manual/sudo/release/man8/visudo.8

   1 .\" Copyright (c) 1996,1998-2005, 2007-2008
   2 .\"     Todd C. Miller <Todd.Miller@courtesan.com>
   3 .\"
   4 .\" Permission to use, copy, modify, and distribute this software for any
   5 .\" purpose with or without fee is hereby granted, provided that the above
   6 .\" copyright notice and this permission notice appear in all copies.
   7 .\"
   8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
   9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  15 .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  16 .\"
  17 .\" Sponsored in part by the Defense Advanced Research Projects
  18 .\" Agency (DARPA) and Air Force Research Laboratory, Air Force
  19 .\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
  20 .\"
  21 .\" Japanese Version Copyright (c) 2000-2002 Yuichi SATO
  22 .\"   and 2009 Yoichi Chonan
  23 .\"         all rights reserved.
  24 .\" Translated Sat Oct  7 14:39:18 JST 2000
  25 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  26 .\" Updated & Modified Fri Dec  6 04:40:44 JST 2002 by Yuichi SATO
  27 .\" New Translation (sudo-1.6.9p17) Fri Jan 23 10:31:17 JST 2009
  28 .\"         by Yoichi Chonan <cyoichi@maple.ocn.ne.jp>
  29 .\" Updated & Modified (sudo-1.7.2p1) Sat Nov 14 21:15:16 JST 2009
  30 .\"         by Yoichi Chonan
  31 .\"
  32 .\" $Sudo: visudo.man.in,v 1.34 2009/06/11 20:29:12 millert Exp $
  33 .\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
  34 .\"
  35 .\" Standard preamble:
  36 .\" ========================================================================
  37 .de Sh \" Subsection heading
  38 .br
  39 .if t .Sp
  40 .ne 5
  41 .PP
  42 \fB\\$1\fR
  43 .PP
  44 ..
  45 .de Sp \" Vertical space (when we can't use .PP)
  46 .if t .sp .5v
  47 .if n .sp
  48 ..
  49 .de Vb \" Begin verbatim text
  50 .ft CW
  51 .nf
  52 .ne \\$1
  53 ..
  54 .de Ve \" End verbatim text
  55 .ft R
  56 .fi
  57 ..
  58 .\" Set up some character translations and predefined strings.  \*(-- will
  59 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  60 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
  61 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
  62 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
  63 .\" nothing in troff, for use with C<>.
  64 .tr \(*W-
  65 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  66 .ie n \{\
  67 .    ds -- \(*W-
  68 .    ds PI pi
  69 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  70 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  71 .    ds L" ""
  72 .    ds R" ""
  73 .    ds C`
  74 .    ds C'
  75 'br\}
  76 .el\{\
  77 .    ds -- \|\(em\|
  78 .    ds PI \(*p
  79 .    ds L" ``
  80 .    ds R" ''
  81 'br\}
  82 .\"
  83 .\" Escape single quotes in literal strings from groff's Unicode transform.
  84 .ie \n(.g .ds Aq \(aq
  85 .el       .ds Aq '
  86 .\"
  87 .\" If the F register is turned on, we'll generate index entries on stderr for
  88 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
  89 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  90 .\" output yourself in some meaningful fashion.
  91 .ie \nF \{\
  92 .    de IX
  93 .    tm Index:\\$1\t\\n%\t"\\$2"
  94 ..
  95 .    nr % 0
  96 .    rr F
  97 .\}
  98 .el \{\
  99 .    de IX
 100 ..
 101 .\}
 102 .\"
 103 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
 104 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
 105 .    \" fudge factors for nroff and troff
 106 .if n \{\
 107 .    ds #H 0
 108 .    ds #V .8m
 109 .    ds #F .3m
 110 .    ds #[ \f1
 111 .    ds #] \fP
 112 .\}
 113 .if t \{\
 114 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
 115 .    ds #V .6m
 116 .    ds #F 0
 117 .    ds #[ \&
 118 .    ds #] \&
 119 .\}
 120 .    \" simple accents for nroff and troff
 121 .if n \{\
 122 .    ds ' \&
 123 .    ds ` \&
 124 .    ds ^ \&
 125 .    ds , \&
 126 .    ds ~ ~
 127 .    ds /
 128 .\}
 129 .if t \{\
 130 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 131 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 132 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 133 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 134 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 135 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 136 .\}
 137 .    \" troff and (daisy-wheel) nroff accents
 138 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 139 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 140 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 141 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 142 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 143 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 144 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 145 .ds ae a\h'-(\w'a'u*4/10)'e
 146 .ds Ae A\h'-(\w'A'u*4/10)'E
 147 .    \" corrections for vroff
 148 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 149 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 150 .    \" for low resolution devices (crt and lpr)
 151 .if \n(.H>23 .if \n(.V>19 \
 152 \{\
 153 .    ds : e
 154 .    ds 8 ss
 155 .    ds o a
 156 .    ds d- d\h'-1'\(ga
 157 .    ds D- D\h'-1'\(hy
 158 .    ds th \o'bp'
 159 .    ds Th \o'LP'
 160 .    ds ae ae
 161 .    ds Ae AE
 162 .\}
 163 .rm #[ #] #H #V #F C
 164 .\" ========================================================================
 165 .\"
 166 .IX Title "VISUDO 8"
 167 .TH VISUDO 8 "June 11, 2009" "1.7.2p1" "MAINTENANCE COMMANDS"
 168 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 169 .\" way too many mistakes in technical documents.
 170 .if n .ad l
 171 .nh
 172 .SH "名前"
 173 \"O visudo \- edit the sudoers file
 174 visudo \- sudoers ファイルを編集する
 175 .SH "書式"
 176 .IX Header "SYNOPSIS"
 177 \&\fBvisudo\fR [\fB\-c\fR] [\fB\-q\fR] [\fB\-s\fR] [\fB\-V\fR] [\fB\-f\fR \fIsudoers\fR]
 178 .SH "説明"
 179 .IX Header "DESCRIPTION"
 180 \&\fBvisudo\fR は \fIvipw\fR\|(8) によく似た安全なやり方で
 181 \&\fIsudoers\fR ファイルを編集する。 \fBvisudo\fR は \fIsudoers\fR
 182 ファイルをロックして、重複した編集が同時に行われないようにするとともに、
 183 整合性をざっと調べ、文法エラーのチェックを行う。 \fIsudoers\fR ファイル
 184 が現在編集中だった場合は、「try again later」というメッセージを端末に
 185 表示する。
 186 .PP
 187 \&\fBvisudo\fR が使用するエディタについては、コンパイル時に設定された
 188 エディタのリストがプログラムに埋め込まれているが、\fIsudoers\fR ファイルの
 189 \&\f(CW\*(C`Defaults\*(C'\fR 行で \fIeditor\fR オプションを使えば、
 190 それを変更することができる。このリストはデフォルトでは、
 191 使用しているシステムにおける \fIvi\fR\|(1) のパスであり、
 192 \&\fIconfigure\fR スクリプトによって割り出されたものだ。
 193 通常 \fBvisudo\fR は、環境変数 \f(CW\*(C`VISUAL\*(C'\fR や
 194 \&\f(CW\*(C`EDITOR\*(C'\fR の値が上述のエディタ・リストに含まれる
 195 エディタでないかぎり、そうした環境変数を使用しない。とは言え、\fBvisudo\fR が
 196 \&\fI\-\-with\-env\-editor\fR オプションを付けて configure されている場合や、
 197 \&\fIsudoeres\fR ファイルの \f(CW\*(C`Defaults\*(C'\fR 行で
 198 \&\fIenv_editor\fR オプションがセットされている場合は、\fBvisudo\fR は
 199 \&\f(CW\*(C`VISUAL\*(C'\fR や \f(CW\*(C`EDITOR\*(C'\fR によって指定された
 200 どんなエディタでも使用することになる。これがセキュリティホールに
 201 なりかねないことに注意してほしい。単に \f(CW\*(C`VISUAL\*(C'\fR や
 202 \&\f(CW\*(C`EDITOR\*(C'\fR を設定するだけで、ユーザが任意のプログラムを
 203 実行できるようになってしまうからだ。
 204 .PP
 205 \&\fBvisudo\fR は編集が終わると、\fIsudoers\fR ファイルの文法解析を行い、
 206 文法エラーがあれば、変更を保存しない。\fBvisudo\fR はエラーを発見すると、
 207 エラーが起きた行番号を知らせるメッセージを表示し、\*(L"What now?\*(R" と
 208 いうプロンプトを出す。このとき、\*(L"e\*(R" を押せば、
 209 \&\fIsudoers\fR ファイルを再編集できる。\*(L"x\*(R" を押せば、
 210 変更を保存せず終了だし、\*(L"Q\*(R" を押せば、変更を保存して終了だ。
 211 \&\*(L"Q\*(R" の選択は、くれぐれも慎重にやってほしい。なぜなら、
 212 \&\fBvisudo\fR が文法エラーがあると考えるのなら、\fBsudo\fR も
 213 同様に考えるはずであり、エラーが訂正されるまで、もう誰にも \fBsudo\fR が
 214 使えなくなってしまうからだ。文法エラーが発見されたとき、\*(L"e\*(R" を
 215 押して \fIsudoers\fR ファイルを編集しようとすると、カーソルがファイルの
 216 エラーが起きた行に飛ぶ (エディタにその機能があればだが)。
 217 .SH "オプション"
 218 .IX Header "OPTIONS"
 219 \&\fBvisudo\fR では以下のコマンドラインオプションが使用できる。
 220 .IP "\-c" 12
 221 .IX Item "-c"
 222 \&\fBcheck-only\fR モードを有効にする。現在の \fIsudoers\fR ファイルの
 223 文法をチェックし、メッセージを標準出力に表示して、
 224 \fIsudoers\fR の状態を詳細に報告する。文法チェックが成功裡に終わった場合、
 225 \&\fBvisudo\fR は返り値 0 で終了する。文法エラーに出会った場合の
 226 返り値は 1 である。
 227 .IP "\-f \fIsudoers\fR" 12
 228 .IX Item "-f sudoers"
 229 \&\fIsudoers\fR ファイルの位置を指定・変更する。このオプションを
 230 付けると、 \fBvisudo\fR はデフォルトの \fI/etc/sudoers\fR ではなく、
 231 ユーザが選んだ \fIsudoers\fR ファイルを編集 (あるいは、チェック) する
 232 ことになる。ロックファイルとしては、指定された \fIsudoers\fR ファイルの
 233 名前の末尾に \*(L".tmp\*(R" を付けたものが使われる。
 234 .IP "\-q" 12
 235 .IX Item "-q"
 236 \&\fBquiet\fR モードを有効にする。このモードでは、文法エラーの詳細情報は
 237 表示されない。このオプションに意味があるのは、\fB\-c\fR オプションと
 238 組み合わせたときだけである。
 239 .IP "\-s" 12
 240 .IX Item "-s"
 241 \&\fIsudoers\fR ファイルの\fB厳密\fR (\fBstrict\fR) チェックを有効にする。
 242 エイリアスを定義する前に使用すると、\fBvisudo\fR がそれを文法エラーと
 243 見なすようになるわけだ。ホスト名やユーザ名がアルファベットの大文字、
 244 数字、アンダースコア ('_') だけから構成されている場合、そうしたものと
 245 エイリアスとの区別は付かないことに注意してほしい。
 246 .IP "\-V" 12
 247 .IX Item "-V"
 248 オプションに \fB\-V\fR (version) を付けると、\fBvisudo\fR は
 249 バージョンナンバーを表示して、終了する。
 250 .SH "環境変数"
 251 .IX Header "ENVIRONMENT"
 252 以下の環境変数が参照されるかどうかは、\fIsudoers\fR の \fIeditor\fR や
 253 \&\fIenv_editor\fR オプションの値次第である。
 254 .ie n .IP "\*(C`VISUAL\*(C'" 16
 255 .el .IP "\f(CW\*(C`VISUAL\*(C'\fR" 16
 256 .IX Item "VISUAL"
 257 visudo が起動するエディタ
 258 .ie n .IP "\*(C`EDITOR\*(C'" 16
 259 .el .IP "\f(CW\*(C`EDITOR\*(C'\fR" 16
 260 .IX Item "EDITOR"
 261 \&\s-1VISUAL\s0 が設定されていないとき visudo が使用するエディタ
 262 .SH "ファイル"
 263 .IX Header "FILES"
 264 .ie n .IP "\fI/etc/sudoers\fR" 24
 265 .el .IP "\fI/etc/sudoers\fR" 24
 266 .IX Item "/etc/sudoers"
 267 誰が何を実行できるかのリスト
 268 .ie n .IP "\fI/etc/sudoers.tmp\fR" 24
 269 .el .IP "\fI/etc/sudoers.tmp\fR" 24
 270 .IX Item "/etc/sudoers.tmp"
 271 visudo が使うロックファイル
 272 .SH "メッセージによる診断"
 273 .IX Header "DIAGNOSTICS"
 274 .IP "sudoers file busy, try again later." 4
 275 .IX Item "sudoers file busy, try again later."
 276 現在、ほかの誰かが \fIsudoers\fR ファイルを編集中だ。
 277 .ie n .IP "/etc/sudoers.tmp: Permission denied" 4
 278 .el .IP "\f(CW@sysconfdir\fR@/sudoers.tmp: Permission denied" 4
 279 \&\fBvisudo\fR を root として実行しなかった。
 280 .IP "Can't find you in the passwd database" 4
 281 .IX Item "Can't find you in the passwd database"
 282 あなたのユーザ ID はシステムの passwd ファイルに載っていない。
 283 .IP "Warning: {User,Runas,Host,Cmnd}_Alias referenced but not defined" 4
 284 .IX Item "Warning: {User,Runas,Host,Cmnd}_Alias referenced but not defined"
 285 User_Alias, Runas_Alias, Host_Alias, Cmnd_Alias のどれかを、
 286 定義しないまま使用しようとしている。
 287 あるいは、記載したユーザ名かホスト名の中に、アルファベットの大文字、
 288 数字、アンダースコア ('_') のみからなるものがある。後者の場合は、
 289 この warning を無視して構わない (\fBsudo\fR は警告を出さないないだろう)。
 290 \&\fB\-s\fR (strict) モードでは、warning ではなく、error になる。
 291 .IP "Warning: unused {User,Runas,Host,Cmnd}_Alias" 4
 292 .IX Item "Warning: unused {User,Runas,Host,Cmnd}_Alias"
 293 指摘された User_Alias (あるいは、Runas_Alias, Host_Alias, Cmnd_Alias) は
 294 定義されているが、一度も使用されていない。そうした使用しないエイリアスは、
 295 コメントアウトするなり、消去するなりしてもよいだろう。
 296 \&\fB\-s\fR (strict) モードでは、warning ではなく、error になる。
 297 .SH "関連項目"
 298 .IX Header "SEE ALSO"
 299 \&\fIvi\fR\|(1), \fIsudoers\fR\|(5), \fIsudo\fR\|(8), \fIvipw\fR\|(8)
 300 .SH "作者"
 301 .IX Header "AUTHOR"
 302 \&\fIsudo\fR の製作には、多数の人々が長年に渡って取り組んできた。
 303 \fBvisudo\fR の当バージョンを書いたのは、
 304 .PP
 305 .Vb 1
 306 \& Todd Miller
 307 .Ve
 308 .PP
 309 である。詳細については、配布物中の \s-1HISTORY\s0 ファイルか、
 310 http://www.sudo.ws/sudo/history.html を御覧になっていただきたい。
 311 .SH "警告"
 312 .IX Header "CAVEATS"
 313 \&\fBvisudo\fR が使用するエディタでシェル・エスケープが可能なかぎり、
 314 ユーザがルート・シェルを獲得するのを防止する簡単な方法はない。
 315 .SH "バグ"
 316 .IX Header "BUGS"
 317 \&\fBvisudo\fR にバクを発見したと思ったら、下記のページにアクセスして、
 318 バグレポートを提出していただきたい。
 319 .br
 320 http://www.sudo.ws/sudo/bugs/
 321 .SH "サポート"
 322 .IX Header "SUPPORT"
 323 ある程度の無料サポートが sudo-users メーリングリストを通して利用できる。
 324 購読やアーカイブの検索には下記 URL を御覧になること。
 325 .br
 326 http://www.sudo.ws/mailman/listinfo/sudo\-users
 327 .SH "免責"
 328 .IX Header "DISCLAIMER"
 329 \&\fBvisudo\fR は「現状のまま」提供される。明示的な、あるいは黙示的な
 330 いかなる保証も、商品性や特定目的への適合性についての黙示的な保証を含め、
 331 またそれのみに止まらず、これを否認する。詳細な全文については、
 332 \&\fBsudo\fR と一緒に配布されている \s-1LICENSE\s0 ファイルや
 333 下記 Web ページを御覧いただきたい。
 334 .br
 335 http://www.sudo.ws/sudo/license.html