previous next trail start tutorial home feedback openwings.org

The ls command

The ls command is used to list discovered Openwings entities.

Syntax: ls [-lv] [<path>]

Typing "ls" immediately after starting the shell will show all contexts and container managers (also known as platforms) currently under the root level of the hierarchy.

The ls command can also be used to list the components, mbeans, services, and processes under a container manager:

Click above image to see full size

If used on a process, ls will display the names of mbeans and services under it.   If used on an mbean or service, the ls command will display the names of any UIs that are contained within.

The -l option specifies long list format, and the -v option specifies verbose list format.  In this release, both the -l and -v options do the same thing.   A long/verbose listing will display detailed status on components, including whether each component is executable (i.e., can be run with the process command) and what state each is in (installed, uninstalled, resolved, or authenticated).

If a component appears in the "installed" state, there are remaining dependencies that need to be resolved by the Openwings Install Service before the component can be run (e.g., component A may depend on the presence of component B).  Once all the needed components have been installed on a platform, the state of your component changes to "resolved", and you can execute the component using the process command (discussed later).

Next: The cd command

back to top

© Copyright 2002-2003, General Dynamics Decision Systems. All rights reserved.

previous next trail start tutorial home feedback openwings.org