Socket create

名称

   socket_create() - 创建一个 socket 连接

语法

   int socket_create( int mode, string|function read_callback );
   int socket_create( int mode, string|function read_callback, string|function close_callback );

描述

   socket_create() 创建一个 efun socket。参数 `mode` 决定要创建哪种模式的 socket。目前支持的 socket 模式为:

   MUD         使用 TCP 协议传输 LPC 类型数据
   STREAM      使用 TCP 协议传输原始数据
   DATAGRAM    使用 UDP 协议

   具体在<socket.h>头文件中有定义：

#ifndef SOCKET_H
#define SOCKET_H

#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
#define STREAM_TLS          5
#define STREAM_TLS_BINARY   6


#endif          /* SOCKET_H */

   参数 `read_callback` 是 socket 接收数据后驱动程序调用的函数名称，此函数原型应该是以下格式：

   void read_callback(int fd, mixed message, void|string addr);

   其中参数 `fd` 是接收到数据的 socket 连接；参数 `message` 是接收到的数据，在非二进制模式下返回值是 utf-8 格式的字符串，在二进制模式下返回值是 buffer；在UDP模式下，第三个参数 `addr` 为客户端IP地址。

   参数 `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>头文件中,具体文件内容如下：

/*
 * socket_errors.h -- definitions for efun socket error return codes.
 *    5-92 : Dwayne Fontenot (Jacques@TMI) : original coding.
 *   10-92 : Dave Richards (Cynosure) : less original coding.
 */

#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), socket_set_option(3)，valid_socket(4)

翻译

   雪风(i@mud.ren)