socket_create
名称
socket_create() - 创建一个 efun socket
语法
int socket_create( int mode, string read_callback );
int socket_create( int mode, string read_callback, string close_callback );
描述
socket_create() 创建一个 efun socket。参数 `mode` 决定要创建哪种模式的 socket。目前支持的 socket 模式为:
MUD 使用 TCP 协议传输 LPC 类型数据
STREAM 使用 TCP 协议传输原始数据
DATAGRAM 使用 UDP 协议
------------------------------------------------
#define MUD 0 // for sending LPC data types using TCP protocol.
#define STREAM 1 // for sending raw data using TCP protocol.
#define DATAGRAM 2 // for using UDP protocol.
#define STREAM_BINARY 3
#define DATAGRAM_BINARY 4
------------------------------------------------
参数 `read_callback` 是在UDP协议下 socket 接收数据后驱动程序调用的函数名称，此函数原型应该是以下格式：
void read_callback(int fd, mixed message, string addr);
其中参数 `fd` 是接收到数据的 socket 连接；参数 `message` 是接收到的数据，在非二进制模式下返回值是 utf-8 格式的字符串，在二进制模式下返回值是 buffer；第三个参数 `addr` 为客户端地址。
参数 `close_callback` 是在TCP协议下 socket 意外关闭时驱动程序调用的函数名称（如不是通过 socket_close() 关闭）。此函数原型应该是以下格式：
void close_callback(int fd);
其中参数 `fd` 是被关闭的 socket 连接。注意：close_callback() 不能在 DATAGRAM 模式下使用。
返回值
成功时返回一个非负连接描述符，失败时返回以下意义的负值：
错误
EEMODENOTSUPP 不支持的 Socket 模式
EESOCKET 创建 socket 时的问题
EESETSOCKOPT 设置 socket 选项（setsockopt）时的问题
EENONBLOCK 设置非阻塞模式（non-blocking mode）时的问题
EENOSOCKS 没有空余的 efun sockets
EESECURITY 试图违反安全性
以上错误定义在驱动程序源文件的 `socket_err.h` 头文件中,具体文件内容如下：
-----------------------------------------
#ifndef _SOCKET_ERRORS_H
#define _SOCKET_ERRORS_H
#define EESUCCESS 1 /* Call was successful */
#define EESOCKET -1 /* Problem creating socket */
#define EESETSOCKOPT -2 /* Problem with setsockopt */
#define EENONBLOCK -3 /* Problem setting non-blocking mode */
#define EENOSOCKS -4 /* UNUSED */
#define EEFDRANGE -5 /* Descriptor out of range */
#define EEBADF -6 /* Descriptor is invalid */
#define EESECURITY -7 /* Security violation attempted */
#define EEISBOUND -8 /* Socket is already bound */
#define EEADDRINUSE -9 /* Address already in use */
#define EEBIND -10 /* Problem with bind */
#define EEGETSOCKNAME -11 /* Problem with getsockname */
#define EEMODENOTSUPP -12 /* Socket mode not supported */
#define EENOADDR -13 /* Socket not bound to an address */
#define EEISCONN -14 /* Socket is already connected */
#define EELISTEN -15 /* Problem with listen */
#define EENOTLISTN -16 /* Socket not listening */
#define EEWOULDBLOCK -17 /* Operation would block */
#define EEINTR -18 /* Interrupted system call */
#define EEACCEPT -19 /* Problem with accept */
#define EEISLISTEN -20 /* Socket is listening */
#define EEBADADDR -21 /* Problem with address format */
#define EEALREADY -22 /* Operation already in progress */
#define EECONNREFUSED -23 /* Connection refused */
#define EECONNECT -24 /* Problem with connect */
#define EENOTCONN -25 /* Socket not connected */
#define EETYPENOTSUPP -26 /* Object type not supported */
#define EESENDTO -27 /* Problem with sendto */
#define EESEND -28 /* Problem with send */
#define EECALLBACK -29 /* Wait for callback */
#define EESOCKRLSD -30 /* Socket already released */
#define EESOCKNOTRLSD -31 /* Socket not released */
#define EEBADDATA -32 /* sending data with too many nested levels */
#define ERROR_STRINGS 33 /* sizeof (error_strings) */
#endif /* SOCKET_ERRORS_H */
-----------------------------------------
参考
socket_accept(3), socket_bind(3), socket_close(3), socket_connect(3), socket_listen(3), socket_write(3), valid_socket(4)
翻译
雪风(i@mud.ren)