packet:xrouter:docs:section4-mailboxcommands
Table of Contents
Section 4 - Mailbox Commands
BYE
BYE(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
BYE -- Graceful Session Termination.
SYNOPSIS
B[ye]
DESCRIPTION
The BYE command disconnects you from the mailbox.
If you accessed the mailbox from the node using the "PMS" or
"BBS" command, you will be returned to the node, otherwise
you will be disconnected.
CB
CB(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
CB -- Copy Message to Bulletin.
SYNOPSIS
CB <msg_number> <topic>[@ distribution]
DESCRIPTION
The CB (Copy to Bulletin) command makes a copy of a message,
and sends the copy as a bulletin.
The argument <msg_number> must refer to a bulletin, or to a
private message that the user is allowed to read. The copy is
always sent as a bulletin, even if the original was a private
message.
EXAMPLES
CB 123 TECH - Copy msg 123 as a bulletin to TECH
CB 456 PACKET @ GBR - Copy msg 456 as bulletin to PACKET@GBR
AVAILABILITY
The CB command is available to all users, but non-sysops can
only make copies of bulletins or private messages sent to
them or by them.
SEE ALSO
CP(4) -- Copy Message to Private Message.
CP
CP(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
CP -- Copy Message to Private Message.
SYNOPSIS
CP <msg_number> <to_callsign>[@ BBS etc]
DESCRIPTION
The CP (Copy to Private) command makes a copy of a message,
and sends the copy to someone else as a private message.
The argument <msg_number> must refer to a bulletin, or to a
private message that the user is allowed to read. The copy is
always sent as a private message, even if the original was a
bulletin.
EXAMPLES
CP 123 G8PZT - Copy msg 123 to G8PZT
CP 456 G4FPV @ GB7GLO.#46.GBR.EU - Copy msg 456 to G4FPV...
AVAILABILITY
The CP command is available to all users, but non-sysops can
only make copies of bulletins or private messages sent to
them or by them.
SEE ALSO
CB(4) -- Copy Message to Bulletin.
EH
EH(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
EH -- Edit Message Header.
SYNOPSIS
EH <msg_number>
DESCRIPTION
The EH (Edit Header) command edits the header or "envelope" of
a message.
After issuing the command, the header details are displayed,
along with a list of single letter commands.
Each field of the header can be changed by issuing the single
letter command followed by a space, then the new value for
the field. The header is redisplayed with the modified value.
When all edits are done, hitting <CR> by itself terminates the
editor.
OPTIONS
The capital letters are the commands used to change the header
fields:
t<Y>pe Y changes the mesaage type (P, B, T etc)
<S>tatus S changes the status (H, F, R etc)
<T>o T changes the "to" field (callsign or topic).
<F>rom F changes the "from" field (callsign).
<A>t A changes the "at" field (distribution area)
s<U>bject U changes the subject.
<M>id M changes the message ID
<CR> Carriage return terminates the editing process.
EXAMPLES
Y B - Change the type to Bulletin.
U Local News - Change the subject to "Local News"
A GBR - Change the distribution to GBR.
AVAILABILITY
Sysop-only.
EXPORT
EXPORT(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
EXPORT -- Export Message to File.
SYNOPSIS
EX[port] <msg_number> <filename>
DESCRIPTION
The EXPORT command writes a copy of a message into a file in
"MBL" format.
(WA7)MBL is a standard message exchange format understood by
virtually all mailbox software.
The exported message is appended to the specified file,
including all its routing headers.
If no path is specified, the resulting file is saved in the
same directory as the XRouter executable.
EXAMPLES
EXPORT 123 techsav.mbl
EX 456 /home/pi/backups/packet.mbl
AVAILABILITY
Sysop-only.
SEE ALSO
IMPORT(4) -- Import Message(s) from File.
MF(4) -- Make File from Message.
MFH(4) -- Make File From Message Including Headers.
FF
FF(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
FF -- Force Fowarding.
SYNOPSIS
FF [mailbox_callsign]
DESCRIPTION
The FF (Force Forward) command starts a "forward run", even
when one is not due.
A "forwarding run" is one pass through the "forwarding file"
(FWD.SYS). For each mailbox in the forwarding file, if there
is anything queued for that mailbox, and forwarding is allowed
at that date and time, the associated connection script is
executed and the mail is delivered.
Forwarding runs are started every 15 minutes (configurable by
"ForwardInterval" directive in PMS.CFG), or upon receipt of
new mail.
If a forward run ends without delivering all the mail, e.g.
due to a connection failure, the FF command can be used to
start a new one immediately, instead of waiting 15 minutes.
OPTIONS
If the optional [mailbox_callsign] is supplied, the run is
restricted to that peer mailbox only.
EXAMPLES
FF -- Force Forwarding to all BBS's in FWD.SYS.
FF G8PZT-2 -- Force Forwarding to G8PZT-2 only.
AVAILABILITY
Sysop-only.
SEE ALSO
FP(4) -- Force Polling.
SF(4) -- Stop Forwarding.
VF(4) -- View Forwarding.
FP
FP(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
FP -- Force Polling.
SYNOPSIS
FP [mailbox_callsign]
DESCRIPTION
The FP (Force Polling) command starts a "polling run", even
when one is not due.
A "polling run" is one pass through the "forwarding file"
(FWD.SYS). For each mailbox in the forwarding file which has
the "P" option and a valid date and time, the associated
connection script is executed and reverse forwarding is
requested.
Polling is used when the peer mailbox is unable to make
outgoing connections to this mailbox, for example to poll a
TNC-based PMS.
Forwarding/polling runs are normally started every 15 minutes
(configurable by "ForwardInterval" directive in PMS.CFG),
when there is no outgoing mail.
If a polling run ends prematurely, e.g. due to a connection
failure, the FF command can be used to start a new one
immediately, instead of waiting 15 minutes.
OPTIONS
If the optional [mailbox_callsign] is supplied, the run is
restricted to that peer mailbox only.
EXAMPLES
FP -- Force Polling of all BBS's in FWD.SYS.
FP G8PZT-2 -- Force Polling of G8PZT-2 only.
AVAILABILITY
Sysop-only.
SEE ALSO
FF(4) -- Force Forwarding.
SF(4) -- Stop Forwarding.
VF(4) -- View Forwarding.
HELP
HELP(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
HELP -- Display Mailbox Help.
SYNOPSIS
H[elp] [cmd | topic]
DESCRIPTION
The HELP command, which may be abbreviated to "H", displays
brief help for the mailbox commands and related topics that
are available to all users.
OPTIONS
HELP by itself gives directions on how to access help.
If the argument is a command name or topic, the help file for
that command or topic is displayed. The argument "*" lists
the available help topics.
EXAMPLES
H * - List available help topics.
H KM - Displays help for the KM command.
AVAILABILITY
All users. Help for Sysop-only commands is available via the
sysop manual instead.
SEE ALSO
INFO(4) -- Mailbox Information
HOLD
HOLD(4) XROUTER REFERENCE MANUAL 6/9/2023
COMMAND
HOLD -- Hold Message For Review.
SYNOPSIS
HO[ld] <message_number>
DESCRIPTION
The HOLD command "holds" a message for review, i.e. makes it
invisible to users and prevents it from being forwarded.
The message can then be edited and released, or action can be
deferred until time allows.
It is not a particularly useful command, because by the time
the message comes to the sysop's attention it will probably
already have been forwarded. But that's then someone else's
problem!
It does allow you to remove the message and save it for
evidence instead of simply deleting it.
Apart from unwanted or abusive content, another reason to
hold mail is if it needs to be readdressed, or if it for any
other reason it fails to forward, holding up the queue.
"Held" messages have the status "H". They can be listed using
the LH (List Held) command, deleted using the KH (Kill Held)
command, or released using the UH (Un-Hold) command.
Messages may be automatically held by entries in the HOLD.SYS
BADWORD.SYS and MSGFILT.SYS files.
EXAMPLE
HO 123 - Hold message 123
AVAILABILITY
Sysop-only.
SEE ALSO
KH(4) -- Kill Held Message(s).
LH(4) -- List Held Message(s).
UH(4) -- Un-Hold a Message.
I@
I@(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
I@ -- List White Pages Entries by Home BBS.
SYNOPSIS
I@ <bbs>
DESCRIPTION
The I@ command queries the White Pages (WP) database, and
displays any users who have nominated the specified BBS as
their "home" BBS.
OPTIONS
The argument is case-insensitve, and wildcards are allowed.
EXAMPLES
I@ GB7* - List users whose home BBS begins with GB7
I@ GB7BDX - List users whose home BBS is GB7BDX
AVAILABILITY
All users.
SEE ALSO
INFO(4) -- Display Mailbox or White Pages Information.
IC(4) -- List White Pages Entries by Callsign.
IH(4) -- List White Pages Entries by Hierarchical Address
IN(4) -- List White Pages Entries by Name
IQ(4) -- List White Pages Entries by QTH
IZ(4) -- List White Pages Entries by Zip code
IC
IC(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
IC -- List White Pages Entries by Callsign.
SYNOPSIS
IC <callsign>
DESCRIPTION
The IC command queries the White Pages (WP) database and
displays any entries with the specified callsign.
OPTIONS
Case-insensitive. Wildcards are allowed.
EXAMPLES
IC G4* - List users whose callsign begins with G4
IC G8PZT - Display WP record for G8PZT
AVAILABILITY
All users.
SEE ALSO
INFO(4) -- Display Mailbox or White Pages Information.
I@(4) -- List White Pages Entries by Home BBS
IH(4) -- List White Pages Entries by Hierarchical Address
IN(4) -- List White Pages Entries by Name
IQ(4) -- List White Pages Entries by QTH
IZ(4) -- List White Pages Entries by Zip code
IH
IH(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
IH -- List White Pages Entries by Hierarchical Address.
SYNOPSIS
IH <haddr>
DESCRIPTION
The IH command lists White Pages (WP) entries whose
hierarchical address contains the specified string of
characters.
OPTIONS
Wildcards are NOT allowed. This command performs a "sliding"
match, so for example "IH GBR" displays systems in GBR and
GBR.EU.
AVAILABILITY
All users.
SEE ALSO
INFO(4) -- Display Mailbox or White Pages Information.
I@(4) -- List White Pages Entries by Home BBS
IC(4) -- List White Pages Entries by Callsign.
IN(4) -- List White Pages Entries by Name
IQ(4) -- List White Pages Entries by QTH
IZ(4) -- List White Pages Entries by Zip code
IMPORT
IMPORT(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
IMPORT -- Import Message(s) From File.
SYNOPSIS
IM[port] <filename>
DESCRIPTION
The IMPORT command reads MBL-format messages from a file into
the message database.
(WA7)MBL is a standard format for exporting, importing and
exchanging messages, understood by virtually all mailbox
software.
The imported messages are treated as though they had been
received from another mailbox, and are forwarded if necesaary.
If no path is specified, the source file is expected to be in
the same directory as the XRouter executable.
Note that in addition to this "manual" method of importing
mail, there is an automatic method: If a file caled "mail.in"
exists in the PMS directory, its contents are imported
and the file is deleted. This can be used to import mail
generated by external applications.
AVAILABILITY
Sysop-only
SEE ALSO
EXPORT(4) -- Export Message to File.
MB(4) -- Make Bulletin From File.
MP(4) -- Make Personal Message From File.
IN
IN(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
IN -- List White Pages Entries by Name
SYNOPSIS
IN <name>
DESCRIPTION
The IH command lists WP (White Pages) entries which have the
specified name.
OPTIONS
Wildcards are allowed.
EXAMPLES
IN Roger - List WP entries with name "Roger"
IN Will* - List WP entries with "Will" in the name
AVAILABILITY
All users.
SEE ALSO
INFO(4) -- Display Mailbox or White Pages Information.
I@(4) -- List White Pages Entries by Home BBS
IC(4) -- List White Pages Entries by Callsign.
IH(4) -- List White Pages Entries by Hierarchical Address
IQ(4) -- List White Pages Entries by QTH
IZ(4) -- List White Pages Entries by Zip code
INFO
INFO(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
INFO -- Display Mailbox or White Pages Information.
SYNOPSIS
I[nfo] [callsign]
DESCRIPTION
The INFO command, which may be abbreviated to I, displays
information about the mailbox, or from White Pages.
OPTIONS
If no arguments are supplied, the INFO command displays
general information about the mailbox and other I commands.
If the argument is a callsign, White Pages (WP) data for that
callsign is displayed, if available. Wildcards are allowed.
The argument "*" displays the entire WP database (long list).
EXAMPLES
INFO - Display mailbox information.
I g8pzt - Display WP information for G8PZT
I G4* - Display WP data for all G4 callsigns
AVAILABILITY
All users.
SEE ALSO
HELP(4) -- Mailbox Help.
I@(4) -- List White Pages Entries by Home BBS
IC(4) -- List White Pages Entries by Callsign.
IH(4) -- List White Pages Entries by Hierarchical Address
IN(4) -- List White Pages Entries by Name
IQ(4) -- List White Pages Entries by QTH
IZ(4) -- List White Pages Entries by Zip code
WPAGES(9) -- The White Pages Database.
IQ
IQ(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
IQ -- List White Pages Entries by QTH.
SYNOPSIS
IQ <qth>
DESCRIPTION
The IQ command queries the White Pages database and
displays all entries who have the specified character string
as part of the QTH. Performs a "sliding" match.
OPTIONS
Case-independent. Wildcards NOT allowed.
EXAMPLES
IQ Kidderminster - Lists users in Kidderminster.
IQ amb - Lists users in Ambridge, Cambridge, Camborne...
AVAILABILITY
All users.
SEE ALSO
INFO(4) -- Display Mailbox or White Pages Information.
I@(4) -- List White Pages Entries by Home BBS
IC(4) -- List White Pages Entries by Callsign.
IH(4) -- List White Pages Entries by Hierarchical Address
IN(4) -- List White Pages Entries by Name
IZ(4) -- List White Pages Entries by Zip code
IZ
IZ(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
IZ -- List White Pages Entries by Zip code.
SYNOPSIS
IZ <zip | locator>
DESCRIPTION
The IZ command queries the White Pages database, displaying
all entries which have the specified ZIP code.
Note that in the UK we use Maidenhead locators, not Zip codes.
OPTIONS
The argument is case-independent. Wildcards are accepted.
EXAMPLES
IZ IO82* - List all users in this major square
IZ DY* - List users in the Dudley postcode area
AVAILABILITY
All users.
SEE ALSO
INFO(4) -- Display Mailbox or White Pages Information.
I@(4) -- List White Pages Entries by Home BBS
IC(4) -- List White Pages Entries by Callsign.
IH(4) -- List White Pages Entries by Hierarchical Address
IN(4) -- List White Pages Entries by Name
IQ(4) -- List White Pages Entries by QTH
WPAGES(9) -- The White Pages Database.
J
J(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
J -- Display Recent Mailbox Sessions.
SYNOPSIS
J [max]
DESCRIPTION
The J (Just-heard) command displays recent mailbox sessions.
Current sessions are not displayed.
Only the most recent connect by each callsign is shown, along
with the date and time of their last connection, and the
length of time they were connected.
OPTIONS
The optional [max] argument specifies the maximum number of
recent sessions to display.
EXAMPLES
J - Display all the recent sessions.
J 3 - Display the 3 most recent connections.
AVAILABILITY
All users.
K<
K<(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
K< -- Kill Message(s) From a Callsign.
SYNOPSIS
K< <callsign>
DESCRIPTION
The K< (KillFrom) command kills (deletes) messages originated
FROM a specified callsign.
The argument is case-independent. Wildcards are accepted.
EXAMPLES
K< G8PZT - Kill messages from G8PZT
K< VK* - Kill all messages from Australians
AVAILABILITY
All users. Non-sysops may only kill messages originated by
themselves.
SEE ALSO
L<(4) -- List Messages From a Callsign.
K>(4) -- Kill Message(s) To Destination.
K@(4) -- Kill Messages At a Distribution.
KF(4) -- Kill Forwarded Mail.
KH(4) -- Kill Held Mail.
KILL(4) -- Kill Message(s) By Number.
KM(4) -- Kill Mine.
KR(4) -- Kill Read Mail.
K>
K>(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
K> -- Kill Message(s) To Destination.
SYNOPSIS
K> <callsign | topic>
DESCRIPTION
The K> (KillTo) command kills (deletes) messages addressed TO
a specified callsign or bulletin topic.
The argument is case-independent. Wildcards are accepted.
EXAMPLES
K> G8PZT - Kill messages addressed to G8PZT
K> HELP - Kill messages addressed to topic HELP
K> DL* - Kill messages addressed to Germans
AVAILABILITY
All users, but non-sysops may only delete mail originated by
them, or addressed to them.
SEE ALSO
K<(4) -- Kill Message(s) From a Callsign.
K@(4) -- Kill Messages At a Distribution.
KF(4) -- Kill Forwarded Mail.
KH(4) -- Kill Held Mail.
KILL(4) -- Kill Message(s) By Number.
KM(4) -- Kill Mine.
KR(4) -- Kill Read Mail.
L>(4) -- List Message(s) To Destination.
K@
K@(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
K@ -- Kill Messages At a Distribution.
SYNOPSIS
K@ <distribution>
DESCRIPTION
The K@ (Kill At) command kills (deletes) messages addressed AT
a specified distribution area.
The argument is case-independent. Wildcards are accepted.
EXAMPLES
K@ USA - Kill all bulletins addressed @USA
K@ EU* - Kill bulletins addressed @EU, @EURO etc
AVAILABILITY
Sysop-only.
SEE ALSO
K<(4) -- Kill Message(s) From a Callsign.
K>(4) -- Kill Message(s) To Destination.
KF(4) -- Kill Forwarded Mail.
KH(4) -- Kill Held Mail.
KILL(4) -- Kill Message(s) By Number.
KM(4) -- Kill Mine.
KR(4) -- Kill Read Mail.
L@(4) -- List Messages At a Distribution.
K-CMDS
K-CMDS(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
K-CMDS -- Commands for Killing Mail.
SYNOPSIS
K[ill] <n ...>
K> <to>
K< <from>
K@ <distribution>
KF [callsign]
KH [callsign]
KM
KR [callsign]
DESCRIPTION
The K (kill) commands are used to delete messages from the
mailbox. There are several forms, listed above, each with
its own manual page.
AVAILABILITY
K>, K<, KILL and KM are available to all users.
K@, KF, KH and KR are sysop-only
SEE ALSO
K<(4) -- Kill Message(s) From a Callsign.
K>(4) -- Kill Message(s) To Destination.
K@(4) -- Kill Messages At a Distribution.
KF(4) -- Kill Forwarded Mail.
KH(4) -- Kill Held Mail.
KILL(4) -- Kill Message(s) By Number.
KM(4) -- Kill Mine.
KR(4) -- Kill Read Mail.
KF
KF(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
KF -- Kill Forwarded Mail.
SYNOPSIS
KF [to]
DESCRIPTION
The KF (Kill Forwarded) command deletes messages that have
been successfully forwarded to another mailbox
OPTIONS
If a [to] callsign or topic is supplied, only the forwarded
mail addressed to that destination is deleted.
EXAMPLES
KF - Kill all forwarded mail
KF EQUAKE - Kill forwarded mail addresed to EQUAKE
KF TECH* - Kill forwarded mail addresses to TECH, TECHNI etc
AVAILABILITY
Sysop-only
SEE ALSO
K<(4) -- Kill Message(s) From a Callsign.
K@(4) -- Kill Messages At a Distribution.
KH(4) -- Kill Held Mail.
KILL(4) -- Kill Message(s) By Number.
KM(4) -- Kill Mine.
KR(4) -- Kill Read Mail.
LF(4) -- Kill Forwarded Mail.
KH
KH(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
KH -- Kill Held Mail.
SYNOPSIS
KH [to]
DESCRIPTION
The KH (Kill Held) command deletes mail that has been "held"
for review.
Mail is held if it matches criteria specified in HOLD.SYS,
which is self-documented. Held mail is not forwarded, and not
visible to anyone except sysops.
OPTIONS
The optional [to] argument specifies a callsign or bulletin
topic. If present, only held mail addressed to that callsign
or topic is deleted.
EXAMPLES
KH - Delete all held mail.
KH SALE - Delete held mail addressed to SALE only
AVAILABILITY
Sysop-only.
SEE ALSO
K<(4) -- Kill Message(s) From a Callsign.
K>(4) -- Kill Message(s) To Destination.
K@(4) -- Kill Messages At a Distribution.
KF(4) -- Kill Forwarded Mail.
KILL(4) -- Kill Message(s) By Number.
KM(4) -- Kill Mine.
KR(4) -- Kill Read Mail.
LH(4) -- List Held Mail.
KILL
KILL(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
KILL -- Kill Message(s) By Number.
SYNOPSIS
K[ill] <n1 [n2 n3 ...]>
DESCRIPTION
The KILL command, which may be abbreviated to K, kills
(deletes) one or more messages from the mailbox.
Once a message has been deleted, it is gone forever; there is
no un-delete!!
OPTIONS
The numbers of the messages to be deleted must be separated
by one or more spaces or tabs. Commas must not be used.
EXAMPLES
KILL 375 -- Kill message 375
K 23 47 92 -- Kill multiple messages
AVAILABILITY
All users, but non-sysops may only kill mail orginated by, or
addressed to, themselves.
SEE ALSO
K<(4) -- Kill Message(s) From a Callsign.
K>(4) -- Kill Message(s) To Destination.
K@(4) -- Kill Messages At a Distribution.
KF(4) -- Kill Forwarded Mail.
KH(4) -- Kill Held Mail.
KM(4) -- Kill Mine.
KR(4) -- Kill Read Mail.
KM
KM(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
KM -- Kill Mine.
SYNOPSIS
KM
DESCRIPTION
The KM (KillMine) command kills (deletes) mail addressed to
you, but only if you have read it.
AVAILABILITY
The KM command is available to all users.
SEE ALSO
K<(4) -- Kill Message(s) From a Callsign.
K>(4) -- Kill Message(s) To Destination.
K@(4) -- Kill Messages At a Distribution.
KF(4) -- Kill Forwarded Mail.
KH(4) -- Kill Held Mail.
KILL(4) -- Kill Message(s) By Number.
KR(4) -- Kill Read Mail.
LM(4) -- List Mine.
KR
KR(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
KR -- Kill Read Mail.
SYNOPSIS
KR [to]
DESCRIPTION
The KR (Kill Held) command deletes private mail that has been
read by its intended recipient.
OPTIONS
The optional [to] argument specifies a callsign. If present,
only "read" mail addressed to that callsign is deleted. The
argument is case insensitive and wildcards are accepted.
EXAMPLES
KR - Delete all read mail.
KR G8PZT - Delete read mail addressed to G8PZT only.
KR M7* - Delete read mail addressed to al M7 calls
AVAILABILITY
Sysop-only.
SEE ALSO
K<(4) -- Kill Message(s) From a Callsign.
K>(4) -- Kill Message(s) To Destination.
K@(4) -- Kill Messages At a Distribution.
KF(4) -- Kill Forwarded Mail.
KH(4) -- Kill Held Mail.
KILL(4) -- Kill Message(s) By Number.
KM(4) -- Kill Mine.
LR(4) -- List Read Mail.
L$
L$(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
L$ -- List Messages Awaiting Forwarding.
SYNOPSIS
L$ [to]
DESCRIPTION
The L$ (List Unforwarded) command lists messages that are
waiting to be forwarded to other mailboxes. These messages
usually have the status "$".
A new message, i.e. one created by a user of this mailbox, or
one received from another mailbox, is given the "$" status if
it is "forwardable". But it only does this if you have
configured the mailbox to allow forwarding of messages to
other mailboxes, and the mail is not addressed at this
mailbox.
Once a message has been forwarded, the status changes to "F".
OPTIONS
The optional argument should be a callsign or a bulletin
topic, and is case-insensitive. Wildcards are accepted.
EXAMPLES
L$ - List all unforwarded mail
L$ SYSOP - List unforwarded mail addressed to SYSOP
L$ TECH* - List unforwarded mail to TECH and TECHNI
AVAILABILITY
The L$ command is available to all users.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
L<
L<(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
L< -- List Messages FROM Callsign.
SYNOPSIS
L< <callsign>
DESCRIPTION
The L< (ListFrom) command lists messages originated by a
specified callsign.
OPTIONS
The argument is case-independent. Wildcards are accepted.
EXAMPLES
L< G8PZT - List all messages from G8PZT
L< VK* - List all messages from Australians
AVAILABILITY
All users, but private mail is only displayed to sysops and
the intended recipient.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
L>
L>(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
L> -- List Messages To Callsign or Category.
SYNOPSIS
L> <callsign | topic>
DESCRIPTION
The L> (List To) command lists messages addressed TO a
callsign or bulletin topic / category.
OPTIONS
The argument is case-independent. Wildcards are accepted.
EXAMPLES
L> G8PZT - List messages addressed to G8PZT
L> PACKET - List messages addressed to topic PACKET
AVAILABILITY
All users, but private mail is only displayed to sysops and
the intended recipient.
SEE ALSO
LIST(4) -- List Messages By Number.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
L@
L@(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
L@ -- List Messages AT a Distribution.
SYNOPSIS
L@ <distribution>
DESCRIPTION
The L@ (List At) command lists messages targeted AT a
specified mailbox or distribution area.
Distribution areas are groups of mailboxes where the same
bulletin is visible on all of them. They are set up by mutual
agreement between sysops.
For example, in the UK, all sysops forward "@GBR" bulletins
to all their peers in the UK, but not to their peers in other
countries.
EXAMPLES
L@ GB7PZT - List messages targetted at GB7PZT mailbox
L@ GBR - List messages with GBR distribution area
L@ EU* - List messages with EU or EURO distribution
OPTIONS
The argument is case-independent. Wildcards are accepted.
AVAILABILITY
The L@ command is available to all users.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LA
LA(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LA -- List Oldest Messages.
SYNOPSIS
LA <max>
DESCRIPTION
The LA (List Ancient) command lists the oldest messages, from
the oldest towards the newest.
Don't ask why it's "List Ancient" not "List Oldest" - It has
always been so. The reason is lost in the mists of time! The
command is provided for backwards compatability.
The LO (List Oldest) command performs the identical function.
OPTIONS
<max> is a number specifying the maximum number of messages
to display.
EXAMPLE
LA 25 - List the oldest 25 messages
AVAILABILITY
The LA command is available to all users.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LB
LB(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LB -- List Bulletins.
SYNOPSIS
LB [max]
DESCRIPTION
The LB (List Bulletins) command lists the most recent
bulletins in reverse order, i.e. newest first.
OPTIONS
Optional argument [max] specifies the maximum number of
bulletins to list, and defaults to 25.
EXAMPLES
LB - List the most recent 25 bulletins
LB 100 - List the most recent 100 bulletins
AVAILABILITY
The LB command is available to all users.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LC
LC(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LC -- List Bulletin Categories.
SYNOPSIS
LC [category]
DESCRIPTION
The LC (List Categories) command lists all the bulletin
categories (aka topics), together with total number of
bulletins in each.
OPTIONS
The optional case-independent argument can be used to narrow
the search. Wildcards are accepted.
EXAMPLES
LC - List all bulletin categories
LC A* - List categories that begin with the letter 'A'
AVAILABILITY
The LC copmmand is available to all users.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
L-CMDS
L-CMDS(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
L-CMDS -- Commands For Listing Mail.
SYNOPSIS
L[ist] List messages and bulletins.
L[ist] <n> List messages starting at number <n>
L[ist] <f> <l> List messages from numbers <f> to <l>
L> <to> List messages TO callsign or category
L< <from> List messages FROM callsign
L@ <at> List messages AT a distribution
L$ [to] List messages waiting to be forwarded
LA <n> List oldest <n> messages
LB [n] List [max of n] Bulletins backwards
LC [cat] List bulletin categories
LF [to] List sucessfully Forwarded messages
LH [to] List held messages
LL <n> List the Last (most recent) <n> messages
LM List Mine (all messages addressed to you)
LN List New (unread) mail addressed to you
LP [n] List [max of n] Private messages
LR [to] List private mail that has been read
LS <text> List messages whose subject contains <text>
LT <text> List messages containing <text> in body
LU [to] List Unread messages
DESCRIPTION
The L (List) commands are used to display lists of messages
and bulletins on the mailbox.
Each of the above commands has its own manual page as listed
below.
AVAILABILITY
The LH (List Held) command is sysop-only, but the remainder
of the L commands are available to all users.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LF
LF(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LF -- List Forwarded Messages.
SYNOPSIS
LF [to]
DESCRIPTION
The LF (List Forwarded) command lists messages that were
successfully forwarded to another mailbox.
OPTIONS
The optional case-independent argument can be used to narrow
the search, based on the "to" field or bulletin "category"
(topic). Wildcards are accepted.
EXAMPLES
LF - List all forwarded messages
LF TECH* - List forwarded messages to TECH or TECHNI
AVAILABILITY
The LF command is available to all users.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LH
LH(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LH -- List Held Mail.
SYNOPSIS
LH [to]
DESCRIPTION
The LH (List Held) command displays mail that has been "held"
for review.
Mail is held if it matches criteria specified in HOLD.SYS,
which is self-documented. Held mail is not forwarded, and not
visible to anyone except sysops.
OPTIONS
The optional [to] argument specifies a callsign or bulletin
topic. If present, only held mail addressed to that callsign
or topic is displayed.
EXAMPLES
LH - List all held mail.
LH SALE - List held mail addressed to SALE only
AVAILABILITY
Sysop-only.
SEE ALSO
HOLD(4) -- Hold Mail
HOLD.SYS(8) -- Mail Holding Control File.
KH(4) -- Kill Held Mail
UH(4) -- Un-hold Mail
LIST
LIST(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LIST -- List Messages By Number.
SYNOPSIS
L[ist]
L[ist] <first_number>
L[ist] <first_number> <last_number>
DESCRIPTION
The LIST command, which may be abbreviated to "L", is used to
list messages by number.
Each message has a unique "index" number on this BBS. The
number is not part of the messsage "envelope", although it
is displayed as if it were so. The same message on a different
mailbox would have a different number.
The mailbox can be configured to re-number the messages from
time to time, to keep the mumbers within a manageable range.
OPTIONS
L[ist] by itself lists messages that have arrived since you
last used the L command, which may be none.
A single numeric argument specifies a starting number, from
which the listing will proceed in a forwards direction.
If two numeric arguments are supplied, the first specifies
the starting mumber and the second specifies the last number
to be listed.
EXAMPLES
LIST - List upwards from your previous "last-listed"
L 400 - List messages starting at number 400
L 50 60 - List messages from numbers 50 to 60
AVAILABILITY
The LIST command is available to all, but non-sysops can
only see messages created by, or addressed to, themselves.
SEE ALSO
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LL
LL(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LL -- List Most Recent Messages
SYNOPSIS
LL <max>
DESCRIPTION
The LL (List Latest) command lists the most recent messages
in reverse order, i.e. newest first. It is similar to LB,
except that it includes all types of message, not just
bulletins.
If pagination is enabled (see NP command), the listing stops
after 1 pageful, allowing you to select messages on that page
to read. After reading the messages, the listing resumes.
OPTIONS
The numeric argument <max> specifies the maximum number of
messages to display.
EXAMPLE
LL 10 - List the latest 10 messages.
AVAILABILITY
The LL command is available to all, but non-sysops can
only see messages created by, or addressed to, themselves.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LM
LM(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LM -- List Mine.
SYNOPSIS
LM
DESCRIPTION
The LM (List Mine) command is similar to LN (List New) in that
it lists all messages addressed to you, except that it
includes the messages you have read.
AVAILABILITY
The LM command is available to all users.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LN
LN(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LN -- List New Messages.
SYNOPSIS
LN
DESCRIPTION
The LN (List New) command lists new (i.e. unread) messages
addressed to you.
To see ALL mail addressed to you, whether it has been read or
not, use LM (List Mine).
AVAILABILITY
The LN command is available to all users.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LO
LO(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LO -- List Oldest Messages.
SYNOPSIS
LO <max>
DESCRIPTION
The LO (List Oldest) command lists the oldest messages, from
the oldest towards the newest.
The LA (List Ancient) command performs the identical function.
OPTIONS
<max> is a number specifying the maximum number of messages
to display.
EXAMPLE
LO 25 - List the oldest 25 messages
AVAILABILITY
The LO command is available to all users.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LO(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LP
LP(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LP -- List Private Messages.
SYNOPSIS
LP [max]
DESCRIPTION
The LP (List Private) command lists private messages, i.e.
those addressed to a single recipient.
OPTIONS
The optional numeric [max] argument specifies the maximum
number of messages to list. The default is 25.
EXAMPLE
LP 10 - List a maximum of 10 private messages.
AVAILABILITY
The LP command is available to all, but non-sysops can
only see messages created by, or addressed to, themselves.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LQ
LQ(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LQ -- List Messages Queued (Awaiting Forwarding).
SYNOPSIS
LQ [to]
DESCRIPTION
The L$ (List Queued) command lists messages that are waiting
to be forwarded to other mailboxes. These messages usually
have the status "$".
A new message, i.e. one created by a user of this mailbox, or
one received from another mailbox, is given the "$" status if
it is "forwardable". But it only does this if you have
configured the mailbox to allow forwarding of messages to
other mailboxes, and the mail is not addressed at this
mailbox.
Once a message has been forwarded, the status changes to "F".
OPTIONS
The optional argument should be a callsign or a bulletin
topic, and is case-insensitive. Wildcards are accepted.
EXAMPLES
LQ - List all unforwarded mail
LQ SYSOP - List unforwarded mail addressed to SYSOP
LQ TECH* - List unforwarded mail to TECH and TECHNI
AVAILABILITY
The LQ command is available to all users.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L$(4) -- List Mesages by Message-ID
L@(4) -- List Messages AT a Distribution.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LR
LR(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LR -- List Read Private Messages.
SYNOPSIS
LR
DESCRIPTION
The LR (List Read) command lists private messages that have
been read by their intended recipient.
OPTIONS
The optional case-independent [to] argument can be used to
limit the search. Wildcards are accepted.
EXAMPLES
LR - List all private mail that has been read.
LR G8PZT - List G8PZT's read mail.
LR VK* - List all Australians' read mail.
AVAILABILITY
The LR command is available to all, but non-sysops can
only see messages created by, or addressed to, themselves.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LS
LS(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LS -- List Messages By Subject.
SYNOPSIS
LS <word>
DESCRIPTION
The LS (List by Subject) command lists messages with a
specified word or part-word anywhere in the subject.
A "sliding match" is performed, thus "eat" will match "meat",
"feature", "weather" etc.
OPTIONS
The argument is case-insensitive. Wildcards are NOT allowed.
EXAMPLE
LS IBM - List messages with IBM anywhere in the subject.
AVAILABILITY
The LS command is available to all, but non-sysops can
only see messages created by, or addressed to, themselves.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LT(4) -- List Messages By Text.
LU(4) -- List Unread Messages.
LT
LT(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LT -- List Messages By Text.
SYNOPSIS
LT <word>
DESCRIPTION
The LT (List by Text) lists messages containing a specified
word or part-word anywhere in the message body.
OPTIONS
The argument is case-insensitive. Wildcards and phrases are
not accepted.
EXAMPLE
LT Packet - List messages containing the word "packet".
AVAILABILITY
The LT command is available to all, but non-sysops can
only see messages created by, or addressed to, themselves.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LU(4) -- List Unread Messages.
LU
LU(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
LU -- List Unread Messages.
SYNOPSIS
LU [to]
DESCRIPTION
The LU (List Unread) command lists unread private mail, plus
bulletins that have not been forwarded or marked for
forwarding.
OPTIONS
The case-independent argument [to] can be used to restrict
the search. Wildcards are accepted.
EXAMPLES
LU - List all unread/unmarked mail
LU RSGB - List unmarked bulletins addressed to RSGB
LU ???USA - List mail affressed to ALLUSA, PKTUSA etc
AVAILABILITY
The LU command is available to all, but non-sysops can
only see messages created by, or addressed to, themselves.
SEE ALSO
LIST(4) -- List Messages By Number.
L>(4) -- List Messages TO Callsign or Category.
L<(4) -- List Messages FROM Callsign.
L@(4) -- List Messages AT a Distribution.
L$(4) -- List Messages Awaiting Forwarding.
LA(4) -- List Oldest Messages.
LB(4) -- List Bulletins.
LC(4) -- List Bulletin Categories.
LF(4) -- List Forwarded Messages.
LH(4) -- List Held Messages
LL(4) -- List Most Recent Messages
LM(4) -- List Mine.
LN(4) -- List New Messages.
LO(4) -- List Oldest Messages.
LP(4) -- List Private Messages
LR(4) -- List Read Private Messages.
LS(4) -- List Messages By Subject.
LT(4) -- List Messages By Text.
MAN
MAN(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
MAN -- Display Sysop's Manual Pages.
SYNOPSIS
MAN [section] [topic]
DESCRIPTION
The MAN command is used to access the sysop's manual, which
consists of a collection of pages, each covering a different
command or topic.
The MAN pages are designed for sysop use, and usually give
more detail than the corresponding HELP pages.
The manual is divided into several sections as follows:
Section Contents
------------------------------------------
1 General Commands
2 Chat Server Commands
3 PZTDOS commands
4 Mailbox commands
6 Installation & Configuration Topics
7 Configuration Directives
8 Configuration / System Files.
9 Miscellaneous Topics
When used from the mailbox command line, MAN by default shows
only the pages in section 4. Pages from other sections may be
displayed using the [section] argument.
OPTIONS
Use MAN SECTIONS to list the sections.
Entering MAN alone displays a list of available topics in
section 4.
To read a specific page in section 4, enter MAN followed by
the topic for which you require help.
To list topics in any other section, enter MAN followed by the
section number.
To read a topic in a section other than 4, enter MAN followed
by a space, the section number, a space then the topic.
If a topic name contains wildcards, all matching topic names
in the section are displayed.
EXAMPLES
MAN LC Display section 4 page for LC command.
MAN 7 List the topics in section 7
MAN 7 MAXTT Display section 7 page for MAXTT directive
MAN 1 I* List section 1 topics begining with 'I'
CONVENTIONS
The following conventions are used in MAN pages:
< > Mandatory argument - These braces and the text
enclosed within them represent any piece of text
typed after the command. The <> do not form part
of the argument.
[ ] Optional argument - These braces enclose anything
which is not always present. If used within a
command name (e.g. N[ODES]), this indicates that
the command may be abbreviated to a minimum form
while remaining unique.
AVAILABILITY
Sysop-only.
FILES
Manual files are normal text files, with the extension
changed to ".MAN". They may be created and edited using a
simple text editor such as Notepad (windows) or Leafpad, nano
etc (Linux).
All MAN files are located within the MAN directory, which
itself is in the directory containing XRouter.
As MAN files are for use only by the sysop, there is no need
for separate directories for alternate language versions.
Even if the MAN files are translated to a different language,
they must always be situated in the MAN directory, not in a
subdirectory thereof
Filenames, including the extensions, MUST be in UPPER CASE.
Lower case filenames and files without the .MAN extension are
ignored.
Within the .MAN files, lines beginning with a semicolon ';'
are not displayed, so you can use them for comments, such as
file modification details.
Manual files can be viewed from the console using <ALT+H>
followed by <M>. This browser window is only around 76
characters wide, so try to keep the lines shorter than this,
to preserve formatting. In any case, lines longer than 72
characters are bad practice, typopgraphically-speaking.
LIMITATIONS
Although most commands may be abbreviated, it is not currently
possible for the MAN command to correctly identify the
required page from an abbreviated argument. Thus "MAN IMPORT"
is acceptable, whereas "MAN IM" is not. Use wildcards if
necessary.
NOTE
Some manual pages are longer than the standard console review
buffer size, and may therefore display only the last 400 or
so lines. However they can be viewed in full via the HTTP
interface, and by using <ALT+H> followed by <M> at the
console.
SEE ALSO
HELP(4) -- General help system.
MB
MB(1) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
MB -- Make Bulletin From File.
SYNOPSIS
MB <filename> <topic> [@ distribution]
DESCRIPTION
The MB (Make Bulletin) command makes a bulletin from a text
file. Apart fron the insertion of a filename between the
command and the bulletin topic, the syntax is similar to the
SB (Send Bulletin) command.
If the filename contains no path, it is expected to be
located in the same directory as the XRouter executable.
If the file is found, the sysop is prompted to enter a
subject for the message. There is no limit on subject length
but please be aware that anything over 32 characters may
cause line-wrap on some mailboxes, or be truncated on others.
After entering the subject, the bulletin is created and
distributed in the usual way.
EXAMPLES
MB newsletter.txt KRG
MB /home/pi/forecast.txt WX @ WMIDS
AVAILABILITY
Sysop-only.
SEE ALSO
IMPORT(4) -- Import Messages Fom File.
MP(4) -- Make Personal Message From File.
SB(4) -- Send Bulletin.
MF
MF(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
MF -- Make File From Message.
SYNOPSIS
MF <msgnum> <filename>
DESCRIPTION
The MF (Message to File) command copies the specified message
to a text file, excluding the routing headers (To save with
headers use the MFH command).
It differs from EXPORT in two respects. Firstly, none of the
message "envelope" is saved, only the message "contents".
Secondly, the file mode is "write", not "append".
If the specified target file already exists, the command will
fail with an error message instead of overwriting the
existing file.
If no path is specified, the resulting file is saved in the
same directory as the XRouter executable.
EXAMPLES
MF 123 areacodes.txt
MF 456 saved/msgs/vcr.txt
AVAILABILITY
Sysop-only.
SEE ALSO
EXPORT(4) -- Export Message to File.
MFH(4) -- Make File From Message Including Headers
MFH
MFH(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
MFH -- Make File From Message With Headers.
SYNOPSIS
MFH <msgnum> <filename>
DESCRIPTION
The MFH (Message to File with Headers) command copies the
specified message to a text file, including the routing
headers (To save without headers use the MF command).
It differs from EXPORT in two respects. Firstly, none of the
message "envelope" is saved, only the message "contents".
Secondly, the file mode is "write", not "append".
If the specified target file already exists, the command will
fail with an error message instead of overwriting the
existing file.
If no path is specified, the resulting file is saved in the
same directory as the XRouter executable.
EXAMPLES
MFH 123 areacodes.txt
MFH 456 saved/msgs/vcr.txt
AVAILABILITY
Sysop-only.
SEE ALSO
EXPORT(4) -- Export Message to File.
MF(4) -- Make File From Message Excluding Headers
MINE
MINE(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
MINE -- List The Messages Sent By You.
SYNOPSIS
M[ine]
DESCRIPTION
The MINE command, which may be shortened to "M", lists all
the messages sent by you.
AVAILABILITY
The MINE command is available to all users.
SEE ALSO
KM(4) -- Kill Mine.
LM(4) -- List Mine.
MP
MP(1) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
MP -- Make Personal Message From File.
SYNOPSIS
MP <filename> <to_callsign> [@ bbs]
DESCRIPTION
The MP (Make Personal) command makes a personal message from
a text file. Apart fron the insertion of a filename between
the command and the destination callsign, the syntax is
similar to the SP (Send Personal) command.
If the filename contains no path, it is expected to be
located in the same directory as the XRouter executable.
If the file is found, the sysop is prompted to enter a
subject for the message. There is no limit on subject length
but please be aware that anything over 32 characters may
cause line-wrap on some mailboxes, or be truncated on others.
After entering the subject, the message is created and
distributed in the usual way.
EXAMPLES
MP comments.txt G8PZT
MP /home/pi/agenda.txt G4FPV @ GB7GLO
AVAILABILITY
Sysop-only.
SEE ALSO
IMPORT(4) -- Import Messages Fom File.
MB(4) -- Make Bulletin From File.
SP(4) -- Send Personal Message.
NAME
NAME(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
NAME -- Display / Change Name
SYNOPSIS
N[ame] [your_first_name]
DESCRIPTION
The NAME command, which can be abbreviated to "N" displays
or changes your first name in the WP (White Pages) database.
The WP database is a global database of mailbox users, used
primarily for making mail routing decisions.
OPTIONS
The argument is case-independent. Whatever you input, the
first character is auto-capitalised, and the remainder is
uncapitalised.
The maximum length for a name is 12 characters. The name
must not include spaces, but may include underscores or
hyphens.
If no argument is supplied, your current name is shown.
EXAMPLES
N - Display your name, as held in the WP database
N fReD - Change your name in WP database to "Fred"
AVAILABILITY
The NAME command is available to all users.
SEE ALSO
NC(4) -- Display/Change ANSI Colour Preferences.
NH(4) -- Display/Change "Home BBS".
NI(4) -- Displays User Information.
NP(4) -- Display/Change Pagination.
NQ(4) -- Display/Change QTH.
NZ(4) -- Display/ Change Zip Code.
WPAGES(9) -- The White Pages Database.
NC
NC(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
NC -- Display / Change ANSI Colour Preference.
SYNOPSIS
NC [on | off]
DESCRIPTION
The NC command displays or sets your ANSI colour preference,
i.e. whethere your mailbox sessions use colour or not.
To use colour, you will need an ANSI-compatable terminal such
as XRouter or PuTTY.
The setting is remembered for your subsequent connections.
OPTIONS
Used without an argument, the NC command displays the current
on/off state of ANSI colour.
"NC ON" turns colour on, and "NC OFF" turns it off.
AVAILABILITY
The NC command is available to all users.
SEE ALSO
NAME(4) -- Display / Change Name in White Pages Database.
NH(4) -- Display / Change Home BBS
NI(4) -- Display Summary of Your User Record
NP(4) -- Display / Change Pagination Settings
NQ(4) -- Display / Change QTH
NZ(4) -- Display / Change Zip / Locator
N-CMDS
N-CMDS(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
N-CMDS -- Commands to Display / Set Name and Other Options.
SYNOPSIS
N[ame] [first-name]
NC [on | off]
NH [home-bbs]
NI
NP [lines-per-page]
NQ [qth]
NZ [zip | locator]
DESCRIPTION
The N commands are used to display or change your name, QTH,
home BBS and other attributes, i.e. anything related to you,
in the mailbox user database.
Each of the above commands has its own MAN page.
AVAILABILITY
The N(ame) commands are available to all users
SEE ALSO
NAME(4) -- Display / Change Name in White Pages Database.
NC(4) -- Display / Change ANSI Colour Preference
NH(4) -- Display / Change Home BBS
NI(4) -- Display Summary of Your User Record
NP(4) -- Display / Change Pagination Settings
NQ(4) -- Display / Change QTH
NZ(4) -- Display / Change Zip / Locator
NH
NH(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
NH -- Display / Change Home BBS.
SYNOPSIS
NH [bbscall[.hier_address]]
DESCRIPTION
The NH command allows you to query or change your "Home BBS",
i.e. the BBS which you use the most, in the White Pages (WP)
database.
The "Home BBS" is the one to which which all other mailboxes
will route your mail, so it is important to set it correctly.
OPTIONS
Used without arguments, NH displays your current "Home BBS".
If an argument is supplied, it specifies a new Home BBS. The
argument is case-independent. If your home BBS is known to
the WP database at this mailbox, you only need to supply the
callsign, otherwise you must supply the full hierachical
address, e.g. "GB7PZT.#24.GBR.EU".
EXAMPLES
NH GB7PZT - changes your HomeBBs to GB7PZT.
NH - reports the current setting
AVAILABILITY
The NH copmmand is available to all users.
SEE ALSO
NAME(4) -- Display / Change Name in White Pages Database.
NC(4) -- Display / Change ANSI Colour Preference
NI(4) -- Display Summary of Your User Record
NP(4) -- Display / Change Pagination Settings
NQ(4) -- Display / Change QTH
NZ(4) -- Display / Change Zip / Locator
NI
NI(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
NI -- Display Summary of Your User Record
SYNOPSIS
NI
DESCRIPTION
The NI (Information) command displays your user account, i.e.
the information that the mailbox remembers about you.
The information includes, Name, QTH, Home BBS, the date and
time of your previous session, the number of times you have
connected, your colour setting, the number of messages you
have read and sent, and your pagination settings.
AVAILABILITY
The NI command is available to all users.
SEE ALSO
NAME(4) -- Display / Change Name in White Pages Database.
NC(4) -- Display / Change ANSI Colour Preference
NH(4) -- Display / Change Home BBS
NP(4) -- Display / Change Pagination Settings
NQ(4) -- Display / Change QTH
NZ(4) -- Display / Change Zip / Locator
NP
NP(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
NP -- Display / Change Pagination Settings.
SYNOPSIS
NP [lines_per_page]
DESCRIPTION
The NP (Pagination) command is used to display or adjust your
pagination settings.
OPTIONS
"NP" - by itself reports the current setting.
"NP <lines>" - changes it.
"NP 0" - disables pagination.
EXAMPLES
NP - Enquire current pagination setting
NP 18 - Set pagination to 18 lines per page
AVAILABILITY
The NP command is available to all users.
SEE ALSO
NAME(4) -- Display / Change Name in White Pages Database.
NC(4) -- Display / Change ANSI Colour Preference
NH(4) -- Display / Change Home BBS
NI(4) -- Display Summary of Your User Record
NQ(4) -- Display / Change QTH
NZ(4) -- Display / Change Zip / Locator
NQ
NQ(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
NQ -- Display / Change QTH.
SYNOPSIS
NQ [qth]
DESCRIPTION
The NQ (Qth) command displays or changes your QTH in the
White Pages (WP) database.
The maximum length for a QTH in WP is 28 characters. Spaces
are allowed.
OPTIONS
NQ by itself displays the current QTH setting.
NQ foilowed by a QTH sets the specified QTH.
EXAMPLES
NQ - Enquire your current QTH
NQ Botany Bay - Set your QTH to "Botany Bay"
AVAILABILITY
The NQ command is available to all users.
SEE ALSO
NAME(4) -- Display / Change Name in White Pages Database.
NC(4) -- Display / Change ANSI Colour Preference
NH(4) -- Display / Change Home BBS
NI(4) -- Display Summary of Your User Record
NP(4) -- Display / Change Pagination Settings
NZ(4) -- Display / Change Zip / Locator
WPAGES(9) -- White Pages System.
NZ
NZ(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
NZ -- Display / Change Zip / Locator.
SYNOPSIS
NZ [zip]
DESCRIPTION
The NZ (Zip) command displays of sets your "zip" code in the
White Pages (WP) database. In the UK we use this field for
Maidenhead Locator.
The maximum length for the zip / locator is 7 characters.
EXAMPLES
NZ - Display current zip / locator
NZ IO48TL - Set locator to IO48TL
AVAILABILITY
The NZ command is availabnle to all users.
SEE ALSO
NAME(4) -- Display / Change Name in White Pages Database.
NC(4) -- Display / Change ANSI Colour Preference
NH(4) -- Display / Change Home BBS
NI(4) -- Display Summary of Your User Record
NP(4) -- Display / Change Pagination Settings
NQ(4) -- Display / Change QTH
WPAGES(9) -- White Pages Database.
R<
R<(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
R<(4) -- Read Messages FROM Callsign.
SYNOPSIS
R< <callsign>
DESCRIPTION
The R< (Read From) reads all messages sent by a specified
callsign, i.e. with that callsign in the "From:" field.
Non-sysops may only read bulletins, and private mail
addressed to or from themselves.
OPTIONS
The argument is case-independent. Wildcards are accepted.
EXAMPLES
R< G8PZT - Read messages sent by G8PZT
R< VK* - Read messages sent by Australians
AVAILABILITY
The R< command is available to all users.
SEE ALSO
R>(4) -- Read Messages To Callsign Or Category.
R@(4) -- Read Messages AT a distribution.
READ(4) -- Read Message(s) By Number.
RH(4) -- Read Message(s) With Full Headers.
RM(4) -- Read Mine.
RN(4) -- Read New Mail.
R>
R>(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
R> -- Read Messages To Callsign Or Category.
SYNOPSIS
R> <callsign | topic>
DESCRIPTION
The R> (Read To) reads all messages with a specified callsign
or bulletin topic in the TO field.
Non-sysops can read bulletins, but can only read private mail
that was sent by themselves.
OPTIONS
The argument is case-independent. Wildcards are accepted.
EXAMPLES
R> G8PZT - Read messages from you to G8PZT
R> TECH* - read bulletins to topic TECH, TECHNI etc.
AVAILABILITY
The R> command is available to all users.
SEE ALSO
R<(4) -- Read Messages FROM Callsign.
R@(4) -- Read Messages AT a Distribution.
READ(4) -- Read Message(s) By Number.
RH(4) -- Read Message(s) With Full Headers.
RM(4) -- Read Mine.
RN(4) -- Read New Mail.
R@
R@(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
R@ -- Read Messages AT a Distribution.
SYNOPSIS
R@ <distribution>
DESCRIPTION
The R@ (Read At) command reads bulletins targetted AT a
specified distribution area.
OPTIONS
The argument is case-independent. Wildcards are accepted.
EXAMPLES
R@ GBR - Read messages with GBR distribution area
R@ EU* - Read messages with EU or EURO distribution
AVAILABILITY
The R@ command is available to all users.
SEE ALSO
R>(4) -- Read Messages To Callsign Or Category.
R<(4) -- Read Messages FROM Callsign.
READ(4) -- Read Message(s) By Number.
RH(4) -- Read Message(s) With Full Headers.
RM(4) -- Read Mine.
RN(4) -- Read New Mail.
R-CMDS
;***********************|****** Max Width *****|*********************| <code>R-CMDS(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
R-CMDS -- Commands for Reading Mail.
SYNOPSIS
R> <to>
R< <from>
R@ <at>
R[ead] <number ...>
RH <number ...>
RM
RN
DESCRIPTION
The R commands are used to read messages on the mailbox.
There are currently 7 variants, each with its own man page,
as detailed below.
AVAILABILITY
The R commands are available to all users.
SEE ALSO
R>(4) -- Read Messages To Callsign Or Category.
R<(4) -- Read Messages FROM Callsign.
R@(4) -- Read Messages AT a Distribution.
READ(4) -- Read Message(s) By Number.
RH(4) -- Read Message(s) With Full Headers.
RM(4) -- Read Mine.
RN(4) -- Read New Mail.
READ
READ(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
READ -- Read Message(s) By Number.
SYNOPSIS
R[ead] <number> [number ...]
DESCRIPTION
The READ command, which may be shortened to "R", reads one or
more messages by number, without displaying the routing
headers (use the RH command if headers are wanted).
If pagination is enabled (see NP command), the output pauses
after each pageful, giving you the options to continue or
abort reading the message.
If more than one message is being read in a single operation,
i.e. a "reading list", aborting a message witl move on to the
next message in the list.
OPTIONS
The "R[ead]" is optional - messages can be read simply by
entering the numbers alone.
EXAMPLES
READ 693 - Read message 693
R 100 147 193 - Read messages 100, 147 and 193
55 66 77 - Read messages 55, 66 and 77
AVAILABILITY
All users, but non-sysops may only read bulletins, and
private mail sent by them or to them.
SEE ALSO
NP(4) -- Display / Change Pagination Settings.
R>(4) -- Read Messages To Callsign Or Category.
R<(4) -- Read Messages FROM Callsign.
R@(4) -- Read Messages AT a Distribution.
RH(4) -- Read Message(s) With Full Headers.
RM(4) -- Read Mine.
RN(4) -- Read New Mail.
RH
RH(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
RH -- Read Message(s) With Full Headers.
SYNOPSIS
RH <msgnum> [msgnum ...]
DESCRIPTION
The RH (Read with Headers) command reads one or more
messages, displaying all the routing headers (use the R[EAD]
command to omit headers).
OPTIONS
Message numbers must be separated by spaces or tabs, not
commas.
EXAMPLES
RH 327 - Read message 327 with routing headers.
RH 55 66 77 - Read multiple messages with routing hdrs
AVAILABILITY
The RH command is available to all users, but non-sysops may
only read bulletins, and private mail sent by or to themselves.
SEE ALSO
R>(4) -- Read Messages To Callsign Or Category.
R<(4) -- Read Messages FROM Callsign.
R@(4) -- Read Messages AT a Distribution.
READ(4) -- Read Message(s) By Number.
RM(4) -- Read Mine.
RN(4) -- Read New Mail.
RM
RM(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
RM -- Read Mine.
SYNOPSIS
RM
DESCRIPTION
The RM (Read Mine) command reads all messages addressed to
you, regardless of whether on not you have read them before.
(Use the RN (Read New) command to read only the unread mail).
AVAILABILITY
All users.
SEE ALSO
R>(4) -- Read Messages To Callsign Or Category.
R<(4) -- Read Messages FROM Callsign.
R@(4) -- Read Messages AT a Distribution.
READ(4) -- Read Message(s) By Number.
RH(4) -- Read Message(s) With Full Headers.
RN(4) -- Read New Mail.
RN
RN(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
RN -- Read New Mail.
SYNOPSIS
RN
DESCRIPTION
The RN (Read New) command reads UNREAD messages addressed to
you.
Use RM (Read Mine) to read ALL messages addressed to you.
AVAILABILITY
The RN command is available to all users.
SEE ALSO
R>(4) -- Read Messages To Callsign Or Category.
R<(4) -- Read Messages FROM Callsign.
R@(4) -- Read Messages AT a Distribution.
READ(4) -- Read Message(s) By Number.
RH(4) -- Read Message(s) With Full Headers.
RM(4) -- Read Mine.
SB
SB(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
SB -- Send Bulletin.
SYNOPSIS
SB <topic> [ @ <area> ]
DESCRIPTION
The SB (Send Bulletin) command is used to send a "bulletin",
i.e. a message which can be read by anyone.
OPTIONS
The non-optional <topic> field targets the bulletin at an
intended audience, and can consist of any word, up to 6
characters maximum, e.g. ALL IBM HELP TCPIP etc. Please
use a meaningful <topic> field if possible.
The optional [ @ <area> ] bit specifies the "target area" or
"distribution area" for the bulletin. If a distribution area
is specified, the bulletin is delivered to all other
mailboxes within the specified area, otherwise the bulletin
stays on this mailbox only.
The <area> or "at" field should consist of an area code that
is known to other sysops, otherwise they won't know where to
send it. Examples are:
WMIDS - West midlands mailboxes
FOURP - Mailboxes in the Fourpak area
GBR - All mailboxes in Great Britain
EU - All mailboxes in Europe (includes GBR)
WW - All mailboxes in the world.
Please try to target your bulletin to the minimum area
necessary. A bulletin advertising your local club night
doesn't need to go worldwide!
EXAMPLES
SB KRG - Bull about local KRG club meeting
SB IBM @ WMIDS - Bull about IBM to west mids mailboxes.
SB HELP @ GBR - Ask everyone in Great Britain for help.
AVAILABILITY
The SB command is available to all users.
SEE ALSO
SP(4) -- Send Personal Message.
SR(4) -- Send Reply to a Message.
S-CMDS
S-CMDS(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
S-CMDS -- Message Sending Commands.
SYNOPSIS
S[end] Send a message to sysop.
SB <topic> Send bulletin to <topic>
SP <call> Send personal message to <call>
SR [msgnum] Send Reply to a message.
DESCRIPTION
The S (send) commands are used to send personal messages and
bulletins. Each one has its own manual page.
AVAILABILITY
The S[end] commands are available to all users.
SEE ALSO
SEND(4) -- Send Message to Sysop.
SB(4) -- Send Bulletin.
SP(4) -- Send Personal Message.
SR(4) -- Send Reply to a Message.
SEND
SEND(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
SEND -- Send Personal Message To Sysop.
SYNOPSIS
S[end]
DESCRIPTION
The SEND command, which can be abbreviated to "S", allows a
user to send a personal message to the sysop (SYstem OPerator)
of this mailbox, without needing to know any other syntax.
After issuing the command, the user is prompted to enter a
subject, then the text of the message.
AVAILABILITY
All users, but for sysops it is pointless.
SEE ALSO
SB(4) -- Send Bulletin.
SP(4) -- Send Personal Message.
SR(4) -- Send Reply to a Message.
SF
SF(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
SF -- Stop Forwarding.
SYNOPSIS
SF
DESCRIPTION
The SF command aborts any forwarding or polling run that is
currently in progress.
At the moment this does not prevent future runs.
AVAILABILITY
Sysop-only.
SEE ALSO
FF(4) -- Force Forwarding.
FP(4) -- Force Polling.
VF(4) -- View Forwarding.
SP
SP(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
SP -- Send Personal Message.
SYNOPSIS
SP <to> [ @ <at> ]
DESCRIPTION
The SP (Send Personal) command is used to send a personal
message, i.e. one which is targeted at a single individual.
OPTIONS
The <to> field must contain the recipient's callsign.
The <at> field is semi-optional, and consists of the callsign
of the recipient's "home BBS", plus other routing information
where necessary.
This mailbox contains a database of known active mail users,
called the "White Pages", or WP for short. If the recipient's
callsign is known to WP there is no need to enter the <at>
field, as the White Pages will automatically supply it.
If you enter an incomplete address, the WP attempts to extend
it into a full "Hierarchical Address (HA), but if you enter a
full address, WP assumes you know best, and does not
intervene. Therefore if you do supply a complete address,
make sure it is EXACTLY right, or your mail may get lost.
If you're sending a message to another user of this mailbox,
you needn't enter the <at> field.
If you're sending a message to a user of another mailbox, you
only need to supply an address if the WP doesn't know the
recipient.
If in doubt, use the "I <callsign>" command to check if the
recipient is in the WP database.
EXAMPLES
SP G8PZT <-- No address supplied. WP will supply it
if recipient is known to WP.
SP G8PZT @ GB7PZT <-- Partial address supplied. WP will
attempt to extend it.
SP G8PZT @ GB7PZT.#24.GBR.EU <-- Full address supplied.
WP won't intervene.
AVAILABILITY
The SP command is available to all users.
SEE ALSO
INFO(4) -- Display Info About Mailbox / Users.
SB(4) -- Send Bulletin.
SR(4) -- Send Reply.
WPAGES(9) -- White Pages Database
SR
SR(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
SR -- Send Reply to a Message.
SYNOPSIS
SR [msgnum]
DESCRIPTION
The SR (Send Reply) command is used to reply to a message.
The mailbox automatically fills in the address, and prepends
"RE:" to the original subject. The reply is always a private
message, even when replying to a bulletin.
After issuing the SR command, the user is prompted to enter
the message text in the usual way.
It is advisable wherever possible to use the "SR" command in
preference to "SP", to reduce addressing errors.
OPTIONS
The optional [msgnum] argument specifies the original message
which is being replied to.
If [msgnum] is not supplied, the reply relates to the message
most recently read by the user in the current session. In
this case it is best to use SR immediately after reading a
message, because some commands can cause the mailbox to
"forget" the last message that was read.
EXAMPLES
SR - Send reply to message you just read
SR 123 - Send a reply to message number 123
AVAILABILITY
The SR command is available to all users, but non-sysops can
only reply to bulletins, and messages addressed to themselves.
SEE ALSO
SB(4) -- Send Bulletin.
SP(4) -- Send Personal Message.
UH
UH(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
UH -- Un-hold Held Mail.
SYNOPSIS
UH <msgnum> [msgnum...]
DESCRIPTION
The UH (UnHold) command un-holds ("releases") one or more
"held" messages, and reports how many were released.
Messages may be automatically held by entries in the HOLD.SYS
and BADWORD.SYS files, or manually using the HOLD command.
"Held" messages have the status "H". They are only visible to
sysops, and are not forwarded to other mailboxes. Sysops can
list them using the LH (List Held) command, delete them using
the KH (Kill Held) command, or release them using the UH
command.
Upon release, messages are once again visible to users and
eligible for forwarding to other mailboxes.
Attempting to un-hold a non-held message has no effect.
OPTIONS
The arguments to the command are the message numbers to be
unheld. If more than one number is specified, they must be
separated by tablbs or spaces. Commas are not allowed.
AVAILABILITY
Sysop-only.
SEE ALSO
HOLD(4) -- Hold Mail.
LH(4) -- List Held Mail.
KH(4) -- Kill Held Mail.
UNREAD
UNREAD(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
UNREAD -- Mark a Message as Unread.
SYNOPSIS
U[nread] <msg>
DESCRIPTION
The UNREAD command, which may be shortened to U, "un-reads" a
message, i.e. marks it unread. You may for example do this if
a message requires a detailed reply for which you don't
currently have enough time.
By marking the mail as unread, it will once again show up in
the "new mail" list, and will be retained for longer.
EXAMPLE
UN 357 - Unread message 357
AVAILABILITY
The UNREAD command is available to all users, but non-sysops
can only unread their own mail.
SEE ALSO
LN(4) -- List New (Unread) Mail.
READ(4) -- Read Mail.
RN(4) -- Read New Mail.
VF
VF(4) XROUTER REFERENCE MANUAL 29/3/2024
COMMAND
VF -- View Forwarding.
SYNOPSIS
VF
DESCRIPTION
The VF command displays the mail waiting to be forwarded, and
which neighbour it is queued for.
AVAILABILITY
Sysop-only.
SEE ALSO
FF(4) -- Force Forwarding.
FP(4) -- Force Polling.
SF(4) -- Stop Forwarding.
packet/xrouter/docs/section4-mailboxcommands.txt · Last modified: 2025/04/22 02:31 by m0mzf