NAME

       gfsched - schedule and display available file system nodes

SYNOPSIS

       gfsched -f gfarm-URL [ -D domain-name ] [ -n number ] [ -LMclw ]

       gfsched [ -P gfarm-URL ] [ -D domain-name ] [ -n number ] [ -LMlw ]

DESCRIPTION

       The  gfsched  command with the -f gfarm-URL option displays available file system nodes which have a file
       replica of the specified gfarm-URL.

       When the -f gfarm-URL option is not specified, the gfsched command just displays  available  file  system
       nodes.  In this case, you can specify a metadata server by the -P gfarm-URL option, if necessary.

OPTIONS

       -D domain-name
              Limits file system node by specifying a domain name or a hostname.

       -c     Displays scheduling information for a file creation, if the file specified by -f doesn't exist.

              Currently,  this  option  creates  the  specified file.  But please note that this behavior may be
              changed in future.

       -L     Suppresses authentication check.  Without this option, the scheduler checks whether the user  will
              be  successfully  authenticated  with  the  hosts  or  not.   This  option omits the check to make
              scheduling faster, but that creates a risk that hosts which fail authentication with the user  may
              be scheduled.

       -M     Suppresses  client-side scheduling and only performs metadata-server-side scheduling.  This option
              makes scheduling faster, but also creates a risk that hosts which is network-unreachable or  fails
              authentication with the user may be scheduled.

       -P gfarm-URL
              Specifies  a  gfarm-URL  or  a  pathname  to  identify  a  metadata  server  which is used for the
              scheduling.  This option conflicts with the -f option.

       -f gfarm-URL
              The gfsched command schedules file system nodes which have a replica of a file specified  by  this
              option.  This option conflicts with the -P option.

       -l     Long  format.   This  option  displays  port  numbers as well as hostnames.  Note that the display
              format of this option may be changed in future.

       -n number
              Displays specified number of file system nodes at most.  If  this  option  is  not  specified,  it
              displays all available nodes.

       -w     Schedules  with  write-mode.   When  this  option is specified, file system nodes which don't have
              enough free space won't be displayed.

              When both this option and the -f are specified, and if the file is already opened by  an  existing
              process  with write-mode, the gfsched command only displays one file system node which is assigned
              for writing to the file.

       -?     Displays a list of command options.

EXAMPLES

       The following is an example to inquire file system  nodes  that  the  metadata  server  thinks  they  are
       currently working.

       $ gfsched -M

Gfarm                                           28 December 2010                                      GFSCHED(1)