A parameter within a structured data element. More...

#include <param.h>

Data Fields
char	name [32+1]
	The name of the parameter.

size_t	name_length
	The number of characters in name (not including the NULL character).

char *	value
	The value may be any UTF-8 string.

size_t	value_length
	The number of characters in value (not including the NULL character).

Detailed Description

A parameter within a structured data element.

A parameter must have both a name and a value in compliance with RFC 5424.

Examples: entry_example.c, file_example.c, socket_example.c, stream_example.c, tcp_example.c, udp_example.c, and wel_example.c.

Field Documentation

◆ name

char stumpless_param::name[32+1]

The name of the parameter.

The name must be between 1 and 32 characters long and consist only of ASCII characters between '!' and '~', inclusive, with the exception of the '=', ' ', ']', and '"' characters, which are not allowed.

Note that the name will be NULL-terminated as of version 1.6.0. In earlier versions it is not NULL-terminated.

If you need to access the name, use the stumpless_(g|s)et_param_name functions. These will protect you from changes in the struct in future versions.

◆ name_length

size_t stumpless_param::name_length

The number of characters in name (not including the NULL character).

◆ value

char* stumpless_param::value

The value may be any UTF-8 string.

As specified in RFC 5424, the characters '"' (ABNF d34), '\' (ABNF d92), and ']' (ABNF d93) MUST be escaped by placing a backslash character '\' directly before them.

Unlike the name field, value will always be NULL-terminated. This is done to support their use for wel insertion strings.

If you need to access the value, use the stumpless_(g|s)et_param_value functions. These will protect you from changes in the struct in future versions.

◆ value_length

size_t stumpless_param::value_length

The number of characters in value (not including the NULL character).

The documentation for this struct was generated from the following file: