Data Structures
struct	lws_log_cx
struct	lws_log_ratelimit
union	lws_log_cx.u

Macros
#define	LLL_ERR (1 << 0)
#define	LLL_WARN (1 << 1)
#define	LLL_NOTICE (1 << 2)
#define	LLL_INFO (1 << 3)
#define	LLL_DEBUG (1 << 4)
#define	LLL_PARSER (1 << 5)
#define	LLL_HEADER (1 << 6)
#define	LLL_EXT (1 << 7)
#define	LLL_CLIENT (1 << 8)
#define	LLL_LATENCY (1 << 9)
#define	LLL_USER (1 << 10)
#define	LLL_THREAD (1 << 11)
#define	LLL_COUNT (12) /* set to count of valid flags */
#define	LLLF_SECRECY_PII (1 << 16)
#define	LLLF_SECRECY_BEARER (1 << 17)
#define	LLLF_LOG_TIMESTAMP (1 << 18)
#define	LLLF_LOG_CONTEXT_AWARE (1 << 30)
#define	LWS_RATELIMIT_DEFINE_STATIC(_name)
#define	lwsl_cx(_c, _fil, ...)
#define	lwsl_vhost(_v, _fil, ...)
#define	lwsl_wsi(_w, _fil, ...)
#define	lwsl_ss(_h, _fil, ...)
#define	lwsl_hexdump_context(_c, _fil, _buf, _len)
#define	lwsl_hexdump_vhost(_v, _fil, _buf, _len)
#define	lwsl_hexdump_wsi(_w, _fil, _buf, _len)
#define	lwsl_hexdump_ss(_h, _fil, _buf, _len)
#define	_LWS_LINIT (LLL_ERR \| LLL_USER \| LLL_WARN \| LLL_NOTICE)
#define	_LWS_LBS 0
#define	_LWS_LBC 0
#define	_LWS_ENABLED_LOGS (((_LWS_LINIT) \| (_LWS_LBS)) & ~(_LWS_LBC))
#define	lwsl_err(...)
#define	lwsl_warn(...)
#define	lwsl_notice(...)
#define	lwsl_info(...)
#define	lwsl_debug(...)
#define	lwsl_parser(...)
#define	lwsl_header(...)
#define	lwsl_ext(...)
#define	lwsl_client(...)
#define	lwsl_latency(...)
#define	lwsl_thread(...)
#define	lwsl_user(...)
#define	lwsl_hexdump_user(...)
#define	lwsl_hexdump_err(...)
#define	lwsl_hexdump_warn(...)
#define	lwsl_hexdump_notice(...)
#define	lwsl_hexdump_info(...)
#define	lwsl_hexdump_debug(...)
#define	lwsl_cx_err(_c, ...)
#define	lwsl_cx_warn(_c, ...)
#define	lwsl_cx_notice(_c, ...)
#define	lwsl_cx_info(_c, ...)
#define	lwsl_cx_debug(_c, ...)
#define	lwsl_cx_parser(_c, ...)
#define	lwsl_cx_header(_c, ...)
#define	lwsl_cx_ext(_c, ...)
#define	lwsl_cx_client(_c, ...)
#define	lwsl_cx_latency(_c, ...)
#define	lwsl_cx_thread(_c, ...)
#define	lwsl_cx_user(_c, ...)
#define	lwsl_hexdump_cx_err(_c, ...)
#define	lwsl_hexdump_cx_warn(_c, ...)
#define	lwsl_hexdump_cx_notice(_c, ...)
#define	lwsl_hexdump_cx_info(_c, ...)
#define	lwsl_hexdump_cx_debug(_c, ...)
#define	lwsl_vhost_err(_v, ...)
#define	lwsl_vhost_warn(_v, ...)
#define	lwsl_vhost_notice(_v, ...)
#define	lwsl_vhost_info(_v, ...)
#define	lwsl_vhost_debug(_v, ...)
#define	lwsl_vhost_parser(_v, ...)
#define	lwsl_vhost_header(_v, ...)
#define	lwsl_vhost_ext(_v, ...)
#define	lwsl_vhost_client(_v, ...)
#define	lwsl_vhost_latency(_v, ...)
#define	lwsl_vhost_thread(_v, ...)
#define	lwsl_vhost_user(_v, ...)
#define	lwsl_hexdump_vhost_err(_v, ...)
#define	lwsl_hexdump_vhost_warn(_v, ...)
#define	lwsl_hexdump_vhost_notice(_v, ...)
#define	lwsl_hexdump_vhost_info(_v, ...)
#define	lwsl_hexdump_vhost_debug(_v, ...)
#define	lwsl_wsi_err(_w, ...)
#define	lwsl_wsi_warn(_w, ...)
#define	lwsl_wsi_notice(_w, ...)
#define	lwsl_wsi_info(_w, ...)
#define	lwsl_wsi_debug(_w, ...)
#define	lwsl_wsi_parser(_w, ...)
#define	lwsl_wsi_header(_w, ...)
#define	lwsl_wsi_ext(_w, ...)
#define	lwsl_wsi_client(_w, ...)
#define	lwsl_wsi_latency(_w, ...)
#define	lwsl_wsi_thread(_w, ...)
#define	lwsl_wsi_user(_w, ...)
#define	lwsl_hexdump_wsi_err(_v, ...)
#define	lwsl_hexdump_wsi_warn(_v, ...)
#define	lwsl_hexdump_wsi_notice(_v, ...)
#define	lwsl_hexdump_wsi_info(_v, ...)
#define	lwsl_hexdump_wsi_debug(_v, ...)
#define	lwsl_hexdump_wsi_user(_v, ...)
#define	lwsl_ss_err(_w, ...)
#define	lwsl_ss_warn(_w, ...)
#define	lwsl_ss_notice(_w, ...)
#define	lwsl_ss_info(_w, ...)
#define	lwsl_ss_debug(_w, ...)
#define	lwsl_ss_parser(_w, ...)
#define	lwsl_ss_header(_w, ...)
#define	lwsl_ss_ext(_w, ...)
#define	lwsl_ss_client(_w, ...)
#define	lwsl_ss_latency(_w, ...)
#define	lwsl_ss_thread(_w, ...)
#define	lwsl_ss_user(_w, ...)
#define	lwsl_hexdump_ss_err(_v, ...)
#define	lwsl_hexdump_ss_warn(_v, ...)
#define	lwsl_hexdump_ss_notice(_v, ...)
#define	lwsl_hexdump_ss_info(_v, ...)
#define	lwsl_hexdump_ss_debug(_v, ...)

