slog2_find_buffer()

Find the handle for a buffer with a given name

Synopsis:

#include <slog2_parse.h>

slog2_buffer_t slog2_find_buffer( const char *buffer_name,
                                  const char *buffer_set_name );

Arguments:

buffer_name
The name of the previously registered buffer that you're looking for.
buffer_set_name
NULL, or the name of the buffer set in which to search for the buffer.

Library:

libslog2

Use the -l slog2 option to qcc to link against this library.

Description:

The slog2_find_buffer() function performs a reverse lookup of the buffer name to try and find the corresponding buffer handle.

Returns:

The matching buffer handle, or NULL if the buffer wasn't found (errno is set).

Errors:

EINVAL
The buffer_name argument is NULL.
ENOENT
The buffer wasn't found.
ERANGE
An internal error occurred.

Classification:

QNX Neutrino

Safety:  
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes