* Wrote the "citlogin" wrapper, so Citadel client can run directly without

  having to login as bbs first.

diff --git a/citadel/ChangeLog b/citadel/ChangeLog
index 69f3973968460e009b30139e1f5af717a245ce6b..8ee274f9b99214aeccb03cdc3456dcea2f9ce576 100644 (file)
--- a/citadel/ChangeLog
+++ b/citadel/ChangeLog
@@ -1,4 +1,8 @@
  $Log$
+ Revision 573.96  2001/02/21 05:44:44  ajc
+ * Wrote the "citlogin" wrapper, so Citadel client can run directly without
+   having to login as bbs first.
+
  Revision 573.95  2001/02/21 05:15:41  ajc
  * Repaired buggy "ALL" macro in IMAP FETCH.
 
@@ -2427,3 +2431,4 @@ Sat Jul 11 00:20:48 EDT 1998 Nathan Bryant <bryant@cs.usm.maine.edu>
 
 Fri Jul 10 1998 Art Cancro <ajc@uncensored.citadel.org>
        * Initial CVS import 
+

diff --git a/citadel/docs/install.txt b/citadel/docs/install.txt
index 2fb8852fc2340db3ca3e56f8ca0019a3f6716890..11db7421e9b2e6a1ab653f0124bdfd74a241ad45 100644 (file)
--- a/citadel/docs/install.txt
+++ b/citadel/docs/install.txt
@@ -93,8 +93,41 @@ in the Makefile).  If such an account needs to be accessed remotely (such as
 from client software), these users can use *either* their Citadel login name
 or their login name on the host computer, and their password on the host
 computer.
-   
+ 
+ 
+ BYPASSING THE login: PROMPT
+ 
+ If you normally log in to your host system using some method other than
+telnet (such as ssh), you might want the telnet service to go straight to
+the Citadel BBS, instead of displaying the "login:" prompt first.  You can
+do this using the "citlogin" wrapper program.
+ 
+ Simply specify "citlogin" as the login program to your telnetd.  For example,
+you might configure your /etc/inetd.conf like this:
+ 
+ telnet stream tcp nowait root /usr/sbin/tcpd in.telnetd -L /usr/local/citadel/citlogin
+ 
+ Why does the wrapper program exist?  Why not just go directly to the client?
+There are several reasons:
+ 1. If you just execute the client directly from inetd, your terminal
+emulation will be really crappy.  telnetd handles this for you.
+ 2. If you specify the citadel client as your login program (-L), it will
+usually be passed a bunch of command-line arguments that confuse it.  Also,
+it'll be running as root, which is bad.
+ 3. If you try to solve the root problem by specifying some other username
+to inetd, you'll run into problems when that user can't correctly set the
+permissions of the allocated pseudotty.
+ 
+ Here's what the wrapper does:
+ 
+ 1. Locate your Citadel installation (by loading its config file)
+ 2. Drop root privileges.  Change the user id to your BBS user.
+ 3. Execute the Citadel client.
+ 
+ Please make sure you know what you're doing before you install this!
   
+     
+   
  COMPILING THE PROGRAMS