'\" t
.\"     Title: gfsd
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 5 March 2016
.\"    Manual: Gfarm
.\"    Source: Gfarm
.\"  Language: English
.\"
.TH "GFSD" "8" "5 March 2016" "Gfarm" "Gfarm"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gfsd \- Gfarm filesystem daemon
.SH "SYNOPSIS"
.HP \w'\fBgfsd\fR\ 'u
\fBgfsd\fR [\fIoptions\fR]
.SH "DESCRIPTION"
.PP
\fBgfsd\fR
is a filesystem daemon for the Gfarm filesystem, which runs on every filesystem node, usually, with root privileges\&.
.PP
\fBgfsd\fR
provides remote file operations with access control in the Gfarm filesystem as well as user authentication, file replication, and node resource status monitoring\&.
.PP
It is possible for
\fBgfsd\fR
to be executed as a non\-privileged user process, although only the user that executes the
\fBgfsd\fR
can be authenticated\&. Other users cannot use it\&. For details, see SETUP\&.private\&.en document\&.
.SH "OPTIONS"
.PP
\fB\-F\fR \fIlog\-file\fR
.RS 4
Specifies a log file\&.
.RE
.PP
\fB\-L\fR \fIlog\-level\fR
.RS 4
Specifies a log priority level\&. The log output, which priority is higher or equal to this level, will be sent to syslog or standard error\&. Please refer gfarm2\&.conf(5) for the priority levels which can be specified by this option\&.
.RE
.PP
\fB\-P\fR \fIpid\-file\fR
.RS 4
Specifies a file name which records the process ID of gfsd\&.
.RE
.PP
\fB\-c\fR
.RS 4
When starting up, gfsd investigates all files stored in a spool directory\&. This option is useful when a hostname of a file system node is changed\&. Valid file copies will be registered to the metadata server\&.
.sp
When the
\fB\-c\fR
option is specified twice (or the
\fB\-cc\fR
option), invalid file copies that are not registered in the metadata server are deleted\&.
.sp
When the
\fB\-c\fR
option is specified three times (or the
\fB\-ccc\fR
option), invalid file copies that are not registered in the metadata server are moved to the lost+found directory in the Gfarm file system\&. Furthermore, invalid metadata pointing to a missing file copy of the file system node are deleted\&. This is the default behavior\&.
.RE
.PP
\fB\-d\fR
.RS 4
Specifies the debug mode\&. With the \-d option, gfsd runs as a foreground process, not a daemon\&.
.sp
If this option is specified and
\fB\-L\fR
is not specified, the log level is set to "debug"\&.
.RE
.PP
\fB\-f\fR \fIconfig\-file\fR
.RS 4
Specifies a configuration file that is read instead of the default configuration file\&.
.RE
.PP
\fB\-h\fR \fIhostname\fR
.RS 4
Specifies my own canonical host name\&.
.RE
.PP
\fB\-l\fR \fIIP\-address\fR
.RS 4
Specifies the IP address from which the gfsd accepts TCP and UDP requests\&. The default address is all IP addresses of the host\&. This option is useful to invoke multiple instances of gfsd to provide multiple spool directories on the host\&.
.RE
.PP
\fB\-r\fR \fIdirectory\fR
.RS 4
Specifies a spool directory for a Gfarm filesystem on this filesystem node\&. This option can be specified multiple times to specify multiple spool directories up to five\&.
.RE
.PP
\fB\-s\fR \fIsyslog\-facility\fR
.RS 4
Specifies a syslog facility to report errors by gfsd\&. By default, local0 is used\&.
.RE
.PP
\fB\-v\fR
.RS 4
Makes gfsd output verbose log message on authentication\&. This is useful, when one has to resolve an issue about GSI authenticaion\&.
.RE
.PP
\fB\-?\fR
.RS 4
Displays a list of command options\&.
.RE
.SH "FILES"
.PP
%%SYSCONFDIR%%/gfarm2\&.conf
.RS 4
configuration file
.RE
.SH "SEE ALSO"
.PP
\fBgfarm2.conf\fR(5)