summaryrefslogtreecommitdiff
path: root/man/man1
diff options
context:
space:
mode:
authorNathan Scott <nathans@sgi.com>2002-02-26 02:32:48 +0000
committerNathan Scott <nathans@sgi.com>2002-02-26 02:32:48 +0000
commit0406b735ddf3c52d4213cce77ba8c26d86979bee (patch)
tree97b64799087cc57fa747f8021819797a5ae3b4bc /man/man1
parent368202f9af7b38948fda25d9d07a2ed92fa7eb5c (diff)
downloadattr-0406b735ddf3c52d4213cce77ba8c26d86979bee.tar.gz
bump to 2.0.1, we should now be completely sync'd with Andreas for "attr".
Diffstat (limited to 'man/man1')
-rw-r--r--man/man1/getfattr.136
-rw-r--r--man/man1/setfattr.134
2 files changed, 38 insertions, 32 deletions
diff --git a/man/man1/getfattr.1 b/man/man1/getfattr.1
index 93de390..014aa63 100644
--- a/man/man1/getfattr.1
+++ b/man/man1/getfattr.1
@@ -7,7 +7,6 @@ getfattr \- get extended attributes of filesystem objects
\f3pathname\f1...
\f3getfattr\f1 [\f3\-hRLP\f1] \f3\-d\f1 [\f3\-e en\f1] \c
[\f3\-m pattern\f1] \f3pathname\f1...
-\f3getfattr\f1 [\f3\-\-version\f1]
.fi
.SH DESCRIPTION
For each file,
@@ -52,42 +51,47 @@ Encode values after retrieving them.
Valid values of
.I en
are "text", "hex", and "base64".
+Values encoded as text strings are enclosed in double quotes ("),
+while strings encoded as hexidecimal and base64 are prefixed with
+0x and 0s, respectively.
.TP
.BR \-h ", " \-\-no-dereference
-Do not follow symlinks - if
+Do not follow symlinks.
+If
.I pathname
-is a symbolic link, it is not followed, but is instead itself the
-inode being examined.
+is a symbolic link, the symbolic link itself is examined,
+rather than the file the link refers to.
.TP
.BR \-m " \f2pattern\f1, " \-\-match "=\f2pattern\f1"
+Only include attributes with names matching the regular expression
+.IR pattern .
+The default value for
.I pattern
-is a regular expression pattern to apply to the set of extended
-attribute names being returned.
-It defaults to "^user\\." if no
+is "^user\\\\.",
.B \-m
-is specified, which causes
-.B getfattr
-to operate on only extended attributes from the user namespace.
+which includes all the attributes in the user namespace.
Refer to
.BR attr (5)
for a more detailed discussion on namespaces.
.TP
.B \-\-absolute-names
-Suppress the stripping of leading '/' from an absolute
-.IR pathname .
+Do not strip leading slash characters ('/').
+The default behaviour is to strip leading slash characters.
.TP
.B \-\-only-values
Dump out the extended attribute value(s) only.
.TP
.BR \-R ", " \-\-recursive
-Recurse into subdirectories, dumping extended attributes for each file
-encountered (breadth first).
+List the attributes of all files and directories recursively.
.TP
.BR \-L ", " \-\-logical
-Refines the \-R option - "logical walk" (do follow symbolic links).
+Logical walk, follow symbolic links.
+The default behaviour is to follow symbolic link arguments, and to
+skip symbolic links encountered in subdirectories.
.TP
.BR \-P ", " \-\-physical
-Refines the \-R option - "physical walk" (do not follow symbolic links).
+Physical walk, skip all symbolic links.
+This also skips symbolic link arguments.
.TP
.B \-\-version
Print the version of
diff --git a/man/man1/setfattr.1 b/man/man1/setfattr.1
index d032801..2289486 100644
--- a/man/man1/setfattr.1
+++ b/man/man1/setfattr.1
@@ -6,12 +6,11 @@ setfattr \- set extended attributes of filesystem objects
\f3setfattr\f1 [\f3\-h\f1] \f3\-n name\f1 [\f3\-v value\f1] \f3pathname\f1...
\f3setfattr\f1 [\f3\-h\f1] \f3\-x name\f1 \f3pathname\f1...
\f3setfattr\f1 [\f3\-h\f1] \f3\-\-restore=file\f1
-\f3setfattr\f1 [\f3\-\-version\f1]
.fi
.SH DESCRIPTION
The
.B setfattr
-command is used to associate a new
+command associates a new
.I value
with an extended attribute
.IR name
@@ -19,29 +18,32 @@ for each specified file.
.SS OPTIONS
.TP 4
.BR \-n " \f2name\f1, " \-\-name "=\f2name\f1"
-Set the value of the named extended attribute extended attribute.
+Specifies the name of the extended attribute to set.
.TP
-.BR \-h ", " \-\-no-dereference
-Do not follow symlinks - if
-.I pathname
-is a symbolic link, it is not followed, but is instead itself the
-inode being modified.
+.BR \-v " \f2value\f1, " \-\-value "=\f2value\f1"
+Specifies the new value for the extended attribute.
.TP
.BR \-x " \f2name\f1, " \-\-remove "=\f2name\f1"
Remove the named extended attribute entirely.
.TP
-.BR \-v " \f2value\f1, " \-\-value "=\f2value\f1"
-Specifies the new value for the named extended attribute.
+.BR \-h ", " \-\-no-dereference
+Do not follow symlinks. If
+.I pathname
+is a symbolic link, it is not followed, but is instead itself the
+inode being modified.
.TP
.BR \-\-restore =\f2file\f1
-Restores extended attributes using values from the specified file.
+Restores extended attributes from file.
The file must be in the format generated by the
.B getfattr
-command.
-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.
+command with the
+.B \-\-dump
+option.
+If a dash (\c
+.IR \- )
+is given as the file name,
+.B setfattr
+reads from standard input.
.TP
.B \-\-version
Print the version of