[v2] doc/power: add info on jansson conditional build
Checks
Commit Message
Add more info to the docs on how to set environmental variable to
correctly build the vm_power_manager sample app in a cross compile
or multilib environment by setting PKG_CONFIG_LIBDIR.
Signed-off-by: David Hunt <david.hunt@intel.com>
---
v2:
Changed the note to be shown using the ``.. Note::`` tag.
---
.../sample_app_ug/vm_power_management.rst | 25 +++++++++++++++++++
1 file changed, 25 insertions(+)
Comments
Acked-by: Marko Kovacevic <marko.kovacevic@intel.com>
16/11/2018 16:47, David Hunt:
> Add more info to the docs on how to set environmental variable to
> correctly build the vm_power_manager sample app in a cross compile
> or multilib environment by setting PKG_CONFIG_LIBDIR.
>
> Signed-off-by: David Hunt <david.hunt@intel.com>
Applied, thanks
@@ -657,6 +657,31 @@ To build just the ``guest_vm_power_manager`` application using ``make``:
The resulting binary will be ${RTE_SDK}/build/examples/guest_cli
+.. Note::
+ This sample application conditionally links in the Jansson JSON
+ library, so if you are using a multilib or cross compile environment you
+ may need to set the ``PKG_CONFIG_LIBDIR`` environmental variable to point to
+ the relevant pkgconfig folder so that the correct library is linked in.
+
+ For example, if you are building for a 32-bit target, you could find the
+ correct directory using the following ``find`` command:
+
+ .. code-block:: console
+
+ # find /usr -type d -name pkgconfig
+ /usr/lib/i386-linux-gnu/pkgconfig
+ /usr/lib/x86_64-linux-gnu/pkgconfig
+
+ Then use:
+
+ .. code-block:: console
+
+ export PKG_CONFIG_LIBDIR=/usr/lib/i386-linux-gnu/pkgconfig
+
+ You then use the make command as normal, which should find the 32-bit
+ version of the library, if it installed. If not, the application will
+ be built without the JSON interface functionality.
+
To build just the ``vm_power_manager`` application using ``meson/ninja``:
.. code-block:: console