Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
module:telgate [2016/10/07 20:49] – [Telgate] campaignmodule:telgate [2021/01/24 21:49] (current) – [Telgate] new title digital man
Line 1: Line 1:
-====== 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).
  
-This allows users on your system to be connected to other TCP/Telnet services on the Internet through your BBS. Typically, these services would be other telnetable BBSs and MUDs, although really, you can gate to any single-port TCP service (i.e. POP3, but not FTP).+The module itself (''[[dir:exec]]/telgate.js'') is just a thin wrapper around the JavaScript function: ''bbs.telnet_gate()''
  
-TELNET_GATE <"str" || str_var> [mode]+===== Usage ===== 
 +To use the module:
  
-The str or str_var argument is the destination address in the format:+Execute ''telgate.js <address> [mode]''
  
- <addr>[:port]+The brackets are not part of the syntax but only used to clarify which arguments are required (''<>'') and which are optional (''[]'').
  
-If port is not specified, the default is 23 (telnet), or 513 (when the TG_RLOGIN mode is used).+When executed from a command-line with the [[server:Terminal]] Server (e.g. as a //door//), the ''?'' or ''*'' prefix is required.
  
-Examples:+If no //mode// value is specified, the default mode is ''TG_PASSTHRU''.
  
- "vert.synchro.net" +==== Address ====
- "24.0.193.46" +
- "retromud.org:3000"+
  
-The valid mode bits (multiple may be |'d together) are:+The <//address//> argument is the destination address in the format: ''<//IP address or hostname//>[://port//]''
  
- TG_ECHO         Turn on telnet echo +If the TCP //port// number is not specified, the default is 23 (standard for telnet).
- TG_CRLF         Expand sole CR to CRLF +
- TG_LINEMODE     Send entire lines only +
- TG_NODESYNC     Call Nodesync, get msgs, etc. +
- TG_CTRLKEYS     Interpret ^P ^U ^T, etc locally +
- TG_PASSTHRU     Pass-through telnet commands/responses +
- TG_RLOGIN       Use BSD RLogin protocol+
  
-This function can be called from any module or shell, but will most likely be used from the external programs menu (even though the telnet gate isn't technically an external program). The following modules are included (in your EXEC directory): TELGATE.BIN, MUDGATE.BIN, UNIXGATE.BIN, and RLOGIN.BIN. Use them as follows:+Examples <//address//> values:
  
- To set-up an external gateway to another BBS:+  * vert.synchro.net 
 +  * 24.0.193.46 
 +  * retromud.org:3000
  
- Command line: "*telgate vert.synchro.net"+==== Mode ==== 
  
- To set-up an external gateway to a MUD:+The valid mode flags (defined in ''[[dir:exec]]/[[dir:exec#load]]/sbbsdefs.js'') are:
  
- Command line: "*mudgate batmud.bat.org"+^ 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 |
  
- To set-up an external gateway to a Trade Wars Game Server (TWGS):+Multiple mode flags may be specified by ORing them together with the pipe (''|'') character, like so:
  
- Command line: "*rlogin twgs.someserver.com"+  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. 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}}
  

Trace: