mirror of
https://github.com/ShadowKatStudios/OC-Minitel.git
synced 2024-09-07 20:08:48 +10:00
.. | ||
OpenOS/etc/rc.d | ||
bridge.lua | ||
interminitel.lua | ||
README.md | ||
vtunnel-protocol.md |
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
Setup
Server
Requirements
- Some form of unix-like
- Lua 5.2 or 5.3
- Luasocket
Running the server
At present, all you need to do is run bridge.lua, for example:
lua53 bridge.lua [port] [timeout]
Client
OPPM
oppm install vtunnel
Manual
- Install vtunnel.lua to /etc/rc.d
- Install interminitel.lua to /usr/lib
Starting
vTunnel is invoked as follows:
rc vtunnel start <server address> <server port>
This will create a virtual linked card component connected to server_address:server_port
Minitel configuration
- Disable minitel with rc -
rc minitel disable
- Enable vtunnel with rc -
rc vtunnel enable
- Add the following to your ~/.shrc:
rc minitel start > /dev/null
This will ensure that Minitel sees the virtual tunnel component created by vTunnel and routes packets via it.