mudOS源码 options.h配置详细选项

/* options.h配置详细选项
—————————————————————————-
将 MudOS 下载解压以后可以在相应目录的根目录中找到 options.h 这个文件。如果修
 改了这个文件,那么每次都需要重新编译 MudOS 才能生效。重新编译之前,请执行 ma
 ke clean 一下。
 下面的 options.h 来自 MudOSv22.2b10,MudOS作者推荐在修改options.h 之前,先将
 它备份成 local_options。新的特性将会自动对比local_options并且在编译的时候告知
 。文中的选项定义并非最原始的定义。此文只是为了说明各个选项的大致含义。
options.h: defines for the compile-time configuration of the MudOS driver
 */

#ifndef _OPTIONS_H_
 #define _OPTIONS_H_

/****************************************************************************
如果你对自己的系统不熟悉,请使用缺省的定义 SYSMALLOC,同时将其它的undef掉。
 你必须选择下面的其中一种定义,并且将其它的定义undef掉。
SYSMALLOC: 缺省选项,没有额外的系统开支,没有统计能力。
SMALLOC:速度比较快,但是开销相对大一些。
BSDMALLOC:速度更快,开销比较大。
****************************************************************************/

#define SYSMALLOC
 #undef SMALLOC
 #undef BSDMALLOC

/****************************************************************************
 WRAPPEDMALLOC:这个附加定义可以换来有限的统计能力,并且不会增加太多的系统开销。
DEBUGMALLOC:系统花费比较折中
****************************************************************************/
 #undef WRAPPEDMALLOC
 #undef DEBUGMALLOC

/****************************************************************************
如果没有定义SMALLOC,请不要使用下面这个定义。
****************************************************************************/
 #undef SBRK_OK

/****************************************************************************
如果没有定义 BSDMALLOC or SMALLOC ,请不要使用下面这个定义
****************************************************************************/
 #undef DO_MSTATS

/****************************************************************************
 DEBUGMALLOC定义的附加定义,用来强化DEBUGMALLOC,但是需要更多的开销。
set_malloc_mask(int) and debugmalloc(string,int)等efuns将可以被使用。
****************************************************************************/
 #undef DEBUGMALLOC_EXTENSIONS

/****************************************************************************
同上,是用来调试的良好定义,check_memory() efun将可以被使用。
****************************************************************************/
 #undef CHECK_MEMORY

/****************************************************************************
兼容性定义选项:
 由于MudOS发展了很多年,所以历代MudOS为了保证原有的Lib可以不修改就被移植到新的
OS上面,增加了这些兼容性选项。如果你是根据OS撰写Lib的人,可以定义一些优化的选
 项来设计自己的Lib,而不必考虑重写的问题。
 以前的MudOS使用status这样子的定义词,这是很老的定义了,对于新的Lib设计而言,
 这个定义毫无用处。
****************************************************************************/
 #undef HAS_STATUS_TYPE

/****************************************************************************
 explode()选项,这个根据个人的习惯来定义吧
 如果不定义下面两个选项, explode(“..x.y..z..”, “.”) 的结果是 ({ “x”, “y”, “”
, “z”, “” })
如果定义SANE_EXPLODE_STRING 选项,其结果将是({ “”, “x”, “y”, “”, “z”, “” })
如果定义 REVERSIBLE_EXPLODE_STRING 选项,其结果将是 ({ “”, “”, “x”, “y”, “”,
“z”, “”, “” })
 ****************************************************************************/
 #define SANE_EXPLODE_STRING
 #undef REVERSIBLE_EXPLODE_STRING

/****************************************************************************
这个选项用来确定call_other的行为,但是这个选项对于系统毫无好处可言。
****************************************************************************/
 #undef CAST_CALL_OTHERS

/****************************************************************************
如果定义了下面这个选项,那么任何传往非交互式物件(比如npc)的信息前面都会被加
 上’]'符号,这个也不是非常需要,而且很容易被模拟出来。
****************************************************************************/
 #undef NONINTERACTIVE_STDERR_WRITE

/****************************************************************************
如果定义下面这个选项,你将不能使用set_light()这样的efuns函数,不过没有关系,
 这个函数是在太落伍了,这个功能非常容易被模拟出来。
****************************************************************************/
 #define NO_LIGHT

/****************************************************************************
嗯,下面这个选项,是非常重要的选项,如果你定义了,那么意味着你将不能使用add_
 action, commands, livings等等这些相关的efuns,而不得不使用 process_input() 这
 样的函数来定义物件所有的动作。这将是非常难堪的工作。所以保持add_action还是非
 常有用的。
****************************************************************************/
 #undef NO_ADD_ACTION

