str *n_getls(SERVER *se,str regexp)
str *n_setls(SERVER *se,str regexp)
str *n_putls(SERVER *se,str *flist)
These functions allow the client software to select the lists of files that will be processed at the server. These lists all refer to files that are resident on the server, not the client.
n_getls() function performs an ls(1) on the server referenced
SERVER *se argument, and returns this list into the client's
str *. The
regexp argument may be a shell type file
"*.txt" for example. The
function provides a method of directly assigning a list of files
to be used by the server. It is very advisable for the calling
program to only use the results of calls to
obtain the file names passed to
n_setls() function sets the list of selected files on the
server referenced by the
SERVER *se argument to those described
regexp argument. For example, if you wanted to set
the file list to all the files in the
/tmp directory, then
the following call would be in order:
Once the client program assigns a list of files for the server
with a call to
the server will use that list for all subsequent processing.
The programmer should be aware of Thunderstone's intent to abstract items selected by this family of functions into items that may not be files. An example of this might be something akin to the way that Gopher performs its abstraction.