So far the --direct-io-mode option has been presented as of being Boolean valued. That is however not exact, as a third behavior is chosen if the option is not specified. We accept now the "auto" value as an explicit choice for the default heuristics, and indicate in the descriptions of the option (which occur in commandline help and in the gluterfs / mount.glusterfs man pages) that auto is the default. The default heuristics was briefly described in the commandline help. We are getting rid of that, because: - it's not the right place to provide such details; - there is no guarantee of keeping the current heuristics so it might go out of sync with reality; - that is already the case to some degree, because the description did not take into account that the default heuristics varies between platforms (on Mac, it's just "off"), and that xlators can also prescribe direct I/O for the file of their choice (see change I3fe3312cd96baa4eecfe1247ab7255b4f455f049). Change-Id: Ia83479c0c67fe66b7fc2e0e8db5b7792d9f44b28 Signed-off-by: Csaba Henk <csaba@redhat.com>
155 lines
4.4 KiB
Groff
155 lines
4.4 KiB
Groff
.\" Copyright (c) 2008-2013 Red Hat, Inc. <http://www.redhat.com>
|
|
.\" This file is part of GlusterFS.
|
|
.\"
|
|
.\" This file is licensed to you under your choice of the GNU Lesser
|
|
.\" General Public License, version 3 or any later version (LGPLv3 or
|
|
.\" later), or the GNU General Public License, version 2 (GPLv2), in all
|
|
.\" cases as published by the Free Software Foundation.
|
|
.\"
|
|
.\"
|
|
.\"
|
|
.TH GlusterFS 8 "Cluster Filesystem" "14 September 2013" "Red Hat, Inc."
|
|
.SH NAME
|
|
.B mount.glusterfs - script to mount native GlusterFS volume
|
|
.SH SYNOPSIS
|
|
.B mount -t glusterfs [-o <options>] <volumeserver>:/<volume>[/<subdir>]
|
|
.B <mountpoint>
|
|
.TP
|
|
.B mount -t glusterfs [-o <options>] <server1>,<server2>,
|
|
.B <server3>,..<serverN>:/<volname>[/<subdir>] <mount_point>
|
|
.TP
|
|
.TP
|
|
.B mount -t glusterfs [-o <options>] <path/to/volumefile> <mountpoint>
|
|
.PP
|
|
.SH DESCRIPTION
|
|
This tool is part of \fBglusterfs\fR(8) package, which is used to mount using
|
|
GlusterFS native binary.
|
|
|
|
\fBmount.glusterfs\fR is meant to be used by the mount(8) command for mounting
|
|
native GlusterFS client. This subcommand, however, can also be used as a
|
|
standalone command with limited functionality.
|
|
|
|
.SH OPTIONS
|
|
.PP
|
|
.SS "Basic options"
|
|
.PP
|
|
.TP
|
|
\fBlog\-file=\fRLOG-FILE
|
|
File to use for logging [default:/var/log/glusterfs/glusterfs.log]
|
|
.TP
|
|
\fBlog\-level=\fRLOG-LEVEL
|
|
Logging severity. Valid options are TRACE, DEBUG, WARNING, ERROR, CRITICAL
|
|
INFO and NONE [default: INFO]
|
|
.TP
|
|
\fBacl
|
|
Mount the filesystem with POSIX ACL support
|
|
.TP
|
|
\fBfopen\-keep\-cache
|
|
Do not purge the cache on file open
|
|
.TP
|
|
\fBworm
|
|
Mount the filesystem in 'worm' mode
|
|
.TP
|
|
\fBaux\-gfid\-mount
|
|
Enable access to filesystem through gfid directly
|
|
.TP
|
|
\fBro\fR
|
|
Mount the filesystem read-only
|
|
.TP
|
|
\fBenable\-ino32=\fRBOOL
|
|
Use 32-bit inodes when mounting to workaround broken applications that don't
|
|
support 64-bit inodes
|
|
.TP
|
|
\fBmem\-accounting
|
|
Enable internal memory accounting
|
|
.TP
|
|
\fBcapability
|
|
Enable file capability setting and retrival
|
|
.TP
|
|
\fBthin-client
|
|
Enables thin mount and connects via gfproxyd daemon
|
|
|
|
.PP
|
|
.SS "Advanced options"
|
|
.PP
|
|
.TP
|
|
\fBattribute\-timeout=\fRSECONDS
|
|
Set attribute timeout to SECONDS for inodes in fuse kernel module [default: 1]
|
|
.TP
|
|
\fBentry\-timeout=\fRSECONDS
|
|
Set entry timeout to SECONDS in fuse kernel module [default: 1]
|
|
.TP
|
|
\fBbackground\-qlen=\fRN
|
|
Set fuse module's background queue length to N [default: 64]
|
|
.TP
|
|
\fBgid\-timeout=\fRSECONDS
|
|
Set auxiliary group list timeout to SECONDS for fuse translator [default: 0]
|
|
.TP
|
|
\fBnegative\-timeout=\fRSECONDS
|
|
Set negative timeout to SECONDS in fuse kernel module [default: 0]
|
|
.TP
|
|
\fBvolume\-name=\fRVOLUME-NAME
|
|
Volume name to be used for MOUNT-POINT [default: top most volume in
|
|
VOLUME-FILE]
|
|
.TP
|
|
\fBdirect\-io\-mode=\fRBOOL|auto
|
|
Specify fuse direct I/O strategy [default: auto]
|
|
.TP
|
|
\fBcongestion\-threshold=\fRN
|
|
Set fuse module's congestion threshold to N [default: 48]
|
|
.TP
|
|
\fsubdir\-mount=\fRN
|
|
Set the subdirectory mount option [default: NULL, ie, no subdirectory mount]
|
|
.TP
|
|
.TP
|
|
\fBbackup\-volfile\-servers=\fRSERVERLIST
|
|
Provide list of backup volfile servers in the following format [default: None]
|
|
|
|
\fB$ mount \-t glusterfs \-obackup\-volfile\-servers=<server2>:\fR
|
|
\fB <server3>:...:<serverN> <server1>:/<volname> <mount_point>\fR
|
|
|
|
.TP
|
|
.TP
|
|
\fBbackupvolfile\-server=\fRSERVER
|
|
Provide list of backup volfile servers in the following format [default: None]
|
|
|
|
\fB $ mount \-t glusterfs \-obackupvolfile\-server=<server2>
|
|
\fB <server1>:/<volname> <mount_point>
|
|
|
|
.TP
|
|
.TP
|
|
\fBfetch-attempts=\fRN
|
|
\fBDeprecated\fR option - placed here for backward compatibility [default: 1]
|
|
.TP
|
|
.TP
|
|
\fBbackground-qlen=\fRN
|
|
Set fuse module's background queue length to N [default: 64]
|
|
.TP
|
|
\fBno\-root\-squash=\fRBOOL
|
|
disable root squashing for the trusted client [default: off]
|
|
.TP
|
|
\fBroot\-squash=\fRBOOL
|
|
enable root squashing for the trusted client [default: on]
|
|
.TP
|
|
\fBuse\-readdirp=\fRBOOL
|
|
Use readdirp() mode in fuse kernel module [default: on]
|
|
.PP
|
|
.SH FILES
|
|
.TP
|
|
.I /etc/fstab
|
|
A typical GlusterFS entry in /etc/fstab looks like below
|
|
|
|
\fBserver1:/mirror /mnt/mirror glusterfs log-file=/var/log/mirror.log,acl 0 0\fR
|
|
|
|
.TP
|
|
.I /proc/mounts
|
|
An example entry of a GlusterFS mountpoint in /proc/mounts looks like below
|
|
|
|
\fBserver1:/mirror /mnt/glusterfs fuse.glusterfs rw,allow_other,default_permissions,max_read=131072 0 0\fR
|
|
|
|
.SH SEE ALSO
|
|
\fBglusterfs\fR(8), \fBmount\fR(8), \fBgluster\fR(8)
|
|
|
|
.SH COPYRIGHT
|
|
Copyright(c) 2006-2013 Red Hat, Inc. <http://www.redhat.com>
|