summaryrefslogtreecommitdiffstats
path: root/doc/mount.glusterfs.8
diff options
context:
space:
mode:
Diffstat (limited to 'doc/mount.glusterfs.8')
-rw-r--r--doc/mount.glusterfs.896
1 files changed, 44 insertions, 52 deletions
diff --git a/doc/mount.glusterfs.8 b/doc/mount.glusterfs.8
index fbc8c0206..01b7f7554 100644
--- a/doc/mount.glusterfs.8
+++ b/doc/mount.glusterfs.8
@@ -1,86 +1,78 @@
-.\" Copyright (c) 2008-2009 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" "07 December 2008" "Gluster Inc."
+.TH GlusterFS 8 "Cluster Filesystem" "18 March 2010" "Gluster Inc."
.SH NAME
-GlusterFS \- Clustered Filesystem.
-.SH SYNOPSYS
-.B mount.glusterfs
-.I <volumeserver>:<volumeid/volumeport> -o <options> <mountpoint>
+mount.glusterfs - script to mount native GlusterFS volume
+.SH SYNOPSIS
+.B mount -t glusterfs
+.I [-o <options>] <volumeserver>:<volumeid> <mountpoint>
+.TP
+.B mount -t glusterfs
+.I [-o <options>] <path/to/volumefile> <mountpoint>
.PP
.SH DESCRIPTION
-This tool is part of \fBglusterfs\fR(8)
+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=\fRvalue
+.TP
+\fBlog\-file=\fRLOG-FILE
File to use for logging [default:/var/log/glusterfs/glusterfs.log]
.TP
-\fBlog\-level=\fRvalue
-Logging severity. Valid options are TRACE, DEBUG, WARNING, ERROR, CRITICAL
-NORMAL and NONE [default: NORMAL]
+\fBlog\-level=\fRLOG-LEVEL
+Logging severity. Valid options are TRACE, DEBUG, WARNING, ERROR, CRITICAL
+INFO and NONE [default: INFO]
.TP
-\fBlog\-server=\fRvalue
-Server to use as the central log server.
-
+\fBro\fR
+Mount the filesystem read-only
+.PP
.SS "Advanced options"
.PP
.TP
-
-\fBvolfile\-id=\fRvalue
+\fBvolfile\-id=\fRKEY
Volume key or name of the volume file to be fetched from server
.TP
-\fBserver\-port=\fRvalue
-Port number of volfile server [default: 6996]
+\fBtransport=\fRTRANSPORT-TYPE
+Transport type to get volume file from server [default: tcp]
.TP
-\fBtransport=\fRvalue
-Transport type to get volume file from server [default: socket]
-.TP
-\fBvolume\-name=\fRvalue
-Volume name to be used for MOUNT-POINT [default: top most volume in
+\fBvolume\-name=\fRVOLUME-NAME
+Volume name to be used for MOUNT-POINT [default: top most volume in
VOLUME-FILE]
.TP
-\fBlog\-server\-port=\fRvalue
-Listening port number of log server
-.TP
-\fBdirect\-io\-mode=\fRvalue
+\fBdirect\-io\-mode=\fRdisable
Disable direct I/O mode in fuse kernel module
.TP
-
.PP
.SH FILES
-.TP
+.TP
.I /etc/fstab
-file system table
+A typical GlusterFS entry in /etc/fstab looks like below
+
+server1.gluster.com:mirror /mnt/mirror glusterfs log-file=/var/log/mirror.vol,ro,defaults 0 0
+
.TP
.I /etc/mtab
-table of mounted file systems
+An example entry of a GlusterFS mountpoint in /etc/mtab looks like below
-.SH SEE ALSO
-.BR glusterfs(8),
-.BR mount(8)
+mirror.vol /mnt/glusterfs fuse.glusterfs rw,allow_other,default_permissions,max_read=131072 0 0
-.SH AUTHORS
-.BR http://www.gluster.org/core-team.php <URL:http://www.gluster.org/core-team.php>
+.SH SEE ALSO
+\fBglusterfs\fR(8), \fBmount\fR(8), \fBgluster\fR(8)
.SH COPYRIGHT
-.BR Copyright(c)2006-2009 Gluster, Inc. <http://www.gluster.com>
+Copyright(c) 2006-2011 Gluster, Inc. <http://www.gluster.com>