## Name

attr — Used to create, change, retrieve, or view attributes of database objects.

## Synopsis

`attr` [get] [set] [rm] [append] [show] {`object_name`} [`arguments`]

## DESCRIPTION

Used to create, change, retrieve, or view attributes of database objects. The arguments for "set" and "append" subcommands are attribute name/value pairs. The arguments for "get," "rm," and "show" subcommands are attribute names. The "set" subcommand sets the specified attributes for the object. The "append" subcommand appends the provided value to an existing attribute, or creates a new attribute if it does not already exist. The "get" subcommand retrieves and displays the specified attributes. The "rm" subcommand deletes the specified attributes. The "show" subcommand does a "get" and displays the results in a user readable format. Note that the attribute names may not contain embedded white space, and if attribute values contain embedded white space, they must be surrounded by {} or double quotes.

## EXAMPLES

The examples demonstrate the use of the attr command and subcommands to assign and list attributes of database objects.

Example 1. Assigns an attribute to an object.

`mged` `attr set region_1 comment {This is a comment for region_1}`

  Assigns an attribute named "comment" to region_1. Its value is "This is a comment for region_1."

Example 2. List all the attributes for an object

`mged` `attr show region_1 comment`

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to <devs@brlcad.org>, or via the "cadbug.sh" script.