Return to ustar.man CVS log

Up to [MW Coherent from dump] / coherent / d / usr / bin / pax

coherent

     UUUUSSSSTTTTAAAARRRR((((1111))))                    CCCCOOOOHHHHEEEERRRREEEENNNNTTTT                     UUUUSSSSTTTTAAAARRRR((((1111))))



     NNNNAAAAMMMMEEEE
          ustar - process tape archives

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          uuuussssttttaaaarrrr ----cccc[bbbbffffvvvvwwww] _d_e_v_i_c_e _b_l_o_c_k _f_i_l_e_n_a_m_e...
          uuuussssttttaaaarrrr ----rrrr[bbbbvvvvwwww] _d_e_v_i_c_e _b_l_o_c_k [_f_i_l_e_n_a_m_e...]
          uuuussssttttaaaarrrr ----tttt[ffffvvvv] _d_e_v_i_c_e
          uuuussssttttaaaarrrr ----uuuu[bbbbvvvvwwww] _d_e_v_i_c_e _b_l_o_c_k
          uuuussssttttaaaarrrr ----xxxx[ffffllllmmmmoooovvvvwwww] _d_e_v_i_c_e [_f_i_l_e_n_a_m_e...]

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          _U_s_t_a_r reads and writes archive files which conform to the
          AAAArrrrcccchhhhiiiivvvveeee////IIIInnnntttteeeerrrrcccchhhhaaaannnnggggeeee FFFFiiiilllleeee FFFFoooorrrrmmmmaaaatttt specified in _I_E_E_E _S_t_d.
          _1_0_0_3._1-_1_9_8_8.

        OOOOppppttttiiiioooonnnnssss
          The following options are available:

          ----cccc        Creates a new archive; writing begins at the
                    beginning of the archive, instead of after the
                    last file.

          ----rrrr        Writes names files to the end of the archive.

          ----tttt        Lists the names of all of the files in the
                    archive.

          ----uuuu        Causes named files to be added to the archive if
                    they are not already there, or have been modified
                    since last written into the archive.  This implies
                    the ----rrrr option.

          ----xxxx        Extracts named files from the archive.  If a named
                    file matches a directory whose contents had been
                    written onto the archive, that directory is
                    recursively extracted.  If a named file in the
                    archive does not exist on the system, the file is
                    create with the same mode as the one in the
                    archive, except that the set-user-id and get-
                    group-id modes are not set unless the user has
                    appropriate privileges.

          If the files exist, their modes are not changed except as
          described above.  The owner, group and modification time are
          restored if possible.  If no _f_i_l_e_n_a_m_e argument is given, the
          entire contents of the archive is extracted.  Note that if
          several files with the same name are in the archive, the
          last one will overwrite all earlier ones.

          ----bbbb        Causes _u_s_t_a_r to use the next argument on the
                    command line as the blocking factor for tape
                    records.  The default is 1; the maximum is 20.



     Page 1                                         (printed 10/10/90)






     UUUUSSSSTTTTAAAARRRR((((1111))))                    CCCCOOOOHHHHEEEERRRREEEENNNNTTTT                     UUUUSSSSTTTTAAAARRRR((((1111))))



                    This option should only be used with raw magnetic
                    tape archives.  Normally, the block size is
                    determined automatically when reading tapes.

          ----ffff        Causes _u_s_t_a_r to use the next argument on the
                    command line as the name of the archive instead of
                    the default, which is usually a tape drive.  If ----
                    is specified as a filename _u_s_t_a_r writes to the
                    standard output or reads from the standard input,
                    whichever is appropriate for the options given.
                    Thus, _u_s_t_a_r can be used as the head or tail of a
                    pipeline.

          ----llll        Tells _u_s_t_a_r to report if it cannot resolve all of
                    the links to the files being archived.  If ----llll is
                    not specified, no error messages are written to
                    the standard output.  This modifier is only valid
                    with the ----cccc, ----rrrr and ----uuuu options.

          ----mmmm        Tells _u_s_t_a_r not to restore the modification times.
                    The modification time of the file will be the time
                    of extraction.  This modifier is invalid with th
                    ----tttt option.

          ----oooo        Causes extracted files to take on the user and
                    group identifier of the user running the program
                    rather than those on the archive.  This modifier
                    is only valid with the ----xxxx option.

          ----vvvv        Causes _u_s_t_a_r to operate verbosely.  Usually, _u_s_t_a_r
                    does its work silently, but the vvvv modifier causes
                    it to print the name of each file it processes,
                    preceded by the option letter.  With the ----tttt
                    option, vvvv gives more information about the archive
                    entries than just the name.

          ----wwww        Causes _u_s_t_a_r to print the action to be taken,
                    followed by the name of the file, and then wait
                    for the user's confirmation.  If a word beginning
                    with yyyy is given, the action is performed.  Any
                    other input means "no".  This modifier is invalid
                    with the ----tttt option.

     FFFFIIIILLLLEEEESSSS
          /dev/tty  used to prompt the user for information when the
                    ----iiii or ----yyyy options are specified.

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          cpio, dd, find, pax, cpio, ustar

     CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
          Copyright (c) 1989 Mark H. Colburn.



     Page 2                                         (printed 10/10/90)






     UUUUSSSSTTTTAAAARRRR((((1111))))                    CCCCOOOOHHHHEEEERRRREEEENNNNTTTT                     UUUUSSSSTTTTAAAARRRR((((1111))))



          All rights reserved.

          Redistribution and use in source and binary forms are
          permitted provided that the above copyright notice is
          duplicated in all such forms and that any documentation,
          advertising materials, and other materials related to such
          distribution and use acknowledge that the software was
          developed by Mark H. Colburn and sponsored by The USENIX
          Association.

          THE SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS
          OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE
          IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
          PARTICULAR PURPOSE.

     AAAAUUUUTTTTHHHHOOOORRRR
          Mark H. Colburn
          NAPS International
          117 Mackubin Street, Suite 1
          St. Paul, MN 55102
          [email protected]


          Sponsored by TTTThhhheeee UUUUSSSSEEEENNNNIIIIXXXX AAAAssssssssoooocccciiiiaaaattttiiiioooonnnn for public distribution.































     Page 3                                         (printed 10/10/90)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.