Digital

NAME

dls − List the contents of a remote directory

SYNOPSIS

dls  [-1][-C][-a][-l] filespec

FLAGS

-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 Digital UNIX 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. 

-l Produces a list in long format.  For each file specification, the -l option lists the file name, the protection settings, the creation date (or last modified date, for Digital UNIX systems), 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-Plus for Digital UNIX Introductory User’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 Digital UNIX systems have 10 such characters and dls -l displays from other DECnet-Plus systems have 12 of these characters, for example, DECnet-Plus for Digital UNIX Node         DECnet-Plus for OpenVMS Node
-rwxrw-r-----rwxrwxrwx

For Digital UNIX 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 the protection levels for the file’s owner, group, and other (world), in that order, consisting of three characters each.  Within each level, the three modes 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 Digital UNIX protection setting (normally x or ) is t if the sticky bit of the file mode is on.  See the description of chmod in the Digital UNIX Programmer’s Manual for the meaning of this mode.  Some other 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 have the concept of protections. 

EXAMPLES

In the following example, the user specifies the remote DECnet-Plus for Digital UNIX node local:.atlanta, the remote user name jones, and the password mysecret.  Because this information is included in the file specification, the remote node can verify access: dls local:.atlant/jones/mysecret:: Using the long format, the following command lists the file name TEST.DAT, its protection level, creation date (or last modified date, for Digital UNIX systems), size, and owner.  TEST.DAT is located on the remote DECnet-RSX node LOCAL:.NAVAHO; the standard Digital UNIX use of >filename redirects the information to the file info.tes on the local node: dls -l navaho::’[312,42]test.dat’ > info.tes

RELATED INFORMATION

DECnet-Plus for Digital UNIX Introductory User’s Guide