2009-12-19 22:37:15 +01:00
|
|
|
/*
|
2011-07-10 14:33:19 +02:00
|
|
|
* vim:ts=4:sw=4:expandtab
|
2009-12-19 22:37:15 +01:00
|
|
|
*
|
|
|
|
* i3 - an improved dynamic tiling window manager
|
2011-10-25 22:19:38 +02:00
|
|
|
* © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE)
|
2009-12-19 22:37:15 +01:00
|
|
|
*
|
2012-07-22 00:16:52 +02:00
|
|
|
* log.c: Logging functions.
|
2009-12-19 22:37:15 +01:00
|
|
|
*
|
|
|
|
*/
|
2012-09-21 15:36:25 +02:00
|
|
|
#ifndef I3_LOG_H
|
|
|
|
#define I3_LOG_H
|
2009-12-19 22:37:15 +01:00
|
|
|
|
|
|
|
#include <stdarg.h>
|
2010-03-19 18:48:36 +01:00
|
|
|
#include <stdbool.h>
|
2009-12-19 22:37:15 +01:00
|
|
|
|
2012-08-12 12:20:15 +02:00
|
|
|
/* We will include libi3.h which define its own version of LOG, ELOG.
|
2012-08-10 15:39:50 +02:00
|
|
|
* We want *our* version, so we undef the libi3 one. */
|
2012-08-12 12:20:15 +02:00
|
|
|
#if defined(LOG)
|
|
|
|
#undef LOG
|
|
|
|
#endif
|
2012-08-10 15:39:50 +02:00
|
|
|
#if defined(ELOG)
|
|
|
|
#undef ELOG
|
|
|
|
#endif
|
2012-08-12 12:20:15 +02:00
|
|
|
/** ##__VA_ARGS__ means: leave out __VA_ARGS__ completely if it is empty, that
|
|
|
|
is, delete the preceding comma */
|
|
|
|
#define LOG(fmt, ...) verboselog(fmt, ##__VA_ARGS__)
|
2009-12-19 22:37:15 +01:00
|
|
|
#define ELOG(fmt, ...) errorlog("ERROR: " fmt, ##__VA_ARGS__)
|
2012-08-12 12:18:43 +02:00
|
|
|
#define DLOG(fmt, ...) debuglog("%s:%s:%d - " fmt, I3__FILE__, __FUNCTION__, __LINE__, ##__VA_ARGS__)
|
2009-12-19 22:37:15 +01:00
|
|
|
|
2011-07-10 14:33:19 +02:00
|
|
|
extern char *errorfilename;
|
2011-12-09 23:27:35 +01:00
|
|
|
extern char *shmlogname;
|
|
|
|
extern int shmlog_size;
|
2011-07-10 14:33:19 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Initializes logging by creating an error logfile in /tmp (or
|
|
|
|
* XDG_RUNTIME_DIR, see get_process_filename()).
|
|
|
|
*
|
|
|
|
*/
|
2012-03-31 10:53:04 +02:00
|
|
|
void init_logging(void);
|
2009-12-19 22:37:15 +01:00
|
|
|
|
2013-06-05 15:04:57 +02:00
|
|
|
/**
|
|
|
|
* Opens the logbuffer.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
void open_logbuffer(void);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Closes the logbuffer.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
void close_logbuffer(void);
|
|
|
|
|
2009-12-19 22:37:15 +01:00
|
|
|
/**
|
2012-07-22 00:16:52 +02:00
|
|
|
* Set debug logging.
|
2009-12-19 22:37:15 +01:00
|
|
|
*
|
|
|
|
*/
|
2012-07-22 00:16:52 +02:00
|
|
|
void set_debug_logging(const bool _debug_logging);
|
2009-12-19 22:37:15 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Set verbosity of i3. If verbose is set to true, informative messages will
|
|
|
|
* be printed to stdout. If verbose is set to false, only errors will be
|
|
|
|
* printed.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
void set_verbosity(bool _verbose);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Logs the given message to stdout while prefixing the current time to it,
|
2012-07-22 00:16:52 +02:00
|
|
|
* but only if debug logging was activated.
|
2009-12-19 22:37:15 +01:00
|
|
|
*
|
|
|
|
*/
|
2012-08-05 15:59:08 +02:00
|
|
|
void debuglog(char *fmt, ...)
|
|
|
|
__attribute__ ((format (printf, 1, 2)));
|
2009-12-19 22:37:15 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Logs the given message to stdout while prefixing the current time to it.
|
|
|
|
*
|
|
|
|
*/
|
2012-08-05 15:59:08 +02:00
|
|
|
void errorlog(char *fmt, ...)
|
|
|
|
__attribute__ ((format (printf, 1, 2)));
|
2009-12-19 22:37:15 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Logs the given message to stdout while prefixing the current time to it,
|
|
|
|
* but only if verbose mode is activated.
|
|
|
|
*
|
|
|
|
*/
|
2012-08-05 15:59:08 +02:00
|
|
|
void verboselog(char *fmt, ...)
|
|
|
|
__attribute__ ((format (printf, 1, 2)));
|
2009-12-19 22:37:15 +01:00
|
|
|
|
2012-08-11 01:50:37 +02:00
|
|
|
/**
|
|
|
|
* Deletes the unused log files. Useful if i3 exits immediately, eg.
|
|
|
|
* because --get-socketpath was called. We don't care for syscall
|
|
|
|
* failures. This function is invoked automatically when exiting.
|
|
|
|
*/
|
|
|
|
void purge_zerobyte_logfile(void);
|
|
|
|
|
2009-12-19 22:37:15 +01:00
|
|
|
#endif
|