derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
69 lines
2.5 KiB
Plaintext
69 lines
2.5 KiB
Plaintext
****************************************************************************
|
|
* README *
|
|
* *
|
|
* This file provides all the information regarding new CLI commands that *
|
|
* enable using various hardware features of Intel(R) architecture based *
|
|
* processors from LLDB's CLI. *
|
|
****************************************************************************
|
|
|
|
|
|
============
|
|
Introduction
|
|
============
|
|
A shared library has been developed to use various hardware features of
|
|
Intel(R) architecture based processors through LLDB's command line. The library
|
|
currently comprises of hardware features namely Intel(R) Processor Trace and
|
|
Intel(R) Memory Protection Extensions.
|
|
|
|
|
|
============
|
|
Details
|
|
============
|
|
A C++ based cli wrapper (cli-wrapper.cpp) has been developed here that
|
|
agglomerates all cli commands for various hardware features. This wrapper is
|
|
build to generate a shared library (lldbIntelFeatures) to provide all these
|
|
commands.
|
|
|
|
For each hardware feature, separate cli commands have been developed that are
|
|
provided by wrappers (e.g. cli-wrapper-mpxtable.cpp) residing
|
|
in feature specific folders.
|
|
|
|
For details regarding cli commands of each feature, please refer to these
|
|
feature specific wrappers.
|
|
|
|
|
|
|
|
============
|
|
How to Build
|
|
============
|
|
The shared library (lldbIntelFeatures) has a cmake based build and can be built
|
|
while building LLDB with cmake. "cli-wrapper.cpp" file is compiled along with all
|
|
the feature specific source files (residing in feature specific folders).
|
|
|
|
Furthermore, flexibility is provided to the user to include/exclude a particular
|
|
feature while building lldbIntelFeatures library. This is done by flags described
|
|
below:
|
|
|
|
- LLDB_BUILD_INTEL_MPX - Enables building Intel(R) Memory Protection Extensions
|
|
feature (inside intel-mpx folder). This flag defaults to "ON" meaning
|
|
the feature is excluded while building lldbIntelFeatures library.
|
|
|
|
Please refer to README files in feature specific folders to know about additional
|
|
flags that need to be set in order to build that feature successfully.
|
|
|
|
|
|
============
|
|
How to Use
|
|
============
|
|
All CLI commands provided by this shared library can be used through the LLDB's
|
|
CLI by executing "plugin load <shared_lib_name>" on LLDB CLI. shared_lib_name here
|
|
is lldbIntelFeatures
|
|
|
|
|
|
|
|
============
|
|
Description
|
|
============
|
|
Please refer to README_CLI file of each feature to know about details of CLI
|
|
commands.
|