1 02/08/85  create, cr
 2 
 3 Syntax as a command:  cr paths {-control_args}
 4 
 5 
 6 Function: creates a segment in a specified directory, or in your
 7 working directory; that is, it creates a storage system entry for an
 8 empty segment.
 9 
10 
11 Arguments:
12 paths
13    are pathnames of segments to be created.
14 
15 
16 Control arguments:
17 -max_length N, -ml N
18    sets the max_length of the created entry to N.  Used with
19    -multisegment_file, -max_length sets future MSF components to N
20    words long.
21 -multisegment_file, -msf
22    creates an MSF with one empty component, instead of an empty
23    segment.  When you foresee that you need much storage, creating an
24    MSF prevents the expensive copying occurring when a segment is
25    converted to an MSF.
26 
27 
28 -name STR, -nm STR
29    specifies an entryname STR that begins with a minus sign, to
30    distinguish it from a control argument.
31 -ring_brackets N1 {N2 {N3}}, -rb N1 {N2 {N3}}
32    specifies the desired ring brackets for the created segment.  N3
33    defaults to N2, which defaults to N1, which defaults to your
34    validation level.
35 
36 
37 Access required: You must have m access to a directory to create the
38 segment, and you are given rw to it.
39 
40 
41 Notes: If there is a one-name segment with an identical name to the
42 segment you are creating, you are asked whether to delete the old
43 segment.  If it has multiple names, the conflicting one is removed and
44 a message is issued to you.  In either case, since the directory is
45 being changed, you must also have modify permission for the directory.
46 
47 All directories specified in paths must already exist; that is, only a
48 single level of the storage system hierarchy can be created with this
49 command.
50 
51 See the create_dir and link commands for the creation of directories
52 and links.