debug.h File Reference

#include "lwip/arch.h"
#include "lwip/opt.h"

Macros
#define	LWIP_ASSERT(message, assertion)
#define	LWIP_DBG_FRESH   0x10U
	flag for LWIP_DEBUGF indicating newly added code, not thoroughly tested yet More...
#define	LWIP_DBG_HALT   0x08U
	flag for LWIP_DEBUGF to halt after printing this debug message More...
#define	LWIP_DBG_LEVEL_ALL   0x00
	lower two bits indicate debug level More...
#define	LWIP_DBG_LEVEL_OFF   LWIP_DBG_LEVEL_ALL /* compatibility define only */
#define	LWIP_DBG_LEVEL_SERIOUS   0x02 /* memory allocation failures, ... */
#define	LWIP_DBG_LEVEL_SEVERE   0x03
#define	LWIP_DBG_LEVEL_WARNING   0x01 /* bad checksums, dropped packets, ... */
#define	LWIP_DBG_MASK_LEVEL   0x03
#define	LWIP_DBG_OFF   0x00U
	flag for LWIP_DEBUGF to disable that debug message More...
#define	LWIP_DBG_ON   0x80U
	flag for LWIP_DEBUGF to enable that debug message More...
#define	LWIP_DBG_STATE   0x20U
	flag for LWIP_DEBUGF indicating a state debug message (to follow module states) More...
#define	LWIP_DBG_TRACE   0x40U
	flag for LWIP_DEBUGF indicating a tracing message (to follow program flow) More...
#define	LWIP_DEBUGF(debug, message)
	if "expression" isn't true, then print "message" and execute "handler" expression More...

#define LWIP_ASSERT	(		message,
			assertion
	)

Value:

do { if(!(assertion)) \
  LWIP_PLATFORM_ASSERT(message); } while(0)

Referenced by autoip_create_addr(), autoip_set_struct(), dhcp_cleanup(), dhcp_create_msg(), dhcp_delete_msg(), dhcp_option(), dhcp_option_byte(), dhcp_option_long(), dhcp_option_short(), dhcp_option_trailer(), dhcp_parse_reply(), dhcp_recv(), dhcp_set_struct(), dhcp_start(), dhcp_stop(), dns_check_entry(), dns_init(), dns_send(), err_tcp(), etharp_arp_input(), etharp_find_addr(), etharp_find_entry(), etharp_output(), etharp_output_to_arp_index(), etharp_query(), etharp_raw(), etharp_send_ip(), etharp_update_arp_entry(), ethernet_input(), ethip6_send(), event_callback(), icmp6_send_response(), icmp_input(), icmp_send_response(), if(), inet_cksum_pseudo_partial_base(), ip6_output_if_src(), ip6_reass(), ip6_reass_free_complete_datagram(), ip_frag(), ip_frag_free_pbuf_custom_ref(), ip_reass_chain_frag_into_datagram_and_validate(), ip_reass_dequeue_datagram(), ip_reass_free_complete_datagram(), ipaddr_aton(), ipfrag_free_pbuf_custom(), lwip_accept(), lwip_close(), lwip_getaddrinfo(), lwip_getsockopt_callback(), lwip_netconn_do_close(), lwip_netconn_do_close_internal(), lwip_netconn_do_connected(), lwip_netconn_do_delconn(), lwip_netconn_do_getaddr(), lwip_netconn_do_write(), lwip_netconn_do_writemore(), lwip_recvfrom(), lwip_select(), lwip_selscan(), lwip_sendto(), lwip_setsockopt_callback(), memp_free(), nd6_free_q(), netbuf_alloc(), netconn_alloc(), netconn_free(), netconn_new_with_proto_and_callback(), netconn_recv(), netconn_recv_data(), netif_add(), pbuf_alloc(), pbuf_alloced_custom(), pbuf_cat(), pbuf_coalesce(), pbuf_copy(), pbuf_dechain(), pbuf_free(), pbuf_header_impl(), pbuf_realloc(), pbuf_take(), pcb_new(), ping_send(), poll_tcp(), raw_input(), raw_sendto(), recv_tcp(), recv_udp(), sent_tcp(), tcp_abandon(), tcp_close_shutdown(), tcp_create_segment(), tcp_enqueue_flags(), tcp_err(), tcp_input(), tcp_output(), tcp_output_alloc_header(), tcp_output_segment(), tcp_pbuf_prealloc(), tcp_pcb_purge(), tcp_pcb_remove(), tcp_poll(), tcp_process(), tcp_receive(), tcp_recv(), tcp_recved(), tcp_rst_impl(), tcp_sent(), tcp_slowtmr(), tcp_update_rcv_ann_wnd(), tcp_write(), tcp_write_checks(), tcpip_apimsg(), tcpip_init(), tcpip_thread(), udp_bind(), and udp_input().

