265 lines
12 KiB
C
265 lines
12 KiB
C
/*
|
|
* Copyright (c) 2011-2015 Todd C. Miller <Todd.Miller@courtesan.com>
|
|
*
|
|
* Permission to use, copy, modify, and distribute this software for any
|
|
* purpose with or without fee is hereby granted, provided that the above
|
|
* copyright notice and this permission notice appear in all copies.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
|
|
#ifndef SUDO_DEBUG_H
|
|
#define SUDO_DEBUG_H
|
|
|
|
#include <stdarg.h>
|
|
#ifdef HAVE_STDBOOL_H
|
|
# include <stdbool.h>
|
|
#else
|
|
# include "compat/stdbool.h"
|
|
#endif
|
|
#include "sudo_queue.h"
|
|
|
|
/*
|
|
* List of debug files and flags for use in registration.
|
|
*/
|
|
struct sudo_debug_file {
|
|
TAILQ_ENTRY(sudo_debug_file) entries;
|
|
char *debug_file;
|
|
char *debug_flags;
|
|
};
|
|
struct sudo_conf_debug_file_list;
|
|
|
|
/*
|
|
* The priority and subsystem are encoded in a single 32-bit value.
|
|
* The lower 4 bits are the priority and the top 26 bits are the subsystem.
|
|
* This allows for 16 priorities and a very large number of subsystems.
|
|
* Bit 5 is used as a flag to specify whether to log the errno value.
|
|
* Bit 6 specifies whether to log the function, file and line number data.
|
|
*/
|
|
|
|
/*
|
|
* Sudo debug priorities, ordered least to most verbose,
|
|
* in other words, highest to lowest priority. Max pri is 15.
|
|
* Note: order must match sudo_debug_priorities[]
|
|
*/
|
|
#define SUDO_DEBUG_CRIT 1 /* critical errors */
|
|
#define SUDO_DEBUG_ERROR 2 /* non-critical errors */
|
|
#define SUDO_DEBUG_WARN 3 /* non-fatal warnings */
|
|
#define SUDO_DEBUG_NOTICE 4 /* non-error condition notices */
|
|
#define SUDO_DEBUG_DIAG 5 /* diagnostic messages */
|
|
#define SUDO_DEBUG_INFO 6 /* informational message */
|
|
#define SUDO_DEBUG_TRACE 7 /* log function enter/exit */
|
|
#define SUDO_DEBUG_DEBUG 8 /* very verbose debugging */
|
|
|
|
/* Flag to include string version of errno in debug info. */
|
|
#define SUDO_DEBUG_ERRNO (1<<4)
|
|
|
|
/* Flag to include function, file and line number in debug info. */
|
|
#define SUDO_DEBUG_LINENO (1<<5)
|
|
|
|
/*
|
|
* Sudo debug subsystems.
|
|
* This includes subsystems in the sudoers plugin.
|
|
* Note: order must match sudo_debug_subsystems[]
|
|
*/
|
|
#define SUDO_DEBUG_ARGS ( 1<<6) /* command line argument handling */
|
|
#define SUDO_DEBUG_CONV ( 2<<6) /* user conversation */
|
|
#define SUDO_DEBUG_EDIT ( 3<<6) /* sudoedit */
|
|
#define SUDO_DEBUG_EVENT ( 4<<6) /* event handling */
|
|
#define SUDO_DEBUG_EXEC ( 5<<6) /* command execution */
|
|
#define SUDO_DEBUG_HOOKS ( 6<<6) /* hook functions */
|
|
#define SUDO_DEBUG_MAIN ( 7<<6) /* sudo main() */
|
|
#define SUDO_DEBUG_NETIF ( 8<<6) /* network interface functions */
|
|
#define SUDO_DEBUG_PCOMM ( 9<<6) /* plugin communications */
|
|
#define SUDO_DEBUG_PLUGIN (10<<6) /* main plugin functions */
|
|
#define SUDO_DEBUG_PTY (11<<6) /* pseudo-tty */
|
|
#define SUDO_DEBUG_SELINUX (12<<6) /* selinux */
|
|
#define SUDO_DEBUG_UTIL (13<<6) /* utility functions */
|
|
#define SUDO_DEBUG_UTMP (14<<6) /* utmp file ops */
|
|
#define SUDO_DEBUG_ALL 0xffff0000 /* all subsystems */
|
|
|
|
/* Initializer for instance index to indicate that debugging is not setup. */
|
|
#define SUDO_DEBUG_INSTANCE_INITIALIZER -1
|
|
|
|
/* Extract priority number and convert to an index. */
|
|
#define SUDO_DEBUG_PRI(n) (((n) & 0x0f) - 1)
|
|
|
|
/* Extract subsystem number and convert to an index. */
|
|
#define SUDO_DEBUG_SUBSYS(n) (((n) >> 6) - 1)
|
|
|
|
/*
|
|
* Wrapper for sudo_debug_enter() that declares __func__ as needed
|
|
* and sets sudo_debug_subsys for sudo_debug_exit().
|
|
*/
|
|
#ifdef HAVE___FUNC__
|
|
# define debug_decl_func(funcname)
|
|
# define debug_decl_vars(funcname, subsys) \
|
|
const int sudo_debug_subsys = (subsys);
|
|
#else
|
|
# define debug_decl_func(funcname) \
|
|
const char __func__[] = #funcname;
|
|
# define debug_decl_vars(funcname, subsys) \
|
|
const int sudo_debug_subsys = (subsys); \
|
|
debug_decl_func(funcname);
|
|
#endif
|
|
#define debug_decl(funcname, subsys) \
|
|
debug_decl_vars((funcname), (subsys)) \
|
|
sudo_debug_enter(__func__, __FILE__, __LINE__, sudo_debug_subsys);
|
|
|
|
/*
|
|
* Wrappers for sudo_debug_exit() and friends.
|
|
*/
|
|
#define debug_return \
|
|
do { \
|
|
sudo_debug_exit(__func__, __FILE__, __LINE__, sudo_debug_subsys); \
|
|
return; \
|
|
} while (0)
|
|
|
|
#define debug_return_int(rval) \
|
|
do { \
|
|
int sudo_debug_rval = (rval); \
|
|
sudo_debug_exit_int(__func__, __FILE__, __LINE__, sudo_debug_subsys, \
|
|
sudo_debug_rval); \
|
|
return sudo_debug_rval; \
|
|
} while (0)
|
|
|
|
#define debug_return_size_t(rval) \
|
|
do { \
|
|
size_t sudo_debug_rval = (rval); \
|
|
sudo_debug_exit_size_t(__func__, __FILE__, __LINE__, sudo_debug_subsys,\
|
|
sudo_debug_rval); \
|
|
return sudo_debug_rval; \
|
|
} while (0)
|
|
|
|
#define debug_return_long(rval) \
|
|
do { \
|
|
long sudo_debug_rval = (rval); \
|
|
sudo_debug_exit_long(__func__, __FILE__, __LINE__, sudo_debug_subsys, \
|
|
sudo_debug_rval); \
|
|
return sudo_debug_rval; \
|
|
} while (0)
|
|
|
|
#define debug_return_bool(rval) \
|
|
do { \
|
|
bool sudo_debug_rval = (rval); \
|
|
sudo_debug_exit_bool(__func__, __FILE__, __LINE__, sudo_debug_subsys, \
|
|
sudo_debug_rval); \
|
|
return sudo_debug_rval; \
|
|
} while (0)
|
|
|
|
#define debug_return_str(rval) \
|
|
do { \
|
|
char *sudo_debug_rval = (rval); \
|
|
sudo_debug_exit_str(__func__, __FILE__, __LINE__, sudo_debug_subsys, \
|
|
sudo_debug_rval); \
|
|
return sudo_debug_rval; \
|
|
} while (0)
|
|
|
|
#define debug_return_const_str(rval) \
|
|
do { \
|
|
const char *sudo_debug_rval = (rval); \
|
|
sudo_debug_exit_str(__func__, __FILE__, __LINE__, sudo_debug_subsys, \
|
|
sudo_debug_rval); \
|
|
return sudo_debug_rval; \
|
|
} while (0)
|
|
|
|
#define debug_return_str_masked(rval) \
|
|
do { \
|
|
char *sudo_debug_rval = (rval); \
|
|
sudo_debug_exit_str_masked(__func__, __FILE__, __LINE__, \
|
|
sudo_debug_subsys, sudo_debug_rval); \
|
|
return sudo_debug_rval; \
|
|
} while (0)
|
|
|
|
#define debug_return_ptr(rval) \
|
|
do { \
|
|
void *sudo_debug_rval = (rval); \
|
|
sudo_debug_exit_ptr(__func__, __FILE__, __LINE__, sudo_debug_subsys, \
|
|
sudo_debug_rval); \
|
|
return sudo_debug_rval; \
|
|
} while (0)
|
|
|
|
#define debug_return_const_ptr(rval) \
|
|
do { \
|
|
const void *sudo_debug_rval = (rval); \
|
|
sudo_debug_exit_ptr(__func__, __FILE__, __LINE__, sudo_debug_subsys, \
|
|
sudo_debug_rval); \
|
|
return sudo_debug_rval; \
|
|
} while (0)
|
|
|
|
/*
|
|
* Variadic macros are a C99 feature but GNU cpp has supported
|
|
* a (different) version of them for a long time.
|
|
*/
|
|
#if defined(NO_VARIADIC_MACROS)
|
|
# define sudo_debug_printf sudo_debug_printf_nvm
|
|
#elif defined(__GNUC__) && __GNUC__ == 2
|
|
# define sudo_debug_printf(pri, fmt...) \
|
|
sudo_debug_printf2(__func__, __FILE__, __LINE__, (pri)|sudo_debug_subsys, \
|
|
fmt)
|
|
#else
|
|
# define sudo_debug_printf(pri, ...) \
|
|
sudo_debug_printf2(__func__, __FILE__, __LINE__, (pri)|sudo_debug_subsys, \
|
|
__VA_ARGS__)
|
|
#endif
|
|
|
|
#define sudo_debug_execve(pri, path, argv, envp) \
|
|
sudo_debug_execve2((pri)|sudo_debug_subsys, (path), (argv), (envp))
|
|
|
|
#define sudo_debug_write(fd, str, len, errnum) \
|
|
sudo_debug_write2(fd, NULL, NULL, 0, (str), (len), (errnum))
|
|
|
|
__dso_public int sudo_debug_deregister_v1(int instance_id);
|
|
__dso_public void sudo_debug_enter_v1(const char *func, const char *file, int line, int subsys);
|
|
__dso_public void sudo_debug_execve2_v1(int level, const char *path, char *const argv[], char *const envp[]);
|
|
__dso_public void sudo_debug_exit_v1(const char *func, const char *file, int line, int subsys);
|
|
__dso_public void sudo_debug_exit_bool_v1(const char *func, const char *file, int line, int subsys, bool rval);
|
|
__dso_public void sudo_debug_exit_int_v1(const char *func, const char *file, int line, int subsys, int rval);
|
|
__dso_public void sudo_debug_exit_long_v1(const char *func, const char *file, int line, int subsys, long rval);
|
|
__dso_public void sudo_debug_exit_ptr_v1(const char *func, const char *file, int line, int subsys, const void *rval);
|
|
__dso_public void sudo_debug_exit_size_t_v1(const char *func, const char *file, int line, int subsys, size_t rval);
|
|
__dso_public void sudo_debug_exit_str_v1(const char *func, const char *file, int line, int subsys, const char *rval);
|
|
__dso_public void sudo_debug_exit_str_masked_v1(const char *func, const char *file, int line, int subsys, const char *rval);
|
|
__dso_public pid_t sudo_debug_fork_v1(void);
|
|
__dso_public int sudo_debug_get_active_instance_v1(void);
|
|
__dso_public int sudo_debug_get_fds_v1(unsigned char **fds);
|
|
__dso_public int sudo_debug_get_instance_v1(const char *program);
|
|
__dso_public void sudo_debug_printf2_v1(const char *func, const char *file, int line, int level, const char *fmt, ...) __printf0like(5, 6);
|
|
__dso_public void sudo_debug_printf_nvm_v1(int pri, const char *fmt, ...) __printf0like(2, 3);
|
|
__dso_public int sudo_debug_register_v1(const char *program, const char *const subsystems[], unsigned int ids[], struct sudo_conf_debug_file_list *debug_files);
|
|
__dso_public int sudo_debug_set_active_instance_v1(int inst);
|
|
__dso_public void sudo_debug_update_fd_v1(int ofd, int nfd);
|
|
__dso_public void sudo_debug_vprintf2_v1(const char *func, const char *file, int line, int level, const char *fmt, va_list ap) __printf0like(5, 0);
|
|
__dso_public void sudo_debug_write2_v1(int fd, const char *func, const char *file, int line, const char *str, int len, int errnum);
|
|
|
|
#define sudo_debug_deregister(_a) sudo_debug_deregister_v1((_a))
|
|
#define sudo_debug_enter(_a, _b, _c, _d) sudo_debug_enter_v1((_a), (_b), (_c), (_d))
|
|
#define sudo_debug_execve2(_a, _b, _c, _d) sudo_debug_execve2_v1((_a), (_b), (_c), (_d))
|
|
#define sudo_debug_exit(_a, _b, _c, _d) sudo_debug_exit_v1((_a), (_b), (_c), (_d))
|
|
#define sudo_debug_exit_bool(_a, _b, _c, _d, _e) sudo_debug_exit_bool_v1((_a), (_b), (_c), (_d), (_e))
|
|
#define sudo_debug_exit_int(_a, _b, _c, _d, _e) sudo_debug_exit_int_v1((_a), (_b), (_c), (_d), (_e))
|
|
#define sudo_debug_exit_long(_a, _b, _c, _d, _e) sudo_debug_exit_long_v1((_a), (_b), (_c), (_d), (_e))
|
|
#define sudo_debug_exit_ptr(_a, _b, _c, _d, _e) sudo_debug_exit_ptr_v1((_a), (_b), (_c), (_d), (_e))
|
|
#define sudo_debug_exit_size_t(_a, _b, _c, _d, _e) sudo_debug_exit_size_t_v1((_a), (_b), (_c), (_d), (_e))
|
|
#define sudo_debug_exit_str(_a, _b, _c, _d, _e) sudo_debug_exit_str_v1((_a), (_b), (_c), (_d), (_e))
|
|
#define sudo_debug_exit_str_masked(_a, _b, _c, _d, _e) sudo_debug_exit_str_masked_v1((_a), (_b), (_c), (_d), (_e))
|
|
#define sudo_debug_fork() sudo_debug_fork_v1()
|
|
#define sudo_debug_get_active_instance() sudo_debug_get_active_instance_v1()
|
|
#define sudo_debug_get_fds(_a) sudo_debug_get_fds_v1((_a))
|
|
#define sudo_debug_get_instance(_a) sudo_debug_get_instance_v1((_a))
|
|
#define sudo_debug_printf2 sudo_debug_printf2_v1
|
|
#define sudo_debug_printf_nvm sudo_debug_printf_nvm_v1
|
|
#define sudo_debug_register(_a, _b, _c, _d) sudo_debug_register_v1((_a), (_b), (_c), (_d))
|
|
#define sudo_debug_set_active_instance(_a) sudo_debug_set_active_instance_v1((_a))
|
|
#define sudo_debug_update_fd(_a, _b) sudo_debug_update_fd_v1((_a), (_b))
|
|
#define sudo_debug_vprintf2(_a, _b, _c, _d, _e, _f) sudo_debug_vprintf2_v1((_a), (_b), (_c), (_d), (_e), (_f))
|
|
#define sudo_debug_write2(_a, _b, _c, _d, _e, _f, _g) sudo_debug_write2_v1((_a), (_b), (_c), (_d), (_e), (_f), (_g))
|
|
|
|
#endif /* SUDO_DEBUG_H */
|