| |
DL1DWW > WAMPES 29.10.95 04:48l 438 Lines 16672 Bytes #-10850 (365) @ DL
BID : DB0TUD020129
Read: GUEST
Subj: Manual BBSX 1.15 1/2
Path: OE3XSR<OE3XZR<OE1XGR<OE6XHG<OE3XBS<DB0WGS<DB0PV<DB0MAK<OK0PKL<DB0DLN<
DB0TUD
Sent: 951028/1646z @DB0TUD.#SAX.DEU.EU [DB0TUD - WAMPES BBSX JO61UA OP:DG2DWL]
FROM: DL1DWW (Ronald Konschak)
TO: WAMPES@DL
BBSX Version 1.15 USERGUIDE
============================
by: Thomas Fichte
dg1rtf@db0tud.#sax.deu.eu
fichte@freia.inf.tu-dresden.de
additional remarks:
Ronald Konschak
dl1dww@db0tud.#sax.deu.eu
1. Einleitung
-------------
Das "bbsx" ist eine Weiterentwicklung des "DK5SG-BBS". Die Um-
stellung der Software von "DieBox" nach "WAMPES" bereitete vielen
Usern grosse Probleme. Das in der Wampes-Distribution enthaltene
BBS erfuellte auch nicht die Anforderungen die an DB0TUD gestellt
sind.
Ich entwickelte daraufhin das "dk5sg-bbs" weiter und baute immer
mehr neue Funktionalitaet ein (meist hat der Nutzer davon nichts
gemerkt).
Irgendwann kam dann der Zeitpunkt einer gruendlichen Ueberar-
beitung dessen, was ich immer aus der Not heraus schnell
hineingepflanzt hatte und bei dieser Gelegenheit gleich der Ein-
bau neuer Funktionalitaet. Daraus enstand das "bbsx". Also bbs-
extended.
Natuerlich lag es mir am Herzen nicht diese Nutzer zu verprellen,
die sich muehsam an das dk5sg-bbs gewoehnt hatten. Mit geringen
Ausnahmen ist die Kompatibilaet gewaehrleistet.
2. Was ist anders als im "DK5SG-BBS" ?
--------------------------------------
Das PROMPT Kommando gibt es nicht mehr, es heisst jetzt:
set prompt=... .
Dann traten Probleme auf, wenn jemand laengere Zeit nicht QRV
war. Ein "LIST NEW" foerderte ellenlange Listen zu Tage. Hier war
vielen nicht bekannt wie sich das umgehen laest. Um die sowie
verstopften Frequenzen nicht weiter zu belasten, entschloss ich
mich, die QUIT, EXIT und DISCONNECT Kommandos mit einer neuen
Funktionalitaet auszustatten. Beim Verlassen des BBS mit den
genannten Kommandos wird die Messagenummer gespeichert, welche
beim Start des BBS durch den Nutzer die hoechste war, bzw. die
bei einem "LIST NEW" hoechste angezeigte Messagenummer. Wird das
BBS mit dem BYE Kommando verlassen, wird kein Update durchge-
fuehrt.
3. Die Startup-Datei: .bbsrc
----------------------------
Beim Start des BBS wird die Datei ".bbsrc" ausgefuehrt, welche
sich im HOME-Verzeichnis des jeweiligen Users befinden kann. In
dieser Datei koennen bestimmte Einstellungen gesetzt werden, die
man bei jedem BBS-Aufruf sowieso machen wuerde. Das kann das Ver-
aendern des Prompts, das Anzeigen des Status oder die Definition
von Kommandos mit ALIAS sein. Zum Beispiel kann in der ".bbsrc"
folgendes stehen:
status
set subject
set prompt="\t (\w) \u de \h > "
alias check="list new"
Was das alles bedeutet, dazu spaeter.
Wie schreibt man nun diese Datei? Nach dem Login in die Box/Digi
befindet man sich in seinem HOME-Verzeichnis (siehe UNIX/Wampes-
Beschreibung)(*1). Das darf man natuerlich nicht verlassen, weil man
woanders kaum das Recht hat, irgenwas zu speichern. Jetzt kann
man diese Datei (.bbsrc) mit einem Texteditor erstellen. Hier
eignet sich fuer die Nutzung ueber Funk der "ed" bzw. "ex". "ed"
funktioniert wie der in der DOS-Welt bekannte "edline". Das ist
sicher nicht sehr komfortabel, aber wie will man das ueber Funk
sonst machen? Eine andere Moeglichkeit ist das Kommando "cat".
Das kann man dazu ueberreden, alles was man eingibt in ein File
zu speichern. Man schreibe:
cat > .bbsrc
status
set subject
^D
Das ^D ist wichtig! Mit SP erzeugt man es, indem man erst ^Q dann
^D eingibt, mit GP muss man die ALT-Taste druecken und auf dem
Zehnerblock die "4" eingeben, denn ^D entspricht dem ASCII-Code
4.
Vielleicht stellt aber auch der Sysop eine fertige Datei zur Ver-
fuegung, die man sich dann bloss kopieren muss. Frage ihn am
besten mal.
(*1) Anmerkung zu DB0TUD: Der Normaluser befindet sich nach dem
Login zunaechst erst einmal im Sessionmanager, muss also erst den
Menuepunkt "UNIX-Shell" waehlen. Es gibt auch einen Script namens
bbsxconfig.sh, der aus dem bbsx heraus mit "shell bbsxconfig.sh"
aufgerufen werden kann. Damit koennen die wichtigsten Optionen
interaktiv eingestellt werden.
4. Kommandoeingabe:
-------------------
Eine Kommandozeile besteht aus einem Kommandonamen und (nur fuer
manche Kommandos) aus Parametern. Kommandonamen koennen in
Klein- oder Grossbuchstaben eingegeben und auch abgekuerzt
werden. Kommandonamen und Parameter werden durch Leerzeichen
voneinander getrennt. Will man einen Parameter eingeben, der
Leerzeichen enthaelt, muss dieser in einfache oder doppelte
Anfuehrungsstriche gesetzt werden. Die maximale Laenge der
Eingabezeile ist 1000 Zeichen, maximal duerfen 250 Parameter pro
Kommando angegeben werden. Weiss man mal nicht welche Kommandos
es gibt, so hilft hier der HELP Befehl oder einfach das "?". Dann
wird eine Liste aller verfuegbaren Kommandos ausgegeben. Mit
"HELP <Kommando>" bekommt man zu einem bestimmten Befehl eine de-
tailierte Beschreibung. Mit "HELP ALL" kann man sich die Hilfe-
texte aller zur Verfuegung stehenden Befehle angucken. Dann
sollte entweder der Drucker mitlaufen oder alles in ein File
geschrieben werden. Wie man das macht steht im Handbuch des Ter-
minalprogramms.
5. Abbruch der Ausgabe:
-----------------------
Jede Ausgabe laesst sich durch Eingabe des "Interrupt" Zeichens
stoppen. Normalerweise ist dieses "Interrupt" Zeichen ASCII 127,
es kann aber mit dem Unix Kommando "stty intr" vor dem Start des
BBS geaendert werden.
Zum Abbrechen der Ausgabe der Kommandos LIST und READ kann ein
spezielles "Interrupt" Zeichen definiert werden. Die geschieht
mit dem BBS-Befehl SET. SET erwartet dann den ASCII-Code des Ze-
ichens, welches zum Abbrechen verwendet werden soll. Es gibt nat-
uerlich die beruehmte Ausnahme: <RETURN> <RETURN> besteht
eigentlich aus zwei Zeichen, naehmlich LF (Linefeed) und CR (Car-
riage Return). Deshalb muss der ASCII-Code des LF, also "10"
angegeben werden.
Zum Beispiel:
SET escape=10 Abbruch mit <RETURN>
SET escape=3 Abbruch der Ausgabe mit ^C:
6. Die einzelnen Kommandos
--------------------------
6.1. Das ALIAS Kommando
-----------------------
Mit dem ALIAS Kommando kann man sich Kommandos neu definieren und
sich so seinen persoenlichen Befehlssatz zusammenstellen. Diese
definierten Aliase sind dann wie die Standardkommandos verwend-
bar. Damit ist es moeglich haeufig und oft gebrauchte Kommandos
abzukuerzen.
ALIAS ohne Parameter zeigt eine Liste aller definierten Kommando-
Aliase.
Die Syntax ist:
ALIAS neues_kommando = "Konstruktion aus Standardkommando"
Die Aliase werden in die alphabetisch geordnete Kommandoliste
eingefuegt. Das heisst, hat man sich sich ein alias: "lese"
definiert und gibt spaeter ein: "l 3" wird nicht "LIST 3", son-
dern "LESE 3" ausgefuehrt.
Zum Beispiel:
ALIAS check="list new"
Viele Nutzer die an "DieBox" gewoehnt sind (oder waren) vermissen
den CHECK Befehl im BBS. Hat man sich ein solches ALIAS
definiert, so wird bei der Eingabe von CHECK das Kommando LIST
NEW ausgefuehrt.
ALIAS lese=read
Wem das Neudeutsche der Kommandos nicht gefaellt, kann sich sie
so sehr einfach in einer ihm genehmen Sprache verfuegbar machen.
6.2 Das BYE Kommando
--------------------
Das BYE Kommando beendet das BBS Programm. Die Nummer der letzten
irgendwann mal mittels "LIST NEW" angezeigten Nachricht bleibt
erhalten. Hat man in der laufenden Sitzung mal ein "LIST NEW"
gemacht, so bleibt dieses unberuecksichtigt. BYE hat KEINEN Ein-
fluss auf das DELETE Kommando. Geloeschte Nachrichten koennen
nur mit UNDELETE wiederhergestellt werden.
6.3 Das DELETE, ERASE, KILL Kommando
------------------------------------
Mittels DELETE, ERASE oder KILL lassen sich Nachrichten loeschen,
welche man selber in das BBS eingespielt hat. Dabei wird die
Nachricht allerdings nicht physisch geloescht, sondern bloss un-
sichtbar gemacht. Hat man sich die Messagenummer gemerkt, so
kann man mit UNDELETE oder UNERASE das Loeschen rueckgaengig
machen. Ansonsten hilft vielleicht eine kleine Bitte an den Sysop
das Entloeschen vorzunehmen. Die zu loeschende Nachricht kann auch
anhand ihrer Bulletin-ID ausgewaehlt werden. Dazu muss nach dem
Kommando erst ein "$" oder "BID" und dann die Bulletin-ID angegeben
werden. Die BID steht im Kopf der Nachricht nach dem Wort "Bulletin-
ID:". Die BID ist eine Kennummer, die die Nachricht eindeutig
identifiziert, nur einmal im ganzen Netz vorkommt und darum in jeder
beliebigen Box derselben Nachricht zugeordnet ist.
Syntax:
DELETE msg# ...
DELETE [rubrik] -msg#
ERASE [rubrik] msg# -
KILL BID bulletin-ID
DELETE $ bulletin-ID
Beispiele:
DELETE 12345 23456 34567
DELETE meinung 1-
DELETE 50-53
E 54321
KILL $ DB0TUD017542
6.4 Das DISCONNECT Kommando
---------------------------
Das DISCONNECT Kommando beendet das BBS Programm und trennt
danach die Verbindung auf. Benutzt man einen Unix Shell mit
Job Control (zB /bin/csh oder /bin/ksh), kann die
Verbindung leider nicht vom BBS getrennt werden, in diesem
Fall muss man im Shell noch "exit" eingeben.
Im Gegensatz zum BYE Kommando wird aber aber die letzte bei einem
LIST NEW angezeigte Messagenummer in der Datei .bbsseq abgespe-
ichert. Hat man kein LIST NEW durchgefuehrt, so wird die Mes-
sagenummer abgespeichert, die beim Start des BBS die hoeste war.
Damit kann man dann ewig lange Listen vermeiden, wenn man lange
nicht QRV war. Natuerlich ging das im DK5SG-BBS auch; mit: LIST
NEW COUNT 1
6.5 Das DIR Kommando
--------------------
Das DIR Kommando zeigt eine Liste aller im BBS verfuegbaren
Rubriken. Unter einer Rubrik versteht man den Oberbegriff ver-
schiedener Nachrichten aehnlichen oder zusammengehoerenden In-
halts. Das kann IBM, DARC oder UNIX sein. Beim SEND Kommando gibt
man an, in welcher Rubrik man seine Nachricht gerne speichern
wuerde. Existiert diese Rubrik dann nicht, so wird sie neu an-
gelegt. Solche neuen Rubriken haben aber meist nur eine kurze
Lifetime, also ihr Inhalt wird bald geloescht werden. Um das
Rubrikenchaos zu begrenzen, werden Rubriken aehnlichen oder gle-
ichen Inhalts manchmal zusammengefasst. Die Rubriken sind nicht
mit den Verteilern wie DL, WW zu verwechseln. Vor jeder Rubrik
wird beim DIR Kommando angezeigt, wieviele Nachrichten sie en-
thaelt. Man kann die Ausgabe auch begrenzen, indem man einen
Suchbegriff vorgibt. Wenn man versucht, eine umgeleitete Rubrik
zu lesen, wird eine Warnmeldung ausgegeben und es wird die Rubrik
gelesen, in welche umgeleitet wurde.
Beispiele:
DIR SAT* zeigt alle Rubriken, die mit SAT beginnen
DIR QS? zeigt alle Rubriken, die aus 3 Buchstaben
bestehen und mit QS beginnen
DIR S*WARE zeigt alle Rubriken, die mit S beginnen und
mit WARE aufhoeren
6.6 Das FORWARD Kommando
------------------------
Das FORWARD Kommando dient dem verschicken einer im BBS vorhanden
Nachricht als mail. Ist der Adressat auch eine Rubrik, so wird die Nachricht
innerhalb des BBS kopiert. Von dieser Moeglichkeit sollte nur in
Ausnahmefaellen Gebrauch gemacht werden. Es koennen nur Nachrichten
gemailt werden, die man selbst eingespielt hat.
Beispiele:
FORWARD dg1rtf@db0tud 101 102
FORWARD darc@db0lpz 1020
FORWARD suche@dl 9876
6.7 Das HELP Kommando
---------------------
Das HELP Kommando ohne Parameter gibt eine kurze Liste der
moeglichen BBS Kommandos aus, HELP gefolgt von einem Komman-
donamen druckt die Erklaerung dieses Kommandos, HELP ALL druckt
die Hilfe fuer alle Kommandos aus. Anstelle HELP kann auch ein ?
verwendet werden. Es emphiehlt sich die Ausgabe des Help-Texte
zu speichern oder den Drucker mitlaufen zulassen.
Beispiele:
HELP Drucke Liste der moeglichen Kommandos
HELP SEND Drucke Erklaerung des SEND Kommandos
? ALL Drucke das ganze BBS Manual
6.8 Das HIDE Kommando
--------------------
Das HIDE-Kommando wird verwendet, um Rubriken vom LIST-Kommando
auszuschliessen. HIDE ohne Parameter zeigt alle Rubriken, die nicht
angezeigt werden. Diese Rubriken-Liste wird ebenfalls mittels HIDE
erzeugt, indem die Rubriken als Parameter angegeben werden. Joker sind
erlaubt. Das HIDE-Kommando gilt nur fuer die aktuelle BBSX-Session.
Wer bestimmte Rubriken dauerhaft ausschliessen moechte, muss das mit
einem HIDE-Kommando in .bbsrc eintragen.
Syntax:
HIDE
HIDE Rubrik Rubrik
Beispiele:
HIDE
HIDE meinung darc sat*
6.9 Das INFO Kommando
---------------------
Mit dem INFO-Kommando kann man sich eine kurze Beschreibung ueber
die Hard- und Software des Systems anzeigen lassen. Dieses Kom-
mando enthaelt keine Hilfestellung zur Bedienung des BBS oder des
UNIX.
6.10 Das LIST Kommando
---------------------
Das LIST Kommando druckt ein Verzeichnis der gespeicherten
Nachrichten. Es werden nur die Nachrichten angezeigt, bei
denen alle angegebenen Optionen zutreffen. Die Optionsnamen
koennen in Klein- oder Grossbuchstaben eingegeben und
auch abgekuerzt werden. Falls kein Optionsname eingegeben
wurde, wird die TO Option angenommen. Wird die gleiche Option
mehrmals angegeben, wird nur die zuletzt angegebene berueck-
sichtigt. Die Ausgabe von LIST kann wie die aller anderen Kom-
mandos auch mit Interrupt-Zeichen (Kapitel 5) abgebrochen werden.
Ist mittels SET Kommando ein anderes Interrupt-Zeichen definiert,
z.B. <RETURN>, wirkt dieses im LIST Kommando.
Ist das BBS auf "DieBox"-Style geschalten, wird fuer den TO-
Paramter die Rubrik verwendet, in der man sich zuletzt befand.
Options:
$ ...................... Bulletin id
< ...................... Absender
> ...................... Empfaenger (Rubrik)
@ ...................... Verteiler (@DL)
AT ..................... Verteiler
BID .................... Bulletin id
COUNT .................. Anzahl der Nachrichten
FROM ................... Absender
MAX .................... Groesste Nummer der Nachricht
MIN .................... Niedrigste Nummer der Nachricht
NEW .................... Nummer seit dem letzten NEW
SUBJECT ................ Titel der Nachricht oder Teil davon
TO ..................... Empfaenger (Rubrik)
msg#- .................. Niedrgste Nummer der Nachricht
- msg# ................. Groesste Nummer der Nachricht
msg# - msg# ............ Nummernbereich
Beispiele:
LIST NEW .................. Liste alle neuen Nachrichten
LIST COUNT 10 ............. Liste die 10 neuesten Nachrichten
LIST SUBJECT "ham radio" .. Liste alle Nachrichten die den Text
"ham radio" im Titel haben
LIST MIN 12000 MAX 12100 .. Liste die Nachrichten mit den
Nummern von 12000 bis 12100
LIST TO wampes ............ Liste alle Nachrichten an WAMPES
LIST wampes ............... Liste alle Nachrichten an WAMPES
LIST < dk5sg count 5 ...... Liste die 5 letzten Nachrichten von
DK5SG
LIST < dl5ue > wampes @ db0sao C 7
Liste die 7 letzten Nachrichten,
die von dl5ue an wampes@db0sao
gesendet wurden
LIST wampes 3- ............ Liste alle Nachrichten an WAMPES
beginnend mit Nummer 3
LIST tcpip -100 ........... Liste alle Nachrichten an TCPIP mit
einer maximalen Nummer 100
LIST unix 30-40 ........... Liste alle Nachrichten an UNIX, deren
Nummern zwischen 30 und 40 liegt.
6.11 Das MAIL Kommando
---------------------
Mit MAIL kann auf das eigene MAIL-Verzeichnis zugegriffen werden.
Es gelten dann die Kommandos vom UNIX-Mailer. Eine spezielle Hilfe
dazu gibt es mit "?", nach dem Ausfuehren des Mail-Kommandos.
Wer nicht schon einen Mailer-Aufruf in seiner .profile hat oder den
Sessionmanager benutzt kann sich das MAIL-Kommando in die
.bbsrc schreiben und bekommt dann beim Aufruf des bbsx seine
Usermails praesentiert.
6.12 Das MOVE Kommando
----------------------
Mit dem MOVE Kommando kann man die Rubrik einer Nachricht aen-
dern. Das ist sinnvoll, wenn man sich im SEND Befehl vertippt
hat, oder einem eingefallen ist, dass der Kommentar zu Margittas
letztem Posting doch nichts in UNIX zu suchen hat. Die Syntax
des Befehls ist:
MOVE TO ziel_rubrik mesg# ...
MOVE > ziel_rubrik mesg# ...
Um zu vermeiden, dass jeder das moved, was ihm gerade in den Sinn
kommt, darf man nur die Nachrichten veraendern, die man selbst
eingespielt hat.
Beispiele:
MOVE > linux 10 11 2050
MOVE TO wampes 100 200
Read previous mail | Read next mail
| |
