diff options
author | Nathan Scott <nathans@sgi.com> | 2002-02-26 02:32:48 +0000 |
---|---|---|
committer | Nathan Scott <nathans@sgi.com> | 2002-02-26 02:32:48 +0000 |
commit | 0406b735ddf3c52d4213cce77ba8c26d86979bee (patch) | |
tree | 97b64799087cc57fa747f8021819797a5ae3b4bc /man/man1 | |
parent | 368202f9af7b38948fda25d9d07a2ed92fa7eb5c (diff) | |
download | attr-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.1 | 36 | ||||
-rw-r--r-- | man/man1/setfattr.1 | 34 |
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 |