LS

## Name

ls — The command with no object argument lists the name of every object in the database (in alphabetical order) except for those marked as hidden with the hide command. If the object argument is supplied, only those objects are listed.

## Synopsis

`ls` [-A -o -a -c -r -s -p -l -q -H -S] [`objects`]

## DESCRIPTION

The command with no object argument lists the name of every object in the database (in alphabetical order) except for those marked as hidden with the hide command. If the object argument is supplied, only those objects are listed. The object argument may include regular expressions. If the -A option is used, then the arguments are expected to be a list of attribute name/value pairs, and objects having attributes that match the provided list are listed. By default, an object must match all the specified attributes in order to be listed; however, the -o flag indicates that an object matching at least one attribute name/value pair should be listed. See the attr command for information on how to set or get attributes. Regular expressions are not supported for attributes. The following options are also allowed:

- a -- List all objects in the database.

- c -- List all non-hidden combinations in the database.

- r -- List all non-hidden regions in the database.

- s -- List all non-hidden primitives in the database.

- p -- List all non-hidden primitives in the database.

- l -- Use long format showing object name, object type, major type, minor type, and length.

- H -- When printing using long format, use human readable sizes for object size.

- S -- Sort using object size rather than object name.

- q -- Suppress informational output messages during database lookup process

The ls command is a synonym for the t command. Note that when any of the above options are used, the output is not formatted.

## EXAMPLES

The examples show the use of the ls command and its options to list objects, primitives, regions, or combinations having a specific object.

Example 1. List all objects beginning with a particular name.

`mged>` `ls shape*`

  Lists all objects with names beginning with "shape" (output is formatted).

Example 2. List all objects beginning with a particular name.

`mged>``ls -a shape*`

Lists all objects with names beginning with "shape."

Example 3. List all primitives beginning with a particular name.

`mged>``ls -p wheel*`

Lists all primitives with names beginning with "wheel."

Example 4. List all regions beginning with a particular name.

`mged>``ls -r wheel*`

Lists all regions with names beginning with "wheel."

Example 5. List all combinations beginning with a particular name.

`mged>``ls -c suspension*`

Lists all combinations with names beginning with "suspension."

Example 6. List all regions having particular attributes.

`mged>``ls -A -o -r Comment{First comment} Comment{Second comment}`

Lists all regions that have a "Comment" attribute that is set to either "First comment" or "Second comment."

## AUTHOR

BRL-CAD Team

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to `<devs@brlcad.org>`