mandb.8j

[nakano@xxxxxxxxxxxxxxxx]

'\" t
.\" Man page for mandb
.\"
.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file COPYING that comes with the
.\" man_db distribution.
.\" 
.\" Tue Apr 26 12:56:44 BST 1994  Wilf. (G.Wilford@xxxxxxxxxxxxxxx) 
.\"
.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
.\" Translated Fri 25 Sep 1998 by NAKANO Takeo <nakano@xxxxxxxxxxxxxxxx>
.\"
.TH mandb 8 "July 12th, 1995" "2.3.10" "Manual pager utils"
.\"O .SH NAME
.\"O mandb \- create or update the manual page index caches
.SH 名前
mandb \- マニュアルページのインデックスキャッシュを作成・更新する。
.\"O .SH SYNOPSIS
.SH 書式
.B mandb  
.RB [\| \-dqsuc \||\| \-h \||\| \-V\c
.RI "\|] [\|" manpath \|] 
.\"O .SH DESCRIPTION
.SH 説明
.\"O .B mandb
.\"O is used to initialise or manually update
.\"O .B index 
.\"O database caches that are usually maintained by 
.\"O .BR man .
.\"O The caches contain information relevant to the current state of the manual
.\"O page system and the information stored within them is used by the man_db 
.\"O utilities to enhance their speed and functionality.
.B mandb
はデータベースのキャッシュ
.B index
を初期化したり、手動で更新するときに用いる。通常はこのキャッシュは
.B man
によって管理されている。
キャッシュには、現在のマニュアルページシステムに関する情報とが含まれている。
この情報は man_db ユーティリティ群によって用いられ、速度と機能の向上に
貢献している。

.\"O When creating or updating an
.\"O .BR index ,
.\"O .B mandb
.\"O will warn of bad ROFF .so requests, bogus manual page filenames and 
.\"O manual pages from which the 
.\"O .B whatis 
.\"O cannot be parsed.
.B index
が生成・更新されるとき、
.B mandb
は ROFF の .so 命令の間違いや、マニュアルページのファイル名の重複、
.B whatis
によって情報を抽出できないマニュアルページなどにたいして警告を発する。

