createlabel(3) [osf1 man page]

createlabel(3)						     Library Functions Manual						    createlabel(3)

NAME

       createlabel - Creates a disk label structure for a disk device

LIBRARY

       Standard C Library (libc.a)

SYNOPSIS

       #include <sys/types.h>

       #include <sys/disklabel.h>

       int createlabel(      char *devname,	 char *name,	  struct disklabel *disk,      char *boot,	int boot_len);

PARAMETERS

       Specifies  the  device special file name of the device.	Specifies the name entry in the /etc/disktab file that is to be used for the label
       information.  Otherwise, specify NULL to indicate that the name entry either is not in the /etc/disktab file, or, if it is, that it  should
       be  ignored.  Points to the disk label structure that is filled in with the returned disk description on successful completion of the func-
       tion.  Points to the buffer that the function may use to contain the (optional) primary and secondary bootstrap names for the  disk  label.
       Specifies the length of the boot buffer.  The value must be set to the value of the BUFSIZ constant.

DESCRIPTION

       The  function fills in the disk label structure pointed to by the disk parameter.  The resulting disk label can then be written to the disk
       in order to label it.

       The function queries the device, using the devname parameter, to obtain the disk's geometry, capacity, and any default  partition  informa-
       tion.

       The  function  checks  the  name parameter.  If name is non-null, the function looks for an entry in the /etc/disktab file that matches the
       name string and initializes the disk label structure from that entry.  The function then overrides the device data and initializes the disk
       label structure from the entry in the /etc/disktab file.

       If  the	name string is NULL, or has no matching entry in the /etc/disktab file, the function queries the device (using the devname parame-
       ter) to obtain the device's name string.  The function then looks for an entry in the /etc/disktab file that matches that name string,  and
       if it finds a match, initializes the disk label structure from that entry.

       If an /etc/disktab entry indicates that the device has a dynamic geometry, the function queries the device (using the devname parameter) to
       obtain the disk's true geometry and capacity and to override any value given in an /etc/disktab entry associated with the device.  In  this
       case, any -1 lengths encountered in the partition specifications for the entry are replaced by a value equal to the device's total capacity
       minus the starting offset of the partition.

RETURN VALUES

       Upon successful completion of the createlabel function, a value of 0 is returned and the contents of the disk label structure are updated.

       Upon error, a value of -1 is returned and errno is set to [EINVAL].

ERRORS

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

FILES

       Table of disk partition sizes for supported disks.

RELATED INFORMATION

       Commands: disklabel(8)

       Functions: getdiskbyname(3).

       Files: disklabel(4), disktab(4) delim off

																    createlabel(3)

disktab(4)						     Kernel Interfaces Manual							disktab(4)

NAME

       disktab - Disk description file

SYNOPSIS

       #include <sys/disklabel.h>

DESCRIPTION

       The  disktab  database  describes disk geometries and disk partition characteristics.  It is used to initialize the disk label on the disk.
       The format is patterned after the termcap terminal database.  Entries in a disktab file consist of a number of : (colon) separated  fields.
       The  first entry for each disk gives the names which are known for the disk, separated by | (vertical bar) characters.  The last name given
       should be a long name fully identifying the disk.

       The following list indicates the normal values stored for each disk entry: Type Description str	Type of disk (for example, removable, win-
       chester)  str  Type of controller (for example, SMD, ESDI,      floppy) num  Number of sectors per track num  Number of tracks per cylinder
       num  Total number of cylinders on the disk num  Number of sectors per cylinder, nc*nt  default  num  Number  of	sectors  per  unit,  sc*nc
       default	num  Sector size in bytes, DEV_BSIZE default bool Controller supports bad144-style bad sector	   forwarding num  Rotation speed,
       rpm, default 3600 num  Sector skew per track, default 0 num  Sector skew per cylinder, default 0  num  Headswitch  time,  usec,	default  0
       num  One-cylinder  seek	time, usec, default 0 num  Sector interleave (n:1), default 1 num  Drive-type-dependent parameters num	Boot block
       size, default BBSIZE num  Superblock size, default SBSIZE num  Block size for partition `a'  (bytes)  num  Block  size  for  partition  `d'
       (bytes)	num  Block  size  for  partition  `e'  (bytes) num  Block size for partition `f' (bytes) num  Block size for partition `g' (bytes)
       num  Block size for partition `h' (bytes) num  Fragment size for partition  `a'	(bytes)  num  Fragment	size  for  partition  `d'  (bytes)
       num  Fragment  size  for  partition  `e'  (bytes) num  Fragment size for partition `f' (bytes) num  Fragment size for partition `g' (bytes)
       num  Fragment size for partition `h' (bytes) num  Offset of partition `a' in sectors num  Offset of partition `b' in sectors num  Offset of
       partition  `c'  in  sectors num	Offset of partition `d' in sectors num	Offset of partition `e' in sectors num	Offset of partition `f' in
       sectors num  Offset of partition `g' in sectors num  Offset of partition `h' in sectors num  Size of partition `a' in sectors num  Size	of
       partition  `b' in sectors num  Size of partition `c' in sectors num  Size of partition `d' in sectors num  Size of partition `e' in sectors
       num  Size of partition `f' in sectors num  Size of partition `g' in sectors num	Size of partition `h' in sectors  str  Partition  type	of
       partition  `a' (4.2BSD file system,	swap, etc.)  str  Partition type of partition `b' str  Partition type of partition `c' str  Parti-
       tion type of partition `d' str  Partition type of partition `e' str  Partition type of partition `f' str  Partition type of  partition  `g'
       str  Partition type of partition `h'

EXAMPLES

       The following is an example disktab entry:

       rz25|RZ25|DEC RZ25 Winchester:
	       :ty=winchester:dt=SCSI:ns#62:nt#9:nc#1492:
	       :oa#0:pa#131072:ba#8192:fa#1024:
	       :ob#131072:pb#262144:bb#8192:fb#1024:
	       :oc#0:pc#832527:bc#8192:fc#1024:
	       :od#393216:pd#146437:bd#8192:fd#1024:
	       :oe#539656:pe#146437:be#8192:fe#1024:
	       :of#686096:pf#146437:bf#8192:ff#1024:
	       :og#393216:pg#439311:bg#8192:fg#1024:
	       :oh#0:ph#0:bh#8192:fh#1024:

FILES

       /etc/disktab

RELATED INFORMATION

       Functions: getdiskbyname(3)

       Files: disklabel(4)

       Commands: disklabel(8), newfs(8) delim off

																	disktab(4)