slog2f()
QNX SDP8.0C Library ReferenceAPIDeveloper
Log a printf-style string in a slog2 buffer
Synopsis:
#include <sys/slog2.h>
int slog2f( slog2_buffer_t buffer,
uint16_t code,
uint8_t severity,
const char* format, ... );
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().
- format
- A printf-formatted character string used to define the log, followed by any additional arguments, as required.
Library:
libslog2
Use the -l slog2 option to qcc to link against this library.
Description:
The slog2f() function logs a printf-style ASCII-text string in the specified slog2 buffer.
CAUTION:
Don't use slog2f() after using slog2_reset(). The
slog2_reset() function unmaps all instances, which releases all
buffer handles and triggers the SIGSEGV signal if
slog2f() tries to dereference the buffer pointer.
The vslog2f() function is an alternate form in which the arguments have already been captured using the variable-length argument facilities of <stdarg.h>.
Returns:
0 on success, or -1 if an error occurred.
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.
- EINVAL
- The format string is invalid.
- EPERM
- The process hasn't registered with slog2.
Examples:
See slog2_register().
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | Yes |
| Thread | Yes |
Page updated: