ltf man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

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 char‐
       acters that must appear as the first command-line argument: -c, -H, -t,
       -x, and -i.  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 system.  (Not all file names allowed in this operating system
       are  permissible	 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 upper‐
       case  Z,	 and truncating 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).  Displays help messages for all options  and	 keys.	 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.  Extracts each named file from the volume to  the
       user's  current	directory.   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.  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: Outputs an ANSI-compatible Version 3 format  vol‐
       ume.  This key can be used with the -c option only. The default version
       is 4.  For further information, see ltf(4).  Writes to  a  tape	volume
       the  file  that	a symbolic link points to instead of creating the sym‐
       bolic 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 direc‐
       tory  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.  Omits directory blocks from the output volume.  When creat‐
       ing  a  volume,	the  directory	files are omitted, and when listing or
       extracting, the V key is disabled.  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 contain the complete Tru64 UNIX disk file
       name.  Not all non-Tru64 UNIX systems are able to process volumes  con‐
       taining	these header labels. Thus, it is helpful to use this qualifier
       to avoid unnecessary error messages when planning to use other systems.
       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.	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 infor‐
	      mation about the volume entries than when	 used  in  conjunction
	      with  the -c and -x options.  The following line is typical out‐
	      put from -tv functions.  ltf:  Volume ID	is:   ULTRIX	Volume
	      is:   ANSI  Version #4 ltf:  Owner  ID is:  OwnerID ltf:	Imple‐
	      mentation ID is:	 SystemID ltf:	Volume	created	  on:	System

	      t(1,1) rw-r--r-- 103/3 owner Feb 2 12:34 2530 bytes <cc >D file1
	      t(2,1) rw-r--r-- 103/3 owner Jun 29 09:34 999 bytes <com>D file2
	      t(3,1) rwxrwxrwx 293/10 name Jan 24 10:20 1234 bytes <bin>F name
	      t(4,1) --xrwx--- 199/04 theowner Jan 24 10:21 12345 bytes <asc>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.	Displays  verbose  information
	      about  directories.  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  dis‐
	      plays two warning messages if the interchange name and the Tru64
	      UNIX file name are not the same. When -xw is specified, ltf dis‐
	      plays  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.  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 speci‐
       fied on the command line.  If two or more of these keys are used, their
       respective arguments are to appear in the exact order that the keys are
       specified.  Sets the blocking factor to size.  This specifies the maxi‐
       mum 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  fol‐
	      lowed  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).	  Sets the device file name to device.
	      The default is /dev/tape/tape0_d0.  The use of the f  key	 over‐
	      rides the 0 ... 31 keys.	Allows file name to be supplied either
	      interactively or from a specified 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 interac‐
	      tively  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 argu‐
	      ment file names.	Specifies a six-character  volume  identifier.
	      The default label for Tru64 UNIX systems is "ULTRIX".  Specifies
	      file sequence and section number at which volume will  be	 posi‐
	      tioned,  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 section 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 vol‐
	      umes, 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.	Other‐
	      wise,  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 speci‐
       fied, the complete 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  com‐
       mand terminates when it detects that a fatal error has occurred.

       The diagnostics are intended to be self-explanatory. Their general for‐
       mat 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)

									ltf(1)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net