一般情况下第一个样例都应该是简单并且容易让人产生兴趣的，但是UPN的第一个样例对于没有写过的人而言是第一个考验

由于官方代码大量使用 <code>upn.h</code> 头文件，经常会导致不知道函数从何而来 
因此建议还是自己徒手编译
本样例需要用到的头文件如下(包括简单的说明):
<pre style="background-color:#fff">#include &lt;arpa/inet.h&gt; //inet_ntop()、inet_ntoa()等
#include &lt;memory.h&gt; //memset
#include &lt;netinet/in.h&gt; //struct sockaddr_in、PROTO_ICMP、INADDR_ANY等
#include &lt;stdio.h&gt; //printf
#include &lt;stdlib.h&gt; //exit
#include &lt;sys/socket.h&gt; //socket、bind、connect、struct sockaddr
#include &lt;sys/types.h&gt; //类型定义
#include &lt;time.h&gt; //time
#include &lt;unistd.h&gt; //read
</pre>本样例由两部分组成:服务端和用户端 
尽管按照书上有 <code>206.168.112.96</code> 这个IP地址，不过在我的测试中并不能成功连接 
因此，可以使用P5的代码实现客户端，用P10的代码实现服务端
由于服务端需要监听端口，因此该部分需要root权限
另外，服务端和客户端都应该是 <code>htons(13)</code> (<code>htons</code>和<code>htonl</code>存在区别)
设计到的几个函数定义如下
<h1 id="heading">函数定义</h1>
<blockquote>
<a href="http://baike.baidu.com/item/socket/281150">百度百科-socket</a> 
{% fold %}
</blockquote>
<h2 id="heading-1">创建</h2>
<ul>
<li>函数原型： 
<code>int socket(int domain, int type, int protocol);</code></li>
<li>参数说明：
<ul>
<li>domain：协议域，又称协议族（family）。常用的协议族有AF_INET、AF_INET6、AF_LOCAL（或称AF_UNIX，Unix域Socket）、AF_ROUTE等。协议族决定了socket的地址类型，在通信中必须采用对应的地址，如AF_INET决定了要用ipv4地址（32位的）与端口号（16位的）的组合、AF_UNIX决定了要用一个绝对路径名作为地址。</li>
<li>type：指定Socket类型。常用的socket类型有SOCK_STREAM、SOCK_DGRAM、SOCK_RAW、SOCK_PACKET、SOCK_SEQPACKET等。流式Socket（SOCK_STREAM）是一种面向连接的Socket，针对于面向连接的TCP服务应用。数据报式Socket（SOCK_DGRAM）是一种无连接的Socket，对应于无连接的UDP服务应用。</li>
<li>protocol：指定协议。常用协议有IPPROTO_TCP、IPPROTO_UDP、IPPROTO_STCP、IPPROTO_TIPC等，分别对应TCP传输协议、UDP传输协议、STCP传输协议、TIPC传输协议。</li>
</ul>
</li>
<li>注意：
<ol>
<li>type和protocol不可以随意组合，如SOCK_STREAM不可以跟IPPROTO_UDP组合。当第三个参数为0时，会自动选择第二个参数类型对应的默认协议。</li>
<li>WindowsSocket下protocol参数中不存在IPPROTO_STCP</li>
</ol>
</li>
<li>返回值： 
如果调用成功就返回新创建的套接字的描述符，如果失败就返回INVALID_SOCKET（Linux下失败返回-1）。 
套接字描述符是一个整数类型的值。 
每个进程的进程空间里都有一个套接字描述符表，该表中存放着套接字描述符和套接字数据结构的对应关系。该表中有一个字段存放新创建的套接字的描述符，另一个字段存放套接字数据结构的地址，因此根据套接字描述符就可以找到其对应的套接字数据结构。 
每个进程在自己的进程空间里都有一个套接字描述符表但是套接字数据结构都是在操作系统的内核缓冲里。</li>
</ul>
<h2 id="heading-2">绑定</h2>
<ul>
<li>函数原型： 
<code>int bind(SOCKET socket, const struct sockaddr* address, socklen_t address_len);</code></li>
<li>参数说明：
<ul>
<li>socket：是一个套接字描述符。</li>
<li>address：是一个sockaddr结构指针，该结构中包含了要结合的地址和端口号。</li>
<li>address_len：确定address缓冲区的长度。</li>
</ul>
</li>
<li>返回值： 
如果函数执行成功，返回值为0，否则为SOCKET_ERROR。</li>
</ul>
<h2 id="heading-3">接收</h2>
<ul>
<li>
函数原型： 
<code>int recv(SOCKET socket, char FAR* buf, int len, int flags);</code>
</li>
<li>
参数说明：
<ul>
<li>socket：一个标识已连接套接口的描述字。</li>
<li>buf：用于接收数据的缓冲区。</li>
<li>len：缓冲区长度。</li>
<li>flags：指定调用方式。取值：MSG_PEEK 查看当前数据，数据将被复制到缓冲区中，但并不从输入队列中删除；MSG_OOB 处理带外数据。</li>
</ul>
</li>
<li>
返回值： 
若无错误发生，recv()返回读入的字节数。如果连接已中止，返回0。否则的话，返回SOCKET_ERROR错误，应用程序可通过WSAGetLastError()获取相应错误代码。
</li>
<li>
函数原型： 
<code>ssize_t recvfrom(int sockfd, void buf, int len, unsigned int flags, struct socketaddr* from, socket_t* fromlen);</code>
</li>
<li>
参数说明：
<ul>
<li>sockfd：标识一个已连接套接口的描述字。</li>
<li>buf：接收数据缓冲区。</li>
<li>len：缓冲区长度。</li>
<li>flags：调用操作方式。是以下一个或者多个标志的组合体，可通过or操作连在一起：
<ol>
<li>MSG_DONTWAIT：操作不会被阻塞；</li>
<li>MSG_ERRQUEUE： 指示应该从套接字的错误队列上接收错误值，依据不同的协议，错误值以某种辅佐性消息的方式传递进来，使用者应该提供足够大的缓冲区。导致错误的原封包通过msg_iovec作为一般的数据来传递。导致错误的数据报原目标地址作为msg_name被提供。错误以sock_extended_err结构形态被使用。</li>
<li>MSG_PEEK：指示数据接收后，在接收队列中保留原数据，不将其删除，随后的读操作还可以接收相同的数据。</li>
<li>MSG_TRUNC：返回封包的实际长度，即使它比所提供的缓冲区更长， 只对packet套接字有效。</li>
<li>MSG_WAITALL：要求阻塞操作，直到请求得到完整的满足。然而，如果捕捉到信号，错误或者连接断开发生，或者下次被接收的数据类型不同，仍会返回少于请求量的数据。</li>
<li>MSG_EOR：指示记录的结束，返回的数据完成一个记录。</li>
<li>MSG_CTRUNC：指明由于缓冲区空间不足，一些控制数据已被丢弃。</li>
<li>MSG_OOB：指示接收到out-of-band数据(即需要优先处理的数据)。</li>
<li>MSG_ERRQUEUE：指示除了来自套接字错误队列的错误外，没有接收到其它数据。</li>
</ol>
</li>
<li>from：（可选）指针，指向装有源地址的缓冲区。</li>
<li>fromlen：（可选）指针，指向from缓冲区长度值。</li>
</ul>
</li>
</ul>
<h2 id="heading-4">发送</h2>
<ul>
<li>函数原型： 
<code>int sendto( SOCKET s, const char FAR* buf, int size, int flags, const struct sockaddr FAR* to, int tolen);</code></li>
<li>参数说明：
<ul>
<li>s：套接字</li>
<li>buf：待发送数据的缓冲区</li>
<li>size：缓冲区长度</li>
<li>flags：调用方式标志位, 一般为0, 改变Flags，将会改变Sendto发送的形式</li>
<li>addr：（可选）指针，指向目的套接字的地址</li>
<li>tolen：addr所指地址的长度</li>
</ul>
</li>
<li>返回值： 
如果成功，则返回发送的字节数，失败则返回SOCKET_ERROR。</li>
</ul>
<h2 id="heading-5">接收连接请求</h2>
<ul>
<li>函数原型： 
<code>int accept( int fd, struct socketaddr* addr, socklen_t* len);</code></li>
<li>参数说明：
<ul>
<li>fd：套接字描述符。</li>
<li>addr：返回连接着的地址</li>
<li>len：接收返回地址的缓冲区长度</li>
</ul>
</li>
<li>返回值： 
成功返回客户端的文件描述符，失败返回-1。 
{% endfold %}</li>
</ul>
<h1 id="heading-6">代码</h1>
<h2 id="heading-7">服务端</h2>
{% fold 点击现/隐代码 %}```c 服务端(需要管理员权限) 
#include &lt;arpa/inet.h&gt; //inet_ntop()、inet_ntoa()等 
#include &lt;memory.h&gt; //memset 
#include &lt;netinet/in.h&gt; //struct sockaddr_in、PROTO_ICMP、INADDR_ANY等 
#include &lt;stdio.h&gt; //printf 
#include &lt;stdlib.h&gt; //exit 
#include &lt;sys/socket.h&gt; //socket、bind、connect、struct sockaddr 
#include &lt;sys/types.h&gt; //类型定义 
#include &lt;time.h&gt; //time 
#include &lt;unistd.h&gt; //read
#define MAXLINE 100 
#define LISTENQ 1024 
#define bzero(a, b) memset(a, 0, b)
void err(const char *_information) { 
printf(&quot;%s\r\n&quot;, _information); 
exit(0); 
}
int main(int argc, char **argv) { 
int listenfd, connfd; 
struct sockaddr_in servaddr; 
char buff[MAXLINE]; 
time_t ticks;
<pre><code>if ((listenfd = socket(AF_INET, SOCK_STREAM, 0)) == -1)
 err(&quot;socket error.&quot;);

bzero(&amp;servaddr, sizeof(servaddr));
servaddr.sin_family = AF_INET;
servaddr.sin_addr.s_addr = htonl(INADDR_ANY);
servaddr.sin_port = htons(13);

if (bind(listenfd, (struct sockaddr *)&amp;servaddr, sizeof(servaddr)) == -1)
 err(&quot;bind error.&quot;);

if (listen(listenfd, LISTENQ) == -1)
 err(&quot;Listen error.&quot;);

while (1) {
 if ((connfd = accept(listenfd, (struct sockaddr *)NULL, NULL)) == -1)
 err(&quot;accept error.&quot;);

 ticks = time(NULL);

 snprintf(buff, sizeof(buff), &quot;%.24s\r\n&quot;, ctime(&amp;ticks));

 if (write(connfd, buff, strlen(buff)) == -1)
 err(&quot;write error.&quot;);

 if (close(connfd) == -1)
 err(&quot;close error.&quot;);
}
</code></pre>
}
<pre style="background-color:#fff">{% endfold %}

## 客户端
{% fold 点击现/隐代码 %}```c 客户端
#include &lt;arpa/inet.h&gt; //inet_ntop()、inet_ntoa()等
#include &lt;memory.h&gt; //memset
#include &lt;netinet/in.h&gt; //struct sockaddr_in、PROTO_ICMP、INADDR_ANY等
#include &lt;stdio.h&gt; //printf
#include &lt;stdlib.h&gt; //exit
#include &lt;sys/socket.h&gt; //socket、bind、connect、struct sockaddr
#include &lt;sys/types.h&gt; //类型定义
#include &lt;time.h&gt; //time
#include &lt;unistd.h&gt; //read

