dls(1dn)
NAME
dls − list the contents of a remote directory
SYNTAX
dls [−1][−C][−a][−d][−l] filespec
where
−1 formats the listing in a single-column format, which is the default when the standard output is not a terminal. The −1 option is ignored if you use it with the −l option.
−C formats the listing in a multicolumn format, which is the default when the standard output is a terminal. The −C option is ignored if you use it with the −l option.
−a lists all files in a remote ULTRIX directory, including the names that begin with a period (.). If you omit the −a option, file names that begin with a period are not listed.
−d prints debugging information in the form of DAP message traces to stderr.
−l produces a list in long format. For each file specification, the −l option lists the file name, the protection levels, the creation date, and the size in bytes.
filespec is a file specification for a remote directory or file. The format for a file specification varies with each operating system.
You can specify wildcard characters. If you want the target node instead of the local shell to interpret a string of wildcard characters, you must enclose the string in quotation marks.
See the DECnet-ULTRIX User’s and Programmer’s Guide for more information about file specifications and wildcard characters.
DESCRIPTION
The dls command lists all the file names in the specified remote directory or lists individual files. If you do not specify a directory or file, dls uses the directory name indicated by the access control information.
All the file names in the directory are listed, unless you specify individual files. For each file name, dls repeats the name and any other information you request, for example, protection settings or creation dates.
Output from dls −l has designated characters that represent the protection setting. Displays from ULTRIX-32 systems have 10 such characters and dls −l displays from non-ULTRIX DECnet systems have 12 of these characters, for example,
DECnet-ULTRIX NodeDECnet-VAX Node
-rwxrw-r-----rwxrwxrwx
For ULTRIX systems, the first character means the following:
d indicates a directory.
b indicates a block-type special file.
c indicates a character-type special file.
s indicates a socket.
− indicates a regular file.
The next nine characters represent three protection levels 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):
r indicates read permission.
w indicates write permission.
x indicates execute permission.
− indicates no permission has been set.
The group-execute permission character is s if a file has the set-group-id bit set. Likewise, the user-execute permission character is s if a file has the set-user-id bit set.
The last character of an ULTRIX protection setting (normally x or −) is t if the sticky bit of the file mode is on. See the description of chmod in the ULTRIX-32 Programmer’s Manual for the meaning of this mode. Some non-ULTRIX systems use different mapping schemes for file protection. These systems map their file protection schemes into the syntax used by dls. An MS-DOS system, for example, does not use the concept of ownership by owner, group, other.
EXAMPLES
In the following example, the user specifies the remote DECnet-ULTRIX node ATLANT, the remote user name "jones," and the password "mysecret." Because this information is included in the file specification, the remote node can verify access for the remote user:
% dls atlant/jones/mysecret::
Using the long format, the following command lists the file name TEST.DAT, its protection level, creation date, size, and owner. TEST.DAT is located on the remote DECnet-RSX node NAVAHO; note that the standard ULTRIX-32 use of >filename redirects the information to the file info.tes on the local node:
% dls -l navaho::’[312,42]test.dat’ > info.tes