diff --git a/.gitignore b/.gitignore
index 7d445d1..040b98c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -24,3 +24,4 @@ _minted-*
*.exe
*.obj
*.listing
+settings.json
diff --git a/CODE/chapter2/SMTPClient.py b/CODE/chapter2/SMTPClient.py
new file mode 100644
index 0000000..dd332d2
--- /dev/null
+++ b/CODE/chapter2/SMTPClient.py
@@ -0,0 +1,66 @@
+from socket import *
+from base64 import *
+
+mailfrom = "mail from:2@test.com\r\n"
+rcptto = "rcpt to:1@test.com\r\n"
+data = "data\r\n"
+quitmsg = "quit\r\n"
+
+msg = "\r\n I love computer networks!"
+endmsg = "\r\n.\r\n"
+#此处使用易邮邮件服务器软件搭建了一个内网邮件服务器
+mailserver = '10.130.82.62'
+mailport = 25
+connectaddress = (mailserver, mailport)
+# Create socket called clientSocket and establish a TCP connection with mailserver
+clientSocket = socket(AF_INET, SOCK_STREAM)
+clientSocket.connect(connectaddress)
+
+recv = clientSocket.recv(1024)
+print (recv)
+if recv[:3] != '220':
+ print ('220 reply not received from server.')
+# Send HELO command and print server response.
+heloCommand = 'HELO Alice\r\n'
+clientSocket.send(bytes(heloCommand.encode()))
+recv1 = clientSocket.recv(1024)
+print (recv1.decode())
+if recv1[:3] != '250':
+ print ('250 reply not received from server.')
+
+#print('000000000000000')
+#从命令和打印服务器响应发送邮件。
+login = b'auth login\r\n'
+clientSocket.send(login)
+recv2 = clientSocket.recv(1024).decode('utf-8')
+print ('222+',recv2)
+
+userCommand = b64encode('2@test.com'.encode('utf-8'))
+clientSocket.send((str(userCommand,encoding='utf-8')+'\r\n').encode())
+recv3 = clientSocket.recv(1024).decode('utf-8')
+print ('333+',recv3)
+
+password = b64encode('2'.encode('utf-8'))
+clientSocket.send((str(password,encoding='utf-8')+'\r\n').encode())
+recv4 = clientSocket.recv(1024).decode('utf-8')
+print ('444+',recv4)
+
+#print('0000000000000000')
+
+clientSocket.send(bytes(mailfrom.encode()))
+check = clientSocket.recv(1024)
+print(check)
+clientSocket.send(bytes(rcptto.encode()))#将RCPT发送到命令和打印服务器响应。
+check1 = clientSocket.recv(1024)
+print(check1)
+clientSocket.send(bytes(data.encode()))#发送数据命令和打印服务器响应。
+check2 = clientSocket.recv(1024)
+print(check2)
+clientSocket.send(bytes((mailfrom+msg+endmsg).encode()))#发送消息数据。
+check3 = clientSocket.recv(1024)
+print(check3)
+#发送退出命令并获得服务器响应。
+clientSocket.send(bytes(quitmsg.encode()))
+check4 = clientSocket.recv(1024)
+print(check4)
+clientSocket.close()
diff --git a/CODE/chapter2/UDP_Pinger_Client.py b/CODE/chapter2/UDP_Pinger_Client.py
new file mode 100644
index 0000000..db005cf
--- /dev/null
+++ b/CODE/chapter2/UDP_Pinger_Client.py
@@ -0,0 +1,19 @@
+from socket import *
+import time
+serverName = 'localhost'
+serverPort = 12000
+clientSocket = socket(AF_INET, SOCK_DGRAM)
+clientSocket.settimeout(1)
+
+for i in range(0, 10):
+ sendTime = time.time()
+ message = ('Ping %d %s' % (i + 1, sendTime)).encode()
+ try:
+ clientSocket.sendto(message, (serverName, serverPort))
+ modifiedMessage, serverAddress = clientSocket.recvfrom(2048)
+ rtt = time.time() - sendTime
+ print('Sequence %d: Reply from %s RTT = %.3fs' % (i + 1, serverName, rtt))
+ except Exception as e:
+ print('Sequence %d: Request timed out' % (i + 1))
+
+clientSocket.close()
diff --git a/CODE/chapter2/UDP_Pinger_Server.py b/CODE/chapter2/UDP_Pinger_Server.py
new file mode 100644
index 0000000..25bda49
--- /dev/null
+++ b/CODE/chapter2/UDP_Pinger_Server.py
@@ -0,0 +1,11 @@
+import random
+from socket import *
+serverSocket = socket(AF_INET, SOCK_DGRAM)
+serverSocket.bind(('', 12000))
+while True:
+ rand = random.randint(0, 10)
+ message, address = serverSocket.recvfrom(1024)
+ message = message.upper()
+ if (rand < 4):
+ continue
+ serverSocket.sendto(message, address)
diff --git a/CODE/chapter2/Websever.py b/CODE/chapter2/Websever.py
new file mode 100644
index 0000000..1d72b0d
--- /dev/null
+++ b/CODE/chapter2/Websever.py
@@ -0,0 +1,62 @@
+# Import socket module
+from socket import *
+import sys # In order to terminate the program
+
+# Create a TCP server socket
+#(AF_INET is used for IPv4 protocols)
+#(SOCK_STREAM is used for TCP)
+
+serverSocket = socket(AF_INET, SOCK_STREAM)
+
+# Assign a port number
+serverPort = 80
+
+# Bind the socket to server address and server port
+serverSocket.bind(("", serverPort))
+
+# Listen to at most 1 connection at a time
+serverSocket.listen(1)
+
+# Server should be up and running and listening to the incoming connections
+
+while True:
+ print('The server is ready to receive')
+
+ # Set up a new connection from the client
+ connectionSocket, addr = serverSocket.accept()
+
+ # If an exception occurs during the execution of try clause
+ # the rest of the clause is skipped
+ # If the exception type matches the word after except
+ # the except clause is executed
+ try:
+ # Receives the request message from the client
+ message = connectionSocket.recv(1024).decode()
+ # Extract the path of the requested object from the message
+ # The path is the second part of HTTP header, identified by [1]
+ filename = message.split()[1]
+ # Because the extracted path of the HTTP request includes
+ # a character '\', we read the path from the second character
+ f = open(filename[1:])
+ # Store the entire contenet of the requested file in a temporary buffer
+ outputdata = f.read()
+ # Send the HTTP response header line to the connection socket
+ connectionSocket.send("HTTP/1.1 200 OK\r\n\r\n".encode())
+
+ # Send the content of the requested file to the connection socket
+ for i in range(0, len(outputdata)):
+ connectionSocket.send(outputdata[i].encode())
+ connectionSocket.send("\r\n".encode())
+
+ # Close the client connection socket
+ connectionSocket.close()
+
+ except IOError:
+ # Send HTTP response message for file not found
+ connectionSocket.send("HTTP/1.1 404 Not Found\r\n\r\n".encode())
+ connectionSocket.send("404 Not Found
\r\n".encode())
+ # Close the client connection socket
+ connectionSocket.close()
+
+serverSocket.close()
+sys.exit()#Terminate the program after sending the corresponding data
diff --git a/Readme.md b/Readme.md
index ad7bd80..97cb99f 100644
--- a/Readme.md
+++ b/Readme.md
@@ -11,21 +11,30 @@
项目根目录下的目录功能如下：
+* book：实验指导书主文件
* data：实验指导书分章节内容
+* code：参考代码
* figure：用到的图片
* bib：参考文献
## 3. 编译
-1. Windows 环境下，需要安装最新版texlive套件，然后在工程目录下运行以下命令编译：
+因为使用minted宏包对文中的代码进行语法高亮，因此在编译代码前需要安装minted的依赖Pygments。
+建议使用Python的包管理工具进行安装。Pygments可以在各种操作系统下运行。
- ```shell
+``` shell
+$ pip install Pygments
+```
+
+1. Windows 环境下，推荐使用最新版TeX Live套件，然后在工程目录下运行以下命令编译：
+
+ ``` shell
compile.bat
```
-2. MacOS 环境下，需要安装MacTex套件，然后编译。
+2. MacOS 环境下，推荐使用MacTex套件，然后编译。
-3. Linux 环境下，需要安装texlive套件，然后编译。
+3. Linux 环境下，推荐使用最新版TeX Live套件，然后编译。
## 4. 说明
diff --git a/instructions.cfg b/book/instructions.cfg
similarity index 94%
rename from instructions.cfg
rename to book/instructions.cfg
index 0795729..27a6315 100644
--- a/instructions.cfg
+++ b/book/instructions.cfg
@@ -1,6 +1,6 @@
%# -*- coding: utf-8-unix -*-
%======================================================================
-%% qbook.cfg for Qbook Template
+%% Book Configurations
%======================================================================
\ProvidesFile{qbook.cfg}[2019/03/19 v1.00 Qbook configuration file]
\def\q@contentsname{目~~~~录}
diff --git a/instructions.cls b/book/instructions.cls
similarity index 98%
rename from instructions.cls
rename to book/instructions.cls
index de237c3..ce7454d 100644
--- a/instructions.cls
+++ b/book/instructions.cls
@@ -30,7 +30,7 @@
\RequirePackage{fancyhdr}
\RequirePackage{lastpage}
\RequirePackage{amsmath,mathtools,amsthm,amsfonts,amssymb,bm}
-\RequirePackage{sourcecodepro}
+% \RequirePackage{sourcecodepro}
\RequirePackage{upgreek}
\RequirePackage{wasysym}
\RequirePackage{anyfontsize}
@@ -66,6 +66,7 @@
\newcommand{\sectionbreak}{\clearpage}
\usepackage{setspace}
+% \usepackage{makecell}
%======================================================================
% 导入tikz库
@@ -196,8 +197,7 @@
% 设置item条目的索引符号为bullet
\renewcommand{\labelitemi}{\ensuremath{\RHD}}
%======================================================================
-% 设置图片载入路径及扩展名
-\graphicspath{{fig/}{figure/}{figures/}{logo/}{logos/}{graph/}{graphs}}
+% 设置图片扩展名
\DeclareGraphicsExtensions{.pdf,.eps,.png,.jpg,.jpeg}
%======================================================================
% 设置图片的标题样式
@@ -227,6 +227,7 @@
%======================================================================
% 定理、公式、图、表的编号为"3.1"的形式
\numberwithin{figure}{section}
+\numberwithin{table}{section}
\renewcommand{\theequation}{\arabic{chapter}.\arabic{equation}}
\renewcommand{\thefigure}{\arabic{chapter}.\arabic{section}--\arabic{figure}}
\renewcommand\p@subfigure{\thefigure}
@@ -401,14 +402,14 @@
%定制代码框
\newtcblisting{code}[1][]{
center,
- width=0.9\linewidth,
+ width=0.95\linewidth,
listing only,
breakable=true,
minted language=#1,
- frame empty,
+ % frame empty,
extras={frame empty},
% minted style=colorful,
- fontupper=\footnotesize,
+ fontupper=\small,
minted options={ %自动移除前置空白、制表为4字符、mathhe和||内的不处理
breaksymbol=,
autogobble,
diff --git a/book/instructions.tex b/book/instructions.tex
new file mode 100644
index 0000000..cf4180a
--- /dev/null
+++ b/book/instructions.tex
@@ -0,0 +1,120 @@
+%# -*- coding: utf-8-unix -*-
+%=========================================================================
+% instructions.tex for Computer Network Assigenment & Project Instructions
+%=========================================================================
+% 双面打印
+% \documentclass[fontset=fandol]{../format/instructions}
+\documentclass[]{instructions}
+\addbibresource{../bib/main.bib} % 导入参考文献数据库
+\begin{document}
+\pagestyle{empty}
+\input{../data/cover} % 载入封面
+
+%=========================================================================
+% 版本声明
+\clearpage
+\begin{center}
+ \Large{\sffamily\bfseries\heiti Version 0.4} \\ \vspace{2em}
+ \Large{\sffamily\bfseries\heiti 发布日期: \today} \\ \vspace{1em}
+\end{center}
+
+% \vfill
+% \vspace{30em}
+% \begin{tabular*}{\textwidth}{ccc}
+% \includegraphics{figure/by-nc.eps}
+% & \begin{minipage}[b]{0.6\textwidth}
+% \small\sffamily
+% 本作品采用知识共享 署名-非商业性使用 4.0 国际许可协议进行许可。\\
+% 访问~\href{http://creativecommons.org/licenses/by-nc/4.0/}{此链接}~查看该许可协议。
+% \end{minipage}
+% \end{tabular*}
+
+%=========================================================================
+% 前言
+\thispagestyle{empty}
+\frontmatter % 对前言和概览用罗马数字作为页码
+\pagestyle{empty}
+\input{../data/preface}
+
+%=========================================================================
+% 目录
+\cleardoublepage
+\pagestyle{empty}
+\tableofcontents
+\mainmatter % 对正文用阿拉伯数字作为页码
+
+%======================================================================
+% 正文内容
+\pagestyle{fancy}
+\setcounter{page}{1}
+
+% “网络抓包与协议分析”
+\graphicspath{{../figure/chapters/wireshark/}}
+\input{../data/ch_wireshark/preface}
+\input{../data/ch_wireshark/sec_arp}
+\input{../data/ch_wireshark/sec_ip}
+\input{../data/ch_wireshark/sec_tcp}
+
+% “基于套接字的网络程序设计”
+\graphicspath{{../figure/chapters/socket/}}
+\input{../data/ch_socket/preface}
+\input{../data/ch_socket/sec_udp}
+\input{../data/ch_socket/sec_web}
+\input{../data/ch_socket/sec_smtp}
+
+
+% “组网基础”
+\graphicspath{{../figure/chapters/ensp/}}
+\input{../data/ch_ensp/preface}
+\input{../data/ch_ensp/sec_static}
+\input{../data/ch_ensp/sec_rip}
+\input{../data/ch_ensp/sec_ospf}
+
+% “路由器实现”
+\graphicspath{{../figure/chapters/router-openbox/}}
+\input{../data/ch_router-openbox/preface}
+\input{../data/ch_router-openbox/sec_switch}
+\input{../data/ch_router-openbox/sec_router}
+\input{../data/ch_router-openbox/sec_networking}
+
+% “软件定义网络与网络测量”
+\graphicspath{{../figure/chapters/sdn-openbox/}}
+\input{../data/ch_sdn-openbox/preface}
+\input{../data/ch_sdn-openbox/sec_sdn}
+\input{../data/ch_sdn-openbox/sec_topo}
+\input{../data/ch_sdn-openbox/sec_ns}
+
+
+%=========================================================================
+% 附录
+\appendix
+\titleformat{\chapter}[display]{\flushleft}{
+ \begin{tikzpicture}
+ \node[anchor=south west] (chap) at (0,1.3){
+ \Large\heiti {附录\Alph{chapter}}};
+ \path [left color=c1,right color=c3] (0,-0.3) rectangle (\textwidth,-0.5);
+ \path(0,-0.2);
+ \end{tikzpicture}
+}{-30mm}{\Huge\heiti}
+\titlespacing{\chapter}{0pt}{0pt}{2\baselineskip}
+\renewcommand{\thefigure}{\Alph{chapter}--\arabic{figure}}
+\renewcommand{\thetable}{\Alph{chapter}--\arabic{table}}
+\renewcommand{\chaptername}{附录\Alph{chapter}}
+
+\graphicspath{{../figure/appendixes/ensp/}}
+\input{../data/appendix/ensp}
+
+\graphicspath{{../figure/appendixes/openbox/}}
+\input{../data/appendix/openbox}
+
+\graphicspath{{../figure/appendixes/fast/}}
+\input{../data/appendix/fast}
+
+\backmatter
+%======================================================================
+% 参考文献
+% \printbibliography[heading=bibintoc]
+% \makeatletter
+% \makeatother
+
+\end{document}
\ No newline at end of file
diff --git a/code/ch_socket/SMTPClient.py b/code/ch_socket/SMTPClient.py
new file mode 100644
index 0000000..bfec76a
--- /dev/null
+++ b/code/ch_socket/SMTPClient.py
@@ -0,0 +1,66 @@
+from socket import *
+from base64 import *
+
+mailfrom = "mail from:2@test.com\r\n"
+rcptto = "rcpt to:1@test.com\r\n"
+data = "data\r\n"
+quitmsg = "quit\r\n"
+
+msg = "\r\n I love computer networks!"
+endmsg = "\r\n.\r\n"
+#此处使用易邮邮件服务器软件搭建了一个内网邮件服务器
+mailserver = '10.130.82.62'
+mailport = 25
+connectaddress = (mailserver, mailport)
+# Create socket called clientSocket and establish a TCP connection with mailserver
+clientSocket = socket(AF_INET, SOCK_STREAM)
+clientSocket.connect(connectaddress)
+
+recv = clientSocket.recv(1024)
+print (recv)
+if recv[:3] != '220':
+ print ('220 reply not received from server.')
+# Send HELO command and print server response.
+heloCommand = 'HELO Alice\r\n'
+clientSocket.send(bytes(heloCommand.encode()))
+recv1 = clientSocket.recv(1024)
+print (recv1.decode())
+if recv1[:3] != '250':
+ print ('250 reply not received from server.')
+
+#print('000000000000000')
+#从命令和打印服务器响应发送邮件。
+login = b'auth login\r\n'
+clientSocket.send(login)
+recv2 = clientSocket.recv(1024).decode('utf-8')
+print ('222+',recv2)
+
+userCommand = b64encode('2@test.com'.encode('utf-8'))
+clientSocket.send((str(userCommand,encoding='utf-8')+'\r\n').encode())
+recv3 = clientSocket.recv(1024).decode('utf-8')
+print ('333+',recv3)
+
+password = b64encode('2'.encode('utf-8'))
+clientSocket.send((str(password,encoding='utf-8')+'\r\n').encode())
+recv4 = clientSocket.recv(1024).decode('utf-8')
+print ('444+',recv4)
+
+#print('0000000000000000')
+
+clientSocket.send(bytes(mailfrom.encode()))
+check = clientSocket.recv(1024)
+print(check)
+clientSocket.send(bytes(rcptto.encode()))#将RCPT发送到命令和打印服务器响应。
+check1 = clientSocket.recv(1024)
+print(check1)
+clientSocket.send(bytes(data.encode()))#发送数据命令和打印服务器响应。
+check2 = clientSocket.recv(1024)
+print(check2)
+clientSocket.send(bytes((mailfrom+msg+endmsg).encode()))#发送消息数据。
+check3 = clientSocket.recv(1024)
+print(check3)
+#发送退出命令并获得服务器响应。
+clientSocket.send(bytes(quitmsg.encode()))
+check4 = clientSocket.recv(1024)
+print(check4)
+clientSocket.close()
diff --git a/code/ch_socket/UDP_Pinger_Client.py b/code/ch_socket/UDP_Pinger_Client.py
new file mode 100644
index 0000000..db005cf
--- /dev/null
+++ b/code/ch_socket/UDP_Pinger_Client.py
@@ -0,0 +1,19 @@
+from socket import *
+import time
+serverName = 'localhost'
+serverPort = 12000
+clientSocket = socket(AF_INET, SOCK_DGRAM)
+clientSocket.settimeout(1)
+
+for i in range(0, 10):
+ sendTime = time.time()
+ message = ('Ping %d %s' % (i + 1, sendTime)).encode()
+ try:
+ clientSocket.sendto(message, (serverName, serverPort))
+ modifiedMessage, serverAddress = clientSocket.recvfrom(2048)
+ rtt = time.time() - sendTime
+ print('Sequence %d: Reply from %s RTT = %.3fs' % (i + 1, serverName, rtt))
+ except Exception as e:
+ print('Sequence %d: Request timed out' % (i + 1))
+
+clientSocket.close()
diff --git a/code/ch_socket/UDP_Pinger_Server.py b/code/ch_socket/UDP_Pinger_Server.py
new file mode 100644
index 0000000..25bda49
--- /dev/null
+++ b/code/ch_socket/UDP_Pinger_Server.py
@@ -0,0 +1,11 @@
+import random
+from socket import *
+serverSocket = socket(AF_INET, SOCK_DGRAM)
+serverSocket.bind(('', 12000))
+while True:
+ rand = random.randint(0, 10)
+ message, address = serverSocket.recvfrom(1024)
+ message = message.upper()
+ if (rand < 4):
+ continue
+ serverSocket.sendto(message, address)
diff --git a/code/ch_socket/Websever.py b/code/ch_socket/Websever.py
new file mode 100644
index 0000000..d901408
--- /dev/null
+++ b/code/ch_socket/Websever.py
@@ -0,0 +1,62 @@
+# Import socket module
+from socket import *
+import sys # In order to terminate the program
+
+# Create a TCP server socket
+#(AF_INET is used for IPv4 protocols)
+#(SOCK_STREAM is used for TCP)
+
+serverSocket = socket(AF_INET, SOCK_STREAM)
+
+# Assign a port number
+serverPort = 80
+
+# Bind the socket to server address and server port
+serverSocket.bind(("", serverPort))
+
+# Listen to at most 1 connection at a time
+serverSocket.listen(1)
+
+# Server should be up and running and listening to the incoming connections
+
+while True:
+ print('The server is ready to receive')
+
+ # Set up a new connection from the client
+ connectionSocket, addr = serverSocket.accept()
+
+ # If an exception occurs during the execution of try clause
+ # the rest of the clause is skipped
+ # If the exception type matches the word after except
+ # the except clause is executed
+ try:
+ # Receives the request message from the client
+ message = connectionSocket.recv(1024).decode()
+ # Extract the path of the requested object from the message
+ # The path is the second part of HTTP header, identified by [1]
+ filename = message.split()[1]
+ # Because the extracted path of the HTTP request includes
+ # a character '\', we read the path from the second character
+ f = open(filename[1:])
+ # Store the entire contenet of the requested file in a temporary buffer
+ outputdata = f.read()
+ # Send the HTTP response header line to the connection socket
+ connectionSocket.send("HTTP/1.1 200 OK\r\n\r\n".encode())
+
+ # Send the content of the requested file to the connection socket
+ for i in range(0, len(outputdata)):
+ connectionSocket.send(outputdata[i].encode())
+ connectionSocket.send("\r\n".encode())
+
+ # Close the client connection socket
+ connectionSocket.close()
+
+ except IOError:
+ # Send HTTP response message for file not found
+ connectionSocket.send("HTTP/1.1 404 Not Found\r\n\r\n".encode())
+ connectionSocket.send("404 Not Found
\r\n".encode())
+ # Close the client connection socket
+ connectionSocket.close()
+
+serverSocket.close()
+sys.exit()#Terminate the program after sending the corresponding data
diff --git a/compile.bat b/compile.bat
index 846faf9..6759aad 100644
--- a/compile.bat
+++ b/compile.bat
@@ -42,7 +42,7 @@ goto :EOF
:instr
echo Compile...
- latexmk -xelatex -halt-on-error -silent instructions >nul 2>nul
+ latexmk -xelatex -shell-escape --halt-on-error -silent books\instructions >nul 2>nul
goto :EOF
:clean
diff --git a/data/appendix/ensp.tex b/data/appendix/ensp.tex
index 6fc1459..35eb905 100644
--- a/data/appendix/ensp.tex
+++ b/data/appendix/ensp.tex
@@ -8,17 +8,28 @@
\subsection{本地安装华为ENSP软件}
可在本机安装华为ENSP软件。
-安装版本如选择的是华为ENSP17年版本的，则安装包里自带所需软件，
-则无需另行下载，默认4款软件全部安装；
-如选择的是华为ENSP最新版即19年的版本，
-在安装之前须自行下载安装以下3款软件且最好版本号一致：
-\begin{figure}[!htp]
+安装版本如选择的是华为ENSP17年版本的，
+则安装包里自带所需软件，则无需另行下载，
+默认4款软件全部安装；如选择的是华为ENSP最新版即19年的版本，
+在安装之前须自行下载安装以下3款软件且最好版本号一致。
+
+eNSP的正常实验依赖与WinPcap、Wireshark和VirtualBox三款软件，
+支持的版本如下表。
+
+\renewcommand{\arraystretch}{1.5}
+\begin{table}[!ht]
+ \small
\centering
- \includegraphics[width=11cm]{a1_ENSP-version}
- \caption{TCP连接示意时序}
- \label{fig:a1_ENSP-version}
-\end{figure}
+ \caption{华为ENSP需安装软件及对应版本号}
+ \label{tab:a:wireshark_eth-format}
+ \begin{tabular}{|c|c|} \hline
+ \heiti 软件类别 & \heiti 版本号\\ \hline
+ WinPcap & 4.1.3\\ \hline
+ Wireshark & 2.6.6\\ \hline
+ VirtualBox & 4.2.X-5.2.X\\ \hline
+ \end{tabular}
+\end{table}
\textbf{安装注意事项：}先装3款基础软件后再安装华为ENSP，
所有安装都建议默认安装，最好不要更改安装盘，更不要设置中文安装目录，
@@ -26,28 +37,28 @@
\subsection{华为ENSP操作和使用}
华为ENSP的操作和使用，强烈建议查看其帮助，并不断实践，如图：
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
- \includegraphics[width=13cm]{a1_ENSP-UI}
+ \includegraphics[width=13cm]{ENSP-UI}
\caption{华为ENSP界面}
- \label{fig:a1_ENSP-version}
+ \label{fig:a1_ENSP-ui}
\end{figure}
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
- \includegraphics[width=13cm]{a1_ENSP-help}
+ \includegraphics[width=13cm]{ENSP-help}
\caption{华为ENSP帮助界面}
- \label{fig:a1_ENSP-version}
+ \label{fig:a1_ENSP-help}
\end{figure}
\subsection{华为模拟设备的基本配置及其配置命令}
-命令行接口是用户对命令行使用的常用工具。
-通过命令行接口输入命令，您可以对交换机进行配置和管理。
-用户登录到交换机出现命令行提示符后，
-即进入命令行接口CLI（Command Line Interface）。
-命令行接口是用户与交换机进行交互的常用工具。
-系统向用户提供一系列命令，
-用户可以通过命令行接口输入命令，对交换机进行配置和管理。
+ 命令行接口是用户对命令行使用的常用工具。
+ 通过命令行接口输入命令，您可以对交换机进行配置和管理。
+ 用户登录到交换机出现命令行提示符后，
+ 即进入命令行接口CLI（Command Line Interface）。
+ 命令行接口是用户与交换机进行交互的常用工具。
+ 系统向用户提供一系列命令，
+ 用户可以通过命令行接口输入命令，对交换机进行配置和管理。
\subsubsection{命令视图}
@@ -55,16 +66,18 @@
系统的所有命令都注册在某个（或某些）命令视图下，
只有在相应的视图下才能执行该视图下的命令。
-\begin{table}[!htp]
+\renewcommand{\arraystretch}{1.5}
+\begin{table}[!ht]
+ \small
\centering
\caption{命令视图分类表}
- \label{tab:c1_tools-command}
- \begin{tabular}{m{5cm}<{\centering}m{6cm}<{\centering}} \toprule
- 视图 & 表现形式\\ \midrule
- 用户视图（缺省配置） & \texttt{}\\
- 系统视图 & \texttt{[Quidway]}\\
- 接口视图 & \texttt{[Quidway-ethernetX]}\\
- VLAN视图 & \texttt{[Quidway-VLANX]}\\ \bottomrule
+ \label{tab:a:ensp_command_ui}
+ \begin{tabular}{|c|c|} \hline
+ \heiti 视图 & \heiti 表现形式\\ \hline
+ 用户视图（缺省配置） & \texttt{}\\ \hline
+ 系统视图 & \texttt{[Quidway]}\\ \hline
+ 接口视图 & \texttt{[Quidway-ethernetX]}\\ \hline
+ VLAN视图 & \texttt{[Quidway-VLANX]}\\ \hline
\end{tabular}
\end{table}
@@ -98,7 +111,7 @@
[Quidway]
\end{code}
\end{itemize}
-
+
说明：命令行提示符“Quidway”是缺省的主机名（sysname）。
通过提示符可以判断当前所处的视图，例如：“<>”表示用户视图，
“[]”表示除用户视图以外的其它视图。
@@ -112,7 +125,7 @@ Ctrl+Z：(在其他模式下)保存设置并退出到特权模式
Tab键的功用：完成一个命令的输入。在超级终端中，可能不支持某些组合键。
\textbf{注：}在不引起歧义的情况下，命令和参数均可以缩写
-
+
\textbf{在线帮助}
输入命令行或进行配置业务时，在线帮助可以提供在配置手册之外的实时帮助。
@@ -124,25 +137,30 @@ Tab键的功用：完成一个命令的输入。在超级终端中，可能不
\item 命令行错误信息
\end{itemize}
-\begin{table}[!htp]
+\renewcommand{\arraystretch}{1.5}
+\begin{table}[!ht]
+ \small
\centering
\caption{帮助类型与对应命令表}
- \label{tab:c1_tools-command}
- \begin{tabular}{m{2cm}<{\centering}m{5cm}<{\centering}m{6cm}<{\centering}} \toprule
- 帮助类型 & 表现形式 & 备注\\ \midrule
- \multirow{2}{*}{完全帮助} & \texttt{?} & 相应命令模式下\\
- & \texttt{[Quidway] sysname ?} & 键入命令，后接以空格分隔的“?”\\\midrule
- 部分帮助 & \texttt{d?} & 键入一字符串，其后紧接“?”，列出以该字符串开头的所有关键字\\\midrule
- 命令行错误信息 & & 如未通过语法检查则系统会向用户报告错误信息\\ \bottomrule
+ \label{tab:a:ensp_help}
+ \begin{tabular}{|m{2cm}<{\centering}|m{5cm}<{\centering}|m{6cm}<{\centering}|} \hline
+ \heiti 帮助类型 & \heiti 表现形式 & \heiti 备注\\ \hline
+ \multirow{2}{*}{完全帮助} & \texttt{?} & 相应命令模式下\\ \cline{2-3}
+ & \texttt{[Quidway] sysname ?} & 键入命令，后接以空格分隔的“?”\\ \hline
+ 部分帮助 & \texttt{d?} & 键入一字符串，其后紧接“?”，列出以该字符串开头的所有关键字\\ \hline
+ 命令行错误信息 & & 如未通过语法检查则系统会向用户报告错误信息\\ \hline
\end{tabular}
\end{table}
\begin{enumerate}
\item \textbf{完全帮助}
-
+
应用完全帮助，系统可以协助您在输入命令行时，给予全部关键字或参数的提示。
+
命令行的完全帮助可以通过以下3种方式获取：
+
在所有命令视图下，键入“?”获取该命令视图下所有的命令及其简单描述。
+
\begin{code}[text]
?
\end{code}
@@ -205,44 +223,49 @@ Tab键的功用：完成一个命令的输入。在超级终端中，可能不
Bootrombpdu
bpdu-tunnel buffer
\end{code}
-
+
输入命令的某个关键字的前几个字母，按下键，
可以显示出完整的关键字，前提是这几个字母可以唯一标示出该关键字，
否则，连续按下键，可出现不同的关键字，用户可以从中选择所需要的关键字。
-
+
\item 命令行错误信息
所有用户键入的命令，如果通过语法检查，则正确执行，
- 否则系统将会向用户报告错误信息。常见错误信息参见下表：
+ 否则系统将会向用户报告错误信息。常见错误信息参见表\ref{tab:a:ensp_error}：
- \begin{table}[!htp]
+ \begin{table}[!ht]
+ \small
\centering
\caption{命令行常见错误信息表}
- \label{tab:c1_tools-command}
- \begin{tabular}{m{4cm}<{\centering}m{5cm}<{\centering}} \toprule
- 英文错误信息 & 错误原因\\ \midrule
- \multirow{2}{*}{Unrecognized command} & 没有查找到命令\\
- & 没有查找到关键字\\\midrule
- \multirow{2}{*}{Wrong parameter} & 参数类型错\\
- & 参数值越界\\\midrule
- Incomplete command & 输入命令不完整\\\midrule
- Too many parameters & 输入参数太多\\\midrule
- Ambiguous command & 输入命令不明确\\ \bottomrule
- \end{tabular}
+ \label{tab:a:ensp_error}
+ \begin{tabular}{|m{4cm}<{\centering}|m{5cm}<{\centering}|} \hline
+ \heiti 英文错误信息 & \heiti 错误原因\\ \hline
+ \multirow{2}{*}{Unrecognized command} & 没有查找到命令\\ \cline{2-2}
+ & 没有查找到关键字\\ \hline
+ \multirow{2}{*}{Wrong parameter} & 参数类型错\\ \cline{2-2}
+ & 参数值越界\\\hline
+ Incomplete command & 输入命令不完整\\\hline
+ Too many parameters & 输入参数太多\\\hline
+ Ambiguous command & 输入命令不明确\\ \hline
+ \end{tabular}
\end{table}
- \textbf{注意：}可以用display cur检查当前系统中已经配置的命令。
+ \textbf{注意：}可以用display~cur检查当前系统中已经配置的命令。
如果命令输出过多，显示一屏幕后会暂停，
这时可以用空格键翻页，用q或者ctrl+c退出。
\end{enumerate}
\subsection{常见问题的解决方法}
- 模拟器毕竟是模拟的，有问题是难免的，如下图令人崩溃的设备启动后进入命令配置界面的等待。如长时间都不能正常工作，建议新建一台设备，如正常后替代失常设备，重新连线。就本人多年指导经验，各种问题会小概率出现，默认重装，更换版本则解决地较为彻底。
+ 模拟器毕竟是模拟的，有问题是难免的，
+ 如下图令人崩溃的设备启动后进入命令配置界面的等待。
+ 如长时间都不能正常工作，建议新建一台设备，如正常后替代失常设备，
+ 重新连线。就本人多年指导经验，各种问题会小概率出现，
+ 默认重装，更换版本则解决地较为彻底。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=10cm]{a1_error}
+ \includegraphics[width=10cm]{error}
\caption{令人崩溃的等待}
\label{fig:a1_error}
\end{figure}
diff --git a/data/appendix/fast.tex b/data/appendix/fast.tex
new file mode 100644
index 0000000..954ca99
--- /dev/null
+++ b/data/appendix/fast.tex
@@ -0,0 +1,836 @@
+%# -*- coding: utf-8-unix -*-
+
+\chapter{FAST软件编程入门指南}
+\label{app:fast}
+
+\subsection{前言}
+
+本文档的主要阅读对象是首次使用FAST平台进行软件开发的工作人员。
+文档主要描述了FAST架构软件的主要功能、如何获取软件代码、
+介绍软件架构与对应代码结构、编译运行FAST代码。
+详细介绍了FAST开发的主要使用函数，
+描述了用户如何使用开发函数进行自己代码的开发流程，
+最后提供一个完整的开发示例说明，供初学者学习使用。
+
+\subsection{FAST能做什么}
+
+FAST平台的主要功能是软硬件配合的网络分组处理功能，
+硬件的主要作用是解析报文，对报文进行查表匹配，
+进行指定的动作处理，然后分发报文。
+报文分发可以直接转发到硬件端口，也可以送到CPU端的UA进程再处理，
+UA处理完成后可以再通过硬件转发从端口输出。
+软件的主要功能有两点：
+一是对硬件的流表与对应动作进行配置，指定报文从硬件端口转发或送到CPU端的UA；
+二是处理硬件无法处理的报文，处理完成后再转发到硬件输出。
+
+FAST软件的编程主要包括UA编程、规则管理编程和寄存器访问控制编程。
+UA编程主要处理硬件送到指定软件的分组数据；
+规则管理编程主要是对硬件流表的读写管理；
+寄存器访问控制编程主要是对硬件各寄存器资源的访问控制。
+对硬件规则的读写与对硬件其他寄存器的读写需要了解FAST架构的虚拟地址空间定义。
+
+\subsection{FAST软件获取}
+\label{subsec:app:fast_get-soft}
+
+FAST的软硬件代码和相关工具下载请查看文章结尾的百度网盘链接。
+
+\subsection{FAST代码结构}
+
+\subsubsection{目录结构}
+
+\renewcommand{\arraystretch}{1.5}
+\begin{table}[!ht]
+ \small
+ \centering
+ \caption{以太网帧格式}
+ \label{tab:c:wireshark_eth-format}
+ \begin{tabular}{|c|c|c|} \hline
+ \heiti 序号 & \heiti 目录名称 & \heiti 说明\\ \hline
+ 1 & include & 开发所用头文件目录\\ \hline
+ 2 & lib & ua、寄存器读写库目录\\ \hline
+ 4 & app & fast应用工具\\ \hline
+ 6 & tools & 调试测试示例工具\\ \hline
+ 7 & src & 综合示例代码测试\\ \hline
+ \end{tabular}
+\end{table}
+
+\subsubsection{头文件}
+
+\begin{enumerate}
+ \item Fast\_vaddr.h：FAST平台硬件资源访问对应的虚拟地址空间定义
+ \item Fast\_type.h：FAST平台所用数据类型定义
+ \item Fast\_err.h：FAST平台错误号定义
+ \item Fast\_struct.h：FAST平台数据结构类型定义
+ \item Fast.h：FAST平台所有开发函数定义，包含上述所有头文件
+ \item 其他：不同平台的适配头文件
+\end{enumerate}
+
+\subsubsection{开发示例}
+
+开发示例提供了一个基于FAST架构的2层交换机实例，
+综合使用了libreg和libua两个库实现了一个全软件的2层交换机功能。
+
+\begin{enumerate}
+ \item L2switch
+
+ L2switch是基于FAST架构开发一个2层以太网交换机原型，
+ 通过对流表默认规则的设置，将硬件所有的分组重定向到UA程序，
+ 然后在UA的分组处理回调函数中实现对分组的2层交换，
+ 然后将分组从指定端口发送或泛洪发送。
+ 该示例主要演示了UA编程开发的主要方法与流程、使用的相关函数，
+ 硬件寄存器地址的操作，以及2层交换机的实现原理。
+
+\item xofp
+
+ xofp是基于FAST架构开发一个SDN交换机原型，
+ 通过OpenFlow协议连接SDN控制器，SDN交换机默认规则是送往SDN控制器，
+ SDN控制器根据报文数据，配置流表转发下发给硬件，下次进来的报文直接转发输出。
+ 该示例主要演示了SDN交换机OpenFLow协议、处理OpenFLow消息、
+ 使用的相关函数，硬件寄存器地址的操作，以及SDN交换机的实现原理。
+\end{enumerate}
+
+\subsubsection{工具}
+
+示例程序的另一种表现就是FAST提供的一些小工具，包括单独的寄存器读写命令、规则输出命令、端口状态显示命令和端口分组计数命令。
+
+\begin{enumerate}
+ \item Reg\_rw
+
+ 该工具主要是使用libreg库实现一个对用户指定的寄存器进行读写访问操作，展示了用户如何调用libreg的相关库函数进行寄存器访问操作的方法。
+ \item Rule\_hw
+
+ 该工具主要是使用libreg库和librule库实现对硬件流表的获取并分组输出操作，展示了用户如何调用librule库的相关库函数进行规则操作。该工具目前只使用了硬件规则的读取操作，更多规则的功能操作可参考综合测试程序
+ \item Port\_status
+
+ 该工具主要使用libreg库实现了对各端口的协商状态、链路状态等寄存器的访问并进行各状态值的解释。主要展示了不同端口状态的寄存器地址如何计算，各状态寄存器值返回如何解释，示例代码中包含了目前支持的所有状态寄存器及对应功能说明
+ \item Port\_counts
+
+ 该工具主要使用libreg库实现了对各端口分组计数的统计显示，主要展示了不同功能计数统计的寄存器虚拟地址空间定义，各端口对应功能寄存器的计算方法。示例代码中包含了目前支持的所有功能计数统计寄存器定义与说明
+\end{enumerate}
+
+\subsubsection{综合测试}
+
+综合测试程序包含了libreg、librule和libua库的综合开发示例功能。
+首先，用户可以通过此程序了解各功能库的主要使用函数及调用顺序；
+其次，用户可以通过此程序的编译参数了解不同功能库如何添加对应库功能支持
+
+subsection{FAST代码运行}
+
+\subsubsection{软硬件环境}
+FAST平台由湖南新实网络科技有限公司提供销售、售后与技术支持。
+该平台可通过采购或免费申请试用获取，用户拿到FAST平台后，
+默认系统环境均已支持FAST硬件基础版本与FAST软件基础版本。
+FAST硬件基础版本是指基于FAST的标准5组流水线功能；
+FAST软件基础版本是指FAST－XXX软件版本。
+
+如果用户只需要了解软件功能，可以不用FAST设备，
+FAST软件可在通用Linux系统中进行编译与测试，
+没有硬件平台的软件代码，不能进行硬件寄存器读写、规则配置与报文收发功能。
+
+\subsubsection{代码获取}
+参考第\ref{subsec:app:fast_get-soft}节
+
+\subsubsection{代码编译}
+\begin{enumerate}
+ \item 解压代码
+ \begin{code}[console]
+ openbox@OpenBox~/hnxs$ tar –zxf fast-0.4.5.tar.gz
+ openbox@OpenBox~/hnxs$ cd fast-0.4.5
+ openbox@OpenBox~/hnxs/fast-0.4.5$ ls
+ aclocal.m4 config.guess config.sub include ltmain.sh NEWS
+ app config.h configure INSTALL Makefile README
+ AUTHORS config.h.in configure.ac install-sh Makefile.am src
+ ChangeLog config.log COPYING lib Makefile.in stamp-h1
+ compile config.status depcomp libtool missing tools
+ \end{code}
+ \item 配置环境
+ \begin{code}[console]
+ openbox@OpenBox~/hnxs/fast-0.4.5$ ./configure
+ checking for a BSD-compatible install... /usr/bin/install -c
+ checking whether build environment is sane... yes
+ checking for a thread-safe mkdir -p... /bin/mkdir -p
+ checking for gawk... gawk
+ checking whether make sets $(MAKE)... yes
+ checking whether make supports nested variables... yes
+ checking whether make supports nested variables... (cached) yes
+ checking for gcc... gcc
+ checking whether the C compiler works... yes
+ checking for C compiler default output file name... a.out
+ checking for suffix of executables...
+ checking whether we are cross compiling... no
+ checking for suffix of object files... o
+ checking whether we are using the GNU C compiler... yes
+ checking whether gcc accepts -g... yes
+ checking for gcc option to accept ISO C89... none needed
+ checking whether gcc understands -c and -o together... yes
+ checking for style of include used by make... GNU
+ checking dependency style of gcc... gcc3
+ checking whether NLS is requested... yes
+ checking for intltool >= 0.35.0... 0.50.2 found
+ checking for intltool-update... /usr/bin/intltool-update
+ checking for intltool-merge... /usr/bin/intltool-merge
+ checking for intltool-extract... /usr/bin/intltool-extract
+ checking for xgettext... /usr/bin/xgettext
+ checking for msgmerge... /usr/bin/msgmerge
+ checking for msgfmt... /usr/bin/msgfmt
+ checking for gmsgfmt... /usr/bin/msgfmt
+ checking for perl... /usr/bin/perl
+ checking for perl >= 5.8.1... 5.18.2
+ checking for XML::Parser... ok
+ checking how to run the C preprocessor... gcc -E
+ checking for grep that handles long lines and -e... /bin/grep
+ checking for egrep... /bin/grep -E
+ checking for ANSI C header files... yes
+ checking for sys/types.h... yes
+ checking for sys/stat.h... yes
+ checking for stdlib.h... yes
+ checking for string.h... yes
+ checking for memory.h... yes
+ checking for strings.h... yes
+ checking for inttypes.h... yes
+ checking for stdint.h... yes
+ checking for unistd.h... yes
+ checking locale.h usability... yes
+ checking locale.h presence... yes
+ checking for locale.h... yes
+ checking for LC_MESSAGES... yes
+ checking libintl.h usability... yes
+ checking libintl.h presence... yes
+ checking for libintl.h... yes
+ checking for ngettext in libc... yes
+ checking for dgettext in libc... yes
+ checking for bind_textdomain_codeset... yes
+ checking for msgfmt... (cached) /usr/bin/msgfmt
+ checking for dcgettext... yes
+ checking if msgfmt accepts -c... yes
+ checking for gmsgfmt... (cached) /usr/bin/msgfmt
+ checking for xgettext... (cached) /usr/bin/xgettext
+ checking build system type... x86_64-unknown-linux-gnu
+ checking host system type... x86_64-unknown-linux-gnu
+ checking how to print strings... printf
+ checking for a sed that does not truncate output... /bin/sed
+ checking for fgrep... /bin/grep -F
+ checking for ld used by gcc... /usr/bin/ld
+ checking if the linker (/usr/bin/ld) is GNU ld... yes
+ checking for BSD- or MS-compatible name lister (nm)... /usr/bin/nm -B
+ checking the name lister (/usr/bin/nm -B) interface... BSD nm
+ checking whether ln -s works... yes
+ checking the maximum length of command line arguments... 1572864
+ checking whether the shell understands some XSI constructs... yes
+ checking whether the shell understands "+="... yes
+ checking how to convert x86_64-unknown-linux-gnu file names to x86_64-unknown-linux-gnu format... func_convert_file_noop
+ checking how to convert x86_64-unknown-linux-gnu file names to toolchain format... func_convert_file_noop
+ checking for /usr/bin/ld option to reload object files... -r
+ checking for objdump... objdump
+ checking how to recognize dependent libraries... pass_all
+ checking for dlltool... no
+ checking how to associate runtime and link libraries... printf %s\n
+ checking for ar... ar
+ checking for archiver @FILE support... @
+ checking for strip... strip
+ checking for ranlib... ranlib
+ checking command to parse /usr/bin/nm -B output from gcc object... ok
+ checking for sysroot... no
+ checking for mt... mt
+ checking if mt is a manifest tool... no
+ checking for dlfcn.h... yes
+ checking for objdir... .libs
+ checking if gcc supports -fno-rtti -fno-exceptions... no
+ checking for gcc option to produce PIC... -fPIC -DPIC
+ checking if gcc PIC flag -fPIC -DPIC works... yes
+ checking if gcc static flag -static works... yes
+ checking if gcc supports -c -o file.o... yes
+ checking if gcc supports -c -o file.o... (cached) yes
+ checking whether the gcc linker (/usr/bin/ld -m elf_x86_64) supports shared libraries... yes
+ checking whether -lc should be explicitly linked in... no
+ checking dynamic linker characteristics... GNU/Linux ld.so
+ checking how to hardcode library paths into programs... immediate
+ checking whether stripping libraries is possible... yes
+ checking if libtool supports shared libraries... yes
+ checking whether to build shared libraries... yes
+ checking whether to build static libraries... yes
+ checking that generated files are newer than configure... done
+ configure: creating ./config.status
+ config.status: creating Makefile
+ config.status: creating include/Makefile
+ config.status: creating libreg/Makefile
+ config.status: creating libua/Makefile
+ config.status: creating librule/Makefile
+ config.status: creating po/Makefile.in
+ config.status: creating src/Makefile
+ config.status: creating tools/Makefile
+ config.status: creating tools/port_counts/Makefile
+ config.status: creating tools/port_status/Makefile
+ config.status: creating tools/rule/Makefile
+ config.status: creating tools/reg_rw/Makefile
+ config.status: creating tools/debug/Makefile
+ config.status: creating examples/Makefile
+ config.status: creating examples/l2switch/Makefile
+ config.status: creating config.h
+ config.status: executing depfiles commands
+ config.status: executing default-1 commands
+ config.status: executing libtool commands
+ config.status: executing po/stamp-it commands
+ \end{code}
+ \item 编译
+ \begin{code}[console]
+ openbox@OpenBox~/hnxs/fast-0.4.5$ make
+ make all-recursive
+ make[1]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5'
+ Making all in include
+ make[2]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/include'
+ make[2]: 没有什么可以做的为 `all'。
+ make[2]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/include'
+ Making all in libreg
+ make[2]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/libreg'
+ CC main_libreg.o
+ AR libreg.a
+ make[2]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/libreg'
+ Making all in libua
+ make[2]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/libua'
+ CC main_libua.o
+ AR libua.a
+ make[2]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/libua'
+ Making all in librule
+ make[2]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/librule'
+ CC main_librule.o
+ AR librule.a
+ make[2]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/librule'
+ Making all in tools
+ make[2]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/tools'
+ Making all in port_counts
+ make[3]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/tools/port_counts'
+ CC main_port_counts.o
+ CCLD port_counts
+ make[3]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/tools/port_counts'
+ Making all in port_status
+ make[3]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/tools/port_status'
+ CC main_port_status.o
+ CCLD port_status
+ make[3]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/tools/port_status'
+ Making all in rule
+ make[3]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/tools/rule'
+ CC main_rule.o
+ CCLD rule
+ make[3]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/tools/rule'
+ Making all in reg_rw
+ make[3]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/tools/reg_rw'
+ CC main_reg_rw.o
+ CCLD reg_rw
+ make[3]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/tools/reg_rw'
+ Making all in debug
+ make[3]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/tools/debug'
+ CC main_debug.o
+ CCLD debug
+ make[3]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/tools/debug'
+ make[3]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/tools'
+ make[3]: 没有什么可以做的为 `all-am'。
+ make[3]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/tools'
+ make[2]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/tools'
+ Making all in po
+ make[2]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/po'
+ make[2]: 没有什么可以做的为 `all'。
+ make[2]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/po'
+ Making all in src
+ make[2]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/src'
+ CC fast-main.o
+ CCLD fast
+ make[2]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/src'
+ Making all in examples
+ make[2]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/examples'
+ Making all in l2switch
+ make[3]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/examples/l2switch'
+ CC main_l2switch.o
+ CCLD l2switch
+ make[3]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/examples/l2switch'
+ make[3]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5/examples'
+ make[3]: 没有什么可以做的为 `all-am'。
+ make[3]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/examples'
+ make[2]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5/examples'
+ make[2]: 正在进入目录 `/home/openbox/hnxs/fast-0.4.5'
+ make[2]: 没有什么可以做的为 `all-am'。
+ make[2]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5'
+ make[1]:正在离开目录 `/home/openbox/hnxs/fast-0.4.5'
+ \end{code}
+\end{enumerate}
+
+\subsubsection{代码执行}
+\begin{enumerate}
+ \item 读硬件版本号
+ \begin{code}[console]
+ openbox@OpenBox~/hnxs/fast-0.4.5$ reg_rw rd 0
+ \end{code}
+\end{enumerate}
+
+\subsection{FAST数据结构}
+\subsubsection{UM数据结构}
+\begin{code}[c]
+ struct um_metadata{
+ #if defined(__LITTLE_ENDIAN) /*INTER*/
+ #ifdef FAST_10
+ u64 ts:32, /**< @brief 报文接收的时间戳 @note 如果用户需要使用表示更大的时间，建议存储在第二拍数据中（user[2]字段）*/
+ ts2:12,
+ flowID:14, /**< @brief 流ID号*/
+ priority:3, /**< @brief 报文优先级*/
+ discard:1, /**< @brief 指示报文是否丢弃 @note 默认为0，表示不丢弃，置1时表示丢弃*/
+ pktdst:1, /**< @brief 报文的输出目的方向 @note 0表示输出到网络端口，1表示输出到CPU*/
+ pktsrc:1; /**< @brief 报文的输入源方向 @note 0表示网络端口输入，1表示从CPU输入*/
+ u64 outport:16, /**< @brief 报文输出端口号 @note 以bitmap形式表示，1表示从0号端口输出；8表示从3号端口输出*/
+ seq:12, /**< @brief 报文接收时的序列号 @note 每个端口独立维护一个编号*/
+ dstmid:8, /**< @brief 报文下次处理的目的模块编号*/
+ srcmid:8, /**< @brief 报文上次处理时的模块编号*/
+ len:12, /**< @brief 报文长度 @note 最大可表示4095字节，但FAST平台报文缓存区最大为2048，完整以太网报文的MTU不要超过1500*/
+ inport:4, /**< @brief 输入端口号 @note 取值：0——15，最多表示16个输入端口*/
+ ttl:4; /**< @brief 报文通过模块的TTL值，每过一个处理模块减1*/
+ #elif FAST_20
+ u64 ts:32, /**< @brief 时间戳*/
+ reserve:17, /**< @brief 保留*/
+ pktsrc:1, /**< @brief 分组的来源，0为网络接口输入，1为CPU输入，此比特位在进入硬件时会交换到pkttype位置，保留位为18位*/
+ flowID:14; /**< @brief 流ID*/
+ u64 seq:8, /**< @brief 分组接收序列号*/
+ pst:8, /**< @brief 标准协议类型（参考硬件定义）*/
+ dstmid:8, /**< @brief 下一个处理分组的模块ID*/
+ srcmid:8, /**< @brief 最近一次处理分组的模块ID*/
+ len:12, /**< @brief 报文长度*/
+ discard:1, /**< @brief 丢弃位*/
+ priority:3, /**< @brief 分组优先级*/
+ outport:6, /**< @brief 单播：分组输出端口ID，组播/泛洪：组播/泛洪表地址索引*/
+ outtype:2, /**< @brief 输出类型，00：单播，01：组播，10：泛洪，11：从输入接口输出*/
+ inport:6, /**< @brief 分组的输入端口号*/
+ pktdst:1, /**< @brief 分组目的，0为网络接口输出，1为送CPU*/
+ pkttype:1; /**< @brief 报文类型，0：数据报文，1：控制报文。硬件识别报文类别后，会将pktsrc位交换到此，恢复硬件数据格式*/
+ #endif
+ u64 user[2]; /**< @brief 用户自定义metadata数据格式与内容 @remarks 此字段由可用户改写，但需要保证数据大小严格限定在16字节*/
+ #elif defined(__BIG_ENDIAN) /**/
+ #error "(__BIG_ENDIAN)Please fix "
+ #else
+ #error "Please fix "
+ #endif
+ };
+\end{code}
+\subsubsection{FAST报文数据结构}
+\begin{code}[c]
+ struct fast_packet
+ {
+ union
+ {
+ struct um_metadata um; /**< @brief UM模块数据格式定义 @see ::um_metadata */
+ struct ctl_metadata cm; /**< 控制报文格式定义*/
+ struct common_metadata md; /**< 公共控制信息，报文类型（0：数据，1：控制）*/
+ };
+ #ifdef OPENBOX_S28
+ u16 flag; /**< @brief 2字节对齐标志，主要是为了IP地址的对齐 @note 此标志在内核会用来标记是一个FAST类型报文，建议用户不使用些字段*/
+ #endif
+ u8 data[1514]; /**< @brief 完整以太网报文数据，暂时不含CRC数据*/
+ };
+\end{code}
+\subsubsection{流关键字数据结构}
+\begin{code}[c]
+ struct flow /*2017/06/01开始启用，支持IPv6*/
+ {
+ u8 dmac[ETH_ALEN]; /**< @brief Ethernet source address. */
+ u8 smac[ETH_ALEN]; /**< @brief Ethernet destination address. */
+ u16 tci; /**< @brief 0 if no VLAN, VLAN_TAG_PRESENT set otherwise. */
+ u16 type; /**< @brief Ethernet frame type. */
+ //eth-16;
+
+ u8 proto; /**< @brief IP protocol or lower 8 bits of ARP opcode. */
+ u8 tos; /**< @brief IP ToS. */
+ u8 ttl; /**< @brief IP TTL/hop limit. */
+ u8 port:6, /**< @brief Input Port*/
+ frag:2; /**< @brief One of OVS_FRAG_TYPE_*. */
+ //ip=16+4;
+
+ union {
+ struct {
+ u32 src; /**< @brief IP source address. */
+ u32 dst; /**< @brief IP destination address. */
+ //addr;
+
+ union {
+ struct {
+ u16 sport; /**< @brief TCP/UDP/SCTP source port. */
+ u16 dport; /**< @brief TCP/UDP/SCTP destination port. */
+ u16 flags; /**< @brief TCP flags. */
+ } tp; /**< @brief IPv4的传输层端口与标志信息*/
+ struct {
+ u8 sha[ETH_ALEN]; /**< @brief ARP source hardware address. */
+ u8 tha[ETH_ALEN]; /**< @brief ARP target hardware address. */
+ } arp; /**< @brief ARP的MAC地址信息*/
+ }; /**< @brief IPv4传输层信息与ARP信息共用体，二者互斥存在*/
+ } ipv4; /**< @brief IPv4协议相关字段*/
+ struct {
+ struct in6_addr src; /**< @brief IPv6 source address. */
+ struct in6_addr dst; /**< @brief IPv6 destination address. */
+ //addr;
+
+ u32 label; /**< @brief IPv6 flow label. */
+ union {
+ struct {
+ u16 sport; /**< @brief TCP/UDP/SCTP source port. */
+ u16 dport; /**< @brief TCP/UDP/SCTP destination port. */
+ u16 flags; /**< @brief TCP flags. */
+ } tp; /**< @brief IPv6的传输层端口与标志信息*/
+ /*512位宽表项不够，暂不使用ND协议中的targetIP!!!为方便以后扩展，将其移至末尾*/
+ #if 0
+ struct {
+ u8 sll[ETH_ALEN]; /**< @brief ND source link layer address. */
+ u8 tll[ETH_ALEN]; /**< @brief ND target link layer address. */
+ struct in6_xaddr target; /**< @brief ND target address. */
+ } nd;
+ #endif
+ }; /**< @brief IPv6传输层信息与ND信息共用体，二者互斥存在*/
+ u16 nil;
+ } ipv6; /**< @brief IPv6协议相关字段*/
+ };
+ };
+\end{code}
+\subsubsection{流数据结构}
+\begin{code}[c]
+ struct fast_rule{
+ struct flow key; /**< @brief 规则内容存储结构 @see ::flow*/
+ struct flow mask; /**< @brief 规则掩码设置结构,与key一一对应 @see ::flow*/
+ u32 priority; /**< @brief 规则的优先级设置*/
+ u32 valid; /**< @brief 规则的有效标志设置,要删除一条规则只需要将此标记置0,并更新到硬件*/
+ u32 action; /**< @brief 规则所对应的执行动作，动作由两部分组成，高4位为ACTION枚举类型，低28位不此类型对应的值 @see ::ACTION*/
+ /*此前数据必须要写入到硬件*/
+ u32 flow_stats_len; /**< @brief 流表信息长度*/
+ u64 *flow_stats_info; /**< @brief 流表信息存储指针位置*/
+ #ifdef OPENBOX_S4
+ u32 *tmp; /*在S4系统中，上面变量指针大小为32*/
+ #endif
+ u64 cookie; /**< @brief 用来存储流的cookie信息，软件使用*/
+ u64 cookie_mask; /**< @brief 用来存储流cookie的掩码信息，软件使用*/
+ u32 md5[4]; /**< @brief MD5值 @note 用来区分规则的唯一性，软件生成规则时即会判断是否规则重复*/
+ u32 pad[18]; /**< @brief 总长256B，此为确保数据结构大小做的填充*/
+ };
+\end{code}
+
+\subsection{FAST开发函数}
+
+\subsubsection{硬件资源与寄存器}
+\begin{enumerate}
+ \item int fast\_init\_hw(u64 addr,u64 len);
+ 硬件资源初始化。所有涉及到需要操作硬件寄存器、流表和动作等均需要先调用此函数，
+ 实例化硬件资源，使软件具体访问硬件的能力。
+
+ 参数：addr，在PCIe标准设备中表示硬件资源的内存映射地址，
+ 通常情况下，用户可以直接填写0。
+
+ 参数：len，在PCIe标准调和中表示硬件资源的内存地址空间大小，
+ 通常情况下，用户可以直接填写0。
+
+ 返回值：0表示硬件资源实例化正常，非零表示失败，
+ 如果失败将无法对硬件进行任何操作，程序将自动退出。
+ \item void fast\_distroy\_hw(void);
+ 硬件资源销毁。PCIe设备主要是撤销对硬件资源的映射，
+ OpenBox-S4主要是对设备发送关闭报文。
+ 一般情况下，用户程序退出时应该调用此函数，释放资源。
+ 但是我们内部并没有做特殊的资源处理，均为系统可自动回收功能，
+ 即使用户不调用此函数，当程序正常退出时，系统也能正常回收资源，
+ 不影响程序再次运行使用。
+ \item u64 fast\_reg\_rd(u64 regaddr);
+ 寄存器读函数。读取用户指定寄存器位置的值返回。
+ 该函数内部会根据平台的不同使用不同的方法去访问硬件寄存器。
+ PCIe的平台以正常寄存器方式访问，而NetMagic~08需要使用NMAC报文进行交互获取。
+ 这些不同的操作方式均已对用户屏蔽，用户无需关心该函数底层如何交互与实现，
+ 仅需调用此函数接口来操作寄存器读操作即可。
+
+ 参数：regaddr，表示用户将要读取的寄存器地址，
+ 该地址即FAST平台所定义的虚拟地址空间，该值均使用相对偏移值的方式使用，
+ 即FAST平台定义的值，对PCIe平台设备访问需要使用绝对地址访问才可以正常访问寄存器，
+ 相对地址转绝对地址已经封装在函数内部，
+ 用户对所有寄存器的操作均可只用相对值访问即可。
+
+ 返回值：返回该寄存器对应的值。该值的位宽是64位，
+ 在所有FAST平台寄存器的位宽均为64位。
+ \item void fast\_reg\_wr(u64 regaddr,u64 regvalue);
+ 寄存器写函数。将指定值写对硬件对应的寄存器位置。
+ 该函数内部会根据平台的不同使用不同的方法去操作硬件寄存器。
+ PCIe的平台以正常寄存器方式访问，而NetMagic~08需要使用NMAC报文进行交互获取。
+ 这些不同的操作方式均已对用户屏蔽，用户无需关心该函数底层如何交互与实现，
+ 仅需调用此函数接口来操作寄存器写操作即可。
+
+ 参数：regaddr，表示用户将要写入的寄存器地址，
+ 该地址即FAST平台所定义的虚拟地址空间，该值均使用相对偏移值的方式使用，
+ 即FAST平台定义的值，
+ 对PCIe平台设备访问需要使用绝对地址访问才可以正常访问寄存器，
+ 相对地址转绝对地址已经封装在函数内部，
+ 用户对所有寄存器的操作均可只用相对值访问即可。
+
+ 参数：regvalue，表示要写入上述参数寄存器位置的值。该值的位宽为64位。
+\end{enumerate}
+\subsubsection{流表操作}
+\begin{enumerate}
+ \item void init\_rule(u32 default\_action);
+ 初始化规则。初始化规则函数的主要功能是在软件分配软件规则空间，
+ 将硬件规则空间清零，设置硬件规则的默认动作。
+ 该函数只在进行流表操作的应用中进行调用，而且只能被调用一次。
+ 如果有多个应用需要操作规则，
+ 整个系统在关机或重启前所有的应用中也只能由一个应用来调用一次。
+ 主要是该函数会将硬件所有存在流表清空。用户需要自己非常清楚对流表的操作，
+ 在一次流表清空后才可以对流表进行其他操作。
+
+ 参数：default\_action，默认动作。当所有的流表均不能匹配时，
+ 硬件需要执行一个默认的动作来完成这个分组的处理，
+ 流表可以为空，但默认动作必须要有。详细的动作含义可以参考动作说明。
+
+ \item int fast\_add\_rule(struct fast\_rule *rule);
+ 添加一条规则。添加规则函数，先将用户的规则添加在软件流表中，
+ 经过各种比较判断后，看是否能正常添加，有无冲突或是否存在，
+ 如果可以正常添加，则先将规则存储在软件，
+ 然后将此条软件规则数据通过寄存器方式下发到硬件对应规则的存储位置。
+
+ 参数：rule，规则对象，内部具体字段参考流规则数据结构定义
+
+ 返回值：返回当前添加规则成功后此条规则所在的索引号
+ \item int fast\_modify\_rule(struct fast\_rule *rule,int idx);
+ 修改一条已经存在的规则。此函数主要是用来修改已经存在的规则，
+ 对其关键字、掩码、动作和优先级等进行修改。
+ 该函数的索引值参数如果指向一条空规则，其操作流程将类似于添加规则函数。
+
+ 参数：rule，新规则对象，内部具体字段参考流规则数据结构定义
+
+ 参数：idx，旧规则所在索引号
+
+ 返回值：返回输入参数的idx值说明操作成功，其他值说明操作失败
+ \item int fast\_del\_rule(int idx);
+ 删除一条已经存储的规则，或将一条规则置为无效。
+ 只需要提供规则所在的索引号，软件可通过索引号定位到对应硬件存储规则位置，
+ 将规则的有效位置为无效，实现一条规则的删除。
+ 删除硬件成功后，将其对应的软件规则进行清除。
+
+ 参数：idx，删除规则所在索引号
+
+ 返回值：返回输入参数的idx值说明操作成功，其他值说明操作失败
+ \item int read\_hw\_rule(struct fast\_rule *rule,int index);
+ 读取一条硬件规则。将存储在硬件规则内对应索引的数据读取出来，
+ 还原为一条软件规则数据，存储在用户提供的指针位置。
+
+ 参数：rule，将要存储规则的内存指针
+
+ 参数：idx，将要读取规则所在硬件的索引号
+
+ 返回值：返回输入参数的idx值说明操作成功，其他值说明操作失败
+ \item void print\_hw\_rule(void);
+ 打印硬件所有规则信息。此函数是上一个读取硬件规则条目信息的集合操作，
+ 将所有硬件流规则信息一一读出，并打印输出在屏幕上。
+\end{enumerate}
+\subsubsection{UA编程}
+\begin{enumerate}
+ \item int fast\_ua\_init(int mid,fast\_ua\_recv\_callback callback);
+ UA编程初始化函数。
+ \item void fast\_ua\_destroy(void);
+ UA编程注销函数。
+ \item int fast\_ua\_send(struct fast\_packet *pkt,int pkt\_len);
+ UA程序发送报文函数
+ \item void fast\_ua\_recv();
+ 启动UA接收用户特征流程序函数
+\end{enumerate}
+
+\subsection{FAST虚拟地址空间定义}
+
+\subsubsection{debug um}
+\begin{code}[c]
+ #define FAST_DEBUG_UM_DC FAST_HW_UM+0x0000
+ #define FAST_DEBUG_UM_GPP FAST_HW_UM+0x2000
+ #define FAST_DEBUG_UM_GKE FAST_HW_UM+0x4000
+ #define FAST_DEBUG_UM_GME FAST_HW_UM+0x6000
+ #define FAST_DEBUG_UM_GAC FAST_HW_UM+0x8400
+ #define FAST_DEBUG_UM_GOE FAST_HW_UM+0xA000
+
+ /*GPP模块*/
+ #define FAST_DEBUG_GPP_GPP_STATUS FAST_DEBUG_UM_GPP+0x00
+ #define FAST_DEBUG_GPP_IN_GPP_DATA_COUNT FAST_DEBUG_UM_GPP+0x08
+ #define FAST_DEBUG_GPP_OUT_GPP_MD_COUNT FAST_DEBUG_UM_GPP+0x10
+ #define FAST_DEBUG_GPP_OUT_GPP_PHY_COUNT FAST_DEBUG_UM_GPP+0x18
+ #define FAST_DEBUG_GPP_OUT_GPP_CACHE_COUNT FAST_DEBUG_UM_GPP+0x20
+
+ /*GKE模块*/
+ #define FAST_DEBUG_GKE_GKE_STATUS FAST_DEBUG_UM_GKE+0x00
+ #define FAST_DEBUG_GKE_IN_GKE_MD_COUNT FAST_DEBUG_UM_GKE+0x08
+ #define FAST_DEBUG_GKE_IN_GKE_PHY_COUNT FAST_DEBUG_UM_GKE+0x10
+ #define FAST_DEBUG_GKE_OUT_GKE_MD_COUNT FAST_DEBUG_UM_GKE+0x18
+ #define FAST_DEBUG_GKE_OUT_GKE_PHY_COUNT FAST_DEBUG_UM_GKE+0x20
+ #define FAST_DEBUG_GKE_OUT_GKE_KEY_COUNT FAST_DEBUG_UM_GKE+0x28
+
+ /*GME*/
+ #define FAST_DEBUG_GME_GME_STATUS FAST_DEBUG_UM_GME+0x00
+ #define FAST_DEBUG_GME_IN_GME_MD_COUNT FAST_DEBUG_UM_GME+0x08
+ #define FAST_DEBUG_GME_IN_GME_PHY_COUNT FAST_DEBUG_UM_GME+0x10
+ #define FAST_DEBUG_GME_IN_GME_KEY_COUNT FAST_DEBUG_UM_GME+0x18
+ #define FAST_DEBUG_GME_IN_GME_INDEX_COUNT FAST_DEBUG_UM_GME+0x20
+ #define FAST_DEBUG_GME_OUT_GME_MD_COUNT FAST_DEBUG_UM_GME+0x28
+ #define FAST_DEBUG_GME_OUT_GME_PHY_COUNT FAST_DEBUG_UM_GME+0x30
+ #define FAST_DEBUG_GME_OUT_GME_KEY_COUNT FAST_DEBUG_UM_GME+0x38
+
+ /*GAC*/
+ #define FAST_DEBUG_GAC_GAC_STATUS FAST_DEBUG_UM_GAC+0x00
+ #define FAST_DEBUG_GAC_IN_GAC_DATA_COUNT FAST_DEBUG_UM_GAC+0x08
+ #define FAST_DEBUG_GAC_IN_GAC_MD_COUNT FAST_DEBUG_UM_GAC+0x10
+ #define FAST_DEBUG_GAC_IN_GAC_PHY_COUNT FAST_DEBUG_UM_GAC+0x18
+ #define FAST_DEBUG_GAC_OUT_GAC_DATA_COUNT FAST_DEBUG_UM_GAC+0x20
+ #define FAST_DEBUG_GAC_OUT_GAC_PHY_COUNT FAST_DEBUG_UM_GAC+0x28
+
+ /*GOE*/
+ #define FAST_DEBUG_GOE_GOE_STATUS FAST_DEBUG_UM_GOE+0x00
+ #define FAST_DEBUG_GOE_IN_GOE_DATA_COUNT FAST_DEBUG_UM_GOE+0x08
+ #define FAST_DEBUG_GOE_IN_GOE_PHY_COUNT FAST_DEBUG_UM_GOE+0x10
+ #define FAST_DEBUG_GOE_OUT_GOE_DATA_COUNT FAST_DEBUG_UM_GOE+0x18
+
+
+ #define FAST_DEBUG_DC_DATA_CACHE_STATUS FAST_DEBUG_UM_DC+0x00
+ #define FAST_DEBUG_DC_IN_DATA_CACHE_COUNT FAST_DEBUG_UM_DC+0x08
+ #define FAST_DEBUG_DC_OUT_DATA_CACHE_COUNT FAST_DEBUG_UM_DC+0x10
+\end{code}
+\subsubsection{端口计数}
+\begin{code}[c]
+ #define FAST_COUNTS_RECV_BYTE_L 0x200 /**< 计数寄存器：成功接收字节数低位计数*/
+ #define FAST_COUNTS_RECV_BYTE_H 0x204 /**< 计数寄存器：成功接收字节数高位计数*/
+ #define FAST_COUNTS_SEND_BYTE_L 0x208 /**< 计数寄存器：成功发送字节数低位计数*/
+ #define FAST_COUNTS_SEND_BYTE_H 0x20C /**< 计数寄存器：成功发送字节数高位计数*/
+
+ #define FAST_COUNTS_RECV_PKT_L 0x290 /**< 计数寄存器：接收成功的计数*/
+ #define FAST_COUNTS_RECV_PKT_H 0x294 /**< 计数寄存器：接收成功的计数*/
+ #define FAST_COUNTS_SEND_PKT_L 0x2D8 /**< 计数寄存器：发送成功的计数*/
+ #define FAST_COUNTS_SEND_PKT_H 0x2DC /**< 计数寄存器：发送成功的计数*/
+\end{code}
+\subsubsection{硬件流表}
+\begin{code}[c]
+ #define FAST_OFP_FLOW_STATS_PKTS 0x8B000 /*流表报文计数*/
+ #define FAST_OFP_FLOW_STATS_BYTES 0x8B800 /*流表字节计数*/
+\end{code}
+\subsubsection{硬件动作}
+\begin{code}[c]
+ #define BASE_ADDR 0x43C00000 /**< 硬件资源起始地址*/
+ #define REG_LEN 0x01000000 /**< 硬件资源可用空间*/
+ #define FAST_ACTION_REG_ADDR 0x88000 /**< 写动作寄存器*/
+ #define FAST_DEFAULT_RULE_ADDR 0x1F8 /**< 默认动作(匹配不到规则时执行默认动作)地址*/
+\end{code}
+
+\subsection{FAST开发流程}
+基于FAST的软件代码开发有三种方式：
+第一种是基于FAS的源代码进行修改，整个代码结构不变，
+可以直接使用原工程中的所有Makefile文件，
+修改完成后，直接make即可得到用户所需要的可执行文件；
+第二种是用户根据自己需要，选择需要的开发库与头文件，
+自己重新组织新的代码目录与结构进行开发，
+原工程中的Makefile文件均不可再用，需要自己重写Makefile文件。
+
+\subsubsection{修改源码开发}
+
+\begin{enumerate}
+ \item 已FAST的rule\_rw工具作为修改示例，
+ 修改fast/tools/rule\_rw/目录下main\_rule.c文件
+ \item 修改main\_rule\_test函数，
+ 将两个端口互转硬件规则改为根据以太网类型来转发
+ \begin{code}[c]
+ void main_rule_test(int argc,char *argv[])
+ {
+ int i = 0,p1 = 1,p2 = 2,idx1 = 0,idx2 = 1;
+ struct fast_rule rule[2] = {{0},{0}};//初始化两条全空的规则
+
+ if(argc == 3)
+ {
+ p1 = atoi(argv[1]);
+ p2 = atoi(argv[2]);
+ }
+ else if(argc == 4)
+ {
+ p1 = atoi(argv[1]);
+ p2 = atoi(argv[2]);
+ idx1 = atoi(argv[3]);
+ }
+ else if(argc == 5)
+ {
+ p1 = atoi(argv[1]);
+ p2 = atoi(argv[2]);
+ idx1 = atoi(argv[3]);
+ idx2 = atoi(argv[4]);
+ }
+
+ //给规则的各字段赋值
+ rule[i].key.type = htole16(0x0800); //以太网类型
+ rule[i].key.port = p1;
+ rule[i].priority =0xA;
+ rule[i].action = ACTION_PORT<<28|p2;//动作字段的涵义请参考fast_type.h
+ rule[i].md5[0] = i+1;
+
+ //给规则对应字段设置掩码，掩码为1表示使用，为0表示忽略
+ rule[i].mask.type = 0xFFFF;
+ rule[i].mask.port = 0x3F;/*6bit*/
+
+ //fast_add_rule(&rule[i]);
+ //fast_modify_rule(&rule[i],0);
+
+ i++;
+
+ rule[i].key.type = htole16(0x0800);
+ rule[i].key.port = p2;
+ rule[i].priority =0xB;
+ rule[i].action = ACTION_PORT<<28|p1;//动作字段的涵义请参考fast_type.h
+ rule[i].md5[0] = i+1;
+
+ //给规则对应字段设置掩码，掩码为1表示使用，为0表示忽略
+ rule[i].mask.type = 0xFFFF;
+ rule[i].mask.port = 0x3F;
+
+ //fast_add_rule(&rule[i]);
+ //fast_modify_rule(&rule[i],1);
+
+
+ if(argc == 3 || argc == 1)
+ {
+ fast_modify_rule(&rule[i-1],idx1);
+ fast_modify_rule(&rule[i],idx2);
+ printf("Row[%d],Port[%d]----->Port[%d]\n",idx1,p1,p2);
+ printf("Row[%d],Port[%d]----->Port[%d]\n",idx2,p2,p1);
+ }
+ else if(argc == 4)
+ {
+ p1 = atoi(argv[1]);
+ p2 = atoi(argv[2]);
+ idx1 = atoi(argv[3]);
+ fast_modify_rule(&rule[i-1],idx1);
+ printf("Row[%d],Port[%d]----->Port[%d]\n",idx1,p1,p2);
+ }
+ else if(argc == 5)
+ {
+ p1 = atoi(argv[1]);
+ p2 = atoi(argv[2]);
+ idx1 = atoi(argv[3]);
+ idx2 = atoi(argv[4]);
+ fast_modify_rule(&rule[i-1],idx1);
+ fast_modify_rule(&rule[i],idx2);
+ printf("Row[%d],Port[%d]----->Port[%d]\n",idx1,p1,p2);
+ printf("Row[%d],Port[%d]----->Port[%d]\n",idx2,p2,p1);
+ }
+ }
+ \end{code}
+
+ 修改保存退出，打开命令终端，跳到fast目录下，执行交叉编译
+
+ \begin{code}[console]
+ # cd fast-0.4.5
+ # make
+ \end{code}
+
+ 编译完成后将把tools/rule\_hw目录下rule\_hw工具放到OpenBox-S4设备，
+ 执行修改过的rule\_hw工具
+ \begin{code}[console]
+ # ./rule_hw 0 1
+ \end{code}
+
+\end{enumerate}
+
+\subsubsection{新增代码开发}
+
+用户基于FAST架构代码增加自己的软件代码，
+建议按照完整项目工程管理的方法进行，
+使用Anjuta开发软件进行修改和配置，
+具体请参考《OpenBox-S4开发环境搭建手册》第三章anjuta 部署fast源代码。
+
+\subsubsection{交叉编译代码}
+OpenBox-S4平台为ARM嵌入式平台，
+所运行软件需要通过交叉编译后才可放入平台运行。
+软件代码的交叉编译请参考《OpenBox-S4开发环境搭建手册》第二章的2.4节测试交叉编译。
\ No newline at end of file
diff --git a/data/appendix/openbox.tex b/data/appendix/openbox.tex
new file mode 100644
index 0000000..af18bc2
--- /dev/null
+++ b/data/appendix/openbox.tex
@@ -0,0 +1,458 @@
+%# -*- coding: utf-8-unix -*-
+
+\chapter{可编程网络平台－操作手册}
+\label{app:openbox}
+
+\subsection{FAST简介}
+
+针对近年来关于工业控制网络创新技术、创新网络结构、
+时间敏感网络、SDN网络、FPGA硬件加速技术及下一代网络技术的研究需求，
+由国防科大与湖南新实共同发起的开源项目
+——FAST（FPGA Accelerated Switcing plaTform）于2016年创建。
+
+FAST平台的架构是一种通用多核CPU加FPGA形态的网络处理架构，
+该平台架构主要由硬件逻辑和软件逻辑两部分组成，
+实现软硬件耦合通信与支持软硬件可编程的网络创新实验系统。
+其中硬件包括平台相关的数据IO和FAST硬件逻辑。
+软件部分包括通用操作系统与FAST软件逻辑。
+FAST软件逻辑包括FAST软件开发环境和FAST UA程序。
+在FAST平台，不仅支持FAST的UA编程开发，同时也支持通用APP的运行。
+
+\subsection{设备简介}
+
+OpenBox-S4是一款软硬件全可编程网络实验平台，
+基于多核CPU加FPGA异构模型的FAST处理架构实现，
+软件在CPU上使用C语言编程，硬件在FPGA芯片上使用Verilog语言编程。
+全系统根据FAST架构搭建其软硬件基础运行环境，
+内部软硬件用户逻辑支持所有FAST架构开发的应用、
+标准的网络协议栈与通用网络应用。
+平台软硬件逻辑代码开源免费，支持用户二次开发。
+
+\subsection{设备上电检测}
+当我们拿到设备后，并不知道这个设备有没有故障。
+所以在使用设备进行实验前，我们尽量简单并全面的对设备进行一次上电检测，
+以确认设备是否没有故障。
+
+\subsubsection{设备外部接口及其配件说明}
+\begin{enumerate}
+ \item 设备外部接口，如下图所示。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f01}
+ \caption{正面外部接口}
+ \label{fig:a:ob_f01}
+ \end{figure}
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f02}
+ \caption{反面外部接口}
+ \label{fig:a:ob_f02}
+ \end{figure}
+
+ \item 12V-1A电源线，如下图所示。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f03}
+ \caption{设备电源线}
+ \label{fig:a:ob_f03}
+ \end{figure}
+
+ \item 串口线，如下图所示。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f04}
+ \caption{设备串口线}
+ \label{fig:a:ob_f04}
+ \end{figure}
+
+ \item 设备烧录线，如下图所示。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f05}
+ \caption{设备烧录线}
+ \label{fig:a:ob_f05}
+ \end{figure}
+
+\end{enumerate}
+
+\subsubsection{检测准备}
+\begin{enumerate}
+ \item 物品准备
+ \begin{table}[!htp]
+ \small
+ \centering
+ \caption{以太网帧格式}
+ \label{tab:c:wireshark_eth-format}
+ \begin{tabular}{|c|c|} \hline
+ \heiti 测试项 & \heiti 所需物品 \\ \hline
+ 上电检测 & 一台设备及电源\\ \hline
+ 串口检测 & 一台设备及电源、一台电脑、一个micro usb 串口线\\ \hline
+ 管理网口（MGMT） & 一台设备及电源、一台电脑、一个网线\\ \hline
+ \end{tabular}
+ \end{table}
+\end{enumerate}
+
+\subsubsection{上电检测}
+\begin{enumerate}
+ \item 连接电源，将电源开关拨到ON（向右）。
+ \item 观察电源指示灯变化情况：
+ \item 电源开关拨到ON（向右）后，CFG电源指示灯会亮一下；
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f06}
+ \caption{电源指示灯（刚接入电源）}
+ \label{fig:a:ob_f06}
+ \end{figure}
+ \item CFG电源指示灯过几秒后就灭了；
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f07}
+ \caption{电源指示灯（系统配置）}
+ \label{fig:a:ob_f07}
+ \end{figure}
+ 图 7 电源指示灯（系统配置）
+ \item 等待15秒左右，RUN电源指示灯常亮。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f08}
+ \caption{电源指示灯（系统运行）}
+ \label{fig:a:ob_f08}
+ \end{figure}
+\end{enumerate}
+\subsubsection{串口检测}
+\begin{enumerate}
+ \item 确保micro usb串口线正确连接到设备上，并且设备已上电。
+ \item 确保调试电脑已按照《01\_常用软件的安装使用手册.pdf》
+ 文档进行了PUTTY串口终端工具的安装。
+ \item 确保调试电脑已按照《01\_常用软件的安装使用手册.pdf》
+ 文档进行了CP2102驱动的安装。
+ \item 在电脑的设备管理器，查看设备的COM口数值。
+ （如下图，设备成的COM口数值为COM4，不同的电脑显示的COM口数值会不同）
+ \item 打开PUTTY工具界面。
+ \begin{enumerate}
+ \item 先点击左边“category”栏的 “serial”选项；
+ \item 在“Serial line to connect to ”栏，填写设备管理器中看到的COM数值；
+ \item 在“Speed”栏，填写串口的波特率为“115200”；
+ \item 在 “Data bits”栏。填写数据位宽为“8”；
+ \item 在“Flow control”栏，选择“None”。
+ \item 如下所示，调试电脑的COM数值为COM3，所以“serial line”栏填写为“COM3”。
+ （不同电脑的COM数值可能不同，请填写实际的COM数值）
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f09}
+ \caption{putty软件串口配置参数}
+ \label{fig:a:ob_f09}
+ \end{figure}
+ \end{enumerate}
+\item 点击 “open” ，进入设备系统，则串口测试OK。
+\end{enumerate}
+\subsubsection{管理网口检测}
+\begin{enumerate}
+ \item 使用一根网线，将调试电脑与设备的obx0口连接。
+ \item
+ \item 设备的eth0网口的默认ip地址为：192.168.50.5，
+ 所以需要将调试电脑的ip地址设置成与设备eth0网口的ip地址在同一个网段下
+ （也就是192.168.50网段）。
+ \item 在调试电脑的 控制面板->网络和Internet->网络设备中。
+ 点击以太网->属性->internet协议版本4（TCP/IPV4），进行ip地址的配置。如下所示。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f10}
+ \caption{配置以太网的ip地址}
+ \label{fig:a:ob_f10}
+ \end{figure}
+ 图 10 配置以太网的ip地址
+ \item 在调试电脑的 控制面板>系统和安全>Windows Defender 防火墙>自定义设置中。
+ 关闭调试电脑的防火墙功能。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f11}
+ \caption{关闭防火墙功能}
+ \label{fig:a:ob_f11}
+ \end{figure}
+ \item 在调试电脑的CMD终端下，使用ping命令能正常与eth0网口通讯，
+ 则说明管理网络检测OK。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f12}
+ \caption{ping 命令测试网络连通性}
+ \label{fig:a:ob_f12}
+ \end{figure}
+
+\end{enumerate}
+\subsection{搭建环境}
+OpenBox-S4是一款软硬件全可编程网络实验平台，
+根据FAST架构搭建其软硬件基础运行环境，
+内部软硬件用户逻辑支持所有FAST架构开发的应用，
+是一款专业的网络实验与研究验证平台。
+\subsubsection{连接二层交换拓扑}
+
+\begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f13}
+ \caption{二层交换连接拓扑示意图}
+ \label{fig:a:ob_f13}
+\end{figure}
+
+其中PC1的IP地址设置为“192.168.1.20”，PC2的IP地址设置为“192.168.1.21”
+\subsubsection{在OpenBox-S4上运行二层交换程序}
+
+\begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f14}
+ \caption{二层交换命令启动输出图}
+ \label{fig:a:ob_f14}
+\end{figure}
+
+在串口登录界面或网络登录界面输入命令：l2switch
+
+\begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f15}
+ \caption{二层交换命令运行输出图}
+ \label{fig:a:ob_f15}
+\end{figure}
+
+\subsubsection{在PC两端进行PING测试}
+
+\begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f16}
+ \caption{端主机PING通结果图}
+ \label{fig:a:ob_f16}
+\end{figure}
+
+\subsection{常用软件安装与使用}
+\subsubsection{Wireshark抓包工具的安装使用}
+\begin{enumerate}
+ \item 安装教程
+ \begin{enumerate}
+ \item 进入“\\06\_软件包及工具\\抓包工具”目录。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f17}
+ \caption{Wireshark安装包路径}
+ \label{fig:a:ob_f17}
+ \end{figure}
+ \item 鼠标双击Wireshark-win64-3.2.5.exe文件，
+ 进入到下图中的安装界面。直接点击“agree”进行下一步。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f18}
+ \caption{Wireshark许可协议}
+ \label{fig:a:ob_f18}
+ \end{figure}
+ \item 选择软件的安装路径。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f19}
+ \caption{更改Wireshark安装路径}
+ \label{fig:a:ob_f19}
+ \end{figure}
+ \item 点击 “install”进行安装。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f20}
+ \caption{Wireshark 开始安装}
+ \label{fig:a:ob_f20}
+ \end{figure}
+ \item 弹出Npacp组件安装窗口，点击 “install”进行安装。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f21}
+ \caption{Wireshark 安装Npacp组件}
+ \label{fig:a:ob_f21}
+ \end{figure}
+ \end{enumerate}
+ \item 使用教程
+ \begin{enumerate}
+ \item 捕获网络接口
+ \begin{enumerate}
+ \item 打开安装好的wireshark，会进入如下所示界面。
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f22}
+ \caption{Wireshark启动界面说明}
+ \label{fig:a:ob_f22}
+ \end{figure}
+
+ \item 这里以有线网口为例，则点击选择 “以太网”，
+ 就可以捕获有线网口的所有数据报文。如下所示。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f23}
+ \caption{以太网接口捕获数据报文情况}
+ \label{fig:a:ob_f23}
+ \end{figure}
+ \end{enumerate}
+ \item wireshark 窗口介绍
+ wireshark主要分为这几个窗口，如下所示。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f24}
+ \caption{Wireshark窗口说明}
+ \label{fig:a:ob_f24}
+ \end{figure}
+ \begin{enumerate}
+ \item Display Filter(显示过滤器)：用于设置过滤条件进行数据包列表过滤。
+ \item Packet List Pane(封包列表)：简要地显示捕获到的数据包，
+ 每个数据包包含编号，时间戳，源地址，目标地址，协议，长度，以及数据包信息。
+ 不同协议的数据包使用了不同的颜色区分显示。。
+ \item Packet Details Pane(封包详细信息)：在数据包列表中选择指定数据包，
+ 在数据包详细信息中会显示数据包的所有详细信息内容。
+ 数据包详细信息面板是最重要的，用来查看协议中的每一个字段。
+ \item Packet Bytes Pane(16进制数据)：以十六进制和ASCII码的形式显示数据包的内容。
+ 这里显 示了一个数据包未经处理的原始样子，也就是在链路上传播时的数据形式。
+ \item Miscellanous(状态栏)：包含有专家信息、注释、包的数量和Profile。
+ \end{enumerate}
+ \item 过滤报文
+ \begin{enumerate}
+ \item 在显示过滤器栏中，输入指定地过滤条件即可过滤报文。
+ \item 如过滤ip地址为“192.168.1.1”的报文，
+ 则输入过滤条件“ip.addr == 192.168.1.1”。如下所示。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f25}
+ \caption{过滤指定ip地址报文}
+ \label{fig:a:ob_f24}
+ \end{figure}
+ \item 如过滤mac地址为“01:00:5e:7f:ff:fa”的报文，
+ 则输入过滤条件 “eth.addr == 01:00:5e:7f:ff:fa”如下所示。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f26}
+ \caption{过滤指定mac地址报文}
+ \label{fig:a:ob_f24}
+ \end{figure}
+ \item 由于篇幅的原因，wireshark的其他使用，在本文档就不再说明了。
+ \end{enumerate}
+ \end{enumerate}
+\end{enumerate}
+\subsubsection{CP2102串口驱动的安装使用}
+\begin{enumerate}
+ \item 在“06\_软件包及工具/CP2102串口驱动”目录下，
+ 根据电脑的操作系统选择对应的软件包。
+ \item 如以windows~10操作系统的电脑为例，
+ 则选择 “06\_软件包及工具/CP2102串口驱动/win10版/CP210x\_Windows10\_Driver.zip”。
+ 如下所示。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f27}
+ \caption{CP2102串口驱动压缩包}
+ \label{fig:a:ob_f27}
+ \end{figure}
+ \item 解压软件包，若根据系统为64位，则双击“CP210xVCPInstaller\_x64.exe”运行安装。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f28}
+ \caption{解压CP2102串口驱动压缩包}
+ \label{fig:a:ob_f28}
+ \end{figure}
+ \item 如下所示，完成安装。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f29}
+ \caption{CP2102串口驱动完成安装}
+ \label{fig:a:ob_f29}
+ \end{figure}
+\end{enumerate}
+\subsection{系统更新}
+\subsubsection{系统组成}
+OpenBox-S4的系统架构为通用多核CPU加FPGA，
+使用的是Xilinx公司的ZYNQ系列芯片提供的整体封装解决方案。
+在ZYNQ芯片中包含CPU系统与FPGA系统两部分，其内部通过高速总线连接。
+在OpenBox-S4的设备中，其管理接口（MGMT）由CPU引出，其他4个标准网口则由FPGA引出。
+
+整个系统的逻辑运行是从SD卡中的几个文件开始，
+主要包括：BOOT.bin、devicetree.dtb、uImage和uramdisk.image.gz四个部分。
+其中BOOT.bin定义的整个芯片的物理系统构成、连接关系和FPGA的功能逻辑；
+devicetree.dtb文件则定义了系统的硬件资源定义，在CPU运行系统内核镜像时，
+提供外设硬件及资源定义参数；uImage是CPU运行的系统内核镜像文件，
+提供linux的内核运行环境及外设驱动；uramdisk.image.gz是linux系统的根文件系统，
+包含内核引导起来后所使用的存储根文件系统、
+系统配置信息、系统命令工具和用户命令等。
+
+在所有的OpenBox-S4设备的系统中，BOOT.bin与devicetree.dtb是匹配成套生成的，
+uImage和uramdisk.image.gz是所有系统通用匹配使用的。
+用户如果要修改芯片系统架构、连接以及硬件逻辑，
+则需要重新生成BOOT.bin和devicetree.dtb文件，替换原来系统的这两件文件，
+即可重新定义设备的硬件逻辑功能。如果需要重新定义系统内核功能，
+则需要重新编译生成uImage文件进行替换。如果是用户软件逻辑或工具命令，
+则可随时通过网络、U盘等上传至系统/mnt/openbox/目录即可使用。
+
+\subsubsection{系统更新}
+如上节所述，更新系统最多是替换该设备环境中的4个核心文件，
+通常用户只修改硬件逻辑就不需要替换uImage和uramdisk.image.gz文件，
+如果不调修改原有接口的地址资源配置地址，也无需devicetree.dtb文件，
+仅需要更新替换Boot.bin文件即可。此文档主要描述一下，
+如何更新整个系统运行环境，即替换系统的4个核心文件。
+
+\begin{enumerate}
+ \item 备份系统原有系统核心文件
+ 通过设备的管理接口连接到用户操作主机，
+ 通过SCP远程复制的方法将OpenBox-S4的系统备份到用户主机本地保存。
+ Windows主机请使用putty配套的pscp命令工具，用法相同。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f30}
+ \caption{下载备份原有系统}
+ \label{fig:a:ob_f30}
+ \end{figure}
+ \item 上传用户新的系统核心文件
+
+ 将用户修改系统硬件逻辑后生成的BOOT.bin和devicetree.dtb
+ 文件保存在本地update目录中，
+ 将备份目录中的uImage和uramdisk.image.gz文件复制到update目录，
+ 确保update更新目录中包含OpenBox-S4系统运行环境的4个核心文件，
+ 其中BOOT.bin和devicetree.dtb是用户最新生成的。执行如下命令，
+ 将更新目录的4个核心文件上传替换原来OpenBox-S4上面的核心文件。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f31}
+ \caption{上传更新用户系统}
+ \label{fig:a:ob_f31}
+ \end{figure}
+ \item 断电后重启设备验证系统
+
+ 确认更新文件已经上传后，即可关机、断电和重新加电进行测试。
+
+ 重新加电进入系统后，使用系统自带工具读取硬件系统版本号。
+ 如果其版本号读出与你的硬件逻辑定义一致，则说明系统更新成功。
+ 如果不同说明系统更新没有替换原来的文件，请检查上传操作是否与上述截图一致，
+ 是否有报错信息。系统自带标准五级流水线版本号为0x2020181108，
+ 如下图所示，即说明系统更新成功
+ （当前运行系统的硬件版本号为用户更新版本号：0x2020191231）。
+
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=11cm]{f32}
+ \caption{读硬件版本号验证}
+ \label{fig:a:ob_f32}
+ \end{figure}
+\end{enumerate}
diff --git a/data/chapter3/preface.tex b/data/ch_ensp/preface.tex
similarity index 78%
rename from data/chapter3/preface.tex
rename to data/ch_ensp/preface.tex
index dd6ae7d..1ae90af 100644
--- a/data/chapter3/preface.tex
+++ b/data/ch_ensp/preface.tex
@@ -6,6 +6,6 @@
掌握静态路由、动态路由RIP和OSPF协议的配置，并理解分析静态与动态路由的区别，
两种动态路由协议各自的适用环境，理解网络收敛的概念。
推荐使用华为ENSP模拟器，
-在附录\ref{app:ENSP}中有该软件的安装、操作和使用，
+在附录\ref{app:ENSP}：《华为网络仿真平台 ENSP 简介》中有该软件的安装、操作和使用，
以熟悉华为模拟设备的基本配置及其配置命令，
掌握软件安装常见问题的解决方法。
diff --git a/data/ch_ensp/sec_ospf.tex b/data/ch_ensp/sec_ospf.tex
new file mode 100644
index 0000000..ba15c27
--- /dev/null
+++ b/data/ch_ensp/sec_ospf.tex
@@ -0,0 +1,258 @@
+%# -*- coding: utf-8-unix -*-
+
+\section{动态路由（OSPF）}
+\label{sec:c:ensp:s:ospf}
+
+\subsection{实验目的}
+\label{subsec:c:ensp:s:ospf_object}
+
+理解动态路由协议OSPF的工作原理；
+掌握采用动态路由协议OSPF进行网络设计的基本原则和方法。
+
+\subsection{实验内容}
+\label{subsec:c:ensp:s:ospf_content}
+
+\begin{itemize}
+ \item 华为路由器IP地址的配置；
+ \item 动态路由协议ospf的配置；
+ \item 路由规划；
+ \item 网络测试与排错操作；
+ \item rip与ospf路由协议的区别。
+\end{itemize}
+
+\subsection{实验原理、方法和手段}
+\label{subsec:c:ensp:s:ospf_principle}
+
+简要说明OSPF工作原理和适用范围；
+可设计至少包括3个由OSPF协议互连起来的网络；
+观察并记录各设备状态变化情况，特别留意路由信息的交换和路由表。
+分析说明相对于RIP协议，OSPF做了哪些改进。
+解释说明与路由协议、路由表的相关性。
+
+可参考图\ref{fig:c:ensp_OSPF-topo}连线，具体联线情况请自行标注。
+
+\begin{figure}[!htp]
+ \centering
+ \includegraphics[width=8cm]{OSPF-topo}
+ \caption{选中特定的捕获类型}
+ \label{fig:c:ensp_OSPF-topo}
+\end{figure}
+
+\subsection{实验条件}
+\label{subsec:c:ensp:s:ospf_requirement}
+
+\begin{itemize}
+ \item 华为ENSP仿真平台中：2台PC，3台路由器；
+ \item 双绞线若干。
+\end{itemize}
+
+\subsection{实验步骤}
+\label{subsec:c:ensp:s:ospf_procedure}
+
+实验说明：路由器端口以具体选用的设备为准，如果是实际设备，
+请观察路由器前面板和后面板的端口名称
+，并使用disp int或者disp cur命令查看端口的实际名称。
+在对路由器进行配置时，可使用disp cur命令来检查当前路由器上生效的配置命令。
+
+(如保存了实验3.2-rip，则在原rip实验基础上选下文第7步，
+即跳过前6步已配置完成的命令，直接配置第7步；
+如是全新实验，则从第一步开始，顺序配置，第7步跳过。)
+
+\begin{enumerate}
+ \item 硬件连接，完成PC1、PC2到路由器的网络连接；
+ PC1到路由器RT1控制线的连接，PC2到路由器RT2控制线的连接。
+ 拓扑图检查无误后方可进行后面的实验步骤,
+ 实验报告中的拓扑图必须标清路由器实际连接的端口。
+ \item 为PC1、PC2分别设置IP地址、掩码和网关。
+ \item 使用sysname命令为三个路由器命名。
+ 路由器R1的名称为学生自己的姓名拼音+R1，
+ 路由器R2的名称为学生自己的姓名拼音+R2，
+ 路由器R3的名称为学生自己的姓名拼音+R3，
+ 要求记录输入的命令和输出（截屏）。
+
+ R1上的命令:
+ \begin{code}[text]
+ system-view
+ [Huawei]sysname zhangsanR1
+ \end{code}
+
+ 输出结果如图\ref{fig:c:ensp_sysname-R1_3}所示。
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=10cm]{sysname-R1_3}
+ \caption{R1配置图}
+ \label{fig:c:ensp_sysname-R1_3}
+ \end{figure}
+
+ R2上的命令:
+ \begin{code}[text]
+ system-view
+ [Huawei]sysname zhangsanR2
+ \end{code}
+
+ 输出结果如图\ref{fig:c:ensp_sysname-R2_3}所示。
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=10cm]{sysname-R2_3}
+ \caption{R2配置图}
+ \label{fig:c:ensp_sysname-R2_3}
+ \end{figure}
+
+ R3上的命令:
+ \begin{code}[text]
+ system-view
+ [Huawei]sysname zhangsanR3
+ \end{code}
+
+ \item （从左至右配置）为路由器R1的两个接口配置IP地址。
+ 配置完成后PC1应该可以Ping通RT1的E0口的地址。
+ 要求记录输入的命令和输出（截屏）。
+ (本模拟器R1实际使用的接口名由实际使用的路由器型号确定，可能有Ethernet0/0/0；
+ 或GigabitEthernet0/0/x；或FastEthernet0/0/x)
+ R1上的命令:
+ \begin{code}[text]
+ [zhangsanR1]interface GigabitEthernet 0/0/0
+ [zhangsanR1- GigabitEthernet0/0/0]ip address 192.168.1.1 255.255.255.0
+ [zhangsanR1- GigabitEthernet0/0/0]
+ \end{code}
+
+ PC1可以Ping通R1的192.168.1.1地址
+ \begin{code}[text]
+ PC1>ping 192.168.1.1
+ \end{code}
+
+ 图3.3-4 Ping通效果图
+
+ 为路由器R1的 GE1接口配置IP地址。
+ \begin{code}[text]
+ [zhangsanR1]interface GigabitEthernet 0/0/1
+ [zhangsanR1-GigabitEthernet0/0/1]ip address 192.168.2.1 255.255.255.0
+ [zhangsanR1-GigabitEthernet0/0/1]quit
+ \end{code}
+ \item 为路由器R2的GE0、GE1接口配置IP地址。
+ 配置完成后路由器R1和R2应该可以互相Ping通。要求记录输入的命令和输出（截屏）
+ \begin{code}[text]
+ [zhangsanR2]interface GigabitEthernet 0/0/0
+ [zhangsanR2-GigabitEthernet0/0/0]ip address 192.168.2.2 255.255.255.0
+ [zhangsanR2-GigabitEthernet0/0/0]quit
+ \end{code}
+
+ \begin{code}[text]
+ [zhangsanR2]interface GigabitEthernet 0/0/1
+ [zhangsanR2-GigabitEthernet0/0/1]ip address 192.168.3.1 255.255.255.0
+ [zhangsanR2-GigabitEthernet0/0/1]quit
+ \end{code}
+ \item 为路由器R3的GE0、GE1接口配置IP地址。
+ 配置完成后，直连路由应可相互Ping通，如PC2应可Ping通R3的GE1口的地址。
+ \begin{code}[text]
+ [zhangsanR3]interface GigabitEthernet 0/0/0
+ [zhangsanR3-GigabitEthernet0/0/0]ip address 192.168.3.2 255.255.255.0
+ [zhangsanR3-GigabitEthernet0/0/0]quit
+ \end{code}
+
+ \begin{code}[text]
+ [zhangsanR3]interface GigabitEthernet 0/0/1
+ [zhangsanR3-GigabitEthernet0/0/1]ip address 192.168.4.1 255.255.255.0
+ [zhangsanR3-GigabitEthernet0/0/1]quit
+ \end{code}
+ PC2可以Ping通R2的192.168.4.1地址
+ \begin{code}[text]
+ PC1>ping 192.168.4.1
+ \end{code}
+
+ (此前同实验3.2-rip的1-6步骤，如在原rip基础上配置则配置下文第7步；
+ 如是全新实验，则跳过第7步，直接配置第8步)
+
+ \item （视情况选择）为3个路由器配置动态路由协议ospf，首先删除原来的rip配置。
+ 要求记录输入的命令和输出（截屏或文本复制）。
+ 配置后可以用display current configuration检查配置，
+ 或者display ip routing-table检查路由表。要求记录输入的命令和输出（截屏）。
+ \begin{code}[text]
+ [zhangsanR1]undo rip
+ \end{code}
+ 确认删除？Y
+
+ 此时用disp cur检查配置，rip相关配置全部删除；
+
+ disp ip routing-table检查路由表，rip那条路由也将被删除
+
+ \begin{code}[text]
+ [zhangsanR2]undo rip
+ \end{code}
+ 确认删除？Y
+
+ \begin{code}[text]
+ [zhangsanR3]undo rip
+ \end{code}
+ 确认删除？Y
+
+ \item 为3个路由器分别配置动态路由协议ospf。
+ 配置后可以用disp cur检查配置，或者disp ip routing-table检查路由表。
+ 配置完成后，网络收敛，则网络任意两点间，应该可以互相Ping通。
+ 要求记录输入的命令和输出（截屏）。
+ \begin{code}[text]
+ [zhangsanR1]ospf
+ [zhangsanR1-ospf-1]area 0
+ [zhangsanR1-ospf-1-area-0.0.0.0]network 192.168.1.0 0.0.0.255
+ [zhangsanR1-ospf-1-area-0.0.0.0]network 192.168.2.0 0.0.0.255
+ [ctrl+z]
+ [zhangsanR1]ping 192.168.4.2
+ \end{code}
+
+ \begin{code}[text]
+ [zhangsanR2]ospf
+ [zhangsanR2-ospf-1]area 0
+ [zhangsanR2-ospf-1-area-0.0.0.0]network 192.168.2.0 0.0.0.255
+ [zhangsanR2-ospf-1-area-0.0.0.0]network 192.168.3.0 0.0.0.255
+ [zhangsanR2-ospf-1-area-0.0.0.0]display ip routing-table
+ [ctrl+z]
+ [zhangsanR2]ping 192.168.1.2
+ \end{code}
+
+ \begin{code}[text]
+ [zhangsanR3]ospf
+ [zhangsanR3-ospf-1]area 0
+ [zhangsanR3-ospf-1-area-0.0.0.0]network 192.168.3.0 0.0.0.255
+ [zhangsanR3-ospf-1-area-0.0.0.0]network 192.168.4.0 0.0.0.255
+ [zhangsanR3-ospf-1-area-0.0.0.0]display ip routing-table
+ [ctrl+z]
+ [zhangsanR3]ping 192.168.1.2
+ \end{code}
+ 如未ping通，则可能网络未收敛，当网络收敛时，网络任意两点间，
+ 应该可以互相ping通。请复核。
+
+ \begin{code}[text]
+ [zhangsanR1]display ip routing-table
+ \end{code}
+ （R1路由表截屏）
+ \begin{code}[text]
+ [zhangsanR2]display ip routing-table
+ \end{code}
+ （R2路由表截屏）
+ \begin{code}[text]
+ [zhangsanR3]display ip routing-table
+ \end{code}
+ （R3路由表截屏）
+\end{enumerate}
+
+\subsection{思考题}
+\label{subsec:c:ensp:s:ospf_rethink}
+
+Rip和OSPF协议的区别是什么？请对比路由表，收敛速度等。
+
+\subsection{注意事项及有关说明}
+\label{subsec:c:ensp:s:ospf_notice}
+
+\begin{enumerate}
+ \item 路由器端口以具体选用的设备为准，
+ 请将E0口和E1口对应到实际设备上的端口名称，
+ 接口名由实际使用的路由器型号确定，可能有Ethernet0/0/0；
+ 或GigabitEthernet0/0/x；或FastEthernet0/0/x。
+ 如果是实际设备，请观察路由器前面板和后面板的端口名称，
+ 并使用disp int或者disp cur命令查看端口的实际名称。
+ 在对路由器进行配置时，可使用disp cur命令来检查当前路由器上生效的配置命令。
+ \item 此实验的第1-6步骤同前一实验3.2-rip，
+ 如保存了实验3.2-rip，则在原rip实验基础上选下文第7步，
+ 即跳过前6步已配置完成的命令，直接配置第7步；
+ 如是全新实验，则从第一步开始，顺序配置，第7步跳过。
+ \end{enumerate}
\ No newline at end of file
diff --git a/data/chapter3/section2.tex b/data/ch_ensp/sec_rip.tex
similarity index 52%
rename from data/chapter3/section2.tex
rename to data/ch_ensp/sec_rip.tex
index 85d1b16..22b699c 100644
--- a/data/chapter3/section2.tex
+++ b/data/ch_ensp/sec_rip.tex
@@ -1,16 +1,16 @@
%# -*- coding: utf-8-unix -*-
\section{动态路由（RIP）}
-\label{sec:c3_s2}
+\label{sec:c:ensp:s:rip}
\subsection{实验目的}
-\label{subsec:c3_s2_object}
+\label{subsec:c:ensp:s:rip_object}
理解动态路由协议RIP的工作原理；
掌握采用动态路由协议RIP进行网络设计的基本原则和方法。
\subsection{实验内容}
-\label{subsec:c3_s2_content}
+\label{subsec:c:ensp:s:rip_content}
\begin{itemize}
\item 华为路由器IP地址的配置；
@@ -21,47 +21,48 @@
\end{itemize}
\subsection{实验原理、方法和手段}
-\label{subsec:c3_s2_principle}
+\label{subsec:c:ensp:s:rip_principle}
简要说明RIP工作原理和适用范围；设计至少包括3个网络由RIP协议互连起来；
观察并记录各设备状态变化情况，特别留意路由信息的交换和路由表。
解释说明与路由协议、路由表的相关性。
-可参考下图连线，具体联线情况请自行标注。
+可参考图\ref{fig:c:ensp_RIP-topo}连线，具体联线情况请自行标注。
\begin{figure}[!htp]
\centering
- \includegraphics[width=8cm]{c3_RIP-topo}
+ \includegraphics[width=8cm]{RIP-topo}
\caption{实验拓扑图}
- \label{fig:c3_RIP-topo}
+ \label{fig:c:ensp_RIP-topo}
\end{figure}
\subsection{实验条件}
-\label{subsec:c3_s2_requirement}
+\label{subsec:c:ensp:s:rip_requirement}
\begin{itemize}
- \item 华为ENSP仿真平台中：2台PC，两台路由器；
+ \item 华为ENSP仿真平台中：2台PC，3台路由器；
\item 双绞线若干。
\end{itemize}
\subsection{实验步骤}
-\label{subsec:c3_s2_procedure}
+\label{subsec:c:ensp:s:rip_procedure}
实验说明：路由器端口以具体选用的设备为准。
如果是实际设备，请观察路由器前面板和后面板的端口名称，
-并使用disp int或者disp cur命令查看端口的实际名称。在对路由器进行配置时，
-可使用disp cur命令来检查当前路由器上生效的配置命令。
+并使用disp~int或者disp~cur命令查看端口的实际名称。
+在对路由器进行配置时，可使用disp cur命令来检查当前路由器上生效的配置命令。
\begin{enumerate}
- \item 硬件连接，完成PC1、PC2到路由器RT1和RT2的网络连接，
- 路由器RT1到路由器RT2的连接；
+ \item 硬件连接，完成PC1、PC2到路由器的网络连接；
PC1到路由器RT1控制线的连接，PC2到路由器RT2控制线的连接。
拓扑图检查无误后方可进行后面的实验步骤,
实验报告中的拓扑图必须标清路由器实际连接的端口。
\item 为PC1、PC2分别设置IP地址、掩码和网关。
- \item 使用sysname命令为路由器R1和R2命名。
+ \item 使用sysname命令为三个路由器命名。
路由器R1的名称为学生自己的姓名拼音+R1，
- 路由器R2的名称为学生自己的姓名拼音+R2,要求记录输入的命令和输出（截屏）。
+ 路由器R2的名称为学生自己的姓名拼音+R2，
+ 路由器R3的名称为学生自己的姓名拼音+R3，
+ 要求记录输入的命令和输出（截屏）。
R1上的命令:
\begin{code}[text]
system-view
@@ -70,9 +71,9 @@
\begin{figure}[!htp]
\centering
- \includegraphics[width=10cm]{c3_sysname-R1_2}
+ \includegraphics[width=10cm]{sysname-R1_2}
\caption{R1配置图}
- \label{fig:c3_sysname-R1_1}
+ \label{fig:c:ensp_sysname-R1_2}
\end{figure}
R2上的命令:
@@ -83,15 +84,19 @@
\begin{figure}[!htp]
\centering
- \includegraphics[width=10cm]{c3_sysname-R2_2}
+ \includegraphics[width=10cm]{sysname-R2_2}
\caption{R2配置图}
- \label{fig:c3_sysname-R2_1}
+ \label{fig:c:ensp_sysname-R2_2}
\end{figure}
- \item 为路由器R1的 GE0接口配置IP地址。
- 配置完成后PC1应该可以Ping通RT1的 GE0口的地址。
- 为路由器R2的 GE1接口配置IP地址。
- 配置完成后PC2应该可以Ping通RT2的GE1口的地址。
+ R3上的命令:
+ \begin{code}[text]
+ system-view
+ [Huawei]sysname zhangsanR3
+ \end{code}
+
+ \item （从左至右配置）为路由器R1的两个接口配置IP地址。
+ 配置完成后PC1应该可以Ping通RT1的E0口的地址。
要求记录输入的命令和输出（截屏）。
(本模拟器R1实际使用的接口名由实际使用的路由器型号确定，
可能有Ethernet0/0/0；或GigabitEthernet0/0/x；或FastEthernet0/0/x)
@@ -111,79 +116,98 @@
\begin{figure}[!htp]
\centering
- \includegraphics[width=10cm]{c3_ping_2}
+ \includegraphics[width=10cm]{ping_2}
\caption{Ping通效果图}
- \label{fig:c3_ping_2}
+ \label{fig:c:ensp_ping_2}
\end{figure}
- R2上的命令:
+ \item 为路由器R1的 GE1接口配置IP地址。
\begin{code}[text]
- [zhangsanR2]interface GigabitEthernet 0/0/1
- [zhangsanR1-GigabitEthernet0/0/1]ip address 192.168.3.1 255.255.255.0
- \end{code}
-
- PC2可以Ping通R2的192.168.3.1地址
-
+ [zhangsanR1]interface GigabitEthernet 0/0/1
+ [zhangsanR1-GigabitEthernet0/0/1]ip address 192.168.2.1 255.255.255.0
+ [zhangsanR1-GigabitEthernet0/0/1]quit
+\end{code}
+\item 为路由器R2的GE0、GE1接口配置IP地址。
+配置完成后路由器R1和R2应该可以互相Ping通。
+要求记录输入的命令和输出（截屏）
\begin{code}[text]
- PC1>ping 192.168.3.1
- \end{code}
-
- \item 为路由器R1的 Ethernet0/0/1接口配置IP地址，
- 为路由器R2的Ethernet0/0/0接口配置IP地址。
- 配置完成后路由器R1和R2应该可以互相Ping通。
- 要求记录输入的命令和输出（截屏）。
-
+ [zhangsanR2]interface GigabitEthernet 0/0/0
+ [zhangsanR2-GigabitEthernet0/0/0]ip address 192.168.2.2 255.255.255.0
+ [zhangsanR2-GigabitEthernet0/0/0]quit
+\end{code}
+
+ \begin{code}[text]
+ [zhangsanR2]interface GigabitEthernet 0/0/1
+ [zhangsanR2-GigabitEthernet0/0/1]ip address 192.168.3.1 255.255.255.0
+ [zhangsanR2-GigabitEthernet0/0/1]quit
+\end{code}
+\item 为路由器R3的GE0、GE1接口配置IP地址。配置完成后，
+直连路由应可相互Ping通，如PC2应可Ping通R3的GE1口的地址。
\begin{code}[text]
- [zhangsanR1-GigabitEthernet0/0/1]ip address 192.168.2.1 255.255.255.0
- [zhangsanR1-GigabitEthernet0/0/1]quit
+ [zhangsanR3]interface GigabitEthernet 0/0/0
+ [zhangsanR3-GigabitEthernet0/0/0]ip address 192.168.3.2 255.255.255.0
+ [zhangsanR3-GigabitEthernet0/0/0]quit
+\end{code}
+
+ \begin{code}[text]
+ [zhangsanR3]interface GigabitEthernet 0/0/1
+ [zhangsanR3-GigabitEthernet0/0/1]ip address 192.168.4.1 255.255.255.0
+ [zhangsanR3-GigabitEthernet0/0/1]quit
\end{code}
+ PC2可以Ping通R2的192.168.4.1地址
\begin{code}[text]
- [zhangsanR2-GigabitEthernet0/0/0]ip address 192.168.2.2 255.255.255.0
- [zhangsanR2-GigabitEthernet0/0/0]quit
+ PC1>ping 192.168.4.1
\end{code}
-
- \item 为RT1和RT2配置动态路由协议rip。
- 要求记录输入的命令和输出（截屏或文本复制）。
- 配置后可以用disp cur检查配置，或者disp ip routing-table检查路由表。
- 要求记录输入的命令和输出（截屏）。
-
+
+ \item 为三个路由器分别配置动态路由协议rip（从左至右）。要求记录输入的命令和输出（截屏或文本复制）。配置后可以用disp cur检查配置，或者disp ip routing-table检查路由表。要求记录输入的命令和输出（截屏）。
\begin{code}[text]
[zhangsanR1]rip
[zhangsanR1-rip]network 192.168.1.0
[zhangsanR1-rip]network 192.168.2.0
\end{code}
-
+
\begin{code}[text]
[zhangsanR2]rip
- [zhangsanR2-rip]network 192.168.3.0
[zhangsanR2-rip]network 192.168.2.0
+ [zhangsanR2-rip]network 192.168.3.0
\end{code}
-
+
+ \begin{code}[text]
+ [zhangsanR3]rip
+ [zhangsanR3-rip]network 192.168.3.0
+ [zhangsanR3-rip]network 192.168.4.0
+ \end{code}
+
\begin{code}[text]
[zhangsanR1]display ip routing-table
\end{code}
-
+ （R1路由表截屏）
\begin{code}[text]
[zhangsanR2]display ip routing-table
\end{code}
-
- 等待1分钟后，在两台路由器上重复disp ip rout(缩写)命令，
- 比较路由表，rip协议是否出现？
+ （R2路由表截屏）
+ \begin{code}[text]
+ [zhangsanR3]display ip routing-table
+ \end{code}
+ （R3路由表截屏）
+ 等待1分钟后，在两台路由器上重复disp ip rout(缩写)命令，
+ 比较路由表，rip协议是否全部出现？
+
注意：如果要删除某路由器上的所有rip配置，或路由输入错误，
则输入下列命令则可删除刚才的路由
\begin{code}[text]
[zhangsanR2]undo rip
\end{code}
-
+
\item 验证PC1和PC2可以ping通。要求记录输入的命令和输出（截屏）。
+
\item （为后续实验，建议保存拓扑和具体设备的配置命令，
即在和模式中输入save命令，并保存已配置命令
-
\end{enumerate}
\subsection{思考题}
-\label{subsec:c3_s2_rethink}
+\label{subsec:c:ensp:s:rip_rethink}
\begin{enumerate}
\item 在完成rip动态路由配置后，最远两端能够ping通，
@@ -192,7 +216,11 @@
\end{enumerate}
\subsection{注意事项及有关说明}
-\label{subsec:c3_s2_notice}
-
-路由器端口以具体选用的设备为准，请将E0口和E1口对应到实际设备上的端口名称，接口名由实际使用的路由器型号确定，可能有Ethernet0/0/0；或GigabitEthernet0/0/x；或FastEthernet0/0/x。如果是实际设备，请观察路由器前面板和后面板的端口名称，并使用disp int或者disp cur命令查看端口的实际名称。在对路由器进行配置时，可使用disp cur命令来检查当前路由器上生效的配置命令。
-
+\label{subsec:c:ensp:s:rip_notice}
+
+路由器端口以具体选用的设备为准，请将E0口和E1口对应到实际设备上的端口名称，
+接口名由实际使用的路由器型号确定，可能有Ethernet0/0/0；
+或GigabitEthernet0/0/x；或FastEthernet0/0/x。如果是实际设备，
+请观察路由器前面板和后面板的端口名称，
+并使用disp int或者disp cur命令查看端口的实际名称。
+在对路由器进行配置时，可使用disp cur命令来检查当前路由器上生效的配置命令。
diff --git a/data/chapter3/section1.tex b/data/ch_ensp/sec_static.tex
similarity index 52%
rename from data/chapter3/section1.tex
rename to data/ch_ensp/sec_static.tex
index 138303a..985d1e3 100644
--- a/data/chapter3/section1.tex
+++ b/data/ch_ensp/sec_static.tex
@@ -1,15 +1,15 @@
%# -*- coding: utf-8-unix -*-
\section{静态路由}
-\label{sec:c3_s1}
+\label{sec:c:ensp:s:static}
\subsection{实验目的}
-\label{subsec:c3_s1_object}
+\label{subsec:c:ensp:s:static_object}
掌握静态路由协议，理解路由器工作原理，掌握路由器相关的配置、检测操作。
\subsection{实验内容}
-\label{subsec:c3_s1_content}
+\label{subsec:c:ensp:s:static_content}
\begin{itemize}
\item 华为网络设备常用配置命令；
@@ -22,35 +22,33 @@
\end{itemize}
\subsection{实验原理、方法和手段}
-\label{subsec:c3_s1_principle}
+\label{subsec:c:ensp:s:static_principle}
\begin{figure}[!htp]
\centering
- \includegraphics[width=8cm]{c3_static-topo}
+ \includegraphics[width=8cm]{static-topo}
\caption{实验拓扑图}
- \label{fig:c3_static-topo}
+ \label{fig:c:ensp_static-topo}
\end{figure}
\begin{enumerate}
- \item 用路由器连接若干局域网，
- 局域网之间建议采用Ethernet协议连接，
- 局域网之间采用静态路由，
- 从而使在不同局域网上的计算机能够交换信息。
+ \item 用路由器连接若干局域网，局域网之间建议采用Ethernet协议连接，
+ 局域网之间采用静态路由，从而使在不同局域网上的计算机能够交换信息。
观察联通前后计算机和路由器路由表的变化情况，并给出解释。
\item 通过ping其他主机，用Wireshark捕捉网络流量，
- 找出与ping相关的ARP协议、ICMP协议报文逐字节地进行剖析（选做）。
+ 找出与ping相关的ARP协议、ICMP协议报文逐字节地进行剖析（选做）
\end{enumerate}
\subsection{实验条件}
-\label{subsec:c3_s1_requirement}
+\label{subsec:c:ensp:s:static_requirement}
\begin{itemize}
- \item 华为ENSP仿真平台中：2台PC，两台路由器；
+ \item 华为ENSP仿真平台中：2台PC，三台路由器；
\item 双绞线若干。
\end{itemize}
\subsection{实验步骤}
-\label{subsec:c3_s1_procedure}
+\label{subsec:c:ensp:s:static_procedure}
实验说明：路由器端口以具体选用的设备为准
（如路由器型号为AR2240以上，端口为千兆以太网口GE0/0/0；
@@ -60,16 +58,17 @@
如果是实际设备，请观察路由器前面板和后面板的端口名称，
并使用disp int或者disp cur命令查看端口的实际名称。
在对路由器进行配置时，可使用disp cur命令来检查当前路由器上生效的配置命令。
+
\begin{enumerate}
- \item 硬件连接，完成PC1、PC2到路由器RT1和RT2的网络连接，
- 路由器RT1到路由器RT2的连接；PC1到路由器RT1控制线的连接，
- PC2到路由器RT2控制线的连接。
- 拓扑图检查无误后方可进行后面的实验步骤，
+ \item 硬件连接，完成PC1、PC2到路由器的网络连接；
+ PC1到路由器RT1控制线的连接，PC2到路由器RT2控制线的连接。
+ 拓扑图检查无误后方可进行后面的实验步骤,
实验报告中的拓扑图必须标清路由器实际连接的端口。
\item 为PC1、PC2分别设置IP地址、掩码和网关。
- \item 使用sysname命令为路由器R1和R2命名。
+ \item 使用sysname命令为三个路由器命名。
路由器R1的名称为学生自己的姓名拼音+R1，
路由器R2的名称为学生自己的姓名拼音+R2，
+ 路由器R3的名称为学生自己的姓名拼音+R3，
要求记录输入的命令和输出（截屏）。
R1上的命令:
@@ -80,9 +79,9 @@
\begin{figure}[!htp]
\centering
- \includegraphics[width=10cm]{c3_sysname-R1_1}
+ \includegraphics[width=10cm]{sysname-R1_1}
\caption{R1配置图}
- \label{fig:c3_sysname-R1_1}
+ \label{fig:c:ensp_sysname-R1_1}
\end{figure}
R2上的命令:
@@ -93,17 +92,22 @@
\begin{figure}[!htp]
\centering
- \includegraphics[width=10cm]{c3_sysname-R2_1}
+ \includegraphics[width=10cm]{sysname-R2_1}
\caption{R1配置图}
- \label{fig:c3_sysname-R2_1}
+ \label{fig:c:ensp_sysname-R2_1}
\end{figure}
-
- \item 为路由器R1的 GE0接口配置IP地址。
+
+ R3上的命令:
+ \begin{code}[text]
+ system-view
+ [Huawei]sysname zhangsanR3
+ \end{code}
+
+ \item （从左至右配置）为路由器R1的两个接口配置IP地址。
配置完成后PC1应该可以Ping通RT1的E0口的地址。
- 为路由器R2的 E1接口配置IP地址。
- 配置完成后PC2应该可以Ping通RT2的E1口的地址。
要求记录输入的命令和输出（截屏）。
- (本模拟器R1实际使用的接口名由实际使用的路由器型号确定，可能有Ethernet0/0/0；或GigabitEthernet0/0/x；或FastEthernet0/0/x)
+ (本模拟器R1实际使用的接口名由实际使用的路由器型号确定，
+ 可能有Ethernet0/0/0；或GigabitEthernet0/0/x；或FastEthernet0/0/x)
R1上的命令:
\begin{code}[text]
@@ -111,78 +115,124 @@
[zhangsanR1- GigabitEthernet0/0/0]ip address 192.168.1.1 255.255.255.0
[zhangsanR1- GigabitEthernet0/0/0]
\end{code}
+
PC1可以Ping通R1的192.168.1.1地址
\begin{code}[text]
PC1>ping 192.168.1.1
\end{code}
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=10cm]{c3_ping_1}
+ \includegraphics[width=10cm]{ping_1}
\caption{Ping通效果图}
- \label{fig:c3_ping_1}
+ \label{fig:c:ensp_ping_1}
\end{figure}
- R2上的命令:
+ 为路由器R1的 GE1接口配置IP地址。
\begin{code}[text]
- [zhangsanR2]interface GigabitEthernet 0/0/1
- [zhangsanR1-GigabitEthernet0/0/1]ip address 192.168.3.1 255.255.255.0
- \end{code}
- PC2可以Ping通R2的192.168.3.1地址
- \begin{code}[text]
- PC1>ping 192.168.3.1
+ [zhangsanR1]interface GigabitEthernet 0/0/1
+ [zhangsanR1-GigabitEthernet0/0/1]ip address 192.168.2.1 255.255.255.0
+ [zhangsanR1-GigabitEthernet0/0/1]quit
\end{code}
- \item 为路由器R1的 Ethernet0/0/1接口配置IP地址，
- 为路由器R2的Ethernet0/0/0接口配置IP地址。
- 配置完成后路由器R1和R2应该可以互相Ping通。要求记录输入的命令和输出（截屏）。
+ \item 为路由器R2的GE0、GE1接口配置IP地址。
+ 配置完成后路由器R1和R2应该可以互相Ping通。
+ 要求记录输入的命令和输出（截屏）
+
\begin{code}[text]
- [zhangsanR1-GigabitEthernet0/0/1]ip address 192.168.2.1 255.255.255.0
- [zhangsanR1-GigabitEthernet0/0/1]quit
+ [zhangsanR2]interface GigabitEthernet 0/0/0
[zhangsanR2-GigabitEthernet0/0/0]ip address 192.168.2.2 255.255.255.0
[zhangsanR2-GigabitEthernet0/0/0]quit
\end{code}
- \item 为RT1和RT2配置路由。要求记录输入的命令和输出（截屏或文本复制）。
+
+ \begin{code}[text]
+ [zhangsanR2]interface GigabitEthernet 0/0/1
+ [zhangsanR2-GigabitEthernet0/0/1]ip address 192.168.3.1 255.255.255.0
+ [zhangsanR2-GigabitEthernet0/0/1]quit
+ \end{code}
+
+ \item 为路由器R3的GE0、GE1接口配置IP地址。配置完成后，
+ 直连路由应可相互Ping通，如PC2应可Ping通R3的GE1口的地址。
+
+ \begin{code}[text]
+ [zhangsanR3]interface GigabitEthernet 0/0/0
+ [zhangsanR3-GigabitEthernet0/0/0]ip address 192.168.3.2 255.255.255.0
+ [zhangsanR3-GigabitEthernet0/0/0]quit
+ \end{code}
+
+ \begin{code}[text]
+ [zhangsanR3]interface GigabitEthernet 0/0/1
+ [zhangsanR3-GigabitEthernet0/0/1]ip address 192.168.4.1 255.255.255.0
+ [zhangsanR3-GigabitEthernet0/0/1]quit
+ \end{code}
+
+ PC2可以Ping通R2的192.168.4.1地址
+ \begin{code}[text]
+ PC1>ping 192.168.4.1
+ \end{code}
+
+ \item 为三个路由器分别从左至右配置静态路由。
+ 要求记录输入的命令和输出（截屏或文本复制）。
配置后可以用disp cur检查配置，或者disp ip route检查路由表。
要求记录输入的命令和输出（截屏）。
+
+ 静态路由配置命令：ip route-static 目的网络号 掩码 下一跳的ip地址
+ 具体环境配置：
+
\begin{code}[text]
[zhangsanR1]ip route-static 192.168.3.0 255.255.255.0 192.168.2.2
+ [zhangsanR1]ip route-static 192.168.4.0 255.255.255.0 192.168.2.2
+ \end{code}
+
+ \begin{code}[text]
[zhangsanR2]ip route-static 192.168.1.0 255.255.255.0 192.168.2.1
+ [zhangsanR2]ip route-static 192.168.4.0 255.255.255.0 192.168.3.2
\end{code}
- 注意：如果路由输入错误，如输入
+
\begin{code}[text]
- [rt1]ip route-static 192.168.3.0 255.255.255.0 192.168.2.2
+ [zhangsanR3]ip route-static 192.168.1.0 255.255.255.0 192.168.3.1
+ [zhangsanR3]ip route-static 192.168.2.0 255.255.255.0 192.168.3.1
+ \end{code}
+
+ 注意：如果路由命令输入错误，如输入
+ \begin{code}[text]
+ [rt1]ip route-static 192.168.3.0 255.255.255.0 192.168.2.1
\end{code}
则输入下列命令则可删除刚才的路由
\begin{code}[text]
- [rt1]undo ip route-static 192.168.3.0 255.255.255.0 192.168.2.2
+ [rt1]undo ip route-static 192.168.3.0 255.255.255.0 192.168.2.1
\end{code}
- \item 验证PC1和PC2可以ping通。
+
+ \item 如配置正确，此时网络收敛，则任何两点之间（含非直连）均可ping通，
+ 验证，如PC1和PC2可以ping通。
分别使用ping命令和traceRT命令来验证,解释结果显示。
要求记录输入的命令和输出（截屏）。
+
\begin{code}[text]
- Ping 192.168.3.2
- traceRT 192.168.3.2
+ Ping 192.168.4.2
+ traceRT 192.168.4.2
\end{code}
- \item （可选作）在PC1上使用抓包工具进行抓包。
- 首先使用arp –d命令清空arp表。
- 再使用Ping命令测试到PC2的连通性（192.168.3.2）。
+
+ \item （以下内容为选做）
+ 在PC1上使用抓包工具进行抓包。首先使用arp –d命令清空arp表。
+ 再使用Ping命令测试到PC2的连通性（192.168.4.2）。
分析抓到的ping命令的icmp报文。
+
\end{enumerate}
\subsection{思考题}
-\label{subsec:c3_s1_rethink}
+\label{subsec:c:ensp:s:static_rethink}
-如未达到网络收敛状态时，最远两端能够ping通，
+如未达到网络收敛状态时，即使最远两端能够ping通，
请问网络中间的任意两点间也能ping通吗？为什么？
\subsection{注意事项及有关说明}
-\label{subsec:c3_s1_notice}
+\label{subsec:c:ensp:s:static_notice}
路由器端口以具体选用的设备为准，
请将E0口和E1口对应到实际设备上的端口名称，
-接口名由实际使用的路由器型号确定，
-可能有Ethernet0/0/0；或GigabitEthernet0/0/x；或FastEthernet0/0/x。
+接口名由实际使用的路由器型号确定，可能有Ethernet0/0/0；
+或GigabitEthernet0/0/x；或FastEthernet0/0/x。
如果是实际设备，请观察路由器前面板和后面板的端口名称，
并使用disp int或者disp cur命令查看端口的实际名称。
在对路由器进行配置时，可使用disp cur命令来检查当前路由器上生效的配置命令。
diff --git a/data/ch_router-openbox/preface.tex b/data/ch_router-openbox/preface.tex
new file mode 100644
index 0000000..853cb0f
--- /dev/null
+++ b/data/ch_router-openbox/preface.tex
@@ -0,0 +1,18 @@
+%# -*- coding: utf-8-unix -*-
+
+\chapter{路由器实现}
+\label{chap:router-ob}
+
+本单元实验使学生能初步使用可编程网络设备开发平台进行路由器基本功能的设计与实现，
+通过程序来实现路由器中最基本的三个功能：
+包括二层交换功能、三层路由功能及组网功能。
+深入理解路由器的基本工作原理与分组处理流程，
+从而培养学生对网络设备使用和研发的能力。
+
+可编程网络设备开发平台是一款基于FAST架构的软硬件
+（软件在CPU上使用C语言编程，硬件在FPGA芯片上使用Verilog语言编程）
+全可编程的网络实验教学平台，平台的软硬件逻辑代码开源免费，支持用户二次开发。
+其基本使用方法与编程开发方法见附录\ref{app:openbox}：《可编程网络平台－操作手册》
+和附录\ref{app:fast}：《FAST编程－入门指南》。
+可编程网络设备开发平台在后文简称为“可编程网络平台”，图标LOGO为FAST，节点名称为OpenBox-S4。
+
diff --git a/data/ch_router-openbox/sec_networking.tex b/data/ch_router-openbox/sec_networking.tex
new file mode 100644
index 0000000..04d5746
--- /dev/null
+++ b/data/ch_router-openbox/sec_networking.tex
@@ -0,0 +1,274 @@
+%# -*- coding: utf-8-unix -*-
+
+\section{三层路由器组网}
+\label{sec:c:router-ob:s:networking}
+
+\subsection{实验目的}
+\label{subsec:c:router-ob:s:networking_object}
+
+本实验的主要目的是让学生将自己开发的路由器进行组网实验，
+引入路由协议的配置与学习，实现多网段主机间的相互通信。
+熟悉Quagga软件的安装与使用和两种基本路由协议（RIP与OSPF）的配置与使用。
+
+\subsection{实验内容}
+\label{subsec:c:router-ob:s:networking_content}
+
+使用学生开发的路由器平台，搭建至少跨两跳路由器的复杂路由组网环境，
+验证多网段主机的相互连通性。主要完成以下内容：
+
+\begin{enumerate}
+ \item \textbf{搭建自研路由器环境：}使用学生自己研发的路由器组建网络，
+ 搭建不少于3台路由器和2台测试主机的网络环境进行验证；
+ \item \textbf{安装并配置路由协议学习环境：}运行Quagga环境，
+ 分配配置RIP路由协议与OSPF路由协议，并将两种协议启动运行；
+ \item \textbf{验证组网功能：}验证不同路由协议下组网运行功能，
+ 验证不同网段内主机的相互通信功能
+ \item \textbf{观察分析路由器工作流程：}观察各路由节点学习非互联网段的路由转发表，
+ 打印输出各路由节点的FIB表
+ \item \textbf{观察分析内核FIB的变化：}在网络正常运行状态下，
+ 断开中间某个路由器间的链路，观察断开链路两端路由器的内核FIB表变化情况，
+ 同时验证路由器内FIB表同步情况
+\end{enumerate}
+
+\subsection{实验原理、方法和手段}
+\label{subsec:c:router-ob:s:networking_principle}
+
+\subsubsection{路由协议及基本工作原理}
+
+路由协议工作在路由器的控制平面，创建了路由表，描述了网络拓扑结构。
+通过在路由器之间共享路由信息来相互学习总个网络可达区域内可到达的路由网段信息。
+路由信息在相邻路由器之间传递，确保所有路由器知道到其它路由器的路径。
+
+路由协议主要包括：RIP、OSPF、IS－IS和BGP等。
+RIP、OSPF、IS-IS是内部网关协议（IGP），
+适用于单个ISP的统一路由协议的运行，
+一般由一个ISP运营的网络位于一个AS（自治系统）内，
+有统一的AS number（自治系统号）。
+BGP是自治系统间的路由协议，是一种外部网关协议，
+多用于不同ISP之间交换路由信息，以及大型企业、政府等具有较大规模的私有网络。
+
+\subsubsection{路由组网环境}
+
+本实验建议采用学生自研的路由器进行组网测试，
+组网测试通过的组可以在中间穿插商用路由器一起验证。
+
+\subsection{实验条件}
+\label{subsec:c:router-ob:s:networking_requirement}
+
+\begin{itemize}
+ \item 可编程网络平台两个，交换测试主机两台，
+ 网络配置与连接拓扑如图\ref{fig:c:router-ob_networking-topo}所示；
+ \item 串口线一根，网线三根；
+ \item 学生自研路由器程序。
+\end{itemize}
+
+\begin{figure}[!ht]
+ \centering
+ \includegraphics[width=12cm]{networking-topo}
+ \caption{三层路由组网实验拓扑图}
+ \label{fig:c:router-ob_networking-topo}
+\end{figure}
+
+\subsection{实验步骤}
+\label{subsec:c:router-ob:s:networking_procedure}
+
+\begin{enumerate}
+ \item 在每个路由器节点安装quagga软件，配置其正常工作。
+ 路由协议选择RIP和OSPF两种，每次测试只启动一种协议即可；
+ \begin{itemize}
+ \item Quagga安装
+ \begin{code}[console]
+ root@HNXS-FAST:/home/hnxs# apt-get install quagga
+ 正在读取软件包列表... 完成
+ 正在分析软件包的依赖关系树
+ 正在读取状态信息... 完成
+ 建议安装：
+ snmpd
+ 下列【新】软件包将被安装：
+ quagga
+ 升级了 0 个软件包，新安装了 1 个软件包，要卸载 0 个软件包，有 1 个软件包未被升级。
+ 有 1 个软件包没有被完全安装或卸载。
+ 需要下载 1,154 kB 的归档。
+ 解压缩后会消耗 4,605 kB 的额外空间。
+ 获取:1 https://mirrors.ustc.edu.cn/ubuntu-ports xenial-updates/main armhf quagga armhf 0.99.24.1-2ubuntu1.4 [1,154 kB]
+ 已下载 1,154 kB，耗时 1秒 (997 kB/s)
+ 正在预设定软件包 ...
+ 正在选中未选择的软件包 quagga。
+ （正在读取数据库 ... 系统当前共安装有 21814 个文件和目录。）
+ 正准备解包 .../quagga_0.99.24.1-2ubuntu1.4_armhf.deb ...
+ 正在解包 quagga (0.99.24.1-2ubuntu1.4) ...
+ 正在处理用于 libc-bin (2.23-0ubuntu3) 的触发器 ...
+ 正在处理用于 ureadahead (0.100.0-19) 的触发器 ...
+ 正在处理用于 systemd (229-4ubuntu4) 的触发器 ...
+ 正在设置 quagga (0.99.24.1-2ubuntu1.4) ...
+ 正在处理用于 libc-bin (2.23-0ubuntu3) 的触发器 ...
+ 正在处理用于 ureadahead (0.100.0-19) 的触发器 ...
+ 正在处理用于 systemd (229-4ubuntu4) 的触发器 ...
+ \end{code}
+
+ \item Quagga启动配置
+ \begin{code}[console]
+ root@HNXS-FAST:/home/hnxs# vim /etc/quagga/daemons
+ zebra=yes
+ bgpd=no
+ ospfd= yes
+ ospf6d=no
+ ripd= yes
+ ripngd=no
+ isisd=no
+ babeld=no
+ \end{code}
+
+ 将上述文件内容中的3个no修改为yes，表示启动该功能模块。
+
+ \item RIP协议启动配置
+ \begin{code}[console]
+ root@HNXS:/home/hnxs# vim /etc/quagga/ripd.conf
+ \end{code}
+
+ ripd.conf配置文件示例如下：
+
+ \begin{code}[text]
+ ! -*- rip -*-
+ !
+ ! RIPd sample configuration file
+ !
+ ! $Id: ripd.conf.sample,v 1.1 2002/12/13 20:15:30 paul Exp $
+ !
+ hostname ripd
+ password zebra
+ !
+ ! debug rip events
+ ! debug rip packet
+ !
+ router rip
+ ! network 11.0.0.0/8
+ ! network eth0
+ ! route 10.0.0.0/8
+ ! distribute-list private-only in eth0
+ network obx0
+ network obx1
+ network obx2
+ network obx3
+ neighbor 192.168.3.1
+ !
+ !access-list private-only permit 10.0.0.0/8
+ !access-list private-only deny any
+ !
+ !log file /var/log/quagga/ripd.log
+ !
+ log stdout
+ \end{code}
+ 上述文件是S4-A路由器的rip配置文件，另一台配置文件与上述基本相同，
+ 只是其neighbor的地址是192.168.3.2。
+ 这两台路由器是通过S4-A的一个端口（IP为192.168.3.1，
+ 故其neighbor为192.168.3.2）和S4-B的一个端口（IP为192.168.3.2）连接起来的。
+
+ \item OSPF协议启动配置
+ \begin{code}[console]
+ root@HNXS:/home/hnxs# vim /etc/quagga/ospfd.conf
+ \end{code}
+
+ ospfd.conf配置文件示例如下：
+
+ \begin{code}[text]
+ ! -*- ospf -*-
+ !
+ ! OSPFd sample configuration file
+ !
+ !
+ hostname ospfd
+ password zebra
+ !enable password please-set-at-here
+ !
+ !router ospf
+ ! network 192.168.1.0/24 area 0
+ !
+ ospf router-id 192.168.3.1
+ network 192.168.0.0/24 area 0
+ network 192.168.1.0/24 area 0
+ network 192.168.2.0/24 area 0
+ network 192.168.3.0/24 area 0
+ log stdout
+ \end{code}
+
+ 上述为S4-A路由器的配置文件，另一台路由器配置文件为：
+ \begin{code}[text]
+ ! -*- ospf -*-
+ !
+ ! OSPFd sample configuration file
+ !
+ !
+ hostname ospfd
+ password zebra
+ !enable password please-set-at-here
+ !
+ !router ospf
+ ! network 192.168.1.0/24 area 0
+ !
+ ospf router-id 192.168.3.2
+ network 192.168.4.0/24 area 0
+ network 192.168.5.0/24 area 0
+ network 192.168.6.0/24 area 0
+ network 192.168.3.0/24 area 0
+ log stdout
+ \end{code}
+ \end{itemize}
+
+ \item 启动路由协议
+ \begin{code}[console]
+ root@HNXS:/home/hnxs# systemctl start quagga
+ \end{code}
+
+ \item 将自研路由器和测试主机组网，路由节点不少于2个，连线可以组成环状；
+ \item 运行自研路由器，并在两个测试主机上分别ping对方主机IP地址；
+ 请参考实验\ref{sec:c:router-ob:s:router}内容。
+ \item 观察某个节点路由器分组处理流程，
+ 从打印消息上观察控制平面与数据平面的分组处理情况；
+ \item 观察每个节点上内核FIB表内容；
+
+ \begin{code}[console]
+ root@HNXS-FAST:/mnt/openbox# route -n
+ Kernel IP routing table
+ Destination Gateway Genmask Flags Metric Ref Use Iface
+ 192.168.0.0 0.0.0.0 255.255.255.0 U 0 0 0 obx0
+ 192.168.1.0 0.0.0.0 255.255.255.0 U 0 0 0 obx1
+ 192.168.2.0 0.0.0.0 255.255.255.0 U 0 0 0 obx2
+ 192.168.3.0 0.0.0.0 255.255.255.0 U 0 0 0 obx3
+ 192.168.4.0 192.168.3.2 255.255.255.0 UG 2 0 0 obx3
+ 192.168.5.0 192.168.3.2 255.255.255.0 UG 2 0 0 obx3
+ 192.168.6.0 192.168.3.2 255.255.255.0 UG 2 0 0 obx3
+ \end{code}
+ 观察新增加的表项内容，最后三条是非本地路由可直达的网段，
+ 其均需要通过192.168.3.2网送才可达。
+ \item 观察路由器FIB表的更新情况，判断是否检测到内核FIB变化，是否已经同步更新；
+\end{enumerate}
+
+\subsection{思考题}
+\label{subsec:c:router-ob:s:networking_rethink}
+
+\begin{enumerate}
+ \item 路由协议的邻接信息学习后如何去重？如何收敛？
+ \item 默认网关的作用是什么？
+\end{enumerate}
+
+\subsection{注意事项及有关说明}
+\label{subsec:c:router-ob:s:networking_notice}
+
+\begin{enumerate}
+ \item RIP协议与OSPF协议一定要根据网络连接接口及相应IP地址配置网段信息，
+ 修改文件时注意不要使用中文符号；
+ \item 每次只启动一个协议，以更好验证其效果。
+\end{enumerate}
+
+\subsection{考核方法}
+\label{subsec:c:router-ob:s:networking_criterion}
+
+完成本次实验，需要提交一份实验报告和一分程序输出日志。
+\begin{enumerate}
+ \item （20分）在规定时间内完成实验，并提交实验成果；
+ \item （30分）实验报告内容详细，有关键步骤截图与分析说明；
+ \item （20分）所有节点正常运行，不同网段的主机可以相互ping通；
+ \item （20分）Quagga安装配置正确，RIP和OSPF配置正确，工作正常；
+ \item （10分）实验报告与源代码内容完整、格式整洁。
+\end{enumerate}
diff --git a/data/ch_router-openbox/sec_router.tex b/data/ch_router-openbox/sec_router.tex
new file mode 100644
index 0000000..fae5866
--- /dev/null
+++ b/data/ch_router-openbox/sec_router.tex
@@ -0,0 +1,283 @@
+%# -*- coding: utf-8-unix -*-
+
+\section{三层路由器实现}
+\label{sec:c:router-ob:s:router}
+
+\subsection{实验目的}
+\label{subsec:c:router-ob:s:router_object}
+
+本实验的主要目的是让学生掌握二层以太网帧、ARP协议和三层IP协议等的数据结构，
+熟悉各协议的解析与封装过程，
+掌握三层路由器的工作原理、分组处理流程、FIB表和邻接表生成与使用。
+熟悉路由器数据平面与控制平面的切分及不同的工作处理流程。
+
+\subsection{实验内容}
+\label{subsec:c:router-ob:s:router_content}
+
+使用可编程网络平台及三层路由器示例框架源码，
+设计完成一个三层路由器原型系统。主要完成以下内容：
+
+\begin{enumerate}
+ \item \textbf{系统路由验证：}搭建测试环境，
+ 验证系统自带三层路由原型系统的功能，实现不同网段主机的相互通信功能；
+ \item \textbf{逻辑设计与实现：}基于路由器示例框架代码，
+ 分别设计完成路由器的分组解析、FIB同步与查表、
+ 二层与三层数据更新、ARP请求与响应等模块功能；
+ \item \textbf{功能调试与验证：}根据路由器分组处理流程，
+ 分别调试每一类分组的处理逻辑。如ARP请求类分组、
+ ARP响应类分组、控制平面分组和数据平面分组；
+ 组网测试路由器功能，实现不同网段内主机之间的相互通信功能。
+\end{enumerate}
+
+\subsection{实验原理、方法和手段}
+\label{subsec:c:router-ob:s:router_principle}
+
+\subsubsection{系统路由验证}
+
+请参考附件《可编程网络平台－操作手册》完成。
+\subsubsection{三层路由器工作原理}
+三层路由器工作于OSI模型的第3层（网络层），根据网络层中的目的IP地址进行查表，
+获得分组转发的下一跳输出端口及下一跳的IP地址。更新网络层的TTL值与CSUM值，
+并在输出端口对二层数据进行重新封装二层数据后转发。
+路由器还具备ARP响应与请求功能，
+支持响应请求自己IP的MAC信息与请求路由下一跳IP的MAC信息。
+
+\subsubsection{路由器分组处理流程}
+
+\begin{enumerate}
+ \item \textbf{线程同步系统FIB表：}通过一个独立线程，读取内核FIB表信息，
+ 保存到路由器的FIB表结构中；循环不断的获取内核FIB表，
+ 一但有更新，则刷新自己的FIB表内容；
+ \item \textbf{输入分组解析：}接收各端口输入分组信息，并进行分组解析处理，
+ 根据MAC地址信息和目的IP地址信息判断分组为控制平面分组还是数据平面分组；
+ \item \textbf{控制平面与数据平面分流：}将控制平面数据转发到协议栈进行处理，
+ 将数据平台数据转发到路由器数据转发逻辑中处理。
+ 若是本机MAC的ARP请求，则构造ARP响应进行回复；
+ \item \textbf{提取目的IP并查表：}路由器数据转发逻辑进一步解析数据，
+ 解析提取目的IP地址，送入FIB查表引擎进行匹配，
+ 获取分组的下一跳IP地址及输出端口信息；
+ \item \textbf{更新三层数据：}更新分组TTL值与CSUM值，根据FIB表结果，
+ 将分组转发至对应端口输出队列；
+ \item \textbf{更新二层数据：}更新FIB查表下一跳IP的MAC地址信息，
+ 查表无结果，则启动ARP请求模块；若查到对应MAC信息，则更新二层数据后直接转发；
+ \item \textbf{ARP请求：}根据请求的IP地址与发送端口信息构造ARP协议的请求报文，
+ 发送到端口进行学习，并将学习结果保存到该端口的邻接表中；
+ \item \textbf{端口队列输出：}抽取端口输出队列内的发送分组，
+ 更新二层数据后由端口直接发送。
+\end{enumerate}
+
+\subsection{实验条件}
+\label{subsec:c:router-ob:s:router_requirement}
+
+\begin{itemize}
+ \item 可编程网络平台一个，路由测试主机两台，
+ IP配置及连接拓扑如图\ref{fig:c:router-ob_router-topo}所示；
+ \item 串口线一根，网线两根；
+ \item 三层路由器框架源代码（开发环境与编译工具系统自带）。
+\end{itemize}
+
+\begin{figure}[!ht]
+ \centering
+ \includegraphics[width=8cm]{router-topo}
+ \caption{三层路由器实验拓扑图}
+ \label{fig:c:router-ob_router-topo}
+\end{figure}
+
+\subsection{实验步骤}
+\label{subsec:c:router-ob:s:router_procedure}
+
+\subsubsection{系统路由验证}
+1. 登录可编程网络平台，启动系统自带三层路由器命令，
+系统输出如下信息说明已正常启动且进入工作模式；
+
+\begin{code}[console]
+ root@HNXS-FAST:/mnt/openbox# l3router
+ Port[0]->obx0,MAC->00:0A:35:01:00:5B,IPv4->192.168.0.1,
+ IPv6->0000:0000:0000:0000:0000:0000:0000:0000
+ Port[1]->obx1,MAC->00:0A:35:00:00:02,IPv4->192.168.1.1,
+ IPv6->0000:0000:0000:0000:0000:0000:0000:0000
+ Port[2]->obx2,MAC->00:0A:35:00:00:03,IPv4->192.168.2.1,
+ IPv6->0000:0000:0000:0000:0000:0000:0000:0000
+ Port[3]->obx3,MAC->00:0A:35:00:00:04,IPv4->192.168.3.1,
+ IPv6->0000:0000:0000:0000:0000:0000:0000:0000
+ Iface Destination Gateway Flags RefCnt Use Metric Mask MTU Window IRTT Port
+ obx0 0000A8C0 00000000 0001 0 0 0 00FFFFFF 0 0 0 0
+ obx1 0001A8C0 00000000 0001 0 0 0 00FFFFFF 0 0 0 1
+ obx2 0002A8C0 00000000 0001 0 0 0 00FFFFFF 0 0 0 2
+ obx3 0003A8C0 00000000 0001 0 0 0 00FFFFFF 0 0 0 3
+ Create update_fib4_thread OK!
+ Create handle_queue_packet on Port[0] thread OK!
+ handle_queue_packet on port[0]
+ handle_queue_packet[0]->Wait pkt INQUEUE...
+ Create handle_queue_packet on Port[1] thread OK!
+ handle_queue_packet on port[1]
+ handle_queue_packet[1]->Wait pkt INQUEUE...
+ Create handle_queue_packet on Port[2] thread OK!
+ handle_queue_packet on port[2]
+ handle_queue_packet[2]->Wait pkt INQUEUE...
+ Create handle_queue_packet on Port[3] thread OK!
+ handle_queue_packet on port[3]
+ handle_queue_packet[3]->Wait pkt INQUEUE...
+ fastU->REG Version:20180827,OpenBox HW Version:2030200722
+ FAST UA REG->from pid:907,state:21,mid:132
+ fastU->Register UA to FAST Kernel! Wait Reply......
+ fastU->UA->pid:907,mid:132,Register OK!
+ fastU->libua version:20180827
+ fastU->fast_ua_recv......
+\end{code}
+
+\subsubsection{设计开发三层路由器}
+\begin{enumerate}
+ \item 阅读三层路由器框架源代码文件，
+ 根据三层路由工作原理及分组处理流程设计完成框架源代码中的TODO部分内容；
+ \item 编译自己的三层路由器源码，生成相应的路由器系统命令user\_l3router；
+\end{enumerate}
+
+\subsubsection{调试与验证}
+\begin{enumerate}
+ \item 运行自己的三层路由器代码，验证路由器的功能；
+ \item 路由器正常工作后，可以显示如下信息；
+ \begin{itemize}
+ \item 加载路由器接口地址信息
+ \begin{code}[text]
+ Port[0]->obx0,MAC->00:0A:35:01:00:5B,IPv4->192.168.0.1,
+ IPv6->0000:0000:0000:0000:0000:0000:0000:0000
+ Port[1]->obx1,MAC->00:0A:35:00:00:02,IPv4->192.168.1.1,
+ IPv6->0000:0000:0000:0000:0000:0000:0000:0000
+ Port[2]->obx2,MAC->00:0A:35:00:00:03,IPv4->192.168.2.1,
+ IPv6->0000:0000:0000:0000:0000:0000:0000:0000
+ Port[3]->obx3,MAC->00:0A:35:00:00:04,IPv4->192.168.3.1,
+ IPv6->0000:0000:0000:0000:0000:0000:0000:0000
+ \end{code}
+
+ \item 同步内核FIB表
+ \begin{code}[text]
+ Iface Destination Gateway Flags RefCnt Use Metric Mask MTU Window IRTT Port
+ obx0 0000A8C0 00000000 0001 0 0 0 00FFFFFF 0 0 0 0
+ obx1 0001A8C0 00000000 0001 0 0 0 00FFFFFF 0 0 0 1
+ obx2 0002A8C0 00000000 0001 0 0 0 00FFFFFF 0 0 0 2
+ obx3 0003A8C0 00000000 0001 0 0 0 00FFFFFF 0 0 0 3
+ \end{code}
+
+ \item 启动端口输出队列线程
+ \begin{code}[text]
+ Create handle_queue_packet on Port[0] thread OK!
+ handle_queue_packet on port[0]
+ handle_queue_packet[0]->Wait pkt INQUEUE...
+ Create handle_queue_packet on Port[1] thread OK!
+ handle_queue_packet on port[1]
+ handle_queue_packet[1]->Wait pkt INQUEUE...
+ Create handle_queue_packet on Port[2] thread OK!
+ handle_queue_packet on port[2]
+ handle_queue_packet[2]->Wait pkt INQUEUE...
+ Create handle_queue_packet on Port[3] thread OK!
+ handle_queue_packet on port[3]
+ handle_queue_packet[3]->Wait pkt INQUEUE...
+ \end{code}
+
+ \item 开始接收分组处理
+ \begin{code}[text]
+ fastU->REG Version:20180827,OpenBox HW Version:2030200722
+ FAST UA REG->from pid:923,state:21,mid:132
+ fastU->Register UA to FAST Kernel! Wait Reply......
+ fastU->UA->pid:923,mid:132,Register OK!
+ fastU->libua version:20180827
+ fastU->fast_ua_recv......
+ \end{code}
+
+ \item 控制平面分组处理
+ \begin{code}[text]
+ UA Recv ptk 0xb2c00468,len:130,inport:0
+ Recv IPv4 Packet!
+ Recv Unicast Host Packet,Dispatch Packet!
+ Control Plane->Send to Protocol Stack[128]!
+ \end{code}
+
+ \item 数据平面分组处理
+ \begin{code}[text]
+ UA Recv ptk 0xb2c00468,len:130,inport:2
+ Recv IPv4 Packet!
+ Recv Unicast Host Packet,Dispatch Packet!
+ Data Plane->FIB(dst:192.168.0.111) tblidx:0
+ Data Plane->Next Hop:192.168.0.111,outport:0
+ //查不到MAC，入队后学习MAC
+ Data Plane->port[0],NEIGH[1],IN QUEUE[1]
+ Data Plane->Active Thread on Port[0],QUEUE[1] len:2
+ //查询到MAC，直接封闭二层数据后发送
+ Data Plane->port[2],NEIGH[0],DMAC->B8:27:EB:C1:D1:39
+ Pack L2 on Port[2]
+ pkt_send_normal->0xb2c00468,outport:2,len:130
+ \end{code}
+
+ \item ARP请求处理
+ \begin{code}[text]
+ send_arp_request 192.168.2.119 on Port[2]
+ pkt_send_normal->0xb2b00468,outport:2,len:74
+ pkt_send_normal->0xb2b00468,outport:2,len:74
+ pkt_send_normal->0xb2b00468,outport:2,len:74
+ \end{code}
+
+ \item ARP响应处理
+ \begin{code}[text]
+ UA Recv ptk 0xb2c00468,len:92,inport:0
+ Recv ARP Packet!
+ ARP->Host IPv4
+ ARP->Response,192.168.0.111[B8:27:EB:D8:83:20]--> 192.168.0.1[00:0A:35:01:00:5B]
+ Learn SMAC Port[0],B8:27:EB:D8:83:20
+ Learn SMAC Port[0],NEIGH[0],Update[B8:27:EB:D8:83:20]!
+ \end{code}
+
+ \item 路由不可达
+ \begin{code}[text]
+ ICMP Report and Drop!
+ \end{code}
+
+ \item FIB表刷新
+ \begin{code}[text]
+ FIB4 fresh...
+ \end{code}
+
+ \end{itemize}
+
+ \item 路由器工作不正确时，使用\texttt{xprintf}函数打印调试，
+ 建议根据不同类别数据流进行打印分析，调试某一些报文时，其他无关内容均不打印；
+ \item 在任意一台测试主机\texttt{ping 8.8.8.8}，
+ 观察路由器分组处理流程及FIB表查找结果变化；
+ \item 路由器正常工作后，复制保留程序输出日志信息。
+\end{enumerate}
+
+\subsection{思考题}
+\label{subsec:c:router-ob:s:router_rethink}
+
+\begin{enumerate}
+ \item 系统内核的FIB表是如何生成的？生成FIB表的路由协议有哪些，各适应哪些环境？
+ \item 什么是静态路由表？什么是动态路由表？
+ \item FIB表查表不命中如何处理？
+ FIB表指示的下一跳IP的MAC地址不存在如何处理当前分组数据？
+ \item 本程序采用单核单线程处理多个端口的数据转发，如何改成多核多线程方式？
+\end{enumerate}
+
+\subsection{注意事项及有关说明}
+\label{subsec:c:router-ob:s:router_notice}
+
+\begin{enumerate}
+ \item 可编程网络平台的路由器只是一个基础的路由器原型，
+ 分组处理方法与流程设计并不是规范，学生可根据自己理解创新实现；
+ \item 控制平面的数据是通过平台开发环境重新导入到了系统内核处理，
+ 目的是为了支持该系统上的其他正常SOCKET应用，如Quagga路由软件。
+\end{enumerate}
+
+\subsection{考核方法}
+\label{subsec:c:router-ob:s:router_criterion}
+
+完成本次实验，需要提交一份实验报告、一份程序源代码和一分程序输出日志。
+程序源代码中用户添加的代码需要有详细的注释说明。
+
+\begin{enumerate}
+ \item （20分）在规定时间内完成实验，并提交实验成果；
+ \item （40分）实验报告中有详细的路由逻辑设计分析与实现说明；
+ \item （10分）程序正常运行，测试主机可以ping通或抓包接收到对端报文；
+ \item （10分）ARP请求与响应功能正常工作；
+ \item （10分）测试主机可以ping通路由器端口的IP地址；
+ \item （10分）实验报告与源代码内容完整、格式整洁。
+\end{enumerate}
diff --git a/data/ch_router-openbox/sec_switch.tex b/data/ch_router-openbox/sec_switch.tex
new file mode 100644
index 0000000..4e9a3cf
--- /dev/null
+++ b/data/ch_router-openbox/sec_switch.tex
@@ -0,0 +1,279 @@
+%# -*- coding: utf-8-unix -*-
+
+\section{二层交换机实现}
+\label{sec:c:router-ob:s:switch}
+
+\subsection{实验目的}
+\label{subsec:c:router-ob:s:switch_object}
+
+本实验的主要目的是让学生掌握可编程网络平台的二层以太网数据收发方法，
+熟悉二层以太网帧的数据结构，掌握MAC地址的解析与使用。
+熟悉二层交换机的分组交换原理、
+设计完成二层交换的分组处理流程和转发表的老化功能与处理方法。
+
+\subsection{实验内容}
+\label{subsec:c:router-ob:s:switch_content}
+
+使用可编程网络平台及二层交换机示例框架源码，
+设计完成一个二层以太网交换机原型系统。主要完成以下内容：
+
+\begin{enumerate}
+ \item \textbf{平台使用与验证：}掌握可编程网络平台及示例开发代码的修改、
+ 编译和运行操作，验证系统自带二层交换机的功能；
+ \item \textbf{逻辑设计与实现：}设计满足二层交换功能的分组处理流程和逻辑，
+ 如源MAC学习功能、目的MAC查表功能、
+ 端口输出（单播与泛洪）功能和MAC转发表老化功能；
+ \item \textbf{功能调试与验证：}验证自己开发的二层交换机功能，
+ 是否满足各端口间相互通信功能；
+\end{enumerate}
+
+\subsection{实验原理、方法和手段}
+\label{subsec:c:router-ob:s:switch_principle}
+
+\subsubsection{平台基本使用}
+
+请参考附录\ref{app:openbox}：《可编程网络平台－操作手册》完成。
+
+\subsubsection{二层交换工作原理}
+
+二层交换机工作于OSI模型的第2层（数据链路层），
+可以识别数据帧中的源MAC地址与输入端口信息，
+并将这些MAC地址与对应的端口记录在自己内部的一个地址表（交换表）中。
+然后根据目的MAC地址进行交换表的查找，获得目的MAC的输出端口，然后进行转发。
+根据目的MAC地址的不同转发方式还分为单端口转发、多端口转发和泛洪转发。
+
+\subsubsection{二层交换分组处理流程}
+
+\begin{enumerate}
+ \item \textbf{源MAC学习：}当交换机从某个端口收到一个数据帧，
+ 它先读取包头中的源MAC地址和输入端口号，
+ 这样就知道源MAC地址的机器是连在交换机的哪个端口上。
+ 以此做为MAC转发表的核心数据结构，学习或更新到转发表中；
+ \item \textbf{目的MAC查表：}读取数据帧头中的目的MAC地址，
+ 并在MAC转发表中查找，找到相同MAC的匹配项后，
+ 获取该表项相应的端口信息（返回-1表示查表不命中）；
+ \item \textbf{转发输出：}根据目的MAC的查表结果，判断输出端口号，
+ 若端口号为-1，表示查不到目的MAC表项，则进行泛洪转发；
+ 否则把数据帧直接复制到查表返回的端口上进行转发；
+ \item \textbf{MAC表老化：}每次源MAC学习时都更新该MAC表项的使用时间；
+ 单独启动一个线程，逐项比较MAC表项的最新使用时间与系统当前时间的差值，
+ 如果超过指定老化时长（如3分钟）则将该表项删除。
+ 表项删除可将其有效位置无效，提高处理效率。
+\end{enumerate}
+
+\subsubsection{实验方法及手段}
+
+可编程网络平台提供了完整软硬件开发环境和网络功能
+（交换或路由等）的示例应用程序及相应框架源代码。
+学生使用挖空了部分逻辑功能的示例框架源码版本完成网络功能的设计与调试工作。
+
+\subsection{实验条件}
+\label{subsec:c:router-ob:s:switch_requirement}
+
+\begin{itemize}
+ \item 可编程网络平台一台，交换测试主机两台，
+ 连接拓扑及网络配置如上图\ref{fig:c:router-ob_switch-topo}所示；
+ \item 串口线一根，网线两根；
+ \item 网络创新实验平台使用手册和二层交换机框架源代码
+ （开发环境与编译工具系统自带）。
+\end{itemize}
+
+\begin{figure}[!ht]
+ \centering
+ \includegraphics[width=8cm]{switch-topo}
+ \caption{二层交换机实验拓扑图}
+ \label{fig:c:router-ob_switch-topo}
+ \end{figure}
+
+\subsection{实验步骤}
+\label{subsec:c:router-ob:s:switch_procedure}
+
+\subsubsection{平台搭建与系统交换验证}
+
+\begin{enumerate}
+ \item 参考附件《可编程网络平台－操作手册》搭建可编程网络平台的运行环境；
+ \item 在串口登录界面输入如下命令，启动系统自带二层交换机命令。
+ 系统输出如下信息说明已正常启动且进入工作模式；
+ \begin{code}[console]
+ root@HNXS-FAST:/mnt/openbox# l2switch
+ fastU->REG Version:20180827,OpenBox HW Version:2030200722
+ FAST UA REG->from pid:902,state:21,mid:129
+ fastU->Register UA to FAST Kernel! Wait Reply......
+ fastU->UA->pid:902,mid:129,Register OK!
+ fastU->libua version:20180827
+ Create nm08_mac_aging thread OK!
+ aging[0]->invalid mac:0
+ fastU->fast_ua_recv......
+ ID PORT0 PORT1 PORT2 PORT3
+ 0 . . . .
+ aging[1]->invalid mac:0
+ ID PORT0 PORT1 PORT2 PORT3
+ 0 . . . .
+ aging[2]->invalid mac:0
+ \end{code}
+\end{enumerate}
+
+\subsubsection{设计开发二层交换机}
+
+\begin{enumerate}
+ \item 阅读二层交换机框架源代码文件，
+ 根据二层交换工作原理及分组处理流程设计完成框架源代码中的TODO部分内容；
+ \begin{code}[console]
+ root@HNXS-FAST:/# cd /home/hnxs/l2switch/
+ root@HNXS-FAST:/home/hnxs/l2switch# vim main_l2switch.c
+ \end{code}
+
+ 以下为main\_l2switch.c文件的具体内容
+ \begin{code}[c]
+ /**
+ * @brief
+ *
+ * @param inport
+ * @param src_mac
+ */
+ /*地址学习过程，将报文的源MAC学习到对应端口MAC表中*/
+ void learn_smac(u8 inport,u8 *src_mac)
+ {
+ /*更新之前查找空白存储MAC位置*/
+ int i = 0,j = -1;
+ xprintf("learn_smac->\n");
+ //TODO User add code
+ xprintf("learn_smac->add new MAC,port:%d,index:%d\n",inport,j);
+ }
+ \end{code}
+
+ 上述框架代码需要实现的主要功能是源MAC地址的学习，
+ 参数输入为分组数据的输入端口号和源MAC地址的指针。
+ 通过对系统MAC转发表的查找，判断原MAC转发表中是否存在该表项，
+ 若存在，则更新该表项的使用时间；
+ 若不存在，则找一个空闲的表项位置存储该条表项，并更新表项使用时间。
+
+ \item 编译自己的二层交换机源码，生成相应的交换机系统命令user\_l2switch；
+ \begin{code}[console]
+ root@HNXS-FAST:/home/hnxs/l2switch# make
+ gcc –o user_l2switch main_l2switch –lreg –lrule –lua -lthread
+ root@HNXS-FAST:/home/hnxs/l2switch# ls
+ main_l2switch.c Makefile user_l2switch
+ \end{code}
+ user\_l2switch为用户代码编译输出的可执行文件。
+\end{enumerate}
+
+\subsubsection{调试与验证}
+
+\begin{enumerate}
+ \item 运行自己的二层交换机代码，验证交换机的功能；
+
+ \begin{code}[console]
+ root@HNXS-FAST:/home/hnxs/l2switch# ./user_l2switch
+ fastU->REG Version:20180827,OpenBox HW Version:2030200722
+ FAST UA REG->from pid:902,state:21,mid:129
+ fastU->Register UA to FAST Kernel! Wait Reply......
+ fastU->UA->pid:902,mid:129,Register OK!
+ fastU->libua version:20180827
+ Create nm08_mac_aging thread OK!
+ aging[0]->invalid mac:0
+ fastU->fast_ua_recv......
+ 后面打印以学生代码为准……
+ \end{code}
+ 运行当前目录下用户的可执行文件，必须在前面加上”./”
+
+ \item 二层交换机正常工作后，可以显示如下信息；
+ \begin{code}[console]
+ root@HNXS-FAST:/mnt/openbox# l2switch
+ fastU->REG Version:20180827,OpenBox HW Version:2030200722
+ FAST UA REG->from pid:902,state:21,mid:129
+ fastU->Register UA to FAST Kernel! Wait Reply......
+ fastU->UA->pid:902,mid:129,Register OK!
+ fastU->libua version:20180827
+ Create nm08_mac_aging thread OK!
+ aging[0]->invalid mac:0
+ fastU->fast_ua_recv......
+ inport:0,dstmid:129,len:102,dmac:33:33:00:00:00:02,
+ smac:B8:27:EB:04:FC:F0
+ learn_smac->
+ update_mac_time->port:0,index:0
+ learn_smac->add new MAC,port:0,index:0
+ find_dmac->ret = -1
+ ------pkt_send_flood------
+ pkt_send_normal->0xb4c00468,outport:1,len:102
+ pkt_send_normal->0xb4c00468,outport:2,len:102
+ pkt_send_normal->0xb4c00468,outport:3,len:102
+ ID PORT0 PORT1 PORT2 PORT3
+ 0 B8:27:EB:04:FC:F0 B8:27:EB:76:8F:DA . .
+ 1 . . . .
+ \end{code}
+ \begin{itemize}
+ \item 有端口接收到报文，显示输入端口及源目的MAC地址内容
+ \begin{code}[text]
+ inport:0,dstmid:129,len:102,dmac:33:33:00:00:00:02,
+ smac:B8:27:EB:04:FC:F0
+ \end{code}
+ \item 进入源MAC学习阶段，并更新MAC时间
+ \begin{code}[text]
+ learn_smac->
+ update_mac_time->port:0,index:0
+ learn_smac->add new MAC,port:0,index:0
+ \end{code}
+ \item 进入目的MAC查表阶段，输出查表结果
+ \begin{code}[text]
+ find_dmac->ret = -1
+ \end{code}
+ \item 进行报文转发
+ \begin{code}[text]
+ //泛洪发送
+ ------pkt_send_flood------
+ pkt_send_normal->0xb4c00468,outport:1,len:102
+ pkt_send_normal->0xb4c00468,outport:2,len:102
+ pkt_send_normal->0xb4c00468,outport:3,len:102
+ //单播发送
+ pkt_send_normal->0xb4c00468,outport:3,len:102
+ \end{code}
+ \item 实时输出端口MAC地址信息，如下表示在端口0和端口1上分别学习到了两个MAC地址信息
+ \begin{code}[text]
+ ID PORT0 PORT1 PORT2 PORT3
+ 0 B8:27:EB:04:FC:F0 B8:27:EB:76:8F:DA . .
+ 1 . . . .
+ \end{code}
+ \end{itemize}
+
+ \item 交换机工作不正确时，开启xprintf函数打印调试；
+ 重返步骤3，仔细阅读二层交换框架代码、交换机的工作原理及分组处理流程；
+
+ \item 交换机正常工作后，尝试不断切换连两根网线连接交换机的端口，
+ 观察测试主机的ping丢包，观察交换机工作界面的输出显示。
+\end{enumerate}
+
+\subsection{思考题}
+\label{subsec:c:router-ob:s:switch_rethink}
+
+\begin{enumerate}
+ \item 交换机区分IPv4和IPv6协议吗？区分TCP和UDP吗？
+ \item 广播风暴（broadcast storm）是如何产生的？如何避免？
+ 在不同的应用环境中分别采取的什么方法？
+ \item 广播与组播报文如何判断？组播报文如何转发？
+ \item MAC转发表的老化时间与哪些因素相关？网络规模、MAC表项大小？
+\end{enumerate}
+
+\subsection{注意事项及有关说明}
+\label{subsec:c:router-ob:s:switch_notice}
+
+\begin{enumerate}
+ \item 可编程网络平台的使用手册需要仔细阅读，严格参照文档说明搭建和运行该平台系统；
+ \item 代码修改若不习惯vim命令，可将其文件通过网络方式下载到自己电脑，编辑修改完成后，再上传到实验平台进行验证。Windows平台的上传下载工具为pscp.exe；
+ \item 二层交换机框架代码只完成了基本的二层数据收发功能，交换机的其他功能逻辑需要自己完成，注意一定要紧扣二层交换机的实验原理完成；
+ \item 系统命令运行直接输入命令名称，当前目录的可执行文件运行需要在前面加上“./”。
+\end{enumerate}
+
+\subsection{考核方法}
+\label{subsec:c:router-ob:s:switch_criterion}
+
+完成本次实验，需要提交一份实验报告、一份程序源代码和一分程序输出日志。
+程序源代码中用户添加的代码需要有详细的注释说明。
+\begin{enumerate}
+ \item （20分）在规定时间内完成实验，并提交实验成果；
+ \item （40分）实验报告中有详细的交换逻辑设计分析与实现说明；
+ \item （10分）程序正常运行，测试主机可以ping通或抓包接收到对端报文；
+ \item （10分）MAC转发表在设定时间后可以老化；
+ \item （10分）测试主机切换端口连接后仍能ping通；
+ \item （10分）实验报告与源代码内容完整、格式整洁。
+\end{enumerate}
diff --git a/data/ch_sdn-openbox/preface.tex b/data/ch_sdn-openbox/preface.tex
new file mode 100644
index 0000000..a923b63
--- /dev/null
+++ b/data/ch_sdn-openbox/preface.tex
@@ -0,0 +1,11 @@
+%# -*- coding: utf-8-unix -*-
+
+\chapter{软件定义网络与网络测量}
+\label{chap:sdn-ob}
+
+本单元实验使学生能初步使用SDN平台进行网络功能的设计与实现，
+通过实验来掌握OpenFlow协议的基本功能与应用，
+以及网络拓扑构建的基本实现。初步掌握网络测试的常用原理及方法，
+了解在测试过程中影响测量精度的原因及如何提高测量精度。
+能通过实验理解软硬件协同测量的方法与特点。
+
diff --git a/data/ch_sdn-openbox/sec_ns.tex b/data/ch_sdn-openbox/sec_ns.tex
new file mode 100644
index 0000000..2ef32f8
--- /dev/null
+++ b/data/ch_sdn-openbox/sec_ns.tex
@@ -0,0 +1,229 @@
+%# -*- coding: utf-8-unix -*-
+
+\section{纳秒级高精度硬件测量}
+\label{sec:c:sdn-ob:s:ns}
+
+\subsection{实验目的}
+\label{subsec:c:sdn-ob:s:ns_object}
+
+本实验的主要目的是让学生掌握网络测试的常用原理及方法，
+了解在测试过程中影响测量精度的原因及如何提高测量精度。
+了解软硬件结果的测量方法与优势。
+
+\subsection{实验内容}
+\label{subsec:c:sdn-ob:s:ns_content}
+
+使用可编程网络平台及用户应用AMS（自动测量系统）软件源代码，
+对网络远端的服务器进行RTT延时测量和带宽测量，
+测量不同长度网线的数据传输时长。主要完成以下内容：
+
+\begin{enumerate}
+ \item 测量RTT时长：使用AMS软件测量一台校园网内服务器的RTT时间，
+ 测量报文使用ping协议文本；
+ \item 测量带宽：在测量网络中添加一台可编程网络平台，
+ 配置为带宽响应测量模式，测量这两个节点之间的实时网络流量，
+ 并用不同测量报文大小来验证测量结果；
+ \item 测量网线时延：测量不同长度网线的数据传输时延，
+ 根据测量结果分析本系统的测量优势与局限；
+ \item 添加软件计时测量：修改测量报文代码，
+ 在开始发送时取系统时间做为软件发送时间，
+ 在接收到报文后为每个报文设置系统接收时间，计算软件的RTT时间。
+\end{enumerate}
+
+\subsection{实验原理、方法和手段}
+\label{subsec:c:sdn-ob:s:ns_principle}
+
+\subsubsection{测量原理}
+网络测量主要是通过时间和数据量相关和相对的关系来反映网络中的各种特性，
+如带宽、延时、抖动和丢包等。
+
+网络测量的分类标准有多种。根据测量的方式分为：
+主动测量和被动测量；根据测量点的多少分为：单点测量与多点测量；
+根据被测量者知情与否分为：协作式测量与非协作式测量；
+根据测量所采用的协议分为：基于BGP协议的测量、
+基于TCP/IP协议的测量以及基于SNMP协议的测量；
+根据测量的内容分为：拓扑测量与性能测量。
+\subsubsection{可编程网络平台的测量特征}
+
+本实验的测量最主要方法是由软件构造测量报文和设定发送报文的时刻表，
+由硬件在指定时间进行报文发送，并在接收获得回应报文后标记硬件的接收时刻。
+接收数据由软件汇总统计计数，与原发送数据进行时间关联，
+计算测量结果。硬件的时间控制精度为8ns，
+故测量数据的收发时间均控制在8ns误差范围内。
+根据时间的精准控制，扩展出硬件背靠背发包测试网络带宽，
+精准周期发包测量精准抖动。
+
+\subsubsection{测量流程}
+
+\begin{enumerate}
+ \item \textbf{软件构造测量报文：}根据测量要求，软件构造测量报文，
+ 报文内容由用户决定。如果测量通用服务器，可以使用ping报文；
+ \item \textbf{软件设置测量报文的发送间隔：}软件设备每个测量报文的发送间隔，
+ 间隔时间可以是零，表示硬件背靠背发送报文；
+ \item \textbf{软件发送测量报文到硬件缓存：}软件将所有测量报文构造好后，
+ 通过分组发送函数发送到硬件缓存。硬件最大缓存32个MTU为1500的分组数据；
+ \item \textbf{软件启动发送：}所有测量分组发送到硬件完成后，
+ 软件可以随时启动发送，通过写硬件状态寄存器的方式通知硬件开始发送测量报文；
+ \item \textbf{硬件根据时间参数严格输出测量报文：}
+ 硬件从开始接收到发送标记时刻开始发送第一个报文，
+ 然后根据报文携带的间隔时间，循环等待，直到下一个报文发送时刻，
+ 将该报文依次发送出去；
+ \item \textbf{硬件接收测量响应报文，标记硬件时间戳：}
+ 等待测量响应服文返回，当接收到任何响应报文后，
+ 硬件均会在报文的头部添加本址硬件时间戳信息，然后将该报文发送给软件；
+ \item \textbf{软件接收报文：}软件根据测量要求，循环接收测量响应报文，
+ 如ping 32个报文后需要接收到32个响应报文；
+ \item \textbf{软件计算测量结果：}测量响应报文接收完成后，
+ 将之前设置的测量配置参数（各报文发送间隔）、
+ 硬件开始发送报文时间戳和接收报文内的时间戳等信息汇总起来进行计算，
+ 得到测量结果后打印输出。
+\end{enumerate}
+
+\subsection{实验条件}
+\label{subsec:c:sdn-ob:s:ns_requirement}
+
+\begin{itemize}
+ \item 可编程网络平台两个，被测试服务器一台；
+ 连接拓扑如图\ref{fig:c:sdn-ob_ns-topo}所示；
+ \item 串口线一根，网线多根；
+ \item AMS软件源代码；
+\end{itemize}
+
+\begin{figure}[!ht]
+ \centering
+ \includegraphics[width=9cm]{ns-topo}
+ \caption{高精度网络测量实验拓扑图}
+ \label{fig:c:sdn-ob_ns-topo}
+\end{figure}
+
+\subsection{实验步骤}
+\label{subsec:c:sdn-ob:s:ns_procedure}
+\begin{enumerate}
+ \item 测试平台与被测量主机间的连接性，在平台\texttt{ping 192.168.1.111}；
+ \begin{code}[console]
+ root@HNXS-FAST:/home/hnxs/ams# ping 192.168.1.111
+ PING 192.168.1.111 (192.168.1.111) 56(84) bytes of data.
+ 64 bytes from 192.168.1.111: icmp_seq=1 ttl=64 time=1.57 ms
+ 64 bytes from 192.168.1.111: icmp_seq=2 ttl=64 time=1.60 ms
+ 64 bytes from 192.168.1.111: icmp_seq=3 ttl=64 time=1.74 ms
+ ^C
+ --- 192.168.1.111 ping statistics ---
+ 3 packets transmitted, 3 received, 0% packet loss, time 2003ms
+ rtt min/avg/max/mdev = 1.576/1.640/1.746/0.088 ms
+ \end{code}
+
+ \item 运行AMS测量命令，测量服务RTT的命令如下：
+ \begin{code}[console]
+ root@HNXS-FAST:/home/hnxs/ams# ams 192.168.1.111 5 70 1000000000
+ fastU->REG Version:20180827,OpenBox HW Version:2030200722
+ FAST UA REG->from pid:1068,state:21,mid:131
+ fastU->Register UA to FAST Kernel! Wait Reply......
+ fastU->UA->pid:1068,mid:131,Register OK!
+ fastU->libua version:20180827
+ fastU->librule version:20181015,Default Action:0x40000080
+ wait for ams pkts...
+ fastU->fast_ua_recv......
+ \end{code}
+ 系统输出如上信息说明AMS运行成功，并发送5个70字节大小的ping报文出去，默认间隔为1秒。等待ping响应回来。
+ \item 观察RTT测量结果
+ \begin{code}[text]
+ AMS ID PKT_SIZE TS(ns)
+ 0, 70, 1583184
+ 1, 70, 1625224
+ 2, 70, 1707240
+ 3, 70, 1492256
+ 4, 70, 1650272
+ \end{code}
+ 观察测量结果，计算结果在1.5ms左右，与之前的ping测试结果相差不大。
+
+ \item 测试两个测量平台之间的实时网络带宽
+ \begin{code}[console]
+ root@HNXS-FAST:/home/hnxs/ams# ams 192.168.1.111 5 100 0
+ fastU->REG Version:20180827,OpenBox HW Version:2030200722
+ FAST UA REG->from pid:1068,state:21,mid:131
+ fastU->Register UA to FAST Kernel! Wait Reply......
+ fastU->UA->pid:1068,mid:131,Register OK!
+ fastU->libua version:20180827
+ fastU->librule version:20181015,Default Action:0x40000080
+ wait for ams pkts...
+ fastU->fast_ua_recv......
+ \end{code}
+
+ 测试之前，要在此链路中间增加一个背景流，使用iperf的UDP流大小为600Mbps，
+ 系统给服务器发送5个100字节大小的ping报文出去，默认间隔为1秒。
+
+\item 观察带宽测试结果
+ \begin{code}[text]
+ AMS ID PKT_SIZE BW(bps)
+ 0, 70, 341467254
+ \end{code}
+ Iperf的背景流设置参数为600M时，其实际带宽会跑到648Mbps左右。
+ 链路上只有两种数据流，该测量值只是某个测量小时段的带宽反馈，
+ UDP流也存在不稳定性，故其结果相加不可能完全是1000Mbps。
+ 其相加结果与千兆带宽基本相等。
+
+\item 测量网线传输延时
+ \begin{code}[console]
+ root@HNXS-FAST:/home/hnxs/ams# ams
+ fastU->REG Version:20180827,OpenBox HW Version:2030200722
+ FAST UA REG->from pid:1068,state:21,mid:131
+ fastU->Register UA to FAST Kernel! Wait Reply......
+ fastU->UA->pid:1068,mid:131,Register OK!
+ fastU->libua version:20180827
+ fastU->librule version:20181015,Default Action:0x40000080
+ wait for ams pkts...
+ fastU->fast_ua_recv......
+ \end{code}
+
+ 网络测量时需要连接在设备的0和1号端口上，默认测量32组数据。
+
+ \item 观察网线测量结果
+ \begin{code}[text]
+ AMS ID PKT_SIZE TS(ns)
+ 0, 100, 20194
+ 1, 100, 20214
+ 2, 100, 20210
+ 3, 100, 20216
+ 4, 100, 20202
+ \end{code}
+
+ 从数据分析每组测量结果有些误差，但基本
+ \item 分析测量数据的差异
+ \begin{enumerate}
+ \item 对相同测试案例进行多组测量，观察数据变化。
+ \item 分析RTT测量时，软件计时测量与硬件计时测量的差异。
+ \end{enumerate}
+\end{enumerate}
+
+\subsection{思考题}
+\label{subsec:c:sdn-ob:s:ns_rethink}
+
+\begin{enumerate}
+ \item 硬件背靠背报文发送是什么意思？其测量的原理是什么？
+ \item 通过硬件方式测量多组延时数据，为什么仍有较大波动？
+ \item 如何测量网络的抖动？
+\end{enumerate}
+
+\subsection{注意事项及有关说明}
+\label{subsec:c:sdn-ob:s:ns_notice}
+
+\begin{enumerate}
+ \item 测量服务器的PING延时，需要修改发包内容为正确的PING报文内容。
+ \item 测量报文的间隔可以设置为零，但真正发包时的发包时刻计算却不是零，
+ 是因为硬件报文是逐个逐个发送的，且每个报文发送时间长短与其报文长度相关。
+ \item 时间计算与带宽计算中均用到了除法，引入了误差。
+ 硬件时钟本身是存在误差（时钟飘移）的，也会引入计数的误差。
+\end{enumerate}
+
+\subsection{考核方法}
+\label{subsec:c:sdn-ob:s:ns_criterion}
+
+完成本次实验，需要提交一份实验报告和一分程序输出日志。
+\begin{enumerate}
+ \item （20分）在规定时间内完成实验，并提交实验成果；
+ \item （25分）实现软件计时测量与硬件测量对比；
+ \item （25分）将多线测量结果以图形曲线形式汇总并做分析总结；
+ \item （20分）完成网络抖动测量，并做图形化汇总统计；
+ \item （10分）实验报告与源代码内容完整、格式整洁。
+\end{enumerate}
+
diff --git a/data/ch_sdn-openbox/sec_sdn.tex b/data/ch_sdn-openbox/sec_sdn.tex
new file mode 100644
index 0000000..98dca17
--- /dev/null
+++ b/data/ch_sdn-openbox/sec_sdn.tex
@@ -0,0 +1,592 @@
+%# -*- coding: utf-8-unix -*-
+
+\section{基于OpenFlow的SDN交换机}
+\label{sec:c:sdn-ob:s:sdn}
+
+\subsection{实验目的}
+\label{subsec:c:sdn-ob:s:sdn_object}
+
+本实验的主要目的是让学生了解SDN的概念及三层结构原理，
+掌握OpenFlow协议格式、内容、工作流程及对应功能作用。
+掌握SDN控制器北向API使用方法，可通过API编程获取和设置交换机数据。
+
+\subsection{实验内容}
+\label{subsec:c:sdn-ob:s:sdn_content}
+
+使用可编程网络平台及SDN交换机示例框架代码，完成OpenFlow协议的部分功能逻辑。
+验证并分析SDN交换机的工作原理与处理流程。主要完成以下内容：
+
+\begin{enumerate}
+ \item \textbf{阅读协议：}阅读OpenFlow 1.3版本协议白皮书，
+ 掌握其协议内容及对应功能；
+ \item \textbf{设计实现协议功能：}基于SDN交换机示例框架代码，
+ 选择开发OpenFlow协议的部分功能，完成逻辑设计与实现；
+ \item \textbf{验证交换机功能：}运行自己的SDN交换机，跟控制器建立连接，
+ 在控制器查询其工作状态与相关协议功能展示。
+ 如交换机基本信息描述、交换机流表状态、
+ 交换机端口状态及计数统计、网络拓扑展示效果；
+ \item \textbf{检验流表：}验证SDN交换机连接主机间的通信功能，
+ 并观察流表内容及变化情况；
+ \item \textbf{REST API应用：}使用实验提供的北向REST~API接口查询控制器，
+ 获取或设置交换机的不同功能数据；
+ \item \textbf{定义流表：}使用REST API接口修改流表内容，
+ 观察主机的通信情况是否受到影响；
+\end{enumerate}
+
+\subsection{实验原理、方法和手段}
+\label{subsec:c:sdn-ob:s:sdn_principle}
+
+\subsection{SDN交换机工作原理}
+SDN即Software Defined Network（软件定义网络），
+是一种新型网络创新架构，用于解决传统网络架构中对于网络虚拟化、
+各类自动化部署以及新型网络协议的问题。
+
+SDN将传统的紧耦合网络设备被拆分成了应用、控制、转发三层，
+其中应用和控制层面能够控制网络中数据的流向以及协议控制，
+而底层的网络设备被抽象为了可自定义的转发逻辑实体，
+可被上层应用定义为不同类型的转发设备。
+
+在应用层，用户可通过通用、简单的API获取网络信息，
+并可修改转发设备的工作逻辑，达到动态改变网络架构的目的。
+
+\subsection{SDN交换机分组处理流程}
+\begin{enumerate}
+ \item \textbf{启动协议通道：}
+ SDN交换机运行OpenFlow协议代理程序与上层控制器建立通信连接。
+ 交换机解析处理OpenFlow协议，
+ 根据协议要求完成协议功能的相关数据收集和配置功能，
+ 构造相应的OpenFlow协议应答控制器。
+
+ \item \textbf{建立连接：}OpenFlow协议代理运行时，
+ 交换机首先和控制器建立连接，
+ 并发送OFP\_HELLO消息用以确认双方都支持的OFP协议版本信息；
+ \item \textbf{查询或设置数据：}
+ 控制器通过OpenFlow的具体消息协议查询或设置交换机其他相关功能的数据，
+ 如OFPT\_HELLO、OFPT\_ECHO\_REQUEST、OFPT\_PACKET\_IN、OFPT\_PACKET\_OUT、
+ OFPT\_FLOW\_MOD、OFPT\_PORT\_MOD、OFPMP\_DESC、OFPMP\_FLOW、OFPMP\_PORT\_STATS等；
+ \item \textbf{处理转发分组：}当交换机接收到一个数据转发分组时，
+ 提取分组数据中的相关字段组成查表关键字，然后在本地进行流表匹配。
+ 如果匹配成功，则根据流表的动作处理该分组，如从其他端口转发出去；
+ 如果匹配不成功，则会命中默认动作，将分组打包送到控制器；
+ \item \textbf{PACKET\_IN分组上传：}交换机查表不命中或是接收到链路探测报文，
+ 则将该数据封装在OpenFlow的PACKET\_IN消息中，上传给控制器；
+ \item \textbf{PACKET\_OUT分组下发：}通过PACKET\_IN上传的分组，
+ 经过控制器分析处理后，会将其封装在OpenFlow协议的PACKET\_OUT消息中，
+ 并携带输出端口信息下发到交换机。交换机接收到该消息数据后，
+ 根据输出信息指示，将该分组从指定端口输出。
+ 通过PACKET\_OUT发送的分组数据还包括链路探测协议报文。
+ \item \textbf{FLOW\_MOD消息处理：}
+ 控制器通过下发FLOW\_MOD消息给交换机的流表设置转发表项内容，
+ FLOW\_MOD消息中包括分组特征元组信息和动作执行列表。
+ 特征元组通常包括常用的MAC信息、帧类型和五元组信息等，
+ 动作通常包括输出端口或丢弃信息等；
+\end{enumerate}
+
+\subsection{实验条件}
+\label{subsec:c:sdn-ob:s:sdn_requirement}
+
+\begin{itemize}
+ \item 可编程网络平台一个，交换测试主机两台，
+ SDN控制器（安装SDN控制器软件Floodlight）一台。
+ 网络配置及连接拓扑如图\ref{fig:c:sdn-ob_sdn-topo}所示；
+ \item 串口线一根，网线三根；
+ \item SDN交换机框架开发源代码、流表配置Python脚本。
+\end{itemize}
+
+\begin{figure}[!ht]
+ \centering
+ \includegraphics[width=9cm]{sdn-topo}
+ \caption{OpenFlow交换机实验拓扑图}
+ \label{fig:c:sdn-ob_sdn-topo}
+\end{figure}
+
+\subsection{实验步骤}
+\label{subsec:c:sdn-ob:s:sdn_procedure}
+
+\subsubsection{编译运行SDN交换机，验证交换机基本功能；}
+
+请参考附件\ref{app:openbox}：《可编程网络平台－操作手册》完成。
+
+\subsubsection{基于SDN交换机源码，选择实现自己的协议功能；}
+
+\begin{enumerate}
+ \item 修改源代码
+ \begin{code}[c]
+ enum ofperr handle_openflow_callback(struct ofp_buffer *ofpbuf,int len)
+ {
+ int oftype = ofpbuf->header.type;
+
+ SHOW_FUN(0);
+ LOG_DBG("ofpbuf->header.type=%d\n",ofpbuf->header.type);
+ switch(oftype)
+ {
+ case OFPT_HELLO:
+ /*用户不实现该类消息处理，则直接break，函数返回CONTINUE，
+ *由系统库完成后续处理；*/
+ break;
+ case OFPT_PACKET_OUT:
+ /*若用户想实现该消息的处理，则在此处完成对消息的功能逻辑，
+ *然后直接返回HANDLE，表示已经处理，库函数直接返回*/
+ //TO DO 用户在些添加处理逻辑，完成该消息功能
+ return HANDLE;
+ //可再增加其他OpenFlow协议的消息类型
+ }
+ return CONTINUE;
+ }
+ \end{code}
+ 用户可以根据自己能力选择实现OpenFlow协议的部分消息功能，
+ 一旦处理了该消息，一定要返回HANDLE，否则直接break即可。
+ \item 编译源代码
+ \begin{code}[console]
+ root@HNXS-FAST:/home/hnxs/sdn# make
+ gcc –o user_openflow –l reg –l ua –l rule –l ofp -lpthread
+ root@HNXS-FAST:/home/hnxs/sdn# ls
+ main_openflow.c Makefile user_openflow
+ root@HNXS-FAST:/home/hnxs/sdn#
+ \end{code}
+\end{enumerate}
+
+\subsubsection{运行修改后的交换机，再次验证SDN交换机的功能；}
+\begin{enumerate}
+ \item 运行SDN交换机，交换机正常工作后输出如下；
+ \begin{code}[console]
+ root@HNXS-FAST:/home/hnxs/sdn# ./ user_openflow -4 192.168.1.3 -i obx0,obx1,obx2,obx3
+ fastU->REG Version:20180827,OpenBox HW Version:2030200722
+ port_name:eth0,port:0
+ port_name:obx0,port:0
+ xofp uses obsolete (PF_INET,SOCK_PACKET)
+ port_name:obx1,port:1
+ port_name:obx2,port:2
+ port_name:obx3,port:3
+ fastU->librule version:20181015,Default Action:0x40000080
+ xofp)Connect to SDN Controller [ 192.168.1.3:6653 ] OK!
+ 0_nms_of13)DELETE ALL RULE!
+ eth0 ADD!
+ obx0 ADD!
+ obx1 ADD!
+ obx2 ADD!
+ obx0(0x29008) Start...
+ obx2(0x2e100) Start...
+ obx3(0x30958) Start...
+ obx1(0x2b890) Start...
+ obx3 ADD!
+ \end{code}
+
+ \item 查看控制器界面基本信息，
+ 在浏览器打开控制器WEB网站\url{http://192.168.1.3/ui/index.html}，
+ 控制界面如图\ref{fig:c:sdn-ob_sdn-switch}所示：
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=14cm]{sdn-switch}
+ \caption{SDN交换机信息}
+ \label{fig:c:sdn-ob_sdn-switch}
+ \end{figure}
+
+ \item 查看连接测试主机信息，
+ SDN主机及连接信息如图\ref{fig:c:sdn-ob_sdn-host}所示：
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=14cm]{sdn-host}
+ \caption{SDN主机信息}
+ \label{fig:c:sdn-ob_sdn-host}
+ \end{figure}
+
+ \item 查看端口状态与计数信息与流表信息，
+ 端口状态与流表计数信息如图\ref{fig:c:sdn-ob_port-flowtable}所示：
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=14cm]{port-flowtable}
+ \caption{端口状态与流表计数信息}
+ \label{fig:c:sdn-ob_port-flowtable}
+ \end{figure}
+
+ \item 查看网络拓扑信息，如图\ref{fig:c:sdn-ob_sdn-test-topo}所示：
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=14cm]{sdn-test-topo}
+ \caption{SDN网络拓扑信息}
+ \label{fig:c:sdn-ob_sdn-test-topo}
+ \end{figure}
+\end{enumerate}
+
+\subsubsection{在测试主机ping的前后，分别观察流表变化；}
+\begin{enumerate}
+ \item ping之前的流表信息（使用REST API方式获取其json数据），
+ 如图\ref{fig:c:sdn-ob_empty-flowtable}所示：
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=14cm]{empty-flowtable}
+ \caption{空流表信息}
+ \label{fig:c:sdn-ob_empty-flowtable}
+ \end{figure}
+
+ \item ping之后的流表信息，如图\ref{fig:c:sdn-ob_flowtable-ping}所示：
+ \begin{figure}[!htp]
+ \centering
+ \includegraphics[width=14cm]{flowtable-ping}
+ \caption{ping通后流表信息}
+ \label{fig:c:sdn-ob_flowtable-ping}
+ \end{figure}
+ Ping通之后在SDN交换机的流表里多了4条转发流表，
+ 分别是两个方向的ARP应答报文转发表和两个方向的IP报文转发表
+ （具体内容在后面的REST~API数据中查验）。
+ 由此可以说明：控制器向SDN交换机注入了四条转发流表，才让两边的主机ping通了。
+\end{enumerate}
+
+\subsubsection{使用REST API接口查询交换机的相关功能数据；}
+\begin{enumerate}
+ \item 查询交换机基本信息
+ \begin{code}[console]
+ # curl http://192.168.1.3:8080/wm/core/switch/\
+ 00:00:00:0a:00:00:08:01/desc/json
+ \end{code}
+ \begin{code}[json]
+ {
+ "desc": {
+ "version": "OF_13",
+ "manufacturer_description": "HuNan XinShi NetWork",
+ "hardware_description": "OpenBox HW 2017",
+ "software_description": "OpenBox Driver 1.0.0",
+ "serial_number": "None",
+ "datapath_description": "None"
+ }
+ }
+ \end{code}
+ \item 查询端口计数信息
+ \begin{code}[console]
+ # curl http://192.168.1.3:8080/wm/core/switch/\
+ 00:00:00:0a:00:00:08:01/port/json
+ \end{code}
+ \begin{code}[json]
+ {
+ "port_reply": [{
+ "version": "OF_13",
+ "port": [{
+ "port_number": "local",
+ "receive_packets": "10957",
+ "transmit_packets": "1180",
+ "receive_bytes": "592738",
+ "transmit_bytes": "143898",
+ "receive_dropped": "0",
+ "transmit_dropped": "0",
+ "receive_errors": "0",
+ "transmit_errors": "0",
+ "receive_frame_errors": "0",
+ "receive_overrun_errors": "0",
+ "receive_CRC_errors": "0",
+ "collisions": "0",
+ "duration_sec": "4294966827",
+ "duration_nsec": "573987"
+ }, {
+ "port_number": "1",
+ "receive_packets": "86",
+ "transmit_packets": "205",
+ "receive_bytes": "11427",
+ "transmit_bytes": "22632",
+ "receive_dropped": "0",
+ "transmit_dropped": "0",
+ "receive_errors": "0",
+ "transmit_errors": "0",
+ "receive_frame_errors": "0",
+ "receive_overrun_errors": "0",
+ "receive_CRC_errors": "0",
+ "collisions": "0",
+ "duration_sec": "4294966827",
+ "duration_nsec": "573991"
+ }, {
+ "port_number": "2",
+ "receive_packets": "0",
+ "transmit_packets": "0",
+ "receive_bytes": "0",
+ "transmit_bytes": "0",
+ "receive_dropped": "0",
+ "transmit_dropped": "0",
+ "receive_errors": "0",
+ "transmit_errors": "0",
+ "receive_frame_errors": "0",
+ "receive_overrun_errors": "0",
+ "receive_CRC_errors": "0",
+ "collisions": "0",
+ "duration_sec": "4294966827",
+ "duration_nsec": "573992"
+ }, {
+ "port_number": "3",
+ "receive_packets": "616",
+ "transmit_packets": "220",
+ "receive_bytes": "56948",
+ "transmit_bytes": "24659",
+ "receive_dropped": "0",
+ "transmit_dropped": "0",
+ "receive_errors": "0",
+ "transmit_errors": "0",
+ "receive_frame_errors": "0",
+ "receive_overrun_errors": "0",
+ "receive_CRC_errors": "0",
+ "collisions": "0",
+ "duration_sec": "4294966827",
+ "duration_nsec": "573994"
+ }, {
+ "port_number": "4",
+ "receive_packets": "0",
+ "transmit_packets": "0",
+ "receive_bytes": "0",
+ "transmit_bytes": "0",
+ "receive_dropped": "0",
+ "transmit_dropped": "0",
+ "receive_errors": "0",
+ "transmit_errors": "0",
+ "receive_frame_errors": "0",
+ "receive_overrun_errors": "0",
+ "receive_CRC_errors": "0",
+ "collisions": "0",
+ "duration_sec": "4294966827",
+ "duration_nsec": "573995"
+ }]
+ }]
+ }
+ \end{code}
+ \item 查询交换机流表信息
+ \begin{code}[console]
+ # curl http://192.168.1.3:8080/wm/core/switch/\
+ 00:00:00:0a:00:00:08:01/flow/json
+ \end{code}
+ \begin{code}[json]
+ {
+ "flows": [{
+ "version": "OF_13",
+ "cookie": "9007199254740992",
+ "table_id": "0x0",
+ "packet_count": "5",
+ "byte_count": "571392",
+ "duration_sec": "0",
+ "duration_nsec": "0",
+ "priority": "1",
+ "idle_timeout_s": "5",
+ "hard_timeout_s": "0",
+ "flags": [],
+ "match": {
+ "in_port": "1",
+ "eth_dst": "b8:27:eb:c1:d1:39",
+ "eth_src": "b8:27:eb:d8:83:20",
+ "eth_type": "0x806"
+ },
+ "instructions": {
+ "instruction_apply_actions": {
+ "actions": "output=3"
+ }
+ }
+ }, {
+ "version": "OF_13",
+ "cookie": "9007199271518208",
+ "table_id": "0x0",
+ "packet_count": "162",
+ "byte_count": "571400",
+ "duration_sec": "0",
+ "duration_nsec": "0",
+ "priority": "1",
+ "idle_timeout_s": "5",
+ "hard_timeout_s": "0",
+ "flags": [],
+ "match": {
+ "in_port": "3",
+ "eth_dst": "b8:27:eb:d8:83:20",
+ "eth_src": "b8:27:eb:c1:d1:39",
+ "eth_type": "0x800",
+ "ipv4_src": "192.168.2.119",
+ "ipv4_dst": "192.168.2.111"
+ },
+ "instructions": {
+ "instruction_apply_actions": {
+ "actions": "output=1"
+ }
+ }
+ }, {
+ "version": "OF_13",
+ "cookie": "9007199288295424",
+ "table_id": "0x0",
+ "packet_count": "161",
+ "byte_count": "571408",
+ "duration_sec": "0",
+ "duration_nsec": "0",
+ "priority": "1",
+ "idle_timeout_s": "5",
+ "hard_timeout_s": "0",
+ "flags": [],
+ "match": {
+ "in_port": "1",
+ "eth_dst": "b8:27:eb:c1:d1:39",
+ "eth_src": "b8:27:eb:d8:83:20",
+ "eth_type": "0x800",
+ "ipv4_src": "192.168.2.111",
+ "ipv4_dst": "192.168.2.119"
+ },
+ "instructions": {
+ "instruction_apply_actions": {
+ "actions": "output=3"
+ }
+ }
+ }, {
+ "version": "OF_13",
+ "cookie": "9007199305072640",
+ "table_id": "0x0",
+ "packet_count": "2",
+ "byte_count": "571416",
+ "duration_sec": "0",
+ "duration_nsec": "0",
+ "priority": "1",
+ "idle_timeout_s": "5",
+ "hard_timeout_s": "0",
+ "flags": [],
+ "match": {
+ "in_port": "3",
+ "eth_dst": "b8:27:eb:d8:83:20",
+ "eth_src": "b8:27:eb:c1:d1:39",
+ "eth_type": "0x806"
+ },
+ "instructions": {
+ "instruction_apply_actions": {
+ "actions": "output=1"
+ }
+ }
+ }]
+ }
+ \end{code}
+\end{enumerate}
+
+\subsubsection*{修改Python脚本，手动配置流表，观察测试主机的通信变化；}
+
+\begin{enumerate}
+ \item 修改流表脚本，使其转发端口错误
+ \begin{code}[console]
+ #vim openflow_flow-test.py
+ \end{code}
+ \begin{code}[python]
+ import httplib
+ import json
+
+ class StaticFlowPusher(object):
+ def __init__(self, server):
+ self.server = server
+
+ def get(self, data):
+ ret = self.rest_call({}, 'GET')
+ return json.loads(ret[2])
+
+ def set(self, data):
+ ret = self.rest_call(data, 'POST')
+ return ret[0] == 200
+
+ def remove(self, objtype, data):
+ ret = self.rest_call(data, 'DELETE')
+ return ret[0] == 200
+
+ def rest_call(self, data, action):
+ path = '/wm/staticflowpusher/json'
+ headers = {
+ 'Content-type': 'application/json',
+ 'Accept': 'application/json',
+ }
+ body = json.dumps(data)
+ conn = httplib.HTTPConnection(self.server, 8080)
+ conn.request(action, path, body, headers)
+ response = conn.getresponse()
+ ret = (response.status, response.reason, response.read())
+ print ret
+ conn.close()
+ return ret
+
+ pusher = StaticFlowPusher('192.168.1.3')
+
+ flowbe0 = {
+ 'switch':"00:00:00:0a:00:00:08:01",
+ "table":"0",
+ "name":"flow-0",
+ "cookie":"60",
+ "priority":"1",
+ "active":"true",
+ "eth_dst":" b8:27:eb:c1:d1:39", #dmac
+ "eth_src":" b8:27:eb:d8:83:20", #smac
+ "eth_type":"0x800", #type
+ #"ip_proto":"0x11", #proto
+ "in_port":"1", #inport
+ "ipv4_src":"192.168.2.111", #sip
+ "ipv4_dst":"192.168.2.119", #dip
+ #"tp_src":"50001", #sport
+ #"tp_dst":"50001", #dport
+ "actions":"output=2" #正确值应该为3
+ }
+ flowbe1 = {
+ 'switch':"00:00:00:0a:00:00:08:01",
+ "table":"1",
+ "name":"flow-1",
+ "cookie":"61",
+ "priority":"1",
+ "active":"true",
+ "eth_dst":"b8:27:eb:d8:83:20", #dmac
+ "eth_src":"b8:27:eb:c1:d1:39", #smac
+ "eth_type":"0x800", #type
+ #"ip_proto":"0x11", #proto
+ "in_port":"3", #inport
+ "ipv4_src":"192.168.2.119", #sip
+ "ipv4_dst":"192.168.2.111", #dip
+ #"tp_src":"50001", #sport
+ #"tp_dst":"50001", #dport
+ "actions":"output=2" #正确值应该为1
+ }
+
+ pusher.set(flowbe0)
+ pusher.set(flowbe1)
+ \end{code}
+
+ 脚本执行命令如下：
+ \begin{code}[console]
+ # python openflow_flow-test.py
+ (200, 'OK', '{"status" : "Entry pushed"}')
+ (200, 'OK', '{"status" : "Entry pushed"}')
+ \end{code}
+
+ 脚本执行成功，两条流表添加成功，在测试主机两边进行ping测试，
+ 是否发现已经ping不通了？
+ \item 修改流表脚本，使其转发端口正确，再次验证；
+ \begin{enumerate}
+ \item 两种动作分别修改为：1进3出和3进1出。
+ 添加流表后，再重新ping测试，是否发现又可以ping通了？
+ \item 由此说明：对于SDN交换机，
+ 可以通过用户修改流表的方式来定义某一条具体流的转发行为。
+ \end{enumerate}
+\end{enumerate}
+
+\subsection{思考题}
+\label{subsec:c:sdn-ob:s:sdn_rethink}
+
+\begin{enumerate}
+ \item WEB界面上显示的转发流表是如何生成的？分析其生成流程；
+ \item 测试主机第一次ping通的数据处理流程与第二次ping通的数据处理流程有何不同？
+ \item 控制器界面的拓扑图是如何生成的？需要哪些数据？
+\end{enumerate}
+
+\subsection{注意事项及有关说明}
+\label{subsec:c:sdn-ob:s:sdn_notice}
+
+\begin{enumerate}
+ \item SDN控制器为JAVA实现，有时候WEB存在缓存，
+ 导致数据显示不及时，在流表更新显示（两次实验对比）时，
+ 先清空历史缓存数据后再显示。
+ \item Python脚本为一个http协议的客户端脚本程序，
+ 通过http协议及REST API的路径请求或设置SDN控制器WEB的对应功能模块，
+ 获取或设置该模块的返回数据或输入参数，传输数据类型为json格式。
+\end{enumerate}
+
+\subsection{考核方法}
+\label{subsec:c:sdn-ob:s:sdn_criterion}
+
+完成本次实验，需要提交一份实验报告和一分程序输出日志。
+\begin{enumerate}
+ \item （20分）在规定时间内完成实验，并提交实验成果；
+ \item （40分）根据实现OpenFlow消息类型的多少分计分，简单类型5分，复杂类型10分；
+ \item （20分）通过脚本设置可以实现两个测试主机ping能和不能ping通；
+ \item （20分）通过网上搜索学习，
+ 使用其他多个REST~API查询到了交换机更多的数据内容；
+ \item （10分）实验报告与源代码内容完整、格式整洁。
+\end{enumerate}
+
diff --git a/data/ch_sdn-openbox/sec_topo.tex b/data/ch_sdn-openbox/sec_topo.tex
new file mode 100644
index 0000000..184f9b5
--- /dev/null
+++ b/data/ch_sdn-openbox/sec_topo.tex
@@ -0,0 +1,173 @@
+%# -*- coding: utf-8-unix -*-
+
+\section{基于OpenFlow的拓扑测量}
+\label{sec:c:sdn-ob:s:topo}
+
+\subsection{实验目的}
+\label{subsec:c:sdn-ob:s:topo_object}
+
+本实验的主要目的是让学生了解OpenFlow协议中PACKET\_IN和链路探测协议
+（LLDP）的工作原理和网络拓扑构建方法。
+
+\subsection{实验内容}
+\label{subsec:c:sdn-ob:s:topo_content}
+
+使用可编程网络平台及SDN交换机源码，分析LLDP的工作原理。
+通过PACKET\_IN消息收集网络设备节点信息。
+掌握网络拓扑的构建方法。主要完成以下内容：
+
+\begin{enumerate}
+ \item \textbf{打印连接主机信息：}基于SDN交换机源码，
+ 在端口分组接收回调函数中添加相关逻辑，
+ 解析输入分组数据，提取设备MAC与IP信息，打印显示其内容；
+ \item \textbf{打印接收LLDP消息：}基于SDN交换机源码，
+ 在端口分组接收回调函数中添加相关逻辑，
+ 解析输入分组数据，打印LLDP分组的相关协议字段；
+ \item \textbf{打印发送LLDP消息：}基于SDN交换机源码，
+ 在OpenFlow协议回调函数中添加相关逻辑，
+ 提取SDN控制器下发的PACKET\_OUT消息，且消息封装的分组协议为LLDP格式；
+ 打印输出LLDP分组中的相关协议字段；
+ \item \textbf{提取控制器链路与设备信息：}
+ 使用REST~API接口获取SDN控制器的网络链路信息和设备连接信息；
+ \item \textbf{构建拓扑图：}以WEB形式展示网络拓扑结构图；
+ \item \textbf{修改网络验证：}改变物理网络拓扑结构后，
+ 重新展示学习到的网络拓扑结构图。
+\end{enumerate}
+
+\subsection{实验原理、方法和手段}
+\label{subsec:c:sdn-ob:s:topo_principle}
+
+\subsubsection{LLDP工作原理}
+
+LLDP是一个用于信息通告和获取的协议，但是需要注意的一点是，
+LLDP发送的信息通告不需要确认，不能发送一个请求来请求获取某些信息，
+也就是说LLDP是一个单向的协议，只有主动通告一种工作方式，
+无需确认，不能查询、请求。
+
+LLDP协议主要完成的功能有：初始化并维护本地MIB 库中的信息；
+从本地MIB 库中提取信息，并将信息封装到LLDP帧中。
+LLDP帧的发送有两种触发方式，一是定时器到期触发，一是设备状态发生了变化触发；
+识别并处理接收到的LLDPDU帧；维护远端设备LLDP MIB 信息库；
+当本地或远端设备MIB信息库中有信息发生变化时，发出通告事件。
+
+网络拓扑的测量是通过一些链路探测协议在各交换节点中相互收发来完成的链路的拓扑测量功能。
+SDN交换机使用LLDP链路探测协议主要是通过PACKET\_OUT消息发送LLDP分组，
+通过PACKET\_IN接收LLDP分组，通过计算获取交换机之间的连通关系和端口连接关系。
+
+\subsubsection{SDN交换机中LLDP的分组处理流程}
+\begin{enumerate}
+ \item 主动发送LLDP：
+ SDN控制器主动构造特定的LLDP报文（含交换机标记与输出端口信息），
+ 封装在OpenFlow的PACKET\_OUT方法中，从指定的交换机各端口发送出去；
+ \item 接收处理LLDP：如果端口连接的是主机，则主机会丢弃该报文，
+ 若同样是OpenFlow交换机，则会通过PACKET\_IN的方式将该LLDP报文转发给控制器；
+ \item LLDP学习：控制器收到LLDP报文后，
+ 则会学习到这两个交换机之间存在一条连接链路；
+ \item 网络设备信息学习：主机连接到交换机后，
+ 主机端会主动构造一些广播报文发送到网络上，
+ 这些报文会携带上本机的MAC地址和IP地址等信息
+ 交换机接收到主机发送报文后，在其交换流表中找不到转发表项，
+ 则会将该报文完整内容和其所输入的端口信息封装在OpenFlow协议的PACKET\_IN方法中，
+ 将报文送到SDN控制器；控制器接收到该消息后，
+ 通过学习对比发现是一台新主机入网，则会将该报文中的源MAC地址、
+ IP地址和接收交换机信息及输入端口信息等均记录在一张网络设备信息数据表中；
+ \item 构建设备连接关系：
+ 交换机之间的链路信息加上交换机与主机之间的链路信息就完整的构成了全网的拓扑连接关系。
+\end{enumerate}
+
+\subsection{实验条件}
+\label{subsec:c:sdn-ob:s:topo_requirement}
+
+\begin{itemize}
+ \item 网络创新实验平台两个，交换测试主机两台，SDN控制器一台。
+ 连接拓扑如图\ref{fig:c:sdn-ob_openflow-topo}所示；
+ \item 串口线一根，网线五根；
+ \item 网络创新实验平台使用手册、开发环境；
+ \item OpenFlow拓扑实验环境配置手册
+\end{itemize}
+
+\begin{figure}[!ht]
+ \centering
+ \includegraphics[width=10cm]{openflow-topo}
+ \caption{OpenFlow拓扑测量实验拓扑图}
+ \label{fig:c:sdn-ob_openflow-topo}
+\end{figure}
+
+\subsection{实验步骤}
+\label{subsec:c:sdn-ob:s:topo_procedure}
+
+\begin{enumerate}
+ \item 运行SDN交换机
+
+ 请参考附件《可编程网络平台－操作手册》完成。
+ \item 基于SDN交换机开源代码，在端口分组接收回调函数中添加相应逻辑；
+ \begin{code}[c]
+ int port_recv_callback(int inport,struct fast_packet *pkt,int pkt_len)
+ {
+ //解析分组字段，提取LLDP分组，并打印输出其相关协议字段
+
+ //解析分组字段，判断帧类型为0x0800，源IP为单播地址的分组，打印其源MAC地址与IP地址
+ }
+ \end{code}
+ \begin{enumerate}
+ \item 解析接收数据，判断以太网帧类型，
+ 如果帧类型为0x88CC，则说明是LLDP协议分组，根据LLDP协议打印相关协议字段内容；
+ \item 解析分组，提取输入帧类型为0x0800的分组，
+ 打印输出其源MAC地址与源IP地址（仅输出IP地址为单播类型的条目）；
+ \end{enumerate}
+ \item 编译SDN交换机，验证添加逻辑功能，观察是否正确打印需要的消息内容；
+ \item 分析端口接收回调函数中打印的消息内容；
+ \begin{enumerate}
+ \item 从LLDP分组中可解析得知对端交换机的某个端口发送到本交换机的某个端口
+ \item 从普通IPv4报文中可以获得连接到该交换机上的主机节点信息
+ （MAC地址和IPv4地址）
+ \end{enumerate}
+ \item 验证并观察SDN控制器自带的拓扑展示界面
+ \begin{enumerate}
+ \item 在控制器主机打开WEB界面，输入地址：
+ \texttt{127.0.0.1/ui/index.html}。查看浏览器界面数据；
+ \item 切换浏览器的拓扑显示版块，
+ 查看网络拓扑展示效果可以看到两台交换机中间用线连接；
+ \item 连接上一台测试主机，刷新拓扑界面，
+ 查看到界面新增了一台主机，并显示其IP地址信息；
+ \item 再连接上另一台主机，刷新拓扑界面，
+ 查看到界面又新增了一台主机，并显示其IP地址信息；
+ \item 断开两台交换机之间的网线，新拓扑界面，
+ 查看两个交换机之间的连线消失了；
+ \item 断开一台测试主机，新拓扑界面，查看其对应的主机从界面消失；
+ \end{enumerate}
+ \item 使用控制器的北向REST API接口查询网络的所有链路连接关系数据，
+ API接口为：\texttt{/wm/topology/links/json}；
+ \item 使用控制器的北向REST API接口查询全网所有设备节点信息，
+ API接口为：\texttt{/wm/device/}；
+ \item 自己开发网络拓扑展示效果图；
+ \item 修改网络拓扑后验证自己开发程序的效果。
+\end{enumerate}
+
+\subsection{思考题}
+\label{subsec:c:sdn-ob:s:topo_rethink}
+
+\begin{enumerate}
+ \item 网络拓扑中的设备节点信息学习，使用广播报文中的信息会带来哪些影响？
+ \item OpenFlow交换机之间用一台普通交换机连接，能学习到全网的拓扑结构信息吗？
+ 分析原因。
+\end{enumerate}
+
+\subsection{注意事项及有关说明}
+\label{subsec:c:sdn-ob:s:topo_notice}
+\begin{enumerate}
+ \item JAVA的WEB程序显示的缓存，每新刷新操作前，请清理浏览器历史缓存数据。
+\end{enumerate}
+
+\subsection{考核方法}
+\label{subsec:c:sdn-ob:s:topo_criterion}
+
+完成本次实验，需要提交一份实验报告和一分程序输出日志。
+\begin{enumerate}
+ \item （20分）在规定时间内完成实验，并提交实验成果；
+ \item （20分）正确打印输入与输出LLDP消息内容和连接主机信息
+ \item （20分）通过REST API编程获取链路状态信息与设备信息，并能生成拓扑关系图；
+ \item （20分）以图形界面形式展示拓扑图；
+ \item （10分）动态修改物理拓扑后，程序可以及时刷新出正确拓扑图状态；
+ \item （10分）实验报告与源代码内容完整、格式整洁。
+\end{enumerate}
diff --git a/data/chapter2/preface.tex b/data/ch_socket/preface.tex
similarity index 100%
rename from data/chapter2/preface.tex
rename to data/ch_socket/preface.tex
diff --git a/data/chapter2/section3.tex b/data/ch_socket/sec_smtp.tex
similarity index 90%
rename from data/chapter2/section3.tex
rename to data/ch_socket/sec_smtp.tex
index ecb3db5..4d43058 100644
--- a/data/chapter2/section3.tex
+++ b/data/ch_socket/sec_smtp.tex
@@ -1,23 +1,23 @@
%# -*- coding: utf-8-unix -*-
\section{SMTP客户端实现}
-\label{sec:c1_s2}
+\label{sec:c:socket:s:smtp}
\subsection{实验目的}
-\label{subsec:c2_s3_object}
+\label{subsec:c:socket:s:smtp_object}
进一步理解和掌握Python中TCP套接字编程的基础知识，
理解SMTP报文格式，了解开发一个简单应用程序的流程。
\subsection{实验内容}
-\label{subsec:c2_s3_content}
+\label{subsec:c:socket:s:smtp_content}
创建一个可以向任何接收方发送电子邮件的简单邮件客户端。
通过Python编写代码与邮件服务器创建一个TCP连接，
使用SMTP协议与邮件服务器交谈并发送邮件报文，最后关闭连接。
\subsection{实验原理、方法和手段}
-\label{subsec:c2_s3_principle}
+\label{subsec:c:socket:s:smtp_principle}
SMTP（Simple Mail Transfer Protocol）即简单邮件传输协议，
是因特网电子邮件中主要的应用层协议，它使用TCP可靠数据传输服务，
@@ -68,7 +68,7 @@ RFC5321给出了SMTP的定义。SMTP有众多出色的性质，
用一个独立的句点指示该邮件的结束，并且仅当所有邮件发送完后才发送QUIT。
\subsection{实验条件}
-\label{subsec:c2_s3_requirement}
+\label{subsec:c:socket:s:smtp_requirement}
\begin{itemize}
\item 下列装有python环境的电脑一台；
@@ -76,8 +76,14 @@ RFC5321给出了SMTP的定义。SMTP有众多出色的性质，
\item 部分代码（实验步骤中已给出）。
\end{itemize}
+参考资料：
+
+\begin{itemize}
+ \item {J.F Kurose and K.W. Ross, 计算机网络自顶向下方法（第7版）}
+\end{itemize}
+
\subsection{实验步骤}
-\label{subsec:c2_s3_procedure}
+\label{subsec:c:socket:s:smtp_procedure}
通过Python开发一个简单的SMTP客户端发送邮件。
补充完善下面的代码并通过向不同的账号发送电子邮件测试程序。
@@ -111,16 +117,16 @@ RFC5321给出了SMTP的定义。SMTP有众多出色的性质，
\end{code}
\subsection{思考题}
-\label{subsec:c2_s3_rethink}
+\label{subsec:c:socket:s:smtp_rethink}
修改代码使程序发送的邮件中不仅包含文本还能够包含图片。
\subsection{注意事项及有关说明}
-\label{subsec:c2_s3_notice}
+\label{subsec:c:socket:s:smtp_notice}
注意部分邮件服务器默认关闭SMTP，需进入设置手动开启SMTP协议。
\subsection{考核方法}
-\label{subsec:c2_s3_criterion}
+\label{subsec:c:socket:s:smtp_criterion}
-同实验\ref{sec:c2_s1}。
+同实验\ref{sec:c:socket:s:udp}。
diff --git a/data/chapter2/section1.tex b/data/ch_socket/sec_udp.tex
similarity index 89%
rename from data/chapter2/section1.tex
rename to data/ch_socket/sec_udp.tex
index a2cc234..43918b0 100644
--- a/data/chapter2/section1.tex
+++ b/data/ch_socket/sec_udp.tex
@@ -1,17 +1,17 @@
%# -*- coding: utf-8-unix -*-
\section{套接字基础与UDP通信}
-\label{sec:c2_s1}
+\label{sec:c:socket:s:udp}
\subsection{实验目的}
-\label{subsec:c2_s1_object}
+\label{subsec:c:socket:s:udp_object}
熟悉Python中UDP套接字编程的基础知识，掌握使用UDP套接字发送和接收数据包，
以及设置正确的套接字超时，
了解Ping应用程序及其在计算数据包丢失率等统计数据方面的有用性。
\subsection{实验内容}
-\label{subsec:c2_s1_content}
+\label{subsec:c:socket:s:udp_content}
标准的ping使用ICMP，该实验创建一个简单的，
非标准的基于UDP的ping程序。用Python编写一个客户ping程序。
@@ -23,7 +23,7 @@
要求考虑分组丢失情况，客户端最多等待1秒，超过该时长则打印丢失报文。
\subsection{实验原理、方法和手段}
-\label{subsec:c2_s1_principle}
+\label{subsec:c:socket:s:udp_principle}
UDP提供了无连接通信，且不对传送数据包进行可靠性保证，
适合于一次传输少量数据，UDP传输的可靠性由应用层负责。
@@ -42,17 +42,17 @@ UDP报文没有可靠性保证、顺序保证和流量控制字段等，可靠
服务器接收到客户发来数据后，调用sendto( )向客户发送应答数据，
客户调用recvfrom接收服务器发来的应答数据。
一旦数据传输结束，服务器和客户通过调用close( )来关闭套接字。
-具体流程如图\ref{fig:c2_udp-flow}所示。
+具体流程如图\ref{fig:c:socket_udp-flow}所示。
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
- \includegraphics[width=8cm]{c2_udp-flow}
+ \includegraphics[width=8cm]{udp-flow}
\caption{无连接客户/服务器流程图}
- \label{fig:c2_udp-flow}
+ \label{fig:c:socket_udp-flow}
\end{figure}
\subsection{实验条件}
-\label{subsec:c2_s1_requirement}
+\label{subsec:c:socket:s:udp_requirement}
\begin{itemize}
\item 装有python环境的电脑两台；
@@ -60,8 +60,15 @@ UDP报文没有可靠性保证、顺序保证和流量控制字段等，可靠
\item 服务器程序（实验步骤中已给出）。
\end{itemize}
+
+参考资料：
+
+\begin{itemize}
+ \item {J.F Kurose and K.W. Ross, 计算机网络自顶向下方法（第7版）}
+\end{itemize}
+
\subsection{实验步骤}
-\label{subsec:c2_s1_procedure}
+\label{subsec:c:socket:s:udp_procedure}
下面的服务器代码中30\%的客户端数据包被模拟为丢失。
请参考该代码，按照实验任务完成ping客户端代码。
@@ -97,13 +104,13 @@ UDP报文没有可靠性保证、顺序保证和流量控制字段等，可靠
\end{code}
\subsection{思考题}
-\label{subsec:c2_s1_rethink}
+\label{subsec:c:socket:s:udp_rethink}
尝试修改代码计算所有ping结束时报告最小、最大、平均rtt和计算丢包率（百分比）
以符合标准ping程序的工作方式。
\subsection{考核方法}
-\label{subsec:c2_s1_criterion}
+\label{subsec:c:socket:s:udp_criterion}
本次实验需提交一份实验报告和代码文件。报告内容应当包括以下三个部分：
\begin{itemize}
diff --git a/data/chapter2/section2.tex b/data/ch_socket/sec_web.tex
similarity index 85%
rename from data/chapter2/section2.tex
rename to data/ch_socket/sec_web.tex
index 6c7b08f..0626ed8 100644
--- a/data/chapter2/section2.tex
+++ b/data/ch_socket/sec_web.tex
@@ -1,16 +1,16 @@
%# -*- coding: utf-8-unix -*-
\section{TCP通信与Web服务器}
-\label{sec:c2_s2}
+\label{sec:c:socket:s:web}
\subsection{实验目的}
-\label{subsec:c2_s2_object}
+\label{subsec:c:socket:s:web_object}
掌握Python中TCP套接字编程的基础知识，理解HTTP报文格式，
了解开发一个简单Web服务器的流程。
\subsection{实验内容}
-\label{subsec:c2_s2_content}
+\label{subsec:c:socket:s:web_content}
使用Python开发一个一次处理一个HTTP请求的Web服务器。
Web服务器接受并解析HTTP请求，从服务器的文件系统中获取请求的文件，
@@ -19,7 +19,7 @@ Web服务器接受并解析HTTP请求，从服务器的文件系统中获取请
则服务器将发送HTTP“404 not Found”的消息给客户端。
\subsection{实验原理、方法和手段}
-\label{subsec:c2_s2_principle}
+\label{subsec:c:socket:s:web_principle}
基于TCP协议的面向客户/服务器的工作流程是：
在服务器端首先启动服务器调用socket( )创建套接字；
@@ -29,17 +29,18 @@ Web服务器接受并解析HTTP请求，从服务器的文件系统中获取请
最后通过accept( )来接收连接请求，并获得客户的socket地址。
在客户端，客户调用socket( )创建套接字，然后调用connect( )和服务器建立连接。
连接建立成功后，客户和服务器之间就可以通过调用read( )和write( )来接收和发送数据。
-一旦数据传输结束，服务器和客户通过调用close( )来关闭套接字。具体流程图如下图所示。
+一旦数据传输结束，服务器和客户通过调用close( )来关闭套接字。
+具体流程图\ref{fig:c:socket_tcp-flow}所示。
\begin{figure}[!htp]
\centering
- \includegraphics[width=6cm]{c2_tcp-flow}
+ \includegraphics[width=6cm]{tcp-flow}
\caption{面向连接客户/服务器流程图}
- \label{fig:c2_udp-flow}
+ \label{fig:c:socket_tcp-flow}
\end{figure}
\subsection{实验条件}
-\label{subsec:c2_s2_requirement}
+\label{subsec:c:socket:s:web_requirement}
\begin{itemize}
\item 装有python环境的电脑两台；
@@ -47,8 +48,14 @@ Web服务器接受并解析HTTP请求，从服务器的文件系统中获取请
\item 部分代码（实验步骤中已给出）。
\end{itemize}
+参考资料：
+
+\begin{itemize}
+ \item {J.F Kurose and K.W. Ross, 计算机网络自顶向下方法（第7版）}
+\end{itemize}
+
\subsection{实验步骤}
-\label{subsec:c2_s2_procedure}
+\label{subsec:c:socket:s:web_procedure}
开发一个简单的Web服务器，一次处理一个请求，具体要求如下：
\begin{enumerate}
@@ -91,13 +98,13 @@ Web服务器接受并解析HTTP请求，从服务器的文件系统中获取请
\end{code}
\subsection{思考题}
-\label{subsec:c2_s2_rethink}
+\label{subsec:c:socket:s:web_rethink}
本实验中的Web服务器一次只能处理一个HTTP请求，请自行查阅线程知识，
修改代码，实现一个能够同时处理多个请求的多线程服务器。
\subsection{注意事项及有关说明}
-\label{subsec:c2_s2_notice}
+\label{subsec:c:socket:s:web_notice}
将HTML文件放在服务器代码同一目录中。运行服务器程序。
确定运行服务器的主机的IP地址（例如，128.238.251.26）。
@@ -109,6 +116,6 @@ Web服务器接受并解析HTTP请求，从服务器的文件系统中获取请
6789为端口号，如果省略则使用默认端口号80。
\subsection{考核方法}
-\label{subsec:c2_s2_criterion}
+\label{subsec:c:socket:s:web_criterion}
-同实验\ref{sec:c2_s1}。
+同实验\ref{sec:c:socket:s:udp}。
diff --git a/data/chapter1/preface.tex b/data/ch_wireshark/preface.tex
similarity index 86%
rename from data/chapter1/preface.tex
rename to data/ch_wireshark/preface.tex
index 6f84f35..4e66711 100644
--- a/data/chapter1/preface.tex
+++ b/data/ch_wireshark/preface.tex
@@ -7,4 +7,4 @@
掌握以太网、802.11、ARP、IP、ICMP和TCP等重要协议传输单元结构，
深入理解相关网络命令和重要协议算法的工作原理，
从而培养网络故障检测、网络性能改进和网络安全分析的能力。
-(备注：第二版将增补实验1.4: IEEE 802.11协议分析。)
\ No newline at end of file
+% (备注：第二版将增补实验1.4: IEEE 802.11协议分析。)
\ No newline at end of file
diff --git a/data/chapter1/section1.tex b/data/ch_wireshark/sec_arp.tex
similarity index 77%
rename from data/chapter1/section1.tex
rename to data/ch_wireshark/sec_arp.tex
index 7110eae..fafc29e 100644
--- a/data/chapter1/section1.tex
+++ b/data/ch_wireshark/sec_arp.tex
@@ -1,16 +1,16 @@
%# -*- coding: utf-8-unix -*-
\section{Wireshark软件使用与ARP分析}
-\label{sec:c1_s1}
+\label{sec:c:wireshark:s:arp}
\subsection{实验目的}
-\label{subsec:c1_s1_object}
+\label{subsec:c:wireshark:s:arp_object}
本实验旨在让学生掌握Wireshark的基本操作，使用捕获过滤器和显示过滤器，
抓取和分析有线局域网的数据包；掌握以太网MAC帧的基本结构，掌握ARP协议的特点及工作过程。
\subsection{实验内容}
-\label{subsec:c1_s1_content}
+\label{subsec:c:wireshark:s:arp_content}
练习使用Wireshark抓取相关有线局域网的数据包并进行分析。
@@ -23,11 +23,11 @@
了解数据封装成帧的过程，计算帧长度。
\item \textbf{差错检测，FCS计算检验：}计算帧尾校验和，
并用抓包数据文件进行验证。
- \item \textbf{ARP协议分析：}取ARP请求和应答报文，分析其工作过程。
+ \item \textbf{ARP协议分析：}抓取ARP请求和应答报文，分析其工作过程。
\end{enumerate}
\subsection{实验原理}
-\label{subsec:c1_s1_principle}
+\label{subsec:c:wireshark:s:arp_principle}
\subsubsection{Wireshark简介}
@@ -46,7 +46,7 @@ Wireshark可以在Windows、Linux和MacOS操作系统中运行，
\subsubsection{以太网MAC帧格式}
本实验基于使用最广泛的有线局域网（以太网Ethernet II），
-以太网的帧结构如表\ref{tab:c1_eth-format}所示。
+以太网的帧结构如表\ref{tab:c:wireshark_eth-format}所示。
其中，MAC地址（Media Access Control Address，媒体存取控制位址）或称物理地址（Physical Address），
用于在网络中标识网卡。MAC地址的长度为48位(6个字节)，
通常表示为12个16进制数，如：00-16-EA-AE-3C-40。
@@ -54,13 +54,16 @@ Wireshark可以在Windows、Linux和MacOS操作系统中运行，
它由IEEE分配；
而后3个字节的16进制数AE-3C-40代表该制造商所生产的某个网络产品(如网卡)的系列号。
-\begin{table}[!hpb]
+\renewcommand{\arraystretch}{1.5}
+\begin{table}[!ht]
+ \small
\centering
\caption{以太网帧格式}
- \label{tab:c1_eth-format}
- \begin{tabular}{cccccc} \toprule
- 前导字符 & 目的MAC地址 & 源MAC地址 & 类型 & IP数据报 & 帧校验\\ \midrule
- 8字节 & 6字节 & 6字节 & 2字节 & & 4字节 \\ \bottomrule
+ \label{tab:c:wireshark_eth-format}
+ \begin{tabular}{|c|c|c|c|c|c|} \hline
+ \heiti 前导字符 & \heiti 目的MAC地址 & \heiti 源MAC地址 &
+ \heiti 类型 & \heiti IP数据报 & \heiti 帧校验\\ \hline
+ 8字节 & 6字节 & 6字节 & 2字节 & 46-1500字节 & 4字节 \\ \hline
\end{tabular}
\end{table}
@@ -90,7 +93,7 @@ ARP解析的过程（主机A和B不在同一网段的情况请参阅课本相关
同时将IP数据报进行封装后发送出去。
\end{enumerate}
-ARP报文结构如图\ref{fig:c1_arp-format}所示，
+ARP报文结构如图\ref{fig:c:wireshark_arp-format}所示，
ARP报文总长度为28字节，MAC地址长度为6字节，
IP地址长度为4字节。每个字段的含义如下：
@@ -103,11 +106,11 @@ IP地址长度为4字节。每个字段的含义如下：
ARP 请求为1，ARP 响应为2，RARP 请求为3，RARP 响应为4。
\end{itemize}
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
- \includegraphics[width=9cm]{c1_arp-format}
+ \includegraphics[width=9cm]{arp-format}
\caption{ARP报文结构示意图}
- \label{fig:c1_arp-format}
+ \label{fig:c:wireshark_arp-format}
\end{figure}
\subsubsection{实验方法及手段}
@@ -117,7 +120,7 @@ IP地址长度为4字节。每个字段的含义如下：
掌握以太网MAC帧和IP数据报的结构以及ARP协议的工作过程。
\subsection{实验条件}
-\label{subsec:c1_s1_requirement}
+\label{subsec:c:wireshark:s:arp_requirement}
\begin{itemize}
\item 装有Wireshark软件的PC机一台（Windows或Linux操作系统）；
@@ -125,7 +128,7 @@ IP地址长度为4字节。每个字段的含义如下：
\end{itemize}
\subsection{实验步骤}
-\label{subsec:c1_s1_procedure}
+\label{subsec:c:wireshark:s:arp_procedure}
\subsubsection{WireShark基本使用}
@@ -133,39 +136,39 @@ IP地址长度为4字节。每个字段的含义如下：
\item 通过Wireshark官网下载最新版软件，按默认选项安装。
\item 运行Wireshark软件，程序界面会显示当前的网络接口列表，
选择要抓取的网络接口，双击开始抓包，
- Wireshark软件选择网络接口的界面如图\ref{fig:c1_wireshark-boot-ui}所示。
+ Wireshark软件选择网络接口的界面如图\ref{fig:c:wireshark_wireshark-boot-ui}所示。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_wireshark-boot-ui}
+ \includegraphics[width=12cm]{wireshark-boot-ui}
\caption{Wireshark软件启动界面}
- \label{fig:c1_wireshark-boot-ui}
+ \label{fig:c:wireshark_wireshark-boot-ui}
\end{figure}
\item 点击工具栏上红色的stop按钮停止抓包。
- \item 菜单、工具栏、状态栏和主窗口如图\ref{fig:c1_wireshark-main-ui}所示，
+ \item 菜单、工具栏、状态栏和主窗口如图\ref{fig:c:wireshark_wireshark-main-ui}所示，
可以根据自己需要通过菜单“视图”以及“编辑/首选项/外观”的相关选项对基本设置进行更改。
- 例如图\ref{fig:c1_wireshark-setup-ui}中的语言、字体缩放、颜色、布局等项目。
+ 例如图\ref{fig:c:wireshark_wireshark-setup-ui}中的语言、字体缩放、颜色、布局等项目。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_wireshark-main-ui}
+ \includegraphics[width=12cm]{wireshark-main-ui}
\caption{Wireshark主窗口界面}
- \label{fig:c1_wireshark-main-ui}
+ \label{fig:c:wireshark_wireshark-main-ui}
\end{figure}
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_wireshark-setup-ui}
+ \includegraphics[width=12cm]{wireshark-setup-ui}
\caption{Wireshark的设置界面}
- \label{fig:c1_wireshark-setup-ui}
+ \label{fig:c:wireshark_wireshark-setup-ui}
\end{figure}
\item 使用“显示过滤器”可以方便地从捕获的数据包中筛选出我们想要观察的某些数据包信息。
显示过滤器支持若干的过滤选项：
源MAC、目的MAC、源IP、目的IP、TCP/UDP传输协议、
应用层协议（HTTP, DHCP）、源端口Port、目的端口Port等。
- 在显示过滤器栏中输入过滤表达式（图\ref{fig:c1_wireshark-filters}），
+ 在显示过滤器栏中输入过滤表达式（图\ref{fig:c:wireshark_wireshark-filters}），
例如下面的命令：
更详细的显示过滤语法可以查看WireShark的官方文档
\footnote{
@@ -174,67 +177,67 @@ IP地址长度为4字节。每个字段的含义如下：
}。
\begin{itemize}
- \item \texttt{arp} \hfill \textit{//显示arp协议报文}
- \item \texttt{ip.src == a.b.c.d \&\& icmp} \hfill \textit{//显示源地址为a.b.c.d的icmp报文}
+ \item \texttt{arp~~~~~~~~~~~~~~~~~~~~~~~~//显示arp协议报文}
+ \item \texttt{ip.src == a.b.c.d \&\& icmp~~//显示源地址为a.b.c.d的icmp报文}
\end{itemize}
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_wireshark-filters}
+ \includegraphics[width=12cm]{wireshark-filters}
\caption{显示过滤规则的示例}
- \label{fig:c1_wireshark-filters}
+ \label{fig:c:wireshark_wireshark-filters}
\end{figure}
- \item 通过主菜单“文件”/“导出特定分组”（如图\ref{fig:c1_wireshark-save}），
+ \item 通过主菜单“文件”/“导出特定分组”（如图\ref{fig:c:wireshark_wireshark-save}），
可以保存抓取的网络数据（也可以先选中某个包，只保存部分数据）。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_wireshark-save}
+ \includegraphics[width=12cm]{wireshark-save}
\caption{操作主菜单保存数据文件}
- \label{fig:c1_wireshark-save}
+ \label{fig:c:wireshark_wireshark-save}
\end{figure}
\item 如果只抓取特定的数据包，
可以使用菜单“捕获”/”捕获过滤器”选定想要的类型
- （如图\ref{fig:c1_wireshark-special-type}）。
+ （如图\ref{fig:c:wireshark_wireshark-special-type}）。
例如，选择“IPv4 only”，Wireshark只抓取ipv4类型的数据包。
Wireshark过滤器官方文档提供了更加全面详细的语法和常用示例
\footnote{\href{https://wiki.wireshark.org/CaptureFilters/\#Useful_Filters}
{WireShark常用过滤器语法}}。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_wireshark-special-type}
+ \includegraphics[width=12cm]{wireshark-special-type}
\caption{选中特定的捕获类型}
- \label{fig:c1_wireshark-special-type}
+ \label{fig:c:wireshark_wireshark-special-type}
\end{figure}
\item Wireshark还提供了丰富的统计功能供用户选用，
- 如图\ref{fig:c1_wireshark-statistic}。
+ 如图\ref{fig:c:wireshark_wireshark-statistic}。
更多文档可以查询Wireshark使用帮助
\footnote{\href{https://www.wireshark.org/\#learnWS}{WireShark学习手册}}。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_wireshark-statistic}
+ \includegraphics[width=16cm]{wireshark-statistic}
\caption{统计功能}
- \label{fig:c1_wireshark-statistic}
+ \label{fig:c:wireshark_wireshark-statistic}
\end{figure}
\end{enumerate}
\subsubsection{查看OUI信息}
查看本机MAC地址字段，查看OUI信息，搜索各厂商的OUI进行验证。
\subsubsection{分析以太网的帧结构}
-选择其中一个数据包，点击Ethernet II展开（图\ref{fig:c1_eth-frame-detail}），
+选择其中一个数据包，点击Ethernet II展开（图\ref{fig:c:wireshark_eth-frame-detail}），
查看MAC帧的各个字段。计算帧的长度，并与Wireshark的分析结果比较。
同时查看比较广播帧和单播帧的异同。
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_eth-frame-detail}
+ \includegraphics[width=12cm]{eth-frame-detail}
\caption{以太网帧结构展开界面}
- \label{fig:c1_eth-frame-detail}
+ \label{fig:c:wireshark_eth-frame-detail}
\end{figure}
\subsubsection{差错检测，FCS计算检验}
@@ -244,20 +247,20 @@ IP地址长度为4字节。每个字段的含义如下：
\item 使用\texttt{arp –d}命令（其语法见图\ref{fig:arp-cmd})，清空本机已有的ARP缓存，
开启Wireshark，ping本机的同网段地址，在显示过滤器条框中输入“\texttt{arp}”，
观察捕获的ARP报文的各个字段，分析请求/响应的过程。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \begin{code}[text]
-arp [-a [InetAddr] [-N IfaceAddr]] [-g [InetAddr] [-N IfaceAddr]]
- [-d InetAddr [IfaceAddr]] [-s InetAddr EtherAddr [IfaceAddr]]
-
- -a显示所有接口/特定接口的当前 ARP 缓存表。
- -g 同-a。
- -d删除所有/指定的IP地址项。
- -s向ARP 缓存添加可将IP地址InetAddr解析成物理地址EtherAddr的静态项。
- \end{code}
- \caption{arp命令语法及参数}
- \label{fig:arp-cmd}
-\end{figure}
+ \begin{code}[text]
+ arp [-a [InetAddr] [-N IfaceAddr]] [-g [InetAddr] [-N IfaceAddr]]
+ [-d InetAddr [IfaceAddr]] [-s InetAddr EtherAddr [IfaceAddr]]
+
+ -a 显示所有接口/特定接口的当前 ARP 缓存表
+ -g 同-a
+ -d 删除所有/指定的IP地址项
+ -s 在ARP缓存中添加对应InetAddr地址的EtherAddr地址静态项
+ \end{code}
+ \caption{arp命令语法及参数}
+ \label{fig:arp-cmd}
+ \end{figure}
\item 使用\texttt{arp –d}命令，清空本机已有的ARP缓存。开启Wireshark，
ping本机的不同网段地址或域名，观察捕获的ARP报文的各个字段，
@@ -265,7 +268,7 @@ arp [-a [InetAddr] [-N IfaceAddr]] [-g [InetAddr] [-N IfaceAddr]]
\end{enumerate}
\subsection{思考题}
-\label{subsec:c1_s1_rethink}
+\label{subsec:c:wireshark:s:arp_rethink}
\begin{enumerate}
\item 使用了显示过滤器后，Wireshark的抓包工作量会减少吗？
@@ -282,7 +285,7 @@ arp [-a [InetAddr] [-N IfaceAddr]] [-g [InetAddr] [-N IfaceAddr]]
\end{enumerate}
\subsection{考核方法}
-\label{subsec:c1_s1_criterion}
+\label{subsec:c:wireshark:s:arp_criterion}
考核分为现场考核和实验报告两个部分，具体如下。
报告内容应包含以下内容，相关的分析解释都需要截图证明，
diff --git a/data/chapter1/section2.tex b/data/ch_wireshark/sec_ip.tex
similarity index 79%
rename from data/chapter1/section2.tex
rename to data/ch_wireshark/sec_ip.tex
index 6cf8ccb..026d906 100644
--- a/data/chapter1/section2.tex
+++ b/data/ch_wireshark/sec_ip.tex
@@ -1,10 +1,10 @@
%# -*- coding: utf-8-unix -*-
\section{IP与ICMP分析}
-\label{sec:c1_s2}
+\label{sec:c:wireshark:s:ip}
\subsection{实验目的}
-\label{subsec:c1_s2_object}
+\label{subsec:c:wireshark:s:ip_object}
IP和ICMP协议是TCP/IP协议簇中的网络层协议，
在网络寻址定位、数据分组转发和路由选择等任务中发挥了重要作用。
@@ -12,7 +12,7 @@ IP和ICMP协议是TCP/IP协议簇中的网络层协议，
分析数据报的分片；掌握基于ICMP协议的ping和traceroute命令及其工作过程。
\subsection{实验内容}
-\label{subsec:c1_s2_content}
+\label{subsec:c:wireshark:s:ip_content}
启动Wireshark，捕捉网络命令执行过程中本机接受和发送的数据报。
@@ -31,31 +31,31 @@ IP和ICMP协议是TCP/IP协议簇中的网络层协议，
\end{enumerate}
\subsection{实验原理、方法和手段}
-\label{subsec:c1_s2_principle}
+\label{subsec:c:wireshark:s:ip_principle}
\subsubsection{IP协议及数据报格式}
网际互连协议（Internet Protocol，IP），是TCP/IP体系中的网络层协议，
可实现大规模的异构网络互联互通，为主机提供无连接的、尽力而为的数据包传输服务。
在网际协议第4版（IPv4）中，IP数据报是一个可变长分组，
-包括首部和数据两部分(如图\ref{c1_ip-structure})。
+包括首部和数据两部分(如图\ref{c:wireshark_ip-structure})。
首部由20~60字节组成，包含与路由选择和传输有关的重要信息，其各字段意义如下：
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
- \includegraphics[width=10cm]{c1_ip-structure}
+ \includegraphics[width=12cm]{ip-structure}
\caption{IP数据报结构示意图}
- \label{c1_ip-structure}
+ \label{c:wireshark_ip-structure}
\end{figure}
\begin{enumerate}
\item \textbf{版本（4位）：}该字段定义IP协议版本，
所有字段都要按照此版本的协议来解释。
\item \textbf{首部长度（4位）：}该字段定义数据报协议头长度，
- 表示协议首部具有32位字长的数量，最小值为5，最大值为15。
+ 表示协议首部具有32位字长的数量，最小值为5，最大值为15。
\item \textbf{服务（8位）：}该字段定义上层协议对处理当前数据报所期望的服务质量，
并对数据报按照重要性级别进行分配。前3位成为优先位，后面4位成为服务类型，
- 最后1位没有定义。这些8位字段可用于分配优先级、延迟、吞吐量以及可靠性。
+ 最后1位没有定义。这些8位字段可用于分配优先级、延迟、吞吐量以及可靠性。
\item \textbf{总长度（16位）：}该字段定义整个IP数据报的字节长度，
包括协议首部和数据，其最大值为65535字节。
\item \textbf{标识（16位）：}该字段包含一个整数，用于标识当前数据报。
@@ -74,7 +74,7 @@ IP和ICMP协议是TCP/IP协议簇中的网络层协议，
计算过程是先将校验和字段置为0，然后将整个头部每16位划分为一部分，
将个部分相加，再将计算结果取反码，插入到校验和字段中。
\item \textbf{源地址（32位）：}源主机的IP地址。
- \item \textbf{目的地址（32位）：}目标主机的IP地址。
+ \item \textbf{目的地址（32位）：}目标主机的IP地址。
\end{enumerate}
一个IP包从源主机传输到目标主机可能需要经过多个传输媒介不同的网络。
@@ -105,31 +105,43 @@ IP和ICMP协议是TCP/IP协议簇中的网络层协议，
对网络正常运行起着重要的作用。
ICMP报文的类型可以分为ICMP差错报文和ICMP询问报文两种
-（其结构如图\ref{c1_icmp-structure}）。
+（其结构如图\ref{c:wireshark_icmp-structure}）。
ICMP差错报告报文主要有终点不可达、源站抑制、超时、参数问题和路由重定向5种。
ICMP询问报文有回送请求和应答、时间戳请求和应答、
地址掩码请求和应答以及路由器询问和通告4种。
-其常见的类型与代码如表\ref{tab:c1_icmp-format}所示。
+其常见的类型与代码如表\ref{tab:c:wireshark_icmp-format}所示。
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
- \includegraphics[width=12cm]{c1_icmp-structure}
+ \includegraphics[width=12cm]{icmp-structure}
\caption{ICMP报文结构示意图}
- \label{c1_icmp-structure}
+ \label{c:wireshark_icmp-structure}
\end{figure}
-\begin{table}[!htp]
+\renewcommand{\arraystretch}{1.5}
+\begin{table}[!ht]
+ \small
\centering
\caption{ICMP各类型报文的格式}
- \label{tab:c1_icmp-format}
- \begin{tabular}{m{1.4cm}<{\centering}m{1.4cm}<{\centering}m{8cm}<{\centering}m{1.4cm}<{\centering}m{1.4cm}<{\centering}} \toprule
- 类型(TYPE) & 代码(CODE) & 描述(Description) & 查询类(Query) & 差错类(Error)\\ \midrule
- 0 & 0 & Echo Reply——回显应答（Ping应答）& x & \\
- 3 & 1 & Host Unreachable——主机不可达 & & x\\
- 3 & 3 & Port Unreachable——端口不可达 & & x\\
- 3 & 4 & Fragmentation needed but no frag. bit set——需要进行分片但设置不分片比特 & &x\\
- 8 & 0 & Echo request——回显请求（Ping请求）& x & \\
- 11& 0 & TTL equals 0 during transit——传输期间生存时间为0 & & x\\ \bottomrule
+ \label{tab:c:wireshark_icmp-format}
+ \begin{tabular}{|m{1.4cm}<{\centering}
+ |m{1.4cm}<{\centering}
+ |m{7cm}
+ |m{1.4cm}<{\centering}
+ |m{1.4cm}<{\centering}|}
+ \hline
+ \heiti 类型(TYPE) &\heiti 代码(CODE) &
+ \multicolumn{1}{|c|}{\heiti 描述(Description)} &
+ \heiti 查询类(Query) &\heiti 差错类(Error)\\ \hline
+
+ 0 & 0 & Echo Reply——回显应答（Ping应答）& $\checkmark$ & \\ \hline
+ 3 & 1 & Host Unreachable——主机不可达 & & $\checkmark$\\ \hline
+ 3 & 3 & Port Unreachable——端口不可达 & & $\checkmark$\\ \hline
+ 3 & 4 & Fragmentation needed but no frag. bit set \newline
+ ——需要进行分片但设置不分片比特 & &$\checkmark$\\ \hline
+ 8 & 0 & Echo request——回显请求（Ping请求）& $\checkmark$ & \\ \hline
+ 11& 0 & TTL equals 0 during transit \newline
+ ——传输期间生存时间为0 & & $\checkmark$\\ \hline
\end{tabular}
\end{table}
@@ -142,21 +154,22 @@ ICMP询问报文有回送请求和应答、时间戳请求和应答、
ping命令可以检测网络的连通性，简单估测数据报的往返时间（Round Trip Time），
确定是否有数据包丢失或损坏，从而帮助分析网络故障。
ping命令格式和常用参数如图\ref{fig:ping-cmd}所示。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \begin{code}[text]
- ping [-t] [-a] [-n count] [-l length] [-f] [-i ttl] [-v tos]
- [-r count] [-s count] [-j computer-list] | [-k computer-list]
- [-w timeout] destination-list
-
- -a 将地址解析为计算机名。
- -n count 发送 count 指定的 ECHO 数据包数。默认值为 4。
- -l length 发送包含由 length 指定的数据量的 ECHO 数据包。默认为 32 字节;最大值是65,527。
- -f 在数据包中发送"不要分片"标志。数据包就不会被路由上的网关分片。
- -i ttl 将"生存时间"字段设置为 ttl 指定的值。 \end{code}
- \caption{ping命令语法及参数}
- \label{fig:ping-cmd}
-\end{figure}
+ \begin{code}[text]
+ ping [-t] [-a] [-n count] [-l length] [-f] [-i ttl] [-v tos]
+ [-r count] [-s count] [-j computer-list] | [-k computer-list]
+ [-w timeout] destination-list
+
+ -a 将地址解析为计算机名。
+ -n count 发送 count 指定的 ECHO 数据包数。默认值为 4。
+ -l length 发送包含由 length 指定的数据量的 ECHO 数据包。默认为 32 字节;最大值是65,527。
+ -f 在数据包中发送"不要分片"标志。数据包就不会被路由上的网关分片。
+ -i ttl 将"生存时间"字段设置为 ttl 指定的值。
+ \end{code}
+ \caption{ping命令语法及参数}
+ \label{fig:ping-cmd}
+ \end{figure}
\item traceroute/tracert命令，利用TTL字段和ICMP差错类型报文，
查找IP数据报的路由转发路径（含路由器信息）。
@@ -174,7 +187,7 @@ ICMP询问报文有回送请求和应答、时间戳请求和应答、
至此，traceroute命令发起者已经获得了通向目标主机路径上的所有路由信息。
tracert命令（Linux）格式和常用参数如图\ref{fig:tracert-cmd}所示。
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
\begin{code}[text]
tracert [-d] [-h maximum_hops] [-j host-list] [-w timeout] [-R]
@@ -205,7 +218,7 @@ tracert命令（Linux）格式和常用参数如图\ref{fig:tracert-cmd}所示
\end{enumerate}
\subsection{实验条件}
-\label{subsec:c1_s2_requirement}
+\label{subsec:c:wireshark:s:ip_requirement}
装有Wireshark软件的PC机一台（Linux或OS 操作系统）；局域网环境。
@@ -220,56 +233,56 @@ tracert命令（Linux）格式和常用参数如图\ref{fig:tracert-cmd}所示
\end{itemize}
\subsection{实验步骤}
-\label{subsec:c1_s2_procedure}
+\label{subsec:c:wireshark:s:ip_procedure}
\subsubsection{ping命令}
-本机（示例IP为10.24.90.1）启动Wireshark软件，
+本机（示例IP为192.168.1.251）启动Wireshark软件，
选择要监听的网络接口（如eth0、wlan0）；
然后在终端发起网络命令：ping IP地址/域名。
\begin{enumerate}
\item 在Wireshark监视器中设置过滤条件。
- 例如图\ref{fig:c1_wireshark-monitor}设置过滤条件为icmp，
+ 例如图\ref{fig:c:wireshark_wireshark-monitor}设置过滤条件为icmp，
则显示出所捕获的ICMP数据包。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_wireshark-monitor}
+ \includegraphics[width=16cm]{wireshark-monitor}
\caption{Wireshark监视器界面}
- \label{fig:c1_wireshark-monitor}
+ \label{fig:c:wireshark_wireshark-monitor}
\end{figure}
- \item 点击Internet Protocol Version 4展开（如图\ref{fig:c1_ip-view}），
+ \item 点击Internet Protocol Version 4展开（如图\ref{fig:c:wireshark_ip-view}），
查看IP数据报，特别观察IP数据报的首部字段及其内容。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_ip-view}
+ \includegraphics[width=16cm]{ip-view}
\caption{查看IP数据报}
- \label{fig:c1_ip-view}
+ \label{fig:c:wireshark_ip-view}
\end{figure}
- \item 点击Internet Control Message Protocol展开（如图\ref{fig:c1_echo-request}），
+ \item 点击Internet Control Message Protocol展开（如图\ref{fig:c:wireshark_echo-request}），
查看ICMP报文，并解释回显（Echo Request和Echo Reply）报文的首部字段。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_echo-request}
+ \includegraphics[width=16cm]{echo-request}
\caption{Echo request示例}
- \label{fig:c1_echo-request}
+ \label{fig:c:wireshark_echo-request}
\end{figure}
- \item 清空Wireshark监控器，重新发起网络命令（如图\ref{c1_ping-exec}）：
+ \item 清空Wireshark监控器，重新发起网络命令（如图\ref{fig:c:wireshark_ping-exec}）：
ping IP地址/域名 –l \#length，并解释对比前后两次执行ping命令的结果。
其中，-l \#length确定echo数据报的长度为\#length，
其默认值为32字节，且小于65,527字节。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=11cm]{c1_ping-exec}
+ \includegraphics[width=12cm]{ping-exec}
\caption{ping命令执行示例}
- \label{fig:c1_ping-exec}
+ \label{fig:c:wireshark_ping-exec}
\end{figure}
\item 可以多次改变\#length的大小（例如1000字节、2000字节和4000字节），
@@ -279,29 +292,29 @@ tracert命令（Linux）格式和常用参数如图\ref{fig:tracert-cmd}所示
\subsubsection{traceroute命令}
-本机（示例IP为10.24.90.172）启动Wireshark软件，
+本机（示例IP为192.168.1.251）启动Wireshark软件，
选择要监听的网络接口（如eth0、wlan0）；
然后在终端发起网络命令：traceroute IP地址/域名。
\begin{enumerate}
\item 启动Wireshark软件，选择要监听的网络接口，设置过滤条件icmp
- （如图\ref{fig:c1_wireshark-filter-setup}）。
+ （如图\ref{fig:c:wireshark_wireshark-filter-setup}）。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_wireshark-filter-setup}
+ \includegraphics[width=16cm]{wireshark-filter-setup}
\caption{在Wireshark中设置过滤条件}
- \label{fig:c1_wireshark-filter-setup}
+ \label{fig:c:wireshark_wireshark-filter-setup}
\end{figure}
\item 在终端中使用traceroute命令，
- 目的主机是外网的一台设备（如图\ref{fig:c1_traceroute-exec}，示例IP为210.34.0.12）。
+ 目的主机是外网的一台设备（如图\ref{fig:c:wireshark_traceroute-exec}，示例IP为210.34.0.1）。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=16cm]{c1_traceroute-exec}
+ \includegraphics[width=10cm]{traceroute-exec}
\caption{在终端中执行traceroute命令示例}
- \label{fig:c1_traceroute-exec}
+ \label{fig:c:wireshark_traceroute-exec}
\end{figure}
\item 点击Internet Control Message Protocol展开，
@@ -311,7 +324,7 @@ tracert命令（Linux）格式和常用参数如图\ref{fig:tracert-cmd}所示
\end{enumerate}
\subsection{思考题}
-\label{subsec:c1_s2_rethink}
+\label{subsec:c:wireshark:s:ip_rethink}
\begin{enumerate}
\item 在有线局域网中，PC1的IP地址为192.168.1.5/24，
@@ -319,7 +332,7 @@ tracert命令（Linux）格式和常用参数如图\ref{fig:tracert-cmd}所示
PC2的IP地址为192.168.2.6/24，默认路由器的IP地址为192.168.2.1。
在PC1向PC2发送数据的传输过程中，
以太网数据帧的首部字段和IP数据报的首部字段是怎样变化的？
- 如果有条件，请搭建实验平台进行实验，并使用Wireshark软件验证你的答案。
+ 如果有条件，请搭建实验平台进行实验，并使用Wireshark软件验证你的答案。
\item 拒绝服务（Denial of Service，DoS）攻击，通过消耗目标主机设备的某种资源，
导致其网络服务不能被正常用户使用。
\begin{enumerate}
@@ -341,7 +354,7 @@ tracert命令（Linux）格式和常用参数如图\ref{fig:tracert-cmd}所示
\end{enumerate}
\subsection{考核方法}
-\label{subsec:c1_s2_criterion}
+\label{subsec:c:wireshark:s:ip_criterion}
本次实验需提交一份实验报告和一组Wireshark数据存储文件。
报告内容应当包括以下三个部分，其中的分析解释都有对应的截图，
diff --git a/data/chapter1/section3.tex b/data/ch_wireshark/sec_tcp.tex
similarity index 89%
rename from data/chapter1/section3.tex
rename to data/ch_wireshark/sec_tcp.tex
index bb5ebcf..8dfea35 100644
--- a/data/chapter1/section3.tex
+++ b/data/ch_wireshark/sec_tcp.tex
@@ -1,10 +1,10 @@
%# -*- coding: utf-8-unix -*-
\section{TCP与拥塞控制}
-\label{sec:c1_s3}
+\label{sec:c:wireshark:s:tcp}
\subsection{实验目的}
-\label{subsec:c1_s3_object}
+\label{subsec:c:wireshark:s:tcp_object}
TCP(Transmission Control Protocol传输控制协议)是一种面向连接的、
可靠的、基于字节流的传输层通信协议。
@@ -14,7 +14,7 @@ TCP(Transmission Control Protocol传输控制协议)是一种面向连接的、
学会运用Wireshark分析TCP连接管理、流量控制和拥塞控制的过程，发现TCP的性能问题。
\subsection{实验内容}
-\label{subsec:c1_s3_content}
+\label{subsec:c:wireshark:s:tcp_content}
启动Wireshark，捕捉网络活动中的TCP报文并按要求分析。
\begin{enumerate}
@@ -33,7 +33,7 @@ TCP(Transmission Control Protocol传输控制协议)是一种面向连接的、
\end{enumerate}
\subsection{实验原理、方法和手段}
-\label{subsec:c1_s3_principle}
+\label{subsec:c:wireshark:s:tcp_principle}
\subsubsection{TCP协议}
@@ -49,14 +49,14 @@ TCP的连接管理、差错控制、流量控制和拥塞控制的原理。
\paragraph{TCP报文段(Segment)}~{}
\\
-TCP 报文段结构如图\ref{fig:c1_TCP-structure}所示，
+TCP 报文段结构如图\ref{fig:c:wireshark_TCP-structure}所示，
采用20字节的报文段头并有最长40字节的可选项。
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
- \includegraphics[width=10cm]{c1_TCP-structure}
+ \includegraphics[width=10cm]{TCP-structure}
\caption{TCP报文段结构标意图}
- \label{fig:c1_TCP-structure}
+ \label{fig:c:wireshark_TCP-structure}
\end{figure}
主要字段如下：
@@ -92,13 +92,13 @@ TCP 报文段结构如图\ref{fig:c1_TCP-structure}所示，
为维护一个可靠的端对端传输，TCP设计实现了完整的连接管理，
重点是三次握手的连接建立和四次挥手的连接释放过程，
-如图\ref{fig:c1_TCP-time-line}。
+如图\ref{fig:c:wireshark_TCP-time-line}。
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
- \includegraphics[width=9cm]{c1_TCP-time-line}
+ \includegraphics[width=9cm]{TCP-time-line}
\caption{TCP连接示意时序}
- \label{fig:c1_TCP-time-line}
+ \label{fig:c:wireshark_TCP-time-line}
\end{figure}
\textbf{建立过程：}TCP是面向连接的，数据传输之前必须在双方之间建立一条连接，
@@ -188,54 +188,61 @@ TCP拥塞控制算法一直处在不断的改进之中，围绕对网络环境
直至收到新确认号的ACK则将cwnd更新为ssthresh。
TCP NewReno则进一步改进了快速恢复算法。
-随着网络速度增长，传统拥塞控制算法的cwnd增长速度影响了TCP的性能，CUBIC应运而生。
+随着网络速度增长，传统拥塞控制算法的cwnd增长速度影响了TCP的性能，
+CUBIC\footnote{\href{https://www.researchgate.net/publication/220623913}{CUBIC: A New TCP-Friendly High-Speed TCP Variant}}
+应运而生。
CUBIC的关键特征是：cwnd窗口的增长依赖两次丢包的时间。
-2016年，谷歌提出了BBR拥塞控制算法，它不再基于丢包感知来调整cwnd，
+2016年，谷歌提出了
+BBR\footnote{\href{https://queue.acm.org/detail.cfm?id=3022184}{BBR: Congestion-Based Congestion Control}}
+拥塞控制算法，它不再基于丢包感知来调整cwnd，
而是利用估算的带宽和延迟直接推测拥塞程度进而确定发送窗口。
\subsubsection{实验方法和手段}
-使用VMWare软件配置两台本地虚拟机，本地相互连接(如图\ref{fig:c1_TCP-topo})。
+使用VMWare软件配置两台本地虚拟机，本地相互连接(如图\ref{fig:c:wireshark_TCP-topo})。
在VMWare中的虚拟机设置->网络适配器->高级中虚拟机的网卡传入/传出带宽、
-传输速率、时延等，用来仿真不同的网络条件（如图\ref{fig:c1_VM-advance-setup}）。
-本实验需要使用的命令和工具，如表\ref{tab:c1_tools-command}所列。
+传输速率、时延等，用来仿真不同的网络条件（如图\ref{fig:c:wireshark_VM-advance-setup}）。
+本实验需要使用的命令和工具，如表\ref{tab:c:wireshark_tools-command}所列。
常用的Linux操作系统命令还包括：echo、cat、sysctl、ping、ftp。
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
- \includegraphics[width=9cm]{c1_TCP-topo}
+ \includegraphics[width=9cm]{TCP-topo}
\caption{实验拓扑图}
- \label{fig:c1_TCP-topo}
+ \label{fig:c:wireshark_TCP-topo}
\end{figure}
-\begin{figure}[!htp]
+\begin{figure}[!ht]
\centering
- \includegraphics[width=6cm]{c1_VM-advance-setup}
+ \includegraphics[width=6cm]{VM-advance-setup}
\caption{虚拟机网络适配器高级设置}
- \label{fig:c1_VM-advance-setup}
+ \label{fig:c:wireshark_VM-advance-setup}
\end{figure}
-\begin{table}[]
+\renewcommand{\arraystretch}{1.5}
+\begin{table}[!ht]
+ \small
\centering
\caption{主要工具及命令列表}
- \label{tab:c1_tools-command}
- \begin{tabular}{m{1.5cm}<{\centering}m{3cm}<{\centering}m{10cm}} \toprule
- 命令 & 作用 & 参考\\ \midrule
- \texttt{ifconfig} & 配置网络 & \url{https://man.linuxde.net/ifconfig}\\
- \texttt{nmap} & 网络扫描 & \url{https://nmap.org/man/zh/index.html}\\
- \texttt{curl} & 文本浏览器 & \url{https://man.linuxde.net/curl}\\
- \texttt{wget} & 下载Web文件 & \texttt{wget /}\\
- \texttt{tc} & 流量控制 & \href{https://man7.org/linux/man-pages/man8/tc.8.html}{TC命令手册} \\
- \texttt{iptables} & 防火墙配置 & \url{https://man.linuxde.net/iptables}\\
- \texttt{netwox} & 网络工具 & \url{https://sourceforge.net/projects/ntwox}/\\
- \texttt{ss} & Socket状态 & \texttt{ss –atn}\\
- \texttt{netstat} & 显示网络状态 & \texttt{netstat –atn}\\
- \texttt{iperf3} & 网络性能分析 & \url{https://iperf.fr/}\\ \bottomrule
+ \label{tab:c:wireshark_tools-command}
+ \begin{tabular}{|m{1.5cm}<{\centering}|m{3cm}<{\centering}|m{8.5cm}|}
+ \hline
+ \heiti 命令 & \heiti 作用 & \multicolumn{1}{c|}{\heiti 参考}\\ \hline
+ \texttt{ifconfig} & 配置网络 & \url{https://man.linuxde.net/ifconfig}\\ \hline
+ \texttt{nmap} & 网络扫描 & \url{https://nmap.org/man/zh/index.html}\\ \hline
+ \texttt{curl} & 文本浏览器 & \url{https://man.linuxde.net/curl}\\ \hline
+ \texttt{wget} & 下载Web文件 & \texttt{wget /}\\ \hline
+ \texttt{tc} & 流量控制 & \href{https://man7.org/linux/man-pages/man8/tc.8.html}{tc命令手册} \\ \hline
+ \texttt{iptables} & 防火墙配置 & \url{https://man.linuxde.net/iptables}\\ \hline
+ \texttt{netwox} & 网络工具 & \url{https://sourceforge.net/projects/ntwox/}\\ \hline
+ \texttt{ss} & Socket状态 & \texttt{ss –atn}\\ \hline
+ \texttt{netstat} & 显示网络状态 & \texttt{netstat –atn}\\ \hline
+ \texttt{iperf3} & 网络性能分析 & \url{https://iperf.fr/}\\ \hline
\end{tabular}
\end{table}
\subsection{实验条件}
-\label{subsec:c1_s3_requirement}
+\label{subsec:c:wireshark:s:tcp_requirement}
\begin{enumerate}
\item 硬件：每个学生一台物理实验机（8G以上内存，80G以上硬盘空间)。
@@ -261,7 +268,7 @@ CUBIC的关键特征是：cwnd窗口的增长依赖两次丢包的时间。
\end{itemize}
\subsection{实验步骤}
-\label{subsec:c1_s3_procedure}
+\label{subsec:c:wireshark:s:tcp_procedure}
\subsubsection{TCP正常连接观察}
@@ -358,7 +365,8 @@ CUBIC的关键特征是：cwnd窗口的增长依赖两次丢包的时间。
\begin{enumerate}
\item 编写一对简单的TCP连接程序，
- 也可以直接运行指导书提供的Python程序(见附件)。
+ 也可以直接运行指导书提供的Python程序
+ (源代码见本节最后的\nameref{subsec:c:wireshark:s:tcp_additionalprg})。
在客户端快速发送数据给服务端，而服务端则有意缓慢地接收数据，
观察TCP如何用窗口大小值进行流量控制。虚拟机两端分别运行
\texttt{python3 server.py}和\texttt{python3 client.py}。
@@ -375,14 +383,14 @@ CUBIC的关键特征是：cwnd窗口的增长依赖两次丢包的时间。
再启动应用(可以是http wget，也可以ftp下载/上传)传输大文件观察。
\item Wireshark抓取全部传输过程数据，找出该网络活动的拥塞点，
并结合Analyze$\rightarrow$Expert Information、Statistic$\rightarrow$IO Graphs、
- Statistic$\rightarrow$TCP Stream Graphs(如图\ref{fig:c1_io-graphs})，
+ Statistic$\rightarrow$TCP Stream Graphs(如图\ref{fig:c:wireshark_io-graphs})，
分析此传输过程中的慢启动、拥塞避免、快速恢复等阶段。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=10cm]{c1_io-graphs}
+ \includegraphics[width=8cm]{io-graphs}
\caption{IO Graphs}
- \label{fig:c1_io-graphs}
+ \label{fig:c:wireshark_io-graphs}
\end{figure}
\item TCP竞争观察：类似以上试验，我们在一个大文件传输过程中，
@@ -406,7 +414,7 @@ CUBIC的关键特征是：cwnd窗口的增长依赖两次丢包的时间。
\end{enumerate}
\subsection{思考题}
-\label{subsec:c1_s3_rethink}
+\label{subsec:c:wireshark:s:tcp_rethink}
\begin{enumerate}
\item TCP在不可靠的IP层上建立了可靠的端对端连接，
@@ -420,21 +428,21 @@ CUBIC的关键特征是：cwnd窗口的增长依赖两次丢包的时间。
\item TCP是封装单元为MSS，可是我们在抓包过程中常发现远大于此值的TCP包，
为什么TCP可以提交如此大的报文呢？
此类型的包远超出链路层的MTU，它是如何被处理的呢？请从两端同时抓包观察比对。
- \item 在TCP状态机(图\ref{fig:c1_TCP-status-machine})中，
+ \item 在TCP状态机(图\ref{fig:c:wireshark_TCP-status-machine})中，
有些状态停留时间较长，易观察到，有些状态很短暂不易观察到。
试列出不易观察到的状态，并考虑观察到它们的可能方法。
- \begin{figure}[!htp]
+ \begin{figure}[!ht]
\centering
- \includegraphics[width=11cm]{c1_TCP-status-machine}
+ \includegraphics[width=9cm]{TCP-status-machine}
\caption{TCP连接管理状态机}
- \label{fig:c1_TCP-status-machine}
+ \label{fig:c:wireshark_TCP-status-machine}
\end{figure}
\end{enumerate}
\subsection{注意事项及有关说明}
-\label{subsec:c1_s3_notice}
+\label{subsec:c:wireshark:s:tcp_notice}
\begin{enumerate}
\item Linux上运行wireshark抓包需要root权限，
@@ -452,7 +460,7 @@ CUBIC的关键特征是：cwnd窗口的增长依赖两次丢包的时间。
\end{enumerate}
\subsection{考核方法}
-\label{subsec:c1_s3_criterion}
+\label{subsec:c:wireshark:s:tcp_criterion}
完成本次实验，并提交一份实验报告和一组Wireshark数据存储文件。
报告内容应当包括以下部分，相关的分析解释都对应有截图证明，并与数据存储文件吻合。
@@ -469,11 +477,12 @@ CUBIC的关键特征是：cwnd窗口的增长依赖两次丢包的时间。
\end{enumerate}
\subsection{附件}
-\label{subsec:c1_s3_additionalprg}
-1． Python3 TCP socket通信程序。
-\ 服务端 server.py
-\lstset{language=python3}
-\begin{lstlisting}
+\label{subsec:c:wireshark:s:tcp_additionalprg}
+
+为了方便进行实验，提供一份Python3套接字通信作为附件，具体代码如下：
+\begin{itemize}
+ \item 服务端 server.py
+\begin{code}[python]
import socket
import time
def recv_data(sock,length):
@@ -499,11 +508,10 @@ CUBIC的关键特征是：cwnd窗口的增长依赖两次丢包的时间。
finally:
sc.close()
s.close()
-\end{lstlisting}
-\\
-\ 客户端 client.py
-\lstset{language=python3}
-\begin{lstlisting}
+\end{code}
+
+\item 客户端 client.py
+\begin{code}[python]
import socket
import time
ip_port = ("192.168.100.144", 9999)
@@ -522,4 +530,6 @@ CUBIC的关键特征是：cwnd窗口的增长依赖两次丢包的时间。
print("Sent. Waiting....")
while True:
time.sleep(0.001)
-\end{lstlisting}
\ No newline at end of file
+\end{code}
+
+\end{itemize}
diff --git a/data/chapter3/section3.tex b/data/chapter3/section3.tex
deleted file mode 100644
index b869c0f..0000000
--- a/data/chapter3/section3.tex
+++ /dev/null
@@ -1,214 +0,0 @@
-%# -*- coding: utf-8-unix -*-
-
-\section{动态路由（OSPF）}
-\label{sec:c3_s3}
-
-\subsection{实验目的}
-\label{subsec:c3_s3_object}
-
-理解动态路由协议OSPF的工作原理；
-掌握采用动态路由协议OSPF进行网络设计的基本原则和方法。
-
-\subsection{实验内容}
-\label{subsec:c3_s3_content}
-
-\begin{itemize}
- \item 华为路由器IP地址的配置；
- \item 动态路由协议OSPF的配置；
- \item 路由规划；
- \item 网络测试与排错操作；
- \item RIP与OSPF路由协议的区别。
-\end{itemize}
-
-\subsection{实验原理、方法和手段}
-\label{subsec:c3_s3_principle}
-
-简要说明OSPF工作原理和适用范围；
-可设计至少包括3个由OSPF协议互连起来的网络；
-观察并记录各设备状态变化情况，特别留意路由信息的交换和路由表。
-分析说明相对于RIP协议，OSPF做了哪些改进。
-解释说明与路由协议、路由表的相关性。
-
-可参考图\ref{fig:c3_OSPF-topo}连线，具体联线情况请自行标注。
-
-\begin{figure}[!htp]
- \centering
- \includegraphics[width=8cm]{c3_OSPF-topo}
- \caption{选中特定的捕获类型}
- \label{fig:c3_OSPF-topo}
-\end{figure}
-
-\subsection{实验条件}
-\label{subsec:c3_s3_requirement}
-
-\begin{itemize}
- \item 华为ENSP仿真平台中：2台PC，两台路由器；
- \item 双绞线若干。
-\end{itemize}
-
-\subsection{实验步骤}
-\label{subsec:c3_s3_procedure}
-
-实验说明：路由器端口以具体选用的设备为准，
-如果是实际设备，请观察路由器前面板和后面板的端口名称，
-并使用disp int或者disp cur命令查看端口的实际名称。
-在对路由器进行配置时，
-可使用disp cur命令来检查当前路由器上生效的配置命令。
-
-\begin{enumerate}
- \item 硬件连接，完成PC1、PC2到路由器RT1和RT2的网络连接，
- 路由器RT1到路由器RT2的连接；
- PC1到路由器RT1控制线的连接，PC2到路由器RT2控制线的连接。
- 拓扑图检查无误后方可进行后面的实验步骤,
- 实验报告中的拓扑图必须标清路由器实际连接的端口。
- \item 为PC1、PC2分别设置IP地址、掩码和网关。
- \item 使用sysname命令为路由器R1和R2命名。
- 路由器R1的名称为学生自己的姓名拼音+R1，
- 路由器R2的名称为学生自己的姓名拼音+R2，要求记录输入的命令和输出（截屏）。
-
- R1上的重命名命令如下例:
- \begin{code}[text]
- system-view
- [Huawei]sysname zhangsanR1
- \end{code}
-
- 输出结果如图\ref{fig:c3_sysname-R1_3}所示。
- \begin{figure}[!htp]
- \centering
- \includegraphics[width=10cm]{c3_sysname-R1_3}
- \caption{R1的sys配置图}
- \label{fig:c3_sysname-R1_3}
- \end{figure}
-
- R2上的重命名命令如下例:
- \begin{code}[text]
- system-view
- [Huawei]sysname zhangsanR2
- \end{code}
-
- 输出结果如图\ref{fig:c3_sysname-R2_3}所示。
- \begin{figure}[!htp]
- \centering
- \includegraphics[width=10cm]{c3_sysname-R2_3}
- \caption{R2的sys配置图}
- \label{fig:c3_sysname-R2_3}
- \end{figure}
-
- \item 为路由器R1的 GE0接口配置IP地址。
- 配置完成后PC1应该可以Ping通RT1的 GE0口的地址。
- 为路由器R2的 GE1接口配置IP地址。
- 配置完成后PC2应该可以Ping通RT2的GE1口的地址。
- 要求记录输入的命令和输出（截屏）。
- (本模拟器R1实际使用的接口名由实际使用的路由器型号确定，
- 可能有Ethernet0/0/0；或GigabitEthernet0/0/x；或FastEthernet0/0/x)
-
- R1上的重命名命令如下例:
- \begin{code}[text]
- [zhangsanR1]interface GigabitEthernet 0/0/0
- [zhangsanR1- GigabitEthernet0/0/0]ip address 192.168.1.1 255.255.255.0
- [zhangsanR1- GigabitEthernet0/0/0]
- \end{code}
-
- PC1可以Ping通R1的192.168.1.1地址
- \begin{code}[text]
- PC1> ping 192.168.1.1
- \end{code}
-
- R2上的命令:
- \begin{code}[text]
- [zhangsanR2]interface GigabitEthernet 0/0/1
- [zhangsanR1-GigabitEthernet0/0/1]ip address 192.168.3.1 255.255.255.0
- \end{code}
-
- PC2可以Ping通R2的192.168.3.1地址
-
- \begin{code}[text]
- PC1>ping 192.168.3.1
- \end{code}
-
- \item 为路由器R1的 Ethernet0/0/1接口配置IP地址，
- 为路由器R2的Ethernet0/0/0接口配置IP地址。
- 配置完成后路由器R1和R2应该可以互相Ping通。
- 要求记录输入的命令和输出（截屏）。
- \begin{code}[text]
- [zhangsanR1-GigabitEthernet0/0/1]ip address 192.168.2.1 255.255.255.0
- [zhangsanR1-GigabitEthernet0/0/1]quit
- \end{code}
-
- \begin{code}[text]
- [zhangsanR2-GigabitEthernet0/0/0]ip address 192.168.2.2 255.255.255.0
- [zhangsanR2-GigabitEthernet0/0/0]quit
- \end{code}
-
- \item （如在实验3.2的基础上进行实验则执行此步骤，否则直接配置第七步）
- 为RT1和RT2配置动态路由协议ospf，首先删除原来的rip配置。
- 要求记录输入的命令和输出（截屏或文本复制）。
- 配置后可以用display current configuration检查配置，
- 或者display ip routing-table检查路由表。
- 要求记录输入的命令和输出（截屏）。
- \begin{code}[text]
- [zhangsanR1]undo rip
- \end{code}
-
- \begin{figure}[!htp]
- \centering
- \includegraphics[width=12cm]{c3_confirm}
- \label{fig:c3_confirm}
- \end{figure}
-
- 确认删除？Y
-
- 此时用disp cur检查配置，rip相关配置全部删除；
-
- disp ip routing-table检查路由表，rip那条路由也将被删除
- \begin{code}[text]
- [zhangsanR2]undo rip
- \end{code}
- 确认删除？Y
-
- \item 为RT1和RT2配置动态路由协议ospf。
- 配置后可以用disp cur检查配置，或者disp ip routing-table检查路由表。
- 配置完成后路由器R1和R2应该可以互相Ping通。
- 要求记录输入的命令和输出（截屏）。
-
- \begin{code}[text]
- [zhangsanR1]ospf
- [zhangsanR1-ospf-1]area 0
- [zhangsanR1-ospf-1-area-0.0.0.0]network 192.168.1.0 0.0.0.255
- [zhangsanR1-ospf-1-area-0.0.0.0]network 192.168.2.0 0.0.0.255
- [ctrl+z]
- [zhangsanR1]ping 192.168.3.2
- \end{code}
-
- \begin{code}[text]
- [zhangsanR2]ospf
- [zhangsanR2-ospf-1]area 0
- [zhangsanR2-ospf-1-area-0.0.0.0]network 192.168.2.0 0.0.0.255
- [zhangsanR2-ospf-1-area-0.0.0.0]network 192.168.3.0 0.0.0.255
- [zhangsanR2-ospf-1-area-0.0.0.0]display ip routing-table
- [ctrl+z]
- [zhangsanR2]ping 192.168.1.2
- \end{code}
-
-\end{enumerate}
-
-\subsection{思考题}
-\label{subsec:c3_s3_rethink}
-
-Rip和OSPF协议的区别是什么？请对比路由表，收敛速度等。
-
-\subsection{注意事项及有关说明}
-\label{subsec:c3_s3_notice}
-
-\begin{enumerate}
- \item 路由器端口以具体选用的设备为准，
- 请将E0口和E1口对应到实际设备上的端口名称，
- 接口名由实际使用的路由器型号确定，
- 可能有Ethernet0/0/0；或GigabitEthernet0/0/x；或FastEthernet0/0/x。
- 如果是实际设备，请观察路由器前面板和后面板的端口名称，
- 并使用disp int或者disp cur命令查看端口的实际名称。
- 在对路由器进行配置时，可使用disp cur命令来检查当前路由器上生效的配置命令。
- \item 此实验的第1-5步骤同前一实验3.2-rip，
- 如在原rip基础上配置选第六步；
- 如是全新实验，则跳过第六步，直接配置第七步。
- \end{enumerate}
\ No newline at end of file
diff --git a/data/preface.tex b/data/preface.tex
index 3a80219..165382f 100644
--- a/data/preface.tex
+++ b/data/preface.tex
@@ -22,8 +22,11 @@
\begin{itemize}
\item 第一单元：谢怡、陈建发、洪劼超、雷蕴奇，厦门大学
- \item 第二单元：吴荻，国防科技大学
+ \item 第二单元：吴荻、周丽涛，国防科技大学
\item 第三单元：张晓丽，昆明理工大学
+ \item 第四单元：胡罡、孙志刚，国防科技大学
+ \item 第五单元：夏竟、蔡志平、徐明，国防科技大学
+ \item 统筹规划：徐明、夏竟，国防科技大学
\end{itemize}
\end{pre}
\ No newline at end of file
diff --git a/figure/appendixes/ensp/a1_ENSP-UI.png b/figure/appendixes/ensp/ENSP-UI.png
similarity index 100%
rename from figure/appendixes/ensp/a1_ENSP-UI.png
rename to figure/appendixes/ensp/ENSP-UI.png
diff --git a/figure/appendixes/ensp/a1_ENSP-help.png b/figure/appendixes/ensp/ENSP-help.png
similarity index 100%
rename from figure/appendixes/ensp/a1_ENSP-help.png
rename to figure/appendixes/ensp/ENSP-help.png
diff --git a/figure/appendixes/ensp/a1_ENSP-version.png b/figure/appendixes/ensp/a1_ENSP-version.png
deleted file mode 100644
index e7f4138..0000000
Binary files a/figure/appendixes/ensp/a1_ENSP-version.png and /dev/null differ
diff --git a/figure/appendixes/ensp/a1_error.png b/figure/appendixes/ensp/error.png
similarity index 100%
rename from figure/appendixes/ensp/a1_error.png
rename to figure/appendixes/ensp/error.png
diff --git a/figure/appendixes/openbox/f01.png b/figure/appendixes/openbox/f01.png
new file mode 100644
index 0000000..c92df2c
Binary files /dev/null and b/figure/appendixes/openbox/f01.png differ
diff --git a/figure/appendixes/openbox/f02.png b/figure/appendixes/openbox/f02.png
new file mode 100644
index 0000000..3f6f1a8
Binary files /dev/null and b/figure/appendixes/openbox/f02.png differ
diff --git a/figure/appendixes/openbox/f03.png b/figure/appendixes/openbox/f03.png
new file mode 100644
index 0000000..2360ba9
Binary files /dev/null and b/figure/appendixes/openbox/f03.png differ
diff --git a/figure/appendixes/openbox/f04.png b/figure/appendixes/openbox/f04.png
new file mode 100644
index 0000000..149bb7d
Binary files /dev/null and b/figure/appendixes/openbox/f04.png differ
diff --git a/figure/appendixes/openbox/f05.png b/figure/appendixes/openbox/f05.png
new file mode 100644
index 0000000..6c9bab7
Binary files /dev/null and b/figure/appendixes/openbox/f05.png differ
diff --git a/figure/appendixes/openbox/f06.png b/figure/appendixes/openbox/f06.png
new file mode 100644
index 0000000..cea7720
Binary files /dev/null and b/figure/appendixes/openbox/f06.png differ
diff --git a/figure/appendixes/openbox/f07.png b/figure/appendixes/openbox/f07.png
new file mode 100644
index 0000000..b9d20a5
Binary files /dev/null and b/figure/appendixes/openbox/f07.png differ
diff --git a/figure/appendixes/openbox/f08.png b/figure/appendixes/openbox/f08.png
new file mode 100644
index 0000000..c67efbe
Binary files /dev/null and b/figure/appendixes/openbox/f08.png differ
diff --git a/figure/appendixes/openbox/f09.png b/figure/appendixes/openbox/f09.png
new file mode 100644
index 0000000..2e64974
Binary files /dev/null and b/figure/appendixes/openbox/f09.png differ
diff --git a/figure/appendixes/openbox/f10.png b/figure/appendixes/openbox/f10.png
new file mode 100644
index 0000000..31ddcb9
Binary files /dev/null and b/figure/appendixes/openbox/f10.png differ
diff --git a/figure/appendixes/openbox/f11.png b/figure/appendixes/openbox/f11.png
new file mode 100644
index 0000000..ee5a310
Binary files /dev/null and b/figure/appendixes/openbox/f11.png differ
diff --git a/figure/appendixes/openbox/f12.png b/figure/appendixes/openbox/f12.png
new file mode 100644
index 0000000..ddd98f8
Binary files /dev/null and b/figure/appendixes/openbox/f12.png differ
diff --git a/figure/appendixes/openbox/f13.png b/figure/appendixes/openbox/f13.png
new file mode 100644
index 0000000..315c25b
Binary files /dev/null and b/figure/appendixes/openbox/f13.png differ
diff --git a/figure/appendixes/openbox/f14.png b/figure/appendixes/openbox/f14.png
new file mode 100644
index 0000000..fb2fdd2
Binary files /dev/null and b/figure/appendixes/openbox/f14.png differ
diff --git a/figure/appendixes/openbox/f15.png b/figure/appendixes/openbox/f15.png
new file mode 100644
index 0000000..1d46ca8
Binary files /dev/null and b/figure/appendixes/openbox/f15.png differ
diff --git a/figure/appendixes/openbox/f16.png b/figure/appendixes/openbox/f16.png
new file mode 100644
index 0000000..408ed26
Binary files /dev/null and b/figure/appendixes/openbox/f16.png differ
diff --git a/figure/appendixes/openbox/f17.png b/figure/appendixes/openbox/f17.png
new file mode 100644
index 0000000..f8604e9
Binary files /dev/null and b/figure/appendixes/openbox/f17.png differ
diff --git a/figure/appendixes/openbox/f18.png b/figure/appendixes/openbox/f18.png
new file mode 100644
index 0000000..ed563b7
Binary files /dev/null and b/figure/appendixes/openbox/f18.png differ
diff --git a/figure/appendixes/openbox/f19.png b/figure/appendixes/openbox/f19.png
new file mode 100644
index 0000000..0468a3a
Binary files /dev/null and b/figure/appendixes/openbox/f19.png differ
diff --git a/figure/appendixes/openbox/f20.png b/figure/appendixes/openbox/f20.png
new file mode 100644
index 0000000..b3ee7a7
Binary files /dev/null and b/figure/appendixes/openbox/f20.png differ
diff --git a/figure/appendixes/openbox/f21.png b/figure/appendixes/openbox/f21.png
new file mode 100644
index 0000000..3866bbf
Binary files /dev/null and b/figure/appendixes/openbox/f21.png differ
diff --git a/figure/appendixes/openbox/f22.png b/figure/appendixes/openbox/f22.png
new file mode 100644
index 0000000..7ae9490
Binary files /dev/null and b/figure/appendixes/openbox/f22.png differ
diff --git a/figure/appendixes/openbox/f23.png b/figure/appendixes/openbox/f23.png
new file mode 100644
index 0000000..241deaf
Binary files /dev/null and b/figure/appendixes/openbox/f23.png differ
diff --git a/figure/appendixes/openbox/f24.png b/figure/appendixes/openbox/f24.png
new file mode 100644
index 0000000..b30dccc
Binary files /dev/null and b/figure/appendixes/openbox/f24.png differ
diff --git a/figure/appendixes/openbox/f25.png b/figure/appendixes/openbox/f25.png
new file mode 100644
index 0000000..40e1eb6
Binary files /dev/null and b/figure/appendixes/openbox/f25.png differ
diff --git a/figure/appendixes/openbox/f26.png b/figure/appendixes/openbox/f26.png
new file mode 100644
index 0000000..a21459b
Binary files /dev/null and b/figure/appendixes/openbox/f26.png differ
diff --git a/figure/appendixes/openbox/f27.png b/figure/appendixes/openbox/f27.png
new file mode 100644
index 0000000..83ba863
Binary files /dev/null and b/figure/appendixes/openbox/f27.png differ
diff --git a/figure/appendixes/openbox/f28.png b/figure/appendixes/openbox/f28.png
new file mode 100644
index 0000000..4aa8f2a
Binary files /dev/null and b/figure/appendixes/openbox/f28.png differ
diff --git a/figure/appendixes/openbox/f29.png b/figure/appendixes/openbox/f29.png
new file mode 100644
index 0000000..f6a713b
Binary files /dev/null and b/figure/appendixes/openbox/f29.png differ
diff --git a/figure/appendixes/openbox/f30.png b/figure/appendixes/openbox/f30.png
new file mode 100644
index 0000000..0c26214
Binary files /dev/null and b/figure/appendixes/openbox/f30.png differ
diff --git a/figure/appendixes/openbox/f31.png b/figure/appendixes/openbox/f31.png
new file mode 100644
index 0000000..1cce3d1
Binary files /dev/null and b/figure/appendixes/openbox/f31.png differ
diff --git a/figure/appendixes/openbox/f32.png b/figure/appendixes/openbox/f32.png
new file mode 100644
index 0000000..ec5dcdd
Binary files /dev/null and b/figure/appendixes/openbox/f32.png differ
diff --git a/figure/chapter1/c1_echo-request.png b/figure/chapter1/c1_echo-request.png
deleted file mode 100644
index 1f0b83a..0000000
Binary files a/figure/chapter1/c1_echo-request.png and /dev/null differ
diff --git a/figure/chapter1/c1_ip-view.png b/figure/chapter1/c1_ip-view.png
deleted file mode 100644
index bf1547f..0000000
Binary files a/figure/chapter1/c1_ip-view.png and /dev/null differ
diff --git a/figure/chapter1/c1_traceroute-exec.png b/figure/chapter1/c1_traceroute-exec.png
deleted file mode 100644
index cb20b0a..0000000
Binary files a/figure/chapter1/c1_traceroute-exec.png and /dev/null differ
diff --git a/figure/chapter1/c1_wireshark-filter-setup.png b/figure/chapter1/c1_wireshark-filter-setup.png
deleted file mode 100644
index 33aa6c7..0000000
Binary files a/figure/chapter1/c1_wireshark-filter-setup.png and /dev/null differ
diff --git a/figure/chapter1/c1_wireshark-monitor.png b/figure/chapter1/c1_wireshark-monitor.png
deleted file mode 100644
index 60c8c96..0000000
Binary files a/figure/chapter1/c1_wireshark-monitor.png and /dev/null differ
diff --git a/figure/chapter3/c3_OSPF-topo.png b/figure/chapter3/c3_OSPF-topo.png
deleted file mode 100644
index 8983c02..0000000
Binary files a/figure/chapter3/c3_OSPF-topo.png and /dev/null differ
diff --git a/figure/chapter3/c3_RIP-topo.png b/figure/chapter3/c3_RIP-topo.png
deleted file mode 100644
index 8983c02..0000000
Binary files a/figure/chapter3/c3_RIP-topo.png and /dev/null differ
diff --git a/figure/chapter3/c3_confirm.jpg b/figure/chapter3/c3_confirm.jpg
deleted file mode 100644
index 4f4cad0..0000000
Binary files a/figure/chapter3/c3_confirm.jpg and /dev/null differ
diff --git a/figure/chapter3/c3_ping_1.png b/figure/chapter3/c3_ping_1.png
deleted file mode 100644
index 02241de..0000000
Binary files a/figure/chapter3/c3_ping_1.png and /dev/null differ
diff --git a/figure/chapter3/c3_ping_2.jpg b/figure/chapter3/c3_ping_2.jpg
deleted file mode 100644
index fd6779e..0000000
Binary files a/figure/chapter3/c3_ping_2.jpg and /dev/null differ
diff --git a/figure/chapter3/c3_static-topo.png b/figure/chapter3/c3_static-topo.png
deleted file mode 100644
index 8983c02..0000000
Binary files a/figure/chapter3/c3_static-topo.png and /dev/null differ
diff --git a/figure/chapter3/c3_sysname-R1_1.png b/figure/chapter3/c3_sysname-R1_1.png
deleted file mode 100644
index 734ad5c..0000000
Binary files a/figure/chapter3/c3_sysname-R1_1.png and /dev/null differ
diff --git a/figure/chapter3/c3_sysname-R1_2.jpg b/figure/chapter3/c3_sysname-R1_2.jpg
deleted file mode 100644
index 64e0264..0000000
Binary files a/figure/chapter3/c3_sysname-R1_2.jpg and /dev/null differ
diff --git a/figure/chapter3/c3_sysname-R1_3.jpg b/figure/chapter3/c3_sysname-R1_3.jpg
deleted file mode 100644
index 64e0264..0000000
Binary files a/figure/chapter3/c3_sysname-R1_3.jpg and /dev/null differ
diff --git a/figure/chapter3/c3_sysname-R2_1.png b/figure/chapter3/c3_sysname-R2_1.png
deleted file mode 100644
index d9d538f..0000000
Binary files a/figure/chapter3/c3_sysname-R2_1.png and /dev/null differ
diff --git a/figure/chapter3/c3_sysname-R2_2.jpg b/figure/chapter3/c3_sysname-R2_2.jpg
deleted file mode 100644
index 85f674b..0000000
Binary files a/figure/chapter3/c3_sysname-R2_2.jpg and /dev/null differ
diff --git a/figure/chapter3/c3_sysname-R2_3.jpg b/figure/chapter3/c3_sysname-R2_3.jpg
deleted file mode 100644
index 85f674b..0000000
Binary files a/figure/chapter3/c3_sysname-R2_3.jpg and /dev/null differ
diff --git a/figure/chapters/ensp/OSPF-topo.png b/figure/chapters/ensp/OSPF-topo.png
new file mode 100644
index 0000000..ce8eea1
Binary files /dev/null and b/figure/chapters/ensp/OSPF-topo.png differ
diff --git a/figure/chapters/ensp/RIP-topo.png b/figure/chapters/ensp/RIP-topo.png
new file mode 100644
index 0000000..ce8eea1
Binary files /dev/null and b/figure/chapters/ensp/RIP-topo.png differ
diff --git a/figure/chapters/ensp/ping_1.png b/figure/chapters/ensp/ping_1.png
new file mode 100644
index 0000000..9e67fc7
Binary files /dev/null and b/figure/chapters/ensp/ping_1.png differ
diff --git a/figure/chapters/ensp/ping_2.png b/figure/chapters/ensp/ping_2.png
new file mode 100644
index 0000000..9e67fc7
Binary files /dev/null and b/figure/chapters/ensp/ping_2.png differ
diff --git a/figure/chapters/ensp/static-topo.png b/figure/chapters/ensp/static-topo.png
new file mode 100644
index 0000000..ce8eea1
Binary files /dev/null and b/figure/chapters/ensp/static-topo.png differ
diff --git a/figure/chapters/ensp/sysname-R1_1.png b/figure/chapters/ensp/sysname-R1_1.png
new file mode 100644
index 0000000..a3b9fa1
Binary files /dev/null and b/figure/chapters/ensp/sysname-R1_1.png differ
diff --git a/figure/chapters/ensp/sysname-R1_2.png b/figure/chapters/ensp/sysname-R1_2.png
new file mode 100644
index 0000000..a3b9fa1
Binary files /dev/null and b/figure/chapters/ensp/sysname-R1_2.png differ
diff --git a/figure/chapters/ensp/sysname-R1_3.png b/figure/chapters/ensp/sysname-R1_3.png
new file mode 100644
index 0000000..a3b9fa1
Binary files /dev/null and b/figure/chapters/ensp/sysname-R1_3.png differ
diff --git a/figure/chapters/ensp/sysname-R2_1.png b/figure/chapters/ensp/sysname-R2_1.png
new file mode 100644
index 0000000..4541556
Binary files /dev/null and b/figure/chapters/ensp/sysname-R2_1.png differ
diff --git a/figure/chapters/ensp/sysname-R2_2.png b/figure/chapters/ensp/sysname-R2_2.png
new file mode 100644
index 0000000..4541556
Binary files /dev/null and b/figure/chapters/ensp/sysname-R2_2.png differ
diff --git a/figure/chapters/ensp/sysname-R2_3.png b/figure/chapters/ensp/sysname-R2_3.png
new file mode 100644
index 0000000..4541556
Binary files /dev/null and b/figure/chapters/ensp/sysname-R2_3.png differ
diff --git a/figure/chapters/router-openbox/networking-topo.pdf b/figure/chapters/router-openbox/networking-topo.pdf
new file mode 100644
index 0000000..b4a67e6
Binary files /dev/null and b/figure/chapters/router-openbox/networking-topo.pdf differ
diff --git a/figure/chapters/router-openbox/router-topo.pdf b/figure/chapters/router-openbox/router-topo.pdf
new file mode 100644
index 0000000..ebed0a1
Binary files /dev/null and b/figure/chapters/router-openbox/router-topo.pdf differ
diff --git a/figure/chapters/router-openbox/switch-topo.pdf b/figure/chapters/router-openbox/switch-topo.pdf
new file mode 100644
index 0000000..7bbf12c
Binary files /dev/null and b/figure/chapters/router-openbox/switch-topo.pdf differ
diff --git a/figure/chapters/sdn-openbox/empty-flowtable.jpg b/figure/chapters/sdn-openbox/empty-flowtable.jpg
new file mode 100644
index 0000000..49c76a9
Binary files /dev/null and b/figure/chapters/sdn-openbox/empty-flowtable.jpg differ
diff --git a/figure/chapters/sdn-openbox/flowtable-ping.jpg b/figure/chapters/sdn-openbox/flowtable-ping.jpg
new file mode 100644
index 0000000..4978088
Binary files /dev/null and b/figure/chapters/sdn-openbox/flowtable-ping.jpg differ
diff --git a/figure/chapters/sdn-openbox/ns-topo.pdf b/figure/chapters/sdn-openbox/ns-topo.pdf
new file mode 100644
index 0000000..2899166
Binary files /dev/null and b/figure/chapters/sdn-openbox/ns-topo.pdf differ
diff --git a/figure/chapters/sdn-openbox/openflow-topo.pdf b/figure/chapters/sdn-openbox/openflow-topo.pdf
new file mode 100644
index 0000000..1a88bdb
Binary files /dev/null and b/figure/chapters/sdn-openbox/openflow-topo.pdf differ
diff --git a/figure/chapters/sdn-openbox/port-flowtable.jpg b/figure/chapters/sdn-openbox/port-flowtable.jpg
new file mode 100644
index 0000000..360c1bd
Binary files /dev/null and b/figure/chapters/sdn-openbox/port-flowtable.jpg differ
diff --git a/figure/chapters/sdn-openbox/sdn-host.jpg b/figure/chapters/sdn-openbox/sdn-host.jpg
new file mode 100644
index 0000000..332c95d
Binary files /dev/null and b/figure/chapters/sdn-openbox/sdn-host.jpg differ
diff --git a/figure/chapters/sdn-openbox/sdn-switch.jpg b/figure/chapters/sdn-openbox/sdn-switch.jpg
new file mode 100644
index 0000000..88decd6
Binary files /dev/null and b/figure/chapters/sdn-openbox/sdn-switch.jpg differ
diff --git a/figure/chapters/sdn-openbox/sdn-test-topo.jpg b/figure/chapters/sdn-openbox/sdn-test-topo.jpg
new file mode 100644
index 0000000..444d449
Binary files /dev/null and b/figure/chapters/sdn-openbox/sdn-test-topo.jpg differ
diff --git a/figure/chapters/sdn-openbox/sdn-topo.pdf b/figure/chapters/sdn-openbox/sdn-topo.pdf
new file mode 100644
index 0000000..7694945
Binary files /dev/null and b/figure/chapters/sdn-openbox/sdn-topo.pdf differ
diff --git a/figure/chapter2/c2_tcp-flow.png b/figure/chapters/socket/tcp-flow.png
similarity index 100%
rename from figure/chapter2/c2_tcp-flow.png
rename to figure/chapters/socket/tcp-flow.png
diff --git a/figure/chapter2/c2_udp-flow.png b/figure/chapters/socket/udp-flow.png
similarity index 100%
rename from figure/chapter2/c2_udp-flow.png
rename to figure/chapters/socket/udp-flow.png
diff --git a/figure/chapter1/c1_TCP-status-machine.png b/figure/chapters/wireshark/TCP-status-machine.png
similarity index 100%
rename from figure/chapter1/c1_TCP-status-machine.png
rename to figure/chapters/wireshark/TCP-status-machine.png
diff --git a/figure/chapter1/c1_TCP-structure.png b/figure/chapters/wireshark/TCP-structure.png
similarity index 100%
rename from figure/chapter1/c1_TCP-structure.png
rename to figure/chapters/wireshark/TCP-structure.png
diff --git a/figure/chapter1/c1_TCP-time-line.png b/figure/chapters/wireshark/TCP-time-line.png
similarity index 100%
rename from figure/chapter1/c1_TCP-time-line.png
rename to figure/chapters/wireshark/TCP-time-line.png
diff --git a/figure/chapter1/c1_TCP-topo.png b/figure/chapters/wireshark/TCP-topo.png
similarity index 100%
rename from figure/chapter1/c1_TCP-topo.png
rename to figure/chapters/wireshark/TCP-topo.png
diff --git a/figure/chapter1/c1_VM-advance-setup.png b/figure/chapters/wireshark/VM-advance-setup.png
similarity index 100%
rename from figure/chapter1/c1_VM-advance-setup.png
rename to figure/chapters/wireshark/VM-advance-setup.png
diff --git a/figure/chapter1/c1_arp-format.png b/figure/chapters/wireshark/arp-format.png
similarity index 100%
rename from figure/chapter1/c1_arp-format.png
rename to figure/chapters/wireshark/arp-format.png
diff --git a/figure/chapters/wireshark/echo-request.png b/figure/chapters/wireshark/echo-request.png
new file mode 100644
index 0000000..3b09a2f
Binary files /dev/null and b/figure/chapters/wireshark/echo-request.png differ
diff --git a/figure/chapter1/c1_eth-frame-detail.png b/figure/chapters/wireshark/eth-frame-detail.png
similarity index 100%
rename from figure/chapter1/c1_eth-frame-detail.png
rename to figure/chapters/wireshark/eth-frame-detail.png
diff --git a/figure/chapter1/c1_icmp-structure.png b/figure/chapters/wireshark/icmp-structure.png
similarity index 100%
rename from figure/chapter1/c1_icmp-structure.png
rename to figure/chapters/wireshark/icmp-structure.png
diff --git a/figure/chapter1/c1_io-graphs.png b/figure/chapters/wireshark/io-graphs.png
similarity index 100%
rename from figure/chapter1/c1_io-graphs.png
rename to figure/chapters/wireshark/io-graphs.png
diff --git a/figure/chapter1/c1_ip-structure.png b/figure/chapters/wireshark/ip-structure.png
similarity index 100%
rename from figure/chapter1/c1_ip-structure.png
rename to figure/chapters/wireshark/ip-structure.png
diff --git a/figure/chapters/wireshark/ip-view.png b/figure/chapters/wireshark/ip-view.png
new file mode 100644
index 0000000..c334323
Binary files /dev/null and b/figure/chapters/wireshark/ip-view.png differ
diff --git a/figure/chapter1/c1_ping-exec.png b/figure/chapters/wireshark/ping-exec.png
similarity index 100%
rename from figure/chapter1/c1_ping-exec.png
rename to figure/chapters/wireshark/ping-exec.png
diff --git a/figure/chapters/wireshark/traceroute-exec.png b/figure/chapters/wireshark/traceroute-exec.png
new file mode 100644
index 0000000..2bbf747
Binary files /dev/null and b/figure/chapters/wireshark/traceroute-exec.png differ
diff --git a/figure/chapter1/c1_wireshark-boot-ui.png b/figure/chapters/wireshark/wireshark-boot-ui.png
similarity index 100%
rename from figure/chapter1/c1_wireshark-boot-ui.png
rename to figure/chapters/wireshark/wireshark-boot-ui.png
diff --git a/figure/chapters/wireshark/wireshark-filter-setup.png b/figure/chapters/wireshark/wireshark-filter-setup.png
new file mode 100644
index 0000000..57aca81
Binary files /dev/null and b/figure/chapters/wireshark/wireshark-filter-setup.png differ
diff --git a/figure/chapter1/c1_wireshark-filters.png b/figure/chapters/wireshark/wireshark-filters.png
similarity index 100%
rename from figure/chapter1/c1_wireshark-filters.png
rename to figure/chapters/wireshark/wireshark-filters.png
diff --git a/figure/chapter1/c1_wireshark-main-ui.png b/figure/chapters/wireshark/wireshark-main-ui.png
similarity index 100%
rename from figure/chapter1/c1_wireshark-main-ui.png
rename to figure/chapters/wireshark/wireshark-main-ui.png
diff --git a/figure/chapters/wireshark/wireshark-monitor.png b/figure/chapters/wireshark/wireshark-monitor.png
new file mode 100644
index 0000000..59eff93
Binary files /dev/null and b/figure/chapters/wireshark/wireshark-monitor.png differ
diff --git a/figure/chapter1/c1_wireshark-save.png b/figure/chapters/wireshark/wireshark-save.png
similarity index 100%
rename from figure/chapter1/c1_wireshark-save.png
rename to figure/chapters/wireshark/wireshark-save.png
diff --git a/figure/chapter1/c1_wireshark-setup-ui.png b/figure/chapters/wireshark/wireshark-setup-ui.png
similarity index 100%
rename from figure/chapter1/c1_wireshark-setup-ui.png
rename to figure/chapters/wireshark/wireshark-setup-ui.png
diff --git a/figure/chapter1/c1_wireshark-special-type.png b/figure/chapters/wireshark/wireshark-special-type.png
similarity index 100%
rename from figure/chapter1/c1_wireshark-special-type.png
rename to figure/chapters/wireshark/wireshark-special-type.png
diff --git a/figure/chapter1/c1_wireshark-statistic.png b/figure/chapters/wireshark/wireshark-statistic.png
similarity index 100%
rename from figure/chapter1/c1_wireshark-statistic.png
rename to figure/chapters/wireshark/wireshark-statistic.png
diff --git a/figure/src/openbox_topo.vsd b/figure/src/openbox_topo.vsd
new file mode 100755
index 0000000..c877e22
Binary files /dev/null and b/figure/src/openbox_topo.vsd differ
diff --git a/instructions.tex b/instructions.tex
deleted file mode 100644
index fd8aee7..0000000
--- a/instructions.tex
+++ /dev/null
@@ -1,86 +0,0 @@
-%# -*- coding: utf-8-unix -*-
-%=========================================================================
-% instructions.tex for Computer Network Assigenment & Project Instructions
-%=========================================================================
-% 双面打印
-\documentclass{instructions}
-\addbibresource{bib/main.bib} % 导入参考文献数据库
-\begin{document}
-\pagestyle{empty}
-\include{data/cover} % 载入封面
-
-\begin{center}
- \Large{\sffamily\bfseries\heiti Version 0.4} \\ \vspace{2em}
- \Large{\sffamily\bfseries\heiti 发布日期: \today} \\ \vspace{1em}
- % \Large{\sffamily\bfseries\heiti 任何建议及错误信息请发送至邮箱} \\
- % \texttt{jey74165@163.com}
-\end{center}
-% \vfill
-% \vspace{30em}
-% \begin{tabular*}{\textwidth}{ccc}
-% \includegraphics{figure/by-nc.eps}
-% & \begin{minipage}[b]{0.6\textwidth}
-% \small\sffamily
-% 本作品采用知识共享 署名-非商业性使用 4.0 国际许可协议进行许可。\\
-% 访问~\href{http://creativecommons.org/licenses/by-nc/4.0/}{此链接}~查看该许可协议。
-% \end{minipage}
-% \end{tabular*}
-
-\thispagestyle{empty}
-\frontmatter % 对前言和概览用罗马数字作为页码
-\pagestyle{empty}
-\include{data/preface}
-\cleardoublepage
-\pagestyle{empty}
-\tableofcontents
-% \cleardoublepage
-% \include{tex/overview}
-\mainmatter % 对正文用阿拉伯数字作为页码
-
-%======================================================================
-% 正文内容
-\pagestyle{fancy}
-\setcounter{page}{1}
-
-\graphicspath{{figure/chapter1/}}
-\include{data/chapter1/preface}
-\include{data/chapter1/section1}
-\include{data/chapter1/section2}
-\include{data/chapter1/section3}
-
-\graphicspath{{figure/chapter2/}}
-\include{data/chapter2/preface}
-\include{data/chapter2/section1}
-\include{data/chapter2/section2}
-\include{data/chapter2/section3}
-
-\graphicspath{{figure/chapter3/}}
-\include{data/chapter3/preface}
-\include{data/chapter3/section1}
-\include{data/chapter3/section2}
-\include{data/chapter3/section3}
-
-\appendix
-\titleformat{\chapter}[display]{\flushleft}{
- \begin{tikzpicture}
- \node[anchor=south west] (chap) at (0,1.3){
- \Large\heiti {附录\Alph{chapter}}};
- \path [left color=c1,right color=c3] (0,-0.3) rectangle (\textwidth,-0.5);
- \path(0,-0.2);
- \end{tikzpicture}
-}{-30mm}{\Huge\heiti}
-\titlespacing{\chapter}{0pt}{0pt}{2\baselineskip}
-\renewcommand{\thefigure}{\Alph{chapter}--\arabic{figure}}
-\renewcommand{\thetable}{\Alph{chapter}--\arabic{table}}
-\renewcommand{\chaptername}{附录\Alph{chapter}}
-
-\graphicspath{{figure/appendixes/ensp/}}
-\include{data/appendix/ensp}
-
-\backmatter
-%======================================================================
-% 打印参考文献
-% \printbibliography[heading=bibintoc]
-% \makeatletter
-% \makeatother
-\end{document}
\ No newline at end of file