github.com/EZLippi/Tinyhttpd 开源代码解析

unimplemented函数

1、c语言中的send（）函数使用方法；
定义函数int send(int s, const void * msg, int len, unsigned int falgs);
函数说明：send()用来将数据由指定的socket 传给对方主机。参数s 为已建立好连接的socket. 参数msg 指向欲连线的数据内容, 参数len 则为数据长度. 参数flags 一般设0
返回值：成功则返回实际传送出去的字符数, 失败返回-1

startup函数

1、socket()函数
定义函数int socket(int domain, int type, int protocol);
socket函数对应于普通文件的打开操作。普通文件的打开操作返回一个文件描述字，而socket()用于创建一个socket描述符（socket descriptor），它唯一标识一个socket。这个socket描述字跟文件描述字一样，后续的操作都有用到它，把它作为参数，通过它来进行一些读写操作。
正如可以给fopen的传入不同参数值，以打开不同的文件。创建socket的时候，也可以指定不同的参数创建不同的socket描述符，socket函数的三个参数分别为：
domain：即协议域，又称为协议族（family）。常用的协议族有，AF_INET、AF_INET6、AF_LOCAL（或称AF_UNIX，Unix域socket）、AF_ROUTE等等。协议族决定了socket的地址类型，在通信中必须采用对应的地址，如AF_INET决定了要用ipv4地址（32位的）与端口号（16位的）的组合、AF_UNIX决定了要用一个绝对路径名作为地址。
type：指定socket类型。常用的socket类型有，SOCK_STREAM、SOCK_DGRAM、SOCK_RAW、SOCK_PACKET、SOCK_SEQPACKET等等。
protocol：故名思意，就是指定协议。常用的协议有，IPPROTO_TCP、IPPTOTO_UDP、IPPROTO_SCTP、IPPROTO_TIPC等，它们分别对应TCP传输协议、UDP传输协议、STCP传输协议、TIPC传输协议。
注意：并不是上面的type和protocol可以随意组合的，如SOCK_STREAM不可以跟IPPROTO_UDP组合。当protocol为0时，会自动选择type类型对应的默认协议。
当我们调用socket创建一个socket时，返回的socket描述字它存在于协议族（address family，AF_XXX）空间中，但没有一个具体的地址。如果想要给它赋值一个地址，就必须调用bind()函数，否则就当调用connect()、listen()时系统会自动随机分配一个端口。
2、bind()函数
正如上面所说bind()函数把一个地址族中的特定地址赋给socket。例如对应AF_INET、AF_INET6就是把一个ipv4或ipv6地址和端口号组合赋给socket。
定义函数int bind(int sockfd, const struct sockaddr *addr, socklen_t addrlen);
函数的三个参数分别为：
sockfd：即socket描述字，它是通过socket()函数创建的，唯一标识一个socket。bind()函数就是将给这个描述字绑定一个名字。
addr：一个const struct sockaddr *指针，指向要绑定给sockfd的协议地址。
addrlen：对应的地址长度
3、listen()、connect()函数
如果作为一个服务器，在调用socket()、bind()之后就会调用listen()来监听这个socket，如果客户端这时调用connect()发出连接请求，服务器端就会接收到这个请求。
定义函数int listen(int sockfd, int backlog);
int connect(int sockfd, const struct sockaddr *addr, socklen_t addrlen);
listen函数的第一个参数即为要监听的socket描述字，第二个参数为相应socket可以排队的最大连接个数。socket()函数创建的socket默认是一个主动类型的，listen函数将socket变为被动类型的，等待客户的连接请求。
connect函数的第一个参数即为客户端的socket描述字，第二参数为服务器的socket地址，第三个参数为socket地址的长度。客户端通过调用connect函数来建立与TCP服务器的连接。
4、setsockopt()函数：设置socket状态
定义函数：int setsockopt(int s, int level, int optname, const void * optval, ,socklen_toptlen);
参数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。
5、getsockname函数 （返回指定套接字的IP地址）
定义函数 int getsockname(int sock, struct sockaddr *name, socklen_t *namelen)
sock：需要获取名称的套接字。（注意这里的sock已经包含了目的地址和本地地址，即已经被绑定了 （connect函数和bind函数都可以将其绑定））
name：存放所获取套接字名称的缓冲区。（由于connect函数的绑定socket是由系统隐式绑定本地地址的，所以用户如果想要知道这个本地的地址就可以调用getsockname，这个本地地址被返回到name中）
nemalen：作为入口参数，name指向空间的最大长度。作为出口参数，name的实际长度。

