요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
.. c:namespace:: V4L
4
.. _VIDIOC_LOG_STATUS:
6
***********************
7
ioctl VIDIOC_LOG_STATUS
8
***********************
10
Name
11
====
13
VIDIOC_LOG_STATUS - Log driver status information
15
Synopsis
16
========
18
.. c:macro:: VIDIOC_LOG_STATUS
20
``int ioctl(int fd, VIDIOC_LOG_STATUS)``
22
Arguments
23
=========
25
``fd``
26
File descriptor returned by :c:func:`open()`.
28
Description
29
===========
31
As the video/audio devices become more complicated it becomes harder to
32
debug problems. When this ioctl is called the driver will output the
33
current device status to the kernel log. This is particular useful when
34
dealing with problems like no sound, no video and incorrectly tuned
35
channels. Also many modern devices autodetect video and audio standards
36
and this ioctl will report what the device thinks what the standard is.
37
Mismatches may give an indication where the problem is.
39
This ioctl is optional and not all drivers support it. It was introduced
40
in Linux 2.6.15.
42
Return Value
43
============
45
On success 0 is returned, on error -1 and the ``errno`` variable is set
46
appropriately. The generic error codes are described at the
47
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
목적과 호출 형식
1-24`VIDIOC_LOG_STATUS`는 인자 없이 현재 video/audio 장치 상태를 kernel log에 기록하도록 드라이버에 요청합니다. `fd`는 `open()`이 반환한 파일 디스크립터입니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: V4L
.. _VIDIOC_LOG_STATUS:
***********************
ioctl VIDIOC_LOG_STATUS
***********************
Name
====
VIDIOC_LOG_STATUS - Log driver status information
Synopsis
========
.. c:macro:: VIDIOC_LOG_STATUS
``int ioctl(int fd, VIDIOC_LOG_STATUS)``
Arguments
=========
진단 정보와 지원 범위
25-38복잡한 video/audio 장치에서 무음, 영상 없음, 잘못 조정된 채널 같은 문제를 진단할 때 사용합니다. 호출 시 드라이버가 현재 상태를 kernel log에 출력합니다.
현대 장치는 영상·오디오 표준을 자동 감지하는 경우가 많습니다. 이 ioctl은 장치가 인식한 표준도 보고하며, 애플리케이션의 예상값과 실제 인식값이 다르면 문제 위치를 추정하는 단서가 됩니다.
이 ioctl은 선택 사항이라 모든 드라이버가 지원하지는 않습니다. Linux 2.6.15에서 도입되었습니다.
``fd``
File descriptor returned by :c:func:`open()`.
Description
===========
As the video/audio devices become more complicated it becomes harder to
debug problems. When this ioctl is called the driver will output the
current device status to the kernel log. This is particular useful when
dealing with problems like no sound, no video and incorrectly tuned
channels. Also many modern devices autodetect video and audio standards
and this ioctl will report what the device thinks what the standard is.
Mismatches may give an indication where the problem is.
반환값
39-47성공하면 0을 반환합니다. 오류 시 -1을 반환하고 `errno`를 설정하며, 적용 가능한 오류는 Generic Error Codes 절을 따릅니다.
This ioctl is optional and not all drivers support it. It was introduced
in Linux 2.6.15.
Return Value
============
On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
요약·해설
vidioc-log-status.rst:1-47진단 출력은 애플리케이션 데이터가 아니라 kernel log에서 확인하며, 드라이버별 선택 기능입니다.