.\"O Supplying 
.\"O .B mandb 
.\"O with an optional colon delimited path will override the internal `global'
.\"O manual page hierarchy search path, determined from information found within 
.\"O the man_db configuration file.
.B mandb
に、コロンで区切ったパスのリストを与えることもできる。
これはプログラム内部の `global' なマニュアルページ系列
(man_db の設定ファイルに書いてある) を上書きする。
.\"O .SH "DATABASE CACHES"
.SS データベースキャッシュ
.\"O .B mandb
.\"O can be compiled with support for any one of the following database types.
..B mandb
は以下のデータベース形式のいずれか一つをサポートするように
コンパイルすることができる。
.TS
tab (@);
l l l l.
.\"O Name@Type@Async@Filename
名前@形式@非同期@ファイル名
_
.\"O Berkeley db@Binary tree@Yes@\fIindex.bt\fR
.\"O GNU gdbm v >= 1.6@Hashed@Yes@\fIindex.db\fR
.\"O GNU gdbm v <  1.6@Hashed@No@\fIindex.db\fR
.\"O UNIX ndbm@Hashed@No@\fIindex.(dir|pag)\fR
Berkeley db@二分木@可@\fIindex.bt\fR
GNU gdbm v >= 1.6@ハッシュ@可@\fIindex.db\fR
GNU gdbm v <  1.6@ハッシュ@不可@\fIindex.db\fR
UNIX ndbm@ハッシュ@不可@\fIindex.(dir|pag)\fR
.TE

.\"O Those database types that support asynchronous updates provide enhanced
.\"O speed at the cost of possible corruption in the event of unusual
.\"O termination.
これらのデータベース形式のうち非同期な更新ができるものでは、
速度は向上するが、予期しない中断が起こったときにデータが壊れるかもしれない。
.\"O In an unusual case where this has occured, it may be necessary to rerun 
.\"O .B mandb 
.\"O with the 
.\"O .B \-c
.\"O option to re-create the databases from scratch. 
このような破壊が起こったときには、
.B mandb
を
.B \-c
オプションをつけて実行し、データベースを再構成しなおす必要が
あるだろう。
.\"O .SH OPTIONS
.SH オプション
.TP
.B \-d, \-\-debug
.\"O Produce debugging information.
デバッグ情報を生成する。
.TP
.B \-q, \-\-quiet
.\"O Produce no warnings.
警告を発しない。
.TP
.B \-s, \-\-no-straycats
.\"O Do not spend time looking for or adding information to the databases
.\"O regarding stray cats.
stray cats (訳注: おそらく対応する roff ソースのない cat ページのこと
でしょう...) を探したり、それに関する情報をデータに追加しようとは試みない。
.\"??? stray cats?
.TP
.B \-c, \-\-create
.\"O By default, 
.\"O .B mandb
.\"O will try to update any previously created databases. If a database
.\"O does not exist, it will create it. This option forces 
.\"O .B mandb
.\"O to delete previous databases and re-create them from scratch. This may be
.\"O necessary if a database becomes corrupt or if a new database storage scheme
.\"O is introduced in the future.
デフォルトでは、
.B mandb
は以前に生成されたデータベースを更新しようとする。データベースが
存在しない場合には、始めから生成する。
このオプションを指定すると、
.B mandb
は以前のデータベースを消去し、データベースをゼロから再構成する。
これはデータベースが壊れた場合や、将来データベースの管理方法が
新しいものに変わったときなどに必要となろう。
.TP
.B \-u, \-\-user-db
.\"O Create user databases only, even with write permissions necessary to create
.\"O `global' databases.
ユーザーのデータベースしか生成しない。 `global' なデータベースを作成す
る権限があっても、こちらは生成しない。
.TP
.B \-h, \-\-help
.\"O Show the usage message, then exit.
使用法に関するメッセージを表示して終了する。
.TP
.B \-V, \-\-version
.\"O Show the version, then exit.
バージョンを表示して終了する。
.\"O .SH DIAGNOSTICS
.SH 診断メッセージ
.\"O The following warning messages can be omitted during database building.
データベースの構築中に、以下のような警告メッセージが出力されることがあ
る。
.TP 
.B <filename>: whatis parse for page(sec) failed
.\"O An attempt to extract whatis line(s) from the given
.\"O <filename> failed.  This is usually due to a poorly written manual
.\"O page, but if many such messages are emitted it is likely that the
.\"O system contains non-standard manual pages which are incompatible with
.\"O the man_db whatis parser.
<filename> から whatis に必要な行を取り出すのに失敗した。これは通常マ
ニュアルページの書き方が悪いからであることが多いが、このようなメッセー
ジが多く出るようであれば、そのシステムには man_db の whatis パーザーと
互換性のない、非標準的なマニュアルページが含まれている可能性が高い。
.TP
.B <filename>: is a dangling symlink
.\"O <filename> does not exist but is referenced by a symbolic link. 
.\"O Further diagnostics are usually emitted to identify the <filename> of the
.\"O offending link. 
<filename> がシンボリックリンクによって参照されているが、存在していな
い。通常、 <filename> を間違ってリンク対象としてしまっているリンク元に
関する診断メッセージが同時に表示される。
.TP
.B <filename>: bad symlink or ROFF `.so' request
.\"O <filename> is either a symbolic link to, or contains a ROFF include
.\"O request to, a non existent file.
<filename> はシンボリックリンクであるか、 ROFF のインクルー
ド命令を含んでいるが、リンク先・読み込み先のファイルが存在していない。
.TP
.B <filename>: ignoring bogus filename
.\"O The <filename> may or may not be a valid manual page but its name is
.\"O invalid.  This is usually due to a manual page with sectional extension <x>
.\"O being put in manual page section <y>. 
<filename> は正しい (あるいは正しくない) マニュアルページであるが、
名前が正しくない。通常これは、セクション拡張子 <x> のファイルが、
マニュアルページのセクション <y> に置かれている場合に起こる。
.TP
.B <filename_mask>: competing extensions
.\"O The wildcard <filename_mask> is not unique.  This is usually caused by
.\"O the existance of both a compressed and uncompressed version of the same
.\"O manual page.  All but the most recent are ignored.
ワイルドカード <filename_mask> がユニークな名前でない。これは通常、同
じマニュアルページに対して、圧縮されたバージョンとされていないバージョ
ンが共存している場合に起こる。最新のもの以外は無視される。
.\"O .SH FILES
.SH ファイル
.TP
.I /etc/manpath.config
.\"O man_db configuration file.
man_db の設定ファイル。
.TP
.I /usr/man/index.(bt|db|dir|pag)
.\"O A traditional global
.\"O .I index
.\"O database cache.
従来形式の、 global なデータベースキャッシュの
インデックス。
.TP
.I /var/catman/index.(bt|db|dir|pag)
.\"O An alternate or FSSTND
.\"O compliant global
.\"O .I index
.\"O database cache.
新しい (FSSTND 準拠の)、 global なデータベースキャッシュの
インデックス。
.\"O .SH "SEE ALSO"
.SH 関連項目
.BR man (1), 
.BR manpath (5),
.\"O .BR catman (8).
.BR catman (8)
.\"O .SH AUTHOR
.SH 著者
Wilf. (G.Wilford@xxxxxxxxxxxxxxx)