From 5c1730d9d35aedbb756fd676ed982b0862c2be8d Mon Sep 17 00:00:00 2001 From: XeonSquared Date: Thu, 19 Dec 2019 20:47:01 +1100 Subject: [PATCH] updated vtunnel documentation --- programs.cfg | 1 + vTunnel/OpenOS/usr/man/vtunnel | 75 +++++++++++++++++++++++++++++++++ vTunnel/README.md | 76 +--------------------------------- 3 files changed, 77 insertions(+), 75 deletions(-) create mode 100644 vTunnel/OpenOS/usr/man/vtunnel mode change 100644 => 120000 vTunnel/README.md diff --git a/programs.cfg b/programs.cfg index 21e55b2..03c1ad6 100644 --- a/programs.cfg +++ b/programs.cfg @@ -85,6 +85,7 @@ ["vtunnel"] = { files = { ["master/vTunnel/interminitel.lua"] = "/lib", + ["master/vTunnel/OpenOS/usr/man/vtunnel"] = "/man", ["master/vTunnel/OpenOS/etc/rc.d/vtunnel.lua"] = "//etc/rc.d", }, dependencies = { diff --git a/vTunnel/OpenOS/usr/man/vtunnel b/vTunnel/OpenOS/usr/man/vtunnel new file mode 100644 index 0000000..2753012 --- /dev/null +++ b/vTunnel/OpenOS/usr/man/vtunnel @@ -0,0 +1,75 @@ +# vTunnel - TCP-based Linked Card Emulator + +vTunnel can be used to add bridging over the internet to any existing OpenOS software that uses linked cards. + +Despite originally being written for Minitel, vTunnel implements a fully-functional linked card emulator and a server that will run under most unix-likes (OpenBSD is currently somewhat flaky, Linux is recommended). + +The protocol is documented [here](vtunnel-protocol.md) + +## Setup + +### Server Requirements + +- Some form of unix-like +- Lua 5.2 or 5.3 +- Luasocket + +### Client Installation + +#### OPPM + +``` +oppm install vtunnel +``` + +#### Manual + +1. Install vtunnel.lua to /etc/rc.d +2. Install interminitel.lua to /usr/lib + +### Client setup + +#### Creating a connection +Many connections can be configured. To add one: + +``` +rc vtunnel addpeer +``` + +## Usage + +### Running the server + +At present, all you need to do is run bridge.lua, for example: + +``` +lua53 bridge.lua [port] [timeout] +``` + +### Client + +vTunnel is invoked as follows: + +``` +rc vtunnel start +``` + +vTunnel can also be configured to start automatically: + +``` +rc vtunnel enable +``` + +There are several other commands available under `rc vtunnel`: + + - settimer - allows you to configure how often vTunnel polls the TCP socket + - listpeers - shows which peers are configured, and the associated tunnel card addresses + - delpeer - deletes a peer from the configuration, as shown in listpeers + +### Minitel configuration + +1. Disable minitel with rc - `rc minitel disable` +2. Enable vtunnel with rc - `rc vtunnel enable` +3. Enable minitel with rc - `rc minitel enable` + +This will ensure that Minitel starts later than vTunnel, allowing it to see the virtual tunnel component. diff --git a/vTunnel/README.md b/vTunnel/README.md deleted file mode 100644 index 2753012..0000000 --- a/vTunnel/README.md +++ /dev/null @@ -1,75 +0,0 @@ -# vTunnel - TCP-based Linked Card Emulator - -vTunnel can be used to add bridging over the internet to any existing OpenOS software that uses linked cards. - -Despite originally being written for Minitel, vTunnel implements a fully-functional linked card emulator and a server that will run under most unix-likes (OpenBSD is currently somewhat flaky, Linux is recommended). - -The protocol is documented [here](vtunnel-protocol.md) - -## Setup - -### Server Requirements - -- Some form of unix-like -- Lua 5.2 or 5.3 -- Luasocket - -### Client Installation - -#### OPPM - -``` -oppm install vtunnel -``` - -#### Manual - -1. Install vtunnel.lua to /etc/rc.d -2. Install interminitel.lua to /usr/lib - -### Client setup - -#### Creating a connection -Many connections can be configured. To add one: - -``` -rc vtunnel addpeer -``` - -## Usage - -### Running the server - -At present, all you need to do is run bridge.lua, for example: - -``` -lua53 bridge.lua [port] [timeout] -``` - -### Client - -vTunnel is invoked as follows: - -``` -rc vtunnel start -``` - -vTunnel can also be configured to start automatically: - -``` -rc vtunnel enable -``` - -There are several other commands available under `rc vtunnel`: - - - settimer - allows you to configure how often vTunnel polls the TCP socket - - listpeers - shows which peers are configured, and the associated tunnel card addresses - - delpeer - deletes a peer from the configuration, as shown in listpeers - -### Minitel configuration - -1. Disable minitel with rc - `rc minitel disable` -2. Enable vtunnel with rc - `rc vtunnel enable` -3. Enable minitel with rc - `rc minitel enable` - -This will ensure that Minitel starts later than vTunnel, allowing it to see the virtual tunnel component. diff --git a/vTunnel/README.md b/vTunnel/README.md new file mode 120000 index 0000000..4f9e916 --- /dev/null +++ b/vTunnel/README.md @@ -0,0 +1 @@ +OpenOS/usr/man/vtunnel \ No newline at end of file