Sysop Tools

Sysop tools is the sysop's menu inside the BBS, reached with * on a sysop's main menu (a custom menu can also have a sysop item). It works on any terminal, although watching a node needs a text terminal.

Tool	Key	What it does
watch a node	W	what a text caller is sent, as it is sent, on your screen: their menus, their door, their typing echoed. A key stops; their leaving ends it. Their screen size and character set are theirs
chat with a node	C	the caller is told you would like a word, and taken into a private chat with you at their next menu (their page's room, sysop-N); you wait there
kick a node	K	throw a caller off, after a yes
users	U	every user's level, flags and state; for one: their level, flags (+AB -C adds and takes), lock or unlock, sysop rights given or taken, a new password. Not your own lock or rights
statistics	S	totals (users, messages, mail, files; logins, posts, pages and failed logins since the start), and calls, new users, posts and uploads for each of the last 14 days, as bars
hack log and bans	H	the addresses banned now (a number lifts its ban), and L the hack log's last 100 lines
scheduled events	E	the events, when they run next and how their last run went; one's command and output, and R runs it now
configuration	F	the setup screens (blue windows and pull-down menus on ANSI terminals): the board, the system, connections, internet and online services, messengers, e-mail, networks, time, users and groups, maintenance; nothing changes until F10 saves (F9 quits), and then what may change while callers are on is put in force at once (Configuration). Shown when the BBS runs with -config
available	A	whether pages reach you; when not, a caller who pages is told you are not available and may leave you a message

Validating new users stays on the main menu (V, when some wait).

Scheduled events

; bbs.conf
; every day, at this local time
[event nodelist]
command = /usr/local/bin/get-nodelist --to "/var/lib/bbs/fido/nodelist"
at = 03:30

; every 60 minutes, for at most 300 seconds (default 600)
[event fidopoll]
command = /usr/local/bin/bbs fido poll
every = 60
timeout = 300

A scheduled event is a program the BBS runs for you, either at a time each day or every so many minutes (the first run comes that many minutes after the BBS starts). The command is a program and its arguments, separated by spaces; "..." or '...' keep spaces inside one argument. It runs without a shell, with BBS_EVENT set to the event's name, and only one event runs at a time. A run that goes past timeout is stopped.

Every run is logged. The last run's result and output (its last 4 KB) are kept for the sysop tools and the API. bbs check warns about a program it cannot find.

The API

Request	What it does
GET /api/v1/admin/events	the events, their next and last runs
POST /api/v1/admin/events/{name}/run	run one now, and wait for it
PUT /api/v1/admin/available	{"available": false}: pages reach no one
GET /api/v1/admin/bans, DELETE /api/v1/admin/bans/{ip}, GET /api/v1/admin/hacklog	bans and the hack log
POST /api/v1/admin/nodes/{n}/kick	throw a caller off

See also: Administration, Security, Chat and paging