getdiskbyna.3c (2010 09)
g
getdiskbyname(3C) getdiskbyname(3C)
NAME
getdiskbyname( ) - get disk description by its name
SYNOPSIS
#include <disktab.h>
struct disktab *getdiskbyname(const char *name);
Obsolescent Interface
int getdiskbyname_r(
const char *name,
struct disktab *result,
char *buffer,
int buflen);
DESCRIPTION
getdiskbyname()
takes a disk name (such as hp7959B) and returns a pointer to a structure that
describes its geometry information and the standard disk partition tables. All information is obtained
from the disktab database file (see disktab (4)).
The contents of the structure
disktab include the following members. Note that there is not neces-
sarily any correlation between the placement in this list and the order in the structure.
char *d_name; /* drive name */
char *d_type; /* drive type */
int d_secsize; /* sector size in bytes */
int d_ntracks; /* # tracks/cylinder */
int d_nsectors; /* # sectors/track */
int d_ncylinders; /* # cylinders */
int d_rpm; /* revolutions/minute */
struct partition {
int p_size; /* #sectors in partition */
short p_bsize; /* block size in bytes */
short p_fsize; /* frag size in bytes */
} d_partitions[NSECTIONS];
The constant NSECTIONS is defined in <disktab.h>.
Obsolescent Interface
getdiskbyname_r()
gets disk description by its name.
DIAGNOSTICS
A NULL pointer is returned in case of an error, or if name is not found in the disktab database file.
WARNINGS
The return value for
getdiskbyname() points to data whose content is overwritten by each call.
getdiskbyname_r() is an obsolescent interface supported only for compatibility with existing DCE
applications. New multithreaded applications should use getdiskbyname()
.
AUTHOR
getdiskbyname() was developed by HP and the University of California, Berkeley.
SEE ALSO
disktab(4), thread_safety(5).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1