| ost::Slog(3) | Library Functions Manual | ost::Slog(3) |
ost::Slog - The slog class is used to stream messages to the system's logging facility (syslogd).
#include <slog.h>
Inherits streambuf, and ostream.
enum Class { classSecurity, classAudit,
classDaemon, classUser, classDefault,
classLocal0, classLocal1, classLocal2,
classLocal3, classLocal4, classLocal5,
classLocal6, classLocal7 }
enum Level { levelEmergency = 1, levelAlert,
levelCritical, levelError, levelWarning,
levelNotice, levelInfo, levelDebug }
typedef enum ost::Slog::Class Class
typedef enum ost::Slog::Level Level
Slog (void)
Default (and only) constructor. virtual ~Slog (void)
void close (void)
void open (const char *ident, Class grp=classUser)
(re)opens the output stream. Slog & operator() (const char
*ident, Class grp=classUser, Level
level=levelError)
Sets the log identifier, level, and class to use for subsequent output.
Slog & operator() (Level level, Class
grp=classDefault)
Changes the log level and class to use for subsequent output. Slog
& operator() (void)
Does nothing except return *this. void error (const char *format,...)
Print a formatted syslog string. void warn (const char *format,...)
Print a formatted syslog string. void debug (const char *format,...)
Print a formatted syslog string. void emerg (const char *format,...)
Print a formatted syslog string. void alert (const char *format,...)
Print a formatted syslog string. void critical (const char *format,...)
Print a formatted syslog string. void notice (const char *format,...)
Print a formatted syslog string. void info (const char *format,...)
Print a formatted syslog string. void level (Level enable)
Sets the logging level. void clogEnable (bool f=true)
Enables or disables the echoing of the messages to clog in addition to the
syslog daemon. Slog & warn (void)
Slog & error (void)
Slog & debug (void)
Slog & emerg (void)
Slog & alert (void)
Slog & critical (void)
Slog & notice (void)
Slog & info (void)
int overflow (int c)
This is the streambuf function that actually outputs the data to the device.
The slog class is used to stream messages to the system's logging facility (syslogd).
A default slog object is used to avoid confusion with the native syslog facility and to imply a logical relationship to the C++ clog().
The key difference is that the slog object sends it's output to the system logging daemon (typically syslogd) rather than through stderr. slog can be streamed with the << operator just like clog; a default slog object is pre-initialized, and you stream character data to it.
The slog allows one to specify logging levels and other properties through the () operators. Hence, once can do:
slog('mydaemon', SLOG_DAEMON, SLOG_EMERGENCY) << I just died << endl;
or things like:
slog('mydaemon', SLOG_DAEMON);
slog(SLOG_INFO) << 'daemon initalized' << endl;
The intent is to be as common-place and as convenient to use as the stderr based clog facility found in C++, and this is especially useful for C++ daemons.
The std::flush manipulator doesn't work. Either the std::endl or std::ends manipulators must be used to cause the output to be sent to the daemon.
When this class is used on a system that doesn't have the syslog headers (i.e. a non-posix win32 box), the output goes to the a file with the same name as the syslog identifier string with '.log' appended to it. If the identifier string ends in '.exe', the '.exe' is removed before the '.log' is appened. (e.g. the identifier foo.exe will generate a log file named foo.log)
Author:
system logging facility class.
Enumerator
Enumerator
Default (and only) constructor. The default log level is set to SLOG_DEBUG. There is no default log facility set. One should be set before attempting any output. This is done by the open() or the operator()(const char*, Class, Level) functions.
Print a formatted syslog string.
Parameters:
References levelAlert.
Enables or disables the echoing of the messages to clog in addition to the syslog daemon. This is enabled by the default class constructor.
Parameters:
Examples:
slogTest.cpp.
Print a formatted syslog string.
Parameters:
References levelCritical.
Print a formatted syslog string.
Parameters:
References levelDebug.
Print a formatted syslog string.
Parameters:
References levelEmergency.
Print a formatted syslog string.
Parameters:
References levelError.
Print a formatted syslog string.
Parameters:
References __EXPORT, levelInfo, and ost::slog.
Sets the logging level.
Parameters:
Print a formatted syslog string.
Parameters:
References levelNotice.
(re)opens the output stream.
Parameters:
Sets the log identifier, level, and class to use for subsequent output.
Parameters:
Changes the log level and class to use for subsequent output.
Parameters:
Does nothing except return *this.
This is the streambuf function that actually outputs the data to the device. Since all output should be done with the standard ostream operators, this function should never be called directly.
Print a formatted syslog string.
Parameters:
References levelWarning.
Generated automatically by Doxygen for GNU CommonC++ from the source code.
| Wed Oct 31 2018 | GNU CommonC++ |