Man pages sections > man1 > gfarm2fs

gfarm2fs - mount a Gfarm file system

GFARM2FS(1) GFARM2FS(1)

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)
2 April 2011 Gfarm