關於Tinyhttpd最全註釋解析

#include <stdio.h>
#include <sys/socket.h>
#include <sys/types.h>
#include <netinet/in.h>
#include <arpa/inet.h>
#include <unistd.h>
#include <ctype.h>
#include <strings.h>
#include <string.h>
#include <sys/stat.h>
#include <pthread.h>
#include <sys/wait.h>
#include <stdlib.h>
#include <stdint.h>
#include "/usr/include/mysql/mysql.h"

#define ISspace(x) isspace((int)(x))

#define SERVER_STRING "Server: zkphttpd/0.1.0\r\n"
#define STDIN   0
#define STDOUT  1
#define STDERR  2

void search_mysql(int, char*);
void accept_request(void *);
void bad_request(int);
void cat(int, FILE *);
void cannot_execute(int);
void error_die(const char *);
void execute_cgi(int, const char *, const char *, const char *);
int get_line(int, char *, int);
void headers(int, const char *);
void not_found(int);
void serve_file(int, const char *);
int startup(u_short *);
void unimplemented(int);

/**********************************************************************/
/* A request has caused a call to accept() on the server port to
 * return.  Process the request appropriately.
 * Parameters: the socket connected to the client */
/**********************************************************************/
void accept_request(void *arg)
{
    //pthread_create傳過來的參數(void *)(intptr_t)client_sock
    int client = (intptr_t)arg;
    char buf[1024];
    /*size_t是標準C庫中定義的，應爲unsigned int，在64位系統中爲 
    long unsigned int。數據類型"socklen_t"和int應該具備相同的長度，
    不然就會破壞 BSD套接字層的填充。*/
    size_t numchars;
    char method[255];
    char url[255];
    char path[512];
    size_t i, j;
    /*在使用這個結構體和方法時，須要引入：<sys/types.h>、<sys/stat.h>
    struct stat這個結構體是用來描述一個linux系統文件系統中的文件屬性
    的結構。有兩種方法得到一個文件的屬性
    
    第一種是經過路徑有兩個函數能夠獲得
    int stat(const char *path, struct stat *struct_stat);
    int lstat(const char *path,struct stat *struct_stat);
    兩個函數的第一個參數都是文件的路徑，第二個參數是struct stat的指針。
    返回值爲0，表示成功執行。執行失敗是，error被自動設置對應值。
    這兩個方法區別在於stat沒有處理字符連接(軟連接）的能力，
    若是一個文件是符號連接，stat會直接返回它所指向的文件的屬性；
    而lstat返回的就是這個符號連接的內容。
    （符號鏈接就是軟鏈接，軟連接的內容就是一個字符串。這個字符串就是它所連接的文件的絕對路徑或者相對路徑）
    
    第二種經過文件描述符
    int fstat(int fdp, struct stat *struct_stat);　　
    *經過文件描述符獲取文件對應的屬性。fdp爲文件描述符
    */
    
    struct stat st;
    /*公共網關接口（Common Gateway Interface，CGI）是Web 服務器運行時外部程序的規範，按CGI 編寫的程序能夠擴展服務器功能。CGI 應用程序能與瀏覽器進行交互，還可經過數據API與數據庫服務器等外部數據源進行通訊，從數據庫服務器中獲取數據。格式化爲HTML文檔後，發送給瀏覽器，也能夠將從瀏覽器得到的數據放到數據庫中。*/
    int cgi = 0;      /* becomes true if server decides this is a CGI
                       * program */
    char *query_string = NULL;

    numchars = get_line(client, buf, sizeof(buf));
    i = 0; j = 0;
    while (!ISspace(buf[i]) && (i < sizeof(method) - 1))
    {
        method[i] = buf[i];
        i++;
    }
    j=i;
    method[i] = '\0';
    //#include <strings.h> int strcasecmp(cost char*s1,const char* s2);
    //若參數s1和s2字符串相等則返回0。s1大於s2則返回大於0 的值，s1 小於s2 則返回小於0的值。
    if (strcasecmp(method, "GET") && strcasecmp(method, "POST"))
    {
        unimplemented(client);
        return;
    }
    //get提交，提交的信息都顯示在地址欄中。get提交，對於大數據不行，由於地址欄存儲體積有限。
    //post提交，提交的信息不顯示地址欄中，顯示在消息體中。post提交，能夠提交大致積數據。 
    
    if (strcasecmp(method, "POST") == 0)
        cgi = 1;

    i = 0;
    while (ISspace(buf[j]) && (j < numchars))
        j++;
    while (!ISspace(buf[j]) && (i < sizeof(url) - 1) && (j < numchars))
    {
        url[i] = buf[j];
        i++; j++;
    }
    url[i] = '\0';
    //strcasecmp忽略大小寫比較字符串
    if (strcasecmp(method, "GET") == 0)
    {
        query_string = url;
        while ((*query_string != '?') && (*query_string != '\0'))
            query_string++;
        if (*query_string == '?')
        {
            cgi = 0;
            *query_string = '\0';
            query_string++;
            headers(client, path);
            while (*query_string != '=') query_string++;
            printf("%s\n", query_string);
            query_string++;
            search_mysql(client, query_string);
            return;
        }
    }

    sprintf(path, "htdocs%s", url);
    if (path[strlen(path) - 1] == '/')
        //extern char *strcat(char *dest, const char *src);
        //把src所指向的字符串（包括「\0」）複製到dest所指向的字符串後面（刪除*dest原來末尾的「\0」）。
        strcat(path, "indexall.html");
    //stat返回值: 成功返回0，返回-1表示失敗
    if (stat(path, &st) == -1) {
        //strcmp不忽略大小寫比較字符串
        //一直用get_line讀取文件，讀到http頭結束
        while ((numchars > 0) && strcmp("\n", buf))  /* read & discard headers */
            numchars = get_line(client, buf, sizeof(buf));
        not_found(client);
    }
    //執行這一步表明讀取到了這個文件
    else
    {
        /*
        S_IFMT   0170000    文件類型的位遮罩
        S_IFSOCK 0140000    套接字
        S_IFLNK 0120000     符號鏈接
        S_IFREG 0100000     通常文件
        S_IFBLK 0060000     區塊裝置
        S_IFDIR 0040000     目錄
        S_IFCHR 0020000     字符裝置
        S_IFIFO 0010000     先進先出
​
        S_ISUID 04000     文件的(set user-id on execution)位
        S_ISGID 02000     文件的(set group-id on execution)位
        S_ISVTX 01000     文件的sticky位
​
        S_IRUSR(S_IREAD) 00400     文件全部者具可讀取權限
        S_IWUSR(S_IWRITE)00200     文件全部者具可寫入權限
        S_IXUSR(S_IEXEC) 00100     文件全部者具可執行權限
​
        S_IRGRP 00040             用戶組具可讀取權限
        S_IWGRP 00020             用戶組具可寫入權限
        S_IXGRP 00010             用戶組具可執行權限
​
        S_IROTH 00004             其餘用戶具可讀取權限
        S_IWOTH 00002             其餘用戶具可寫入權限
        S_IXOTH 00001             其餘用戶具可執行權限
        */
        //是不是文件夾
        if ((st.st_mode & S_IFMT) == S_IFDIR)
            strcat(path, "/myblog.html");
        //文件全部者或文件所屬組或其餘人 具備可執行權限
        if ((st.st_mode & S_IXUSR) ||
                (st.st_mode & S_IXGRP) ||
                (st.st_mode & S_IXOTH)    )
            cgi = 1;
        if (!cgi)
            //執行這一步表明這個文件存在，可是不能執行
            //因而就換成讀取文件內容再發送
            serve_file(client, path);
        else
            execute_cgi(client, path, method, query_string);
    }

    close(client);
}

