Debian Codegraph @

upstream/opensuse-tumbleweed/man8/vfs_glusterfs_fuse.8

raw
1 '\" t
2 .\" Title: vfs_glusterfs_fuse
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 05/26/2026
6 .\" Manual: System Administration tools
7 .\" Source: Samba 4.23.8-git.477.f78166bceedSUSE-oS16.9-x86_64
8 .\" Language: English
9 .\"
10 .TH "VFS_GLUSTERFS_FUSE" "8" "05/26/2026" "Samba 4\&.23\&.8\-git\&.477\&.f78166bcee" "System Administration tools"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 vfs_glusterfs_fuse \- Utilize features provided by GlusterFS
32 .SH "SYNOPSIS"
33 .HP \w'\ 'u
34 vfs objects = glusterfs_fuse
35 .SH "DESCRIPTION"
36 .PP
37 This VFS module is part of the
38 \fBsamba\fR(8)
39 suite\&.
40 .PP
41 GlusterFS (http://www\&.gluster\&.org) is an Open Source clustered file system capable of scaling to several peta\-bytes\&. With its FUSE based native client, GlusterFS is available as a POSIX compliant file system and can hence be shared by Samba without additional steps\&.
42 .PP
43 The
44 vfs_glusterfs_fuse
45 VFS module provides an enhanced way to access a Gluster filesystem using a Gluster FUSE mount\&. It provides support for the
46 get_real_filename
47 VFS call which enhances file access performance by avoiding multiple expensive case folding lookup calls to detect the appropriate case of an existing filename\&.
48 .PP
49 Furthermore, this module implements a substitute file\-id mechanism\&. The default file\-id mechanism is not working correctly for gluster fuse mount re\-exports, so in order to avoid data loss, users exporting gluster fuse mounts with Samba should enable this module\&.
50 .PP
51 This module can be combined with other modules, but it should be the last module in the
52 vfs objects
53 list\&. Modules added to this list to the right of the glusterfs entry may not have any effect at all\&.
54 .SH "CONFIGURATION"
55 .PP
56 A basic configuration looks like this\&.
57 .sp
58 .if n \{\
59 .RS 4
60 .\}
61 .nf
62 \fI[share]\fR
63 \m[blue]\fBvfs objects = glusterfs_fuse\fR\m[]
64 \m[blue]\fBpath = /absolute/path_of_fusemount\fR\m[]
65 .fi
66 .if n \{\
67 .RE
68 .\}
69 .PP
70 Note that
71 vfs_glusterfs_fuse
72 requires a Gluster mount\&. For accessing glusterfs directly over the GFAPI library please use the
73 vfs_glusterfs
74 module\&.
75 .SH "OPTIONS"
76 .PP
77 This module does currently have no further options\&.
78 .SH "VERSION"
79 .PP
80 This man page is part of version 4\&.23\&.8\-git\&.477\&.f78166bceedSUSE\-oS16\&.9\-x86_64 of the Samba suite\&.
81 .SH "AUTHOR"
82 .PP
83 The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&.