Next revision | Previous revision |
module:telgate [2010/02/24 15:53] – created digitalman | module:telgate [2021/01/24 21:49] (current) – [Telgate] new title digital man |
---|
====== Telgate ====== | ====== Telnet Gateway ====== |
FIXME | The Telnet Gateway (''telgate.js'') module allows users of your system's [[server:Terminal]] Server to connect to other TCP/Telnet services on the Internet through your BBS. Typically, these services would be other telnetable BBSes, door game servers, and MUDs, although really, you can theoretically create a gate to any single-port TCP service (e.g. POP3, but not FTP). |
| |
| The module itself (''[[dir:exec]]/telgate.js'') is just a thin wrapper around the JavaScript function: ''bbs.telnet_gate()'' |
| |
| ===== Usage ===== |
| To use the module: |
| |
| Execute ''telgate.js <address> [mode]'' |
| |
| The brackets are not part of the syntax but only used to clarify which arguments are required (''<>'') and which are optional (''[]''). |
| |
| When executed from a command-line with the [[server:Terminal]] Server (e.g. as a //door//), the ''?'' or ''*'' prefix is required. |
| |
| If no //mode// value is specified, the default mode is ''TG_PASSTHRU''. |
| |
| ==== Address ==== |
| |
| The <//address//> argument is the destination address in the format: ''<//IP address or hostname//>[://port//]'' |
| |
| If the TCP //port// number is not specified, the default is 23 (standard for telnet). |
| |
| Examples <//address//> values: |
| |
| * vert.synchro.net |
| * 24.0.193.46 |
| * retromud.org:3000 |
| |
| ==== Mode ==== |
| |
| The valid mode flags (defined in ''[[dir:exec]]/[[dir:exec#load]]/sbbsdefs.js'') are: |
| |
| ^ Flag ^ Description ^ |
| | ''TG_ECHO'' | Turn on telnet echo | |
| | ''TG_CRLF'' | Expand sole CR to CRLF | |
| | ''TG_LINEMODE'' | Send entire lines only | |
| | ''TG_NODESYNC'' | Call Nodesync, get msgs, etc. | |
| | ''TG_CTRLKEYS'' | Interpret control key (e.g. Ctrl-P, Ctrl-U, Ctrl-T, etc.) locally | |
| | ''TG_PASSTHRU'' | Pass-through telnet commands/responses | |
| | ''TG_RLOGIN'' | Use BSD RLogin protocol (not Telnet) | |
| | ''TG_NOCHKTIME'' | Don't check time left online | |
| | ''TG_NOTERMTYPE'' | Request client "DONT TERM_TYPE" | |
| | ''TG_NOLF'' | Do not send line-feeds | |
| | ''TG_RLOGINSWAP'' | Swap the RLogin alias/real-names | |
| |
| Multiple mode flags may be specified by ORing them together with the pipe (''|'') character, like so: |
| |
| TG_PASTHRU|TG_ECHO|TG_CRLF |
| |
| ==== Others ==== |
| |
| Although ''telgate.js'' is the original and most flexible Synchronet Telnet gateway script, there are other ''bbs.telnet_gate()'' wrapper scripts available for your convenience: |
| |
| ^ Module ^ Description ^ |
| | ''mudgate.js'' | Sets the mode flags based on the needs of a typical MUD server | |
| | ''unixgate.js'' | Sets the mode flags based on the needs of a typical Unix Telnet server | |
| | ''rlogin.js'' | Actually a wrapper around the ''bbs.rlogin_gate'' JavaScript function | |
| |
| ==== Examples==== |
| |
| To set-up an external gateway to another BBS in [[util:SCFG]]->External Programs->Online Programs: |
| |
| Command line: "?telgate vert.synchro.net" |
| |
| To set-up an external gateway to a MUD: |
| |
| Command line: "?mudgate batmud.bat.org" |
| |
| To set-up an external gateway to a Trade Wars Game Server (TWGS): |
| |
| Command line: "?rlogin twgs.someserver.com" |
| |
| While using the telnet gateway (and not currently in telnet "Binary" mode), users can press ctrl-] for a menu of telnet gate commands including: Disconnect, Toggle Echo, List Users, and Private Message. |
| |
| ==== Legacy ==== |
| |
| The Baja ''TELNET_GATE'' function and the corresponding ''[[dir:exec]]/*gate.bin'' files have been deprecated. Use the corresponding JavaScript alternatives instead. |
===== See Also ===== | ===== See Also ===== |
* [[:module:|module index]] | * [[:module:|Modules]] |
| * [[:module:RLogin]] |
| |
| {{tag>JavaScript}} |
| |