visudo(1m) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

visudo(1m)

VISUDO(1m)                  System Manager's Manual                 VISUDO(1m)



NAME
       visudo - edit the sudoers file

SYNOPSIS
       visudo [-chqsV] [[-f] sudoers]

DESCRIPTION
       visudo edits the sudoers file in a safe fashion, analogous to vipw(1m).
       visudo locks the sudoers file against multiple simultaneous edits,
       performs basic validity checks, and checks for syntax errors before
       installing the edited file.  If the sudoers file is currently being
       edited you will receive a message to try again later.

       visudo parses the sudoers file after editing and will not save the
       changes if there is a syntax error.  Upon finding an error, visudo will
       print a message stating the line number(s) where the error occurred and
       the user will receive the “What now?”  prompt.  At this point the user
       may enter ‘e’ to re-edit the sudoers file, ‘x’ to exit without saving
       the changes, or ‘Q’ to quit and save changes.  The ‘Q’ option should be
       used with extreme caution because if visudo believes there to be a
       syntax error, so will sudo and no one will be able to run sudo again
       until the error is fixed.  If ‘e’ is typed to edit the sudoers file
       after a syntax error has been detected, the cursor will be placed on
       the line where the error occurred (if the editor supports this
       feature).

       There are two sudoers settings that determine which editor visudo will
       run.

       editor    A colon (‘:’) separated list of editors allowed to be used
                 with visudo.  visudo will choose the editor that matches the
                 user's SUDO_EDITOR, VISUAL or EDITOR environment variable if
                 possible, or the first editor in the list that exists and is
                 executable.  Note that sudo does not preserve the
                 SUDO_EDITOR, VISUAL or EDITOR environment variables unless
                 they are present in the env_keep list or the env_reset option
                 is disabled in the sudoers file.  The default editor path is
                 vi which can be set at compile time via the --with-editor
                 configure option.

       env_editor
                 If set, visudo will use the value of the SUDO_EDITOR, VISUAL
                 or EDITOR environment variables before falling back on the
                 default editor list.  Note that visudo is typically run as
                 root so this option may allow a user with visudo privileges
                 to run arbitrary commands as root without logging.  An
                 alternative is to place a colon-separated list of “safe”
                 editors int the editor variable.  visudo will then only use
                 SUDO_EDITOR, VISUAL or EDITOR if they match a value specified
                 in editor.  If the env_reset flag is enabled, the
                 SUDO_EDITOR, VISUAL and/or EDITOR environment variables must
                 be present in the env_keep list for the env_editor flag to
                 function when visudo is invoked via sudo.  The default value
                 is on, which can be set at compile time via the --with-env-
                 editor configure option.

       The options are as follows:

       -c, --check Enable check-only mode.  The existing sudoers file (and any
                   other files it includes) will be checked for syntax errors.
                   If the path to the sudoers file was not specified, visudo
                   will also check the file owner and mode.  A message will be
                   printed to the standard output describing the status of
                   sudoers unless the -q option was specified.  If the check
                   completes successfully, visudo will exit with a value of 0.
                   If an error is encountered, visudo will exit with a value
                   of 1.

       -f sudoers, --file=sudoers
                   Specify an alternate sudoers file location, see below.  As
                   of version 1.8.27, the sudoers path can be specified
                   without using the -f option.

       -h, --help  Display a short help message to the standard output and
                   exit.

       -q, --quiet Enable quiet mode.  In this mode details about syntax
                   errors are not printed.  This option is only useful when
                   combined with the -c option.

       -s, --strict
                   Enable strict checking of the sudoers file.  If an alias is
                   referenced but not actually defined or if there is a cycle
                   in an alias, visudo will consider this a syntax error.
                   Note that it is not possible to differentiate between an
                   alias and a host name or user name that consists solely of
                   uppercase letters, digits, and the underscore (‘_’)
                   character.

       -V, --version
                   Print the visudo and sudoers grammar versions and exit.

       A sudoers file may be specified instead of the default, /etc/sudoers.
       The temporary file used is the specified sudoers file with “.tmp”
       appended to it.  In check-only mode only, ‘-’ may be used to indicate
       that sudoers will be read from the standard input.  Because the policy
       is evaluated in its entirety, it is not sufficient to check an
       individual sudoers include file for syntax errors.

   Debugging and sudoers plugin arguments
       visudo versions 1.8.4 and higher support a flexible debugging framework
       that is configured via Debug lines in the sudo.conf(4) file.

       Starting with sudo 1.8.12, visudo will also parse the arguments to the
       sudoers plugin to override the default sudoers path name, UID, GID and
       file mode.  These arguments, if present, should be listed after the
       path to the plugin (i.e., after sudoers.so).  Multiple arguments may be
       specified, separated by white space.  For example:

             Plugin sudoers_policy sudoers.so sudoers_mode=0400

       The following arguments are supported:

       sudoers_file=pathname
                 The sudoers_file argument can be used to override the default
                 path to the sudoers file.

       sudoers_uid=uid
                 The sudoers_uid argument can be used to override the default
                 owner of the sudoers file.  It should be specified as a
                 numeric user-ID.

       sudoers_gid=gid
                 The sudoers_gid argument can be used to override the default
                 group of the sudoers file.  It must be specified as a numeric
                 group-ID (not a group name).

       sudoers_mode=mode
                 The sudoers_mode argument can be used to override the default
                 file mode for the sudoers file.  It should be specified as an
                 octal value.

       For more information on configuring sudo.conf(4), please refer to its
       manual.

