.TH "parrot_lsalloc" 1 "" "CCTools 8.0.0 DEVELOPMENT" "Cooperative Computing Tools"

.SH NAME
.LP
\fBparrot_lsalloc\fP - list current status of a space allocation

.SH SYNOPSIS
.LP
\FC\fBparrot_lsalloc [path]\fP\FT

.SH DESCRIPTION
.LP

\FCparrot_lsalloc\FT examines a given directory, determines if it is
contained within a space allocation, and then displays the allocation
size and the current usage. 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 directory to examine.
If none is given, the current directory is assumed.

.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_lsalloc: This filesystem does not support allocations.
.fi
.hy
.fam
.P

.SH EXAMPLES
.LP

To list a space allocation on a Chirp server:

.fam C
.nf
.nh
.IP "" 8
% parrot_run bash
% cd /chirp/myserver.somewhere.edu
% parrot_lsalloc bigdir
/chirp/myserver.somewhere.edu/bigdir
10 GB TOTAL
1 GB INUSE
9 GB AVAIL
% 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