一、前言

logcat 作为读取日志的工具，相当于client 的角色；在前两篇文章中，关于 logcat 如何与其他部分沟通获取日志信息的流程已经介绍的比较清晰，本文不在赘述，转而归纳一下 logcat 的一些常用指令，并对其中一些做详细分析

二、命令简介

三、日志缓冲区

Android 日志系统为日志消息保留了多个环形缓冲区，但并非多有的日志消息都会发送到默认的环形缓冲区。这里可以采用 logcat -b 命令查看设备的其他缓冲区：

如果需要查看内核空间日志信息，可采用如下几种方式查看：

1、读取 /proc/kmsg ，命令如下

adb shell cat /proc/kmsg

读取/proc/kmsg属于消费型读取，读取之后再次读取不会显示已经读取过的日志信息

2、读取 /dev/kmsg，命令如下

adb shell cat /dev/kmsg

读取/dev/kmsg会显示缓存区里面的所有日志信息。新写入的日志信息会不断累加到日志缓冲器中

3、使用 dmesg 命令读取

adb shell dmesg

dmesg命令读取一次只显示一部分日志,非阻塞执行

四、格式化输出

使用 -v 命令来修改 log 的输出格式，以显示特定的元数据字段：

优先级：

五、logcat -f 命令详解

logcat -f 命令可以将日志消息输出到指定的文件中。这里我们需要确定的一件事是 logcat 作为客户端的角色，会将通过 liblog 获得的日志信息进行格式解析、格式化处理，而 liblog 库本身并不存在保存、解析的功能。这里来对 -f 指令做一下解析：

logcat_main.cpp # main()
    ---> logcat.cpp # android_logcat_run_command()
        ---> __logcat()
            {
                ......

                case 'f':
                    if ((tail_time == log_time::EPOCH) && !tail_lines) {
                        tail_time = lastLogTime(optctx.optarg);
                    }
                    // redirect output to a file
                    context->outputFileName = optctx.optarg;   //注释 ①
                    break;

                ......


                setupOutputAndSchedulingPolicy()   //注释 ②

 
                 while (...) {   //注释 ③

                    int ret = android_logger_list_read(logger_list, &log_msg);
                    
                    if (context->printBinary) {
                        printBinary(context, &log_msg);
                    } else {
                        processBuffer(context, dev, &log_msg);
                    }

                ......

            }

5.1 注释① ：解析 -f 指令

          case 'f':
                  if ((tail_time == log_time::EPOCH) && !tail_lines) {
                        tail_time = lastLogTime(optctx.optarg);
                    }
                    // redirect output to a file
                    context->outputFileName = optctx.optarg;   //注释 ①
                    break;

在 _logcat() 函数中解析 -f 指令，设置日志输出文件。例如 logcat -f sdcard/log.txt ，则 context->outputFileName 赋值为 sdcard/log.txt；

5.2 注释② ：设置输出路径

static void setupOutputAndSchedulingPolicy(
    android_logcat_context_internal* context, bool blocking) {
    
    if (!context->outputFileName) return;

    ......
  
    // 打开文件获得 fd 
    context->output_fd = openLogFile(context->outputFileName);

    if (context->output_fd < 0) {
        logcat_panic(context, HELP_FALSE, "couldn't open output file");
        return;
    }

    ......
}

5.3 注释③ ：写入日志

               while (...) {   
                                // 调用 liblog 库中的 android_logger_list_read 函数获取日志 
                    int ret = android_logger_list_read(logger_list, &log_msg);
                    
                    if (context->printBinary) {       
                                    // 根据上面获取的文件 fd ,将日志消息写入文件
                        printBinary(context, &log_msg);
                    } else {
                        processBuffer(context, dev, &log_msg);
                    }

以 printBinary() 函数为例：

logcat.cpp # printBinary() :

void printBinary(android_logcat_context_internal* context, struct log_msg* buf) {
    size_t size = buf->len();

    TEMP_FAILURE_RETRY(write(context->output_fd, buf, size));
}

参考

[ 1 ] Android物语：logcat
[ 2 ] android调试——logcat详解
[ 3 ] 玩转Android10源码开发定制(12)内核篇之logcat输出内核日志