网络编程套接字API

一. linux平台

1.创建套接字

成功返回文件描述符，失败返回-1
int socket (int __domain, int __type, int __protocol) ;

2.套接字绑定IP地址和端口号

成功返回0，失败返回-1
int bind (int __fd, __CONST_SOCKADDR_ARG __addr, socklen_t __len);

3.开启监听套接字

成功返回0，失败返回-1
int listen (int __fd, int __n) __THROW;

4.受理连接请求

成功返回文件描述符，失败返回-1int accept (int __fd, __SOCKADDR_ARG __addr,socklen_t *__restrict __addr_len);

5.发送数据

成功返回写入的字节数，失败返回-1
ssize_t write (int __fd, const void *__buf, size_t __n) __wur;

6.接收数据

成功返回接收的字节数(若遇到文件尾返回0)，失败返回-1
ssize_t read (int __fd, void *__buf, size_t __nbytes) __wur;

7.关闭套接字

成功返回0，失败返回-1
int close (int __fd);

8.优雅的关闭套接字

extern int shutdown (int __fd, int __how) __THROW;

9.发送连接请求

成功返回0，失败返回-1
int connect (int __fd, __CONST_SOCKADDR_ARG __addr, socklen_t __len);

10.域名获取IP地址

extern struct hostent *gethostbyname (const char *__name);

11.IP地址获取域名

extern struct hostent *gethostbyaddr (const void *__addr, __socklen_t __len,int __type);

12.获取套接字的可选项

int
extern int getsockopt (int __fd, int __level, int __optname,void *__restrict __optval,socklen_t *__restrict __optlen) __THROW;

13.设置套接字的可选项

/* Set socket FD's option OPTNAME at protocol level LEVELto *OPTVAL (which is OPTLEN bytes long).Returns 0 on success, -1 for errors.  */
extern int setsockopt (int __fd, int __level, int __optname,const void *__optval, socklen_t __optlen) __THROW;

---

二. Windows平台

1.Winsock库的初始化

进行Winsock编程时,首先必须调用WSAStartup函数,设置程序中用到的Winsock版本,并初始化相应版本的库。

成功返回0，失败返回非0的错误代码值
int
WSAAPI
WSAStartup(_In_ WORD wVersionRequested,_Out_ LPWSADATA lpWSAData);

2.Winsock库的注销

进行Winsock编程时,首先必须调用WSAStartup函数,设置程序中用到的Winsock版本,并初始化相应版本的库。

成功返回0，失败返回SOCKET_ERROR
int
WSAAPI
WSACleanup(void);

1.创建套接字

成功返回套接字句柄，失败返回INVALID_SOCKET
SOCKET
WSAAPI
socket(_In_ int af,_In_ int type,_In_ int protocol);

2.套接字绑定IP地址和端口号

成功返回0，失败返回SOCKET_ERROR
int
WSAAPI
bind(_In_ SOCKET s,_In_reads_bytes_(namelen) const struct sockaddr FAR * name,_In_ int namelen);

3.开启监听套接字

成功返回0，失败返回SOCKET_ERROR
int
WSAAPI
listen(_In_ SOCKET s,_In_ int backlog);

4.受理连接请求

成功返回套接字句柄，失败返回INVALID_SOCKET
SOCKET
WSAAPI
accept(_In_ SOCKET s,_Out_writes_bytes_opt_(*addrlen) struct sockaddr FAR * addr,_Inout_opt_ int FAR * addrlen);

5.发送数据

成功返回发送字节数，失败返回SOCKET_ERROR
int
WSAAPI
send(_In_ SOCKET s,_In_reads_bytes_(len) const char FAR * buf,_In_ int len,_In_ int flags);

6.接收数据

成功返回接收字节数(收到EOF时为0)，失败返回SOCKET_ERROR
int
WSAAPI
recv(_In_ SOCKET s,_Out_writes_bytes_to_(len, return) __out_data_source(NETWORK) char FAR * buf,_In_ int len,_In_ int flags);

7.关闭套接字

成功返回0，失败返回SOCKET_ERROR
int
WSAAPI
closesocket(_In_ SOCKET s);

8.优雅关闭套接字

int
WSAAPI
shutdown(_In_ SOCKET s,_In_ int how);

9.发送连接请求

成功返回0，失败返回SOCKET_ERROR
int
WSAAPI
connect(_In_ SOCKET s,_In_reads_bytes_(namelen) const struct sockaddr FAR * name,_In_ int namelen);

10.域名获取IP地址

struct hostent FAR *
WSAAPI
gethostbyname(_In_z_ const char FAR * name);

11.地址获取域名

struct hostent FAR *
WSAAPI
gethostbyaddr(_In_reads_bytes_(len) const char FAR * addr,_In_ int len,_In_ int type);

12.获取套接字的可选项

int
WSAAPI
getsockopt(_In_ SOCKET s,_In_ int level,_In_ int optname,_Out_writes_bytes_(*optlen) char FAR * optval,_Inout_ int FAR * optlen);

13.设置套接字的可选项

int
WSAAPI
setsockopt(_In_ SOCKET s,_In_ int level,_In_ int optname,_In_reads_bytes_opt_(optlen) const char FAR * optval,_In_ int optlen);