@lpc-lang/core 1.1.2-5.1

package/src/efuns/fluffos/zh-cn/system.zh-cn.h

@@ -0,0 +1,366 @@
+// system.h
+
+/**
+ * uptime()  -  返回自上次驱动重启以来经过的秒数
+ *
+ * 这个函数返回自上次驱动重启以来经过的秒数。
+ *
+ */
+int uptime( void );
+
+/**
+ * trace_start - 开始收集驱动跟踪信息
+ *
+ * 调用此函数将开始收集来自驱动的跟踪信息。这包括LPC函数级别的执行信息。
+ * 
+ * 跟踪收集将在 `trace_end()` 被调用或在 `auto_stop_sec` 秒后停止，该值默认为30秒。
+ * 
+ * 注意：不要让跟踪启用太长时间，否则会有耗尽内存的风险。
+ * @param filename 写入跟踪数据的文件 
+ * @param auto_stop_sec 收集跟踪数据之前的秒数，默认为30秒
+ */
+varargs void trace_start(string filename, int auto_stop_sec);
+
+/**
+ * trace_end - 停止收集驱动跟踪信息
+ *
+ * 调用此函数将停止活动的跟踪并将结果写出到`trace_start(filename)`提供的文件中。
+ * 
+ * 注意：不要让跟踪启用太长时间，否则会有耗尽内存的风险。
+ *
+ */
+void trace_end();
+
+/**
+ * time_ns() - 返回自1970年1月1日以来的纳秒数
+ *
+ * 返回自1970年1月1日午夜（GMT）以来经过的纳秒数。
+ *
+ */
+int time_ns( void );
+
+/**
+ * time() - 返回自1970年1月1日以来的秒数
+ *
+ * 返回自1970年1月1日午夜（GMT）以来经过的秒数。
+ *
+ */
+int time( void );
+
+/**
+ * sys_reload_tls() - 重新加载给定端口的TLS证书和密钥。
+ *
+ * 重新加载指定在配置文件中的端口索引的TLS证书和密钥。
+ * 
+ * 例如，如果您在配置中定义了external_port_1_tls，那么您可以调用sys_reload_tls(1)来重新加载
+ * 它。这允许您在不重启服务器的情况下更新证书和密钥。
+ * 
+ * 注意：
+ * - 在调用此函数之前，您必须覆盖磁盘上先前的证书/密钥文件。
+ * - 目前不支持为WebSocket端口重新加载TLS。
+ *
+ */
+void sys_reload_tls ( int port_index );
+
+/**
+ * sys_network_ports() - 显示活动网络端口
+ *
+ * 返回一个数组的数组；每个数组对应于正在被积极使用的网络端口。
+ *
+ */
+mixed *sys_network_ports(void);
+
+/**
+ * strptime() - 将字符串解析为本地时间
+ *
+ * 使用格式字符串解析给定的时间 'str'，请参见：
+ * https://man7.org/linux/man-pages/man3/strptime.3.html
+ *
+ */
+int strptime( string fmt, string str );
+
+/**
+ * strftime() - 将时间格式化为字符串
+ *
+ * 使用格式字符串格式化给定时间，请参见：
+ * https://man7.org/linux/man-pages/man3/strftime.3.html
+ *
+ */
+string strftime( string fmt, int time );
+
+/**
+ * shutdown() - 关闭驱动
+ *
+ * 此函数以受控的方式关闭驱动（与崩溃时关闭的方式相对）。'how'参数指定驱动应该将哪个
+ * 整数值传递给exit()。约定是当重启驱动的脚本也应该死亡时，将'how'传递为-1。
+ * 因此，重启命令将使用shutdown()，而停止命令将使用shutdown(-1)。脚本必须明确检查
+ * 返回值，以查看是否是-1，如果您希望使用此约定。显然，shutdown()是一个敏感函数，应该
+ * 受到保护。与exec()一样，使其安全的方式是添加一个同名的simul_efun，并进行适当的安全检查。
+ * 确保在master.c中设置valid_override(4)以保护against efun::shutdown()。
+ *
+ */
+varargs void shutdown( int how );
+
+/**
+ * set_reset - 修改对象的重置时间
+ *
+ * 将 'ob' 的重置时间设置为从现在起 'time' 秒。如果 'time' 被省略，
+ * 驱动程序的正常重置时间设置公式将应用于 'ob'，即：
+ * 
+ * 重置时间 = 当前时间 + 重置时间 / 2 + 随机(重置时间 / 2)
+ *
+ */
+varargs void set_reset( object ob, int time );
+
+/**
+ * set_eval_limit() - 设置最大评估成本
+ *
+ * set_eval_limit()，使用非零参数，设置允许任何一个线程的最大
+ * 评估成本，在此成本达到时，会发生运行时错误。使用零作为参数，
+ * 会将当前评估计数器设置为零，并返回最大成本。set_eval_limit(-1)
+ * 返回剩余的评估成本。
+ *
+ */
+void set_eval_limit( int );
+
+/**
+ * reset_eval_cost() - 重置剩余评估成本
+ *
+ * reset_eval_cost()，将剩余评估成本重置为最大评估成本。
+ * 
+ * 返回新的评估成本。
+ *
+ */
+int reset_eval_cost();
+
+/**
+ * replace_program() - 替换 this_object() 中的程序
+ *
+ * replace_program() 将 this_object() 中的程序替换为其继承的
+ * 对象的程序。字符串参数是要使用的对象的文件名。一旦替换
+ * 发生，当前对象实际上变成了那个其他对象的克隆，但保留了
+ * 当前的文件名和全局变量值。程序实际上不会在当前执行
+ * 完成之前被替换。
+ *
+ */
+void replace_program( string str );
+
+/**
+ * reclaim_objects - 回收任何残留对象
+ *
+ * 循环遍历所有已加载的对象，并释放任何它可以释放的残留对象。
+ * 这可能导致根据泥巴的编码释放大量内存。对象通常在一个
+ * 全局变量在多个对象中包含对其的指针时被留下残留，而该对象
+ * 被销毁。此 efun 返回在变量中遇到的被销毁对象的数量。
+ *
+ */
+int reclaim_objects( void );
+
+/**
+ * perf_counter_ns() - 以纳秒为单位提供纪元时间测量
+ *
+ * 返回自 1970 年 1 月 1 日午夜 (GMT) 起的纳秒数。
+ *
+ */
+int perf_counter_ns( void );
+
+/**
+ * max_eval_cost() - 返回最大评估成本
+ *
+ * max_eval_cost() 返回驱动程序决定进入无限循环之前可以执行的
+ * 指令数量。
+ *
+ */
+void max_eval_cost();
+
+/**
+ * localtime() - 转换为当地时间
+ *
+ * localtime() 将一个时间值（由 time() 返回）转换为一个
+ * 表示当地时间的值数组。过去使用 time() 获取 GMT (UTC) 中的时间，
+ * 然后使用本地定义确定与 GMT 的本地偏移。这个绕行的过程
+ * 不再必要。localtime() 返回秒、分钟和小时、天、月和年、
+ * 星期几、一年中的天数、本地时区的名称以及泥巴与 GMT 的
+ * 时差。此信息直接从操作系统检索，并提供给驱动程序，
+ * 无需使用泥巴特定的配置文件。
+ * 
+ * localtime() 返回一个包含上述值的数组。每个值的索引在
+ * localtime.h 中被象征性地定义。以下表总结了 localtime()
+ * 返回的数组。
+ * 
+ * int        LT_SEC      分钟后的秒数 (0..59)
+ * int        LT_MIN      小时后的分钟数 (0..59)
+ * int        LT_HOUR     自午夜以来的小时数 (0..23)
+ * int        LT_MDAY     月中的天数 (1..31)
+ * int        LT_MON      从一月起的月份数 (0..11)
+ * int        LT_YEAR     年份（保证 >= 1900）
+ * int        LT_WDAY     自周日以来的天数 (0..6)
+ * int        LT_YDAY     从 1 月 1 日起的天数 (0..365)
+ * int        LT_GMTOFF   自 GMT (UTC) 的秒数
+ * string     LT_ZONE     时区名称
+ * int        LT_ISDST    如果当前正在观察夏令时
+ *
+ */
+mixed *localtime( int time );
+
+/**
+ * inherits() - 确定对象是否继承给定文件
+ *
+ * inherits() 如果 obj 不继承文件，则返回 0；如果
+ * 继承了文件的最新副本，则返回 1；如果
+ * 继承了文件的旧副本，则返回 2。
+ * 
+ * 如果没有对象作为第二个参数传入，则此 efun 将默认为
+ * this_object()。
+ *
+ */
+int inherits( string file, object obj );
+
+/**
+ * inherit_list() - 获取对象的父对象列表
+ *
+ * 返回一个数组，包含 obj 继承的文件名。仅返回直接
+ * 继承的文件。例如，如果 A 继承 B，B 继承 C，
+ * inherit_list(A) 将返回一个数组包含 B，而不包含 C。
+ * 
+ * 如果没有对象被提供，此 efun 将默认为 this_object()。
+ *
+ */
+string *inherit_list( object obj );
+
+/**
+ * function_profile() - 获取对象的函数性能分析信息
+ *
+ * 返回 'ob' 的函数性能分析信息，如果 'ob' 没有指定，
+ * 则返回 this_object()。只有在驱动程序进行了 PROFILE_FUNCTIONS
+ * 编译时，这才可用。
+ *
+ */
+mixed *function_profile( object ob );
+
+/**
+ * function_exists()  -  查找对象中给定函数所在的文件
+ * @param str 要检查的函数名称
+ * @param ob 要检查的对象
+ * @returns 定义函数 'str' 的对象的文件名 'ob'。
+ * 返回值可以与 'file_name(ob)' 不同，如果函数是由一个继
+ * 承的对象定义的。
+ * 
+ * 如果函数未定义，则返回 0。
+ * 
+ * 请注意，function_exists() 不检查阴影。
+ * 
+ * 如果没有对象作为第二个参数传入，则此 efun 将默认为
+ * this_object()。
+ *
+ */
+varargs string function_exists( string str, object ob );
+
+/**
+ * flush_messages - 发送所有待处理的消息给用户
+ *
+ * 通常，消息会被排队，然后一次性发送，以最小化所需的
+ * 数据包数量。此 efun 强制所有待处理的消息立即写入。
+ * 如果没有指定用户，则所有用户的消息都会被刷新。
+ *
+ */
+int flush_messages();
+int flush_messages(object user);
+/**
+ * find_call_out() - 查找计划调用的呼叫
+ *
+ * 查找计划调用的呼叫，可以通过函数名称或句柄进行查找。
+ * 
+ * 如果参数是一个字符串，那么找到第一个计划执行的函数 'func' 的呼叫，返回剩余的时间（秒数）。
+ * 如果没有找到呼叫，则返回 -1。
+ * 
+ * 如果参数是一个整数，那么找到句柄为 'handle' 的呼叫，返回剩余的时间（秒数）。
+ * 如果没有找到呼叫，则返回 -1。
+ * 
+ * 这将找到通过 call_out() 或 call_out_walltime() 调度的呼叫。
+ * 
+ * 如果剩余时间是分数值，则结果将是一个整数，其值将被取整向下。
+ * 
+ * 示例：
+ * int handle = call_out("func", 10);
+ * printf("Remaining time: %O\n", find_call_out(handle));
+ * // 剩余时间：10
+ * 
+ * int handle = call_out("func", 10.75);
+ * printf("Remaining time: %O\n", find_call_out(handle));
+ * // 剩余时间：10
+ * 
+ * 此 efun 只会找到由 this_object() 初始化的呼叫。
+ *
+ */
+int find_call_out( string func ) ;
+int find_call_out( int handle ) ;
+
+/**
+ * eval_cost() - 返回剩余的评估成本
+ *
+ * eval_cost() 返回在驱动程序判断处于无限循环之前可以执行的指令数量。
+ *
+ */
+int eval_cost();
+
+/**
+ * errorp() - 确定给定变量是否为错误代码
+ *
+ * 如果 'arg' 是一个错误代码的整数，则返回 1。
+ * 
+ * 最终 efuns 将被修改为返回标准错误代码，以便可以使用如下代码：
+ * 
+ * if (errorp(result = efun_call()))
+ * printf("error = %d\n", result);
+ * 
+ * 将来，还将有一个 perror(result) efun 返回与特定错误整数相关的错误字符串。
+ *
+ */
+int errorp( mixed arg );
+
+/**
+ * error - 生成运行时错误
+ *
+ * 当调用 error() 时，将生成一个运行时错误 'err'。当前线程的执行将中止，调试日志将记录追踪信息。
+ * 'err' 本身允许最大长度为 2045 个字符，不包括最后一个可选的 '\n' 字符。
+ * 在处理错误之前，将移除可选的 '\n'，并在前面添加 '*'，并在后面附加一个无条件的 '\n'。
+ * @throws err
+ */
+void error( string err );
+
+/**
+ * deep_inherit_list() - 获取对象的祖先列表
+ *
+ * 返回一个数组，包含所有直接和间接继承自 obj 的对象的文件名。
+ * 
+ * 如果未提供对象，此 efun 将默认使用 this_object()。
+ *
+ */
+string *deep_inherit_list( object obj );
+
+/**
+ * ctime() - 返回时间字符串
+ *
+ * 返回一个包含当前日期和时间的字符串，参数 'clock' 是自 1970 年以来的秒数。
+ * 
+ * 如果未提供参数，将使用当前时间。
+ *
+ */
+string ctime(void| int clock );
+
+/**
+ * call_out_info() - 获取待处理的 call_out() 信息
+ *
+ * 获取所有待处理呼叫的信息。返回一个数组，其中数组中的每个项包含 4 个元素：对象、函数、延迟时间和可选参数。
+ *
+ */
+mixed *call_out_info( void );
+
+/**
+ * all_previous_objects() - 返回调用当前函数的对象数组
+ *
+ * 返回调用当前函数的对象数组。请注意，本地函数调用不会将 previous_object() 设置为当前对象，而是保持不变。
+ *
+ */
+object *all_previous_objects();

