NAME

       mount.glusterfs - script to mount native GlusterFS volume

SYNOPSIS

       mount -t glusterfs [-o <options>] <volumeserver>:/<volume>[/<subdir>] <mountpoint>

       mount -t glusterfs [-o <options>] <server1>,<server2>,
              <server3>,..<serverN>:/<volname>[/<subdir>] <mount_point>

       mount -t glusterfs [-o <options>] <path/to/volumefile> <mountpoint>

DESCRIPTION

       This tool is part of glusterfs(8) package, which is used to mount using GlusterFS native binary.

       mount.glusterfs  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.

OPTIONS

   Basic options
       log-file=LOG-FILE
              File to use for logging [default:/var/log/glusterfs/glusterfs.log]

       log-level=LOG-LEVEL
              Logging severity.  Valid options  are  TRACE,  DEBUG,  WARNING,  ERROR,  CRITICAL  INFO  and  NONE
              [default: INFO]

       acl    Mount the filesystem with POSIX ACL support

       fopen-keep-cache[=BOOL]
              Do not purge the cache on file open (default: false)

       worm   Mount the filesystem in 'worm' mode

       aux-gfid-mount
              Enable access to filesystem through gfid directly

       ro     Mount the filesystem read-only

       enable-ino32=BOOL
              Use 32-bit inodes when mounting to workaround broken applications that don't support 64-bit inodes

       mem-accounting
              Enable internal memory accounting

       capability
              Enable file capability setting and retrival

       thin-client
              Enables thin mount and connects via gfproxyd daemon

       localtime-logging
              Use local timestamps instead of UTC in mount log entries

   Advanced options
       attribute-timeout=SECONDS
              Set attribute timeout to SECONDS for inodes in fuse kernel module [default: 1]

       entry-timeout=SECONDS
              Set entry timeout to SECONDS in fuse kernel module [default: 1]

       background-qlen=N
              Set fuse module's background queue length to N [default: 64]

       gid-timeout=SECONDS
              Set auxiliary group list timeout to SECONDS for fuse translator [default: 0]

       negative-timeout=SECONDS
              Set negative timeout to SECONDS in fuse kernel module [default: 0]

       volume-name=VOLUME-NAME
              Volume name to be used for MOUNT-POINT [default: top most volume in VOLUME-FILE]

       direct-io-mode=BOOL|auto
              Specify fuse direct I/O strategy [default: auto]

       congestion-threshold=N
              Set fuse module's congestion threshold to N [default: 48]

       ubdir-mount=N
              Set the subdirectory mount option [default: NULL, ie, no subdirectory mount]

       backup-volfile-servers=SERVERLIST
              Provide list of backup volfile servers in the following format [default: None] If use IPv6 address
              in SERVERLIST, it is required to use '[' and ']' to surround IPv6 address.

              $ mount -t glusterfs -obackup-volfile-servers=<server2>:
                     <server3>:...:<serverN>   <server1>:/<volname>   <mount_point>   $   mount   -t   glusterfs
              -obackup-volfile-servers=<[ipv6_addr2]>:
                     <[ipv6_addr3]>:...:<[ipv6_addrN]> <ipv6_addr1>:/<volname> <mount_point>

       backupvolfile-server=SERVER
              Provide list of backup volfile servers in the following format [default: None]

               $ mount -t glusterfs -obackupvolfile-server=<server2>
                       <server1>:/<volname> <mount_point>

       fetch-attempts=N
              Deprecated option - placed here for backward compatibility [default: 1]

       lru-limit=N
              Set fuse module's limit for number of inodes kept in LRU list to N [default: 65536]

       inode-table-size=N
              Set the inode hash table size to N - this must be a power of 2 greater than or equal to 65536  and
              will be rounded up if not [default: 65536]

       invalidate-limit=N
              Suspend  fuse invalidations implied by 'lru-limit' if  number of outstanding invalidations reaches
              N

       background-qlen=N
              Set fuse module's background queue length to N [default: 64]

       no-root-squash=BOOL
              disable root squashing for the trusted client [default: off]

       root-squash=BOOL
              enable root squashing for the trusted client [default: on]

       use-readdirp=BOOL
              Use readdirp() mode in fuse kernel module [default: on]

       dump-fuse=PATH
              Dump fuse traffic to PATH

       kernel-writeback-cache=BOOL
              Enable fuse in-kernel writeback cache [default: off]

       attr-times-granularity=NS
              Declare supported granularity of file attribute [default: 0]

       auto-invalidation=BOOL
              controls whether fuse-kernel can auto-invalidate attribute, dentry and  page-cache.  Disable  this
              only if same files/directories are not accessed across two different mounts concurrently [default:
              on]

FILES

       /etc/fstab
              A typical GlusterFS entry in /etc/fstab looks like below

              server1:/mirror  /mnt/mirror  glusterfs log-file=/var/log/mirror.log,acl   0  0

       /proc/mounts
              An example entry of a GlusterFS mountpoint in /proc/mounts looks like below

              server1:/mirror /mnt/glusterfs fuse.glusterfs rw,allow_other,default_permissions,max_read=131072 0
              0

SEE ALSO

       glusterfs(8), mount(8), gluster(8)

COPYRIGHT

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

14 September 2013                              Cluster Filesystem                                   GlusterFS(8)