NAME

dls − list contents of remote DECnet directory

SYNTAX

dls [ options ] filespec

DESCRIPTION

The dls command lists the contents of a remote DECnet directory.  For each file argument, the dls command lists the file name and additional optional information, (if requested).  If you do not specify any file argument(s), dls command lists the entire contents of the directory that you specify. 

The filespec argument is a complete file specification for a remote DECnet directory or file.  The format for a file spec varies with each Digital operating system.  See the DECnet-ULTRIX documentation for a description of all foreign file specifications. 

You can specify wildcard characters in a file specification.  You must enclose in quotes those portions of a file specification that you do not want the local shell to interpret, such as the portions of a file specification that contain foreign wildcard characters.  See the DECnet-ULTRIX documentation for more information. 

File Protection Levels Returned by the -l Option are:

Example ULTRIX System Protection Setting: -rwxrw-r--

The ULTRIX file protection characters are interpreted as follows:

dIndicates that the entry is a directory. 

bIndicates that the entry is a block-type special file. 

cIndicates that the entry is a character-type special file. 

sIndicates that the entry is a socket. 

−Indicates that the entry is a regular file. 

The next nine characters represent three protection groups consisting of three bits each.  The first three bits define owner-level permissions, the next three bits define group-level permissions, and the last three bits define world-level permissions.  Within each level, the three bits are represented by the characters r, w, and x, which are defined as follows (for a directory, execute permission implies permission to search the directory):

rIndicates a file is readable, at the respective level. 

wIndicates a file is writable, at the respective level. 

xIndicates a file is executable, at the respective level. 

−Indicates no permission has been set, at the respective level. 

The group-execute permission character s indicates a file has the set-group-id bit set.  Also, the user-execute permission character s indicates a file has the set-user-id bit set. 

The last character of an ULTRIX protection setting (which is normally x or −), is t if the 1000 bit of the file mode is on. 

Example Non-ULTRIX System Protection Setting: rwxrwxr-----

Non-DECnet-ULTRIX systems set file protections at four levels: system, owner, group, and world.  Each level consists of three bits, which are represented by the characters r, w, and x, defined as follows:

rIndicates read permission, at the respective level. 

wIndicates write permission, at the respective level. 

xIndicates execute permission, at the respective level. 

−Indicates no permission has been set, at the respective level. 

OPTIONS

−C Formats a directory listing in a multicolumn format.  This is the default option when the standard output is a terminal. 

−1 Formats a directory listing in a single-column format.  This is the default option when the standard output is not a terminal. 

−a Lists all files in an ULTRIX directory, including those whose names begin with a period (.).  These files normally are not listed. 

−d Prints debugging information, in the form of DAP message traces, to stderr. 

−l Lists the contents of a DECnet directory in long format.  For each file argument, the list contains the filename, the protection levels, the creation date, and the size in bytes. 

EXAMPLES

 dls smog::’dra1:[buckley]’ <RET>

This command lists all of the files located on DECnet-VAX node Smog1, on dra1: in the user file directory [buckley].

dls -l ’smog::dba0:[fraser]test.dat’>info.tes <RET>

This command lists information (in long format) for the file test.dat located on DECnet-RSX node Smog on dba0: in the user file directory [fraser] and directs that information to the file info.tes on the local DECnet-ULTRIX node.

DIAGNOSTICS

This section defines the format for dls diagnostic messages.  You must refer DECnet-ULTRIX documentation for further information. 

dls: unknown command flag (flag)

You have specified a flag option, (defined by the flag variable), which dls does not recognize. 

dls: directory list failed, message

dls is unable to list the directory you specified.  A secondary error message, specified by the message variable, defines the reason for the error. 

dls: directory read error " filename", message

dls is unable to read the attributes of the file specified by filename.  A secondary error message, specified by the message variable, defines the reason for the read error. 

dls: No such file(s)

You have specified a file (or files) that do(es) not exist. 

SEE ALSO

dcat(1d), dcp(1d), dlogin(1d), drm(1d)
DECnet-ULTRIX documentation