diff options
Diffstat (limited to 'doc/glusterfs.8')
| -rw-r--r-- | doc/glusterfs.8 | 145 |
1 files changed, 86 insertions, 59 deletions
diff --git a/doc/glusterfs.8 b/doc/glusterfs.8 index 93777541d..60ad5709b 100644 --- a/doc/glusterfs.8 +++ b/doc/glusterfs.8 @@ -1,137 +1,164 @@ -.\" Copyright (c) 2008-2010 Gluster, Inc. <http://www.gluster.com> +.\" Copyright (c) 2008-2012 Red Hat, Inc. <http://www.redhat.com> .\" This file is part of GlusterFS. .\" -.\" GlusterFS is free software; you can redistribute it and/or modify -.\" it under the terms of the GNU General Public License as published -.\" by the Free Software Foundation; either version 3 of the License, -.\" or (at your option) any later version. +.\" 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. .\" -.\" GlusterFS is distributed in the hope that it will be useful, but -.\" WITHOUT ANY WARRANTY; without even the implied warranty of -.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -.\" General Public License for more details. .\" -.\" You should have received a copy of the GNU General Public License -.\" long with this program. If not, see -.\" <http://www.gnu.org/licenses/>. .\" -.\" -.\" -.TH GlusterFS 8 "Cluster Filesystem" "19 March 2010" "Gluster Inc." +.TH GlusterFS 8 "Clustered File System" "07 March 2011" "Gluster Inc." .SH NAME -GlusterFS \- Clustered Filesystem. +GlusterFS \- clustered file system .SH SYNOPSIS .B glusterfs .I [options] [mountpoint] .PP .SH DESCRIPTION -GlusterFS is a clustered file-system capable of scaling to several peta-bytes. -It aggregates various storage bricks over Infiniband RDMA or TCP/IP +GlusterFS is a clustered file system, capable of scaling to several peta-bytes. +It aggregates various storage bricks over Infiniband RDMA or TCP/IP and interconnect into one large parallel network file system. Storage bricks can -be made of any commodity hardware such as x86-64 server with SATA-II RAID and +be made of any commodity hardware, such as x86-64 server with SATA-II RAID and Infiniband HBA. -GlusterFS is fully POSIX compliant FileSystem. On client side, it has dependency -on FUSE package, on server side, it works seemlessly on different OSes. -(Currently supported on GNU/Linux, Solaris). +GlusterFS is fully POSIX compliant file system. On client side, it has dependency +on FUSE package, on server side, it works seemlessly on different operating systems. +Currently supported on GNU/Linux and Solaris. .SH OPTIONS -.PP -Mandatory or optional arguments to long options are also mandatory or optional -for any corresponding short options. + .SS "Basic options" .PP .TP - \fB\-f, \fB\-\-volfile=VOLUME-FILE\fR -File to use as VOLUME-FILE [default:/etc/glusterfs/glusterfs.vol] +File to use as VOLUME-FILE. .TP \fB\-l, \fB\-\-log\-file=LOGFILE\fR -File to use for logging [default:/var/log/glusterfs/glusterfs.log] +File to use for logging (the default is <INSTALL-DIR>/var/log/glusterfs/<MOUNT-POINT>.log). .TP \fB\-L, \fB\-\-log\-level=LOGLEVEL\fR -Logging severity. Valid options are TRACE, DEBUG, NORMAL, WARNING, ERROR and -CRITICAL [default: WARNING] +Logging severity. Valid options are TRACE, DEBUG, INFO, WARNING, ERROR and CRITICAL (the default is INFO). .TP \fB\-s, \fB\-\-volfile\-server=SERVER\fR -Server to get the volume from. This option overrides \fB\-\-volfile option +Server to get the volume from. This option overrides \fB\-\-volfile \fR option. .TP -\fB\-\-log\-server=LOG\-SERVER\fR -Server to use as the central log server. +\fB\-\-volfile\-max\-fetch\-attempts=MAX\-ATTEMPTS\fR +Maximum number of connect attempts to server. This option should be provided with +\fB\-\-volfile\-server\fR option (the default is 1). .SS "Advanced options" .PP .TP - +\fB\-\-acl\fR +Mount the filesystem with POSIX ACL support. +.TP \fB\-\-debug\fR -Run in debug mode. This option sets \fB\-\-no\-daemon\fR, \fB\-\-log\-level\fR to DEBUG -and \fB\-\-log\-file\fR to console +Run in debug mode. This option sets \fB\-\-no\-daemon\fR, \fB\-\-log\-level\fR to DEBUG, +and \fB\-\-log\-file\fR to console. +.TP +\fB\-\-enable\-ino32=BOOL\fR +Use 32-bit inodes when mounting to workaround application that doesn't support 64-bit inodes. +.TP +\fB\-\-fopen\-keep\-cache\fR +Do not purge the cache on file open. +.TP +\fB\-\-mac\-compat=BOOL\fR +Provide stubs for attributes needed for seamless operation on Macs (the default is off). .TP \fB\-N, \fB\-\-no\-daemon\fR -Run in foreground +Run in the foreground. +.TP +\fB\-p, \fB\-\-pid\-file=PIDFILE\fR +File to use as PID file. .TP \fB\-\-read\-only\fR -Makes the filesystem read-only +Mount the file system in 'read-only' mode. .TP -\fB\-p, \fB\-\-pid\-file=PIDFILE\fR -File to use as pid file +\fB\-\-selinux\fR +Enable SELinux label (extended attributes) support on inodes. +.TP +\fB\-S, \fB\-\-socket\-file=SOCKFILE\fR +File to use as unix-socket. .TP \fB\-\-volfile\-id=KEY\fR -KEY of the volume file to be fetched from server +Key of the volume file to be fetched from the server. .TP \fB\-\-volfile\-server\-port=PORT\fR -Port number of volfile server +Port number of volfile server. .TP \fB\-\-volfile\-server\-transport=TRANSPORT\fR -Transport type to get volume file from server [default: socket] +Transport type to get volume file from server (the default is tcp). .TP \fB\-\-volume\-name=VOLUME\-NAME\fR -Volume name to be used for MOUNT-POINT [default: top most volume in -VOLUME-FILE] +Volume name to be used for MOUNT-POINT (the default is top most volume in VOLUME-FILE). .TP -\fB\-\-xlator\-option=VOLUME\-NAME.OPTION=VALUE\fR -Add/override a translator option for a volume with the specified value +\fB\-\-worm\fR +Mount the filesystem in 'worm' mode. .TP -\fB\-\-log\-server\-port=PORT\fR -Listening port number of log server +\fB\-\-xlator\-option=VOLUME\-NAME.OPTION=VALUE\fR +Add/Override a translator option for a volume with the specified value. .SS "Fuse options" .PP .TP \fB\-\-attribute\-timeout=SECONDS\fR -Set attribute timeout to SECONDS for inodes in fuse kernel module [default: 1] +Set attribute timeout to SECONDS for inodes in fuse kernel module (the default is 1). +.TP +\fB\-\-background\-qlen=N\fR +Set fuse module's background queue length to N (the default is 64). +.TP +\fB\-\-congestion\-threshold=N\fR +Set fuse module's congestion threshold to N (the default is 48). +.TP +\fB\-\-direct\-io\-mode=BOOL\fR +Enable/Disable the direct-I/O mode in fuse module (the default is enable). +.TP +\fB\-\-dump-fuse=PATH\f\R +Dump fuse traffic to PATH .TP \fB\-\-entry\-timeout=SECONDS\fR -Set entry timeout to SECONDS in fuse kernel module [default: 1] +Set entry timeout to SECONDS in fuse kernel module (the default is 1). +.TP +\fB\-\-gid\-timeout=SECONDS\fR +Set auxilary group list timeout to SECONDS for fuse translator (the default is 0). .TP -\fB\-\-disable\-direct\-io\-mode\fR -Disable direct I/O mode in fuse kernel module +\fB\-\-negative\-timeout=SECONDS\fR +Set negative timeout to SECONDS in fuse kernel module (the default is 0). +.TP +\fB\-\-volfile-check\fR +Enable strict volume file checking. .SS "Miscellaneous Options" .PP .TP \fB\-?, \fB\-\-help\fR -Give this help list +Display this help. .TP \fB\-\-usage\fR -Give a short usage message +Display a short usage message. .TP \fB\-V, \fB\-\-version\fR -Print program version +Print the program version. .PP .SH FILES -/etc/glusterfs/*.vol +/var/lib/glusterd/vols/*/*.vol +.SH EXAMPLES +mount a volume named foo on server bar with log level DEBUG on mount point +/mnt/foo + +# glusterfs \-\-log\-level=DEBUG \-\-volfile\-id=foo \-\-volfile\-server=bar /mnt/foo .SH SEE ALSO .nf -\fBfusermount\fR(1), \fBmount.glusterfs\fR(8), \fBglusterfs-volgen\fR(8) +\fBfusermount\fR(1), \fBmount.glusterfs\fR(8), \fBgluster\fR(8) \fR .fi .SH COPYRIGHT .nf -Copyright(c) 2006-2010 Gluster, Inc. <http://www.gluster.com> +Copyright(c) 2006-2011 Red Hat, Inc. <http://www.redhat.com> \fR .fi |