핵심 요약

워치독 타이머는 소프트웨어가 정해진 시간 안에 “살아 있다”는 신호(kick, ping)를 보내지 않으면 시스템을 리셋하는 하드웨어 타이머입니다. 프로그램이 멈추거나 무한 루프에 빠져도 사람 없이 시스템을 다시 살리는 것이 목적입니다.

한 줄 답: 일정 시간 안에 kick이 없으면 하드웨어가 시스템을 리셋하는 장치입니다.

워치독 타이머란 무엇이고, 왜 필요한가요?

한 줄 답: 소프트웨어가 “살아 있다”고 알리지 않으면 시스템을 리셋하는 하드웨어 회로이며, 사람이 없는 장치가 멈춤 상태에서 스스로 복구하도록 하기 위해 필요합니다.

Linux 커널 문서는 워치독 타이머(WDT)를 소프트웨어 오류가 생겼을 때 시스템을 리셋할 수 있는 하드웨어 회로라고 설명합니다. 사용자 공간의 데몬이 일정한 간격으로 /dev/watchdog를 통해 드라이버에 알려 주고, 이 알림이 끊기면 정해진 시간 뒤에 하드웨어가 시스템을 리셋합니다.

현장에 설치되어 사람이 직접 전원을 껐다 켤 수 없는 장치에서는 프로그램이 한 번 멈추면 장치가 계속 먹통 상태로 남습니다. 워치독은 이런 멈춤이나 무한 루프를 사람 없이 복구하기 위한 마지막 안전장치입니다.

워치독은 어떻게 동작하나요?

한 줄 답: 카운트다운이 진행되다가 kick을 받으면 초기화되고, kick이 끊겨 타임아웃이 지나면 리셋됩니다.

커널 문서는 워치독이 /dev/watchdog를 여는 순간부터 동작한다고 설명합니다. 정해진 시간(문서에서는 “timeout” 또는 “margin”이라고 부릅니다) 안에 핑을 보내지 않으면 시스템이 재부팅됩니다. 가장 단순한 핑은 장치에 아무 데이터나 쓰는 것입니다.

  1. 워치독이 시작되면 타이머가 카운트다운을 합니다.
  2. 소프트웨어가 timeout 안에 kick(ping)을 보내면 카운트다운이 처음부터 다시 시작됩니다.
  3. 프로그램이 멈춰 kick이 끊기면 카운트다운이 끝까지 진행됩니다.
  4. timeout이 만료되면 하드웨어가 시스템을 리셋합니다.

워치독 타임라인: 카운트다운 → kick으로 초기화 → kick이 끊기면 타임아웃 후 하드웨어 리셋

kick은 어디서 해야 하나요?

한 줄 답: 주요 작업이 정상인지 확인한 뒤에만 kick해야 하며, 조건 없이 kick하면 안 됩니다.

면접에서 자주 나오는 함정은 타이머 ISR 안에서 무조건 kick하는 구성입니다. 이렇게 하면 메인 루프가 멈춰도 타이머 인터럽트는 계속 동작하므로 kick이 계속 들어가고, 워치독이 영원히 작동하지 않습니다.

해결 방법은 각 태스크가 자신이 정상 동작했다는 “alive” 플래그를 세우고, 메인 루프가 모든 플래그를 확인한 뒤에만 kick하고 플래그를 지우는 것입니다. 하나라도 플래그가 서지 않으면 kick하지 않으므로 워치독이 시스템을 리셋합니다.

  • 잘못된 방식: 타이머 ISR에서 무조건 kick → 메인 루프가 멈춰도 계속 kick됩니다.
  • 올바른 방식: 각 태스크가 alive 플래그 설정 → 메인 루프가 전부 확인 → kick 후 플래그 초기화.

kick 위치: 타이머 ISR 무조건 kick(잘못된 방식) vs alive 플래그 확인 후 메인 루프에서 kick(올바른 방식)

Linux에서는 워치독을 어떻게 쓰나요?

