요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
=============
2
Ioctl Numbers
3
=============
5
19 October 1999
7
Michael Elizabeth Chastain
8
<mec@shout.net>
10
If you are adding new ioctl's to the kernel, you should use the _IO
11
macros defined in <linux/ioctl.h>:
13
====== ===========================
14
macro parameters
15
====== ===========================
16
_IO none
17
_IOW write (read from userspace)
18
_IOR read (write to userpace)
19
_IOWR write and read
20
====== ===========================
22
'Write' and 'read' are from the user's point of view, just like the
23
system calls 'write' and 'read'. For example, a SET_FOO ioctl would
24
be _IOW, although the kernel would actually read data from user space;
25
a GET_FOO ioctl would be _IOR, although the kernel would actually write
26
data to user space.
28
The first argument to the macros is an identifying letter or number from
29
the table below. Because of the large number of drivers, many drivers
30
share a partial letter with other drivers.
32
If you are writing a driver for a new device and need a letter, pick an
33
unused block with enough room for expansion: 32 to 256 ioctl commands
34
should suffice. You can register the block by patching this file and
35
submitting the patch through :doc:`usual patch submission process
36
</process/submitting-patches>`.
38
The second argument is a sequence number to distinguish ioctls from each
39
other. The third argument (not applicable to _IO) is the type of the data
40
going into the kernel or coming out of the kernel (e.g. 'int' or
41
'struct foo').
43
.. note::
44
Do NOT use sizeof(arg) as the third argument as this results in your
45
ioctl thinking it passes an argument of type size_t.
47
Some devices use their major number as the identifier; this is OK, as
48
long as it is unique. Some devices are irregular and don't follow any
49
convention at all.
51
Following this convention is good because:
53
(1) Keeping the ioctl's globally unique helps error checking:
54
if a program calls an ioctl on the wrong device, it will get an
55
error rather than some unexpected behaviour.
57
(2) The 'strace' build procedure automatically finds ioctl numbers
58
defined with the macros.
60
(3) 'strace' can decode numbers back into useful names when the
61
numbers are unique.
63
(4) People looking for ioctls can grep for them more easily when
64
this convention is used to define the ioctl numbers.
66
(5) When following the convention, the driver code can use generic
67
code to copy the parameters between user and kernel space.
69
This table lists ioctls visible from userland, excluding ones from
70
drivers/staging/.
72
==== ===== ========================================================= ================================================================
73
Code Seq# Include File Comments
74
(hex)
75
==== ===== ========================================================= ================================================================
76
0x00 00-1F linux/fs.h conflict!
77
0x00 00-1F scsi/scsi_ioctl.h conflict!
78
0x00 00-1F linux/fb.h conflict!
79
0x00 00-1F linux/wavefront.h conflict!
80
0x02 all linux/fd.h
81
0x03 all linux/hdreg.h
82
0x04 D2-DC linux/umsdos_fs.h Dead since 2.6.11, but don't reuse these.
83
0x06 all linux/lp.h
84
0x07 9F-D0 linux/vmw_vmci_defs.h, uapi/linux/vm_sockets.h
85
0x09 all linux/raid/md_u.h
86
0x10 00-0F drivers/char/s390/vmcp.h
87
0x10 10-1F arch/s390/include/uapi/sclp_ctl.h
88
0x10 20-2F arch/s390/include/uapi/asm/hypfs.h
89
0x12 all linux/fs.h BLK* ioctls
90
linux/blkpg.h
91
linux/blkzoned.h
92
linux/blk-crypto.h
93
0x15 all linux/fs.h FS_IOC_* ioctls
94
0x1b all InfiniBand Subsystem
95
<http://infiniband.sourceforge.net/>
96
0x20 all drivers/cdrom/cm206.h
97
0x22 all scsi/sg.h
98
0x3E 00-0F linux/counter.h <mailto:linux-iio@vger.kernel.org>
99
'!' 00-1F uapi/linux/seccomp.h
100
'#' 00-3F IEEE 1394 Subsystem
101
Block for the entire subsystem
102
'$' 00-0F linux/perf_counter.h, linux/perf_event.h
103
'%' 00-0F include/uapi/linux/stm.h System Trace Module subsystem
104
<mailto:alexander.shishkin@linux.intel.com>
105
'&' 00-07 drivers/firewire/nosy-user.h
106
'*' 00-1F uapi/linux/user_events.h User Events Subsystem
107
<mailto:linux-trace-kernel@vger.kernel.org>
108
'1' 00-1F linux/timepps.h PPS kit from Ulrich Windl
109
<ftp://ftp.de.kernel.org/pub/linux/daemons/ntp/PPS/>
110
'2' 01-04 linux/i2o.h
111
'3' 00-0F drivers/s390/char/raw3270.h conflict!
112
'3' 00-1F linux/suspend_ioctls.h, conflict!
113
kernel/power/user.c
114
'8' all SNP8023 advanced NIC card
115
<mailto:mcr@solidum.com>
116
';' 64-7F linux/vfio.h
117
';' 80-FF linux/iommufd.h
118
'=' 00-3f uapi/linux/ptp_clock.h <mailto:richardcochran@gmail.com>
119
'@' 00-0F linux/radeonfb.h conflict!
120
'@' 00-0F drivers/video/aty/aty128fb.c conflict!
121
'A' 00-1F linux/apm_bios.h conflict!
122
'A' 00-0F linux/agpgart.h, conflict!
123
drivers/char/agp/compat_ioctl.h
124
'A' 00-7F sound/asound.h conflict!
125
'B' 00-1F linux/cciss_ioctl.h conflict!
126
'B' 00-0F include/linux/pmu.h conflict!
127
'B' C0-FF advanced bbus <mailto:maassen@uni-freiburg.de>
128
'B' 00-0F xen/xenbus_dev.h conflict!
129
'C' all linux/soundcard.h conflict!
130
'C' 01-2F linux/capi.h conflict!
131
'C' F0-FF drivers/net/wan/cosa.h conflict!
132
'D' all arch/s390/include/asm/dasd.h
133
'D' 40-5F drivers/scsi/dpt/dtpi_ioctl.h Dead since 2022
134
'D' 05 drivers/scsi/pmcraid.h
135
'E' all linux/input.h conflict!
136
'E' 00-0F xen/evtchn.h conflict!
137
'F' all linux/fb.h conflict!
138
'F' 01-02 drivers/scsi/pmcraid.h conflict!
139
'F' 20 drivers/video/fsl-diu-fb.h conflict!
140
'F' 20 linux/ivtvfb.h conflict!
141
'F' 20 linux/matroxfb.h conflict!
142
'F' 20 drivers/video/aty/atyfb_base.c conflict!
143
'F' 00-0F video/da8xx-fb.h conflict!
144
'F' 80-8F linux/arcfb.h conflict!
145
'F' DD video/sstfb.h conflict!
146
'G' 00-3F drivers/misc/sgi-gru/grulib.h conflict!
147
'G' 00-0F xen/gntalloc.h, xen/gntdev.h conflict!
148
'H' 00-7F linux/hiddev.h conflict!
149
'H' 00-0F linux/hidraw.h conflict!
150
'H' 01 linux/mei.h conflict!
151
'H' 02 linux/mei.h conflict!
152
'H' 03 linux/mei.h conflict!
153
'H' 00-0F sound/asound.h conflict!
154
'H' 20-40 sound/asound_fm.h conflict!
155
'H' 80-8F sound/sfnt_info.h conflict!
156
'H' 10-8F sound/emu10k1.h conflict!
157
'H' 10-1F sound/sb16_csp.h conflict!
158
'H' 10-1F sound/hda_hwdep.h conflict!
159
'H' 40-4F sound/hdspm.h conflict!
160
'H' 40-4F sound/hdsp.h conflict!
161
'H' 90 sound/usb/usx2y/usb_stream.h
162
'H' 00-0F uapi/misc/habanalabs.h conflict!
163
'H' A0 uapi/linux/usb/cdc-wdm.h
164
'H' C0-F0 net/bluetooth/hci.h conflict!
165
'H' C0-DF net/bluetooth/hidp/hidp.h conflict!
166
'H' C0-DF net/bluetooth/cmtp/cmtp.h conflict!
167
'H' C0-DF net/bluetooth/bnep/bnep.h conflict!
168
'H' F1 linux/hid-roccat.h <mailto:erazor_de@users.sourceforge.net>
169
'H' F8-FA sound/firewire.h
170
'I' all linux/isdn.h conflict!
171
'I' 00-0F drivers/isdn/divert/isdn_divert.h conflict!
172
'I' 40-4F linux/mISDNif.h conflict!
173
'K' all linux/kd.h
174
'L' 00-1F linux/loop.h conflict!
175
'L' 10-1F drivers/scsi/mpt3sas/mpt3sas_ctl.h conflict!
176
'L' E0-FF linux/ppdd.h encrypted disk device driver
177
<http://linux01.gwdg.de/~alatham/ppdd.html>
178
'M' all linux/soundcard.h conflict!
179
'M' 01-16 mtd/mtd-abi.h conflict!
180
and drivers/mtd/mtdchar.c
181
'M' 01-03 drivers/scsi/megaraid/megaraid_sas.h
182
'M' 00-0F drivers/video/fsl-diu-fb.h conflict!
183
'N' 00-1F drivers/usb/scanner.h
184
'N' 40-7F drivers/block/nvme.c
185
'N' 80-8F uapi/linux/ntsync.h NT synchronization primitives
186
<mailto:wine-devel@winehq.org>
187
'O' 00-06 mtd/ubi-user.h UBI
188
'P' all linux/soundcard.h conflict!
189
'P' 60-6F sound/sscape_ioctl.h conflict!
190
'P' 00-0F drivers/usb/class/usblp.c conflict!
191
'P' 01-09 drivers/misc/pci_endpoint_test.c conflict!
192
'P' 00-0F xen/privcmd.h conflict!
193
'P' 00-05 linux/tps6594_pfsm.h conflict!
194
'Q' all linux/soundcard.h
195
'R' 00-1F linux/random.h conflict!
196
'R' 01 linux/rfkill.h conflict!
197
'R' 20-2F linux/trace_mmap.h
198
'R' C0-DF net/bluetooth/rfcomm.h
199
'R' E0 uapi/linux/fsl_mc.h
200
'S' all linux/cdrom.h conflict!
201
'S' 80-81 scsi/scsi_ioctl.h conflict!
202
'S' 82-FF scsi/scsi.h conflict!
203
'S' 00-7F sound/asequencer.h conflict!
204
'T' all linux/soundcard.h conflict!
205
'T' 00-AF sound/asound.h conflict!
206
'T' all arch/x86/include/asm/ioctls.h conflict!
207
'T' C0-DF linux/if_tun.h conflict!
208
'U' all sound/asound.h conflict!
209
'U' 00-CF linux/uinput.h conflict!
210
'U' 00-EF linux/usbdevice_fs.h
211
'U' C0-CF drivers/bluetooth/hci_uart.h
212
'V' all linux/vt.h conflict!
213
'V' all linux/videodev2.h conflict!
214
'V' C0 linux/ivtvfb.h conflict!
215
'V' C0 linux/ivtv.h conflict!
216
'V' C0 media/si4713.h conflict!
217
'W' 00-1F linux/watchdog.h conflict!
218
'W' 00-1F linux/wanrouter.h conflict! (pre 3.9)
219
'W' 00-3F sound/asound.h conflict!
220
'W' 40-5F drivers/pci/switch/switchtec.c
221
'W' 60-61 linux/watch_queue.h
222
'X' all fs/xfs/xfs_fs.h, conflict!
223
fs/xfs/linux-2.6/xfs_ioctl32.h,
224
include/linux/falloc.h,
225
linux/fs.h,
226
'X' all fs/ocfs2/ocfs_fs.h conflict!
227
'Z' 14-15 drivers/message/fusion/mptctl.h
228
'[' 00-3F linux/usb/tmc.h USB Test and Measurement Devices
229
<mailto:gregkh@linuxfoundation.org>
230
'a' all linux/atm*.h, linux/sonet.h ATM on linux
231
<http://lrcwww.epfl.ch/>
232
'b' 00-FF conflict! bit3 vme host bridge
233
<mailto:natalia@nikhefk.nikhef.nl>
234
'b' 00-0F linux/dma-buf.h conflict!
235
'c' 00-7F linux/comstats.h conflict!
236
'c' 00-7F linux/coda.h conflict!
237
'c' 00-1F linux/chio.h conflict!
238
'c' 80-9F arch/s390/include/asm/chsc.h conflict!
239
'c' A0-AF arch/x86/include/asm/msr.h conflict!
240
'd' 00-FF linux/char/drm/drm.h conflict!
241
'd' 02-40 pcmcia/ds.h conflict!
242
'd' F0-FF linux/digi1.h
243
'e' all linux/digi1.h conflict!
244
'f' 00-1F linux/ext2_fs.h conflict!
245
'f' 00-1F linux/ext3_fs.h conflict!
246
'f' 00-0F fs/jfs/jfs_dinode.h conflict!
247
'f' 00-0F fs/ext4/ext4.h conflict!
248
'f' 00-0F linux/fs.h conflict!
249
'f' 00-0F fs/ocfs2/ocfs2_fs.h conflict!
250
'f' 13-27 linux/fscrypt.h
251
'f' 81-8F linux/fsverity.h
252
'g' 00-0F linux/usb/gadgetfs.h
253
'g' 20-2F linux/usb/g_printer.h
254
'h' 00-7F conflict! Charon filesystem
255
<mailto:zapman@interlan.net>
256
'h' 00-1F linux/hpet.h conflict!
257
'h' 80-8F fs/hfsplus/ioctl.c
258
'i' 00-3F linux/i2o-dev.h conflict!
259
'i' 0B-1F linux/ipmi.h conflict!
260
'i' 80-8F linux/i8k.h
261
'i' 90-9F `linux/iio/*.h` IIO
262
'j' 00-3F linux/joystick.h
263
'k' 00-0F linux/spi/spidev.h conflict!
264
'k' 00-05 video/kyro.h conflict!
265
'k' 10-17 linux/hsi/hsi_char.h HSI character device
266
'l' 00-3F linux/tcfs_fs.h transparent cryptographic file system
267
<http://web.archive.org/web/%2A/http://mikonos.dia.unisa.it/tcfs>
268
'l' 40-7F linux/udf_fs_i.h in development:
269
<https://github.com/pali/udftools>
270
'm' 00-09 linux/mmtimer.h conflict!
271
'm' all linux/mtio.h conflict!
272
'm' all linux/soundcard.h conflict!
273
'm' all linux/synclink.h conflict!
274
'm' 00-19 drivers/message/fusion/mptctl.h conflict!
275
'm' 00 drivers/scsi/megaraid/megaraid_ioctl.h conflict!
276
'n' 00-7F linux/ncp_fs.h and fs/ncpfs/ioctl.c
277
'n' 80-8F uapi/linux/nilfs2_api.h NILFS2
278
'n' E0-FF linux/matroxfb.h matroxfb
279
'o' 00-1F fs/ocfs2/ocfs2_fs.h OCFS2
280
'o' 00-03 mtd/ubi-user.h conflict! (OCFS2 and UBI overlaps)
281
'o' 40-41 mtd/ubi-user.h UBI
282
'o' 01-A1 `linux/dvb/*.h` DVB
283
'p' 00-0F linux/phantom.h conflict! (OpenHaptics needs this)
284
'p' 00-1F linux/rtc.h conflict!
285
'p' 40-7F linux/nvram.h
286
'p' 80-9F linux/ppdev.h user-space parport
287
<mailto:tim@cyberelk.net>
288
'p' A1-A5 linux/pps.h LinuxPPS
289
'p' B1-B3 linux/pps_gen.h LinuxPPS
290
<mailto:giometti@linux.it>
291
'q' 00-1F linux/serio.h
292
'q' 80-FF linux/telephony.h Internet PhoneJACK, Internet LineJACK
293
linux/ixjuser.h <http://web.archive.org/web/%2A/http://www.quicknet.net>
294
'r' 00-1F linux/msdos_fs.h and fs/fat/dir.c
295
's' all linux/cdk.h
296
't' 00-7F linux/ppp-ioctl.h
297
't' 80-8F linux/isdn_ppp.h
298
't' 90-91 linux/toshiba.h toshiba and toshiba_acpi SMM
299
'u' 00-1F linux/smb_fs.h gone
300
'u' 00-2F linux/ublk_cmd.h conflict!
301
'u' 20-3F linux/uvcvideo.h USB video class host driver
302
'u' 40-4f linux/udmabuf.h userspace dma-buf misc device
303
'v' 00-1F linux/ext2_fs.h conflict!
304
'v' 00-1F linux/fs.h conflict!
305
'v' 00-0F linux/sonypi.h conflict!
306
'v' 00-0F media/v4l2-subdev.h conflict!
307
'v' 20-27 arch/powerpc/include/uapi/asm/vas-api.h VAS API
308
'v' C0-FF linux/meye.h conflict!
309
'w' all CERN SCI driver
310
'y' 00-1F packet based user level communications
311
<mailto:zapman@interlan.net>
312
'z' 00-3F CAN bus card conflict!
313
<mailto:hdstich@connectu.ulm.circular.de>
314
'z' 40-7F CAN bus card conflict!
315
<mailto:oe@port.de>
316
'z' 10-4F drivers/s390/crypto/zcrypt_api.h conflict!
317
'|' 00-7F linux/media.h
318
'|' 80-9F samples/ Any sample and example drivers
319
0x80 00-1F linux/fb.h
320
0x81 00-1F linux/vduse.h
321
0x89 00-06 arch/x86/include/asm/sockios.h
322
0x89 0B-DF linux/sockios.h
323
0x89 E0-EF linux/sockios.h SIOCPROTOPRIVATE range
324
0x89 F0-FF linux/sockios.h SIOCDEVPRIVATE range
325
0x8A 00-1F linux/eventpoll.h
326
0x8B all linux/wireless.h
327
0x8C 00-3F WiNRADiO driver
328
<http://www.winradio.com.au/>
329
0x90 00 drivers/cdrom/sbpcd.h
330
0x92 00-0F drivers/usb/mon/mon_bin.c
331
0x93 60-7F linux/auto_fs.h
332
0x94 all fs/btrfs/ioctl.h Btrfs filesystem
333
and linux/fs.h some lifted to vfs/generic
334
0x97 00-7F fs/ceph/ioctl.h Ceph file system
335
0x99 00-0F 537-Addinboard driver
336
<mailto:buk@buks.ipn.de>
337
0x9A 00-0F include/uapi/fwctl/fwctl.h
338
0xA0 all linux/sdp/sdp.h Industrial Device Project
339
<mailto:kenji@bitgate.com>
340
0xA1 0 linux/vtpm_proxy.h TPM Emulator Proxy Driver
341
0xA2 all uapi/linux/acrn.h ACRN hypervisor
342
0xA3 80-8F Port ACL in development:
343
<mailto:tlewis@mindspring.com>
344
0xA3 90-9F linux/dtlk.h
345
0xA4 00-1F uapi/linux/tee.h Generic TEE subsystem
346
0xA4 00-1F uapi/asm/sgx.h <mailto:linux-sgx@vger.kernel.org>
347
0xA5 01-05 linux/surface_aggregator/cdev.h Microsoft Surface Platform System Aggregator
348
<mailto:luzmaximilian@gmail.com>
349
0xA5 20-2F linux/surface_aggregator/dtx.h Microsoft Surface DTX driver
350
<mailto:luzmaximilian@gmail.com>
351
0xAA 00-3F linux/uapi/linux/userfaultfd.h
352
0xAB 00-1F linux/nbd.h
353
0xAC 00-1F linux/raw.h
354
0xAD 00 Netfilter device in development:
355
<mailto:rusty@rustcorp.com.au>
356
0xAE 00-1F linux/kvm.h Kernel-based Virtual Machine
357
<mailto:kvm@vger.kernel.org>
358
0xAE 40-FF linux/kvm.h Kernel-based Virtual Machine
359
<mailto:kvm@vger.kernel.org>
360
0xAE 20-3F linux/nitro_enclaves.h Nitro Enclaves
361
0xAF 00-1F linux/fsl_hypervisor.h Freescale hypervisor
362
0xB0 all RATIO devices in development:
363
<mailto:vgo@ratio.de>
364
0xB1 00-1F PPPoX
365
<mailto:mostrows@styx.uwaterloo.ca>
366
0xB2 00 arch/powerpc/include/uapi/asm/papr-vpd.h powerpc/pseries VPD API
367
<mailto:linuxppc-dev@lists.ozlabs.org>
368
0xB2 01-02 arch/powerpc/include/uapi/asm/papr-sysparm.h powerpc/pseries system parameter API
369
<mailto:linuxppc-dev@lists.ozlabs.org>
370
0xB2 03-05 arch/powerpc/include/uapi/asm/papr-indices.h powerpc/pseries indices API
371
<mailto:linuxppc-dev@lists.ozlabs.org>
372
0xB2 06-07 arch/powerpc/include/uapi/asm/papr-platform-dump.h powerpc/pseries Platform Dump API
373
<mailto:linuxppc-dev@lists.ozlabs.org>
374
0xB2 08 arch/powerpc/include/uapi/asm/papr-physical-attestation.h powerpc/pseries Physical Attestation API
375
<mailto:linuxppc-dev@lists.ozlabs.org>
376
0xB2 09 arch/powerpc/include/uapi/asm/papr-hvpipe.h powerpc/pseries HVPIPE API
377
<mailto:linuxppc-dev@lists.ozlabs.org>
378
0xB3 00 linux/mmc/ioctl.h
379
0xB4 00-0F linux/gpio.h <mailto:linux-gpio@vger.kernel.org>
380
0xB5 00-0F uapi/linux/rpmsg.h <mailto:linux-remoteproc@vger.kernel.org>
381
0xB6 all linux/fpga-dfl.h
382
0xB7 all uapi/linux/remoteproc_cdev.h <mailto:linux-remoteproc@vger.kernel.org>
383
0xB7 all uapi/linux/nsfs.h <mailto:Andrei Vagin <avagin@openvz.org>>
384
0xB8 01-02 uapi/misc/mrvl_cn10k_dpi.h Marvell CN10K DPI driver
385
0xB8 all uapi/linux/mshv.h Microsoft Hyper-V /dev/mshv driver
386
<mailto:linux-hyperv@vger.kernel.org>
387
0xC0 00-0F linux/usb/iowarrior.h
388
0xCA 00-0F uapi/misc/cxl.h Dead since 6.15
389
0xCA 10-2F uapi/misc/ocxl.h
390
0xCA 80-BF uapi/scsi/cxlflash_ioctl.h Dead since 6.15
391
0xCB 00-1F CBM serial IEC bus in development:
392
<mailto:michael.klein@puffin.lb.shuttle.de>
393
0xCC 00-0F drivers/misc/ibmvmc.h pseries VMC driver
394
0xCD 01 linux/reiserfs_fs.h Dead since 6.13
395
0xCE 01-02 uapi/linux/cxl_mem.h Compute Express Link Memory Devices
396
0xCF 02 fs/smb/client/cifs_ioctl.h
397
0xDB 00-0F drivers/char/mwave/mwavepub.h
398
0xDD 00-3F ZFCP device driver see drivers/s390/scsi/
399
<mailto:aherrman@de.ibm.com>
400
0xE5 00-3F linux/fuse.h
401
0xEC 00-01 drivers/platform/chrome/cros_ec_dev.h ChromeOS EC driver
402
0xEE 00-09 uapi/linux/pfrut.h Platform Firmware Runtime Update and Telemetry
403
0xF3 00-3F drivers/usb/misc/sisusbvga/sisusb.h sisfb (in development)
404
<mailto:thomas@winischhofer.net>
405
0xF6 all LTTng Linux Trace Toolkit Next Generation
406
<mailto:mathieu.desnoyers@efficios.com>
407
0xF8 all arch/x86/include/uapi/asm/amd_hsmp.h AMD HSMP EPYC system management interface driver
408
<mailto:nchatrad@amd.com>
409
0xF9 00-0F uapi/misc/amd-apml.h AMD side band system management interface driver
410
<mailto:naveenkrishna.chatradhi@amd.com>
411
0xFD all linux/dm-ioctl.h
412
0xFE all linux/isst_if.h
413
==== ===== ========================================================= ================================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
새 ioctl 번호를 정의하는 규칙
1-71이 문서는 Michael Elizabeth Chastain이 1999년 10월 19일 작성한 ioctl 번호 등록 지침입니다. 커널에 새 ioctl을 추가할 때는 `<linux/ioctl.h>`에 정의된 `_IO` 계열 매크로를 사용해야 합니다.
매크로매개변수 방향
_IO전달 매개변수 없음
_IOW쓰기: 사용자 공간에서 커널이 읽음
_IOR읽기: 커널이 사용자 공간에 씀
_IOWR쓰기와 읽기 모두 수행
읽기와 쓰기는 시스템 호출과 마찬가지로 사용자 관점에서 이름 붙입니다.
예를 들어 `SET_FOO`는 커널이 사용자 데이터를 읽더라도 사용자 관점에서는 쓰기이므로 `_IOW`입니다. `GET_FOO`는 커널이 사용자 공간에 데이터를 쓰지만 사용자 관점에서는 읽기이므로 `_IOR`입니다.
첫 번째 인자는 아래 할당표의 식별 문자 또는 숫자입니다. 드라이버 수가 많아 일부 문자는 여러 드라이버가 부분 범위를 공유합니다. 새 장치 드라이버는 확장에 충분한 32~256개 명령 공간을 가진 미사용 블록을 골라야 하며, 이 파일을 수정한 패치를 일반적인 패치 제출 절차로 보내 등록합니다.
두 번째 인자는 ioctl을 서로 구분하는 순번입니다. `_IO`를 제외한 매크로의 세 번째 인자는 커널로 들어가거나 나오는 데이터의 실제 형식, 예를 들어 `int` 또는 `struct foo`입니다. 세 번째 인자에 `sizeof(arg)`를 쓰면 ioctl이 전달 형식을 `size_t`로 잘못 인식하므로 절대 사용하지 않아야 합니다.
일부 장치는 major 번호를 식별자로 사용하며 고유하기만 하면 허용됩니다. 어떤 장치는 관례를 전혀 따르지 않는 불규칙한 번호를 사용하기도 합니다.
항목설명
1잘못된 장치에 호출하면 예상 밖 동작 대신 오류를 내도록 검사 가능
2strace 빌드가 매크로로 정의된 ioctl 번호를 자동 탐색
3고유 번호를 strace가 유용한 이름으로 역변환
4grep으로 ioctl 정의를 더 쉽게 검색
5드라이버가 사용자·커널 공간 사이 매개변수 복사에 공통 코드를 사용
전역 고유성과 도구 지원, 공통 복사 코드를 얻습니다.
뒤의 표는 `drivers/staging/` 아래 항목을 제외하고 사용자 공간에 보이는 ioctl 할당을 나열합니다. `conflict!` 표시는 코드와 순번 범위가 다른 항목과 겹친다는 뜻입니다.
32~256개 여유가 있는 미사용 식별 블록 선택→첫 인자에 식별 문자·숫자 사용→둘째 인자에 고유 순번 배정→셋째 인자에 실제 데이터 형식 지정→sizeof(arg) 사용 금지→이 문서를 수정해 패치 제출
충돌을 피하고 ABI 인코딩이 실제 데이터 형식을 담도록 합니다.
=============
Ioctl Numbers
=============
19 October 1999
Michael Elizabeth Chastain
<mec@shout.net>
If you are adding new ioctl's to the kernel, you should use the _IO
macros defined in <linux/ioctl.h>:
====== ===========================
macro parameters
====== ===========================
_IO none
_IOW write (read from userspace)
_IOR read (write to userpace)
_IOWR write and read
====== ===========================
'Write' and 'read' are from the user's point of view, just like the
system calls 'write' and 'read'. For example, a SET_FOO ioctl would
be _IOW, although the kernel would actually read data from user space;
a GET_FOO ioctl would be _IOR, although the kernel would actually write
data to user space.
The first argument to the macros is an identifying letter or number from
the table below. Because of the large number of drivers, many drivers
share a partial letter with other drivers.
If you are writing a driver for a new device and need a letter, pick an
unused block with enough room for expansion: 32 to 256 ioctl commands
should suffice. You can register the block by patching this file and
submitting the patch through :doc:`usual patch submission process
</process/submitting-patches>`.
The second argument is a sequence number to distinguish ioctls from each
other. The third argument (not applicable to _IO) is the type of the data
going into the kernel or coming out of the kernel (e.g. 'int' or
'struct foo').
.. note::
Do NOT use sizeof(arg) as the third argument as this results in your
ioctl thinking it passes an argument of type size_t.
Some devices use their major number as the identifier; this is OK, as
long as it is unique. Some devices are irregular and don't follow any
convention at all.
Following this convention is good because:
(1) Keeping the ioctl's globally unique helps error checking:
if a program calls an ioctl on the wrong device, it will get an
error rather than some unexpected behaviour.
(2) The 'strace' build procedure automatically finds ioctl numbers
defined with the macros.
(3) 'strace' can decode numbers back into useful names when the
numbers are unique.
(4) People looking for ioctls can grep for them more easily when
this convention is used to define the ioctl numbers.
(5) When following the convention, the driver code can use generic
code to copy the parameters between user and kernel space.
This table lists ioctls visible from userland, excluding ones from
drivers/staging/.
ioctl 할당표: 0x00부터 'F'까지
72-145다음 표는 숫자 코드와 `'!'`부터 `'F'`까지의 문자 코드 할당입니다. 파일 경로와 순번 범위를 원문 그대로 유지하며 상태 설명만 한국어로 표시합니다.
CodeSeq# (hex)Include File설명
0x0000-1Flinux/fs.h충돌!
0x0000-1Fscsi/scsi_ioctl.h충돌!
0x0000-1Flinux/fb.h충돌!
0x0000-1Flinux/wavefront.h충돌!
0x02alllinux/fd.h
0x03alllinux/hdreg.h
0x04D2-DClinux/umsdos_fs.h2.6.11부터 제거되었지만 이 범위는 재사용하지 말 것.
0x06alllinux/lp.h
0x079F-D0linux/vmw_vmci_defs.h, uapi/linux/vm_sockets.h
0x09alllinux/raid/md_u.h
0x1000-0Fdrivers/char/s390/vmcp.h
0x1010-1Farch/s390/include/uapi/sclp_ctl.h
0x1020-2Farch/s390/include/uapi/asm/hypfs.h
0x12alllinux/fs.hBLK* ioctl
↳linux/blkpg.h
↳linux/blkzoned.h
↳linux/blk-crypto.h
0x15alllinux/fs.hFS_IOC_* ioctl
0x1ballInfiniBand 서브시스템
↳<http://infiniband.sourceforge.net/>
0x20alldrivers/cdrom/cm206.h
0x22allscsi/sg.h
0x3E00-0Flinux/counter.h<mailto:linux-iio@vger.kernel.org>
'!'00-1Fuapi/linux/seccomp.h
'#'00-3FIEEE 1394 Subsystem
↳서브시스템 전체에 사용하는 블록
'$'00-0Flinux/perf_counter.h, linux/perf_event.h
'%'00-0Finclude/uapi/linux/stm.hSystem Trace Module 서브시스템
↳<mailto:alexander.shishkin@linux.intel.com>
'&'00-07drivers/firewire/nosy-user.h
'*'00-1Fuapi/linux/user_events.hUser Events 서브시스템
↳<mailto:linux-trace-kernel@vger.kernel.org>
'1'00-1Flinux/timepps.hUlrich Windl의 PPS 키트
↳<ftp://ftp.de.kernel.org/pub/linux/daemons/ntp/PPS/>
'2'01-04linux/i2o.h
'3'00-0Fdrivers/s390/char/raw3270.h충돌!
'3'00-1Flinux/suspend_ioctls.h,충돌!
↳kernel/power/user.c
'8'allSNP8023 고급 NIC 카드
↳<mailto:mcr@solidum.com>
';'64-7Flinux/vfio.h
';'80-FFlinux/iommufd.h
'='00-3fuapi/linux/ptp_clock.h<mailto:richardcochran@gmail.com>
'@'00-0Flinux/radeonfb.h충돌!
'@'00-0Fdrivers/video/aty/aty128fb.c충돌!
'A'00-1Flinux/apm_bios.h충돌!
'A'00-0Flinux/agpgart.h,충돌!
↳drivers/char/agp/compat_ioctl.h
'A'00-7Fsound/asound.h충돌!
'B'00-1Flinux/cciss_ioctl.h충돌!
'B'00-0Finclude/linux/pmu.h충돌!
'B'C0-FFadvanced bbus<mailto:maassen@uni-freiburg.de>
'B'00-0Fxen/xenbus_dev.h충돌!
'C'alllinux/soundcard.h충돌!
'C'01-2Flinux/capi.h충돌!
'C'F0-FFdrivers/net/wan/cosa.h충돌!
'D'allarch/s390/include/asm/dasd.h
'D'40-5Fdrivers/scsi/dpt/dtpi_ioctl.h2022부터 제거됨
'D'05drivers/scsi/pmcraid.h
'E'alllinux/input.h충돌!
'E'00-0Fxen/evtchn.h충돌!
'F'alllinux/fb.h충돌!
'F'01-02drivers/scsi/pmcraid.h충돌!
'F'20drivers/video/fsl-diu-fb.h충돌!
'F'20linux/ivtvfb.h충돌!
'F'20linux/matroxfb.h충돌!
'F'20drivers/video/aty/atyfb_base.c충돌!
'F'00-0Fvideo/da8xx-fb.h충돌!
'F'80-8Flinux/arcfb.h충돌!
'F'DDvideo/sstfb.h충돌!
Code와 Seq#(hex)의 조합이 실제 할당 범위입니다.
==== ===== ========================================================= ================================================================
Code Seq# Include File Comments
(hex)
==== ===== ========================================================= ================================================================
0x00 00-1F linux/fs.h conflict!
0x00 00-1F scsi/scsi_ioctl.h conflict!
0x00 00-1F linux/fb.h conflict!
0x00 00-1F linux/wavefront.h conflict!
0x02 all linux/fd.h
0x03 all linux/hdreg.h
0x04 D2-DC linux/umsdos_fs.h Dead since 2.6.11, but don't reuse these.
0x06 all linux/lp.h
0x07 9F-D0 linux/vmw_vmci_defs.h, uapi/linux/vm_sockets.h
0x09 all linux/raid/md_u.h
0x10 00-0F drivers/char/s390/vmcp.h
0x10 10-1F arch/s390/include/uapi/sclp_ctl.h
0x10 20-2F arch/s390/include/uapi/asm/hypfs.h
0x12 all linux/fs.h BLK* ioctls
linux/blkpg.h
linux/blkzoned.h
linux/blk-crypto.h
0x15 all linux/fs.h FS_IOC_* ioctls
0x1b all InfiniBand Subsystem
<http://infiniband.sourceforge.net/>
0x20 all drivers/cdrom/cm206.h
0x22 all scsi/sg.h
0x3E 00-0F linux/counter.h <mailto:linux-iio@vger.kernel.org>
'!' 00-1F uapi/linux/seccomp.h
'#' 00-3F IEEE 1394 Subsystem
Block for the entire subsystem
'$' 00-0F linux/perf_counter.h, linux/perf_event.h
'%' 00-0F include/uapi/linux/stm.h System Trace Module subsystem
<mailto:alexander.shishkin@linux.intel.com>
'&' 00-07 drivers/firewire/nosy-user.h
'*' 00-1F uapi/linux/user_events.h User Events Subsystem
<mailto:linux-trace-kernel@vger.kernel.org>
'1' 00-1F linux/timepps.h PPS kit from Ulrich Windl
<ftp://ftp.de.kernel.org/pub/linux/daemons/ntp/PPS/>
'2' 01-04 linux/i2o.h
'3' 00-0F drivers/s390/char/raw3270.h conflict!
'3' 00-1F linux/suspend_ioctls.h, conflict!
kernel/power/user.c
'8' all SNP8023 advanced NIC card
<mailto:mcr@solidum.com>
';' 64-7F linux/vfio.h
';' 80-FF linux/iommufd.h
'=' 00-3f uapi/linux/ptp_clock.h <mailto:richardcochran@gmail.com>
'@' 00-0F linux/radeonfb.h conflict!
'@' 00-0F drivers/video/aty/aty128fb.c conflict!
'A' 00-1F linux/apm_bios.h conflict!
'A' 00-0F linux/agpgart.h, conflict!
drivers/char/agp/compat_ioctl.h
'A' 00-7F sound/asound.h conflict!
'B' 00-1F linux/cciss_ioctl.h conflict!
'B' 00-0F include/linux/pmu.h conflict!
'B' C0-FF advanced bbus <mailto:maassen@uni-freiburg.de>
'B' 00-0F xen/xenbus_dev.h conflict!
'C' all linux/soundcard.h conflict!
'C' 01-2F linux/capi.h conflict!
'C' F0-FF drivers/net/wan/cosa.h conflict!
'D' all arch/s390/include/asm/dasd.h
'D' 40-5F drivers/scsi/dpt/dtpi_ioctl.h Dead since 2022
'D' 05 drivers/scsi/pmcraid.h
'E' all linux/input.h conflict!
'E' 00-0F xen/evtchn.h conflict!
'F' all linux/fb.h conflict!
'F' 01-02 drivers/scsi/pmcraid.h conflict!
'F' 20 drivers/video/fsl-diu-fb.h conflict!
'F' 20 linux/ivtvfb.h conflict!
'F' 20 linux/matroxfb.h conflict!
'F' 20 drivers/video/aty/atyfb_base.c conflict!
'F' 00-0F video/da8xx-fb.h conflict!
'F' 80-8F linux/arcfb.h conflict!
'F' DD video/sstfb.h conflict!ioctl 할당표: 'G'부터 'W'까지
146-220이 구간은 `'G'`부터 `'W'`까지의 드라이버·서브시스템 할당을 다룹니다. 여러 sound, HID, Bluetooth 항목처럼 같은 식별 문자 안에서 겹치는 범위가 많습니다.
CodeSeq# (hex)Include File설명
'G'00-3Fdrivers/misc/sgi-gru/grulib.h충돌!
'G'00-0Fxen/gntalloc.h, xen/gntdev.h충돌!
'H'00-7Flinux/hiddev.h충돌!
'H'00-0Flinux/hidraw.h충돌!
'H'01linux/mei.h충돌!
'H'02linux/mei.h충돌!
'H'03linux/mei.h충돌!
'H'00-0Fsound/asound.h충돌!
'H'20-40sound/asound_fm.h충돌!
'H'80-8Fsound/sfnt_info.h충돌!
'H'10-8Fsound/emu10k1.h충돌!
'H'10-1Fsound/sb16_csp.h충돌!
'H'10-1Fsound/hda_hwdep.h충돌!
'H'40-4Fsound/hdspm.h충돌!
'H'40-4Fsound/hdsp.h충돌!
'H'90sound/usb/usx2y/usb_stream.h
'H'00-0Fuapi/misc/habanalabs.h충돌!
'H'A0uapi/linux/usb/cdc-wdm.h
'H'C0-F0net/bluetooth/hci.h충돌!
'H'C0-DFnet/bluetooth/hidp/hidp.h충돌!
'H'C0-DFnet/bluetooth/cmtp/cmtp.h충돌!
'H'C0-DFnet/bluetooth/bnep/bnep.h충돌!
'H'F1linux/hid-roccat.h<mailto:erazor_de@users.sourceforge.net>
'H'F8-FAsound/firewire.h
'I'alllinux/isdn.h충돌!
'I'00-0Fdrivers/isdn/divert/isdn_divert.h충돌!
'I'40-4Flinux/mISDNif.h충돌!
'K'alllinux/kd.h
'L'00-1Flinux/loop.h충돌!
'L'10-1Fdrivers/scsi/mpt3sas/mpt3sas_ctl.h충돌!
'L'E0-FFlinux/ppdd.h암호화 디스크 장치 드라이버
↳<http://linux01.gwdg.de/~alatham/ppdd.html>
'M'alllinux/soundcard.h충돌!
'M'01-16mtd/mtd-abi.h충돌!
↳anddrivers/mtd/mtdchar.c
'M'01-03drivers/scsi/megaraid/megaraid_sas.h
'M'00-0Fdrivers/video/fsl-diu-fb.h충돌!
'N'00-1Fdrivers/usb/scanner.h
'N'40-7Fdrivers/block/nvme.c
'N'80-8Fuapi/linux/ntsync.hNT 동기화 기본 요소
↳<mailto:wine-devel@winehq.org>
'O'00-06mtd/ubi-user.hUBI
'P'alllinux/soundcard.h충돌!
'P'60-6Fsound/sscape_ioctl.h충돌!
'P'00-0Fdrivers/usb/class/usblp.c충돌!
'P'01-09drivers/misc/pci_endpoint_test.c충돌!
'P'00-0Fxen/privcmd.h충돌!
'P'00-05linux/tps6594_pfsm.h충돌!
'Q'alllinux/soundcard.h
'R'00-1Flinux/random.h충돌!
'R'01linux/rfkill.h충돌!
'R'20-2Flinux/trace_mmap.h
'R'C0-DFnet/bluetooth/rfcomm.h
'R'E0uapi/linux/fsl_mc.h
'S'alllinux/cdrom.h충돌!
'S'80-81scsi/scsi_ioctl.h충돌!
'S'82-FFscsi/scsi.h충돌!
'S'00-7Fsound/asequencer.h충돌!
'T'alllinux/soundcard.h충돌!
'T'00-AFsound/asound.h충돌!
'T'allarch/x86/include/asm/ioctls.h충돌!
'T'C0-DFlinux/if_tun.h충돌!
'U'allsound/asound.h충돌!
'U'00-CFlinux/uinput.h충돌!
'U'00-EFlinux/usbdevice_fs.h
'U'C0-CFdrivers/bluetooth/hci_uart.h
'V'alllinux/vt.h충돌!
'V'alllinux/videodev2.h충돌!
'V'C0linux/ivtvfb.h충돌!
'V'C0linux/ivtv.h충돌!
'V'C0media/si4713.h충돌!
'W'00-1Flinux/watchdog.h충돌!
'W'00-1Flinux/wanrouter.h충돌! (3.9 이전)
'W'00-3Fsound/asound.h충돌!
'W'40-5Fdrivers/pci/switch/switchtec.c
충돌 표시는 기존 ABI를 지우거나 재사용해도 된다는 뜻이 아닙니다.
'G' 00-3F drivers/misc/sgi-gru/grulib.h conflict!
'G' 00-0F xen/gntalloc.h, xen/gntdev.h conflict!
'H' 00-7F linux/hiddev.h conflict!
'H' 00-0F linux/hidraw.h conflict!
'H' 01 linux/mei.h conflict!
'H' 02 linux/mei.h conflict!
'H' 03 linux/mei.h conflict!
'H' 00-0F sound/asound.h conflict!
'H' 20-40 sound/asound_fm.h conflict!
'H' 80-8F sound/sfnt_info.h conflict!
'H' 10-8F sound/emu10k1.h conflict!
'H' 10-1F sound/sb16_csp.h conflict!
'H' 10-1F sound/hda_hwdep.h conflict!
'H' 40-4F sound/hdspm.h conflict!
'H' 40-4F sound/hdsp.h conflict!
'H' 90 sound/usb/usx2y/usb_stream.h
'H' 00-0F uapi/misc/habanalabs.h conflict!
'H' A0 uapi/linux/usb/cdc-wdm.h
'H' C0-F0 net/bluetooth/hci.h conflict!
'H' C0-DF net/bluetooth/hidp/hidp.h conflict!
'H' C0-DF net/bluetooth/cmtp/cmtp.h conflict!
'H' C0-DF net/bluetooth/bnep/bnep.h conflict!
'H' F1 linux/hid-roccat.h <mailto:erazor_de@users.sourceforge.net>
'H' F8-FA sound/firewire.h
'I' all linux/isdn.h conflict!
'I' 00-0F drivers/isdn/divert/isdn_divert.h conflict!
'I' 40-4F linux/mISDNif.h conflict!
'K' all linux/kd.h
'L' 00-1F linux/loop.h conflict!
'L' 10-1F drivers/scsi/mpt3sas/mpt3sas_ctl.h conflict!
'L' E0-FF linux/ppdd.h encrypted disk device driver
<http://linux01.gwdg.de/~alatham/ppdd.html>
'M' all linux/soundcard.h conflict!
'M' 01-16 mtd/mtd-abi.h conflict!
and drivers/mtd/mtdchar.c
'M' 01-03 drivers/scsi/megaraid/megaraid_sas.h
'M' 00-0F drivers/video/fsl-diu-fb.h conflict!
'N' 00-1F drivers/usb/scanner.h
'N' 40-7F drivers/block/nvme.c
'N' 80-8F uapi/linux/ntsync.h NT synchronization primitives
<mailto:wine-devel@winehq.org>
'O' 00-06 mtd/ubi-user.h UBI
'P' all linux/soundcard.h conflict!
'P' 60-6F sound/sscape_ioctl.h conflict!
'P' 00-0F drivers/usb/class/usblp.c conflict!
'P' 01-09 drivers/misc/pci_endpoint_test.c conflict!
'P' 00-0F xen/privcmd.h conflict!
'P' 00-05 linux/tps6594_pfsm.h conflict!
'Q' all linux/soundcard.h
'R' 00-1F linux/random.h conflict!
'R' 01 linux/rfkill.h conflict!
'R' 20-2F linux/trace_mmap.h
'R' C0-DF net/bluetooth/rfcomm.h
'R' E0 uapi/linux/fsl_mc.h
'S' all linux/cdrom.h conflict!
'S' 80-81 scsi/scsi_ioctl.h conflict!
'S' 82-FF scsi/scsi.h conflict!
'S' 00-7F sound/asequencer.h conflict!
'T' all linux/soundcard.h conflict!
'T' 00-AF sound/asound.h conflict!
'T' all arch/x86/include/asm/ioctls.h conflict!
'T' C0-DF linux/if_tun.h conflict!
'U' all sound/asound.h conflict!
'U' 00-CF linux/uinput.h conflict!
'U' 00-EF linux/usbdevice_fs.h
'U' C0-CF drivers/bluetooth/hci_uart.h
'V' all linux/vt.h conflict!
'V' all linux/videodev2.h conflict!
'V' C0 linux/ivtvfb.h conflict!
'V' C0 linux/ivtv.h conflict!
'V' C0 media/si4713.h conflict!
'W' 00-1F linux/watchdog.h conflict!
'W' 00-1F linux/wanrouter.h conflict! (pre 3.9)
'W' 00-3F sound/asound.h conflict!
'W' 40-5F drivers/pci/switch/switchtec.cioctl 할당표: 'W' 후반부터 'p'까지
221-290이 구간은 문자 `'W'`의 후반 범위부터 `'p'`까지를 나열합니다. 파일 시스템, USB, IIO, PPS처럼 서로 다른 하위 시스템이 같은 문자를 분할하거나 충돌 상태로 사용합니다.
CodeSeq# (hex)Include File설명
'W'60-61linux/watch_queue.h
'X'allfs/xfs/xfs_fs.h,충돌!
↳fs/xfs/linux-2.6/xfs_ioctl32.h,
↳include/linux/falloc.h,
↳linux/fs.h,
'X'allfs/ocfs2/ocfs_fs.h충돌!
'Z'14-15drivers/message/fusion/mptctl.h
'['00-3Flinux/usb/tmc.hUSB 시험·측정 장치
↳<mailto:gregkh@linuxfoundation.org>
'a'alllinux/atm*.h, linux/sonet.hLinux의 ATM
↳<http://lrcwww.epfl.ch/>
'b'00-FF충돌! bit3 vme host bridge
↳<mailto:natalia@nikhefk.nikhef.nl>
'b'00-0Flinux/dma-buf.h충돌!
'c'00-7Flinux/comstats.h충돌!
'c'00-7Flinux/coda.h충돌!
'c'00-1Flinux/chio.h충돌!
'c'80-9Farch/s390/include/asm/chsc.h충돌!
'c'A0-AFarch/x86/include/asm/msr.h충돌!
'd'00-FFlinux/char/drm/drm.h충돌!
'd'02-40pcmcia/ds.h충돌!
'd'F0-FFlinux/digi1.h
'e'alllinux/digi1.h충돌!
'f'00-1Flinux/ext2_fs.h충돌!
'f'00-1Flinux/ext3_fs.h충돌!
'f'00-0Ffs/jfs/jfs_dinode.h충돌!
'f'00-0Ffs/ext4/ext4.h충돌!
'f'00-0Flinux/fs.h충돌!
'f'00-0Ffs/ocfs2/ocfs2_fs.h충돌!
'f'13-27linux/fscrypt.h
'f'81-8Flinux/fsverity.h
'g'00-0Flinux/usb/gadgetfs.h
'g'20-2Flinux/usb/g_printer.h
'h'00-7F충돌! Charon filesystem
↳<mailto:zapman@interlan.net>
'h'00-1Flinux/hpet.h충돌!
'h'80-8Ffs/hfsplus/ioctl.c
'i'00-3Flinux/i2o-dev.h충돌!
'i'0B-1Flinux/ipmi.h충돌!
'i'80-8Flinux/i8k.h
'i'90-9F`linux/iio/*.h`IIO 서브시스템
'j'00-3Flinux/joystick.h
'k'00-0Flinux/spi/spidev.h충돌!
'k'00-05video/kyro.h충돌!
'k'10-17linux/hsi/hsi_char.hHSI 문자 장치
'l'00-3Flinux/tcfs_fs.h투명 암호화 파일 시스템
↳<http://web.archive.org/web/%2A/http://mikonos.dia.unisa.it/tcfs>
'l'40-7Flinux/udf_fs_i.h개발 중:
↳<https://github.com/pali/udftools>
'm'00-09linux/mmtimer.h충돌!
'm'alllinux/mtio.h충돌!
'm'alllinux/soundcard.h충돌!
'm'alllinux/synclink.h충돌!
'm'00-19drivers/message/fusion/mptctl.h충돌!
'm'00drivers/scsi/megaraid/megaraid_ioctl.h충돌!
'n'00-7Flinux/ncp_fs.h and fs/ncpfs/ioctl.c
'n'80-8Fuapi/linux/nilfs2_api.hNILFS2 파일 시스템
'n'E0-FFlinux/matroxfb.hmatroxfb 프레임버퍼
'o'00-1Ffs/ocfs2/ocfs2_fs.hOCFS2 파일 시스템
'o'00-03mtd/ubi-user.h충돌! (OCFS2 and UBI overlaps)
'o'40-41mtd/ubi-user.hUBI
'o'01-A1`linux/dvb/*.h`DVB 서브시스템
'p'00-0Flinux/phantom.h충돌! (OpenHaptics needs this)
'p'00-1Flinux/rtc.h충돌!
'p'40-7Flinux/nvram.h
'p'80-9Flinux/ppdev.h사용자 공간 parport
↳<mailto:tim@cyberelk.net>
'p'A1-A5linux/pps.hLinuxPPS
'p'B1-B3linux/pps_gen.hLinuxPPS
↳<mailto:giometti@linux.it>
연속 행의 `↳` 표시는 앞 행과 연결되는 추가 파일·URL·연락처입니다.
'W' 60-61 linux/watch_queue.h
'X' all fs/xfs/xfs_fs.h, conflict!
fs/xfs/linux-2.6/xfs_ioctl32.h,
include/linux/falloc.h,
linux/fs.h,
'X' all fs/ocfs2/ocfs_fs.h conflict!
'Z' 14-15 drivers/message/fusion/mptctl.h
'[' 00-3F linux/usb/tmc.h USB Test and Measurement Devices
<mailto:gregkh@linuxfoundation.org>
'a' all linux/atm*.h, linux/sonet.h ATM on linux
<http://lrcwww.epfl.ch/>
'b' 00-FF conflict! bit3 vme host bridge
<mailto:natalia@nikhefk.nikhef.nl>
'b' 00-0F linux/dma-buf.h conflict!
'c' 00-7F linux/comstats.h conflict!
'c' 00-7F linux/coda.h conflict!
'c' 00-1F linux/chio.h conflict!
'c' 80-9F arch/s390/include/asm/chsc.h conflict!
'c' A0-AF arch/x86/include/asm/msr.h conflict!
'd' 00-FF linux/char/drm/drm.h conflict!
'd' 02-40 pcmcia/ds.h conflict!
'd' F0-FF linux/digi1.h
'e' all linux/digi1.h conflict!
'f' 00-1F linux/ext2_fs.h conflict!
'f' 00-1F linux/ext3_fs.h conflict!
'f' 00-0F fs/jfs/jfs_dinode.h conflict!
'f' 00-0F fs/ext4/ext4.h conflict!
'f' 00-0F linux/fs.h conflict!
'f' 00-0F fs/ocfs2/ocfs2_fs.h conflict!
'f' 13-27 linux/fscrypt.h
'f' 81-8F linux/fsverity.h
'g' 00-0F linux/usb/gadgetfs.h
'g' 20-2F linux/usb/g_printer.h
'h' 00-7F conflict! Charon filesystem
<mailto:zapman@interlan.net>
'h' 00-1F linux/hpet.h conflict!
'h' 80-8F fs/hfsplus/ioctl.c
'i' 00-3F linux/i2o-dev.h conflict!
'i' 0B-1F linux/ipmi.h conflict!
'i' 80-8F linux/i8k.h
'i' 90-9F `linux/iio/*.h` IIO
'j' 00-3F linux/joystick.h
'k' 00-0F linux/spi/spidev.h conflict!
'k' 00-05 video/kyro.h conflict!
'k' 10-17 linux/hsi/hsi_char.h HSI character device
'l' 00-3F linux/tcfs_fs.h transparent cryptographic file system
<http://web.archive.org/web/%2A/http://mikonos.dia.unisa.it/tcfs>
'l' 40-7F linux/udf_fs_i.h in development:
<https://github.com/pali/udftools>
'm' 00-09 linux/mmtimer.h conflict!
'm' all linux/mtio.h conflict!
'm' all linux/soundcard.h conflict!
'm' all linux/synclink.h conflict!
'm' 00-19 drivers/message/fusion/mptctl.h conflict!
'm' 00 drivers/scsi/megaraid/megaraid_ioctl.h conflict!
'n' 00-7F linux/ncp_fs.h and fs/ncpfs/ioctl.c
'n' 80-8F uapi/linux/nilfs2_api.h NILFS2
'n' E0-FF linux/matroxfb.h matroxfb
'o' 00-1F fs/ocfs2/ocfs2_fs.h OCFS2
'o' 00-03 mtd/ubi-user.h conflict! (OCFS2 and UBI overlaps)
'o' 40-41 mtd/ubi-user.h UBI
'o' 01-A1 `linux/dvb/*.h` DVB
'p' 00-0F linux/phantom.h conflict! (OpenHaptics needs this)
'p' 00-1F linux/rtc.h conflict!
'p' 40-7F linux/nvram.h
'p' 80-9F linux/ppdev.h user-space parport
<mailto:tim@cyberelk.net>
'p' A1-A5 linux/pps.h LinuxPPS
'p' B1-B3 linux/pps_gen.h LinuxPPS
<mailto:giometti@linux.it>ioctl 할당표: 'q'부터 0xA5까지
291-350이 구간은 소문자 `'q'`부터 `'|'`, 그리고 0x80 이상 숫자 코드의 0xA5 범위까지입니다. 네트워크 사설 ioctl 범위, 파일 시스템, TEE, Surface 플랫폼 API가 포함됩니다.
CodeSeq# (hex)Include File설명
'q'00-1Flinux/serio.h
'q'80-FFlinux/telephony.hInternet PhoneJACK 및 Internet LineJACK
↳linux/ixjuser.h<http://web.archive.org/web/%2A/http://www.quicknet.net>
'r'00-1Flinux/msdos_fs.h and fs/fat/dir.c
's'alllinux/cdk.h
't'00-7Flinux/ppp-ioctl.h
't'80-8Flinux/isdn_ppp.h
't'90-91linux/toshiba.htoshiba 및 toshiba_acpi SMM
'u'00-1Flinux/smb_fs.h제거됨
'u'00-2Flinux/ublk_cmd.h충돌!
'u'20-3Flinux/uvcvideo.hUSB Video Class 호스트 드라이버
'u'40-4flinux/udmabuf.h사용자 공간 dma-buf misc 장치
'v'00-1Flinux/ext2_fs.h충돌!
'v'00-1Flinux/fs.h충돌!
'v'00-0Flinux/sonypi.h충돌!
'v'00-0Fmedia/v4l2-subdev.h충돌!
'v'20-27arch/powerpc/include/uapi/asm/vas-api.hVAS API
'v'C0-FFlinux/meye.h충돌!
'w'allCERN SCI driver
'y'00-1F패킷 기반 사용자 수준 통신
↳<mailto:zapman@interlan.net>
'z'00-3FCAN bus card conflict!
↳<mailto:hdstich@connectu.ulm.circular.de>
'z'40-7FCAN bus card conflict!
↳<mailto:oe@port.de>
'z'10-4Fdrivers/s390/crypto/zcrypt_api.h충돌!
'|'00-7Flinux/media.h
'|'80-9Fsamples/모든 샘플 및 예제 드라이버
0x8000-1Flinux/fb.h
0x8100-1Flinux/vduse.h
0x8900-06arch/x86/include/asm/sockios.h
0x890B-DFlinux/sockios.h
0x89E0-EFlinux/sockios.hSIOCPROTOPRIVATE 범위
0x89F0-FFlinux/sockios.hSIOCDEVPRIVATE 범위
0x8A00-1Flinux/eventpoll.h
0x8Balllinux/wireless.h
0x8C00-3FWiNRADiO 드라이버
↳<http://www.winradio.com.au/>
0x9000drivers/cdrom/sbpcd.h
0x9200-0Fdrivers/usb/mon/mon_bin.c
0x9360-7Flinux/auto_fs.h
0x94allfs/btrfs/ioctl.hBtrfs 파일 시스템
↳and linux/fs.h일부는 VFS/generic으로 이동
0x9700-7Ffs/ceph/ioctl.hCeph 파일 시스템
0x9900-0F537 애드인 보드 드라이버
↳<mailto:buk@buks.ipn.de>
0x9A00-0Finclude/uapi/fwctl/fwctl.h
0xA0alllinux/sdp/sdp.hIndustrial Device 프로젝트
↳<mailto:kenji@bitgate.com>
0xA10linux/vtpm_proxy.hTPM 에뮬레이터 프록시 드라이버
0xA2alluapi/linux/acrn.hACRN 하이퍼바이저
0xA380-8FPort ACL 개발 중:
↳<mailto:tlewis@mindspring.com>
0xA390-9Flinux/dtlk.h
0xA400-1Fuapi/linux/tee.h범용 TEE 서브시스템
0xA400-1Fuapi/asm/sgx.h<mailto:linux-sgx@vger.kernel.org>
0xA501-05linux/surface_aggregator/cdev.hMicrosoft Surface Platform System Aggregator
↳<mailto:luzmaximilian@gmail.com>
0xA520-2Flinux/surface_aggregator/dtx.hMicrosoft Surface DTX 드라이버
↳<mailto:luzmaximilian@gmail.com>
사설 네트워크 범위와 개발 중 범위도 기존 ABI 할당으로 취급합니다.
'q' 00-1F linux/serio.h
'q' 80-FF linux/telephony.h Internet PhoneJACK, Internet LineJACK
linux/ixjuser.h <http://web.archive.org/web/%2A/http://www.quicknet.net>
'r' 00-1F linux/msdos_fs.h and fs/fat/dir.c
's' all linux/cdk.h
't' 00-7F linux/ppp-ioctl.h
't' 80-8F linux/isdn_ppp.h
't' 90-91 linux/toshiba.h toshiba and toshiba_acpi SMM
'u' 00-1F linux/smb_fs.h gone
'u' 00-2F linux/ublk_cmd.h conflict!
'u' 20-3F linux/uvcvideo.h USB video class host driver
'u' 40-4f linux/udmabuf.h userspace dma-buf misc device
'v' 00-1F linux/ext2_fs.h conflict!
'v' 00-1F linux/fs.h conflict!
'v' 00-0F linux/sonypi.h conflict!
'v' 00-0F media/v4l2-subdev.h conflict!
'v' 20-27 arch/powerpc/include/uapi/asm/vas-api.h VAS API
'v' C0-FF linux/meye.h conflict!
'w' all CERN SCI driver
'y' 00-1F packet based user level communications
<mailto:zapman@interlan.net>
'z' 00-3F CAN bus card conflict!
<mailto:hdstich@connectu.ulm.circular.de>
'z' 40-7F CAN bus card conflict!
<mailto:oe@port.de>
'z' 10-4F drivers/s390/crypto/zcrypt_api.h conflict!
'|' 00-7F linux/media.h
'|' 80-9F samples/ Any sample and example drivers
0x80 00-1F linux/fb.h
0x81 00-1F linux/vduse.h
0x89 00-06 arch/x86/include/asm/sockios.h
0x89 0B-DF linux/sockios.h
0x89 E0-EF linux/sockios.h SIOCPROTOPRIVATE range
0x89 F0-FF linux/sockios.h SIOCDEVPRIVATE range
0x8A 00-1F linux/eventpoll.h
0x8B all linux/wireless.h
0x8C 00-3F WiNRADiO driver
<http://www.winradio.com.au/>
0x90 00 drivers/cdrom/sbpcd.h
0x92 00-0F drivers/usb/mon/mon_bin.c
0x93 60-7F linux/auto_fs.h
0x94 all fs/btrfs/ioctl.h Btrfs filesystem
and linux/fs.h some lifted to vfs/generic
0x97 00-7F fs/ceph/ioctl.h Ceph file system
0x99 00-0F 537-Addinboard driver
<mailto:buk@buks.ipn.de>
0x9A 00-0F include/uapi/fwctl/fwctl.h
0xA0 all linux/sdp/sdp.h Industrial Device Project
<mailto:kenji@bitgate.com>
0xA1 0 linux/vtpm_proxy.h TPM Emulator Proxy Driver
0xA2 all uapi/linux/acrn.h ACRN hypervisor
0xA3 80-8F Port ACL in development:
<mailto:tlewis@mindspring.com>
0xA3 90-9F linux/dtlk.h
0xA4 00-1F uapi/linux/tee.h Generic TEE subsystem
0xA4 00-1F uapi/asm/sgx.h <mailto:linux-sgx@vger.kernel.org>
0xA5 01-05 linux/surface_aggregator/cdev.h Microsoft Surface Platform System Aggregator
<mailto:luzmaximilian@gmail.com>
0xA5 20-2F linux/surface_aggregator/dtx.h Microsoft Surface DTX driver
<mailto:luzmaximilian@gmail.com>ioctl 할당표: 0xAA부터 0xFE까지
351-413마지막 구간은 0xAA부터 0xFE까지의 할당입니다. KVM, powerpc pseries API, GPIO·RPMsg·remoteproc, Hyper-V, CXL, userfaultfd, FUSE, 플랫폼 펌웨어와 시스템 관리 드라이버가 포함됩니다.
CodeSeq# (hex)Include File설명
0xAA00-3Flinux/uapi/linux/userfaultfd.h
0xAB00-1Flinux/nbd.h
0xAC00-1Flinux/raw.h
0xAD00Netfilter device 개발 중:
↳<mailto:rusty@rustcorp.com.au>
0xAE00-1Flinux/kvm.hKernel-based Virtual Machine(KVM)
↳<mailto:kvm@vger.kernel.org>
0xAE40-FFlinux/kvm.hKernel-based Virtual Machine(KVM)
↳<mailto:kvm@vger.kernel.org>
0xAE20-3Flinux/nitro_enclaves.hNitro Enclaves
0xAF00-1Flinux/fsl_hypervisor.hFreescale 하이퍼바이저
0xB0allRATIO devices 개발 중:
↳<mailto:vgo@ratio.de>
0xB100-1FPPPoX
↳<mailto:mostrows@styx.uwaterloo.ca>
0xB200arch/powerpc/include/uapi/asm/papr-vpd.hpowerpc/pseries VPD API
↳<mailto:linuxppc-dev@lists.ozlabs.org>
0xB201-02arch/powerpc/include/uapi/asm/papr-sysparm.hpowerpc/pseries 시스템 매개변수 API
↳<mailto:linuxppc-dev@lists.ozlabs.org>
0xB203-05arch/powerpc/include/uapi/asm/papr-indices.hpowerpc/pseries 인덱스 API
↳<mailto:linuxppc-dev@lists.ozlabs.org>
0xB206-07arch/powerpc/include/uapi/asm/papr-platform-dump.hpowerpc/pseries 플랫폼 덤프 API
↳<mailto:linuxppc-dev@lists.ozlabs.org>
0xB208arch/powerpc/include/uapi/asm/papr-physical-attestation.hpowerpc/pseries 물리적 증명 API
↳<mailto:linuxppc-dev@lists.ozlabs.org>
0xB209arch/powerpc/include/uapi/asm/papr-hvpipe.hpowerpc/pseries HVPIPE API
↳<mailto:linuxppc-dev@lists.ozlabs.org>
0xB300linux/mmc/ioctl.h
0xB400-0Flinux/gpio.h<mailto:linux-gpio@vger.kernel.org>
0xB500-0Fuapi/linux/rpmsg.h<mailto:linux-remoteproc@vger.kernel.org>
0xB6alllinux/fpga-dfl.h
0xB7alluapi/linux/remoteproc_cdev.h<mailto:linux-remoteproc@vger.kernel.org>
0xB7alluapi/linux/nsfs.h<mailto:Andrei Vagin <avagin@openvz.org>>
0xB801-02uapi/misc/mrvl_cn10k_dpi.hMarvell CN10K DPI 드라이버
0xB8alluapi/linux/mshv.hMicrosoft Hyper-V `/dev/mshv` 드라이버
↳<mailto:linux-hyperv@vger.kernel.org>
0xC000-0Flinux/usb/iowarrior.h
0xCA00-0Fuapi/misc/cxl.h6.15부터 제거됨
0xCA10-2Fuapi/misc/ocxl.h
0xCA80-BFuapi/scsi/cxlflash_ioctl.h6.15부터 제거됨
0xCB00-1FCBM serial IEC bus 개발 중:
↳<mailto:michael.klein@puffin.lb.shuttle.de>
0xCC00-0Fdrivers/misc/ibmvmc.hpseries VMC 드라이버
0xCD01linux/reiserfs_fs.h6.13부터 제거됨
0xCE01-02uapi/linux/cxl_mem.hCompute Express Link 메모리 장치
0xCF02fs/smb/client/cifs_ioctl.h
0xDB00-0Fdrivers/char/mwave/mwavepub.h
0xDD00-3FZFCP 장치 드라이버, `drivers/s390/scsi/` 참조
↳<mailto:aherrman@de.ibm.com>
0xE500-3Flinux/fuse.h
0xEC00-01drivers/platform/chrome/cros_ec_dev.hChromeOS EC 드라이버
0xEE00-09uapi/linux/pfrut.h플랫폼 펌웨어 런타임 업데이트 및 텔레메트리
0xF300-3Fdrivers/usb/misc/sisusbvga/sisusb.hsisfb(개발 중)
↳<mailto:thomas@winischhofer.net>
0xF6allLTTng Linux Trace Toolkit Next Generation
↳<mailto:mathieu.desnoyers@efficios.com>
0xF8allarch/x86/include/uapi/asm/amd_hsmp.hAMD HSMP EPYC 시스템 관리 인터페이스 드라이버
↳<mailto:nchatrad@amd.com>
0xF900-0Fuapi/misc/amd-apml.hAMD sideband 시스템 관리 인터페이스 드라이버
↳<mailto:naveenkrishna.chatradhi@amd.com>
0xFDalllinux/dm-ioctl.h
0xFEalllinux/isst_if.h
제거된 드라이버의 범위도 기존 사용자 공간 ABI와 충돌할 수 있으므로 표에 남겨 둡니다.
0xAA 00-3F linux/uapi/linux/userfaultfd.h
0xAB 00-1F linux/nbd.h
0xAC 00-1F linux/raw.h
0xAD 00 Netfilter device in development:
<mailto:rusty@rustcorp.com.au>
0xAE 00-1F linux/kvm.h Kernel-based Virtual Machine
<mailto:kvm@vger.kernel.org>
0xAE 40-FF linux/kvm.h Kernel-based Virtual Machine
<mailto:kvm@vger.kernel.org>
0xAE 20-3F linux/nitro_enclaves.h Nitro Enclaves
0xAF 00-1F linux/fsl_hypervisor.h Freescale hypervisor
0xB0 all RATIO devices in development:
<mailto:vgo@ratio.de>
0xB1 00-1F PPPoX
<mailto:mostrows@styx.uwaterloo.ca>
0xB2 00 arch/powerpc/include/uapi/asm/papr-vpd.h powerpc/pseries VPD API
<mailto:linuxppc-dev@lists.ozlabs.org>
0xB2 01-02 arch/powerpc/include/uapi/asm/papr-sysparm.h powerpc/pseries system parameter API
<mailto:linuxppc-dev@lists.ozlabs.org>
0xB2 03-05 arch/powerpc/include/uapi/asm/papr-indices.h powerpc/pseries indices API
<mailto:linuxppc-dev@lists.ozlabs.org>
0xB2 06-07 arch/powerpc/include/uapi/asm/papr-platform-dump.h powerpc/pseries Platform Dump API
<mailto:linuxppc-dev@lists.ozlabs.org>
0xB2 08 arch/powerpc/include/uapi/asm/papr-physical-attestation.h powerpc/pseries Physical Attestation API
<mailto:linuxppc-dev@lists.ozlabs.org>
0xB2 09 arch/powerpc/include/uapi/asm/papr-hvpipe.h powerpc/pseries HVPIPE API
<mailto:linuxppc-dev@lists.ozlabs.org>
0xB3 00 linux/mmc/ioctl.h
0xB4 00-0F linux/gpio.h <mailto:linux-gpio@vger.kernel.org>
0xB5 00-0F uapi/linux/rpmsg.h <mailto:linux-remoteproc@vger.kernel.org>
0xB6 all linux/fpga-dfl.h
0xB7 all uapi/linux/remoteproc_cdev.h <mailto:linux-remoteproc@vger.kernel.org>
0xB7 all uapi/linux/nsfs.h <mailto:Andrei Vagin <avagin@openvz.org>>
0xB8 01-02 uapi/misc/mrvl_cn10k_dpi.h Marvell CN10K DPI driver
0xB8 all uapi/linux/mshv.h Microsoft Hyper-V /dev/mshv driver
<mailto:linux-hyperv@vger.kernel.org>
0xC0 00-0F linux/usb/iowarrior.h
0xCA 00-0F uapi/misc/cxl.h Dead since 6.15
0xCA 10-2F uapi/misc/ocxl.h
0xCA 80-BF uapi/scsi/cxlflash_ioctl.h Dead since 6.15
0xCB 00-1F CBM serial IEC bus in development:
<mailto:michael.klein@puffin.lb.shuttle.de>
0xCC 00-0F drivers/misc/ibmvmc.h pseries VMC driver
0xCD 01 linux/reiserfs_fs.h Dead since 6.13
0xCE 01-02 uapi/linux/cxl_mem.h Compute Express Link Memory Devices
0xCF 02 fs/smb/client/cifs_ioctl.h
0xDB 00-0F drivers/char/mwave/mwavepub.h
0xDD 00-3F ZFCP device driver see drivers/s390/scsi/
<mailto:aherrman@de.ibm.com>
0xE5 00-3F linux/fuse.h
0xEC 00-01 drivers/platform/chrome/cros_ec_dev.h ChromeOS EC driver
0xEE 00-09 uapi/linux/pfrut.h Platform Firmware Runtime Update and Telemetry
0xF3 00-3F drivers/usb/misc/sisusbvga/sisusb.h sisfb (in development)
<mailto:thomas@winischhofer.net>
0xF6 all LTTng Linux Trace Toolkit Next Generation
<mailto:mathieu.desnoyers@efficios.com>
0xF8 all arch/x86/include/uapi/asm/amd_hsmp.h AMD HSMP EPYC system management interface driver
<mailto:nchatrad@amd.com>
0xF9 00-0F uapi/misc/amd-apml.h AMD side band system management interface driver
<mailto:naveenkrishna.chatradhi@amd.com>
0xFD all linux/dm-ioctl.h
0xFE all linux/isst_if.h
==== ===== ========================================================= ================================================================
요약·해설
ioctl-number.rst:1-413새 ioctl은 `<linux/ioctl.h>`의 `_IO` 계열 매크로로 정의하고, 전역 충돌을 피하도록 충분한 순번 공간이 있는 식별 블록을 등록해야 합니다.
세 번째 매크로 인자는 `sizeof(arg)`가 아니라 실제 데이터 형식이어야 합니다. 이 규칙은 오류 검출, strace 디코딩, 소스 검색과 공통 사용자 메모리 복사 코드를 가능하게 합니다.
한국어 전문 번역은 원문 413줄의 할당표 전체를 구조화해 Code, Seq#, include/source path, 충돌·폐기·개발 상태와 연락처를 보존합니다.