Typedefs
typedef void(*	lws_log_emit_t) (int level, const char *line)
typedef void(*	lws_log_emit_cx_t) (struct lws_log_cx cx, int level, const char line, size_t len)
typedef void(*	lws_log_prepend_cx_t) (struct lws_log_cx cx, void obj, char *p, char e)
typedef void(*	lws_log_use_cx_t) (struct lws_log_cx *cx, int _new)
typedef struct lws_log_cx	lws_log_cx_t
typedef struct lws_log_ratelimit	lws_log_ratelimit_t

Functions
LWS_VISIBLE LWS_EXTERN int	lwsl_timestamp (int level, char *p, size_t len)
LWS_VISIBLE LWS_EXTERN uint32_t	lws_log_ratelimit_check (lws_log_ratelimit_t *rl, int64_t interval_us)
LWS_VISIBLE LWS_EXTERN void	_lws_log_rl (int filter, uint32_t dropped, const char *format,...) LWS_FORMAT(3)
LWS_VISIBLE LWS_EXTERN void	_lws_log_cx_rl (lws_log_cx_t cx, lws_log_prepend_cx_t prep, void obj, int filter, uint32_t dropped, const char _fun, const char format,...) LWS_FORMAT(7)
LWS_VISIBLE LWS_EXTERN void	_lws_log (int filter, const char *format,...) LWS_FORMAT(2)
LWS_VISIBLE LWS_EXTERN void	_lws_logv (int filter, const char *format, va_list vl)
LWS_VISIBLE LWS_EXTERN struct lws_log_cx *	lwsl_context_get_cx (struct lws_context *cx)
LWS_VISIBLE LWS_EXTERN struct lws_log_cx *	lwsl_vhost_get_cx (struct lws_vhost *vh)
LWS_VISIBLE LWS_EXTERN struct lws_log_cx *	lwsl_wsi_get_cx (struct lws *wsi)
LWS_VISIBLE LWS_EXTERN void	lws_log_emit_cx_file (struct lws_log_cx cx, int level, const char line, size_t len)
LWS_VISIBLE LWS_EXTERN void	lws_log_use_cx_file (struct lws_log_cx *cx, int _new)
LWS_VISIBLE LWS_EXTERN void	lws_log_prepend_context (struct lws_log_cx cx, void obj, char *p, char e)
LWS_VISIBLE LWS_EXTERN void	lws_log_prepend_vhost (struct lws_log_cx cx, void obj, char *p, char e)
LWS_VISIBLE LWS_EXTERN void	lws_log_prepend_wsi (struct lws_log_cx cx, void obj, char *p, char e)
LWS_VISIBLE LWS_EXTERN void	_lws_log_cx (lws_log_cx_t cx, lws_log_prepend_cx_t prep, void obj, int filter, const char _fun, const char format,...) LWS_FORMAT(6)
LWS_VISIBLE LWS_EXTERN void	lwsl_hexdump_level (int level, const void *vbuf, size_t len)
LWS_VISIBLE LWS_EXTERN void	lwsl_hexdump_level_cx (lws_log_cx_t cx, lws_log_prepend_cx_t prep, void obj, int hexdump_level, const void *vbuf, size_t len)
LWS_VISIBLE LWS_EXTERN void	lwsl_hexdump (const void *buf, size_t len)
LWS_VISIBLE LWS_EXTERN void	lws_set_log_level (int level, lws_log_emit_t log_emit_function)
LWS_VISIBLE LWS_EXTERN void	lwsl_emit_syslog (int level, const char *line)
LWS_VISIBLE LWS_EXTERN void	lwsl_emit_stderr (int level, const char *line)
LWS_VISIBLE LWS_EXTERN void	lwsl_emit_stderr_notimestamp (int level, const char *line)
LWS_VISIBLE LWS_EXTERN int	lwsl_visible (int level)
LWS_VISIBLE LWS_EXTERN const char *	lws_wsi_tag (struct lws *wsi)
LWS_VISIBLE LWS_EXTERN void	lwsl_refcount_cx (lws_log_cx_t *cx, int _new)

Detailed Description

Logging

Lws provides flexible and filterable logging facilities, which can be used inside lws and in user code.

Log categories may be individually filtered bitwise, and directed to built-in sinks for syslog-compatible logging, or a user-defined function.

Traditional logs use a single, processwide logging context. New style log apis (lws_xxx_cx()) can pass the logging context to use in.

Data Structure Documentation

◆ lws_log_ratelimit

struct lws_log_ratelimit

Definition at line 128 of file lws-logs.h.

Collaboration diagram for lws_log_ratelimit:

Data Fields
int64_t	next_log_us
uint32_t	dropped

◆ lws_log_cx.u

union lws_log_cx.u

Definition at line 81 of file lws-logs.h.

Collaboration diagram for lws_log_cx.u:

Data Fields
lws_log_emit_t	emit
lws_log_emit_cx_t	emit_cx

Macro Definition Documentation

◆ LLL_ERR

#define LLL_ERR (1 << 0)

#include <lws-logs.h>

Definition at line 40 of file lws-logs.h.

◆ LLL_WARN

#define LLL_WARN (1 << 1)

#include <lws-logs.h>

Definition at line 41 of file lws-logs.h.

◆ LLL_NOTICE

#define LLL_NOTICE (1 << 2)

#include <lws-logs.h>

Definition at line 42 of file lws-logs.h.

◆ LLL_INFO

#define LLL_INFO (1 << 3)

#include <lws-logs.h>

Definition at line 43 of file lws-logs.h.

◆ LLL_DEBUG

#define LLL_DEBUG (1 << 4)

#include <lws-logs.h>

Definition at line 44 of file lws-logs.h.

◆ LLL_PARSER

#define LLL_PARSER (1 << 5)

#include <lws-logs.h>

Definition at line 45 of file lws-logs.h.

◆ LLL_HEADER

#define LLL_HEADER (1 << 6)

#include <lws-logs.h>

Definition at line 46 of file lws-logs.h.

◆ LLL_EXT

#define LLL_EXT (1 << 7)

#include <lws-logs.h>

Definition at line 47 of file lws-logs.h.

◆ LLL_CLIENT

#define LLL_CLIENT (1 << 8)

#include <lws-logs.h>

Definition at line 48 of file lws-logs.h.

◆ LLL_LATENCY

#define LLL_LATENCY (1 << 9)

#include <lws-logs.h>

Definition at line 49 of file lws-logs.h.

◆ LLL_USER

#define LLL_USER (1 << 10)

