summaryrefslogtreecommitdiff
path: root/Documentation/translations/zh_CN/core-api/kernel-api.rst
blob: ab7d818893404c5d8719f0868136fe5a18005dfc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
.. include:: ../disclaimer-zh_CN.rst

:Original: Documentation/core-api/kernel-api.rst

:翻译:

 司延腾 Yanteng Si <siyanteng@loongson.cn>

.. _cn_kernel-api.rst:

============
Linux内核API
============


列表管理函数
============

该API在以下内核代码中:

include/linux/list.h

基本的C库函数
=============

在编写驱动程序时,一般不能使用C库中的例程。部分函数通常很有用,它们在
下面被列出。这些函数的行为可能会与ANSI定义的略有不同,这些偏差会在文中
注明。

字符串转换
----------

该API在以下内核代码中:

lib/vsprintf.c

include/linux/kernel.h

include/linux/kernel.h

lib/kstrtox.c

lib/string_helpers.c

字符串处理
----------

该API在以下内核代码中:

lib/string.c

include/linux/string.h

mm/util.c

基本的内核库函数
================

Linux内核提供了很多实用的基本函数。

位运算
------

该API在以下内核代码中:

include/asm-generic/bitops/instrumented-atomic.h

include/asm-generic/bitops/instrumented-non-atomic.h

include/asm-generic/bitops/instrumented-lock.h

位图运算
--------

该API在以下内核代码中:

lib/bitmap.c

include/linux/bitmap.h

include/linux/bitmap.h

include/linux/bitmap.h

lib/bitmap.c

lib/bitmap.c

include/linux/bitmap.h

命令行解析
----------

该API在以下内核代码中:

lib/cmdline.c

排序
----

该API在以下内核代码中:

lib/sort.c

lib/list_sort.c

文本检索
--------

该API在以下内核代码中:

lib/textsearch.c

lib/textsearch.c

include/linux/textsearch.h

Linux中的CRC和数学函数
======================


CRC函数
-------

*译注:CRC,Cyclic Redundancy Check,循环冗余校验*

该API在以下内核代码中:

lib/crc4.c

lib/crc7.c

lib/crc8.c

lib/crc16.c

lib/crc32.c

lib/crc-ccitt.c

lib/crc-itu-t.c

基数为2的对数和幂函数
---------------------

该API在以下内核代码中:

include/linux/log2.h

整数幂函数
----------

该API在以下内核代码中:

lib/math/int_pow.c

lib/math/int_sqrt.c

除法函数
--------

该API在以下内核代码中:

include/asm-generic/div64.h

include/linux/math64.h

lib/math/div64.c

lib/math/gcd.c

UUID/GUID
---------

该API在以下内核代码中:

lib/uuid.c

内核IPC设备
===========

IPC实用程序
-----------

该API在以下内核代码中:

ipc/util.c

FIFO 缓冲区
===========

kfifo接口
---------

该API在以下内核代码中:

include/linux/kfifo.h

转发接口支持
============

转发接口支持旨在为工具和设备提供一种有效的机制,将大量数据从内核空间
转发到用户空间。

转发接口
--------

该API在以下内核代码中:

kernel/relay.c

kernel/relay.c

模块支持
========

模块加载
--------

该API在以下内核代码中:

kernel/kmod.c

模块接口支持
------------

更多信息请参考文件kernel/module.c。

硬件接口
========


该API在以下内核代码中:

kernel/dma.c

资源管理
--------

该API在以下内核代码中:

kernel/resource.c

kernel/resource.c

MTRR处理
--------

该API在以下内核代码中:

arch/x86/kernel/cpu/mtrr/mtrr.c

安全框架
========

该API在以下内核代码中:

security/security.c

security/inode.c

审计接口
========

该API在以下内核代码中:

kernel/audit.c

kernel/auditsc.c

kernel/auditfilter.c

核算框架
========

该API在以下内核代码中:

kernel/acct.c

块设备
======

该API在以下内核代码中:

block/blk-core.c

block/blk-core.c

block/blk-map.c

block/blk-sysfs.c

block/blk-settings.c

block/blk-exec.c

block/blk-flush.c

block/blk-lib.c

block/blk-integrity.c

kernel/trace/blktrace.c

block/genhd.c

block/genhd.c

字符设备
========

该API在以下内核代码中:

fs/char_dev.c

时钟框架
========

时钟框架定义了编程接口,以支持系统时钟树的软件管理。该框架广泛用于系统级芯片(SOC)平
台,以支持电源管理和各种可能需要自定义时钟速率的设备。请注意,这些 “时钟”与计时或实
时时钟(RTC)无关,它们都有单独的框架。这些:c:type: `struct clk <clk>` 实例可用于管理
各种时钟信号,例如一个96理例如96MHz的时钟信号,该信号可被用于总线或外设的数据交换,或以
其他方式触发系统硬件中的同步状态机转换。

通过明确的软件时钟门控来支持电源管理:未使用的时钟被禁用,因此系统不会因为改变不在使用
中的晶体管的状态而浪费电源。在某些系统中,这可能是由硬件时钟门控支持的,其中时钟被门控
而不在软件中被禁用。芯片的部分,在供电但没有时钟的情况下,可能会保留其最后的状态。这种
低功耗状态通常被称为*保留模式*。这种模式仍然会产生漏电流,特别是在电路几何结构较细的情
况下,但对于CMOS电路来说,电能主要是随着时钟翻转而被消耗的。

电源感知驱动程序只有在其管理的设备处于活动使用状态时才会启用时钟。此外,系统睡眠状态通
常根据哪些时钟域处于活动状态而有所不同:“待机”状态可能允许从多个活动域中唤醒,而
"mem"(暂停到RAM)状态可能需要更全面地关闭来自高速PLL和振荡器的时钟,从而限制了可能
的唤醒事件源的数量。驱动器的暂停方法可能需要注意目标睡眠状态的系统特定时钟约束。

一些平台支持可编程时钟发生器。这些可以被各种外部芯片使用,如其他CPU、多媒体编解码器以
及对接口时钟有严格要求的设备。

该API在以下内核代码中:

include/linux/clk.h

同步原语
========

读-复制-更新(RCU)
-------------------

该API在以下内核代码中:

include/linux/rcupdate.h

kernel/rcu/tree.c

kernel/rcu/tree_exp.h

kernel/rcu/update.c

include/linux/srcu.h

kernel/rcu/srcutree.c

include/linux/rculist_bl.h

include/linux/rculist.h

include/linux/rculist_nulls.h

include/linux/rcu_sync.h

kernel/rcu/sync.c