AIX 5L v5.2 Technical Reference: Kernel and Subsystems

This book provides information about kernel services, device driver operations, file system operations, subroutines, the configuration subsystem, the communications subsystem, the low function terminal (LFT) subsystem, the logical volume subsystem, the M-audio capture and playback adapter subsystem, the printer subsystem, the SCSI subsystem, and the serial DASD subsystem.This book is part of the six-volume technical reference set, AIX 5L Version 5.2 Technical Reference, that provides information on system calls, kernel extension calls, and subroutines in the following volumes:* AIX 5L Version 5.2 Technical Reference: Base Operating System and Extensions Volume 1 and AIX 5L Version 5.2 Technical Reference: Base Operating System and Extensions Volume 2 provide information on system calls, subroutines, functions, macros, and statements associated with base operating system runtime services.* AIX 5L Version 5.2 Technical Reference: Communications Volume 1 and AIX 5L Version 5.2 Technical Reference: Communications Volume 2 provide information on entry points, functions, system calls, subroutines, and operations related to communications services.* AIX 5L Version 5.2 Technical Reference: Kernel and Subsystems Volume 1 and AIX 5L Version 5.2 Technical Reference: Kernel and Subsystems Volume 2 provide information about kernel services, device driver operations, file system operations, subroutines, the configuration subsystem, the communications subsystem, the low function terminal (LFT) subsystem, the logical volume subsystem, the M-audio capture and playback adapter subsystem, the printer subsystem, the SCSI subsystem, and the serial DASD subsystem.

---

