__SOCKET函数
#include <sys/socket.h>
int socket(int domain, int type, int protocol);
/*
domain 套接字中使用的协议族(protocol family)信息
type 传输类型信息
protocol 通信协议信息
*/
//返回文件描述符fd(句柄),失败时返回-1
__BIND函数
#include <sys/socket.h>
int bind(int sockfd, struct sockaddr *myaddr, socklen_t addrlen);
// success -> return 0
// fail -> return -1
__LISTEN函数
#include <sys/socket.h>
int listen(int sockfd, int backlog);
// succ -> return 0
// fail -> return -1
__ACCEPT
#include <sys/socket.h>
int accept(int sockfd, struct sockaddr *addr, socklen_t *addrlen);
// succ -> return fd
// fail -> return -1
打开文件
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
int open(const char *path, int flag);
/* flag: O_CREAT 创建
O_TRUNC 删除全部现有数据重新写入
O_APPEND append
O_RDONLY 只读
O_WRONLY 只写
O_RDWR
*/
数据写入文件
#include <unistd.h>
ssize_t write(int fd, const void *buf, size_t nbytes);
// succ -> nbyte
// fail -> -1
读取文件数据
#include <unistd.h>
ssize_t read(int fd, void *buf, size_t nbyte);
// 成功时返回接受的字节数,(遇到文件结尾时返回0),失败返回-1
| ||||||||||||||||
bind(对socket定位) | |
相关函数 | socket,accept,connect,listen |
表头文件 | #include<sys/types.h> #include<sys/socket.h> |
定义函数 | int bind(int sockfd,struct sockaddr * my_addr,int addrlen); |
函数说明 | bind()用来设置给参数sockfd的socket一个名称。此名称由参数my_addr指向一sockaddr结构,对于不同的socket domain定义了一个通用的数据结构。 struct sockaddr { unsigned short int sa_family; char sa_data[14]; }; sa_family 为调用socket()时的domain参数,即AF_xxxx值。 sa_data 最多使用14个字符长度。 此sockaddr结构会因使用不同的socket domain而有不同结构定义,例如使用AF_INET domain,其socketaddr结构定义便为 struct socketaddr_in { unsigned short int sin_family; uint16_t sin_port; struct in_addr sin_addr; unsigned char sin_zero[8]; }; struct in_addr { uint32_t s_addr; }; sin_family 即为sa_family sin_port 为使用的port编号 sin_addr.s_addr 为IP 地址 sin_zero 未使用。 |
参数说明 | addrlen为sockaddr的结构长度。 |
返回值 | 成功则返回0,失败返回-1,错误原因存于errno中。 |
错误代码 | EBADF参数sockfd 非合法socket处理代码。 EACCESS权限不足 ENOTSOCK参数sockfd为一文件描述词,非socket。 |
范例 | 参考listen() |
connect(建立socket连线) | |
相关函数 | socket,bind,listen |
表头文件 | #include<sys/types.h> #include<sys/socket.h> |
定义函数 | int connect (int sockfd,struct sockaddr * serv_addr,int addrlen); |
函数说明 | connect()用来将参数sockfd 的socket 连至参数serv_addr 指定的网络地址。结构sockaddr请参考bind()。参数addrlen为sockaddr的结构长度。 |
返回值 | 成功则返回0,失败返回-1,错误原因存于errno中。 |
错误代码 | EBADF参数sockfd 非合法socket处理代码 EFAULT参数serv_addr指针指向无法存取的内存空间 ENOTSOCK参数sockfd为一文件描述词,非socket。 EISCONN参数sockfd的socket已是连线状态 ECONNREFUSED连线要求被server端拒绝。 ETIMEDOUT企图连线的操作超过限定时间仍未有响应。 ENETUNREACH无法传送数据包至指定的主机。 EAFNOSUPPORT sockaddr结构的sa_family不正确。 EALREADY socket为不可阻断且先前的连线操作还未完成。 |
范例 | /* 利用socket的TCP client * 此程序会连线TCP server,并将键盘输入的字符串传送给server。 * TCP server范例请参考listen()。 */ #include<sys/stat.h> #include<fcntl.h> #include<unistd.h> #include<sys/types.h> #include<sys/socket.h> #include<netinet/in.h> #include<arpa/inet.h>
#define PORT 1234 #define SERVER_IP “127.0.0.1” main() { int s; struct sockaddr_in addr; char buffer[256]; if ((s = socket(AF_INET,SOCK_STREAM,0))<0) { perror(“socket”); exit(1); }
/* 填写sockaddr_in结构*/ bzero(&addr,sizeof(addr)); addr.sin_family = AF_INET; addr.sin_port = htons(PORT); addr.sin_addr.s_addr = inet_addr(SERVER_IP); /* 尝试连线*/ if (connect(s,&addr,sizeof(addr))<0) { perror(“connect”); exit(1); }
/* 接收由server端传来的信息*/ recv(s,buffer,sizeof(buffer),0); printf(“%s\n”,buffer); while(1) { bzero(buffer, sizeof(buffer)); /* 从标准输入设备取得字符串*/ read(STDIN_FILENO, buffer, sizeof(buffer)); /* 将字符串传给server端*/ if (send(s, buffer, sizeof(buffer), 0)<0) { perror(“send”); exit(1); } } } |
执行 | $ ./connect Welcome to server! hi I am client! /*键盘输入*/ /*<Ctrl+C>中断程序*/ |
setprotoent(打开网络协议的数据文件) | |
相关函数 | getprotobyname, getprotobynumber, endprotoent |
表头文件 | #include <netdb.h> |
定义函数 | void setprotoent (int stayopen); |
函数说明 | setprotoent()用来打开/etc/protocols,如果参数stayopen值为1,则接下来的getprotobyname()或getprotobynumber()将不会自动关闭此文件。 |
setservent(打开主机网络服务的数据文件) | |
相关函数 | getservent, getservbyname, getservbyport, endservent |
表头文件 | #include < netdb.h > |
定义函数 | void setservent (int stayopen); |
函数说明 | setservent()用来打开/etc/services,如果参数stayopen值为1,则接下来的getservbyname()或getservbyport()将补回自动关闭文件。 |
setsockopt(设置socket状态) | |
相关函数 | getsockopt |
表头文件 | #include<sys/types.h> #include<sys/socket.h> |
定义函数 | int setsockopt(int s,int level,int optname,const void * optval,,socklen_toptlen); |
函数说明 | setsockopt()用来设置参数s所指定的socket状态。参数level代表欲设置的网络层,一般设成SOL_SOCKET以存取socket层。参数optname代表欲设置的选项,有下列几种数值: SO_DEBUG打开或关闭排错模式 SO_REUSEADDR允许在bind()过程中本地地址可重复使用 SO_TYPE返回socket形态。 SO_ERROR返回socket已发生的错误原因 SO_DONTROUTE送出的数据包不要利用路由设备来传输。 SO_BROADCAST使用广播方式传送 SO_SNDBUF设置送出的暂存区大小 SO_RCVBUF设置接收的暂存区大小 SO_KEEPALIVE定期确定连线是否已终止。 SO_OOBINLINE当接收到OOB 数据时会马上送至标准输入设备 SO_LINGER确保数据安全且可靠的传送出去。 |
参数 | optval代表欲设置的值,参数optlen则为optval的长度。 |
返回值 | 成功则返回0,若有错误则返回-1,错误原因存于errno。 |
附加说明 | EBADF参数s并非合法的socket处理代码。 ENOTSOCK参数s为一文件描述词,非socket。 ENOPROTOOPT参数optname指定的选项不正确。 EFAULT参数optval指针指向无法存取的内存空间。 |
范例 | 参考getsockopt()。 |
shutdown(终止socket通信) | |
相关函数 | socket,connect |
表头文件 | #include<sys/socket.h> |
定义函数 | int shutdown(int s,int how); |
函数说明 | shutdown()用来终止参数s所指定的socket连线。参数s是连线中的socket处理代码,参数how有下列几种情况: how=0 终止读取操作。 how=1 终止传送操作 how=2 终止读取及传送操作 |
返回值 | 成功则返回0,失败返回-1,错误原因存于errno。 |
错误代码 | EBADF参数s不是有效的socket处理代码。 ENOTSOCK参数s为一文件描述词,非socket。 ENOTCONN参数s指定的socket并未连线。 |
|