unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



ltf(1)								       ltf(1)



NAME

  ltf -	labeled	tape facility

SYNOPSIS

  ltf option [keys] file...

OPTIONS

  The actions of ltf are controlled by one of the following option characters
  that must appear as the first	command-line argument: -c, -H, -t, -x, and
  -i.

  -c  Creates a	new volume assigning an	interchange file name to the files on
      the volume, that is, ltf initializes the volume and writes each named
      file onto	the output file. Then ltf assigns an interchange file name to
      the files	being created on the volume.  This interchange file name is a
      name that	can be recognized by a system other than this operating	sys-
      tem.  (Not all file names	allowed	in this	operating system are permis-
      sible in all forms of ANSI volumes.) This	file name is 17	characters in
      length and includes only capital letters and the "a" characters, which
      are listed in ltf(4). It is formed by converting all lowercase letters
      to uppercase, converting non-"a" characters to uppercase Z, and trun-
      cating the resultant string to 17	characters. If ANSI Version 4 volumes
      are being	used, the original file	name is	preserved in HDR3 through
      HDR9 and EOF3 through EOF9.  For further information, see	ltf(4).

  -H  Displays help messages for all options and keys.

  -t  Lists each named file on the specified volume. If	no file	argument is
      given, information about all files on the	volume is provided.  If	-t is
      used without v or	V (verbose keys), the interchange file names are also
      included in the list.

  -x  Extracts each named file from the	volume to the user's current direc-
      tory.  If	no file	argument is given, the entire content of the volume
      is extracted. If the p key is not	specified when extracting files	from
      a	volume written by a Tru64 UNIX system, the files are restored to the
      current user and group IDs and to	the mode set by	the umask(2) system
      call.

  -i  Initializes an ANSI labeled magnetic volume in accordance	with the ANSI
      X3.27-1978 Standard for Magnetic Tape Labels and File Structure for
      Information Interchange.









