RepoMirrors
/
haproxy
mirror of http://git.haproxy.org/git/haproxy.git/
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
haproxy/contrib/debug/flags.c

452 lines
12 KiB
C
Raw Normal View History

CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
#include <stdio.h>
#include <stdlib.h>
#include <types/channel.h>
#include <types/connection.h>
REORG: proto_htx: Move HTX analyzers & co to http_ana.{c,h} files The old module proto_http does not exist anymore. All code dedicated to the HTTP analysis is now grouped in the file proto_htx.c. So, to finish the polishing after removing the legacy HTTP code, proto_htx.{c,h} files have been moved in http_ana.{c,h} files. In addition, all HTX analyzers and related functions prefixed with "htx_" have been renamed to start with "http_" instead.
2019-07-16 12:54:53 +00:00
#include <types/http_ana.h>
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
#include <types/stream.h>
#include <types/stream_interface.h>
#include <types/task.h>
CONTRIB: debug: add the possibility to decode the value as certain types only It's often confusing to have a whole dump on the screen while only checking for a set of task or stream flags, and appending "|grep ^chn" isn't very convenient to repeat the opeation. Instead let's add the ability to filter the output as certain types only by prepending their name(s) before the value.
2020-02-06 07:33:08 +00:00
// 1 bit per flag, no hole permitted here
#define SHOW_AS_ANA 0x00000001
#define SHOW_AS_CHN 0x00000002
#define SHOW_AS_CONN 0x00000004
#define SHOW_AS_CS 0x00000008
#define SHOW_AS_SI 0x00000010
#define SHOW_AS_SIET 0x00000020
#define SHOW_AS_STRM 0x00000040
#define SHOW_AS_TASK 0x00000080
#define SHOW_AS_TXN 0x00000100
// command line names, must be in exact same order as the SHOW_AS_* flags above
// so that show_as_words[i] matches flag 1U<<i.
const char *show_as_words[] = { "ana", "chn", "conn", "cs", "si", "siet", "strm", "task", "txn", };
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
#define SHOW_FLAG(f,n) \
do { \
if (!((f) & (n))) break; \
(f) &= ~(n); \
printf(#n"%s", (f) ? " | " : ""); \
} while (0)
CONTRIB: debug: add the possibility to decode the value as certain types only It's often confusing to have a whole dump on the screen while only checking for a set of task or stream flags, and appending "|grep ^chn" isn't very convenient to repeat the opeation. Instead let's add the ability to filter the output as certain types only by prepending their name(s) before the value.
2020-02-06 07:33:08 +00:00
unsigned int get_show_as(const char *word)
{
int w = 0;
while (1) {
if (w == sizeof(show_as_words) / sizeof(*show_as_words))
return 0;
if (strcmp(word, show_as_words[w]) == 0)
return 1U << w;
w++;
}
}
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
void show_chn_ana(unsigned int f)
{
printf("chn->ana = ");
if (!f) {
printf("0\n");
return;
}
MINOR: debug/flags: Add missing flags
2017-11-10 13:10:35 +00:00
SHOW_FLAG(f, AN_REQ_FLT_START_FE);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, AN_REQ_INSPECT_FE);
SHOW_FLAG(f, AN_REQ_WAIT_HTTP);
SHOW_FLAG(f, AN_REQ_HTTP_BODY);
SHOW_FLAG(f, AN_REQ_HTTP_PROCESS_FE);
SHOW_FLAG(f, AN_REQ_SWITCHING_RULES);
MINOR: debug/flags: Add missing flags
2017-11-10 13:10:35 +00:00
SHOW_FLAG(f, AN_REQ_FLT_START_BE);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, AN_REQ_INSPECT_BE);
SHOW_FLAG(f, AN_REQ_HTTP_PROCESS_BE);
MINOR: debug/flags: Add missing flags
2017-11-10 13:10:35 +00:00
SHOW_FLAG(f, AN_REQ_HTTP_TARPIT);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, AN_REQ_SRV_RULES);
SHOW_FLAG(f, AN_REQ_HTTP_INNER);
SHOW_FLAG(f, AN_REQ_PRST_RDP_COOKIE);
MINOR: debug/flags: Add missing flags
2017-11-10 13:10:35 +00:00
SHOW_FLAG(f, AN_REQ_STICKING_RULES);
SHOW_FLAG(f, AN_REQ_FLT_HTTP_HDRS);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, AN_REQ_HTTP_XFER_BODY);
MINOR: debug/flags: Add missing flags
2017-11-10 13:10:35 +00:00
SHOW_FLAG(f, AN_REQ_FLT_XFER_DATA);
SHOW_FLAG(f, AN_REQ_FLT_END);
CONTRIB: debug: fix a few flags definitions Commit f4cfcf9 ("MINOR: debug/flags: Add missing flags") added a number of missing flags but a few of them were incorrect, hiding real values. This can be backported to 1.8.
2018-01-15 17:59:16 +00:00
SHOW_FLAG(f, AN_RES_FLT_START_FE);
SHOW_FLAG(f, AN_RES_FLT_START_BE);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, AN_RES_INSPECT);
SHOW_FLAG(f, AN_RES_WAIT_HTTP);
SHOW_FLAG(f, AN_RES_STORE_RULES);
MINOR: debug/flags: Add missing flags
2017-11-10 13:10:35 +00:00
SHOW_FLAG(f, AN_RES_HTTP_PROCESS_FE);
SHOW_FLAG(f, AN_RES_HTTP_PROCESS_BE);
SHOW_FLAG(f, AN_RES_FLT_HTTP_HDRS);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, AN_RES_HTTP_XFER_BODY);
MINOR: debug/flags: Add missing flags
2017-11-10 13:10:35 +00:00
SHOW_FLAG(f, AN_RES_FLT_XFER_DATA);
SHOW_FLAG(f, AN_RES_FLT_END);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
if (f) {
printf("EXTRA(0x%08x)", f);
}
putchar('\n');
}
void show_chn_flags(unsigned int f)
{
printf("chn->flags = ");
if (!f) {
printf("0\n");
return;
}
SHOW_FLAG(f, CF_ISRESP);
CONTRIB: debug: report the CS and CF's EOI flags These ones indicate an end of input.
2019-03-25 17:34:28 +00:00
SHOW_FLAG(f, CF_EOI);
MINOR: debug/flags: Add missing flags
2017-11-10 13:10:35 +00:00
SHOW_FLAG(f, CF_FLT_ANALYZE);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, CF_WAKE_ONCE);
SHOW_FLAG(f, CF_NEVER_WAIT);
SHOW_FLAG(f, CF_SEND_DONTWAIT);
SHOW_FLAG(f, CF_EXPECT_MORE);
SHOW_FLAG(f, CF_DONT_READ);
SHOW_FLAG(f, CF_AUTO_CONNECT);
SHOW_FLAG(f, CF_READ_DONTWAIT);
SHOW_FLAG(f, CF_KERN_SPLICING);
SHOW_FLAG(f, CF_READ_ATTACHED);
SHOW_FLAG(f, CF_ANA_TIMEOUT);
SHOW_FLAG(f, CF_WROTE_DATA);
SHOW_FLAG(f, CF_STREAMER_FAST);
SHOW_FLAG(f, CF_STREAMER);
SHOW_FLAG(f, CF_AUTO_CLOSE);
SHOW_FLAG(f, CF_SHUTW_NOW);
SHOW_FLAG(f, CF_SHUTW);
SHOW_FLAG(f, CF_WAKE_WRITE);
SHOW_FLAG(f, CF_WRITE_ERROR);
SHOW_FLAG(f, CF_WRITE_TIMEOUT);
SHOW_FLAG(f, CF_WRITE_PARTIAL);
SHOW_FLAG(f, CF_WRITE_NULL);
SHOW_FLAG(f, CF_READ_NOEXP);
SHOW_FLAG(f, CF_SHUTR_NOW);
SHOW_FLAG(f, CF_SHUTR);
SHOW_FLAG(f, CF_READ_ERROR);
SHOW_FLAG(f, CF_READ_TIMEOUT);
SHOW_FLAG(f, CF_READ_PARTIAL);
SHOW_FLAG(f, CF_READ_NULL);
if (f) {
printf("EXTRA(0x%08x)", f);
}
putchar('\n');
}
void show_conn_flags(unsigned int f)
{
printf("conn->flags = ");
if (!f) {
printf("0\n");
return;
}
SHOW_FLAG(f, CO_FL_XPRT_TRACKED);
MINOR: debug/flags: Add missing flags
2017-11-10 13:10:35 +00:00
SHOW_FLAG(f, CO_FL_RCVD_PROXY);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, CO_FL_PRIVATE);
MINOR: debug/flags: Add missing flags
2017-11-10 13:10:35 +00:00
SHOW_FLAG(f, CO_FL_ACCEPT_CIP);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, CO_FL_ACCEPT_PROXY);
SHOW_FLAG(f, CO_FL_SSL_WAIT_HS);
SHOW_FLAG(f, CO_FL_SEND_PROXY);
SHOW_FLAG(f, CO_FL_WAIT_L6_CONN);
SHOW_FLAG(f, CO_FL_WAIT_L4_CONN);
SHOW_FLAG(f, CO_FL_ERROR);
SHOW_FLAG(f, CO_FL_SOCK_WR_SH);
SHOW_FLAG(f, CO_FL_SOCK_RD_SH);
CONTRIB: debug: add 4 missing connection/conn_stream flags The following flags were missing thus added : - CO_FL_SOCKS4_RECV - CO_FL_SOCKS4_SEND - CS_FL_READ_PARTIAL - CS_FL_KILL_CONN
2019-06-03 12:26:54 +00:00
SHOW_FLAG(f, CO_FL_SOCKS4_RECV);
SHOW_FLAG(f, CO_FL_SOCKS4_SEND);
MINOR: debug/flags: Add missing flags
2017-11-10 13:10:35 +00:00
SHOW_FLAG(f, CO_FL_EARLY_DATA);
SHOW_FLAG(f, CO_FL_EARLY_SSL_HS);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, CO_FL_ADDR_TO_SET);
SHOW_FLAG(f, CO_FL_ADDR_FROM_SET);
SHOW_FLAG(f, CO_FL_WAIT_ROOM);
MINOR: debug: Add check for CO_FL_WILL_UPDATE This could be backported to 1.8.
2018-02-27 14:41:10 +00:00
SHOW_FLAG(f, CO_FL_WILL_UPDATE);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, CO_FL_XPRT_READY);
SHOW_FLAG(f, CO_FL_CTRL_READY);
REORG: connection: rename CO_FL_DATA_* -> CO_FL_XPRT_* These flags are not exactly for the data layer, they instead indicate what is expected from the transport layer. Since we're going to split the connection between the transport and the data layers to insert a mux layer, it's important to have a clear idea of what each layer does. All function conn_data_* used to manipulate these flags were renamed to conn_xprt_*.
2017-09-13 16:30:23 +00:00
SHOW_FLAG(f, CO_FL_XPRT_WR_ENA);
SHOW_FLAG(f, CO_FL_XPRT_RD_ENA);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
if (f) {
printf("EXTRA(0x%08x)", f);
}
putchar('\n');
}
MINOR: debug: Add checks for conn_stream flags This may be carefully backported to 1.8 (a few flags don't exist there).
2018-03-01 07:55:21 +00:00
void show_cs_flags(unsigned int f)
{
printf("cs->flags = ");
if (!f) {
printf("0\n");
return;
}
CONTRIB: debug: add 4 missing connection/conn_stream flags The following flags were missing thus added : - CO_FL_SOCKS4_RECV - CO_FL_SOCKS4_SEND - CS_FL_READ_PARTIAL - CS_FL_KILL_CONN
2019-06-03 12:26:54 +00:00
SHOW_FLAG(f, CS_FL_READ_PARTIAL);
CONTRIB: debug: fix build related to conn_stream flags change Commit 53216e7db ("MEDIUM: connections: Don't directly mess with the polling from the upper layers.") removed the CS_FL_DATA_RD_ENA and CS_FL_DATA_WR_ENA flags without updating flags.c, thus breaking the build. This patch also adds flag CL_FL_NOT_FIRST which was brought by commit 08088e77c.
2018-11-16 09:37:20 +00:00
SHOW_FLAG(f, CS_FL_NOT_FIRST);
CONTRIB: debug: add 4 missing connection/conn_stream flags The following flags were missing thus added : - CO_FL_SOCKS4_RECV - CO_FL_SOCKS4_SEND - CS_FL_READ_PARTIAL - CS_FL_KILL_CONN
2019-06-03 12:26:54 +00:00
SHOW_FLAG(f, CS_FL_KILL_CONN);
MINOR: debug: Add checks for conn_stream flags This may be carefully backported to 1.8 (a few flags don't exist there).
2018-03-01 07:55:21 +00:00
SHOW_FLAG(f, CS_FL_WAIT_FOR_HS);
CONTRIB: debug: report the CS and CF's EOI flags These ones indicate an end of input.
2019-03-25 17:34:28 +00:00
SHOW_FLAG(f, CS_FL_EOI);
MINOR: debug: Add checks for conn_stream flags This may be carefully backported to 1.8 (a few flags don't exist there).
2018-03-01 07:55:21 +00:00
SHOW_FLAG(f, CS_FL_EOS);
CONTRIB: debug: teach the "flags" utility about new conn_stream flags CS_FL_ERR_PENDING and CS_FL_WANT_ROOM were not added.
2018-12-17 20:58:03 +00:00
SHOW_FLAG(f, CS_FL_ERR_PENDING);
SHOW_FLAG(f, CS_FL_WANT_ROOM);
MINOR: debug: Add checks for conn_stream flags This may be carefully backported to 1.8 (a few flags don't exist there).
2018-03-01 07:55:21 +00:00
SHOW_FLAG(f, CS_FL_RCV_MORE);
SHOW_FLAG(f, CS_FL_ERROR);
SHOW_FLAG(f, CS_FL_SHWS);
SHOW_FLAG(f, CS_FL_SHWN);
SHOW_FLAG(f, CS_FL_SHRR);
SHOW_FLAG(f, CS_FL_SHRD);
if (f) {
printf("EXTRA(0x%08x)", f);
}
putchar('\n');
}
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
void show_si_et(unsigned int f)
{
printf("si->et = ");
if (!f) {
printf("SI_ET_NONE\n");
return;
}
SHOW_FLAG(f, SI_ET_QUEUE_TO);
SHOW_FLAG(f, SI_ET_QUEUE_ERR);
SHOW_FLAG(f, SI_ET_QUEUE_ABRT);
SHOW_FLAG(f, SI_ET_CONN_TO);
SHOW_FLAG(f, SI_ET_CONN_ERR);
SHOW_FLAG(f, SI_ET_CONN_ABRT);
SHOW_FLAG(f, SI_ET_CONN_RES);
SHOW_FLAG(f, SI_ET_CONN_OTHER);
SHOW_FLAG(f, SI_ET_DATA_TO);
SHOW_FLAG(f, SI_ET_DATA_ERR);
SHOW_FLAG(f, SI_ET_DATA_ABRT);
if (f) {
printf("EXTRA(0x%08x)", f);
}
putchar('\n');
}
void show_si_flags(unsigned int f)
{
printf("si->flags = ");
if (!f) {
printf("SI_FL_NONE\n");
return;
}
SHOW_FLAG(f, SI_FL_EXP);
SHOW_FLAG(f, SI_FL_ERR);
MINOR: stream-int: rename SI_FL_WAIT_ROOM to SI_FL_RXBLK_ROOM This flag is not enough to describe all blocking situations, as can be seen in each case we remove it. The muxes has taught us that using multiple blocking flags in parallel will be much easier, so let's start to do this now. This patch only renames this flags in order to make next changes more readable.
2018-11-14 10:10:26 +00:00
SHOW_FLAG(f, SI_FL_RXBLK_ROOM);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, SI_FL_WAIT_DATA);
SHOW_FLAG(f, SI_FL_ISBACK);
SHOW_FLAG(f, SI_FL_DONT_WAKE);
SHOW_FLAG(f, SI_FL_INDEP_STR);
SHOW_FLAG(f, SI_FL_NOLINGER);
SHOW_FLAG(f, SI_FL_NOHALF);
SHOW_FLAG(f, SI_FL_SRC_ADDR);
SHOW_FLAG(f, SI_FL_WANT_GET);
CONTRIB: debug: report stream-int's flag SI_FL_CLEAN_ABRT It was missing.
2018-12-18 08:54:22 +00:00
SHOW_FLAG(f, SI_FL_CLEAN_ABRT);
MINOR: stream-int: introduce new SI_FL_RXBLK flags The plan is to have the following flags to describe why a stream interface doesn't produce data : - SI_FL_RXBLK_CHAN : the channel doesn't want it to receive - SI_FL_RXBLK_BUFF : waiting for a buffer allocation to complete - SI_FL_RXBLK_ROOM : more room is required in the channel to receive - SI_FL_RXBLK_SHUT : input now closed, nothing new will come - SI_FL_RX_WAIT_EP : waiting for the endpoint to produce more data Applets like the CLI which consume complete commands at once and produce large chunks of responses will for example be able to stop being woken up by clearing SI_FL_WANT_GET and setting SI_FL_RXBLK_ROOM when the rx buffer is full. Once called they will unblock WANT_GET. The flags were moved together in readable form with the Rx bits using 2 hex digits and still have some room to do a similar operation on the Tx path later, with the WAIT_EP flag being represented alone on a digit.
2018-11-14 10:24:08 +00:00
SHOW_FLAG(f, SI_FL_RXBLK_CHAN);
SHOW_FLAG(f, SI_FL_RXBLK_BUFF);
SHOW_FLAG(f, SI_FL_RXBLK_ROOM);
SHOW_FLAG(f, SI_FL_RXBLK_SHUT);
SHOW_FLAG(f, SI_FL_RX_WAIT_EP);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
if (f) {
MINOR: stream-int: introduce new SI_FL_RXBLK flags The plan is to have the following flags to describe why a stream interface doesn't produce data : - SI_FL_RXBLK_CHAN : the channel doesn't want it to receive - SI_FL_RXBLK_BUFF : waiting for a buffer allocation to complete - SI_FL_RXBLK_ROOM : more room is required in the channel to receive - SI_FL_RXBLK_SHUT : input now closed, nothing new will come - SI_FL_RX_WAIT_EP : waiting for the endpoint to produce more data Applets like the CLI which consume complete commands at once and produce large chunks of responses will for example be able to stop being woken up by clearing SI_FL_WANT_GET and setting SI_FL_RXBLK_ROOM when the rx buffer is full. Once called they will unblock WANT_GET. The flags were moved together in readable form with the Rx bits using 2 hex digits and still have some room to do a similar operation on the Tx path later, with the WAIT_EP flag being represented alone on a digit.
2018-11-14 10:24:08 +00:00
printf("EXTRA(0x%08x)", f);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
}
putchar('\n');
}
void show_task_state(unsigned int f)
{
printf("task->state = ");
if (!f) {
printf("TASK_SLEEPING\n");
return;
}
SHOW_FLAG(f, TASK_WOKEN_OTHER);
SHOW_FLAG(f, TASK_WOKEN_RES);
SHOW_FLAG(f, TASK_WOKEN_MSG);
SHOW_FLAG(f, TASK_WOKEN_SIGNAL);
SHOW_FLAG(f, TASK_WOKEN_IO);
SHOW_FLAG(f, TASK_WOKEN_TIMER);
SHOW_FLAG(f, TASK_WOKEN_INIT);
SHOW_FLAG(f, TASK_RUNNING);
if (f) {
printf("EXTRA(0x%08x)", f);
}
putchar('\n');
}
void show_txn_flags(unsigned int f)
{
printf("txn->flags = ");
if (!f) {
printf("0\n");
return;
}
SHOW_FLAG(f, TX_NOT_FIRST);
SHOW_FLAG(f, TX_USE_PX_CONN);
SHOW_FLAG(f, TX_WAIT_NEXT_RQ);
MINOR: proto_http: Remove unused http txn flags Many flags of the HTTP transction (TX_*) are now unused and useless. So the flags TX_WAIT_CLEANUP, TX_HDR_CONN_*, TX_CON_CLO_SET and TX_CON_KAL_SET were removed. Most of TX_CON_WANT_* were also removed. Only TX_CON_WANT_TUN has been kept.
2019-07-16 12:32:23 +00:00
SHOW_FLAG(f, TX_CON_WANT_TUN);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, TX_CACHE_COOK);
SHOW_FLAG(f, TX_CACHEABLE);
SHOW_FLAG(f, TX_SCK_PRESENT);
//printf("%s", f ? "" : " | ");
switch (f & TX_SCK_MASK) {
case TX_SCK_NONE: f &= ~TX_SCK_MASK ; /*printf("TX_SCK_NONE%s", f ? " | " : "");*/ break;
case TX_SCK_FOUND: f &= ~TX_SCK_MASK ; printf("TX_SCK_FOUND%s", f ? " | " : ""); break;
case TX_SCK_DELETED: f &= ~TX_SCK_MASK ; printf("TX_SCK_DELETED%s", f ? " | " : ""); break;
case TX_SCK_INSERTED: f &= ~TX_SCK_MASK ; printf("TX_SCK_INSERTED%s", f ? " | " : ""); break;
case TX_SCK_REPLACED: f &= ~TX_SCK_MASK ; printf("TX_SCK_REPLACED%s", f ? " | " : ""); break;
case TX_SCK_UPDATED: f &= ~TX_SCK_MASK ; printf("TX_SCK_UPDATED%s", f ? " | " : ""); break;
default: printf("TX_SCK_MASK(%02x)", f); f &= ~TX_SCK_MASK ; printf("%s", f ? " | " : ""); break;
}
//printf("%s", f ? "" : " | ");
switch (f & TX_CK_MASK) {
case TX_CK_NONE: f &= ~TX_CK_MASK ; /*printf("TX_CK_NONE%s", f ? " | " : "");*/ break;
case TX_CK_INVALID: f &= ~TX_CK_MASK ; printf("TX_CK_INVALID%s", f ? " | " : ""); break;
case TX_CK_DOWN: f &= ~TX_CK_MASK ; printf("TX_CK_DOWN%s", f ? " | " : ""); break;
case TX_CK_VALID: f &= ~TX_CK_MASK ; printf("TX_CK_VALID%s", f ? " | " : ""); break;
case TX_CK_EXPIRED: f &= ~TX_CK_MASK ; printf("TX_CK_EXPIRED%s", f ? " | " : ""); break;
case TX_CK_OLD: f &= ~TX_CK_MASK ; printf("TX_CK_OLD%s", f ? " | " : ""); break;
case TX_CK_UNUSED: f &= ~TX_CK_MASK ; printf("TX_CK_UNUSED%s", f ? " | " : ""); break;
default: printf("TX_CK_MASK(%02x)", f); f &= ~TX_CK_MASK ; printf("%s", f ? " | " : ""); break;
}
SHOW_FLAG(f, TX_CLTARPIT);
SHOW_FLAG(f, TX_SVALLOW);
SHOW_FLAG(f, TX_SVDENY);
SHOW_FLAG(f, TX_CLALLOW);
SHOW_FLAG(f, TX_CLDENY);
if (f) {
printf("EXTRA(0x%08x)", f);
}
putchar('\n');
}
void show_strm_flags(unsigned int f)
{
printf("strm->flags = ");
if (!f) {
printf("0\n");
return;
}
SHOW_FLAG(f, SF_SRV_REUSED);
SHOW_FLAG(f, SF_IGNORE_PRST);
//printf("%s", f ? "" : " | ");
switch (f & SF_FINST_MASK) {
case SF_FINST_R: f &= ~SF_FINST_MASK ; printf("SF_FINST_R%s", f ? " | " : ""); break;
case SF_FINST_C: f &= ~SF_FINST_MASK ; printf("SF_FINST_C%s", f ? " | " : ""); break;
case SF_FINST_H: f &= ~SF_FINST_MASK ; printf("SF_FINST_H%s", f ? " | " : ""); break;
case SF_FINST_D: f &= ~SF_FINST_MASK ; printf("SF_FINST_D%s", f ? " | " : ""); break;
case SF_FINST_L: f &= ~SF_FINST_MASK ; printf("SF_FINST_L%s", f ? " | " : ""); break;
case SF_FINST_Q: f &= ~SF_FINST_MASK ; printf("SF_FINST_Q%s", f ? " | " : ""); break;
case SF_FINST_T: f &= ~SF_FINST_MASK ; printf("SF_FINST_T%s", f ? " | " : ""); break;
}
switch (f & SF_ERR_MASK) {
case SF_ERR_LOCAL: f &= ~SF_ERR_MASK ; printf("SF_ERR_LOCAL%s", f ? " | " : ""); break;
case SF_ERR_CLITO: f &= ~SF_ERR_MASK ; printf("SF_ERR_CLITO%s", f ? " | " : ""); break;
case SF_ERR_CLICL: f &= ~SF_ERR_MASK ; printf("SF_ERR_CLICL%s", f ? " | " : ""); break;
case SF_ERR_SRVTO: f &= ~SF_ERR_MASK ; printf("SF_ERR_SRVTO%s", f ? " | " : ""); break;
case SF_ERR_SRVCL: f &= ~SF_ERR_MASK ; printf("SF_ERR_SRVCL%s", f ? " | " : ""); break;
case SF_ERR_PRXCOND: f &= ~SF_ERR_MASK ; printf("SF_ERR_PRXCOND%s", f ? " | " : ""); break;
case SF_ERR_RESOURCE: f &= ~SF_ERR_MASK ; printf("SF_ERR_RESOURCE%s", f ? " | " : ""); break;
case SF_ERR_INTERNAL: f &= ~SF_ERR_MASK ; printf("SF_ERR_INTERNAL%s", f ? " | " : ""); break;
case SF_ERR_DOWN: f &= ~SF_ERR_MASK ; printf("SF_ERR_DOWN%s", f ? " | " : ""); break;
case SF_ERR_KILLED: f &= ~SF_ERR_MASK ; printf("SF_ERR_KILLED%s", f ? " | " : ""); break;
case SF_ERR_UP: f &= ~SF_ERR_MASK ; printf("SF_ERR_UP%s", f ? " | " : ""); break;
CONTRIB: debug/flags: add check for SF_ERR_CHK_PORT This flag was added by commit 95db2bc ("MAJOR: check: find out which port to use for health check at run time"), let's check for it.
2016-11-11 07:05:34 +00:00
case SF_ERR_CHK_PORT: f &= ~SF_ERR_MASK ; printf("SF_ERR_CHK_PORT%s", f ? " | " : ""); break;
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
}
CONTRIB: debug: add missing flags SF_HTX and SF_MUX These two were forgotten when HTX was added. They can be backported as they're missing for debugging traces in 2.0.
2020-02-06 06:57:36 +00:00
SHOW_FLAG(f, SF_HTX);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, SF_REDIRECTABLE);
CONTRIB: debug: add missing flags SF_HTX and SF_MUX These two were forgotten when HTX was added. They can be backported as they're missing for debugging traces in 2.0.
2020-02-06 06:57:36 +00:00
SHOW_FLAG(f, SF_IGNORE);
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
SHOW_FLAG(f, SF_REDISP);
SHOW_FLAG(f, SF_CURR_SESS);
SHOW_FLAG(f, SF_MONITOR);
SHOW_FLAG(f, SF_FORCE_PRST);
SHOW_FLAG(f, SF_BE_ASSIGNED);
SHOW_FLAG(f, SF_ADDR_SET);
SHOW_FLAG(f, SF_ASSIGNED);
SHOW_FLAG(f, SF_DIRECT);
if (f) {
printf("EXTRA(0x%08x)", f);
}
putchar('\n');
}
CONTRIB: debug: add the possibility to decode the value as certain types only It's often confusing to have a whole dump on the screen while only checking for a set of task or stream flags, and appending "|grep ^chn" isn't very convenient to repeat the opeation. Instead let's add the ability to filter the output as certain types only by prepending their name(s) before the value.
2020-02-06 07:33:08 +00:00
void usage_exit(const char *name)
{
CONTRIB: debug: support reporting multiple values at once It's often convenient, for example to dump two channels or two stream-int at once. Now all input values are decoded and the value is recalled before the dump when there is more than one to display.
2020-02-06 07:48:16 +00:00
fprintf(stderr, "Usage: %s [ana|chn|conn|cs|si|sierr|strm|task|txn]* [0x]value*\n", name);
CONTRIB: debug: add the possibility to decode the value as certain types only It's often confusing to have a whole dump on the screen while only checking for a set of task or stream flags, and appending "|grep ^chn" isn't very convenient to repeat the opeation. Instead let's add the ability to filter the output as certain types only by prepending their name(s) before the value.
2020-02-06 07:33:08 +00:00
exit(1);
}
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
int main(int argc, char **argv)
{
unsigned int flags;
CONTRIB: debug: add the possibility to decode the value as certain types only It's often confusing to have a whole dump on the screen while only checking for a set of task or stream flags, and appending "|grep ^chn" isn't very convenient to repeat the opeation. Instead let's add the ability to filter the output as certain types only by prepending their name(s) before the value.
2020-02-06 07:33:08 +00:00
unsigned int show_as = 0;
unsigned int f;
const char *name = argv[0];
CONTRIB: debug: support reporting multiple values at once It's often convenient, for example to dump two channels or two stream-int at once. Now all input values are decoded and the value is recalled before the dump when there is more than one to display.
2020-02-06 07:48:16 +00:00
int multi = 0;
CONTRIB: debug: add the possibility to decode the value as certain types only It's often confusing to have a whole dump on the screen while only checking for a set of task or stream flags, and appending "|grep ^chn" isn't very convenient to repeat the opeation. Instead let's add the ability to filter the output as certain types only by prepending their name(s) before the value.
2020-02-06 07:33:08 +00:00
char *err;
while (argc > 0) {
argv++; argc--;
if (argc < 1)
usage_exit(name);
f = get_show_as(argv[0]);
CONTRIB: debug: support reporting multiple values at once It's often convenient, for example to dump two channels or two stream-int at once. Now all input values are decoded and the value is recalled before the dump when there is more than one to display.
2020-02-06 07:48:16 +00:00
if (!f)
break;
CONTRIB: debug: add the possibility to decode the value as certain types only It's often confusing to have a whole dump on the screen while only checking for a set of task or stream flags, and appending "|grep ^chn" isn't very convenient to repeat the opeation. Instead let's add the ability to filter the output as certain types only by prepending their name(s) before the value.
2020-02-06 07:33:08 +00:00
show_as |= f;
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
}
CONTRIB: debug: add the possibility to decode the value as certain types only It's often confusing to have a whole dump on the screen while only checking for a set of task or stream flags, and appending "|grep ^chn" isn't very convenient to repeat the opeation. Instead let's add the ability to filter the output as certain types only by prepending their name(s) before the value.
2020-02-06 07:33:08 +00:00
if (!show_as)
show_as = ~0U;
CONTRIB: debug: support reporting multiple values at once It's often convenient, for example to dump two channels or two stream-int at once. Now all input values are decoded and the value is recalled before the dump when there is more than one to display.
2020-02-06 07:48:16 +00:00
if (argc > 1)
multi = 1;
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
CONTRIB: debug: support reporting multiple values at once It's often convenient, for example to dump two channels or two stream-int at once. Now all input values are decoded and the value is recalled before the dump when there is more than one to display.
2020-02-06 07:48:16 +00:00
while (argc > 0) {
flags = strtoul(argv[0], &err, 0);
if (!*argv[0] || *err) {
fprintf(stderr, "Unparsable value: <%s>\n", argv[0]);
usage_exit(name);
}
if (multi)
printf("### 0x%08x:\n", flags);
if (show_as & SHOW_AS_ANA) show_chn_ana(flags);
if (show_as & SHOW_AS_CHN) show_chn_flags(flags);
if (show_as & SHOW_AS_CONN) show_conn_flags(flags);
if (show_as & SHOW_AS_CS) show_cs_flags(flags);
if (show_as & SHOW_AS_SI) show_si_flags(flags);
if (show_as & SHOW_AS_SIET) show_si_et(flags);
if (show_as & SHOW_AS_STRM) show_strm_flags(flags);
if (show_as & SHOW_AS_TASK) show_task_state(flags);
if (show_as & SHOW_AS_TXN) show_txn_flags(flags);
argv++; argc--;
}
CONTRIB: initiate a debugging suite to make debugging easier The goal is to have a collection of quick-n-dirty utilities that make debugging easier and that can easily be modified when needed. The first utility in this series is called "flags". For a given numeric argument, it reports the various known combinations of flags for channels, streams and so on. This way it's easy to copy-paste values from the CLI or from gdb and immediately know what state a stream-interface or connection is in.
2015-12-20 22:21:57 +00:00
return 0;
}