firebird-25m

我搜集到的一个java常用类库的源代码

注： 以下文件乃编改自中正资工 Firebird BBS 2.5 版之使用手册。

————————————————————————————————————
                           目       录
————————————————————————————————————
  
                     (零) 前言

                     (一) 架站前的考量

                          [1] 硬体的准备
                          [2] 网路流量的考量
                          [3] 系统安全的考量
                          [4] 身份确认的重要性
                          
                     (二) 安装 BBS 程式
         
                          [1] 建立 BBS 的相关帐号
                          [2] 取得 BBS 程式
                          [3] 设定及安装 BBS 程式
                          [4] 测试 BBS 程式及错误的排除
                          [5] 其他版本 BBS 升级须知

                     (三) 设定 BBS 的相关档案  

                          [1] 修改系统设定档
                          [2] 修改 BBS 的选单
                          [3] 开版及建立精华区
                          [4] BBS 目录下档案说明

                     (四) 外部工具程式使用
 
                          [1] 简介自动程序
                          [2] 上站人数统计
                          [3] 上站人次统计
                          [4] 上站次数, 发表文章次数, 使用时间排名
                          [5] 十大热门话题统计
                          [6] 讨论区使用率统计
                          [7] 观看 .PASSWDS 的程式 -- showuser.c
                          [8] 自动 login BBS 帐号安装
                          [9] BBSnet, Lynx, Archie client ,IRC..etc安装

                     (五) 寄信给 BBS 站内使用者及 E-mail Post 安装

                          [1] 身份确认信处理的流程
                          [2] 如何修改系统使 BBS 站内 User 能收到 Intermail
                          [3] E-mail post 安装及使用    

                     (六) 转信程式 INNBBSD 的安装 
                        
                          [1] 安装转信程式
                          [2] 设定转信所需的设定档
                          [3] 申请转信的方法
                          [4] 参考文件 [已知 News Server 列表]
                          [5] 参考文件 [tw.bbs.* 列表]                  
                                        
————————————————————————————————————
                      第 零 章  前言  
————————————————————————————————————

    本版乃中正资工 Firebird BBS 的一个 variant, 由马来西亚旅台同学会之
    工作站管理小组成员所编改, 为秉持 GNU 软体开发精神而开放给大家自由
    拷贝使用。

    本版作者的风格与习性也许跟原版 Firebird BBS 的作者略有不同, 固一些原
    Firebird BBS 所拥有的小功能并没有被纳入, 且又增加了一些原版 Firebird
    BBS 所没有的功能。 比较重要的一点是, 我们尝试修正了一些存在于原版
    Firebird BBS 上的小错误。

    本版开放让大家抓取, 其目的在于希望能让各 Firebird 系列的站台互相交流, 
    集思广益, 一齐来参与发展, 使 Firebird BBS 在研发方面做得更加的尽善尽美。

    本版在 GNU Public Licence 下发行, 各位可任意拷贝及修改。但是我们有个
    小小的要求, 就是若您对它作了一些修改, 或修正错误, 或添加功能, 请在
    firebird 连线版上 post 出您改过的地方, 好让大家也能分享您的成果。 与
    您分享的快乐, 胜过独自拥有, 这是本版发行的目的。

————————————————————————————————————
                      第 一 章  架站前的考量  
————————————————————————————————————
 
 [1] 硬体的准备
     
     足够的记忆体及 SWAP 是影响上站人数上限的关键, 硬碟的大小则影响到
     各版文章能保留篇数的多少, 在架站前需衡量所需配备。 据观察, 一台
     具有32MB 记忆体的 Linux station 在 BBS 人数达 50 人左右时开始会
     用 SWAP。 (Linux 作业系统在记忆体不足的状况下才会用 SWAP)
     
     因为 BBS 的档案多以信件, 讨论区文章为多, 这些都是 1k ~ 2k 的小档
     案, 所以系统的档案结构每个 inode 以 1k 或 2k 为佳 , 您可以下 df -i 
     指令观察目前 inode 的使用状况。 inode 的大小通常是在 fdisk 时选择
     的。

 [2] 网路流量的考量
 
     当您的 BBS站公开给外界使用以后，通常会遇到以下麻烦：
      
     如果有大量使用者透过网路连接您的 BBS，会对您们当地的网路造成「有
     点大，又不会太大」的网路交通量。
   
     ==> 对策：统计网路交通流量，了解 BBS系统对网路的影响程度，以调整
               BBS的管理策略。
   
 [3] 系统安全的考量

     由于 BBS站是一般 cracker觊觎的对象之一，因此设立 BBS站之后，容易
     让您的工作站成为显著的入侵目标。
   
     ==> 对策：请更加注意您的系统安全，尤其当执行外部程式(gopher,lynx
               tin,....etc)务必确定程式是否有执行上的漏洞, 或者寻找修
               改过专为 BBS 用的版本,并请勤于修补作业系统的漏洞。
   
 [4] 身份确认的重要性

     除非您的 BBS站是封闭式的 BBS（也就是使用者必须经过严格的申请程序
     才能拥有帐号），否则请注意匿名使用者的问题。匿名使用者的言责问题
     一直是网路上争议的论点之一，因此请您在开站之前考虑您的做法。
   
     ==> 对策：确认使用者身份以后才给予发表文章的权利，而且规定使用者
               身份只能透过系统管理员查询。如此即可适度保障使用者隐私
               权、又可在发生问题时追查责任的归属。