#define MAXLINE 100
#define bzero(a, b) memset(a, 0, b)

void err(const char *_information) {
 printf(&#34;%s\r\n&#34;, _information);
 exit(0);
}

int main(int argc, char **argv) {
 int sockfd, n;
 char recvline[MAXLINE + 1];
 struct sockaddr_in servaddr;

 //判断参数数目
 if (argc != 2)
 err(&#34;usage: a.out &lt;IPaddress&gt;&#34;);

 //创建socket
 if ((sockfd = socket(AF_INET, SOCK_STREAM, 0)) &lt; 0)
 err(&#34;socket error&#34;);

 bzero(&amp;servaddr, sizeof(servaddr));

 servaddr.sin_family = AF_INET;
 servaddr.sin_port = htons(13);

 //转换地址
 if (inet_pton(AF_INET, argv[1], &amp;servaddr.sin_addr) &lt;= 0)
 err(&#34;inet_pton error&#34;);

 //连接
 if (connect(sockfd, (struct sockaddr *)&amp;servaddr, sizeof(servaddr)) &lt; 0)
 err(&#34;connect error&#34;);

 //读取
 while ((n = read(sockfd, recvline, MAXLINE)) &gt; 0) {
 recvline[n] = 0;
 if (fputs(recvline, stdout) == EOF)
 err(&#34;fputs error&#34;);
 }
 if (n &lt; 0)
 err(&#34;read error&#34;);

 exit(0);
}
</pre>{% endfold %}

UPN第一个样例