요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
=======
Console
=======
.. contents:: :local:
Struct Console
==============
.. kernel-doc:: include/linux/console.h
:identifiers: console cons_flags
Internals
---------
.. kernel-doc:: include/linux/console.h
:identifiers: nbcon_state nbcon_prio nbcon_context nbcon_write_context
Struct Consw
============
.. kernel-doc:: include/linux/console.h
:identifiers: consw
Console functions
=================
.. kernel-doc:: include/linux/console.h
:identifiers: console_srcu_read_flags console_srcu_write_flags
console_is_registered for_each_console_srcu for_each_console
.. kernel-doc:: drivers/tty/vt/selection.c
:export:
.. kernel-doc:: drivers/tty/vt/vt.c
:export:
Internals
---------
.. kernel-doc:: drivers/tty/vt/selection.c
:internal:
.. kernel-doc:: drivers/tty/vt/vt.c
:internal:
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
`struct console`과 플래그
1-15이 문서는 Linux 콘솔 API의 kernel-doc 항목을 한 페이지에 모읍니다. 로컬 목차 다음에 `include/linux/console.h`에서 콘솔 객체와 상태 플래그를 설명하는 문서를 가져옵니다.
`console`은 개별 콘솔 드라이버를 나타내는 핵심 구조체이고, `cons_flags`는 콘솔의 등록 상태와 기능을 표현하는 플래그 집합입니다. 실제 필드와 플래그 정의는 지정된 헤더의 kernel-doc 주석이 생성 시점에 확장합니다.
.. SPDX-License-Identifier: GPL-2.0
=======
Console
=======
.. contents:: :local:
Struct Console
==============
.. kernel-doc:: include/linux/console.h
:identifiers: console cons_flags
Internals비차단 콘솔 내부 상태와 `struct consw`
16-27첫 번째 Internals 절은 비차단 콘솔(nbcon)의 상태, 우선순위, 실행 문맥, 쓰기 문맥을 설명하는 내부 kernel-doc 항목을 나열합니다. `nbcon_state`, `nbcon_prio`, `nbcon_context`, `nbcon_write_context`라는 식별자는 원문 그대로 유지됩니다.
이어지는 Struct Consw 절은 같은 헤더의 `consw` 문서를 포함합니다. 이 구조체는 가상 터미널 콘솔이 하위 콘솔 구현에 위임하는 연산 집합을 나타내므로, 콘솔 코어 구조체와 별도의 계약으로 다뤄집니다.
---------
.. kernel-doc:: include/linux/console.h
:identifiers: nbcon_state nbcon_prio nbcon_context nbcon_write_context
Struct Consw
============
.. kernel-doc:: include/linux/console.h
:identifiers: consw
Console functions콘솔 함수와 VT 공개·내부 API
28-45Console functions 절은 콘솔 목록을 SRCU 보호 아래 읽고 갱신하는 플래그 접근 함수와 등록·순회 도우미를 문서화합니다. 대상은 `console_srcu_read_flags`, `console_srcu_write_flags`, `console_is_registered`, `for_each_console_srcu`, `for_each_console`입니다.
그 뒤에는 `drivers/tty/vt/selection.c`와 `drivers/tty/vt/vt.c`의 exported kernel-doc 항목을 포함합니다. 마지막 Internals 절은 같은 두 소스 파일의 내부 항목도 별도로 포함하여 공개 API와 구현 내부 설명을 구분합니다.
헤더의 콘솔 목록 API와 VT 구현 파일의 공개·내부 kernel-doc을 차례로 결합합니다.
=================
.. kernel-doc:: include/linux/console.h
:identifiers: console_srcu_read_flags console_srcu_write_flags
console_is_registered for_each_console_srcu for_each_console
.. kernel-doc:: drivers/tty/vt/selection.c
:export:
.. kernel-doc:: drivers/tty/vt/vt.c
:export:
Internals
---------
.. kernel-doc:: drivers/tty/vt/selection.c
:internal:
.. kernel-doc:: drivers/tty/vt/vt.c
:internal:
요약·해설
console.rst:1-45이 페이지는 `include/linux/console.h`의 `console`, nbcon 내부 형식, `consw` 및 콘솔 목록 API를 연결하고, VT 선택·터미널 구현의 공개 함수와 내부 함수를 구분해 보여 줍니다.