OSDN Git Service

(split) LDP: Update draft and release pages (based on the previous commit)
[linuxjm/LDP_man-pages.git] / release / man5 / nscd.conf.5
index 18519ad..01952ad 100644 (file)
@@ -1,7 +1,7 @@
-.\" -*- nroff -*-
 .\" Copyright (c) 1999, 2000 SuSE GmbH Nuernberg, Germany
 .\" Author: Thorsten Kukuk <kukuk@suse.de>
 .\"
+.\" %%%LICENSE_START(GPLv2+_SW_3_PARA)
 .\" This program is free software; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of the
 .\" General Public License for more details.
 .\"
 .\" You should have received a copy of the GNU General Public
-.\" License along with this program; see the file COPYING.  If not,
-.\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-.\" Boston, MA 02111-1307, USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
-.\" Japanese Version Copyright (c) 2001 Yuichi SATO
-.\"         all rights reserved.
-.\" Translated 2001-06-09, Yuichi SATO <ysato@h4.dion.ne.jp>
-.\" Updated 2006-07-19, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.36
+.\"*******************************************************************
 .\"
-.TH NSCD.CONF 5 1999-10-01 "GNU" "Linux Programmer's Manual"
-.SH Ì¾Á°
-/etc/nscd.conf \- ¥Í¡¼¥à¥µ¡¼¥Ó¥¹¥­¥ã¥Ã¥·¥å¥Ç¡¼¥â¥ó¤ÎÀßÄê¥Õ¥¡¥¤¥ë
-.SH ÀâÌÀ
-.BR nscd (8)
-¤Ïµ¯Æ°»þ¤Ë¥Õ¥¡¥¤¥ë
-.I /etc/nscd.conf
-¤òÆɤ߹þ¤à¡£
-³Æ¹Ô¤Ë¤Ï¡Ö°À­¡¦Ã͡פޤ¿¤Ï¡Ö°À­¡¦¥µ¡¼¥Ó¥¹¡¦Ã͡פò»ØÄꤹ¤ë¡£
-¥Õ¥£¡¼¥ë¥É¤Ï¥¹¥Ú¡¼¥¹Ê¸»ú¤Þ¤¿¤Ï¥¿¥Öʸ»ú¤Ç¶èÀÚ¤é¤ì¤ë¡£
-\(aq#\(aq (¥Ê¥ó¥Ð¡¼µ­¹æ) ¤Ï¥³¥á¥ó¥È¤Î»Ï¤Þ¤ê¤òɽ¤¹¡£
-¤³¤Îµ­¹æ¤«¤é¹ÔËö¤Þ¤Ç¤Ï nscd ¤Ë¤è¤Ã¤Æ²ò¼á¤µ¤ì¤Ê¤¤¡£
-»ØÄê²Äǽ¤Ê¥µ¡¼¥Ó¥¹¤Ï \fIpasswd\fP, \fIgroup\fP, \fIhosts\fP ¤Ç¤¢¤ë¡£
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH NSCD.CONF 5 2013\-02\-12 GNU "Linux Programmer's Manual"
+.SH 名前
+/etc/nscd.conf \- ネームサービスキャッシュデーモンの設定ファイル
+.SH 説明
+\fBnscd\fP(8)  は起動時にファイル \fI/etc/nscd.conf\fP を読み込む。
+各行には「属性・値」または「属性・サービス・値」を指定する。 フィールドはスペース文字またはタブ文字で区切られる。 \(aq#\(aq (ナンバー記号)
+はコメントの始まりを表す。 この記号から行末までは nscd によって解釈されない。
+
+指定可能なサービスは \fIpasswd\fP, \fIgroup\fP, \fIhosts\fP, \fIservices\fP, \fInetgroup\fP である。
+
+\fBlogfile\fP \fIdebug\-file\-name\fP
+.RS
+デバッグ情報が書き込まれるファイルの名前を指定する。
+.RE
+
+\fBdebug\-level\fP \fIvalue\fP
+.RS
+希望するデバッグレベルを設定する。デフォルトは 0。
+.RE
 
-.B logfile
-.I debug-file-name
+\fBthreads\fP \fInumber\fP
 .RS
-¥Ç¥Ð¥Ã¥°¾ðÊ󤬽ñ¤­¹þ¤Þ¤ì¤ë¥Õ¥¡¥¤¥ë¤Î̾Á°¤ò»ØÄꤹ¤ë¡£
+スレッドをいくつ起動してリクエストを待つのかを指定する。 少なくとも 5 つのスレッドが常に作成される。
 .RE
 
-.B debug-level
-.I value
+\fBmax\-threads\fP \fInumber\fP
 .RS
-´õ˾¤¹¤ë¥Ç¥Ð¥Ã¥°¥ì¥Ù¥ë¤òÀßÄꤹ¤ë¡£
+スレッドの最大数を指定する。デフォルトは 32。
 .RE
 
-.B threads
-.I number
+\fBserver\-user\fP \fIuser\fP
 .RS
-¥¹¥ì¥Ã¥É¤ò¤¤¤¯¤Äµ¯Æ°¤·¤Æ¥ê¥¯¥¨¥¹¥È¤òÂԤĤΤ«¤ò»ØÄꤹ¤ë¡£
-¾¯¤Ê¤¯¤È¤â 5 ¤Ä¤Î¥¹¥ì¥Ã¥É¤¬¾ï¤ËºîÀ®¤µ¤ì¤ë¡£
+このオプションが設定されると、 nscd は root ではなく、この user として実行される。 (\-S パラメータにより)
+各ユーザー毎に別々のキャッシュが使われる場合、 このオプションは無視される。
 .RE
 
-.B server-user
-.I user
+\fBstat\-user\fP \fIuser\fP
 .RS
-¤³¤Î¥ª¥×¥·¥ç¥ó¤¬ÀßÄꤵ¤ì¤ë¤È¡¢
-nscd ¤Ï root ¤Ç¤Ï¤Ê¤¯¡¢¤³¤Î user ¤È¤·¤Æ¼Â¹Ô¤µ¤ì¤ë¡£
-(\-S ¥Ñ¥é¥á¡¼¥¿¤Ë¤è¤ê) ³Æ¥æ¡¼¥¶¡¼Ëè¤ËÊÌ¡¹¤Î¥­¥ã¥Ã¥·¥å¤¬»È¤ï¤ì¤ë¾ì¹ç¡¢
-¤³¤Î¥ª¥×¥·¥ç¥ó¤Ï̵»ë¤µ¤ì¤ë¡£
+統計情報の参照を許可するユーザを指定する。
 .RE
 
-.B enable-cache
-.I service
-.I <yes|no>
+\fBreload\-count\fP unlimited | \fInumber\fP
 .RS
-»ØÄꤷ¤¿
-.I service
-¤Î¥­¥ã¥Ã¥·¥å¤òÍ­¸ú¤Þ¤¿¤Ï̵¸ú¤Ë¤¹¤ë¡£
+キャッシュされたエントリが使用されなかったときに、 削除される前に何回リロードされるかを設定する。デフォルトは 5。
 .RE
 
-.B positive-time-to-live
-.I service
-.I value
+\fBparanoia\fP \fI<yes|no>\fP
 .RS
-»ØÄꤷ¤¿
-.I service
-¤Î¥­¥ã¥Ã¥·¥å¤Ë¤¢¤ë¥Ý¥¸¥Æ¥£¥Ö¥¨¥ó¥È¥ê (À®¸ù¤·¤¿Ì䤤¹ç¤ï¤») ¤Î
-TTL (time-to-live) ¤òÀßÄꤹ¤ë¡£
-.I value
-¤Îñ°Ì¤ÏÉäǤ¢¤ë¡£
-ÃͤòÂ礭¤¯¤¹¤ë¤È¡¢¥Ò¥Ã¥ÈΨ¤¬¹â¤¯¤Ê¤êÊ¿¶Ñ±þÅú»þ´Ö¤òû¤¯¤Ç¤­¤ë¤¬¡¢
-¥­¥ã¥Ã¥·¥å¤Î¥³¥Ò¡¼¥ì¥ó¥¹ (coherence,
-¥­¥ã¥Ã¥·¥å¤¬¼ÂºÝ¤Î¥Ç¡¼¥¿¤È°ìÃפ·¤Æ¤¤¤ë¤³¤È) ¤ËÌäÂ꤬À¸¤¸¤ë¡£
+パラノイアモードを有効にする。 パラノイアモードでは nscd を定期的に再起動する。デフォルトは無効。
 .RE
 
-.B negative-time-to-live
-.I service
-.I value
+\fBrestart\-interval\fP \fItime\fP
 .RS
-»ØÄꤷ¤¿
-.I service
-¤Î¥­¥ã¥Ã¥·¥å¤Ë¤¢¤ë¥Í¥¬¥Æ¥£¥Ö¥¨¥ó¥È¥ê (¼ºÇÔ¤·¤¿Ì䤤¹ç¤ï¤») ¤Î
-TTL (time-to-live) ¤òÀßÄꤹ¤ë¡£
-.I value
-¤Îñ°Ì¤ÏÉäǤ¢¤ë¡£
-¥·¥¹¥Æ¥à¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ë¤Ê¤¤ UID (¥æ¡¼¥¶¡¼ID) ¤Ç½êÍ­¤µ¤ì¤ë¥Õ¥¡¥¤¥ë
-(¤¿¤È¤¨¤Ð root ¤Ç tar ¤òŸ³«¤·¤¿ linux ¥«¡¼¥Í¥ë¤Î¥½¡¼¥¹) ¤¬¾¯¤Ê¤¤¤È¡¢
-¸²Ãø¤ÊÀ­Ç½¤Î¸þ¾å¤¬¸«¤é¤ì¤ë¡£
-¥­¥ã¥Ã¥·¥å¤Î¥³¥Ò¡¼¥ì¥ó¥¹ÌäÂê¤ò¾¯¤Ê¤¯¤¹¤ë¤¿¤á¤Ë¾®¤µ¤ÊÃͤˤ¹¤Ù¤­¤Ç¤¢¤ë¡£
+パラノイアモードが有効で定期的に再起動する場合の、 再起動間隔を \fItime\fP 秒に設定する。デフォルトは 3600。
 .RE
 
-.B suggested-size
-.I service
-.I value
+\fBenable\-cache\fP \fIservice\fP \fI<yes|no>\fP
 .RS
-ÆâÉô¥Ï¥Ã¥·¥å¥Æ¡¼¥Ö¥ë¤ÎÂ礭¤µ¤ò»ØÄꤹ¤ë¡£
-¸úΨ¤òºÇŬ¤Ë¤¹¤ë¤¿¤á¤Ë
-.I value
-¤ÏÁÇ¿ô¤Ë¤·¤Æ¤ª¤¯¤Ù¤­¤Ç¤¢¤ë¡£
+指定した \fIservice\fP のキャッシュを有効または無効にする。デフォルトは無効。
 .RE
 
-.B check-files
-.I service
-.I <yes|no>
+\fBpositive\-time\-to\-live\fP \fIservice\fP \fIvalue\fP
 .RS
-»ØÄꤷ¤¿
-.I service
-¤Ë´ØÏ¢¤¹¤ë¥Õ¥¡¥¤¥ë¤ÎÊѹ¹¤Î¥Á¥§¥Ã¥¯¤òÍ­¸ú¤Þ¤¿¤Ï̵¸ú¤Ë¤¹¤ë¡£
-¥Õ¥¡¥¤¥ë¤Ï
-.IR /etc/passwd ,
-.IR /etc/group ,
-.I /etc/hosts
-¤Ç¤¢¤ë¡£
+指定した \fIservice\fP のキャッシュにあるポジティブエントリ (成功した問い合わせ) の TTL (time\-to\-live) を設定する。
+\fIvalue\fP の単位は秒である。 値を大きくすると、ヒット率が高くなり平均応答時間を短くできるが、 キャッシュのコヒーレンス (coherence,
+キャッシュが実際のデータと一致していること) に問題が生じる。
 .RE
 
-.B max-threads
-.I threads
+\fBnegative\-time\-to\-live\fP \fIservice\fP \fIvalue\fP
 .RS
-³«»Ï¤¹¤ë¥¹¥ì¥Ã¥É¤ÎºÇÂç¿ô¤ò»ØÄꤹ¤ë¡£
+指定した \fIservice\fP のキャッシュにあるネガティブエントリ (失敗した問い合わせ) の TTL (time\-to\-live) を設定する。
+\fIvalue\fP の単位は秒である。 システムデータベースにない UID (ユーザーID) で所有されるファイル (たとえば root で tar
+を展開した Linux カーネルのソース) が少ないと、 顕著な性能の向上が見られる。
+キャッシュのコヒーレンス問題を少なくするために小さな値にすべきである。
 .RE
 
-.B stat-user
-.I username
+\fBsuggested\-size\fP \fIservice\fP \fIvalue\fP
 .RS
-Åý·×¾ðÊó¤Î»²¾È¤òµö²Ä¤¹¤ë¥æ¡¼¥¶¤ò»ØÄꤹ¤ë¡£
+内部ハッシュテーブルの大きさを指定する。 効率を最適にするために \fIvalue\fP は素数にしておくべきである。デフォルトは 211 である。
 .RE
 
-.B reload-count
-unlimited |
-.I number
+\fBcheck\-files\fP \fIservice\fP \fI<yes|no>\fP
 .RS
-¥­¥ã¥Ã¥·¥å¤µ¤ì¤¿¥¨¥ó¥È¥ê¤¬»ÈÍѤµ¤ì¤Ê¤«¤Ã¤¿¤È¤­¤Ë¡¢
-ºï½ü¤µ¤ì¤ëÁ°¤Ë²¿²ó¥ê¥í¡¼¥É¤µ¤ì¤ë¤«¤òÀßÄꤹ¤ë¡£
+指定した \fIservice\fP に関連するファイルの変更のチェックを有効または無効にする。 ファイルは \fI/etc/passwd\fP,
+\fI/etc/group\fP, \fI/etc/hosts\fP である。デフォルトは有効。
 .RE
 
-.B paranoia
-.I <yes|no>
+\fBpersistent\fP \fIservice\fP \fI<yes|no>\fP
 .RS
-¥Ñ¥é¥Î¥¤¥¢¥â¡¼¥É¤òÍ­¸ú¤Ë¤¹¤ë¡£
-¥Ñ¥é¥Î¥¤¥¢¥â¡¼¥É¤Ç¤Ï nscd ¤òÄê´üŪ¤ËºÆµ¯Æ°¤¹¤ë¡£
+サーバの再起動の前後で \fIservice\fP のキャッシュ内容を保持する。 \fBparanoia\fP
+モードが有効の場合に便利である。デフォルトは保持しない。
 .RE
 
-.B restart-interval
-.I time
+\fBshared\fP \fIservice\fP \fI<yes|no>\fP
 .RS
-¥Ñ¥é¥Î¥¤¥¢¥â¡¼¥É¤¬Í­¸ú¤ÇÄê´üŪ¤ËºÆµ¯Æ°¤¹¤ë¾ì¹ç¤Î¡¢
-ºÆµ¯Æ°´Ö³Ö¤ò
-.I time
-ÉäËÀßÄꤹ¤ë¡£
+\fIservice\fP の nscd データベースのメモリ・マッピングをクライアント間で共有する。
+これにより、検索を実行する度にソケット経由でデーモンに問い合わせを 行わずに、直接データベースを検索できるようになる。デフォルトは共有しない。
 .RE
 
-.B persistent
-.I service
-.I <yes|no>
+\fBmax\-db\-size\fP \fIservice\fP \fIbytes\fP
 .RS
-¥µ¡¼¥Ð¤ÎºÆµ¯Æ°¤ÎÁ°¸å¤Ç
-.I service
-¤Î¥­¥ã¥Ã¥·¥åÆâÍƤòÊÝ»ý¤¹¤ë¡£
-.B paranoia
-¥â¡¼¥É¤¬Í­¸ú¤Î¾ì¹ç¤ËÊØÍø¤Ç¤¢¤ë¡£
+The maximum allowable size, in bytes, of the database files for the
+\fIservice\fP.  The default is 33554432.
 .RE
 
-.B shared
-.I service
-.I <yes|no>
+\fBauto\-propagate\fP \fIservice\fP \fI<yes|no>\fP
 .RS
-.I service
-¤Î nscd ¥Ç¡¼¥¿¥Ù¡¼¥¹¤Î¥á¥â¥ê¡¦¥Þ¥Ã¥Ô¥ó¥°¤ò¥¯¥é¥¤¥¢¥ó¥È´Ö¤Ç¶¦Í­¤¹¤ë¡£
-¤³¤ì¤Ë¤è¤ê¡¢¸¡º÷¤ò¼Â¹Ô¤¹¤ëÅ٤˥½¥±¥Ã¥È·Ðͳ¤Ç¥Ç¡¼¥â¥ó¤ËÌ䤤¹ç¤ï¤»¤ò
-¹Ô¤ï¤º¤Ë¡¢Ä¾Àܥǡ¼¥¿¥Ù¡¼¥¹¤ò¸¡º÷¤Ç¤­¤ë¤è¤¦¤Ë¤Ê¤ë¡£
+When set to \fIno\fP for \fIpasswd\fP or \fIgroup\fP service, then the \fI.byname\fP
+requests are not added to \fIpasswd.byuid\fP or \fIgroup.bygid\fP cache.  This can
+help with tables containing multiple records for the same ID.  The default
+is yes.  This option is valid only for services \fIpasswd\fP and \fIgroup\fP.
 .RE
-.SH ´ØÏ¢¹àÌÜ
-.BR nscd (8)
-.\" .SH Ãø¼Ô
+.SH 関連項目
+.\" .SH AUTHOR
 .\" .B nscd
-.\" ¤Ï Thorsten Kukuk ¤È Ulrich Drepper ¤Ë¤è¤Ã¤Æ½ñ¤«¤ì¤¿¡£
+.\" was written by Thorsten Kukuk and Ulrich Drepper.
+\fBnscd\fP(8)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。