glusterfs

1
.\"  Copyright (c) 2008-2012 Red Hat, Inc. <http://www.redhat.com>
2
.\"  This file is part of GlusterFS.
3
.\"
4
.\"  This file is licensed to you under your choice of the GNU Lesser
5
.\"  General Public License, version 3 or any later version (LGPLv3 or
6
.\"  later), or the GNU General Public License, version 2 (GPLv2), in all
7
.\"  cases as published by the Free Software Foundation.
8
.\"
9
.\"
10
.\"
11
.TH GlusterFS 8 "Clustered File System" "07 March 2011" "Gluster Inc."
12
.SH NAME
13
GlusterFS \- clustered file system
14
.SH SYNOPSIS
15
.B glusterfs
16
.I [options] [mountpoint]
17
.PP
18
.SH DESCRIPTION
19
GlusterFS is a clustered file system, capable of scaling to several peta-bytes.
20
It aggregates various storage bricks over Infiniband RDMA or TCP/IP and
21
interconnect into one large parallel network file system. Storage bricks can
22
be made of any commodity hardware, such as x86-64 server with SATA-II RAID and
23
Infiniband HBA.
24

25
GlusterFS is fully POSIX compliant file system. On client side, it has dependency
26
on FUSE package, on server side, it works seemlessly on different operating systems.
27
Currently supported on GNU/Linux and Solaris.
28

29
.SH OPTIONS
30

31
.SS "Basic options"
32
.PP
33
.TP
34
\fB\-f, \fB\-\-volfile=VOLUME-FILE\fR
35
File to use as VOLUME-FILE.
36
.TP
37
\fB\-l, \fB\-\-log\-file=LOGFILE\fR
38
File to use for logging (the default is <INSTALL-DIR>/var/log/glusterfs/<MOUNT-POINT>.log).
39
.TP
40
\fB\-L, \fB\-\-log\-level=LOGLEVEL\fR
41
Logging severity.  Valid options are TRACE, DEBUG, INFO, WARNING, ERROR and CRITICAL (the default is INFO).
42
.TP
43
\fB\-s, \fB\-\-volfile\-server=SERVER\fR
44
Server to get the volume from.  This option overrides \fB\-\-volfile \fR option.
45
.TP
46
\fB\-\-volfile\-max\-fetch\-attempts=MAX\-ATTEMPTS\fR
47
Maximum number of connect attempts to server. This option should be provided with
48
\fB\-\-volfile\-server\fR option (the default is 1).
49

50
.SS "Advanced options"
51
.PP
52
.TP
53
\fB\-\-acl\fR
54
Mount the filesystem with POSIX ACL support.
55
.TP
56
\fB\-\-localtime\-logging\fR
57
Enable localtime log timestamps.
58
.TP
59
\fB\-\-debug\fR
60
Run in debug mode.  This option sets \fB\-\-no\-daemon\fR, \fB\-\-log\-level\fR to DEBUG,
61
and \fB\-\-log\-file\fR to console.
62
.TP
63
\fB\-\-enable\-ino32=BOOL\fR
64
Use 32-bit inodes when mounting to workaround application that doesn't support 64-bit inodes.
65
.TP
66
\fB\-\-fopen\-keep\-cache[=BOOL]\fR
67
Do not purge the cache on file open (default: false).
68
.TP
69
\fB\-\-mac\-compat=BOOL\fR
70
Provide stubs for attributes needed for seamless operation on Macs (the default is off).
71
.TP
72
\fB\-N, \fB\-\-no\-daemon\fR
73
Run in the foreground.
74
.TP
75
\fB\-p, \fB\-\-pid\-file=PIDFILE\fR
76
File to use as PID file.
77
.TP
78
\fB\-\-read\-only\fR
79
Mount the file system in 'read-only' mode.
80
.TP
81
\fB\-\-selinux\fR
82
Enable SELinux label (extended attributes) support on inodes.
83
.TP
84
\fB\-S, \fB\-\-socket\-file=SOCKFILE\fR
85
File to use as unix-socket.
86
.TP
87
\fB\-\-volfile\-id=KEY\fR
88
Key of the volume file to be fetched from the server.
89
.TP
90
\fB\-\-volfile\-server\-port=PORT\fR
91
Port number of volfile server.
92
.TP
93
\fB\-\-volfile\-server\-transport=TRANSPORT\fR
94
Transport type to get volume file from server (the default is tcp).
95
.TP
96
\fB\-\-volume\-name=VOLUME\-NAME\fR
97
Volume name to be used for MOUNT-POINT (the default is top most volume in VOLUME-FILE).
98
.TP
99
\fB\-\-worm\fR
100
Mount the filesystem in 'worm' mode.
101
.TP
102
\fB\-\-xlator\-option=VOLUME\-NAME.OPTION=VALUE\fR
103
Add/Override a translator option for a volume with the specified value.
104
.TP
105
\fB\-\-subdir\-mount=SUBDIR\-MOUNT\-PATH\fR
106
Mount subdirectory instead of the '/' of volume.
107

