mkdir
Creates a directory element
SYNOPSIS
- mkdir [ –nco ] [ –c·omment comment | –cfi·le comment-file-pname |–cq·uery
- | –cqe·ach | –nc·omment ]
[–master ] dir-pname ...
DESCRIPTION
Note: A new directory
element can be created only if its parent directory is checked out. mkdir appends
an appropriate line to the parent directory's checkout comment.
The mkdir command creates
one or more directory elements. (Operating system directory creation commands
create view-private directories, not elements.) Unless you specify the –nco (no
checkout) option, the new directory is checked out automatically. A directory
element must be checked out before you can create elements and VOB links within
it.
The mkelem –eltype directory command
is equivalent to this command.
The new directory element is associated with
the same storage pools (source, derived object, and cleartext) as its parent
directory element. You can assign the directory to different pools with the chpool command. Note that the directory itself is
stored in the database, but files created in the directory are stored in the
pools associated with the directory.
In a snapshot view, this command also updates
the directory element.
UNIX File Modes
New directory elements are created with mode
777, as modified by your umask. However, the meanings
of the read, write, and execute permissions do not have their standard UNIX
meanings. See the protect reference page
for details.
Converting View-Private Directories
You cannot create a directory element with
the same name as an existing view-private file or directory, and you cannot
use mkdir to convert an existing view-private directory
structure into directory and file elements. To accomplish this task, use clearfsimport.
RESTRICTIONS
Identities
No special identity
is required.
Locks
An error occurs if one
or more of these objects are locked: VOB, element type.
Mastership
(Replicated VOBs
only) No mastership restrictions.
OPTIONS AND ARGUMENTS
Checkout of the New Directory
- Default
- mkdir checks out the new
directory element.
- –nco
- Suppresses checkout of the new directory element.
Event Records and Comments
- Default
- Creates one or more event records, with commenting
controlled by your .clearcase_profile file (default: –cqe).
See the comments reference page. Comments
can be edited with chevent.
- –c·omment comment | –cfi·le comment-file-pname |–cq·uery | –cqe·ach | –nc·omment
- Overrides the default with the option you
specify. See the comments reference page.
Mastership of the Main Branch
- Default
- Assigns mastership of the directory element's main branch
to the VOB replica that masters the main branch type.
- –master
- Assigns mastership of the main branch
of the directory element to the VOB replica in which you execute the mkdir command.
If your config spec includes –mkbranch lines or mkbranch rules
that apply to the directory element, and you do not use the –nco option, mkdir creates
these branches and assigns their mastership to the current VOB replica. mkdir also
prints a note that these branches are explicitly mastered by the current replica;
the output also displays the master replica of each associated branch type.
Naming the Directories
- Default
- None.
- dir-pname ...
- One or more pathnames, specifying directories
to be created.
EXAMPLES
The UNIX examples in this section are written for use in csh.
If you use another shell, you may need to use different quoting and escaping
conventions.
The Windows examples that include wildcards or quoting are written for
use in cleartool interactive mode. If you use cleartool single-command
mode, you may need to change the wildcards and quoting to make your command
interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents
the UNIX shell or Windows command interpreter prompt, followed by the cleartool command.
In cleartool interactive mode, cmd-context represents
the interactive cleartool prompt.
- Create
a subdirectory named subd and check out the directory
to the current view.
- Create
a subdirectory named release, but do not check it out.
Provide a comment on the command line.
SEE ALSO
checkout, chevent, chpool, clearfsimport, cleartool, comments, mkelem, mv,
protect,
pwd, rmelem, update