ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / include

/*
 * SPDX-License-Identifier: ISC
 *
 * Copyright (c) 2009-2018 Todd C. Miller <Todd.Miller@sudo.ws>
 *
 * 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_PLUGIN_H
#define SUDO_PLUGIN_H

/* API version major/minor */
#define SUDO_API_VERSION_MAJOR 1
#define SUDO_API_VERSION_MINOR 14
#define SUDO_API_MKVERSION(x, y) (((x) << 16) | (y))
#define SUDO_API_VERSION SUDO_API_MKVERSION(SUDO_API_VERSION_MAJOR, SUDO_API_VERSION_MINOR)

/* Getters and setters for plugin API versions */
#define SUDO_API_VERSION_GET_MAJOR(v) ((v) >> 16)
#define SUDO_API_VERSION_GET_MINOR(v) ((v) & 0xffffU)
#define SUDO_API_VERSION_SET_MAJOR(vp, n) do { \
    *(vp) = (*(vp) & 0x0000ffffU) | ((n) << 16); \
} while(0)
#define SUDO_API_VERSION_SET_MINOR(vp, n) do { \
    *(vp) = (*(vp) & 0xffff0000U) | (n); \
} while(0)

/* Conversation function types and defines */
struct sudo_conv_message {
#define SUDO_CONV_PROMPT_ECHO_OFF   0x0001  /* do not echo user input */
#define SUDO_CONV_PROMPT_ECHO_ON    0x0002  /* echo user input */
#define SUDO_CONV_ERROR_MSG	    0x0003  /* error message */
#define SUDO_CONV_INFO_MSG	    0x0004  /* informational message */
#define SUDO_CONV_PROMPT_MASK	    0x0005  /* mask user input */
#define SUDO_CONV_PROMPT_ECHO_OK    0x1000  /* flag: allow echo if no tty */
#define SUDO_CONV_PREFER_TTY	    0x2000  /* flag: use tty if possible */
    int msg_type;
    int timeout;
    const char *msg;
};

/*
 * Maximum length of a reply (not including the trailing NUL) when
 * conversing with the user.  In practical terms, this is the longest
 * password sudo will support.  This means that a buffer of size
 * SUDO_CONV_REPL_MAX+1 is guaranteed to be able to hold any reply
 * from the conversation function.  It is also useful as a max value
 * for memset_s() when clearing passwords returned by the conversation
 * function.
 */
#define SUDO_CONV_REPL_MAX	255

struct sudo_conv_reply {
    char *reply;
};

/* Conversation callback API version major/minor */
#define SUDO_CONV_CALLBACK_VERSION_MAJOR	1
#define SUDO_CONV_CALLBACK_VERSION_MINOR	0
#define SUDO_CONV_CALLBACK_VERSION SUDO_API_MKVERSION(SUDO_CONV_CALLBACK_VERSION_MAJOR, SUDO_CONV_CALLBACK_VERSION_MINOR)

/*
 * Callback struct to be passed to the conversation function.
 * Can be used to perform operations on suspend/resume such
 * as dropping/acquiring locks.
 */
typedef int (*sudo_conv_callback_fn_t)(int signo, void *closure);
struct sudo_conv_callback {
    unsigned int version;
    void *closure;
    sudo_conv_callback_fn_t on_suspend;
    sudo_conv_callback_fn_t on_resume;
};

typedef int (*sudo_conv_t)(int num_msgs, const struct sudo_conv_message msgs[],
	struct sudo_conv_reply replies[], struct sudo_conv_callback *callback);
typedef int (*sudo_printf_t)(int msg_type, const char *fmt, ...);

/*
 * Hooks allow a plugin to hook into specific sudo and/or libc functions.
 */

/* Hook functions typedefs. */
typedef int (*sudo_hook_fn_t)();
typedef int (*sudo_hook_fn_setenv_t)(const char *name, const char *value, int overwrite, void *closure);
typedef int (*sudo_hook_fn_putenv_t)(char *string, void *closure);
typedef int (*sudo_hook_fn_getenv_t)(const char *name, char **value, void *closure);
typedef int (*sudo_hook_fn_unsetenv_t)(const char *name, void *closure);