void search_mysql(int client, char* query_string)
{
    char buf[1024];
    MYSQL mysql;
    MYSQL_RES *res;
    MYSQL_ROW row;
    int flag, t;
    mysql_init(&mysql);
    if (!mysql_real_connect(&mysql, "localhost", "root", "Kunpeng1994.", "words", 0, NULL, 0))
    {
        printf("Failed to connect to Mysql!\n");
    }
    else
    {
        printf("Connected to Mysql successfully!\n");
    }
    sprintf(buf, "select word, chinese from words where word=\"%s\";", query_string);
    mysql_query(&mysql, "set names utf8;");
    flag = mysql_real_query(&mysql, buf,(unsigned int)sizeof(buf));
    if (flag)
    {
        perror("Query failed");
    }
    res = mysql_store_result(&mysql);
    row = mysql_fetch_row(res);
    if (row != 0)
    {
        while (row)
        {
            t = mysql_num_fields(res);
            for(t = 0; t < mysql_num_fields(res); t++)
            {
                printf("%s \t", row[t]);
                sprintf(buf, "%s\t", row[t]);
                send(client, buf, strlen(buf), 0);
            }
            row = mysql_fetch_row(res);
        }
    }
    else 
    {
        sprintf(buf, "not found %s\n", query_string);
        send(client, buf, strlen(buf), 0);
    }
    mysql_close(&mysql);
    sprintf(buf, "<!DOCTYPE html><html><head><meta charset=\"utf-8\"><title>Search Word</title></head><body><br> <a href='indexall.html'>主頁</a> <br><form action='#' action='get'><p><input type='text' name='word'><input type='submit'  value='Search'> </p></form></body></html>\n");
    send(client, buf, strlen(buf), 0);
}

