分析安卓的Logger機制
一、概述
Logger機制是在Android系統中提供的一個輕量級的日誌系統,這個日誌系統是以驅動程序的形式在內核空間實現的,在用戶空間分別提供了Java接口和C/C++接口來使用這個日誌系統,使用的接口取決於編寫的是Android應用程序還是系統組件。
下面我準備從應用開發和源碼分析兩部分來分析安卓的Logger機制。
二、從Android應用程序開發角度看Logger機制
這一部分將簡要地介紹一下在Android應用程序開發中Log的使用方法
2.1概述
在程序開發過程中,LOG是廣泛使用的用來記錄程序執行過程的機制,它既可以用於程序調試,也可以用於產品運營中的事件記錄。
在Android系統中,提供了簡單、便利的LOG機制,開發人員可以方便地使用。下面我將介紹在Android內核空間和用戶空間中LOG的使用和查看方法。
2.2內核開發時LOG的使用
Android內核是基於Linux Kernel 2.36的,因此,Linux Kernel的LOG機制同樣適合於Android內核,這就是與C語言的printf齊名的printk。與printf類似,printk提供格式化輸入功能,同時,它也具有所有LOG機制的特點——提供日誌級別過慮功能。
printk提供了8種日誌級別(<linux/kernel.h>):
#define KERN_EMERG "<0>" /* system is unusable */ #define KERN_ALERT "<1>" /* action must be taken immediately */ #define KERN_CRIT "<2>" /* critical conditions */ #deinfe KERN_ERR "<3>" /* error conditions */ #deinfe KERN_WARNING "<4>" /* warning conditions */ #deinfe KERN_NOTICE "<5>" /* normal but significant condition */ #deinfe KERN_INFO "<6>" /* informational */ #deinfe KERN_DEBUG "<7>" /* debug-level messages */
|
printk的使用方法:
//KERN_ALERT表示日誌級別,後面緊跟着格式化字符串。
printk(KERN_ALERT"This is the log printed by printk in linux kernel space.");
|
在Android系統中,printk輸出的日誌信息保存在/proc/kmsg中,要查看/proc/kmsg的內容,需要在後臺中運行模擬器:
USER-NAME@MACHINE-NAME:~/Android$ emulator &
啓動adb shell工具:
USER-NAME@MACHINE-NAME:~/Android$ adb shell
查看/proc/kmsg文件:
root@android:/# cat /proc/kmsg
2.3用戶空間程序開發時LOG的使用
Android系統在用戶空間中提供了輕量級的logger日誌系統,它是在內核中實現的一種設備驅動,與用戶空間的logcat工具配合使用能夠方便地跟蹤調試程序。在Android系統中,分別爲C/C++和Java語言提供兩種不同的logger訪問接口。
C/C++日誌接口一般是在編寫硬件抽象層模塊或者編寫JNI方法時使用,而Java接口一般是在應用層編寫APP時使用。
2.31 C/C++日誌接口
Android系統中的C/C++日誌接口是通過宏來使用的。
在system/core/include/android/log.h定義了日誌的級別:
/* * Android log priority values, in ascending priority order. */ typedefenum android_LogPriority{ ANDROID_LOG_UNKNOWN =0, ANDROID_LOG_DEFAULT, /* only for SetMinPriority() */ ANDROID_LOG_VERBOSE, ANDROID_LOG_DEBUG, ANDROID_LOG_INFO, ANDROID_LOG_WARN, ANDROID_LOG_ERROR, ANDROID_LOG_FATAL, ANDROID_LOG_SILENT,/* only for SetMinPriority(); must be last */ } android_LogPriority;
|
在system/core/include/cutils/log.h中,定義了對應的宏。
如對應於ANDROID_LOG_VERBOSE的宏LOGV:
/* * This is the local tag used for the following simplified * logging macros. You can change this preprocessor definition * before using the other macros to change the tag. */ #ifndef LOG_TAG #define LOG_TAG NULL #endif
/* * Simplified macro to send a verbose log message using the current LOG_TAG. */ #ifndef LOGV #if LOG_NDEBUG #define LOGV(...) ((void)0) #else #define LOGV(...) ((void)LOG(LOG_VERBOSE, LOG_TAG, __VA_ARGS__)) #endif #endif
/* * Basic log message macro. * * Example: * LOG(LOG_WARN, NULL, "Failed with error %d", errno); * * The second argument may be NULL or "" to indicate the "global" tag. */ #ifndef LOG #define LOG(priority, tag, ...) \ LOG_PRI(ANDROID_##priority, tag, __VA_ARGS__) #endif
/* * Log macro that allows you to specify a number for priority. */ #ifndef LOG_PRI #define LOG_PRI(priority, tag, ...) \ android_printLog(priority, tag, __VA_ARGS__) #endif
/* * ================================================================ * * The stuff in the rest of this file should not be used directly. */ #define android_printLog(prio, tag, fmt...) \ __android_log_print(prio, tag, fmt)
|
因此,如果要使用C/C++日誌接口,只要定義自己的LOG_TAG宏和包含頭文件system/core/include/cutils/log.h就可以了:
#define LOG_TAG "MY LOG TAG"
#include <cutils/log.h>
例如使用LOGV:
LOGV("This is the log printed by LOGV in androiduser space.");
2.32 JAVA日誌接口
Android系統在Frameworks層中定義了Log接口(frameworks/base/core/java/android/util/Log.java):
................................................
publicfinalclass Log{
................................................
/** * Priority constant for the println method; use Log.v. */ publicstaticfinalint VERBOSE=2;
/** * Priority constant for the println method; use Log.d. */ publicstaticfinalint DEBUG=3;
/** * Priority constant for the println method; use Log.i. */ publicstaticfinalint INFO=4;
/** * Priority constant for the println method; use Log.w. */ publicstaticfinalint WARN=5;
/** * Priority constant for the println method; use Log.e. */ publicstaticfinalint ERROR=6;
/** * Priority constant for the println method. */ publicstaticfinalint ASSERT=7;
.....................................................
publicstaticint v(String tag, String msg){ return println_native(LOG_ID_MAIN, VERBOSE, tag, msg); }
publicstaticint v(String tag, String msg, Throwable tr){ return println_native(LOG_ID_MAIN, VERBOSE, tag, msg +'\n'+ getStackTraceString(tr)); }
publicstaticint d(String tag, String msg){ return println_native(LOG_ID_MAIN, DEBUG, tag, msg); }
publicstaticint d(String tag, String msg, Throwable tr){ return println_native(LOG_ID_MAIN, DEBUG, tag, msg +'\n'+ getStackTraceString(tr)); }
publicstaticint i(String tag, String msg){ return println_native(LOG_ID_MAIN, INFO, tag, msg); }
publicstaticint i(String tag, String msg, Throwable tr){ return println_native(LOG_ID_MAIN, INFO, tag, msg +'\n'+ getStackTraceString(tr)); }
publicstaticint w(String tag, String msg){ return println_native(LOG_ID_MAIN, WARN, tag, msg); }
publicstaticint w(String tag, String msg, Throwable tr){ return println_native(LOG_ID_MAIN, WARN, tag, msg +'\n'+ getStackTraceString(tr)); }
publicstaticint w(String tag, Throwable tr){ return println_native(LOG_ID_MAIN, WARN, tag, getStackTraceString(tr)); }
publicstaticint e(String tag, String msg){ return println_native(LOG_ID_MAIN, ERROR, tag, msg); }
publicstaticint e(String tag, String msg, Throwable tr){ return println_native(LOG_ID_MAIN, ERROR, tag, msg +'\n'+ getStackTraceString(tr)); }
..................................................................
/**@hide */publicstaticnativeint println_native(int bufID, int priority, String tag, String msg); }
|
因此,如果要使用Java日誌接口,只要在類中定義的LOG_TAG常量和引用android.util.Log就可以了:
private static final String LOG_TAG ="MY_LOG_TAG";
Log.i(LOG_TAG, "This is the log printed by Log.i inandroid user space.");
Log.e(LOG_TAG, "This is the logprinted by Log.e in android user space.");
要查看這些LOG的輸出,可以配合logcat工具。如果是在Eclipse環境(ADT)下運行,直接在Eclipse就可以查看了:
如果是在自己編譯的Android源代碼工程中使用,則在後臺中運行模擬器:
USER-NAME@MACHINE-NAME:~/Android$ emulator &
啓動adb shell工具:
USER-NAME@MACHINE-NAME:~/Android$ adb shell
使用logcat命令查看日誌:
root@android:/ # logcat
這樣就可以看到輸出的日誌了。
以上是Logger在應用開發中的使用的簡單分析,除了Logger在應用開發中的使用,我將更進一步地分析Logger驅動程序的源代碼,更加深刻的認識Android日誌系統。
三、從Logger驅動程序源代碼看Logger機制
3.1概述
因爲Android日誌系統是以驅動程序的形式實現在內核空間的,所以需要獲取Android內核源代碼來分析。在下載好Android源代碼工程中,Logger驅動程序主要由兩個文件構成,分別是:
kernel/common/drivers/staging/android/logger.h
kernel/common/drivers/staging/android/logger.c
接下來,我將首先分析Logger驅動程序的相關數據結構,然後對Logger驅動程序源代碼的使用情景進行分析,比如日誌系統初始化情景、日誌讀取情景和日誌寫入情景。
3.2Logger驅動程序的相關數據結構
3.21 logger.h源代碼
#ifndef _LINUX_LOGGER_H #define _LINUX_LOGGER_H
#include <linux/types.h> #include <linux/ioctl.h>
struct logger_entry { __u16 len; /* length of the payload */ __u16 __pad; /* no matter what, we get 2 bytes of padding */ __s32 pid; /* generating process's pid */ __s32 tid; /* generating process's tid */ __s32 sec; /* seconds since Epoch */ __s32 nsec; /* nanoseconds */ char msg[0];/* the entry's payload */ };
#define LOGGER_LOG_RADIO "log_radio" /* radio-related messages */ #define LOGGER_LOG_EVENTS "log_events" /* system/hardware events */ #define LOGGER_LOG_MAIN "log_main" /* everything else */
#define LOGGER_ENTRY_MAX_LEN (4*1024) #define LOGGER_ENTRY_MAX_PAYLOAD \ (LOGGER_ENTRY_MAX_LEN - sizeof(struct logger_entry))
#define __LOGGERIO 0xAE
#define LOGGER_GET_LOG_BUF_SIZE _IO(__LOGGERIO, 1) /* size of log */ #define LOGGER_GET_LOG_LEN _IO(__LOGGERIO, 2) /* used log len */ #define LOGGER_GET_NEXT_ENTRY_LEN _IO(__LOGGERIO, 3) /* next entry len */ #define LOGGER_FLUSH_LOG _IO(__LOGGERIO, 4) /* flush log */
#endif/* _LINUX_LOGGER_H */
|
struct logger_entry是一個用於描述一條Log記錄的結構體。
len成員變量記錄了這條記錄的有效負載的長度,有效負載指定的日誌記錄本身的長度,但是不包括用於描述這個記錄的struct logger_entry結構體。我們調用android.util.Log接口來使用日誌系統時,會指定日誌的優先級別Priority、Tag字符串以及Msg字符串,Priority + Tag + Msg三者內容的長度加起來就是記錄的有效負載長度。
__pad成員變量是用來對齊結構體的。
pid和tid成員變量分別用來記錄是哪條進程寫入了這條記錄。
sec和nsec成員變量記錄日誌寫的時間。
msg成員變量記錄有效負載的內容,它的大小由len成員變量來確定。
接着還定義了兩個宏:
#define LOGGER_ENTRY_MAX_LEN (4*1024) #define LOGGER_ENTRY_MAX_PAYLOAD \ (LOGGER_ENTRY_MAX_LEN - sizeof(struct logger_entry))
|
從這兩個宏可以看出,每條日誌記錄的有效負載長度加上結構體logger_entry的長度不能超過4K個字節。
logger.h文件中還定義了其它宏,這裏就不一一分析了。
再來看logger.c文件中,其它相關數據結構的定義:
3.22 logger.c中的相關數據結構
/* * struct logger_log - represents a specific log, such as 'main' or 'radio' * * This structure lives from module insertion until module removal, so it does * not need additional reference counting. The structure is protected by the * mutex 'mutex'. */ struct logger_log {
unsignedchar* 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 - a logging device open for reading * * This object lives from open to release, so we don't need additional * reference counting. The structure is protected by log->mutex. */ 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 */
};
/* logger_offset - returns index 'n' into the log via (optimized) modulus */ #define logger_offset(n) ((n) & (log->size - 1))
|
struct logger_log是真正用來保存日誌的結構體。
buffer成員變量是用於保存日誌信息的內存緩衝區,它的大小由size成員變量確定。
從misc成員變量可以看出,logger驅動程序使用的設備屬於misc類型的設備,通過在Android模擬器上執行cat /proc/devices命令,可以看出,misc類型設備的主設備號是10。
wq成員變量是一個等待隊列,用於保存正在等待讀取日誌的進程。
readers成員變量用來保存當前正在讀取日誌的進程,正在讀取日誌的進程由結構體logger_reader來描述。
mutex成員變量是一個互斥量,用來保護log的併發訪問。因爲可以看出,這裏的日誌系統的讀寫問題,其實是一個生產者-消費者的問題,因此,需要互斥量來保護log的併發訪問。
w_off成員變量用來記錄下一條日誌應該從哪裏開始寫。
head成員變量用來表示打開日誌文件中,應該從哪一個位置開始讀取日誌。
struct logger_reader是用來表示一個讀取日誌的進程的結構體,log成員變量指向要讀取的日誌緩衝區。list成員變量用來連接其它讀者進程。r_off成員變量表示當前要讀取的日誌在緩衝區中的位置。
struct logger_log結構體中用於保存日誌信息的內存緩衝區buffer是一個循環使用的環形緩衝區,緩衝區中保存的內容是以struct logger_entry爲單位的,每個單位的組成爲:
structlogger_entry | priority | tag | msg
由於是內存緩衝區buffer是一個循環使用的環形緩衝區,給定一個偏移值,它在buffer中的位置由下logger_offset來確定:
#definelogger_offset(n) ((n) & (log->size -1))
3.3Logger驅動程序的初始化過程
logger.c文件中定義了三個日誌設備:
/* * Defines a log structure with name 'NAME' and a size of 'SIZE' bytes, which * must be a power of two, greater than LOGGER_ENTRY_MAX_LEN, and less than * LONG_MAX minus LOGGER_ENTRY_MAX_LEN. */ #define DEFINE_LOGGER_DEVICE(VAR, NAME, SIZE) \ static unsigned char _buf_ ## VAR[SIZE]; \ static struct logger_log VAR = { \ .buffer = _buf_ ## VAR, \ .misc = { \ .minor = MISC_DYNAMIC_MINOR, \ .name = NAME, \ .fops = &logger_fops, \ .parent = NULL, \ }, \ .wq = __WAIT_QUEUE_HEAD_INITIALIZER(VAR .wq), \ .readers = LIST_HEAD_INIT(VAR .readers), \ .mutex = __MUTEX_INITIALIZER(VAR .mutex), \ .w_off = 0, \ .head = 0, \ .size = SIZE, \ };
DEFINE_LOGGER_DEVICE(log_main, LOGGER_LOG_MAIN,64*1024) DEFINE_LOGGER_DEVICE(log_events, LOGGER_LOG_EVENTS,256*1024) DEFINE_LOGGER_DEVICE(log_radio, LOGGER_LOG_RADIO,64*1024)
|
分別是log_main、log_events和log_radio,名稱分別LOGGER_LOG_MAIN、LOGGER_LOG_EVENTS和LOGGER_LOG_RADIO,它們的次設備號爲MISC_DYNAMIC_MINOR,即爲在註冊時動態分配。
在logger.h文件中,有這三個宏的定義:
#defineLOGGER_LOG_RADIO
"log_radio" /* radio-related messages */
#define LOGGER_LOG_EVENTS "log_events" /* system/hardware events */
#define LOGGER_LOG_MAIN "log_main" /* everything else */
註釋說明了這三個日誌設備的用途。
註冊的日誌設備文件操作方法爲logger_fops:
staticstruct file_operations logger_fops={ .owner= THIS_MODULE, .read= logger_read, .aio_write= logger_aio_write, .poll= logger_poll, .unlocked_ioctl= logger_ioctl, .compat_ioctl= logger_ioctl, .open= logger_open, .release= logger_release, };
|
日誌驅動程序模塊的初始化函數爲logger_init:
staticint __init logger_init(void) { int ret;
ret = init_log(&log_main); if(unlikely(ret)) goto out;
ret = init_log(&log_events); if(unlikely(ret)) goto out;
ret = init_log(&log_radio); if(unlikely(ret)) goto out;
out: return ret; } device_initcall(logger_init);
|
logger_init函數通過調用init_log函數來初始化了上述提到的三個日誌設備:
staticint __init init_log(struct logger_log *log) { int ret;
ret = misc_register(&log->misc); if(unlikely(ret)){ printk(KERN_ERR"logger: failed to register misc " "device for log '%s'!\n", log->misc.name); return ret; }
printk(KERN_INFO"logger: created %luK log '%s'\n", (unsignedlong) log->size>>10, log->misc.name);
return0; } |
init_log函數主要調用了misc_register函數來註冊misc設備,misc_register函數定義在kernel/common/drivers/char/misc.c文件中:
/** * misc_register - register a miscellaneous device * @misc: device structure * * Register a miscellaneous device with the kernel. If the minor * number is set to %MISC_DYNAMIC_MINOR a minor number is assigned * and placed in the minor field of the structure. For other cases * the minor number requested is used. * * The structure passed is linked into the kernel and may not be * destroyed until it has been unregistered. * * A zero is returned on success and a negative errno code for * failure. */
int misc_register(struct miscdevice * misc) { struct miscdevice*c; dev_t dev; int err=0;
INIT_LIST_HEAD(&misc->list);
mutex_lock(&misc_mtx); list_for_each_entry(c,&misc_list, list){ if(c->minor== misc->minor){ mutex_unlock(&misc_mtx); return-EBUSY; } }
if(misc->minor== MISC_DYNAMIC_MINOR){ int i= DYNAMIC_MINORS; while(--i>=0) if((misc_minors[i>>3]&(1<<(i&7)))==0) break; if(i<0){ mutex_unlock(&misc_mtx); return-EBUSY; } misc->minor= i; }
if(misc->minor< DYNAMIC_MINORS) misc_minors[misc->minor>>3]|=1<<(misc->minor&7); dev = MKDEV(MISC_MAJOR, misc->minor);
misc->this_device= device_create(misc_class, misc->parent, dev,NULL, "%s", misc->name); if(IS_ERR(misc->this_device)){ err = PTR_ERR(misc->this_device); goto out; }
/* * Add it to the front, so that later devices can "override" * earlier defaults */ list_add(&misc->list,&misc_list); out: mutex_unlock(&misc_mtx); return err; }
|
註冊完成後,通過device_create創建設備文件節點。這裏,將創建/dev/log/main、/dev/log/events和/dev/log/radio三個設備文件,這樣,用戶空間就可以通過讀寫這三個文件和驅動程序進行交互。
3.4Logger驅動程序的日誌記錄讀取過程
在logger.c文件中,註冊的讀取日誌設備文件的方法爲logger_read:
/* * logger_read - our log's read() method * * Behavior: * * - O_NONBLOCK works * - If there are no log entries to read, blocks until log is written to * - Atomically reads exactly one log entry * * Optimal read size is LOGGER_ENTRY_MAX_LEN. Will set errno to EINVAL if read * buffer is insufficient to hold next entry. */ static ssize_t logger_read(struct file *file,char __user*buf, size_t count, loff_t*pos) { struct logger_reader*reader= file->private_data; struct logger_log*log= reader->log; ssize_t ret; DEFINE_WAIT(wait);
start: while(1){ prepare_to_wait(&log->wq,&wait, TASK_INTERRUPTIBLE);
mutex_lock(&log->mutex); ret =(log->w_off== reader->r_off); mutex_unlock(&log->mutex); if(!ret) break;
if(file->f_flags& O_NONBLOCK){ ret =-EAGAIN; break; }
if(signal_pending(current)){ ret =-EINTR; break; }
schedule(); }
finish_wait(&log->wq,&wait); if(ret) return ret;
mutex_lock(&log->mutex);
/* is there still something to read or did we race? */ if(unlikely(log->w_off== reader->r_off)){ mutex_unlock(&log->mutex); goto start; }
/* get the size of the next entry */ ret = get_entry_len(log, reader->r_off); if(count< ret){ ret =-EINVAL; goto out; }
/* get exactly one entry from the log */ ret = do_read_log_to_user(log, reader, buf, ret);
out: mutex_unlock(&log->mutex);
return ret; }
|
需要注意的是,在函數開始的地方,表示讀取日誌上下文的structlogger_reader是保存在文件指針的private_data成員變量裏面的,這是在打開設備文件時設置的,設備文件打開方法爲logger_open:
/* * logger_open - the log's open() file operation * * Note how near a no-op this is in the write-only case. Keep it that way! */ staticint logger_open(struct inode *inode,struct file*file) { struct logger_log*log; int ret;
ret = nonseekable_open(inode, file); if(ret) return ret;
log = get_log_from_minor(MINOR(inode->i_rdev)); if(!log) return-ENODEV;
if(file->f_mode& FMODE_READ){ struct logger_reader*reader;
reader = kmalloc(sizeof(struct logger_reader), GFP_KERNEL); if(!reader) return-ENOMEM;
reader->log= log; INIT_LIST_HEAD(&reader->list);
mutex_lock(&log->mutex); reader->r_off= log->head; list_add_tail(&reader->list,&log->readers); mutex_unlock(&log->mutex);
file->private_data= reader; }else file->private_data= log;
return0; }
|
新打開日誌設備文件時,是從log->head位置開始讀取日誌的,保存在struct logger_reader的成員變量r_off中。
start標號處的while循環是在等待日誌可讀,如果已經沒有新的日誌可讀了,那麼就要讀進程就要進入休眠狀態,等待新的日誌寫入後再喚醒,這是通過prepare_wait和schedule兩個調用來實現的。
如果沒有新的日誌可讀,並且設備文件不是以非阻塞O_NONBLOCK的方式打開或者這時有信號要處理(signal_pending(current)),那麼就直接返回,不再等待新的日誌寫入。判斷當前是否有新的日誌可讀的方法是:
ret = (log->w_off == reader->r_off);
即判斷當前緩衝區的寫入位置和當前讀進程的讀取位置是否相等,如果不相等,則說明有新的日誌可讀。
之後的代碼表示,如果有新的日誌可讀,那麼就首先通過get_entry_len來獲取下一條可讀的日誌記錄的長度,從這裏可以看出,日誌讀取進程是以日誌記錄爲單位進行讀取的,一次只讀取一條記錄。get_entry_len的函數實現如下:
/* * get_entry_len - Grabs the length of the payload of the next entry starting * from 'off'. * * Caller needs to hold log->mutex. */ static __u32 get_entry_len(struct logger_log *log, size_t off) { __u16 val;
switch(log->size- off){ case1: memcpy(&val, log->buffer+ off,1); memcpy(((char*)&val)+1, log->buffer,1); break; default: memcpy(&val, log->buffer+ off,2); }
returnsizeof(struct logger_entry)+ val; }
|
上面提到,每一條日誌記錄是由兩大部分組成的,一個用於描述這條日誌記錄的結構體struct logger_entry,另一個是記錄體本身,即有效負載。結構體structlogger_entry的長度是固定的,只要知道有效負載的長度,就可以知道整條日誌記錄的長度了。而有效負載的長度是記錄在結構體struct logger_entry的成員變量len中,而len成員變量的地址與struct logger_entry的地址相同,因此,只需要讀取記錄的開始位置的兩個字節就可以了。
又由於日誌記錄緩衝區是循環使用的,這兩個節字有可能是第一個字節存放在緩衝區最後一個字節,而第二個字節存放在緩衝區的第一個節,除此之外,這兩個字節都是連在一起的。因此,分兩種情況來考慮,對於前者,分別通過讀取緩衝區最後一個字節和第一個字節來得到日誌記錄的有效負載長度到本地變量val中,對於後者,直接讀取連續兩個字節的值到本地變量val中。
這兩種情況是通過判斷日誌緩衝區的大小和要讀取的日誌記錄在緩衝區中的位置的差值來區別的,如果相差1,就說明是前一種情況了。
最後,把有效負載的長度val加上struct logger_entry的長度就得到了要讀取的日誌記錄的總長度了。
接下來,得到了要讀取的記錄的長度,就調用do_read_log_to_user函數來執行真正的讀取動作:
static ssize_t do_read_log_to_user(struct logger_log *log, struct logger_reader*reader, char __user*buf, size_t count) { size_t len;
/* * We read from the log in two disjoint operations. First, we read from * the current read head offset up to 'count' bytes or to the end of * the log, whichever comes first. */ len = min(count, log->size- reader->r_off); if(copy_to_user(buf, log->buffer+ reader->r_off, len)) return-EFAULT;
/* * Second, we read any remaining bytes, starting back at the head of * the log. */ if(count!= len) if(copy_to_user(buf+ len, log->buffer, count - len)) return-EFAULT;
reader->r_off= logger_offset(reader->r_off+ count);
return count; }
|
這個函數簡單地調用copy_to_user函數來把位於內核空間的日誌緩衝區指定的內容拷貝到用戶空間的內存緩衝區就可以了,同時,把當前讀取日誌進程的上下文信息中的讀偏移r_off前進到下一條日誌記錄的開始的位置上。
3.5Logger驅動程序的日誌記錄寫入過程
logger.c文件,註冊的寫入日誌設備文件的方法爲logger_aio_write:
/* * logger_aio_write - our write method, implementing support for write(), * writev(), and aio_write(). Writes are our fast path, and we try to optimize * them above all else. */ ssize_t logger_aio_write(struct kiocb *iocb,conststruct iovec*iov, unsignedlong nr_segs, loff_t ppos) { struct logger_log*log= file_get_log(iocb->ki_filp); size_t orig = log->w_off; struct logger_entry header; struct timespec now; ssize_t ret =0;
now = current_kernel_time();
header.pid= current->tgid; header.tid= current->pid; header.sec= now.tv_sec; header.nsec= now.tv_nsec; header.len= min_t(size_t, iocb->ki_left, LOGGER_ENTRY_MAX_PAYLOAD);
/* null writes succeed, return zero */ if(unlikely(!header.len)) return0;
mutex_lock(&log->mutex);
/* * Fix up any readers, pulling them forward to the first readable * entry after (what will be) the new write offset. We do this now * because if we partially fail, we can end up with clobbered log * entries that encroach on readable buffer. */ fix_up_readers(log,sizeof(struct logger_entry)+ header.len);
do_write_log(log,&header,sizeof(struct logger_entry));
while(nr_segs-->0){ size_t len; ssize_t nr;
/* figure out how much of this vector we can keep */ len = min_t(size_t, iov->iov_len, header.len- ret);
/* write out this segment's payload */ nr = do_write_log_from_user(log, iov->iov_base, len); if(unlikely(nr<0)){ log->w_off= orig; mutex_unlock(&log->mutex); return nr; }
iov++; ret += nr; }
mutex_unlock(&log->mutex);
/* wake up any blocked readers */ wake_up_interruptible(&log->wq);
return ret; }
|
輸入的參數iocb表示io上下文,iov表示要寫入的內容,長度爲nr_segs,表示有nr_segs個段的內容要寫入。我們知道,每個要寫入的日誌的結構形式爲:
struct logger_entry | priority | tag | msg
其中, priority、tag和msg這三個段的內容是由iov參數從用戶空間傳遞下來的,分別對應iov裏面的三個元素。而logger_entry是由內核空間來構造的:
struct logger_entry header;
structtimespec now;
now =current_kernel_time();
header.pid= current->tgid;
header.tid= current->pid;
header.sec= now.tv_sec;
header.nsec= now.tv_nsec;
header.len= min_t(size_t, iocb->ki_left, LOGGER_ENTRY_MAX_PAYLOAD);
然後調用do_write_log首先把logger_entry結構體寫入到日誌緩衝區中:
/* * do_write_log - writes 'len' bytes from 'buf' to 'log' * * The caller needs to hold log->mutex. */ staticvoid do_write_log(struct logger_log *log,constvoid*buf, size_t count) { size_t len;
len = min(count, log->size- log->w_off); memcpy(log->buffer+ log->w_off, buf, len);
if(count!= len) memcpy(log->buffer, buf + len, count - len);
log->w_off= logger_offset(log->w_off+ count);
}
|
由於logger_entry是內核堆棧空間分配的,直接用memcpy拷貝就可以了。
接着,通過一個while循環把iov的內容寫入到日誌緩衝區中,也就是日誌的優先級別priority、日誌Tag和日誌主體Msg:
while(nr_segs-->0){ size_t len; ssize_t nr;
/* figure out how much of this vector we can keep */ len = min_t(size_t, iov->iov_len, header.len- ret);
/* write out this segment's payload */ nr = do_write_log_from_user(log, iov->iov_base, len); if(unlikely(nr<0)){ log->w_off= orig; mutex_unlock(&log->mutex); return nr; }
iov++; ret += nr; } |
由於iov的內容是由用戶空間傳下來的,需要調用do_write_log_from_user來寫入:
static ssize_t do_write_log_from_user(struct logger_log *log, constvoid __user*buf, size_t count) { size_t len;
len = min(count, log->size- log->w_off); if(len&& copy_from_user(log->buffer+ log->w_off, buf, len)) return-EFAULT;
if(count!= len) if(copy_from_user(log->buffer, buf + len, count - len)) return-EFAULT;
log->w_off= logger_offset(log->w_off+ count);
return count; }
|
並且在這裏,還有一個重要的步驟:
/* * Fix up any readers, pulling them forward to the first readable * entry after (what will be) the new write offset. We do this now * because if we partially fail, we can end up with clobbered log * entries that encroach on readable buffer. */ fix_up_readers(log,sizeof(struct logger_entry)+ header.len);
|
爲什麼要調用fix_up_reader這個函數呢?這個函數又是作什麼用的呢?這是由於日誌緩衝區是循環使用的,即舊的日誌記錄如果沒有及時讀取,而緩衝區的內容又已經用完時,就需要覆蓋舊的記錄來容納新的記錄。而這部分將要被覆蓋的內容,有可能是某些reader的下一次要讀取的日誌所在的位置,以及爲新的reader準備的日誌開始讀取位置head所在的位置。因此,需要調整這些位置,使它們能夠指向一個新的有效的位置。我們來看一下fix_up_reader函數的實現:
/* * fix_up_readers - walk the list of all readers and "fix up" any who were * lapped by the writer; also do the same for the default "start head". * We do this by "pulling forward" the readers and start head to the first * entry after the new write head. * * The caller needs to hold log->mutex. */ staticvoid fix_up_readers(struct logger_log *log, size_t len) { size_t old = log->w_off; size_t new = logger_offset(old+ len); struct logger_reader*reader;
if(clock_interval(old, new, log->head)) log->head= get_next_entry(log, log->head, len);
list_for_each_entry(reader,&log->readers, list) if(clock_interval(old, new, reader->r_off)) reader->r_off= get_next_entry(log, reader->r_off, len); }
|
判斷log->head和所有讀者reader的當前讀偏移reader->r_off是否在被覆蓋的區域內,如果是,就需要調用get_next_entry來取得下一個有效的記錄的起始位置來調整當前位置:
/* * get_next_entry - return the offset of the first valid entry at least 'len' * bytes after 'off'. * * Caller must hold log->mutex. */ static size_t get_next_entry(struct logger_log *log, size_t off, size_t len) { size_t count =0;
do{ size_t nr = get_entry_len(log, off); off = logger_offset(off+ nr); count += nr; }while(count< len);
return off; }
|
而判斷log->head和所有讀者reader的當前讀偏移reader->r_off是否在被覆蓋的區域內,是通過clock_interval函數來實現的:
/* * clock_interval - is a < c < b in mod-space? Put another way, does the line * from a to b cross c? */ static inline int clock_interval(size_t a, size_t b, size_t c) { if(b< a){ if(a< c|| b>= c) return1; }else{ if(a< c&& b>= c) return1; }
return0; }
|
最後,日誌寫入完畢,還需要喚醒正在等待新日誌的reader進程:
/* wake up any blocked readers */
wake_up_interruptible(&log->wq);
至此,Logger驅動程序的主要邏輯就分析完成了,還有其它的一些接口,如logger_poll、 logger_ioctl和logger_release函數,比較簡單,就不再分析了。
還有一點需要注意的是,由於Logger驅動程序模塊在退出系統時,是不會卸載的,所以這個模塊沒有module_exit函數,而對於模塊裏面定義的對象,也沒有用對引用計數技術。