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)