/****************************************************************************
定义下面这个选项,将不能使用和snoop相关的函数,如果你认为没有snoop也没有关系
 ,可以定义这个选项来保护一些隐私。
****************************************************************************/
 #undef NO_SNOOP

/****************************************************************************
这个选项和add_action一样要命,除非你立志只做一个聊天室,那么可以定义这个选项
 ,否则,你的工作将会非常的麻烦。
****************************************************************************/
 #undef NO_ENVIRONMENT

/****************************************************************************
由于历史原因,定义wizard来管理Mud的运作,但是现在好像不是非常重要了。
 如果定义了, wizardp() 和 related efuns 将不存在
 如果没有定义,在使用ed()时也受限制,设置的限制参数无效
 而且这个定义非常容易模拟出来。
****************************************************************************/
 #undef NO_WIZARDS

/****************************************************************************
下面的选项只是为了保持兼容性问题,对于大多数的LPmud而言,这个选项毫无用处。尤
 其是一个新的Lib撰写。
****************************************************************************/
 #undef OLD_TYPE_BEHAVIOR

/****************************************************************************
定义下面这个选项,将意味着对于一个string或者buffers而言可以使用负数的index。
 对于一个新Lib撰写,这个属性不是非常重要。
****************************************************************************/
 #undef OLD_RANGE_BEHAVIOR

/****************************************************************************
这个定义选项主要是为了保持向后兼容,对于新的Lib而言,没什么用处。重新习惯一个
 方式,并不是非常困难的,而且,ed()对于大多数习惯使用工具撰写的人们而言,意义
 不大。
****************************************************************************/
 #define OLD_ED

/****************************************************************************
下面这个选项比较重要,对于新的Lib撰写或者以前没有接触过LPC的人来说,这个定义
 可以按照喜好来定。
(1) ‘static’ 将不再使用,而是用 ‘nosave’ 或者 ‘protected’ 代替了它。.
 (2) ‘public’ 含义发生了变化,外部函数必须在任何一级的继承中被声明。现在publi
 c意味着是明显可见的。
****************************************************************************/
 #define SENSIBLE_MODIFIERS

/****************************************************************************
下面的选项定义会改变MudOS的一些行为。这些对于Lib撰写,是比较重要的。
 定义下面这个选项,将使用MD5加密法代替系统缺省的crypt()加密法。
****************************************************************************/
 #undef CUSTOM_CRYPT

/****************************************************************************
下面这个选项只是为了一些兼容性问题。定义以后,某些efuns含义会有所变化,但是没
 有实质的区别。
****************************************************************************/
 #undef COMPAT_32

/****************************************************************************
允许统计的时候包含字符串分配,不定义可以是字符串处理更快,但字符串统计将被忽略。
****************************************************************************/
 #define STRING_STATS

/****************************************************************************
同上,数组统计。
****************************************************************************/
 #define ARRAY_STATS

/****************************************************************************
这是比较有用的选项,用来生成log文件。
****************************************************************************/
 #define LOG_CATCHES

/****************************************************************************
这个类似上面得选项,可以生成有用的调试文档。
****************************************************************************/
 #define ARGUMENTS_IN_TRACEBACK

/****************************************************************************
同上,对于新Lib撰写非常有用。
****************************************************************************/
 #define LOCALS_IN_TRACEBACK

/****************************************************************************
通过error_handler()来处理错误,非常有用的选项。
****************************************************************************/
 #define MUDLIB_ERROR_HANDLER

/****************************************************************************
下面得选项,可以详细定义,当然也可以通过配置config.cfg这样的文件来设置。
****************************************************************************/
 #ifndef LATTICE
 #define CONFIG_FILE_DIR “/u/tim/COMP/bin”
#else
 #define CONFIG_FILE_DIR “etc:”
#endif

/****************************************************************************
下面的选项将会对整个Lib撰写起到作用。对于新的Lib撰写,建议选择比较严格的方式
 。而如果想保持兼容,建议选择常规的设定。
 这些设定 其实等同于使用 #pragma 来定义。
 如果你不太明白,使用 #define DEFAULT_PRAGMAS 0 是一个比较好的选择。
PRAGMA_STRICT_TYPES: 强制执行严格的书写规则,这个估计是以前议论最多的问题,
 事实上,对于新Lib,这几乎不是问题。
PRAGMA_WARNINGS: 对不合法代码进行警告。非常有用。
PRAGMA_SAVE_TYPES: 呼叫以后保存函数情况
PRAGMA_SAVE_BINARY: 二进制代码保存,可以降低系统负担。
PRAGMA_OPTIMIZE: 代码优化
PRAGMA_ERROR_CONTEXT:错误报告
****************************************************************************/
 #define DEFAULT_PRAGMAS PRAGMA_SAVE_BINARY + PRAGMA_WARNINGS + PRAGMA_ERROR_CONTEXT

