요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
.. _GPIO_GET_CHIPINFO_IOCTL:
5
***********************
6
GPIO_GET_CHIPINFO_IOCTL
7
***********************
9
Name
10
====
12
GPIO_GET_CHIPINFO_IOCTL - Get the publicly available information for a chip.
14
Synopsis
15
========
17
.. c:macro:: GPIO_GET_CHIPINFO_IOCTL
19
``int ioctl(int chip_fd, GPIO_GET_CHIPINFO_IOCTL, struct gpiochip_info *info)``
21
Arguments
22
=========
24
``chip_fd``
25
The file descriptor of the GPIO character device returned by `open()`.
27
``info``
28
The :c:type:`chip_info<gpiochip_info>` to be populated.
30
Description
31
===========
33
Gets the publicly available information for a particular GPIO chip.
35
Return Value
36
============
38
On success 0 and ``info`` is populated with the chip info.
40
On error -1 and the ``errno`` variable is set appropriately.
41
Common error codes are described in error-codes.rst.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
이름과 호출 형식
1-20`GPIO_GET_CHIPINFO_IOCTL`은 한 GPIO chip에 관해 공개 가능한 정보를 가져옵니다. C 호출 형식은 `int ioctl(int chip_fd, GPIO_GET_CHIPINFO_IOCTL, struct gpiochip_info *info)`입니다.
항목설명
파일 디스크립터chip_fd
요청GPIO_GET_CHIPINFO_IOCTL
출력struct gpiochip_info *info
Chip 파일 디스크립터와 출력 구조체 pointer를 전달합니다.
.. SPDX-License-Identifier: GPL-2.0
.. _GPIO_GET_CHIPINFO_IOCTL:
***********************
GPIO_GET_CHIPINFO_IOCTL
***********************
Name
====
GPIO_GET_CHIPINFO_IOCTL - Get the publicly available information for a chip.
Synopsis
========
.. c:macro:: GPIO_GET_CHIPINFO_IOCTL
``int ioctl(int chip_fd, GPIO_GET_CHIPINFO_IOCTL, struct gpiochip_info *info)``
인자, 동작, 반환값
21-41`chip_fd`는 GPIO character device를 `open()`해 얻은 file descriptor입니다. `info`는 kernel이 채울 `gpiochip_info` 구조체입니다.
호출은 지정한 GPIO chip의 공개 정보를 조회합니다. 성공하면 0을 반환하고 `info`를 chip 정보로 채웁니다. 실패하면 -1을 반환하고 `errno`를 알맞게 설정합니다. 공통 오류 코드는 `error-codes.rst`에 설명되어 있습니다.
GPIO character device open→chip_fd 획득→gpiochip_info 저장 공간 준비→GPIO_GET_CHIPINFO_IOCTL 호출→성공 시 info 채움 또는 실패 시 errno 설정
입력 file descriptor에서 chip 정보를 읽어 사용자 구조체로 반환합니다.
Arguments
=========
``chip_fd``
The file descriptor of the GPIO character device returned by `open()`.
``info``
The :c:type:`chip_info<gpiochip_info>` to be populated.
Description
===========
Gets the publicly available information for a particular GPIO chip.
Return Value
============
On success 0 and ``info`` is populated with the chip info.
On error -1 and the ``errno`` variable is set appropriately.
Common error codes are described in error-codes.rst.
요약·해설
gpio-get-chipinfo-ioctl.rst:1-41GPIO chip의 공개 정보를 gpiochip_info로 조회하는 ioctl의 인자와 반환 규약을 설명합니다.
원문의 ioctl prototype, struct, flag, errno, source path와 줄 좌표를 보존해 전문 번역했습니다.