1 02/13/85  link, lk
 2 
 3 Syntax as a command:  lk path1 {path2...path1N path2N} {-control_args}
 4 
 5 
 6 Function: creates a storage system link with a specified name in a
 7 specified directory pointing to a specified segment, directory, or link
 8 (for a discussion of links, see the Programmer's Reference Manual).
 9 
10 
11 Arguments:
12 path1
13    specifies the pathname of the storage system entry to which path2N
14    is to point.  The star convention is allowed.  Give the pathnames in
15    pairs.
16 path2
17    specifies the pathname of the link to be created.  If omitted (in
18    the final argument position of a command line only), a link to path1
19    is created in your working directory with the entryname portion of
20    path1N as its entryname.  The equal convention is allowed.
21 
22 
23 Control arguments:
24 -chase
25    creates a link to the ultimate target of path1 if path1 is a link.
26    The default is to create a link to path1 itself.
27 -no_chase
28    creates a link directly to the target specified.  (Default)
29 -check, -ck
30    refuses to create a link if the target does not exist or if its
31    existence cannot be determined due to access.
32 -no_check, -nck
33    creates a link whether or not the target exists.  (Default)
34 -copy_names, -cpnm
35    copies the names of the target to the link after creating it.
36 
37 
38 -no_copy_names, -ncpnm
39    does not copy the names of the target.  (Default)
40 -name STR, -nm STR
41    specifies an entryname STR (either as a path1 or a path2, depending
42    on position) that begins with a minus to distinguish it from a
43    control argument.
44 
45 
46 Access required: You must have append permission for the directory in
47 which the link is to be created.
48 
49 
50 Notes: Entrynames must be unique within the directory.  If the
51 creation of a specified link introduces a duplication of names within
52 the directory and if the old entry has only one name, you are asked
53 whether to delete the entry with the old name.  If you answer "no", the
54 link is not created.  If the old entry has multiple names, the
55 conflicting name is removed and a message is issued to you.  In either
56 case since the directory in which the link is to be created is being
57 changed, you must have modify permission for that directory.
58 
59 See the create_dir and create commands for the creation of directories
60 and segments.