/**********************************************************************/
/* Inform the client that a request it has made has a problem.
 * Parameters: client socket */
/**********************************************************************/
void bad_request(int client)
{
    char buf[1024];

    sprintf(buf, "HTTP/1.0 400 BAD REQUEST\r\n");
    send(client, buf, sizeof(buf), 0);
    sprintf(buf, "Content-type: text/html\r\n");
    send(client, buf, sizeof(buf), 0);
    sprintf(buf, "\r\n");
    send(client, buf, sizeof(buf), 0);
    sprintf(buf, "<P>Your browser sent a bad request, ");
    send(client, buf, sizeof(buf), 0);
    sprintf(buf, "such as a POST without a Content-Length.\r\n");
    send(client, buf, sizeof(buf), 0);
}

/**********************************************************************/
/* Put the entire contents of a file out on a socket.  This function
 * is named after the UNIX "cat" command, because it might have been
 * easier just to do something like pipe, fork, and exec("cat").
 * Parameters: the client socket descriptor
 *             FILE pointer for the file to cat */
/**********************************************************************/
void cat(int client, FILE *resource)
{
    char buf[1024];
    /*fgets函數功能爲從指定的流中讀取數據，每次讀取一行。
    *其原型爲：char *fgets(char *str, int n, FILE *stream);
    *從指定的流 stream 讀取一行，並把它存儲在 str 所指向的字符串內。
    *當讀取 (n-1) 個字符時，或者讀取到換行符時，或者到達文件末尾時，
    *它會中止，具體視狀況而定。*/
    fgets(buf, sizeof(buf), resource);
    //feof是C語言標準庫函數，其原型在stdio.h中，其功能是檢測流上的文件結束符，若是文件結束，則返回非0值，不然返回0（即，文件結束：返回非0值，文件未結束，返回0值）
    while (!feof(resource))
    {
        send(client, buf, strlen(buf), 0);
        fgets(buf, sizeof(buf), resource);
    }
}

/**********************************************************************/
/* Inform the client that a CGI script could not be executed.
 * Parameter: the client socket descriptor. */