108
.SS "Fuse options"
109
.PP
110
.TP
111

112
\fB\-\-attr\-times\-granularity=NANOSECONDS\fR
113
Declare supported granularity of file attribute times (default is 0 which kernel handles as unspecified; valid real values are between 1 and 1000000000).
114
.TP
115
\fB\-\-attribute\-timeout=SECONDS\fR
116
Set attribute timeout to SECONDS for inodes in fuse kernel module (the default is 1).
117
.TP
118
\fB\-\-background\-qlen=N\fR
119
Set fuse module's background queue length to N (the default is 64).
120
.TP
121
\fB\-\-congestion\-threshold=N\fR
122
Set fuse module's congestion threshold to N (the default is 48).
123
.TP
124
\fB\-\-direct\-io\-mode=BOOL|auto\fR
125
Specify fuse direct I/O strategy (the default is auto).
126
.TP
127
\fB\-\-dump-fuse=PATH\fR
128
Dump fuse traffic to PATH
129
.TP
130
\fB\-\-entry\-timeout=SECONDS\fR
131
Set entry timeout to SECONDS in fuse kernel module (the default is 1).
132
.TP
133
\fB\-\-gid\-timeout=SECONDS\fR
134
Set auxiliary group list timeout to SECONDS for fuse translator (the default is 0).
135
.TP
136
\fB\-\-kernel-writeback-cache=BOOL\fR
137
Enable fuse in-kernel writeback cache.
138
.TP
139
\fB\-\-negative\-timeout=SECONDS\fR
140
Set negative timeout to SECONDS in fuse kernel module (the default is 0).
141
.TP
142
\fB\-\-auto\-invalidation=BOOL\fR
143
controls whether fuse-kernel can auto-invalidate attribute, dentry and
144
page-cache. Disable this only if same files/directories are not
145
accessed across two different mounts concurrently [default: on].
146
.TP
147
\fB\-\-volfile-check\fR
148
Enable strict volume file checking.
149

150
.SS "Miscellaneous Options"
151
.PP
152
.TP
153

154
\fB\-?, \fB\-\-help\fR
155
Display this help.
156
.TP
157
\fB\-\-usage\fR
158
Display a short usage message.
159
.TP
160
\fB\-V, \fB\-\-version\fR
161
Print the program version.
162

163
.PP
164
.SH FILES
165
/var/lib/glusterd/vols/*/*.vol
166
.SH EXAMPLES
167
mount a volume named foo on server bar with log level DEBUG on mount point
168
/mnt/foo
169

170
# glusterfs \-\-log\-level=DEBUG \-\-volfile\-id=foo \-\-volfile\-server=bar /mnt/foo
171

172
.SH SEE ALSO
173
.nf
174
\fBfusermount\fR(1), \fBmount.glusterfs\fR(8), \fBgluster\fR(8)
175
\fR
176
.fi
177
.SH COPYRIGHT
178
.nf
179
Copyright(c) 2006-2011  Red Hat, Inc.  <http://www.redhat.com>
180
\fR
181
.fi
182