summaryrefslogtreecommitdiff
path: root/man/man1/setfattr.1
blob: 6b71d2ada089a153249236f32856186f1a004b57 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
.TH SETFATTR 1 "Extended Attributes" "Dec 2001" "File Utilities"
.SH NAME
setfattr, aset \- set extended attributes of filesystem objects
.SH SYNOPSIS
.nf
\f3setfattr\f1 [\f3\-l\f1] \f3\-n name\f1 [\f3\-v value\f1] \f3pathname\f1...
\f3setfattr\f1 [\f3\-l\f1] \f3\-x name\f1 \f3pathname\f1...
\f3setfattr\f1 [\f3\-l\f1] \f3\-B file\f1
\f3setfattr\f1 [\f3\-Vh\f1]
.fi
.SH DESCRIPTION
The 
.B setfattr
command is used to associate a new
.I value
with an extended attribute
.IR name
for each specified file.
.PP
.B aset
is exactly the same as
.BR setfattr ,
and is installed for compatibility purposes.
.SS OPTIONS
.TP 4
.I \-n name
Set the value of the named extended attribute extended attribute.
.TP
.I \-l
Do not follow symlinks - if
.I pathname
is a symbolic link, it is not followed, but is instead itself the
inode being modified.
.TP
.I \-x
Remove the named extended attribute entirely.
.TP
.I \-v
Specifies the new value for the named extended attribute.
.TP
.I \-B
Restores extended attributes using values from the specified file.
The file must be in the format generated by the
.B getfattr
command (\-sdlR options).
The file name
.I \-
may be used in conjunction with this option, to specify the
standard input stream to be used rather than a named file.
.TP
.I \-V
Print the version of
.B setfattr
and exit.
.TP
.I \-h
Print help explaining the command line options.
.TP
.I \-\-
End of command line options.
All remaining parameters are interpreted as file names, even if they
start with a dash character.
.SH AUTHOR
Andreas Gruenbacher,
.RI < a.gruenbacher@computer.org >
and the SGI XFS development team,
.RI < linux-xfs@oss.sgi.com >.
.P
Please send your bug reports or comments to these addresses.
.SH "SEE ALSO"
getfattr(1), and attr(5).