git.gag.com Git - debian/sudo/blob - visudo.cat

   1
   2
   3
   4 VISUDO(1m)             MAINTENANCE COMMANDS            VISUDO(1m)
   5
   6
   7 N\bNA\bAM\bME\bE
   8        visudo - edit the sudoers file
   9
  10 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
  11        v\bvi\bis\bsu\bud\bdo\bo [-\b-c\bc] [-\b-q\bq] [-\b-s\bs] [-\b-V\bV] [-\b-f\bf _\bs_\bu_\bd_\bo_\be_\br_\bs]
  12
  13 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  14        v\bvi\bis\bsu\bud\bdo\bo edits the _\bs_\bu_\bd_\bo_\be_\br_\bs file in a safe fashion, analogous
  15        to _\bv_\bi_\bp_\bw(1m).  v\bvi\bis\bsu\bud\bdo\bo locks the _\bs_\bu_\bd_\bo_\be_\br_\bs file against multi
  16        ple simultaneous edits, provides basic sanity checks, and
  17        checks for parse errors.  If the _\bs_\bu_\bd_\bo_\be_\br_\bs file is currently
  18        being edited you will receive a message to try again
  19        later.
  20
  21        There is a hard-coded list of editors that v\bvi\bis\bsu\bud\bdo\bo will use
  22        set at compile-time that may be overridden via the _\be_\bd_\bi_\bt_\bo_\br
  23        _\bs_\bu_\bd_\bo_\be_\br_\bs Default variable.  This list defaults to the path
  24        to _\bv_\bi(1) on your system, as determined by the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be
  25        script.  Normally, v\bvi\bis\bsu\bud\bdo\bo does not honor the VISUAL or
  26        EDITOR environment variables unless they contain an editor
  27        in the aforementioned editors list.  However, if v\bvi\bis\bsu\bud\bdo\bo is
  28        configured with the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\be_\bn_\bv_\be_\bd_\bi_\bt_\bo_\br flag or the _\be_\bn_\bv_\b__\be_\bd_\bi_\b
  29        _\bt_\bo_\br Default variable is set in _\bs_\bu_\bd_\bo_\be_\br_\bs, v\bvi\bis\bsu\bud\bdo\bo will use
  30        any the editor defines by VISUAL or EDITOR.  Note that
  31        this can be a security hole since it allows the user to
  32        execute any program they wish simply by setting VISUAL or
  33        EDITOR.
  34
  35        v\bvi\bis\bsu\bud\bdo\bo parses the _\bs_\bu_\bd_\bo_\be_\br_\bs file after the edit and will not
  36        save the changes if there is a syntax error.  Upon finding
  37        an error, v\bvi\bis\bsu\bud\bdo\bo will print a message stating the line
  38        number(s) where the error occurred and the user will
  39        receive the "What now?" prompt.  At this point the user
  40        may enter "e" to re-edit the _\bs_\bu_\bd_\bo_\be_\br_\bs file, "x" to exit
  41        without saving the changes, or "Q" to quit and save
  42        changes.  The "Q" option should be used with extreme care
  43        because if v\bvi\bis\bsu\bud\bdo\bo believes there to be a parse error, so
  44        will s\bsu\bud\bdo\bo and no one will be able to s\bsu\bud\bdo\bo again until the
  45        error is fixed.  If "e" is typed to edit the  _\bs_\bu_\bd_\bo_\be_\br_\bs file
  46        after a parse error has been detected, the cursor will be
  47        placed on the line where the error occurred (if the editor
  48        supports this feature).
  49
  50 O\bOP\bPT\bTI\bIO\bON\bNS\bS
  51        v\bvi\bis\bsu\bud\bdo\bo accepts the following command line options:
  52
  53        -c  Enable c\bch\bhe\bec\bck\bk-\b-o\bon\bnl\bly\by mode.  The existing _\bs_\bu_\bd_\bo_\be_\br_\bs file
  54            will be checked for syntax and a message will be
  55            printed to the standard output detailing the status of
  56            _\bs_\bu_\bd_\bo_\be_\br_\bs.  If the syntax check completes successfully,
  57            v\bvi\bis\bsu\bud\bdo\bo will exit with a value of 0.  If a syntax error
  58            is encountered, v\bvi\bis\bsu\bud\bdo\bo will exit with a value of 1.
  59
  60        -f  Specify and alternate _\bs_\bu_\bd_\bo_\be_\br_\bs file location.  With
  61
  62
  63
  64 1.6.9p14                February 19, 2008                       1
  65
  66
  67
  68
  69
  70 VISUDO(1m)             MAINTENANCE COMMANDS            VISUDO(1m)
  71
  72
  73            this option v\bvi\bis\bsu\bud\bdo\bo will edit (or check) the _\bs_\bu_\bd_\bo_\be_\br_\bs
  74            file of your choice, instead of the default,
  75            _\b/_\be_\bt_\bc_\b/_\bs_\bu_\bd_\bo_\be_\br_\bs.  The lock file used is the specified
  76            _\bs_\bu_\bd_\bo_\be_\br_\bs file with ".tmp" appended to it.
  77
  78        -q  Enable q\bqu\bui\bie\bet\bt mode.  In this mode details about syntax
  79            errors are not printed.  This option is only useful
  80            when combined with the -\b-c\bc flag.
  81
  82        -s  Enable s\bst\btr\bri\bic\bct\bt checking of the _\bs_\bu_\bd_\bo_\be_\br_\bs file.  If an
  83            alias is used before it is defined, v\bvi\bis\bsu\bud\bdo\bo will con
  84            sider this a parse error.  Note that it is not possi
  85            ble to differentiate between an alias and a hostname
  86            or username that consists solely of uppercase letters,
  87            digits, and the underscore ('_') character.
  88
  89        -V  The -\b-V\bV (version) option causes v\bvi\bis\bsu\bud\bdo\bo to print its
  90            version number and exit.
  91
  92 E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
  93        The following environment variables are used only if
  94        v\bvi\bis\bsu\bud\bdo\bo was configured with the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\be_\bn_\bv_\b-_\be_\bd_\bi_\bt_\bo_\br option:
  95
  96        VISUAL          Invoked by visudo as the editor to use
  97
  98        EDITOR          Used by visudo if VISUAL is not set
  99
 100 F\bFI\bIL\bLE\bES\bS
 101        _\b/_\be_\bt_\bc_\b/_\bs_\bu_\bd_\bo_\be_\br_\bs            List of who can run what
 102
 103        _\b/_\be_\bt_\bc_\b/_\bs_\bu_\bd_\bo_\be_\br_\bs_\b._\bt_\bm_\bp        Lock file for visudo
 104
 105 D\bDI\bIA\bAG\bGN\bNO\bOS\bST\bTI\bIC\bCS\bS
 106        sudoers file busy, try again later.
 107            Someone else is currently editing the _\bs_\bu_\bd_\bo_\be_\br_\bs file.
 108
 109        /etc/sudoers.tmp: Permission denied
 110            You didn't run v\bvi\bis\bsu\bud\bdo\bo as root.
 111
 112        Can't find you in the passwd database
 113            Your userid does not appear in the system passwd file.
 114
 115        Warning: undeclared Alias referenced near ...
 116            Either you are using a {User,Runas,Host,Cmnd}_Alias
 117            before defining it or you have a user or hostname
 118            listed that consists solely of uppercase letters, dig
 119            its, and the underscore ('_') character.  If the lat
 120            ter, you can ignore the warnings (s\bsu\bud\bdo\bo will not com
 121            plain).  In -\b-s\bs (strict) mode these are errors, not
 122            warnings.
 123
 124        Warning: runas_default set after old value is in use ...
 125            You have a _\br_\bu_\bn_\ba_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt Defaults setting listed in
 126            the _\bs_\bu_\bd_\bo_\be_\br_\bs file after its value has already been
 127
 128
 129
 130 1.6.9p14                February 19, 2008                       2
 131
 132
 133
 134
 135
 136 VISUDO(1m)             MAINTENANCE COMMANDS            VISUDO(1m)
 137
 138
 139            used.  This means that entries prior to the
 140            _\br_\bu_\bn_\ba_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt setting will match based on the default
 141            value of _\br_\bu_\bn_\ba_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (root) whereas entries a\baf\bft\bte\ber\br
 142            the _\br_\bu_\bn_\ba_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt setting will match based on the new
 143            value.  This is usually unintentional and in most
 144            cases the <runas_default> setting should be placed
 145            before any Runas_Alias or User specifications.  In -\b-s\bs
 146            (strict) mode this is an error, not a warning.
 147
 148 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
 149        _\bv_\bi(1), _\bs_\bu_\bd_\bo_\be_\br_\bs(4), _\bs_\bu_\bd_\bo(1m), _\bv_\bi_\bp_\bw(8)
 150
 151 A\bAU\bUT\bTH\bHO\bOR\bR
 152        Many people have worked on _\bs_\bu_\bd_\bo over the years; this ver
 153        sion of v\bvi\bis\bsu\bud\bdo\bo was written by:
 154
 155         Todd Miller
 156
 157        See the HISTORY file in the sudo distribution or visit
 158        http://www.sudo.ws/sudo/history.html for more details.
 159
 160 C\bCA\bAV\bVE\bEA\bAT\bTS\bS
 161        There is no easy way to prevent a user from gaining a root
 162        shell if the editor used by v\bvi\bis\bsu\bud\bdo\bo allows shell escapes.
 163
 164 B\bBU\bUG\bGS\bS
 165        If you feel you have found a bug in v\bvi\bis\bsu\bud\bdo\bo, please submit
 166        a bug report at http://www.sudo.ws/sudo/bugs/
 167
 168 S\bSU\bUP\bPP\bPO\bOR\bRT\bT
 169        Limited free support is available via the sudo-users mail
 170        ing list, see http://www.sudo.ws/mail
 171        man/listinfo/sudo-users to subscribe or search the
 172        archives.
 173
 174 D\bDI\bIS\bSC\bCL\bLA\bAI\bIM\bME\bER\bR
 175        v\bvi\bis\bsu\bud\bdo\bo is provided ``AS IS'' and any express or implied
 176        warranties, including, but not limited to, the implied
 177        warranties of merchantability and fitness for a particular
 178        purpose are disclaimed.  See the LICENSE file distributed
 179        with s\bsu\bud\bdo\bo or http://www.sudo.ws/sudo/license.html for com
 180        plete details.
 181
 182
 183
 184
 185
 186
 187
 188
 189
 190
 191
 192
 193
 194
 195
 196 1.6.9p14                February 19, 2008                       3
 197
 198