/****************************************************************************
对于没有使用的变量声明或者缺少的参数进行报告
****************************************************************************/
 #define SUPPRESS_ARGUMENT_WARNINGS

/****************************************************************************
这是重要的设定,为了保证系统拥有reset(),请不要定义这个选项。
 除非不想系统拥有reset()。
****************************************************************************/
 #undef NO_RESETS

/****************************************************************************
看名字就知道,如果定义了,reset()将变得比较懒惰,你不碰它,它不呼叫。对于大多
 数需要刷新时间的LPmud而言,还是不要定义的好。
****************************************************************************/
 #undef LAZY_RESETS

/****************************************************************************
存盘文件的缺省后缀名。
****************************************************************************/
 #define SAVE_EXTENSION “.o”

/****************************************************************************
下面两个选项使用来控制ansi的用户输入的,这个比较容易模拟出来,因为*的ansi
输入可能会导致一些显示错误。
****************************************************************************/
 #define NO_ANSI
 #define STRIP_BEFORE_PROCESS_INPUT

/****************************************************************************
笔者水平有限,不知道OPC是什么东西。只知道定义以后,可以用一个opcprof()函数来
 统计外部函数调用的情况。下面得选项稍有不同,一次只能定义其中的一个。
****************************************************************************/
#undef OPCPROF
#undef OPCPROF_2D

/****************************************************************************
当这个选项定义以后,当发生crash的时候,master.c中定义的crash()将被呼叫。
****************************************************************************/
 #define TRAP_CRASHES

/****************************************************************************
可以在call_outs中使用this_player()
 ****************************************************************************/
 #define THIS_PLAYER_IN_CALL_OUT

/****************************************************************************
这个定义是比较有用的,定义以后,call_out将产生一个int序列,这个序列可以方便的
 被find_call_out()和remove_call_out()调用。这是一个效率极高的处理方式。原来使
 用name来处理的方式相对比较低效。唯一的代价是些许系统开销。
****************************************************************************/
 #define CALLOUT_HANDLES

/****************************************************************************
调试非常有用,一般情况下不需要。
****************************************************************************/
 #undef FLUSH_OUTPUT_IMMEDIATELY

/****************************************************************************
这个定义允许在Lib中给与一些object以特权,除非你非常了解这个定义对于你所要撰写
 的Lib的用处,不然的话,不要定义这个。
****************************************************************************/
 #undef PRIVS

/****************************************************************************
下面这个定义可以使互动物件也适用catch_tell(),当然你就必须在user.c中写入catc
 h_tell()来处理receive(msg)。
****************************************************************************/
 #undef INTERACTIVE_CATCH_TELL

/****************************************************************************
受限制的ed模式
****************************************************************************/
 #define RESTRICTED_ED

/****************************************************************************
使用下面这个定义,你就不能在想要撰写的Lib中使用shadow,而shadow往往非常有用,
 所以除非你明确知道不需要,不然不要定义这个选项。
****************************************************************************/
 #undef NO_SHADOWS

/****************************************************************************
定义下面这个,可以snoop shadowed object,因为shadowed object可能不知道送过来
 的msg。
****************************************************************************/
 #undef SNOOP_SHADOWED

/****************************************************************************
这是一个有趣的定义,可以让你监听snooper的msg,也许利用起来比较有趣。当然也可
 以不定义它。
****************************************************************************/
 #define RECEIVE_SNOOP

/****************************************************************************
这不是一个非常准确的定义,如果你想知道物件调用函数的时候,使用了多少时间,可
 以用这个试试。不过不要对它的准确性基于太多的希望。
****************************************************************************/
 #define PROFILE_FUNCTIONS

/****************************************************************************
‘buffer’这个类型定义的选择,按所要撰写的Lib而定,如果你可能要用到这种变量定义
 ,就不要定义这个选项。
****************************************************************************/
 #undef NO_BUFFER_TYPE

/****************************************************************************
设置 pragma ’save_binary’ 的有效性。
 使用这个选项,可以是Lib运行速度有所提高,并且降低系统的开销。代价就是将占用更
 多的硬盘空间。
****************************************************************************/
 #define BINARIES

