home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Beijing Paradise BBS Backup
/
PARADISE.ISO
/
software
/
BBSDOORW
/
LLST200D.ZIP
/
LLIST.DOC
< prev
next >
Wrap
Text File
|
1996-04-15
|
47KB
|
1,850 lines
██ ██ ████ ████ ██████
██ ██ ██ ██ ██ ██
██ ██ ██ ███ ██
██ ██████ ██ ██ ███ ██
██ ██ ██ ███ ██
██ ██ ██ ██ ██ ██
██████ ██████ ████ ████ ██
──────────────────────────────────────────────────────────────────────
Table of Contents
──────────────────────────────────────────────────────────────────────
1.0 Legal stuff . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
2.0 Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
3.0 Thanks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
4.0 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
5.0 Setting up . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
5.1 Supported BBS . . . . . . . . . . . . . . . . . . . . . . . . . 8
5.2 Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
5.3 Configure . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
6.0 LLIST.CFG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
7.0 Selecting global parameters . . . . . . . . . . . . . . . . . . . . 10
8.0 FileList, CdList . . . . . . . . . . . . . . . . . . . . . . . . . 11
9.0 FileIdx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
10.0 FixFBbs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
11.0 Announce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
12.0 Files.Bbs editor . . . . . . . . . . . . . . . . . . . . . . . . . 15
12.1 Help [F1] . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
12.2 Delete line <Ctrl-Y> . . . . . . . . . . . . . . . . . . . . . 15
12.3 Save Files.Bbs [F2] . . . . . . . . . . . . . . . . . . . . . . 15
12.4 Look at Files.Bbs [F5] . . . . . . . . . . . . . . . . . . . . 15
12.5 Dos/OS2 Shell [F9] . . . . . . . . . . . . . . . . . . . . . . 15
12.6 Hurl <Alt-M> . . . . . . . . . . . . . . . . . . . . . . . . . 15
12.7 View Content <Alt-V> . . . . . . . . . . . . . . . . . . . . . 15
12.8 Import Desc <Alt-I> . . . . . . . . . . . . . . . . . . . . . . 15
12.9 Rewrap description <Alt-P> . . . . . . . . . . . . . . . . . . 15
12.10 Tag/Untag current file <Alt-T> . . . . . . . . . . . . . . . . 16
12.11 Update current file <Alt-E> . . . . . . . . . . . . . . . . . 16
12.12 Tag dupes files <Alt-G> . . . . . . . . . . . . . . . . . . . 16
12.13 Tag missing files <Alt-0> . . . . . . . . . . . . . . . . . . 16
12.14 Untag all files <Alt-U> . . . . . . . . . . . . . . . . . . . 16
12.15 Move tagged lines [F4] [F3] . . . . . . . . . . . . . . . . . 16
12.16 Copy <Alt-C> . . . . . . . . . . . . . . . . . . . . . . . . . 16
12.17 Tag new files <Alt-N> . . . . . . . . . . . . . . . . . . . . 16
12.18 Repack (change archiver) <Alt-R> . . . . . . . . . . . . . . . 16
12.19 Adopt orphan file <Alt-O> . . . . . . . . . . . . . . . . . . 16
12.20 Find keyword <Alt-W> . . . . . . . . . . . . . . . . . . . . . 16
12.21 Hatch <Alt-H> . . . . . . . . . . . . . . . . . . . . . . . . 16
12.22 Get Desc from LList.Db <Alt-B> . . . . . . . . . . . . . . . . 16
12.23 Check File <Alt-Z> . . . . . . . . . . . . . . . . . . . . . . 17
12.24 Execute shell <n> <Alt-F<n>> . . . . . . . . . . . . . . . . . 17
12.25 Macro <n> <Ctrl-F<n>> . . . . . . . . . . . . . . . . . . . . 17
12.26 Insert AVATAR color <Shift-F1> . . . . . . . . . . . . . . . . 17
12.27 Insert ASCII char <Shift-F2> . . . . . . . . . . . . . . . . . 17
12.28 Announce current file <Alt-A> . . . . . . . . . . . . . . . . 17
12.29 Delete file and description <Alt-D> . . . . . . . . . . . . . 17
12.30 Mark to be announced . . . . . . . . . . . . . . . . . . . . . 17
13.0 Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
13.1 Scan Msg base . . . . . . . . . . . . . . . . . . . . . . . . . 18
13.2 FSearch syntax . . . . . . . . . . . . . . . . . . . . . . . . 18
13.3 Path strings . . . . . . . . . . . . . . . . . . . . . . . . . 18
13.4 Keyword strings . . . . . . . . . . . . . . . . . . . . . . . . 18
13.5 Boolean operators . . . . . . . . . . . . . . . . . . . . . . . 19
14.0 Tic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
14.1 TicNode format . . . . . . . . . . . . . . . . . . . . . . . . 20
14.2 TicGroup format . . . . . . . . . . . . . . . . . . . . . . . . 21
14.3 Lines "Local LLIST" . . . . . . . . . . . . . . . . . . . . . . 22
15.0 Raid Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
16.0 Appendices . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
16.1 Multitasker . . . . . . . . . . . . . . . . . . . . . . . . . . 25
16.2 Bugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
16.3 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
17.0 Keeping in touch . . . . . . . . . . . . . . . . . . . . . . . . . 27
──────────────────────────────────────────────────────────────────────
1.0 - Legal stuff
──────────────────────────────────────────────────────────────────────
L-List is not a free software !!! L-List is ShareWare: you can try
it, and if you decide to use it after a short period of evaluation
(about 1 month), you must register. L-List required many hours of
work: if you like it and would like to support me in developing
this and other similar products, please register. See Register.Frm
for more details.
No warranty of any kind is given with this program.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 1
──────────────────────────────────────────────────────────────────────
2.0 - Registration
──────────────────────────────────────────────────────────────────────
For registration:
* United Kingdom *
The Snow Cave, 2:443/888@fidonet
0044,1662,247887
V32B,V42B,VFC,U,TXH
Send a Cheque or Postal Order (or cash) for UK £10 to:
Steve Stacher
1 Tattysallagh Road
Omagh, Co. Tyrone BT78 5BW
Northern Ireland
The Snow Cave can accept Visa and Access/Mastercard payments. Please
fill out the appropriate part of the registration form below.
* Deutschland
Delta-OS #1, 2:2476/62@fidonet 81:449/7300@os2net
0049,7444,51312
V.34
Delta-OS #2, 2:2476/63@fidonet 81:449/7301@os2net
0049,7444,91046
V.34
Delta-OS #3, 2:2476/64@fidonet 81:449/7302@os2net
0049,7444,91047
ISDN
Send a Cheque or Postal Order (or cash) for DM 25.- to:
Gert Massheimer
Gerbergasse 61
72275 Alpirsbach
No Credit Card facility available
* Australia
Register Online
Credit Card facility available
Fred's Corner BBS 3:634/382@fidonet
+61-3-9569-4130
V32B
Send a Cheque or Postal Order (or cash) for AUS $25 to:
AUSITERM
C/O Fred's Corner BBS
8-45 Blackwood St
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 2
Carnegie, VIC, 3163
Australia
* Italy / Other countries *
NightMare #1, 2:332/901@fidonet
0039,721,21317
VFC
NightMare #2, 2:332/902@fidonet
0039,721,401271
V34+,U,TWI
Send a Postal Order (or cash) for 25.000 Italian Lire to:
Alessandro Trebbi
via Cecchi, 52
61100 Pesaro
Italy
(looking for support nodes/registration sites in other countries,
please contact Alessandro Trebbi if you are interested)
==================================================================
The registration key will be sent via mail or netmail crash
(select the way you prefer).
You must fill following registration form, indicating your name
(that is, SysopName for L-List), that will be used to generate
your personal key, and then deliver it to the address of your
preferred registration site together with money).
==================================================================
■ L-List, Registration form ■
Name: ....................................
Address: ....................................
....................................
....................................
Type of Bbs: Lora Max Other
[ ] [ ] [ ]
Release: Dos OS/2
[ ] [ ]
I'm using L-List version ....... as:
[ ] File list compiler
[ ] File finder
[ ] New files announcer
[ ] Files.Bbs editor
[ ] TIC processor
L-List ......... (*)
(* no forwarding expenses *)
---------
Total .........
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 3
Key forwarding method: ( ) Netmail to ......... (**)
( ) Paper mail
------------------------------------------------------------------
* Following part is for credit card payments only, take care to
* select the right fee above (10.5 UK £, no other currency accepted)
------------------------------------------------------------------
Card used: [ ] Visa [ ] Access/Mastercard
Card Number: _____ _____ _____ _____ Exp: __/__
Name as on Credit Card:__________________________________
Billing Address:______________________________________
______________________________________
______________________________________
==================================================================
(*) the registration fee is 25,000 ITL, which correspond to:
10 UK £ (10.5 UK £ for credit card payments), 15 US $, 25.- DM, 25 AUS $
(**) The netmail forwarding method needs a valid Fidonet
nodenumber and an answering system capable of handling Fido-
Technology Mail sessions.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 4
──────────────────────────────────────────────────────────────────────
3.0 - Thanks
──────────────────────────────────────────────────────────────────────
Thanks to:
* Mark May, for his MkMsg libraries;
* Matthew Mastracci, for his Manual compiler (used to write this manual);
* Gert Massheimer, for the translation of the manual into german language;
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 5
──────────────────────────────────────────────────────────────────────
4.0 - Introduction
──────────────────────────────────────────────────────────────────────
L-List is a powerful file base utility, that can make most of the
common jobs related to file base maintenance: supports several kinds
of Bbs (especially written to be run with Lora or Maximus) and several
kinds of message base (Fido, Squish, Hudson, Jam); a brief overview
to main features include:
Process TIC files:
* Easy to configure, reads and uses a standard Tic.Cfg file;
* Supports file area grouping;
* Can compress all *.Tic in a compressed *.?ic file;
* Check dupes files;
* Can send monthly report;
* Can send announce with routed files;
* Can strip Seen-by lines;
* Can disable sending *.Tic;
* Can recompress received files;
* Powerful internal Raid processor, include %RESCAN and
%RESEND commands, group management, forward to uplink;
all options can be activated through Raid, with commands
%PACKER %NOTIFY %TINYSEENBY %SENDTIC %ANNOUNCE;
* Support for "Magic" lines;
Announce Msg:
* Totally independent from file date, only checks in its own
index;
* Fully configurable, can cross-post the same msg in several
areas and send netmail carbon copies;
Files.Bbs editor:
* Tag/Untag files, includes commands to tag all missing and dupes;
* Many available commands, full support for most common
compressors (included internal viewer for ARC PAK ZIP LZH ARJ
and RAR), and configurable for other kinds of compressors;
* Internal text file viewer available;
* Search command compatible with remote FSearch (look after),
will look in the whole file base if files are not found in
current area; found files are automatically tagged;
* Commands to hatch and announce files directly from editor;
* Import orphan files reading included description files to get
description;
* Can repack files from one format to another;
* Can move / copy files from one area to another;
* Very fast and fully configurable file list compilation, including
some header info with available magic names, most downloaded files
and a list of available file areas, all written at runtime;
* Full support for multi-line descriptions and Avatar color codes;
FSearch:
* Fully compatible with FSearch and AllFix syntax, including
boolean operators;
* Supports wildcards and brackets both in file names and in
descriptions, in 4Dos style;
* Can let you configure the Msg area where to answer, including
NetMail;
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 6
The first time you run L-List, you will subscribe the terms for
evaluation period (up to 30 days); at the end of this period, you
can choice between registering the software or deleting it, if you
think that it is not useful; however, you can distribute the
original archive, if you do not modify it and if no additional
cost is required (except distribution expenses). You can insert
this archive (with no modification) in any shareware collection
(Cd-Rom, for example), but please let me know about it.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 7
──────────────────────────────────────────────────────────────────────
5.0 - Setting up
──────────────────────────────────────────────────────────────────────
5.1 Supported BBS
L-List reads directly info from several configuration files; it
can use Lora's SysFile.Dat (2.35), SuperBbs' FlSearch.Bbs (1.16),
Maximus' Area.Dat (2.00), Maximus 3.x's FArea.Dat, Remote Access
2.50's Files.Ra.
L-List can run even with only a Tic.Cfg, with no need for Bbs
configuration files.
5.2 Install
Make a directory, named LLIST, and unpack there all files in the
distribution package; L-List must be able to locate your file-area
configuration files (if you use it with a Bbs); this can be easily
made setting dos environment variable (LORA, MAX or RA), or setting it
in keyword BbsDir of LList.Cfg.
Now L-List is ready to run, enjoy it!
The first time you run L-List an index of all files will be created,
used to detect new files in Announce option; each time you change
anything in your bbs' file area setup this index will be fully rewritten,
a partial update is made each time you modifies an area, or new
files are detected.
5.3 Configure
L-List can read info directly from you bbs configuration files,
using default options; if you want to personalize setup, you will
have to create a LLIST.CFG (an example of it can be found in the
distribution package); TIC setup is done through a standard Tic.Cfg
and Raid.Cfg (correspond to FileBone.*, regularly distributed in
TIC area FILEBONE), while info about Tic Nodes and Tic Groups will be stored
in LLTIC.CFG (a default one is created automatically by L-List).
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 8
──────────────────────────────────────────────────────────────────────
6.0 - LLIST.CFG
──────────────────────────────────────────────────────────────────────
Please refer to example cfg, widely commented.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 9
──────────────────────────────────────────────────────────────────────
7.0 - Selecting global parameters
──────────────────────────────────────────────────────────────────────
-Q : runs L-List in quiet mode, limiting echo of log file to screen;
-B : uses bios for all screen writes;
-M : uses monochrome color set;
Other option are specific of each option, and you will have to
specify them only after having selected one of main options.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 10
──────────────────────────────────────────────────────────────────────
8.0 - FileList, CdList
──────────────────────────────────────────────────────────────────────
This option will create file lists defined in LList.Cfg (look at
example cfg for more details). Multiple file lists can be created
at a time.
Each file list can contain a complete file list, a new file list, an
OkFile list, a list of Most Downloaded Files (L-List will create
the lists that you have defined, only AllFiles is necessary, the
others are optional). CdList will generate lists flagged with keyword
"CD", that are not compiled with FileList command; the only difference
between the lists is the OkFile list that is not imported in the
main lists in CdList.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 11
──────────────────────────────────────────────────────────────────────
9.0 - FileIdx
──────────────────────────────────────────────────────────────────────
With this option L-List will update/create an index file which is
used by Lora for file requests (with performances better than
using OkFile). FileIdx is automatically updated after Announce,
EditFBbs and FixFBbs option, rewriting info about modified areas;
note that previous existing index file to be updated must be
sorted, otherwise it will be truncated (Lora's utility FileIdx.Exe
creates an unsorted index file that can't be updated by L-List).
L-List uses this index in order to determinate if a file has to be
announced. If no index file is found or if its date is lower than the
date of the bbs file area configuration files, L-List will rebuild the
index file.
If you want Lora to use index file for request, you will have to
activate the flag "NoDlPath" and add a line such as:
OkLine $C:\LORA\FILES.IDX
(if your index file is named C:\LORA\FILES.IDX)
Then, tell LLIST to create an index file for request (with a line
"OkFile C:\LORA\OKFILE.LST" in the definition of a file list);
this file will contain
the list of magic names (defined in Magic.Cfg) and then the line
"$C:\LORA\FILES.IDX" that will let Lora use the index file instead of
the download paths (that will not be listed in this file, due to
the flag "NoDlPath" specified).
In Lsetup, tell Lora to use the file "C:\LORA\OKFILE.LST" to allow
requests.
If you want to disable f/r from some areas, use appropriate flags
in lsetup file area cfg (the f/r will not be allowed even if the file
is listed in "C:\LORA\Files.Idx").
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 12
──────────────────────────────────────────────────────────────────────
10.0 - FixFBbs
──────────────────────────────────────────────────────────────────────
This option will rewrite Files.Bbs, importing orphans and
deleting offlines. Dupes will be removed. New Files.Bbs will be
sorted according to the cfg option FixNewFBbs (default, no sort).
You can use this option to repack files and to check them for
integrity and presence of virus, with additional options ,REPACK
and ,CHECK that must follow keyword fixfbbs (with no blank between
them). This option should be run the first time you use L-List, in
order to save Files.Bbs in the same format L-List will show them
in Files.Bbs editor, and each time you make global changes of
download counter limits in your configuration.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 13
──────────────────────────────────────────────────────────────────────
11.0 - Announce
──────────────────────────────────────────────────────────────────────
This option will write Msg with announce of new files. Detection
of new files is not based on date; L-List checks in its index files
(LFiles.Idx and Announce.Idx) and will announce files that are not
found in LFiles.Idx or that are found in Announce.Idx; Announce.Idx
is automatically updated when TIC are processed and when orphan files
are imported, and is deleted after having announced files.
L-List will never search new files in Cd-Rom areas and will not announce
files that match any of ANNOUNCEEXCLUDE keywords. You must define
AnnounceMsg in LList.Cfg, look at example cfg for more details.
This option will be automatically run after any .Tic file has been
correctly processed.
At last, L-List will take care to update index file of areas where
new files have been found.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 14
──────────────────────────────────────────────────────────────────────
12.0 - Files.Bbs editor
──────────────────────────────────────────────────────────────────────
This option is used to edit directly Files.Bbs.
12.1 Help [F1]
Help about available commands. You can select an option directly in this
screen, using mouse or cursor keys. This menu' can be invoked pressing
button mouse in the first row of the screen.
12.2 Delete line <Ctrl-Y>
Delete current line; only the description is deleted, if it is
the unique line of a file description, the file can be re-imported
as orphan.
12.3 Save Files.Bbs [F2]
Save Files.Bbs if any change has been made.
12.4 Look at Files.Bbs [F5]
Look at Files.Bbs; the file will be shown in the way it will be
written in file lists.
12.5 Dos/OS2 Shell [F9]
Shell to SO.
12.6 Hurl <Alt-M>
Tagged files (or current file if none is tagged) will be moved in
the selected area.
12.7 View Content <Alt-V>
View content of compressed files; L-List will show the content of the
compressed file, you can scroll up and down and recursively view any
file contained in the archive using again the command <Alt-V>; other
available commands are <Alt-F<n>> to execute an external shell and
<Alt-R> to run an executable file. This viewer supports ARC, PAK, ZIP,
LZH, ARJ and RAR, self-extracting too; if the file is not in one of these
formats, L-List will run a Text file viewer to look at the current file.
This command is automatically executed with a mouse double click.
12.8 Import Desc <Alt-I>
Import File_Id.Diz or Desc.Sdi in Files.Bbs description. These
lines will replace the old description (only the first line and
the uploader line will be preserved).
12.9 Rewrap description <Alt-P>
Rewrap description from the second line, stripping frame chars.
12.10 Tag/Untag current file <Alt-T>
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 15
Tag/Untag current file.
12.11 Update current file <Alt-E>
Update current file. This is useful to let L-List announce it.
12.12 Tag dupes files <Alt-G>
Tag dupes files.
12.13 Tag missing files <Alt-0>
Tag missing files.
12.14 Untag all files <Alt-U>
Untag all files.
12.15 Move tagged lines [F4] [F3]
F4 Moves tagged lines before current line in the order in which
they were tagged; F3 dort them in alfabetical order.
12.16 Copy <Alt-C>
Copy tagged files (or current file if none is tagged) in the
selected area.
12.17 Tag new files <Alt-N>
Tag new files. L-List will prompt for the max age of new files.
12.18 Repack (change archiver) <Alt-R>
Repack current file to the selected archive type; if the file is
not compressed, or its format is unknown, l_list will repack file
as it is. You will be prompted to choice between repacked file and
old one.
12.19 Adopt orphan file <Alt-O>
Adopt orphan files; L-List will try to read packed description
(File_Id.Diz or Desc.Sdi), rewrapping it; if this fail, keyword
OrphanStr will be used as description.
12.20 Find keyword <Alt-W>
Find keyword. String format is the same supported by search
strings, wildcards and boolean operators supported.
12.21 Hatch <Alt-H>
Hatch current file in the seleected tic area. L-List will prompt
for the tag of the tic area, and for some additional info: file to
replace and magic name.
12.22 Get Desc from LList.Db <Alt-B>
Get desc from LList.Db.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 16
12.23 Check File <Alt-Z>
Check file for integrity and presence of virus. The file will be
assumed corrupted if L-List will fail to uncompress it, and will
be assumed infected if your ScanVirus will report an errorlevel
different from 0.
12.24 Execute shell <n> <Alt-F<n>>
Execute shell <n>. These shells are defined in LList.Cfg.
12.25 Macro <n> <Ctrl-F<n>>
Macro <n> will be added at cursor position. Macros are defined
in LList.Cfg.
12.26 Insert AVATAR color <Shift-F1>
The avatar code for the selected colo will be added at cursor position.
12.27 Insert ASCII char <Shift-F2>
The selected char will be added at cursor position.
12.28 Announce current file <Alt-A>
Current file will be announced in specified area; L-List will
prompt for the AreaId of the area where file must be announced
(AreaId format is described in LList.Cfg).
12.29 Delete file and description <Alt-D>
The current file is deleted and its description removed.
12.30 Mark to be announced
The current file is added to Announce.Idx, so that it will be announced
the next time you select Announce option.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 17
──────────────────────────────────────────────────────────────────────
13.0 - Search
──────────────────────────────────────────────────────────────────────
13.1 Scan Msg base
Using this option, L-List will scan msg areas specified in config
file looking for Msg to "AllFix", "LList" and to "FSearch"; you
can specify keywords in Msg Subject, separated by spaces (enclose
in double quotes if keyword contains spaces), or in Msg Text, in
lines starting with DIR or KEYWORD; L-List has a powerful wildcard
management, using "?" and "*" you can easily search every file;
if a "?" is too generic, you can specify range of chars that will
match including them in square barckets; for example, "[0-9]"
meand any number, "[0-9A-Z]" letter or number, "[AEIOU]" a wowel;
if a range start with a "!", than the rest of the range is assumed
as negative (that is, "[!a]" means all chars different from "a").
Note that, differently from 4Dos(tm), L-List requires at least a
char to match a "?" (usually, if this is at the end of a name, can
be matched by no char; for example, 123??.* will match 123.*,
1234.*, 12345.*, but not 123456.*; L-List will match 12345.* only,
like you can obtain in 4Dos(tm) using "[?]"; this last is treated
differently by L-List, meaning just a "?" and not any char).
When a valid Msg is found, L-List will process the information
request searching in areas specified in Search definition (look at
Example.Cfg for details), and will answer if it finds files which
match the information request. The search will be made only in
the first description line, if this match the request the file
will be displayed with all its description lines.
13.2 FSearch syntax
You must specify strings to search for in the msg subject; L-List
will answer to your Msg if any matching file is found (or even if
no file was found, but it was a private Msg); if many files are
found, L-List will stop search when it has found more than
SEARCHMAXFILES files, adding at the end of the answer Msg info on
how to obtain more info (that can be done sending a Msg with same
subject but now addressed to LLIST <Node>, that is simply
answering to L-List response message).
13.3 Path strings
Path strings are only searched in file name, in Dos style; you you
can also use the "*" to match filenames with specific letters
somewhere inside the name, for example *113*.*; you can use
wildcards in any combiantion you desire, for example LL*ST*.*; a
path is specified as it is in a Msg Subject; if a wildcard is too
generic, you can specify range of chars (brackets) instead of a
"?".
13.4 Keyword strings
Keyword strings are searched in file description, conceptually a
<keyword> is always searched as if it were *<keyword>*, and it can
contain wildcards like a path ("?" and "*"); it can be specified
in Msg subject (or in command line) preceeded by a "/" or between
""", that is you must write either /4DOS or "4DOS" if you want to
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 18
search 4DOS in file name and in file descriptions. Other robots
often do not support wildcards in keyword strings, if you are
writing a Msg that will be processed by other filefinder, add
another keyword in subject of Msg obtained stripping "*" and
substituting "?" with blanks; this keyword string will not affect
L-List performances, as L-List searchs only most generic strings
(does not search for strings that will be automatically matched if
a more generic string is matched).
13.5 Boolean operators
Normally, different strings specified in the same subject are
searched assuming a OR conncetion; if you want to search files
that match two or more strings, you must write AND between each
other. A not operator is supported too; if the first char of a
string or of a path is a "~" (#126), only files that do not match
the string will be found.
This syntax for search strings is used in command <Alt-W> (Search)
in Files.Bbs editor.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 19
──────────────────────────────────────────────────────────────────────
14.0 - Tic
──────────────────────────────────────────────────────────────────────
With this option, L-List will manage tic files; tic areas, nodes
and groups must be defined in LLTic.Cfg.
When you run TIC option, L-List first will scan NetAreaId
searching Msg to Raid, then will process Tic files in inbound dir,
and at last will make announces if any Tic has been correctly
processed.
The first time it will be enough to edit a Tic.Cfg file like
following (LLTic.Cfg will be automatically created, and will need
some minor changes later): L-List will use additional info about
ti areas that will be stored in lines starting witg "Local LLIST"
that immediately follow the line AREA.
=============================================
AREA D:\file\ECHOLIST ECHOLIST
Local LLIST Address 2:332/901
Local LLIST Level 100
1:150/503 Passwrd1 *C
1:150/3 Passwrd2 H
==============================================
The LLTic.Cfg, automatically created and maintained by L-List,
contains additional info about Nodes and Groups.
This info will be stored in separate sections of LLTic.Cfg:
TicNode, TicGroup and TicArea.
14.1 TicNode format
A TicNode starts with a line containing reserved word TicNode
followed by the node number, and will continue until the keyword
End is found; only the line PW <password> is necessary, but you
can add optional lines used to set several flags (that the node
will be usually able to change by himself using internal Raid
processor); these are:
TicNode <node>
Pw <Password>
[optional field]
[...]
End
Where optional field can be:
Level <n>
This flag specifies node access level, used to link areas and
groups using internal raid processor; only RemoteMaint nodes (see
later) can modify this value, using command %LEVEL <n>;
Hold | Crash
Select the flavour to send files; by default, files will be sent
using a *.flo; marking the node with Hold, a *.Hlo will be used;
marking the node with Crash, a *.Clo will be used;
Notify
If this flag is active, the node will receive a monthly report
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 20
about sent and received files; can be toggled using commands
%NOTIFY and %-NOTIFY;
Announce
If this flag is active, the node will receive an announce msg each
time one or more new files are received in a tic area linked to
that node; can be toggled using commands %ANNOUNCE and %-ANNOUNCE;
TinySeenBy
If this flag is active, the node will receive .Tic files with only
local SeenBy (only sender and receiver node will be reported); can
be toggled using commands %TINYSEENBY and %-TINYSEENBY;
RequireUplink
A node with this flag active can require tic areas which are not
currently carried by you node but which are currently available
from an uplink of yours; L-List will get the list of available tic
areas reading a standard Raid.Cfg (FileBone.*) and importing the
areas which belongs to a defined group which has a vaild uplink;
the requested areas will be immediately created, linking all nodes
which are AutoLinked to that group, and a netmail msg will be sent
to uplink's Raid;
Packer <Packer>
This is the packer used to send .Tic files; if no packer is
selected, .Tic files will be sent separately in an uncompressed
format. Using a valid packer, all .Tic files will be sent in a
unique compressed file, named NNNNFFFF.PIC, where NNNN is the net
number, FFFF is the node number (both in hex format), and P is the
first letter of the packer. A packer can be set using command
%PACKER <Packer> of Raid internal processor;
RemoteMaint
This flag will allow node to make remote maintenance for other
nodes (command %FROM <node> of internal Raid processor);
NoTic
Files will be sent without the corresponding .Tic;
14.2 TicGroup format
Groups are used by L-List for several purposes; new areas
creation, autolink options, Raid msg forward. A TicGroup
definition starts with a line TicGroup <TAG> and continues until a
keyword End is found.
TicGroup <tag>
[Field]
End
Where field can be:
Level <n>
This is the level used for new created areas, and to give access
to Uplink's Raid;
Address <Node>
This is the address used for new created areas, and used for Zone
matching;
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 21
Uplink <Node>
This is the node that can create new areas and to which the
request for areas that are not currently carried will be
forwarded;
GroupId <keyword>
These are the strings that will be searched at the beginning of a
Tic area tag to determine if it belongs to this group; more than
one can be specified;
Node <Node>
These are the nodes that will be automatically linked to new
created areas of this group; a node can subscribe and unsubscribe
a Tic group using command %AUTOLINK <group> and %-AUTOLINK <group>
of internal Raid processor;x
14.3 Lines "Local LLIST"
You can add lines starting with "Local LLIST" after each line AREA
in Tic.Cfg; these lines will be used to store additional info about
tic areas required by L-List.
After the keyword "Local LLIST" you can add following items:
Level <n>
Access level of the current area, used to allow link through Raid;
Address <Node>
Address used to process .Tic, and used for Zone matching in Raid
requests;
Packer <Packer>
New compressed format for distributed files (L-list will try to
recompress received files);
Flag <flags>
Attribute with which areas will be linked; if no flag is
specified, area can be linked as receive only; flag can be "*" to
allow bidiretional links and "&*" for send only areas (that is,
areas used for hatch);
Group <Tag>
Group which area belongs to; you must use a group starting with a
"!" if you want to indicate that the area belongs to no group
(this fiels can't be left empty, L-List will always try to guess
the Group);
Bytes <n>
Estimation of monthly traffic of the area; used to automatically
delete area when the traffic will be null for several months; this
number is monthly updated considering the traffic of the current
month and previous value, and is reported in area lists sent by
Raid processor;
ReadFile_id
This flag will make L-List use the description contained in
File_Id.Diz to add info in Files.bbs (does not affect lines DESC and
LDESC in exported *.Tic);
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 22
──────────────────────────────────────────────────────────────────────
15.0 - Raid Help
──────────────────────────────────────────────────────────────────────
The Raid function allows remote nodes to link and/or unlink file
areas of the system by means of netmail messages.
A typical message to Raid is as follows:
From: Alessandro Trebbi (2:332/901.1)
To: Raid (2:332/901)
Subj: PASSWORD
====================================
-HUB900
[12]-*
%RESCAN
%DAYS 7
NODELIST
%LIST
-+-
The calling node must be authorised to use Raid on this system.
The receiver must be Raid (case insensitive) with this system
address. In the 'subject' field Your password must be inserted.
The message text contains commands that Raid will execute
following the order. In the previous example, the HUB900 file area
will be unlinked, all areas whose tag starts with "1-" or "2-"
will be linked, the NODELIST file area will be linked too and new
files in this area will be resent; a list of available areas will
be sent.
Raid will answer the sender with one or more messages for
operation confirmation.
L-List's Raid function interprets the following commands (commands
marked with (*) are available only to RemoteMaint nodes):
[+]AREATAG - Link AREATAG (+ is optional). You can specify
wildcards and brackets in the tag, all the
areas that match will be linked.
-AREATAG - Unlink AREATAG.
%-ALL - Unlink every area.
%[+]ALL - Link every area (+ is optional).
%LIST - Send a list of the available areas.
%QUERY - Send a list of the already linked areas.
%UNLINKED - Send a list of the available and not yet linked
areas.
%RESEND <nomefile> - Resend a file with the corresponding .Tic.
%RESCAN - Resend every file whose age is smaller
than specified %DAYS contained in the TIC
areas specified on the following lines.
%DAYS - Specifies max days for command %RESCAN.
%PWD <pwd> - Allows the change of the password to be used with
Raid and TIC processor.
%FROM <node> - (*) Allows the user to make changes for another node.
The following lines are traded as if originating
from the node <node>. To use this command the
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 23
node must have flag RemoteMaint.
%ECHO - (*) Global info about all links.
%LEVEL% <n> - (*) Set TIC level to value <n>
%INFO - Your node settings.
%PACKER <Packer> - Select a packer to compress .Tic files; if you
do not specify <Packer>, a list of available
Packers will be sent;
%AUTOLINK [-]GROUPTAG - Add/Remove a Group; new created areas that
belong to one of the selected groups will be
automatically linked. If you do not specify
GROUPTAG, a list of available Groups will
be sent.
%[-]NOTIFY - Select if the monthly report will be sent;
%[-]ANNOUNCE - Select if a announce with new files in linked
areas will be sent.
%[-]SENDTIC - Select if a .Tic will be sent with each file.
%[-]TINYSEENBY - Select if Seenby lines will be stripped.
%HELP - Send a help message to use Raid (this text).
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 24
──────────────────────────────────────────────────────────────────────
16.0 - Appendices
──────────────────────────────────────────────────────────────────────
16.1 Multitasker
L-List is multitasker aware, due to the method it uses to look for
files and to wait for keyboard input; you can run multiple copies
of L-List, setting in each task the environment variable LLISTLOG
to a different value (this will be the full path of L-List log
file). L-List uses flag file to allow exclusive access to file
areas and to some operations; these flags have extension .Bsy, and
are stored in L-List dir (remember to delete these files if L-List
hangs).
16.2 Bugs
Sometimes you could get a Runtime Error, that will be logged in
your log file; these are the most common:
RTE 003; You have simply miss defined a path name; check LList.Cfg
for wrong path names;
RTE 203: You need more memory, could happen with very large file
areas; run LList after having freed some memory.
If you get any other RTE, please send me info about it: number
(xxx), address (xxxx:xxxx), Files.Bbs of area where it happened,
your LList.Cfg and command line you used.
16.3 Examples
Genoerate configured file lists
===============================
LList FileList
Generate Announces
==================
LList Announce
Fix Files.Bbs in Area #1 (import orphans, deletes offlines)
===========================================================
LList FixFBbs,Repack,Check Area 1
Scan msg base for msg to LList, and answers if any is found
===========================================================
LList Search
Update fileidx
==============
LList FileIdx
Process TIC files
=================
LList TIC
Commands can be run together, specifying more than one option
in the command line.
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 25
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 26
──────────────────────────────────────────────────────────────────────
17.0 - Keeping in touch
──────────────────────────────────────────────────────────────────────
If you find a bug anywhere in the program on in the documentation,
please report it immediately to one of the addresses below. Also,
if you have any problems with the program or any suggestions, send
them my way.
I can be contacted by any of these ways:
Fidonet:
NetMail 2:332/901 2:332/902 Alessandro Trebbi
Tic distribution area LLIST (LLISTBDF or LLISTEXE for beta updates)
Echomail support area LLIST_HELP
─────────────────────────────────────────────────────────────────────────────
LLIST v2.00 - Page 27
This manual compiled using MC v1.05 by Matthew Mastracci