ls

LS(nged)                     BRL-CAD User Commands                    LS(nged)



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] [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.

       ·   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>, or via the "cadbug.sh" script.



BRL-CAD                           09/09/2016                          LS(nged)