GFKEY(1)																  GFKEY(1)

NAME

       gfkey - management of Gfarm session keys

SYNOPSIS

       gfkey [ options ]

DESCRIPTION

       gfkey manages the session key file, $HOME/.gfarm_shared_key, that is used for user authentication by a shared secret key in a trusted envi-
       ronment when connecting to gfsd and/or gfmd.

       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.

OPTIONS

       -c     Creates a new session key when there is no valid session key.  If a valid session key already exists, no operation is performed.

       -f     Forces the creation of a new session key, even if a valid session key already exists.

       -p period
	      Specifies the term of validity in seconds.  This option has to be used with the -c or -f option.

       -l     Displays the current key.

       -e     Displays the expiration date of the current key.

       -L message-priority-level
	      Specifies  a level of the log priority.  The log messages that have higher or the same priority than the specified priority are dis-
	      played 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.

       -?     Displays a list of command options.

FILES

       $HOME/.gfarm_shared_key
	      a file for a session key

Gfarm								 25 February 2010							  GFKEY(1)