Adds an entry into a given target. This is the primary logging function of stumpless; all other logging functions call this one after performing any setup specific to themselves.

stumpless_add_log^⚠

Adds a log message with a priority to a given target.

stumpless_add_log_str^⚠

Adds a log message with a priority to a given target.

stumpless_add_message^⚠

Adds a message to a given target.

stumpless_add_message_str^⚠

Adds a string message to a given target.

stumpless_add_new_element^⚠

Creates a new element with the given name and adds it to this entry.

stumpless_add_new_param^⚠

Creates a new param and adds it to the given element.

stumpless_add_new_param_to_entry^⚠

Creates a new param and adds it to the given element in the given entry. If an element with the given name does not exist in the given entry, then one will be created with the new param added to it.

stumpless_add_param^⚠

Adds a param to an element.

stumpless_close_buffer_target^⚠

Closes a buffer target.

stumpless_close_file_target^⚠

Closes a file target.

stumpless_close_function_target^⚠

Closes a function target.

stumpless_close_stream_target^⚠

Closes a stream target.

stumpless_close_target^⚠

Closes a target.

stumpless_copy_element^⚠

Creates a copy of an element.

stumpless_copy_entry^⚠

Creates a copy of an entry.

stumpless_copy_param^⚠

Creates a copy of a param.

stumpless_destroy_element^⚠

An alias for stumpless_destroy_element_and_contents.

stumpless_destroy_element_and_contents^⚠

Destroys an element as well as all params that it contains, freeing any allocated memory.

stumpless_destroy_element_only^⚠

Destroys an element, freeing any allocated memory. Associated params are left untouched, and must be destroyed separately.

stumpless_destroy_entry^⚠

An alias for stumpless_destroy_entry_and_contents.

stumpless_destroy_entry_and_contents^⚠

Destroys an entry as well as all elements and params that it contains, freeing any allocated memory.

stumpless_destroy_entry_only^⚠

Destroys an entry, freeing any allocated memory. Associated elements and params are left untouched, and must be destroyed separately.

stumpless_destroy_param^⚠

Destroys a param, freeing any allocated memory.

stumpless_element_has_param^⚠

True if the given element has a param with the given name, false otherwise.

stumpless_element_to_string^⚠

Returns name and params from element as a formatted string. The character buffer should be freed when no longer is needed by the caller.

stumpless_entry_has_element^⚠

True if the given entry has an element with the given name, false otherwise.

stumpless_free_all^⚠

Closes the default target if it has been opened, frees all memory allocated internally, and performs any other necessary cleanup.

stumpless_free_thread^⚠

Frees all memory allocated internally to the calling thread, and performs any other thread-specific cleanup.

stumpless_get_cons_stream^⚠

stumpless_get_current_target^⚠

Gets the current target.

stumpless_get_default_facility^⚠

Gets the default facility of a target.

stumpless_get_default_target^⚠

Gets the default target.

stumpless_get_element_by_index^⚠

Returns the element at the given index in this Entry.

stumpless_get_element_by_name^⚠

Returns the element with the given name in this entry, if it is found.

stumpless_get_element_count^⚠

Returns the number of elements in the given entry.

stumpless_get_element_index^⚠

Returns the index of the element with the given name in this entry, if it is found.

stumpless_get_element_name^⚠

Returns the name of the given element. The character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_entry_app_name^⚠

Returns the app name of the given entry. The character buffer returned must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_entry_facility^⚠

Returns the facility code of the given entry.

stumpless_get_entry_hostname^⚠

Returns the hostname of a given entry. If hostname is not set it will return the machine hostname. The result character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_entry_message^⚠

Returns the message of the given entry. The character buffer returned must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_entry_msgid^⚠

Returns the msgid of the given entry. The character buffer returned must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_entry_param_by_index^⚠

Gets the param from the element at the given index in an entry.

stumpless_get_entry_param_by_name^⚠

Gets the first param from the element with the given name in an entry.

stumpless_get_entry_param_value_by_index^⚠

Gets the value of the param from the element at the given index in an entry. The result character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_entry_param_value_by_name^⚠

Gets the value of the first param from the element with the given name in an entry. The result character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_entry_prival^⚠

Returns the prival of the given entry, as defined in RFC 5424.

stumpless_get_entry_procid^⚠

