5 files changed, 258 insertions, 94 deletions
diff --git a/docs/ADVANCE b/docs/ADVANCE
new file mode 100644
index 00000000..dd1a2e28
--- /dev/null
+++ b/docs/ADVANCE
@@ -0,0 +1,39 @@
+我們在這個版本裡面加入了一些好玩的東西,
+最主要是希望可以偷懶做一些事情.
+
+bbsctl
+------
+bbsctl是一個很特別的程式, 安裝有點複雜.
+	1.先用 bbsadm 的權限在 util/下 make bbsctl
+	2.改成 root 的權限在 util/下 make installbbsctl
+如此會把 bbsctl 安裝到 /usr/local/bin 下, 以方便在任何目錄下皆可使用.
+!!請注意,  bbsctl 是有 root setuid的, 這可能會有安全上的問題!!
+
+您可以直接打 bbsctl 來看有什麼功能.
+主要的功能說明如下:
+1.bbsctl start
+  用於啟動 mbbsd (須先跑 uhash_loader)
+  以往因為要 bind port 23 須要 root 所以要手動 su ,
+  不過現在有 bbsctl with setuid ,
+  請直接使用 bbsctl start , 即可將 mbbsd跑起來.
+2.bbsctl stop
+  會將所有正在 listen 的 mbbsd都砍掉
+3.bbsctl restart
+  即 bbsctl stop; bbsctl start
+  主要是如果程式更新的話, 可以透過這個來直接重跑.
+4.bbsctl bbsadm
+  若該使用者有加入 bbsadm 群組, 則同於直接 su 成 bbsadm
+   (不須密碼)
+  如此您可以將某些有管理權限的使用者,
+  透過 /etc/group 放進 bbsadm 的群組,
+  讓她們在 login後可以直接用 bbsctl bbsadm來換成 bbsadm 的權限.
+
+
+
+shmctl
+------
+這隻程式主要是外部用來輔助 shared-memory正常運作的.
+1.shmctl utmpfix
+  將 shared-memory中 utmp 不正確的 record 清掉.
+  建議至少每小時跑一次.
+  另外可以用這個來外部設定 idle 多久後就踢人.
diff --git a/docs/FAQ b/docs/FAQ
index bc2904a0..9faf6109 100644
--- a/docs/FAQ
+++ b/docs/FAQ
@@ -1,74 +1,9 @@
- 作者  DavidYu (^^Y)                                        看板  PttSrc
- 標題  Re: 安裝完連線時.....
- 時間  Thu May 18 15:08:04 2000
-───────────────────────────────────────
-
-※ 引述《JamesCheng (網球比排球好玩啦！)》之銘言：
-: 我在安裝完之後 用root執行 mbbsd 23
-: 連線看出現
-: Escape character is '^]'.
-: 【物治樂園】◎ 物治第二站 ◎(pt.mc.ntu.edu.tw)
-:   調幅(140.112.122.44)  系統負荷  0.00 0.01 0.00
-: Connection closed by foreign host.
-: 然後系統出現下列訊息
-: [shmget error] key = 8ab
-: errno = 12: Cannot allocate memory
-: 這是何原因呢？
-shared memory要加大
-在kernel config file中加一行
-options         SHMMAXPGS=4100
-重新make kernel
-
---
-※ 發信站: 批踢踢實業坊(ptt.twbbs.org)
-◆ From: oio.m6.ntu.edu.t
-
- 作者  DavidYu (Do it YOURSELF!)                            看板  PttSrc
- 標題  Re: 請問一下...
- 時間  Sat May 27 18:41:39 2000
-───────────────────────────────────────
-
-※ 引述《clifflu ( 煩呀煩呀煩~~~)》之銘言：
-: ※ 引述《hscat (復站了！)》之銘言：
-: :         不過我有一個小小的問題
-: :         能不能指導一下...想要開新的版應該從哪邊開呢？
-: 主選單下的 (0)Admin ??
-: :         因為我實在找不到怎麼開新看板...:~~~~...
-不不不..
-開板要從分類看板的地方開,這部份有點小小的複雜,
-和以往的版本不一樣,我來簡單說明一下:
-
-首先介紹看板.
-看板有兩種, 一般看板和群組看板. 如果用檔案系統的架構來看的話,
-一般看板如同 file, 而群組看板就是 directory
-(在所有看板列表的地方只會出現一般看板)
-
-一個看板有UID及GID這兩個屬性. UID是unique的,從1開始分配,系統在開板時會�
-菾佧llocate一個. 而GID是指定這個看板在哪一個群組看板之下(看板是樹狀架構的)
-所以如果有一個群組看板的UID是x, 則GID為x的看板都會擺在該群組看板之下
-而如果看板GID為0(保留的UID)的話,該看板就會出現在一開始從主選單進CLASS的
-那個地方
-
-至於開板的方法.
-首先從CLASS進到你想要開新板的類別下,然後按大B設定
-如此新開的板就會自動assign GID 到那個類別下
-
-如果要般動一個已經開好的板到其他類別的話
-先找出那個類別(群組看板)的UID, 按大E可以看到
-然後把要搬動的板的GID設成那個UID及可
-
-值得注意的是, 如果把某個使用者設成某群組看板的板主的話
-則當他從CLASS進到那個群組時會獲得小組長的權限(可以開板,設定看板等等)
-要特別小心
-
-比較麻煩的地方:
-一個新開的群組裡面並沒有任何看板,所以無法從選單進去裡面開板
-這時候就需要在可開板的地方先開個板,然後再把那個板的GID設過去即可
-(這也是為什麼需要一個initial的.BOARDS的原因 :p)
-
---
-※ 發信站: 批踢踢實業坊(ptt.twbbs.org)
-◆ From: meow.cc.ntu.edu.
+加大 shared-memory:
+如果您是用 FreeBSD, 請在 /boot/loader.conf 裡面加入
+kern.ipc.shmmax=104857600
+kern.ipc.shmall=25600
+這兩個數值可視須要調整,
+在重新開機後會生效.
 
  作者  DavidYu (軱~~~~~~~~~~)                               看板  PttSrc
  標題  sendmail.cf要改的地方(參考用)
@@ -123,24 +58,3 @@ Mbbsmail,       P=/home/bbs/bin/bbsmail, F=lsSDFMhPu, U=bbs, S=10,R=20/40,
 --
 ※ 發信站: 批踢踢實業坊(ptt.twbbs.org)
 ◆ From: oio.m6.ntu.edu.t
-
- 作者  DavidYu (鴰~~~~~~~~~~~~~~)                           看板  PttSrc
- 標題  [anno] tunepasswd
- 時間  Sat Jul 29 09:18:06 2000
-───────────────────────────────────────
-
-新增了一個 tunepasswd 的程式
-
-如果你在 .PASSWD 建立後又改過了 MAX_USERS
-
-你必須要執行 tunepasswd 一次來修改 .PASSWD 檔的大小
-
-執行的時候不可以有任何BBS的程式在執行
-
-shared memory 也應該要清除, 否則會有不預期的錯誤發生
-
-執行 tunepasswd 會產生一個原來的備份檔 .PASSWD~
-
---
-※ 發信站: 批踢踢實業坊(ptt.twbbs.org)
-◆ From: oio.m6.ntu.edu.t   
diff --git a/docs/FAQ.old b/docs/FAQ.old
new file mode 100755
index 00000000..bc2904a0
--- /dev/null
+++ b/docs/FAQ.old
@@ -0,0 +1,146 @@
+ 作者  DavidYu (^^Y)                                        看板  PttSrc
+ 標題  Re: 安裝完連線時.....
+ 時間  Thu May 18 15:08:04 2000
+───────────────────────────────────────
+
+※ 引述《JamesCheng (網球比排球好玩啦！)》之銘言：
+: 我在安裝完之後 用root執行 mbbsd 23
+: 連線看出現
+: Escape character is '^]'.
+: 【物治樂園】◎ 物治第二站 ◎(pt.mc.ntu.edu.tw)
+:   調幅(140.112.122.44)  系統負荷  0.00 0.01 0.00
+: Connection closed by foreign host.
+: 然後系統出現下列訊息
+: [shmget error] key = 8ab
+: errno = 12: Cannot allocate memory
+: 這是何原因呢？
+shared memory要加大
+在kernel config file中加一行
+options         SHMMAXPGS=4100
+重新make kernel
+
+--
+※ 發信站: 批踢踢實業坊(ptt.twbbs.org)
+◆ From: oio.m6.ntu.edu.t
+
+ 作者  DavidYu (Do it YOURSELF!)                            看板  PttSrc
+ 標題  Re: 請問一下...
+ 時間  Sat May 27 18:41:39 2000
+───────────────────────────────────────
+
+※ 引述《clifflu ( 煩呀煩呀煩~~~)》之銘言：
+: ※ 引述《hscat (復站了！)》之銘言：
+: :         不過我有一個小小的問題
+: :         能不能指導一下...想要開新的版應該從哪邊開呢？
+: 主選單下的 (0)Admin ??
+: :         因為我實在找不到怎麼開新看板...:~~~~...
+不不不..
+開板要從分類看板的地方開,這部份有點小小的複雜,
+和以往的版本不一樣,我來簡單說明一下:
+
+首先介紹看板.
+看板有兩種, 一般看板和群組看板. 如果用檔案系統的架構來看的話,
+一般看板如同 file, 而群組看板就是 directory
+(在所有看板列表的地方只會出現一般看板)
+
+一個看板有UID及GID這兩個屬性. UID是unique的,從1開始分配,系統在開板時會�
+菾佧llocate一個. 而GID是指定這個看板在哪一個群組看板之下(看板是樹狀架構的)
+所以如果有一個群組看板的UID是x, 則GID為x的看板都會擺在該群組看板之下
+而如果看板GID為0(保留的UID)的話,該看板就會出現在一開始從主選單進CLASS的
+那個地方
+
+至於開板的方法.
+首先從CLASS進到你想要開新板的類別下,然後按大B設定
+如此新開的板就會自動assign GID 到那個類別下
+
+如果要般動一個已經開好的板到其他類別的話
+先找出那個類別(群組看板)的UID, 按大E可以看到
+然後把要搬動的板的GID設成那個UID及可
+
+值得注意的是, 如果把某個使用者設成某群組看板的板主的話
+則當他從CLASS進到那個群組時會獲得小組長的權限(可以開板,設定看板等等)
+要特別小心
+
+比較麻煩的地方:
+一個新開的群組裡面並沒有任何看板,所以無法從選單進去裡面開板
+這時候就需要在可開板的地方先開個板,然後再把那個板的GID設過去即可
+(這也是為什麼需要一個initial的.BOARDS的原因 :p)
+
+--
+※ 發信站: 批踢踢實業坊(ptt.twbbs.org)
+◆ From: meow.cc.ntu.edu.
+
+ 作者  DavidYu (軱~~~~~~~~~~)                               看板  PttSrc
+ 標題  sendmail.cf要改的地方(參考用)
+ 時間  Sun Jul  9 09:39:53 2000
+───────────────────────────────────────
+
+有顏色的是要加上去的
+要注意,tab和space不能混用
+
+######################################
+###   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
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+--
+※ 發信站: 批踢踢實業坊(ptt.twbbs.org)
+◆ From: oio.m6.ntu.edu.t
+
+ 作者  DavidYu (鴰~~~~~~~~~~~~~~)                           看板  PttSrc
+ 標題  [anno] tunepasswd
+ 時間  Sat Jul 29 09:18:06 2000
+───────────────────────────────────────
+
+新增了一個 tunepasswd 的程式
+
+如果你在 .PASSWD 建立後又改過了 MAX_USERS
+
+你必須要執行 tunepasswd 一次來修改 .PASSWD 檔的大小
+
+執行的時候不可以有任何BBS的程式在執行
+
+shared memory 也應該要清除, 否則會有不預期的錯誤發生
+
+執行 tunepasswd 會產生一個原來的備份檔 .PASSWD~
+
+--
+※ 發信站: 批踢踢實業坊(ptt.twbbs.org)
+◆ From: oio.m6.ntu.edu.t   
diff --git a/docs/INSTALL b/docs/INSTALL
index 5bd484d5..2cff5971 100644
--- a/docs/INSTALL
+++ b/docs/INSTALL
@@ -21,6 +21,16 @@
 然後切換成 bbsadm 的身份
 
 7. 取得解開 pttbbs-VERSION.tar.gz (任何目錄下皆可).
+
+   或透過 cvs來取得 (強烈建議)
+   touch ~/.cvspass
+   cvs -d :pserver:cvs@ptt2.csie.ntu.edu.tw:/var/db/cvsroot login
+    (不用打密碼, 直接按 Enter過去)
+   cvs -d :pserver:cvs@ptt2.csie.ntu.edu.tw:/var/db/cvsroot checkout pttbbs
+   使用此法的朋友, 將來您可以直接在 pttbbs/ 下用
+      cvs update
+   更新到最新版本的 pttbbs
+
 8. 執行 cd pttbbs
 9. 如果之前沒有設定過 pttbbs.conf 的話, 請 cp sample/pttbbs.conf pttbbs.conf
 10. 修改 pttbbs.conf
@@ -32,9 +42,10 @@
 假如一切都很順利的話,這樣子大概就安裝完了
 接下來是啟動 bbs 的部份
 
-13. 執行 bin/uhash_loader (*註1)
+13. 執行 bin/uhash_loader (*註1, *註2)
 14. 用 root 執行 bin/mbbsd 23 (註2)
 
+15. 新功能請參考 ADVANCE
 telnet localhost 23 看看
 new一個帳號叫SYSOP,然後logout再login, 這樣子就會擁有站長權限囉~
 再new一個帳號叫 guest, 這樣子別人就可以用 guest 參觀你的站了
