O-CU-UP
[scp/ocu/5gnr.git] / Include / vos_socket.h
diff --git a/Include/vos_socket.h b/Include/vos_socket.h
new file mode 100644 (file)
index 0000000..712f688
--- /dev/null
@@ -0,0 +1,686 @@
+/******************************************************************************
+###############################################################################
+#   Copyright (c) [2017-2020] [ICT/CAS]                                        #
+#   Licensed under the ORAN Software License v1.0 (License)             #
+###############################################################################
+******************************************************************************/
+
+
+
+#ifndef        __VOS_SOCKET_H__
+#define        __VOS_SOCKET_H__
+
+#ifdef __cplusplus
+extern "C"{
+#endif
+
+#include "vos_types.h"
+#include <unistd.h>
+#include <sys/un.h>
+#include <sys/socket.h>
+#include <netinet/in.h>
+#include <net/if.h>
+#include <sys/ioctl.h>
+#include <netpacket/packet.h>
+#include "vos_sctp.h"
+#include "vos_linklist.h"
+
+/**
+ * socket地址联合体,可用于IPv4,IPv6,和unix类型的socket
+ */
+typedef union vos_sockaddr_u
+{
+    struct sockaddr         sa;     ///< 通用结构 
+    struct sockaddr_in      sin;    ///< IPv4 结构 
+    struct sockaddr_in6     sin6;   ///< IPv6 结构
+    struct sockaddr_un      un;     ///< unix 结构 
+    struct sockaddr_ll      raw;    ///< raw 结构
+}vos_sockaddr_t;
+
+/**
+ * 协议族
+*/
+typedef enum vos_domain_e{
+    VOS_AF_UNIX  = AF_UNIX,     ///< unix socket
+    VOS_AF_INET  = AF_INET,     ///< ipv4
+    VOS_AF_INET6 = AF_INET6,    ///< ipv6
+    VOS_AF_PACKET= AF_PACKET,   ///< 用于raw socket
+}vos_domain_t;
+
+/**
+ * socket类型
+*/
+typedef enum vos_socktype_e{
+    VOS_SOCK_STREAM = SOCK_STREAM,  ///< TCP
+    VOS_SOCK_DGRAM  = SOCK_DGRAM,   ///< UDP
+    VOS_SOCK_RAW    = SOCK_RAW,     ///< raw socket
+    VOS_SOCK_SEQPACKET    = SOCK_SEQPACKET,     ///< sctp one2many
+}vos_socktype_t;
+
+
+/**
+ * 将IP地址结构转换成IP地址字符串
+ * @param[in ]   af           协议族,VOS_AF_INET 或 VOS_AF_INET6
+ * @param[in ]   src          IP地址结构
+ * @param[out]   dst          用于存储转换结果的buf,
+ * @param[in ]   size         buf的大小
+ * @return       成功返回指向dst的指针,失败返回 NULL
+*/
+const CHAR *vos_inet_ntop(LONG af, const vos_sockaddr_t *src,CHAR *dst, socklen_t size);
+
+
+/**
+ * 将IP地址字符串转换成IP地址结构
+ * @param[in ]   af           协议族,VOS_AF_INET 或 VOS_AF_INET6
+ * @param[in ]   src          IP地址字符串
+ * @param[out]   dst          用于存储转换结果的IP地址结构,
+ * @return       成功返回 VOS_OK,失败则返回其他
+*/
+LONG vos_inet_pton(LONG af, const CHAR *src, vos_sockaddr_t *dst);
+
+
+
+/**
+ * 创建socket
+ * @param[in ]   domain        协议族
+ * @param[in ]   type          socket类型
+ * @param[out]   protocol      协议,一般填0
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_socket(vos_domain_t domain,vos_socktype_t type,LONG protocol);
+
+/**
+ * 为socket绑定地址
+ * @param[in ]   sockfd        要绑定的socket
+ * @param[in ]   my_addr       地址结构
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_bind(LONG sockfd,vos_sockaddr_t *my_addr);
+
+
+
+/**
+ * 为socket绑定地址
+ * @param[in ]   sockfd        要绑定的socket
+ * @param[in ]   family        协议族
+ * @param[in ]   port          端口号,当family为 VOS_AF_INET 和 VOS_AF_INET6 有效
+ * @param[in ]   addrStr       地址字符串,
+                                    当family为 VOS_AF_INET 和 VOS_AF_INET6 时为IP地址字符串,
+                                    当family为 VOS_AF_UNIX 时 为本地文件路径字符串
+ * @param[in ]   protocol      协议,当family为 VOS_AF_PACKET 时有效,为协议类型
+ * @param[in ]   ifName        网口名,当family为 VOS_AF_PACKET 时有效,为绑定的网口名
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_bind_str(LONG sockfd,vos_domain_t family,SHORT port,const CHAR *addrStr,SHORT protocol,const CHAR *ifName);
+
+
+/**
+ * 监听socket
+ * @param[in ]   sockfd        欲监听的socket
+ * @param[in ]   maxClient     最大连接数
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_listen(LONG sockfd, LONG maxClient);
+
+
+/**
+ * 获得连接请求
+ * @param[in ]   sockfd        被监听的socket
+ * @param[in ]   addr          客户端地址
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_accept(LONG sockfd,vos_sockaddr_t *addr);
+
+
+
+/**
+ * 建立与指定socket的连接
+ * @param[in ]   sockfd        欲建立连接的socket
+ * @param[in ]   con_addr      服务端地址
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_connect(LONG sockfd,vos_sockaddr_t *con_addr);
+
+
+
+/**
+ * 建立与指定socket的连接
+ * @param[in ]   sockfd        欲建立连接的socket
+ * @param[in ]   family        协议族
+ * @param[in ]   port          端口号,当family为 VOS_AF_INET 和 VOS_AF_INET6 有效
+ * @param[in ]   addrStr       服务端地址字符串,
+                                    当family为 VOS_AF_INET 和 VOS_AF_INET6 时为IP地址字符串,
+                                    当family为 VOS_AF_UNIX 时 为本地文件路径字符串
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_connect_str(LONG sockfd,vos_domain_t family,SHORT port,const CHAR *addrStr);
+
+
+/**
+ * 从已连接的socket的接收数据
+ * @param[in ]   sockfd        已建立连接的socket
+ * @param[in ]   buf           存储数据的缓冲区
+ * @param[in ]   len           buf的大小
+ * @param[in ]   flags         参考 系统 recv 函数
+ * @return       成功返回 接收的字节数 ,失败则返回 VOS_ERROR
+*/
+LONG vos_recv(LONG sockfd, VOID *buf, size_t len, LONG flags);
+
+/**
+ * 向已连接的socket的发送数据
+ * @param[in ]   sockfd        已建立连接的socket
+ * @param[in ]   buf           存储数据的缓冲区
+ * @param[in ]   len           buf的大小
+ * @param[in ]   flags         参考 系统 recv 函数
+ * @return       成功返回 发送的字节数 ,失败则返回 VOS_ERROR
+*/
+LONG vos_send(LONG sockfd, const VOID *buf, size_t len, LONG flags);
+
+/**
+ * 从socket中接收数据
+ * @param[in ]   sockfd        socket
+ * @param[in ]   buf           存储数据的缓冲区
+ * @param[in ]   len           buf的大小
+ * @param[in ]   flags         参考 系统 recv 函数
+ * @param[in ]   src_addr      数据来源端的地址
+ * @return       成功返回 接收的字节数 ,失败则返回 VOS_ERROR
+*/
+LONG vos_recvfrom(LONG sockfd, void *buf, size_t len, LONG flags,vos_sockaddr_t *src_addr);
+
+/**
+ * 向socket中发送数据
+ * @param[in ]   sockfd        socket
+ * @param[in ]   buf           存储数据的缓冲区
+ * @param[in ]   len           buf的大小
+ * @param[in ]   flags         参考 系统 sendto 函数
+ * @param[in ]   dest_addr     数据发送的目的地址
+ * @return       成功返回 发送的字节数 ,失败则返回 VOS_ERROR
+*/
+LONG vos_sendto(LONG sockfd, const void *buf, size_t len, LONG flags,const vos_sockaddr_t *dest_addr);
+
+
+
+/**
+ * 获取 本地的 IP 地址
+ * @param[in ]   sockfd        socket
+ * @param[out]   addr          用于存放地址
+ * @return       成功返回 地址个数,失败则返回 VOS_ERROR
+*/
+LONG vos_getsockname(LONG sockfd,vos_sockaddr_t *addr);
+
+/**
+ * 获取 对端的 IP 地址
+ * @param[in ]   sockfd       socket
+ * @param[out]   addr         用于存放地址
+ * @return       成功返回 地址个数,失败则返回 VOS_ERROR
+*/
+LONG vos_getpeername(LONG sockfd, vos_sockaddr_t *addr);
+
+
+/**
+ * 向raw socket中发送数据
+ * @param[in ]   sockfd        socket
+ * @param[in ]   ifName        用于数据发送的网口名
+ * @param[in ]   buf           存储数据的缓冲区
+ * @param[in ]   len           buf的大小
+ * @param[in ]   flags         参考 系统 sendto 函数
+ * @return       成功返回 发送的字节数 ,失败则返回 VOS_ERROR
+*/
+LONG vos_raw_sendto(LONG sockfd,const CHAR *ifName, const void *buf, size_t len, LONG flags);
+
+
+/**
+ * 填充vos_sockaddr_t地址结构
+ * @param[in ]   socket        相关的socket,当family 为VOS_AF_PACKET时有效
+ * @param[out]   my_addr       被填充的 vos_sockaddr_t 变量
+ * @param[in ]   family        协议族
+ * @param[in ]   port          端口号,当family为 VOS_AF_INET 和 VOS_AF_INET6 有效
+ * @param[in ]   addrStr       地址字符串,
+                                    当family为 VOS_AF_INET 和 VOS_AF_INET6 时为IP地址字符串,
+                                    当family为 VOS_AF_UNIX 时 为本地文件路径字符串
+ * @param[in ]   protocol      协议,当family为 VOS_AF_PACKET 时有效,为协议类型
+ * @param[in ]   ifName        网口名,当family为 VOS_AF_PACKET 时有效,为绑定的网口名
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_addr_fill(LONG socket,vos_sockaddr_t *my_addr,vos_domain_t family,SHORT port,const CHAR *addrStr,SHORT protocol,const CHAR *ifName);
+
+
+/**
+ * 获取本机网口的MAC地址
+ * @param[in ]   ifName        网口名
+ * @param[out]   addr          MAC 地址
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_get_if_mac_addr(const CHAR *ifName,UCHAR addr[6]);
+
+/**
+ * 创建unix udp socket,包含创建、绑定和监听
+ * @param[in ]   local_path       本地文件路径
+ * @param[in ]   isbind           是否绑定端口
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_unix_udp_socket_create(const CHAR *local_path,BOOL isbind);
+
+
+/**
+ * 创建unix tcp socket,包含创建、绑定和监听
+ * @param[in ]   local_path       本地文件路径
+ * @param[in ]   maxClient        最大连接数
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_unix_tcp_server_socket_create(const CHAR *local_path, LONG maxClient);
+
+
+/**
+ * 创建unix tcp socket,包含创建和连接
+ * @param[in ]   local_path       本地文件路径
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_unix_tcp_client_socket_create(const CHAR *local_path);
+
+
+/**
+ * 创建tcp socket,包含创建、绑定和监听
+ * @param[in ]   family        VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   addrStr       IPv4/IPv6 地址
+ * @param[in ]   port          端口号
+ * @param[in ]   maxClient     最大连接数
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_tcp_server_socket_create(vos_domain_t family,const CHAR *addrStr,SHORT port, LONG maxClient);
+
+/**
+ * 创建tcp socket,包含创建和连接
+ * @param[in ]   family        VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   addrStr       IPv4/IPv6 地址
+ * @param[in ]   port          端口号
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_tcp_client_socket_create(vos_domain_t family,const CHAR *addrStr,SHORT port);
+
+/**
+ * 创建udp socket,包含创建、绑定
+ * @param[in ]   family        VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   addrStr       IPv4/IPv6 地址
+ * @param[in ]   port          端口号
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_udp_server_socket_create(vos_domain_t family,const CHAR *addrStr,SHORT port);
+
+/**
+ * 创建udp socket,包含创建并返回server 地址结构
+ * @param[in ]   family          VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   s_addrStr       IPv4/IPv6 地址
+ * @param[in ]   s_port          端口号
+ * @param[out]   s_addr          s_addr 由s_addrStr和s_port生成的地址结构
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_udp_client_socket_create(vos_domain_t family,const CHAR *s_addrStr,SHORT s_port,vos_sockaddr_t *s_addr);
+
+
+/**
+ * 创建raw socket,包含创建、绑定
+ * @param[in ]   protocol      协议
+ * @param[in ]   ifName        网口名
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_raw_server_socket_create(SHORT protocol,const CHAR *ifName);
+
+
+/**
+ * 创建sctp socket 绑定,可以指定多个地址,
+ * 如果 sock 参数为 IPv4 套接字,则传送给 sctp_bindx() 函数的地址必须为 IPv4 地址。
+ * 如果 sock 参数为 IPv6 套接字,则传送给 sctp_bindx() 函数的地址可以为 IPv4 或 IPv6 地址。
+ * @param[in ]   sockfd        要绑定的socket
+ * @param[in ]   addrs         地址数组
+ * @param[in ]   addrcnt       地址个数
+ * @param[in ]   flags         有如下取值:
+ *                  SCTP_BINDX_ADD_ADDR 指示 SCTP 将给定地址添加到关联中
+ *                  SCTP_BINDX_REM_ADDR 指示 SCTP 从关联中删除给定地址
+ * @return       成功返回 VOS_OK,失败则返回 其他
+*/
+LONG vos_sctp_bindx(LONG sockfd, vos_sockaddr_t *addrs, LONG addrcnt, LONG flags);
+
+
+/**
+ * 创建sctp socket 绑定,可以指定多个地址,
+ * 如果 sock 参数为 IPv4 套接字,则传送给 sctp_bindx() 函数的地址必须为 IPv4 地址。
+ * 如果 sock 参数为 IPv6 套接字,则传送给 sctp_bindx() 函数的地址可以为 IPv4 或 IPv6 地址。
+ * @param[in ]   sockfd        要绑定的socket
+ * @param[in ]   family        协议族,VOS_AF_INET 和 VOS_AF_INET6 有效
+ * @param[in ]   port          端口号 
+ * @param[in ]   addrStr       地址字符串数组
+ * @param[in ]   addrcnt       地址个数
+ * @param[in ]   flags         有如下取值:
+ *                  SCTP_BINDX_ADD_ADDR 指示 SCTP 将给定地址添加到关联中
+ *                  SCTP_BINDX_REM_ADDR 指示 SCTP 从关联中删除给定地址
+ * @return       成功返回 VOS_OK,失败则返回 其他
+*/
+LONG vos_sctp_bindx_str(LONG sockfd,vos_domain_t family,SHORT port,CHAR *addrStr[], LONG addrcnt, LONG flags);
+
+
+
+/**
+ * 建立与指定socket的连接
+ * @param[in ]   sockfd        欲建立连接的socket
+ * @param[in ]   addrs         地址数组
+ * @param[in ]   addrcnt       地址个数
+ * @param[out]   id            关联ID
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_sctp_connectx(LONG sockfd, vos_sockaddr_t *addrs, LONG addrcnt,sctp_assoc_t *id);
+
+
+/**
+ * 建立与指定socket的连接
+ * @param[in ]   sockfd        欲建立连接的socket
+ * @param[in ]   family        协议族
+ * @param[in ]   port          端口号,当family为 VOS_AF_INET 和 VOS_AF_INET6 有效
+ * @param[in ]   addrStr       地址字符串数组
+ * @param[in ]   addrcnt       地址个数
+ * @param[out]   id            关联ID
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_sctp_connectx_str(LONG sockfd,vos_domain_t family,SHORT port,CHAR *addrStr[], LONG addrcnt,sctp_assoc_t *id);
+
+
+/**
+ * 向socket发送数据
+ * @param[in ]   sockfd        socket
+ * @param[in ]   msg           存储数据的缓冲区
+ * @param[in ]   len           msg的大小
+ * @param[in ]   sinfo         包含用于发送消息的参数。可以指定,流、ppid、TTL、关联 ID等。
+ * @param[in ]   flags         此值在将逻辑运算 OR 以按位形式应用于以下零个或多个标志位时形成:
+ *                              MSG_UNORDERED :设置此标志之后,vos_sctp_sendmsg() 函数将无序传送消息。
+ *                              MSG_ADDR_OVER:设置此标志之后,vos_sctp_sendmsg() 函数将使用 to 参数中的地址,而不使用关联的主要目标地址。此标志仅用于一对多风格 SCTP 套接字。
+ *                              MSG_ABORT:设置此标志之后,指定的关联将异常中止,同时向其对等方发送 ABORT 信号。此标志仅用于一对多风格 SCTP 套接字。
+ *                              MSG_EOF:设置此标志之后,指定的关联将进入正常关闭状态。此标志仅用于一对多风格 SCTP 套接字。
+ * @return       成功返回 发送的字节数 ,失败则返回 VOS_ERROR
+*/
+LONG vos_sctp_send(LONG sockfd, const void *msg, size_t len,const struct sctp_sndrcvinfo *sinfo, LONG flags);
+
+
+
+/**
+ * 向socket发送数据
+ * @param[in ]   sockfd        socket
+ * @param[in ]   msg           存储数据的缓冲区
+ * @param[in ]   len           msg的大小
+ * @param[in ]   to            目的地址
+ * @param[in ]   ppid          协议无关的一个自定义值,一般填0即可
+ * @param[in ]   flags         同vos_sctp_send
+ * @param[in ]   stream_no     此消息的目标流
+ * @param[in ]   timetolive    TTL 以毫秒为单位,0表示无限生命期。
+ * @param[in ]   context       一个本地标志,用于检测无法发送到对端的消息,一般填0即可
+ * @return       成功返回 发送的字节数 ,失败则返回 VOS_ERROR
+*/
+LONG vos_sctp_sendmsg(LONG sockfd, const void *msg, size_t len, vos_sockaddr_t *to,
+                        LONG ppid, LONG flags,
+                        LONG stream_no, LONG timetolive, LONG context);
+
+
+
+/**
+ * 从socket接收数据
+ * @param[in ]   sockfd        socket
+ * @param[out]   msg           存储数据的缓冲区
+ * @param[in ]   len           msg的大小
+ * @param[in ]   from          源地址
+ * @param[out]   sinfo         包含接收消息的参数。包含流、ppid、TTL、关联 ID等。
+ * @param[out]   msg_flags     同vos_sctp_send
+ * @return       成功返回 接收的字节数 ,失败则返回 VOS_ERROR
+*/
+LONG vos_sctp_recvmsg(LONG sockfd, void *msg, size_t len, vos_sockaddr_t *from,
+                        struct sctp_sndrcvinfo *sinfo,
+                        LONG *msg_flags);
+
+/**
+ * 获取 socket 选项参数
+ * @param[in ]   sockfd        sctp socket
+ * @param[in ]   level         选项定义的层次;支持SOL_SOCKET、IPPROTO_SCTP、IPPROTO_TCP、IPPROTO_IP和IPPROTO_IPV6。
+ * @param[in ]   optname       需获取的选项
+ * @param[out]   optval        存放获取的值
+ * @param[in ]   optlen        optval的大小
+ * @param[out]   optlen        获取的大小
+ * @return       成功返回 VOS_OK,失败则返回 其他
+*/
+LONG vos_getsockopt(LONG sockfd, LONG level, LONG optname,void *optval, socklen_t *optlen);
+
+
+/**
+ * 设置 socket 选项参数
+ * @param[in ]   sockfd        sctp socket
+ * @param[in ]   level         同 vos_getsockopt
+ * @param[in ]   optname       需设置的选项
+ * @param[in ]   optval        要设置的值
+ * @param[in ]   optlen        optval的大小
+ * @return       成功返回 VOS_OK,失败则返回 其他
+*/
+LONG vos_setsockopt(LONG sockfd, LONG level, LONG optname,const void *optval, socklen_t optlen);
+
+
+/**
+ * 关闭文件描述符
+ * @param[in ]   sockfd        socket
+ * @return       成功返回 VOS_OK,失败则返回 其他
+*/
+LONG vos_close(LONG sockfd);
+
+
+/**
+ * 从一对多式socket的关联标识id中抽取一个一对一式socket
+ * @param[in ]   sockfd        一对多式socket
+ * @param[in ]   assoc_id      关联标识id
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_sctp_peeloff(LONG sockfd, sctp_assoc_t assoc_id);
+
+
+/**
+ * 获取 SCTP 相关的 socket 选项参数
+ * @param[in ]   sockfd        sctp socket
+ * @param[in ]   assoc_id      关联标识id
+ * @param[in ]   opt           SCTP 相关的 socket 选项
+ * @param[out]   arg           用于存放参数
+ * @param[out]   size          参数的大小
+ * @return       成功返回 VOS_OK,失败则返回 其他
+*/
+LONG vos_sctp_opt_info(LONG sockfd, sctp_assoc_t assoc_id, LONG opt, void *arg, socklen_t *size);
+
+
+/**
+ * 获取 对端的 IP 地址,使用完需要调用 vos_sctp_freepaddrs 释放资源
+ * @param[in ]   sockfd        sctp socket
+ * @param[in ]   assoc_id      关联标识id
+ * @param[out]   addrs         用于存放地址
+ * @return       成功返回 地址个数,失败则返回 VOS_ERROR
+*/
+LONG vos_sctp_getpaddrs(LONG sockfd, sctp_assoc_t assoc_id,vos_sockaddr_t **addrs);
+
+
+/**
+ * 释放由 vos_sctp_getpaddrs 函数分配的资源,获取到 0 个时不需要释放
+ * @param[out]   addrs         vos_sctp_getpaddrs 返回的地址
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_sctp_freepaddrs(vos_sockaddr_t *addrs);
+
+/**
+ * 获取 本地的 IP 地址,使用完需要调用 vos_sctp_freepaddrs 释放资源
+ * @param[in ]   sockfd        sctp socket
+ * @param[in ]   assoc_id      关联标识id
+ * @param[out]   addrs         用于存放地址
+ * @return       成功返回 地址个数,失败则返回 VOS_ERROR
+*/
+LONG vos_sctp_getladdrs(LONG sockfd, sctp_assoc_t assoc_id,vos_sockaddr_t **addrs);
+
+/**
+ * 释放由 vos_sctp_getladdrs 函数分配的资源,获取到 0 个时不需要释放
+ * @param[out]   addrs         vos_sctp_getladdrs 返回的地址
+ * @return       成功返回 VOS_OK ,失败则返回 其他
+*/
+LONG vos_sctp_freeladdrs(vos_sockaddr_t *addrs);
+
+/**
+ * 判断字符串是否为IPv4地址
+ * @param[in ]   str        待判断字符串
+ * @return       是返回 TRUE ,否返回 FALSE
+*/
+BOOL vos_is_ipv4_addr(CHAR *str);
+
+/**
+ * 判断字符串是否为IPv6地址
+ * @param[in ]   str        待判断字符串
+ * @return       是返回 TRUE ,否返回 FALSE
+*/
+BOOL vos_is_ipv6_addr(char *str);
+
+/**
+ * 判断两个addr是否相等
+ * @param[in ]   addr1        待判断地址结构
+ * @param[in ]   addr2        待判断地址结构
+ * @param[in ]   ignPort      是否忽略端口号
+ * @return       相等则返回0,不相等返回非0
+*/
+LONG vos_sock_addr_cmp(vos_sockaddr_t *addr1,vos_sockaddr_t *addr2,BOOL ignPort);
+
+
+/**
+ * addr 地址结构转换成用于打印的字符串
+ * @param[in ]   addr        地址结构
+ * @param[in ]   str         用于存放生成的字符串
+ * @param[in ]   size        str大小
+ * @return       返回指向str的指针
+*/
+CHAR *vos_addr_showstr(vos_sockaddr_t *addr,CHAR *str,LONG size);
+
+
+/**
+ * 创建sctp 一对一 socket,包含创建、绑定和监听
+ * @param[in ]   family        VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   addrs         地址数组
+ * @param[in ]   addrcnt       地址个数
+ * @param[in ]   port          端口号
+ * @param[in ]   maxClient     最大连接数
+ * @param[in ]   initmsg       sctp 相关信息
+ * @param[in ]   events        sctp 事件,如果传入 NULL 则默认监听 data_io
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_sctp_server_one2one_create(vos_domain_t family,vos_sockaddr_t *addrs,LONG addrcnt, SHORT port, LONG maxClient,struct sctp_initmsg *initmsg,struct sctp_event_subscribe *events);
+
+/**
+ * 创建sctp 一对一 socket,包含创建 和 连接
+ * @param[in ]   family        VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   s_addrs       地址数组
+ * @param[in ]   s_addrcnt     地址个数
+ * @param[in ]   s_port        端口号
+ * @param[in ]   initmsg       sctp 相关信息
+ * @param[in ]   events        sctp 事件,如果传入 NULL 则默认监听 data_io
+ * @param[out]   id            sctp_assoc id
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_sctp_client_one2one_create(vos_domain_t family,vos_sockaddr_t *s_addrs,LONG s_addrcnt, SHORT s_port,
+                                                    struct sctp_initmsg *initmsg,struct sctp_event_subscribe *events,sctp_assoc_t *id);
+
+
+/**
+ * 通过字符串地址创建sctp 一对一 socket,包含创建 和 连接
+ * @param[in ]   family        VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   s_addrStr     地址数组
+ * @param[in ]   s_addrcnt     地址个数
+ * @param[in ]   s_port        端口号
+ * @param[in ]   initmsg       sctp 相关信息
+ * @param[in ]   events        sctp 事件,如果传入 NULL 则默认监听 data_io
+ * @param[out]   id            sctp_assoc id
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_sctp_client_one2one_str_create(vos_domain_t family,CHAR *s_addrStr[],LONG s_addrcnt, SHORT s_port,
+                                                    struct sctp_initmsg *initmsg,struct sctp_event_subscribe *events,sctp_assoc_t *id);
+
+
+/**
+ * 创建sctp 一对一 socket,包含创建、绑定和监听
+ * @param[in ]   family        VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   addrStr       地址字符串数组
+ * @param[in ]   addrcnt       地址个数
+ * @param[in ]   port          端口号
+ * @param[in ]   maxClient     最大连接数
+ * @param[in ]   initmsg       sctp 相关信息
+ * @param[in ]   events        sctp 事件,如果传入 NULL 则默认监听 data_io
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_sctp_server_one2one_str_create(vos_domain_t family,CHAR *addrStr[],LONG addrcnt, SHORT port, LONG maxClient,struct sctp_initmsg *initmsg,struct sctp_event_subscribe *events);
+
+
+/**
+ * 创建sctp 一对多 socket,包含创建、绑定和监听
+ * @param[in ]   family        VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   addrs         地址数组
+ * @param[in ]   addrcnt       地址个数
+ * @param[in ]   port          端口号
+ * @param[in ]   maxClient     最大连接数
+ * @param[in ]   initmsg       sctp 相关信息
+ * @param[in ]   events        sctp 事件,如果传入 NULL 则默认监听 data_io
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_sctp_server_one2many_create(vos_domain_t family,vos_sockaddr_t *addrs,LONG addrcnt, SHORT port, LONG maxClient,struct sctp_initmsg *initmsg,struct sctp_event_subscribe *events);
+
+/**
+ * 创建sctp 一对多 socket,包含创建
+ * @param[in ]   family        VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   s_addrs       地址数组
+ * @param[in ]   s_addrcnt     地址个数
+ * @param[in ]   s_port        端口号
+ * @param[in ]   initmsg       sctp 相关信息
+ * @param[in ]   events        sctp 事件,如果传入 NULL 则默认监听 data_io
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_sctp_client_one2many_create(vos_domain_t family,vos_sockaddr_t *s_addrs,LONG s_addrcnt, SHORT s_port,
+                                               struct sctp_initmsg *initmsg,struct sctp_event_subscribe *events);
+
+/**
+ * 创建sctp 一对多 socket,包含创建、绑定和监听
+ * @param[in ]   family        VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   addrStr       地址字符串数组
+ * @param[in ]   addrcnt       地址个数
+ * @param[in ]   port          端口号
+ * @param[in ]   maxClient     最大连接数
+ * @param[in ]   initmsg       sctp 相关信息
+ * @param[in ]   events        sctp 事件,如果传入 NULL 则默认监听 data_io
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_sctp_server_one2many_str_create(vos_domain_t family,CHAR *addrStr[],LONG addrcnt, SHORT port, LONG maxClient,struct sctp_initmsg *initmsg,struct sctp_event_subscribe *events);
+
+/**
+ * 通过字符串地址创建sctp 一对多 socket,包含创建
+ * @param[in ]   family        VOS_AF_INET 和 VOS_AF_INET6
+ * @param[in ]   s_addrStr     地址数组
+ * @param[in ]   s_addrcnt     地址个数
+ * @param[in ]   s_port        端口号
+ * @param[in ]   initmsg       sctp 相关信息
+ * @param[in ]   events        sctp 事件,如果传入 NULL 则默认监听 data_io
+ * @return       成功返回 文件描述符,失败则返回 其他
+*/
+LONG vos_sctp_client_one2many_str_create(vos_domain_t family,CHAR *s_addrStr[],LONG s_addrcnt, SHORT s_port,
+                                                     struct sctp_initmsg *initmsg,struct sctp_event_subscribe *events);
+
+
+LONG vos_udp_client_socket_create_bind(vos_domain_t family,const CHAR *s_addrStr,SHORT s_port,vos_sockaddr_t *s_addr,vos_sockaddr_t *my_addr);
+
+LONG vos_tcp_client_socket_create_bind(vos_domain_t family,const CHAR *addrStr,SHORT port,vos_sockaddr_t *my_addr);
+
+LONG vos_sctp_client_one2one_create_bind(vos_domain_t family,vos_sockaddr_t *s_addrs,LONG s_addrcnt, SHORT s_port,
+                                                    struct sctp_initmsg *initmsg,struct sctp_event_subscribe *events,sctp_assoc_t *id,
+                                                    vos_sockaddr_t *my_addrs,LONG my_addrcnt);
+
+LONG vos_sctp_client_one2many_create_bind(vos_domain_t family,vos_sockaddr_t *s_addrs,LONG s_addrcnt, SHORT s_port,
+                                               struct sctp_initmsg *initmsg,struct sctp_event_subscribe *events,
+                                               vos_sockaddr_t *my_addrs,LONG my_addrcnt);
+
+
+#ifdef __cplusplus
+}
+#endif /* end of __cplusplus */
+
+#endif /* end of __VOS_SOCKET_H__ */
+