|
|
|
|
|
diff -up sudo-1.8.6p7/doc/Makefile.in.sudoconfman sudo-1.8.6p7/doc/Makefile.in
|
|
|
|
|
|
--- sudo-1.8.6p7/doc/Makefile.in.sudoconfman 2013-07-30 13:57:00.000004193 +0200
|
|
|
|
|
|
+++ sudo-1.8.6p7/doc/Makefile.in 2013-07-30 13:58:25.732323525 +0200
|
|
|
|
|
|
@@ -64,12 +64,13 @@ DEVEL = @DEVEL@
|
|
|
|
|
|
|
|
|
|
|
|
SHELL = @SHELL@
|
|
|
|
|
|
|
|
|
|
|
|
-DOCS = sudo.$(mantype) visudo.$(mantype) sudoers.$(mantype) \
|
|
|
|
|
|
- sudoers.ldap.$(mantype) sudoers.$(mantype) \
|
|
|
|
|
|
+DOCS = sudo.$(mantype) visudo.$(mantype) sudo.conf.$(mantype) \
|
|
|
|
|
|
+ sudoers.$(mantype) sudoers.ldap.$(mantype) sudoers.$(mantype) \
|
|
|
|
|
|
sudoreplay.$(mantype) sudo_plugin.$(mantype)
|
|
|
|
|
|
|
|
|
|
|
|
DEVDOCS = $(srcdir)/sudo.man.in $(srcdir)/sudo.cat \
|
|
|
|
|
|
$(srcdir)/visudo.man.in $(srcdir)/visudo.cat \
|
|
|
|
|
|
+ $(srcdir)/sudo.conf.man.in $(srcdir)/sudo.conf.cat \
|
|
|
|
|
|
$(srcdir)/sudoers.man.in $(srcdir)/sudoers.cat \
|
|
|
|
|
|
$(srcdir)/sudoers.ldap.man.in $(srcdir)/sudoers.ldap.cat \
|
|
|
|
|
|
$(srcdir)/sudoers.man.in $(srcdir)/sudoers.cat \
|
|
|
|
|
|
@@ -158,6 +159,34 @@ $(srcdir)/visudo.cat: varsub $(srcdir)/v
|
|
|
|
|
|
|
|
|
|
|
|
visudo.cat: $(srcdir)/visudo.cat
|
|
|
|
|
|
|
|
|
|
|
|
+$(srcdir)/sudo.conf.man.in: $(srcdir)/sudo.conf.mdoc.in
|
|
|
|
|
|
+ @if [ -n "$(DEVEL)" ]; then \
|
|
|
|
|
|
+ echo "Generating $@"; \
|
|
|
|
|
|
+ mansectsu=`echo @MANSECTSU@|$(TR) A-Z a-z`; \
|
|
|
|
|
|
+ mansectform=`echo @MANSECTFORM@|$(TR) A-Z a-z`; \
|
|
|
|
|
|
+ printf '.\\" DO NOT EDIT THIS FILE, IT IS NOT THE MASTER!\n' > $@; \
|
|
|
|
|
|
+ printf '.\\" IT IS GENERATED AUTOMATICALLY FROM sudo.conf.mdoc.in\n' >> $@; \
|
|
|
|
|
|
+ $(SED) -n -e '/^.Dd/q' -e '/^\.\\/p' $(srcdir)/sudo.conf.mdoc.in >> $@; \
|
|
|
|
|
|
+ $(SED) -e "s/$$mansectsu/8/g" -e "s/$$mansectform/5/g" $(srcdir)/sudo.conf.mdoc.in | $(MANDOC) -Tman | $(SED) -e 's/^\(\.TH "VISUDO" \)"8"\(.*"\)OpenBSD \(.*\)/\1"'$$mansectsu'"\2\3/' -e "s/(5)/($$mansectform)/g" -e "s/(8)/($$mansectsu)/g" >> $@; \
|
|
|
|
|
|
+ fi
|
|
|
|
|
|
+
|
|
|
|
|
|
+sudo.conf.man.sed: $(srcdir)/fixman.sh
|
|
|
|
|
|
+ $(SHELL) $(srcdir)/fixman.sh $@
|
|
|
|
|
|
+
|
|
|
|
|
|
+sudo.conf.man: $(srcdir)/sudo.conf.man.in sudo.conf.man.sed
|
|
|
|
|
|
+ (cd $(top_builddir) && $(SHELL) config.status --file=-) < $(srcdir)/$@.in | $(SED) -f $@.sed > $@
|
|
|
|
|
|
+
|
|
|
|
|
|
+sudo.conf.mdoc: $(srcdir)/sudo.conf.mdoc.in
|
|
|
|
|
|
+ (cd $(top_builddir) && $(SHELL) config.status --file=doc/$@)
|
|
|
|
|
|
+
|
|
|
|
|
|
+$(srcdir)/sudo.conf.cat: varsub $(srcdir)/sudo.conf.mdoc.in
|
|
|
|
|
|
+ @if [ -n "$(DEVEL)" ]; then \
|
|
|
|
|
|
+ echo "Generating $@"; \
|
|
|
|
|
|
+ $(SED) -f varsub $(srcdir)/sudo.conf.mdoc.in | $(MANDOC) -mdoc | $(SED) -e 's/ OpenBSD \([^ ].* \)/ \1 /' -e 's/(5)/(4)/g' -e 's/(8)/(1m)/g' > $@; \
|
|
|
|
|
|
+ fi
|
|
|
|
|
|
+
|
|
|
|
|
|
+sudo.conf.cat: $(srcdir)/sudo.conf.cat
|
|
|
|
|
|
+
|
|
|
|
|
|
$(srcdir)/sudoers.man.in: $(srcdir)/sudoers.mdoc.in
|
|
|
|
|
|
@if [ -n "$(DEVEL)" ]; then \
|
|
|
|
|
|
echo "Generating $@"; \
|
|
|
|
|
|
@@ -292,10 +321,11 @@ install-doc: install-dirs
|
|
|
|
|
|
$(INSTALL) -O $(install_uid) -G $(install_gid) -m 0644 @mansrcdir@/sudo_plugin.$(mantype) $(DESTDIR)$(mandirsu)/sudo_plugin.$(mansectsu)
|
|
|
|
|
|
$(INSTALL) -O $(install_uid) -G $(install_gid) -m 0644 @mansrcdir@/sudoreplay.$(mantype) $(DESTDIR)$(mandirsu)/sudoreplay.$(mansectsu)
|
|
|
|
|
|
$(INSTALL) -O $(install_uid) -G $(install_gid) -m 0644 @mansrcdir@/visudo.$(mantype) $(DESTDIR)$(mandirsu)/visudo.$(mansectsu)
|
|
|
|
|
|
+ $(INSTALL) -O $(install_uid) -G $(install_gid) -m 0644 @mansrcdir@/sudo.conf.$(mantype) $(DESTDIR)$(mandirform)/sudo.conf.$(mansectform)
|
|
|
|
|
|
$(INSTALL) -O $(install_uid) -G $(install_gid) -m 0644 @mansrcdir@/sudoers.$(mantype) $(DESTDIR)$(mandirform)/sudoers.$(mansectform)
|
|
|
|
|
|
@LDAP@$(INSTALL) -O $(install_uid) -G $(install_gid) -m 0644 @mansrcdir@/sudoers.ldap.$(mantype) $(DESTDIR)$(mandirform)/sudoers.ldap.$(mansectform)
|
|
|
|
|
|
@if test -n "$(MANCOMPRESS)"; then \
|
|
|
|
|
|
- for f in $(mandirsu)/sudo.$(mansectsu) $(mandirsu)/sudo_plugin.$(mansectsu) $(mandirsu)/sudoreplay.$(mansectsu) $(mandirsu)/visudo.$(mansectsu) $(mandirform)/sudoers.$(mansectform) $(mandirform)/sudoers.ldap.$(mansectform); do \
|
|
|
|
|
|
+ for f in $(mandirsu)/sudo.$(mansectsu) $(mandirsu)/sudo_plugin.$(mansectsu) $(mandirsu)/sudoreplay.$(mansectsu) $(mandirsu)/visudo.$(mansectsu) $(mandirform)/sudo.conf.$(mansectform) $(mandirform)/sudoers.$(mansectform) $(mandirform)/sudoers.ldap.$(mansectform); do \
|
|
|
|
|
|
if test -f $(DESTDIR)$$f; then \
|
|
|
|
|
|
echo $(MANCOMPRESS) -f $(DESTDIR)$$f; \
|
|
|
|
|
|
$(MANCOMPRESS) -f $(DESTDIR)$$f; \
|
|
|
|
|
|
@@ -319,6 +349,7 @@ uninstall:
|
|
|
|
|
|
$(DESTDIR)$(mandirsu)/sudo_plugin.$(mansectsu) \
|
|
|
|
|
|
$(DESTDIR)$(mandirsu)/sudoreplay.$(mansectsu) \
|
|
|
|
|
|
$(DESTDIR)$(mandirsu)/visudo.$(mansectsu) \
|
|
|
|
|
|
+ $(DESTDIR)$(mandirform)/sudo.conf.$(mansectform) \
|
|
|
|
|
|
$(DESTDIR)$(mandirform)/sudoers.$(mansectform) \
|
|
|
|
|
|
$(DESTDIR)$(mandirform)/sudoers.ldap.$(mansectform)
|
|
|
|
|
|
|
|
|
|
|
|
diff -up sudo-1.8.6p7/doc/sudo.conf.cat.sudoconfman sudo-1.8.6p7/doc/sudo.conf.cat
|
|
|
|
|
|
--- sudo-1.8.6p7/doc/sudo.conf.cat.sudoconfman 2013-07-30 13:58:15.401285217 +0200
|
|
|
|
|
|
+++ sudo-1.8.6p7/doc/sudo.conf.cat 2013-07-30 13:58:25.733323538 +0200
|
|
|
|
|
|
@@ -0,0 +1,263 @@
|
|
|
|
|
|
+SUDO(4) Programmer's Manual SUDO(4)
|
|
|
|
|
|
+
|
|
|
|
|
|
+NNAAMMEE
|
|
|
|
|
|
+ ssuuddoo..ccoonnff - configuration for sudo front end
|
|
|
|
|
|
+
|
|
|
|
|
|
+DDEESSCCRRIIPPTTIIOONN
|
|
|
|
|
|
+ The ssuuddoo..ccoonnff file is used to configure the ssuuddoo front end. It specifies
|
|
|
|
|
|
+ the security policy and I/O logging plugins, debug flags as well as
|
|
|
|
|
|
+ plugin-agnostic path names and settings.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ The ssuuddoo..ccoonnff file supports the following directives, described in detail
|
|
|
|
|
|
+ below.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Plugin a security policy or I/O logging plugin
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Path a plugin-agnostic path
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Set a front end setting, such as _d_i_s_a_b_l_e___c_o_r_e_d_u_m_p or _g_r_o_u_p___s_o_u_r_c_e
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Debug debug flags to aid in debugging ssuuddoo, ssuuddoorreeppllaayy, vviissuuddoo, and
|
|
|
|
|
|
+ the ssuuddooeerrss plugin.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ The pound sign (`#') is used to indicate a comment. Both the comment
|
|
|
|
|
|
+ character and any text after it, up to the end of the line, are ignored.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Non-comment lines that don't begin with Plugin, Path, Debug, or Set are
|
|
|
|
|
|
+ silently ignored.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ The ssuuddoo..ccoonnff file is always parsed in the ``C'' locale.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ PPlluuggiinn ccoonnffiigguurraattiioonn
|
|
|
|
|
|
+ ssuuddoo supports a plugin architecture for security policies and
|
|
|
|
|
|
+ input/output logging. Third parties can develop and distribute their own
|
|
|
|
|
|
+ policy and I/O logging plugins to work seamlessly with the ssuuddoo front
|
|
|
|
|
|
+ end. Plugins are dynamically loaded based on the contents of ssuuddoo..ccoonnff.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ A Plugin line consists of the Plugin keyword, followed by the _s_y_m_b_o_l___n_a_m_e
|
|
|
|
|
|
+ and the _p_a_t_h to the shared object containing the plugin. The _s_y_m_b_o_l___n_a_m_e
|
|
|
|
|
|
+ is the name of the struct policy_plugin or struct io_plugin in the plugin
|
|
|
|
|
|
+ shared object. The _p_a_t_h may be fully qualified or relative. If not
|
|
|
|
|
|
+ fully qualified, it is relative to the _/_u_s_r_/_l_o_c_a_l_/_l_i_b_e_x_e_c directory. In
|
|
|
|
|
|
+ other words:
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Plugin sudoers_policy sudoers.so
|
|
|
|
|
|
+
|
|
|
|
|
|
+ is equivalent to:
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Plugin sudoers_policy /usr/local/libexec/sudoers.so
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Any additional parameters after the _p_a_t_h are passed as arguments to the
|
|
|
|
|
|
+ plugin's _o_p_e_n function. For example, to override the compile-time
|
|
|
|
|
|
+ default sudoers file mode:
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Plugin sudoers_policy sudoers.so sudoers_mode=0440
|
|
|
|
|
|
+
|
|
|
|
|
|
+ If no ssuuddoo..ccoonnff file is present, or if it contains no Plugin lines, the
|
|
|
|
|
|
+ ssuuddooeerrss plugin will be used as the default security policy and for I/O
|
|
|
|
|
|
+ logging (if enabled by the policy). This is equivalent to the following:
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Plugin policy_plugin sudoers.so
|
|
|
|
|
|
+ Plugin io_plugin sudoers.so
|
|
|
|
|
|
+
|
|
|
|
|
|
+ For more information on the ssuuddoo plugin architecture, see the
|
|
|
|
|
|
+ sudo_plugin(1m) manual.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ PPaatthh sseettttiinnggss
|
|
|
|
|
|
+ A Path line consists of the Path keyword, followed by the name of the
|
|
|
|
|
|
+ path to set and its value. For example:
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Path noexec /usr/local/libexec/sudo_noexec.so
|
|
|
|
|
|
+ Path askpass /usr/X11R6/bin/ssh-askpass
|
|
|
|
|
|
+
|
|
|
|
|
|
+ The following plugin-agnostic paths may be set in the _/_e_t_c_/_s_u_d_o_._c_o_n_f
|
|
|
|
|
|
+ file:
|
|
|
|
|
|
+
|
|
|
|
|
|
+ askpass The fully qualified path to a helper program used to read the
|
|
|
|
|
|
+ user's password when no terminal is available. This may be the
|
|
|
|
|
|
+ case when ssuuddoo is executed from a graphical (as opposed to
|
|
|
|
|
|
+ text-based) application. The program specified by _a_s_k_p_a_s_s
|
|
|
|
|
|
+ should display the argument passed to it as the prompt and
|
|
|
|
|
|
+ write the user's password to the standard output. The value of
|
|
|
|
|
|
+ _a_s_k_p_a_s_s may be overridden by the SUDO_ASKPASS environment
|
|
|
|
|
|
+ variable.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ noexec The fully-qualified path to a shared library containing dummy
|
|
|
|
|
|
+ versions of the eexxeeccvv(), eexxeeccvvee() and ffeexxeeccvvee() library
|
|
|
|
|
|
+ functions that just return an error. This is used to implement
|
|
|
|
|
|
+ the _n_o_e_x_e_c functionality on systems that support LD_PRELOAD or
|
|
|
|
|
|
+ its equivalent. The default value is:
|
|
|
|
|
|
+ _/_u_s_r_/_l_o_c_a_l_/_l_i_b_e_x_e_c_/_s_u_d_o___n_o_e_x_e_c_._s_o.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ OOtthheerr sseettttiinnggss
|
|
|
|
|
|
+ The ssuuddoo..ccoonnff file also supports the following front end settings:
|
|
|
|
|
|
+
|
|
|
|
|
|
+ disable_coredump
|
|
|
|
|
|
+ Core dumps of ssuuddoo itself are disabled by default. To aid in
|
|
|
|
|
|
+ debugging ssuuddoo crashes, you may wish to re-enable core dumps by
|
|
|
|
|
|
+ setting ``disable_coredump'' to false in ssuuddoo..ccoonnff as follows:
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Set disable_coredump false
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Note that most operating systems disable core dumps from setuid
|
|
|
|
|
|
+ programs, including ssuuddoo. To actually get a ssuuddoo core file you
|
|
|
|
|
|
+ will likely need to enable core dumps for setuid processes. On
|
|
|
|
|
|
+ BSD and Linux systems this is accomplished via the sysctl
|
|
|
|
|
|
+ command. On Solaris, the coreadm command is used to configure
|
|
|
|
|
|
+ core dump behavior.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ This setting is only available in ssuuddoo version 1.8.4 and
|
|
|
|
|
|
+ higher.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ DDeebbuugg ffllaaggss
|
|
|
|
|
|
+ ssuuddoo versions 1.8.4 and higher support a flexible debugging framework
|
|
|
|
|
|
+ that can help track down what ssuuddoo is doing internally if there is a
|
|
|
|
|
|
+ problem.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ A Debug line consists of the Debug keyword, followed by the name of the
|
|
|
|
|
|
+ program (or plugin) to debug (ssuuddoo, vviissuuddoo, ssuuddoorreeppllaayy, ssuuddooeerrss), the
|
|
|
|
|
|
+ debug file name and a comma-separated list of debug flags. The debug
|
|
|
|
|
|
+ flag syntax used by ssuuddoo and the ssuuddooeerrss plugin is _s_u_b_s_y_s_t_e_m@_p_r_i_o_r_i_t_y but
|
|
|
|
|
|
+ a plugin is free to use a different format so long as it does not include
|
|
|
|
|
|
+ a comma (`,').
|
|
|
|
|
|
+
|
|
|
|
|
|
+ For example:
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Debug sudo /var/log/sudo_debug all@warn,plugin@info
|
|
|
|
|
|
+
|
|
|
|
|
|
+ would log all debugging statements at the _w_a_r_n level and higher in
|
|
|
|
|
|
+ addition to those at the _i_n_f_o level for the plugin subsystem.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Currently, only one Debug entry per program is supported. The ssuuddoo Debug
|
|
|
|
|
|
+ entry is shared by the ssuuddoo front end, ssuuddooeeddiitt and the plugins. A
|
|
|
|
|
|
+ future release may add support for per-plugin Debug lines and/or support
|
|
|
|
|
|
+ for multiple debugging files for a single program.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ The priorities used by the ssuuddoo front end, in order of decreasing
|
|
|
|
|
|
+ severity, are: _c_r_i_t, _e_r_r, _w_a_r_n, _n_o_t_i_c_e, _d_i_a_g, _i_n_f_o, _t_r_a_c_e and _d_e_b_u_g.
|
|
|
|
|
|
+ Each priority, when specified, also includes all priorities higher than
|
|
|
|
|
|
+ it. For example, a priority of _n_o_t_i_c_e would include debug messages
|
|
|
|
|
|
+ logged at _n_o_t_i_c_e and higher.
|
|
|
|
|
|
+
|
|
|
|
|
|
+ The following subsystems are used by the ssuuddoo front-end:
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _a_l_l matches every subsystem
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _a_r_g_s command line argument processing
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _c_o_n_v user conversation
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _e_d_i_t sudoedit
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _e_x_e_c command execution
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _m_a_i_n ssuuddoo main function
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _n_e_t_i_f network interface handling
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _p_c_o_m_m communication with the plugin
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _p_l_u_g_i_n plugin configuration
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _p_t_y pseudo-tty related code
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _s_e_l_i_n_u_x SELinux-specific handling
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _u_t_i_l utility functions
|
|
|
|
|
|
+
|
|
|
|
|
|
+ _u_t_m_p utmp handling
|
|
|
|
|
|
+
|
|
|
|
|
|
+FFIILLEESS
|
|
|
|
|
|
+ _/_e_t_c_/_s_u_d_o_._c_o_n_f ssuuddoo front end configuration
|
|
|
|
|
|
+
|
|
|
|
|
|
+EEXXAAMMPPLLEESS
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # Default /etc/sudo.conf file
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # Format:
|
|
|
|
|
|
+ # Plugin plugin_name plugin_path plugin_options ...
|
|
|
|
|
|
+ # Path askpass /path/to/askpass
|
|
|
|
|
|
+ # Path noexec /path/to/sudo_noexec.so
|
|
|
|
|
|
+ # Debug sudo /var/log/sudo_debug all@warn
|
|
|
|
|
|
+ # Set disable_coredump true
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # The plugin_path is relative to /usr/local/libexec unless
|
|
|
|
|
|
+ # fully qualified.
|
|
|
|
|
|
+ # The plugin_name corresponds to a global symbol in the plugin
|
|
|
|
|
|
+ # that contains the plugin interface structure.
|
|
|
|
|
|
+ # The plugin_options are optional.
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # The sudoers plugin is used by default if no Plugin lines are
|
|
|
|
|
|
+ # present.
|
|
|
|
|
|
+ Plugin policy_plugin sudoers.so
|
|
|
|
|
|
+ Plugin io_plugin sudoers.so
|
|
|
|
|
|
+
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # Sudo askpass:
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # An askpass helper program may be specified to provide a graphical
|
|
|
|
|
|
+ # password prompt for "sudo -A" support. Sudo does not ship with
|
|
|
|
|
|
+ # its own askpass program but can use the OpenSSH askpass.
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # Use the OpenSSH askpass
|
|
|
|
|
|
+ #Path askpass /usr/X11R6/bin/ssh-askpass
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # Use the Gnome OpenSSH askpass
|
|
|
|
|
|
+ #Path askpass /usr/libexec/openssh/gnome-ssh-askpass
|
|
|
|
|
|
+
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # Sudo noexec:
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # Path to a shared library containing dummy versions of the execv(),
|
|
|
|
|
|
+ # execve() and fexecve() library functions that just return an error.
|
|
|
|
|
|
+ # This is used to implement the "noexec" functionality on systems that
|
|
|
|
|
|
+ # support C<LD_PRELOAD> or its equivalent.
|
|
|
|
|
|
+ # The compiled-in value is usually sufficient and should only be
|
|
|
|
|
|
+ # changed if you rename or move the sudo_noexec.so file.
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ #Path noexec /usr/local/libexec/sudo_noexec.so
|
|
|
|
|
|
+
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # Core dumps:
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ # By default, sudo disables core dumps while it is executing
|
|
|
|
|
|
+ # (they are re-enabled for the command that is run).
|
|
|
|
|
|
+ # To aid in debugging sudo problems, you may wish to enable core
|
|
|
|
|
|
+ # dumps by setting "disable_coredump" to false.
|
|
|
|
|
|
+ #
|
|
|
|
|
|
+ #Set disable_coredump false
|
|
|
|
|
|
+
|
|
|
|
|
|
+SSEEEE AALLSSOO
|
|
|
|
|
|
+ sudoers(4), sudo(1m), sudo_plugin(1m),
|
|
|
|
|
|
+
|
|
|
|
|
|
+HHIISSTTOORRYY
|
|
|
|
|
|
+ See the HISTORY file in the ssuuddoo distribution
|
|
|
|
|
|
+ (http://www.sudo.ws/sudo/history.html) for a brief history of sudo.
|
|
|
|
|
|
+
|
|
|
|
|
|
+AAUUTTHHOORRSS
|
|
|
|
|
|
+ Many people have worked on ssuuddoo over the years; this version consists of
|
|
|
|
|
|
+ code written primarily by:
|
|
|
|
|
|
+
|
|
|
|
|
|
+ Todd C. Miller
|
|
|
|
|
|
+
|
|
|
|
|
|
+ See the CONTRIBUTORS file in the ssuuddoo distribution
|
|
|
|
|
|
+ (http://www.sudo.ws/sudo/contributors.html) for an exhaustive list of
|
|
|
|
|
|
+ people who have contributed to ssuuddoo.
|
|
|
|
|
|
+
|
|
|
|
|
|
+BBUUGGSS
|
|
|
|
|
|
+ If you feel you have found a bug in ssuuddoo, please submit a bug report at
|
|
|
|
|
|
+ http://www.sudo.ws/sudo/bugs/
|
|
|
|
|
|
+
|
|
|
|
|
|
+SSUUPPPPOORRTT
|
|
|
|
|
|
+ Limited free support is available via the sudo-users mailing list, see
|
|
|
|
|
|
+ http://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or search the
|
|
|
|
|
|
+ archives.
|
|
|
|
|
|
+
|
|
|
|
|
|
+DDIISSCCLLAAIIMMEERR
|
|
|
|
|
|
+ ssuuddoo is provided ``AS IS'' and any express or implied warranties,
|
|
|
|
|
|
+ including, but not limited to, the implied warranties of merchantability
|
|
|
|
|
|
+ and fitness for a particular purpose are disclaimed. See the LICENSE
|
|
|
|
|
|
+ file distributed with ssuuddoo or http://www.sudo.ws/sudo/license.html for
|
|
|
|
|
|
+ complete details.
|
|
|
|
|
|
+
|
|
|
|
|
|
+Sudo 1.8.6p7 February 1, 2013 Sudo 1.8.6p7
|
|
|
|
|
|
diff -up sudo-1.8.6p7/doc/sudo.conf.man.in.sudoconfman sudo-1.8.6p7/doc/sudo.conf.man.in
|
|
|
|
|
|
--- sudo-1.8.6p7/doc/sudo.conf.man.in.sudoconfman 2013-07-30 13:58:15.401285217 +0200
|
|
|
|
|
|
+++ sudo-1.8.6p7/doc/sudo.conf.man.in 2013-07-30 13:58:25.733323538 +0200
|
|
|
|
|
|
@@ -0,0 +1,470 @@
|
|
|
|
|
|
+.\" DO NOT EDIT THIS FILE, IT IS NOT THE MASTER!
|
|
|
|
|
|
+.\" IT IS GENERATED AUTOMATICALLY FROM sudo.conf.mdoc.in
|
|
|
|
|
|
+.\"
|
|
|
|
|
|
+.\" Copyright (c) 2010-2013 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.
|
|
|
|
|
|
+.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
|
|
+.\"
|
|
|
|
|
|
+.TH "SUDO" "5" "February 1, 2013" "Sudo @PACKAGE_VERSION@" "OpenBSD Programmer's Manual"
|
|
|
|
|
|
+.nh
|
|
|
|
|
|
+.if n .ad l
|
|
|
|
|
|
+.SH "NAME"
|
|
|
|
|
|
+\fBsudo.conf\fR
|
|
|
|
|
|
+\- configuration for sudo front end
|
|
|
|
|
|
+.SH "DESCRIPTION"
|
|
|
|
|
|
+The
|
|
|
|
|
|
+\fBsudo.conf\fR
|
|
|
|
|
|
+file is used to configure the
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+front end.
|
|
|
|
|
|
+It specifies the security policy and I/O logging plugins, debug flags
|
|
|
|
|
|
+as well as plugin-agnostic path names and settings.
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+The
|
|
|
|
|
|
+\fBsudo.conf\fR
|
|
|
|
|
|
+file supports the following directives, described in detail below.
|
|
|
|
|
|
+.TP 10n
|
|
|
|
|
|
+Plugin
|
|
|
|
|
|
+a security policy or I/O logging plugin
|
|
|
|
|
|
+.TP 10n
|
|
|
|
|
|
+Path
|
|
|
|
|
|
+a plugin-agnostic path
|
|
|
|
|
|
+.TP 10n
|
|
|
|
|
|
+Set
|
|
|
|
|
|
+a front end setting, such as
|
|
|
|
|
|
+\fIdisable_coredump\fR
|
|
|
|
|
|
+or
|
|
|
|
|
|
+\fIgroup_source\fR
|
|
|
|
|
|
+.TP 10n
|
|
|
|
|
|
+Debug
|
|
|
|
|
|
+debug flags to aid in debugging
|
|
|
|
|
|
+\fBsudo\fR,
|
|
|
|
|
|
+\fBsudoreplay\fR,
|
|
|
|
|
|
+\fBvisudo\fR,
|
|
|
|
|
|
+and the
|
|
|
|
|
|
+\fBsudoers\fR
|
|
|
|
|
|
+plugin.
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+The pound sign
|
|
|
|
|
|
+(`#')
|
|
|
|
|
|
+is used to indicate a comment.
|
|
|
|
|
|
+Both the comment character and any text after it, up to the end of
|
|
|
|
|
|
+the line, are ignored.
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+Non-comment lines that don't begin with
|
|
|
|
|
|
+\fRPlugin\fR,
|
|
|
|
|
|
+\fRPath\fR,
|
|
|
|
|
|
+\fRDebug\fR,
|
|
|
|
|
|
+or
|
|
|
|
|
|
+\fRSet\fR
|
|
|
|
|
|
+are silently ignored.
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+The
|
|
|
|
|
|
+\fBsudo.conf\fR
|
|
|
|
|
|
+file is always parsed in the
|
|
|
|
|
|
+``\fRC\fR''
|
|
|
|
|
|
+locale.
|
|
|
|
|
|
+.SS "Plugin configuration"
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+supports a plugin architecture for security policies and input/output
|
|
|
|
|
|
+logging.
|
|
|
|
|
|
+Third parties can develop and distribute their own policy and I/O
|
|
|
|
|
|
+logging plugins to work seamlessly with the
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+front end.
|
|
|
|
|
|
+Plugins are dynamically loaded based on the contents of
|
|
|
|
|
|
+\fBsudo.conf\fR.
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+A
|
|
|
|
|
|
+\fRPlugin\fR
|
|
|
|
|
|
+line consists of the
|
|
|
|
|
|
+\fRPlugin\fR
|
|
|
|
|
|
+keyword, followed by the
|
|
|
|
|
|
+\fIsymbol_name\fR
|
|
|
|
|
|
+and the
|
|
|
|
|
|
+\fIpath\fR
|
|
|
|
|
|
+to the shared object containing the plugin.
|
|
|
|
|
|
+The
|
|
|
|
|
|
+\fIsymbol_name\fR
|
|
|
|
|
|
+is the name of the
|
|
|
|
|
|
+\fRstruct policy_plugin\fR
|
|
|
|
|
|
+or
|
|
|
|
|
|
+\fRstruct io_plugin\fR
|
|
|
|
|
|
+in the plugin shared object.
|
|
|
|
|
|
+The
|
|
|
|
|
|
+\fIpath\fR
|
|
|
|
|
|
+may be fully qualified or relative.
|
|
|
|
|
|
+If not fully qualified, it is relative to the
|
|
|
|
|
|
+\fI@PLUGINDIR@\fR
|
|
|
|
|
|
+directory.
|
|
|
|
|
|
+In other words:
|
|
|
|
|
|
+.nf
|
|
|
|
|
|
+.sp
|
|
|
|
|
|
+.RS 6n
|
|
|
|
|
|
+Plugin sudoers_policy sudoers.so
|
|
|
|
|
|
+.RE
|
|
|
|
|
|
+.fi
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+is equivalent to:
|
|
|
|
|
|
+.nf
|
|
|
|
|
|
+.sp
|
|
|
|
|
|
+.RS 6n
|
|
|
|
|
|
+Plugin sudoers_policy @PLUGINDIR@/sudoers.so
|
|
|
|
|
|
+.RE
|
|
|
|
|
|
+.fi
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+Any additional parameters after the
|
|
|
|
|
|
+\fIpath\fR
|
|
|
|
|
|
+are passed as arguments to the plugin's
|
|
|
|
|
|
+\fIopen\fR
|
|
|
|
|
|
+function.
|
|
|
|
|
|
+For example, to override the compile-time default sudoers file mode:
|
|
|
|
|
|
+.nf
|
|
|
|
|
|
+.sp
|
|
|
|
|
|
+.RS 6n
|
|
|
|
|
|
+Plugin sudoers_policy sudoers.so sudoers_mode=0440
|
|
|
|
|
|
+.RE
|
|
|
|
|
|
+.fi
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+If no
|
|
|
|
|
|
+\fBsudo.conf\fR
|
|
|
|
|
|
+file is present, or if it contains no
|
|
|
|
|
|
+\fRPlugin\fR
|
|
|
|
|
|
+lines, the
|
|
|
|
|
|
+\fBsudoers\fR
|
|
|
|
|
|
+plugin will be used as the default security policy and for I/O logging
|
|
|
|
|
|
+(if enabled by the policy).
|
|
|
|
|
|
+This is equivalent to the following:
|
|
|
|
|
|
+.nf
|
|
|
|
|
|
+.sp
|
|
|
|
|
|
+.RS 6n
|
|
|
|
|
|
+Plugin policy_plugin sudoers.so
|
|
|
|
|
|
+Plugin io_plugin sudoers.so
|
|
|
|
|
|
+.RE
|
|
|
|
|
|
+.fi
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+For more information on the
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+plugin architecture, see the
|
|
|
|
|
|
+sudo_plugin(@mansectsu@)
|
|
|
|
|
|
+manual.
|
|
|
|
|
|
+.SS "Path settings"
|
|
|
|
|
|
+A
|
|
|
|
|
|
+\fRPath\fR
|
|
|
|
|
|
+line consists of the
|
|
|
|
|
|
+\fRPath\fR
|
|
|
|
|
|
+keyword, followed by the name of the path to set and its value.
|
|
|
|
|
|
+For example:
|
|
|
|
|
|
+.nf
|
|
|
|
|
|
+.sp
|
|
|
|
|
|
+.RS 6n
|
|
|
|
|
|
+Path noexec @noexec_file@
|
|
|
|
|
|
+Path askpass /usr/X11R6/bin/ssh-askpass
|
|
|
|
|
|
+.RE
|
|
|
|
|
|
+.fi
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+The following plugin-agnostic paths may be set in the
|
|
|
|
|
|
+\fI@sysconfdir@/sudo.conf\fR
|
|
|
|
|
|
+file:
|
|
|
|
|
|
+.TP 10n
|
|
|
|
|
|
+askpass
|
|
|
|
|
|
+The fully qualified path to a helper program used to read the user's
|
|
|
|
|
|
+password when no terminal is available.
|
|
|
|
|
|
+This may be the case when
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+is executed from a graphical (as opposed to text-based) application.
|
|
|
|
|
|
+The program specified by
|
|
|
|
|
|
+\fIaskpass\fR
|
|
|
|
|
|
+should display the argument passed to it as the prompt and write
|
|
|
|
|
|
+the user's password to the standard output.
|
|
|
|
|
|
+The value of
|
|
|
|
|
|
+\fIaskpass\fR
|
|
|
|
|
|
+may be overridden by the
|
|
|
|
|
|
+\fRSUDO_ASKPASS\fR
|
|
|
|
|
|
+environment variable.
|
|
|
|
|
|
+.TP 10n
|
|
|
|
|
|
+noexec
|
|
|
|
|
|
+The fully-qualified path to a shared library containing dummy
|
|
|
|
|
|
+versions of the
|
|
|
|
|
|
+\fBexecv\fR(),
|
|
|
|
|
|
+\fBexecve\fR()
|
|
|
|
|
|
+and
|
|
|
|
|
|
+\fBfexecve\fR()
|
|
|
|
|
|
+library functions that just return an error.
|
|
|
|
|
|
+This is used to implement the
|
|
|
|
|
|
+\fInoexec\fR
|
|
|
|
|
|
+functionality on systems that support
|
|
|
|
|
|
+\fRLD_PRELOAD\fR
|
|
|
|
|
|
+or its equivalent.
|
|
|
|
|
|
+The default value is:
|
|
|
|
|
|
+\fI@noexec_file@\fR.
|
|
|
|
|
|
+.SS "Other settings"
|
|
|
|
|
|
+The
|
|
|
|
|
|
+\fBsudo.conf\fR
|
|
|
|
|
|
+file also supports the following front end settings:
|
|
|
|
|
|
+.TP 10n
|
|
|
|
|
|
+disable_coredump
|
|
|
|
|
|
+Core dumps of
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+itself are disabled by default.
|
|
|
|
|
|
+To aid in debugging
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+crashes, you may wish to re-enable core dumps by setting
|
|
|
|
|
|
+``disable_coredump''
|
|
|
|
|
|
+to false in
|
|
|
|
|
|
+\fBsudo.conf\fR
|
|
|
|
|
|
+as follows:
|
|
|
|
|
|
+.RS
|
|
|
|
|
|
+.nf
|
|
|
|
|
|
+.sp
|
|
|
|
|
|
+.RS 6n
|
|
|
|
|
|
+Set disable_coredump false
|
|
|
|
|
|
+.RE
|
|
|
|
|
|
+.fi
|
|
|
|
|
|
+.sp
|
|
|
|
|
|
+Note that most operating systems disable core dumps from setuid programs,
|
|
|
|
|
|
+including
|
|
|
|
|
|
+\fBsudo\fR.
|
|
|
|
|
|
+To actually get a
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+core file you will likely need to enable core dumps for setuid processes.
|
|
|
|
|
|
+On BSD and Linux systems this is accomplished via the
|
|
|
|
|
|
+sysctl
|
|
|
|
|
|
+command.
|
|
|
|
|
|
+On Solaris, the
|
|
|
|
|
|
+coreadm
|
|
|
|
|
|
+command is used to configure core dump behavior.
|
|
|
|
|
|
+.sp
|
|
|
|
|
|
+This setting is only available in
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+version 1.8.4 and higher.
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+.RE
|
|
|
|
|
|
+.SS "Debug flags"
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+versions 1.8.4 and higher support a flexible debugging framework
|
|
|
|
|
|
+that can help track down what
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+is doing internally if there is a problem.
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+A
|
|
|
|
|
|
+\fRDebug\fR
|
|
|
|
|
|
+line consists of the
|
|
|
|
|
|
+\fRDebug\fR
|
|
|
|
|
|
+keyword, followed by the name of the program (or plugin) to debug
|
|
|
|
|
|
+(\fBsudo\fR, \fBvisudo\fR, \fBsudoreplay\fR, \fBsudoers\fR),
|
|
|
|
|
|
+the debug file name and a comma-separated list of debug flags.
|
|
|
|
|
|
+The debug flag syntax used by
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+and the
|
|
|
|
|
|
+\fBsudoers\fR
|
|
|
|
|
|
+plugin is
|
|
|
|
|
|
+\fIsubsystem\fR@\fIpriority\fR
|
|
|
|
|
|
+but a plugin is free to use a different format so long as it does
|
|
|
|
|
|
+not include a comma
|
|
|
|
|
|
+(`\&,').
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+For example:
|
|
|
|
|
|
+.nf
|
|
|
|
|
|
+.sp
|
|
|
|
|
|
+.RS 6n
|
|
|
|
|
|
+Debug sudo /var/log/sudo_debug all@warn,plugin@info
|
|
|
|
|
|
+.RE
|
|
|
|
|
|
+.fi
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+would log all debugging statements at the
|
|
|
|
|
|
+\fIwarn\fR
|
|
|
|
|
|
+level and higher in addition to those at the
|
|
|
|
|
|
+\fIinfo\fR
|
|
|
|
|
|
+level for the plugin subsystem.
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+Currently, only one
|
|
|
|
|
|
+\fRDebug\fR
|
|
|
|
|
|
+entry per program is supported.
|
|
|
|
|
|
+The
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+\fRDebug\fR
|
|
|
|
|
|
+entry is shared by the
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+front end,
|
|
|
|
|
|
+\fBsudoedit\fR
|
|
|
|
|
|
+and the plugins.
|
|
|
|
|
|
+A future release may add support for per-plugin
|
|
|
|
|
|
+\fRDebug\fR
|
|
|
|
|
|
+lines and/or support for multiple debugging files for a single
|
|
|
|
|
|
+program.
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+The priorities used by the
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+front end, in order of decreasing severity, are:
|
|
|
|
|
|
+\fIcrit\fR, \fIerr\fR, \fIwarn\fR, \fInotice\fR, \fIdiag\fR, \fIinfo\fR, \fItrace\fR
|
|
|
|
|
|
+and
|
|
|
|
|
|
+\fIdebug\fR.
|
|
|
|
|
|
+Each priority, when specified, also includes all priorities higher
|
|
|
|
|
|
+than it.
|
|
|
|
|
|
+For example, a priority of
|
|
|
|
|
|
+\fInotice\fR
|
|
|
|
|
|
+would include debug messages logged at
|
|
|
|
|
|
+\fInotice\fR
|
|
|
|
|
|
+and higher.
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+The following subsystems are used by the
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+front-end:
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fIall\fR
|
|
|
|
|
|
+matches every subsystem
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fIargs\fR
|
|
|
|
|
|
+command line argument processing
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fIconv\fR
|
|
|
|
|
|
+user conversation
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fIedit\fR
|
|
|
|
|
|
+sudoedit
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fIexec\fR
|
|
|
|
|
|
+command execution
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fImain\fR
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+main function
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fInetif\fR
|
|
|
|
|
|
+network interface handling
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fIpcomm\fR
|
|
|
|
|
|
+communication with the plugin
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fIplugin\fR
|
|
|
|
|
|
+plugin configuration
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fIpty\fR
|
|
|
|
|
|
+pseudo-tty related code
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fIselinux\fR
|
|
|
|
|
|
+SELinux-specific handling
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fIutil\fR
|
|
|
|
|
|
+utility functions
|
|
|
|
|
|
+.TP 12n
|
|
|
|
|
|
+\fIutmp\fR
|
|
|
|
|
|
+utmp handling
|
|
|
|
|
|
+.SH "FILES"
|
|
|
|
|
|
+.TP 26n
|
|
|
|
|
|
+\fI@sysconfdir@/sudo.conf\fR
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+front end configuration
|
|
|
|
|
|
+.SH "EXAMPLES"
|
|
|
|
|
|
+.nf
|
|
|
|
|
|
+.RS 0n
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Default @sysconfdir@/sudo.conf file
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Format:
|
|
|
|
|
|
+# Plugin plugin_name plugin_path plugin_options ...
|
|
|
|
|
|
+# Path askpass /path/to/askpass
|
|
|
|
|
|
+# Path noexec /path/to/sudo_noexec.so
|
|
|
|
|
|
+# Debug sudo /var/log/sudo_debug all@warn
|
|
|
|
|
|
+# Set disable_coredump true
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# The plugin_path is relative to @PLUGINDIR@ unless
|
|
|
|
|
|
+# fully qualified.
|
|
|
|
|
|
+# The plugin_name corresponds to a global symbol in the plugin
|
|
|
|
|
|
+# that contains the plugin interface structure.
|
|
|
|
|
|
+# The plugin_options are optional.
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# The sudoers plugin is used by default if no Plugin lines are
|
|
|
|
|
|
+# present.
|
|
|
|
|
|
+Plugin policy_plugin sudoers.so
|
|
|
|
|
|
+Plugin io_plugin sudoers.so
|
|
|
|
|
|
+
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Sudo askpass:
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# An askpass helper program may be specified to provide a graphical
|
|
|
|
|
|
+# password prompt for "sudo -A" support. Sudo does not ship with
|
|
|
|
|
|
+# its own askpass program but can use the OpenSSH askpass.
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Use the OpenSSH askpass
|
|
|
|
|
|
+#Path askpass /usr/X11R6/bin/ssh-askpass
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Use the Gnome OpenSSH askpass
|
|
|
|
|
|
+#Path askpass /usr/libexec/openssh/gnome-ssh-askpass
|
|
|
|
|
|
+
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Sudo noexec:
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Path to a shared library containing dummy versions of the execv(),
|
|
|
|
|
|
+# execve() and fexecve() library functions that just return an error.
|
|
|
|
|
|
+# This is used to implement the "noexec" functionality on systems that
|
|
|
|
|
|
+# support C<LD_PRELOAD> or its equivalent.
|
|
|
|
|
|
+# The compiled-in value is usually sufficient and should only be
|
|
|
|
|
|
+# changed if you rename or move the sudo_noexec.so file.
|
|
|
|
|
|
+#
|
|
|
|
|
|
+#Path noexec @noexec_file@
|
|
|
|
|
|
+
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Core dumps:
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# By default, sudo disables core dumps while it is executing
|
|
|
|
|
|
+# (they are re-enabled for the command that is run).
|
|
|
|
|
|
+# To aid in debugging sudo problems, you may wish to enable core
|
|
|
|
|
|
+# dumps by setting "disable_coredump" to false.
|
|
|
|
|
|
+#
|
|
|
|
|
|
+#Set disable_coredump false
|
|
|
|
|
|
+.RE
|
|
|
|
|
|
+.fi
|
|
|
|
|
|
+.SH "SEE ALSO"
|
|
|
|
|
|
+sudoers(@mansectform@),
|
|
|
|
|
|
+sudo(@mansectsu@),
|
|
|
|
|
|
+sudo_plugin(@mansectsu@),
|
|
|
|
|
|
+.SH "HISTORY"
|
|
|
|
|
|
+See the HISTORY file in the
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+distribution (http://www.sudo.ws/sudo/history.html) for a brief
|
|
|
|
|
|
+history of sudo.
|
|
|
|
|
|
+.SH "AUTHORS"
|
|
|
|
|
|
+Many people have worked on
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+over the years; this version consists of code written primarily by:
|
|
|
|
|
|
+.sp
|
|
|
|
|
|
+.RS 6n
|
|
|
|
|
|
+Todd C. Miller
|
|
|
|
|
|
+.RE
|
|
|
|
|
|
+.PP
|
|
|
|
|
|
+See the CONTRIBUTORS file in the
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+distribution (http://www.sudo.ws/sudo/contributors.html) for an
|
|
|
|
|
|
+exhaustive list of people who have contributed to
|
|
|
|
|
|
+\fBsudo\fR.
|
|
|
|
|
|
+.SH "BUGS"
|
|
|
|
|
|
+If you feel you have found a bug in
|
|
|
|
|
|
+\fBsudo\fR,
|
|
|
|
|
|
+please submit a bug report at http://www.sudo.ws/sudo/bugs/
|
|
|
|
|
|
+.SH "SUPPORT"
|
|
|
|
|
|
+Limited free support is available via the sudo-users mailing list,
|
|
|
|
|
|
+see http://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
|
|
|
|
|
|
+search the archives.
|
|
|
|
|
|
+.SH "DISCLAIMER"
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+is provided
|
|
|
|
|
|
+``AS IS''
|
|
|
|
|
|
+and any express or implied warranties, including, but not limited
|
|
|
|
|
|
+to, the implied warranties of merchantability and fitness for a
|
|
|
|
|
|
+particular purpose are disclaimed.
|
|
|
|
|
|
+See the LICENSE file distributed with
|
|
|
|
|
|
+\fBsudo\fR
|
|
|
|
|
|
+or http://www.sudo.ws/sudo/license.html for complete details.
|
|
|
|
|
|
diff -up sudo-1.8.6p7/doc/sudo.conf.mdoc.in.sudoconfman sudo-1.8.6p7/doc/sudo.conf.mdoc.in
|
|
|
|
|
|
--- sudo-1.8.6p7/doc/sudo.conf.mdoc.in.sudoconfman 2013-07-30 13:58:15.401285217 +0200
|
|
|
|
|
|
+++ sudo-1.8.6p7/doc/sudo.conf.mdoc.in 2013-07-30 13:58:25.734323547 +0200
|
|
|
|
|
|
@@ -0,0 +1,430 @@
|
|
|
|
|
|
+.\"
|
|
|
|
|
|
+.\" Copyright (c) 2010-2013 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.
|
|
|
|
|
|
+.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
|
|
+.\"
|
|
|
|
|
|
+.Dd February 5, 2013
|
|
|
|
|
|
+.Dt SUDO @mansectform@
|
|
|
|
|
|
+.Os Sudo @PACKAGE_VERSION@
|
|
|
|
|
|
+.Sh NAME
|
|
|
|
|
|
+.Nm sudo.conf
|
|
|
|
|
|
+.Nd configuration for sudo front end
|
|
|
|
|
|
+.Sh DESCRIPTION
|
|
|
|
|
|
+The
|
|
|
|
|
|
+.Nm sudo.conf
|
|
|
|
|
|
+file is used to configure the
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+front end.
|
|
|
|
|
|
+It specifies the security policy and I/O logging plugins, debug flags
|
|
|
|
|
|
+as well as plugin-agnostic path names and settings.
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+The
|
|
|
|
|
|
+.Nm sudo.conf
|
|
|
|
|
|
+file supports the following directives, described in detail below.
|
|
|
|
|
|
+.Bl -tag -width 8n
|
|
|
|
|
|
+.It Plugin
|
|
|
|
|
|
+a security policy or I/O logging plugin
|
|
|
|
|
|
+.It Path
|
|
|
|
|
|
+a plugin-agnostic path
|
|
|
|
|
|
+.It Set
|
|
|
|
|
|
+a front end setting, such as
|
|
|
|
|
|
+.Em disable_coredump
|
|
|
|
|
|
+or
|
|
|
|
|
|
+.Em group_source
|
|
|
|
|
|
+.It Debug
|
|
|
|
|
|
+debug flags to aid in debugging
|
|
|
|
|
|
+.Nm sudo ,
|
|
|
|
|
|
+.Nm sudoreplay ,
|
|
|
|
|
|
+.Nm visudo ,
|
|
|
|
|
|
+and the
|
|
|
|
|
|
+.Nm sudoers
|
|
|
|
|
|
+plugin.
|
|
|
|
|
|
+.El
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+The pound sign
|
|
|
|
|
|
+.Pq Ql #
|
|
|
|
|
|
+is used to indicate a comment.
|
|
|
|
|
|
+Both the comment character and any text after it, up to the end of
|
|
|
|
|
|
+the line, are ignored.
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+Non-comment lines that don't begin with
|
|
|
|
|
|
+.Li Plugin ,
|
|
|
|
|
|
+.Li Path ,
|
|
|
|
|
|
+.Li Debug ,
|
|
|
|
|
|
+or
|
|
|
|
|
|
+.Li Set
|
|
|
|
|
|
+are silently ignored.
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+The
|
|
|
|
|
|
+.Nm sudo.conf
|
|
|
|
|
|
+file is always parsed in the
|
|
|
|
|
|
+.Dq Li C
|
|
|
|
|
|
+locale.
|
|
|
|
|
|
+.Ss Plugin configuration
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+supports a plugin architecture for security policies and input/output
|
|
|
|
|
|
+logging.
|
|
|
|
|
|
+Third parties can develop and distribute their own policy and I/O
|
|
|
|
|
|
+logging plugins to work seamlessly with the
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+front end.
|
|
|
|
|
|
+Plugins are dynamically loaded based on the contents of
|
|
|
|
|
|
+.Nm sudo.conf .
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+A
|
|
|
|
|
|
+.Li Plugin
|
|
|
|
|
|
+line consists of the
|
|
|
|
|
|
+.Li Plugin
|
|
|
|
|
|
+keyword, followed by the
|
|
|
|
|
|
+.Em symbol_name
|
|
|
|
|
|
+and the
|
|
|
|
|
|
+.Em path
|
|
|
|
|
|
+to the shared object containing the plugin.
|
|
|
|
|
|
+The
|
|
|
|
|
|
+.Em symbol_name
|
|
|
|
|
|
+is the name of the
|
|
|
|
|
|
+.Li struct policy_plugin
|
|
|
|
|
|
+or
|
|
|
|
|
|
+.Li struct io_plugin
|
|
|
|
|
|
+in the plugin shared object.
|
|
|
|
|
|
+The
|
|
|
|
|
|
+.Em path
|
|
|
|
|
|
+may be fully qualified or relative.
|
|
|
|
|
|
+If not fully qualified, it is relative to the
|
|
|
|
|
|
+.Pa @PLUGINDIR@
|
|
|
|
|
|
+directory.
|
|
|
|
|
|
+In other words:
|
|
|
|
|
|
+.Bd -literal -offset indent
|
|
|
|
|
|
+Plugin sudoers_policy sudoers.so
|
|
|
|
|
|
+.Ed
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+is equivalent to:
|
|
|
|
|
|
+.Bd -literal -offset indent
|
|
|
|
|
|
+Plugin sudoers_policy @PLUGINDIR@/sudoers.so
|
|
|
|
|
|
+.Ed
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+Any additional parameters after the
|
|
|
|
|
|
+.Em path
|
|
|
|
|
|
+are passed as arguments to the plugin's
|
|
|
|
|
|
+.Em open
|
|
|
|
|
|
+function.
|
|
|
|
|
|
+For example, to override the compile-time default sudoers file mode:
|
|
|
|
|
|
+.Bd -literal -offset indent
|
|
|
|
|
|
+Plugin sudoers_policy sudoers.so sudoers_mode=0440
|
|
|
|
|
|
+.Ed
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+If no
|
|
|
|
|
|
+.Nm sudo.conf
|
|
|
|
|
|
+file is present, or if it contains no
|
|
|
|
|
|
+.Li Plugin
|
|
|
|
|
|
+lines, the
|
|
|
|
|
|
+.Nm sudoers
|
|
|
|
|
|
+plugin will be used as the default security policy and for I/O logging
|
|
|
|
|
|
+(if enabled by the policy).
|
|
|
|
|
|
+This is equivalent to the following:
|
|
|
|
|
|
+.Bd -literal -offset indent
|
|
|
|
|
|
+Plugin policy_plugin sudoers.so
|
|
|
|
|
|
+Plugin io_plugin sudoers.so
|
|
|
|
|
|
+.Ed
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+For more information on the
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+plugin architecture, see the
|
|
|
|
|
|
+.Xr sudo_plugin @mansectsu@
|
|
|
|
|
|
+manual.
|
|
|
|
|
|
+.Ss Path settings
|
|
|
|
|
|
+A
|
|
|
|
|
|
+.Li Path
|
|
|
|
|
|
+line consists of the
|
|
|
|
|
|
+.Li Path
|
|
|
|
|
|
+keyword, followed by the name of the path to set and its value.
|
|
|
|
|
|
+For example:
|
|
|
|
|
|
+.Bd -literal -offset indent
|
|
|
|
|
|
+Path noexec @noexec_file@
|
|
|
|
|
|
+Path askpass /usr/X11R6/bin/ssh-askpass
|
|
|
|
|
|
+.Ed
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+The following plugin-agnostic paths may be set in the
|
|
|
|
|
|
+.Pa @sysconfdir@/sudo.conf
|
|
|
|
|
|
+file:
|
|
|
|
|
|
+.Bl -tag -width 8n
|
|
|
|
|
|
+.It askpass
|
|
|
|
|
|
+The fully qualified path to a helper program used to read the user's
|
|
|
|
|
|
+password when no terminal is available.
|
|
|
|
|
|
+This may be the case when
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+is executed from a graphical (as opposed to text-based) application.
|
|
|
|
|
|
+The program specified by
|
|
|
|
|
|
+.Em askpass
|
|
|
|
|
|
+should display the argument passed to it as the prompt and write
|
|
|
|
|
|
+the user's password to the standard output.
|
|
|
|
|
|
+The value of
|
|
|
|
|
|
+.Em askpass
|
|
|
|
|
|
+may be overridden by the
|
|
|
|
|
|
+.Ev SUDO_ASKPASS
|
|
|
|
|
|
+environment variable.
|
|
|
|
|
|
+.It noexec
|
|
|
|
|
|
+The fully-qualified path to a shared library containing dummy
|
|
|
|
|
|
+versions of the
|
|
|
|
|
|
+.Fn execv ,
|
|
|
|
|
|
+.Fn execve
|
|
|
|
|
|
+and
|
|
|
|
|
|
+.Fn fexecve
|
|
|
|
|
|
+library functions that just return an error.
|
|
|
|
|
|
+This is used to implement the
|
|
|
|
|
|
+.Em noexec
|
|
|
|
|
|
+functionality on systems that support
|
|
|
|
|
|
+.Ev LD_PRELOAD
|
|
|
|
|
|
+or its equivalent.
|
|
|
|
|
|
+The default value is:
|
|
|
|
|
|
+.Pa @noexec_file@ .
|
|
|
|
|
|
+.El
|
|
|
|
|
|
+.Ss Other settings
|
|
|
|
|
|
+The
|
|
|
|
|
|
+.Nm sudo.conf
|
|
|
|
|
|
+file also supports the following front end settings:
|
|
|
|
|
|
+.Bl -tag -width 8n
|
|
|
|
|
|
+.It disable_coredump
|
|
|
|
|
|
+Core dumps of
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+itself are disabled by default.
|
|
|
|
|
|
+To aid in debugging
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+crashes, you may wish to re-enable core dumps by setting
|
|
|
|
|
|
+.Dq disable_coredump
|
|
|
|
|
|
+to false in
|
|
|
|
|
|
+.Nm sudo.conf
|
|
|
|
|
|
+as follows:
|
|
|
|
|
|
+.Bd -literal -offset indent
|
|
|
|
|
|
+Set disable_coredump false
|
|
|
|
|
|
+.Ed
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+Note that most operating systems disable core dumps from setuid programs,
|
|
|
|
|
|
+including
|
|
|
|
|
|
+.Nm sudo .
|
|
|
|
|
|
+To actually get a
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+core file you will likely need to enable core dumps for setuid processes.
|
|
|
|
|
|
+On BSD and Linux systems this is accomplished via the
|
|
|
|
|
|
+.Xr sysctl
|
|
|
|
|
|
+command.
|
|
|
|
|
|
+On Solaris, the
|
|
|
|
|
|
+.Xr coreadm
|
|
|
|
|
|
+command is used to configure core dump behavior.
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+This setting is only available in
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+version 1.8.4 and higher.
|
|
|
|
|
|
+.El
|
|
|
|
|
|
+.Ss Debug flags
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+versions 1.8.4 and higher support a flexible debugging framework
|
|
|
|
|
|
+that can help track down what
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+is doing internally if there is a problem.
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+A
|
|
|
|
|
|
+.Li Debug
|
|
|
|
|
|
+line consists of the
|
|
|
|
|
|
+.Li Debug
|
|
|
|
|
|
+keyword, followed by the name of the program (or plugin) to debug
|
|
|
|
|
|
+.Pq Nm sudo , Nm visudo , Nm sudoreplay , Nm sudoers ,
|
|
|
|
|
|
+the debug file name and a comma-separated list of debug flags.
|
|
|
|
|
|
+The debug flag syntax used by
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+and the
|
|
|
|
|
|
+.Nm sudoers
|
|
|
|
|
|
+plugin is
|
|
|
|
|
|
+.Em subsystem Ns No @ Ns Em priority
|
|
|
|
|
|
+but a plugin is free to use a different format so long as it does
|
|
|
|
|
|
+not include a comma
|
|
|
|
|
|
+.Pq Ql \&, .
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+For example:
|
|
|
|
|
|
+.Bd -literal -offset indent
|
|
|
|
|
|
+Debug sudo /var/log/sudo_debug all@warn,plugin@info
|
|
|
|
|
|
+.Ed
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+would log all debugging statements at the
|
|
|
|
|
|
+.Em warn
|
|
|
|
|
|
+level and higher in addition to those at the
|
|
|
|
|
|
+.Em info
|
|
|
|
|
|
+level for the plugin subsystem.
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+Currently, only one
|
|
|
|
|
|
+.Li Debug
|
|
|
|
|
|
+entry per program is supported.
|
|
|
|
|
|
+The
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+.Li Debug
|
|
|
|
|
|
+entry is shared by the
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+front end,
|
|
|
|
|
|
+.Nm sudoedit
|
|
|
|
|
|
+and the plugins.
|
|
|
|
|
|
+A future release may add support for per-plugin
|
|
|
|
|
|
+.Li Debug
|
|
|
|
|
|
+lines and/or support for multiple debugging files for a single
|
|
|
|
|
|
+program.
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+The priorities used by the
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+front end, in order of decreasing severity, are:
|
|
|
|
|
|
+.Em crit , err , warn , notice , diag , info , trace
|
|
|
|
|
|
+and
|
|
|
|
|
|
+.Em debug .
|
|
|
|
|
|
+Each priority, when specified, also includes all priorities higher
|
|
|
|
|
|
+than it.
|
|
|
|
|
|
+For example, a priority of
|
|
|
|
|
|
+.Em notice
|
|
|
|
|
|
+would include debug messages logged at
|
|
|
|
|
|
+.Em notice
|
|
|
|
|
|
+and higher.
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+The following subsystems are used by the
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+front-end:
|
|
|
|
|
|
+.Bl -tag -width Fl
|
|
|
|
|
|
+.It Em all
|
|
|
|
|
|
+matches every subsystem
|
|
|
|
|
|
+.It Em args
|
|
|
|
|
|
+command line argument processing
|
|
|
|
|
|
+.It Em conv
|
|
|
|
|
|
+user conversation
|
|
|
|
|
|
+.It Em edit
|
|
|
|
|
|
+sudoedit
|
|
|
|
|
|
+.It Em exec
|
|
|
|
|
|
+command execution
|
|
|
|
|
|
+.It Em main
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+main function
|
|
|
|
|
|
+.It Em netif
|
|
|
|
|
|
+network interface handling
|
|
|
|
|
|
+.It Em pcomm
|
|
|
|
|
|
+communication with the plugin
|
|
|
|
|
|
+.It Em plugin
|
|
|
|
|
|
+plugin configuration
|
|
|
|
|
|
+.It Em pty
|
|
|
|
|
|
+pseudo-tty related code
|
|
|
|
|
|
+.It Em selinux
|
|
|
|
|
|
+SELinux-specific handling
|
|
|
|
|
|
+.It Em util
|
|
|
|
|
|
+utility functions
|
|
|
|
|
|
+.It Em utmp
|
|
|
|
|
|
+utmp handling
|
|
|
|
|
|
+.El
|
|
|
|
|
|
+.Sh FILES
|
|
|
|
|
|
+.Bl -tag -width 24n
|
|
|
|
|
|
+.It Pa @sysconfdir@/sudo.conf
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+front end configuration
|
|
|
|
|
|
+.El
|
|
|
|
|
|
+.Sh EXAMPLES
|
|
|
|
|
|
+.Bd -literal
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Default @sysconfdir@/sudo.conf file
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Format:
|
|
|
|
|
|
+# Plugin plugin_name plugin_path plugin_options ...
|
|
|
|
|
|
+# Path askpass /path/to/askpass
|
|
|
|
|
|
+# Path noexec /path/to/sudo_noexec.so
|
|
|
|
|
|
+# Debug sudo /var/log/sudo_debug all@warn
|
|
|
|
|
|
+# Set disable_coredump true
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# The plugin_path is relative to @PLUGINDIR@ unless
|
|
|
|
|
|
+# fully qualified.
|
|
|
|
|
|
+# The plugin_name corresponds to a global symbol in the plugin
|
|
|
|
|
|
+# that contains the plugin interface structure.
|
|
|
|
|
|
+# The plugin_options are optional.
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# The sudoers plugin is used by default if no Plugin lines are
|
|
|
|
|
|
+# present.
|
|
|
|
|
|
+Plugin policy_plugin sudoers.so
|
|
|
|
|
|
+Plugin io_plugin sudoers.so
|
|
|
|
|
|
+
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Sudo askpass:
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# An askpass helper program may be specified to provide a graphical
|
|
|
|
|
|
+# password prompt for "sudo -A" support. Sudo does not ship with
|
|
|
|
|
|
+# its own askpass program but can use the OpenSSH askpass.
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Use the OpenSSH askpass
|
|
|
|
|
|
+#Path askpass /usr/X11R6/bin/ssh-askpass
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Use the Gnome OpenSSH askpass
|
|
|
|
|
|
+#Path askpass /usr/libexec/openssh/gnome-ssh-askpass
|
|
|
|
|
|
+
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Sudo noexec:
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Path to a shared library containing dummy versions of the execv(),
|
|
|
|
|
|
+# execve() and fexecve() library functions that just return an error.
|
|
|
|
|
|
+# This is used to implement the "noexec" functionality on systems that
|
|
|
|
|
|
+# support C<LD_PRELOAD> or its equivalent.
|
|
|
|
|
|
+# The compiled-in value is usually sufficient and should only be
|
|
|
|
|
|
+# changed if you rename or move the sudo_noexec.so file.
|
|
|
|
|
|
+#
|
|
|
|
|
|
+#Path noexec @noexec_file@
|
|
|
|
|
|
+
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# Core dumps:
|
|
|
|
|
|
+#
|
|
|
|
|
|
+# By default, sudo disables core dumps while it is executing
|
|
|
|
|
|
+# (they are re-enabled for the command that is run).
|
|
|
|
|
|
+# To aid in debugging sudo problems, you may wish to enable core
|
|
|
|
|
|
+# dumps by setting "disable_coredump" to false.
|
|
|
|
|
|
+#
|
|
|
|
|
|
+#Set disable_coredump false
|
|
|
|
|
|
+.Ed
|
|
|
|
|
|
+.Sh SEE ALSO
|
|
|
|
|
|
+.Xr sudoers @mansectform@ ,
|
|
|
|
|
|
+.Xr sudo @mansectsu@ ,
|
|
|
|
|
|
+.Xr sudo_plugin @mansectsu@
|
|
|
|
|
|
+.Sh HISTORY
|
|
|
|
|
|
+See the HISTORY file in the
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+distribution (http://www.sudo.ws/sudo/history.html) for a brief
|
|
|
|
|
|
+history of sudo.
|
|
|
|
|
|
+.Sh AUTHORS
|
|
|
|
|
|
+Many people have worked on
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+over the years; this version consists of code written primarily by:
|
|
|
|
|
|
+.Bd -ragged -offset indent
|
|
|
|
|
|
+Todd C. Miller
|
|
|
|
|
|
+.Ed
|
|
|
|
|
|
+.Pp
|
|
|
|
|
|
+See the CONTRIBUTORS file in the
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+distribution (http://www.sudo.ws/sudo/contributors.html) for an
|
|
|
|
|
|
+exhaustive list of people who have contributed to
|
|
|
|
|
|
+.Nm sudo .
|
|
|
|
|
|
+.Sh BUGS
|
|
|
|
|
|
+If you feel you have found a bug in
|
|
|
|
|
|
+.Nm sudo ,
|
|
|
|
|
|
+please submit a bug report at http://www.sudo.ws/sudo/bugs/
|
|
|
|
|
|
+.Sh SUPPORT
|
|
|
|
|
|
+Limited free support is available via the sudo-users mailing list,
|
|
|
|
|
|
+see http://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
|
|
|
|
|
|
+search the archives.
|
|
|
|
|
|
+.Sh DISCLAIMER
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+is provided
|
|
|
|
|
|
+.Dq AS IS
|
|
|
|
|
|
+and any express or implied warranties, including, but not limited
|
|
|
|
|
|
+to, the implied warranties of merchantability and fitness for a
|
|
|
|
|
|
+particular purpose are disclaimed.
|
|
|
|
|
|
+See the LICENSE file distributed with
|
|
|
|
|
|
+.Nm sudo
|
|
|
|
|
|
+or http://www.sudo.ws/sudo/license.html for complete details.
|
|
|
|
|
|
diff -up sudo-1.8.6p7/MANIFEST.sudoconfman sudo-1.8.6p7/MANIFEST
|
|
|
|
|
|
--- sudo-1.8.6p7/MANIFEST.sudoconfman 2013-07-30 13:56:49.585965170 +0200
|
|
|
|
|
|
+++ sudo-1.8.6p7/MANIFEST 2013-07-30 13:58:25.731323515 +0200
|
|
|
|
|
|
@@ -348,6 +348,9 @@ src/tgetpass.c
|
|
|
|
|
|
src/ttyname.c
|
|
|
|
|
|
src/utmp.c
|
|
|
|
|
|
sudo.pp
|
|
|
|
|
|
+sudo/sudo.conf.cat
|
|
|
|
|
|
+sudo/sudo.conf.man.in
|
|
|
|
|
|
+sudo/sudo.conf.mdoc.in
|
|
|
|
|
|
zlib/Makefile.in
|
|
|
|
|
|
zlib/adler32.c
|
|
|
|
|
|
zlib/compress.c
|
