Initial revision

git-svn-id: http://opensvn.csie.org/pttbbs/pttbbs/trunk/pttbbs@1 63ad8ddf-47c3-0310-b6dd-a9e9d9715204

4 files changed, 294 insertions, 0 deletions

diff --git a/docs/ANCESTOR b/docs/ANCESTOR
new file mode 100644
index 00000000..269e7cea
--- /dev/null
+++ b/docs/ANCESTOR
@@ -0,0 +1,23 @@
+Pirate Bulletin Board System		Version: 1.00
+Copyright (C) 1990			Edward A. Luke
+
+Eagles Bulletin Board System		Version: 2.00-3.00
+Copyright (C) 1992, 1993, 1994		Raymond R. Rocker, Dominic B. Tynes
+					Guy T. Vega
+
+Phoenix Bulletin Board System		Version: 3.00-4.0
+Copyright (C) 1993, 1994		Ming-Feng Chen, Ji-Tzay Yang
+					Tsun-Yi Wen 
+
+¯µ±K±¡¤H¸ê°T¯¸				Version: 3.1-4.0
+Copyright (C) 1994			²ÅãŲ, ¼B¨Î®p
+
+MapleBridge Bulletin Board System	Version: 2.36
+Copyright (C) 1994-1995			Jeng-Hermes Lin, Hung-Pin Chen 
+					SoC, Xshadow
+
+SunOfBeach Bulletin Board System        Version: 0.22
+Copyleft  ($) 1996                      Kaede, woju
+
+Ptt Bulletin Board System		Ptt, Jaky, Action, Heat, Dunk
+§å½ð½ð¹ê·~§{				CharlieL, DickG, DavidYu
diff --git a/docs/CHANGE b/docs/CHANGE
new file mode 100644
index 00000000..2ddb6869
--- /dev/null
+++ b/docs/CHANGE
@@ -0,0 +1,76 @@
+Version 1.0.2	2001/07/17
+
+* ·s¼W util/merge_passwd
+* ·s¼W util/merge_board
+* ­×¥¿ load fromcache ¶W¹L 300 ¦æ·| segfault ªº bug
+* ­×¥¿¨Ó·½¦r¦ê¦b FreeBSD ¤U·|¦³¶Ã½Xªº°ÝÃD
+* ­×¥¿ mbbsd ¤¤ select() ¤£¦nªº¥Îªk
+* ­×¥¿ more.c ¤¤ªº¦w¥þ°ÝÃD (by kcwu)
+
+--------------------------------------------------
+Version 1.0.1	2001/04/26
+
+* ±N¤å¥ó·h¦Ü docs ¥Ø¿ý¤U
+* ­×§ï config.h ¤¤ªº MAX_ACTIVE, MAX_CPULOAD
+  ¨Ã¥[¤J FORCE_PROCESS_REGISTER_FORM ªº¿ï¶µ
+* ·s¼W­×´_¿ò¥¢¬ÝªOªº¥\¯à (press 'R')
+* ­×¥¿°T®§ªº¿ù»~
+* ­×¥¿«ÕÆF¤ô²y
+* ²¾°£¦b¨Ï¥ÎªÌ¦W³æ«ö'N'­×§ï¼ÊºÙªº¥\¯à, ¸Ó¥\¯à¥i¯à¦³bug¦s¦b
+* ·s¼W util/shmsweep
+
+--------------------------------------------------
+Version 1.0.0	2000/09/16
+
+* ­×¥¿ Select ¬ÝªOªº bug
+* ·s¼W Reaper, §R°£¹L´Á±b¸¹
+* ·s¼W chickens ¨ì sample ¤¤
+* ·s¼W initbbs ªº¥\¯à: ªì©l¤Æ°ÊºA¬ÝªO, ½d¥»ºëÆF
+* ·s¼W FAQ
+
+--------------------------------------------------
+Version 0.9.7	2000/08/31
+
+* ·s¼W tunepasswd
+* ­×¥¿ innbbsd ªº bug
+* xchatd ¹B§@¥¿±`
+* ¾ã¦X buildir
+* ­×¥¿ Makefile ¦b¬Y¨Ç Linux ¤WµLªk¥¿±`¤u§@ªº bug
+* ¦b sample ªº¥Ø¿ý¤U¥´ make install §Y¥i¦Û°Ê¦w¸Ë sample ³]©wÀÉ
+
+--------------------------------------------------
+Version 0.9.6	2000/06/28
+
+* ­×¥¿¨Ï¥Î¼È¦sÀÉ·|·í±¼ªº bug
+* ¾ã¦X FreeBSD ©M Linux ªº Makefile, ¤£»Ý­n¦A¤â°Ê­×§ï
+* §â pttbbs.conf ±q include ·h¨ì pttsrc ¤U
+* ·s¼W outmail ¨ú¥N bmda
+* ¾ã¦X xchatd  (¥¼´ú¸Õ)
+* ¾ã¦X innbbsd (¥¼´ú¸Õ)
+
+--------------------------------------------------
+Version 0.9.5	2000/06/07
+
+* ­×¥¿¦b Linux µLªk talk ªº bug
+* ¦pªG¬ÝªO¦Cªí¬OªÅªºªº¸Ü, ¦Û°Ê¶i¤J¶}ªO¥\¯à
+* ·s¼W initbbs ¤u¨ãµ{¦¡
+* ·s¼W BBSHOME environment variable ªº¨Ï¥Î (¨£ INSTALL)
+* ·h²¾³¡¥÷³]©w¨ì include/pttbbs.conf
+* ­×¥¿¦bFreeBSD¤WµLªk¨ú±o swapinfo ªº bug
+
+--------------------------------------------------
+Version 0.9.4	2000/06/03
+
+* §âµ{¦¡¤¤¦³¥Î¨ì ncurses ªº¦a¤è²¾°£, ¤£¦A»Ý­n -ltermcap, -lncurses
+* ­×¥¿¤@­Ó³y¦¨µL½a°j°éªº Bug
+* ²¾°£¥H¨Ï¥ÎªÌ¦WºÙ·j´M¥þ¯¸¤å³¹ªº¥\¯à
+
+--------------------------------------------------
+Version 0.9.3	2000/05/23
+
+* ­×¥¿¦b Linux ¤W Makefile ªº°ÝÃD
+
+--------------------------------------------------
+Version 0.9.2	2000/05/20
+
+* port ¨ì Linux ¤W
diff --git a/docs/FAQ b/docs/FAQ
new file mode 100644
index 00000000..bc2904a0
--- /dev/null
+++ b/docs/FAQ
@@ -0,0 +1,146 @@
+ §@ªÌ  DavidYu (^^Y)                                        ¬ÝªO  PttSrc
+ ¼ÐÃD  Re: ¦w¸Ë§¹³s½u®É.....
+ ®É¶¡  Thu May 18 15:08:04 2000
+¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w
+
+¡° ¤Þ­z¡mJamesCheng (ºô²y¤ñ±Æ²y¦nª±°Õ¡I)¡n¤§»Ê¨¥¡G
+: §Ú¦b¦w¸Ë§¹¤§«á ¥Îroot°õ¦æ mbbsd 23
+: ³s½u¬Ý¥X²{
+: Escape character is '^]'.
+: ¡iª«ªv¼Ö¶é¡j¡· ª«ªv²Ä¤G¯¸ ¡·(pt.mc.ntu.edu.tw)
+:   ½Õ´T(140.112.122.44)  ¨t²Î­t²ü  0.00 0.01 0.00
+: Connection closed by foreign host.
+: µM«á¨t²Î¥X²{¤U¦C°T®§
+: [shmget error] key = 8ab
+: errno = 12: Cannot allocate memory
+: ³o¬O¦ó­ì¦]©O¡H
+shared memory­n¥[¤j
+¦bkernel config file¤¤¥[¤@¦æ
+options         SHMMAXPGS=4100
+­«·smake kernel
+
+--
+¡° µo«H¯¸: §å½ð½ð¹ê·~§{(ptt.twbbs.org)
+¡» From: oio.m6.ntu.edu.t
+
+ §@ªÌ  DavidYu (Do it YOURSELF!)                            ¬ÝªO  PttSrc
+ ¼ÐÃD  Re: ½Ð°Ý¤@¤U...
+ ®É¶¡  Sat May 27 18:41:39 2000
+¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w
+
+¡° ¤Þ­z¡mclifflu ( ·Ð§r·Ð§r·Ð~~~)¡n¤§»Ê¨¥¡G
+: ¡° ¤Þ­z¡mhscat (´_¯¸¤F¡I)¡n¤§»Ê¨¥¡G
+: :         ¤£¹L§Ú¦³¤@­Ó¤p¤pªº°ÝÃD
+: :         ¯à¤£¯à«ü¾É¤@¤U...·Q­n¶}·sªºª©À³¸Ó±q­þÃä¶}©O¡H
+: ¥D¿ï³æ¤Uªº (0)Admin ??
+: :         ¦]¬°§Ú¹ê¦b§ä¤£¨ì«ç»ò¶}·s¬ÝªO...:~~~~...
+¤£¤£¤£..
+¶}ªO­n±q¤ÀÃþ¬ÝªOªº¦a¤è¶},³o³¡¥÷¦³ÂI¤p¤pªº½ÆÂø,
+©M¥H©¹ªºª©¥»¤£¤@¼Ë,§Ú¨Ó²³æ»¡©ú¤@¤U:
+
+­º¥ý¤¶²Ð¬ÝªO.
+¬ÝªO¦³¨âºØ, ¤@¯ë¬ÝªO©M¸s²Õ¬ÝªO. ¦pªG¥ÎÀɮרt²Îªº¬[ºc¨Ó¬Ýªº¸Ü,
+¤@¯ë¬ÝªO¦p¦P file, ¦Ó¸s²Õ¬ÝªO´N¬O directory
+(¦b©Ò¦³¬ÝªO¦Cªíªº¦a¤è¥u·|¥X²{¤@¯ë¬ÝªO)
+
+¤@­Ó¬ÝªO¦³UID¤ÎGID³o¨â­ÓÄÝ©Ê. UID¬Ouniqueªº,±q1¶}©l¤À°t,¨t²Î¦b¶}ªO®É·|¦
+Û°Êallocate¤@­Ó. ¦ÓGID¬O«ü©w³o­Ó¬ÝªO¦b­þ¤@­Ó¸s²Õ¬ÝªO¤§¤U(¬ÝªO¬O¾ðª¬¬[ºcªº)
+©Ò¥H¦pªG¦³¤@­Ó¸s²Õ¬ÝªOªºUID¬Ox, «hGID¬°xªº¬ÝªO³£·|Â\¦b¸Ó¸s²Õ¬ÝªO¤§¤U
+¦Ó¦pªG¬ÝªOGID¬°0(«O¯dªºUID)ªº¸Ü,¸Ó¬ÝªO´N·|¥X²{¦b¤@¶}©l±q¥D¿ï³æ¶iCLASSªº
+¨º­Ó¦a¤è
+
+¦Ü©ó¶}ªOªº¤èªk.
+­º¥ý±qCLASS¶i¨ì§A·Q­n¶}·sªOªºÃþ§O¤U,µM«á«ö¤jB³]©w
+¦p¦¹·s¶}ªºªO´N·|¦Û°Êassign GID ¨ì¨º­ÓÃþ§O¤U
+
+¦pªG­n¯ë°Ê¤@­Ó¤w¸g¶}¦nªºªO¨ì¨ä¥LÃþ§Oªº¸Ü
+¥ý§ä¥X¨º­ÓÃþ§O(¸s²Õ¬ÝªO)ªºUID, «ö¤jE¥i¥H¬Ý¨ì
+µM«á§â­n·h°ÊªºªOªºGID³]¦¨¨º­ÓUID¤Î¥i
+
+­È±oª`·Nªº¬O, ¦pªG§â¬Y­Ó¨Ï¥ÎªÌ³]¦¨¬Y¸s²Õ¬ÝªOªºªO¥Dªº¸Ü
+«h·í¥L±qCLASS¶i¨ì¨º­Ó¸s²Õ®É·|Àò±o¤p²ÕªøªºÅv­­(¥i¥H¶}ªO,³]©w¬ÝªOµ¥µ¥)
+­n¯S§O¤p¤ß
+
+¤ñ¸û³Â·Ðªº¦a¤è:
+¤@­Ó·s¶}ªº¸s²Õ¸Ì­±¨Ã¨S¦³¥ô¦ó¬ÝªO,©Ò¥HµLªk±q¿ï³æ¶i¥h¸Ì­±¶}ªO
+³o®É­Ô´N»Ý­n¦b¥i¶}ªOªº¦a¤è¥ý¶}­ÓªO,µM«á¦A§â¨º­ÓªOªºGID³]¹L¥h§Y¥i
+(³o¤]¬O¬°¤°»ò»Ý­n¤@­Óinitialªº.BOARDSªº­ì¦] :p)
+
+--
+¡° µo«H¯¸: §å½ð½ð¹ê·~§{(ptt.twbbs.org)
+¡» From: meow.cc.ntu.edu.
+
+ §@ªÌ  DavidYu (ÜI~~~~~~~~~~)                               ¬ÝªO  PttSrc
+ ¼ÐÃD  sendmail.cf­n§ïªº¦a¤è(°Ñ¦Ò¥Î)
+ ®É¶¡  Sun Jul  9 09:39:53 2000
+¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w
+
+¦³ÃC¦âªº¬O­n¥[¤W¥hªº
+­nª`·N,tab©Mspace¤£¯à²V¥Î
+
+######################################
+###   Ruleset 0 -- Parse Address   ###
+######################################
+S0
+
+R$*                     $: $>Parse0 $1          initial parsing
+R<@>                    $#local $: <@>          special case error msgs
+R$*                     $: $>98 $1              handle local hacks
+R$+.bbs < @ $=w .>      $#bbsmail $: $1         bbs mail gateway
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+R$*                     $: $>Parse1 $1          final parsing
+
+......
+
+# handle locally delivered names
+R$+.bbs                 $#bbsmail $:$1                  bbs mail gateway
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+R$=L                    $#local $: @ $1                 special local names
+R$+                     $#local $: $1                   regular local names
+
+###########################################################################
+###   Ruleset 5 -- special rewriting after aliases have been expanded   ###
+###########################################################################
+
+......
+
+##################################################
+###   Local and Program Mailer specification   ###
+##################################################
+
+#####  @(#)local.m4     8.30 (Berkeley) 6/30/1998  #####
+
+Mlocal,         P=/usr/libexec/mail.local, F=lsDFMAw5:/|@qSXfmnz9P, S=10/30, R= 
+                T=DNS/RFC822/X-Unix,
+                A=mail.local -l
+Mprog,          P=/bin/sh, F=lsDFMoqeu9, S=10/30, R=20/40, D=$z:/,
+                T=X-Unix,
+                A=sh -c $u
+Mbbsmail,       P=/home/bbs/bin/bbsmail, F=lsSDFMhPu, U=bbs, S=10,R=20/40,
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+                A=bbsmail $u
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+--
+¡° µo«H¯¸: §å½ð½ð¹ê·~§{(ptt.twbbs.org)
+¡» From: oio.m6.ntu.edu.t
+
+ §@ªÌ  DavidYu (ï~~~~~~~~~~~~~~~)                           ¬ÝªO  PttSrc
+ ¼ÐÃD  [anno] tunepasswd
+ ®É¶¡  Sat Jul 29 09:18:06 2000
+¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w¢w
+
+·s¼W¤F¤@­Ó tunepasswd ªºµ{¦¡
+
+¦pªG§A¦b .PASSWD «Ø¥ß«á¤S§ï¹L¤F MAX_USERS
+
+§A¥²¶·­n°õ¦æ tunepasswd ¤@¦¸¨Ó­×§ï .PASSWD Àɪº¤j¤p
+
+°õ¦æªº®É­Ô¤£¥i¥H¦³¥ô¦óBBSªºµ{¦¡¦b°õ¦æ
+
+shared memory ¤]À³¸Ó­n²M°£, §_«h·|¦³¤£¹w´Áªº¿ù»~µo¥Í
+
+°õ¦æ tunepasswd ·|²£¥Í¤@­Ó­ì¨Óªº³Æ¥÷ÀÉ .PASSWD~
+
+--
+¡° µo«H¯¸: §å½ð½ð¹ê·~§{(ptt.twbbs.org)
+¡» From: oio.m6.ntu.edu.t   
diff --git a/docs/INSTALL b/docs/INSTALL
new file mode 100644
index 00000000..5bd484d5
--- /dev/null
+++ b/docs/INSTALL
@@ -0,0 +1,49 @@
+©³¤U¬O§Ö³t¦w¸Ëªº¤èªk
+
+==
+
+¥ý¨ú±o root Åv­­
+
+1. ¥´ vipw, ¥[¤J©³¤U¨â¦æ
+
+   bbs:*:9999:99::0:0:Ptt BBS:/home/bbs:/home/bbs/bin/bbsrf
+   bbsadm::9999:99::0:0:Ptt BBS:/home/bbs:/bin/csh
+
+2. °õ¦æ passwd bbsadm ³] bbsadmªº±K½X
+3. ¦b /etc/group ¤¤¥[¤J¤@¦æ
+
+   bbs:*:99:
+
+4. °õ¦æ mkdir /home/bbs
+5. °õ¦æ chown bbs.bbs /home/bbs
+6. °õ¦æ chmod 700 /home/bbs
+
+µM«á¤Á´«¦¨ bbsadm ªº¨­¥÷
+
+7. ¨ú±o¸Ñ¶} pttbbs-VERSION.tar.gz (¥ô¦ó¥Ø¿ý¤U¬Ò¥i).
+8. °õ¦æ cd pttbbs
+9. ¦pªG¤§«e¨S¦³³]©w¹L pttbbs.conf ªº¸Ü, ½Ð cp sample/pttbbs.conf pttbbs.conf
+10. ­×§ï pttbbs.conf
+11. °õ¦æ make OSTYPE=FreeBSD BBSHOME=/home/bbs all install
+    (Linux¨Ï¥ÎªÌ½Ð§â "FreeBSD" §ï¦¨ "linux")
+12. ¦pªG¬O·s¬[°_¨Óªº¯¸, ½Ð°õ¦æ cd sample; make install
+12. °õ¦æ cd /home/bbs; bin/initbbs
+
+°²¦p¤@¤Á³£«Ü¶¶§Qªº¸Ü,³o¼Ë¤l¤j·§´N¦w¸Ë§¹¤F
+±µ¤U¨Ó¬O±Ò°Ê bbs ªº³¡¥÷
+
+13. °õ¦æ bin/uhash_loader (*µù1)
+14. ¥Î root °õ¦æ bin/mbbsd 23 (µù2)
+
+telnet localhost 23 ¬Ý¬Ý
+new¤@­Ó±b¸¹¥sSYSOP,µM«álogout¦Alogin, ³o¼Ë¤l´N·|¾Ö¦³¯¸ªøÅv­­Åo~
+¦Anew¤@­Ó±b¸¹¥s guest, ³o¼Ë¤l§O¤H´N¥i¥H¥Î guest °ÑÆ[§Aªº¯¸¤F
+¶}ªO,¶}¸s²Õ,¥H¤Î·h°Ê¸s²Õªº¤èªk½Ð¬Ý PttSrc ªOªº¤åºK
+
+µù:
+1. ³o­Óµ{¦¡¬O¦b initial shared memory ¥Îªº, ¥u¦³¶}¾÷«á²Ä¤@¦¸°õ¦æ, ©Î¬O
+   §A¤â°Ê²M°£ shm «á¤~»Ý­n°õ¦æ
+
+2. bin/mbbsd 23 ¬O«ü©w­n bind 23 port, ¨Ì·Ó UNIX ³W©w, 1024 ¥H¤Uªº port
+   ¶·­n¦³ root Åv­­, ©Ò¥H¦pªG­n bind 23 port ªº¸Ü´N­n¥Î root ¥h°õ¦æ,
+   3000 port «h¤£»Ý­n