.\" cvmkdir.1: auto-generated, DO NOT EDIT
.\"
.\" Copyright 1999-2014. Quantum Corporation. All Rights Reserved.
.\" StorNext is either a trademark or registered trademark of
.\" Quantum Corporation in the US and/or other countries.
.\"
.\" Code start macro
.de Cs
.sp
.ft C
.in +0.3i
.nf
..
.\" Code end macro
.de Ce
.fi
.in -0.3i
.ft R
..
.TH CVMKDIR 1 "June 2014" "Xsan File System"
.SH NAME
cvmkdir \- Create an Xsan Directory with an Affinity
.SH SYNOPSIS
.na
.nh
.HP
.B cvmkdir
.RB [ \-k \ \fIkey\fP]
.I dirname
.ad
.hy
.SH DESCRIPTION
The \fBcvmkdir\fR command creates a \fIXsan File System\fR
directory and attaches an affinity parameter (\fIkey\fR) to it.
If no option is used and the directory exists,
the \fBcvmkdir\fR command displays the assigned affinity.
Once an affinity is assigned to a directory, it cannot be altered.
If no \fIkey\fR is specified and the directory does not exist,
the directory will not be created.
.PP
An affinity may be dissociated from a directory by specifying an empty key (e.g., "").
.PP
See
.BR snfs_config (5)
for details about affinities to storage pools.
.SH OPTIONS
.IP "\fB\-k\fP \fIkey\fP"
Specify to the file system what affinity (\fIkey\fR)
to associate with the directory. 
All new sub-directories and files created beneath this directory inherit its affinity.
If the affinity is changed or removed only files or directories 
created after the change are affected.
.IP \fIdirname\fR
The path of the directory to be created.
.SH "SEE ALSO"
.BR cvmkfile (1),
.BR cvaffinity (1),
.BR snfs_config (5)