요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
==============================
2
Decoding an IOCTL Magic Number
3
==============================
5
To decode a hex IOCTL code:
7
Most architectures use this generic format, but check
8
include/ARCH/ioctl.h for specifics, e.g. powerpc
9
uses 3 bits to encode read/write and 13 bits for size.
11
====== ==================================
12
bits meaning
13
====== ==================================
14
31-30 00 - no parameters: uses _IO macro
15
10 - read: _IOR
16
01 - write: _IOW
17
11 - read/write: _IOWR
19
29-16 size of arguments
21
15-8 ascii character supposedly
22
unique to each driver
24
7-0 function #
25
====== ==================================
28
So for example 0x82187201 is a read with arg length of 0x218,
29
character 'r' function 1. Grepping the source reveals this is::
31
#define VFAT_IOCTL_READDIR_BOTH _IOR('r', 1, struct dirent [2])
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
16진수 IOCTL 코드 해석
1-3116진수 ioctl 코드를 해석할 때 대부분의 아키텍처는 아래의 일반 형식을 사용합니다. 다만 정확한 형식은 `include/ARCH/ioctl.h`를 확인해야 합니다. 예를 들어 powerpc는 읽기/쓰기를 3비트로, 크기를 13비트로 인코딩합니다.
비트의미
31-30: 00매개변수 없음, `_IO` 매크로
31-30: 10읽기, `_IOR`
31-30: 01쓰기, `_IOW`
31-30: 11읽기/쓰기, `_IOWR`
29-16인자 크기
15-8각 드라이버에 고유하다고 가정하는 ASCII 문자
7-0함수 번호
상위 비트부터 전송 방향, 인자 크기, 드라이버 magic 문자, 함수 번호를 담습니다.
예를 들어 `0x82187201`은 읽기 방향이고 인자 길이는 `0x218`, magic 문자는 `'r'`, 함수 번호는 1입니다. 소스에서 검색하면 다음 정의와 일치합니다.
#define VFAT_IOCTL_READDIR_BOTH _IOR('r', 1, struct dirent [2])include/ARCH/ioctl.h 확인→31-30 방향 비트 해석→29-16 인자 크기 추출→15-8 magic 문자 변환→7-0 함수 번호 추출→소스의 매크로 정의와 대조
아키텍처별 형식을 확인한 뒤 각 필드를 분리합니다.
==============================
Decoding an IOCTL Magic Number
==============================
To decode a hex IOCTL code:
Most architectures use this generic format, but check
include/ARCH/ioctl.h for specifics, e.g. powerpc
uses 3 bits to encode read/write and 13 bits for size.
====== ==================================
bits meaning
====== ==================================
31-30 00 - no parameters: uses _IO macro
10 - read: _IOR
01 - write: _IOW
11 - read/write: _IOWR
29-16 size of arguments
15-8 ascii character supposedly
unique to each driver
7-0 function #
====== ==================================
So for example 0x82187201 is a read with arg length of 0x218,
character 'r' function 1. Grepping the source reveals this is::
#define VFAT_IOCTL_READDIR_BOTH _IOR('r', 1, struct dirent [2])
요약·해설
ioctl-decoding.rst:1-31일반적인 32비트 ioctl 명령 값의 필드 배치를 설명하고, 아키텍처별 예외가 있으므로 해당 `ioctl.h`를 우선 확인하라고 안내합니다.
`0x82187201`을 `VFAT_IOCTL_READDIR_BOTH`로 찾아가는 예제로 방향·크기·문자·함수 번호 디코딩을 보여 줍니다.