.TH "parrot_mkalloc" 1 "" "CCTools 7.1.2 FINAL" "Cooperative Computing Tools"

.SH NAME
.LP
\fBparrot_mkalloc\fP - create a directory with a space allocation

.SH SYNOPSIS
.LP
\FC\fBparrot_mkalloc <path> <size>\fP\FT

.SH DESCRIPTION
.LP

\FCparrot_mkalloc\FT creates a new directory with a space allocation.
As the name suggests, the command only runs correctly inside of the
Parrot virtual file system, on file servers where space allocation is enabled.
.PP
The \fBpath\fP argument gives the new directory to create, and
the \fBsize\fP argument indicates how large the space allocation should be.
The latter may use metric units such as K, M, B, etc to indicate kilobytes,
megabytes, gigabytes, and so forth.

.SH OPTIONS
.LP

.LP
.TP
.B \ -h
.
Show help text.



.SH EXIT STATUS
.LP
On success, returns zero.  On failure, returns non-zero.
If the command is attempted on a filesystem that does not support
space allocation, it will give the following error:

.fam C
.nf
.nh
.IP "" 8
parrot_mkalloc: This filesystem does not support allocations.
.fi
.hy
.fam
.P

.SH EXAMPLES
.LP

To create a space allocation of ten gigabytes on a Chirp server:

.fam C
.nf
.nh
.IP "" 8
% parrot_run bash
% cd /chirp/myserver.somewhere.edu
% parrot_mkalloc bigdir 10G
% exit
.fi
.hy
.fam
.P

.SH COPYRIGHT
.LP

The Cooperative Computing Tools are Copyright (C) 2005-2019 The University of Notre Dame.  This software is distributed under the GNU General Public License.  See the file COPYING for details.

.SH SEE ALSO
.LP

.IP \(bu 4
\fBCooperative Computing Tools Documentation\fP
.IP \(bu 4
\fBParrot User Manual\fP
.IP \(bu 4
\fBparrot_run(1)\fP \fBparrot_cp(1)\fP \fBparrot_getacl(1)\fP  \fBparrot_setacl(1)\fP  \fBparrot_mkalloc(1)\fP  \fBparrot_lsalloc(1)\fP  \fBparrot_locate(1)\fP  \fBparrot_timeout(1)\fP  \fBparrot_whoami(1)\fP  \fBparrot_mount(1)\fP  \fBparrot_md5(1)\fP  \fBparrot_package_create(1)\fP  \fBparrot_package_run(1)\fP  \fBchroot_package_run(1)\fP