使用GDK7调试Linux内核之printk函数

1. 环境搭建

1.1 Ubuntu操作系统的GDK7连接网络的过程记录

在USB接口上插入Mercury的无线网卡。

Windows中可直接运行网卡驱动，在等待网卡驱动安装完成以后就可以连接WiFi了。
初始的Ubuntu中由于没有Wine，故无法直接运行.exe应用程序；同时通过在终端输入ifconfig命令时提示安装net-tools，于是可以发现Ubuntu是非常“干净”的？

进入设置=>进入WiFi面板=>显示未发现WiFi适配器=>在终端输入lsusb，发现USB无线网卡设备可以被识别出来=>没有安装网卡驱动=>无法连接WiFi =>尝试使用其他方法连接网络来安装网卡驱动。
尝试给GDK7连接网络。

让GDK7通过网线与路由器连接，从而连接网络=>实际可行但我这不行=>否掉此方案。
手机开启个人热点并开启USB网络共享，然后通过数据线与GDK7连接，从而连接网络=>可以但涉及下载及更新，比较耗费流量=>选择此方案。

通过手机热点及数据线如愿的让Ubuntu连接上了网络。
进入清华大学开源软件镜像站=>点击Ubuntu旁边的问号进入Ubuntu镜像使用帮助页面=>选择合适的Ubuntu版本（GDK7自带的Ubuntu版本默认是18.04.1LTS）=>复制文本内容。

或通过下方链接直接进入Ubuntu镜像使用帮助页面。

https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/

打开终端=>输入cd /etc/apt，进入apt文件夹=>输入ls，查看apt文件夹下的文件=>输入sudo gedit sources.list，修改软件源配置文件=>将文件中原本的文本替换成第5步中复制的文本=>保存并退出=>输入sudo apt-get update，更新本地软件源列表=>输入sudo apt-get upgrade更新已安装的软件至新版本（中途需要按Y），软件更新的版本取决于本地软件源的情况。

由于更新所以我的Linux内核版本从5.0.0-23升级到了5.3.0-62。

从下方链接进入水星网络的官方网站后，找到合适的驱动下载并安装。

https://www.mercurycom.com.cn/
成功连接WiFi。

1.2 准备符号文件（GDK7端操作）

根据http://advdbg.org/blogs/advdbg_system/articles/7147.aspx（参考文献中的2）下载Linux的符号文件。

若出现仓库“……”没有Release文件的情况则在ddebs.list中注释/删除对应的仓库内容。
Linux的内核符号文件默认下载在/usr/lib/debug/boot目录下。
Linux其他的符号文件默认下载在/usr/lib/debug/modules目录下。

将Linux的内核符号文件复制到调试主机下；文件在调试主机内的位置无要求。

1.3 准备Linux内核源码（GDK7端操作）

打开终端=>输入uname -a，来查看当前系统的Linux内核版本。
下载并安装对应内核版本的Linux内核源代码。

选择合适的镜像源，修改软件源配置文件/etc/apt/sources.list并保存。
sudo apt-get update // 更新。
apt search linux-source // 查找对应内核版本的的Linux内核源代码。
sudo apt install linux-source-x.x.x // 安装Linux内核源代码。
cd /usr/src/linux-source-x.x.x // 找到Linux内核源代码包linux-source-x.x.x.tar.bz2。

将Linux内核源代码包复制到调试主机下，文件在调试主机内的位置无要求。

2. printk函数的分析

2.1 printk函数的介绍

printk函数是专供内核程序实现打印功能的函数（内核态模式下实现打印功能），显然printk函数只能在内核代码中使用；printk函数主要的作用是将信息记录到日志中及对外打印信息；Linux系统日志架构的说明见图2.1。

2.2 printk函数与printf函数

假如你熟悉C语言那么你一定对printf函数非常的熟悉，printk函数与printf函数不能说一模一样，只能说非常相似=>print kernel(内核)与print format(格式化)，两个函数同属于print这一个大家族。

printk函数在内核态模式下实现打印功能；printf在用户态下实现打印功能。
CPU运行时所处的特权级为内核级0级时，使用者才可调用printk；CPU运行时所处的特权级为应用级3级时，使用者才可调用printf。
printk函数可控制打印的信息是否出现在终端上，只有当日志级别小于控制台级别时，printk函数打印的信息才会在终端上显示。

print 家族的简单说明

print类函数的家族成员：
- printB/vprintB
- sprintB/vsprintB
- fprintB/vfprintB
print类函数的标准格式：AprintB

A：大概可分为空/s/f/v=>
- 空：默认情况；代表向标准化设备（如显示器）输出打印的信息。
- s：全称为string；代表向字符串缓冲区输出打印的信息。
- f：全称为file；代表输出打印的信息。
- v：全称为va_arg；意思是接受va_list参数，将可变参数函数的格式调用变为接受可变参数的固定参数函数的格式调用。
B：k/f=>全称为kernel(内核)/format(格式化)。

