ref: b1387b2b58854f371d10d6dbcd85ac6eba802a76
parent: e51294c08d71412a8153157c8f82d36e4853f6a3
author: sl <sl@x60t>
date: Fri Aug 30 22:56:39 EDT 2024
add README, updated mkfile to generate index.md from README.
--- /dev/null
+++ b/README
@@ -1,0 +1,141 @@
+9bbs
+====
+
+citadel style bbs for plan 9, written in rc
+
+download
+--------
+
+[9bbs.tgz](http://plan9.stanleylieber.com/src/9bbs.tgz)
+
+ git/clone git://only9fans.com/sl/9bbs
+
+install
+-------
+
+9bbs is started by a [listen(8)](http://man.9front.org/8/listen)
+script that runs on an arbitrary port. The example files included
+with this distribution are setup to run on port 666, but may be
+modified to suit. The following instructions assume that a listener
+is already scanning the directory `/rc/bin/service` (true by default
+for cpu servers). In this scenario, the 9bbs script will be run as
+user `none`, which has special properties limiting its access to
+system resources. Run 9bbs as any user other than `none` at
+your own risk. WARNING: Because user `none` can only read and
+write files that are world-accessible, anyone with access to the
+file system will be able to read and write files under `etc/`.
+
+First, edit `src/tcp666` to reflect the location of the 9bbs files on
+your system, and set any desired options. Edit `etc/motd` and
+`etc/welcome` according to taste.
+
+Next, build and install the programs:
+
+ cd 9bbs/src
+ mk install
+ cd ..
+ mk log
+ mk perms # user who runs this must be a member of group none
+
+Note: 9bbs uses a modified copy of the Plan 9 pager,
+[p(1)](http://man.9front.org/1/p). It is identical in all ways to the
+original except that the `!` command for issuing shell commands has been
+removed. The resulting np binary is copied to `$objtype/bin/`, the
+tcp666 script is copied to `/rc/bin/service/`, and a log file is created
+in `/sys/log/9bbs`. All other 9bbs files remain within the 9bbs
+directory.
+
+All of that completed, 9bbs will now answer telnet connections on port
+666.
+
+Suggested: Read the source.
+
+use
+---
+
+The following commands have been implemented:
+
+ [0-9]+ print specified message
+ b back
+ B toggle biff
+ C change password
+ d [...] delete message
+ D [...] view, set message delimiter
+ >D truncate message delimiter
+ e enter message
+ E [...] view, set editor (choices: sam, simple)
+ f jump to first message
+ g [...] list rooms with unread messages, go to specified room
+ gr list ten most recently active rooms
+ grep [...] grep messages in current room for regexp
+ h, help print this help message
+ k [...] print roomlist or grep for specified regexp
+ l jump to last message
+ L [...] view, set number of lines to print before engaging pager (enter to continue, q to quit)
+ n next
+ p, re [...] print message with minimal headers
+ P [...] print message with full headers
+ r [...] reply to message
+ q quit
+ S [...] view, set signature
+ >S truncate signature
+ t print current date and time
+ u list users
+ w who is online
+ wr list ten most recently active users
+ W [...] view, set line wrap width
+ y synchronize message list for current room
+ z mark all messages (on the entire bbs) as read
+ " [...] print message in quoted form, suitable for reply
+ ? print debug information
+
+rooms
+-----
+
+A room is a directory somewhere under `rooms/` that contains at least
+one numbered message file. An example room has been included in the
+distribution: `rooms/lobby/`.
+
+To create a room:
+
+ cd 9bbs
+ ./bin/mkroom roomname
+
+Note: Rooms may be nested.
+
+messages
+---------
+
+The message format is as follows:
+
+ To: lobby
+ Date: Wed, 31 Dec 1969 19:00:01 EST
+ X-Date-N: 1
+
+ This is a placeholder message created to bootstrap the system.
+
+todo
+----
+
+• `g [room]/[n]` to print message `[n]` in `[room]`.
+
+mailing list
+------------
+
+Mainly for announcements.
+
+To subscribe:
+
+ echo subscribe | mail 9bbs-owner@stanleylieber.com
+
+After you're subscribed, messages will arrive from, and may be sent
+to, 9bbs@stanleylieber.com.
+
+To unsubscribe:
+
+ echo unsubscribe | mail 9bbs-owner@stanleylieber.com
+
+powered
+-------
+
+<http://osuny.bell-labs.co> - telnet port 666, ssh port 999
--- a/index.md
+++ /dev/null
@@ -1,141 +1,0 @@
-9bbs
-====
-
-citadel style bbs for plan 9, written in rc
-
-download
---------
-
-[9bbs.tgz](http://plan9.stanleylieber.com/src/9bbs.tgz)
-
- git/clone git://only9fans.com/sl/9bbs
-
-install
--------
-
-9bbs is started by a [listen(8)](http://man.9front.org/8/listen)
-script that runs on an arbitrary port. The example files included
-with this distribution are setup to run on port 666, but may be
-modified to suit. The following instructions assume that a listener
-is already scanning the directory `/rc/bin/service` (true by default
-for cpu servers). In this scenario, the 9bbs script will be run as
-user `none`, which has special properties limiting its access to
-system resources. Run 9bbs as any user other than `none` at
-your own risk. WARNING: Because user `none` can only read and
-write files that are world-accessible, anyone with access to the
-file system will be able to read and write files under `etc/`.
-
-First, edit `src/tcp666` to reflect the location of the 9bbs files on
-your system, and set any desired options. Edit `etc/motd` and
-`etc/welcome` according to taste.
-
-Next, build and install the programs:
-
- cd 9bbs/src
- mk install
- cd ..
- mk log
- mk perms # user who runs this must be a member of group none
-
-Note: 9bbs uses a modified copy of the Plan 9 pager,
-[p(1)](http://man.9front.org/1/p). It is identical in all ways to the
-original except that the `!` command for issuing shell commands has been
-removed. The resulting np binary is copied to `$objtype/bin/`, the
-tcp666 script is copied to `/rc/bin/service/`, and a log file is created
-in `/sys/log/9bbs`. All other 9bbs files remain within the 9bbs
-directory.
-
-All of that completed, 9bbs will now answer telnet connections on port
-666.
-
-Suggested: Read the source.
-
-use
----
-
-The following commands have been implemented:
-
- [0-9]+ print specified message
- b back
- B toggle biff
- C change password
- d [...] delete message
- D [...] view, set message delimiter
- >D truncate message delimiter
- e enter message
- E [...] view, set editor (choices: sam, simple)
- f jump to first message
- g [...] list rooms with unread messages, go to specified room
- gr list ten most recently active rooms
- grep [...] grep messages in current room for regexp
- h, help print this help message
- k [...] print roomlist or grep for specified regexp
- l jump to last message
- L [...] view, set number of lines to print before engaging pager (enter to continue, q to quit)
- n next
- p, re [...] print message with minimal headers
- P [...] print message with full headers
- r [...] reply to message
- q quit
- S [...] view, set signature
- >S truncate signature
- t print current date and time
- u list users
- w who is online
- wr list ten most recently active users
- W [...] view, set line wrap width
- y synchronize message list for current room
- z mark all messages (on the entire bbs) as read
- " [...] print message in quoted form, suitable for reply
- ? print debug information
-
-rooms
------
-
-A room is a directory somewhere under `rooms/` that contains at least
-one numbered message file. An example room has been included in the
-distribution: `rooms/lobby/`.
-
-To create a room:
-
- cd 9bbs
- ./bin/mkroom roomname
-
-Note: Rooms may be nested.
-
-messages
----------
-
-The message format is as follows:
-
- To: lobby
- Date: Wed, 31 Dec 1969 19:00:01 EST
- X-Date-N: 1
-
- This is a placeholder message created to bootstrap the system.
-
-todo
-----
-
-• `g [room]/[n]` to print message `[n]` in `[room]`.
-
-mailing list
-------------
-
-Mainly for announcements.
-
-To subscribe:
-
- echo subscribe | mail 9bbs-owner@stanleylieber.com
-
-After you're subscribed, messages will arrive from, and may be sent
-to, 9bbs@stanleylieber.com.
-
-To unsubscribe:
-
- echo unsubscribe | mail 9bbs-owner@stanleylieber.com
-
-powered
--------
-
-<http://osuny.bell-labs.co> - telnet port 666, ssh port 999
--- a/mkfile
+++ b/mkfile
@@ -14,6 +14,7 @@
}
web:V:
+ cp README index.md
if(test -f 9bbs.tgz)
rm 9bbs.tgz
cd ..