RADE

Source Code Manager

adl_ls_out

Listing objects

Quick Reference

Abstract

The adl_ls_out command displays the list of objects (identifier, relative name) in the specified image of the workspace or of the current workspace

Synopsis
Usage
Options
Examples
References

Synopsis

adl_ls_out [object...[{-d|-itself} [-rec]]] [-ws workspace_name -image image_name] [-all] [-rel_to_folder] [-soft_obj_info] [-tree ws_tree_name...] [-program [-sep | -separator char]] [-out file_path] [-h | -help | -?]

Usage

This command displays information on objects belonging to a workspace.
These information are:

the SCM identifier, in a specific format (see examples for more details)
the SCM relative path

A user doesn't usually need these information. In case of problem, they can be useful.

In a program mode, the information are displayed in the following form:

directory (1) or file (0)
text (1) or binary (0)
official check-out (1), private check-out (1)
executable permission (1), or not executable (0)
content identifier
size in bytes
creation date

The "-program" option displays information in a specific output mode. For more details, see the article explaining this option.

[Top]

Options

adl_ls_out accepts the following options:

`-h\|-help\|-?`	Help of the command
`object ...`	Name of the object
`-d\|-itself`	Display the SCM object itself
`-rec`	Display recursively the contained objects
`-ws workspace_name`	Name of the workspace
`-image image_name`	Name of the image for which the objects are to list
`-all`	Look for all information (directory or file, text or binary, official check-out, private check-out, executable permission, content identifier, size in bytes, creation date)
`-rel_to_folder`	Display the object name relative to the folder and the folder identifier (or <NULL>)
`-soft_obj_info`	Display the SCM object type : framework, module, data, directory or file. If the object is a component, its responsible name and its workspace tree are displayed
`-tree ws_tree_name ...`	Names of the workspace trees used to filter the output
`-program`	Display the output in a program mode
`-sep char`	Separator between each field (default value is blank)
`-separator char`	Separator between each field (default value is blank)
`-out file_path`	Path of the file where the results are stored

Examples

Display all the current workspace's objects in a normal mode:

adl_ls_out

+2BzlT2pfsL36-++-gRU+9_BzmiG9oIXwQ3+++-5+-P AdeleTools/data.d/Shell/run_map.bat
+2BzlT2pfsL36-++-gRU+9_BzcDumYia3w-++-IzU+8 AdeleConfigManagement/ADLCMCommand.m
+2BzlT2pfsL36-++-gRU+9_BzcMYWYia3w-+++hq++D AdeleConfigManagement/ADLCheck.m/src/AdeleList.cpp

Display of all the current workspace's objects in a normal mode with all the information:

adl_ls_out -all

+2BzlT2pfsL36-++-gRU+9_BzmiG9oIXwQ3+++-5+-P AdeleTools/data.d/Shell/run_map.bat
+2BzlT2pfsL36-++-gRU+9_BzcDumYia3w-++-IzU+8 AdeleConfigManagement/ADLCMCommand.m Dir
+2BzlT2pfsL36-++-gRU+9_BzcMYWYia3w-+++hq++D AdeleConfigManagement/ADLCheck.m/src/AdeleList.cpp File Text Co:N Priv:N Exe
c:N ContentId:CEYltemLFyU-+++qaU+9 Size:1565 Date:Friday, April 28, 2000 07:48:48 AM

Display of all the current workspace's objects in a program mode with all the information:

adl_ls_out -all -program

+2BzlT2pfsL36-++-gRU+9_BzmiG9oIXwQ3+++-5+-P AdeleTools/data.d/Shell/run_map.bat
+2BzlT2pfsL36-++-gRU+9_BzcDumYia3w-++-IzU+8 AdeleConfigManagement/ADLCMCommand.m 1
+2BzlT2pfsL36-++-gRU+9_BzcMYWYia3w-+++hq++D AdeleConfigManagement/ADLCheck.m/src/AdeleList.cpp 0 1 0 0 0 CEYltemLFyU-+++
qaU+9 1565 956900928

In case of multi-tree workspaces, the result of the command can be filtered by workspace trees.

In the following example, the workspace Ws1 is a multi-tree workspace.

Workspace tree : T1 - RootWsT1 ! +- Ws1 ! +- FW1inT1
Workspace tree : T2 - RootWsT2 ! +- Ws1 ! +- FW1inT2

Display all the current workspace's objects in a normal mode:

adl_ls_out

+0Cco05F--SMA3+++04k3c_Ck83O---SMA3+++-ukBI FW1inT1
+0Cco05F--SMA3+++04k3c_Ck83dl--SMA3+++-fk6O FW1inT1/module.m
+0Cco05F--SMA3+++04k3c_Ck83gl--SMA3+++-uk6t FW1inT1/module.m/dir1
+0Ck2g1F--SMA3+++-cU+S_Ck2ht---SMA3+++-+ECt FW1inT2
+0Ck2g1F--SMA3+++-cU+S_Ck2zd---SMA3+++-Q+8e FW1inT2/mod.m
+0Ck2g1F--SMA3+++-cU+S_Ck6xhV--SMA3+++-LkBG FW1inT2/mod.m/dir1
+0Ck2g1F--SMA3+++-cU+S_Ckcspl--SMA3+++-p+9a FW1inT2/mod.m/fic1.h

Display all the current workspace's objects in a normal mode filtered by tree:

adl_ls_out -tree T1

+0Cco05F--SMA3+++04k3c_Ck83O---SMA3+++-ukBI FW1inT1
+0Cco05F--SMA3+++04k3c_Ck83dl--SMA3+++-fk6O FW1inT1/module.m
+0Cco05F--SMA3+++04k3c_Ck83gl--SMA3+++-uk6t FW1inT1/module.m/dir1

Display the objects contained in a given object of the current workspace in a normal mode:

adl_ls_out FW1inT1

+0Cco05F--SMA3+++04k3c_Ck83dl--SMA3+++-fk6O FW1inT1/module.m
+0Cco05F--SMA3+++04k3c_Ck83gl--SMA3+++-uk6t FW1inT1/module.m/dir1

Display the informations of a given object of the current workspace in a normal mode:

adl_ls_out FW1inT1 -d

+0Cco05F--SMA3+++04k3c_Ck83O---SMA3+++-ukBI FW1inT1

Display the informations of a given object of the current workspace in a normal mode, with all its contained objects found recursively:

adl_ls_out FW1inT1 -d -rec

+0Cco05F--SMA3+++04k3c_Ck83O---SMA3+++-ukBI FW1inT1
+0Cco05F--SMA3+++04k3c_Ck83dl--SMA3+++-fk6O FW1inT1/module.m
+0Cco05F--SMA3+++04k3c_Ck83gl--SMA3+++-uk6t FW1inT1/module.m/dir1

[Top]

References

[1]	adl_mk_elem: Creating an object

[Top]

History

Version: 2 [Nov 2001]	Document update
Version: 1 [Mar 2001]	Document creation

[Top]