#include <lws-logs.h>

Definition at line 50 of file lws-logs.h.

◆ LLL_THREAD

#define LLL_THREAD (1 << 11)

#include <lws-logs.h>

Definition at line 51 of file lws-logs.h.

◆ LLL_COUNT

#define LLL_COUNT (12) /* set to count of valid flags */

#include <lws-logs.h>

Definition at line 53 of file lws-logs.h.

◆ LLLF_SECRECY_PII

#define LLLF_SECRECY_PII (1 << 16)

#include <lws-logs.h>

contains Personally Identifiable Information

Definition at line 55 of file lws-logs.h.

◆ LLLF_SECRECY_BEARER

#define LLLF_SECRECY_BEARER (1 << 17)

#include <lws-logs.h>

possession of this data allows impersonation

Definition at line 57 of file lws-logs.h.

◆ LLLF_LOG_TIMESTAMP

#define LLLF_LOG_TIMESTAMP (1 << 18)

#include <lws-logs.h>

set to prepend logs with timestamp

Definition at line 60 of file lws-logs.h.

◆ LLLF_LOG_CONTEXT_AWARE

#define LLLF_LOG_CONTEXT_AWARE (1 << 30)

#include <lws-logs.h>

set if the context uses an emit function that takes the logctx, auto- applied when setting emit using lws_set_log_level_cx() api

Definition at line 63 of file lws-logs.h.

◆ LWS_RATELIMIT_DEFINE_STATIC

#define LWS_RATELIMIT_DEFINE_STATIC ( _name )

#include <lws-logs.h>

Value:

static lws_log_ratelimit_t _name = { 0, 0 }

lws_log_ratelimit_t

struct lws_log_ratelimit lws_log_ratelimit_t

Definition at line 133 of file lws-logs.h.

133#define LWS_RATELIMIT_DEFINE_STATIC(_name) \

134 static lws_log_ratelimit_t _name = { 0, 0 }

◆ lwsl_cx

#define lwsl_cx	(	_c,
		_fil,
		... )

#include <lws-logs.h>

Value:

_lws_log_cx(lwsl_context_get_cx(_c), lws_log_prepend_context, \

_c, _fil, __func__, __VA_ARGS__)

lwsl_context_get_cx

LWS_VISIBLE LWS_EXTERN struct lws_log_cx * lwsl_context_get_cx(struct lws_context *cx)

_lws_log_cx

LWS_VISIBLE LWS_EXTERN void _lws_log_cx(lws_log_cx_t *cx, lws_log_prepend_cx_t prep, void *obj, int filter, const char *_fun, const char *format,...) LWS_FORMAT(6)

lws_log_prepend_context

LWS_VISIBLE LWS_EXTERN void lws_log_prepend_context(struct lws_log_cx *cx, void *obj, char **p, char *e)

Definition at line 202 of file lws-logs.h.

#define lwsl_cx(_c, _fil, ...) \
                 _lws_log_cx(lwsl_context_get_cx(_c), lws_log_prepend_context, \
                                        _c, _fil, __func__, __VA_ARGS__)

◆ lwsl_vhost

#define lwsl_vhost	(	_v,
		_fil,
		... )

#include <lws-logs.h>

Value:

_lws_log_cx(lwsl_vhost_get_cx(_v), lws_log_prepend_vhost, _v, \

_fil, __func__, __VA_ARGS__)

lws_log_prepend_vhost

LWS_VISIBLE LWS_EXTERN void lws_log_prepend_vhost(struct lws_log_cx *cx, void *obj, char **p, char *e)

lwsl_vhost_get_cx

LWS_VISIBLE LWS_EXTERN struct lws_log_cx * lwsl_vhost_get_cx(struct lws_vhost *vh)

Definition at line 205 of file lws-logs.h.

#define lwsl_vhost(_v, _fil, ...) \
                 _lws_log_cx(lwsl_vhost_get_cx(_v), lws_log_prepend_vhost, _v, \
                                        _fil, __func__, __VA_ARGS__)

◆ lwsl_wsi

#define lwsl_wsi	(	_w,
		_fil,
		... )

#include <lws-logs.h>

Value:

_lws_log_cx(lwsl_wsi_get_cx(_w), lws_log_prepend_wsi, _w, \

_fil, __func__, __VA_ARGS__)

lwsl_wsi_get_cx

LWS_VISIBLE LWS_EXTERN struct lws_log_cx * lwsl_wsi_get_cx(struct lws *wsi)

lws_log_prepend_wsi

LWS_VISIBLE LWS_EXTERN void lws_log_prepend_wsi(struct lws_log_cx *cx, void *obj, char **p, char *e)

Definition at line 208 of file lws-logs.h.

#define lwsl_wsi(_w, _fil, ...) \
                 _lws_log_cx(lwsl_wsi_get_cx(_w), lws_log_prepend_wsi, _w, \
                                        _fil, __func__, __VA_ARGS__)

◆ lwsl_ss

#define lwsl_ss	(	_h,
		_fil,
		... )

#include <lws-logs.h>

Value:

_lws_log_cx(lwsl_ss_get_cx(_h), lws_log_prepend_ss, _h, \

_fil, __func__, __VA_ARGS__)

Definition at line 211 of file lws-logs.h.

#define lwsl_ss(_h, _fil, ...) \
                 _lws_log_cx(lwsl_ss_get_cx(_h), lws_log_prepend_ss, _h, \
                                        _fil, __func__, __VA_ARGS__)

◆ lwsl_hexdump_context

#define lwsl_hexdump_context	(	_c,
		_fil,
		_buf,
		_len )

#include <lws-logs.h>

Value:

lwsl_hexdump_level_cx(lwsl_context_get_cx(_c), \
                      lws_log_prepend_context, \
                      _c, _fil, _buf, _len)

Definition at line 215 of file lws-logs.h.

#define lwsl_hexdump_context(_c, _fil, _buf, _len) \
                lwsl_hexdump_level_cx(lwsl_context_get_cx(_c), \
                                      lws_log_prepend_context, \
                                      _c, _fil, _buf, _len)

◆ lwsl_hexdump_vhost

#define lwsl_hexdump_vhost	(	_v,
		_fil,
		_buf,
		_len )

#include <lws-logs.h>

Value:

lwsl_hexdump_level_cx(lwsl_vhost_get_cx(_v), \
                      lws_log_prepend_vhost, \
                      _v, _fil, _buf, _len)

Definition at line 219 of file lws-logs.h.

#define lwsl_hexdump_vhost(_v, _fil, _buf, _len) \
                lwsl_hexdump_level_cx(lwsl_vhost_get_cx(_v), \
                                      lws_log_prepend_vhost, \
                                      _v, _fil, _buf, _len)

◆ lwsl_hexdump_wsi

#define lwsl_hexdump_wsi	(	_w,
		_fil,
		_buf,
		_len )

#include <lws-logs.h>

Value:

lwsl_hexdump_level_cx(lwsl_wsi_get_cx(_w), \
                      lws_log_prepend_wsi, \
                      _w, _fil, _buf, _len)

Definition at line 223 of file lws-logs.h.

#define lwsl_hexdump_wsi(_w, _fil, _buf, _len) \
                lwsl_hexdump_level_cx(lwsl_wsi_get_cx(_w), \
                                      lws_log_prepend_wsi, \
                                      _w, _fil, _buf, _len)

◆ lwsl_hexdump_ss

#define lwsl_hexdump_ss	(	_h,
		_fil,
		_buf,
		_len )

#include <lws-logs.h>

Value:

lwsl_hexdump_level_cx(lwsl_ss_get_cx(_h), \
                      lws_log_prepend_ss, \
                      _h, _fil, _buf, _len)

Definition at line 227 of file lws-logs.h.

#define lwsl_hexdump_ss(_h, _fil, _buf, _len) \
                lwsl_hexdump_level_cx(lwsl_ss_get_cx(_h), \
                                      lws_log_prepend_ss, \
                                      _h, _fil, _buf, _len)

◆ _LWS_LINIT

#define _LWS_LINIT (LLL_ERR | LLL_USER | LLL_WARN | LLL_NOTICE)

#include <lws-logs.h>

Definition at line 249 of file lws-logs.h.

◆ _LWS_LBS

#define _LWS_LBS 0

#include <lws-logs.h>

Definition at line 265 of file lws-logs.h.

◆ _LWS_LBC

#define _LWS_LBC 0

#include <lws-logs.h>

Definition at line 271 of file lws-logs.h.

◆ _LWS_ENABLED_LOGS

#define _LWS_ENABLED_LOGS (((_LWS_LINIT) | (_LWS_LBS)) & ~(_LWS_LBC))

#include <lws-logs.h>

Definition at line 277 of file lws-logs.h.

◆ lwsl_err

#define lwsl_err ( ... )

#include <lws-logs.h>

Value:

_lws_log(LLL_ERR, __VA_ARGS__)

_lws_log

LWS_VISIBLE LWS_EXTERN void _lws_log(int filter, const char *format,...) LWS_FORMAT(2)

LLL_ERR

#define LLL_ERR

Definition lws-logs.h:40

Definition at line 289 of file lws-logs.h.

◆ lwsl_warn

#define lwsl_warn ( ... )

#include <lws-logs.h>

Value:

_lws_log(LLL_WARN, __VA_ARGS__)

LLL_WARN

#define LLL_WARN

Definition lws-logs.h:41

Definition at line 295 of file lws-logs.h.

◆ lwsl_notice

#define lwsl_notice ( ... )

#include <lws-logs.h>

Value:

_lws_log(LLL_NOTICE, __VA_ARGS__)

LLL_NOTICE

#define LLL_NOTICE

Definition lws-logs.h:42

Definition at line 301 of file lws-logs.h.

◆ lwsl_info

#define lwsl_info ( ... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 309 of file lws-logs.h.

◆ lwsl_debug

#define lwsl_debug ( ... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 315 of file lws-logs.h.

◆ lwsl_parser

#define lwsl_parser ( ... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 321 of file lws-logs.h.

◆ lwsl_header

#define lwsl_header ( ... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 327 of file lws-logs.h.

◆ lwsl_ext

#define lwsl_ext ( ... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 333 of file lws-logs.h.

◆ lwsl_client

#define lwsl_client ( ... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 339 of file lws-logs.h.

◆ lwsl_latency

#define lwsl_latency ( ... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 345 of file lws-logs.h.

◆ lwsl_thread

#define lwsl_thread ( ... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 351 of file lws-logs.h.

◆ lwsl_user

#define lwsl_user ( ... )

#include <lws-logs.h>

Value:

_lws_log(LLL_USER, __VA_ARGS__)

LLL_USER

#define LLL_USER

Definition lws-logs.h:50

Definition at line 355 of file lws-logs.h.

◆ lwsl_hexdump_user

#define lwsl_hexdump_user ( ... )

#include <lws-logs.h>

Value:

lwsl_hexdump_level(LLL_USER, __VA_ARGS__)

lwsl_hexdump_level

LWS_VISIBLE LWS_EXTERN void lwsl_hexdump_level(int level, const void *vbuf, size_t len)

Definition at line 360 of file lws-logs.h.

◆ lwsl_hexdump_err

#define lwsl_hexdump_err ( ... )

#include <lws-logs.h>

Value:

lwsl_hexdump_level(LLL_ERR, __VA_ARGS__)

Definition at line 361 of file lws-logs.h.

◆ lwsl_hexdump_warn

#define lwsl_hexdump_warn ( ... )

#include <lws-logs.h>

Value:

lwsl_hexdump_level(LLL_WARN, __VA_ARGS__)

Definition at line 362 of file lws-logs.h.

◆ lwsl_hexdump_notice

#define lwsl_hexdump_notice ( ... )

#include <lws-logs.h>

Value:

lwsl_hexdump_level(LLL_NOTICE, __VA_ARGS__)

Definition at line 363 of file lws-logs.h.

◆ lwsl_hexdump_info

#define lwsl_hexdump_info ( ... )

#include <lws-logs.h>

Value:

lwsl_hexdump_level(LLL_INFO, __VA_ARGS__)

LLL_INFO

#define LLL_INFO

Definition lws-logs.h:43

Definition at line 364 of file lws-logs.h.

◆ lwsl_hexdump_debug

#define lwsl_hexdump_debug ( ... )

#include <lws-logs.h>

Value:

lwsl_hexdump_level(LLL_DEBUG, __VA_ARGS__)

LLL_DEBUG

#define LLL_DEBUG

Definition lws-logs.h:44

Definition at line 365 of file lws-logs.h.

◆ lwsl_cx_err

#define lwsl_cx_err	(		_c,
			... )

#include <lws-logs.h>

Value:

lwsl_cx(_c, LLL_ERR, __VA_ARGS__)

lwsl_cx

#define lwsl_cx(_c, _fil,...)

Definition lws-logs.h:202

Definition at line 372 of file lws-logs.h.

