[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    fnattr(1) manual page Table of Contents

Name

fnattr - Update and examine attributes associated with an FNS named object

Synopsis

fnattr -a [ -s ] composite_name [ -O | -U ] identifier
value1 [ value2 ... ]
fnattr -d composite_name
[[ -O | -U ] identifier [ value1 [ value2 ... ]]]
fnattr -m composite_name [ -O | -U ] identifier
old_value new_value
fnattr -l composite_name [[ -O | -U ] identifier ]

Availability

SUNWfns

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

-a
Add an attribute or add a value to an attribute associated with object named using composite_name. identifier is the identifier of the attribute to manipulate; its format is FN_ID_STRING unless the -O or -U option is given. value1, value2 ... are attribute values to add. The attribute syntax used for storing value1, value2 ... is fn_attr_syntax_ascii.
-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 accompanying values, value1, value2, ..., the entire attribute identified by identifier is removed. If individual attribute values, value1, value2, ..., 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
List the attribute (its identifier and values) associated with the object named by composite_name. If identifier is not specified, all the attribute associated with the named object are displayed. The format of identifier is FN_ID_STRING unless the -O or -U option is given.
-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.
-s
Add in supersede mode. If an attribute with the same identifier as identifier already exists, remove all its values, and replace    with value1, value2 ... If this option is omitted, the resulting values for the specified attribute is a union of the existing values and value1, value2 ....
-O
The format of identifier is FN_ID_ISO_OID_STRING, an ASN.1 dot-separated integer list string.
-U
The format of identifier is FN_ID_DCE_UUID, a DCE UUID in string form.

Examples

The -a option is used for adding attributes and values. This following command replaces the value of the shoesize attribute of user/jane with the value 7.5.
eg% fnattr -as user/jane shoesize 7.5
The following command adds the value Chameleo to the project attribute of user/jane.
eg% fnattr -a user/jsmith project Chameleo

The -d option is used for deleting attributes and values. The following command deletes all the attributes associated with user/jane.

eg% fnattr -d user/jane
The following command deletes the attribute shoesize associated with user/jane.
eg% fnattr -d user/jane shoesize
The following command deletes the attribute value old_project from the projects attribute associated with user/jane.
eg% fnattr -d user/jane projects old_project

The -m option is for modifying an attribute value. The following command replaces the value Chameleo by Dungeon in the projects attribute associated with user/jsmith.

eg% fnattr -m user/jsmith projects Chameleo Dungeon

The -l option is used for listing attributes and their values. The following command lists all the attributes associated with user/jane.

eg% fnattr -l user/jane
The following command list the values of the project attribute of user/jane.
eg% fnattr -l user/jane project

See Also

fnlookup(1) , fns(5)


Table of Contents