mkdir

Creates a directory element

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

mkdir [ -nco ] [ -c·omment comment | -cfi·le comment-file-pname |-cq·uery

| -cqe·ach | -nc·omment ] 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. (You can also use the standard Windows mkdir command, but that creates 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.

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 the clearexport_ffile and clearimport utilities.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required. An error occurs if any of the following objects are locked: VOB, element type.

OPTIONS AND ARGUMENTS

CHECKOUT OF THE NEW DIRECTORY.  Default: mkelem 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 CUSTOMIZING COMMENT HANDLING in 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.

NAMING THE DIRECTORIES.  Default: None.

dir-pname ...

One or more pathnames, specifying directories to be created.

EXAMPLES

Examples including 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 command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

• Create a subdirectory named subd, and check out the directory to the current view.

cmd-context mkdir -nc subd
Created directory element "subd".
Checked out "subd" from version "\main\0".

• Create a subdirectory named release, but do not check it out. Provide a comment on the command line.

cmd-context mkdir -nco -c "Storage directory for released files" release
Created directory element "release".

SEE ALSO

checkout, mv, protect, pwd, rmelem, update