Socket create

来自MudWiki

名称

   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` 是 socket 接收数据后驱动程序调用的函数名称,此函数原型应该是以下格式:

   void read_callback(int fd, mixed message);

   其中参数 `fd` 是接收到数据的 socket 连接,参数 `message` 是接收到的数据。

   参数 `close_callback` 是 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)