◆ lwsl_cx_warn

#define lwsl_cx_warn	(		_c,
			... )

#include <lws-logs.h>

Value:

lwsl_cx(_c, LLL_WARN, __VA_ARGS__)

Definition at line 378 of file lws-logs.h.

◆ lwsl_cx_notice

#define lwsl_cx_notice	(		_c,
			... )

#include <lws-logs.h>

Value:

lwsl_cx(_c, LLL_NOTICE, __VA_ARGS__)

Definition at line 384 of file lws-logs.h.

◆ lwsl_cx_info

#define lwsl_cx_info	(		_c,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 392 of file lws-logs.h.

◆ lwsl_cx_debug

#define lwsl_cx_debug	(		_c,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 398 of file lws-logs.h.

◆ lwsl_cx_parser

#define lwsl_cx_parser	(		_c,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 404 of file lws-logs.h.

◆ lwsl_cx_header

#define lwsl_cx_header	(		_c,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 410 of file lws-logs.h.

◆ lwsl_cx_ext

#define lwsl_cx_ext	(		_c,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 416 of file lws-logs.h.

◆ lwsl_cx_client

#define lwsl_cx_client	(		_c,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 422 of file lws-logs.h.

◆ lwsl_cx_latency

#define lwsl_cx_latency	(		_c,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 428 of file lws-logs.h.

◆ lwsl_cx_thread

#define lwsl_cx_thread	(		_c,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 434 of file lws-logs.h.

◆ lwsl_cx_user

#define lwsl_cx_user	(		_c,
			... )

#include <lws-logs.h>

Value:

lwsl_cx(_c, LLL_USER, __VA_ARGS__)

Definition at line 438 of file lws-logs.h.

◆ lwsl_hexdump_cx_err

#define lwsl_hexdump_cx_err	(		_c,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_context(_c, LLL_ERR, __VA_ARGS__)

lwsl_hexdump_context

#define lwsl_hexdump_context(_c, _fil, _buf, _len)

Definition lws-logs.h:215

Definition at line 443 of file lws-logs.h.

◆ lwsl_hexdump_cx_warn

#define lwsl_hexdump_cx_warn	(		_c,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_context(_c, LLL_WARN, __VA_ARGS__)

Definition at line 444 of file lws-logs.h.

◆ lwsl_hexdump_cx_notice

#define lwsl_hexdump_cx_notice	(		_c,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_context(_c, LLL_NOTICE, __VA_ARGS__)

Definition at line 445 of file lws-logs.h.

◆ lwsl_hexdump_cx_info

#define lwsl_hexdump_cx_info	(		_c,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_context(_c, LLL_INFO, __VA_ARGS__)

Definition at line 446 of file lws-logs.h.

◆ lwsl_hexdump_cx_debug

#define lwsl_hexdump_cx_debug	(		_c,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_context(_c, LLL_DEBUG, __VA_ARGS__)

Definition at line 447 of file lws-logs.h.

◆ lwsl_vhost_err

#define lwsl_vhost_err	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_vhost(_v, LLL_ERR, __VA_ARGS__)

lwsl_vhost

#define lwsl_vhost(_v, _fil,...)

Definition lws-logs.h:205

Definition at line 454 of file lws-logs.h.

◆ lwsl_vhost_warn

#define lwsl_vhost_warn	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_vhost(_v, LLL_WARN, __VA_ARGS__)

Definition at line 460 of file lws-logs.h.

◆ lwsl_vhost_notice

#define lwsl_vhost_notice	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_vhost(_v, LLL_NOTICE, __VA_ARGS__)

Definition at line 466 of file lws-logs.h.

◆ lwsl_vhost_info

#define lwsl_vhost_info	(		_v,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 474 of file lws-logs.h.

◆ lwsl_vhost_debug

#define lwsl_vhost_debug	(		_v,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 480 of file lws-logs.h.

◆ lwsl_vhost_parser

#define lwsl_vhost_parser	(		_v,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 486 of file lws-logs.h.

◆ lwsl_vhost_header

#define lwsl_vhost_header	(		_v,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 492 of file lws-logs.h.

◆ lwsl_vhost_ext

#define lwsl_vhost_ext	(		_v,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 498 of file lws-logs.h.

◆ lwsl_vhost_client

#define lwsl_vhost_client	(		_v,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 504 of file lws-logs.h.

◆ lwsl_vhost_latency

#define lwsl_vhost_latency	(		_v,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 510 of file lws-logs.h.

◆ lwsl_vhost_thread

#define lwsl_vhost_thread	(		_v,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 516 of file lws-logs.h.

◆ lwsl_vhost_user

#define lwsl_vhost_user	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_vhost(_v, LLL_USER, __VA_ARGS__)

Definition at line 520 of file lws-logs.h.

◆ lwsl_hexdump_vhost_err

#define lwsl_hexdump_vhost_err	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_vhost(_v, LLL_ERR, __VA_ARGS__)

lwsl_hexdump_vhost

#define lwsl_hexdump_vhost(_v, _fil, _buf, _len)

Definition lws-logs.h:219

Definition at line 525 of file lws-logs.h.

◆ lwsl_hexdump_vhost_warn

#define lwsl_hexdump_vhost_warn	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_vhost(_v, LLL_WARN, __VA_ARGS__)

Definition at line 526 of file lws-logs.h.

◆ lwsl_hexdump_vhost_notice

#define lwsl_hexdump_vhost_notice	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_vhost(_v, LLL_NOTICE, __VA_ARGS__)

Definition at line 527 of file lws-logs.h.

◆ lwsl_hexdump_vhost_info

#define lwsl_hexdump_vhost_info	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_vhost(_v, LLL_INFO, __VA_ARGS__)

Definition at line 528 of file lws-logs.h.

◆ lwsl_hexdump_vhost_debug

#define lwsl_hexdump_vhost_debug	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_vhost(_v, LLL_DEBUG, __VA_ARGS__)

Definition at line 529 of file lws-logs.h.

◆ lwsl_wsi_err

#define lwsl_wsi_err	(		_w,
			... )

#include <lws-logs.h>

Value:

lwsl_wsi(_w, LLL_ERR, __VA_ARGS__)

lwsl_wsi

#define lwsl_wsi(_w, _fil,...)

Definition lws-logs.h:208

Definition at line 537 of file lws-logs.h.

◆ lwsl_wsi_warn

#define lwsl_wsi_warn	(		_w,
			... )

#include <lws-logs.h>

Value:

lwsl_wsi(_w, LLL_WARN, __VA_ARGS__)

