github/acrn-hypervisor
1
0
Fork 0
mirror of https://github.com/projectacrn/acrn-hypervisor.git synced 2025-06-22 13:37:10 +00:00
Code Issues Projects Releases Wiki Activity

Updated commands per feedback

Browse Source 
Signed-off-by: Amy Reyes <amy.reyes@intel.com>
This commit is contained in:
Amy Reyes 2021-10-26 10:12:43 -07:00 committed by David Kinder
parent 10947ee1ca
commit 1f681cdedc
1 changed files with 7 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
misc/debug_tools/acrn_trace/README.rst
View File

@ -93,17 +93,11 @@ Here's a typical use of ``acrntrace`` to capture trace data from the Service VM,
convert the binary data to human-readable form, copy the processed trace convert the binary data to human-readable form, copy the processed trace
data to your development computer (Linux system), and run the analysis tool. data to your development computer (Linux system), and run the analysis tool.
1. On the Service VM, clear buffers before starting a trace: 1. On the Service VM, start capturing buffered trace data:
.. code-block:: none .. code-block:: none
# acrntrace -c sudo acrntrace
#. Start capturing buffered trace data:
.. code-block:: none
# acrntrace
Trace files are created under the current directory where you launched Trace files are created under the current directory where you launched
``acrntrace``, with a date-time-based directory name such as ``acrntrace``, with a date-time-based directory name such as
@ -119,7 +113,7 @@ data to your development computer (Linux system), and run the analysis tool.
.. code-block:: none .. code-block:: none
# acrntrace_format.py formats trace_data sudo acrntrace_format.py formats trace_data
Trace data will be converted to human-readable format based on a given format Trace data will be converted to human-readable format based on a given format
and printed to stdout. and printed to stdout.
@ -130,7 +124,7 @@ data to your development computer (Linux system), and run the analysis tool.
.. code-block:: none .. code-block:: none
# scp -r ./acrntrace/20171115-101605/ \ sudo scp -r ./acrntrace/20171115-101605/ \
username@hostname:/home/username/trace_data username@hostname:/home/username/trace_data
Replace username and hostname with appropriate values. Replace username and hostname with appropriate values.
@ -140,7 +134,7 @@ data to your development computer (Linux system), and run the analysis tool.
.. code-block:: none .. code-block:: none
# acrnalyze.py -i /home/xxxx/trace_data/20171115-101605/0 \ sudo acrnalyze.py -i /home/xxxx/trace_data/20171115-101605/0 \
-o /home/xxxx/trace_data/20171115-101605/cpu0 --vm_exit --irq -o /home/xxxx/trace_data/20171115-101605/cpu0 --vm_exit --irq
- The analysis report is written to stdout, or to a CSV file if - The analysis report is written to stdout, or to a CSV file if
@ -155,8 +149,8 @@ directory. To build and install ``acrntrace``, run these commands:
.. code-block:: none .. code-block:: none
# make make
# make install sudo make install
The processing scripts are in ``misc/debug_tools/acrn_trace/scripts``. The The processing scripts are in ``misc/debug_tools/acrn_trace/scripts``. The
``acrnalyze.py`` tool needs to be copied to and run on your development ``acrnalyze.py`` tool needs to be copied to and run on your development