.\" Copyright (c) 1983 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)getdisk.3	6.2.1 (2.11BSD) 1995/09/08
.\"
.TH GETDISKBYNAME 3 "September 8, 1995"
.UC 5
.SH NAME
getdiskbyname \- get disk description by its name
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.B #include <sys/disktab.h>
.PP
.B struct disklabel *
.B getdiskbyname(name)
.B char *name;
.fi
.SH DESCRIPTION
.I Getdiskbyname
takes a disk name (e.g. rm03) and returns a structure
describing its geometry information and the standard
disk partition tables.  Information obtained from
the 
.IR disktab (5)
file has the following form:
.sp
.cs R 24
.nf
.so /usr/include/sys/disklabel.h
.fi
.cs R
.SH "SEE ALSO"
disktab(5), disklabel(8)
.SH BUGS
This routine is primarily used when the underlying disk driver does
not support labels.  The other use is for supplying default information
to the
.IR disklabel (8)
program.