Returns the procid of a given entry. If procid is not set it will return the ProcessID. The result character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_entry_severity^⚠

Returns the severity code of the given entry.

stumpless_get_error^⚠

Retrieves the error encountered by the last library call.

stumpless_get_error_id^⚠

Gets the error id of the given error.

stumpless_get_error_id_string^⚠

Gets the error string of the given error id.

stumpless_get_error_stream^⚠

Gets the current stream that errors are written to.

stumpless_get_facility_enum^⚠

Gets the enum value corresponding to the given facility string.

stumpless_get_facility_string^⚠

Gets the string representation of the given facility.

stumpless_get_option^⚠

Gets a given option of a target.

stumpless_get_param_by_index^⚠

Returns the param in the given element at the specified index.

stumpless_get_param_by_name^⚠

Returns the first occurrence of a param with the given name in element, if it is found.

stumpless_get_param_count^⚠

Returns the number of params in the given element.

stumpless_get_param_index^⚠

Gives the index of the first occurrence of a param with the given name in the given element.

stumpless_get_param_name^⚠

Returns the name of the given param. The character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_param_name_by_index^⚠

Gets the name of the param with the given index in this element. The result character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_param_name_count^⚠

Gives the number of params with the given name found in the given element.

stumpless_get_param_value^⚠

Returns the value of the given param. The character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_param_value_by_index^⚠

Returns the value of the param at the given index in the given element. The result character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_param_value_by_name^⚠

Returns the value of the first param with the given name in the given element. The result character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_severity_enum^⚠

Gets the enum value corresponding to the given severity string.

stumpless_get_severity_string^⚠

Gets the string representation of the given severity.

stumpless_get_target_default_app_name^⚠

Returns the default app name of the given target. The character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_target_default_msgid^⚠

Returns the default msgid of the given target. The character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_target_filter^⚠

Returns the current filter used by the given target to determine if entries should be allowed through it.

stumpless_get_target_mask^⚠

Gets the log mask of a target.

stumpless_get_target_name^⚠

Returns the name of the given target. The character buffer must be freed by the caller when it is no longer needed to avoid memory leaks.

stumpless_get_target_type_string^⚠

Gets the string representation of the given target_type.

stumpless_get_version^⚠

Gets the version of code the library was built with. This version must be freed by the caller when it is no longer needed to avoid a memory leak.

stumpless_has_error^⚠

True if the last call to a stumpless function encountered an error. To get the error itself, use the stumpless_get_error function.

stumpless_load_element^⚠

Loads a provided element with the given name.

stumpless_load_entry^⚠

Loads an entry struct with the given characteristics.

stumpless_load_entry_str^⚠

Creates a new entry with the given characteristics.

stumpless_load_param^⚠

Loads a provided param with the given values.

stumpless_mask_filter^⚠

Compares the severity of the entry to the current mask of the target, and only passes the entry if the mask bit corresponding to the severity is set.

stumpless_new_element^⚠

Creates a new element with the given name.

stumpless_new_entry^⚠

Creates a new entry with the given characteristics.

stumpless_new_entry_str^⚠

Creates a new entry with the given characteristics.

stumpless_new_param^⚠

Creates a new param with the given name and value.

stumpless_open_buffer_target^⚠

Creates a buffer target for the given buffer.

stumpless_open_file_target^⚠

Opens a file target.

stumpless_open_function_target^⚠

Opens a function target.

stumpless_open_stderr_target^⚠

Opens a stream target for the stderr stream.

stumpless_open_stdout_target^⚠

Opens a stream target for the stdout stream.

stumpless_open_stream_target^⚠

Opens a stream target for the given stream.

stumpless_open_target^⚠

Opens a target that has already been created and configured.

stumpless_param_to_string^⚠

Returns the name and the value from param as a formatted string. The character buffer should be freed when no longer is needed by the caller.

stumpless_perror^⚠

Prints information about the current error to the error stream.

stumpless_read_buffer^⚠

Reads the next message from the provided buffer target and writes it into the given buffer.

stumpless_set_cons_stream^⚠

Sets the console stream to write logs to.

stumpless_set_current_target^⚠

Sets the target used when one is not provided.

stumpless_set_default_facility^⚠

Sets the default facility of a target.

stumpless_set_element^⚠

