home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume29 / mbox / part07 / TUTORIAL < prev   
Text File  |  1992-04-06  |  11KB  |  352 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.             ix/MBox BETA-Test Version
  11.           Mailbox-Programm fuer UNIX(-Derivate)
  12.             
  13.                Volker Schuermann
  14.               Wuppertal, FRG, 08.12.1991
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.           INHALT (Tutorial Beta-Entwurf (internal use only !))
  28. =============================================================================
  29.  
  30.     1.  ALLGEMEINES
  31.  
  32.     1.1.  Public Domain ?!
  33.     1.2.  Struktur der Programme
  34.  
  35.     2.  UMGEBUNG (Voraussetzungen)
  36.  
  37.     2.1.  Fuer alle
  38.     2.2.  Speziell fuer Minix
  39.  
  40.     3.  INSTALLATION
  41.  
  42.     3.1.  Anpassungen "mbox.h"
  43.     3.2.  Anpassungen "mb-daemon.c"
  44.     3.3.  Anpassungen "/usr/lib/crontab"
  45.     3.4.  Anpassungen "/etc/passwd"
  46.     3.5.  Die Verteilung der Rechte
  47.     3.6.  Kommunikation mit RMAIL & INEWS
  48.  
  49.     4.  VERWALTUNG
  50.     
  51.     4.1.  der Teilnehmer (Bitte VOR dem ersten Aufruf der MBox lesen !)
  52.     4.2.  der Dateien
  53.  
  54.     5.  WEITERE INFOS
  55.     
  56.     5.1.  Mail genuegt
  57.     5.2.  Updates
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. 1. ALLGEMEIN
  65. =============================================================================
  66.  
  67. 1.1.  Public Domain ?!
  68. ======================
  69.  
  70. Das gesammte Programmpaket darf beliebig oft weitergegeben und eingesetzt
  71. werden. 
  72.  
  73. Es duerfen keine veraenderten Versionen verbreitet werden. Jede Veraenderung
  74. muss dem Autor als ASCII-Textfile uebermittelt werden. Er entscheidet, ob
  75. die Veraenderung in die naechste Version aufgenommen wird.
  76.  
  77. Die Routine "getch.c" stammt nicht vom Autor, sondern von "attron!chris" !
  78.  
  79.  
  80.  
  81. 1.2. Struktur der Programme
  82. ===========================
  83.  
  84. Mir ist voellig klar, 
  85.  
  86. ... dass jeder die Routinen der "ix/MBox" effizienter, 
  87. strukturierter und "besser" schreiben koennte. 
  88.  
  89. ... dass GOTOs und globale Varibalen nicht unbedingt zum
  90. Handwerkszeug eine C-Programmierers gehoehren sollten.
  91.  
  92. ... dass viele Routinen aussehen, als waeren sie schnell
  93. "ins Unreine" geschrieben worden - bei etlichen trifft das zu.
  94.  
  95. ... dass keine der Routinen einem LINT standhalten koennte.
  96.  
  97. ... dass jeder, der diese Punkte bemaengelt, selbst zu faul 
  98. war, eine MBox auf die Beine zu stellen ...
  99.  
  100.  
  101.  
  102.  
  103. 2. UMGEBUNG
  104. =============================================================================
  105.  
  106. 2.1. Fuer alle
  107. ==============
  108. Folgende Programme MUESSEN bereits auf dem Host-Rechner installiert und
  109. einsatzfaehig sein:
  110.  
  111. - UUCP (UUCICO, UUX, UUXQT, ...)  
  112.  
  113. - NEWS (RNEWS, PNEWS, EXPIRE, NNPOST, ...)
  114.  
  115. - MAIL (LMAIL)
  116.  
  117. - UMAIL (SENDMAIL, SMAIL etc.)
  118.  
  119. Die MBox setzt auf dieser Programm-Konstellation auf. Sie ist nicht ein-
  120. satzfaehig, wenn eines der Programm nicht verfuegbar ist.
  121.  
  122.  
  123.  
  124. 2.2. Speziell fuer Minix
  125. ========================
  126. Die MBox wurde entwickelt unter MINIX 1.5.10 ... folgenden Patches muessen
  127. bei dieser Version angewendet werden:
  128.  
  129. - Bruce Evans MX386-Patches
  130.  
  131. Vorteilhaft aber nicht zwingend erforderlich:
  132.  
  133. - Gordon Irlams VC (virtuelle Consolen)
  134.  
  135. - Shoelace (zum Booten von Harddisk)
  136.  
  137. Die "ix/MBox" laeuft NICHT im 64+64 Modus, sondern nur unter 386er MINIX !
  138. Wie's bei 68000er MINIX aussieht, ist bisher nicht geprueft worden.
  139.  
  140.  
  141.  
  142. 3. INSTALLATION
  143. =============================================================================
  144.  
  145. 3.1. Anpassungen ("mbox.h")
  146. ===========================
  147. Die Datei "mbox.h" enthaelt die wichtigsten system-spezifischen Parameter.
  148. Diese Parameter MUESSEN (zum Teil) unbedingt angepasst werden. 
  149.  
  150. Die einzelnen Eintraege sind in der Datei dokumentiert - Fehler bei der
  151. Anpassung ziehen WEITE Kreise ... VORSICHT ist die Mutter der Porzellankiste.
  152.  
  153. Pfade, deren Definition mit "./" beginnen, beziehen sich auf die MBox und 
  154. deren HOME-Verzeichnis. Diese Pfade muessen/sollten NICHT geandert werden.
  155.  
  156. Das gilt praktisch fuer alle Definitionen, die nicht durch ein vorangestelltes
  157. ">" kenntlich gemacht wurden.
  158.  
  159. Zusaetzlich enthalten die verschiedenen Programme jeweils eigene Parameter-
  160. Definitionen. Deren Bedeutung wird im Folgenden erklaert.
  161.  
  162.  
  163. 3.2. Anpassungen "mb-daemon.c"
  164. ==============================
  165. Der MB-Daemon kann u.A. auch als Reflektor fuer eine NewsGroup (NG) fungieren.
  166. Da er sich nicht an die Konventionen fuer Reflektoren haelt, sollte sein
  167. Einsatz auf lokal NGs beschraenkt bleiben.
  168.  
  169. REFLECT_NG        Diese NG wird vom Reflektor untersucht und beantwortet
  170. REFLECT_LOG       Hier protokolliert der Reflector seine Aktionen
  171. DIRLIST           Mit dieser Datei wird ein DIRLIST-Request beantwortet
  172. REFLECTUID        UID des Users "reflector" ... siehe "/etc/passwd"
  173.  
  174. Soll der Reflektor inaktiv bleiben, genuegt es die REFLECT_NG auf eine NG
  175. zu setzen, die nicht existiert (NICHT "", sondern z.B. "dummy.dummy".
  176.  
  177.  
  178.  
  179.  
  180. 3.3. Anpassungen "/usr/lib/crontab"
  181. ===================================
  182. Die CRONTAB muss um 2 Eintraege erweitert werden. Entscheidend ist dabei
  183. die chronologische Reihenfolge:
  184.  
  185.   0   4         *   *   *   /usr/lib/news/sendbatch -c NEWSFEED
  186.  30   5         *   *   *   /usr/lib/uucp/uucico -r1 -x2 -sNEWSFEED
  187.   0   6         *   *   *   /usr/lib/news/rnews -U
  188.  20   6         *   *   *   /usr/bin/mb-daemon
  189.  40   6         *   *   *   /usr/bin/xmd
  190.  
  191. MB-Daemon und XMD duerfen erst aktiv werden, nachdem die NEWS einsortiert
  192. sind. Wird als Mailer SMAIL verwendet, entfaellt der Aufruf des XMD.
  193.  
  194.  
  195. 3.4. Anpassung der "/etc/passwd"
  196. ================================
  197. Die PASSWD-Datei sollte um den Eintrag "gast" erweitert werden. Meldet
  198. sich dieser User an, wird direkt die "ix/MBox" gestartet.
  199. Ein Verlassen den MBox ist damit gleichbedeutend mit einem Verlassen des
  200. Systems !
  201.  
  202. gast::12:1:Mailbox-User:/usr/gast:/usr/bin/mbox
  203. volkers:X:14:3:Volker Schuermann:/usr/volkers/bin/shh
  204. reflector:*:22:3:UnNet Reflector::
  205. news:*:30:6:W-NEWS System:/usr/lib/news:
  206. usenet:*:31:6:W-NEWS Administrator:/usr/lib/news: 
  207. uucp::40:40:UUCP-Account on Un.Net:/usr/spool/uucp:
  208. postmaster:*:41:40:UUCP-Erroruser:/usr/spool/uucp:/bin/sh
  209. nuucp::42:40:Anonymous-UUCP:/usr/spool/uucppublic:/usr/lib/uucp/uucico
  210.  
  211. Die Gruppe des Users "gast" und die Gruppe der uebrigen User (z.B. "volkers")
  212. muss unterschiedlich sein (GID !)
  213.  
  214.  
  215.  
  216. 3.5. Die Verteilung der Rechte
  217. ==============================
  218. Hier nun eine Uebersicht der versch. Pfade und Programme (wobei das HOME-
  219. Verzeichnis der "ix/MBox" jetzt "/usr/mbox" genannt wird):
  220.  
  221. drwxrwxrwx  root.root /usr/mbox
  222. -r-xr-xr-x  root.root /usr/mbox/mbrsh
  223.  
  224. drwxrwx---  root.root  /usr/mbox/etc
  225. -rw-rw----  root.root  /usr/mbox/etc/*
  226. -rwxrwx---  root.root  /usr/mbox/etc/tset
  227.  
  228. drwxrwx---  root.root  /usr/mbox/lib
  229. -rw-rw-rw-  root.root  /usr/mbox/lib/*
  230.  
  231. drwx------  root.root  /usr/mbox/src
  232. -rw-r--r--  root.root  /usr/mbox/src/*
  233.  
  234. drwxrwx---  root.root  /usr/mbox/usr
  235. drwxrwx---  root.root  /usr/mbox/usr/*
  236. -rw-rw----  root.root  /usr/mbox/usr/*/*
  237.  
  238. -rwsrwsr-x  root.root  /usr/bin/mbox
  239. -rwxrwxr-x  bin.sys    /usr/bin/bled
  240. -rwxrwxr-x  root.root  /usr/bin/xmd
  241. -rwsrwsr-x  root.root  /usr/bin/mb-daemon
  242.  
  243.  
  244. 3.6. Kommunikation mit RMAIL & INEWS
  245. ====================================
  246. Mit der Version 1.6 PL4 wird eine voellig neue Struktur der Kommunikation
  247. zwischen ix/MBox und UNIX/MINIX eingefuehrt. Sowohl Mails als auch Artikel
  248. fuer NEWS werden von der MBox mit einem Header ausgestattet und an die
  249. Programme RMAIL bzw. INEWS uebergeben, die den Header komplettieren und
  250. die MSG verschicken.
  251.  
  252. Durchgefuehrt werden diese Aktion mit Hilfe von 2 (3) Shell-Scripts. Sie
  253. befinden sich in "/usr/mbox/etc/rmail.sh", "/usr/mbox/etc/inews.sh" und
  254. "/usr/mbox/etc/alias.sh". Das letzte Script wird immer dann aufgerufen,
  255. wenn ein neues Postfach angelegt wird. Es sollte dann eine Zeile an die Datei
  256. "/usr/lib/smail/aliases" (Alias-Datei von SMAIL) angehaengt werden, die
  257. SMAIL anweist den Usernamen "Vorname.Name" als Alias zu verstehen und das
  258. entsprechende Kommando ("xmd Vorname.Name") auszufuehren ...
  259.  
  260.  
  261.  
  262.  
  263. 4. VERWALTUNG
  264. =============================================================================
  265.  
  266. 4.1. Teilnehmer
  267. ===============
  268. Die "ix/MBox" benutzt den Befehl "admin" zur Pflege der Teilnehmerdaten-
  269. bank. Der Sysop/Postmaster/Administrator kann hier auf alle Eintraege
  270. zugreifen. 
  271.  
  272. Um die Sysop-Berechtigung zu bekommen, muss der Postmaster sich als "root"
  273. ins System einloggen, und dann per "mbox" die MBox aufrufen. Er erhaelt
  274. dann Userlevel 10 und ist damit berechtigt, das Kommando "admin" auszu-
  275. fuehren. Sollte das mal nicht funktionieren, kann man einfach das Level
  276. fuer "admin" in der Datei "/usr/mbox/etc/help.befehle" auf 0 setzen ...
  277.  
  278. ACHTUNG: damit hat JEDER Zugriff auf alle Teilnehmerdaten - also nach
  279. Erhoehung des eigenen Levels (auf 10) unbedingt das "admin"-Level wieder
  280. auf 9 zuruecksetzen !!!
  281.  
  282.  
  283. Nochmal ACHTUNG: Zwei User muessen unbedingt ins System eingetragen werden:
  284.  
  285. Username:   GAST (identisch mit der GUEST-Definition in "mbox.h")
  286. SH-Account: gast (siehe "/etc/passwd");
  287. User-Level: 0
  288.  
  289. Username:   Jacke wie Hose (naja...)
  290. SH-Account: root (siehe POSTMASTER-Definition in "mbox.h");
  291. User-Level: 10
  292.  
  293. Solange diese beiden User nicht ordnungsgemaess eingetragen sind, laeuft
  294. das System nicht !!!
  295.  
  296.  
  297. Wird die MBox gestartet, und die Datei UDBASE (siehe "mbox.h") existiert
  298. noch nicht, erzeugt die MBox eine Userdatenbank aus den Definitionen in
  299. "mbox.h" - diese Datenbank kann mit dem Befehl "admin" ueberarbeitet werden.
  300.  
  301. Scheint das zu aufwendig, muessen die Definitionen in "mbox.h" geaendert und
  302. die Datei UDBASE geloescht werden. Beim naechsten Start der MBox wird
  303. erneute eine Datenbank angelegt.
  304.  
  305.  
  306.  
  307. WICHTIG: Fuer Gaeste und User muss es verschiedene GIDs (GroupIDs) auf
  308. Shell-Ebene geben !!! MBox-User OHNE Shell-Account werden daran erkannt,
  309. dass ihre GID die der SH-Gaeste (z.b. "other") ist ... MBox-User MIT Shell-
  310. Account haben die GID der SH-User (z.B. "sys"). 
  311.  
  312.  
  313.  
  314. 4.2. Dateien
  315. ============
  316. Da es sich bei allen Protokoll- und Steuerdateien um ASCII-Textfiles handelt,
  317. koennen Aenderungen problemlos mit einem "normalen" Editor vorgenommen werden.
  318.  
  319. Die einzige Ausnahme bildet die Teilnehmer-Datenbank - also HAENDE WEG !!!
  320.  
  321. Soll sich die MBox mit einem "LOGO"-Text/Bild melden, muss die Datei 
  322. "./etc/logo" (s. LOGO-Definition in "mbox.h") exisitieren. Diese Datei 
  323. enthaelt einen ASCII-Text. ANSI-Bilder sollten vermieden werden, denn sie
  324. umgehen die TERMCAP-Steuerung der MBox.
  325.  
  326.  
  327. 5. WEITERE INFOS
  328. =============================================================================
  329.  
  330. 5.1. Mail genuegt
  331. =================
  332. Diese BETA-Version des TUTORIALS beantwortet natuerlich nicht alle Fragen,
  333. die bei der Installation der "ix/MBox" auftreten werden, aber bei zusaetz-
  334. lichem Studium der einzelnen Routinen (siehe auch CROSSREF), sollte sich
  335. zu fast jedem Problem auch eine Loesung finden lassen.
  336.  
  337. Wenn alles fehlschlaegt, genuegt eine MAIL an "volkers@unnet.w.open.de",
  338. um Infos und evtl. neue Routinen zu bekommen. Ausserdem wird immer dann,
  339. wenn's neue Erkenntnisse gibt, ein INFO-Rundschreiben verschickt, um 
  340. alle MBox-Betrieber mit dem aktuellen Stand der Entwicklung vertraut
  341. zu machen.
  342.  
  343.  
  344. 5.2. Updates
  345. ============
  346. Updates werden als CDIFFs fuer die Version 1.6.0 der ix/MBox verschickt,
  347. oder auf Wunsch als komplette Source-Files. Ausserdem werden von Zeit zu
  348. Zeit INFO-Runschreiben verschickt, die auf Aenderungen aufmerksam machen.
  349.  
  350.  
  351. Der Rest ist Glueckssache ... mfG Volker Schuermann
  352.