GFARM2FS

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)