10.0;crl (create_link), revision 1.0, 88/01/18
crl (create_link) -- Create a link.
usage: crl linkname object_name ... [-p] [-r] {CL}
DESCRIPTION
crl is used to create links. Links normally serve two functions: as a
shorthand way of specifying objects with long (and frequently recurring)
pathnames and as static pointers to other objects.
Links cause the shell to redirect a pathname to another object. In
effect, links allow you to take a detour from one part of the naming tree
to another.
Multiple linkname/pathname pairs are permitted. Wildcards are not
permitted with linkname/pathname pairs.
ARGUMENTS
linkname (required)
Specify the link's name and location.
object_name (required)
Specify the object to which the link points.
OPTIONS
-p[airwise] Instructs crl to accept the list of tokens as
consecutive pairs. This is necessary whether you are
using wildcards or not.
-r Replace an existing link. Use this option to change a
link's object_name.
NOTES
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
Create a link called bugs in the current working directory.
$ crl bugs /maintenance/reports
Now, when you use bugs in a pathname, the command shell substitutes the
text /maintenance/reports. Therefore, the pathname
bugs/sticky_cursor
refers to the same file as the pathname
/maintenance/reports/sticky_cursor