*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> ltf (1)              



NAME    [Toc]    [Back]

       ltf - labeled tape facility

SYNOPSIS    [Toc]    [Back]

       ltf option [keys] file...

OPTIONS    [Toc]    [Back]

       The  actions of ltf are controlled by one of the following
       option characters that must appear as the  first  commandline
 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 uppercase 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    [Toc]    [Back]

       The following optional keys can be specified to enable  or
       disable ltf actions as specified: 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).  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.  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.  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
       containing 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 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
              <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 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.
              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  respective  arguments  are  to
       appear  in  the  exact  order that the keys are specified.
       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

              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).  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.
              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 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.  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 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
              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 volumes, the file section
              number is always 1 for volumes  written  with  this

              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    [Toc]    [Back]

       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 complete
       directory tree is processed.

RESTRICTIONS    [Toc]    [Back]

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

ERRORS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]


[ Back ]
 Similar pages
Name OS Title
witness FreeBSD lock validation facility
CTR0 FreeBSD kernel tracing facility
CTR1 FreeBSD kernel tracing facility
CTR2 FreeBSD kernel tracing facility
CTR3 FreeBSD kernel tracing facility
CTR4 FreeBSD kernel tracing facility
CTR5 FreeBSD kernel tracing facility
aio HP-UX POSIX asynchronous I/O facility
lmf Tru64 License Management Facility (LMF)
ktr FreeBSD kernel tracing facility
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service