/**********************************************************************/
void cannot_execute(int client)
{
    char buf[1024];

    sprintf(buf, "HTTP/1.0 500 Internal Server Error\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "Content-type: text/html\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "<P>Error prohibited CGI execution.\r\n");
    send(client, buf, strlen(buf), 0);
}

/**********************************************************************/
/* Print out an error message with perror() (for system errors; based
 * on value of errno, which indicates system call errors) and exit the
 * program indicating an error. */
/**********************************************************************/
void error_die(const char *sc)
{
    perror(sc);
    exit(1);
}

/**********************************************************************/
/* Execute a CGI script.  Will need to set environment variables as
 * appropriate.
 * Parameters: client socket descriptor
 *             path to the CGI script */
/**********************************************************************/
void execute_cgi(int client, const char *path,
        const char *method, const char *query_string)
{
    char buf[1024];
    int cgi_output[2];
    int cgi_input[2];
    //在頭文件#include <bits/types.h>
    //pid_t等同於int
    pid_t pid;
    int status;
    int i;
    char c;
    int numchars = 1;
    int content_length = -1;

    buf[0] = 'A'; buf[1] = '\0';
    if (strcasecmp(method, "GET") == 0)
        while ((numchars > 0) && strcmp("\n", buf))  /* read & discard headers */
            numchars = get_line(client, buf, sizeof(buf));
    else if (strcasecmp(method, "POST") == 0) /*POST*/
    {
        numchars = get_line(client, buf, sizeof(buf));
        while ((numchars > 0) && strcmp("\n", buf))
        {
            buf[15] = '\0';
            if (strcasecmp(buf, "Content-Length:") == 0)
                /*atoi (表示 ascii to integer)是把字符串轉換成整型數的一個函數，
                應用在計算機程序和辦公軟件中。int atoi(const char *nptr) 
                函數會掃描參數 nptr字符串，會跳過前面的空白字符
                （例如空格，tab縮進）等。
                若是 nptr不能轉換成 int 或者 nptr爲空字符串，那麼將返回 0 */
                content_length = atoi(&(buf[16]));
            numchars = get_line(client, buf, sizeof(buf));
        }
        if (content_length == -1) {
            bad_request(client);
            return;
        }
    }
    else/*HEAD or other*/
    {
    }

    //pipe所需頭文件 #include<unistd.h>
    //pipe函數定義中的fd參數是一個大小爲2的一個數組類型的指針。
    //該函數成功時返回0，並將一對打開的文件描述符值填入fd參數指向的數組。
    //失敗時返回 -1並設置errno。
    if (pipe(cgi_output) < 0) {
        cannot_execute(client);
        return;
    }
    if (pipe(cgi_input) < 0) {
        cannot_execute(client);
        return;
    }

    if ( (pid = fork()) < 0 ) {
        cannot_execute(client);
        return;
    }
    sprintf(buf, "HTTP/1.0 200 OK\r\n");
    send(client, buf, strlen(buf), 0);
    if (pid == 0)  /* child: CGI script */
    {
        char meth_env[255];
        char query_env[255];
        char length_env[255];
        /*#include <unistd.h>
        int dup(int oldfd);
        dup用來複制參數oldfd所指的文件描述符。
        當複製成功是，返回最小的還沒有被使用過的文件描述符，
        如有錯誤則返回-1.錯誤代碼存入errno中返回的新文件描述符和參數oldfd指向同一個文件，
        這兩個描述符共享同一個數據結構，
        共享全部的鎖定，讀寫指針和各項全現或標誌位。
        假如oldfd的值爲1，當前文件描述符的最小值爲3，那麼新描述符3指向描述符１所擁有的文件表項。*/
        //從shell中運行一個進程，默認會有3個文件描述符存在(0、１、2), 0與進程的標準輸入相關聯，１與進程的標準輸出相關聯，2與進程的標準錯誤輸出相關聯，
        /*dup2定義是int dup2( int filedes, int filedes2 ) 
        也是返回一個文件描述符，可是呢這個文件描述符你能夠指定，
        也就是它的第二個參數filedes2，
        若是fiedes2文件描述符指定的文件已經被打開，
        那麼就先把filedes2指定的文件關閉，
        一樣仍是返回文件描述符這個文件描述符能夠用來打開filedes1指定的文件*/
        dup2(cgi_output[1], STDOUT);
        dup2(cgi_input[0], STDIN);
        //#include <unistd.h>  int close(int fd); 返回值：成功返回0，出錯返回-1並設置errno
        //參數fd是要關閉的文件描述符。
        close(cgi_output[0]);
        close(cgi_input[1]);
        sprintf(meth_env, "REQUEST_METHOD=%s", method);
        //putenv  就是把meth_env添加到環境變量裏，且這個環境變量只在這個子進程裏有用
        putenv(meth_env);
        if (strcasecmp(method, "GET") == 0) {
            sprintf(query_env, "QUERY_STRING=%s", query_string);
            putenv(query_env);
        }
        else {   /* POST */
            sprintf(length_env, "CONTENT_LENGTH=%d", content_length);
            putenv(length_env);
        }
        //Linux下頭文件 #include <unistd.h> 函數定義 int execl(const char *path, const char *arg, ...);
        /*第一參數path字符指針所指向要執行的文件路徑， 
        接下來的參數表明執行該文件時傳遞的參數列表：argv[0],argv[1]... 
        最後一個參數須用空指針NULL做結束。*/
        // 例如執行/bin目錄下的ls, 第一參數爲程序名ls, 第二個參數爲"-al", 第三個參數爲"/etc/"
        //execl("/bin/ls","ls","-al","/etc/",NULL)；
        // 執行：  ./execl   結果：-rw-r--r-- 1 root root 2218 Jan 13 11:36 /etc/passwd
        execl(path, NULL);
        exit(0);
    } else {    /* parent */
        close(cgi_output[1]);
        close(cgi_input[0]);
        if (strcasecmp(method, "POST") == 0)
            for (i = 0; i < content_length; i++) {
                recv(client, &c, 1, 0);
                write(cgi_input[1], &c, 1);
            }
        while (read(cgi_output[0], &c, 1) > 0)
            send(client, &c, 1, 0);

        close(cgi_output[0]);
        close(cgi_input[1]);
        waitpid(pid, &status, 0);
    }
}