Definition at line 543 of file lws-logs.h.

◆ lwsl_wsi_notice

#define lwsl_wsi_notice	(		_w,
			... )

#include <lws-logs.h>

Value:

lwsl_wsi(_w, LLL_NOTICE, __VA_ARGS__)

Definition at line 549 of file lws-logs.h.

◆ lwsl_wsi_info

#define lwsl_wsi_info	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 557 of file lws-logs.h.

◆ lwsl_wsi_debug

#define lwsl_wsi_debug	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 563 of file lws-logs.h.

◆ lwsl_wsi_parser

#define lwsl_wsi_parser	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 569 of file lws-logs.h.

◆ lwsl_wsi_header

#define lwsl_wsi_header	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 575 of file lws-logs.h.

◆ lwsl_wsi_ext

#define lwsl_wsi_ext	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 581 of file lws-logs.h.

◆ lwsl_wsi_client

#define lwsl_wsi_client	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 587 of file lws-logs.h.

◆ lwsl_wsi_latency

#define lwsl_wsi_latency	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 593 of file lws-logs.h.

◆ lwsl_wsi_thread

#define lwsl_wsi_thread	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 599 of file lws-logs.h.

◆ lwsl_wsi_user

#define lwsl_wsi_user	(		_w,
			... )

#include <lws-logs.h>

Value:

lwsl_wsi(_w, LLL_USER, __VA_ARGS__)

Definition at line 603 of file lws-logs.h.

◆ lwsl_hexdump_wsi_err

#define lwsl_hexdump_wsi_err	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_wsi(_v, LLL_ERR, __VA_ARGS__)

lwsl_hexdump_wsi

#define lwsl_hexdump_wsi(_w, _fil, _buf, _len)

Definition lws-logs.h:223

Definition at line 608 of file lws-logs.h.

◆ lwsl_hexdump_wsi_warn

#define lwsl_hexdump_wsi_warn	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_wsi(_v, LLL_WARN, __VA_ARGS__)

Definition at line 609 of file lws-logs.h.

◆ lwsl_hexdump_wsi_notice

#define lwsl_hexdump_wsi_notice	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_wsi(_v, LLL_NOTICE, __VA_ARGS__)

Definition at line 610 of file lws-logs.h.

◆ lwsl_hexdump_wsi_info

#define lwsl_hexdump_wsi_info	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_wsi(_v, LLL_INFO, __VA_ARGS__)

Definition at line 611 of file lws-logs.h.

◆ lwsl_hexdump_wsi_debug

#define lwsl_hexdump_wsi_debug	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_wsi(_v, LLL_DEBUG, __VA_ARGS__)

Definition at line 612 of file lws-logs.h.

◆ lwsl_hexdump_wsi_user

#define lwsl_hexdump_wsi_user	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_wsi(_v, LLL_USER, __VA_ARGS__)

Definition at line 613 of file lws-logs.h.

◆ lwsl_ss_err

#define lwsl_ss_err	(		_w,
			... )

#include <lws-logs.h>

Value:

lwsl_ss(_w, LLL_ERR, __VA_ARGS__)

lwsl_ss

#define lwsl_ss(_h, _fil,...)

Definition lws-logs.h:211

Definition at line 622 of file lws-logs.h.

◆ lwsl_ss_warn

#define lwsl_ss_warn	(		_w,
			... )

#include <lws-logs.h>

Value:

lwsl_ss(_w, LLL_WARN, __VA_ARGS__)

Definition at line 628 of file lws-logs.h.

◆ lwsl_ss_notice

#define lwsl_ss_notice	(		_w,
			... )

#include <lws-logs.h>

Value:

lwsl_ss(_w, LLL_NOTICE, __VA_ARGS__)

Definition at line 634 of file lws-logs.h.

◆ lwsl_ss_info

#define lwsl_ss_info	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 642 of file lws-logs.h.

◆ lwsl_ss_debug

#define lwsl_ss_debug	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 648 of file lws-logs.h.

◆ lwsl_ss_parser

#define lwsl_ss_parser	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 654 of file lws-logs.h.

◆ lwsl_ss_header

#define lwsl_ss_header	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 660 of file lws-logs.h.

◆ lwsl_ss_ext

#define lwsl_ss_ext	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 666 of file lws-logs.h.

◆ lwsl_ss_client

#define lwsl_ss_client	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 672 of file lws-logs.h.

◆ lwsl_ss_latency

#define lwsl_ss_latency	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 678 of file lws-logs.h.

◆ lwsl_ss_thread

#define lwsl_ss_thread	(		_w,
			... )

#include <lws-logs.h>

Value:

do {} while(0)

Definition at line 684 of file lws-logs.h.

◆ lwsl_ss_user

#define lwsl_ss_user	(		_w,
			... )

#include <lws-logs.h>

Value:

lwsl_ss(_w, LLL_USER, __VA_ARGS__)

Definition at line 688 of file lws-logs.h.

◆ lwsl_hexdump_ss_err

#define lwsl_hexdump_ss_err	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_ss(_v, LLL_ERR, __VA_ARGS__)

lwsl_hexdump_ss

#define lwsl_hexdump_ss(_h, _fil, _buf, _len)

Definition lws-logs.h:227

Definition at line 693 of file lws-logs.h.

◆ lwsl_hexdump_ss_warn

#define lwsl_hexdump_ss_warn	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_ss(_v, LLL_WARN, __VA_ARGS__)

Definition at line 694 of file lws-logs.h.

◆ lwsl_hexdump_ss_notice

#define lwsl_hexdump_ss_notice	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_ss(_v, LLL_NOTICE, __VA_ARGS__)

Definition at line 695 of file lws-logs.h.

◆ lwsl_hexdump_ss_info

#define lwsl_hexdump_ss_info	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_ss(_v, LLL_INFO, __VA_ARGS__)

Definition at line 696 of file lws-logs.h.

◆ lwsl_hexdump_ss_debug

#define lwsl_hexdump_ss_debug	(		_v,
			... )

#include <lws-logs.h>

Value:

lwsl_hexdump_ss(_v, LLL_DEBUG, __VA_ARGS__)

Definition at line 697 of file lws-logs.h.

Typedef Documentation

◆ lws_log_emit_t

typedef void(* lws_log_emit_t) (int level, const char *line)

#include <lws-logs.h>

Definition at line 69 of file lws-logs.h.

◆ lws_log_emit_cx_t

typedef void(* lws_log_emit_cx_t) (struct lws_log_cx *cx, int level, const char *line, size_t len)

