lifcp(1)

NAME

lifcp — copy to or from LIF files

SYNOPSIS

lifcp [-T xxx] [-L xxx] [-v xxx] [-a] [-b] [-i xxx] [-r] [-t] file1 file2

lifcp [-T xxx] [-L xxx] [-v xxx] [-a] [-b] [-i xxx] [-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

The space between option and argument is optional.

-T xxx: 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.
-L xxx: 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.
-v xxx: 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.
-i xxx: 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). Note that the "implementation" value controls the attributes of the LIF file with regard to protection and record sizes. lifls -l or lifls -i can be used to determine the "implementation" value of a file.
-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).) The -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 nonletter, 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:

File Type	Default Copying Mode
ASCII	ASCII
BINARY	BINARY
BIN	RAW
other	RAW

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 are duplicated from 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 nonstandard 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.

Do not mount the special file while using lifcp.

DIAGNOSTICS

lifcp returns exit code 0 if the file is copied successfully. Otherwise it prints a diagnostic and returns nonzero.

EXAMPLES

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 abc lifvol:CDE 

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 -t * ../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 -r -T -5555 -t *.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 0xffffe961 -i 0x20200080 bdat lifvol:BDAT 

Copy a BDAT file, without a password, from a BASIC WorkStation to an HP-UX LIF volume lifvol. Note that -i controls protection and record size attributes. The file type for a BDAT file is -5791 (or 0xffffe961) and its record size is 256 bytes per record.

lifcp -b *.o 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 -r -t * /lifvol: 

Copy file abc: to LIF file CDE in lifvol.

lifcp abc\\: lifvol:CDE 

Copy files abc and def to LIF files ABC and DEF within lifvol.

lifcp -t abc def lifvol: 

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

lifcp lifvol:ABC . 

Copy standard input to LIF file A_FILE on LIF volume /dev/dsk/c0t6d0.

lifcp - /dev/dsk/c0t6d0:A_FILE 

Copy LIF file ABC in lifvol to LIF file CDE on /dev/dsk/c0t6d0 .

lifcp lifvol:ABC /dev/dsk/c0t6d0:CDE 

Copy the output of pr to the LIF file ABC.

pr abc | lifcp - lifvol:ABC 

Copy the output of pr to the LIF volume lifvol. LIF file STDIN is created since no file names are specified.

pr abc | lifcp - lifvol: 

Copy LIF file ABC in lifvol to standard output.

lifcp lifvol:ABC - 

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!).

lifcp * ../lifvol: 

DEPENDENCIES

Series 700/800

The following option is also supported:

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

AUTHOR

lifcp was developed by the Hewlett-Packard Company.