commit 05867825afa7e5332e28ab224a39dbc9424bc5fc79fca965142619832a172f1d from: Tracey Emery date: Tue Nov 10 16:32:21 2026 UTC describe worker count and congestion in mqttctl.8 "show parent" now reports the number of sockets workers and "show clients" marks a connection that is not draining as congested and counts the messages dropped for it; say so in the manual. commit - 1ac677f7e995bd41b12d494c275059d6da7299509971ca2589b898cfc7b7ba57 commit + 05867825afa7e5332e28ab224a39dbc9424bc5fc79fca965142619832a172f1d blob - b21f7bae8819426b5ae8420b54f713f4787dc3df983c2b78d97df4102ebf1653 blob + 115b2b396518f3d3ba8afb823e71a7d1eae0d2f31ef2dc4e7c9ffe504e709767 --- mqttctl/mqttctl.8 +++ mqttctl/mqttctl.8 @@ -73,12 +73,18 @@ traffic counters. .It Cm show clients Op Ar client-id List all sessions, connected or not, or the one with the given identifier. +The state column reads +.Dq congested +while the client's connection is not draining and messages for it are +being dropped or held back; the DROP column counts the messages dropped +for the session. .It Cm show control Show the state of the control process. .It Cm show listeners List the configured listeners with their connection counts. .It Cm show parent -Show the state of the parent process. +Show the state of the parent process: log level, uptime, the number of +sockets workers and the number of listeners. .It Cm show retained Op Ar topic List retained messages, or the one for the given topic. .It Cm show stats