LIFINIT(1)			 HP-UX 5.0		    LIFINIT(1)

     NAME
	  lifinit - write LIF volume header on file

     SYNOPSIS
	  lifinit [-vnnn] [-dnnn] [-n string] file

     HP-UX COMPATIBILITY
	  Level:    HP-UX/NUCLEUS

	  Origin:   HP

     DESCRIPTION
	  Lifinit writes a LIF volume header  on  a  volume  or	 file.
	  Options may appear in any order. Their meanings are:

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

	  -dnnn	     Sets the directory size to nnn file  entries.  If
		     nnn is not a multiple of 8, it will be rounded up
		     to next such multiple.

	  -n string  sets the volume name to be	 string.   If  the  -n
		     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 upper case letters	(A-Z),
		     digits  (0-9)  and	 the underscore character (_).
		     The first character (if any) must	be  a  letter.
		     The    utility    will    automatically   perform
		     translation to create  legal  LIF	volume	names.
		     Therefore,	 all lower-case letters are up-shifted
		     and  all  other  characters  except  numeric  and
		     underscore	 will  be replaced with capital letter
		     (X). If the volume name does  not	start  with  a
		     letter,  the  volume name will be preceded by the
		     capital letter (X).  The volume name will also be
		     right  padded  with blanks or truncated as needed
		     to be 6 characters long.  If -n is used  with  no
		     string,  the  default  volume  name  is  set to 6
		     blanks.

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

	  The default values  for  volume  size	 are  256K  bytes  for
	  regular  files,  and	the  actual capacity of the device (as
	  determined by volsize(3)) 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 follows:

	       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.

	  Note that you should not mount the special file before using
	  lifinit.

	  If your  media  has  never  been  initialized,  it  must  be
	  initialized  using  mediainit	 before	 lifinit  can be used.
	  (Refer  to  the  System  Administrator  Manual  for  details
	  concerning system_mi.)

     EXAMPLES
	  lifinit -v500000 -d10 x
	  lifinit /dev/rfd.0

     SEE ALSO
	  lif(5),   lifcp(1),	lifls(1),   lifrename(1),    lifrm(1),
	  sdfinit(8).

     DIAGNOSTICS
	  Lifinit returns exit code 0 if  the  volume  is  initialized
	  successfully.	  Otherwise it prints a diagnostic and returns
	  non-zero.

     WARNING
	  Do not terminate lifinit  once  it  has  started  executing.
	  Otherwise, your media could become corrupted.