.TH "make_growfs" 1 "" "CCTools 7.0.9 FINAL" "Cooperative Computing Tools"

.SH NAME
.LP
\fBmake_growfs\fP - generate directory listings for the GROW filesystem

.SH SYNOPSIS
.LP
\FC\fBmake_growfs [options] <directory>\fP\FT

.SH DESCRIPTION
.LP

\fBmake_growfs\fP prepares a local filesystem to be exported as
a GROW filesystem which can be accessed by \fBparrot_run(1)\fP.
Given a directory as an argument, it recursively visits all of
the directories underneath and creates files named \FC.__growfsdir\FT
that summarize the metadata of all files in that directory.
.PP
Once the directory files are generated, the files may be accessed
through a web server as if there were on a full-fledged filesystem
with complete metadata.

.SH OPTIONS
.LP

.LP
.TP
.B \ -v
.
Give verbose messages.
.TP
.B \ -K
.
Create checksums for files. (default)
.TP
.B \ -k
.
Disable checksums for files.
.TP
.B \ -f
.
Follow all symbolic links.
.TP
.B \ -F
.
Do not follow any symbolic links.
.TP
.B \ -a
.
Only follow links that fall outside the root.  (default)
.TP
.B \ -h
.
Show help text.


.SH EXIT STATUS
.LP
On success, returns zero.  On failure, returns non-zero.

.SH EXAMPLES
.LP

Suppose that your university web server exports the
directory \FC/home/fred/www\FT as \FChttp://www.somewhere.edu/fred\FT.
To create a GROW filesystem, put whatever files and directories you
like into \FC/home/fred/www\FT.  Then, run the following to generate
the GROW data:

.fam C
.nf
.nh
.IP "" 8
% make_growfs /home/fred/www
.fi
.hy
.fam
.P

Now that the GROW data is generated, you can use \fBparrot_run(1)\fP
to treat the web address as a read-only filesystem:

.fam C
.nf
.nh
.IP "" 8
% parrot_run bash
% cd /growfs/www.somewhere.edu/fred
% ls -la
.fi
.hy
.fam
.P

.SH COPYRIGHT
.LP

The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain and Copyright (C) 2005-2015 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
The Cooperative Computing Tools (\fB"http://ccl.cse.nd.edu/software/manuals"\fP)
.IP \(bu 4
Parrot User Manual (\fB"http://ccl.cse.nd.edu/software/manuals/parrot.html"\fP)
.IP \(bu 4
\fBparrot_run(1)\fP