#include <lws-logs.h>

Definition at line 70 of file lws-logs.h.

◆ lws_log_prepend_cx_t

typedef void(* lws_log_prepend_cx_t) (struct lws_log_cx *cx, void *obj, char **p, char *e)

#include <lws-logs.h>

Definition at line 72 of file lws-logs.h.

◆ lws_log_use_cx_t

typedef void(* lws_log_use_cx_t) (struct lws_log_cx *cx, int _new)

#include <lws-logs.h>

Definition at line 74 of file lws-logs.h.

◆ lws_log_cx_t

typedef struct lws_log_cx lws_log_cx_t

#include <lws-logs.h>

◆ lws_log_ratelimit_t

typedef struct lws_log_ratelimit lws_log_ratelimit_t

#include <lws-logs.h>

Function Documentation

◆ lwsl_timestamp()

LWS_VISIBLE LWS_EXTERN int lwsl_timestamp	(	int	level,
		char *	p,
		size_t	len )

#include <lws-logs.h>

lwsl_timestamp: generate logging timestamp string

Parameters

level	logging level
p	char * buffer to take timestamp
len	length of p

returns length written in p

◆ lws_log_ratelimit_check()

LWS_VISIBLE LWS_EXTERN uint32_t lws_log_ratelimit_check	(	lws_log_ratelimit_t *	rl,
		int64_t	interval_us )

#include <lws-logs.h>

References LWS_EXTERN, and LWS_VISIBLE.

◆ _lws_log_rl()

LWS_VISIBLE LWS_EXTERN void _lws_log_rl	(	int	filter,
		uint32_t	dropped,
		const char *	format,
			... )

#include <lws-logs.h>

References LWS_EXTERN, LWS_FORMAT, and LWS_VISIBLE.

◆ _lws_log_cx_rl()

LWS_VISIBLE LWS_EXTERN void _lws_log_cx_rl	(	lws_log_cx_t *	cx,
		lws_log_prepend_cx_t	prep,
		void *	obj,
		int	filter,
		uint32_t	dropped,
		const char *	_fun,
		const char *	format,
			... )

#include <lws-logs.h>

References _lws_log_cx_rl(), LWS_EXTERN, LWS_FORMAT, and LWS_VISIBLE.

Referenced by _lws_log_cx_rl().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _lws_log()

LWS_VISIBLE LWS_EXTERN void _lws_log	(	int	filter,
		const char *	format,
			... )

#include <lws-logs.h>

References LWS_EXTERN, LWS_FORMAT, and LWS_VISIBLE.

◆ _lws_logv()

LWS_VISIBLE LWS_EXTERN void _lws_logv	(	int	filter,
		const char *	format,
		va_list	vl )

#include <lws-logs.h>

References _lws_logv(), LWS_EXTERN, and LWS_VISIBLE.

Referenced by _lws_logv().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ lwsl_context_get_cx()

LWS_VISIBLE LWS_EXTERN struct lws_log_cx * lwsl_context_get_cx ( struct lws_context * cx )

#include <lws-logs.h>

References LWS_EXTERN, and LWS_VISIBLE.

◆ lwsl_vhost_get_cx()

LWS_VISIBLE LWS_EXTERN struct lws_log_cx * lwsl_vhost_get_cx ( struct lws_vhost * vh )

#include <lws-logs.h>

References LWS_EXTERN, and LWS_VISIBLE.

◆ lwsl_wsi_get_cx()

LWS_VISIBLE LWS_EXTERN struct lws_log_cx * lwsl_wsi_get_cx ( struct lws * wsi )

#include <lws-logs.h>

References LWS_EXTERN, and LWS_VISIBLE.

◆ lws_log_emit_cx_file()

LWS_VISIBLE LWS_EXTERN void lws_log_emit_cx_file	(	struct lws_log_cx *	cx,
		int	level,
		const char *	line,
		size_t	len )

#include <lws-logs.h>

References LWS_EXTERN, and LWS_VISIBLE.

◆ lws_log_use_cx_file()

LWS_VISIBLE LWS_EXTERN void lws_log_use_cx_file	(	struct lws_log_cx *	cx,
		int	_new )

#include <lws-logs.h>

References LWS_EXTERN, and LWS_VISIBLE.

◆ lws_log_prepend_context()

LWS_VISIBLE LWS_EXTERN void lws_log_prepend_context	(	struct lws_log_cx *	cx,
		void *	obj,
		char **	p,
		char *	e )

#include <lws-logs.h>

References LWS_EXTERN, and LWS_VISIBLE.

◆ lws_log_prepend_vhost()

LWS_VISIBLE LWS_EXTERN void lws_log_prepend_vhost	(	struct lws_log_cx *	cx,
		void *	obj,
		char **	p,
		char *	e )

#include <lws-logs.h>

References LWS_EXTERN, and LWS_VISIBLE.

◆ lws_log_prepend_wsi()

LWS_VISIBLE LWS_EXTERN void lws_log_prepend_wsi	(	struct lws_log_cx *	cx,
		void *	obj,
		char **	p,
		char *	e )

#include <lws-logs.h>

References LWS_EXTERN, and LWS_VISIBLE.

◆ _lws_log_cx()

LWS_VISIBLE LWS_EXTERN void _lws_log_cx	(	lws_log_cx_t *	cx,
		lws_log_prepend_cx_t	prep,
		void *	obj,
		int	filter,
		const char *	_fun,
		const char *	format,
			... )

#include <lws-logs.h>

References LWS_FORMAT.

◆ lwsl_hexdump_level()

LWS_VISIBLE LWS_EXTERN void lwsl_hexdump_level	(	int	level,
		const void *	vbuf,
		size_t	len )

#include <lws-logs.h>

lwsl_hexdump_level() - helper to hexdump a buffer at a selected debug level

Parameters

level	one of LLL_ constants
vbuf	buffer start to dump
len	length of buffer to dump

If level is visible, does a nice hexdump -C style dump of vbuf for len bytes. This can be extremely convenient while debugging.

References LWS_EXTERN, and LWS_VISIBLE.

◆ lwsl_hexdump_level_cx()

LWS_VISIBLE LWS_EXTERN void lwsl_hexdump_level_cx	(	lws_log_cx_t *	cx,
		lws_log_prepend_cx_t	prep,
		void *	obj,
		int	hexdump_level,
		const void *	vbuf,
		size_t	len )

#include <lws-logs.h>

References LWS_EXTERN, and LWS_VISIBLE.

◆ lwsl_hexdump()

