萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux 驅動程式開發除錯技術指南:printk、Oops 訊息解讀、kgdb、ftrace 實戰

Linux 核心驅動程式開發無法像使用者空間程式用 GDB 單步除錯,需掌握 printk、Oops 訊息分析、kgdb 遠端除錯、ftrace 追蹤等核心技術。本文系統整理實戰除錯手法。

一、printk:最樸實也最常用的輸出手段

基本用法

printk(KERN_ALERT "wakeup by signal in process %d\n", current->pid);

printk 類似 printf,但可加日誌等級巨集 (無逗號分隔):

巨集等級用途
KERN_EMERG0系統不可用
KERN_ALERT1需立即處理
KERN_CRIT2嚴重錯誤
KERN_ERR3一般錯誤
KERN_WARNING4警告
KERN_NOTICE5正常但重要事件
KERN_INFO6資訊
KERN_DEBUG7除錯細節

控制台輸出閾值控制

cat /proc/sys/kernel/printk
# 輸出: 6 4 1 7
# 第1欄: 控制台輸出閾值 (優先級 <= 此值才輸出到主控台)
# 第2欄: 無指定等級時的預設等級
# 第3欄: 最小等級 (最高優先權)
# 第4欄: 開機時第1欄預設值

若看不到 printk 輸出,執行:echo 8 > /proc/sys/kernel/printk 提高閾值。

條件編譯開關除錯訊息 (最佳實踐)

#define MYDRV_DEBUG
#undef PDEBUG
#ifdef MYDRV_DEBUG
#ifdef __KERNEL__
#define PDEBUG(fmt, args...) printk(KERN_DEBUG "mydrv: " fmt, ##args)
#else
#define PDEBUG(fmt, args...) fprintf(stderr, fmt, ##args)
#endif
#else
#define PDEBUG(fmt, args...)
#endif

#undef PDEBUGG
#define PDEBUGG(fmt, args...)  // 正式版只需將 MYDRV_DEBUG 註解掉

開發時用 PDEBUG("value=%d\n", val),發布前註解 #define MYDRV_DEBUG 即可一次關閉所有除錯輸出。

二、解讀 Oops 訊息 (核心恐慌的輕量版)

觸發 Oops 範例:驅動 write 函數寫入記憶體位址 0 (*(int*)0 = 0)。

Unable to handle kernel NULL pointer dereference at virtual address 00000000
pgd = c3894000
[00000000] *pgd=33830031, *pte=00000000, *ppte=00000000
Internal error: Oops: 817 [#1] PREEMPT
Modules linked in: faulty scull
CPU: 0 Not tainted (2.6.22.6 #4)
PC is at faulty_write+0x10/0x18 [faulty]
LR is at vfs_write+0xc4/0x148
...
Stack: (0xc3871f44 to 0xc3872000)
1f40: c3871f74 c3871f54 c0088eb8 bf00608c ...
Backtrace:
[<bf00607c>] (faulty_write+0x0/0x18 [faulty]) from [<c0088eb8>] (vfs_write+0xc4/0x148)
[<c0088eb8>] (vfs_write+0x0/0x148) from [<c002c0e4>] (sys_write+0x4c/0x74)
[<c002c0e4>] (sys_write+0x0/0x74) from [<c002bf40>] (ret_fast_syscall+0x0/0x2c)
Code: e1a0c00d e92dd800 e24cb004 e3a00000 (e5800000)

關鍵欄位解讀

  1. 第 1 行:錯誤類型 (NULL pointer dereference) 與虛擬位址。
  2. 第 5 行:Oops 編號與 CPU 資訊。
  3. 第 6 行:已載入模組清單。
  4. 第 7-15 行:出錯指令位址 (PC)、連結暫存器 (LR)、各暫存器值 — 最關鍵定位程式碼位置。
  5. 第 16 行:當前進程名稱與 PID。
  6. 第 17-23 行:堆疊內容。
  7. 第 24-29 行:堆疊回溯 — 完整函數呼叫鏈 (需開啟 CONFIG_FRAME_POINTER)。
  8. 第 30 行:出錯指令及鄰近指令機器碼 (括號內為出錯指令)。

結合反組譯定位原始碼行號

arm-linux-objdump -D faulty.ko > faulty.dis
# 查找 faulty_write 標籤,計算 (PC - 函數起始位址) / 4 = 第 N 條指令

三、kgdb:核心級 GDB 遠端除錯

  • 需兩台機器:目標機 (被除錯) + 宿主機 (運行 GDB),透過串列埠/網路 (kgdboc/kgdbwait) 連接。
  • 核心編譯需開啟 CONFIG_KGDB、CONFIG_KGDB_SERIAL_CONSOLE。
  • 啟動參數:kgdbwait kgdboc=ttyS0,115200 讓核心啟動早期等待 GDB 連接。
  • 支援斷點、單步、檢查變數、堆疊回溯,功能完整但設定複雜,適合難以重現的死機/鎖死問題。

四、ftrace:核心內建追蹤框架 (無需重編譯)

  • 掛載 tracefs:mount -t tracefs nodev /sys/kernel/tracing
  • 關鍵檔案:
    available_tracers、current_tracer、set_ftrace_filter、set_ftrace_pid、trace、trace_pipe
  • 常用追蹤器:function (函數進出)、function_graph (呼叫圖)、irqsoff (關中斷延遲)、preemptoff (搶佔關閉延遲)。
  • 範例:追蹤 my_driver_write 執行時間:
    echo function_graph > current_tracer
    echo my_driver_write > set_ftrace_filter
    cat trace_pipe (即時輸出)

五、其他實用技巧

  • Magic SysRq:Alt+SysRq+t 顯示所有任務堆疊、Alt+SysRq+w 顯示阻塞任務。
  • /proc/kallsyms、/proc/modules:查詢核心符號表與模組資訊。
  • crash 工具:分析 vmcore (kdump 核心轉儲) 進行事後剖析。
  • 動態除錯:echo 'file my_driver.c +p' > /sys/kernel/debug/dynamic_debug/control 執行時開啟特定檔案 pr_debug 輸出。

總結建議

  1. 新驅動開發:大量使用 PDEBUG 條件編譯 printk,功能穩定後一次關閉。
  2. 遇到 Oops:先看 PC/LR/Backtrace 定位函數,再反組譯對應原始碼行。
  3. 效能/延遲問題:優先用 ftrace (function_graph/irqsoff) 非侵入式分析。
  4. 死機/硬鎖定:配置 kgdb 或 kdump 事後分析。
  5. 養成習慣:每次修改驅動碼後先 grep "printk" 確認無遺留除錯輸出再提交。
copyright © 萬盛學電腦網 all rights reserved