Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
Miykael_xxm
RCore Tutorial Book V3
提交
96a76265
R
RCore Tutorial Book V3
项目概览
Miykael_xxm
/
RCore Tutorial Book V3
与 Fork 源项目一致
Fork自
rcore-os / RCore Tutorial Book V3
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
R
RCore Tutorial Book V3
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
前往新版Gitcode,体验更适合开发者的 AI 搜索 >>
提交
96a76265
编写于
11月 03, 2020
作者:
Y
Yifan Wu
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update chapter1 2020-11-03
上级
3a12b68d
变更
10
隐藏空白更改
内联
并排
Showing
10 changed file
with
718 addition
and
22 deletion
+718
-22
docs/_sources/chapter1/1app-ee-platform.rst.txt
docs/_sources/chapter1/1app-ee-platform.rst.txt
+81
-7
docs/_sources/chapter1/1remove-std.rst.txt
docs/_sources/chapter1/1remove-std.rst.txt
+52
-5
docs/_sources/chapter1/index.rst.txt
docs/_sources/chapter1/index.rst.txt
+1
-1
docs/chapter1/1app-ee-platform.html
docs/chapter1/1app-ee-platform.html
+360
-0
docs/chapter1/1remove-std.html
docs/chapter1/1remove-std.html
+44
-4
docs/chapter1/index.html
docs/chapter1/index.html
+3
-3
docs/objects.inv
docs/objects.inv
+0
-0
docs/searchindex.js
docs/searchindex.js
+1
-1
source/chapter1/1app-ee-platform.rst
source/chapter1/1app-ee-platform.rst
+175
-0
source/chapter1/index.rst
source/chapter1/index.rst
+1
-1
未找到文件。
source/chapter1/1remove-std.rs
t
→
docs/_sources/chapter1/1app-ee-platform.rst.tx
t
浏览文件 @
96a76265
移除标准库依赖
===========================
应用程序运行环境与平台支持
===========================
=====================
.. toctree::
:hidden:
...
...
@@ -52,7 +52,11 @@
如下图所示,应用程序的运行需要下面一套运行环境栈的支持:
.. image:: app-software-stack.png
.. _app-software-stack:
.. figure:: app-software-stack.png
应用程序运行环境栈
图中的白色块自上而下(越往下则越靠近底层,下层作为上层的执行环境支持上层代码的运行)表示各级运行环境,黑色块则表示相邻两层运行环境之间
的接口。
...
...
@@ -70,9 +74,23 @@
``Hello, world!`` 用到了哪些系统调用?
从之前的 ``cargo run`` 的输出可以看出之前构建的可执行文件是在 target/debug 目录下的 os 。
在 Ubuntu 系统上,可以通过 ``strace`` 工具来运行一个程序并输出程序运行过程当中向内核请求的所有的系统调用及其返回值。
我们只需输入 ``strace target/debug/os`` 即可看到一长串的系统调用。
其中,真正容易看出与 ``Hello, world!`` 相关的只有一个系统调用:
.. code-block::
write(1, "Hello, world!\n", 14) = 14
其参数的具体含义我们暂且不在这里进行解释。
其余的系统调用基本上分别用于函数库和内核两层执行环境的初始化工作和对于上层的运行期监控和管理。之后,随着应用场景的复杂化,我们
需要更强的抽象能力,也会实现这里面的一些系统调用。
从硬件的角度来看,它上面的一切都属于软件。硬件可以分为三种: 处理器 (Processor) ——它更常见的名字是中央处理单元 (CPU, Central Processing Unit),
内存 (Memory) 还有 I/O 设备。其中处理器无疑是其中最复杂同时也最关键的一个。它与软件约定一套 **指令集
架
构** (ISA, Instruction Set Architecture),
内存 (Memory) 还有 I/O 设备。其中处理器无疑是其中最复杂同时也最关键的一个。它与软件约定一套 **指令集
体系结
构** (ISA, Instruction Set Architecture),
使得软件可以通过 ISA 中提供的汇编指令来访问各种硬件资源。软件当然也需要知道处理器会如何执行这些指令:最简单的话就是一条一条执行位于内存
中的指令。当然,实际的情况远比这个要复杂得多,为了适应现代应用程序的场景,处理器还需要提供很多额外的机制,而不仅仅是让数据在 CPU 寄存器、内存和 I/O 设备
三者之间流动。
...
...
@@ -94,8 +112,64 @@
操作系统如 Windows/Linux/macOS 等的抽象都支持同时运行很多应用程序,在嵌入式场景是过抽象的。因此,常见的解决方案是仅使用函数库构建
单独的应用程序或是用专为应用场景特别裁减过的轻量级内核管理少数应用程序。
目标三元组
--------------------
平台与目标三元组
---------------------------------------
对于一份用某种编程语言实现的源代码而言,编译器在将其通过编译、链接得到目标文件的时候需要知道程序要在哪个 **平台** (Platform) 上运行。
从上面给出的 :ref:`应用程序运行环境栈 <app-software-stack>` 可以看出:
- 如果用户态基于的内核不同,会导致系统调用接口不同或者语义不一致;
- 如果底层硬件不同,对于硬件资源的访问方式会有差异。特别是 ISA 不同的话,对上提供的指令集和寄存器都不同。
它们都会导致最终生成的目标文件有很大不同。需要指出的是,某些编译器支持同一份源代码无需修改就可编译到多个不同的目标平台并在上面运行。这种
情况下,源代码是 **跨平台** 的。而另一些编译器则已经预设好了一个固定的目标平台。
我们可以通过 **目标三元组** (Target Triple) 来描述一个目标平台。它一般包括 CPU 架构、CPU 厂商和操作系统,它们确实都会控制目标文件的生成。
比如,我们可以尝试看一下之前的 ``Hello, world!`` 的目标平台是什么。这可以通过打印编译器 rustc 的默认配置信息:
.. code-block:: console
$ rustc --version --verbose
rustc 1.48.0-nightly (73dc675b9 2020-09-06)
binary: rustc
commit-hash: 73dc675b9437c2a51a975a9f58cc66f05463c351
commit-date: 2020-09-06
host: x86_64-unknown-linux-gnu
release: 1.48.0-nightly
LLVM version: 11.0
从其中的 host 一项可以看出默认的目标平台是 ``x86_64-unknown-linux-gnu``,其中 CPU 架构是 x86_64,CPU 厂商是 unknown,操作系统是 linux-gnu。
这种无论编译器还是其目标文件都在我们当前所处的平台运行是一种最简单也最普遍的情况。但是很快我们就将遇到另外一种情况。
讲了这么多,终于该介绍我们的主线任务了。我们希望能够在另一个平台上运行 ``Hello, world!``,而与之前的默认平台不同的地方在于,我们将 CPU 架构从
x86_64 换成 RISC-V。
.. note::
为何基于 RISC-V 架构而非 x86 系列架构?
x86 架构为了在升级换代的同时保持对基于旧版架构应用程序/内核的兼容性,存在大量的历史包袱,也就是一些对于目前的应用场景没有任何意义,但又必须
花大量时间正确设置才能正常使用 CPU 的奇怪设定。为了建立并维护架构的应用生态,这确实是必不可少的,但站在教学的角度几乎完全是在浪费时间。而
新生的 RISC-V 架构十分简洁,架构文档需要阅读的核心部分不足百页,且这些功能已经足以用来构造一个具有相当抽象能力的内核了。
可以看一下目前 Rust 编译器支持哪些基于 RISC-V 的平台:
.. code-block:: console
$ rustc --print target-list | grep riscv
riscv32i-unknown-none-elf
riscv32imac-unknown-none-elf
riscv32imc-unknown-none-elf
riscv64gc-unknown-linux-gnu
riscv64gc-unknown-none-elf
riscv64imac-unknown-none-elf
这里我们选择的是 ``riscv64gc-unknown-none-elf``,目标三元组中的操作系统是 none-elf,表明没有任何系统调用支持。这里我们之所以不选择有
linux-gnu 系统调用支持的版本 ``riscv64gc-unknown-linux-gnu``,是因为我们只是想跑一个 ``Hello, world!``,没有必要使用操作系统所提供的
那么高级的抽象。而且我们很清楚后续我们要开发的是一个内核,如果仅仅基于已有操作系统提供的系统调用的话,它自身的抽象能力会受到很大限制。所以它必须
直面底层硬件来解锁更大的抽象能力上限。
.. note::
RISC-V 指令集拓展
\ No newline at end of file
docs/_sources/chapter1/1remove-std.rst.txt
浏览文件 @
96a76265
...
...
@@ -52,7 +52,11 @@
如下图所示,应用程序的运行需要下面一套运行环境栈的支持:
.. image:: app-software-stack.png
.. _app-software-stack:
.. figure:: app-software-stack.png
应用程序运行环境栈
图中的白色块自上而下(越往下则越靠近底层,下层作为上层的执行环境支持上层代码的运行)表示各级运行环境,黑色块则表示相邻两层运行环境之间
的接口。
...
...
@@ -70,9 +74,23 @@
``Hello, world!`` 用到了哪些系统调用?
从之前的 ``cargo run`` 的输出可以看出之前构建的可执行文件是在 target/debug 目录下的 os 。
在 Ubuntu 系统上,可以通过 ``strace`` 工具来运行一个程序并输出程序运行过程当中向内核请求的所有的系统调用及其返回值。
我们只需输入 ``strace target/debug/os`` 即可看到一长串的系统调用。
其中,真正容易看出与 ``Hello, world!`` 相关的只有一个系统调用:
.. code-block::
write(1, "Hello, world!\n", 14) = 14
其参数的具体含义我们暂且不在这里进行解释。
其余的系统调用基本上分别用于函数库和内核两层执行环境的初始化工作和对于上层的运行期监控和管理。之后,随着应用场景的复杂化,我们
需要更强的抽象能力,也会实现这里面的一些系统调用。
从硬件的角度来看,它上面的一切都属于软件。硬件可以分为三种: 处理器 (Processor) ——它更常见的名字是中央处理单元 (CPU, Central Processing Unit),
内存 (Memory) 还有 I/O 设备。其中处理器无疑是其中最复杂同时也最关键的一个。它与软件约定一套 **指令集
架
构** (ISA, Instruction Set Architecture),
内存 (Memory) 还有 I/O 设备。其中处理器无疑是其中最复杂同时也最关键的一个。它与软件约定一套 **指令集
体系结
构** (ISA, Instruction Set Architecture),
使得软件可以通过 ISA 中提供的汇编指令来访问各种硬件资源。软件当然也需要知道处理器会如何执行这些指令:最简单的话就是一条一条执行位于内存
中的指令。当然,实际的情况远比这个要复杂得多,为了适应现代应用程序的场景,处理器还需要提供很多额外的机制,而不仅仅是让数据在 CPU 寄存器、内存和 I/O 设备
三者之间流动。
...
...
@@ -94,8 +112,37 @@
操作系统如 Windows/Linux/macOS 等的抽象都支持同时运行很多应用程序,在嵌入式场景是过抽象的。因此,常见的解决方案是仅使用函数库构建
单独的应用程序或是用专为应用场景特别裁减过的轻量级内核管理少数应用程序。
目标三元组
--------------------
平台与目标三元组
---------------------------------------
对于一份用某种编程语言实现的源代码而言,编译器在将其通过编译、链接得到目标文件的时候需要知道程序要在哪个 **平台** (Platform) 上运行。
从上面给出的 :ref:`应用程序运行环境栈 <app-software-stack>` 可以看出:
- 如果用户态基于的内核不同,会导致系统调用接口不同或者语义不一致;
- 如果底层硬件不同,对于硬件资源的访问方式会有差异。特别是 ISA 不同的话,对上提供的指令集和寄存器都不同。
它们都会导致最终生成的目标文件有很大不同。需要指出的是,某些编译器支持同一份源代码无需修改就可编译到多个不同的目标平台并在上面运行。这种
情况下,源代码是 **跨平台** 的。而另一些编译器则已经预设好了一个固定的目标平台。
我们可以通过 **目标三元组** (Target Triple) 来描述一个目标平台。它一般包括 CPU 架构、CPU 厂商和操作系统,它们确实都会控制目标文件的生成。
比如,我们可以尝试看一下之前的 ``Hello, world!`` 的目标平台是什么。这可以通过打印编译器 rustc 的默认配置信息:
.. code-block:: console
$ rustc --version --verbose
rustc 1.48.0-nightly (73dc675b9 2020-09-06)
binary: rustc
commit-hash: 73dc675b9437c2a51a975a9f58cc66f05463c351
commit-date: 2020-09-06
host: x86_64-unknown-linux-gnu
release: 1.48.0-nightly
LLVM version: 11.0
从其中的 host 一项可以看出默认的目标平台是 ``x86_64-unknown-linux-gnu``,其中 CPU 架构是 x86_64,CPU 厂商是 unknown,操作系统是 linux-gnu。
这种无论编译器还是目标文件都在我们当前所处的平台运行是一种最简单也最普遍的情况。但是很快我们就将遇到另外一种情况。
讲了这么多,终于该介绍我们的主线任务了。我们希望能够在另一个平台上运行 ``Hello, world!``,而与之前的默认平台不同的地方在于:
- CPU 架构从 x86_64 换成 RISC-V 架构;
- 操作系统从 linux-gnu 换成 none-elf,也就是没有任何系统调用支持。
\ No newline at end of file
docs/_sources/chapter1/index.rst.txt
浏览文件 @
96a76265
...
...
@@ -6,4 +6,4 @@
:hidden:
:maxdepth: 3
1remove-std
\ No newline at end of file
1app-ee-platform
\ No newline at end of file
docs/chapter1/1app-ee-platform.html
0 → 100644
浏览文件 @
96a76265
<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!-->
<html
class=
"no-js"
lang=
"en"
>
<!--<![endif]-->
<head>
<meta
charset=
"utf-8"
>
<meta
name=
"viewport"
content=
"width=device-width, initial-scale=1.0"
>
<title>
应用程序运行环境与平台支持
—
rCore-Tutorial-Book-v3 0.1 documentation
</title>
<script
type=
"text/javascript"
src=
"../_static/js/modernizr.min.js"
></script>
<script
type=
"text/javascript"
id=
"documentation_options"
data-url_root=
"../"
src=
"../_static/documentation_options.js"
></script>
<script
src=
"../_static/jquery.js"
></script>
<script
src=
"../_static/underscore.js"
></script>
<script
src=
"../_static/doctools.js"
></script>
<script
src=
"../_static/language_data.js"
></script>
<script
async=
"async"
src=
"https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/latest.js?config=TeX-AMS-MML_HTMLorMML"
></script>
<script
type=
"text/javascript"
src=
"../_static/js/theme.js"
></script>
<link
rel=
"stylesheet"
href=
"../_static/css/theme.css"
type=
"text/css"
/>
<link
rel=
"stylesheet"
href=
"../_static/pygments.css"
type=
"text/css"
/>
<link
rel=
"index"
title=
"Index"
href=
"../genindex.html"
/>
<link
rel=
"search"
title=
"Search"
href=
"../search.html"
/>
<link
rel=
"next"
title=
"reStructuredText 基本语法"
href=
"../rest-example.html"
/>
<link
rel=
"prev"
title=
"第一章:编译运行 RV64 裸机程序"
href=
"index.html"
/>
</head>
<body
class=
"wy-body-for-nav"
>
<div
class=
"wy-grid-for-nav"
>
<nav
data-toggle=
"wy-nav-shift"
class=
"wy-nav-side"
>
<div
class=
"wy-side-scroll"
>
<div
class=
"wy-side-nav-search"
>
<a
href=
"../index.html"
class=
"icon icon-home"
>
rCore-Tutorial-Book-v3
</a>
<div
role=
"search"
>
<form
id=
"rtd-search-form"
class=
"wy-form"
action=
"../search.html"
method=
"get"
>
<input
type=
"text"
name=
"q"
placeholder=
"Search docs"
/>
<input
type=
"hidden"
name=
"check_keywords"
value=
"yes"
/>
<input
type=
"hidden"
name=
"area"
value=
"default"
/>
</form>
</div>
</div>
<div
class=
"wy-menu wy-menu-vertical"
data-spy=
"affix"
role=
"navigation"
aria-label=
"main navigation"
>
<p
class=
"caption"
><span
class=
"caption-text"
>
正文
</span></p>
<ul
class=
"current"
>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"../quickstart.html"
>
快速上手
</a></li>
<li
class=
"toctree-l1 current"
><a
class=
"reference internal"
href=
"index.html"
>
第一章:编译运行 RV64 裸机程序
</a><ul
class=
"current"
>
<li
class=
"toctree-l2 current"
><a
class=
"current reference internal"
href=
"#"
>
应用程序运行环境与平台支持
</a><ul>
<li
class=
"toctree-l3"
><a
class=
"reference internal"
href=
"#id2"
>
应用程序运行环境
</a></li>
<li
class=
"toctree-l3"
><a
class=
"reference internal"
href=
"#id3"
>
平台与目标三元组
</a></li>
</ul>
</li>
</ul>
</li>
</ul>
<p
class=
"caption"
><span
class=
"caption-text"
>
开发注记
</span></p>
<ul>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"../rest-example.html"
>
reStructuredText 基本语法
</a></li>
</ul>
</div>
</div>
</nav>
<section
data-toggle=
"wy-nav-shift"
class=
"wy-nav-content-wrap"
>
<nav
class=
"wy-nav-top"
aria-label=
"top navigation"
>
<i
data-toggle=
"wy-nav-top"
class=
"fa fa-bars"
></i>
<a
href=
"../index.html"
>
rCore-Tutorial-Book-v3
</a>
</nav>
<div
class=
"wy-nav-content"
>
<div
class=
"rst-content"
>
<div
role=
"navigation"
aria-label=
"breadcrumbs navigation"
>
<ul
class=
"wy-breadcrumbs"
>
<li><a
href=
"../index.html"
>
Docs
</a>
»
</li>
<li><a
href=
"index.html"
>
第一章:编译运行 RV64 裸机程序
</a>
»
</li>
<li>
应用程序运行环境与平台支持
</li>
<li
class=
"wy-breadcrumbs-aside"
>
<a
href=
"../_sources/chapter1/1app-ee-platform.rst.txt"
rel=
"nofollow"
>
View page source
</a>
</li>
</ul>
<hr/>
</div>
<div
role=
"main"
class=
"document"
itemscope=
"itemscope"
itemtype=
"http://schema.org/Article"
>
<div
itemprop=
"articleBody"
>
<div
class=
"section"
id=
"id1"
>
<h1>
应用程序运行环境与平台支持
<a
class=
"headerlink"
href=
"#id1"
title=
"Permalink to this headline"
>
¶
</a></h1>
<div
class=
"toctree-wrapper compound"
>
</div>
<p>
作为一切的开始,让我们使用 Cargo 工具来创建一个 Rust 项目。它看上去没有任何特别之处:
</p>
<div
class=
"highlight-console notranslate"
><div
class=
"highlight"
><pre><span></span><span
class=
"gp"
>
$
</span>
cargo new os --bin
</pre></div>
</div>
<p>
我们加上了
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
--bin
</span></code>
选项来告诉 Cargo 我们创建一个可执行项目而不是库项目。此时,项目的文件结构如下:
</p>
<div
class=
"highlight-console notranslate"
><div
class=
"highlight"
><pre><span></span><span
class=
"gp"
>
$
</span>
tree os
<span
class=
"go"
>
os
</span>
<span
class=
"go"
>
├── Cargo.toml
</span>
<span
class=
"go"
>
└── src
</span>
<span
class=
"go"
>
└── main.rs
</span>
<span
class=
"go"
>
1 directory, 2 files
</span>
</pre></div>
</div>
<p>
其中
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Cargo.toml
</span></code>
中保存着项目的配置,包括作者的信息、联系方式以及库依赖等等。显而易见源代码保存在
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
src
</span></code>
目录下,目前为止只有
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
main.rs
</span></code>
一个文件,让我们看一下里面的内容:
</p>
<div
class=
"literal-block-wrapper docutils container"
id=
"id4"
>
<div
class=
"code-block-caption"
><span
class=
"caption-text"
>
最简单的 Rust 应用
</span><a
class=
"headerlink"
href=
"#id4"
title=
"Permalink to this code"
>
¶
</a></div>
<div
class=
"highlight-rust notranslate"
><table
class=
"highlighttable"
><tr><td
class=
"linenos"
><div
class=
"linenodiv"
><pre>
1
2
3
</pre></div></td><td
class=
"code"
><div
class=
"highlight"
><pre><span></span><span
class=
"k"
>
fn
</span>
<span
class=
"nf"
>
main
</span><span
class=
"p"
>
()
</span><span
class=
"w"
>
</span><span
class=
"p"
>
{
</span><span
class=
"w"
></span>
<span
class=
"w"
>
</span><span
class=
"n"
>
println
</span><span
class=
"o"
>
!
</span><span
class=
"p"
>
(
</span><span
class=
"s"
>
"
Hello, world!
"
</span><span
class=
"p"
>
);
</span><span
class=
"w"
></span>
<span
class=
"p"
>
}
</span><span
class=
"w"
></span>
</pre></div>
</td></tr></table></div>
</div>
<p>
利用 Cargo 工具即可一条命令实现构建并运行项目:
</p>
<div
class=
"highlight-console notranslate"
><div
class=
"highlight"
><pre><span></span><span
class=
"gp"
>
$
</span>
cargo run
<span
class=
"go"
>
Compiling os v0.1.0 (/home/shinbokuow/workspace/v3/rCore-Tutorial-v3/os)
</span>
<span
class=
"go"
>
Finished dev [unoptimized + debuginfo] target(s) in 1.15s
</span>
<span
class=
"go"
>
Running `target/debug/os`
</span>
<span
class=
"go"
>
Hello, world!
</span>
</pre></div>
</div>
<p>
如我们预想的一样,我们在屏幕上看到了一行
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Hello,
</span>
<span
class=
"pre"
>
world!
</span></code>
。但是,需要注意到我们所享受到的编程的方便并不是理所当然的,背后有着从硬件
到软件的多种机制的支持。
</p>
<div
class=
"section"
id=
"id2"
>
<h2>
应用程序运行环境
<a
class=
"headerlink"
href=
"#id2"
title=
"Permalink to this headline"
>
¶
</a></h2>
<p>
如下图所示,应用程序的运行需要下面一套运行环境栈的支持:
</p>
<div
class=
"figure align-default"
id=
"id5"
>
<span
id=
"app-software-stack"
></span><img
alt=
"../_images/app-software-stack.png"
src=
"../_images/app-software-stack.png"
/>
<p
class=
"caption"
><span
class=
"caption-text"
>
应用程序运行环境栈
</span><a
class=
"headerlink"
href=
"#id5"
title=
"Permalink to this image"
>
¶
</a></p>
</div>
<p>
图中的白色块自上而下(越往下则越靠近底层,下层作为上层的执行环境支持上层代码的运行)表示各级运行环境,黑色块则表示相邻两层运行环境之间
的接口。
</p>
<p>
我们的应用位于最上层,它可以通过调用编程语言提供的标准库或者其他三方库对外提供的功能强大的函数接口,使得仅需少量的源代码就能完成复杂的
功能。但是这些库的功能不仅限于此,事实上它们属于应用程序的
<strong>
执行环境
</strong>
(Execution Environment),在我们通常不会注意到的地方,它
们还会在执行应用之前完成一些初始化工作,并在应用程序执行的时候对它进行监控。我们在打印
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Hello,
</span>
<span
class=
"pre"
>
world!
</span></code>
时使用的
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
println!
</span></code>
宏正是由 Rust 标准库 std 提供的。
</p>
<p>
从内核/操作系统的角度看来,它上面的一切都属于用户态,而它自身属于内核态。无论用户态应用如何编写,是手写汇编代码,还是基于某种编程语言利用
其标准库或三方库,某些功能总要直接或间接的通过内核/操作系统提供的
<strong>
系统调用
</strong>
(System Call) 来实现。因此系统调用充当了用户和内核之间
的边界。内核作为用户态的运行环境,它不仅要提供系统调用接口,还需要对用户态应用的执行进行监控和管理。
</p>
<div
class=
"admonition note"
>
<p
class=
"admonition-title"
>
Note
</p>
<p><code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Hello,
</span>
<span
class=
"pre"
>
world!
</span></code>
用到了哪些系统调用?
</p>
<p>
从之前的
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
cargo
</span>
<span
class=
"pre"
>
run
</span></code>
的输出可以看出之前构建的可执行文件是在 target/debug 目录下的 os 。
在 Ubuntu 系统上,可以通过
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
strace
</span></code>
工具来运行一个程序并输出程序运行过程当中向内核请求的所有的系统调用及其返回值。
我们只需输入
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
strace
</span>
<span
class=
"pre"
>
target/debug/os
</span></code>
即可看到一长串的系统调用。
</p>
<p>
其中,真正容易看出与
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Hello,
</span>
<span
class=
"pre"
>
world!
</span></code>
相关的只有一个系统调用:
</p>
<div
class=
"highlight-default notranslate"
><div
class=
"highlight"
><pre><span></span><span
class=
"n"
>
write
</span><span
class=
"p"
>
(
</span><span
class=
"mi"
>
1
</span><span
class=
"p"
>
,
</span>
<span
class=
"s2"
>
"
Hello, world!
</span><span
class=
"se"
>
\n
</span><span
class=
"s2"
>
"
</span><span
class=
"p"
>
,
</span>
<span
class=
"mi"
>
14
</span><span
class=
"p"
>
)
</span>
<span
class=
"o"
>
=
</span>
<span
class=
"mi"
>
14
</span>
</pre></div>
</div>
<p>
其参数的具体含义我们暂且不在这里进行解释。
</p>
<p>
其余的系统调用基本上分别用于函数库和内核两层执行环境的初始化工作和对于上层的运行期监控和管理。之后,随着应用场景的复杂化,我们
需要更强的抽象能力,也会实现这里面的一些系统调用。
</p>
</div>
<p>
从硬件的角度来看,它上面的一切都属于软件。硬件可以分为三种: 处理器 (Processor) ——它更常见的名字是中央处理单元 (CPU, Central Processing Unit),
内存 (Memory) 还有 I/O 设备。其中处理器无疑是其中最复杂同时也最关键的一个。它与软件约定一套
<strong>
指令集体系结构
</strong>
(ISA, Instruction Set Architecture),
使得软件可以通过 ISA 中提供的汇编指令来访问各种硬件资源。软件当然也需要知道处理器会如何执行这些指令:最简单的话就是一条一条执行位于内存
中的指令。当然,实际的情况远比这个要复杂得多,为了适应现代应用程序的场景,处理器还需要提供很多额外的机制,而不仅仅是让数据在 CPU 寄存器、内存和 I/O 设备
三者之间流动。
</p>
<div
class=
"admonition note"
>
<p
class=
"admonition-title"
>
Note
</p>
<p>
多层执行环境都是必需的吗?
</p>
<p>
除了最上层的应用程序和最下层的硬件平台必须存在之外,作为中间层的函数库和内核并不是必须存在的:它们都是对下层资源进行了
<strong>
抽象
</strong>
(Abstraction),
并为上层提供了一套运行环境。抽象的优点在于它让上层以较小的代价获得所需的功能,并同时可以提供一些保护。但抽象同时也是一种限制,会丧失一些
应有的灵活性。比如,当你在考虑在项目中应该使用哪个函数库的时候,就常常需要这方面的权衡:过多的抽象和过少的抽象自然都是不合适的。
</p>
<p>
实际上,我们通过应用程序的特征来判断它需要什么程度的抽象。
</p>
<ul
class=
"simple"
>
<li><p>
如果函数库和内核都不存在,那么我们就是在手写汇编代码,这种方式具有最高的灵活性,抽象能力则最低,基本等同于硬件。我们通常用这种方式来
实现一些架构相关且仅通过编程语言无法描述的小模块或者代码片段。
</p></li>
<li><p>
如果仅存在函数库而不存在内核,意味着我们不需要内核提供的抽象。在嵌入式场景就常常会出现这种情况。嵌入式设备虽然也包含 CPU、内存和 I/O
设备,但是它上面通常只会同时运行一个或几个功能非常简单的小应用程序,其定位就是那种功能单一的场景,比如人脸识别打卡系统等。我们常用的
操作系统如 Windows/Linux/macOS 等的抽象都支持同时运行很多应用程序,在嵌入式场景是过抽象的。因此,常见的解决方案是仅使用函数库构建
单独的应用程序或是用专为应用场景特别裁减过的轻量级内核管理少数应用程序。
</p></li>
</ul>
</div>
</div>
<div
class=
"section"
id=
"id3"
>
<h2>
平台与目标三元组
<a
class=
"headerlink"
href=
"#id3"
title=
"Permalink to this headline"
>
¶
</a></h2>
<p>
对于一份用某种编程语言实现的源代码而言,编译器在将其通过编译、链接得到目标文件的时候需要知道程序要在哪个
<strong>
平台
</strong>
(Platform) 上运行。
从上面给出的
<a
class=
"reference internal"
href=
"#app-software-stack"
><span
class=
"std std-ref"
>
应用程序运行环境栈
</span></a>
可以看出:
</p>
<ul
class=
"simple"
>
<li><p>
如果用户态基于的内核不同,会导致系统调用接口不同或者语义不一致;
</p></li>
<li><p>
如果底层硬件不同,对于硬件资源的访问方式会有差异。特别是 ISA 不同的话,对上提供的指令集和寄存器都不同。
</p></li>
</ul>
<p>
它们都会导致最终生成的目标文件有很大不同。需要指出的是,某些编译器支持同一份源代码无需修改就可编译到多个不同的目标平台并在上面运行。这种
情况下,源代码是
<strong>
跨平台
</strong>
的。而另一些编译器则已经预设好了一个固定的目标平台。
</p>
<p>
我们可以通过
<strong>
目标三元组
</strong>
(Target Triple) 来描述一个目标平台。它一般包括 CPU 架构、CPU 厂商和操作系统,它们确实都会控制目标文件的生成。
比如,我们可以尝试看一下之前的
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Hello,
</span>
<span
class=
"pre"
>
world!
</span></code>
的目标平台是什么。这可以通过打印编译器 rustc 的默认配置信息:
</p>
<div
class=
"highlight-console notranslate"
><div
class=
"highlight"
><pre><span></span><span
class=
"gp"
>
$
</span>
rustc --version --verbose
<span
class=
"go"
>
rustc 1.48.0-nightly (73dc675b9 2020-09-06)
</span>
<span
class=
"go"
>
binary: rustc
</span>
<span
class=
"go"
>
commit-hash: 73dc675b9437c2a51a975a9f58cc66f05463c351
</span>
<span
class=
"go"
>
commit-date: 2020-09-06
</span>
<span
class=
"go"
>
host: x86_64-unknown-linux-gnu
</span>
<span
class=
"go"
>
release: 1.48.0-nightly
</span>
<span
class=
"go"
>
LLVM version: 11.0
</span>
</pre></div>
</div>
<p>
从其中的 host 一项可以看出默认的目标平台是
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
x86_64-unknown-linux-gnu
</span></code>
,其中 CPU 架构是 x86_64,CPU 厂商是 unknown,操作系统是 linux-gnu。
这种无论编译器还是其目标文件都在我们当前所处的平台运行是一种最简单也最普遍的情况。但是很快我们就将遇到另外一种情况。
</p>
<p>
讲了这么多,终于该介绍我们的主线任务了。我们希望能够在另一个平台上运行
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Hello,
</span>
<span
class=
"pre"
>
world!
</span></code>
,而与之前的默认平台不同的地方在于,我们将 CPU 架构从
x86_64 换成 RISC-V。
</p>
<div
class=
"admonition note"
>
<p
class=
"admonition-title"
>
Note
</p>
<p>
为何基于 RISC-V 架构而非 x86 系列架构?
</p>
<p>
x86 架构为了在升级换代的同时保持对基于旧版架构应用程序/内核的兼容性,存在大量的历史包袱,也就是一些对于目前的应用场景没有任何意义,但又必须
花大量时间正确设置才能正常使用 CPU 的奇怪设定。为了建立并维护架构的应用生态,这确实是必不可少的,但站在教学的角度几乎完全是在浪费时间。而
新生的 RISC-V 架构十分简洁,架构文档需要阅读的核心部分不足百页,且这些功能已经足以用来构造一个具有相当抽象能力的内核了。
</p>
</div>
<p>
可以看一下目前 Rust 编译器支持哪些基于 RISC-V 的平台:
</p>
<div
class=
"highlight-console notranslate"
><div
class=
"highlight"
><pre><span></span><span
class=
"gp"
>
$
</span>
rustc --print target-list
<span
class=
"p"
>
|
</span>
grep riscv
<span
class=
"go"
>
riscv32i-unknown-none-elf
</span>
<span
class=
"go"
>
riscv32imac-unknown-none-elf
</span>
<span
class=
"go"
>
riscv32imc-unknown-none-elf
</span>
<span
class=
"go"
>
riscv64gc-unknown-linux-gnu
</span>
<span
class=
"go"
>
riscv64gc-unknown-none-elf
</span>
<span
class=
"go"
>
riscv64imac-unknown-none-elf
</span>
</pre></div>
</div>
<p>
这里我们选择的是
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
riscv64gc-unknown-none-elf
</span></code>
,目标三元组中的操作系统是 none-elf,表明没有任何系统调用支持。这里我们之所以不选择有
linux-gnu 系统调用支持的版本
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
riscv64gc-unknown-linux-gnu
</span></code>
,是因为我们只是想跑一个
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Hello,
</span>
<span
class=
"pre"
>
world!
</span></code>
,没有必要使用操作系统所提供的
那么高级的抽象。而且我们很清楚后续我们要开发的是一个内核,如果仅仅基于已有操作系统提供的系统调用的话,它自身的抽象能力会受到很大限制。所以它必须
直面底层硬件来解锁更大的抽象能力上限。
</p>
<div
class=
"admonition note"
>
<p
class=
"admonition-title"
>
Note
</p>
<p>
RISC-V 指令集拓展
</p>
</div>
</div>
</div>
</div>
</div>
<footer>
<div
class=
"rst-footer-buttons"
role=
"navigation"
aria-label=
"footer navigation"
>
<a
href=
"../rest-example.html"
class=
"btn btn-neutral float-right"
title=
"reStructuredText 基本语法"
accesskey=
"n"
rel=
"next"
>
Next
<span
class=
"fa fa-arrow-circle-right"
></span></a>
<a
href=
"index.html"
class=
"btn btn-neutral float-left"
title=
"第一章:编译运行 RV64 裸机程序"
accesskey=
"p"
rel=
"prev"
><span
class=
"fa fa-arrow-circle-left"
></span>
Previous
</a>
</div>
<hr/>
<div
role=
"contentinfo"
>
<p>
©
Copyright 2020, Yifan Wu
</p>
</div>
Built with
<a
href=
"http://sphinx-doc.org/"
>
Sphinx
</a>
using a
<a
href=
"https://github.com/rtfd/sphinx_rtd_theme"
>
theme
</a>
provided by
<a
href=
"https://readthedocs.org"
>
Read the Docs
</a>
.
</footer>
</div>
</div>
</section>
</div>
<script
type=
"text/javascript"
>
jQuery
(
function
()
{
SphinxRtdTheme
.
Navigation
.
enable
(
true
);
});
</script>
</body>
</html>
\ No newline at end of file
docs/chapter1/1remove-std.html
浏览文件 @
96a76265
...
...
@@ -87,7 +87,7 @@
<li
class=
"toctree-l1 current"
><a
class=
"reference internal"
href=
"index.html"
>
第一章:编译运行 RV64 裸机程序
</a><ul
class=
"current"
>
<li
class=
"toctree-l2 current"
><a
class=
"current reference internal"
href=
"#"
>
移除标准库依赖
</a><ul>
<li
class=
"toctree-l3"
><a
class=
"reference internal"
href=
"#id2"
>
应用程序运行环境
</a></li>
<li
class=
"toctree-l3"
><a
class=
"reference internal"
href=
"#id3"
>
目标三元组
</a></li>
<li
class=
"toctree-l3"
><a
class=
"reference internal"
href=
"#id3"
>
平台与
目标三元组
</a></li>
</ul>
</li>
</ul>
...
...
@@ -205,7 +205,10 @@
<div
class=
"section"
id=
"id2"
>
<h2>
应用程序运行环境
<a
class=
"headerlink"
href=
"#id2"
title=
"Permalink to this headline"
>
¶
</a></h2>
<p>
如下图所示,应用程序的运行需要下面一套运行环境栈的支持:
</p>
<img
alt=
"../_images/app-software-stack.png"
src=
"../_images/app-software-stack.png"
/>
<div
class=
"figure align-default"
id=
"id5"
>
<span
id=
"app-software-stack"
></span><img
alt=
"../_images/app-software-stack.png"
src=
"../_images/app-software-stack.png"
/>
<p
class=
"caption"
><span
class=
"caption-text"
>
应用程序运行环境栈
</span><a
class=
"headerlink"
href=
"#id5"
title=
"Permalink to this image"
>
¶
</a></p>
</div>
<p>
图中的白色块自上而下(越往下则越靠近底层,下层作为上层的执行环境支持上层代码的运行)表示各级运行环境,黑色块则表示相邻两层运行环境之间
的接口。
</p>
<p>
我们的应用位于最上层,它可以通过调用编程语言提供的标准库或者其他三方库对外提供的功能强大的函数接口,使得仅需少量的源代码就能完成复杂的
...
...
@@ -218,9 +221,19 @@
<div
class=
"admonition note"
>
<p
class=
"admonition-title"
>
Note
</p>
<p><code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Hello,
</span>
<span
class=
"pre"
>
world!
</span></code>
用到了哪些系统调用?
</p>
<p>
从之前的
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
cargo
</span>
<span
class=
"pre"
>
run
</span></code>
的输出可以看出之前构建的可执行文件是在 target/debug 目录下的 os 。
在 Ubuntu 系统上,可以通过
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
strace
</span></code>
工具来运行一个程序并输出程序运行过程当中向内核请求的所有的系统调用及其返回值。
我们只需输入
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
strace
</span>
<span
class=
"pre"
>
target/debug/os
</span></code>
即可看到一长串的系统调用。
</p>
<p>
其中,真正容易看出与
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Hello,
</span>
<span
class=
"pre"
>
world!
</span></code>
相关的只有一个系统调用:
</p>
<div
class=
"highlight-default notranslate"
><div
class=
"highlight"
><pre><span></span><span
class=
"n"
>
write
</span><span
class=
"p"
>
(
</span><span
class=
"mi"
>
1
</span><span
class=
"p"
>
,
</span>
<span
class=
"s2"
>
"
Hello, world!
</span><span
class=
"se"
>
\n
</span><span
class=
"s2"
>
"
</span><span
class=
"p"
>
,
</span>
<span
class=
"mi"
>
14
</span><span
class=
"p"
>
)
</span>
<span
class=
"o"
>
=
</span>
<span
class=
"mi"
>
14
</span>
</pre></div>
</div>
<p>
其参数的具体含义我们暂且不在这里进行解释。
</p>
<p>
其余的系统调用基本上分别用于函数库和内核两层执行环境的初始化工作和对于上层的运行期监控和管理。之后,随着应用场景的复杂化,我们
需要更强的抽象能力,也会实现这里面的一些系统调用。
</p>
</div>
<p>
从硬件的角度来看,它上面的一切都属于软件。硬件可以分为三种: 处理器 (Processor) ——它更常见的名字是中央处理单元 (CPU, Central Processing Unit),
内存 (Memory) 还有 I/O 设备。其中处理器无疑是其中最复杂同时也最关键的一个。它与软件约定一套
<strong>
指令集
架
构
</strong>
(ISA, Instruction Set Architecture),
内存 (Memory) 还有 I/O 设备。其中处理器无疑是其中最复杂同时也最关键的一个。它与软件约定一套
<strong>
指令集
体系结
构
</strong>
(ISA, Instruction Set Architecture),
使得软件可以通过 ISA 中提供的汇编指令来访问各种硬件资源。软件当然也需要知道处理器会如何执行这些指令:最简单的话就是一条一条执行位于内存
中的指令。当然,实际的情况远比这个要复杂得多,为了适应现代应用程序的场景,处理器还需要提供很多额外的机制,而不仅仅是让数据在 CPU 寄存器、内存和 I/O 设备
三者之间流动。
</p>
...
...
@@ -242,7 +255,34 @@
</div>
</div>
<div
class=
"section"
id=
"id3"
>
<h2>
目标三元组
<a
class=
"headerlink"
href=
"#id3"
title=
"Permalink to this headline"
>
¶
</a></h2>
<h2>
平台与目标三元组
<a
class=
"headerlink"
href=
"#id3"
title=
"Permalink to this headline"
>
¶
</a></h2>
<p>
对于一份用某种编程语言实现的源代码而言,编译器在将其通过编译、链接得到目标文件的时候需要知道程序要在哪个
<strong>
平台
</strong>
(Platform) 上运行。
从上面给出的
<a
class=
"reference internal"
href=
"#app-software-stack"
><span
class=
"std std-ref"
>
应用程序运行环境栈
</span></a>
可以看出:
</p>
<ul
class=
"simple"
>
<li><p>
如果用户态基于的内核不同,会导致系统调用接口不同或者语义不一致;
</p></li>
<li><p>
如果底层硬件不同,对于硬件资源的访问方式会有差异。特别是 ISA 不同的话,对上提供的指令集和寄存器都不同。
</p></li>
</ul>
<p>
它们都会导致最终生成的目标文件有很大不同。需要指出的是,某些编译器支持同一份源代码无需修改就可编译到多个不同的目标平台并在上面运行。这种
情况下,源代码是
<strong>
跨平台
</strong>
的。而另一些编译器则已经预设好了一个固定的目标平台。
</p>
<p>
我们可以通过
<strong>
目标三元组
</strong>
(Target Triple) 来描述一个目标平台。它一般包括 CPU 架构、CPU 厂商和操作系统,它们确实都会控制目标文件的生成。
比如,我们可以尝试看一下之前的
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Hello,
</span>
<span
class=
"pre"
>
world!
</span></code>
的目标平台是什么。这可以通过打印编译器 rustc 的默认配置信息:
</p>
<div
class=
"highlight-console notranslate"
><div
class=
"highlight"
><pre><span></span><span
class=
"gp"
>
$
</span>
rustc --version --verbose
<span
class=
"go"
>
rustc 1.48.0-nightly (73dc675b9 2020-09-06)
</span>
<span
class=
"go"
>
binary: rustc
</span>
<span
class=
"go"
>
commit-hash: 73dc675b9437c2a51a975a9f58cc66f05463c351
</span>
<span
class=
"go"
>
commit-date: 2020-09-06
</span>
<span
class=
"go"
>
host: x86_64-unknown-linux-gnu
</span>
<span
class=
"go"
>
release: 1.48.0-nightly
</span>
<span
class=
"go"
>
LLVM version: 11.0
</span>
</pre></div>
</div>
<p>
从其中的 host 一项可以看出默认的目标平台是
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
x86_64-unknown-linux-gnu
</span></code>
,其中 CPU 架构是 x86_64,CPU 厂商是 unknown,操作系统是 linux-gnu。
这种无论编译器还是目标文件都在我们当前所处的平台运行是一种最简单也最普遍的情况。但是很快我们就将遇到另外一种情况。
</p>
<p>
讲了这么多,终于该介绍我们的主线任务了。我们希望能够在另一个平台上运行
<code
class=
"docutils literal notranslate"
><span
class=
"pre"
>
Hello,
</span>
<span
class=
"pre"
>
world!
</span></code>
,而与之前的默认平台不同的地方在于:
</p>
<ul
class=
"simple"
>
<li><p>
CPU 架构从 x86_64 换成 RISC-V 架构;
</p></li>
<li><p>
操作系统从 linux-gnu 换成 none-elf,也就是没有任何系统调用支持。
</p></li>
</ul>
</div>
</div>
...
...
docs/chapter1/index.html
浏览文件 @
96a76265
...
...
@@ -36,7 +36,7 @@
<link
rel=
"stylesheet"
href=
"../_static/pygments.css"
type=
"text/css"
/>
<link
rel=
"index"
title=
"Index"
href=
"../genindex.html"
/>
<link
rel=
"search"
title=
"Search"
href=
"../search.html"
/>
<link
rel=
"next"
title=
"
移除标准库依赖"
href=
"1remove-std
.html"
/>
<link
rel=
"next"
title=
"
应用程序运行环境与平台支持"
href=
"1app-ee-platform
.html"
/>
<link
rel=
"prev"
title=
"快速上手"
href=
"../quickstart.html"
/>
</head>
...
...
@@ -85,7 +85,7 @@
<ul
class=
"current"
>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"../quickstart.html"
>
快速上手
</a></li>
<li
class=
"toctree-l1 current"
><a
class=
"current reference internal"
href=
"#"
>
第一章:编译运行 RV64 裸机程序
</a><ul>
<li
class=
"toctree-l2"
><a
class=
"reference internal"
href=
"1
remove-std.html"
>
移除标准库依赖
</a></li>
<li
class=
"toctree-l2"
><a
class=
"reference internal"
href=
"1
app-ee-platform.html"
>
应用程序运行环境与平台支持
</a></li>
</ul>
</li>
</ul>
...
...
@@ -170,7 +170,7 @@
<div
class=
"rst-footer-buttons"
role=
"navigation"
aria-label=
"footer navigation"
>
<a
href=
"1
remove-std.html"
class=
"btn btn-neutral float-right"
title=
"移除标准库依赖
"
accesskey=
"n"
rel=
"next"
>
Next
<span
class=
"fa fa-arrow-circle-right"
></span></a>
<a
href=
"1
app-ee-platform.html"
class=
"btn btn-neutral float-right"
title=
"应用程序运行环境与平台支持
"
accesskey=
"n"
rel=
"next"
>
Next
<span
class=
"fa fa-arrow-circle-right"
></span></a>
<a
href=
"../quickstart.html"
class=
"btn btn-neutral float-left"
title=
"快速上手"
accesskey=
"p"
rel=
"prev"
><span
class=
"fa fa-arrow-circle-left"
></span>
Previous
</a>
...
...
docs/objects.inv
浏览文件 @
96a76265
无法预览此类型文件
docs/searchindex.js
浏览文件 @
96a76265
Search
.
setIndex
({
docnames
:[
"
chapter1/1remove-std
"
,
"
chapter1/index
"
,
"
index
"
,
"
quickstart
"
,
"
rest-example
"
],
envversion
:{
"
sphinx.domains.c
"
:
2
,
"
sphinx.domains.changeset
"
:
1
,
"
sphinx.domains.citation
"
:
1
,
"
sphinx.domains.cpp
"
:
3
,
"
sphinx.domains.index
"
:
1
,
"
sphinx.domains.javascript
"
:
2
,
"
sphinx.domains.math
"
:
2
,
"
sphinx.domains.python
"
:
2
,
"
sphinx.domains.rst
"
:
2
,
"
sphinx.domains.std
"
:
1
,
sphinx
:
56
},
filenames
:[
"
chapter1/1remove-std.rst
"
,
"
chapter1/index.rst
"
,
"
index.rst
"
,
"
quickstart.rst
"
,
"
rest-example.rst
"
],
objects
:{},
objnames
:{},
objtypes
:{},
terms
:{
"
15s
"
:
0
,
"
\
u4e00
\
u4e2a
\
u5168
\
u9762
\
u5c55
\
u793a
"
:
4
,
"
\
u4e00
\
u4e2a
\
u6587
\
u4ef6
"
:
0
,
"
\
u4e00
\
u6bb5
\
u793a
\
u4f8b
"
:
4
,
"
\
u4e09
\
u8005
\
u4e4b
\
u95f4
\
u6765
\
u56de
\
u6298
\
u817e
"
:[],
"
\
u4e09
\
u8005
\
u4e4b
\
u95f4
\
u6d41
\
u52a8
"
:
0
,
"
\
u4e0b
\
u5c42
\
u4f5c
\
u4e3a
\
u4e0a
\
u5c42
\
u7684
\
u6267
\
u884c
\
u73af
\
u5883
\
u652f
\
u6301
\
u4e0a
\
u5c42
\
u4ee3
\
u7801
\
u7684
\
u8fd0
\
u884c
"
:
0
,
"
\
u4e0b
\
u5c42
\
u4f5c
\
u4e3a
\
u4e0a
\
u5c42
\
u7684
\
u8fd0
\
u884c
\
u73af
\
u5883
\
u652f
\
u6301
\
u4e0a
\
u5c42
\
u4ee3
\
u7801
\
u7684
\
u8fd0
\
u884c
"
:[],
"
\
u4e0b
\
u9762
\
u662f
\
u4e00
\
u4e2a
\
u6ce8
\
u8bb0
"
:
4
,
"
\
u4e0b
\
u9762
\
u662f
\
u4e00
\
u4e2a
\
u6d4b
\
u8bd5
"
:
4
,
"
\
u4e0b
\
u9762
\
u662f
\
u4e00
\
u4e2a
\
u8b66
\
u544a
"
:
4
,
"
\
u4e0b
\
u9762
\
u662f
\
u4e00
\
u4e2a
\
u9519
\
u8bef
"
:
4
,
"
\
u4e0b
\
u9762
\
u7ee7
\
u7eed
\
u6211
\
u4eec
\
u7684
\
u8b66
\
u544a
"
:
4
,
"
\
u4e2d
"
:
4
,
"
\
u4e2d
\
u4fdd
\
u5b58
\
u7740
\
u9879
\
u76ee
\
u7684
\
u914d
\
u7f6e
"
:
0
,
"
\
u4e2d
\
u63d0
\
u4f9b
\
u7684
\
u6c47
\
u7f16
\
u6307
\
u4ee4
\
u6765
\
u8bbf
\
u95ee
\
u5404
\
u79cd
\
u786c
\
u4ef6
\
u8d44
\
u6e90
"
:
0
,
"
\
u4e2d
\
u7684
\
u6307
\
u4ee4
"
:
0
,
"
\
u4e3a
\
u4e86
\
u9002
\
u5e94
\
u73b0
\
u4ee3
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u7684
\
u573a
\
u666f
"
:
0
,
"
\
u4e3b
\
u9898
\
u4e86
"
:
4
,
"
\
u4e8b
\
u5b9e
\
u4e0a
"
:
4
,
"
\
u4e8b
\
u5b9e
\
u4e0a
\
u5b83
\
u4eec
\
u5c5e
\
u4e8e
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u7684
"
:
0
,
"
\
u4ece
\
u5185
\
u6838
"
:
0
,
"
\
u4ece
\
u786c
\
u4ef6
\
u7684
\
u89d2
\
u5ea6
\
u6765
\
u770b
"
:
0
,
"
\
u4ee3
\
u7801
"
:
4
,
"
\
u4eec
\
u8fd8
\
u4f1a
\
u5728
\
u6267
\
u884c
\
u5e94
\
u7528
\
u4e4b
\
u524d
\
u5b8c
\
u6210
\
u4e00
\
u4e9b
\
u521d
\
u59cb
\
u5316
\
u5de5
\
u4f5c
"
:
0
,
"
\
u4f1a
\
u4e27
\
u5931
\
u4e00
\
u4e9b
"
:
0
,
"
\
u4f46
\
u62bd
\
u8c61
\
u540c
\
u65f6
\
u4e5f
\
u662f
\
u4e00
\
u79cd
\
u9650
\
u5236
"
:
0
,
"
\
u4f46
\
u662f
"
:
0
,
"
\
u4f46
\
u662f
\
u5b83
\
u4e0a
\
u9762
\
u901a
\
u5e38
\
u53ea
\
u4f1a
\
u540c
\
u65f6
\
u8fd0
\
u884c
\
u4e00
\
u4e2a
\
u6216
\
u51e0
\
u4e2a
\
u529f
\
u80fd
\
u975e
\
u5e38
\
u7b80
\
u5355
\
u7684
\
u5c0f
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
"
:
0
,
"
\
u4f46
\
u662f
\
u8fd9
\
u4e9b
\
u5e93
\
u7684
\
u529f
\
u80fd
\
u4e0d
\
u4ec5
\
u9650
\
u4e8e
\
u6b64
"
:
0
,
"
\
u4f5c
\
u4e3a
\
u4e00
\
u5207
\
u7684
\
u5f00
\
u59cb
"
:
0
,
"
\
u4f5c
\
u4e3a
\
u4e2d
\
u95f4
\
u5c42
\
u7684
\
u51fd
\
u6570
\
u5e93
\
u548c
\
u5185
\
u6838
\
u5e76
\
u4e0d
\
u662f
\
u5fc5
\
u987b
\
u5b58
\
u5728
\
u7684
"
:
0
,
"
\
u4f5c
\
u4e3a
\
u4e2d
\
u95f4
\
u5c42
\
u7684
\
u51fd
\
u6570
\
u5e93
\
u548c
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u5e76
\
u4e0d
\
u662f
\
u5fc5
\
u987b
\
u5b58
\
u5728
\
u7684
"
:[],
"
\
u4f7f
\
u5f97
\
u4ec5
\
u9700
\
u5c11
\
u91cf
\
u7684
\
u6e90
\
u4ee3
\
u7801
\
u5c31
\
u80fd
\
u5b8c
\
u6210
\
u590d
\
u6742
\
u7684
"
:
0
,
"
\
u4f7f
\
u5f97
\
u8f6f
\
u4ef6
\
u53ef
\
u4ee5
\
u901a
\
u8fc7
"
:
0
,
"
\
u5176
\
u4e2d
"
:
0
,
"
\
u5176
\
u4e2d
\
u5904
\
u7406
\
u5668
\
u65e0
\
u7591
\
u662f
\
u5176
\
u4e2d
\
u6700
\
u590d
\
u6742
\
u540c
\
u65f6
\
u4e5f
\
u6700
\
u5173
\
u952e
\
u7684
\
u4e00
\
u4e2a
"
:
0
,
"
\
u5176
\
u5b9a
\
u4f4d
\
u5c31
\
u662f
\
u90a3
\
u79cd
\
u529f
\
u80fd
\
u5355
\
u4e00
\
u7684
\
u573a
\
u666f
"
:
0
,
"
\
u5176
\
u6807
\
u51c6
\
u5e93
\
u6216
\
u4e09
\
u65b9
\
u5e93
"
:
0
,
"
\
u5185
\
u5b58
"
:
0
,
"
\
u5185
\
u5b58
\
u548c
"
:
0
,
"
\
u5185
\
u6838
\
u4f5c
\
u4e3a
\
u7528
\
u6237
\
u6001
\
u7684
\
u8fd0
\
u884c
\
u73af
\
u5883
"
:
0
,
"
\
u5229
\
u7528
"
:
0
,
"
\
u5230
\
u8f6f
\
u4ef6
\
u7684
\
u591a
\
u79cd
\
u673a
\
u5236
\
u7684
\
u652f
\
u6301
"
:
0
,
"
\
u529f
\
u80fd
"
:
0
,
"
\
u52a0
\
u7c97
"
:
4
,
"
\
u5305
\
u62ec
\
u4f5c
\
u8005
\
u7684
\
u4fe1
\
u606f
"
:
0
,
"
\
u5355
\
u72ec
\
u7684
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u6216
\
u662f
\
u7528
\
u4e13
\
u4e3a
\
u5e94
\
u7528
\
u573a
\
u666f
\
u7279
\
u522b
\
u88c1
\
u51cf
\
u8fc7
\
u7684
\
u8f7b
\
u91cf
\
u7ea7
\
u5185
\
u6838
\
u7ba1
\
u7406
\
u5c11
\
u6570
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
"
:
0
,
"
\
u53ef
\
u4ee5
\
u8fdb
\
u5165
\
u5feb
\
u901f
\
u4e0a
\
u624b
\
u73af
\
u8282
"
:
4
,
"
\
u56e0
\
u6b64
"
:
0
,
"
\
u56e0
\
u6b64
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u5145
\
u5f53
\
u4e86
\
u7528
\
u6237
\
u548c
\
u5185
\
u6838
\
u4e4b
\
u95f4
"
:
0
,
"
\
u56fe
\
u4e2d
\
u7684
\
u767d
\
u8272
\
u5757
\
u81ea
\
u4e0a
\
u800c
\
u4e0b
"
:
0
,
"
\
u5728
\
u5d4c
\
u5165
\
u5f0f
\
u573a
\
u666f
\
u5c31
\
u5e38
\
u5e38
\
u4f1a
\
u51fa
\
u73b0
\
u8fd9
\
u79cd
\
u60c5
\
u51b5
"
:
0
,
"
\
u5728
\
u5d4c
\
u5165
\
u5f0f
\
u573a
\
u666f
\
u662f
\
u8fc7
\
u62bd
\
u8c61
\
u7684
"
:
0
,
"
\
u5728
\
u6211
\
u4eec
\
u901a
\
u5e38
\
u4e0d
\
u4f1a
\
u6ce8
\
u610f
\
u5230
\
u7684
\
u5730
\
u65b9
"
:
0
,
"
\
u57fa
\
u672c
\
u7684
\
u6587
\
u672c
\
u6837
\
u5f0f
"
:
4
,
"
\
u57fa
\
u672c
\
u7b49
\
u540c
\
u4e8e
\
u786c
\
u4ef6
"
:
0
,
"
\
u5904
\
u7406
\
u5668
"
:
0
,
"
\
u5904
\
u7406
\
u5668
\
u8fd8
\
u9700
\
u8981
\
u63d0
\
u4f9b
\
u5f88
\
u591a
\
u989d
\
u5916
\
u7684
\
u673a
\
u5236
"
:
0
,
"
\
u5916
\
u90e8
\
u94fe
\
u63a5
\
u7684
\
u5f15
\
u5165
\
u65b9
\
u6cd5
"
:
4
,
"
\
u591a
\
u5c42
\
u6267
\
u884c
\
u73af
\
u5883
\
u90fd
\
u662f
\
u5fc5
\
u9700
\
u7684
\
u5417
"
:
0
,
"
\
u5982
\
u4e0b
\
u56fe
\
u6240
\
u793a
"
:
0
,
"
\
u5982
\
u6211
\
u4eec
\
u9884
\
u60f3
\
u7684
\
u4e00
\
u6837
"
:
0
,
"
\
u5982
\
u679c
\
u4ec5
\
u5b58
\
u5728
\
u51fd
\
u6570
\
u5e93
\
u800c
\
u4e0d
\
u5b58
\
u5728
\
u5185
\
u6838
"
:
0
,
"
\
u5982
\
u679c
\
u51fd
\
u6570
\
u5e93
\
u548c
\
u5185
\
u6838
\
u90fd
\
u4e0d
\
u5b58
\
u5728
"
:
0
,
"
\
u5b83
"
:
0
,
"
\
u5b83
\
u4e0a
\
u9762
\
u7684
\
u4e00
\
u5207
\
u90fd
\
u5c5e
\
u4e8e
\
u7528
\
u6237
\
u6001
"
:
0
,
"
\
u5b83
\
u4e0a
\
u9762
\
u7684
\
u4e00
\
u5207
\
u90fd
\
u5c5e
\
u4e8e
\
u8f6f
\
u4ef6
"
:
0
,
"
\
u5b83
\
u4e0d
\
u4ec5
\
u8981
\
u63d0
\
u4f9b
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u63a5
\
u53e3
"
:
0
,
"
\
u5b83
\
u4e0e
\
u8f6f
\
u4ef6
\
u7ea6
\
u5b9a
\
u4e00
\
u5957
"
:
0
,
"
\
u5b83
\
u4eec
\
u7684
\
u524d
\
u540e
\
u90fd
\
u9700
\
u8981
\
u6709
\
u4e00
\
u4e2a
\
u7a7a
\
u683c
\
u9694
\
u5f00
\
u5176
\
u4ed6
\
u5185
\
u5bb9
"
:
4
,
"
\
u5b83
\
u4eec
\
u90fd
\
u662f
\
u5bf9
\
u4e0b
\
u5c42
\
u8d44
\
u6e90
\
u8fdb
\
u884c
\
u4e86
"
:
0
,
"
\
u5b83
\
u53ef
\
u4ee5
\
u901a
\
u8fc7
\
u8c03
\
u7528
\
u7f16
\
u7a0b
\
u8bed
\
u8a00
\
u63d0
\
u4f9b
\
u7684
\
u6807
\
u51c6
\
u5e93
\
u6216
\
u8005
\
u5176
\
u4ed6
\
u4e09
\
u65b9
\
u5e93
\
u5bf9
\
u5916
\
u63d0
\
u4f9b
\
u7684
\
u529f
\
u80fd
\
u5f3a
\
u5927
\
u7684
\
u51fd
\
u6570
\
u63a5
\
u53e3
"
:
0
,
"
\
u5b83
\
u66f4
\
u5e38
\
u89c1
\
u7684
\
u540d
\
u5b57
\
u662f
\
u4e2d
\
u592e
\
u5904
\
u7406
\
u5355
\
u5143
"
:
0
,
"
\
u5b83
\
u770b
\
u4e0a
\
u53bb
\
u6ca1
\
u6709
\
u4efb
\
u4f55
\
u7279
\
u522b
\
u4e4b
\
u5904
"
:
0
,
"
\
u5b83
\
u975e
\
u5e38
\
u7f8e
\
u89c2
\
u5927
\
u65b9
"
:
4
,
"
\
u5b8f
\
u6b63
\
u662f
\
u7531
"
:
0
,
"
\
u5b9e
\
u73b0
\
u4e00
\
u4e9b
"
:[],
"
\
u5b9e
\
u73b0
\
u4e00
\
u4e9b
\
u67b6
\
u6784
\
u76f8
\
u5173
\
u4e14
\
u4ec5
\
u901a
\
u8fc7
\
u7f16
\
u7a0b
\
u8bed
\
u8a00
\
u65e0
\
u6cd5
\
u63cf
\
u8ff0
\
u7684
\
u5c0f
\
u6a21
\
u5757
\
u6216
\
u8005
\
u4ee3
\
u7801
\
u7247
\
u6bb5
"
:
0
,
"
\
u5b9e
\
u9645
\
u4e0a
"
:
0
,
"
\
u5b9e
\
u9645
\
u7684
\
u60c5
\
u51b5
\
u8fdc
\
u6bd4
\
u8fd9
\
u4e2a
\
u8981
\
u590d
\
u6742
\
u5f97
\
u591a
"
:
0
,
"
\
u5bc4
\
u5b58
\
u5668
"
:
0
,
"
\
u5c31
\
u5e38
\
u5e38
\
u9700
\
u8981
\
u8fd9
\
u65b9
\
u9762
\
u7684
\
u6743
\
u8861
"
:
0
,
"
\
u5d4c
\
u5165
\
u5f0f
\
u8bbe
\
u5907
\
u867d
\
u7136
\
u4e5f
\
u5305
\
u542b
"
:
0
,
"
\
u5de5
\
u5177
\
u5373
\
u53ef
\
u4e00
\
u6761
\
u547d
\
u4ee4
\
u5b9e
\
u73b0
\
u6784
\
u5efa
\
u5e76
\
u8fd0
\
u884c
\
u9879
\
u76ee
"
:
0
,
"
\
u5de5
\
u5177
\
u6765
\
u521b
\
u5efa
\
u4e00
\
u4e2a
"
:
0
,
"
\
u5e38
\
u89c1
\
u7684
\
u89e3
\
u51b3
\
u65b9
\
u6848
\
u662f
\
u4ec5
\
u4f7f
\
u7528
\
u51fd
\
u6570
\
u5e93
\
u6784
\
u5efa
"
:
0
,
"
\
u5e76
\
u4e3a
\
u4e0a
\
u5c42
\
u63d0
\
u4f9b
\
u4e86
\
u4e00
\
u5957
\
u8fd0
\
u884c
\
u73af
\
u5883
"
:
0
,
"
\
u5e76
\
u540c
\
u65f6
\
u53ef
\
u4ee5
\
u63d0
\
u4f9b
\
u4e00
\
u4e9b
\
u4fdd
\
u62a4
"
:
0
,
"
\
u5e76
\
u5728
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u6267
\
u884c
\
u7684
\
u65f6
\
u5019
\
u5bf9
\
u5b83
\
u8fdb
\
u884c
\
u76d1
\
u63a7
"
:
0
,
"
\
u5e94
\
u6709
\
u7684
\
u7075
\
u6d3b
\
u6027
"
:
0
,
"
\
u5e94
\
u7528
"
:
0
,
"
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u7684
\
u8fd0
\
u884c
\
u9700
\
u8981
\
u4e0b
\
u9762
\
u4e00
\
u5957
\
u8fd0
\
u884c
\
u73af
\
u5883
\
u6808
\
u7684
\
u652f
\
u6301
"
:
0
,
"
\
u5f53
\
u4f60
\
u5728
\
u8003
\
u8651
\
u5728
\
u9879
\
u76ee
\
u4e2d
\
u5e94
\
u8be5
\
u4f7f
\
u7528
\
u54ea
\
u4e2a
\
u51fd
\
u6570
\
u5e93
\
u7684
\
u65f6
\
u5019
"
:
0
,
"
\
u5f53
\
u7136
"
:
0
,
"
\
u5feb
\
u901f
\
u4e0a
\
u624b
"
:
4
,
"
\
u610f
\
u5473
\
u7740
\
u6211
\
u4eec
\
u4e0d
\
u9700
\
u8981
\
u5185
\
u6838
\
u63d0
\
u4f9b
\
u7684
\
u62bd
\
u8c61
"
:
0
,
"
\
u6211
\
u4eec
\
u521b
\
u5efa
\
u4e00
\
u4e2a
\
u53ef
\
u6267
\
u884c
\
u9879
\
u76ee
\
u800c
\
u4e0d
\
u662f
\
u5e93
\
u9879
\
u76ee
"
:
0
,
"
\
u6211
\
u4eec
\
u52a0
\
u4e0a
\
u4e86
"
:
0
,
"
\
u6211
\
u4eec
\
u5728
\
u5c4f
\
u5e55
\
u4e0a
\
u770b
\
u5230
\
u4e86
\
u4e00
\
u884c
"
:
0
,
"
\
u6211
\
u4eec
\
u5728
\
u6253
\
u5370
"
:
0
,
"
\
u6211
\
u4eec
\
u5e38
\
u7528
\
u7684
"
:
0
,
"
\
u6211
\
u4eec
\
u751a
\
u81f3
\
u53ef
\
u4ee5
\
u63d2
\
u5165
\
u4e00
\
u6bb5
"
:
4
,
"
\
u6211
\
u4eec
\
u7684
\
u5e94
\
u7528
\
u4f4d
\
u4e8e
\
u6700
\
u4e0a
\
u5c42
"
:
0
,
"
\
u6211
\
u4eec
\
u901a
\
u5e38
\
u7528
\
u8fd9
\
u79cd
\
u65b9
\
u5f0f
\
u6765
"
:
0
,
"
\
u6211
\
u4eec
\
u901a
\
u8fc7
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u7684
\
u7279
\
u5f81
\
u6765
\
u5224
\
u65ad
\
u5b83
\
u9700
\
u8981
\
u4ec0
\
u4e48
\
u7a0b
\
u5ea6
\
u7684
\
u62bd
\
u8c61
"
:
0
,
"
\
u6233
"
:
4
,
"
\
u6267
\
u884c
\
u73af
\
u5883
"
:
0
,
"
\
u62bd
\
u8c61
"
:
0
,
"
\
u62bd
\
u8c61
\
u7684
\
u4f18
\
u70b9
\
u5728
\
u4e8e
\
u5b83
\
u8ba9
\
u4e0a
\
u5c42
\
u4ee5
\
u8f83
\
u5c0f
\
u7684
\
u4ee3
\
u4ef7
\
u83b7
\
u5f97
\
u6240
\
u9700
\
u7684
\
u529f
\
u80fd
"
:
0
,
"
\
u62bd
\
u8c61
\
u80fd
\
u529b
\
u5219
\
u6700
\
u4f4e
"
:
0
,
"
\
u6307
\
u4ee4
\
u96c6
\
u67b6
\
u6784
"
:
0
,
"
\
u63a5
\
u4e0b
\
u6765
\
u662f
\
u4e00
\
u4e2a
\
u6587
\
u6863
\
u5185
\
u90e8
\
u5f15
\
u7528
\
u7684
\
u4f8b
\
u5b50
"
:
4
,
"
\
u63a5
\
u4e0b
\
u6765
\
u7684
\
u5219
\
u662f
\
u884c
\
u95f4
\
u516c
\
u5f0f
"
:
4
,
"
\
u63d0
\
u4f9b
\
u7684
"
:
0
,
"
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u5982
"
:
0
,
"
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u63d0
\
u4f9b
\
u7684
"
:
0
,
"
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u7684
\
u89d2
\
u5ea6
\
u770b
\
u6765
"
:
0
,
"
\
u659c
\
u4f53
"
:
4
,
"
\
u65e0
\
u8bba
\
u7528
\
u6237
\
u6001
\
u5e94
\
u7528
\
u5982
\
u4f55
\
u7f16
\
u5199
"
:
0
,
"
\
u65f6
\
u4f7f
\
u7528
\
u7684
"
:
0
,
"
\
u662f
\
u624b
\
u5199
\
u6c47
\
u7f16
\
u4ee3
\
u7801
"
:
0
,
"
\
u663e
\
u800c
\
u6613
\
u89c1
\
u6e90
\
u4ee3
\
u7801
\
u4fdd
\
u5b58
\
u5728
"
:
0
,
"
\
u6700
\
u7b80
\
u5355
\
u7684
"
:
0
,
"
\
u6700
\
u7b80
\
u5355
\
u7684
\
u8bdd
\
u5c31
\
u662f
\
u4e00
\
u6761
\
u4e00
\
u6761
\
u6267
\
u884c
\
u4f4d
\
u4e8e
\
u5185
\
u5b58
"
:
0
,
"
\
u6709
\
u4e00
\
u4e2a
\
u7a7a
\
u683c
"
:
4
,
"
\
u672c
\
u8282
\
u6211
\
u4eec
\
u5c06
\
u5b8c
\
u6210
\
u73af
\
u5883
\
u914d
\
u7f6e
\
u5e76
\
u6210
\
u529f
\
u8fd0
\
u884c
"
:
3
,
"
\
u6765
\
u5b9e
\
u73b0
"
:
0
,
"
\
u6765
\
u81ea
\
u4e8e
"
:
4
,
"
\
u67d0
\
u4e9b
\
u529f
\
u80fd
\
u603b
\
u8981
\
u76f4
\
u63a5
\
u6216
\
u95f4
\
u63a5
\
u7684
\
u901a
\
u8fc7
\
u5185
\
u6838
"
:
0
,
"
\
u6807
\
u51c6
\
u5e93
"
:
0
,
"
\
u6b22
\
u8fce
\
u6765
\
u5230
"
:
2
,
"
\
u6b64
\
u65f6
"
:
0
,
"
\
u6bd4
\
u5982
"
:[
0
,
4
],
"
\
u6bd4
\
u5982
\
u4eba
\
u8138
\
u8bc6
\
u522b
\
u6253
\
u5361
\
u7cfb
\
u7edf
\
u7b49
"
:
0
,
"
\
u6ce8
\
u610f
"
:
4
,
"
\
u73b0
\
u5728
\
u6211
\
u4eec
\
u4e5f
\
u91c7
\
u7528
"
:
4
,
"
\
u7528
\
u5230
\
u4e86
\
u54ea
\
u4e9b
\
u7cfb
\
u7edf
\
u8c03
\
u7528
"
:
0
,
"
\
u7684
\
u5b98
\
u65b9
\
u6587
\
u6863
"
:
4
,
"
\
u7684
\
u63a5
\
u53e3
"
:
0
,
"
\
u7684
\
u8fb9
\
u754c
"
:
0
,
"
\
u76ee
\
u524d
\
u4e3a
\
u6b62
\
u53ea
\
u6709
"
:
0
,
"
\
u76ee
\
u5f55
\
u4e0b
"
:
0
,
"
\
u786c
\
u4ef6
\
u53ef
\
u4ee5
\
u5206
\
u4e3a
\
u4e09
\
u79cd
"
:
0
,
"
\
u7ae0
\
u8282
\
u5206
\
u5e03
\
u7684
\
u4f8b
\
u5b50
"
:
4
,
"
\
u7b49
\
u7684
\
u62bd
\
u8c61
\
u90fd
\
u652f
\
u6301
\
u540c
\
u65f6
\
u8fd0
\
u884c
\
u5f88
\
u591a
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
"
:
0
,
"
\
u7cfb
\
u7edf
\
u8c03
\
u7528
"
:
0
,
"
\
u7ed9
\
u51fa
\
u4e86
\
u5728
"
:
4
,
"
\
u800c
\
u4e0d
\
u4ec5
\
u4ec5
\
u662f
\
u5728
"
:[],
"
\
u800c
\
u4e0d
\
u4ec5
\
u4ec5
\
u662f
\
u8ba9
\
u6570
\
u636e
"
:[],
"
\
u800c
\
u4e0d
\
u4ec5
\
u4ec5
\
u662f
\
u8ba9
\
u6570
\
u636e
\
u5728
"
:
0
,
"
\
u800c
\
u5b83
\
u81ea
\
u8eab
\
u5c5e
\
u4e8e
\
u5185
\
u6838
\
u6001
"
:
0
,
"
\
u8054
\
u7cfb
\
u65b9
\
u5f0f
\
u4ee5
\
u53ca
\
u5e93
\
u4f9d
\
u8d56
\
u7b49
\
u7b49
"
:
0
,
"
\
u80cc
\
u540e
\
u6709
\
u7740
\
u4ece
\
u786c
\
u4ef6
"
:
0
,
"
\
u8868
\
u793a
\
u5404
\
u7ea7
\
u8fd0
\
u884c
\
u73af
\
u5883
"
:
0
,
"
\
u8ba9
\
u6211
\
u4eec
\
u4f7f
\
u7528
"
:
0
,
"
\
u8ba9
\
u6211
\
u4eec
\
u770b
\
u4e00
\
u4e0b
\
u91cc
\
u9762
\
u7684
\
u5185
\
u5bb9
"
:
0
,
"
\
u8bbe
\
u5907
"
:
0
,
"
\
u8d8a
\
u5f80
\
u4e0b
\
u5219
\
u8d8a
\
u9760
\
u8fd1
\
u5e95
\
u5c42
"
:
0
,
"
\
u8f6f
\
u4ef6
\
u5f53
\
u7136
\
u4e5f
\
u9700
\
u8981
\
u77e5
\
u9053
\
u5904
\
u7406
\
u5668
\
u4f1a
\
u5982
\
u4f55
\
u6267
\
u884c
\
u8fd9
\
u4e9b
\
u6307
\
u4ee4
"
:
0
,
"
\
u8fc7
\
u591a
\
u7684
\
u62bd
\
u8c61
\
u548c
\
u8fc7
\
u5c11
\
u7684
\
u62bd
\
u8c61
\
u81ea
\
u7136
\
u90fd
\
u662f
\
u4e0d
\
u5408
\
u9002
\
u7684
"
:
0
,
"
\
u8fd8
\
u662f
\
u57fa
\
u4e8e
\
u67d0
\
u79cd
\
u7f16
\
u7a0b
\
u8bed
\
u8a00
\
u5229
\
u7528
"
:
0
,
"
\
u8fd8
\
u6709
"
:
0
,
"
\
u8fd8
\
u9700
\
u8981
\
u5bf9
\
u7528
\
u6237
\
u6001
\
u5e94
\
u7528
\
u7684
\
u6267
\
u884c
\
u8fdb
\
u884c
\
u76d1
\
u63a7
\
u548c
\
u7ba1
\
u7406
"
:
0
,
"
\
u8fd9
\
u4e2a
\
u8ba9
\
u4eba
\
u633a
\
u4e0d
\
u723d
\
u7684
"
:
4
,
"
\
u8fd9
\
u662f
"
:
4
,
"
\
u8fd9
\
u79cd
\
u65b9
\
u5f0f
\
u5177
\
u6709
\
u6700
\
u9ad8
\
u7684
\
u7075
\
u6d3b
\
u6027
"
:
0
,
"
\
u8fd9
\
u91cc
"
:
4
,
"
\
u8fd9
\
u91cc
\
u662f
\
u4e00
\
u884c
\
u6570
\
u5b66
\
u516c
\
u5f0f
"
:
4
,
"
\
u9009
\
u9879
\
u6765
\
u544a
\
u8bc9
"
:
0
,
"
\
u90a3
\
u4e48
\
u6211
\
u4eec
\
u5c31
\
u662f
\
u5728
\
u624b
\
u5199
\
u6c47
\
u7f16
\
u4ee3
\
u7801
"
:
0
,
"
\
u94fe
\
u63a5
\
u6700
\
u540e
\
u7684
\
u4e0b
\
u5212
\
u7ebf
\
u548c
\
u7247
\
u6bb5
\
u7684
\
u540e
\
u7eed
\
u5185
\
u5bb9
\
u4e4b
\
u95f4
\
u4e5f
\
u9700
\
u8981
"
:
4
,
"
\
u94fe
\
u63a5
\
u7684
\
u540d
\
u5b57
\
u548c
\
u7528
\
u4e00
\
u5bf9
\
u5c16
\
u62ec
\
u53f7
\
u5305
\
u88f9
\
u8d77
\
u6765
\
u7684
\
u94fe
\
u63a5
\
u5730
\
u5740
\
u4e4b
\
u95f4
\
u5fc5
\
u987b
\
u6709
\
u4e00
\
u4e2a
\
u7a7a
\
u683c
"
:
4
,
"
\
u963f
"
:[],
"
\
u9664
\
u4e86
\
u6700
\
u4e0a
\
u5c42
\
u7684
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u548c
\
u6700
\
u4e0b
\
u5c42
\
u7684
\
u786c
\
u4ef6
\
u5e73
\
u53f0
\
u5fc5
\
u987b
\
u5b58
\
u5728
\
u4e4b
\
u5916
"
:
0
,
"
\
u9700
\
u8981
\
u6ce8
\
u610f
\
u5230
\
u6211
\
u4eec
\
u6240
\
u4eab
\
u53d7
\
u5230
\
u7684
\
u7f16
\
u7a0b
\
u7684
\
u65b9
\
u4fbf
\
u5e76
\
u4e0d
\
u662f
\
u7406
\
u6240
\
u5f53
\
u7136
\
u7684
"
:
0
,
"
\
u9879
\
u76ee
"
:
0
,
"
\
u9879
\
u76ee
\
u7684
\
u6587
\
u4ef6
\
u7ed3
\
u6784
\
u5982
\
u4e0b
"
:
0
,
"
\
u9ed1
\
u8272
\
u5757
\
u5219
\
u8868
\
u793a
\
u76f8
\
u90bb
\
u4e24
\
u5c42
\
u8fd0
\
u884c
\
u73af
\
u5883
\
u4e4b
\
u95f4
"
:
0
,
"
abstract
"
:
0
,
"
new
"
:
0
,
add
:
4
,
alpha
:
4
,
architectur
:
0
,
beta
:
4
,
bin
:
0
,
call
:
0
,
caption
:[],
cargo
:
0
,
central
:
0
,
compil
:
0
,
cos
:
4
,
cpu
:
0
,
debug
:
0
,
debuginfo
:
0
,
dev
:
0
,
directori
:
0
,
environ
:
0
,
execut
:
0
,
file
:
0
,
finish
:
0
,
gif
:
4
,
hello
:
0
,
home
:
0
,
i32
:
4
,
instruct
:
0
,
isa
:
0
,
linux
:
0
,
maco
:
0
,
main
:
0
,
memori
:
0
,
println
:
0
,
process
:
0
,
processor
:
0
,
rcore
:[
0
,
3
],
readthedoc
:
4
,
run
:
0
,
rust
:[
0
,
4
],
set
:
0
,
shinbokuow
:
0
,
sin
:
4
,
sphinx
:
4
,
src
:
0
,
std
:
0
,
system
:
0
,
target
:
0
,
toml
:
0
,
tree
:
0
,
tutori
:[
0
,
3
],
unit
:
0
,
unoptim
:
0
,
window
:
0
,
workspac
:
0
,
world
:
0
},
titles
:[
"
\
u79fb
\
u9664
\
u6807
\
u51c6
\
u5e93
\
u4f9d
\
u8d56
"
,
"
\
u7b2c
\
u4e00
\
u7ae0
\
uff1a
\
u7f16
\
u8bd1
\
u8fd0
\
u884c RV64
\
u88f8
\
u673a
\
u7a0b
\
u5e8f
"
,
"
rCore-Tutorial-Book
\
u7b2c
\
u4e09
\
u7248
"
,
"
\
u5feb
\
u901f
\
u4e0a
\
u624b
"
,
"
reStructuredText
\
u57fa
\
u672c
\
u8bed
\
u6cd5
"
],
titleterms
:{
"
\
u57fa
\
u672c
\
u8bed
\
u6cd5
"
:
4
,
"
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u8fd0
\
u884c
\
u73af
\
u5883
"
:
0
,
"
\
u5feb
\
u901f
\
u4e0a
\
u624b
"
:
3
,
"
\
u76ee
\
u6807
\
u4e09
\
u5143
\
u7ec4
"
:
0
,
"
\
u79fb
\
u9664
\
u6807
\
u51c6
\
u5e93
\
u4f9d
\
u8d56
"
:
0
,
"
\
u7b2c
\
u4e00
\
u7ae0
"
:
1
,
"
\
u7b2c
\
u4e09
\
u7248
"
:
2
,
"
\
u7f16
\
u8bd1
\
u8fd0
\
u884c
"
:
1
,
"
\
u88f8
\
u673a
\
u7a0b
\
u5e8f
"
:
1
,
book
:
2
,
rcore
:
2
,
restructuredtext
:
4
,
rv64
:
1
,
tutori
:
2
}})
\ No newline at end of file
Search
.
setIndex
({
docnames
:[
"
chapter1/1app-ee-platform
"
,
"
chapter1/index
"
,
"
index
"
,
"
quickstart
"
,
"
rest-example
"
],
envversion
:{
"
sphinx.domains.c
"
:
2
,
"
sphinx.domains.changeset
"
:
1
,
"
sphinx.domains.citation
"
:
1
,
"
sphinx.domains.cpp
"
:
3
,
"
sphinx.domains.index
"
:
1
,
"
sphinx.domains.javascript
"
:
2
,
"
sphinx.domains.math
"
:
2
,
"
sphinx.domains.python
"
:
2
,
"
sphinx.domains.rst
"
:
2
,
"
sphinx.domains.std
"
:
1
,
sphinx
:
56
},
filenames
:[
"
chapter1/1app-ee-platform.rst
"
,
"
chapter1/index.rst
"
,
"
index.rst
"
,
"
quickstart.rst
"
,
"
rest-example.rst
"
],
objects
:{},
objnames
:{},
objtypes
:{},
terms
:{
"
15s
"
:
0
,
"
73dc675b9
"
:
0
,
"
73dc675b9437c2a51a975a9f58cc66f05463c351
"
:
0
,
"
\
u4e00
\
u4e2a
\
u5168
\
u9762
\
u5c55
\
u793a
"
:
4
,
"
\
u4e00
\
u4e2a
\
u6587
\
u4ef6
"
:
0
,
"
\
u4e00
\
u6bb5
\
u793a
\
u4f8b
"
:
4
,
"
\
u4e00
\
u9879
\
u53ef
\
u4ee5
\
u770b
\
u51fa
\
u9ed8
\
u8ba4
\
u7684
\
u76ee
\
u6807
\
u5e73
\
u53f0
\
u662f
"
:
0
,
"
\
u4e09
\
u8005
\
u4e4b
\
u95f4
\
u6765
\
u56de
\
u6298
\
u817e
"
:[],
"
\
u4e09
\
u8005
\
u4e4b
\
u95f4
\
u6d41
\
u52a8
"
:
0
,
"
\
u4e0a
\
u8fd0
\
u884c
"
:
0
,
"
\
u4e0b
\
u5c42
\
u4f5c
\
u4e3a
\
u4e0a
\
u5c42
\
u7684
\
u6267
\
u884c
\
u73af
\
u5883
\
u652f
\
u6301
\
u4e0a
\
u5c42
\
u4ee3
\
u7801
\
u7684
\
u8fd0
\
u884c
"
:
0
,
"
\
u4e0b
\
u5c42
\
u4f5c
\
u4e3a
\
u4e0a
\
u5c42
\
u7684
\
u8fd0
\
u884c
\
u73af
\
u5883
\
u652f
\
u6301
\
u4e0a
\
u5c42
\
u4ee3
\
u7801
\
u7684
\
u8fd0
\
u884c
"
:[],
"
\
u4e0b
\
u9762
\
u662f
\
u4e00
\
u4e2a
\
u6ce8
\
u8bb0
"
:
4
,
"
\
u4e0b
\
u9762
\
u662f
\
u4e00
\
u4e2a
\
u6d4b
\
u8bd5
"
:
4
,
"
\
u4e0b
\
u9762
\
u662f
\
u4e00
\
u4e2a
\
u8b66
\
u544a
"
:
4
,
"
\
u4e0b
\
u9762
\
u662f
\
u4e00
\
u4e2a
\
u9519
\
u8bef
"
:
4
,
"
\
u4e0b
\
u9762
\
u7ee7
\
u7eed
\
u6211
\
u4eec
\
u7684
\
u8b66
\
u544a
"
:
4
,
"
\
u4e0d
\
u540c
\
u7684
\
u8bdd
"
:
0
,
"
\
u4e14
\
u8fd9
\
u4e9b
\
u529f
\
u80fd
\
u5df2
\
u7ecf
\
u8db3
\
u4ee5
\
u7528
\
u6765
\
u6784
\
u9020
\
u4e00
\
u4e2a
\
u5177
\
u6709
\
u76f8
\
u5f53
\
u62bd
\
u8c61
\
u80fd
\
u529b
\
u7684
\
u5185
\
u6838
\
u4e86
"
:
0
,
"
\
u4e2d
"
:
4
,
"
\
u4e2d
\
u4fdd
\
u5b58
\
u7740
\
u9879
\
u76ee
\
u7684
\
u914d
\
u7f6e
"
:
0
,
"
\
u4e2d
\
u63d0
\
u4f9b
\
u7684
\
u6c47
\
u7f16
\
u6307
\
u4ee4
\
u6765
\
u8bbf
\
u95ee
\
u5404
\
u79cd
\
u786c
\
u4ef6
\
u8d44
\
u6e90
"
:
0
,
"
\
u4e2d
\
u7684
\
u6307
\
u4ee4
"
:
0
,
"
\
u4e3a
\
u4e86
\
u5efa
\
u7acb
\
u5e76
\
u7ef4
\
u62a4
\
u67b6
\
u6784
\
u7684
\
u5e94
\
u7528
\
u751f
\
u6001
"
:
0
,
"
\
u4e3a
\
u4e86
\
u9002
\
u5e94
\
u73b0
\
u4ee3
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u7684
\
u573a
\
u666f
"
:
0
,
"
\
u4e3a
\
u4f55
\
u57fa
\
u4e8e
"
:
0
,
"
\
u4e3b
\
u9898
\
u4e86
"
:
4
,
"
\
u4e4b
\
u524d
\
u7684
"
:[],
"
\
u4e4b
\
u540e
"
:
0
,
"
\
u4e5f
\
u4f1a
\
u5b9e
\
u73b0
\
u8fd9
\
u91cc
\
u9762
\
u7684
\
u4e00
\
u4e9b
\
u7cfb
\
u7edf
\
u8c03
\
u7528
"
:
0
,
"
\
u4e5f
\
u5c31
\
u662f
\
u4e00
\
u4e9b
\
u5bf9
\
u4e8e
\
u76ee
\
u524d
\
u7684
\
u5e94
\
u7528
\
u573a
\
u666f
\
u6ca1
\
u6709
\
u4efb
\
u4f55
\
u610f
\
u4e49
"
:
0
,
"
\
u4e5f
\
u5c31
\
u662f
\
u6ca1
\
u6709
\
u4efb
\
u4f55
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u652f
\
u6301
"
:[],
"
\
u4e8b
\
u5b9e
\
u4e0a
"
:
4
,
"
\
u4e8b
\
u5b9e
\
u4e0a
\
u5b83
\
u4eec
\
u5c5e
\
u4e8e
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u7684
"
:
0
,
"
\
u4ece
\
u4e0a
\
u9762
\
u7ed9
\
u51fa
\
u7684
"
:
0
,
"
\
u4ece
\
u4e4b
\
u524d
\
u7684
"
:
0
,
"
\
u4ece
\
u5176
\
u4e2d
\
u7684
"
:
0
,
"
\
u4ece
\
u5185
\
u6838
"
:
0
,
"
\
u4ece
\
u786c
\
u4ef6
\
u7684
\
u89d2
\
u5ea6
\
u6765
\
u770b
"
:
0
,
"
\
u4ee3
\
u7801
"
:
4
,
"
\
u4eec
\
u8fd8
\
u4f1a
\
u5728
\
u6267
\
u884c
\
u5e94
\
u7528
\
u4e4b
\
u524d
\
u5b8c
\
u6210
\
u4e00
\
u4e9b
\
u521d
\
u59cb
\
u5316
\
u5de5
\
u4f5c
"
:
0
,
"
\
u4f1a
\
u4e27
\
u5931
\
u4e00
\
u4e9b
"
:
0
,
"
\
u4f1a
\
u5bfc
\
u81f4
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u63a5
\
u53e3
\
u4e0d
\
u540c
\
u6216
\
u8005
\
u8bed
\
u4e49
\
u4e0d
\
u4e00
\
u81f4
"
:
0
,
"
\
u4f46
\
u53c8
\
u5fc5
\
u987b
"
:
0
,
"
\
u4f46
\
u62bd
\
u8c61
\
u540c
\
u65f6
\
u4e5f
\
u662f
\
u4e00
\
u79cd
\
u9650
\
u5236
"
:
0
,
"
\
u4f46
\
u662f
"
:
0
,
"
\
u4f46
\
u662f
\
u5b83
\
u4e0a
\
u9762
\
u901a
\
u5e38
\
u53ea
\
u4f1a
\
u540c
\
u65f6
\
u8fd0
\
u884c
\
u4e00
\
u4e2a
\
u6216
\
u51e0
\
u4e2a
\
u529f
\
u80fd
\
u975e
\
u5e38
\
u7b80
\
u5355
\
u7684
\
u5c0f
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
"
:
0
,
"
\
u4f46
\
u662f
\
u5f88
\
u5feb
\
u6211
\
u4eec
\
u5c31
\
u5c06
\
u9047
\
u5230
\
u53e6
\
u5916
\
u4e00
\
u79cd
\
u60c5
\
u51b5
"
:
0
,
"
\
u4f46
\
u662f
\
u8fd9
\
u4e9b
\
u5e93
\
u7684
\
u529f
\
u80fd
\
u4e0d
\
u4ec5
\
u9650
\
u4e8e
\
u6b64
"
:
0
,
"
\
u4f46
\
u7ad9
\
u5728
\
u6559
\
u5b66
\
u7684
\
u89d2
\
u5ea6
\
u51e0
\
u4e4e
\
u5b8c
\
u5168
\
u662f
\
u5728
\
u6d6a
\
u8d39
\
u65f6
\
u95f4
"
:
0
,
"
\
u4f5c
\
u4e3a
\
u4e00
\
u5207
\
u7684
\
u5f00
\
u59cb
"
:
0
,
"
\
u4f5c
\
u4e3a
\
u4e2d
\
u95f4
\
u5c42
\
u7684
\
u51fd
\
u6570
\
u5e93
\
u548c
\
u5185
\
u6838
\
u5e76
\
u4e0d
\
u662f
\
u5fc5
\
u987b
\
u5b58
\
u5728
\
u7684
"
:
0
,
"
\
u4f5c
\
u4e3a
\
u4e2d
\
u95f4
\
u5c42
\
u7684
\
u51fd
\
u6570
\
u5e93
\
u548c
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u5e76
\
u4e0d
\
u662f
\
u5fc5
\
u987b
\
u5b58
\
u5728
\
u7684
"
:[],
"
\
u4f7f
\
u5f97
\
u4ec5
\
u9700
\
u5c11
\
u91cf
\
u7684
\
u6e90
\
u4ee3
\
u7801
\
u5c31
\
u80fd
\
u5b8c
\
u6210
\
u590d
\
u6742
\
u7684
"
:
0
,
"
\
u4f7f
\
u5f97
\
u8f6f
\
u4ef6
\
u53ef
\
u4ee5
\
u901a
\
u8fc7
"
:
0
,
"
\
u5176
\
u4e2d
"
:
0
,
"
\
u5176
\
u4e2d
\
u5904
\
u7406
\
u5668
\
u65e0
\
u7591
\
u662f
\
u5176
\
u4e2d
\
u6700
\
u590d
\
u6742
\
u540c
\
u65f6
\
u4e5f
\
u6700
\
u5173
\
u952e
\
u7684
\
u4e00
\
u4e2a
"
:
0
,
"
\
u5176
\
u4f59
\
u7684
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u57fa
\
u672c
\
u4e0a
\
u5206
\
u522b
\
u7528
\
u4e8e
\
u51fd
\
u6570
\
u5e93
\
u548c
\
u5185
\
u6838
\
u4e24
\
u5c42
\
u6267
\
u884c
\
u73af
\
u5883
\
u7684
\
u521d
\
u59cb
\
u5316
\
u5de5
\
u4f5c
\
u548c
\
u5bf9
\
u4e8e
\
u4e0a
\
u5c42
\
u7684
\
u8fd0
\
u884c
\
u671f
\
u76d1
\
u63a7
\
u548c
\
u7ba1
\
u7406
"
:
0
,
"
\
u5176
\
u4f59
\
u7684
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u57fa
\
u672c
\
u662f
\
u7528
\
u4e8e
\
u51fd
\
u6570
\
u5e93
\
u548c
\
u5185
\
u6838
\
u4e24
\
u5c42
\
u6267
\
u884c
\
u73af
\
u5883
\
u7684
\
u521d
\
u59cb
\
u5316
\
u5de5
\
u4f5c
\
u548c
\
u5bf9
\
u4e8e
\
u4e0a
\
u5c42
\
u7684
\
u8fd0
\
u884c
\
u671f
\
u76d1
\
u63a7
\
u548c
\
u7ba1
\
u7406
"
:[],
"
\
u5176
\
u53c2
\
u6570
\
u7684
\
u5177
\
u4f53
\
u542b
\
u4e49
\
u6211
\
u4eec
\
u6682
\
u4e14
\
u4e0d
\
u5728
\
u8fd9
\
u91cc
\
u8fdb
\
u884c
\
u89e3
\
u91ca
"
:
0
,
"
\
u5176
\
u5b9a
\
u4f4d
\
u5c31
\
u662f
\
u90a3
\
u79cd
\
u529f
\
u80fd
\
u5355
\
u4e00
\
u7684
\
u573a
\
u666f
"
:
0
,
"
\
u5176
\
u6807
\
u51c6
\
u5e93
\
u6216
\
u4e09
\
u65b9
\
u5e93
"
:
0
,
"
\
u5185
\
u5b58
"
:
0
,
"
\
u5185
\
u5b58
\
u548c
"
:
0
,
"
\
u5185
\
u6838
\
u4f5c
\
u4e3a
\
u7528
\
u6237
\
u6001
\
u7684
\
u8fd0
\
u884c
\
u73af
\
u5883
"
:
0
,
"
\
u5185
\
u6838
\
u7684
\
u517c
\
u5bb9
\
u6027
"
:
0
,
"
\
u5229
\
u7528
"
:
0
,
"
\
u5230
\
u8f6f
\
u4ef6
\
u7684
\
u591a
\
u79cd
\
u673a
\
u5236
\
u7684
\
u652f
\
u6301
"
:
0
,
"
\
u529f
\
u80fd
"
:
0
,
"
\
u52a0
\
u7c97
"
:
4
,
"
\
u5305
\
u62ec
\
u4f5c
\
u8005
\
u7684
\
u4fe1
\
u606f
"
:
0
,
"
\
u5355
\
u72ec
\
u7684
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u6216
\
u662f
\
u7528
\
u4e13
\
u4e3a
\
u5e94
\
u7528
\
u573a
\
u666f
\
u7279
\
u522b
\
u88c1
\
u51cf
\
u8fc7
\
u7684
\
u8f7b
\
u91cf
\
u7ea7
\
u5185
\
u6838
\
u7ba1
\
u7406
\
u5c11
\
u6570
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
"
:
0
,
"
\
u5373
\
u53ef
\
u770b
\
u5230
\
u4e00
\
u957f
\
u4e32
\
u7684
\
u7cfb
\
u7edf
\
u8c03
\
u7528
"
:
0
,
"
\
u5382
\
u5546
\
u548c
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
"
:
0
,
"
\
u5382
\
u5546
\
u662f
"
:
0
,
"
\
u53ef
\
u4ee5
\
u770b
\
u4e00
\
u4e0b
\
u76ee
\
u524d
"
:
0
,
"
\
u53ef
\
u4ee5
\
u770b
\
u51fa
"
:
0
,
"
\
u53ef
\
u4ee5
\
u8fdb
\
u5165
\
u5feb
\
u901f
\
u4e0a
\
u624b
\
u73af
\
u8282
"
:
4
,
"
\
u53ef
\
u4ee5
\
u901a
\
u8fc7
"
:
0
,
"
\
u56e0
\
u6b64
"
:
0
,
"
\
u56e0
\
u6b64
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u5145
\
u5f53
\
u4e86
\
u7528
\
u6237
\
u548c
\
u5185
\
u6838
\
u4e4b
\
u95f4
"
:
0
,
"
\
u56fe
\
u4e2d
\
u7684
\
u767d
\
u8272
\
u5757
\
u81ea
\
u4e0a
\
u800c
\
u4e0b
"
:
0
,
"
\
u5728
"
:
0
,
"
\
u5728
\
u5d4c
\
u5165
\
u5f0f
\
u573a
\
u666f
\
u5c31
\
u5e38
\
u5e38
\
u4f1a
\
u51fa
\
u73b0
\
u8fd9
\
u79cd
\
u60c5
\
u51b5
"
:
0
,
"
\
u5728
\
u5d4c
\
u5165
\
u5f0f
\
u573a
\
u666f
\
u662f
\
u8fc7
\
u62bd
\
u8c61
\
u7684
"
:
0
,
"
\
u5728
\
u6211
\
u4eec
\
u901a
\
u5e38
\
u4e0d
\
u4f1a
\
u6ce8
\
u610f
\
u5230
\
u7684
\
u5730
\
u65b9
"
:
0
,
"
\
u57fa
\
u672c
\
u7684
\
u6587
\
u672c
\
u6837
\
u5f0f
"
:
4
,
"
\
u57fa
\
u672c
\
u7b49
\
u540c
\
u4e8e
\
u786c
\
u4ef6
"
:
0
,
"
\
u5904
\
u7406
\
u5668
"
:
0
,
"
\
u5904
\
u7406
\
u5668
\
u8fd8
\
u9700
\
u8981
\
u63d0
\
u4f9b
\
u5f88
\
u591a
\
u989d
\
u5916
\
u7684
\
u673a
\
u5236
"
:
0
,
"
\
u5916
\
u90e8
\
u94fe
\
u63a5
\
u7684
\
u5f15
\
u5165
\
u65b9
\
u6cd5
"
:
4
,
"
\
u591a
\
u5c42
\
u6267
\
u884c
\
u73af
\
u5883
\
u90fd
\
u662f
\
u5fc5
\
u9700
\
u7684
\
u5417
"
:
0
,
"
\
u5982
\
u4e0b
\
u56fe
\
u6240
\
u793a
"
:
0
,
"
\
u5982
\
u6211
\
u4eec
\
u9884
\
u60f3
\
u7684
\
u4e00
\
u6837
"
:
0
,
"
\
u5982
\
u679c
\
u4ec5
\
u4ec5
\
u57fa
\
u4e8e
\
u5df2
\
u6709
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u63d0
\
u4f9b
\
u7684
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u7684
\
u8bdd
"
:
0
,
"
\
u5982
\
u679c
\
u4ec5
\
u5b58
\
u5728
\
u51fd
\
u6570
\
u5e93
\
u800c
\
u4e0d
\
u5b58
\
u5728
\
u5185
\
u6838
"
:
0
,
"
\
u5982
\
u679c
\
u51fd
\
u6570
\
u5e93
\
u548c
\
u5185
\
u6838
\
u90fd
\
u4e0d
\
u5b58
\
u5728
"
:
0
,
"
\
u5982
\
u679c
\
u5e95
\
u5c42
\
u786c
\
u4ef6
\
u4e0d
\
u540c
"
:
0
,
"
\
u5982
\
u679c
\
u7528
\
u6237
\
u6001
\
u57fa
\
u4e8e
\
u7684
\
u5185
\
u6838
\
u4e0d
\
u540c
"
:
0
,
"
\
u5b58
\
u5728
\
u5927
\
u91cf
\
u7684
\
u5386
\
u53f2
\
u5305
\
u88b1
"
:
0
,
"
\
u5b83
"
:
0
,
"
\
u5b83
\
u4e00
\
u822c
\
u5305
\
u62ec
"
:
0
,
"
\
u5b83
\
u4e0a
\
u9762
\
u7684
\
u4e00
\
u5207
\
u90fd
\
u5c5e
\
u4e8e
\
u7528
\
u6237
\
u6001
"
:
0
,
"
\
u5b83
\
u4e0a
\
u9762
\
u7684
\
u4e00
\
u5207
\
u90fd
\
u5c5e
\
u4e8e
\
u8f6f
\
u4ef6
"
:
0
,
"
\
u5b83
\
u4e0d
\
u4ec5
\
u8981
\
u63d0
\
u4f9b
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u63a5
\
u53e3
"
:
0
,
"
\
u5b83
\
u4e0e
\
u8f6f
\
u4ef6
\
u7ea6
\
u5b9a
\
u4e00
\
u5957
"
:
0
,
"
\
u5b83
\
u4eec
\
u7684
\
u524d
\
u540e
\
u90fd
\
u9700
\
u8981
\
u6709
\
u4e00
\
u4e2a
\
u7a7a
\
u683c
\
u9694
\
u5f00
\
u5176
\
u4ed6
\
u5185
\
u5bb9
"
:
4
,
"
\
u5b83
\
u4eec
\
u786e
\
u5b9e
\
u90fd
\
u4f1a
\
u63a7
\
u5236
\
u76ee
\
u6807
\
u6587
\
u4ef6
\
u7684
\
u751f
\
u6210
"
:
0
,
"
\
u5b83
\
u4eec
\
u90fd
\
u4f1a
\
u5bfc
\
u81f4
\
u6700
\
u7ec8
\
u751f
\
u6210
\
u7684
\
u76ee
\
u6807
\
u6587
\
u4ef6
\
u6709
\
u5f88
\
u5927
\
u4e0d
\
u540c
"
:
0
,
"
\
u5b83
\
u4eec
\
u90fd
\
u662f
\
u5bf9
\
u4e0b
\
u5c42
\
u8d44
\
u6e90
\
u8fdb
\
u884c
\
u4e86
"
:
0
,
"
\
u5b83
\
u53ef
\
u4ee5
\
u901a
\
u8fc7
\
u8c03
\
u7528
\
u7f16
\
u7a0b
\
u8bed
\
u8a00
\
u63d0
\
u4f9b
\
u7684
\
u6807
\
u51c6
\
u5e93
\
u6216
\
u8005
\
u5176
\
u4ed6
\
u4e09
\
u65b9
\
u5e93
\
u5bf9
\
u5916
\
u63d0
\
u4f9b
\
u7684
\
u529f
\
u80fd
\
u5f3a
\
u5927
\
u7684
\
u51fd
\
u6570
\
u63a5
\
u53e3
"
:
0
,
"
\
u5b83
\
u66f4
\
u5e38
\
u89c1
\
u7684
\
u540d
\
u5b57
\
u662f
\
u4e2d
\
u592e
\
u5904
\
u7406
\
u5355
\
u5143
"
:
0
,
"
\
u5b83
\
u770b
\
u4e0a
\
u53bb
\
u6ca1
\
u6709
\
u4efb
\
u4f55
\
u7279
\
u522b
\
u4e4b
\
u5904
"
:
0
,
"
\
u5b83
\
u81ea
\
u8eab
\
u7684
\
u62bd
\
u8c61
\
u80fd
\
u529b
\
u4f1a
\
u53d7
\
u5230
\
u5f88
\
u5927
\
u9650
\
u5236
"
:
0
,
"
\
u5b83
\
u975e
\
u5e38
\
u7f8e
\
u89c2
\
u5927
\
u65b9
"
:
4
,
"
\
u5b8f
\
u6b63
\
u662f
\
u7531
"
:
0
,
"
\
u5b9e
\
u73b0
\
u4e00
\
u4e9b
"
:[],
"
\
u5b9e
\
u73b0
\
u4e00
\
u4e9b
\
u67b6
\
u6784
\
u76f8
\
u5173
\
u4e14
\
u4ec5
\
u901a
\
u8fc7
\
u7f16
\
u7a0b
\
u8bed
\
u8a00
\
u65e0
\
u6cd5
\
u63cf
\
u8ff0
\
u7684
\
u5c0f
\
u6a21
\
u5757
\
u6216
\
u8005
\
u4ee3
\
u7801
\
u7247
\
u6bb5
"
:
0
,
"
\
u5b9e
\
u9645
\
u4e0a
"
:
0
,
"
\
u5b9e
\
u9645
\
u7684
\
u60c5
\
u51b5
\
u8fdc
\
u6bd4
\
u8fd9
\
u4e2a
\
u8981
\
u590d
\
u6742
\
u5f97
\
u591a
"
:
0
,
"
\
u5bc4
\
u5b58
\
u5668
"
:
0
,
"
\
u5bf9
\
u4e0a
\
u63d0
\
u4f9b
\
u7684
\
u6307
\
u4ee4
\
u96c6
\
u548c
\
u5bc4
\
u5b58
\
u5668
\
u90fd
\
u4e0d
\
u540c
"
:
0
,
"
\
u5bf9
\
u4e8e
\
u4e00
\
u4efd
\
u7528
\
u67d0
\
u79cd
\
u7f16
\
u7a0b
\
u8bed
\
u8a00
\
u5b9e
\
u73b0
\
u7684
\
u6e90
\
u4ee3
\
u7801
\
u800c
\
u8a00
"
:
0
,
"
\
u5bf9
\
u4e8e
\
u786c
\
u4ef6
\
u8d44
\
u6e90
\
u7684
\
u8bbf
\
u95ee
\
u65b9
\
u5f0f
\
u4f1a
\
u6709
\
u5dee
\
u5f02
"
:
0
,
"
\
u5c31
\
u5e38
\
u5e38
\
u9700
\
u8981
\
u8fd9
\
u65b9
\
u9762
\
u7684
\
u6743
\
u8861
"
:
0
,
"
\
u5d4c
\
u5165
\
u5f0f
\
u8bbe
\
u5907
\
u867d
\
u7136
\
u4e5f
\
u5305
\
u542b
"
:
0
,
"
\
u5de5
\
u5177
\
u5373
\
u53ef
\
u4e00
\
u6761
\
u547d
\
u4ee4
\
u5b9e
\
u73b0
\
u6784
\
u5efa
\
u5e76
\
u8fd0
\
u884c
\
u9879
\
u76ee
"
:
0
,
"
\
u5de5
\
u5177
\
u6765
\
u521b
\
u5efa
\
u4e00
\
u4e2a
"
:
0
,
"
\
u5de5
\
u5177
\
u6765
\
u8fd0
\
u884c
\
u4e00
\
u4e2a
\
u7a0b
\
u5e8f
\
u5e76
\
u8f93
\
u51fa
\
u7a0b
\
u5e8f
\
u8fd0
\
u884c
\
u8fc7
\
u7a0b
\
u5f53
\
u4e2d
\
u5411
\
u5185
\
u6838
\
u8bf7
\
u6c42
\
u7684
\
u6240
\
u6709
\
u7684
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u53ca
\
u5176
\
u8fd4
\
u56de
\
u503c
"
:
0
,
"
\
u5e38
\
u89c1
\
u7684
\
u89e3
\
u51b3
\
u65b9
\
u6848
\
u662f
\
u4ec5
\
u4f7f
\
u7528
\
u51fd
\
u6570
\
u5e93
\
u6784
\
u5efa
"
:
0
,
"
\
u5e73
\
u53f0
"
:
0
,
"
\
u5e76
\
u4e3a
\
u4e0a
\
u5c42
\
u63d0
\
u4f9b
\
u4e86
\
u4e00
\
u5957
\
u8fd0
\
u884c
\
u73af
\
u5883
"
:
0
,
"
\
u5e76
\
u540c
\
u65f6
\
u53ef
\
u4ee5
\
u63d0
\
u4f9b
\
u4e00
\
u4e9b
\
u4fdd
\
u62a4
"
:
0
,
"
\
u5e76
\
u5728
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u6267
\
u884c
\
u7684
\
u65f6
\
u5019
\
u5bf9
\
u5b83
\
u8fdb
\
u884c
\
u76d1
\
u63a7
"
:
0
,
"
\
u5e94
\
u6709
\
u7684
\
u7075
\
u6d3b
\
u6027
"
:
0
,
"
\
u5e94
\
u7528
"
:
0
,
"
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u7684
\
u8fd0
\
u884c
\
u9700
\
u8981
\
u4e0b
\
u9762
\
u4e00
\
u5957
\
u8fd0
\
u884c
\
u73af
\
u5883
\
u6808
\
u7684
\
u652f
\
u6301
"
:
0
,
"
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u8fd0
\
u884c
\
u73af
\
u5883
\
u6808
"
:
0
,
"
\
u5f53
\
u4f60
\
u5728
\
u8003
\
u8651
\
u5728
\
u9879
\
u76ee
\
u4e2d
\
u5e94
\
u8be5
\
u4f7f
\
u7528
\
u54ea
\
u4e2a
\
u51fd
\
u6570
\
u5e93
\
u7684
\
u65f6
\
u5019
"
:
0
,
"
\
u5f53
\
u7136
"
:
0
,
"
\
u5feb
\
u901f
\
u4e0a
\
u624b
"
:
4
,
"
\
u60c5
\
u51b5
\
u4e0b
"
:
0
,
"
\
u610f
\
u5473
\
u7740
\
u6211
\
u4eec
\
u4e0d
\
u9700
\
u8981
\
u5185
\
u6838
\
u63d0
\
u4f9b
\
u7684
\
u62bd
\
u8c61
"
:
0
,
"
\
u6211
\
u4eec
"
:
0
,
"
\
u6211
\
u4eec
\
u521b
\
u5efa
\
u4e00
\
u4e2a
\
u53ef
\
u6267
\
u884c
\
u9879
\
u76ee
\
u800c
\
u4e0d
\
u662f
\
u5e93
\
u9879
\
u76ee
"
:
0
,
"
\
u6211
\
u4eec
\
u52a0
\
u4e0a
\
u4e86
"
:
0
,
"
\
u6211
\
u4eec
\
u53ea
\
u9700
\
u8f93
\
u5165
"
:
0
,
"
\
u6211
\
u4eec
\
u53ef
\
u4ee5
\
u5c1d
\
u8bd5
\
u770b
\
u4e00
\
u4e0b
"
:[],
"
\
u6211
\
u4eec
\
u53ef
\
u4ee5
\
u5c1d
\
u8bd5
\
u770b
\
u4e00
\
u4e0b
\
u4e4b
\
u524d
\
u7684
"
:
0
,
"
\
u6211
\
u4eec
\
u53ef
\
u4ee5
\
u901a
\
u8fc7
"
:
0
,
"
\
u6211
\
u4eec
\
u5728
\
u5c4f
\
u5e55
\
u4e0a
\
u770b
\
u5230
\
u4e86
\
u4e00
\
u884c
"
:
0
,
"
\
u6211
\
u4eec
\
u5728
\
u6253
\
u5370
"
:
0
,
"
\
u6211
\
u4eec
\
u5c06
"
:
0
,
"
\
u6211
\
u4eec
\
u5e0c
\
u671b
\
u80fd
\
u591f
\
u5728
\
u53e6
\
u4e00
\
u4e2a
\
u5e73
\
u53f0
\
u4e0a
\
u8fd0
\
u884c
"
:
0
,
"
\
u6211
\
u4eec
\
u5e38
\
u7528
\
u7684
"
:
0
,
"
\
u6211
\
u4eec
\
u751a
\
u81f3
\
u53ef
\
u4ee5
\
u63d2
\
u5165
\
u4e00
\
u6bb5
"
:
4
,
"
\
u6211
\
u4eec
\
u7684
\
u5e94
\
u7528
\
u4f4d
\
u4e8e
\
u6700
\
u4e0a
\
u5c42
"
:
0
,
"
\
u6211
\
u4eec
\
u901a
\
u5e38
\
u7528
\
u8fd9
\
u79cd
\
u65b9
\
u5f0f
\
u6765
"
:
0
,
"
\
u6211
\
u4eec
\
u901a
\
u8fc7
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u7684
\
u7279
\
u5f81
\
u6765
\
u5224
\
u65ad
\
u5b83
\
u9700
\
u8981
\
u4ec0
\
u4e48
\
u7a0b
\
u5ea6
\
u7684
\
u62bd
\
u8c61
"
:
0
,
"
\
u6233
"
:
4
,
"
\
u6240
\
u4ee5
\
u5b83
\
u5fc5
\
u987b
"
:
0
,
"
\
u6267
\
u884c
\
u73af
\
u5883
"
:
0
,
"
\
u62bd
\
u8c61
"
:
0
,
"
\
u62bd
\
u8c61
\
u7684
\
u4f18
\
u70b9
\
u5728
\
u4e8e
\
u5b83
\
u8ba9
\
u4e0a
\
u5c42
\
u4ee5
\
u8f83
\
u5c0f
\
u7684
\
u4ee3
\
u4ef7
\
u83b7
\
u5f97
\
u6240
\
u9700
\
u7684
\
u529f
\
u80fd
"
:
0
,
"
\
u62bd
\
u8c61
\
u80fd
\
u529b
\
u5219
\
u6700
\
u4f4e
"
:
0
,
"
\
u6307
\
u4ee4
\
u96c6
\
u4f53
\
u7cfb
\
u7ed3
\
u6784
"
:
0
,
"
\
u6307
\
u4ee4
\
u96c6
\
u62d3
\
u5c55
"
:
0
,
"
\
u6307
\
u4ee4
\
u96c6
\
u67b6
\
u6784
"
:[],
"
\
u6362
\
u6210
"
:
0
,
"
\
u63a5
\
u4e0b
\
u6765
\
u662f
\
u4e00
\
u4e2a
\
u6587
\
u6863
\
u5185
\
u90e8
\
u5f15
\
u7528
\
u7684
\
u4f8b
\
u5b50
"
:
4
,
"
\
u63a5
\
u4e0b
\
u6765
\
u7684
\
u5219
\
u662f
\
u884c
\
u95f4
\
u516c
\
u5f0f
"
:
4
,
"
\
u63d0
\
u4f9b
\
u7684
"
:
0
,
"
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u4ece
"
:[],
"
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u5982
"
:
0
,
"
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u63d0
\
u4f9b
\
u7684
"
:
0
,
"
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u662f
"
:
0
,
"
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u7684
\
u89d2
\
u5ea6
\
u770b
\
u6765
"
:
0
,
"
\
u659c
\
u4f53
"
:
4
,
"
\
u65b0
\
u751f
\
u7684
"
:
0
,
"
\
u65e0
\
u8bba
\
u7528
\
u6237
\
u6001
\
u5e94
\
u7528
\
u5982
\
u4f55
\
u7f16
\
u5199
"
:
0
,
"
\
u65f6
\
u4f7f
\
u7528
\
u7684
"
:
0
,
"
\
u662f
\
u56e0
\
u4e3a
\
u6211
\
u4eec
\
u53ea
\
u662f
\
u60f3
\
u8dd1
\
u4e00
\
u4e2a
"
:
0
,
"
\
u662f
\
u624b
\
u5199
\
u6c47
\
u7f16
\
u4ee3
\
u7801
"
:
0
,
"
\
u663e
\
u800c
\
u6613
\
u89c1
\
u6e90
\
u4ee3
\
u7801
\
u4fdd
\
u5b58
\
u5728
"
:
0
,
"
\
u6700
\
u7b80
\
u5355
\
u7684
"
:
0
,
"
\
u6700
\
u7b80
\
u5355
\
u7684
\
u8bdd
\
u5c31
\
u662f
\
u4e00
\
u6761
\
u4e00
\
u6761
\
u6267
\
u884c
\
u4f4d
\
u4e8e
\
u5185
\
u5b58
"
:
0
,
"
\
u6709
\
u4e00
\
u4e2a
\
u7a7a
\
u683c
"
:
4
,
"
\
u672c
\
u8282
\
u6211
\
u4eec
\
u5c06
\
u5b8c
\
u6210
\
u73af
\
u5883
\
u914d
\
u7f6e
\
u5e76
\
u6210
\
u529f
\
u8fd0
\
u884c
"
:
3
,
"
\
u6765
\
u5b9e
\
u73b0
"
:
0
,
"
\
u6765
\
u63cf
\
u8ff0
\
u4e00
\
u4e2a
\
u76ee
\
u6807
\
u5e73
\
u53f0
"
:
0
,
"
\
u6765
\
u81ea
\
u4e8e
"
:
4
,
"
\
u67b6
\
u6784
"
:
0
,
"
\
u67b6
\
u6784
\
u4e3a
\
u4e86
\
u5728
\
u5347
\
u7ea7
\
u6362
\
u4ee3
\
u7684
\
u540c
\
u65f6
\
u4fdd
\
u6301
\
u5bf9
\
u57fa
\
u4e8e
\
u65e7
\
u7248
\
u67b6
\
u6784
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
"
:
0
,
"
\
u67b6
\
u6784
\
u4ece
"
:
0
,
"
\
u67b6
\
u6784
\
u5341
\
u5206
\
u7b80
\
u6d01
"
:
0
,
"
\
u67b6
\
u6784
\
u6587
\
u6863
\
u9700
\
u8981
\
u9605
\
u8bfb
\
u7684
\
u6838
\
u5fc3
\
u90e8
\
u5206
\
u4e0d
\
u8db3
\
u767e
\
u9875
"
:
0
,
"
\
u67b6
\
u6784
\
u662f
"
:
0
,
"
\
u67b6
\
u6784
\
u800c
\
u975e
"
:
0
,
"
\
u67d0
\
u4e9b
\
u529f
\
u80fd
\
u603b
\
u8981
\
u76f4
\
u63a5
\
u6216
\
u95f4
\
u63a5
\
u7684
\
u901a
\
u8fc7
\
u5185
\
u6838
"
:
0
,
"
\
u67d0
\
u4e9b
\
u7f16
\
u8bd1
\
u5668
\
u652f
\
u6301
\
u540c
\
u4e00
\
u4efd
\
u6e90
\
u4ee3
\
u7801
\
u65e0
\
u9700
\
u4fee
\
u6539
\
u5c31
\
u53ef
\
u7f16
\
u8bd1
\
u5230
\
u591a
\
u4e2a
\
u4e0d
\
u540c
\
u7684
\
u76ee
\
u6807
\
u5e73
\
u53f0
\
u5e76
\
u5728
\
u4e0a
\
u9762
\
u8fd0
\
u884c
"
:
0
,
"
\
u6807
\
u51c6
\
u5e93
"
:
0
,
"
\
u6b22
\
u8fce
\
u6765
\
u5230
"
:
2
,
"
\
u6b64
\
u65f6
"
:
0
,
"
\
u6bd4
\
u5982
"
:[
0
,
4
],
"
\
u6bd4
\
u5982
\
u4eba
\
u8138
\
u8bc6
\
u522b
\
u6253
\
u5361
\
u7cfb
\
u7edf
\
u7b49
"
:
0
,
"
\
u6ca1
\
u6709
\
u5fc5
\
u8981
\
u4f7f
\
u7528
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u6240
\
u63d0
\
u4f9b
\
u7684
"
:
0
,
"
\
u6ce8
\
u610f
"
:
4
,
"
\
u6e90
\
u4ee3
\
u7801
\
u662f
"
:
0
,
"
\
u7279
\
u522b
\
u662f
"
:
0
,
"
\
u73b0
\
u5728
\
u6211
\
u4eec
\
u4e5f
\
u91c7
\
u7528
"
:
4
,
"
\
u7528
\
u5230
\
u4e86
\
u54ea
\
u4e9b
\
u7cfb
\
u7edf
\
u8c03
\
u7528
"
:
0
,
"
\
u7684
"
:
0
,
"
\
u7684
\
u5947
\
u602a
\
u8bbe
\
u5b9a
"
:
0
,
"
\
u7684
\
u5b98
\
u65b9
\
u6587
\
u6863
"
:
4
,
"
\
u7684
\
u5e73
\
u53f0
"
:
0
,
"
\
u7684
\
u63a5
\
u53e3
"
:
0
,
"
\
u7684
\
u76ee
\
u6807
\
u5e73
\
u53f0
\
u662f
\
u4ec0
\
u4e48
"
:
0
,
"
\
u7684
\
u8f93
\
u51fa
\
u53ef
\
u4ee5
\
u770b
\
u51fa
\
u4e4b
\
u524d
\
u6784
\
u5efa
\
u7684
\
u53ef
\
u6267
\
u884c
\
u6587
\
u4ef6
\
u4fdd
\
u5b58
\
u5728
"
:[],
"
\
u7684
\
u8f93
\
u51fa
\
u53ef
\
u4ee5
\
u770b
\
u51fa
\
u4e4b
\
u524d
\
u6784
\
u5efa
\
u7684
\
u53ef
\
u6267
\
u884c
\
u6587
\
u4ef6
\
u662f
\
u5728
"
:
0
,
"
\
u7684
\
u8fb9
\
u754c
"
:
0
,
"
\
u7684
\
u9ed8
\
u8ba4
\
u914d
\
u7f6e
\
u4fe1
\
u606f
"
:
0
,
"
\
u76ee
\
u524d
\
u4e3a
\
u6b62
\
u53ea
\
u6709
"
:
0
,
"
\
u76ee
\
u5f55
\
u4e0b
"
:
0
,
"
\
u76ee
\
u5f55
\
u4e0b
\
u7684
"
:
0
,
"
\
u76ee
\
u6807
\
u4e09
\
u5143
\
u7ec4
"
:
0
,
"
\
u76ee
\
u6807
\
u4e09
\
u5143
\
u7ec4
\
u4e2d
\
u7684
\
u64cd
\
u4f5c
\
u7cfb
\
u7edf
\
u662f
"
:
0
,
"
\
u76f4
\
u9762
\
u5e95
\
u5c42
\
u786c
\
u4ef6
\
u6765
\
u89e3
\
u9501
\
u66f4
\
u5927
\
u7684
\
u62bd
\
u8c61
\
u80fd
\
u529b
\
u4e0a
\
u9650
"
:
0
,
"
\
u76f8
\
u5173
\
u7684
\
u53ea
\
u6709
\
u4e00
\
u4e2a
\
u7cfb
\
u7edf
\
u8c03
\
u7528
"
:
0
,
"
\
u771f
\
u6b63
\
u5bb9
\
u6613
\
u770b
\
u51fa
\
u4e0e
"
:
0
,
"
\
u786c
\
u4ef6
\
u53ef
\
u4ee5
\
u5206
\
u4e3a
\
u4e09
\
u79cd
"
:
0
,
"
\
u7ae0
\
u8282
\
u5206
\
u5e03
\
u7684
\
u4f8b
\
u5b50
"
:
4
,
"
\
u7b49
\
u7684
\
u62bd
\
u8c61
\
u90fd
\
u652f
\
u6301
\
u540c
\
u65f6
\
u8fd0
\
u884c
\
u5f88
\
u591a
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
"
:
0
,
"
\
u7cfb
\
u5217
\
u67b6
\
u6784
"
:
0
,
"
\
u7cfb
\
u7edf
\
u4e0a
"
:
0
,
"
\
u7cfb
\
u7edf
\
u8c03
\
u7528
"
:
0
,
"
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u652f
\
u6301
\
u7684
\
u7248
\
u672c
"
:
0
,
"
\
u7ec8
\
u4e8e
\
u8be5
\
u4ecb
\
u7ecd
\
u6211
\
u4eec
\
u7684
\
u4e3b
\
u7ebf
\
u4efb
\
u52a1
\
u4e86
"
:
0
,
"
\
u7ed9
\
u51fa
\
u4e86
\
u5728
"
:
4
,
"
\
u7f16
\
u8bd1
\
u5668
\
u5728
\
u5c06
\
u5176
\
u901a
\
u8fc7
\
u7f16
\
u8bd1
"
:
0
,
"
\
u7f16
\
u8bd1
\
u5668
\
u652f
\
u6301
\
u54ea
\
u4e9b
\
u57fa
\
u4e8e
"
:
0
,
"
\
u800c
"
:
0
,
"
\
u800c
\
u4e0d
\
u4ec5
\
u4ec5
\
u662f
\
u5728
"
:[],
"
\
u800c
\
u4e0d
\
u4ec5
\
u4ec5
\
u662f
\
u8ba9
\
u6570
\
u636e
"
:[],
"
\
u800c
\
u4e0d
\
u4ec5
\
u4ec5
\
u662f
\
u8ba9
\
u6570
\
u636e
\
u5728
"
:
0
,
"
\
u800c
\
u4e0e
\
u4e4b
\
u524d
\
u7684
\
u9ed8
\
u8ba4
\
u5e73
\
u53f0
\
u4e0d
\
u540c
\
u7684
\
u5730
\
u65b9
\
u5728
\
u4e8e
"
:
0
,
"
\
u800c
\
u4e14
\
u6211
\
u4eec
\
u5f88
\
u6e05
\
u695a
\
u540e
\
u7eed
\
u6211
\
u4eec
\
u8981
\
u5f00
\
u53d1
\
u7684
\
u662f
\
u4e00
\
u4e2a
\
u5185
\
u6838
"
:
0
,
"
\
u800c
\
u53e6
\
u4e00
\
u4e9b
\
u7f16
\
u8bd1
\
u5668
\
u5219
\
u5df2
\
u7ecf
\
u9884
\
u8bbe
\
u597d
\
u4e86
\
u4e00
\
u4e2a
\
u56fa
\
u5b9a
\
u7684
\
u76ee
\
u6807
\
u5e73
\
u53f0
"
:
0
,
"
\
u800c
\
u5b83
\
u81ea
\
u8eab
\
u5c5e
\
u4e8e
\
u5185
\
u6838
\
u6001
"
:
0
,
"
\
u8054
\
u7cfb
\
u65b9
\
u5f0f
\
u4ee5
\
u53ca
\
u5e93
\
u4f9d
\
u8d56
\
u7b49
\
u7b49
"
:
0
,
"
\
u80cc
\
u540e
\
u6709
\
u7740
\
u4ece
\
u786c
\
u4ef6
"
:
0
,
"
\
u82b1
\
u5927
\
u91cf
\
u65f6
\
u95f4
\
u6b63
\
u786e
\
u8bbe
\
u7f6e
\
u624d
\
u80fd
\
u6b63
\
u5e38
\
u4f7f
\
u7528
"
:
0
,
"
\
u8868
\
u660e
\
u6ca1
\
u6709
\
u4efb
\
u4f55
\
u7cfb
\
u7edf
\
u8c03
\
u7528
\
u652f
\
u6301
"
:
0
,
"
\
u8868
\
u793a
\
u5404
\
u7ea7
\
u8fd0
\
u884c
\
u73af
\
u5883
"
:
0
,
"
\
u8ba9
\
u6211
\
u4eec
\
u4f7f
\
u7528
"
:
0
,
"
\
u8ba9
\
u6211
\
u4eec
\
u770b
\
u4e00
\
u4e0b
\
u91cc
\
u9762
\
u7684
\
u5185
\
u5bb9
"
:
0
,
"
\
u8bb2
\
u4e86
\
u8fd9
\
u4e48
\
u591a
"
:
0
,
"
\
u8bbe
\
u5907
"
:
0
,
"
\
u8d8a
\
u5f80
\
u4e0b
\
u5219
\
u8d8a
\
u9760
\
u8fd1
\
u5e95
\
u5c42
"
:
0
,
"
\
u8de8
\
u5e73
\
u53f0
"
:
0
,
"
\
u8f6f
\
u4ef6
\
u5f53
\
u7136
\
u4e5f
\
u9700
\
u8981
\
u77e5
\
u9053
\
u5904
\
u7406
\
u5668
\
u4f1a
\
u5982
\
u4f55
\
u6267
\
u884c
\
u8fd9
\
u4e9b
\
u6307
\
u4ee4
"
:
0
,
"
\
u8fc7
\
u591a
\
u7684
\
u62bd
\
u8c61
\
u548c
\
u8fc7
\
u5c11
\
u7684
\
u62bd
\
u8c61
\
u81ea
\
u7136
\
u90fd
\
u662f
\
u4e0d
\
u5408
\
u9002
\
u7684
"
:
0
,
"
\
u8fd8
\
u662f
\
u57fa
\
u4e8e
\
u67d0
\
u79cd
\
u7f16
\
u7a0b
\
u8bed
\
u8a00
\
u5229
\
u7528
"
:
0
,
"
\
u8fd8
\
u6709
"
:
0
,
"
\
u8fd8
\
u9700
\
u8981
\
u5bf9
\
u7528
\
u6237
\
u6001
\
u5e94
\
u7528
\
u7684
\
u6267
\
u884c
\
u8fdb
\
u884c
\
u76d1
\
u63a7
\
u548c
\
u7ba1
\
u7406
"
:
0
,
"
\
u8fd9
\
u4e2a
\
u8ba9
\
u4eba
\
u633a
\
u4e0d
\
u723d
\
u7684
"
:
4
,
"
\
u8fd9
\
u53ef
\
u4ee5
\
u901a
\
u8fc7
\
u6253
\
u5370
\
u7f16
\
u8bd1
\
u5668
"
:
0
,
"
\
u8fd9
\
u662f
"
:
4
,
"
\
u8fd9
\
u786e
\
u5b9e
\
u662f
\
u5fc5
\
u4e0d
\
u53ef
\
u5c11
\
u7684
"
:
0
,
"
\
u8fd9
\
u79cd
"
:
0
,
"
\
u8fd9
\
u79cd
\
u65b9
\
u5f0f
\
u5177
\
u6709
\
u6700
\
u9ad8
\
u7684
\
u7075
\
u6d3b
\
u6027
"
:
0
,
"
\
u8fd9
\
u79cd
\
u65e0
\
u8bba
\
u7f16
\
u8bd1
\
u5668
\
u8fd8
\
u662f
\
u5176
\
u76ee
\
u6807
\
u6587
\
u4ef6
\
u90fd
\
u5728
\
u6211
\
u4eec
\
u5f53
\
u524d
\
u6240
\
u5904
\
u7684
\
u5e73
\
u53f0
\
u8fd0
\
u884c
\
u662f
\
u4e00
\
u79cd
\
u6700
\
u7b80
\
u5355
\
u4e5f
\
u6700
\
u666e
\
u904d
\
u7684
\
u60c5
\
u51b5
"
:
0
,
"
\
u8fd9
\
u79cd
\
u65e0
\
u8bba
\
u7f16
\
u8bd1
\
u5668
\
u8fd8
\
u662f
\
u76ee
\
u6807
\
u6587
\
u4ef6
\
u90fd
\
u5728
\
u6211
\
u4eec
\
u5f53
\
u524d
\
u6240
\
u5904
\
u7684
\
u5e73
\
u53f0
\
u8fd0
\
u884c
\
u662f
\
u4e00
\
u79cd
\
u6700
\
u7b80
\
u5355
\
u4e5f
\
u6700
\
u666e
\
u904d
\
u7684
\
u60c5
\
u51b5
"
:[],
"
\
u8fd9
\
u91cc
"
:
4
,
"
\
u8fd9
\
u91cc
\
u6211
\
u4eec
\
u4e4b
\
u6240
\
u4ee5
\
u4e0d
\
u9009
\
u62e9
\
u6709
"
:
0
,
"
\
u8fd9
\
u91cc
\
u6211
\
u4eec
\
u9009
\
u62e9
\
u7684
\
u662f
"
:
0
,
"
\
u8fd9
\
u91cc
\
u662f
\
u4e00
\
u884c
\
u6570
\
u5b66
\
u516c
\
u5f0f
"
:
4
,
"
\
u9009
\
u9879
\
u6765
\
u544a
\
u8bc9
"
:
0
,
"
\
u90a3
\
u4e48
\
u6211
\
u4eec
\
u5c31
\
u662f
\
u5728
\
u624b
\
u5199
\
u6c47
\
u7f16
\
u4ee3
\
u7801
"
:
0
,
"
\
u90a3
\
u4e48
\
u9ad8
\
u7ea7
\
u7684
\
u62bd
\
u8c61
"
:
0
,
"
\
u91cc
\
u9762
"
:[],
"
\
u94fe
\
u63a5
\
u5f97
\
u5230
\
u76ee
\
u6807
\
u6587
\
u4ef6
\
u7684
\
u65f6
\
u5019
\
u9700
\
u8981
\
u77e5
\
u9053
\
u7a0b
\
u5e8f
\
u5728
\
u54ea
\
u4e2a
"
:[],
"
\
u94fe
\
u63a5
\
u5f97
\
u5230
\
u76ee
\
u6807
\
u6587
\
u4ef6
\
u7684
\
u65f6
\
u5019
\
u9700
\
u8981
\
u77e5
\
u9053
\
u7a0b
\
u5e8f
\
u8981
\
u5728
\
u54ea
\
u4e2a
"
:
0
,
"
\
u94fe
\
u63a5
\
u5f97
\
u5230
\
u76ee
\
u6807
\
u6587
\
u4ef6
\
u7684
\
u65f6
\
u5019
\
u9700
\
u8981
\
u77e5
\
u9053
\
u7a0b
\
u5e8f
\
u9700
\
u8981
\
u5728
\
u54ea
\
u4e2a
"
:[],
"
\
u94fe
\
u63a5
\
u6700
\
u540e
\
u7684
\
u4e0b
\
u5212
\
u7ebf
\
u548c
\
u7247
\
u6bb5
\
u7684
\
u540e
\
u7eed
\
u5185
\
u5bb9
\
u4e4b
\
u95f4
\
u4e5f
\
u9700
\
u8981
"
:
4
,
"
\
u94fe
\
u63a5
\
u7684
\
u540d
\
u5b57
\
u548c
\
u7528
\
u4e00
\
u5bf9
\
u5c16
\
u62ec
\
u53f7
\
u5305
\
u88f9
\
u8d77
\
u6765
\
u7684
\
u94fe
\
u63a5
\
u5730
\
u5740
\
u4e4b
\
u95f4
\
u5fc5
\
u987b
\
u6709
\
u4e00
\
u4e2a
\
u7a7a
\
u683c
"
:
4
,
"
\
u963f
"
:[],
"
\
u9664
\
u4e86
\
u6700
\
u4e0a
\
u5c42
\
u7684
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u548c
\
u6700
\
u4e0b
\
u5c42
\
u7684
\
u786c
\
u4ef6
\
u5e73
\
u53f0
\
u5fc5
\
u987b
\
u5b58
\
u5728
\
u4e4b
\
u5916
"
:
0
,
"
\
u968f
\
u7740
\
u5e94
\
u7528
\
u573a
\
u666f
\
u7684
\
u590d
\
u6742
\
u5316
"
:
0
,
"
\
u9700
\
u8981
\
u6307
\
u51fa
\
u7684
\
u662f
"
:
0
,
"
\
u9700
\
u8981
\
u66f4
\
u5f3a
\
u7684
\
u62bd
\
u8c61
\
u80fd
\
u529b
"
:
0
,
"
\
u9700
\
u8981
\
u6ce8
\
u610f
\
u5230
\
u6211
\
u4eec
\
u6240
\
u4eab
\
u53d7
\
u5230
\
u7684
\
u7f16
\
u7a0b
\
u7684
\
u65b9
\
u4fbf
\
u5e76
\
u4e0d
\
u662f
\
u7406
\
u6240
\
u5f53
\
u7136
\
u7684
"
:
0
,
"
\
u9879
\
u76ee
"
:
0
,
"
\
u9879
\
u76ee
\
u7684
\
u6587
\
u4ef6
\
u7ed3
\
u6784
\
u5982
\
u4e0b
"
:
0
,
"
\
u9ed1
\
u8272
\
u5757
\
u5219
\
u8868
\
u793a
\
u76f8
\
u90bb
\
u4e24
\
u5c42
\
u8fd0
\
u884c
\
u73af
\
u5883
\
u4e4b
\
u95f4
"
:
0
,
"
abstract
"
:
0
,
"
new
"
:
0
,
add
:
4
,
alpha
:
4
,
architectur
:
0
,
beta
:
4
,
bin
:
0
,
binari
:
0
,
call
:
0
,
caption
:[],
cargo
:
0
,
central
:
0
,
commit
:
0
,
compil
:
0
,
cos
:
4
,
cpu
:
0
,
date
:
0
,
debug
:
0
,
debuginfo
:
0
,
dev
:
0
,
directori
:
0
,
elf
:
0
,
environ
:
0
,
execut
:
0
,
file
:
0
,
finish
:
0
,
gif
:
4
,
gnu
:
0
,
grep
:
0
,
hash
:
0
,
hello
:
0
,
home
:
0
,
host
:
0
,
i32
:
4
,
instruct
:
0
,
isa
:
0
,
linux
:
0
,
list
:
0
,
llvm
:
0
,
maco
:
0
,
main
:
0
,
memori
:
0
,
nightli
:
0
,
none
:
0
,
platform
:
0
,
print
:
0
,
println
:
0
,
process
:
0
,
processor
:
0
,
rcore
:[
0
,
3
],
readthedoc
:
4
,
releas
:
0
,
risc
:
0
,
riscv32i
:
0
,
riscv32imac
:
0
,
riscv32imc
:
0
,
riscv64gc
:
0
,
riscv64imac
:
0
,
riscv
:
0
,
run
:
0
,
rust
:[
0
,
4
],
rustc
:
0
,
set
:
0
,
shinbokuow
:
0
,
sin
:
4
,
sphinx
:
4
,
src
:
0
,
std
:
0
,
strace
:
0
,
system
:
0
,
target
:
0
,
toml
:
0
,
tree
:
0
,
tripl
:
0
,
tutori
:[
0
,
3
],
ubuntu
:
0
,
unit
:
0
,
unknown
:
0
,
unoptim
:
0
,
verbos
:
0
,
version
:
0
,
window
:
0
,
workspac
:
0
,
world
:
0
,
write
:
0
,
x86
:
0
,
x86_64
:
0
},
titles
:[
"
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u8fd0
\
u884c
\
u73af
\
u5883
\
u4e0e
\
u5e73
\
u53f0
\
u652f
\
u6301
"
,
"
\
u7b2c
\
u4e00
\
u7ae0
\
uff1a
\
u7f16
\
u8bd1
\
u8fd0
\
u884c RV64
\
u88f8
\
u673a
\
u7a0b
\
u5e8f
"
,
"
rCore-Tutorial-Book
\
u7b2c
\
u4e09
\
u7248
"
,
"
\
u5feb
\
u901f
\
u4e0a
\
u624b
"
,
"
reStructuredText
\
u57fa
\
u672c
\
u8bed
\
u6cd5
"
],
titleterms
:{
"
\
u57fa
\
u672c
\
u8bed
\
u6cd5
"
:
4
,
"
\
u5e73
\
u53f0
\
u4e0e
\
u76ee
\
u6807
\
u4e09
\
u5143
\
u7ec4
"
:
0
,
"
\
u5e73
\
u53f0
\
u652f
\
u6301
\
u4e0e
\
u76ee
\
u6807
\
u4e09
\
u5143
\
u7ec4
"
:[],
"
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u8fd0
\
u884c
\
u73af
\
u5883
"
:
0
,
"
\
u5e94
\
u7528
\
u7a0b
\
u5e8f
\
u8fd0
\
u884c
\
u73af
\
u5883
\
u4e0e
\
u5e73
\
u53f0
\
u652f
\
u6301
"
:
0
,
"
\
u5feb
\
u901f
\
u4e0a
\
u624b
"
:
3
,
"
\
u76ee
\
u6807
\
u4e09
\
u5143
\
u7ec4
"
:[],
"
\
u79fb
\
u9664
\
u6807
\
u51c6
\
u5e93
\
u4f9d
\
u8d56
"
:[],
"
\
u7b2c
\
u4e00
\
u7ae0
"
:
1
,
"
\
u7b2c
\
u4e09
\
u7248
"
:
2
,
"
\
u7f16
\
u8bd1
\
u8fd0
\
u884c
"
:
1
,
"
\
u88f8
\
u673a
\
u7a0b
\
u5e8f
"
:
1
,
book
:
2
,
rcore
:
2
,
restructuredtext
:
4
,
rv64
:
1
,
tutori
:
2
}})
\ No newline at end of file
source/chapter1/1app-ee-platform.rst
0 → 100644
浏览文件 @
96a76265
应用程序运行环境与平台支持
================================================
.. toctree::
:hidden:
:maxdepth: 3
作为一切的开始,让我们使用 Cargo 工具来创建一个 Rust 项目。它看上去没有任何特别之处:
.. code-block:: console
$ cargo new os --bin
我们加上了 ``--bin`` 选项来告诉 Cargo 我们创建一个可执行项目而不是库项目。此时,项目的文件结构如下:
.. code-block:: console
$ tree os
os
├── Cargo.toml
└── src
└── main.rs
1 directory, 2 files
其中 ``Cargo.toml`` 中保存着项目的配置,包括作者的信息、联系方式以及库依赖等等。显而易见源代码保存在 ``src`` 目录下,目前为止只有 ``main.rs``
一个文件,让我们看一下里面的内容:
.. code-block:: rust
:linenos:
:caption: 最简单的 Rust 应用
fn main() {
println!("Hello, world!");
}
利用 Cargo 工具即可一条命令实现构建并运行项目:
.. code-block:: console
$ cargo run
Compiling os v0.1.0 (/home/shinbokuow/workspace/v3/rCore-Tutorial-v3/os)
Finished dev [unoptimized + debuginfo] target(s) in 1.15s
Running `target/debug/os`
Hello, world!
如我们预想的一样,我们在屏幕上看到了一行 ``Hello, world!`` 。但是,需要注意到我们所享受到的编程的方便并不是理所当然的,背后有着从硬件
到软件的多种机制的支持。
应用程序运行环境
-------------------------------
如下图所示,应用程序的运行需要下面一套运行环境栈的支持:
.. _app-software-stack:
.. figure:: app-software-stack.png
应用程序运行环境栈
图中的白色块自上而下(越往下则越靠近底层,下层作为上层的执行环境支持上层代码的运行)表示各级运行环境,黑色块则表示相邻两层运行环境之间
的接口。
我们的应用位于最上层,它可以通过调用编程语言提供的标准库或者其他三方库对外提供的功能强大的函数接口,使得仅需少量的源代码就能完成复杂的
功能。但是这些库的功能不仅限于此,事实上它们属于应用程序的 **执行环境** (Execution Environment),在我们通常不会注意到的地方,它
们还会在执行应用之前完成一些初始化工作,并在应用程序执行的时候对它进行监控。我们在打印 ``Hello, world!`` 时使用的 ``println!``
宏正是由 Rust 标准库 std 提供的。
从内核/操作系统的角度看来,它上面的一切都属于用户态,而它自身属于内核态。无论用户态应用如何编写,是手写汇编代码,还是基于某种编程语言利用
其标准库或三方库,某些功能总要直接或间接的通过内核/操作系统提供的 **系统调用** (System Call) 来实现。因此系统调用充当了用户和内核之间
的边界。内核作为用户态的运行环境,它不仅要提供系统调用接口,还需要对用户态应用的执行进行监控和管理。
.. note::
``Hello, world!`` 用到了哪些系统调用?
从之前的 ``cargo run`` 的输出可以看出之前构建的可执行文件是在 target/debug 目录下的 os 。
在 Ubuntu 系统上,可以通过 ``strace`` 工具来运行一个程序并输出程序运行过程当中向内核请求的所有的系统调用及其返回值。
我们只需输入 ``strace target/debug/os`` 即可看到一长串的系统调用。
其中,真正容易看出与 ``Hello, world!`` 相关的只有一个系统调用:
.. code-block::
write(1, "Hello, world!\n", 14) = 14
其参数的具体含义我们暂且不在这里进行解释。
其余的系统调用基本上分别用于函数库和内核两层执行环境的初始化工作和对于上层的运行期监控和管理。之后,随着应用场景的复杂化,我们
需要更强的抽象能力,也会实现这里面的一些系统调用。
从硬件的角度来看,它上面的一切都属于软件。硬件可以分为三种: 处理器 (Processor) ——它更常见的名字是中央处理单元 (CPU, Central Processing Unit),
内存 (Memory) 还有 I/O 设备。其中处理器无疑是其中最复杂同时也最关键的一个。它与软件约定一套 **指令集体系结构** (ISA, Instruction Set Architecture),
使得软件可以通过 ISA 中提供的汇编指令来访问各种硬件资源。软件当然也需要知道处理器会如何执行这些指令:最简单的话就是一条一条执行位于内存
中的指令。当然,实际的情况远比这个要复杂得多,为了适应现代应用程序的场景,处理器还需要提供很多额外的机制,而不仅仅是让数据在 CPU 寄存器、内存和 I/O 设备
三者之间流动。
.. note::
多层执行环境都是必需的吗?
除了最上层的应用程序和最下层的硬件平台必须存在之外,作为中间层的函数库和内核并不是必须存在的:它们都是对下层资源进行了 **抽象** (Abstraction),
并为上层提供了一套运行环境。抽象的优点在于它让上层以较小的代价获得所需的功能,并同时可以提供一些保护。但抽象同时也是一种限制,会丧失一些
应有的灵活性。比如,当你在考虑在项目中应该使用哪个函数库的时候,就常常需要这方面的权衡:过多的抽象和过少的抽象自然都是不合适的。
实际上,我们通过应用程序的特征来判断它需要什么程度的抽象。
- 如果函数库和内核都不存在,那么我们就是在手写汇编代码,这种方式具有最高的灵活性,抽象能力则最低,基本等同于硬件。我们通常用这种方式来
实现一些架构相关且仅通过编程语言无法描述的小模块或者代码片段。
- 如果仅存在函数库而不存在内核,意味着我们不需要内核提供的抽象。在嵌入式场景就常常会出现这种情况。嵌入式设备虽然也包含 CPU、内存和 I/O
设备,但是它上面通常只会同时运行一个或几个功能非常简单的小应用程序,其定位就是那种功能单一的场景,比如人脸识别打卡系统等。我们常用的
操作系统如 Windows/Linux/macOS 等的抽象都支持同时运行很多应用程序,在嵌入式场景是过抽象的。因此,常见的解决方案是仅使用函数库构建
单独的应用程序或是用专为应用场景特别裁减过的轻量级内核管理少数应用程序。
平台与目标三元组
---------------------------------------
对于一份用某种编程语言实现的源代码而言,编译器在将其通过编译、链接得到目标文件的时候需要知道程序要在哪个 **平台** (Platform) 上运行。
从上面给出的 :ref:`应用程序运行环境栈 <app-software-stack>` 可以看出:
- 如果用户态基于的内核不同,会导致系统调用接口不同或者语义不一致;
- 如果底层硬件不同,对于硬件资源的访问方式会有差异。特别是 ISA 不同的话,对上提供的指令集和寄存器都不同。
它们都会导致最终生成的目标文件有很大不同。需要指出的是,某些编译器支持同一份源代码无需修改就可编译到多个不同的目标平台并在上面运行。这种
情况下,源代码是 **跨平台** 的。而另一些编译器则已经预设好了一个固定的目标平台。
我们可以通过 **目标三元组** (Target Triple) 来描述一个目标平台。它一般包括 CPU 架构、CPU 厂商和操作系统,它们确实都会控制目标文件的生成。
比如,我们可以尝试看一下之前的 ``Hello, world!`` 的目标平台是什么。这可以通过打印编译器 rustc 的默认配置信息:
.. code-block:: console
$ rustc --version --verbose
rustc 1.48.0-nightly (73dc675b9 2020-09-06)
binary: rustc
commit-hash: 73dc675b9437c2a51a975a9f58cc66f05463c351
commit-date: 2020-09-06
host: x86_64-unknown-linux-gnu
release: 1.48.0-nightly
LLVM version: 11.0
从其中的 host 一项可以看出默认的目标平台是 ``x86_64-unknown-linux-gnu``,其中 CPU 架构是 x86_64,CPU 厂商是 unknown,操作系统是 linux-gnu。
这种无论编译器还是其目标文件都在我们当前所处的平台运行是一种最简单也最普遍的情况。但是很快我们就将遇到另外一种情况。
讲了这么多,终于该介绍我们的主线任务了。我们希望能够在另一个平台上运行 ``Hello, world!``,而与之前的默认平台不同的地方在于,我们将 CPU 架构从
x86_64 换成 RISC-V。
.. note::
为何基于 RISC-V 架构而非 x86 系列架构?
x86 架构为了在升级换代的同时保持对基于旧版架构应用程序/内核的兼容性,存在大量的历史包袱,也就是一些对于目前的应用场景没有任何意义,但又必须
花大量时间正确设置才能正常使用 CPU 的奇怪设定。为了建立并维护架构的应用生态,这确实是必不可少的,但站在教学的角度几乎完全是在浪费时间。而
新生的 RISC-V 架构十分简洁,架构文档需要阅读的核心部分不足百页,且这些功能已经足以用来构造一个具有相当抽象能力的内核了。
可以看一下目前 Rust 编译器支持哪些基于 RISC-V 的平台:
.. code-block:: console
$ rustc --print target-list | grep riscv
riscv32i-unknown-none-elf
riscv32imac-unknown-none-elf
riscv32imc-unknown-none-elf
riscv64gc-unknown-linux-gnu
riscv64gc-unknown-none-elf
riscv64imac-unknown-none-elf
这里我们选择的是 ``riscv64gc-unknown-none-elf``,目标三元组中的操作系统是 none-elf,表明没有任何系统调用支持。这里我们之所以不选择有
linux-gnu 系统调用支持的版本 ``riscv64gc-unknown-linux-gnu``,是因为我们只是想跑一个 ``Hello, world!``,没有必要使用操作系统所提供的
那么高级的抽象。而且我们很清楚后续我们要开发的是一个内核,如果仅仅基于已有操作系统提供的系统调用的话,它自身的抽象能力会受到很大限制。所以它必须
直面底层硬件来解锁更大的抽象能力上限。
.. note::
RISC-V 指令集拓展
source/chapter1/index.rst
浏览文件 @
96a76265
...
...
@@ -6,4 +6,4 @@
:hidden:
:maxdepth: 3
1remove-std
\ No newline at end of file
1app-ee-platform
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录