slog2c()
QNX SDP8.0C Library ReferenceAPIDeveloper
Log a constant string in a slog2 buffer
Synopsis:
#include <sys/slog2.h>
int slog2c( slog2_buffer_t buffer,
uint16_t code,
uint8_t severity,
const char* data );
Arguments:
- buffer
- The handle of the buffer you want to log the message in, or NULL to use the default buffer that you specified earlier with slog2_set_default_buffer().
- code
- A user-specified code that you want to be associated with the message. The slog2 system doesn't interpret this code in any way.
- severity
- The severity level of this log item; one of:
- SLOG2_SHUTDOWN
- SLOG2_CRITICAL
- SLOG2_ERROR
- SLOG2_WARNING
- SLOG2_NOTICE
- SLOG2_INFO
- SLOG2_DEBUG1
- SLOG2_DEBUG2
For more information, see the entry for slog2_register().
- data
- A pointer to the constant string that you want to log in the buffer.
Library:
libslog2
Use the -l slog2 option to qcc to link against this library.
Description:
The slog2c() function logs a constant string to the slog2 buffer.
CAUTION:
Don't use slog2c() after using slog2_reset(). The
slog2_reset() function unmaps all instances, which releases all
buffer handles and triggers the SIGSEGV signal if
slog2c() tries to dereference the buffer pointer.
Returns:
0 on success, or -1 if an error occurred (errno is set).
Errors:
- EBUSY
- The logger couldn't obtain a buffer within the number of retries that you specified when you registered the buffer set; see slog2_register().
- EFAULT
- You specified NULL for buffer, but there's no default buffer.
- EPERM
- The process hasn't registered with slog2.
Examples:
See slog2_register().
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | Yes |
| Thread | Yes |
Page updated: