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