mirror of
https://github.com/ShadowKatStudios/OC-Minitel.git
synced 2024-11-23 10:38:05 +11:00
updated vtunnel documentation
This commit is contained in:
parent
11ec131ab8
commit
5c1730d9d3
@ -85,6 +85,7 @@
|
|||||||
["vtunnel"] = {
|
["vtunnel"] = {
|
||||||
files = {
|
files = {
|
||||||
["master/vTunnel/interminitel.lua"] = "/lib",
|
["master/vTunnel/interminitel.lua"] = "/lib",
|
||||||
|
["master/vTunnel/OpenOS/usr/man/vtunnel"] = "/man",
|
||||||
["master/vTunnel/OpenOS/etc/rc.d/vtunnel.lua"] = "//etc/rc.d",
|
["master/vTunnel/OpenOS/etc/rc.d/vtunnel.lua"] = "//etc/rc.d",
|
||||||
},
|
},
|
||||||
dependencies = {
|
dependencies = {
|
||||||
|
75
vTunnel/OpenOS/usr/man/vtunnel
Normal file
75
vTunnel/OpenOS/usr/man/vtunnel
Normal file
@ -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 <server address> <server port>
|
||||||
|
```
|
||||||
|
|
||||||
|
## 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.
|
@ -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 <server address> <server port>
|
|
||||||
```
|
|
||||||
|
|
||||||
## 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.
|
|
1
vTunnel/README.md
Symbolic link
1
vTunnel/README.md
Symbolic link
@ -0,0 +1 @@
|
|||||||
|
OpenOS/usr/man/vtunnel
|
Loading…
Reference in New Issue
Block a user