glusterfs

1

2
.\"  Copyright (c) 2017 Red Hat, Inc. <http://www.redhat.com>
3
.\"  This file is part of GlusterFS.
4
.\"
5
.\"  This file is licensed to you under your choice of the GNU Lesser
6
.\"  General Public License, version 3 or any later version (LGPLv3 or
7
.\"  later), or the GNU General Public License, version 2 (GPLv2), in all
8
.\"  cases as published by the Free Software Foundation.
9
.\"
10
.\"
11
.TH gluster-setgfid2path 8 "Command line utility to set GFID to Path Xattrs"
12
.SH NAME
13
gluster-setgfid2path - Gluster tool to set GFID to Path xattrs
14
.SH SYNOPSIS
15
.B gluster-setgfid2path
16
.IR file
17
.SH DESCRIPTION
18
New feature introduced with Gluster release 3.12, to find full path from GFID.
19
This feature can be enabled using Volume set command \fBgluster volume set
20
<VOLUME> storage.gfid2path enable\fR
21
.PP
22
Once \fBgfid2path\fR feature is enabled, it starts recording the necessary
23
xattrs required for the feature. But it will not add xattrs for the already
24
existing files. This tool provides facility to update the gfid2path xattrs for
25
the given file path.
26

27
.SH EXAMPLES
28
To add xattrs of a single file,
29
.PP
30
.nf
31
.RS
32
gluster-setgfid2path /bricks/b1/hello.txt
33
.RE
34
.fi
35
.PP
36
To set xattr for all the existing files, run the below script on each bricks.
37
.PP
38
.nf
39
.RS
40
BRICK=/bricks/b1
41
find $BRICK -type d \\( -path "${BRICK}/.trashcan" -o -path \\
42
    "${BRICK}/.glusterfs" \\) -prune -o -type f \\
43
    -exec gluster-setgfid2path {} \\;
44
.RE
45
.fi
46
.PP
47
.SH SEE ALSO
48
.nf
49
\fBgluster\fR(8)
50
\fR
51
.fi
52
.SH COPYRIGHT
53
.nf
54
Copyright(c) 2017   Red Hat, Inc.   <http://www.redhat.com>
55