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>
This commit is contained in:
parent
a1c07bb9b0
commit
731c0d41f9
|
@ -0,0 +1,47 @@
|
||||||
|
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/
|
Loading…
Reference in New Issue