Puts the element at the given index in the given entry.

stumpless_set_element_name^⚠

Sets the name of the given element.

stumpless_set_entry_app_name^⚠

Sets the app name for an entry.

stumpless_set_entry_facility^⚠

Sets the facility of an entry.

stumpless_set_entry_hostname^⚠

Sets the hostname of a given entry. If hostname is NULL it will set hostname to be the Machine hostname.

stumpless_set_entry_message^⚠

Sets the message of a given entry.

stumpless_set_entry_message_str^⚠

Sets the message of a given entry.

stumpless_set_entry_msgid^⚠

Sets the msgid for an entry.

stumpless_set_entry_param_by_index^⚠

Puts the param in the element at the given index of an entry.

stumpless_set_entry_param_value_by_index^⚠

Sets the value of the param in the element at the given index of an entry.

stumpless_set_entry_param_value_by_name^⚠

Sets the value of the first param in the named element an entry.

stumpless_set_entry_priority^⚠

Sets the facility and severity of an entry.

stumpless_set_entry_prival^⚠

Sets the prival of an entry, as defined in RFC 5424.

stumpless_set_entry_procid^⚠

Sets the procid of a given entry. If procid is NULL it will set procid to be the ProcessID.

stumpless_set_entry_severity^⚠

Sets the severity of an entry.

stumpless_set_error_stream^⚠

Sets the stream to write errors to.

stumpless_set_free^⚠

Sets the function used by the library to free memory.

stumpless_set_malloc^⚠

Sets the function used by the library to allocate memory.

stumpless_set_option^⚠

Sets an option on a target.

stumpless_set_param^⚠

Puts the param at the given index in the given element.

stumpless_set_param_name^⚠

Sets the name of the given param.

stumpless_set_param_value^⚠

Sets the value of the given param.

stumpless_set_param_value_by_index^⚠

Sets the value of the param at the given index in the given element.

stumpless_set_param_value_by_name^⚠

Sets the value of the first param with the given name in the given element.

stumpless_set_realloc^⚠

Sets the function used by the library to reallocate memory.

stumpless_set_target_default_app_name^⚠

Sets the default app name for a given target.

stumpless_set_target_default_msgid^⚠

Sets the default msgid for a given target.

stumpless_set_target_filter^⚠

Sets the filter used to determine whether entries should be logged by a given target.

stumpless_set_target_mask^⚠

Sets the log mask of a target.

stumpless_target_is_open^⚠

Checks to see if the given target is open.

stumpless_trace_entry^⚠

Adds an entry into a given target. The entry has a structured data element added to it with the file, line, and function information specified.

stumpless_trace_log^⚠

Adds a log message with a priority to a given target, along with the file, line, and function information specified in a structured data element.

stumpless_trace_log_str^⚠

Adds a log message with a priority to a given target, along with the file, line, and function information specified in a structured data element.

stumpless_trace_message^⚠

Adds a message to a given target, along with the file, line, and function information specified in a structured data element.

stumpless_trace_message_str^⚠

Adds a message to a given target, along with the file, line, and function information specified in a structured data element.

stumpless_unload_element_and_contents^⚠

Unloads an element as well as all params that it contains.

stumpless_unload_element_only^⚠

Unloads an element, freeing any allocated memory. Associated params are left untouched, and must be unloaded separately.

stumpless_unload_entry_and_contents^⚠

Unloads an entry as well as all elements that it contains.

stumpless_unload_entry_only^⚠

Unloads an entry, freeing any allocated memory. Associated elements are left untouched, and must be unloaded separately.

stumpless_unload_param^⚠

Unloads a param.

stumpless_unset_option^⚠

Unsets an option on a target.

stumpless_version_cmp^⚠

Compares the version of two given stumpless_version struct.

stumpless_version_to_string^⚠

Creates a string representation of the given version.

stumplog^⚠

Logs a message to the current target with the given priority.

stumplog_set_mask^⚠

Sets the log mask of the current target.

stumplog_str^⚠

Logs a message to the current target with the given priority.

stumplog_trace^⚠

Logs a message to the default target with the given priority, along with the file, line, and function information specified in a structured data element.

stumplog_trace_str^⚠

Logs a message to the default target with the given priority, along with the file, line, and function information specified in a structured data element.