htons()作用是将端口号由主机字节序转换为网络字节序的整数值。(host to net)。
inet_addr()作用是将一个IP字符串转化为一个网络字节序的整数值，用于sockaddr_in.sin_addr.s_addr。
inet_ntoa()作用是将一个sin_addr结构体输出成IP字符串(network to ascii)。
htonl()作用和htons()一样，不过它针对的是32位的（long），而htons()针对的是两个字节，16位short。
与htonl()和htons()作用相反的两个函数是：ntohl()和ntohs()。

main函数

1、accept()函数
TCP服务器端依次调用socket()、bind()、listen()之后，就会监听指定的socket地址了。TCP客户端依次调用socket()、connect()之后就想TCP服务器发送了一个连接请求。TCP服务器监听到这个请求之后，就会调用accept()函数取接收请求，这样连接就建立好了。之后就可以开始网络I/O操作了，即类同于普通文件的读写I/O操作。
定义函数 int accept(int sockfd, struct sockaddr *addr, socklen_t *addrlen);
accept函数的第一个参数为服务器的socket描述字，第二个参数为指向struct sockaddr *的指针，用于返回客户端的协议地址，第三个参数为协议地址的长度。如果accpet成功，那么其返回值是由内核自动生成的一个全新的描述字，代表与返回客户的TCP连接。
注意：accept的第一个参数为服务器的socket描述字，是服务器开始调用socket()函数生成的，称为监听socket描述字；而accept函数返回的是已连接的socket描述字。一个服务器通常通常仅仅只创建一个监听socket描述字，它在该服务器的生命周期内一直存在。内核为每个由服务器进程接受的客户连接创建了一个已连接socket描述字，当服务器完成了对某个客户的服务，相应的已连接socket描述字就被关闭。
2、close()函数
在服务器与客户端建立连接之后，会进行一些读写操作，完成了读写操作就要关闭相应的socket描述字，好比操作完打开的文件要调用fclose关闭打开的文件。
定义函数int close(int fd)

get_line函数