Table of contents :
Contents……Page 5
Case-Sensitivity in AIX……Page 11
Related Publications……Page 12
Related Information……Page 13
Description……Page 14
Related Information……Page 15
Related Information……Page 16
Description……Page 17
Description……Page 18
Parameters……Page 19
Related Information……Page 20
Return Values……Page 21
Description……Page 22
Description……Page 23
Description……Page 24
Return Values……Page 25
Flags……Page 26
Flags……Page 27
Guidelines for Writing a Change Method……Page 28
Description……Page 29
Flags……Page 30
Syntax……Page 33
Guidelines for Writing a Define Method……Page 34
Description……Page 36
Guidelines for Writing an Unconfigure Method……Page 37
Related Information……Page 38
Guidelines for Writing an Undefine Method……Page 39
Device Methods for Adapter Cards: Guidelines……Page 40
/dev/nvram Special File Support……Page 41
Bus Special File Support……Page 46
Files……Page 47
How Device Methods Return Errors……Page 48
Description……Page 49
Descriptors……Page 50
Description……Page 51
Related Information……Page 52
Descriptors……Page 53
Description……Page 54
Descriptors……Page 55
Related Information……Page 57
Description……Page 58
Predefined Attribute Object Class Descriptors……Page 59
Description……Page 63
Predefined Attribute Extended Object Class Descriptors……Page 64
Description……Page 66
Descriptors……Page 69
Description……Page 70
Descriptors……Page 71
Files……Page 74
Related Information……Page 75
Purpose……Page 77
Parameters……Page 78
Parameters……Page 79
Parameters……Page 80
Related Information……Page 81
Description……Page 82
Description……Page 83
Return Values……Page 84
Description……Page 85
Related Information……Page 87
Related Information……Page 88
Execution Environment……Page 89
Parameters……Page 90
Related Information……Page 91
Description……Page 92
Purpose……Page 93
Related Information……Page 94
Return Values……Page 95
Description……Page 96
Purpose……Page 97
Description……Page 98
Execution Environment……Page 99
Related Information……Page 100
Status Blocks for the Ethernet Device Handler……Page 101
Description……Page 102
Description……Page 103
Description……Page 104
Related Information……Page 105
Related Information……Page 106
Related Information……Page 107
Return Values……Page 108
Execution Environment……Page 109
Description……Page 110
Purpose……Page 111
Return Values……Page 112
Description……Page 113
Parameters……Page 114
Related Information……Page 115
Related Information……Page 116
Execution Environment……Page 117
Status Blocks for the Multiprotocol Device Handler……Page 118
Related Information……Page 121
Description……Page 122
Description……Page 123
Related Information……Page 124
Description……Page 125
t_start_dev Fields……Page 126
Flag Fields for Autodial Protocols……Page 128
t_x21_data Fields……Page 130
Related Information……Page 131
Purpose……Page 132
Return Values……Page 133
Return Values……Page 134
Parameters……Page 135
Related Information……Page 136
Description……Page 137
Return Values……Page 138
Description……Page 139
Parameters……Page 140
Description……Page 141
Purpose……Page 142
Return Values……Page 143
Related Information……Page 144
Parameters……Page 145
Status Blocks for the Multiprotocol Device Handler……Page 146
Description……Page 149
Purpose……Page 150
Return Values……Page 151
Description……Page 152
t_start_dev Fields……Page 153
Flag Fields for Protocols……Page 154
Related Information……Page 155
Description……Page 156
Syntax……Page 157
Parameters……Page 158
Description……Page 159
Execution Environment……Page 160
Description……Page 161
Syntax……Page 162
Parameters……Page 163
Sense Data for the Serial Optical Link Device Driver……Page 164
Status 2 Register……Page 165
Description……Page 166
Description……Page 167
Syntax……Page 168
Return Values……Page 169
Description……Page 170
Description……Page 171
Status Blocks for the Serial Optical Link Device Driver……Page 172
Description……Page 176
Description……Page 177
Description……Page 178
Description……Page 179
Related Information……Page 180
Purpose……Page 181
Execution Environment……Page 182
Parameters……Page 183
Syntax……Page 184
Return Values……Page 185
Parameters……Page 186
Parameters……Page 187
Execution Environment……Page 188
Execution Environment……Page 189
Description……Page 190
Syntax……Page 191
Parameters……Page 192
Parameters……Page 193
Syntax……Page 194
Description……Page 195
Status Blocks for the Token-Ring Device Handler……Page 196
Related Information……Page 200
Related Information……Page 201
Related Information……Page 202
Return Values……Page 203
Execution Environment……Page 204
Execution Environment……Page 205
Description……Page 206
Execution Environment……Page 207
Related Information……Page 208
Description……Page 209
Description……Page 210
Parameters……Page 211
Purpose……Page 212
Execution Environment……Page 213
Description……Page 214
Related Information……Page 215
lft_dds_t Structure……Page 217
phys_displays Structure……Page 219
vtmstruct Structure……Page 223
Description……Page 224
Parameters……Page 225
Input Device Driver ioctl Operations……Page 226
Syntax……Page 227
Syntax……Page 228
Syntax……Page 229
Parameter……Page 230
Description……Page 231
Syntax……Page 232
Related Information……Page 233
Description……Page 234
Purpose……Page 235
Description……Page 236
Parameters……Page 237
Parameters……Page 238
Syntax……Page 239
Parameters……Page 240
Purpose……Page 241
Related Information……Page 242
Purpose……Page 243
Purpose……Page 244
Description……Page 245
Parameters……Page 246
Return Values……Page 247
Parameters……Page 248
Return Values……Page 249
Parameters……Page 251
Parameters……Page 252
Parameters……Page 253
Syntax……Page 254
Purpose……Page 255
Syntax……Page 256
Syntax……Page 257
Description……Page 258
Description……Page 259
Parameters……Page 260
Syntax……Page 261
Syntax……Page 262
Description……Page 263
Description……Page 264
Related Information……Page 265
Device-Dependent Subroutines……Page 267
Error Conditions……Page 275
Reliability and Serviceability Information……Page 276
Special Files……Page 281
Device-Dependent Subroutines……Page 282
Device Requirements……Page 290
Error Conditions……Page 291
Reliability and Serviceability Information……Page 292
Special Files……Page 297
Device-Dependent Subroutines……Page 298
Syntax……Page 304
Error Conditions……Page 305
Related Information……Page 306
Device-Dependent Subroutines……Page 307
Reliability and Serviceability Information……Page 309
Related Information……Page 314
Return Values……Page 315
Description……Page 316
Files……Page 317
Return Values……Page 318
Description……Page 319
Description……Page 320
Return Values……Page 321
Return Values……Page 322
Description……Page 323
Purpose……Page 324
Return Values……Page 325
Return Values……Page 326
Description……Page 327
Description……Page 328
Description……Page 329
Description……Page 330
Purpose……Page 331
Description……Page 332
Files……Page 333
Description……Page 334
Device-Dependent Subroutines……Page 335
Description……Page 340
Description……Page 341
Related Information……Page 342
Description……Page 343
Description……Page 344
Files……Page 345
Files……Page 346
Related Information……Page 347
Device-Dependent Subroutines……Page 349
Reliability and Serviceability Information……Page 350
Device-Dependent Subroutines……Page 353
Device Requirements……Page 355
Error Conditions……Page 356
Reliability and Serviceability Information……Page 357
Special Files……Page 360
Device-Dependent Subroutines……Page 361
Error Conditions……Page 362
Related Information……Page 366
Return Values……Page 367
Return Values……Page 368
Description……Page 369
Return Values……Page 370
Related Information……Page 371
Related Information……Page 372
Files……Page 373
Related Information……Page 374
Trace Formatting……Page 375
SSA Micro Channel Adapter ODM Attributes……Page 376
Device-Dependent Subroutines……Page 377
Related Information……Page 378
Files……Page 379
Description……Page 380
Related Information……Page 381
Configuration Issues……Page 382
Device Attributes……Page 385
Device-Dependent Subroutines……Page 386
Error Conditions……Page 388
Special Files……Page 389
Related Information……Page 390
Return Values……Page 391
Description……Page 392
Related Information……Page 393
Return Values……Page 394
Description……Page 395
SSA Disk Concurrent Mode of Operation Interface……Page 396
Top Kernel Extension Entry Point……Page 397
SSA Disk Fencing……Page 398
SSA Target Mode……Page 399
Buffer Management……Page 400
Execution of Target Mode Requests……Page 401
Description……Page 402
Device-Dependent Subroutines……Page 403
Description……Page 408
Purpose……Page 409
Description……Page 410
Description……Page 413
openx Subroutine……Page 414
ioctl Subroutine……Page 415
Related Information……Page 419
ioctl Subroutine……Page 420
Device-Dependent Subroutines for Serial DASD Adapter Operations……Page 423
ioctl Subroutine……Page 424
Error Conditions for Serial DASD Subroutines……Page 427
Related Information……Page 428
Hardware Implementation……Page 429
Software Implementation……Page 430
Device Driver Entry Point……Page 431
Top Kernel Extension Entry Point……Page 432
Related Information……Page 433
Appendix. Notices……Page 435
Trademarks……Page 436
Index……Page 437
Readers’ Comments — We’d Like to Hear from You……Page 445