unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 lifcp(1)							    lifcp(1)




 NAME
      lifcp - copy to or from LIF files

 SYNOPSIS
      lifcp [-Txxx] [-Lxxx] [-vxxx] [-a] [-b] [-i xxx] [-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



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 lifcp(1)							    lifcp(1)




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



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 lifcp(1)							    lifcp(1)




      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



 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 lifcp(1)							    lifcp(1)




      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 files 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 a nnn x
			  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



 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000






 lifcp(1)							    lifcp(1)




			  effect when copying from a LIF volume.

 AUTHOR
      lifcp was developed by the Hewlett-Packard Company.

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















































 Hewlett-Packard Company	    - 5 -   HP-UX Release 11i: November 2000