/* Hook structure definition. */
struct sudo_hook {
    unsigned int hook_version;
    unsigned int hook_type;
    sudo_hook_fn_t hook_fn;
    void *closure;
};

/* Hook API version major/minor */
#define SUDO_HOOK_VERSION_MAJOR	1
#define SUDO_HOOK_VERSION_MINOR	0
#define SUDO_HOOK_VERSION SUDO_API_MKVERSION(SUDO_HOOK_VERSION_MAJOR, SUDO_HOOK_VERSION_MINOR)

/*
 * Hook function return values.
 */
#define SUDO_HOOK_RET_ERROR	-1	/* error */
#define SUDO_HOOK_RET_NEXT	0	/* go to the next hook in the list */
#define SUDO_HOOK_RET_STOP	1	/* stop hook processing for this type */

/*
 * Hooks for setenv/unsetenv/putenv/getenv.
 * This allows the plugin to be notified when a PAM module modifies
 * the environment so it can update the copy of the environment that
 * is passed to execve().
 */
#define SUDO_HOOK_SETENV	1
#define SUDO_HOOK_UNSETENV	2
#define SUDO_HOOK_PUTENV	3
#define SUDO_HOOK_GETENV	4

/* Policy plugin type and defines */
struct passwd;
struct policy_plugin {
#define SUDO_POLICY_PLUGIN     1
    unsigned int type; /* always SUDO_POLICY_PLUGIN */
    unsigned int version; /* always SUDO_API_VERSION */
    int (*open)(unsigned int version, sudo_conv_t conversation,
	sudo_printf_t sudo_printf, char * const settings[],
	char * const user_info[], char * const user_env[],
	char * const plugin_options[]);
    void (*close)(int exit_status, int error); /* wait status or error */
    int (*show_version)(int verbose);
    int (*check_policy)(int argc, char * const argv[],
	char *env_add[], char **command_info[],
	char **argv_out[], char **user_env_out[]);
    int (*list)(int argc, char * const argv[], int verbose,
	const char *list_user);
    int (*validate)(void);
    void (*invalidate)(int remove);
    int (*init_session)(struct passwd *pwd, char **user_env_out[]);
    void (*register_hooks)(int version, int (*register_hook)(struct sudo_hook *hook));
    void (*deregister_hooks)(int version, int (*deregister_hook)(struct sudo_hook *hook));
};

/* I/O plugin type and defines */
struct io_plugin {
#define SUDO_IO_PLUGIN	    2
    unsigned int type; /* always SUDO_IO_PLUGIN */
    unsigned int version; /* always SUDO_API_VERSION */
    int (*open)(unsigned int version, sudo_conv_t conversation,
	sudo_printf_t sudo_printf, char * const settings[],
	char * const user_info[], char * const command_info[],
	int argc, char * const argv[], char * const user_env[],
	char * const plugin_options[]);
    void (*close)(int exit_status, int error); /* wait status or error */
    int (*show_version)(int verbose);
    int (*log_ttyin)(const char *buf, unsigned int len);
    int (*log_ttyout)(const char *buf, unsigned int len);
    int (*log_stdin)(const char *buf, unsigned int len);
    int (*log_stdout)(const char *buf, unsigned int len);
    int (*log_stderr)(const char *buf, unsigned int len);
    void (*register_hooks)(int version, int (*register_hook)(struct sudo_hook *hook));
    void (*deregister_hooks)(int version, int (*deregister_hook)(struct sudo_hook *hook));
    int (*change_winsize)(unsigned int line, unsigned int cols);
    int (*log_suspend)(int signo);
};

/* Sudoers group plugin version major/minor */
#define GROUP_API_VERSION_MAJOR 1
#define GROUP_API_VERSION_MINOR 0
#define GROUP_API_VERSION SUDO_API_MKVERSION(GROUP_API_VERSION_MAJOR, GROUP_API_VERSION_MINOR)

