getdiskbyname(3C)

NAME

getdiskbyname() − get disk description by its name

SYNOPSIS

#include <disktab.h>

struct disktab *getdiskbyname(const char *name);

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 necessarily 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>.

DIAGNOSTICS

A NULL pointer is returned in case of an error, or if name is not found in the disktab database file.

AUTHOR

getdiskbyname() was developed by HP and the University of California, Berkeley.

Museum