lifinit(1)						      General Commands Manual							lifinit(1)

NAME

       lifinit - write LIF volume header on file

SYNOPSIS

       nnn] nnn] string] nnn] nnn] nnn] file

DESCRIPTION

       writes a LIF volume header on a volume or file.

   Options
       recognizes the following options and command-line arguments which can appear in any order:

	      Sets volume size to
			 nnn bytes.  If nnn is not a multiple of 256, it is rounded down to the next such multiple.

	      Sets directory size to
			 nnn file entries.  If nnn is not an integer multiple of 8, it is rounded up to next such multiple.

	      Sets the volume name to be
			 string.  If the option is not specified, the volume name is set to the last component of the path name specified by file.
			 A legal LIF volume name is 6 characters long and is limited to uppercase letters (A-Z), digits (0-9) and  the	underscore
			 character  (_).  The first character (if any) must be a letter.  The utility automatically performs translation to create
			 legal LIF volume names.  Therefore, all lowercase letters are converted to uppercase, and  all  other	characters  except
			 numeric  and  underscore  are	replaced with a capital letter If the volume name does not start with a letter, the volume
			 name is preceded by a capital letter The volume name is also right-padded with spaces or truncated as needed  to  be  six
			 characters long.  If is used with no string, the default volume name is set to 6 spaces.

	      set the initial system load (ISL) start address to
			 nnn in the volume label.  This is useful when building boot media for Series 700/800 systems.

	      specifies the length in bytes of the ISL code in the LIF volume.

	      set the ISL entry point to
			 nnn  bytes from the beginning of the ISL.  For example, specifying means that the ISL entry point is 3272 (decimal) bytes
			 from the beginning of the ISL object module.

	      forces the directory start location to be the nearest multiple of
			 nnn x 1024 bytes from the beginning of the volume.  This is necessary for booting Series 700/800 systems from LIF media.

       If file does not exist, a regular HP-UX disk file is created and initialized.

       The default values for volume size are 256 kilobytes for regular files, and the actual capacity of the device for device files.

       The default directory size is a function of the volume size.  A percentage of the volume size is allocated to the volume directory as  fol-
       lows:
									  |
							      Volume Size | Directory Size
							      ------------+----------------
								 < 2MB	  |	~1.3%
								 > 2MB	  |	~0.5%

       Each directory entry occupies 32 bytes of storage.  The actual directory space is subject to the rounding rules stated above.

RETURN VALUE

       returns exit code 0 if the volume is initialized successfully.  Otherwise it prints a diagnostic message and returns nonzero.

EXAMPLES

       Initialize file to be a LIF volume containing 500000 bytes with 10 directory file entries:

       Initialize device as a LIF volume using default initialization conditions (device must not be a mounted file system device):

WARNINGS

       To prevent media corruption, do not terminate lifinit once it has started executing.

AUTHOR

       was developed by HP.

SEE ALSO

       lifcp(1), lifls(1), lifrename(1), lifrm(1), lif(4).

																	lifinit(1)