1 02/08/85  create_dir, cd
 2 
 3 Syntax as a command:  cd paths {-control_args}
 4 
 5 
 6 Function: creates a specified directory branch in a specified
 7 directory or in your working directory; that is, it creates a storage
 8 system entry for an empty subdirectory.
 9 
10 
11 Arguments:
12 paths
13    are pathnames of directories to be created.
14 
15 
16 Control arguments:
17 -access_class STR, -acc STR
18    applies to each pathi and upgrades each directory created to the
19    specified access class.  You can give the access class with either
20    long or short names.
21 -account STR, -acct STR
22    specifies the volume quota account from which the created master
23    directory is to draw its quota, where STR must match an existing
24    quota account on the given logical volume.  If omitted, an account
25    that matches the owner User_id is used (if any).  You can supply
26    -account only if you select -logical_volume.
27 -dir_quota N
28    specifies the directory quota to be given to the directory when it
29    is created, where N must be a positive integer and applies to each
30    pathi.  If omitted, the directory is given zero directory quota.
31 
32 
33 -logical_volume VOL, -lv VOL
34    specifies that each directory created is to be a master directory
35    whose segments are to reside on the logical volume named VOL.
36 -name STR, -nm STR
37    specifies an entryname STR that begins with a minus sign, to
38    distinguish it from a control argument, or consists solely of white
39    space.
40 -owner USER_ID, -ow USER_ID
41    specifies the owner of the created master directory.  You can supply
42    -owner only if you select -logical_volume.  (Default: your User_id)
43 
44 
45 -quota N
46    specifies the segment quota to be given to the directory when it is
47    created, where N must be a positive integer and applies to each
48    pathi.  You must provide -quota if you use either -access_class or
49    -logical_volume.  If omitted, the directory is given zero segment
50    quota.
51 -ring_brackets N1 {N2}, -rb N1 {N2}
52    specifies the ring brackets of the created directory.  N2 defaults
53    to N1, which defaults to 7.
54 
55 
56 Access required: You must have a access to a directory in order to
57 create a subdirectory in that directory.
58 
59 The -account and -owner control arguments are allowed only for volume
60 administrators (i.e., only those who have e access to the volume).
61 
62 
63 Notes: If you specify a directory or segment quota and the directory
64 you are creating is not a master directory, the containing directory
65 must have sufficient directory or segment quota to move quota to the
66 directory being created (see move_quota).
67 
68 If the creation of a new subdirectory introduces a duplication of names
69 within the directory and if the old entry has only one name, you are
70 asked whether to delete the old entry.  If the old entry has multiple
71 names, the conflicting name is removed and a message is issued to you.
72 You are given sma access on the created subdirectory.
73 
74 All superior directories specified in pathi must already exist.  That
75 is, you can only create a single level of storage system directory
76 hierarchy in a single invocation of create_dir.
77 
78 
79 To create a master directory, you must have a quota account on the
80 logical volume with sufficient volume quota to create the directory.
81 If you are not a volume administrator, you can create a master
82 directory only if the administrator has created a quota account that
83 matches your User_id.  A master directory must always have a nonzero
84 quota; therefore you must always give -quota when creating a master
85 directory.  You can create a master directory even though the logical
86 volume is not mounted.
87 
88 Each upgraded directory must have a quota greater than zero and must
89 have an access class that is greater than its containing directory.
90 The specified access class must also be less than, or equal to, the
91 maximum access authorization of the process.
92 
93 
94 When you supply -access_class, the command does not create a new
95 directory through a link.  Creating through links is allowed only when
96 the access class of the containing directory is taken as the default.
97 
98 See the create and link commands for the creation of segments and
99 links.