/* Getters and setters for group version (for source compat only) */
#define GROUP_API_VERSION_GET_MAJOR(v) SUDO_API_VERSION_GET_MAJOR(v)
#define GROUP_API_VERSION_GET_MINOR(v) SUDO_API_VERSION_GET_MINOR(v)
#define GROUP_API_VERSION_SET_MAJOR(vp, n) SUDO_API_VERSION_SET_MAJOR(vp, n)
#define GROUP_API_VERSION_SET_MINOR(vp, n) SUDO_API_VERSION_SET_MINOR(vp, n)

/*
 * version: for compatibility checking
 * group_init: return 1 on success, 0 if unconfigured, -1 on error.
 * group_cleanup: called to clean up resources used by provider
 * user_in_group: returns 1 if user is in group, 0 if not.
 *                note that pwd may be NULL if the user is not in passwd.
 */
struct sudoers_group_plugin {
    unsigned int version;
    int (*init)(int version, sudo_printf_t sudo_printf, char *const argv[]);
    void (*cleanup)(void);
    int (*query)(const char *user, const char *group, const struct passwd *pwd);
};

#endif /* SUDO_PLUGIN_H */

[+] ..
[-] ucontext.h [edit]
[-] syscall.h [edit]
[-] complex.h [edit]
[-] pnglibconf.h [edit]
[-] nc_tparm.h [edit]
[-] wordexp.h [edit]
[-] fmtmsg.h [edit]
[-] dlfcn.h [edit]
[-] ncurses_dll.h [edit]
[+] freetype2
[+] GL
[+] glib-2.0
[-] cursesw.h [edit]
[-] cursesf.h [edit]
[-] printf.h [edit]
[+] c++
[-] expat.h [edit]
[-] proc_service.h [edit]
[-] fnmatch.h [edit]
[-] regex.h [edit]
[-] oniguruma.h [edit]
[-] semaphore.h [edit]
[-] gshadow.h [edit]
[-] pcre2posix.h [edit]
[-] expat_external.h [edit]
[-] link.h [edit]
[-] errno.h [edit]
[-] ldap_utf8.h [edit]
[-] ftw.h [edit]
[-] math.h [edit]
[+] neteconet
[-] form.h [edit]
[-] err.h [edit]
[-] syslog.h [edit]
[+] arpa
[-] inttypes.h [edit]
[-] event.h [edit]
[-] fenv.h [edit]
[-] pty.h [edit]
[-] ldap_features.h [edit]
[-] monetary.h [edit]
[+] iproute2
[-] poll.h [edit]
[-] tgmath.h [edit]
[+] misc
[-] wctype.h [edit]
[-] tar.h [edit]
[-] aio.h [edit]
[+] tirpc
[-] stdlib.h [edit]
[-] envz.h [edit]
[+] protocols
[-] re_comp.h [edit]
[-] ncurses.h [edit]
[-] db.h [edit]
[+] lua5.3
[+] netipx
[-] alloca.h [edit]
[-] cpio.h [edit]
[-] mpath_cmd.h [edit]
[+] netax25
[-] fcntl.h [edit]
[-] sgtty.h [edit]
[-] ctype.h [edit]
[+] xen
[-] stdc-predef.h [edit]
[+] x86_64-linux-gnu
[-] features.h [edit]
[+] rpcsvc
[-] pcrecpparg.h [edit]
[-] nss.h [edit]
[-] cursesapp.h [edit]
[-] crypt.h [edit]
[-] term.h [edit]
[+] blkid
[-] libgen.h [edit]
[+] mtd
[-] elf.h [edit]
[-] panel.h [edit]
[-] limits.h [edit]
[-] etip.h [edit]
[+] libpng16
[-] cursslk.h [edit]
[-] grp.h [edit]
[-] evhttp.h [edit]
[-] mntent.h [edit]
[-] string.h [edit]
[-] wchar.h [edit]
[-] nl_types.h [edit]
[-] fstab.h [edit]
[-] evutil.h [edit]
[-] pcre2.h [edit]
[-] openldap.h [edit]
[-] stab.h [edit]
[-] mpath_persist.h [edit]
[+] sound
[-] gnu-versions.h [edit]
[-] assert.h [edit]
[+] netinet
[+] rdma
[-] ttyent.h [edit]
[-] thread_db.h [edit]
[-] ulimit.h [edit]
[-] mqueue.h [edit]
[+] netash
[-] ldap_cdefs.h [edit]
[+] xfs
[-] libintl.h [edit]
[-] gconv.h [edit]
[-] wait.h [edit]
[+] selinux
[+] ncursesw
[-] setjmp.h [edit]
[+] netiucv
[+] python3.8
[+] xcb
[-] locale.h [edit]
[+] rpc
[-] unistd.h [edit]
[-] sched.h [edit]
[-] time.h [edit]
[-] onigposix.h [edit]
[-] zconf.h [edit]
[-] pwd.h [edit]
[+] asm-generic
[+] gio-unix-2.0
[-] fts.h [edit]
[+] netrom
[+] linux
[-] stdio_ext.h [edit]
[-] pngconf.h [edit]
[-] sudo_plugin.h [edit]
[-] threads.h [edit]
[+] python2.7
[+] cairo
[-] evrpc.h [edit]
[-] evdns.h [edit]
[-] termios.h [edit]
[-] lber_types.h [edit]
[+] reglib
[-] utmp.h [edit]
[-] ldif.h [edit]
[-] paths.h [edit]
[-] pcrecpp.h [edit]
[+] libpng
[-] pthread.h [edit]
[-] stdint.h [edit]
[-] utime.h [edit]
[-] langinfo.h [edit]
[+] finclude
[-] db_185.h [edit]
[-] execinfo.h [edit]
[-] strings.h [edit]
[+] netatalk
[-] lastlog.h [edit]
[-] dirent.h [edit]
[-] ar.h [edit]
[+] readline
[-] shadow.h [edit]
[-] curses.h [edit]
[-] getopt.h [edit]
[-] spawn.h [edit]
[-] signal.h [edit]
[+] sepol
[-] mcheck.h [edit]
[+] unicode
[-] ifaddrs.h [edit]
[-] tic.h [edit]
[-] unctrl.h [edit]
[-] byteswap.h [edit]
[+] libmount
[-] stdio.h [edit]
[-] pcre.h [edit]
[+] libdmmp
[-] termio.h [edit]
[-] pcreposix.h [edit]
[-] oniggnu.h [edit]
[-] values.h [edit]
[-] pcre_stringpiece.h [edit]
[-] iconv.h [edit]
[-] netdb.h [edit]
[-] cursesp.h [edit]
[+] X11
[-] memory.h [edit]
[-] obstack.h [edit]
[-] endian.h [edit]
[-] cursesm.h [edit]
[-] error.h [edit]
[+] drm
[+] net
[-] utmpx.h [edit]
[-] malloc.h [edit]
[-] gawkapi.h [edit]
[-] ltdl.h [edit]
[-] gnumake.h [edit]
[+] scsi
[-] termcap.h [edit]
[-] regexp.h [edit]
[-] argz.h [edit]
[-] eti.h [edit]
[-] aliases.h [edit]
[+] openssl
[-] resolv.h [edit]
[-] glob.h [edit]
[+] libxml2
[+] netrose
[+] webp
[+] security
[-] sysexits.h [edit]
[-] argp.h [edit]
[-] pcre_scanner.h [edit]
[+] uuid
[+] nfs
[-] search.h [edit]
[+] video
[-] ldap_schema.h [edit]
[-] uchar.h [edit]
[+] pixman-1
[-] zlib.h [edit]
[-] lber.h [edit]
[+] apache2
[+] event2
[-] menu.h [edit]
[-] ldap.h [edit]
[-] term_entry.h [edit]
[+] fontconfig
[+] netpacket
[+] libltdl
[-] png.h [edit]