#define LWIP_DBG_FRESH   0x10U

flag for LWIP_DEBUGF indicating newly added code, not thoroughly tested yet

#define LWIP_DBG_HALT   0x08U

flag for LWIP_DEBUGF to halt after printing this debug message

#define LWIP_DBG_LEVEL_ALL   0x00

lower two bits indicate debug level

• 0 all
• 1 warning
• 2 serious
• 3 severe

#define LWIP_DBG_LEVEL_OFF   LWIP_DBG_LEVEL_ALL /* compatibility define only */

#define LWIP_DBG_LEVEL_SERIOUS   0x02 /* memory allocation failures, ... */

Referenced by dhcp_create_msg(), dhcp_decline(), dhcp_discover(), dhcp_handle_offer(), dhcp_inform(), dhcp_rebind(), dhcp_reboot(), dhcp_recv(), dhcp_release(), dhcp_renew(), etharp_output(), etharp_raw(), ethip6_output(), ip6_input(), ip6_output_if(), ip6_output_if_src(), ip_input(), ip_route(), pbuf_alloc(), pbuf_free(), pbuf_header_impl(), raw_sendto(), and udp_input().

#define LWIP_DBG_LEVEL_SEVERE   0x03

Referenced by tcp_write_checks().

#define LWIP_DBG_LEVEL_WARNING   0x01 /* bad checksums, dropped packets, ... */

Referenced by autoip_arp_reply(), dhcp_arp_reply(), dhcp_check(), dhcp_recv(), dhcp_select(), dns_check_entry(), etharp_arp_input(), ip6_input(), ip_input(), pbuf_alloced_custom(), and raw_sendto().

#define LWIP_DBG_MASK_LEVEL   0x03

#define LWIP_DBG_OFF   0x00U

flag for LWIP_DEBUGF to disable that debug message

#define LWIP_DBG_ON   0x80U

flag for LWIP_DEBUGF to enable that debug message

#define LWIP_DBG_STATE   0x20U

flag for LWIP_DEBUGF indicating a state debug message (to follow module states)

Referenced by autoip_arp_reply(), autoip_create_addr(), autoip_handle_arp_conflict(), autoip_start(), autoip_start_probing(), autoip_tmr(), dhcp_arp_reply(), dhcp_bind(), dhcp_check(), dhcp_coarse_tmr(), dhcp_decline(), dhcp_discover(), dhcp_fine_tmr(), dhcp_handle_offer(), dhcp_inform(), dhcp_rebind(), dhcp_reboot(), dhcp_release(), dhcp_renew(), dhcp_select(), dhcp_start(), dhcp_t1_timeout(), dhcp_t2_timeout(), dhcp_timeout(), netif_set_gw(), netif_set_ipaddr(), netif_set_netmask(), tcp_write(), tcp_write_checks(), udp_bind(), and udp_connect().

#define LWIP_DBG_TRACE   0x40U

flag for LWIP_DEBUGF indicating a tracing message (to follow program flow)

Referenced by autoip_arp_reply(), autoip_bind(), autoip_create_addr(), autoip_handle_arp_conflict(), autoip_start(), autoip_start_probing(), autoip_tmr(), dhcp_arp_reply(), dhcp_bind(), dhcp_check(), dhcp_coarse_tmr(), dhcp_create_msg(), dhcp_decline(), dhcp_discover(), dhcp_fine_tmr(), dhcp_handle_nak(), dhcp_handle_offer(), dhcp_inform(), dhcp_parse_reply(), dhcp_rebind(), dhcp_reboot(), dhcp_recv(), dhcp_release(), dhcp_renew(), dhcp_select(), dhcp_start(), dhcp_stop(), dhcp_t1_timeout(), dhcp_t2_timeout(), dhcp_timeout(), etharp_arp_input(), etharp_find_entry(), etharp_output(), etharp_query(), etharp_raw(), etharp_request(), etharp_send_ip(), etharp_update_arp_entry(), ethernet_input(), ethip6_output(), ethip6_send(), ip6_input(), ip_input(), nd6_queue_packet(), netif_set_gw(), netif_set_ipaddr(), netif_set_netmask(), pbuf_alloc(), pbuf_alloced_custom(), pbuf_chain(), pbuf_copy(), pbuf_dechain(), pbuf_free(), pbuf_free_ooseq(), pbuf_header_impl(), raw_new(), raw_sendto(), tcp_enqueue_flags(), tcp_write(), udp_bind(), udp_connect(), and udp_input().

