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

Next revision
Previous revision
Next revisionBoth sides next revision
module:rlogin [2010/02/24 15:52] – created digitalmanmodule:rlogin [2018/07/18 18:10] – [See Also] Added link to Telgate module digital man
Line 1: Line 1:
-====== Rlogin ====== +====== RLogin ====== 
-FIXME+The Synchronet RLogin module (''[[dir:exec]]/rlogin.js'') is used to create an outbound proxy gateway connection between a Synchronet [[server:Terminal]] Server user and a remote server using the BSD Rlogin protocol ([[RFC>1282]]) over TCP (traditionally, TCP port 513).  The BBS user can be connected to the host BBS using any supported terminal protocol (Telnet, RLogin, or SSH). 
 + 
 +RLogin is often used to connect BBS users to "door game servers" because of the protocol's ability to transparently pass the login-ID of the user as part of the initial connection establishment. If the door game server recognizes the user's credentials, it can automatically authenticate the user and in some cases immediately launch a specific door game of interest. 
 + 
 +===== Telgate ===== 
 + 
 +The RLogin module is just a thin script that calls the Synchronet JavaScript ''bbs.rlogin_gate'' method which in turn is just a thin wrapper function around the Synchronet C++ ''telnet_gate'' function. Although this function was originally created for creating proxy gateways using the Telnet protocol, it was later enhanced to also support the RLogin protocol, but was not renamed. So the internal Telnet Gateway (telgate) functionality is utilized to create RLogin gateway connections as well. 
 + 
 +===== Menu ===== 
 + 
 +While the gateway is connected, the BBS user can use the ''Ctrl-]'' key sequence to display a host-BBS menu to perform specific functions, like: 
 +  * Disconnect 
 +  * Toggle local echo off/on 
 +  * List users on the host BBS 
 +  * Send a private message to another user on the host BBS 
 + 
 +===== Usage =====  
 +The RLogin module is normally executed via a command-line configured [[util:SCFG]], often as an "External Program". By convention, JavaScript modules are executed by prefixing the module name with a question mark (''?'') symbol. An asterisk (''*'') prefix will also work, but will fall back to execute the old ''[[dir:exec]]/rlogin.bin'' if the ''rlogin.js'' is missing. 
 + 
 +==== Command-line ==== 
 +The RLogin module accepts command-line arguments to control its behavior when invoked. The command-line syntax is: 
 +  ?rlogin <address>[:port] [flags] 
 + 
 +Where: 
 +  * ''<address>'' is the IP address or hostname to connect to 
 +  * ''[:port]'' is the TCP port number to connect to (default is 513) 
 +  * ''[flags]'' is an optional set of one or more Telnet Gateway (TG_*) flags separated by pipe (''|'') symbols 
 +  
 +===== Connection ===== 
 +The RLogin protocol allows the client to pass 3 strings to the server during connection establishment. These 3 strings defined by the protocol specification, in order: 
 +  - client-user-name 
 +  - server-user-name 
 +  - terminal-type 
 + 
 +By default, the Synchronet telnet gateway sends the following values for the RLogin connection strings: 
 +  - User's alias 
 +  - User's real name 
 +  - Users' terminal type/speed (e.g. "ANSI/30000"
 + 
 +If you wish to reverse the order of the first 2 strings sent, pass the ''TG_RLOGINSWAP'' flag on the ''rlogin.js'' command-line. 
 + 
 ===== See Also ===== ===== See Also =====
-  * [[:module:|module index]]+  * [[:module:|Module Index]] 
 +  * [[:module:Telgate|Telgate Module]]