ENVIRONMENT
       The following environment variables may be consulted depending on the
       value of the editor and env_editor sudoers settings:

       SUDO_EDITOR      Invoked by visudo as the editor to use

       VISUAL           Used by visudo if SUDO_EDITOR is not set

       EDITOR           Used by visudo if neither SUDO_EDITOR nor VISUAL is
                        set

FILES
       /etc/sudo.conf            Sudo front end configuration

       /etc/sudoers              List of who can run what

       /etc/sudoers.tmp          Default temporary file used by visudo

DIAGNOSTICS
       In addition to reporting sudoers syntax errors, visudo may produce the
       following messages:

       sudoers file busy, try again later.
             Someone else is currently editing the sudoers file.

       /etc/sudoers: Permission denied
             You didn't run visudo as root.

       you do not exist in the passwd database
             Your user-ID does not appear in the system passwd database.

       Warning: {User,Runas,Host,Cmnd}_Alias referenced but not defined
             Either you are trying to use an undeclared
             {User,Runas,Host,Cmnd}_Alias or you have a user or host name
             listed that consists solely of uppercase letters, digits, and the
             underscore (‘_’) character.  In the latter case, you can ignore
             the warnings (sudo will not complain) .  The message is prefixed
             with the path name of the sudoers file and the line number where
             the undefined alias was used.  In -s (strict) mode these are
             errors, not warnings.

       Warning: unused {User,Runas,Host,Cmnd}_Alias
             The specified {User,Runas,Host,Cmnd}_Alias was defined but never
             used.  The message is prefixed with the path name of the sudoers
             file and the line number where the unused alias was defined.  You
             may wish to comment out or remove the unused alias.

       Warning: cycle in {User,Runas,Host,Cmnd}_Alias
             The specified {User,Runas,Host,Cmnd}_Alias includes a reference
             to itself, either directly or through an alias it includes.  The
             message is prefixed with the path name of the sudoers file and
             the line number where the cycle was detected.  This is only a
             warning unless visudo is run in -s (strict) mode as sudo will
             ignore cycles when parsing the sudoers file.

       unknown defaults entry "name"
             The sudoers file contains a Defaults setting not recognized by
             visudo.

SEE ALSO
       vi(1), sudo.conf(4), sudoers(4), sudo(1m), vipw(1m)

AUTHORS
       Many people have worked on sudo over the years; this version consists
       of code written primarily by:

             Todd C. Miller

       See the CONTRIBUTORS file in the sudo distribution
       (https://www.sudo.ws/contributors.html) for an exhaustive list of
       people who have contributed to sudo.

CAVEATS
       There is no easy way to prevent a user from gaining a root shell if the
       editor used by visudo allows shell escapes.

BUGS
       If you feel you have found a bug in visudo, please submit a bug report
       at https://bugzilla.sudo.ws/

SUPPORT
       Limited free support is available via the sudo-users mailing list, see
       https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or search
       the archives.

DISCLAIMER
       visudo 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 sudo or
       https://www.sudo.ws/license.html for complete details.



Sudo 1.9.5p2                    August 27, 2020                     VISUDO(1m)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3