home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / fileutil.lha / fileutils-3.3 / cat / cp.1 < prev    next >
Encoding:
Text File  |  1992-08-28  |  5.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. CP(1L)            MISC. REFERENCE MANUAL PAGES             CP(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      cp - copy files
  10.  
  11. SYNOPSIS
  12.      cp [options] source dest
  13.      cp [options] source... directory
  14.      Options:
  15.      [-abdfilprsuvxPR]       [-S        backup-suffix]        [-V
  16.      {numbered,existing,simple}]   [--backup]  [--no-dereference]
  17.      [--force] [--interactive]  [--one-file-system]  [--preserve]
  18.      [--recursive]   [--update]   [--verbose]   [--suffix=backup-
  19.      suffix]       [--version-control={numbered,existing,simple}]
  20.      [--archive] [--path] [--link] [--symbolic-link]
  21.  
  22. DESCRIPTION
  23.      This manual page documents the GNU version of  cp.   If  the
  24.      last  argument  names  an existing directory, cp copies each
  25.      other given file into a file with  the  same  name  in  that
  26.      directory.   Otherwise,  if  only  two  files  are given, it
  27.      copies the first onto the second.  It is  an  error  if  the
  28.      last argument is not a directory and more than two files are
  29.      given.  By default, it does not copy directories.
  30.  
  31.   OPTIONS
  32.      -_a, --_a_r_c_h_i_v_e
  33.           Preserve as much  as  possible  of  the  structure  and
  34.           attributes of the original files in the copy.  The same
  35.           as -_d_p_R.
  36.  
  37.      -_b, --_b_a_c_k_u_p
  38.           Make backups of files that are about to be  overwritten
  39.           or removed.
  40.  
  41.      -_d, --_n_o-_d_e_r_e_f_e_r_e_n_c_e
  42.           Copy symbolic links as symbolic links rather than copy-
  43.           ing  the  files  that  they point to, and preserve hard
  44.           link relationships between source files in the copies.
  45.  
  46.      -_f, --_f_o_r_c_e
  47.           Remove existing destination files.
  48.  
  49.      -_i, --_i_n_t_e_r_a_c_t_i_v_e
  50.           Prompt whether to overwrite existing  regular  destina-
  51.           tion files.
  52.  
  53.      -_l, --_l_i_n_k
  54.           Make hard links instead of copies of non-directories.
  55.  
  56.      -_P, --_p_a_t_h
  57.           Form the pathname of each destination file by appending
  58.           to the target directory a slash and the pathname of the
  59.           source file.  The last argument given to cp must be the
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CP(1L)            MISC. REFERENCE MANUAL PAGES             CP(1L)
  71.  
  72.  
  73.  
  74.           name  of  an existing directory.  For example, the com-
  75.           mand `cp --path a/b/c  existing_dir'  copies  the  file
  76.           _a/_b/_c   to  _e_x_i_s_t_i_n_g__d_i_r/_a/_b/_c,  creating  any  missing
  77.           intermediate directories.
  78.  
  79.      -_p, --_p_r_e_s_e_r_v_e
  80.           Preserve the original files' owner, group, permissions,
  81.           and timestamps.
  82.  
  83.      -_r   Copy  directories   recursively,   copying   all   non-
  84.           directories as if they were regular files.
  85.  
  86.      -_s, --_s_y_m_b_o_l_i_c-_l_i_n_k
  87.           Make  symbolic  links  instead  of   copies   of   non-
  88.           directories.   All  source files must be absolute path-
  89.           names (starting with `/') unless the destination  files
  90.           are in the current directory.
  91.  
  92.      -_u, --_u_p_d_a_t_e
  93.           Do not copy a nondirectory that has an existing  desti-
  94.           nation with the same or newer modification time.
  95.  
  96.      -_v, --_v_e_r_b_o_s_e
  97.           Print the name of each file before copying it.
  98.  
  99.      -_x, --_o_n_e-_f_i_l_e-_s_y_s_t_e_m
  100.           Skip subdirectories that are on  different  filesystems
  101.           from the one that the copy started on.
  102.  
  103.      -_R, --_r_e_c_u_r_s_i_v_e
  104.           Copy directories recursively.
  105.  
  106.      -_S, --_s_u_f_f_i_x _b_a_c_k_u_p-_s_u_f_f_i_x
  107.           The suffix used for making simple backup files  can  be
  108.           set with the SIMPLE_BACKUP_SUFFIX environment variable,
  109.           which can be overridden by this option.  If neither  of
  110.           those is given, the default is `~', as it is in Emacs.
  111.  
  112.      -_V, --_v_e_r_s_i_o_n-_c_o_n_t_r_o_l {_n_u_m_b_e_r_e_d,_e_x_i_s_t_i_n_g,_s_i_m_p_l_e}
  113.           The  type  of  backups  made  can  be  set   with   the
  114.           VERSION_CONTROL  environment  variable,  which  can  be
  115.           overridden by this option.  If VERSION_CONTROL  is  not
  116.           set  and  this  option is not given, the default backup
  117.           type is `existing'.  The value of  the  VERSION_CONTROL
  118.           environment  variable  and  the argument to this option
  119.           are like the GNU Emacs `version-control' variable; they
  120.           also recognize synonyms that are more descriptive.  The
  121.           valid values are (unique abbreviations are accepted):
  122.  
  123.           `t' or `numbered'
  124.                Always make numbered backups.
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CP(1L)            MISC. REFERENCE MANUAL PAGES             CP(1L)
  137.  
  138.  
  139.  
  140.           `nil' or `existing'
  141.                Make numbered backups of files that  already  have
  142.                them, simple backups of the others.
  143.  
  144.           `never' or `simple'
  145.                Always make simple backups.
  146.  
  147.      The long-named options can be introduced with `+' as well as
  148.      `--',  for compatibility with previous releases.  Eventually
  149.      support for `+' will be removed, because it is  incompatible
  150.      with the POSIX.2 standard.
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sun Release 4.1           Last change:                          3
  196.  
  197.  
  198.  
  199.