/****************************************************************************
允许定义数组变量,关键字array。比如 int array x = ({…});
不过估计这样定义也不会有人反对 int *x = ({});
定义这个选项与否,主要是看是不是习惯使用array这个声明,如果你来自C或者java,
 也许会喜欢的。
****************************************************************************/
 #define ARRAY_RESERVED_WORD

/****************************************************************************
这个同上,关键字ref。按照Lib撰写人的习惯来定义比较好。
****************************************************************************/
 #define REF_RESERVED_WORD

/****************************************************************************
扩充包是可选配件
 如果你定义了PACKAGE_XYZZY,那么你可以参看 packages/xyzzy.c 中的函数来确定可
 以使用哪些efuns。
 确定使用哪些扩充包,主要取决于提供的efuns是否是需要的。

****************************************************************************/

/****************************************************************************
这个扩充包的函数还是非常有用的,比如query_ip_port() repeat_string()等等。

****************************************************************************/

#define PACKAGE_CONTRIB

/****************************************************************************
下面这个包主要用来了解driver内部的信息。
****************************************************************************/
 #define PACKAGE_DEVELOP

/****************************************************************************

****************************************************************************/
 #define PACKAGE_MATH

/****************************************************************************
这个是图像处理包,不过,笔者也没用过。
****************************************************************************/
 #undef PACKAGE_MATRIX

/****************************************************************************
这个包的函数用来了解Mudlib的数据,比较实用。
****************************************************************************/
 #undef PACKAGE_MUDLIB_STATS

/****************************************************************************
呵呵,这个当然非常有用了。
****************************************************************************/
 #define PACKAGE_SOCKETS

/****************************************************************************
这个用处不大,尤其是中文使用者,呵呵
****************************************************************************/
 #undef PACKAGE_PARSER

/****************************************************************************
这个也没什么大的用处。允许driver在config文件里exe()命令清单
****************************************************************************/
 #undef PACKAGE_EXTERNAL

/****************************************************************************
外部扩展指令支持的数目
****************************************************************************/
 #ifdef PACKAGE_EXTERNAL
 #define NUM_EXTERNAL_CMDS
 #endif

/****************************************************************************
数据库支持包,想用数据库mysql的Lib撰写者比较有用,
****************************************************************************/
 //#define PACKAGE_DB
 #undef PACKAGE_DB
 /****************************************************************************
如果PACKAGE_DB被定义,必须选择下面中的一个来支持数据库
****************************************************************************/
 #ifdef PACKAGE_DB
 #define USE_MSQL 1 /* MiniSQL, it’s small; it’s free */
 #undef USE_MYSQL 2 /* MySQL, bigger; it’s free */
 #define DEFAULT_DB USE_MSQL /* default database */
 #endif

/****************************************************************************
  UID,就是用户有效识别码,国内的LPMud大多基于 wizard 以及 uid 系统,如果不
 是新Lib的撰写者,这个是比较有用的。如果你拥有了自己的理念,可以不使用这些定义
 。从MudOS开发者来看,他们也没有明确说不需要这些。虽然本人倒是比较喜欢放弃这些
 设定,但是这些设定的存在,确实可以方便很多的处理。
 如果你打算使用UID,那就定义下面这个选项。
****************************************************************************/
 #define PACKAGE_UIDS

/****************************************************************************
自动设定UID,那就不需要每次都seteuid(getuid(this_object()))。如果需要seteuid
 (0),那么不要定义这个,比如现在大多数的Lib。
****************************************************************************/
 #define AUTO_SETEUID

/****************************************************************************
 backbone这个设定是被自动认可的。
****************************************************************************/
 #define AUTO_TRUST_BACKBONE

/****************************************************************************
下面这些设定,一般情况下,不需要做出大的调整。
 资源问题,使用32位地址。
****************************************************************************/
 #undef USE_32BIT_ADDRESSES

/****************************************************************************
心跳时间,这里是一秒。
****************************************************************************/
 #define HEARTBEAT_INTERVAL 2000000

/****************************************************************************
 call_out的设定
****************************************************************************/
 #define CALLOUT_CYCLE_SIZE 64

/****************************************************************************
信息暂存设定
****************************************************************************/
 #define LARGEST_PRINTABLE_STRING 8192

/****************************************************************************
输出信息buffer设定
****************************************************************************/
 #define MESSAGE_BUFFER_SIZE 65536

/****************************************************************************
定义call_other cache的bits number
 6 64 1k
 8 256 4k
 10 1024 16k
 12 4096 64k
 14 16384 256k
 16 65536 1M
 ****************************************************************************/
 #define APPLY_CACHE_BITS 12

