阅读Sofia-SIP源码 - su模块 - su.h

最新推荐文章于 2024-08-15 09:44:19 发布

Neohan

最新推荐文章于 2024-08-15 09:44:19 发布

阅读量1.3k

点赞数

本文链接：https://blog.csdn.net/neohan/article/details/51956685

版权

这篇博客主要探讨Sofia-SIP源码中的su模块，重点解析su.h头文件。内容涉及常量定义，如INVALID_SOCKET和SOCKET_ERROR，以及平台特定的socket描述符类型。文章还介绍了scatter-gather I/O的概念，并讨论了跨平台的socket API，如su_init和su_deinit函数。此外，还提到了su_is_blocking函数在非Windows平台的特殊实现。

摘要由CSDN通过智能技术生成

此头文件最开始部分都是约定俗成的内容，这里就不再多啰嗦了。然后是包含自身软件包内的头文件，以及针对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