NAME

       GlusterFS - clustered file system

SYNOPSIS

       glusterfs [options] [mountpoint]

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 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 Infiniband HBA.

       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.

OPTIONS

   Basic options
       -f, --volfile=VOLUME-FILE
              File to use as VOLUME-FILE.

       -l, --log-file=LOGFILE
              File to use for logging  (the  default  is  <INSTALL-DIR>/var/log/glusterfs/<MOUNT-
              POINT>.log).

       -L, --log-level=LOGLEVEL
              Logging  severity.   Valid  options  are  TRACE,  DEBUG,  INFO,  WARNING, ERROR and
              CRITICAL (the default is INFO).

       -s, --volfile-server=SERVER
              Server to get the volume from.  This option overrides --volfile  option.

       --volfile-max-fetch-attempts=MAX-ATTEMPTS
              Maximum number of connect attempts to server. This option should be  provided  with
              --volfile-server option (the default is 1).

   Advanced options
       --acl  Mount the filesystem with POSIX ACL support.

       -L, --localtime-logging=on|off
              Enable  or  disable  localtime  log  timestamps.  Valid options are on and off (the
              default is off).

       --debug
              Run in debug mode.   This  option  sets  --no-daemon,  --log-level  to  DEBUG,  and
              --log-file to console.

       --enable-ino32=BOOL
              Use  32-bit  inodes  when  mounting  to workaround application that doesn't support
              64-bit inodes.

       --fopen-keep-cache
              Do not purge the cache on file open.

       --mac-compat=BOOL
              Provide stubs for attributes needed for seamless operation on Macs (the default  is
              off).

       -N, --no-daemon
              Run in the foreground.

       -p, --pid-file=PIDFILE
              File to use as PID file.

       --read-only
              Mount the file system in 'read-only' mode.

       --selinux
              Enable SELinux label (extended attributes) support on inodes.

       -S, --socket-file=SOCKFILE
              File to use as unix-socket.

       --volfile-id=KEY
              Key of the volume file to be fetched from the server.

       --volfile-server-port=PORT
              Port number of volfile server.

       --volfile-server-transport=TRANSPORT
              Transport type to get volume file from server (the default is tcp).

       --volume-name=VOLUME-NAME
              Volume  name  to be used for MOUNT-POINT (the default is top most volume in VOLUME-
              FILE).

       --worm Mount the filesystem in 'worm' mode.

       --xlator-option=VOLUME-NAME.OPTION=VALUE
              Add/Override a translator option for a volume with the specified value.

       --subdir-mount=SUBDIR-MOUNT-PATH
              Mount subdirectory instead of the '/' of volume.

   Fuse options
       --attribute-timeout=SECONDS
              Set attribute timeout to SECONDS for inodes in fuse kernel module (the  default  is
              1).

       --background-qlen=N
              Set fuse module's background queue length to N (the default is 64).

       --congestion-threshold=N
              Set fuse module's congestion threshold to N (the default is 48).

       --direct-io-mode=BOOL
              Enable/Disable the direct-I/O mode in fuse module (the default is enable).

       --dump-fuse=PATHR
              Dump fuse traffic to PATH

       --entry-timeout=SECONDS
              Set entry timeout to SECONDS in fuse kernel module (the default is 1).

       --gid-timeout=SECONDS
              Set auxiliary group list timeout to SECONDS for fuse translator (the default is 0).

       --negative-timeout=SECONDS
              Set negative timeout to SECONDS in fuse kernel module (the default is 0).

       --volfile-check
              Enable strict volume file checking.

   Miscellaneous Options
       -?, --help
              Display this help.

       --usage
              Display a short usage message.

       -V, --version
              Print the program version.

FILES

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

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

SEE ALSO

       fusermount(1), mount.glusterfs(8), gluster(8)

COPYRIGHT

       Copyright(c) 2006-2011  Red Hat, Inc.  <http://www.redhat.com>