linux socket 编程中主要函数解析

1. socket()
2. bind()
3. connect()
4. listen()
5. accept()
6. send()和recv()
7. sendto()和recvfrom()
8. close()和shutdown()
9. getpeername()
10. gethostname()


socket()
------------------------------------------------
    我们使用系统调用socket()来获得文件描述符：
    #include <sys/types.h>
    #include <sys/socket.h>
    int socket(int domain, int type, int protocol);
    第一个参数domain设置为“AF_INET”。
    第二个参数是套接口的类型SOCK_STREAM或SOCK_DGRAM。
    第三个参数设置为0。
    系统调用socket()只返回一个套接口描述符，如果出错，则返回-1。



bind() -- 服务器端socket绑定本地IP和端口
------------------------------------------------
    一旦你有了一个套接口以后，下一步就是把套接口绑定到本地计算机的某一个端口上。但如果你只想使用connect()则无此必要。
    下面是系统调用bind()的使用方法：
    #include <sys/types.h>
    #include <sys/socket.h>
    int bind(int sockfd, struct sockaddr *my_addr, int addrlen);
    第一个参数sockfd是由socket()调用返回的套接口文件描述符。
    第二个参数my_addr是指向数据结构sockaddr的指针。数据结构sockaddr中包括了关于你的地址、端口和IP地址的信息。
    第三个参数addrlen可以设置成sizeof(structsockaddr)。

    下面是一个例子：
    #include <string.h>
    #include <sys/types.h>
    #include <sys/socket.h>
    #define MYPORT 3490

    int main()
    {
        int sockfd;
        struct sockaddr_in my_addr;
        sockfd = socket(AF_INET, SOCK_STREAM, 0);
        my_addr.sin_family      = AF_INET;
        my_addr.sin_port        = htons(MYPORT);
        my_addr.sin_addr.s_addr = inet_addr("132.241.5.10");
        bind(sockfd, (struct sockaddr*)&my_addr, sizeof(struct sockaddr));

    如果出错，bind()也返回-1。
    如果你使用connect()系统调用，那么你不必知道你使用的端口号。当你调用connect()时，它检查套接口是否已经绑定，如果没有，它将会分配一个空闲的端口。

注:
    bind()所做的事情其实就是: 将该socket和本地的IP地址和某个端口号相关联 -- 将sockaddr与socket绑定
设置inet_sock结构的下列域
    inet->rcv_saddr   132.241.5.10   本地接收地址
    inet->saddr       132.241.5.10   本地发送地址
    inet->sport       3490           本地端口
    inet->daddr       0              目的地址(远程地址)
    inet->dport       0              目的端口(远程端口)



connect() -- 客户端socket连接服务器端的socket
------------------------------------------------
    系统调用connect()的用法如下：
    #include <sys/types.h>
    #include <sys/socket.h>
    int connect(int sockfd, struct sockaddr* serv_addr, int addrlen);
    第一个参数还是套接口文件描述符，它是由系统调用socket()返回的。   
    第二个参数是serv_addr是指向数据结构sockaddr的指针，其中包括目的端口和IP地址。
    第三个参数可以使用sizeof(struct sockaddr)而获得。

    #include <string.h>
    #include <sys/types.h>
    #include <sys/socket.h>
    #define DEST_IP    "132.241.5.10"
    #define DEST_PORT 23

    int main() {
        int    sockfd;
        struct sockaddr_in dest_addr;
        sockfd = socket(AF_INET, SOCK_STREAM, 0);
        dest_addr.sin_family      = AF_INET;
        dest_addr.sin_port        = htons(DEST_PORT);
        dest_addr.sin_addr.s_addr = inet_addr(DEST_IP);
        connect(sockfd, (structsockaddr*)&dest_addr, sizeof(struct sockaddr));

    同样，如果出错，connect()将会返回-1。



listen()
------------------------------------------------
    如果你希望不连接到远程的主机，也就是说你希望等待一个进入的连接请求，然后再处理它们。这样，你通过首先调用listen()，然后再调用accept()来实现。
    系统调用listen()的形式如下：
    intl isten(int sockfd, int backlog);
    第一个参数是系统调用socket()返回的套接口文件描述符。
    第二个参数是进入队列中允许的连接的个数。进入的连接请求在使用系统调用accept()应答之前要在进入队列中等待。这个值是队列中最多可以拥有的请求的个数。大多数系统的缺省设置为20。你可以设置为5或者10。当出错时，listen()将会返回-1值。

    当然，在使用系统调用listen()之前，我们需要调用bind()绑定到需要的端口，否则系统内核将会让我们监听一个随机的端口。所以，如果你希望监听一个端口，下面是应该使用的系统调用的顺序：
    socket();
    bind();
    listen();



accept()
------------------------------------------------
    系统调用accept()比较起来有点复杂。在远程的主机可能试图使用connect()连接你使用listen()正在监听的端口。但此连接将会在队列中等待，直到使用accept()处理它。调用accept()之后，将会返回一个全新的套接口文件描述符来处理这个单个的连接。这样，对于同一个连接来说，你就有了两个文件描述符。原先的一个文件描述符正在监听你指定的端口，新的文件描述符可以用来调用send()和recv()。

    #include <sys/socket.h>
    int accept(int sockfd, void *addr, int *addrlen);
    第一个参数是正在监听端口的套接口文件描述符。第二个参数addr是指向本地的数据结构sockaddr_in的指针。调用connect()中的信息将存储在这里。通过它你可以了解哪个主机在哪个端口呼叫你。第三个参数同样可以使用sizeof(struct sockaddr_in)来获得。
    如果出错，accept()也将返回-1。

    #include <string.h>
    #include <sys/types.h>
    #include <sys/socket.h>
    #define MYPORT   3490
    #define BACKLOG 10

    int main() {
        int    sockfd, new_fd;
        struct sockaddr_in my_addr;
        struct sockaddr_in their_addr;
        int    sin_size;
        sockfd = socket(AF_INET, SOCK_STREAM, 0);
        my_addr.sin_family      = AF_INET;
        my_addr.sin_port        = htons(MYPORT);
        my_addr.sin_addr.s_addr = INADDR_ANY;

        bind(sockfd, (struct sockaddr*)&my_addr, sizeof(struct sockaddr));
        listen(sockfd, BACKLOG);
        sin_size = sizeof(struct sockaddr_in);
        new_fd   = accept(sockfd, &their_addr, &sin_size);
         ...
    下面，我们将可以使用新创建的套接口文件描述符new_fd来调用send()和recv()。



send()和recv()
------------------------------------------------
    系统调用send()的用法如下：
    int send(int sockfd, const void* msg, int len, int flags);
    第一个参数是你希望给发送数据的套接口文件描述符。它可以是你通过socket()系统调用返回的，也可以是通过accept()系统调用得到的。
    第二个参数是指向你希望发送的数据的指针。
    第三个参数是数据的字节长度。
    第四个参数标志设置为0。

    下面是一个简单的例子：
    char *msg = "Beejwashere!";
    int len, bytes_sent;
    ...
    len        = strlen(msg);
    bytes_sent = send(sockfd, msg, len, 0);
    ...
    系统调用send()返回实际发送的字节数，这可能比你实际想要发送的字节数少。如果返回的字节数比要发送的字节数少，你在以后必须发送剩下的数据。当send()出错时，将返回-1。

    系统调用recv()的使用方法和send()类似：
    int recv(int sockfd, void* buf, int len, unsigned int flags);
    第一个参数是要读取的套接口文件描述符。
    第二个参数是保存读入信息的地址。
    第三个参数是缓冲区的最大长度。第四个参数设置为0。
    系统调用recv()返回实际读取到缓冲区的字节数，如果出错则返回-1。
    这样使用上面的系统调用，你可以通过数据流套接口来发送和接受信息。



sendto()和recvfrom()
------------------------------------------------
    因为数据报套接口并不连接到远程的主机上，所以在发送数据包之前，我们必须首先给出目的地址，请看：
    int sendto(int          sockfd, const void            * msg, int len,
               unsigned int flags, const struct sockaddr *to,   int tolen);
    除了两个参数以外，其他的参数和系统调用send()时相同。参数to是指向包含目的IP地址和端口号的数据结构sockaddr的指针。参数tolen可以设置为sizeof(structsockaddr)。
    系统调用sendto()返回实际发送的字节数，如果出错则返回-1。

    系统调用recvfrom()的使用方法也和recv()的十分近似：
    int recvfrom(int          sockfd, void            * buf, int len,
                 unsigned int flags, struct sockaddr * from, int * fromlen);
    参数from是指向本地计算机中包含源IP地址和端口号的数据结构sockaddr的指针。参数fromlen设置为sizeof(struct sockaddr)。系统调用recvfrom()返回接收到的字节数，如果出错则返回-1。



close()和shutdown()
------------------------------------------------
    你可以使用close()调用关闭连接的套接口文件描述符：
    close(sockfd);
    这样就不能再对此套接口做任何的读写操作了。

    使用系统调用shutdown()，可有更多的控制权。它允许你在某一个方向切断通信，或者切断双方的通信：
    int shutdown(int sockfd,int how);
    第一个参数是你希望切断通信的套接口文件描述符。第二个参数how值如下：
    0 —- Further receives are disallowed
    1 —- Further sends are disallowed
    2 -— Further sends and receives are disallowed(likeclose())
    shutdown()如果成功则返回0，如果失败则返回-1。



getpeername()
------------------------------------------------
    这个系统的调用十分简单。它将告诉你是谁在连接的另一端：
    #include <sys/socket.h>
    int getpeername(int sockfd, struct sockaddr* addr,int* addrlen);
    第一个参数是连接的数据流套接口文件描述符。
    第二个参数是指向包含另一端的信息的数据结构sockaddr的指针。
    第三个参数可以设置为sizeof(struct sockaddr)。
    如果出错，系统调用将返回-1。
    一旦你获得了它们的地址，你可以使用inet_ntoa()或者gethostbyaddr()来得到更多的信息。



gethostname()
------------------------------------------------
    系统调用 gethostname()比系统调用getpeername()还简单。它返回程序正在运行的计算机的名字。系统调用 gethostbyname()可以使用这个名字来决定你的机器的IP地址。
下面是一个例子：
    #include <unistd.h>
    int gethostname(char *hostname, size_t size);

    如果成功，gethostname将返回0。如果失败，它将返回-1。

-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

字节转换函数
unsigned long int htonl(unsigned long int hostlong)
unsigned short int htons(unisgned short int hostshort)
unsigned long int ntohl(unsigned long int netlong)
unsigned short int ntohs(unsigned short int netshort)

在这四个转换函数中,h 代表host, n 代表 network.s 代表short l 代表long 第一个函数的意义是将本机器上的long数据转化为网络上的long. 其他几个函数的意义也差不多.

hostent函数
struct hostent *gethostbyname(const char *hostname)
struct hostent *gethostbyaddr(const char *addr,int len,int type) //典型为(char*)&addr.sin_addr,4,AF_INET
在中有struct hostent的定义
struct hostent{
        char *h_name;           /* 主机的正式名称 */
        char *h_aliases;        /* 主机的别名 */
        int   h_addrtype;       /* 主机的地址类型 AF_INET*/
        int   h_length;         /* 主机的地址长度 对于IP4 是4字节32位*/
        char **h_addr_list;     /* 主机的IP地址列表 */
        }
#define h_addr h_addr_list[0] /* 主机的第一个IP地址*/

gethostbyname可以 将机器名(如 linux.yessun.com)转换为一个结构指针hostent.在这个结构里面储存了域名的信息
gethostbyaddr可以 将一个32位的IP地址(C0A80001)转换为结构指针. 使用之前要现inet_aton

                struct sockaddr_in addr;
                struct hostent *host;

                if(inet_aton(*argv[0],&addr.sin_addr)!=0)
                {
                   host=gethostbyaddr((char   *)&addr.sin_addr,4,AF_INET);
                   printf("Address information of Ip %s\n",*argv);
                }
                else
                {
                      /* 失败,难道是域名?*/
                      host=gethostbyname(*argv); printf("Address information
                      of host %s\n",*argv);
                }
                if(host==NULL)
                {
                        /* 都不是 ,算了不找了*/
                        fprintf(stderr,"No address information of %s\n",*argv);
                        continue;
                }


服务信息函数
在网络程序里面我们有时候需要知道端口.IP和服务信息.这个时候我们可以使用以下几个函数

int getsockname(int sockfd,struct sockaddr *localaddr,int *addrlen)// 得到(本地)系统分配的端口号
int getpeername(int sockfd,struct sockaddr *peeraddr, int *addrlen)// 得到peer的IP地址
struct servent *getservbyname(const char *servname,const char *protoname)// 得到指定服务的端口号
struct servent *getservbyport(int port,const char *protoname)// 得到指定的端口号的服务名
struct servent
        {
                char *s_name;          /* 正式服务名 */
                char **s_aliases;      /* 别名列表 */
                int s_port;            /* 端口号 */
                char *s_proto;         /* 使用的协议 */
        }

一般我们很少用这几个函数.对应客户端,当我们要得到连接的端口号时在connect调用成功后使用可 得到 系统分配的端口号.对于服务端,我们用INADDR_ANY填充后,为了得到连接的IP我们可以在accept调用成功后 使用而 得到IP地址.

在网络上有许多的默认端口和服务,比如端口21对ftp80对应WWW.为了 得到指定的端口号的服务名, 我们可以调用第四个函数,相反为了 得到指定服务的端口号可以调用第三个函数.


ssize_t write(int fd,const void *buf,size_t nbytes)

write函数将buf中的nbytes字节内容写入文件描述符fd.成功时返回写的字节数.失败时返回-1. 并设置errno变量. 在网络程序中,当我们向套接字文件描述符写时有俩种可能.

1)write的返回值大于0,表示写了部分或者是全部的数据.

2)返回的值 小于等于0,此时出现了错误.我们要根据错误类型来处理.
如果错误为EINTR表示在写的时候出现了中断错误.
如果为 EPIPE表示网络连接出现了问题(对方已经关闭了连接).

ssize_t read(int fd,void *buf,size_t nbyte)
read函数是负责从fd中读取内容.当读成功时,read返回实际所读的字节数,如果返回的值是0 表示已经读到文件的结束了,小于0表示出现了错误.如果错误为 EINTR说明读是由中断引起的, 如果是 ECONNREST表示网络连接出了问题. 和上面一样,我们也写一个自己的读函数


UDP数据报
int recvfrom(int sockfd,void *buf,int len,unsigned int flags,struct sockaddr * from, int *fromlen)
int sendto(int sockfd,const void *msg, int len, unsigned int flags, struct sockaddr *to, int tolen)

sockfd,buf,len的意义和read,write一样,分别表示套接字描述符,发送或接收的缓冲区及大小.recvfrom负责从 sockfd接收数据,如果from不是NULL,那么在from里面存储了信息来源的情况, 如果对信息的来源不感兴趣,可以将from和fromlen 设置为NULL.sendto负责向to发送信息.此时在to里面存储了收信息方的详细资料.
注意:
要求sockfd=socket(AF_INET,SOCK_DGRAM,0);
sendto里面最后两个参数是不可缺的,recvfrom最后两个参数可以设为NULL


6.1 recv和send
recv和send函数提供了和read和write差不多的功能.不过它们提供 了第四个参数来控制读写操作.

int recv(int sockfd,void *buf,int len,int flags)
int send(int sockfd,void *buf,int len,int flags)

前面的三个参数和read,write一样,第四个参数可以是0或者是以下的组合
_______________________________________________________________
| MSG_DONTROUTE        | 不查找路由表                         |
| MSG_OOB              | 接受或者发送带外数据                  |
| MSG_PEEK             | 查看数据,并不从系统缓冲区移走数据      |
| MSG_WAITALL          | 等待所有数据                         |
|--------------------------------------------------------------|

MSG_DONTROUTE:是send函数使用的标志.这个标志告诉IP协议.目的主机在本地网络上面,没有必要查找路由表.这个标志一般用网络诊断和路由程序里面.
MSG_OOB:表示可以接收和发送带外的数据.关于带外数据我们以后会解释的.

MSG_PEEK:是recv函数的使用标志,表示只是从系统缓冲区中读取内容,而不清楚系统缓冲区的内容.这样下次读的时候,仍然是一样的内容.一般在有多个进程读写数据时可以使用这个标志.

MSG_WAITALL是recv函数的使用标志,表示等到所有的信息到达时才返回.使用这个标志的时候recv回一直阻塞,直到指定的条件满足,或者是发生了错误. 1)当读到了指定的字节时,函数正常返回.返回值等于len 2)当读到了文件的结尾时,函数正常返回.返回值小于len 3) 当操作发生错误时,返回-1,且设置错误为相应的错误号(errno)

