Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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:

       o   a --	List all objects in the	database.

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

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

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

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

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

       o   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				  07/08/2017			      LS(nged)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | AUTHOR | BUG REPORTS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ls&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help