home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat1 / cpio.0 < prev    next >
Text File  |  1993-12-07  |  16KB  |  397 lines
  1.  
  2.  
  3.  
  4. CPIO(1L)                                                 CPIO(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        cpio - copy files to and from archives
  9.  
  10. SSYYNNOOPPSSIISS
  11.        ccppiioo  {-o|--create} [-0acvABLV] [-C bytes] [-H format] [-M
  12.        message]       [-O       [[user@]host:]archive]        [-F
  13.        [[user@]host:]archive]      [--file=[[user@]host:]archive]
  14.        [--format=format] [--message=message]  [--null]  [--reset-
  15.        access-time]   [--verbose]  [--dot]  [--append]  [--block-
  16.        size=blocks]  [--dereference]  [--io-size=bytes]  [--help]
  17.        [--version] < name-list [> archive]
  18.  
  19.        ccppiioo {-i|--extract} [-bcdfmnrtsuvBSV] [-C bytes] [-E file]
  20.        [-H  format]  [-M  message]  [-R  [user][:.][group]]   [-I
  21.        [[user@]host:]archive]      [-F     [[user@]host:]archive]
  22.        [--file=[[user@]host:]archive]        [--make-directories]
  23.        [--nonmatching] [--preserve-modification-time] [--numeric-
  24.        uid-gid]  [--rename]  [--list]   [--swap-bytes]   [--swap]
  25.        [--dot]     [--unconditional]     [--verbose]    [--block-
  26.        size=blocks] [--swap-halfwords] [--io-size=bytes]  [--pat-
  27.        tern-file=file]                          [--format=format]
  28.        [--owner=[user][:.][group]] [--no-preserve-owner]  [--mes-
  29.        sage=message]   [--help]   [--version]   [pattern...]   [<
  30.        archive]
  31.  
  32.        ccppiioo      {-p|--pass-through}       [-0adlmuvLV]       [-R
  33.        [user][:.][group]] [--null] [--reset-access-time] [--make-
  34.        directories]    [--link]    [--preserve-modification-time]
  35.        [--unconditional]   [--verbose]   [--dot]  [--dereference]
  36.        [--owner=[user][:.][group]] [--no-preserve-owner] [--help]
  37.        [--version] destination-directory < name-list
  38.  
  39. DDEESSCCRRIIPPTTIIOONN
  40.        This  manual page documents the GNU version of ccppiioo.  ccppiioo
  41.        copies files into or out of a cpio or tar  archive,  which
  42.        is a file that contains other files plus information about
  43.        them, such  as  their  pathname,  owner,  timestamps,  and
  44.        access  permissions.   The  archive can be another file on
  45.        the disk, a magnetic tape, or  a  pipe.   ccppiioo  has  three
  46.        operating modes.
  47.  
  48.        In  copy-out  mode, ccppiioo copies files into an archive.  It
  49.        reads a list of filenames, one per line, on  the  standard
  50.        input, and writes the archive onto the standard output.  A
  51.        typical way to generate the list of filenames is with  the
  52.        ffiinndd  command;  you  should give ffiinndd the -depth option to
  53.        minimize problems with permissions on directories that are
  54.        unwritable or not searchable.
  55.  
  56.        In  copy-in  mode,  ccppiioo copies files out of an archive or
  57.        lists the archive contents.  It reads the archive from the
  58.        standard input.  Any non-option command line arguments are
  59.        shell globbing patterns; only files in the  archive  whose
  60.        names  match one or more of those patterns are copied from
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CPIO(1L)                                                 CPIO(1L)
  71.  
  72.  
  73.        the archive.  Unlike in the shell, an  initial  `.'  in  a
  74.        filename  does match a wildcard at the start of a pattern,
  75.        and a `/' in a filename can match wildcards.  If  no  pat-
  76.        terns are given, all files are extracted.
  77.  
  78.        In  copy-pass  mode,  ccppiioo copies files from one directory
  79.        tree to another, combining the copy-out and copy-in  steps
  80.        without  actually  using an archive.  It reads the list of
  81.        files to copy from the standard input; the directory  into
  82.        which it will copy them is given as a non-option argument.
  83.  
  84.        ccppiioo supports the following archive formats:  binary,  old
  85.        ASCII,  new  ASCII,  crc, HPUX binary, HPUX old ASCII, old
  86.        tar, and POSIX.1  tar.   The  binary  format  is  obsolete
  87.        because  it  encodes  information about the files in a way
  88.        that is not portable between different  machine  architec-
  89.        tures.  The old ASCII format is portable between different
  90.        machine architectures, but should not be used on file sys-
  91.        tems  with  more than 65536 i-nodes.  The new ASCII format
  92.        is portable between different  machine  architectures  and
  93.        can  be used on any size file system, but is not supported
  94.        by all versions of ccppiioo; currently, it is  only  supported
  95.        by  GNU  and Unix System V R4.  The crc format is like the
  96.        new ASCII format, but also contains a  checksum  for  each
  97.        file  which  ccppiioo  calculates when creating an archive and
  98.        verifies when the file is extracted from the archive.  The
  99.        HPUX  formats  are  provided for compatibility with HPUX's
  100.        cpio which stores device files differently.
  101.  
  102.        The tar format is provided for compatability with the  ttaarr
  103.        program.   It  can not be used to archive files with names
  104.        longer than 100 characters, and can not be used to archive
  105.        "special" (block or character devices) files.  The POSIX.1
  106.        tar format can not be used to  archive  files  with  names
  107.        longer than 255 characters (less unless they have a "/" in
  108.        just the right place).
  109.  
  110.        By default, ccppiioo creates binary format archives, for  com-
  111.        patibility with older ccppiioo programs.  When extracting from
  112.        archives, ccppiioo  automatically  recognizes  which  kind  of
  113.        archive  it  is  reading  and can read archives created on
  114.        machines with a different byte-order.
  115.  
  116.        Some of the options to ccppiioo apply only to certain  operat-
  117.        ing  modes;  see  the SYNOPSIS section for a list of which
  118.        options are allowed in which modes.
  119.  
  120.    OOPPTTIIOONNSS
  121.        _-_0_, _-_-_n_u_l_l
  122.               In copy-out and copy-pass modes,  read  a  list  of
  123.               filenames terminated by a null character instead of
  124.               a newline, so that files whose names  contain  new-
  125.               lines can be archived.  GNU ffiinndd is one way to pro-
  126.               duce a list of null-terminated filenames.
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CPIO(1L)                                                 CPIO(1L)
  137.  
  138.  
  139.        _-_a_, _-_-_r_e_s_e_t_-_a_c_c_e_s_s_-_t_i_m_e
  140.               Reset the access times of files after reading them,
  141.               so  that  it does not look like they have just been
  142.               read.
  143.  
  144.        _-_A_, _-_-_a_p_p_e_n_d
  145.               Append to an existing archive.  Only works in copy-
  146.               out  mode.   The archive must be a disk file speci-
  147.               fied with the _-_O or _-_F _(_-_-_f_i_l_e_) option.
  148.  
  149.        _-_b_, _-_-_s_w_a_p
  150.               In copy-in mode, swap both halfwords of  words  and
  151.               bytes of halfwords in the data.  Equivalent to _-_s_S.
  152.               Use this option to convert 32-bit integers  between
  153.               big-endian and little-endian machines.
  154.  
  155.        _-_B     Set  the  I/O  block size to 5120 bytes.  Initially
  156.               the block size is 512 bytes.
  157.  
  158.        _-_-_b_l_o_c_k_-_s_i_z_e_=_B_L_O_C_K_-_S_I_Z_E
  159.               Set the I/O block size to BLOCK-SIZE * 512 bytes.
  160.  
  161.        _-_c     Use the old portable (ASCII) archive format.
  162.  
  163.        _-_C _I_O_-_S_I_Z_E_, _-_-_i_o_-_s_i_z_e_=_I_O_-_S_I_Z_E
  164.               Set the I/O block size to IO-SIZE bytes.
  165.  
  166.        _-_d_, _-_-_m_a_k_e_-_d_i_r_e_c_t_o_r_i_e_s
  167.               Create leading directories where needed.
  168.  
  169.        _-_E _F_I_L_E_, _-_-_p_a_t_t_e_r_n_-_f_i_l_e_=_F_I_L_E
  170.               In copy-in mode, read additional patterns  specify-
  171.               ing  filenames  to  extract or list from FILE.  The
  172.               lines of FILE are treated as if they had been  non-
  173.               option arguments to ccppiioo.
  174.  
  175.        _-_f_, _-_-_n_o_n_m_a_t_c_h_i_n_g
  176.               Only  copy files that do not match any of the given