1 12/08/88  copy, cp
  2 
  3 Syntax as a command:  cp path1 {path2...path1N path2N} {-control_args}
  4 
  5 
  6 Function: copies specified segments, multisegment files (MSFs), data
  7 management (DM) files, and extended entries in the specified
  8 directories with the specified names.  Optionally it copies access
  9 control lists (ACLs), ring brackets, and multiple names.
 10 
 11 
 12 Arguments:
 13 path1
 14    is the pathname of a segment, MSF, DM file, and extended entry to be
 15    copied.  If it is the name of a link, the command copies the target
 16    of the link.  The star convention is allowed.  (See "Notes" below.)
 17 path2
 18    is the pathname of a copy to be created from path1.  If you don't
 19    give path2N, the copy is placed in your working directory with the
 20    entryname of path1.  The equal convention is allowed.
 21 
 22 
 23 Control arguments:
 24 -acl
 25    copies the ACL.
 26 -all, -a
 27    copies multiple names, ACLs, and ring brackets.
 28 -brief, -bf
 29    suppresses warning messages (see "Notes").
 30 -chase
 31    copies the targets of links that match path1 (see "Notes" for the
 32    default).
 33 -extend
 34    appends the contents of path1 to the contents' end of path2.  An
 35    error occurs if path2 does not already exist.
 36 
 37 
 38 -force, -fc
 39    with -extend or -update, forces writing of the file contents
 40    regardless of whether you have write access to path2; in all other
 41    cases (replacing the entire file), forces deletion of an existing
 42    path2.
 43 -interpret_as_extended_entry, -inaee
 44    interpret the selected entry as an extended entry type.
 45 -interpret_as_standard_entry, -inase
 46    interpret the selected entry as a standard entry type.
 47 -long, -lg
 48    prints warning messages.  (Default)
 49 -name, -nm
 50    copies multiple names.
 51 -no_acl
 52    does not copy the ACL.  (Default)
 53 
 54 
 55 -no_chase
 56    does not copy the targets of links that match path1 (see "Notes").
 57 -no_force, -nfc
 58    does not force write without write access or force deletion of an
 59    existing path2.  (Default)
 60 -no_name, -nnm
 61    does not copy multiple names.  (Default)
 62 -no_ring_brackets, -no_rb, -nrb
 63    does not copy ring brackets.  (Default)
 64 -replace, -rp
 65    replaces the entire file path2, rather than modifying its contents
 66    as is done by -extend and -update.  (Default)
 67 
 68 
 69 -ring_brackets, -rb
 70    copies the ring brackets of path1 to path2.  It is incompatible with
 71    -extend and -update.
 72 -update, -ud
 73    replaces the contents of path2 with those of path1 without deleting
 74    path2 or changing any of its attributes.  An error occurs if path2
 75    does not already exist.
 76 
 77 
 78 Access required: You need read access for path1; write access for
 79 path2, unless you use -force with -extend or -update; status permission
 80 for the directory containing path1 if you supply -acl, -all, or -name;
 81 modify permission for the directory containing path2 if you give -acl,
 82 -all, or -name; append permission for the directory containing path2 if
 83 you select neither -extend nor -update.
 84 
 85 
 86 Notes: The control arguments can appear once anywhere after the
 87 command name and apply to the entire command line.
 88 
 89 The default for chasing links depends on path1--if it is not a
 90 starname, links are chased by default; if it is a starname, links are
 91 not chased.
 92 
 93 The initial ACL of the target directory doesn't affect the ACL of the
 94 segment or multisegment file being copied.  The AIM access class of a
 95 segment is not copied by -acl.
 96 
 97 
 98 Since two entries in a directory cannot have the same entryname, copy
 99 takes special action if the name of path1 already exists in the
100 directory specified by path2: if path1 has an alternate name, the
101 entryname that would have resulted in a duplicate name is removed, you
102 are informed of this action, and the copying operation takes place; if
103 path1 has only one entryname, the entry that already exists in the
104 directory must be deleted to remove the name, you are asked if the
105 deletion should be done, and the copying operation does not take place
106 if you answer "no."
107 
108 This command prints a warning message if the bit count of path1 is less
109 than its current length ("Bit count inconsistent with current
110 length...") or if the current length is greater than the number of
111 records used ("Current length is not the same as records used...").
112 
113 
114 If copying a non-empty mailbox requires that the max_length
115 characteristic of the source be applied to the target, then the target
116 max_length value will take on the default value that was given it when
117 created.