10.0;cpl (copy_link), revision 1.0, 88/01/21
cpl (copy_link) -- Copy a link.
usage: cpl linkname [pathname] [-c|-r] [-chn] [-ll] [-ldl] {cl}
DESCRIPTION
cpl copies a linkname to the target object. Multiple linkname/pathname
pairs and wildcarding are permitted, however while you can use a wildcard
with the source argument, you cannot with the destination.
ARGUMENTS
linkname (required)
Specify the name of the link to be copied.
pathname (optional)
Specify the target pathname of the copied link. If
pathname is a linkname, then this link is created or
replaced (depending on various options below). If
pathname is a directory, the link text is copied into this
directory. In no case is the object to which the link
refers affected; only the text of the link itself.
Default if omitted: copy link into current working
directory
OPTIONS
-c (default) Create source link at target. An error occurs if the
target link already exists.
-r Replace target with copy of source.
-ll List links copied.
-ldl List links deleted because of replacement (-r).
-chn Change name of existing link with target_pathname before
copying.
-p[airwise] If you use more than one pair of name tokens with this
command, you must use the -p option. It instructs the
command to accept the list of tokens as consecutive pairs.
This is necessary whether you are using wildcards or not.
In the past, this command has correctly paired off tokens
without the prompting of a switch; now the -p switch must
be used to acheive this result. The switch has been added
to protect against inadvertent use in a shell, other than
/com/sh, where wildcard expansion can be a problem.
EXAMPLES
Copy the link //ai/sources to the node entry directory as progs.
$ cpl //ai/sources /progs
Copy the link /sys/print from the node whose entry directory is zorba to
the local /sys directory, replacing any existing link.
$ cpl //zorba/sys/print /sys -r