此头文件最开始部分都是约定俗成的内容,这里就不再多啰嗦了。然后是包含自身软件包内的头文件,以及针对BSD平台或WINDOWS平台包含不同的头文件。这些都很好理解。
然后是常量定义。首先,为BSD平台定义INVALID_SOCKET和SOCKET_ERROR这两个windows平台下特有的常量,以及定义软件包特有的两个常量:su_sucess和su_failure。再为上述最后两个常量各定义一个别名:SU_SUCESS和SU_FAILURE。以及其他一些常用的长度常量。
/* ---------------------------------------------------------------------- */
/* Constant definitions */
#if SU_HAVE_BSDSOCK || DOCUMENTATION_ONLY
enum {
/** Invalid socket descriptor, error from socket() or accept() */
INVALID_SOCKET = -1,
#define INVALID_SOCKET ((su_socket_t)INVALID_SOCKET)
/** Error from other socket calls */
SOCKET_ERROR = -1,
#define SOCKET_ERROR SOCKET_ERROR
/** Return code for a successful call */
su_success = 0,
/** Return code for an unsuccessful call */
su_failure = -1
};
#if SYMBIAN && !defined(MSG_NOSIGNAL)
#define MSG_NOSIGNAL (0)
#endif
#elif SU_HAVE_WINSOCK
enum {
su_success = 0,
su_failure = 0xffffffffUL
};
#define MSG_NOSIGNAL (0)
#endif
/**@HI Maximum size of host name. */
#define SU_MAXHOST (1025)
/**@HI Maximum size of service name. */
#define SU_MAXSERV (25)
/**@HI Maximum size of address in text format. */
#define SU_ADDRSIZE (48)
/**@HI Maximum size of port number in text format. */
#define SU_SERVSIZE (16)
#define SU_SUCCESS su_success
#define SU_FAILURE su_failure
紧接着是socket描述符类型。
#if SU_HAVE_BSDSOCK || DOCUMENTATION_ONLY
typedef int su_socket_t;
#elif SU_HAVE_WINSOCK
typedef SOCKET su_socket_t;
#endif
我们都知道windows平台和其他平台下的socket描述符不一致。windows平台的描述符类型是SOCKET,而其他平台是int。为了抹平不同平台下的差异,Sofia软件包又定义了一个su_socket_t类型作为socket描述符类型。
之前在阅读su_configure.h头文件时,遇到过SU_HAVE_SOCKADDR_STORAGE宏,不知道它的具体含义。这次在这个头文件中看到了使用它的地方。当初在头文件中我是这么注释的:
/** Define as 1 if you have struct sockaddr_storage */
#define SU_HAVE_SOCKADDR_STORAGE 1 widnows平台下看到有这个结构体,因此为1。
含义很明显,因为有这个结构体所以这个宏为1。但这个结构体有什么作用呢?因此我上网仔细查了查。找到了MSDN网页:https://msdn.microsoft.com/en-us/library/windows/desktop/ms740504(v=vs.85).aspx。网页上第一段就是对这个结构体的描述:
The SOCKADDR_STORAGE structure stores socket address information. Since the SOCKADDR_STORAGE structure is sufficiently large to store address information for IPv4, IPv6, or other address families, its use promotes protocol-family and protocol-version independence and simplifies cross-platform development. Use the SOCKADDR_STORAGE structure in place of the sockaddr structure.
typedef struct sockaddr_storage {
short ss_family;
char __ss_pad1[_SS_PAD1SIZE];
__int64 __ss_align;
char __ss_pad2[_SS_PAD2SIZE];
} SOCKADDR_STORAGE, *PSOC