@@ -44,6 +55,11 @@ new一個帳號叫SYSOP,然後logout再login, 這樣子就會擁有站長權限囉~
 1. 這個程式是在 initial shared memory 用的, 只有開機後第一次執行, 或是
    你手動清除 shm 後才需要執行
 
-2. bin/mbbsd 23 是指定要 bind 23 port, 依照 UNIX 規定, 1024 以下的 port
+2. 如果您跑了 uhash_loader 並沒有看到
+      total XXXXX names loaded.
+   而是看到其他的錯誤訊息, 可能是您作業系統 shared-memory 上限不足,
+   請參考 FAQ第一部份加大 shared-memory.
+
+3. bin/mbbsd 23 是指定要 bind 23 port, 依照 UNIX 規定, 1024 以下的 port
    須要有 root 權限, 所以如果要 bind 23 port 的話就要用 root 去執行,
    3000 port 則不需要
diff --git a/docs/INSTALL.old b/docs/INSTALL.old
new file mode 100755
index 00000000..5bd484d5
--- /dev/null
+++ b/docs/INSTALL.old
@@ -0,0 +1,49 @@
+底下是快速安裝的方法
+
+==
+
+先取得 root 權限
+
+1. 打 vipw, 加入底下兩行
+
+   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的密碼
+3. 在 /etc/group 中加入一行
+
+   bbs:*:99:
+
+4. 執行 mkdir /home/bbs
+5. 執行 chown bbs.bbs /home/bbs
+6. 執行 chmod 700 /home/bbs
+
+然後切換成 bbsadm 的身份
+
+7. 取得解開 pttbbs-VERSION.tar.gz (任何目錄下皆可).
+8. 執行 cd pttbbs
+9. 如果之前沒有設定過 pttbbs.conf 的話, 請 cp sample/pttbbs.conf pttbbs.conf
+10. 修改 pttbbs.conf
+11. 執行 make OSTYPE=FreeBSD BBSHOME=/home/bbs all install
+    (Linux使用者請把 "FreeBSD" 改成 "linux")
+12. 如果是新架起來的站, 請執行 cd sample; make install
+12. 執行 cd /home/bbs; bin/initbbs
+
+假如一切都很順利的話,這樣子大概就安裝完了
+接下來是啟動 bbs 的部份
+
+13. 執行 bin/uhash_loader (*註1)
+14. 用 root 執行 bin/mbbsd 23 (註2)
+
+telnet localhost 23 看看
+new一個帳號叫SYSOP,然後logout再login, 這樣子就會擁有站長權限囉~
+再new一個帳號叫 guest, 這樣子別人就可以用 guest 參觀你的站了
+開板,開群組,以及搬動群組的方法請看 PttSrc 板的文摘
+
+註:
+1. 這個程式是在 initial shared memory 用的, 只有開機後第一次執行, 或是
+   你手動清除 shm 後才需要執行
+
+2. bin/mbbsd 23 是指定要 bind 23 port, 依照 UNIX 規定, 1024 以下的 port
+   須要有 root 權限, 所以如果要 bind 23 port 的話就要用 root 去執行,
+   3000 port 則不需要