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

.SH NAME
.LP
\fBchirp_server\fP - create a Chirp user-level filesystem

.SH SYNOPSIS
.LP
\FC\fBchirp_server [options]\fP\FT

.SH DESCRIPTION
.LP

.PP
Starts a Chirp server which allows the sharing of data with friends and
colleagues without requiring any administrator privileges.  Chirp provides an
RPC network interface to a "backend" filesystem which can be the local
filesystem or even the Hadoop HDFS filesystem. Chirp supports flexible and
robust ACL management of data.

.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-\-default-acl\fP=\fI<file>\fP
.
Use this file as the default ACL.
.TP
.B \ --inherit-default-acl
.
 Directories without an ACL inherit from parent directories.
.TP
\fB-a\fP, \fB-\-auth\fP=\fI<method>\fP
.
Enable this authentication method.
.TP
.B \ -b, --background
.
Run as daemon.
.TP
\fB-B\fP, \fB-\-pid-file\fP=\fI<file>\fP
.
Write PID to file.
.TP
.B \ -C, --no-core-dump
.
Do not create a core dump, even due to a crash.
.TP
\fB-c\fP, \fB-\-challenge-dir\fP=\fI<dir>\fP
.
Challenge directory for unix filesystem authentication.
.TP
\fB-d\fP, \fB-\-debug\fP=\fI<flag>\fP
.
Enable debugging for this sybsystem
.TP
.B \ -E, --parent-death
.
Exit if parent process dies.
.TP
\fB-e\fP, \fB-\-parent-check\fP=\fI<time>\fP
.
Check for presence of parent at this interval. (default is 300s)
.TP
\fB-F\fP, \fB-\-free-space\fP=\fI<size>\fP
.
Leave this much space free in the filesystem.
.TP
\fB-G\fP, \fB-\-group-url\fP=\fI<url>\fP
.
Base url for group lookups. (default: disabled)
.TP
.B \ -h, --help
.
Give help information.
.TP
\fB-I\fP, \fB-\-interface\fP=\fI<addr>\fP
.
Listen only on this network interface.
.TP
\fB-M\fP, \fB-\-max-clients\fP=\fI<count>\fP
.
Set the maximum number of clients to accept at once. (default unlimited)
.TP
\fB-n\fP, \fB-\-catalog-name\fP=\fI<name>\fP
.
Use this name when reporting to the catalog.
.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-O\fP, \fB-\-debug-rotate-max\fP=\fI<bytes>\fP
.
Rotate debug file once it reaches this size.
.TP
\fB-P\fP, \fB-\-superuser\fP=\fI<user>\fP
.
Superuser for all directories. (default is none)
.TP
\fB-p\fP, \fB-\-port\fP=\fI<port>\fP
.
Listen on this port (default is 9094, arbitrary is 0)
.TP
.BI \ --project-name \ <name>
.
Project name this Chirp server belongs to.
.TP
\fB-Q\fP, \fB-\-root-quota\fP=\fI<size>\fP
.
Enforce this root quota in software.
.TP
.B \ -R, --read-only
.
Read-only mode.
.TP
\fB-r\fP, \fB-\-root\fP=\fI<url>\fP
.
URL of storage directory, like file://path or hdfs://host:port/path.
.TP
\fB-s\fP, \fB-\-stalled\fP=\fI<time>\fP
.
Abort stalled operations after this long. (default is 3600s)
.TP
\fB-T\fP, \fB-\-group-cache-exp\fP=\fI<time>\fP
.
Maximum time to cache group information. (default is 900s)
.TP
\fB-t\fP, \fB-\-idle-clients\fP=\fI<time>\fP
.
Disconnect idle clients after this time. (default is 60s)
.TP
\fB-U\fP, \fB-\-catalog-update\fP=\fI<time>\fP
.
Send status updates at this interval. (default is 5m)
.TP
\fB-u\fP, \fB-\-advertize\fP=\fI<host>\fP
.
Send status updates to this host. (default is catalog.cse.nd.edu)
.TP
.B \ -v, --version
.
Show version info.
.TP
\fB-W\fP, \fB-\-passwd\fP=\fI<file>\fP
.
Use alternate password file for unix authentication
.TP
\fB-w\fP, \fB-\-owner\fP=\fI<name>\fP
.
The name of this server's owner.  (default is username)
.TP
\fB-y\fP, \fB-\-transient\fP=\fI<dir>\fP
.
Location of transient data (default is pwd).
.TP
\fB-Z\fP, \fB-\-port-file\fP=\fI<file>\fP
.
Select port at random and write it to this file.  (default is disabled)
.TP
\fB-z\fP, \fB-\-unix-timeout\fP=\fI<time>\fP
.
Set max timeout for unix filesystem authentication. (default is 5s)


.SH ENVIRONMENT VARIABLES
.LP


.IP \(bu 4
\FC\fBCATALOG_HOST\fP\FT Hostname of catalog server (same as \FC-u\FT).
.IP \(bu 4
\FC\fBTCP_LOW_PORT\fP\FT Inclusive low port in range used with \FC-Z\FT.
.IP \(bu 4
\FC\fBTCP_HIGH_PORT\fP\FT Inclusive high port in range used with \FC-Z\FT.


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

.SH EXAMPLES
.LP

To start a Chirp server with a local root directory:

.fam C
.nf
.nh
.IP "" 8
% chirp_server -r file:///tmp/foo
.fi
.hy
.fam
.P

Setting various authentication modes:

.fam C
.nf
.nh
.IP "" 8
% chirp_server -a hostname -a unix -a ticket -r file:///tmp/foo
.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