2.3 printk函数赏析

printk函数的原型：

asmlinkage __visible int printk(const char *fmt, ...)

{

       printk_func_t vprintk_func;

       va_list args;

       int r;

       va_start(args, fmt);


       /*

        * If a caller overrides the per_cpu printk_func, then it needs

        * to disable preemption when calling printk(). Otherwise

        * the printk_func should be set to the default. No need to

        * disable preemption here.

        */

       vprintk_func = this_cpu_read(printk_func);

       r = vprintk_func(fmt, args);

       va_end(args);


       return r;

}

示例赏析：

vprintk_emit (facility=0, level=-1, dict=0x0, dictlen=0,

fmt=0xc18b0fa2 "\001\066brd: module loaded\n", args=0xe644bee4 "")

Facility = 0 代表信息源自内核
Level = -1, 是来自printk的调用时，指定的默认日志级别，vprintk_emit函数内部会尝试从fmt参数中提取level值

日志级别（共8个级别）=> /include/linux/kernel.h：

#defineKERN_EMERG”<0>” /紧急事件消息；系统崩溃之前提示，表示系统不可用/

#defineKERN_ALERT”<1>” /报告消息；表示必须立即采取措施/

#defineKERN_CRIT”<2>” /临界条件；一般涉及严重的硬件或软件操作失败/

#defineKERN_ERR”<3>” /错误条件；驱动程序常用KERN_ERR来报告硬件的错误/

#defineKERN_WARNING”<4>” /警告条件；对可能出现问题的情况进行警告/

#defineKERN_NOTICE”<5>” /正常且重要的条件；常用于与安全相关的消息/

#defineKERN_INFO”<6>” /提示信息；如驱动程序启动时，打印硬件信息/

#defineKERN_DEBUG”<7>” /调试级别的消息/

消息头结构：

struct printk_log {

       u64 ts_nsec;          /*时间戳（纳秒）*/

       u16 len;                /* 全部记录的长度 */

       u16 text_len;          /*文本缓存区的长度*/

       u16 dict_len;          /* 字典缓冲区的长度 */

       u8 facility;             /* 系统日志的来源*/

       u8 flags:5;             /* 内部记录 */

       u8 level:3;             /*系统日志的级别 */

};

cat /proc/sys/kernel/printk=>4 4 1 7

左数第1个数字4称为控制台日志级别。此数值决定打印到控制台的任何消息的最低优先级；优先级越低，日志级别的数字越高。
左数第2个数字4决定了不维持特定日志级别的所有消息的默认日志级别。
数字1 决定了整个控制台日志级别中最低日志级别的配置。
数字7决定了整个控制台日志级别的默认值。

1) 控制台日志级别，级别更高（0-3）的才显示在控制台.

2) 默认的消息日志级别（ KERN_WARNING ），调用printk时没有指定日志级别时会使用这个值

3) 控制台日记级别的允许最小值，dmesg –n 0会失败

4) 默认的控制台日志级别，即第一项的默认值

Facility：

LOG_AUTH             security/authorization    messages    (DEPRECATED    Use

LOG_AUTHPRIV instead)

LOG_AUTHPRIV         security/authorization messages (private)

LOG_CRON            clock daemon (cron and at)

LOG_DAEMON         system daemons without separate facility value

LOG_FTP                ftp daemon

LOG_KERN              kernel messages (these can't be generated from user pro‐cesses)

LOG_LOCAL0 through LOG_LOCAL7

                    reserved for local use

LOG_LPR                line printer subsystem

LOG_MAIL              mail subsystem

LOG_NEWS             USENET news subsystem

LOG_SYSLOG           messages generated internally by syslogd(8)

LOG_USER (default)

                      generic user-level messages

LOG_UUCP             UUCP subsystem

改变控制台日志级别的方法：

启动时Kernel boot option：loglevel=level
运行时Runtime: dmesg -n level

（注意：demsg -n level 改变的是console上的loglevel，dmesg命令仍然会打印出所有级别的系统信息。）

运行时Runtime: echo $level > /proc/sys/kernel/printk
运行时Runtime:写程序使用syslog系统调用（可以man syslog）

#include <unistd.h>

#include <sys/syscall.h>

static inline int syslog(int type, char *bufp, int len)

{

       return syscall(SYS_syslog, type, bufp, len);

}

int main()

{

/* Set the console loglevel to 4 */

syslog(8, 0, 4);

return 0;

}

3. 调试过程

3.1 中断Ubuntu

打开Nano Code并登录=>打开Nano调试并点击左侧栏中的 [糖果]（鼠标放上去会提示Nano Debgguer）=>点击 [内核调试] =》点击 [USB3] => 点击[DCI Open] =>点击 [Reconnect] 、[Linux Kernel] 、 [Memory Shadow] => 点击[启动] ；Linux内核调试时应选择的选项详见图3.1。