package/src/efuns/ldmud/defines.h

@@ -0,0 +1,69 @@
+// Driver-provided defines that are injected into each file
+
+#define LPC3                        1 /* always defined */
+#define __LDMUD__                   1 /* always defined */
+#define __EUIDS__                   1 /* always (for compatibility) */
+#define COMPAT_FLAG                 1 /* defined if the driver runs in compat mode */
+#define __COMPAT_MODE__             1 /* ditto */
+#define __STRICT_EUIDS__            1 /* defined if strict euid usage is enforced */
+#define __FILENAME_SPACES__         1 /* defined if filenames may contain spaces */
+
+// #define __MASTER_OBJECT__           "master_object" /* the name of the master object (in compat mode without leading '/') */
+// #define __FILE__                    "compiled_file" /* the name of the compiled file (in compat mode without leading '/') */
+#define __LINE__                    1 /* the current line number */
+#define __FUNCTION__                "function" /* the current function name */
+// #define __DIR__                     "directory_path" /* the directory path of the compiled file (in compat mode without leading '/') */
+#define __PATH__(n)                 "/path/" /* the directory path of the compiled file without the <n> trailing elements (in compat mode without leading '/') */
+// #define __VERSION__                 "version_string" /* the version string of the driver */
+#define __VERSION_MAJOR__           3 /* the major version number of the driver */
+#define __VERSION_MINOR__           6 /* the minor version number of the driver */
+#define __VERSION_MICRO__           1 /* the micro version number of the driver */
+#define __VERSION_PATCH__           1 /* the patchlevel of the driver; a 0 here means 'no patchlevel' */
+#define __VERSION_COMMITID__        "commit_id" /* the commit ID of the source of the driver (attention: it might be <unknown>, if the driver was not compiled from a git repository) */
+// #define __VERSION_LOCAL__           "local_level" /* the (optional) LOCAL_LEVEL, the user has defined */
+
+#define __DOMAIN_NAME__             "domain_name" /* the domain the host is part of */
+#define __HOST_IP_NUMBER__          "host_ip_number" /* the hosts IP number (as a string) */
+#define __HOST_NAME__               "hostname" /* the full hostname */
+#define __MAX_RECURSION__           1000 /* the max count of nested function calls (this is config.h:MAX_USER_TRACE) */
+#define __MAX_EVAL_COST__           1000 /* the max evaluation cost */
+#define __RESET_TIME__              1 /* default interval time between object resets */
+#define __CLEANUP_TIME__            1 /* default interval time between object cleanups */
+#define __ALARM_TIME__              1 /* the configured timing granularity */
+#define __HEART_BEAT_INTERVAL__     1 /* the configured heartbeat time */
+#define __SYNCHRONOUS_HEART_BEAT__  1 /* defined if synchronous heartbeats are enabled */
+#define __MAX_COMMAND_LENGTH__      1 /* the maximum length a command from command(), execute_command() or H_MODIFY_COMMAND can have */
+#define __EFUN_DEFINED__(name)      0 /* if the efun 'name' exists, this macro evaluates to " 1 ", else to " 0 " */
+#define __DRIVER_LOG__              "driver_log" /* the name of the default debug.log file (within the mudlib); undefined if a different name has been specified on the commandline */
+#define __WIZLIST__                 "wizlist" /* the name of the (mudlib) file from where the driver read the initial WIZLIST information. It is undefined if the driver was configured to not read the information */
+
+#define __MAX_MALLOC__              1000 /* the internal upper limit for total memory usage */
+#define __INT_MAX__                 2147483647 /* the largest integer number */
+#define __INT_MIN__                 -2147483648 /* the smallest integer number */
+#define __FLOAT_MAX__               1.0e+20 /* the largest (positive) float number */
+#define __FLOAT_MIN__               0.00000 /* the smallest (positive) float number */
+
+#define __LPC_NOSAVE__              1 /* always defined */
+#define __LPC_STRUCTS__             1 /* always defined */
+#define __LPC_LWOBJECTS__           1 /* always defined */
+#define __LPC_INLINE_CLOSURES__     1 /* always defined */
+#define __LPC_ARRAY_CALLS__         1 /* always defined */
+#define __BOOT_TIME__               1 /* the time() the driver was started */
+
+#define __ERQ_MAX_SEND__            1 /* the max size of the send buffer */
+#define __ERQ_MAX_REPLY__           1 /* the max size of the reply buffer */
+
+#define __IDNA__                    0 /* support for IDNA */
+#define __IPV6__                    0 /* support for IP v.6 */
+#define __MYSQL__                   0 /* support for mySQL */
+#define __PGSQL__                   0 /* support for PostgreSQL */
+#define __SQLITE__                  0 /* support for SQLite 3 */
+#define __XML_DOM__                 0 /* support for XML parsing */
+#define __MCCP__                    0 /* support for MCCP */
+#define __ALISTS__                  0 /* support for alists */
+#define __PCRE__                    0 /* support for PCRE (always defined) */
+#define __TLS__                     0 /* support for TLS (internal) */
+#define __GNUTLS__                  0 /* if __TLS__: TLS support provided by GnuTLS */
+#define __OPENSSL__                 0 /* if __TLS__: TLS support provided by OpenSSL */
+#define __GCRYPT__                  0 /* cryptographic routines provided by libgcrypt */
+#define __DEPRECATED__              0 /* support for obsolete and deprecated efuns */