home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / gnu / fileutils-3.9-bin.lha / man / cat1 / cp.0 < prev    next >
Encoding:
Text File  |  1993-12-07  |  6.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. CP(1L)                                                     CP(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        cp - copy files
  9.  
  10. SSYYNNOOPPSSIISS
  11.        ccpp [options] source dest
  12.        ccpp [options] source... directory
  13.        Options:
  14.        [-abdfilprsuvxPR]    [-S    backup-suffix]    [-V    {num-
  15.        bered,existing,simple}]   [--backup]    [--no-dereference]
  16.        [--force] [--interactive] [--one-file-system] [--preserve]
  17.        [--recursive]  [--update]  [--verbose]   [--suffix=backup-
  18.        suffix]     [--version-control={numbered,existing,simple}]
  19.        [--archive] [--path] [--link]  [--symbolic-link]  [--help]
  20.        [--version]
  21.  
  22. DDEESSCCRRIIPPTTIIOONN
  23.        This  manual page documents the GNU version of ccpp.  If the
  24.        last argument names an existing directory, ccpp 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
  29.        are given.  By default, it does not copy directories.
  30.  
  31.    OOPPTTIIOONNSS
  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
  35.               same as _-_d_p_R.
  36.  
  37.        _-_b_, _-_-_b_a_c_k_u_p
  38.               Make  backups  of  files that are about to be over-
  39.               written 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
  43.               copying  the files that they point to, and preserve
  44.               hard link relationships between source files in the
  45.               copies.
  46.  
  47.        _-_f_, _-_-_f_o_r_c_e
  48.               Remove existing destination files.
  49.  
  50.        _-_i_, _-_-_i_n_t_e_r_a_c_t_i_v_e
  51.               Prompt whether to overwrite existing regular desti-
  52.               nation files.
  53.  
  54.        _-_l_, _-_-_l_i_n_k
  55.               Make  hard  links  instead  of   copies   of   non-
  56.               directories.
  57.  
  58.        _-_P_, _-_-_p_a_t_h
  59.               Form  the  pathname  of  each  destination  file by
  60.               appending to the target directory a slash  and  the
  61.  
  62.  
  63.  
  64. FSF                     GNU File Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CP(1L)                                                     CP(1L)
  71.  
  72.  
  73.               pathname  of  the  source  file.  The last argument
  74.               given to ccpp must be the name of an existing  direc-
  75.               tory.   For  example,  the command `cp --path a/b/c
  76.               existing_dir'  copies  the  file  _a_/_b_/_c  to  _e_x_i_s_t_-
  77.               _i_n_g___d_i_r_/_a_/_b_/_c_,  creating  any  missing intermediate
  78.               directories.
  79.  
  80.        _-_p_, _-_-_p_r_e_s_e_r_v_e
  81.               Preserve the original files' owner, group,  permis-
  82.               sions, and timestamps.
  83.  
  84.        _-_r     Copy  directories  recursively,  copying  all  non-
  85.               directories as if they were regular files.
  86.  
  87.        _-_s_, _-_-_s_y_m_b_o_l_i_c_-_l_i_n_k
  88.               Make symbolic  links  instead  of  copies  of  non-
  89.               directories.   All  source  files  must be absolute
  90.               pathnames (starting with `/') unless  the  destina-
  91.               tion  files  are  in  the  current directory.  This
  92.               option produces an error message on systems that do
  93.               not support symbolic links.
  94.  
  95.        _-_u_, _-_-_u_p_d_a_t_e
  96.               Do  not  copy  a  nondirectory that has an existing
  97.               destination with the  same  or  newer  modification
  98.               time.
  99.  
  100.        _-_v_, _-_-_v_e_r_b_o_s_e
  101.               Print the name of each file before copying it.
  102.  
  103.        _-_x_, _-_-_o_n_e_-_f_i_l_e_-_s_y_s_t_e_m
  104.               Skip  subdirectories that are on different filesys-
  105.               tems from the one that the copy started on.
  106.  
  107.        _-_R_, _-_-_r_e_c_u_r_s_i_v_e
  108.               Copy directories recursively.
  109.  
  110.        _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
  111.               tus.
  112.  
  113.        _-_-_v_e_r_s_i_o_n
  114.               Print  version  information  on standard error then
  115.               exit.
  116.  
  117.        _-_S_, _-_-_s_u_f_f_i_x _b_a_c_k_u_p_-_s_u_f_f_i_x
  118.               The suffix used for making simple backup files  can
  119.               be  set  with  the SSIIMMPPLLEE__BBAACCKKUUPP__SSUUFFFFIIXX environment
  120.               variable, which can be overridden by  this  option.
  121.               If  neither  of those is given, the default is `~',
  122.               as it is in Emacs.
  123.  
  124.        _-_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_}
  125.               The type of backups made can be set with  the  VVEERR--
  126.               SSIIOONN__CCOONNTTRROOLL  environment  variable,  which  can be
  127.  
  128.  
  129.  
  130. FSF                     GNU File Utilities                      2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CP(1L)                                                     CP(1L)
  137.  
  138.  
  139.               overridden by this option.  If  VVEERRSSIIOONN__CCOONNTTRROOLL  is
  140.               not  set  and this option is not given, the default
  141.               backup type is `existing'.  The value of  the  VVEERR--
  142.               SSIIOONN__CCOONNTTRROOLL  environment variable and the argument
  143.               to this option are like  the  GNU  Emacs  `version-
  144.               control'  variable;  they  also  recognize synonyms
  145.               that are more descriptive.  The  valid  values  are
  146.               (unique abbreviations are accepted):
  147.  
  148.               `t' or `numbered'
  149.                      Always make numbered backups.
  150.  
  151.               `nil' or `existing'
  152.                      Make  numbered backups of files that already
  153.                      have them, simple backups of the others.
  154.  
  155.               `never' or `simple'
  156.                      Always make simple backups.
  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.  
  196. FSF                     GNU File Utilities                      3
  197.  
  198.  
  199.