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函数):
- 如果 write_to_log 指向__write_to_log_init
执行打开日志设备文件/log/main,.../radio, .../events, .../system到相应的log-fds数组中。
write_to_log指向__write_to_log_kernel
- 如果main, radio, events日志设备文件其中一个没有打开成功
关闭日志文件/log/main,.../radio, .../event,并将write_to_log指向__write_to_log_null
- 如果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日志写入接口
...