2021-04-07 07:24:30 +08:00
|
|
|
/* $OpenBSD: log.h,v 1.32 2021/04/06 23:24:30 djm Exp $ */
|
2001-01-29 15:39:26 +08:00
|
|
|
|
2001-01-22 13:34:40 +08:00
|
|
|
/*
|
|
|
|
* Author: Tatu Ylonen <ylo@cs.hut.fi>
|
|
|
|
* Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
|
|
|
|
* All rights reserved
|
|
|
|
*
|
|
|
|
* As far as I am concerned, the code I have written for this software
|
|
|
|
* can be used freely for any purpose. Any derived versions of this
|
|
|
|
* software must be clearly marked as such, and if the derived work is
|
|
|
|
* incompatible with the protocol description in the RFC file, it must be
|
|
|
|
* called by a name other than "ssh" or "Secure Shell".
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef SSH_LOG_H
|
|
|
|
#define SSH_LOG_H
|
|
|
|
|
2019-09-06 12:53:27 +08:00
|
|
|
#include <stdarg.h> /* va_list */
|
2021-04-07 07:24:30 +08:00
|
|
|
#include "ssherr.h" /* ssh_err() */
|
2019-09-06 12:53:27 +08:00
|
|
|
|
2001-01-22 13:34:40 +08:00
|
|
|
/* Supported syslog facilities and levels. */
|
|
|
|
typedef enum {
|
|
|
|
SYSLOG_FACILITY_DAEMON,
|
|
|
|
SYSLOG_FACILITY_USER,
|
|
|
|
SYSLOG_FACILITY_AUTH,
|
|
|
|
#ifdef LOG_AUTHPRIV
|
2001-02-05 20:42:17 +08:00
|
|
|
SYSLOG_FACILITY_AUTHPRIV,
|
2001-01-22 13:34:40 +08:00
|
|
|
#endif
|
|
|
|
SYSLOG_FACILITY_LOCAL0,
|
|
|
|
SYSLOG_FACILITY_LOCAL1,
|
|
|
|
SYSLOG_FACILITY_LOCAL2,
|
|
|
|
SYSLOG_FACILITY_LOCAL3,
|
|
|
|
SYSLOG_FACILITY_LOCAL4,
|
|
|
|
SYSLOG_FACILITY_LOCAL5,
|
|
|
|
SYSLOG_FACILITY_LOCAL6,
|
2002-02-05 09:26:34 +08:00
|
|
|
SYSLOG_FACILITY_LOCAL7,
|
2002-06-07 03:51:06 +08:00
|
|
|
SYSLOG_FACILITY_NOT_SET = -1
|
2001-01-22 13:34:40 +08:00
|
|
|
} SyslogFacility;
|
|
|
|
|
|
|
|
typedef enum {
|
|
|
|
SYSLOG_LEVEL_QUIET,
|
|
|
|
SYSLOG_LEVEL_FATAL,
|
|
|
|
SYSLOG_LEVEL_ERROR,
|
|
|
|
SYSLOG_LEVEL_INFO,
|
|
|
|
SYSLOG_LEVEL_VERBOSE,
|
|
|
|
SYSLOG_LEVEL_DEBUG1,
|
|
|
|
SYSLOG_LEVEL_DEBUG2,
|
2002-02-05 09:26:34 +08:00
|
|
|
SYSLOG_LEVEL_DEBUG3,
|
2002-06-07 03:51:06 +08:00
|
|
|
SYSLOG_LEVEL_NOT_SET = -1
|
2001-01-22 13:34:40 +08:00
|
|
|
} LogLevel;
|
|
|
|
|
2020-10-16 21:24:45 +08:00
|
|
|
typedef void (log_handler_fn)(const char *, const char *, int, LogLevel,
|
|
|
|
const char *, void *);
|
2011-06-20 12:42:23 +08:00
|
|
|
|
2020-12-04 10:25:13 +08:00
|
|
|
void log_init(const char *, LogLevel, SyslogFacility, int);
|
2018-07-27 20:03:17 +08:00
|
|
|
LogLevel log_level_get(void);
|
2017-05-17 09:24:17 +08:00
|
|
|
int log_change_level(LogLevel);
|
2012-09-06 19:25:37 +08:00
|
|
|
int log_is_on_stderr(void);
|
2013-04-23 13:21:06 +08:00
|
|
|
void log_redirect_stderr_to(const char *);
|
2020-10-16 21:24:45 +08:00
|
|
|
void log_verbose_add(const char *);
|
|
|
|
void log_verbose_reset(void);
|
2001-01-22 13:34:40 +08:00
|
|
|
|
2001-07-04 12:46:56 +08:00
|
|
|
SyslogFacility log_facility_number(char *);
|
2021-04-03 13:54:14 +08:00
|
|
|
const char * log_facility_name(SyslogFacility);
|
2008-06-10 21:01:51 +08:00
|
|
|
LogLevel log_level_number(char *);
|
|
|
|
const char * log_level_name(LogLevel);
|
2001-01-22 13:34:40 +08:00
|
|
|
|
2011-06-20 12:42:23 +08:00
|
|
|
void set_log_handler(log_handler_fn *, void *);
|
2008-06-13 08:22:54 +08:00
|
|
|
void cleanup_exit(int) __attribute__((noreturn));
|
2020-10-16 21:24:45 +08:00
|
|
|
|
|
|
|
void sshlog(const char *, const char *, int, int,
|
2020-10-18 19:21:59 +08:00
|
|
|
LogLevel, const char *, const char *, ...)
|
|
|
|
__attribute__((format(printf, 7, 8)));
|
2020-10-16 21:24:45 +08:00
|
|
|
void sshlogv(const char *, const char *, int, int,
|
2020-10-18 19:21:59 +08:00
|
|
|
LogLevel, const char *, const char *, va_list);
|
2020-10-17 09:28:20 +08:00
|
|
|
void sshsigdie(const char *, const char *, int, int,
|
2020-10-18 19:21:59 +08:00
|
|
|
LogLevel, const char *, const char *, ...) __attribute__((noreturn))
|
|
|
|
__attribute__((format(printf, 7, 8)));
|
2020-10-17 09:28:20 +08:00
|
|
|
void sshlogdie(const char *, const char *, int, int,
|
2020-10-18 19:21:59 +08:00
|
|
|
LogLevel, const char *, const char *, ...) __attribute__((noreturn))
|
|
|
|
__attribute__((format(printf, 7, 8)));
|
2020-10-17 09:28:20 +08:00
|
|
|
void sshfatal(const char *, const char *, int, int,
|
2020-10-18 19:21:59 +08:00
|
|
|
LogLevel, const char *, const char *, ...) __attribute__((noreturn))
|
|
|
|
__attribute__((format(printf, 7, 8)));
|
2020-10-16 21:24:45 +08:00
|
|
|
|
2020-10-18 19:21:59 +08:00
|
|
|
#define do_log2(level, ...) sshlog(__FILE__, __func__, __LINE__, 0, level, NULL, __VA_ARGS__)
|
|
|
|
#define debug3(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG3, NULL, __VA_ARGS__)
|
|
|
|
#define debug2(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG2, NULL, __VA_ARGS__)
|
|
|
|
#define debug(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG1, NULL, __VA_ARGS__)
|
|
|
|
#define verbose(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_VERBOSE, NULL, __VA_ARGS__)
|
|
|
|
#define logit(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_INFO, NULL, __VA_ARGS__)
|
|
|
|
#define error(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
|
|
|
|
#define fatal(...) sshfatal(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_FATAL, NULL, __VA_ARGS__)
|
|
|
|
#define logdie(...) sshlogdie(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
|
|
|
|
#define sigdie(...) sshsigdie(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
|
|
|
|
|
|
|
|
/* Variants that prepend the caller's function */
|
|
|
|
#define do_log2_f(level, ...) sshlog(__FILE__, __func__, __LINE__, 1, level, NULL, __VA_ARGS__)
|
|
|
|
#define debug3_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG3, NULL, __VA_ARGS__)
|
|
|
|
#define debug2_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG2, NULL, __VA_ARGS__)
|
|
|
|
#define debug_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG1, NULL, __VA_ARGS__)
|
|
|
|
#define verbose_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_VERBOSE, NULL, __VA_ARGS__)
|
|
|
|
#define logit_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_INFO, NULL, __VA_ARGS__)
|
|
|
|
#define error_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
|
|
|
|
#define fatal_f(...) sshfatal(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_FATAL, NULL, __VA_ARGS__)
|
|
|
|
#define logdie_f(...) sshlogdie(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
|
|
|
|
#define sigdie_f(...) sshsigdie(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
|
|
|
|
|
|
|
|
/* Variants that appends a ssh_err message */
|
|
|
|
#define do_log2_r(r, level, ...) sshlog(__FILE__, __func__, __LINE__, 0, level, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define debug3_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG3, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define debug2_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG2, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define debug_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG1, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define verbose_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_VERBOSE, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define logit_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_INFO, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define error_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define fatal_r(r, ...) sshfatal(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_FATAL, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define logdie_r(r, ...) sshlogdie(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define sigdie_r(r, ...) sshsigdie(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define do_log2_fr(r, level, ...) sshlog(__FILE__, __func__, __LINE__, 1, level, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define debug3_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG3, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define debug2_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG2, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define debug_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG1, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define verbose_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_VERBOSE, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define logit_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_INFO, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define error_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define fatal_fr(r, ...) sshfatal(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_FATAL, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define logdie_fr(r, ...) sshlogdie(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
|
|
|
|
#define sigdie_fr(r, ...) sshsigdie(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
|
2020-10-16 21:24:45 +08:00
|
|
|
|
2001-01-22 13:34:40 +08:00
|
|
|
#endif
|