Ubuntu Manpage: gfarm2fs - mount a Gfarm file system

Provided by: gfarm2fs_1.2.16-1build2_amd64

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 directory_quota_rename_error_exdev
enables client-side directory move between directories which belong to different directory quota.
CAUTION: such client-side move will be really slow, because all files under the directory will be
copied from source filesystem nodes to the client, and be copied back to destination filesystem
nodes, and because this operation is essentially same with copy and remove, file owner settings
may not be preserved, and it's possible that some directories cannot be correctly moved due to
permission problems.

-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.