1、recv函数
定义函数int recv(int sockfd, void *buf, size_t len, int flags）
不论是客户还是服务器应用程序都用recv函数从TCP连接的另一端接收数据。
该函数的第一个参数指定接收端套接字描述符；
第二个参数指明一个缓冲区，该缓冲区用来存放recv函数接收到的数据；
第三个参数指明buf的长度；
第四个参数一般置0，此时send为阻塞式发送，即发送不成功会一直阻塞，直到被某个信号终端终止，或者直到发送成功为止。
返回值：成功返回发送的字节数；失败返回-1，同时errno被设置
2、’\0’ ‘\n’ ‘\r’ 区别
\n的意思是换行符,\r的意思是回车符。
在C语言中，语句结尾打上\n是转到下一行同一个位置，而\r是回到当前行的行首，如果同时打上\r\n就会转到下一行的行首。
在C语言中没有专门的字符串变量，通常用一个字符数组来存放一个字符串。字符串总是以’\0’作为串的结束符。

cat函数

1、定义函数 char* fgets(char * s，int n，FILE *stream)
参数：
s: 字符型指针，指向存储读入数据的缓冲区的地址。
n: 从流中读入n-1个字符
stream ： 指向读取的流。
返回值：
1.当n<=0 时返回NULL，即空指针。
2. 当n=1 时，返回空串" “。
3. 如果读入成功，则返回缓冲区的地址。
4. 如果读入错误或遇到文件结尾(EOF)，则返回NULL。
2、feof函数
feof用于检测流上的文件结束符，其返回值有两种情况：如果遇到文件结束标志，函数返回值为非零值，否则函数返回值为0。
注：此处的文件结束标志是EOF
feof实例分析：
test.txt：
1 2 3 注意：文档中1,2,3之间有一个空格，在3之后没有空行。
程序：
char ch;
while(!feof(fp))
{
ch=fgetc(fp);
printf(”%c",ch);
}
我们看到，在读取最后一个字符3后，feof()的返回值是0，此时while()条件成立，然后继续向文件后读，读出文件结束标志EOF，此刻feof()的返回值变位16,while()条件不满足，因此不再继续，但是由于读出了最后一个EOF，按照代码的要求，读一个马上输出来，因此要输出来，就出现了多出来一个字符的情况。

accept_request函数

1、stat函数
定义函数 int stat(const char* file_name,struct stat* buf);
stat()用来将参数file_name所指的文件状态, 复制到参数buf所指的结构中，const char* 表示文件的路径，struct stat* buf 表示声明的结构体。
stat，lstat，fstat函数都是用来获取文件的状态，三个函数的功能将文件的状态复制到buffer的结构体当中去。
2、strcasecmp()函数
定义函数：int strcasecmp (const char *s1, const char *s2)；
strcasecmp()用来比较参数s1 和s2 字符串，比较时会自动忽略大小写的差异。
返回值：若参数s1 和s2 字符串相同则返回0。s1 长度大于s2 长度则返回大于0 的值，s1 长度若小于s2 长度则返回小于0 的值。
3、strcmp函数
作用：比较a，b两个字符串的，strcmp函数是根据ASCII码来比较两个字符串的。用a字符串的第一个字符减去b字符串的第一个字符，若第一个字符相等，则对比第二个字符，若a，b完全相等，则返回0；若a大于b，则返回大于0的数值；若a小于b，同样返回小于0的数值。

execute_cgi函数

1、atoi()函数
atoi()函数是把字符串转化为数字。
2、pipe()函数
定义函数 int pipe (int fd[2])
函数传入值 fd[2]：管道的两个文件描述符，之后就是可以直接操作这两个文件描述符
返回值 ：成功 0， 失败 -1
3、fork()函数
fork 的功能：
fork调用的一个奇妙之处就是它仅仅被调用一次，却能够返回两次，它可能有三种不同的返回值：
1）在父进程中，fork返回新创建子进程的进程ID；
2）在子进程中，fork返回0；
3）如果出现错误，fork返回一个负值；
4、dup()、dup2()函数
功能：复制文件描述符，使多个文件描述符指向同一个文件。
返回值：
　成功：dup函数返回当前系统可用的最小整数值。
　　　　dup2函数返回第一个不小于newfd的整数值。也就是分为两种情况：
　　　　①、如果newfd已经打开，则先将其关闭，再复制文件描述符。
　　　　②、如果newfd等于oldfd，则dup2返回newfd, 而不关闭它。
　失败：均返回-1，并设置errno。
5、putenv函数
定义函数 int putenv(char* string)
putenv 函数用来向环境表中 添加或者修改 环境变量。
string：指向环境变量的指针
返回值：
调用成功返回 0
调用失败时返回 非0 值
6、execl()函数
定义函数 int execl(const char* path, const char* arg, …);
execl()用来执行参数path 字符串所代表的文件路径, 接下来的参数代表执行该文件时传递过去的argv[0]，argv[1], …, 最后一个参数必须用空指针(NULL)作结束。
返回值：如果执行成功则函数不会返回，执行失败则直接返回-1，失败原因存于errno 中。
7、read()、write()等函数
定义函数 ssize_t read(int fd, void* buf, size_t count);
ssize_t write(int fd, const void* buf, size_t count);
read函数是负责从fd中读取内容。当读成功时，read返回实际所读的字节数，如果返回的值是0表示已经读到文件的结束了，小于0表示出现了错误。
write函数将buf中的nbytes字节内容写入文件描述符fd。成功时返回写的字节数。失败时返回-1，并设置errno变量。在网络程序中，当我们向套接字文件描述符写时有俩种可能。1)write的返回值大于0，表示写了部分或者是全部的数据。2)返回的值小于0，此时出现了错误。
8、waitpid函数
定义函数 pid_t waitpid (pid_t pid, int * ststus, int options)；
参数：pid子进程号，status子进程状态，options可为0(阻塞)或WNOHANG、WUNTRACED。
函数返回值：
执行成功返回子进程Pid，失败返回-1，原因存于errno。子进程未结束返回0。
作用：如果一个子进程比父进程晚终止，子进程就变成了Zombie，为了避免这种情况，使用waitpid函数，父进程等待子进程结束后，再结束。