glusterfs(8)

1GlusterFS(8)                     Gluster Inc.                     GlusterFS(8)
2
3
4

NAME

6       GlusterFS - clustered file system
7

SYNOPSIS

9       glusterfs [options] [mountpoint]
10

DESCRIPTION

12       GlusterFS  is  a  clustered  file system, capable of scaling to several
13       peta-bytes.  It aggregates various storage bricks over Infiniband  RDMA
14       or TCP/IP and interconnect into one large parallel network file system.
15       Storage bricks can be made of any commodity hardware,  such  as  x86-64
16       server with SATA-II RAID and Infiniband HBA.
17
18       GlusterFS  is fully POSIX compliant file system. On client side, it has
19       dependency on FUSE package, on server side, it works seemlessly on dif‐
20       ferent  operating  systems.   Currently  supported on GNU/Linux and So‐
21       laris.
22
23

OPTIONS

25   Basic options
26       -f, --volfile=VOLUME-FILE
27              File to use as VOLUME-FILE.
28
29       -l, --log-file=LOGFILE
30              File  to   use   for   logging   (the   default   is   <INSTALL-
31              DIR>/var/log/glusterfs/<MOUNT-POINT>.log).
32
33       -L, --log-level=LOGLEVEL
34              Logging  severity.   Valid options are TRACE, DEBUG, INFO, WARN‐
35              ING, ERROR and CRITICAL (the default is INFO).
36
37       -s, --volfile-server=SERVER
38              Server to get the volume from.  This option overrides  --volfile
39              option.
40
41       --volfile-max-fetch-attempts=MAX-ATTEMPTS
42              Maximum number of connect attempts to server. This option should
43              be provided with --volfile-server option (the default is 1).
44
45
46   Advanced options
47       --acl  Mount the filesystem with POSIX ACL support.
48
49       --localtime-logging
50              Enable localtime log timestamps.
51
52       --debug
53              Run in debug mode.  This option sets --no-daemon, --log-level to
54              DEBUG, and --log-file to console.
55
56       --enable-ino32=BOOL
57              Use  32-bit  inodes when mounting to workaround application that
58              doesn't support 64-bit inodes.
59
60       --fopen-keep-cache[=BOOL]
61              Do not purge the cache on file open (default: false).
62
63       --mac-compat=BOOL
64              Provide stubs for attributes needed for  seamless  operation  on
65              Macs (the default is off).
66
67       -N, --no-daemon
68              Run in the foreground.
69
70       -p, --pid-file=PIDFILE
71              File to use as PID file.
72
73       --read-only
74              Mount the file system in 'read-only' mode.
75
76       --selinux
77              Enable SELinux label (extended attributes) support on inodes.
78
79       -S, --socket-file=SOCKFILE
80              File to use as unix-socket.
81
82       --volfile-id=KEY
83              Key of the volume file to be fetched from the server.
84
85       --volfile-server-port=PORT
86              Port number of volfile server.
87
88       --volfile-server-transport=TRANSPORT
89              Transport  type  to  get volume file from server (the default is
90              tcp).
91
92       --volume-name=VOLUME-NAME
93              Volume name to be used for MOUNT-POINT (the default is top  most
94              volume in VOLUME-FILE).
95
96       --worm Mount the filesystem in 'worm' mode.
97
98       --xlator-option=VOLUME-NAME.OPTION=VALUE
99              Add/Override a translator option for a volume with the specified
100              value.
101
102       --subdir-mount=SUBDIR-MOUNT-PATH
103              Mount subdirectory instead of the '/' of volume.
104
105
106   Fuse options
107       --attr-times-granularity=NANOSECONDS
108              Declare supported granularity of file attribute  times  (default
109              is  0 which kernel handles as unspecified; valid real values are
110              between 1 and 1000000000).
111
112       --attribute-timeout=SECONDS
113              Set attribute timeout to SECONDS for inodes in fuse kernel  mod‐
114              ule (the default is 1).
115
116       --background-qlen=N
117              Set  fuse  module's background queue length to N (the default is
118              64).
119
120       --congestion-threshold=N
121              Set fuse module's congestion threshold to N (the default is 48).
122
123       --direct-io-mode=BOOL|auto
124              Specify fuse direct I/O strategy (the default is auto).
125
126       --dump-fuse=PATH
127              Dump fuse traffic to PATH
128
129       --entry-timeout=SECONDS
130              Set entry timeout to SECONDS in fuse kernel module (the  default
131              is 1).
132
133       --gid-timeout=SECONDS
134              Set  auxiliary group list timeout to SECONDS for fuse translator
135              (the default is 0).
136
137       --kernel-writeback-cache=BOOL
138              Enable fuse in-kernel writeback cache.
139
140       --negative-timeout=SECONDS
141              Set negative timeout to SECONDS in fuse kernel module  (the  de‐
142              fault is 0).
143
144       --auto-invalidation=BOOL
145              controls whether fuse-kernel can auto-invalidate attribute, den‐
146              try and page-cache. Disable this only if same  files/directories
147              are  not  accessed across two different mounts concurrently [de‐
148              fault: on].
149
150       --volfile-check
151              Enable strict volume file checking.
152
153
154   Miscellaneous Options
155       -?, --help
156              Display this help.
157
158       --usage
159              Display a short usage message.
160
161       -V, --version
162              Print the program version.
163
164

FILES

166       /var/lib/glusterd/vols/*/*.vol
167

EXAMPLES

169       mount a volume named foo on server bar with log level  DEBUG  on  mount
170       point /mnt/foo
171
172       #  glusterfs  --log-level=DEBUG  --volfile-id=foo  --volfile-server=bar
173       /mnt/foo
174
175

COPYRIGHT

180       Copyright(c) 2006-2011  Red Hat, Inc.  <http://www.redhat.com>
181
182
183
18407 March 2011                Clustered File System                GlusterFS(8)