한 줄 답: /dev/watchdog를 열어 시작하고, timeout 전에 write 또는 WDIOC_KEEPALIVE로 핑을 보내며, 종료할 때는 Magic Close로 닫습니다.

  • 시작과 핑: 장치를 열면 워치독이 시작됩니다. 아무 데이터나 write하는 것과 WDIOC_KEEPALIVE ioctl은 정확히 같은 동작입니다.
  • Magic Close: 장치를 닫으면 보통 워치독이 멈추지만, Magic Close를 지원하는 드라이버는 닫기 직전에 매직 문자 'V'를 쓴 경우에만 워치독을 끕니다. 그렇지 않으면 데몬이 죽었다고 보고 timeout 뒤에 시스템을 재부팅합니다.
  • NOWAYOUT: CONFIG_WATCHDOG_NOWAYOUT=Y(또는 nowayout 모듈 파라미터)이면 한 번 시작한 워치독을 끌 방법이 없습니다.
  • timeout 설정: WDIOC_SETTIMEOUT은 초 단위로 지정하며, 드라이버는 하드웨어 단위 때문에 요청과 다를 수 있는 실제 timeout 값을 돌려줍니다. 현재 값은 WDIOC_GETTIMEOUT으로 읽습니다.
  • Pretimeout: 일부 워치독은 리셋 전에 NMI/인터럽트를 발생시켜 Linux가 패닉 정보나 코어덤프를 기록하게 합니다. WDIOC_SETPRETIMEOUT은 timeout “이전”의 초 단위 값입니다. 커널 문서의 예시로는 timeout 60, pretimeout 10이면 50초 시점에 발생합니다. 모든 드라이버가 지원하지는 않습니다.
  • 리셋 원인 확인: WDIOC_GETBOOTSTATUS는 마지막 부팅 시점의 상태를 돌려주며, WDIOF_CARDRESET은 직전 재부팅이 워치독 때문이었음을 뜻합니다. 모든 장치가 지원하지는 않습니다.

커널 문서는 이 API가 ad hoc 성격이라 드라이버마다 일부만 구현한다고 밝힙니다. 즉 드라이버마다 지원 범위가 다르다는 점을 기억해야 합니다. 또한 문서 머리말은 Linux 2.4.18 시점의 상태를 설명하며 마지막 검토는 2007년이라고 적혀 있으므로, 실제 사용 전에 사용하는 커널과 드라이버를 확인해야 합니다.

아래는 문서 수준의 단순화한 예시입니다(실행하지 않았으며 출력은 없습니다).

int fd = open("/dev/watchdog", O_WRONLY);

while (1) {
    ioctl(fd, WDIOC_KEEPALIVE, 0);
    sleep(10);
}

/* 정상 종료 시: 닫기 직전에 매직 문자 'V'를 씁니다. */
write(fd, "V", 1);
close(fd);

systemd 서비스는 WatchdogSec=를 쓸 수 있으며, 이 경우 서비스가 sd_notify로 WATCHDOG=1 keep-alive를 보내야 합니다. 서비스 파일 키워드는 이전 글 「systemd Type= 정리|simple·exec·notify와 서비스 파일 핵심 키워드」를 참고해 주시기 바랍니다.

면접에서 자주 나오는 워치독 질문은 무엇인가요?

한 줄 답: 하드웨어와 소프트웨어 워치독의 차이, timeout 선택, 리셋 원인 확인, 디버깅 중 동작이 주로 나옵니다.

하드웨어 워치독과 소프트웨어 워치독은 무엇이 다른가요?

소프트웨어 워치독은 감시 대상과 같은 커널과 CPU 위에서 돌기 때문에 커널이나 CPU가 멈추면 함께 멈춥니다. 하드웨어 타이머는 독립적으로 카운트하므로 시스템이 완전히 멈춰도 리셋할 수 있습니다. 이는 일반적인 구조에 따른 설명입니다.

timeout은 어떻게 정하나요?

정해진 정답 숫자는 없습니다. 정상 상태에서 가장 오래 걸리는 루프나 부팅 경로보다 길어야 하고, 복구 요구 시간보다는 짧아야 합니다. 하드웨어가 허용하는 최대값도 확인해야 하며, WDIOC_SETTIMEOUT이 실제 적용된 값을 돌려준다는 점도 기억해야 합니다.

리셋 원인이 워치독인지 어떻게 확인하나요?

지원하는 장치라면 WDIOC_GETBOOTSTATUS로 마지막 부팅 상태를 읽고 WDIOF_CARDRESET 플래그를 확인합니다. 이 플래그가 있으면 마지막 재부팅이 워치독 때문이었다는 뜻입니다. 모든 장치가 지원하지는 않습니다.

디버깅 중에 워치독은 어떻게 되나요?

브레이크포인트에서 멈추면 kick도 멈추므로 예상하지 못한 리셋이 일어날 수 있습니다. 사용하는 시스템이 지원하는 방법으로 워치독을 끄거나 멈춰야 하지만, NOWAYOUT 설정에서는 끌 수 없습니다. gdb 사용법은 gdb 정리 글을 참고해 주시기 바랍니다.

pretimeout은 언제 유용한가요?

리셋 직전에 패닉 정보나 코어덤프를 남겨 원인을 추적할 수 있습니다. 다만 드라이버가 지원해야 사용할 수 있습니다.

함께 보면 좋은 글은 무엇인가요?

한 줄 답: 디버깅 중 워치독 동작은 gdb 글, 서비스 단위 워치독은 systemd 글이 이어집니다.

  • gdb 정리 글
  • systemd Type= 정리|simple·exec·notify와 서비스 파일 핵심 키워드

출처는 어디인가요?

한 줄 답: Linux 커널 워치독 API 문서와 systemd.service 매뉴얼 페이지를 참고했습니다.