fnattr(1)
NAME
fnattr - update and examine attributes associated with an
FNS named object
SYNOPSIS
fnattr [-AL] composite_name [ [-O | -U] identifier...]
fnattr [-L] composite_name [ -a [-s]
[-O | -U] identifier [value...] | -d [ [-O | -U] iden-
tifier [value...]] | -m
[-O | -U] identifier old_value new_value] ...
DESCRIPTION
The fnattr command is for updating and examining attributes
associated with an FNS named object. There are four uses for
this command: add an attribute or value, delete an attribute
or value, modify an attribute's value, and list the contents
of an attribute.
OPTIONS
The options for adding, modifying, and deleting attributes
and their values can be combined in the same command line.
The modifications will be executed in the order that they
are specified.
Any unsuccessful modification will abort all subsequent
modifications specified in the command line; any modifica-
tions already carried out will remain. The unsuccessful
modifications are displayed as output of fnattr.
-a Add an attribute or add a value to an attribute asso-
ciated with object named by composite_name. identif-
ier is the identifier of the attribute to manipulate;
its format is FN_ID_STRING unless the -O or -U option
is given. value ... represents the attribute values to
add. The attribute syntax used for storing value is
fn_attr_syntax_ascii.
-A Consult the authoritative source to get attribute
information.
-d Delete attributes associated with object named by
composite_name. If identifier is not specified, all
attributes associated with the named object are
deleted. If identifier is specified without accompany-
ing values (value ...), the entire attribute identi-
fied by identifier is removed. If individual attribute
values (value ...) are specified, then only these are
removed from the attribute. Removal of the last value
of an attribute entails removal of the attribute as
well. The format of identifier is FN_ID_STRING unless
the -O or -U option is given.
-L If the composite name is bound to an XFN link, manipu-
late the attributes associated with the object pointed
to by the link. If -L is not used, the attributes
associated with the XFN link are manipulated.
-m Modify the values of the attribute identified by
identifier associated with the object named by
composite_name. old_value is replaced by new_value in
the specified attribute. Other attributes and values
associated with composite_name are not affected. The
format of identifier is FN_ID_STRING unless the -O
or -U option is given.
-O The format of identifier is FN_ID_ISO_OID_STRING, an
ASN.1 dot-separated integer list string.
-s Add in supersede mode. If an attribute with the same
identifier as identifier already exists, remove all
its values, and replace with value. If this option is
omitted, the resulting values for the specified attri-
bute is a union of the existing values and value.
-U The format of identifier is FN_ID_DCE_UUID, a DCE UUID
in string form.
OPERANDS
The following operand is supported:
composite_name
An FNS named object.
EXAMPLES
Adding
The -a option is used for adding attributes and values. This
following command replaces the value of the shoesize attri-
bute of user/jane with the value 7.5:
eg% fnattr user/jane -as shoesize 7.5
The following command adds the value Chameleo to the pro-
ject attribute of user/jane:
eg% fnattr user/jsmith -a project Chameleo
Deleting
The -d option is used for deleting attributes and values.
The following command deletes all the attributes associated
with user/jane:
eg% fnattr user/jane -d
The following command deletes the attribute shoesize asso-
ciated with user/jane:
eg% fnattr user/jane -d shoesize
The following command deletes the attribute value
old_project from the projects attribute associated with
user/jane:
eg% fnattr user/jane -d projects old_project
Modifying
The -m option is for modifying an attribute value. The fol-
lowing command replaces the value Chameleo by Dungeon in
the projects attribute associated with user/jsmith:
eg% fnattr user/jsmith -m projects Chameleo Dungeon
The following command is an example of unsuccessful modifi-
cation attempts. The user executing this command does not
have permission to update user/jane's attributes but is
allowed to add new attributes. Executing the command will
add the attribute hatsize but will not delete shoesize or
modify dresssize because -d shoesize will fail and cause the
command to stop:
eg% fnattr user/jane -a hatsize medium -d shoesize -m
dresssize 5 6
Listing
No options are required to list attributes and their values.
The following command lists all the attributes associated
with user/jane:
eg% fnattr user/jane
The following command lists the values of the project
attribute of user/jane:
eg% fnattr user/jane project
The following command lists the values of the project and
shoesize attributes of user/jane:
eg% fnattr user/jane project shoesize
EXIT STATUS
0 Operation was successful.
1 Operation failed.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWfns |
|_____________________________|_____________________________|
SEE ALSO
fnlookup(1), attributes(5), fns(5)
NOTES
Built-in attributes, such as onc_unix_passwd for users, can-
not be updated using the fnattr command. Their contents are
affected by updates to the underlying naming service, such
as NIS+ or NIS.
Man(1) output converted with
man2html