/**********************************************************************/
/* Get a line from a socket, whether the line ends in a newline,
 * carriage return, or a CRLF combination.  Terminates the string read
 * with a null character.  If no newline indicator is found before the
 * end of the buffer, the string is terminated with a null.  If any of
 * the above three line terminators is read, the last character of the
 * string will be a linefeed and the string will be terminated with a
 * null character.
 * Parameters: the socket descriptor
 *             the buffer to save the data in
 *             the size of the buffer
 * Returns: the number of bytes stored (excluding null) */
/**********************************************************************/
int get_line(int sock, char *buf, int size)
{
    int i = 0;
    char c = '\0';
    int n;

    while ((i < size - 1) && (c != '\n'))
    {
        //recv函數僅僅是copy數據，真正的接收數據是協議來完成的
        //int recv( _In_ SOCKET s, _Out_ char *buf, _In_ int len, _In_ int flags);
        //len  緩衝區長度。  flags 指定調用方式。
        //recv函數返回其實際copy的字節數。若是recv在copy時出錯，那麼它返回SOCKET_ERROR；若是recv函數在等待協議接收數據時網絡中斷了，那麼它返回0。
        n = recv(sock, &c, 1, 0);
        /* DEBUG printf("%02X\n", c); */
        if (n > 0)
        {
            if (c == '\r')
            {
                //把flags設置爲MSG_PEEK，僅把tcp buffer中的數據讀取到
                //buf中，並不把已讀取的數據從tcp buffer中移除，
                //再次調用recv仍然能夠讀到剛纔讀到的數據。
                n = recv(sock, &c, 1, MSG_PEEK);
                /* DEBUG printf("%02X\n", c); */
                if ((n > 0) && (c == '\n'))
                    recv(sock, &c, 1, 0);
                else
                    c = '\n';
            }
            //buf中沒有\r只會在結尾保存\n
            buf[i] = c;
            i++;
        }
        else
            c = '\n';
    }
    buf[i] = '\0';

    return(i);
}

