summaryrefslogtreecommitdiff
path: root/man/man1
diff options
context:
space:
mode:
authorNathan Scott <nathans@sgi.com>2002-02-25 23:11:05 +0000
committerNathan Scott <nathans@sgi.com>2002-02-25 23:11:05 +0000
commit368202f9af7b38948fda25d9d07a2ed92fa7eb5c (patch)
treedc6a0a0f256210ef9687cc4090e03515979c796e /man/man1
parent5f174a9fbe68d24975819fb67cb8e29e71c44bc8 (diff)
downloadattr-368202f9af7b38948fda25d9d07a2ed92fa7eb5c.tar.gz
Merge of xfs-cmds-2.4.18:slinx:112587a by nathans.
redo short/long options in the way Andreas intended, and fix up man pages.
Diffstat (limited to 'man/man1')
-rw-r--r--man/man1/getfattr.146
-rw-r--r--man/man1/setfattr.126
2 files changed, 36 insertions, 36 deletions
diff --git a/man/man1/getfattr.1 b/man/man1/getfattr.1
index 7fadfc5..93de390 100644
--- a/man/man1/getfattr.1
+++ b/man/man1/getfattr.1
@@ -3,11 +3,11 @@
getfattr \- get extended attributes of filesystem objects
.SH SYNOPSIS
.nf
-\f3getfattr\f1 [\f3\-hvRLP\f1] \f3\-n name\f1 [\f3\-e en\f1] \c
+\f3getfattr\f1 [\f3\-hRLP\f1] \f3\-n name\f1 [\f3\-e en\f1] \c
\f3pathname\f1...
-\f3getfattr\f1 [\f3\-hvRLP\f1] \f3\-d\f1 [\f3\-e en\f1] \c
+\f3getfattr\f1 [\f3\-hRLP\f1] \f3\-d\f1 [\f3\-e en\f1] \c
[\f3\-m pattern\f1] \f3pathname\f1...
-\f3getfattr\f1 [\f3\-VH\f1]
+\f3getfattr\f1 [\f3\-\-version\f1]
.fi
.SH DESCRIPTION
For each file,
@@ -17,15 +17,15 @@ and the set of extended attribute names (and optionally values) which
are associated with that file.
.PP
The output format of
-.B "getfattr \-ds"
+.B "getfattr \-d"
is as follows:
.fam C
.RS
.nf
1: # file: somedir/
2: user.name0="value0"
- 3: system.name0="value1"
- 4: user.name1="value2"
+ 3: user.name1="value1"
+ 4: user.name2="value2"
5: ...
.fi
.RE
@@ -40,35 +40,31 @@ and
pairs associated with the specified file.
.SS OPTIONS
.TP 4
-.I \-n name
+.BR \-n " \f2name\f1, " \-\-name "=\f2name\f1"
Dump the value of the named extended attribute extended attribute.
.TP
-.I \-a
-Absolute names \- suppress the stripping of leading '/' from an absolute
-.IR pathname .
-.TP
-.I \-d
+.BR \-d ", " \-\-dump
Dump the values of all extended attributes associated with
.IR pathname .
.TP
-.I \-e en
+.BR \-e " \f2en\f1, " \-\-encoding "=\f2en\f1"
Encode values after retrieving them.
Valid values of
.I en
are "text", "hex", and "base64".
.TP
-.I \-h
+.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 examined.
.TP
-.I \-m
+.BR \-m " \f2pattern\f1, " \-\-match "=\f2pattern\f1"
.I pattern
is a regular expression pattern to apply to the set of extended
attribute names being returned.
It defaults to "^user\\." if no
-.I \-r
+.B \-m
is specified, which causes
.B getfattr
to operate on only extended attributes from the user namespace.
@@ -76,28 +72,32 @@ Refer to
.BR attr (5)
for a more detailed discussion on namespaces.
.TP
-.I \-v
+.B \-\-absolute-names
+Suppress the stripping of leading '/' from an absolute
+.IR pathname .
+.TP
+.B \-\-only-values
Dump out the extended attribute value(s) only.
.TP
-.I \-R
+.BR \-R ", " \-\-recursive
Recurse into subdirectories, dumping extended attributes for each file
encountered (breadth first).
.TP
-.I \-L
+.BR \-L ", " \-\-logical
Refines the \-R option - "logical walk" (do follow symbolic links).
.TP
-.I \-P
+.BR \-P ", " \-\-physical
Refines the \-R option - "physical walk" (do not follow symbolic links).
.TP
-.I \-V
+.B \-\-version
Print the version of
.B getfattr
and exit.
.TP
-.I \-h
+.B \-\-help
Print help explaining the command line options.
.TP
-.I \-\-
+.B \-\-
End of command line options.
All remaining parameters are interpreted as file names, even if they
start with a dash character.
diff --git a/man/man1/setfattr.1 b/man/man1/setfattr.1
index c605651..d032801 100644
--- a/man/man1/setfattr.1
+++ b/man/man1/setfattr.1
@@ -3,10 +3,10 @@
setfattr \- 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]
+\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
@@ -18,40 +18,40 @@ with an extended attribute
for each specified file.
.SS OPTIONS
.TP 4
-.I \-n name
+.BR \-n " \f2name\f1, " \-\-name "=\f2name\f1"
Set the value of the named extended attribute extended attribute.
.TP
-.I \-l
+.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
-.I \-x
+.BR \-x " \f2name\f1, " \-\-remove "=\f2name\f1"
Remove the named extended attribute entirely.
.TP
-.I \-v
+.BR \-v " \f2value\f1, " \-\-value "=\f2value\f1"
Specifies the new value for the named extended attribute.
.TP
-.I \-B
+.BR \-\-restore =\f2file\f1
Restores extended attributes using values from the specified file.
The file must be in the format generated by the
.B getfattr
-command (\-sdlR options).
+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.
.TP
-.I \-V
+.B \-\-version
Print the version of
.B setfattr
and exit.
.TP
-.I \-h
+.B \-\-help
Print help explaining the command line options.
.TP
-.I \-\-
+.B \-\-
End of command line options.
All remaining parameters are interpreted as file names, even if they
start with a dash character.