如果flags为0,则和read,write一样的操作.还有其它的几个选项,不过我们实际上用的很少,可以查看 Linux Programmer's Manual得到详细解释.

6.2 recvfrom和sendto
这两个函数一般用在非套接字的网络程序当中(UDP),我们已经在前面学会了.

6.3 recvmsg和sendmsg
recvmsg和sendmsg可以实现前面所有的读写函数的功能.

int recvmsg(int sockfd,struct msghdr *msg,int flags)
int sendmsg(int sockfd,struct msghdr *msg,int flags)

struct msghdr
        {
                void *msg_name;//实际上是struct sockaddr*,非UDP时候应该设置NULL
                int msg_namelen;//结构的长度
                struct iovec *msg_iov;//指出接受和发送的缓冲区内容
                int msg_iovlen;
                void *msg_control;
                int msg_controllen;
                int msg_flags;
        }

struct iovec
        {
                void *iov_base; /* 缓冲区开始的地址 */
                size_t iov_len; /* 缓冲区的长度      */
        }

msg_name和 msg_namelen当套接字是非面向连接时(UDP),它们存储接收和发送方的地址信息.msg_name实际上是一个指向struct sockaddr的指针,msg_name是结构的长度.当套接字是面向连接时,这两个值应设为NULL. msg_iov和 msg_iovlen指出接受和发送的缓冲区内容.msg_iov是一个结构指针,msg_iovlen指出这个结构数组的大小. msg_control和msg_controllen这两个变量是用来接收和发送控制数据时的 msg_flags指定接受和发送的操作选项.和 recv,send的选项一样
6.4 套接字的关闭
关闭套接字有两个函数close和shutdown.用close时和我们关闭文件一样.

6.5 shutdown

int shutdown(int sockfd,int howto)

TCP连接是双向的(是可读写的),当我们使用close时,会把读写通道都关闭,有时侯我们希望只关闭一个方向,这个时候我们可以使用shutdown.针对不同的howto,系统回采取不同的关闭方式.
howto=0这个时候系统会关闭读通道.但是可以继续往接字描述符写.

howto=1关闭写通道,和上面相反,着时候就只可以读了.

howto=2关闭读写通道,和close一样 在多进程程序里面,如果有几个子进程共享一个套接字时,如果我们使用shutdown, 那么所有的子进程都不能够操作了,这个时候我们只能够使用close来关闭子进程的套接字描述符.