PreviousNext

directory list

Returns a list of the names of all the descendants of a directory. The syntax is:

directory list directory_name_list [-directories] [-objects]
[-links] [-simplename | -fullname]

Options

-directories
This option lists the names of all descendant directories.

-objects
This option lists the names of all descendant objects.

-links
This option lists the names of all descendant soft links.

-simplename
Returns just the RDN (relative distinguished name) of the name.

-fullname
Returns the entire name.

Description
The directory list operation returns a list of the names of all the descendants of a directory. Descendants can include all directories, objects, links, and clearinghouses of the directory. The directory_name_list argument is a list of names of directories to be operated on. This command returns only the names of descendants, so there is no way to tell the class of each name unless by convention (for instance, most clearinghouses end with _ch). Use the following options to specify the types of descendants to return: -directories, -objects, -links. The options take no values and can be used in combination. By default or if the -fullname option is specified, fullnames are returned. Use the -simplename option to return the last RDN (relative distinguished name) of the name.

Privileges Required
You must have r (read) permission to the directory named in the argument.

Examples
The following example lists a soft link in the /.:/depts/administration directory that points to a server entry in the /.:/depts/phrenology/applications directory.

dcecp> dir list /.:/depts/administration -link
/.../ward_cell.osf.org/depts/administration/bump_server1
dcecp>