2009-03-03 16:04:15 +01:00
|
|
|
COMMENT(!MOD!zsh/attr
|
|
|
|
|
Builtins for manipulating extended attributes (xattr).
|
|
|
|
|
!MOD!)
|
|
|
|
|
The tt(zsh/attr) module is used for manipulating extended attributes.
|
|
|
|
|
The builtins in this module are:
|
|
|
|
|
|
|
|
|
|
startitem()
|
|
|
|
|
findex(zgetattr)
|
|
|
|
|
cindex(extended attributes, xattr, getting from files)
|
|
|
|
|
item(tt(zgetattr) var(filename) var(attribute) [ var(parameter) ])(
|
|
|
|
|
Get the extended attribute var(attribute) from the specified
|
|
|
|
|
var(filename). If the optional argument var(parameter) is given, the
|
|
|
|
|
attribute is set on that parameter instead of being printed to stdout.
|
|
|
|
|
)
|
|
|
|
|
findex(zsetattr)
|
|
|
|
|
cindex(extended attributes, xattr, setting on files)
|
|
|
|
|
item(tt(zsetattr) var(filename) var(attribute) var(value))(
|
|
|
|
|
Set the extended attribute var(attribute) on the specified
|
|
|
|
|
var(filename) to var(value).
|
|
|
|
|
)
|
|
|
|
|
findex(zdelattr)
|
|
|
|
|
cindex(extended attributes, xattr, removing, deleting)
|
|
|
|
|
item(tt(zdelattr) var(filename) var(attribute))(
|
|
|
|
|
Remove the extended attribute var(attribute) from the specified
|
|
|
|
|
var(filename).
|
|
|
|
|
)
|
|
|
|
|
findex(zlistattr)
|
|
|
|
|
cindex(extended attributes, xattr, listing)
|
|
|
|
|
item(tt(zlistattr) var(filename) [ var(parameter) ])(
|
|
|
|
|
List the extended attributes currently set on the specified
|
|
|
|
|
var(filename). If the optional argument var(parameter) is given, the
|
|
|
|
|
list of attributes is set on that parameter instead of being printed to stdout.
|
|
|
|
|
)
|
|
|
|
|
enditem()
|
2009-11-04 12:33:59 +01:00
|
|
|
|
|
|
|
|
tt(zgetattr) and tt(zlistattr) allocate memory dynamically. If the
|
|
|
|
|
attribute or list of attributes grows between the allocation and the call
|
|
|
|
|
to get them, they return 2. On all other errors, 1 is returned. This
|
|
|
|
|
allows the calling function to check for this case and retry.
|
