Annotation of src/usr.bin/ssh/log.h, Revision 1.30
1.30 ! djm 1: /* $OpenBSD: log.h,v 1.29 2020/10/18 11:21:59 djm Exp $ */
1.2 niklas 2:
1.1 markus 3: /*
4: * Author: Tatu Ylonen <ylo@cs.hut.fi>
5: * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
6: * All rights reserved
7: *
8: * As far as I am concerned, the code I have written for this software
9: * can be used freely for any purpose. Any derived versions of this
10: * software must be clearly marked as such, and if the derived work is
11: * incompatible with the protocol description in the RFC file, it must be
12: * called by a name other than "ssh" or "Secure Shell".
13: */
14:
15: #ifndef SSH_LOG_H
16: #define SSH_LOG_H
1.24 djm 17:
18: #include <stdarg.h> /* va_list */
1.29 djm 19: #include <ssherr.h> /* ssh_err() */
1.1 markus 20:
21: /* Supported syslog facilities and levels. */
22: typedef enum {
23: SYSLOG_FACILITY_DAEMON,
24: SYSLOG_FACILITY_USER,
25: SYSLOG_FACILITY_AUTH,
26: SYSLOG_FACILITY_LOCAL0,
27: SYSLOG_FACILITY_LOCAL1,
28: SYSLOG_FACILITY_LOCAL2,
29: SYSLOG_FACILITY_LOCAL3,
30: SYSLOG_FACILITY_LOCAL4,
31: SYSLOG_FACILITY_LOCAL5,
32: SYSLOG_FACILITY_LOCAL6,
1.5 markus 33: SYSLOG_FACILITY_LOCAL7,
1.7 deraadt 34: SYSLOG_FACILITY_NOT_SET = -1
1.1 markus 35: } SyslogFacility;
36:
37: typedef enum {
38: SYSLOG_LEVEL_QUIET,
39: SYSLOG_LEVEL_FATAL,
40: SYSLOG_LEVEL_ERROR,
41: SYSLOG_LEVEL_INFO,
42: SYSLOG_LEVEL_VERBOSE,
43: SYSLOG_LEVEL_DEBUG1,
44: SYSLOG_LEVEL_DEBUG2,
1.5 markus 45: SYSLOG_LEVEL_DEBUG3,
1.7 deraadt 46: SYSLOG_LEVEL_NOT_SET = -1
1.1 markus 47: } LogLevel;
48:
1.25 djm 49: typedef void (log_handler_fn)(const char *, const char *, int, LogLevel,
50: const char *, void *);
1.18 djm 51:
1.30 ! djm 52: void log_init(const char *, LogLevel, SyslogFacility, int);
1.23 markus 53: LogLevel log_level_get(void);
1.22 djm 54: int log_change_level(LogLevel);
1.19 dtucker 55: int log_is_on_stderr(void);
1.20 dtucker 56: void log_redirect_stderr_to(const char *);
1.25 djm 57: void log_verbose_add(const char *);
58: void log_verbose_reset(void);
1.1 markus 59:
1.4 markus 60: SyslogFacility log_facility_number(char *);
1.16 dtucker 61: const char * log_facility_name(SyslogFacility);
62: LogLevel log_level_number(char *);
63: const char * log_level_name(LogLevel);
1.1 markus 64:
1.25 djm 65: void set_log_handler(log_handler_fn *, void *);
66: void cleanup_exit(int) __attribute__((noreturn));
1.4 markus 67:
1.25 djm 68: void sshlog(const char *, const char *, int, int,
1.29 djm 69: LogLevel, const char *, const char *, ...)
70: __attribute__((format(printf, 7, 8)));
1.25 djm 71: void sshlogv(const char *, const char *, int, int,
1.29 djm 72: LogLevel, const char *, const char *, va_list);
1.26 djm 73: void sshsigdie(const char *, const char *, int, int,
1.29 djm 74: LogLevel, const char *, const char *, ...) __attribute__((noreturn))
75: __attribute__((format(printf, 7, 8)));
1.26 djm 76: void sshlogdie(const char *, const char *, int, int,
1.29 djm 77: LogLevel, const char *, const char *, ...) __attribute__((noreturn))
78: __attribute__((format(printf, 7, 8)));
1.26 djm 79: void sshfatal(const char *, const char *, int, int,
1.29 djm 80: LogLevel, const char *, const char *, ...) __attribute__((noreturn))
81: __attribute__((format(printf, 7, 8)));
1.25 djm 82:
1.29 djm 83: #define do_log2(level, ...) sshlog(__FILE__, __func__, __LINE__, 0, level, NULL, __VA_ARGS__)
84: #define debug3(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG3, NULL, __VA_ARGS__)
85: #define debug2(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG2, NULL, __VA_ARGS__)
86: #define debug(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG1, NULL, __VA_ARGS__)
87: #define verbose(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_VERBOSE, NULL, __VA_ARGS__)
88: #define logit(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_INFO, NULL, __VA_ARGS__)
89: #define error(...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
90: #define fatal(...) sshfatal(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_FATAL, NULL, __VA_ARGS__)
91: #define logdie(...) sshlogdie(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
92: #define sigdie(...) sshsigdie(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
93:
94: /* Variants that prepend the caller's function */
95: #define do_log2_f(level, ...) sshlog(__FILE__, __func__, __LINE__, 1, level, NULL, __VA_ARGS__)
96: #define debug3_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG3, NULL, __VA_ARGS__)
97: #define debug2_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG2, NULL, __VA_ARGS__)
98: #define debug_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG1, NULL, __VA_ARGS__)
99: #define verbose_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_VERBOSE, NULL, __VA_ARGS__)
100: #define logit_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_INFO, NULL, __VA_ARGS__)
101: #define error_f(...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
102: #define fatal_f(...) sshfatal(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_FATAL, NULL, __VA_ARGS__)
103: #define logdie_f(...) sshlogdie(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
104: #define sigdie_f(...) sshsigdie(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, NULL, __VA_ARGS__)
105:
106: /* Variants that appends a ssh_err message */
107: #define do_log2_r(r, level, ...) sshlog(__FILE__, __func__, __LINE__, 0, level, ssh_err(r), __VA_ARGS__)
108: #define debug3_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG3, ssh_err(r), __VA_ARGS__)
109: #define debug2_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG2, ssh_err(r), __VA_ARGS__)
110: #define debug_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_DEBUG1, ssh_err(r), __VA_ARGS__)
111: #define verbose_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_VERBOSE, ssh_err(r), __VA_ARGS__)
112: #define logit_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_INFO, ssh_err(r), __VA_ARGS__)
113: #define error_r(r, ...) sshlog(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
114: #define fatal_r(r, ...) sshfatal(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_FATAL, ssh_err(r), __VA_ARGS__)
115: #define logdie_r(r, ...) sshlogdie(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
116: #define sigdie_r(r, ...) sshsigdie(__FILE__, __func__, __LINE__, 0, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
117: #define do_log2_fr(r, level, ...) sshlog(__FILE__, __func__, __LINE__, 1, level, ssh_err(r), __VA_ARGS__)
118: #define debug3_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG3, ssh_err(r), __VA_ARGS__)
119: #define debug2_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG2, ssh_err(r), __VA_ARGS__)
120: #define debug_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_DEBUG1, ssh_err(r), __VA_ARGS__)
121: #define verbose_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_VERBOSE, ssh_err(r), __VA_ARGS__)
122: #define logit_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_INFO, ssh_err(r), __VA_ARGS__)
123: #define error_fr(r, ...) sshlog(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
124: #define fatal_fr(r, ...) sshfatal(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_FATAL, ssh_err(r), __VA_ARGS__)
125: #define logdie_fr(r, ...) sshlogdie(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
126: #define sigdie_fr(r, ...) sshsigdie(__FILE__, __func__, __LINE__, 1, SYSLOG_LEVEL_ERROR, ssh_err(r), __VA_ARGS__)
1.18 djm 127:
1.1 markus 128: #endif