home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Jason Aller Floppy Collection
/
176.img
/
SLBBS76M.ZIP
/
SLDIR.ZIP
/
SLDIR.DOC
Wrap
Text File
|
1989-04-11
|
5KB
|
110 lines
SLDIR Sept 1988
Searchlight BBS File Directory Lister by F. LaRosa
-----------------------------------------------------------------
(c) Copyright 1988 Searchlight Software.
This program may be used free of charge by registered
SEARCHLIGHT BBS owners only.
-----------------------------------------------------------------
Description
This program reads one or more Searchlight BBS file directories (as
defined in a FILEDIR.DEF or FILEn.DEF file) and prints an alphabetical
list of the files to the standard output. Command line options can be
used to specifiy the DEF file to open, to limit the listing to certain
directories within the DEF file, or to search for particular files. The
result can be viewed on the screen, redirected to a text file or the
printer, or piped into another process.
Syntax
The syntax for running SLDIR is as follows:
SLDIR [dirfile] [access] [=string] [/abc...] [-abc...]
All parameters are optional. If no parameters are given, the file
FILEDIR.DEF is opened, and all directories contained within it are
displayed.
If [dirfile] is given, it specifies the path and filename to the DEF
file containing the Searchlight directory definitions (NOT the "DIR"
file). Don't include the ".DEF" extension, but do include the filename.
If [access] is included, it should be a number from 0 to 255 specifying
that only directories with an access level less than or equal to the
specified number will be printed. For example, the command
> SLDIR 100
will omit any directories with access levels of 101 or greater from the
final list.
The [=string] option, if included, specifies a search string. Only files
which contain the search string in their filename or description are
printed. The search is case-insensitive. Example: use the following
command to list all files on your system with the word "Searchlight" in
their description:
> SLDIR =SEARCHLIGHT
The [/abc...] option, where "abc..." is an arbitrary list of directory
letters from A to Z, indicates that ONLY the specified directories will
be used in the listing. For example, to get a quick look at your letter
"C" directory from the command line, you might type
> SLDIR /C
If [-abc...] is given, then the program will display all directories
EXCEPT the specified ones in the listing. For example, you want to list
your files, but omit the "D" and "F" directories from the list; type
> SLDIR -DF
If an access level parameter is used together with a "/" or "-"
parameter, the options will work together; only those directories which
meet the criteria of both parameters will be displayed. "/" and "-" type
parameters should not be used together on the same command line.
Useage
The primary use for SLDIR will be to generate text files containing
the directory listings of a system. Since SLDIR writes to standard
output, you can use the ">" redirection symbol to send your file list to
a file; for example, SLDIR 10 >ALLFILES.TXT. Using a batch file, you can
automate the process of generating a list, ARChiving it if desired, and
moving it to an upload/download directory for access by users. Put the
whole process onto your system as a nightly event, and your directory
file will be updated daily, automatically.
SLDIR checks for a file called SLDIR.TXT in the default directory when
it runs. If SLDIR.TXT exists, the program reads it and echos the text to
standard output before the file listing. Thus, you can place a "header"
on your file list by placing your header text in a file called SLDIR.TXT
and making sure that file is in the current directory when you run SLDIR.
There should be many other uses for SLDIR: besides giving fast,
convenient lists and searches of your BBS file directories from the
command line, SLDIR's output can be piped to or read by other programs
which need to read your directory list, without having to open and read
the binary ".DIR" files on your disk.
Copyright
This program is (c) Copyright 1988 Searchlight Software. You may use
this program for free if you are a registered owner of any version of
Searchlight BBS. You may distribute this program in unmodified form.
F. LaRosa 9/19/1988
------------------------------------------------------------------------