KEYS

  The following	optional keys can be specified to enable or disable ltf
  actions as specified:

  a   Outputs an ANSI-compatible Version 3 format volume.  This	key can	be
      used with	the -c option only. The	default	version	is 4.  For further
      information, see ltf(4).

  h   Writes to	a tape volume the file that a symbolic link points to instead
      of creating the symbolic link on a volume.  The file written to the
      tape now has the same name as the	symbolic link. This key	can be used
      with the -c option only.	When extracting, if a symbolic link exists in
      the current directory that has the same name as a	file on	the tape
      volume, the link is followed and the file	that the symbolic link
      currently	points to is overwritten with the extracted file.  To avoid
      overwriting files, use the w key.

  o   Omits directory blocks from the output volume.  When creating a volume,
      the directory files are omitted, and when	listing	or extracting, the V
      key is disabled.

  O   Omits usage of optional headers HDR3 through HDR9	and EOF3 through
      EOF9.  For further information, see ltf(4). If a file is created on a
      Tru64 UNIX system	without	the use	of the O key, these file headers con-
      tain the complete	Tru64 UNIX disk	file name.  Not	all non-Tru64 UNIX
      systems are able to process volumes containing these header labels.
      Thus, it is helpful to use this qualifier	to avoid unnecessary error
      messages when planning to	use other systems.

  p   Restores files to	original mode, user ID and group ID that is written
      on the tape volume.  This	key can	be used	with the -x option on Tru64
      UNIX files and by	the superuser only.

  v   Displays long form information about volume and files. Normally, ltf
      operates with little terminal output.

      When used	in conjunction with the	-t option, v gives more	information
      about the	volume entries than when used in conjunction with the -c and
      -x options.  The following line is typical output	from -tv functions.
	   ltf:	 Volume	ID is:	ULTRIX	 Volume	is:  ANSI Version #4
	   ltf:	 Owner	ID is:	OwnerID
	   ltf:	 Implementation	ID is:	 SystemID
	   ltf:	 Volume	 created   on:	 System

	   t(1,1) rw-r--r-- 103/3 owner	Feb 2 12:34 2530 bytes <&lt;cc >&gt;D file1
	   t(2,1) rw-r--r-- 103/3 owner	Jun 29 09:34 999 bytes <&lt;com>&gt;D file2
	   t(3,1) rwxrwxrwx 293/10 name	Jan 24 10:20 1234 bytes	<&lt;bin>&gt;F name
	   t(4,1) --xrwx--- 199/04 theowner Jan	24 10:21 12345 bytes <&lt;asc>&gt;D
			   long	file name

      The first	field contains the file	sequence number	and the	file section
      number of	the file.  If a	Tru64 UNIX system created the labeled volume,
      the second and third fields contain the mode, and	owner/group ID of the
      file.  Otherwise,	these two fields are filled with dashes. The fourth
      field contains the file owner name. The fifth field contains latest
      modification time.  The year is included if the modification time	is
      older than Jan 1 of the current year.  The sixth field contains the
      number of	bytes used on the volume for the file. If the volume is	from
      a	system other than Tru64	UNIX, this field contains the number of
      blocks with the block size in parentheses. The seventh field contains
      the ANSI file type (angle	brackets) and the file record format (one
      character	suffix). The file record formats are: F	(fixed length),	D
      (variable	length), or S (spanned/segmented records). The eighth (last)
      field contains the name of the file.  If the file	name does not fit
      within the 12 spaces left	in the line, the name appears on the next
      line preceded by a carriage return. A long file name will	be continued
      over one or more lines thus it is	recommended to keep auto wrap on in
      the terminal setup. Also if a file on a volume is	either a symbolic or
      hard link, information about the linked file is displayed	on the next
      line, preceded by	a carriage return.

  V   Displays verbose information about directories.

  w   Warns the	user if	file name is in	danger of being	truncated when using
      -c or if it could	be overwritten using -x. Normally, ltf operates
      silently and does	not let	the user know what is happening.  When -cw is
      specified, ltf displays two warning messages if the interchange name
      and the Tru64 UNIX file name are not the same. When -xw is specified,
      ltf displays a warning message if	a file is about	to be overwritten.
      Another message is displayed asking for approval to overwrite the	file.
      If the user types	no or presses Return, the option exists	to enter a
      new file name or press Return to quit.  If a new file name is entered,
      this name	is also	checked. Thus, ltf does	not continue until a unique
      file name	is entered. When -x is specified, ltf does not warn the	user
      if a directory name already exists.

  0 ...	31
      Selects a	unit number for	a named	tape device.  These unit numbers can
      be entered when using the	default	tape name, /dev/tape/tape0_d0.

  The following	optional keys require an additional argument to	be specified
  on the command line.	If two or more of these	keys are used, their respec-
  tive arguments are to	appear in the exact order that the keys	are speci-
  fied.

  B size
      Sets the blocking	factor to size.	 This specifies	the maximum number of
      bytes that can be	written	in a block on a	volume.	 If no value is
      specified, size defaults to 2048 bytes. The maximum size is 20480	bytes
      and the minimum size is 18 bytes.	The B key need only be specified with
      -c.

      The size value may be specified as n bytes, (where n is assumed to be
      decimal) or as nb, (a multiple of	512 bytes using	n followed by b,
      where b signifies	the multiple of	512) or	as nk, (a multiple of 1024
      bytes using n followed by	k, where k signifies the multiple of 1024).

  f device
      Sets the device file name	to device.  The	default	is
      /dev/tape/tape0_d0.  The use of the f key	overrides the 0	... 31 keys.

  I file
      Allows file name to be supplied either interactively or from a speci-
      fied file.  Normally, ltf	expects	the argument file names	to be part of
      the command line.	The I key allows the user to enter argument file
      names either interactively or from a specified file. If file is a	dash
      (-), ltf reads standard input and	prompts	for all	required information.
      All of the file names are	requested first, followed by a single return
      before the arguments are processed. If file is a valid file name,	the
      specified	file is	opened and read	to obtain argument file	names.

  L label
      Specifies	a six-character	volume identifier.  The	default	label for
      Tru64 UNIX systems is "ULTRIX".

  P position
      Specifies	file sequence and section number at which volume will be
      positioned, using	#,#.  The first	#, represents the file sequence
      number, while second #, the file section number. The file	sequence
      number begins at 1 and is	incremented for	each file in the current file
      set.  Since this implementation of ltf only produces one file set, the
      file sequence number for volumes written with this implementation	is
      the number of the	file as	it is written on the volume.  The file sec-
      tion number begins at 1 and is incremented for each file section on any
      one volume.  This	number is necessary when files are written in multi-
      volume format where the need may exist to	split a	file across volumes;
      however since this implementation	of ltf writes only single volumes,
      the file section number is always	1 for volumes written with this
      implementation.

      If no file arguments are specified, all files from the position number
      to the end of the	tape are listed	or extracted.  Otherwise, particular
      files that exist between the position number and the end of the tape
      can be listed or extracted.  A warning message appears if	a file is
      requested	that exists before the position	number specified. The P	key
      cannot be	used with the -c option.

DESCRIPTION

  The ltf command reads	and writes single-volume Versions 3 and	4 ANSI-
  compatible tape volumes. The file argument specifies each file or directory
  name that is to be processed.	 If a directory	name is	specified, the com-
  plete	directory tree is processed.

RESTRICTIONS

  The ltf command does not support floppy diskettes or multi-volume tapes.

ERRORS

  Diagnostics are written to the standard error	file. They come	in four
  forms: fatal errors, warnings, information, and prompts.  The	ltf command
  terminates when it detects that a fatal error	has occurred.

  The diagnostics are intended to be self-explanatory. Their general format
  is:

       ltf: FATAL > a fatal error message
       ltf: Warning > a	warning	or advisory message
       ltf: Info > an information message
       ltf: a prompt asking for	input

EXAMPLES

  This example creates a new volume for	file1, file2, and file3	using device
  /dev/tape/tape0_d0 (f	key) and a blocking factor of 100 (B key).

       ltf -cfB	/dev/tape/tape0_d0 100 file1 file2 file3

SEE ALSO

  ltf(4)