Commands Reference, Volume 4

nisls Command

Purpose

Lists the contents of an NIS+ directory.

Syntax

nisls [ -d ] [ -g ] [ -l ] [ -L ] [ -m ] [ -M ] [ -R ] [ Directory... ]

The nisls command writes to standard output the contents of each directory specified in the parameter that is an NIS+ directory. If Directory specifies any other NIS+ object that is not a directory, nisls simply echoes the object's name. If no directory is given as a parameter, the first directory in the search path, the default, is listed (see nisdefaults).

Flags

-d	Treats an NIS+ directory like other NIS+ objects instead of listing its contents.
-g	Displays group owner instead of owner when using the -l flag to list in long format.
-l	Lists in long format. The -l flag displays additional information about the Directory such as its type, creation time, owner, and permission rights.
-L	Indicates that links are to be followed. If Directory actually points to a link, it is followed to a link object.
-m	Displays modification time instead of creation time when using the -l flag to list contents in long format.
-M	Specifies that the master server of the named directory returns the standard output of the nisls command. Using the -M flag guarantees that the most current information is listed.
-R	Lists directories recursively. The -R flag displays the contents of each subdirectory contained in the directory specified in Directory.

Environment

NIS_PATH

Searches each directory specified until the object is found if the NIS+ directory name is not fully qualified (see nisdefaults).

Exit Status

0	Successful completion.
1	An error occurred.

Examples

To list in short format the contents of org.com., including its subdirectories, enter:
```
nisls -R org.com.
```
To display detailed information about rootmaster.org.com., including when it was last modified, enter:
```
nisls -lm rootmaster.org.com.
```

Related Information

The nisdefaults command, nisgrpadm command, nismatch command, and nistbladm command.