————————————————————————————————————
                      第 二 章  安装 BBS 程式  
————————————————————————————————————

 [1] 建立 BBS 的相关帐号
     
     在安装 BBS 之前，请您先在系统中加入以下三位使用者，在 /etc/passwd
     内应该如下所示：（新建帐号的步骤会因系统不同而有所差异，请您在建
     立帐号之前参考您的系统管理手册。采用 UID=9999 与9990的原因是为了
     避免与一般使用者的 UID 产生冲突）

     一般建立新帐号的步骤是在 /etc/passwd 中加入下三行，然后再为 bbsadm 和
     bbsuser 这两个帐号设好密码, 而 bbs 这个帐号一般上是不设任何密码的: 

       bbsadm::9990:99:BBS admin and developer:/home/bbsroot:/bin/csh
       bbs::9999:99:BBS user:/home/bbs:/home/bbs/bin/bbsrf
       bbsuser::9999:99:BBS user:/home/bbs:/bin/csh

     其中 bbsadm  是用来修改 /home/bbsadm/bbs_src 下的 BBS 程式。
          bbsuser 跟 bbs 拥有相同的 UID，但它的 shell 是一般的 shell，
                  而 bbs 的 shell 则是 bbsrf。 当系统需要 bbs 以一般的
                  shell 来作处理时, 便需要有这个帐号了。

     此外, 在 /etc/group 内设定 bbs 的 group，如下所示：

     bbs:*:99:bbs,bbsuser,bbsadm

     以方便您管理目录的读写权限。
  
     并在 /etc/shells 中加入 /home/bbs/bin/bbsrf 。
   
     以上都设定完成后,在 /home 建立 bbsadm 和 bbs 两个目录, 并 
     chown bbsadm.bbs bbsadm ; chown bbs.bbs bbs
     再分别替 bbsroot bbsuser 设定密码。

 [2] 取得 BBS 程式
     
     请以 bbsadm login ,再抓取 BBS source , 本版的 BBS source 
     可由以下位址取得

     ftp://MSIA.pine.ncu.edu.tw/pub/bbs/FirebirdBBS2.5M.tar.gz
 
     取回后,解开 FirebirdBBS 2.5M 的原始程式，以进行安装程序。
     解开 FirebirdBBS2.5M.tar.gz 的方法:

     tar zxvf FirebirdBBS2.5M.tar.gz

     程式解开之后，会在你所在目录底下造出 bbs_src 目录，内含 BBS的原始
     程式。
      
     (注）如果您的 tar 不认得 zxvf，请利用 anonymous ftp 至
          ftp.csie.nctu.edu.tw 取回 /pub/GNU/gzip-1.2.4.tar与 
          /pub/GNU/tar-1.11.2.tar.gz，并且安装至您的系统上。

 [3] 设定及安装 BBS 

     1.自动设定系统环境及填写主要 BBS 资料
   
     同样以 bbsroot login , 到 bbs_src/ 目录底下执行以下指令
      
      ( cd CONFIG ; ./configure )
      
     执行的过程应类似以下画面：

 ..................................
   Please fill data for your BBS
 ..................................
Home directory of BBS --> [/home/bbs]                   ==> bbs 目录所在
UID of BBS --> [9999]					==> bbs 的系统 User ID
GID of BBS --> [99]					==> bbs 的系统 GID
UID of BBS admin --> [9990]				==> bbsadm 的系统 UID
The ID of your site --> [NoName]                        ==> 贵站的英文代号
The name of your site --> [Hibiscus Realm BBS]          ==> 贵站名称 (中文可)
The domain name of your site --> [some.where.on.earth]  ==> 贵站 domain name
The ip address of your site --> [127.0.0.1]		==> 贵站 ip address
Maximum number of users --> [20236]			==> 最大使用人数
Maximum number of boards --> [256]			==> 开板最大数目
Maximum number of on-line users --> [256]		==> 最大同时上线人数
Show idle time of BBS users ? --> [Y]			==> 显示 idle 时间
........................................
updating cache ./config.cache
creating ./config.status
creating Makefile
creating config.h
creating Install.sh

........................................................................
You may review the Makefile now. Then, type 'make' to build your system.
........................................................................

     在设定一些数值时请确切考虑您的硬体设备是否足够。 特别是最大同时上线
     人数，它是与记忆体的大小非常有关的。

     程式会自动判断您所用的系统，并且询问您所架设的 BBS之基本资料，以
     造出必要的 Makefile 。 顺利的话，您应该可以在 bbs_src/ 目录底下找
     到刚造出来的 Makefile。 您可以观看此档的设定，若有必要，可手动修改
     之。

     在 bbs_src/ 下亦可找到 config.h 这个档，在编译程式之前您亦可对它作
     一些手动的修改。

     同一个目录下可找到 chat.h 这个档, 您可以在此更改 chat room 的 port
     number 和名字。

     2.编译 BBS 程式
     
     在 bbs_src/ 下执行如下指令  

      make

     进行编译动作。如果编译过程无错误的话，bbs_src/ 目录底下应该已经产
     生 bbs, bbsrf, chatd 以及 thread 这四个执行档。如果这四个档案都已
     产生的话，代表 BBS 程式的编译已经完成。

     如果因为任何 error导致 BBS 程式无法产生的话, 请检查安装程序是否有误。
     若无法解决, 可将完整编译过程产生的讯息张贴至各大站 firebird 版或 
     installbbs 版求助。  
     
     3.安装 BBS 程式

     以 root login , 在 /home/bbsroot/bbs_src 目录底下执行

      make install
      make installchatd
      make installthread

     即可大功告成。请继续测试您刚架设完成的 ＢＢＳ站。

 [4] 测试 BBS 程式及错误的排除
     
     1.测试ＢＢＳ并取得 SYSOP 权利

     Telnet 到您的 BBS 主机，然后以 bbs 当 username 来 login , 应可见
     到 BBS 的 login 画面。此时，当 BBS程式要求您输入代号时，  请输入 
     new，以便注册一个新使用者。由于名称为 SYSOP 的使用者拥有一切权利
     ，因此您必须先注册为 SYSOP，并且设定密码。请注意：SYSOP 必需完全
     大写。

     接下来，请再替  guest 登记帐号，此帐号为 BBS的参观帐号，不须输入
     密码即可进入 BBS(注册时随便打个密码即可)。如果您不想提供 guest帐
     号，可以略过此步骤，并记得把 guest 加入 "不可注册之ID" 的名单内。
     如果您提供了 guest  帐号，请参考稍后的文件说明替 guest  设定
    「恰到好处」的权限。通常guest 帐号是只能参观不可发言的，因此通常
     不具有发表文章或聊天的功能。
   
     2.错误的排除
   
     如果天不从人愿，程式一声不响地就结束了，请您先以 bbsuser login，
     在/home/bbs 的目录底下执行「 bin/bbs h localhost」，看看能不能执
     行。如果 bbs可以执行的话，那应该是  ~bbs/bin/bbsrf  出了问题，请
     检查bbsrf 程式之 owner与 mode ，如果您自行使用 chroot 安装选项的
     话，请确定 owner为 root 且 mode 为 4755。
   
     如果不是这个情形，请执行 ipcs 指令，查看 shared memory的使用情形
     与 owner是否正确，正常的 owner应该是 bbs，如果不是的话，请利用
     ipcrm 清除之，然后重新执行 bbs。
     通常以上错误会有 Error! shmat error! key = xxx. 的讯息.
   
     再不行的话，请检查 ~bbs/etc/menu.ini  与 ~bbs/etc/sysconf.ini 是
     否存在，以及档案内容是否完整。如果完整的话，请试著删除
      ~bbs/sysconf.img 档案，再重新进入 BBS测试。
   
     如果还是不行的话，请试著清除整个 BBS系统，重新开机后再安装几次试
     试。如果真的没有办法，请到 tw.bbs.admin.installbbs  讨论区求助，
     或 email 给本系统的发展小组 [e-mail] 。在此
     特别推荐第一种做法，因为这样子可以在网路上遇到较多使用 FirebirdBBS
     系统的管理者，得到立即回应的机会较大。当然啦，在求助之前请详述您的
     系统平台、所用的编译器，以及出现错误的状况等资讯，这样子大家才能
     容易帮您找出可能发生问题的地方。

 [5] 其他版本 BBS 升级须知
    
     以下说明从各版本升级所须步骤, 详细 BBS 相关设定档请见第三章说明。

 ☆  从 Phoenix  BBS 4.0 版升级
 ———————————————————————————————————
 1. 在 /home/bbs/etc 建立目录 notepad_tmp 的目录(注意 owner 为 bbs)