User Tools

Site Tools


packet:bpq_commands

BPQ Node Commands

This is not intended to be an exhaustive guide, but includes some less well known commands and variations that are found useful.

Where letters are shown bold in a command it indicates the minimum letters of the command that are required.

The original BPQ documentation can be found at
https://www.cantab.net/users/john.wiseman/Documents/NodeCommands.html for general user commands and
https://www.cantab.net/users/john.wiseman/Documents/Node SYSOP.html for SYSOP commands.

A 'cheat sheet', printable over 5 pages is also available at https://cheatography.com/gcremerius/cheat-sheets/bpq-user-and-sysop-commands/


Common Commands

?

? displays the currently available applications on the node followed by some commonly used commands.

Sample Output

?
BMONEY:GB7BMY} BBS CHAT CONNECT BYE INFO NODES PORTS ROUTES USERS MHEARD

GB7BMY has BBS(mail) and CHAT applications available.


CONNECT

Connect allows a node user to make a connection to another node. Users can then use applications on the remote node, or make another, onwards connection.

C P Call|Alias [via digi1 [digi2...]] [S]

Example - C 1 GB7RDG via GB7BPQ S

This would instruct the node to make a connection, on port 1, via GB7BPQ, to GB7RDG, and to stay connected to the current node when disconnecting.


BYE

Bye or Quit disconnects you from your current node.


INFO

Info displays a few lines of text that can contain details of the node location, services, equipment, the SYSOP, and other sources of information about it.

info
BMONEY:GB7BMY} This is Packet Node GB7BMY located in
Ballymoney, N.Ireland. - IO65rb
HF on 40m, 9:1 Random Wire, FT-818ND, 6W
Available Services: BBS CHAT
SYSOP: GI3JMC

NODES


PORTS

Ports lists ports available for use on the node. The details can vary depending on how the SYSOP has set the port ID text in the configuration file. Hidden ports will not appear in the list.

p
BMONEY:GB7BMY} Ports
  1 HF 40m BPSK300 IL2P+CRC AX.25
  2 VHF 2m AFSK AX.25 1k2bd

ROUTES


MHEARD

MHeard lists the stations that have been heard on a port

MH P Call

Example - MH 1 - List all stations heard on port 1
Example - MH 1 GB - List all stations heard on port 1 with GB in the callsign

MHV lists stations in a table format with more detail.
MHU/MHL Lists stations with UTC/Local timestamps instead of time since last heard.

SYSOPs can replace the call filter with 'CLEAR' to erase the MHeard lists. Example - MH 1 CLEAR

Sample Output

MH 1 GB7B
BMONEY:GB7BMY} Heard List for Port 1 filtered by GB7B
GB7BPQ     00:00:21:56    
GB7BEX-15  00:00:59:42    
GB7BPQ-7   00:15:02:34     

MHU 1 GB7B
BMONEY:GB7BMY} Heard List for Port 1 filtered by GB7B
GB7BPQ     Apr 11 11:04:03    
GB7BEX-15  Apr 11 10:26:17    
GB7BPQ-7   Apr 10 20:23:25 

MHV 1 GB7B
BMONEY:GB7BMY} MHeard List GB7BMY for Port 1
Callsign   Last heard     Pkts RX    via Digi ;) 
---------  -----------    -------    ------------------------------------------
GB7BPQ     00:00:22:18    68                                       
GB7BEX-15  00:01:00:04    34                                       
GB7BPQ-7   00:15:02:56    9 

LISTEN

Listen allows a user to monitor traffic on specified ports

LIS P1 P2 P3....

Example - LIS 1 2 starts traffic monitoring for ports 1 & 2

While listening on a single port, CQ will send a beacon under the users callsign.

Entering LIS with no ports disables monitoring


USERS

Users lists all stations currently using the node.

Host is an internal (Normally BBS Port)
Circuit is a link from/to another node.
Uplink is a connection from a normal AX.25 station.
Downlink is a connection to a normal user.
←→ indicates an active session.
<~~> indicates a session being set up.


VERSION

Version returns the version number of the node software

v
BMONEY:GB7BMY} Version 6.0.24.66 (64 bit)

SYSOP Commands

PASSWORD

PASSWORD Used to obtain SYSOP status on the node. If connected locally, or via a Telnet session with the SYSOP flag set for the user, no password is required. If required

Example user without SYSOP flag using the password 'packetradio'

Connected to TelnetServer
password
BMONEY:GB7BMY} 8 6 4 7 1
password atkrp
BMONEY:GB7BMY} Ok

Each character entered for the password, corresponds to the password character at the position indicated by the number, so in the example, 1=p, 2=a, 3=c, 4=k, 5=e, 6=t, etc…

Example user connected locally or with SYSOP flag set

Connected to TelnetServer
password
BMONEY:GB7BMY} Ok

STARTPORT / STOPPORT

These commands allow for the temporary disabling of a given port.

Example - STOPPORT 2 will disable the use of port 2
Example - STARTPORT 2 will enable the use of port 2


GETPORTCTEXT

GETPORTCTEXT causes BPQ to read any files with names formatted as Port#CTEXT.txt (where # is a port number). These need to be in the same location as bpq32.cfg, or if using the Hibbian-packaged version, in /opt/oarc/bpq/.

This allows for CTEXT to be customised for each individual port. The files are read once when BPQ is started, however if the SYSOP alters the contents they can be re-read using GETPORTCTEXT. Any port that does not have a Port#CTEXT.txt file will use the node's general CTEXT or HFCTEXT instead.


TELRECONFIG

TELReconfig allows a telnet port configuration to be loaded after being altered in bpq32.cfg by the SYSOP

TELR p [USERS|ALL]

Example - TELR 9 ALL reloads the entire configuration for port 9. Any users will be disconnected.
Example - TELR 9 USERS reloads only the USER access records for port 9. No users will be disconnected.


ROUTES


NODE


SAVENODES

SAVENODES immediately saves the NODES (and ROUTES ??) table for reloading when BPQ is restarted, rather than rebuilding them.


SENDNODES

SENDNODES sends immediate nodes broadcasts on all ports that have 'MHEARD=Y' in their configuration.


SAVEMH

SAVEMH Sets the node to save and restore the MH list when being shut down/restarted.


KISS

KISS sends a KISS command/value pair. Parameters required are port, command, and value all specified in decimal

KISS 1 2 3


Port Parameters

TXDELAY, MAXFRAME, FRACK, RESPTIME, PPACLEN, RETRIES,
QUALITY, PERSIST, TXTAIL, XMITOFF, DIGIFLAG, DIGIPORT,
MAXUSERS, L3ONLY, BBSALIAS, FULLDUP, SOFTDCD

Each of the commands listed above either update or display that setting for the specified port.

Example - PACLEN 1 100 sets the default maximum packet length for port 1 Example - PERSIST 2 displays the current 'probability to retransmit' value for port 2

VALIDCALL is also available. It is not possible to update the list, but it can be displayed.

Further details of the permitted values for the parameters above can be found in the bpq32.cfg documentation available here


System Parameters

REMDUMP, OBSINIT, OBSMIN, NODESINT, L3TTL,
L4RETRIES, L4TIMEOUT, T3, NODEIDLETIME, LINKEDFLAG,
IDINTERVAL, MINQUAL, FULLCTEXT, HIDENODES, L4DELAY, L4WINDOW, BTINTERVAL

Each of the commands listed above either update or display that setting for the node.

Further details of the permitted values for the parameters above can be found in the bpq32.cfg documentation available here

packet/bpq_commands.txt · Last modified: 2025/04/14 17:08 by gi3jmc