acrn-hypervisor/devicemodel/tools/acrnlog
Yan, Like 731c0d41f9 DM:tools: add README.rst for acrnlog tool
Signed-off-by: Yan, Like <like.yan@intel.com>
Reviewed-by: Zhao Yakui <yakui.zhao@intel.com>
Acked-by: Eddie Dong <eddie.dong@intel.com>
2018-05-15 17:25:23 +08:00
..
Makefile DM:tools: add acrnlog tool 2018-05-15 17:25:23 +08:00
README.rst DM:tools: add README.rst for acrnlog tool 2018-05-15 17:25:23 +08:00
acrnlog.c DM:tools: add acrnlog tool 2018-05-15 17:25:23 +08:00
acrnlog.service DM:tools: add service file for acrnlog 2018-05-15 17:25:23 +08:00

README.rst

ACRNLOG
#######

DESCRIPTION
###########
acrnlog is a userland tool to capture ACRN hypervisor log, it runs as an
SOS service at boot. It captures two kinds of logs:
 - log of current running;
 - log of last running if crashed and logs remaining.

The path to save log files is /tmp/acrnog/, so the log files would be lost
after reset.

USAGE
#####
The acrnlog tool is launched as a service at boot, with 4 1MB log files limited.
To change the log file limitation:

- temporary change
 Stop the acrnlog service:

 # systemctl disable acrnlog

 Restart acrnlog running at backgroud with size and number of files.
 For example:

 # acrnlog -n 8 -s 4 &

Use get_loglevel/set_loglevel to query and change the hypervisor loglevel.
The mem_loglevel controls log to be saved using acrnlog, while
console_loglevel controls log to output to console. For example:
 ACRN:\>get_loglevel
 console_loglevel: 2, mem_loglevel: 4
 ACRN:\>set_loglevel 2 5
 ACRN:\>get_loglevel
 console_loglevel: 2, mem_loglevel: 5

- permanent chagne
 Edit /usr/lib/systemd/system/acrnlog.service to attached the -n and -s options to
 the ExecStart cmd, and restart the service. For example:

 ExecStart=/usr/bin/acrnlog -n 8 -s 4

BUILD&INSTALLATION
##################
 # make
 copy acrnlog to /usr/bin/ and copy acrnlog.service to /usr/lib/systemd/system/