NAME

       gfarm2fs - mount a Gfarm file system

SYNOPSIS

       gfarm2fs mount_point [ options ]

DESCRIPTION

       gfarm2fs mounts the Gfarm file system at the specified mount point.

GENERAL OPTIONS

       -h     display a list of command options.

       -V     display version.

       -o opt,[opt...]
              specify mount options.

GFARM2FS OPTIONS

       -o syslog=facility
              specify syslog facility.  default is local0.

       -o loglevel=priority
              specify syslog priority level.  default is notice.

       -E T   specify the timeout of attribute cache.  default is 1.0 seconds.

       -o gfs_stat_timeout=T
              same as -E option

       -o ncopy=N
              specify  the  number  of copies automatically created when a file is created.  default is 0, which
              means disabling automatic replication mechanism.

       -o copy_limit=N
              specify the maximum  number  of  concurrent  copy  creations.   this  is  effective  if  automatic
              replication is enabled.  default is 0.

       -o disable_genuine_nlink
              uses faked st_nlink (32000) of struct stat for directories.

       -o auto_uid_min=N
              specify the minimum UID automatically assigned.

       -o auto_uid_max=N
              specify the maximum UID automatically assigned.

       -o auto_gid_min=N
              specify the minimum GID automatically assigned.

       -o auto_gid_max=N
              specify the maximum GID automatically assigned.

FUSE OPTIONS

       see gfarm2fs -h

ENVIRONMENT VARIABLE

       GFARM_CONFIG_FILE
              specifies the Gfarm configuration file.

NOTES

       When  there  is not the same local account name as the Gfarm global user name, a temporal UID is assigned
       between auto_uid_min and auto_uid_max.  When there is not the same local group name as the  Gfarm  global
       group name, a temporal GID is assigned between auto_gid_min and auto_gid_max.

       When a temporal UID/GID cannot be assigned, setfacl(1) fails with EPERM.

SECURITY NOTES

       When untrusted users are registered in the gfarmroot group or gfarm_root.{user,group} extended attributes
       of  any  files  or  directories,  a  Security  Hole  exists  on  the  mount  point  of  gfarm2fs with "-o
       suid,allow_other" option executed by root (even if either "-o  ro"  option  or  "-o  default_permissions"
       option  is  also  specified).   Therefore  both  "-o suid,allow_other" option and gfarm_root.{user,group}
       extended attributes should not be used.

SEE ALSO

       fusermount(1), gfarm_attr(5), gfarm2.conf(5), mount(8)

Gfarm                                             2 April 2011                                       GFARM2FS(1)