flux_shell_log(3)¶
SYNOPSIS¶
#include <flux/shell.h>
#include <errno.h>
void flux_shell_log (const char *component,
int level,
const char *file,
int line,
const char *fmt,
...)
int flux_shell_err (const char *component,
const char *file,
int line,
int errnum,
const char *fmt,
...)
void flux_shell_fatal (const char *component,
const char *file,
int line,
int errnum,
int exit_code,
const char *fmt,
...)
void flux_shell_raise (const char *type,
int severity,
const char *fmt,
...)
int flux_shell_log_setlevel (int level,
const char *dest);
DESCRIPTION¶
flux_shell_log() logs a message at for shell component or plugin
component at level to all loggers registered to receive messages
at that severity or greater. See flux_log for a list of supported levels.
The following macros handle common levels. For external shell plugins,
the required macro FLUX_SHELL_PLUGIN_NAME is automatically substituted
for the component in all macros.
#define shell_trace(...) \
#define shell_debug(...) \
#define shell_log(...) \
#define shell_warn(...) \
#define shell_log_error(...) \
flux_shell_err() logs a message at FLUX_SHELL_ERROR level,
additionally appending the result of strerror(errnum) for
convenience. Macros include:
#define shell_log_errn(errn, ...) \
#define shell_log_errno(...) \
Note that errno is the standard global value defined in errno.h
and errn is a user-provided error code.
flux_shell_fatal() logs a message at FLUX_SHELL_FATAL level and
schedules termination of the job shell. This may generate an
exception if tasks are already running. Exits with exit_code.
While the macro names are similar to those using flux_shell_err(),
note that the choices of errnum are either 0 or errno.
#define shell_die(code,...) \
#define shell_die_errno(code,...) \
flux_shell_raise() explicitly raises an exception for the current
job of the given type and severity. Exceptions of severity 0
will result in termination of the job by the execution system.
flux_shell_log_setlevel() sets default severity of logging
destination dest to level. If dest is NULL then the internal
log dispatch level is set (i.e. no messages above severity level will
be logged to any log destination). Macros include:
#define shell_set_verbose(n) \
flux_shell_log_setlevel(FLUX_SHELL_NOTICE+n, NULL)
#define shell_set_quiet(n) \
flux_shell_log_setlevel(FLUX_SHELL_NOTICE-n, NULL)
As a special case, if level is set to FLUX_SHELL_QUIET, then
logging will be completely disabled to dest. For example, to disable
logging to stderr, use:
flux_shell_log_setlevel (FLUX_SHELL_QUIET, "stderr");
RETURN VALUE¶
flux_shell_err() returns -1 with errno = errnum, so that the
function can be used as:
return flux_shell_err(…);
flux_shell_log_setlevel() will return -1 and set errno to EINVAL
if the requested level is not valid or if dest is not a valid
pointer to a logger shell.
ERRORS:¶
- EINVAL
levelordestis not valid.