Content-type: text/html Man page of getdiskbyname

getdiskbyname

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

getdiskbyname, getdiskbyname_r - Get the disk description using a disk name  

LIBRARY

Standard C Library (libc.a)  

SYNOPSIS

#include <sys/disklabel.h> #include <sys/types.h>


 struct disklabel *getdiskbyname(        char *name);

[Digital]  The following function is supported in order to maintain backward compatibility with previous versions of the operating system.
 int getdiskbyname_r(        char *name,
       struct disklabel *disk,
       char *boot,
       int boot_len,
 

PARAMETERS

Specifies a common name for the disk drive whose geometry and partition characteristics are sought. Points to the structure that will contain the returned disk description. Points to the buffer that will contain the optional names of the primary and secondary bootstraps. Specifies the length of boot. This should be BUFSIZ.  

DESCRIPTION

Operations supported by the getdiskbyname function are also supported by the createlabel function. See The getdiskbyname function is supported only for backward compatibility with operating system versions earlier that Tru64 UNIX Version 4.0 and will be retired in a future release of the product.

The getdiskbyname() function uses a disk (disk drive) name to return a pointer to a structure that describes the geometry and standard partition characteristics of the named disk drive. Information obtained from the /etc/disktab database file is written to the type disklabel structure space referenced by the returned pointer.  

NOTES

The getdiskbyname_r() function is the reentrant version of getdiskbyname(). It is supported in order to maintain backward compatibility with previous versions of the operating system.

Upon successful completion, getdiskbyname_r() returns a value of 0 (zero); the returned structure is pointed at by disk. Upon error, it returns a value of -1, and may set errno to [EINVAL].  

RETURN VALUES

Upon successful completion, the getdiskbyname() function, returns a pointer to a type disklabel structure.  

ERRORS

Either disk or boot is NULL, or boot_len is not equal to BUFSIZ.  

RELATED INFORMATION

Functions: createlabel(3),

Files: disklabel(4), disktab(4).

Commands: disklabel(8). delim off


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
NOTES
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:34 GMT, October 02, 2010