NAME
getdiskbyname,
setdisktab —
get generic disk description by its
name
LIBRARY
library “libc”
SYNOPSIS
#include
<sys/types.h>
#include <sys/disklabel.h>
#include <disktab.h>
int
setdisktab(char
*name);
struct disklabel *
getdiskbyname(const
char *name);
DESCRIPTION
Thegetdiskbyname()
function takes a disk name (e.g. ‘rm03’)
and returns a prototype disk label describing its geometry information and the
standard disk partition tables. All information is obtained from the
disktab(5) file.
The
setdisktab()
function changes the default
disktab
file name from /etc/disktab (aka
_PATH_DISKTAB) to name.
RETURN VALUES
getdiskbyname() returns a null pointer if
the entry is not found in the current disktab
file.
setdisktab() returns 0 on success and -1
if name is a null pointer or points to an empty
string.
FILES
- /etc/disktab
- the default database of disk types.
SEE ALSO
HISTORY
The getdiskbyname() function appeared in
4.3BSD.
The setdisktab() function appeared in
NetBSD 1.4.
BUGS
The getdiskbyname() function leaves its
results in an internal static object and returns a pointer to that object.
Subsequent calls will modify the same object.