pappl-log(3)

NAME
pappl-log - pappl logging functions

LIBRARY
Printer Application Framework (libpappl, "pkg-config --cflags --libs pappl")

SYNOPSIS
#include <pappl/pappl.h>

void
papplLog(pappl_system_t *system, pappl_loglevel_t level, const char *message, ...);

void
papplLogClient(pappl_client_t *client, pappl_loglevel_t level, const char *message, ...);

void
papplLogJob(pappl_job_t *job, pappl_loglevel_t level, const char *message, ...);

void
papplLogPrinter(pappl_printer_t *printer, pappl_loglevel_t level, const char *message, ...);

DESCRIPTION
The PAPPL logging functions record messages to the configured log file.

papplLog records messages applying to the system as a whole.

papplLogClient, papplLogJob, and papplLogPrinter record messages specific to a client connection, print job, or printer respectively.

The level argument specifies a log level from debugging (PAPPL_LOGLEVEL_DEBUG) to fatal (PAPPL_LOGLEVEL_FATAL) and is used to determine whether the message is recorded to the log.

The message argument specifies the message using a printf(3) format string.

ENUMERATIONS

  pappl_loglevel_e
Log levels

PAPPL_LOGLEVEL_DEBUG
    Debug message

PAPPL_LOGLEVEL_ERROR
    Error message

PAPPL_LOGLEVEL_FATAL
    Fatal message

PAPPL_LOGLEVEL_INFO
    Informational message

PAPPL_LOGLEVEL_UNSPEC
    Not specified

PAPPL_LOGLEVEL_WARN
    Warning message

FUNCTIONS

  papplLog
Log a message for the system.

void papplLog (
    pappl_system_t *system,
    pappl_loglevel_t level,
    const char *message,
    ...
);

This function sends a message to the system's log file. The "level" argument specifies the urgency of the message:

•   PAPPL_LOGLEVEL_DEBUG: A debugging message.

•   PAPPL_LOGLEVEL_ERROR: An error message.

•   PAPPL_LOGLEVEL_FATAL: A fatal error message.

•   PAPPL_LOGLEVEL_INFO: An informational message.

•   PAPPL_LOGLEVEL_WARN: A warning message.

The "message" argument specifies a printf-style format string. Values logged using the "%c" and "%s" format specifiers are sanitized to not contain control characters.

  papplLogClient
Log a message for a client.

void papplLogClient (
    pappl_client_t *client,
    pappl_loglevel_t level,
    const char *message,
    ...
);

This function sends a client message to the system's log file. The "level" argument specifies the urgency of the message:

•   PAPPL_LOGLEVEL_DEBUG: A debugging message.

•   PAPPL_LOGLEVEL_ERROR: An error message.

•   PAPPL_LOGLEVEL_FATAL: A fatal error message.

•   PAPPL_LOGLEVEL_INFO: An informational message.

•   PAPPL_LOGLEVEL_WARN: A warning message.

The "message" argument specifies a printf-style format string. Values logged using the "%c" and "%s" format specifiers are sanitized to not contain control characters.

  papplLogDevice
Log a device error for the system...

void papplLogDevice (
    const char *message,
    void *data
);

This function sends a device error message to the system's log file.

  papplLogJob
Log a message for a job.

void papplLogJob (
    pappl_job_t *job,
    pappl_loglevel_t level,
    const char *message,
    ...
);

This function sends a job message to the system's log file. The "level" argument specifies the urgency of the message:

•   PAPPL_LOGLEVEL_DEBUG: A debugging message.

•   PAPPL_LOGLEVEL_ERROR: An error message.

•   PAPPL_LOGLEVEL_FATAL: A fatal error message.

•   PAPPL_LOGLEVEL_INFO: An informational message.

•   PAPPL_LOGLEVEL_WARN: A warning message.

The "message" argument specifies a printf-style format string. Values logged using the "%c" and "%s" format specifiers are sanitized to not contain control characters.

  papplLogPrinter
Log a message for a printer.

void papplLogPrinter (
    pappl_printer_t *printer,
    pappl_loglevel_t level,
    const char *message,
    ...
);

This function sends a printer message to the system's log file. The "level" argument specifies the urgency of the message:

•   PAPPL_LOGLEVEL_DEBUG: A debugging message.

•   PAPPL_LOGLEVEL_ERROR: An error message.

•   PAPPL_LOGLEVEL_FATAL: A fatal error message.

•   PAPPL_LOGLEVEL_INFO: An informational message.

•   PAPPL_LOGLEVEL_WARN: A warning message.

The "message" argument specifies a printf-style format string. Values logged using the "%c" and "%s" format specifiers are sanitized to not contain control characters.

TYPES

  pappl_loglevel_t
Log levels

typedef enum pappl_loglevel_e pappl_loglevel_t;

SEE ALSO
pappl(1), pappl-client(3), pappl-device(3), pappl-job(3), pappl-log(3), pappl-mainline(3), pappl-makeresheader(1), pappl-printer(3), pappl-resource(3), pappl-system(3), https://www.msweet.org/pappl

COPYRIGHT
Copyright © 2019-2020 by Michael R Sweet.

PAPPL is licensed under the Apache License Version 2.0 with an (optional) exception to allow linking against GPL2/LGPL2 software (like older versions of CUPS), so it can be used freely in any project you'd like. See the files "LICENSE" and "NOTICE" in the source distribution for more information.