#define LWIP_DEBUGF	(		debug,
			message
	)

Value:

do { \
                               if ( \
                                   ((debug) & LWIP_DBG_ON) && \
                                   ((debug) & LWIP_DBG_TYPES_ON) && \
                                   ((s16_t)((debug) & LWIP_DBG_MASK_LEVEL) >= LWIP_DBG_MIN_LEVEL)) { \
                                 LWIP_PLATFORM_DIAG(message); \
                                 if ((debug) & LWIP_DBG_HALT) { \
                                   while(1); \
                                 } \
                               } \
                             } while(0)

if "expression" isn't true, then print "message" and execute "handler" expression

print debug message only if debug message type is enabled... AND is of correct type AND is at least LWIP_DBG_LEVEL

Referenced by accept_function(), arp_timer(), autoip_arp_reply(), autoip_bind(), autoip_create_addr(), autoip_handle_arp_conflict(), autoip_start(), autoip_start_probing(), autoip_timer(), autoip_tmr(), dhcp_arp_reply(), dhcp_bind(), dhcp_check(), dhcp_coarse_tmr(), dhcp_create_msg(), dhcp_decline(), dhcp_discover(), dhcp_fine_tmr(), dhcp_handle_nak(), dhcp_handle_offer(), dhcp_inform(), dhcp_parse_reply(), dhcp_rebind(), dhcp_reboot(), dhcp_recv(), dhcp_release(), dhcp_renew(), dhcp_select(), dhcp_start(), dhcp_stop(), dhcp_t1_timeout(), dhcp_t2_timeout(), dhcp_timeout(), dhcp_timer_coarse(), dhcp_timer_fine(), dns_check_entry(), dns_enqueue(), dns_gethostbyname(), dns_init(), dns_lookup(), dns_recv(), dns_send(), dns_timer(), dns_tmr(), etharp_arp_input(), etharp_find_entry(), etharp_free_entry(), etharp_output(), etharp_query(), etharp_raw(), etharp_request(), etharp_send_ip(), etharp_tmr(), etharp_update_arp_entry(), ethernet_input(), ethip6_output(), ethip6_send(), get_socket(), icmp6_send_response(), icmp_input(), icmp_send_response(), inet_cksum_pseudo_base(), inet_cksum_pseudo_partial_base(), ip6_input(), ip6_options_add_hbh_ra(), ip6_output(), ip6_output_if(), ip6_output_if_src(), ip6_reass_timer(), ip_frag(), ip_input(), ip_output(), ip_reass(), ip_reass_enqueue_new_datagram(), ip_reass_timer(), ip_reass_tmr(), ip_route(), lwip_accept(), lwip_bind(), lwip_close(), lwip_connect(), lwip_fcntl(), lwip_getaddrname(), lwip_gethostbyname(), lwip_gethostbyname_r(), lwip_getsockopt_impl(), lwip_ioctl(), lwip_listen(), lwip_recvfrom(), lwip_select(), lwip_selscan(), lwip_send(), lwip_sendto(), lwip_setsockopt_impl(), lwip_shutdown(), lwip_socket(), mld6_timer(), nd6_queue_packet(), nd6_timer(), netconn_recv_data(), netconn_send(), netif_add(), netif_find(), netif_remove(), netif_set_default(), netif_set_gw(), netif_set_ipaddr(), netif_set_netmask(), pbuf_alloc(), pbuf_alloced_custom(), pbuf_chain(), pbuf_copy(), pbuf_dechain(), pbuf_free(), pbuf_free_ooseq(), pbuf_header_impl(), ping_function(), ping_recv(), raw_new(), raw_sendto(), tcp_abandon(), tcp_alloc(), tcp_bind(), tcp_close(), tcp_connect(), tcp_create_segment(), tcp_enqueue_flags(), tcp_fasttmr(), tcp_input(), tcp_keepalive(), tcp_kill_prio(), tcp_kill_timewait(), tcp_listen_input(), tcp_output(), tcp_output_segment(), tcp_parseopt(), tcp_pcb_purge(), tcp_process(), tcp_process_refused_data(), tcp_receive(), tcp_recved(), tcp_rexmit_fast(), tcp_rst_impl(), tcp_send_empty_ack(), tcp_slowtmr(), tcp_write(), tcp_write_checks(), tcp_zero_window_probe(), tcpip_input(), tcpip_thread(), udp_bind(), udp_connect(), and udp_input().