Android源码——Logger日志系统

Android的Logger日志系统是基于内核中的Logger日志驱动程序实现的。

日志保存在内核空间中

缓冲区保存日志

 

分类方法：日志的类型  +   日志的输出量

 

日志类型：   main          sysytem       radio        events

 

以上四种日志分别通过以下四个设备文件来访问：

/dev/log/main

/dev/log/system

.../radio

.../events

 

Android系统在应用中提供了三个 Java接口，往Logger日志驱动程序中写入日志，分别对应main,  system,  event:

android.util.Log

android.util.Slog

android.util.EventLog

 

Logger日志驱动程序

 

基础数据结构

Logger主要用到了logger_entry     logger_log     logger_reader三个结构体。

 

struct logger_entry {

__u16 len; /* length of the payload */

__u16 hdr_size; /* sizeof(struct logger_entry_v2) */

__s32 pid; /* generating process's pid */

__s32 tid; /* generating process's tid */

__s32 sec; /* seconds since Epoch */

__s32 nsec; /* nanoseconds */

uid_t euid; /* effective UID of logger */

char msg[0]; /* the entry's payload */

};

------------------------------------------------------------------

struct logger_log {

 

unsigned char *buffer;  /* the ring buffer itself 保存内容*/

struct miscdevice misc; /* misc device representing the log 日志设备*/

wait_queue_head_t wq; /* wait queue for readers */

struct list_head readers; /* this log's readers */

struct mutex mutex; /* mutex protecting buffer */

size_t w_off; /* current write head offset */

size_t head; /* new readers start here */

size_t size;   /* size of the log */

}

-------------------------------------------------------------------------------------------------------

struct logger_reader {

struct logger_log *log; /* associated log */

struct list_head list; /* entry in logger_log's list */

size_t r_off; /* current read head offset */

bool r_all; /* reader can read all entries */

int r_ver; /* reader ABI version */

};

---

日志设备的初始化过程

     日志设备的初始化：

          入口函数：logger_init

日志设备的打开，读取， 写入， 分别对应：logger_open， logger_read， logger_aio_write.

 

 

初始化过程：

     注册日志设备     kernel/goldfish/drivers/staging/android/logger.c   init_log

     将日志设备注册到系统中：  init_log中调用misc_register函数

     在misc_register中调用device_create函数注册到系统中

     在设备的/dev目录下看到/dev/log/main,  .../events,  .../radio

 

---

日志设备文件的打开过程

日志驱动程序的读写之前，都需要先打开日志设备文件。日志设备文件的打开函数为looger_open：

kernel/goldfish/drivers/statging/android/logger.c  logger_open()

get_log_from_minor根据从设备号获取日志缓冲区

 

---

日志记录的读取过程

     进程调用read函数，从日志设备中读取日志记录

     logger_read被调用：

do_read_log_to_user: 

    /*

     * First, copy the header to userspace, using the version of

     * the header requested

     */

 

   /*

     * We read from the msg in two disjoint operations. First, we read from

     * the current msg head offset up to 'count' bytes or to the end of

     * the log, whichever comes first.

     */

 

   /*

     * Second, we read any remaining bytes, starting back at the head of

     * the log.

     */

 

---

运行时库层日志

 

 

write_to_log

      函数指针write_to_log第一次被调用的时候，便执行函数__write_to_log_init来初始化日志库liblog。

• 日志初始化过程(__write_to_log_init函数)：

1. 如果  write_to_log 指向__write_to_log_init

          执行打开日志设备文件/log/main,.../radio, .../events, .../system到相应的log-fds数组中。

          write_to_log指向__write_to_log_kernel

1. 如果main, radio, events日志设备文件其中一个没有打开成功

          关闭日志文件/log/main,.../radio, .../event，并将write_to_log指向__write_to_log_null

1. 如果system日志设备文件没有打开

          将system和main的日志记录全都写入到日志设备文件/dev/log/main中

 

• __write_to_log_kernel函数

          根据参数log_id在全局数组log_fds中找到对应的日志设备文件描述符，

          把日志记录写入到Logger日志驱动程序中

 

__write_to_log_null

     该函数什么也不做

 

 

__android_log_write

      默认情况下，日志记录类型为main。如果参数日志标签以“RIL”开头或HTC_RIL、AT、GSM、STK、CDMA、PHONE、SMS，日志类型则为radio。

 

__android_log_buf_write

     该函数的实现和__android_log_write类似，不过可以指定写入日志记录的类型。

 

__android_log_vprint     __android_log_print     __android_log_assert

这三个函数都是调用__android_log_write日志驱动程序写入日志记录的。

 

__android_log_bWrite     __android_log_btwrite

这两个函数写入的日志记录的类型为events。其中，函数__android_log_bwrite写入的日志记录的内容尅有由多个值组成，而后者只能写入一个值。

 

---

C/C++日志写入接口

logv logd logi logw loge用来写入类型为main的日志记录

slogv slogd slogi slogw sloge用来写入类型为system的日志记录

log_event_int     log_event_long     long_event_string用来写入类型为events的日志记录

 

---

Java日志写入接口

...