'\" t
.\"     Title: gfkey
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 25 Feb 2010
.\"    Manual: Gfarm
.\"    Source: Gfarm
.\"  Language: English
.\"
.TH "GFKEY" "1" "25 Feb 2010" "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"
gfkey \- management of Gfarm session keys
.SH "SYNOPSIS"
.HP \w'\fBgfkey\fR\ 'u
\fBgfkey\fR [\fIoptions\fR]
.SH "DESCRIPTION"
.PP
\fBgfkey\fR
manages the session key file,
$HOME/\&.gfarm_shared_key, that is used for user authentication by a shared secret key in a trusted environment when connecting to gfsd and/or gfmd\&.
.PP
When the home directory is shared among filesystem nodes, it is not necessary to use this command\&. If not, it is necessary to distribute a session key created with the \-c or \-f option to every filesystem node, in advance\&.
.SH "OPTIONS"
.PP
\fB\-c\fR
.RS 4
Creates a new session key when there is no valid session key\&. If a valid session key already exists, no operation is performed\&.
.RE
.PP
\fB\-f\fR
.RS 4
Forces the creation of a new session key, even if a valid session key already exists\&.
.RE
.PP
\fB\-p\fR \fIperiod\fR
.RS 4
Specifies the term of validity in seconds\&. This option has to be used with the \-c or \-f option\&.
.RE
.PP
\fB\-l\fR
.RS 4
Displays the current key\&.
.RE
.PP
\fB\-e\fR
.RS 4
Displays the expiration date of the current key\&.
.RE
.PP
\fB\-L\fR \fImessage\-priority\-level\fR
.RS 4
Specifies a level of the log priority\&. The log messages that have higher or the same priority than the specified priority are displayed to the standard error\&. The default priority is info\&. Refer to the
log_level
directive described in the manual page of gfarm2\&.conf(5) for the priority level which can be specified by this option\&.
.RE
.PP
\fB\-?\fR
.RS 4
Displays a list of command options\&.
.RE
.SH "FILES"
.PP
$HOME/\&.gfarm_shared_key
.RS 4
a file for a session key
.RE