acrn-hypervisor/devicemodel/tools/acrnlog
Geoffroy Van Cutsem d93066f769 Move ACRN Device Model code in a devicemodel/ folder
This is part of the short series of commits that will lead
to a unified repository for the ACRN hypervisor, device model
and the associated documentation.

Signed-off-by: Geoffroy Van Cutsem <geoffroy.vancutsem@intel.com>
2018-05-10 01:51:51 +02:00
..
acrnlog.c Move ACRN Device Model code in a devicemodel/ folder 2018-05-10 01:51:51 +02:00
acrnlog.service Move ACRN Device Model code in a devicemodel/ folder 2018-05-10 01:51:51 +02:00
Makefile Move ACRN Device Model code in a devicemodel/ folder 2018-05-10 01:51:51 +02:00
README.rst Move ACRN Device Model code in a devicemodel/ folder 2018-05-10 01:51:51 +02:00

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/