LWS_VISIBLE LWS_EXTERN void lwsl_hexdump	(	const void *	buf,
		size_t	len )

#include <lws-logs.h>

lwsl_hexdump() - helper to hexdump a buffer (DEBUG builds only)

Parameters

buf	buffer start to dump
len	length of buffer to dump

Calls through to lwsl_hexdump_level(LLL_DEBUG, ... for compatability. It's better to use lwsl_hexdump_level(level, ... directly so you can control the visibility.

References LWS_INLINE.

◆ lws_set_log_level()

LWS_VISIBLE LWS_EXTERN void lws_set_log_level	(	int	level,
		lws_log_emit_t	log_emit_function )

#include <lws-logs.h>

lws_set_log_level() - Set the logging bitfield

Parameters

level	OR together the LLL_ debug contexts you want output from
log_emit_function	NULL to leave it as it is, or a user-supplied function to perform log string emission instead of the default stderr one.

log level defaults to "err", "warn" and "notice" contexts enabled and emission on stderr. If stderr is a tty (according to isatty()) then the output is coloured according to the log level using ANSI escapes.

You can set the default security level for logging using the secrecy_and_log_level() macro to set the level parameter, eg

lws_set_log_level(secrecy_and_log_level(LWS_SECRECY_PII, LLL_ERR | LLL_WARN), my_emit_function);

Normally you can just leave it at the default.

References LWS_EXTERN, and LWS_VISIBLE.

◆ lwsl_emit_syslog()

LWS_VISIBLE LWS_EXTERN void lwsl_emit_syslog	(	int	level,
		const char *	line )

#include <lws-logs.h>

lwsl_emit_syslog() - helper log emit function writes to system log

Parameters

level	one of LLL_ log level indexes
line	log string

You use this by passing the function pointer to lws_set_log_level(), to set it as the log emit function, it is not called directly.

References LWS_EXTERN, and LWS_VISIBLE.

◆ lwsl_emit_stderr()

LWS_VISIBLE LWS_EXTERN void lwsl_emit_stderr	(	int	level,
		const char *	line )

#include <lws-logs.h>

lwsl_emit_stderr() - helper log emit function writes to stderr

Parameters

level	one of LLL_ log level indexes
line	log string

You use this by passing the function pointer to lws_set_log_level(), to set it as the log emit function, it is not called directly.

It prepends a system timestamp like [2018/11/13 07:41:57:3989]

If stderr is a tty, then ansi colour codes are added.

References LWS_EXTERN, and LWS_VISIBLE.

◆ lwsl_emit_stderr_notimestamp()

LWS_VISIBLE LWS_EXTERN void lwsl_emit_stderr_notimestamp	(	int	level,
		const char *	line )

#include <lws-logs.h>

lwsl_emit_stderr_notimestamp() - helper log emit function writes to stderr

Parameters

level	one of LLL_ log level indexes
line	log string

You use this by passing the function pointer to lws_set_log_level(), to set it as the log emit function, it is not called directly.

If stderr is a tty, then ansi colour codes are added.

References LWS_EXTERN, and LWS_VISIBLE.

◆ lwsl_visible()

LWS_VISIBLE LWS_EXTERN int lwsl_visible ( int level )

#include <lws-logs.h>

lwsl_visible() - returns true if the log level should be printed

Parameters

level one of LLL_ log level indexes

This is useful if you have to do work to generate the log content, you can skip the work if the log level used to print it is not actually enabled at runtime.

References LWS_EXTERN, and LWS_VISIBLE.

◆ lws_wsi_tag()

LWS_VISIBLE LWS_EXTERN const char * lws_wsi_tag ( struct lws * wsi )

#include <lws-logs.h>

References LWS_EXTERN, and LWS_VISIBLE.

◆ lwsl_refcount_cx()

LWS_VISIBLE LWS_EXTERN void lwsl_refcount_cx	(	lws_log_cx_t *	cx,
		int	_new )

#include <lws-logs.h>

Data Structures

Macros

Typedefs

Functions

Detailed Description

Logging

Data Structure Documentation

◆ lws_log_ratelimit

◆ lws_log_cx.u

Macro Definition Documentation

◆ LLL_ERR

◆ LLL_WARN

◆ LLL_NOTICE

◆ LLL_INFO

◆ LLL_DEBUG

◆ LLL_PARSER

◆ LLL_HEADER

◆ LLL_EXT

◆ LLL_CLIENT

◆ LLL_LATENCY

◆ LLL_USER

◆ LLL_THREAD

◆ LLL_COUNT

◆ LLLF_SECRECY_PII

◆ LLLF_SECRECY_BEARER

◆ LLLF_LOG_TIMESTAMP

◆ LLLF_LOG_CONTEXT_AWARE

◆ LWS_RATELIMIT_DEFINE_STATIC

◆ lwsl_cx

◆ lwsl_vhost

◆ lwsl_wsi

◆ lwsl_ss

◆ lwsl_hexdump_context

◆ lwsl_hexdump_vhost

◆ lwsl_hexdump_wsi

◆ lwsl_hexdump_ss

◆ _LWS_LINIT

◆ _LWS_LBS

◆ _LWS_LBC

◆ _LWS_ENABLED_LOGS

◆ lwsl_err

◆ lwsl_warn

◆ lwsl_notice

◆ lwsl_info

◆ lwsl_debug

◆ lwsl_parser

◆ lwsl_header

◆ lwsl_ext

◆ lwsl_client

◆ lwsl_latency

◆ lwsl_thread

◆ lwsl_user

◆ lwsl_hexdump_user

◆ lwsl_hexdump_err

◆ lwsl_hexdump_warn

◆ lwsl_hexdump_notice

◆ lwsl_hexdump_info

◆ lwsl_hexdump_debug

◆ lwsl_cx_err

◆ lwsl_cx_warn

◆ lwsl_cx_notice

◆ lwsl_cx_info

◆ lwsl_cx_debug

◆ lwsl_cx_parser

◆ lwsl_cx_header

◆ lwsl_cx_ext

◆ lwsl_cx_client

◆ lwsl_cx_latency

◆ lwsl_cx_thread

◆ lwsl_cx_user

◆ lwsl_hexdump_cx_err

◆ lwsl_hexdump_cx_warn

◆ lwsl_hexdump_cx_notice

◆ lwsl_hexdump_cx_info

◆ lwsl_hexdump_cx_debug

◆ lwsl_vhost_err

◆ lwsl_vhost_warn

◆ lwsl_vhost_notice

◆ lwsl_vhost_info

◆ lwsl_vhost_debug