show pools

Show the status of internal memory pools.

Description Jump to heading #

The show pools command displays a list of memory pools and their statuses.

As of version 2.7r1, there are options for filtering and sorting the output.

By default, the command does not sort the output. If byname is specified, it is sorted by pool name. If bysize is specified, it is sorted by item size in reverse order. If byusage is specified, it is sorted by total usage in reverse order, and only used entries are shown.

To limit output to the first number of lines, specify that number as an argument.

To report only pools beginning with a given string, specify the string after the match argument.

The reported total only concerns pools matching the filtering criteria.

Examples Jump to heading #

Below, we call show pools to see the status of internal memory pools:

nix
echo "show pools" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999

nix
echo "show pools" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999

output
text
Dumping pools usage. Use SIGQUIT to flush them.
   - Pool comp_state (32 bytes) : 10 allocated (320 bytes), 10 used, needed_avg 6, 0 failures, 6 users, @0x55f09cab7380=10 [SHARED]
   - Pool filter (64 bytes) : 17 allocated (1088 bytes), 17 used, needed_avg 13, 0 failures, 9 users, @0x55f09cab7280=08 [SHARED]
   - Pool pendconn (96 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 5 users, @0x55f09cab7400=11 [SHARED]
   - Pool uniqueid (128 bytes) : 6 allocated (768 bytes), 6 used, needed_avg 2, 0 failures, 4 users, @0x55f09cab7080=04 [SHARED]
   - Pool h1c (160 bytes) : 26 allocated (4160 bytes), 26 used, needed_avg 22, 0 failures, 4 users, @0x55f09cab6f80=02 [SHARED]
   - Pool fcgi_strm (192 bytes) : 8 allocated (1536 bytes), 8 used, needed_avg 4, 0 failures, 3 users, @0x55f09cab6e80=00 [SHARED]
   - Pool tcpcheck_ru (224 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 2 users, @0x55f09cab7180=06 [SHARED]
   - Pool authority (256 bytes) : 2 allocated (512 bytes), 2 used, needed_avg 0, 0 failures, 2 users, @0x55f09cab7580=14 [SHARED]
   - Pool spoe_ctx (320 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7200=07 [SHARED]
   - Pool session (352 bytes) : 4 allocated (1408 bytes), 4 used, needed_avg 1, 0 failures, 1 users, @0x55f09cab7300=09 [SHARED]
   - Pool dns_resolut (480 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7480=12 [SHARED]
   - Pool dns_answer_ (576 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7500=13 [SHARED]
   - Pool requri (1024 bytes) : 2 allocated (2048 bytes), 2 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7680=16 [SHARED]
   - Pool fcgi_conn (1216 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab6f00=01 [SHARED]
   - Pool stream (1248 bytes) : 2 allocated (2496 bytes), 2 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7100=05 [SHARED]
   - Pool h2c (1312 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7000=03 [SHARED]
   - Pool hpack_tbl (4096 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7780=18 [SHARED]
   - Pool buffer (16384 bytes) : 6 allocated (98304 bytes), 6 used, needed_avg 2, 0 failures, 1 users, @0x55f09cab7700=17 [SHARED]
   - Pool trash (16416 bytes) : 2 allocated (32832 bytes), 2 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7800=19
Total: 19 pools, 145472 bytes allocated, 145472 used.

output
text
Dumping pools usage. Use SIGQUIT to flush them.
   - Pool comp_state (32 bytes) : 10 allocated (320 bytes), 10 used, needed_avg 6, 0 failures, 6 users, @0x55f09cab7380=10 [SHARED]
   - Pool filter (64 bytes) : 17 allocated (1088 bytes), 17 used, needed_avg 13, 0 failures, 9 users, @0x55f09cab7280=08 [SHARED]
   - Pool pendconn (96 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 5 users, @0x55f09cab7400=11 [SHARED]
   - Pool uniqueid (128 bytes) : 6 allocated (768 bytes), 6 used, needed_avg 2, 0 failures, 4 users, @0x55f09cab7080=04 [SHARED]
   - Pool h1c (160 bytes) : 26 allocated (4160 bytes), 26 used, needed_avg 22, 0 failures, 4 users, @0x55f09cab6f80=02 [SHARED]
   - Pool fcgi_strm (192 bytes) : 8 allocated (1536 bytes), 8 used, needed_avg 4, 0 failures, 3 users, @0x55f09cab6e80=00 [SHARED]
   - Pool tcpcheck_ru (224 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 2 users, @0x55f09cab7180=06 [SHARED]
   - Pool authority (256 bytes) : 2 allocated (512 bytes), 2 used, needed_avg 0, 0 failures, 2 users, @0x55f09cab7580=14 [SHARED]
   - Pool spoe_ctx (320 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7200=07 [SHARED]
   - Pool session (352 bytes) : 4 allocated (1408 bytes), 4 used, needed_avg 1, 0 failures, 1 users, @0x55f09cab7300=09 [SHARED]
   - Pool dns_resolut (480 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7480=12 [SHARED]
   - Pool dns_answer_ (576 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7500=13 [SHARED]
   - Pool requri (1024 bytes) : 2 allocated (2048 bytes), 2 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7680=16 [SHARED]
   - Pool fcgi_conn (1216 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab6f00=01 [SHARED]
   - Pool stream (1248 bytes) : 2 allocated (2496 bytes), 2 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7100=05 [SHARED]
   - Pool h2c (1312 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7000=03 [SHARED]
   - Pool hpack_tbl (4096 bytes) : 0 allocated (0 bytes), 0 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7780=18 [SHARED]
   - Pool buffer (16384 bytes) : 6 allocated (98304 bytes), 6 used, needed_avg 2, 0 failures, 1 users, @0x55f09cab7700=17 [SHARED]
   - Pool trash (16416 bytes) : 2 allocated (32832 bytes), 2 used, needed_avg 0, 0 failures, 1 users, @0x55f09cab7800=19
Total: 19 pools, 145472 bytes allocated, 145472 used.

Show pools whose names start with string quic and sort by total usage:

nix
echo "show pools match quic byusage" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999

nix
echo "show pools match quic byusage" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999

output
text
Dumping pools usage. Use SIGQUIT to flush them.
   - Pool quic_conn_r (65560 bytes) : 1337 allocated (87653720 bytes), ...
   - Pool quic_crypto (1048 bytes) : 6685 allocated (7005880 bytes), ...
   - Pool quic_conn (4056 bytes) : 1337 allocated (5422872 bytes), ...
   - Pool quic_rxbuf (262168 bytes) : 8 allocated (2097344 bytes), ...
   - Pool quic_connne (184 bytes) : 9359 allocated (1722056 bytes), ...
   - Pool quic_frame (184 bytes) : 7938 allocated (1460592 bytes), ...
   - Pool quic_tx_pac (152 bytes) : 6454 allocated (981008 bytes), ...
   - Pool quic_tls_ke (56 bytes) : 12033 allocated (673848 bytes), ...
   - Pool quic_rx_pac (408 bytes) : 1596 allocated (651168 bytes), ...
   - Pool quic_tls_se (88 bytes) : 6685 allocated (588280 bytes), ...
   - Pool quic_cstrea (88 bytes) : 4011 allocated (352968 bytes), ...
   - Pool quic_tls_iv (24 bytes) : 12033 allocated (288792 bytes), ...
   - Pool quic_dgram (344 bytes) : 732 allocated (251808 bytes), ...
   - Pool quic_arng (56 bytes) : 4011 allocated (224616 bytes), ...
   - Pool quic_conn_c (152 bytes) : 1337 allocated (203224 bytes), ...
Total: 15 pools, 109578176 bytes allocated, 109578176 used ...

output
text
Dumping pools usage. Use SIGQUIT to flush them.
   - Pool quic_conn_r (65560 bytes) : 1337 allocated (87653720 bytes), ...
   - Pool quic_crypto (1048 bytes) : 6685 allocated (7005880 bytes), ...
   - Pool quic_conn (4056 bytes) : 1337 allocated (5422872 bytes), ...
   - Pool quic_rxbuf (262168 bytes) : 8 allocated (2097344 bytes), ...
   - Pool quic_connne (184 bytes) : 9359 allocated (1722056 bytes), ...
   - Pool quic_frame (184 bytes) : 7938 allocated (1460592 bytes), ...
   - Pool quic_tx_pac (152 bytes) : 6454 allocated (981008 bytes), ...
   - Pool quic_tls_ke (56 bytes) : 12033 allocated (673848 bytes), ...
   - Pool quic_rx_pac (408 bytes) : 1596 allocated (651168 bytes), ...
   - Pool quic_tls_se (88 bytes) : 6685 allocated (588280 bytes), ...
   - Pool quic_cstrea (88 bytes) : 4011 allocated (352968 bytes), ...
   - Pool quic_tls_iv (24 bytes) : 12033 allocated (288792 bytes), ...
   - Pool quic_dgram (344 bytes) : 732 allocated (251808 bytes), ...
   - Pool quic_arng (56 bytes) : 4011 allocated (224616 bytes), ...
   - Pool quic_conn_c (152 bytes) : 1337 allocated (203224 bytes), ...
Total: 15 pools, 109578176 bytes allocated, 109578176 used ...

See also Jump to heading #

• show threads