/**********************************************************************/
/* Return the informational HTTP headers about a file. */
/* Parameters: the socket to print the headers on
 *             the name of the file */
/**********************************************************************/
void headers(int client, const char *filename)
{
    //這個filename是一個文件路徑
    char buf[1024];
    (void)filename;  /* could use filename to determine file type */

    strcpy(buf, "HTTP/1.0 200 OK\r\n");
    send(client, buf, strlen(buf), 0);
    strcpy(buf, SERVER_STRING);
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "Keep-Alive: timeout=20\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "Connection: keep-alive\r\n");
    send(client, buf, strlen(buf), 0); 
    sprintf(buf, "Content-Type: text/html\r\n");
    send(client, buf, strlen(buf), 0);
    strcpy(buf, "\r\n");
    send(client, buf, strlen(buf), 0);
}

/**********************************************************************/
/* Give a client a 404 not found status message. */
/**********************************************************************/
void not_found(int client)
{
    char buf[1024];

    sprintf(buf, "HTTP/1.0 404 NOT FOUND\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, SERVER_STRING);
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "Content-Type: text/html\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "<HTML><TITLE>Not Found</TITLE>\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "<BODY><P>The server could not fulfill\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "your request because the resource specified\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "is unavailable or nonexistent.\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "</BODY></HTML>\r\n");
    send(client, buf, strlen(buf), 0);
}

/**********************************************************************/
/* Send a regular file to the client.  Use headers, and report
 * errors to client if they occur.
 * Parameters: a pointer to a file structure produced from the socket
 *              file descriptor
 *             the name of the file to serve */
/**********************************************************************/
void serve_file(int client, const char *filename)
{
    //filename保存的是文件路徑
    FILE *resource = NULL;
    int numchars = 1;
    char buf[1024];

    buf[0] = 'A'; buf[1] = '\0';
    //和前邊同樣讀取整個http頭文件並不作任何操做
    while ((numchars > 0) && strcmp("\n", buf))  /* read & discard headers */
        numchars = get_line(client, buf, sizeof(buf));
    //進入這一步就是由於沒有執行權限，就採用讀取文件的方式
    resource = fopen(filename, "r");
    if (resource == NULL)
        not_found(client);
    else
    {
        //先返回一個文件存在的http響應 200 0k
        headers(client, filename);
        cat(client, resource);
    }
    fclose(resource);
}

/**********************************************************************/
/* This function starts the process of listening for web connections
 * on a specified port.  If the port is 0, then dynamically allocate a
 * port and modify the original port variable to reflect the actual
 * port.
 * Parameters: pointer to variable containing the port to connect on
 * Returns: the socket */
/**********************************************************************/
int startup(u_short *port)
{
    int httpd = 0;
    int on = 1;
    struct sockaddr_in name;
    /*爲了知足不一樣的通訊程序對通訊質量和性能的要求，通常的網絡系統提供了三種不一樣類型的套接字，以供用戶在設計網絡應用程序時根據不一樣的要求來選擇。這三種套接爲流式套接字（SOCK-STREAM）、數據報套接字（SOCK-DGRAM）和原始套接字（SOCK-RAW）。
        （1）流式套接字。它提供了一種可靠的、面向鏈接的雙向數據傳輸服務，實現了數據無差錯、無重複的發送。流式套接字內設流量控制，被傳輸的數據看做是無記錄邊界的字節流。在TCP/IP協議簇中，使用TCP協議來實現字節流的傳輸，當用戶想要發送大批量的數據或者對數據傳輸有較高的要求時，可使用流式套接字。
        （2）數據報套接字。它提供了一種無鏈接、不可靠的雙向數據傳輸服務。數據包以獨立的形式被髮送，而且保留了記錄邊界，不提供可靠性保證。數據在傳輸過程當中可能會丟失或重複，而且不能保證在接收端按發送順序接收數據。在TCP/IP協議簇中，使用UDP協議來實現數據報套接字。在出現差錯的可能性較小或容許部分傳輸出錯的應用場合，可使用數據報套接字進行數據傳輸，這樣通訊的效率較高。
        （3）原始套接字。該套接字容許對較低層協議（如IP或ICMP）進行直接訪問，經常使用於網絡協議分析，檢驗新的網絡協議實現，也可用於測試新配置或安裝的網絡設備。*/
    httpd = socket(PF_INET, SOCK_STREAM, 0);
    if (httpd == -1)
        error_die("socket");
    memset(&name, 0, sizeof(name));
    name.sin_family = AF_INET;
    name.sin_port = htons(*port);
    //INADDR_ANY（地址通配符）表示這個服務器上任意一個IP地址均可以
    name.sin_addr.s_addr = htonl(INADDR_ANY);
    /*int getsockopt(int sock, int level, int optname, 
        void *optval, socklen_t *optlen);
    int setsockopt(int sock, int level, int optname, const 
        void *optval, socklen_t optlen);
    sock：將要被設置或者獲取選項的套接字。
    level：選項所在的協議層。
        1)SOL_SOCKET:通用套接字選項.
        2)IPPROTO_IP:IP選項.
        3)IPPROTO_TCP:TCP選項.
    optname：須要訪問的選項名。
    optval：對於getsockopt()，指向返回選項值的緩衝。
            對於setsockopt()，指向包含新選項值的緩衝。
    optlen：對於getsockopt()，做爲入口參數時，選項值的最大長度。
            做爲出口參數時，選項值的實際長度。對於setsockopt()，
            現選項的長度。
    成功執行時，返回0。失敗返回-1*/
    if ((setsockopt(httpd, SOL_SOCKET, SO_REUSEADDR, &on, sizeof(on))) < 0)  
    //setsockopt獲取或者設置與某個套接字關聯的選項。
    {  
        error_die("setsockopt failed");
    }
    /*struct sockaddr {
　　unsigned short sa_family; // address family, AF_xxx 
　　char sa_data[14]; // 14 bytes of protocol address 
　　};*/
    if (bind(httpd, (struct sockaddr *)&name, sizeof(name)) < 0)
        error_die("bind");
    //若是不指定端口就動態分配一個
    if (*port == 0)  /* if dynamically allocating a port */
    {
        socklen_t namelen = sizeof(name);
        /*getsockname()函數用於獲取一個套接字的名字。
        *它用於一個已捆綁或已鏈接套接字s，本地地址將被返回。
        *本調用特別適用於以下狀況：未調用bind()就調用了connect()，
符）表示這個服務器上任意一個IP地址均可以
        *name.sin_addr.s_addr = *這時惟有getsockname()調用能夠獲知系統內定的本地地址。
        *在返回時，namelen參數包含了名字的實際字節數。
        *若無錯誤發生，getsockname()返回0。
        int PASCAL FAR getsockname( SOCKET s, 
            struct sockaddr FAR* name,int FAR* namelen);
        s：標識一個已捆綁套接口的描述字。
        name：接收套接口的地址（名字）。
        namelen：名字緩衝區長度。*/
        if (getsockname(httpd, (struct sockaddr *)&name, &namelen) == -1)
            error_die("getsockname");
        *port = ntohs(name.sin_port);
    }
    
    /*int listen( int sockfd, int backlog);
    *sockfd：用於標識一個已捆綁未鏈接套接口的描述字。
    *backlog：等待鏈接隊列的最大長度。
    *置服務器的流套接字處於監聽狀態
    僅面向鏈接的流套接字
    成功返回零 失敗socket_error*/
    
    if (listen(httpd, 5) < 0)
        error_die("listen");
    return(httpd);
}

/**********************************************************************/
/* Inform the client that the requested web method has not been
 * implemented.
 * Parameter: the client socket */
/**********************************************************************/
void unimplemented(int client)
{
    char buf[1024];

    sprintf(buf, "HTTP/1.0 501 Method Not Implemented\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, SERVER_STRING);
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "Content-Type: text/html\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "<HTML><HEAD><TITLE>Method Not Implemented\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "</TITLE></HEAD>\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "<BODY><P>HTTP request method not supported.\r\n");
    send(client, buf, strlen(buf), 0);
    sprintf(buf, "</BODY></HTML>\r\n");
    send(client, buf, strlen(buf), 0);
}

/**********************************************************************/

int main(void)
{
    int server_sock = -1;
    u_short port = 80;
    int client_sock = -1;
    //struct sockaddr_in
     //{
    //short sin_family;/*Address family通常來講AF_INET（地址族）PF_INET（協議族）*/
    //unsigned short sin_port;/*Port number(必需要採用網絡數據格式,普通數字能夠用htons()函數轉換成網絡數據格式的數字)*/
    //struct in_addr sin_addr;/*IP address in network byte order（Internet address）*/
    //unsigned char sin_zero[8];/*Same size as struct sockaddr沒有實際意義,只是爲了　跟SOCKADDR結構在內存中對齊*/
    //};
    struct sockaddr_in client_name;
    //爲了方便平臺移植而定義的內存類型，大小在全部平臺上都是四個字節
    socklen_t  client_name_len = sizeof(client_name);
    //Linux下沒有真正意義上的線程，他的實現是由進程來模擬，因此屬於用戶級線程位於libpthread共享庫（因此線程的ID只在庫中有效）
    //Linux 實現進程的主要目的是資源獨佔，Linux實現線程的主要目的是資源共享，線程全部資源由進程提供
    //同一個進程的多個線程共享同一地址空間
    pthread_t newthread;

    server_sock = startup(&port);
    printf("httpd running on port %d\n", port);

    while (1)
    {
        /*SOCKET accept(int sockfd, struct sockaddr *addr, socklen_t *addrlen);
        *服務器調用accept函數從處於監聽狀態的流套接字sd的客戶鏈接隊列中
        *取出排在最前面的的一個客戶鏈接請求，
        *並建立一個與sd同類的新套接字描述符與客戶端套接字建立鏈接通道。*/
        client_sock = accept(server_sock,
                (struct sockaddr *)&client_name,
                &client_name_len);
        if (client_sock == -1)
            error_die("accept");
        /* accept_request(&client_sock);
        int pthread_create(pthread_t * thread, const pthread_arrt_t* attr
            ,void*(*start_routine)(void *), void* arg);
        （1）thread參數是新線程的標識符,爲一個整型。

        （2）attr參數用於設置新線程的屬性。
            給傳遞NULL表示設置爲默認線程屬性。

        （3）start_routine和arg參數分別指定新線程將運行的函數和參數。
            start_routine返回時,這個線程就退出了

        （4）返回值:成功返回0,失敗返回錯誤號。*/
        //intptr_t是爲了保存指針變量的，因爲不一樣位數的機器指針變量所佔字節數不一樣。爲了保證平臺的通用性
        if (pthread_create(&newthread , NULL, (void *)accept_request, (void *)(intptr_t)client_sock) != 0)
            perror("pthread_create");
    }

    close(server_sock);

    return(0);
}