/****************************************************************************
 call_other的cache统计
****************************************************************************/
 #define CACHE_STATS

/****************************************************************************
不定义可以快一点。
****************************************************************************/
 #undef TRACE

/****************************************************************************
 LPC->C的编译
****************************************************************************/
 #undef LPC_TO_C

/****************************************************************************
看系统而定,一般不需要定义。
****************************************************************************/
 #undef RUNTIME_LOADING

/****************************************************************************
这个定义以后,允许被跟踪执行。
****************************************************************************/
 #undef TRACE_CODE

/****************************************************************************
缺省设定是32,主要关系到 heart_beat 的系统开销。
****************************************************************************/
 #define HEART_BEAT_CHUNK 64

/****************************************************************************
一般情况下,get_char不是bufferd。所以不太必要定义这个选项。
****************************************************************************/
 #undef GET_CHAR_IS_BUFFERED

/****************************************************************************
字符串定义。
****************************************************************************/
 #define SMALL_STRING_SIZE 100
 #define LARGE_STRING_SIZE 1000

/****************************************************************************
指令buffer定义。
****************************************************************************/
 #define COMMAND_BUF_SIZE 2000

/****************************************************************************
呵呵,如果dbase深度超过了25就会溢出,这个设定就是这里定义的。当年最常见的一个
 当机bug就是set指令的dbase溢出导致的。
****************************************************************************/
 #define MAX_SAVE_SVALUE_DEPTH 50

/****************************************************************************
 25个局部变量调用,对于一个函数来说,应该是够了。数数COMBAT_D中的attack()函数
 用到了几个局部变量。本人曾经定义超过25个变量,结果导致出错,但是那个时候不知
 道为什么,虽然预感到这一点,可以在mud配置文件中定义。
****************************************************************************/
 #define CFG_MAX_LOCAL_VARIABLES 100
 #define CFG_EVALUATOR_STACK_SIZE 2000
 #define CFG_MAX_CALL_DEPTH 100

/****************************************************************************
下面定义的必须选择 4, 16, 64, 256, 1024, 4096 中的一个数字
****************************************************************************/
 #define CFG_LIVING_HASH_SIZE 1024

/****************************************************************************
 NEXT_MALLOC_DEBUG: define this if using a NeXT and you want to enable
 the malloc_check() and/or malloc_debug() efuns. Run the ‘man malloc_debug’
command on the NeXT to find out what the arguments to malloc_debug(int)
 mean. The malloc_check() efun calls the NeXT NXMallocCheck() system
 call which does a consistency check on malloc’s data structures (this
 consistency check is done at each malloc() and free() for certain
 malloc_debug() levels). A non-zero return value indicates there was
 a consistency problem. For those NeXT users wanting a bit more
 performance out of malloc, try defining NEXT_MALLOC_DEBUG and calling the
 malloc_debug(-1) efun (with an arg of -1). This will turn all
 malloc debugging off and call malloc_singlethreaded() which the NeXT
 malloc man page claims can make NeXT system malloc 10% to 15% faster.

[NOTE: This #define has no affect on the driver if not using the
 NeXTSTEP OS.]

Warning: if you use a NeXT and define NEXT_MALLOC_DEBUG, be sure to
 protect the use of the malloc_check() and malloc_debug() efuns
 since setting certain debug levels can cause malloc() and free()
 to become _very_ slow (protect efuns by using simul_efuns and
 valid_override).

[NOTE: malloc_debug(6) is a good compromise between efficiency and
 completeness of malloc debugging (malloc/free will be about half as fast).]
 ****************************************************************************/
 #define NEXT_MALLOC_DEBUG

#endif

编译V14的时候编译DB
 option.h修改下列配置
#define PACKAGE_DB
 #ifdef PACKAGE_DB
 #undef USE_MSQL /* MiniSQL, it’s small; it’s free */
 #define USE_MYSQL 2 /* MySQL, bigger; it’s free */
 #define DEFAULT_DB USE_MYSQL /* default database */
 #endif

修改 db.h 头文件:
 将 24 行至 37 行注释掉,紧接着写上你自己的 MySQL 头文件的位置,
find / -name mysql.h 就找到了!
 例如在 /usr/local/mysql/include/mysql.h
就写上:
#include “/usr/local/mysql/include/mysql.h”

在源代码目录里的 system_libs 文件里加上 mysql 连接库的位置,
 例如在 /usr/local/mysql/lib
就加上:
-L/usr/local/mysql/lib -lmysqlclient

上一篇:第23章 排序算法(包括merge等)


下一篇:Sa yo na ra