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

.SH NAME
.LP
\fBchirp_fuse\fP - create a \FCFUSE\FT mount point with virtual access to remote chirp servers

.SH SYNOPSIS
.LP
\FC\fBchirp_fuse [options] <mount path>\fP\FT

.SH DESCRIPTION
.LP

.PP
You can attach to a Chirp filesystems by using the FUSE package to attach Chirp
as a kernel filesystem module. Unlike \fBparrot(1)\fP, this requires
superuser privileges to install the FUSE package, but will likely work more
reliably on a larger number of programs and environments. Using FUSE allows for
transparent access to a Chirp server via the local filesystem. This allows user
applications to use a Chirp store unmodified.

.PP
Once you have installed and permissions to use FUSE, simply run chirp_fuse with
the name of a directory on which the filesystem should be mounted.

.PP
For complete details with examples, see the
Chirp User's Manual (\fBhttp://ccl.cse.nd.edu/software/manuals/chirp.html\fP).

.SH OPTIONS
.LP

.LP
.TP
\fB-a\fP, \fB-\-auth\fP=\fI<flag>\fP
.
Require this authentication mode.
.TP
\fB-b\fP, \fB-\-block-size\fP=\fI<bytes>\fP
.
Block size for network I/O. (default is 65536s)
.TP
\fB-d\fP, \fB-\-debug\fP=\fI<flag>\fP
.
Enable debugging for this subsystem.
.TP
.B \ -D, --no-optimize
.
Disable small file optimizations such as recursive delete.
.TP
.B \ -f, --foreground
.
Run in foreground for debugging.
.TP
\fB-i\fP, \fB-\-tickets\fP=\fI<files>\fP
.
Comma-delimited list of tickets to use for authentication.
.TP
\fB-m\fP, \fB-\-mount-options\fP=\fI<option>\fP
.
Pass mount option to FUSE. Can be specified multiple times.
.TP
\fB-o\fP, \fB-\-debug-file\fP=\fI<file>\fP
.
Write debugging output to this file. By default, debugging is sent to stderr (":stderr"). You may specify logs be sent to stdout (":stdout"), to the system syslog (":syslog"), or to the systemd journal (":journal").
.TP
\fB-t\fP, \fB-\-timeout\fP=\fI<timeout>\fP
.
Timeout for network operations. (default is 60s)
.TP
.B \ -v, --version
.
Show program version.
.TP
.B \ -h, --help
.
Give help information.


.SH ENVIRONMENT VARIABLES
.LP


.IP \(bu 4
\FC\fBCHIRP_CLIENT_TICKETS\fP\FT Comma delimited list of tickets to authenticate with (same as \FC-i\FT).


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

.SH EXAMPLES
.LP

To create and use a \FCFUSE\FT mount point for access to remote chirp servers:

.fam C
.nf
.nh
.IP "" 8
% chirp_fuse /tmp/chirp-fuse &
% cd /tmp/chirp-fuse
% ls
% cd host:port
% cat foo/bar
% exit
.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
\fBCooperative Computing Tools Documentation\fP
.IP \(bu 4
\fBChirp User Manual\fP
.IP \(bu 4
\fBchirp(1)\fP  \fBchirp_status(1)\fP  \fBchirp_fuse(1)\fP  \fBchirp_get(1)\fP  \fBchirp_put(1)\fP  \fBchirp_stream_files(1)\fP  \fBchirp_distribute(1)\fP  \fBchirp_benchmark(1)\fP  \fBchirp_server(1)\fP