lifinit(1)                                                       lifinit(1)




 NAME    [Toc]    [Back]
      lifinit - write LIF volume header on file

 SYNOPSIS    [Toc]    [Back]
      lifinit [-vnnn] [-dnnn] [-n string] [-snnn] [-lnnn] [-ennn] file

 DESCRIPTION    [Toc]    [Back]
      lifinit writes a LIF volume header on a volume or file.

    Options    [Toc]    [Back]
      lifinit recognizes the following options and command-line arguments
      which can appear in any order:

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

           -dnnn      Sets directory size to nnn file entries.  If nnn is
                      not an integer multiple of 8, it is 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
                      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 X.  If
                      the volume name does not start with a letter, the
                      volume name is preceded by a capital letter X.  The
                      volume name is also right-padded with spaces or
                      truncated as needed to be six characters long.  If -n
                      is used with no string, the default volume name is set
                      to 6 spaces.

           -snnn      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.

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

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




 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 lifinit(1)                                                       lifinit(1)




           -Knnn      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
      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.

      Do not mount the special file while using lifinit.

 RETURN VALUE    [Toc]    [Back]
      lifinit returns exit code 0 if the volume is initialized successfully.
      Otherwise it prints a diagnostic message and returns nonzero.

 EXAMPLES    [Toc]    [Back]
      Initialize file x to be a LIF volume containing 500000 bytes with 10
      directory file entries:

           lifinit -v500000 -d10 x

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

           lifinit /dev/rdsk/c0t6d0

 WARNINGS    [Toc]    [Back]
      To prevent media corruption, do not terminate lifinit once it has
      started executing.

 AUTHOR    [Toc]    [Back]
      lifinit was developed by HP.

 SEE ALSO    [Toc]    [Back]
      lifcp(1), lifls(1), lifrename(1), lifrm(1), lif(4).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003