d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
15129224d4
freebsd-dev/usr.sbin/setextattr/setextattr.8

84 lines
2.7 KiB
Groff
Raw Normal View History

Introduce userland utilities to set and get extended attributes. These utilities do not present the world's greatest interface, and will undoubtably change soon. However, they do let people experiment with extended attributes, and provide samples of how to use the syscalls. Obtained from: TrustedBSD
2000-04-16 20:55:50 +00:00
.\"-
o Update getextattr and setextattr utilities to take into account the revised EA interface with explicit namespacing. Link against libutil to provide string/constant conversion for namespaces. Document revised interface. Obtained from: TrustedBSD Project
2001-03-15 03:09:48 +00:00
.\" Copyright (c) 2000, 2001 Robert N. M. Watson
Introduce userland utilities to set and get extended attributes. These utilities do not present the world's greatest interface, and will undoubtably change soon. However, they do let people experiment with extended attributes, and provide samples of how to use the syscalls. Obtained from: TrustedBSD
2000-04-16 20:55:50 +00:00
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
o Update getextattr and setextattr utilities to take into account the revised EA interface with explicit namespacing. Link against libutil to provide string/constant conversion for namespaces. Document revised interface. Obtained from: TrustedBSD Project
2001-03-15 03:09:48 +00:00
.\" $FreeBSD$
Introduce userland utilities to set and get extended attributes. These utilities do not present the world's greatest interface, and will undoubtably change soon. However, they do let people experiment with extended attributes, and provide samples of how to use the syscalls. Obtained from: TrustedBSD
2000-04-16 20:55:50 +00:00
.\"
.Dd March 30, 2000
.Dt SETEXTATTR 8
Minor mdoc markup fixes. Reviewed by: maintainer
2000-05-10 14:50:44 +00:00
.Os
Introduce userland utilities to set and get extended attributes. These utilities do not present the world's greatest interface, and will undoubtably change soon. However, they do let people experiment with extended attributes, and provide samples of how to use the syscalls. Obtained from: TrustedBSD
2000-04-16 20:55:50 +00:00
.Sh NAME
.Nm setextattr
.Nd set a named extended attribute
.Sh SYNOPSIS
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm
o Rename "namespace" argument to "attrnamespace" as namespace is a C++ reserved word. Submitted by: jkh Obtained from: TrustedBSD Project
2001-03-19 05:56:02 +00:00
.Ar attrnamespace
Introduce userland utilities to set and get extended attributes. These utilities do not present the world's greatest interface, and will undoubtably change soon. However, they do let people experiment with extended attributes, and provide samples of how to use the syscalls. Obtained from: TrustedBSD
2000-04-16 20:55:50 +00:00
.Ar attrname
.Ar filename
.Ar attrvalue
.Sh DESCRIPTION
.Nm
is a user tool to set a named extended attribute on a file or directory to
the provided string.
The
o Rename "namespace" argument to "attrnamespace" as namespace is a C++ reserved word. Submitted by: jkh Obtained from: TrustedBSD Project
2001-03-19 05:56:02 +00:00
.Ar attrnamespace
o Update getextattr and setextattr utilities to take into account the revised EA interface with explicit namespacing. Link against libutil to provide string/constant conversion for namespaces. Document revised interface. Obtained from: TrustedBSD Project
2001-03-15 03:09:48 +00:00
argument should be the namespace of the attribute to retrieve: legal
values are "user" and "system".
The
Introduce userland utilities to set and get extended attributes. These utilities do not present the world's greatest interface, and will undoubtably change soon. However, they do let people experiment with extended attributes, and provide samples of how to use the syscalls. Obtained from: TrustedBSD
2000-04-16 20:55:50 +00:00
.Ar attrname
argument should be the name of the attribute,
.Ar filename
the name of the file or directory to set the attribute for, and
.Ar attrvalue
a string to store in the attribute.
.Nm
will store the string in the file's attribute.
In order for
.Nm
to succeed, the attribute service must be available on the file system,
and appropriate privilege may be required.
.Sh EXAMPLES
o Update getextattr and setextattr utilities to take into account the revised EA interface with explicit namespacing. Link against libutil to provide string/constant conversion for namespaces. Document revised interface. Obtained from: TrustedBSD Project
2001-03-15 03:09:48 +00:00
.Dl # setextattr system md5 /kernel `md5 -q /kernel`
Introduce userland utilities to set and get extended attributes. These utilities do not present the world's greatest interface, and will undoubtably change soon. However, they do let people experiment with extended attributes, and provide samples of how to use the syscalls. Obtained from: TrustedBSD
2000-04-16 20:55:50 +00:00
.Pp
Minor man page formatting changes and improvements. Suggested by: chris
2000-04-17 00:21:08 +00:00
Set the
.Dq md5
extended attribute on the file /kernel to the string
containing the output of
.Dq md5 -q /kernel .
Introduce userland utilities to set and get extended attributes. These utilities do not present the world's greatest interface, and will undoubtably change soon. However, they do let people experiment with extended attributes, and provide samples of how to use the syscalls. Obtained from: TrustedBSD
2000-04-16 20:55:50 +00:00
.Sh SEE ALSO
.Xr extattrctl 8 ,
.Xr getextattr 8 ,
.Xr extattr 9
.Sh HISTORY
Extended attribute support was developed as part of the TrustedBSD Project,
Minor man page formatting changes and improvements. Suggested by: chris
2000-04-17 00:21:08 +00:00
and introduced in
.Fx 5.0 .
Introduce userland utilities to set and get extended attributes. These utilities do not present the world's greatest interface, and will undoubtably change soon. However, they do let people experiment with extended attributes, and provide samples of how to use the syscalls. Obtained from: TrustedBSD
2000-04-16 20:55:50 +00:00
It was developed to support security extensions requiring additional labels
to be associated with each file or directory.
.Sh AUTHORS
Robert N M Watson
.Sh BUGS
.Nm
can only be used to set attributes to strings.
Reference in New Issue Copy Permalink