Ubuntu Manpage: gfarm2fs - mount a Gfarm file system

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.