Documentation/translations/zh_CN/core-api/kernel-api.rst

   1 .. include:: ../disclaimer-zh_CN.rst
   2
   3 :Original: Documentation/core-api/kernel-api.rst
   4
   5 :翻译:
   6
   7  司延腾 Yanteng Si <siyanteng@loongson.cn>
   8
   9 .. _cn_kernel-api.rst:
  10
  11 ============
  12 Linux内核API
  13 ============
  14
  15
  16 列表管理函数
  17 ============
  18
  19 该API在以下内核代码中:
  20
  21 include/linux/list.h
  22
  23 基本的C库函数
  24 =============
  25
  26 在编写驱动程序时，一般不能使用C库中的例程。部分函数通常很有用，它们在
  27 下面被列出。这些函数的行为可能会与ANSI定义的略有不同，这些偏差会在文中
  28 注明。
  29
  30 字符串转换
  31 ----------
  32
  33 该API在以下内核代码中:
  34
  35 lib/vsprintf.c
  36
  37 include/linux/kernel.h
  38
  39 include/linux/kernel.h
  40
  41 lib/kstrtox.c
  42
  43 lib/string_helpers.c
  44
  45 字符串处理
  46 ----------
  47
  48 该API在以下内核代码中:
  49
  50 lib/string.c
  51
  52 include/linux/string.h
  53
  54 mm/util.c
  55
  56 基本的内核库函数
  57 ================
  58
  59 Linux内核提供了很多实用的基本函数。
  60
  61 位运算
  62 ------
  63
  64 该API在以下内核代码中:
  65
  66 include/asm-generic/bitops/instrumented-atomic.h
  67
  68 include/asm-generic/bitops/instrumented-non-atomic.h
  69
  70 include/asm-generic/bitops/instrumented-lock.h
  71
  72 位图运算
  73 --------
  74
  75 该API在以下内核代码中:
  76
  77 lib/bitmap.c
  78
  79 include/linux/bitmap.h
  80
  81 include/linux/bitmap.h
  82
  83 include/linux/bitmap.h
  84
  85 lib/bitmap.c
  86
  87 lib/bitmap.c
  88
  89 include/linux/bitmap.h
  90
  91 命令行解析
  92 ----------
  93
  94 该API在以下内核代码中:
  95
  96 lib/cmdline.c
  97
  98 排序
  99 ----
 100
 101 该API在以下内核代码中:
 102
 103 lib/sort.c
 104
 105 lib/list_sort.c
 106
 107 文本检索
 108 --------
 109
 110 该API在以下内核代码中:
 111
 112 lib/textsearch.c
 113
 114 lib/textsearch.c
 115
 116 include/linux/textsearch.h
 117
 118 Linux中的CRC和数学函数
 119 ======================
 120
 121
 122 CRC函数
 123 -------
 124
 125 *译注：CRC，Cyclic Redundancy Check，循环冗余校验*
 126
 127 该API在以下内核代码中:
 128
 129 lib/crc4.c
 130
 131 lib/crc7.c
 132
 133 lib/crc8.c
 134
 135 lib/crc16.c
 136
 137 lib/crc32.c
 138
 139 lib/crc-ccitt.c
 140
 141 lib/crc-itu-t.c
 142
 143 基数为2的对数和幂函数
 144 ---------------------
 145
 146 该API在以下内核代码中:
 147
 148 include/linux/log2.h
 149
 150 整数幂函数
 151 ----------
 152
 153 该API在以下内核代码中:
 154
 155 lib/math/int_pow.c
 156
 157 lib/math/int_sqrt.c
 158
 159 除法函数
 160 --------
 161
 162 该API在以下内核代码中:
 163
 164 include/asm-generic/div64.h
 165
 166 include/linux/math64.h
 167
 168 lib/math/div64.c
 169
 170 lib/math/gcd.c
 171
 172 UUID/GUID
 173 ---------
 174
 175 该API在以下内核代码中:
 176
 177 lib/uuid.c
 178
 179 内核IPC设备
 180 ===========
 181
 182 IPC实用程序
 183 -----------
 184
 185 该API在以下内核代码中:
 186
 187 ipc/util.c
 188
 189 FIFO 缓冲区
 190 ===========
 191
 192 kfifo接口
 193 ---------
 194
 195 该API在以下内核代码中:
 196
 197 include/linux/kfifo.h
 198
 199 转发接口支持
 200 ============
 201
 202 转发接口支持旨在为工具和设备提供一种有效的机制，将大量数据从内核空间
 203 转发到用户空间。
 204
 205 转发接口
 206 --------
 207
 208 该API在以下内核代码中:
 209
 210 kernel/relay.c
 211
 212 kernel/relay.c
 213
 214 模块支持
 215 ========
 216
 217 模块加载
 218 --------
 219
 220 该API在以下内核代码中:
 221
 222 kernel/kmod.c
 223
 224 模块接口支持
 225 ------------
 226
 227 更多信息请参考文件kernel/module.c。
 228
 229 硬件接口
 230 ========
 231
 232
 233 该API在以下内核代码中:
 234
 235 kernel/dma.c
 236
 237 资源管理
 238 --------
 239
 240 该API在以下内核代码中:
 241
 242 kernel/resource.c
 243
 244 kernel/resource.c
 245
 246 MTRR处理
 247 --------
 248
 249 该API在以下内核代码中:
 250
 251 arch/x86/kernel/cpu/mtrr/mtrr.c
 252
 253 安全框架
 254 ========
 255
 256 该API在以下内核代码中:
 257
 258 security/security.c
 259
 260 security/inode.c
 261
 262 审计接口
 263 ========
 264
 265 该API在以下内核代码中:
 266
 267 kernel/audit.c
 268
 269 kernel/auditsc.c
 270
 271 kernel/auditfilter.c
 272
 273 核算框架
 274 ========
 275
 276 该API在以下内核代码中:
 277
 278 kernel/acct.c
 279
 280 块设备
 281 ======
 282
 283 该API在以下内核代码中:
 284
 285 block/blk-core.c
 286
 287 block/blk-core.c
 288
 289 block/blk-map.c
 290
 291 block/blk-sysfs.c
 292
 293 block/blk-settings.c
 294
 295 block/blk-exec.c
 296
 297 block/blk-flush.c
 298
 299 block/blk-lib.c
 300
 301 block/blk-integrity.c
 302
 303 kernel/trace/blktrace.c
 304
 305 block/genhd.c
 306
 307 block/genhd.c
 308
 309 字符设备
 310 ========
 311
 312 该API在以下内核代码中:
 313
 314 fs/char_dev.c
 315
 316 时钟框架
 317 ========
 318
 319 时钟框架定义了编程接口，以支持系统时钟树的软件管理。该框架广泛用于系统级芯片（SOC）平
 320 台，以支持电源管理和各种可能需要自定义时钟速率的设备。请注意，这些 “时钟”与计时或实
 321 时时钟(RTC)无关，它们都有单独的框架。这些:c:type: `struct clk <clk>` 实例可用于管理
 322 各种时钟信号，例如一个96理例如96MHz的时钟信号，该信号可被用于总线或外设的数据交换，或以
 323 其他方式触发系统硬件中的同步状态机转换。
 324
 325 通过明确的软件时钟门控来支持电源管理：未使用的时钟被禁用，因此系统不会因为改变不在使用
 326 中的晶体管的状态而浪费电源。在某些系统中，这可能是由硬件时钟门控支持的，其中时钟被门控
 327 而不在软件中被禁用。芯片的部分，在供电但没有时钟的情况下，可能会保留其最后的状态。这种
 328 低功耗状态通常被称为*保留模式*。这种模式仍然会产生漏电流，特别是在电路几何结构较细的情
 329 况下，但对于CMOS电路来说，电能主要是随着时钟翻转而被消耗的。
 330
 331 电源感知驱动程序只有在其管理的设备处于活动使用状态时才会启用时钟。此外，系统睡眠状态通
 332 常根据哪些时钟域处于活动状态而有所不同：“待机”状态可能允许从多个活动域中唤醒，而
 333 "mem"（暂停到RAM）状态可能需要更全面地关闭来自高速PLL和振荡器的时钟，从而限制了可能
 334 的唤醒事件源的数量。驱动器的暂停方法可能需要注意目标睡眠状态的系统特定时钟约束。
 335
 336 一些平台支持可编程时钟发生器。这些可以被各种外部芯片使用，如其他CPU、多媒体编解码器以
 337 及对接口时钟有严格要求的设备。
 338
 339 该API在以下内核代码中:
 340
 341 include/linux/clk.h
 342
 343 同步原语
 344 ========
 345
 346 读-复制-更新（RCU）
 347 -------------------
 348
 349 该API在以下内核代码中:
 350
 351 include/linux/rcupdate.h
 352
 353 kernel/rcu/tree.c
 354
 355 kernel/rcu/tree_exp.h
 356
 357 kernel/rcu/update.c
 358
 359 include/linux/srcu.h
 360
 361 kernel/rcu/srcutree.c
 362
 363 include/linux/rculist_bl.h
 364
 365 include/linux/rculist.h
 366
 367 include/linux/rculist_nulls.h
 368
 369 include/linux/rcu_sync.h
 370
 371 kernel/rcu/sync.c