요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
============================================================
WDT Watchdog Timer Interfaces For The Linux Operating System
============================================================
Last Reviewed: 10/05/2007
Alan Cox <[email protected]>
- ICS WDT501-P
- ICS WDT501-P (no fan tachometer)
- ICS WDT500-P
All the interfaces provide /dev/watchdog, which when open must be written
to within a timeout or the machine will reboot. Each write delays the reboot
time another timeout. In the case of the software watchdog the ability to
reboot will depend on the state of the machines and interrupts. The hardware
boards physically pull the machine down off their own onboard timers and
will reboot from almost anything.
A second temperature monitoring interface is available on the WDT501P cards.
This provides /dev/temperature. This is the machine internal temperature in
degrees Fahrenheit. Each read returns a single byte giving the temperature.
The third interface logs kernel messages on additional alert events.
The ICS ISA-bus wdt card cannot be safely probed for. Instead you need to
pass IO address and IRQ boot parameters. E.g.::
wdt.io=0x240 wdt.irq=11
Other "wdt" driver parameters are:
=========== ======================================================
heartbeat Watchdog heartbeat in seconds (default 60)
nowayout Watchdog cannot be stopped once started (kernel
build parameter)
tachometer WDT501-P Fan Tachometer support (0=disable, default=0)
type WDT501-P Card type (500 or 501, default=500)
=========== ======================================================
Features
--------
================ ======= =======
WDT501P WDT500P
================ ======= =======
Reboot Timer X X
External Reboot X X
I/O Port Monitor o o
Temperature X o
Fan Speed X o
Power Under X o
Power Over X o
Overheat X o
================ ======= =======
The external event interfaces on the WDT boards are not currently supported.
Minor numbers are however allocated for it.
Example Watchdog Driver:
see samples/watchdog/watchdog-simple.c
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
지원하는 ICS 보드
1-12이 문서는 ICS WDT501-P, 팬 회전계가 없는 WDT501-P, WDT500-P 보드용 WDT watchdog 인터페이스를 설명합니다. 마지막 검토일은 2007년 10월 5일이며 작성자는 Alan Cox입니다.
문서가 다루는 ICS ISA watchdog 보드입니다.
============================================================
WDT Watchdog Timer Interfaces For The Linux Operating System
============================================================
Last Reviewed: 10/05/2007
Alan Cox <[email protected]>
- ICS WDT501-P
- ICS WDT501-P (no fan tachometer)
- ICS WDT500-P
장치 인터페이스
13-24모든 보드는 `/dev/watchdog`를 제공합니다. 이 장치를 연 뒤 timeout 안에 데이터를 써야 하며, 쓰지 않으면 시스템이 재부팅됩니다. 한 번 쓸 때마다 재부팅 시점이 timeout만큼 다시 늦춰집니다.
소프트웨어 watchdog이 실제로 재부팅할 수 있는지는 시스템과 interrupt 상태에 좌우됩니다. 반면 하드웨어 보드는 자체 timer로 시스템을 물리적으로 끌어내리므로 거의 어떤 고장 상태에서도 재부팅할 수 있습니다.
WDT501P에는 두 번째 인터페이스인 `/dev/temperature`가 있습니다. 읽을 때마다 시스템 내부 온도를 화씨로 나타내는 1바이트를 반환합니다. 세 번째 인터페이스는 추가 경보 이벤트를 kernel 메시지로 기록합니다.
All the interfaces provide /dev/watchdog, which when open must be written
to within a timeout or the machine will reboot. Each write delays the reboot
time another timeout. In the case of the software watchdog the ability to
reboot will depend on the state of the machines and interrupts. The hardware
boards physically pull the machine down off their own onboard timers and
will reboot from almost anything.
A second temperature monitoring interface is available on the WDT501P cards.
This provides /dev/temperature. This is the machine internal temperature in
degrees Fahrenheit. Each read returns a single byte giving the temperature.
The third interface logs kernel messages on additional alert events.부팅 매개변수와 드라이버 옵션
25-40ICS ISA 버스 WDT 카드는 안전하게 자동 탐색할 수 없습니다. 따라서 부팅할 때 I/O 주소와 IRQ를 `wdt.io=0x240 wdt.irq=11`처럼 명시해야 합니다.
`heartbeat`는 초 단위 ping 주기이며 기본값은 60입니다. `nowayout`은 시작한 watchdog을 멈출 수 없게 하는 kernel 빌드 옵션입니다. `tachometer`는 WDT501-P 팬 회전계 지원을 제어하고 기본값 0은 비활성화를 뜻합니다. `type`은 카드 종류 500 또는 501을 고르며 기본값은 500입니다.
ICS WDT 드라이버의 핵심 설정과 기본값입니다.
The ICS ISA-bus wdt card cannot be safely probed for. Instead you need to
pass IO address and IRQ boot parameters. E.g.::
wdt.io=0x240 wdt.irq=11
Other "wdt" driver parameters are:
=========== ======================================================
heartbeat Watchdog heartbeat in seconds (default 60)
nowayout Watchdog cannot be stopped once started (kernel
build parameter)
tachometer WDT501-P Fan Tachometer support (0=disable, default=0)
type WDT501-P Card type (500 or 501, default=500)
=========== ======================================================
WDT501P와 WDT500P 기능
41-58두 보드 모두 재부팅 timer와 외부 재부팅 기능을 제공합니다. I/O 포트 감시는 두 모델에서 선택 기능입니다. 온도, 팬 속도, 저전압, 과전압, 과열 감시는 WDT501P에서 제공되며 WDT500P에는 제공되지 않습니다.
WDT 보드의 외부 이벤트 인터페이스는 현재 지원되지 않지만, 이를 위한 minor number는 할당되어 있습니다.
원문의 `X`는 제공, `o`는 미제공 또는 선택 기능 표기를 그대로 해석해 정리했습니다.
Features
--------
================ ======= =======
WDT501P WDT500P
================ ======= =======
Reboot Timer X X
External Reboot X X
I/O Port Monitor o o
Temperature X o
Fan Speed X o
Power Under X o
Power Over X o
Overheat X o
================ ======= =======
The external event interfaces on the WDT boards are not currently supported.
Minor numbers are however allocated for it.예제 watchdog 드라이버
59-63간단한 watchdog 드라이버 구현 예제는 kernel source의 `samples/watchdog/watchdog-simple.c`에서 확인할 수 있습니다.
Example Watchdog Driver:
see samples/watchdog/watchdog-simple.c
요약·해설
wdt.rst:1-63ICS WDT501-P와 WDT500-P의 장치 인터페이스, 부팅 옵션, 지원 기능을 설명합니다.