NAME

lifcp − copy to or from LIF files

SYNOPSIS

lifcp [−Txxx] [−Lxxx] [−vxxx] [−a] [−b] [−ixxx] [−r] [−t] file1 file2
lifcp [−Txxx] [−Lxxx] [−vxxx] [−a] [−b] [−ixxx] [−r] [−t] file1 [file2 ...] directory

DESCRIPTION

Lifcp copies a LIF file to an HP-UX file, an HP-UX file to a LIF file, or a LIF file to another LIF file.  It also copies a list of (HP-UX/LIF) files to a (LIF/HP-UX) directory.  The last name on the argument list is the destination file or directory. 

Options can be used singly or combined in any order before the file names.  The space between option and argument is optional. 

−Txxx Used only when copying files to a LIF volume.  This option forces the file type of the LIF directory entry to be set to the argument given.  The argument can be decimal, octal or hex, using standard "C" notation. 

−Lxxx Used only when copying files to a LIF volume. This option will set the "last volume flag" to xxx (0 or 1). The default "last volume flag" is 1. 

−vxxx Used only when copying files to a LIF volume. This option sets the "volume number" to xxx. The default "volume number" is one.

−a This option forces a ASCII mode of copying regardless of the file type.  When copying in ASCII mode from HP-UX to LIF the default file type is BINARY (1).  (For details on available modes of copying refer to lif(4)). This option has no effect when copying from LIF to LIF. 

−b This option forces a BINARY mode of copying regardless of the file type.  When copying in BINARY mode from HP-UX to LIF the default file type is BINARY (−2).  (For details on available modes of copying refer to lif(4)). This option has no effect when copying from LIF to LIF. 

−ixxx Used only when copying files to a LIF volume. This option sets the "implementation" field of the LIF directory entry to the argument given.  The argument value can be decimal, octal or hex, using standard "C" notation.  The "implementation" field can only be set for file types −2001 to −100000 (octal).  The "implementation" field is set to zero for all interchange file types and for file types −2 to −200 (octal). 

−r Forces RAW mode copying regardless of file type. When copying in RAW mode from HP-UX to LIF the default file type is BIN (−23951).  −T option overrides the default file type.  (various modes of copying are explained in lif(4).) −r option has no effect in LIF to LIF copy operations. 

−t causes HP-UX file names to be translated to a name acceptable by a LIF utility; that is, all lowercase letters are converted to uppercase and all other characters except numerics are changed to an underscore (_).  If the HP-UX file name starts with a non-letter, the file name is preceded by the capital letter X.  Thus, for example, if two files named colon (:) and semicolon (;), were copied, both of them would be translated to X_.  File names are truncated to a maximum of 10 characters.  When copying a LIF file to an HP-UX or LIF file, −t has no effect.  Omitting −t causes an error to be generated if an improper name is used. 

The default copying modes when copying from LIF to HP-UX are summarized in the following table:

When copying from HP-UX to LIF, the default copying mode is ASCII and an ASCII file is created. 

When copying from LIF to LIF, if no options are specified then all the LIF directory fields and file contents source to destination. 

A LIF file name is recognized by the embedded colon (:) delimiter (see lif(4) for LIF file naming conventions).  A LIF directory is recognized by a trailing colon.  If an HP-UX file name containing a colon is used, the colon must be escaped with two backslash characters (\\) (the shell removes one of them). 

The file name − (dash) is interpreted to mean standard input or standard output, depending on its position in the argument list.  This is particularly useful if the data requires non-standard translation.  When copying from standard input, if no other name can be found, the name "STDIN" is used. 

LIF file naming conventions are known only to the LIF utilities.  Since file name expansion is done by the shell, this mechanism cannot be used for expanding LIF file names. 

Note that the media should not be mounted while using lifcp.

DEPENDENCIES

Series 800
The following option is also supported:

−Knnn forces each file copied in to begin on a nnn × 1024 byte boundary from the beginning of the volume.  This is useful when files are used for Series 800 boot media.  This option has no effect when copying from a LIF volume. 

EXAMPLES

lifcp abc lifvol:CDE
Copy HP-UX file abc to LIF file CDE on LIF volume lifvol which is actually an HP-UX file initialized to be a LIF volume. 

lifcp −t ∗ ../lifvol:
Copy all the HP-UX files in the current directory to the LIF volume lifvol which is present in the parent directory.  File names are translated to appropriate LIF file names. 

lifcp −r −T −5555 −t ∗.o lifvol:
Copy all the HP-UX object files in the current directory to the LIF volume lifvol. Copying mode is RAW and LIF file types are set to −5555. 

lifcp −b  ∗.o lifvol:
Copy all the object files in the current directory to the LIF volume lifvol.  Copying mode is BINARY and LIF BINARY files are created. 

lifcp −r −t ∗ /lifvol:
Copy all files in the current directory to the LIF volume lifvol in the root directory.  Copying mode is RAW and LIF file types are set to BIN. 

lifcp abc\\: lifvol:CDE
Copy file abc: to LIF file CDE in lifvol. 

lifcp −t abc def lifvol:
Copy files abc and def to LIF files ABC and DEF within lifvol. 

lifcp lifvol:ABC .
Copy LIF file ABC within lifvol to file ABC within current directory. 

lifcp − /dev/dsk/1s2:A_FILE
Copy standard input to LIF file A_FILE on LIF volume /dev/dsk/1s2. 

lifcp lifvol:ABC /dev/dsk/1s2:CDE
Copy LIF file ABC in lifvol to LIF file CDE on /dev/dsk/1s2 . 

pr abc | lifcp − lifvol:ABC
Copy the output of pr to the LIF file ABC. 

pr abc | lifcp − lifvol:
Copy the output of pr to the LIF volume lifvol.  LIF file STDIN is created since no files names are specified. 

lifcp lifvol:ABC −
Copy LIF file ABC in lifvol to standard output.

lifcp ∗ ../lifvol:
Copy all files in current directory to LIF files of the same name on LIF volume lifvol (may cause errors if file names in the current directory do not obey LIF naming conventions!). 

AUTHOR

Lifcp was developed by the Hewlett-Packard Company. 

SEE ALSO

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

DIAGNOSTICS

Lifcp returns exit code 0 if the file is copied successfully.  Otherwise it prints a diagnostic and returns non-zero. 

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989