blob: 58b84e240fb088cdc889b243da316c25a99c317f [file] [log] [blame]
newtmgr mpstat
---------------
Read memory pool statistics from a device.
Usage:
^^^^^^
.. code-block:: console
newtmgr mpstat -c <conn_profile> [flags]
Global Flags:
^^^^^^^^^^^^^
.. code-block:: console
-c, --conn string connection profile to use
-h, --help help for newtmgr
-l, --loglevel string log level to use (default "info")
--name string name of target BLE device; overrides profile setting
-t, --timeout float timeout in seconds (partial seconds allowed) (default 10)
-r, --tries int total number of tries in case of timeout (default 1)
Description
^^^^^^^^^^^
Reads and displays the memory pool statistics from a device. Newtmgr uses the ``conn_profile`` connection profile to
connect to the device. It lists the following statistics for each memory pool:
- **name**: Memory pool name
- **blksz**: Size (number of bytes) of each memory block
- **cnt**: Number of blocks allocated for the pool
- **free**: Number of free blocks
- **min**: The lowest number of free blocks that were available
Examples
^^^^^^^^
+-----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Usage | Explanation |
+===================================+====================================================================================================================================================================+
| ``newtmgr mpstat -c profile01`` | Reads and displays the memory pool statistics from a device. Newtmgr connects to the device over a connection specified in the ``profile01`` connection profile. |
+-----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Here is an example output for the ``myble`` application from the
:doc:`Enabling Newt Manager in any app <../../os/tutorials/add_newtmgr>` tutiorial:
.. code-block:: console
$ newtmgr mpstat -c myserial
name blksz cnt free min
ble_att_svr_entry_pool 20 75 0 0
ble_att_svr_prep_entry_pool 12 64 64 64
ble_gap_update 24 1 1 1
ble_gattc_proc_pool 56 4 4 4
ble_gatts_clt_cfg_pool 12 2 1 1
ble_hci_ram_evt_hi_pool 72 2 2 1
ble_hci_ram_evt_lo_pool 72 8 8 8
ble_hs_conn_pool 92 1 1 1
ble_hs_hci_ev_pool 16 10 10 9
ble_l2cap_chan_pool 28 3 3 3
ble_l2cap_sig_proc_pool 20 1 1 1
btshell_chr_pool 36 64 64 64
btshell_dsc_pool 28 64 64 64
btshell_svc_pool 36 32 32 32
msys_1 292 12 9 6