OSDN Git Service

sudo: release pages for sudo-1.8.4p4
[linuxjm/jm.git] / manual / sudo / release / man8 / visudo.8
index 61b0aa2..efc7938 100644 (file)
@@ -1,4 +1,4 @@
-.\" Copyright (c) 1996,1998-2005, 2007-2008
+.\" Copyright (c) 1996,1998-2005, 2007-2012
 .\"    Todd C. Miller <Todd.Miller@courtesan.com>
 .\" 
 .\" Permission to use, copy, modify, and distribute this software for any
 .\"         by Yoichi Chonan <cyoichi@maple.ocn.ne.jp>
 .\" Updated & Modified (sudo-1.7.2p1) Sat Nov 14 21:15:16 JST 2009
 .\"         by Yoichi Chonan
+.\" Updated & Modified (sudo-1.8.4p4) Wed May  9 12:26:33 JST 2012
+.\"         by Yoichi Chonan
 .\"
-.\" $Sudo: visudo.man.in,v 1.34 2009/06/11 20:29:12 millert Exp $
-.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
+.\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
 .de Sp \" Vertical space (when we can't use .PP)
 .if t .sp .5v
 .if n .sp
@@ -85,7 +78,7 @@
 .el       .ds Aq '
 .\"
 .\" If the F register is turned on, we'll generate index entries on stderr for
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
 .\" entries marked with X<> in POD.  Of course, you'll have to process the
 .\" output yourself in some meaningful fashion.
 .ie \nF \{\
 .\" ========================================================================
 .\"
 .IX Title "VISUDO 8"
-.TH VISUDO 8 "June 11, 2009" "1.7.2p1" "MAINTENANCE COMMANDS"
+.TH VISUDO 8 "March 12, 2012" "1.8.4" "MAINTENANCE COMMANDS"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
 visudo \- sudoers ファイルを編集する
 .SH "書式"
 .IX Header "SYNOPSIS"
-\&\fBvisudo\fR [\fB\-c\fR] [\fB\-q\fR] [\fB\-s\fR] [\fB\-V\fR] [\fB\-f\fR \fIsudoers\fR]
+\&\fBvisudo\fR [\fB\-chqsV\fR] [\fB\-f\fR \fIsudoers\fR]
 .SH "説明"
 .IX Header "DESCRIPTION"
 \&\fBvisudo\fR は \fIvipw\fR\|(8) によく似た安全なやり方で 
 \&\fIsudoers\fR ファイルを編集する。 \fBvisudo\fR は \fIsudoers\fR 
 ファイルをロックして、重複した編集が同時に行われないようにするとともに、
-整合性をざっと調べ、文法エラーのチェックを行う。 \fIsudoers\fR ファイル
-が現在編集中だった場合は、「try again later」というメッセージを端末に
-表示する。
+整合性をざっと調べ、文法エラーのチェックを行う。
+\&\fIsudoers\fR ファイルが現在編集中だった場合は、
+「try again later」というメッセージを端末に表示する。
 .PP
 \&\fBvisudo\fR が使用するエディタについては、コンパイル時に設定された
-エディタのリストがプログラムに埋め込まれているが、\fIsudoers\fR ファイルの 
-\&\f(CW\*(C`Defaults\*(C'\fR 行で \fIeditor\fR オプションを使えば、
-それを変更することができる。このリストはデフォルトでは、
-使用しているシステムにおける \fIvi\fR\|(1) のパスであり、
-\&\fIconfigure\fR スクリプトによって割り出されたものだ。
-通常 \fBvisudo\fR は、環境変数 \f(CW\*(C`VISUAL\*(C'\fR や
-\&\f(CW\*(C`EDITOR\*(C'\fR の値が上述のエディタ・リストに含まれる
-エディタでないかぎり、そうした環境変数を使用しない。とは言え、\fBvisudo\fR が
+一つ以上のエディタからなるリストがプログラムに埋め込まれているが、
+\&\fIsudoers\fR ファイルの \f(CW\*(C`Defaults\*(C'\fR 行で
+\&\fIeditor\fR オプションを使えば、それを変更することができる。
+このリストはデフォルトでは、\f(CW"/usr/bin/vi"\fR になっている。
+通常 \fBvisudo\fR は、
+環境変数 \f(CW\*(C`VISUAL\*(C'\fR や \f(CW\*(C`EDITOR\*(C'\fR
+の値が上述のエディタ・リストに含まれるエディタでないかぎり、
+そうした環境変数を使用しない。とは言え、
+\&\fBvisudo\fR が
 \&\fI\-\-with\-env\-editor\fR オプションを付けて configure されている場合や、
 \&\fIsudoeres\fR ファイルの \f(CW\*(C`Defaults\*(C'\fR 行で
 \&\fIenv_editor\fR オプションがセットされている場合は、\fBvisudo\fR は
 \&\f(CW\*(C`VISUAL\*(C'\fR や \f(CW\*(C`EDITOR\*(C'\fR によって指定された
-どんなエディタでも使用することになる。これがセキュリティホールに
\81ªã\82\8aã\81\8bã\81­ã\81ªã\81\84ã\81\93ã\81¨ã\81«æ³¨æ\84\8fã\81\97ã\81¦ã\81»ã\81\97ã\81\84ã\80\82å\8d\98ã\81« \f(CW\*(C`VISUAL\*(C'\fR ã\82\84
-\&\f(CW\*(C`EDITOR\*(C'\fR を設定するだけで、ユーザが任意のプログラムを
-実行できるようになってしまうからだ。
+どんなエディタでも使用することになる。
\81\93ã\82\8cã\81\8cã\82»ã\82­ã\83¥ã\83ªã\83\86ã\82£ã\83\9bã\83¼ã\83«ã\81«ã\81ªã\82\8aã\81\8bã\81­ã\81ªã\81\84ã\81\93ã\81¨ã\81«æ³¨æ\84\8fã\81\97ã\81¦ã\81»ã\81\97ã\81\84ã\80\82
+単に \f(CW\*(C`VISUAL\*(C'\fR や \f(CW\*(C`EDITOR\*(C'\fR を設定するだけで、
+ユーザが任意のプログラムを実行できるようになってしまうからだ。
 .PP
 \&\fBvisudo\fR は編集が終わると、\fIsudoers\fR ファイルの文法解析を行い、
 文法エラーがあれば、変更を保存しない。\fBvisudo\fR はエラーを発見すると、
-エラーが起きた行番号を知らせるメッセージを表示し、\*(L"What now?\*(R" と
-いうプロンプトを出す。このとき、\*(L"e\*(R" を押せば、
+エラーが起きた行番号を知らせるメッセージを表示し、\*(L"What now?\*(R"
\81¨ã\81\84ã\81\86ã\83\97ã\83­ã\83³ã\83\97ã\83\88ã\82\92å\87ºã\81\99ã\80\82ã\81\93ã\81®ã\81¨ã\81\8dã\80\81\*(L"e\*(R" ã\82\92æ\8a¼ã\81\9bã\81°ã\80\81
 \&\fIsudoers\fR ファイルを再編集できる。\*(L"x\*(R" を押せば、
 変更を保存せず終了だし、\*(L"Q\*(R" を押せば、変更を保存して終了だ。
 \&\*(L"Q\*(R" の選択は、くれぐれも慎重にやってほしい。なぜなら、
-\&\fBvisudo\fR が文法エラーがあると考えるのなら、\fBsudo\fR も
-同様に考えるはずであり、エラーが訂正されるまで、もう誰にも \fBsudo\fR が
-使えなくなってしまうからだ。文法エラーが発見されたとき、\*(L"e\*(R" を
-押して \fIsudoers\fR ファイルを編集しようとすると、カーソルがファイルの
-エラーが起きた行に飛ぶ (エディタにその機能があればだが)。
+\&\fBvisudo\fR が文法エラーがあると考えるのなら、\fBsudo\fR
+も同様に考えるはずであり、エラーが訂正されるまで、もう誰にも \fBsudo\fR
+が使えなくなってしまうからだ。文法エラーが発見されたとき、\*(L"e\*(R"
+を押して \fIsudoers\fR ファイルを編集しようとすると、
\82«ã\83¼ã\82½ã\83«ã\81\8cã\83\95ã\82¡ã\82¤ã\83«ã\81®ã\82¨ã\83©ã\83¼ã\81\8cèµ·ã\81\8dã\81\9fè¡\8cã\81«é£\9bã\81¶ (ã\82¨ã\83\87ã\82£ã\82¿ã\81«ã\81\9dã\81®æ©\9fè\83½ã\81\8cã\81\82ã\82\8cã\81°ã\81 ã\81\8c\80\82
 .SH "オプション"
 .IX Header "OPTIONS"
 \&\fBvisudo\fR では以下のコマンドラインオプションが使用できる。
 .IP "\-c" 12
 .IX Item "-c"
 \&\fBcheck-only\fR モードを有効にする。現在の \fIsudoers\fR ファイルの
-文法をチェックし、メッセージを標準出力に表示して、
-\fIsudoers\fR の状態を詳細に報告する。文法チェックが成功裡に終わった場合、
-\&\fBvisudo\fR は返り値 0 で終了する。文法エラーに出会った場合の
-返り値は 1 である。
+文法エラー、所有者、アクセス権をチェックする
+(訳注: 所有者とアクセス権のチェックをするのは sudo-1.8.4p3 以降である)。
+\&\fB\-q\fR オプションが指定されていない場合は、メッセージを標準出力に表示して、
+\&\fIsudoers\fR の状態を報告する。チェックが成功裡に終わった場合は、
+\&\fBvisudo\fR は返り値 0 で終了する。
+エラーに出会った場合の返り値は 1 である。
 .IP "\-f \fIsudoers\fR" 12
 .IX Item "-f sudoers"
-\&\fIsudoers\fR ファイルの位置を指定・変更する。このオプションを
-付けると、 \fBvisudo\fR はデフォルトの \fI/etc/sudoers\fR ではなく、
-ユーザが選んだ \fIsudoers\fR ファイルを編集 (あるいは、チェック) する
-ことになる。ロックファイルとしては、指定された \fIsudoers\fR ファイルの
-名前の末尾に \*(L".tmp\*(R" を付けたものが使われる。
+\&\fIsudoers\fR ファイルの位置を指定・変更する。このオプションを付けると、
+\&\fBvisudo\fR はデフォルトの \fI/etc/sudoers\fR ではなく、
+ユーザが選んだ \fIsudoers\fR ファイルを編集 (あるいは、チェック)
+することになる。ロックファイルとしては、指定された \fIsudoers\fR
+ファイルの名前の末尾に \*(L".tmp\*(R" を付けたものが使われる。なお、
+\&\fBcheck-only\fR モードの場合だけ、\fB\-f\fR の引数に \*(L"\-\*(R"
+を指定することができる。
+これは、標準入力から \fIsudoers\fR が読み込まれるということである。
+.IP "\-h" 12
+.IX Item "-h"
+\&\fB\-h\fR (\fIhelp\fR) オプションを指定すると、
+\&\fBvisudo\fR は標準出力に簡単なヘルプメッセージを表示して、終了する。
 .IP "\-q" 12
 .IX Item "-q"
-\&\fBquiet\fR モードを有効にする。このモードでは、文法エラーの詳細情報は
-表示されない。このオプションに意味があるのは、\fB\-c\fR オプションと
-組み合わせたときだけである。
+\&\fBquiet\fR モードを有効にする。このモードでは、
+文法エラーの詳細情報は表示されない。このオプションが役に立つのは、
+\&\fB\-c\fR オプションと組み合わせたときだけである。
 .IP "\-s" 12
 .IX Item "-s"
 \&\fIsudoers\fR ファイルの\fB厳密\fR (\fBstrict\fR) チェックを有効にする。
-エイリアスを定義する前に使用すると、\fBvisudo\fR がそれを文法エラーと
-見なすようになるわけだ。ホスト名やユーザ名がアルファベットの大文字、
-数字、アンダースコア ('_') だけから構成されている場合、そうしたものと
-エイリアスとの区別は付かないことに注意してほしい。
+エイリアスを定義する前に使用すると、
+\&\fBvisudo\fR がそれを文法エラーと見なすようになるわけだ。
+ホスト名やユーザ名がアルファベットの大文字、数字、アンダースコア ('_')
+だけから構成されている場合は、
+そうしたものとエイリアスとの区別が付かないことに注意してほしい。
 .IP "\-V" 12
 .IX Item "-V"
-オプションに \fB\-V\fR (version) を付けると、\fBvisudo\fR は
-バージョンナンバーを表示して、終了する。
+\&\fB\-V\fR (version) オプションを指定すると、
+\&\fBvisudo\fR はバージョン番号を表示して、終了する。
 .SH "環境変数"
 .IX Header "ENVIRONMENT"
 以下の環境変数が参照されるかどうかは、\fIsudoers\fR の \fIeditor\fR や
@@ -273,7 +277,7 @@ visudo が使うロックファイル
 .IX Header "DIAGNOSTICS"
 .IP "sudoers file busy, try again later." 4
 .IX Item "sudoers file busy, try again later."
\8f¾å\9c¨ã\80\81ã\81»ã\81\8bã\81®èª°ã\81\8bã\81\8c \fIsudoers\fR ã\83\95ã\82¡ã\82¤ã\83«ã\82\92ç·¨é\9b\86中ã\81 
\8f¾å\9c¨ã\80\81ã\81»ã\81\8bã\81®èª°ã\81\8bã\81\8c \fIsudoers\fR ã\83\95ã\82¡ã\82¤ã\83«ã\82\92ç·¨é\9b\86中ã\81§ã\81\82ã\82\8b
 .ie n .IP "/etc/sudoers.tmp: Permission denied" 4
 .el .IP "\f(CW@sysconfdir\fR@/sudoers.tmp: Permission denied" 4
 \&\fBvisudo\fR を root として実行しなかった。
@@ -282,32 +286,40 @@ visudo が使うロックファイル
 あなたのユーザ ID はシステムの passwd ファイルに載っていない。
 .IP "Warning: {User,Runas,Host,Cmnd}_Alias referenced but not defined" 4
 .IX Item "Warning: {User,Runas,Host,Cmnd}_Alias referenced but not defined"
-User_Alias, Runas_Alias, Host_Alias, Cmnd_Alias のどれかを、
-定義しないまま使用しようとしている。
+User_Alias (あるいは、Runas_Alias, Host_Alias, Cmnd_Alias)
+を、定義しないまま使用しようとしている。
 あるいは、記載したユーザ名かホスト名の中に、アルファベットの大文字、
 数字、アンダースコア ('_') のみからなるものがある。後者の場合は、
 この warning を無視して構わない (\fBsudo\fR は警告を出さないないだろう)。
 \&\fB\-s\fR (strict) モードでは、warning ではなく、error になる。
 .IP "Warning: unused {User,Runas,Host,Cmnd}_Alias" 4
 .IX Item "Warning: unused {User,Runas,Host,Cmnd}_Alias"
-指摘された User_Alias (あるいは、Runas_Alias, Host_Alias, Cmnd_Alias) は
+指摘された User_Alias (あるいは、Runas_Alias, Host_Alias, Cmnd_Alias) は
 定義されているが、一度も使用されていない。そうした使用しないエイリアスは、
\82³ã\83¡ã\83³ã\83\88ã\82¢ã\82¦ã\83\88ã\81\99ã\82\8bã\81ªã\82\8aã\80\81æ¶\88å\8e»ã\81\99ã\82\8bã\81ªã\82\8aã\81\97ã\81¦ã\82\82ã\82\88ã\81\84ã\81 ã\82\8dã\81\86ã\80\82
+コメントアウトするなり、消去するなりしてもよい。
 \&\fB\-s\fR (strict) モードでは、warning ではなく、error になる。
+.IP "Warning: cycle in {User,Runas,Host,Cmnd}_Alias" 4
+.IX Item "Warning: cycle in {User,Runas,Host,Cmnd}_Alias"
+指摘された User_Alias (あるいは、Runas_Alias, Host_Alias, Cmnd_Alias) は、
+直接自分自身を参照しているか、
+構成要素のエイリアスを通して自分自身を参照している。
+\&\fBsudo\fR は \fIsudoers\fR を解析するとき、
+循環を無視するので、これはデフォルトでは、単なる警告になっている。
 .SH "関連項目"
 .IX Header "SEE ALSO"
 \&\fIvi\fR\|(1), \fIsudoers\fR\|(5), \fIsudo\fR\|(8), \fIvipw\fR\|(8)
 .SH "作者"
 .IX Header "AUTHOR"
-\&\fIsudo\fR の製作には、多数の人々が長年に渡って取り組んできた。
-\fBvisudo\fR の当バージョンを書いたのは、
+多数の人々が長年に渡って \fBsudo\fR の開発に取り組んできた。
+\&\fBvisudo\fR の当バージョンを書いたのは、
 .PP
 .Vb 1
 \& Todd Miller
 .Ve
 .PP
-である。詳細については、配布物中の \s-1HISTORY\s0 ファイルか、
-http://www.sudo.ws/sudo/history.html を御覧になっていただきたい。
+である。\fBsudo\fR の開発に貢献してくださった方々のリストについては、
+\&\fBsudo\fR の配布に含まれる \s-1CONTRIBUTORS\s0 ファイルをご覧いただきたい
+(http://www.sudo.ws/sudo/contributors.html)。 
 .SH "警告"
 .IX Header "CAVEATS"
 \&\fBvisudo\fR が使用するエディタでシェル・エスケープが可能なかぎり、
@@ -326,10 +338,11 @@ http://www.sudo.ws/sudo/bugs/
 http://www.sudo.ws/mailman/listinfo/sudo\-users
 .SH "免責"
 .IX Header "DISCLAIMER"
-\&\fBvisudo\fR は「現状のまま」提供される。明示的な、あるいは黙示的な
-いかなる保証も、商品性や特定目的への適合性についての黙示的な保証を含め、
+\&\fBvisudo\fR は「現状のまま」提供される。
+明示的な、あるいは黙示的ないかなる保証も、
+商品性や特定目的への適合性についての黙示的な保証を含め、
 またそれのみに止まらず、これを否認する。詳細な全文については、
-\&\fBsudo\fR と一緒に配布されている \s-1LICENSE\s0 ファイルや
+\&\fBsudo\fR と一緒に配布されている \s-1LICENSE\s0 ファイルや
 下記 Web ページを御覧いただきたい。
 .br
 http://www.sudo.ws/sudo/license.html