RMEXTATTR(8)            NetBSD System Manager's Manual            RMEXTATTR(8)

NAME
     getextattr, lsextattr, rmextattr, setextattr -- manipulate extended
     attributes

SYNOPSIS
     getextattr [-fhqsx] attrnamespace attrname filename ...
     lsextattr [-fhq] attrnamespace filename ...
     rmextattr [-fhq] attrnamespace attrname filename ...
     setextattr [-fhnq] attrnamespace attrname attrvalue filename ...

DESCRIPTION
     These utilities are user tools to manipulate the named extended
     attributes on files and directories.  The attrnamespace argument should
     be the namespace of the attribute to retrieve: legal values are user and
     system.  The attrname argument should be the name of the attribute,
     filename the name of the target file or directory, attrvalue a string to
     store in the attribute.

     The following options are available:

     -f      (Force.)  Ignore errors on individual filenames and continue with
             the remaining arguments.

     -h      (No follow.)  If the file is a symbolic link, perform the opera-
             tion on the link itself rather than the file that the link points
             to.

     -n      (NUL-terminate.)  NUL-terminate the extent content written out.

     -q      (Quiet.)  Do not print out the pathname and suppress error mes-
             sages.

     -s      (Stringify.)  Escape nonprinting characters and put quotes around
             the output.

     -x      (Hex.)  Print the output in hexadecimal.

EXAMPLES
     setextattr system md5 `md5 -q /boot/kernel/kernel` /boot/kernel/kernel
     getextattr system md5 /boot/kernel/kernel
     lsextattr system /boot/kernel/kernel
     rmextattr system md5 /boot/kernel/kernel

SEE ALSO
     extattr(2), extattr(3), extattrctl(8), extattr(9)

HISTORY
     Extended attribute support was developed as part of the TrustedBSD
     Project, and introduced in FreeBSD 5.0 and NetBSD 3.0.  It was developed
     to support security extensions requiring additional labels to be associ-
     ated with each file or directory.

AUTHORS
     Robert N M Watson
     Poul-Henning Kamp

BUGS
     The setextattr utility can only be used to set attributes to strings.

NetBSD 3.1                      January 2, 2005                     NetBSD 3.1