diff --git a/ja_JP.eucJP/man/man1/host.1 b/ja_JP.eucJP/man/man1/host.1 index eb4056df70..ad5986926c 100644 --- a/ja_JP.eucJP/man/man1/host.1 +++ b/ja_JP.eucJP/man/man1/host.1 @@ -1,329 +1,329 @@ .\" ++Copyright++ 1993 .\" - .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" - .\" Portions Copyright (c) 1993 by Digital Equipment Corporation. .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies, and that .\" the name of Digital Equipment Corporation not be used in advertising or .\" publicity pertaining to distribution of the document or software without .\" specific, written prior permission. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL .\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT .\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS .\" SOFTWARE. .\" - .\" --Copyright-- .\" %Id: host.1,v 8.4 2000/02/29 03:50:47 vixie Exp % .\" %FreeBSD: src/contrib/bind/doc/man/host.1,v 1.3.2.1 2000/11/02 14:08:07 asmodai Exp % .\" .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/host.1,v 1.9 2001/05/14 01:07:24 horikawa Exp $ +.\" $FreeBSD$ .Dd December 15, 1994 .Dt HOST 1 .Os BSD 4 .Sh 名称 .Nm host .Nd ドメインサーバを使ってホスト名の検索を行なう .Sh 書式 .Nm host .Op Fl adlrwv .Op Fl c Ar class .Op Fl t Ar querytype .Ar host .Op Ar server .Sh 解説 .Ic host はインターネットホストに関する情報の検索を行ないます。 情報は世界中に広がった相互に接続されたサーバ群から得ます。 デフォルトではホスト名とインターネットアドレス間の変換のみを行ないます。 .Dq Fl t や .Dq Fl a オプションとともに使うと、そのホストに関するドメインサーバによって保守 されている情報のすべてを得ることができます。 .Pp 引数にはホスト名かホスト番号のいずれかを指定できます。 本プログラムはまず引数をホスト番号として解釈を試みます。 それがうまくいかなければ、ホスト名として扱います。 ホスト番号は 128.6.4.194 のようにドットによって区切られた 4 つの 10 進数からなります。 ホスト名は topaz.rutgers.edu のようにドットで区切られた複数の名前からなります。 名前がドットで終っていなければ、ローカルドメインが自動的に末尾に 付け加えられます。たとえば Rutgers のユーザは .Pp .D1 Ic host topaz .Pp というように使うことができ、これは実際には "topaz.rutgers.edu" が検索されます。 これがうまくいかなければ、名前は変更されずに (この例では "topaz" として) 試みられます。このやりかたはメールやその他のネットワークユーティリティ -でも使うことができます。 +でも使われています。 実際に末尾に付け加えられる接尾辞は、 .Xr hostname 1 を呼び出した結果の最初のドット以降となります。(下記の .Sx ホスト名検索のカスタマイズ の節を参照してください。) .Pp 最初の引数は検索を行なうホスト名となります。これが数字の場合、 .Dq 逆引き が実行されます。すなわちドメインシステムは数字を名前に変換するための別 のデータベース群を参照します。 .Pp 2 番目の引数は省略可能です。ここでは問い合わせを行なうサーバを指定する ことができます。この引数が指定されなければ、デフォルトのサーバ (通常は ローカルマシン) が使われます。 .Pp 名前が指定された場合、3 つの異なった種類の結果が出力されます。 以下はそれらの例です。 .Pp .D1 Ic % host sun4 .Dl sun4.rutgers.edu is a nickname for ATHOS.RUTGERS.EDU .Dl ATHOS.RUTGERS.EDU has address 128.6.5.46 .Dl ATHOS.RUTGERS.EDU has address 128.6.4.4 .Dl ATHOS.RUTGERS.EDU mail is handled by ARAMIS.RUTGERS.EDU .Pp ここでユーザはコマンド .Dq Ic host sun4 を入力しています。最初の行は名前 .Dq Li sun4.rutgers.edu は実際にはニックネームであることを示しています。 正式なホスト名は .Dq Li ATHOS.RUTGERS.EDU です。続く 2 行ではアドレスが表示 されています。もし複数のネットワークインタフェースをもつシステムであ れば、その各々は別のアドレスを持ちます。最後の行では .Li ATHOS.RUTGERS.EDU は自分に対するメールは受け取らないことを示しています。このホスト宛ての メールは .Li ARAMIS.RUTGERS.EDU によって取り込まれます。いくつかのシステム ではそのメールを扱うシステムが複数存在することがあり、その場合はこの行 のような情報がさらに出力されます。技術的にはメールを受け取ることのでき るすべてのシステムがこのようなエントリを持つと考えられます。もしシステム がそのメールを自分自身で受け取る場合、 .Pp .D1 Li XXX mail is handled by XXX .Pp のように、そのシステム自身について言及したエントリがあるはずです。しかし、 メールを自分で受け取る多くのシステムではわざわざその事実について言及し ていません。もしあるシステムに .Dq Li mail is handled by のエントリがあるのにアドレスがなければ、 それは本当はインターネットの構成員ではないが、 ネットワーク上のあるシステムがメールをそこに転送してくることを示しています。 Usenet や Bitnet やその他の多くのネットワーク上のシステムではこの種の エントリを持っています。 .Sh オプション ホスト名の前に指定できるオプションは沢山あります。これらのオプションの ほとんどはドメインデータベースを保守しているスタッフにのみ意味のあるも のです。 .Bl -tag -width Fl .It Fl a .Dq all の意。 これは .Dq Fl v Fl t Cm any と同じです。 .It Fl c Ar class 非インターネットデータを検索する .Ar class 。 .It Fl d デバッグモードとなります。ネットワークトランザクションが詳細に表示されます。 .It Fl l 完全なドメインのリストを表示します。例えば .Pp .D1 Ic host -l rutgers.edu .Pp を実行すると、rutgers.edu ドメインのすべてのホストのリストを表示します。 .Dq Fl t オプションを使うことによって表示する情報にフィルタをかけることがで きます。デフォルトでは PTR と NS レコードを含んだアドレス情報が表示さ れます。 .Pp .D1 Ic host -l -v -t any rutgers.edu .Pp このコマンドでは rutgers.edu の完全なゾーンデータを正式なマスタファイル の形式でダウンロードします。(しかし不思議な理由により SOA レコードは 2 回リストされます。) .Pp .Sy 注: .Dq Fl l フラグは完全なゾーン転送を行なった後、 要求した情報をフィルタリングするように実装されています。このコマンドは 絶対に必要な時に限って使うべきです。 .It Fl r 再帰的な問い合わせを行ないません。これは ネームサーバがそのサーバ自身のデータベースに所持しているデータのみを返すこ とを意味します。サーバは他のサーバに情報の問い合わせを行ないません。 .It Fl d デバッグを有効にします。 ネットワークトランザクションの詳細が表示されます。 .It Fl s 署名から親の鍵を追跡します (DNSSEC)。 .It Fl t Ar querytype 特定の .Ar querytype の情報の検索を指定することができます。 引数は .Xr named 8 の man ページにおいて定義されています。現在サポートされ ているタイプには以下のものが含まれます: .Dq Cm a , .Dq Cm ns , .Dq Cm md , .Dq Cm mf , .Dq Cm cname , .Dq Cm soa , .Dq Cm mb , .Dq Cm mg , .Dq Cm mr , .Dq Cm null , .Dq Cm wks , .Dq Cm ptr , .Dq Cm hinfo , .Dq Cm minfo , .Dq Cm mx , .Dq Cm uinfo , .Dq Cm uid , .Dq Cm gid , .Dq Cm unspec さらに、ワイルドカード (これは .Dq Cm any か .Dq Cm * として指定されます) があり、上記のすべてのタイプを指定するためにつかいます。 タイプは小文字で指定しなければなりません。 デフォルトでは最初に .Dq Cm a が検索され、次に .Dq Cm mx が検索されます。ただし、verbose オプションが指定されていると、デフォルトでは .Dq Cm a のみの検索を行ないます。オプション .Dq Fl t は .Ic host が返す情報にフィルタをかけるのに特に有効です。 それ以上の情報は下記の .Dq Fl l オプションの説明を参照してください。 .It Fl a .Dq すべて 。 .Dq Fl v Fl t Cm any と同じです。 .It Fl l 完全なドメインを列挙します。例えば .Pp .D1 Ic host -l rutgers.edu .Pp は、rutgers.edu domain 内のすべてのホストを列挙します。 .Dq Fl t オプションを使用して、どの情報を表示するかを、意図通りフィルタ可能です。 デフォルトは、アドレス情報と PTR と NS レコードです。 コマンド .Pp .D1 Ic host -l -v -t any rutgers.edu .Pp は、rutgers.edu に対するゾーンデータの完全なダウンロードを、 公式なマスタファイル書式で与えます (しかしながら、不可解な理由で、SOA レコードは 2 度表示されます)。 .Pp .Sy 注: .Dq Fl l の実装は、完全なゾーン転送を行い、 これに対して要求した情報をフィルタアウトすることで行われます。 このコマンドの使用は、本当に必要な場合に限るべきです。 .El .Sh ホスト名検索のカスタマイズ 一般にユーザによって指定された名前にドットが含まれていなければ、 デフォルトのドメインがその末尾に付け加えられます。このドメインは .Pa /etc/resolv.conf において定義することができますが、通常はローカルの ホスト名の最初のドット以降を取ることによって求められます。ユーザは環境変数 .Ev LOCALDOMAIN を使って異なるデフォルトドメインを指定することによって、これを オーバーライドすることができます。さらに、ユーザはホスト名の独自の略称を使うこ ともできます。略称は 1 つの略称につき 1 行からなるファイルにおいて指定 します。各行には略称、スペース、そして完全なホスト名が含まれます。この ファイルは環境変数 .Ev HOSTALIASES にてファイル名を指定します。 .Sh 環境変数 .Bl -tag -width "/etc/resolv.conf " -compress .It Ev HOSTALIASES .Pq Ar ホストの別名 , 完全なホスト名 のペアを含んでいるファイルのファイル名 .El .Sh 関連ファイル .Bl -tag -width "/etc/resolv.conf " -compress .It Pa /etc/resolv.conf .Xr resolver 5 を参照してください。 .It Ev HOSTALIASES .Pq Ar ホストの別名 , 完全なホスト名 のペアを含んでいるファイルのファイル名 .El .Sh 関連項目 .Xr named 8 、 .Xr resolver 5 .Sh バグ ローカルドメインに含まれない名前を入力すると予期できない影響が起こり得 ます。名前がドットで終っていない限り、ローカルドメイン名がすべての名前の 末尾に付加されることをいつも心に留めておいてください。 ローカルドメインの補完に失敗した時のみ、名前は変更されずに使用されます。 .Pp .Dq Fl l オプションでは要求されたドメインにおいてリストされている最初の ネームサーバにのみ問い合わせを行ないます。もしこのサーバが死んでいれば、 サーバをマニュアルで指定しなければなりません。たとえば foo.edu のリストを 得るには、 .Pp .D1 Ic host -t ns foo.edu .Pp と指定して foo.edu のすべてのネームサーバ のリストを得てから、動作するものが見つかるまでリストにあるすべての ネームサーバについて .Pp .D1 Ic host -l foo.edu xxx .Pp (ここで .Dq Ic xxx はネームサーバ) を試みれば良いでしょう。 diff --git a/ja_JP.eucJP/man/man1/indxbib.1 b/ja_JP.eucJP/man/man1/indxbib.1 index d84128c440..a9f52d5da2 100644 --- a/ja_JP.eucJP/man/man1/indxbib.1 +++ b/ja_JP.eucJP/man/man1/indxbib.1 @@ -1,210 +1,210 @@ .ig Copyright (C) 1989-2000, 2001 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be included in translations approved by the Free Software Foundation instead of in the original English. .. -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/indxbib.1,v 1.6 2001/05/14 01:07:24 horikawa Exp $ +.\" $FreeBSD$ .TH INDXBIB 1 "6 August 2001" "Groff Version 1.17.2" .SH 名称 indxbib \- 文献目録データベース用の逆引きインデックスの作成 .SH 書式 .nr a \n(.j .ad l .nr i \n(.i .in +\w'\fBindxbib 'u .ti \niu .B indxbib .de OP .ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]" .el .RB "[\ " "\\$1" "\ ]" .. .OP \-vw .OP \-c file .OP \-d dir .OP \-f file .OP \-h n .OP \-i string .OP \-k n .OP \-l n .OP \-n n .OP \-o file .OP \-t n .RI [\ filename \|.\|.\|.\ ] .ad \na .PP コマンドラインオプションとパラメータの間に、空白を置くことが可能です。 .SH 解説 .B indxbib は、 .IR filename \|.\|.\|. で指定される文献目録データベースの逆引きインデックスを作成します。逆引きインデックスは .BR refer (1) 、 .BR lookbib (1) 、 .BR lkbib (1) で利用されます。このインデックスのファイル名は .IB filename .i となります(インデックスはいったんテンポラリファイルに書き込まれ、この 名前にリネームされます)。 .B \-f オプションを使い、また .B \-o オプションの指定もファイル名の指定もしなかった場合には、インデックスファイルは .BR Ind.i という名前となります。 .LP 文献目録データベースは、空行によってレコードに分けられています。 レコード内では、各フィールドは、行頭にある .B % の文字で始まります。フィールドは、 .B % に続いた一文字の名前を持ちます。 .LP .BR \-c 、 .BR \-n 、 .BR \-l 、および .B \-t のオプションによって指定された値は、インデックスの中に格納されます。 インデックスを検索する時には、ユーザが指定する検索キーは、これらのオプションに 従って、捨てられたり切りつめられてしまいます。 しかし、インデックスを検索して見付かったレコードが、実際にユーザが指定した検索キーを 含んでいる、ということを確かめる場合には、検索キーには そのような修正は行われません。 これは、 ユーザが指定した検索キーのうち少なくとも1つが (-l オプション等によって捨てられることなく) インデックスに登録されており、 かつ検索キーのうちの少なくとも(-t オプションによって)切りつめられた部分を インデックスのユーザが指定できるならば、 これらのオプションがインデックス作成時に使われたかどうか、ユーザは気にする必要が ない、ということを意味します。 .B \-i オプションによって指定された値もインデックス内に保存され、 インデックスを使った検索に適合するレコードがキーに適合するか否かを検証する時に使用します。 .\" うーんこんな訳でいいのかなぁ...ちょっと自信なし... .SH オプション .TP .B \-v バージョン番号を表示します。 .TP .B \-w ファイル全体に対してインデックスを作成します。 各々のファイルが、別々のレコードとなります。 .TP .BI \-c file .BR /usr/share/dict/eign の代わりに、 .I file から共通語の一覧を読み込みます。 .TP .BI \-d dir インデックスに格納する現在の作業ディレクトリのパスとして .BR pwd (1) で表示されるパスの代わりに .I dir を使います。 通常、 .I dir は -BR pwd (1) +.BR pwd (1) で表示されるディレクトリを差すシンボリックリンクとします。 .TP .BI \-f file インデックスを作るファイルを .IR file から読み込みます。 .I file が .BR \- の場合には、ファイルは標準入力から読み込まれます。 .B \-f オプションは1つまでしか使用できません。 .TP .BI \-i string フィールド名が .IR string に含まれているフィールドの内容についてのインデックスは作成しません。 .I string の初期値は .BR XYZ です。 .TP .BI \-h n ハッシュテーブルのサイズとして .I n 以上の素数を用います。 .I n を大きくすると検索は速くなりますが、インデックスは大きくなり、また .B indxbib はより多くのメモリを消費するようになります。 .I n の初期値は997です。 .TP .BI \-k n 入力レコードに対する検索キーの数を、最大で .I n 個にします。 .I n の初期値は100です。 .TP .BI \-l n .IR n 文字未満の検索キーを捨てます。 .I n の初期値は3です。 .TP .BI \-n n .I n 個の共通語を、ありふれたものから順に捨てます。 .I n の初期値は100です。 .TP .BI \-o basename インデックスの名前を .IB basename .i\fR とします。 .TP .BI \-t n 検索キーを .IR n 文字で切り捨てます。 .I n の初期値は6です。 .SH 関連ファイル .TP \w'\fBindxbib\fIXXXXXX'u+2n .IB filename .i インデックスです。 .TP .B Ind.i デフォルトのインデックス名です。 .TP .B /usr/share/dict/eign 共通語の一覧です。 .TP .BI indxbib XXXXXX テンポラリファイルです。 .SH 関連項目 .BR refer (1), .BR lkbib (1), .BR lookbib (1) . .\" Local Variables: .\" mode: nroff .\" End: diff --git a/ja_JP.eucJP/man/man1/login.1 b/ja_JP.eucJP/man/man1/login.1 index 9b20704da1..10baa3c6ce 100644 --- a/ja_JP.eucJP/man/man1/login.1 +++ b/ja_JP.eucJP/man/man1/login.1 @@ -1,200 +1,199 @@ .\" %NetBSD: login.1,v 1.5 1994/12/23 06:53:00 jtc Exp % .\" .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#)login.1 8.2 (Berkeley) 5/5/94 .\" %FreeBSD: src/usr.bin/login/login.1,v 1.17.2.1 2001/07/16 07:02:39 markm Exp % .\" -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/login.1,v 1.13 2001/05/14 01:07:25 horikawa Exp $ +.\" $FreeBSD$ .Dd May 5, 1994 .Dt LOGIN 1 .Os .Sh 名称 .Nm login .Nd 指定したユーザでログインする .Sh 書式 .Nm .Op Fl fp .Op Fl h Ar hostname .Op Ar user .Sh 解説 .Nm は、指定したユーザでログインするものです。 .Pp user を指定しなかった場合、もしくは指定した user でのログインに失敗した ときには、 .Nm は、再度ユーザ名の入力を求めるプロンプトを表示します。 ユーザの確認は入力されたパスワードにより行われます。 .Pp オプションとしては以下のものがあります: .Bl -tag -width Ds .It Fl f パスワードによるユーザの確認を省略します。このオプションは、スーパーユーザ か、すでにログインしているユーザが同じユーザ名で login を実行す るときのみ指定可能です。 .It Fl h コネクションを受信可能なホスト名を指定します。この機能は .Xr telnetd 8 などのデーモンによって使われています。このオプションはスーパーユーザ しか指定することができません。 .It Fl p .Nm は、デフォルトでは実行時の環境 (環境変数など) を引き継ぎ ませんが、このオプションを指定すると、実行時の環境を引き継ぎます。 .El .Pp もし .Pa /var/run/nologin ファイルが存在した場合、 .Nm はそのファイル内容 を表示してログイン処理をせずに終了します。この機能は .Xr shutdown 8 で使用されており、システムの終了処理実行中にユーザがログインしないよう にしています。 .Pp もし .Pa /etc/login.access ファイルが存在した場合、 .Nm はそのファイルから、ユーザとホストの組が特別に許可されている、もしくは 拒否されているかどうかをチェックします。 .Pp もし .Pa /etc/fbtab ファイルが存在した場合、 .Nm はそのファイルに記述された幾つかのデバイスのプロテクトと所有者を変えます。 .Pp ファイル .Pa /etc/skeykeys が存在する場合、このファイル中にユーザのエントリが存在する時には、 .Nm は S/key パスワード認証を行います。 .Pa /etc/skey.access により、 接続元のホストやネットワークに応じて S/key パスワード使用の義務を制御します。 .Pp 通常、ユーザがログインすると、 .Nm はシステムのコピーライト表示、 ユーザが最後にログインした日付と時間、その日のメッセージなどの 情報を表示します。ただし、ユーザのホームディレクトリに .Dq Pa .hushlogin というファイルが存在した場合は、これらのメッセージを表示 しないようにします (これは .Xr uucp 1 のようなプログラムがユーザとしてログインするためにあります)。 このあと、 .Nm は .Xr wtmp 5 と .Xr utmp 5 ファイルに記録し、ユーザのコマンドインタプリタ (シェル) を起動します。 .Pp なお、環境変数 ( .Xr environ 7 ) HOME, SHELL, PATH, TERM, LOGNAME, USER は .Nm によりセットされます。 他の環境変数はログインクラスケーパビリティデータベースの エントリにより設定されるかも知れません。 ログインクラスはユーザのシステムパスワードレコードに割り当てられています。 ログインクラスは、当該ログインに許された最大および現在の資源制約、 プロセス優先度や他の多くのユーザログイン環境を制御します。 .Pp シェルによっては、本ユーティリティと似たまたは同じ、組み込みの .Nm コマンドを提供するものがあります。 .Xr builtin 1 マニュアルページを参照してください。 .Sh 関連ファイル .Bl -tag -width /var/mail/userXXX -compact .It Pa /etc/fbtab デバイスのプロテクトの変更 .It Pa /etc/login.access ログインアクセス制御表 .It Pa /etc/login.conf ログインクラスケーパビリティデータベース .It Pa /etc/motd ログイン時に最初に表示するメッセージ .It Pa /var/run/nologin ログインを拒否する時に表示するメッセージ .It Pa /etc/skey.access skey パスワード制御表 .It Pa /etc/skeykeys skey パスワードデータベース .It Pa /var/run/utmp 現在のログイン状況 .It Pa /var/log/lastlog 最後にログインした記録 -last login account records .It Pa /var/log/wtmp ログイン・ログアウト状況 .It Pa /var/mail/user ユーザごとのメイルボックス .It Pa \&.hushlogin ログインメッセージを抑止するファイル .It Pa /etc/auth.conf 認証サービスの設定 .It Pa /etc/pam.conf .Nm が PAM サポート付きで設定されている場合、サービス名 .Dq login で .Pa /etc/pam.conf エントリを見ます .El .Sh 関連項目 .Xr builtin 1 , .Xr chpass 1 , .Xr csh 1 , .Xr passwd 1 , .Xr rlogin 1 , .Xr skey 1 , .Xr getpass 3 , .Xr fbtab 5 , .Xr login.access 5 , .Xr login.conf 5 , .Xr nologin 5 , .Xr skey.access 5 , .Xr utmp 5 , .Xr environ 7 , .Xr nologin 8 , .Xr pam 8 .Sh 歴史 .Nm login ユーティリティは .At v6 から登場しました。 diff --git a/ja_JP.eucJP/man/man1/make.1 b/ja_JP.eucJP/man/man1/make.1 index f10d4e3680..8d8a9085e5 100644 --- a/ja_JP.eucJP/man/man1/make.1 +++ b/ja_JP.eucJP/man/man1/make.1 @@ -1,1208 +1,1209 @@ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)make.1 8.4 (Berkeley) 3/19/94 .\" %FreeBSD: src/usr.bin/make/make.1,v 1.29.2.12 2001/08/16 13:16:57 ru Exp % .\" .\" this file based on that translated to japanese on NetBSD Japanese Reference .\" Manual Project, and modefied to fit FreeBSD Reference Manual .\" by Mochida Shuji 1996/04/26 .\" $FreeBSD$ .\" .Dd March 19, 1994 .Dt MAKE 1 .Os .Sh 名称 .Nm make .Nd プログラムの依存関係をメンテナンスする .Sh 書式 .Nm .Op Fl BPSXeiknqrstv .Op Fl D Ar variable .Op Fl d Ar flags .Op Fl E Ar variable .Op Fl f Ar makefile .Op Fl I Ar directory .Bk -words .Op Fl j Ar max_jobs .Op Fl m Ar directory .Ek .Op Fl V Ar variable .Op Ar variable Ns No = Ns Ar value .Op Ar target ... .Sh 解説 .Nm は、プログラムのメンテナンスを単純化するためのツールです。 その入力はファイルの生成とプログラムとの間の依存関係を指定する リストが記述されています。 カレントディレクトリまたは特別なオブジェクトディレクトリ .Ql Va (.OBJDIR 参照) のどちらか一方において .Ql Pa makefile と .Ql Pa Makefile の最初に見つかった方から、この指定のリストが読み込まれます。 .Ql Pa .depend というファイルが見つかれば、それも読み込みます .Pq Xr mkdep 1 を参照 。 .Pp 本マニュアルはリファレンスのためのみのドキュメントです。 .Nm と makefile に関する詳しい紹介は .%T "Make \- A Tutorial" を参照してください。 .Pp オプションは以下のとおりです。 .Bl -tag -width Ds .It Fl B シーケンス中の依存行のソースを作成するために、各コマンドに対して 1 つのシェルを実行する、バックワード互換モードで実行しようとします。 このオプションは .Fl j が使用されない限り、デフォルトで有効になります。 .It Fl D Ar variable 大域変数 .Ar variable を 1 と定義します。 .It Fl d Ar flags デバッグモードを有効にし、 .Nm が表示するデバッグ情報の種類を指定します。 引数 .Ar flags には、以下のうち 1 つ以上を指定できます。 .Bl -tag -width Ds .It Ar A すべてのデバッグ情報を出力します。他のフラグをすべて指定したことと 等価です。 .It Ar a アーカイブ検索とキャッシュに関する情報を表示します。 .It Ar c 条件評価に関する情報を表示します。 .It Ar d ディレクトリ検索とキャッシュに関する情報を表示します。 .It Ar f for ループの実行に関するデバッグ情報を表示します。 今のところは何もしていません。 .It Ar "g1" 処理を行う前に、入力のグラフを表示します。 .It Ar "g2" すべての処理を行ったあと、あるいはエラーにより終了する前に入力のグラフを 表示します。 .It Ar j 複数のシェルを起動する場合の情報を表示します。 .It Ar l @ がコマンドに前置されていようといまいと、 また他の「静寂」フラグの有無に関わらず、Makefile のコマンドを表示します。 これは「やかましい」動作としても知られています。 .It Ar m ターゲットの作成と変更日付に関する情報を表示します。 .It Ar s 拡張子解釈に関する情報を表示します。 .It Ar t ターゲットリストのメンテナンスに関する情報を表示します。 .It Ar v 変数の値に関する情報を表示します。 .El .It Fl E Ar variable (存在すれば) 環境の値で上書きする、makefile の中の変数を指定します。 .It Fl e 環境の値で makefile 中のすべての変数の値を上書きするように指示します。 .It Fl f Ar makefile デフォルトの .Ql Pa makefile と .Ql Pa Makefile のかわりに、読み込むファイルを指定します。もし .Ar makefile が .Ql \- なら標準入力から読み込みます。複数のファイルが指定可能で、 指定した順に読み込まれます。 .It Fl I Ar directory makefile と、インクルードされる makefile を検索するためのディレクトリを 指定します。システムで定義してある makefile のあるディレクトリ (または、 複数のディレクトリ; .Fl m オプションを参照) は自動的にリストに含まれ、検索されます。 .It Fl i makefile から実行されたシェルコマンドが 0 でない終了ステータスを返し ても無視します。makefile 中でコマンドの先頭に .Ql \- を指定するのと同じです。 .It Fl j Ar max_jobs .Nm が同時に起動できるジョブの数を指定します。 .Ar B フラグを指定しなければ、互換性モードはオフになります。 .It Fl k エラーが発生しても処理を続行します。ただし、発生したエラーによって作成 が不能になったターゲットに依存したターゲットに関しては処理が中断されます。 .It Fl m Ar directory <...> 形式で読み込まれる sys.mk や makefile を検索するための ディレクトリを指定します。複数のディレクトリを検索パスに加えることが できます。このパスは、デフォルトのシステムインクルードパス .Pa /usr/share/mk を上書きします。 さらに、システムインクルードパスを "..." 形式のインクルードによって 追加することができます( .Fl I オプションを参照)。 .It Fl n make が実行するであろうコマンド内容の表示のみを行い、実行はしません。 .It Fl P 並行して動作するジョブを一緒に混ぜて出力するのでなく、 与えられたジョブの順番をそろえて、ジョブが終了するまで表示しません。 このオプションは .Fl j が使われた時のみ効果を持ちます。 .It Fl q いっさいのコマンドを実行せず、指定されたターゲットが最新のものであれば 0 を、そうでなければ 1 を終了ステータスとして返します。 .It Fl r システムの makefile で定義された組み込みのルールを使用しません。 .It Fl S エラーが起きた時に処理を中止します。 デフォルトの動作です。このオプションは 再帰的な構築の際に .Fl k オプションを打ち消すのに必要となります。 .It Fl s 実行するコマンドを表示しません。makefile のなかで、コマンドの先頭に .Ql Ic @ を指定するのと同じです。 .It Fl t makefile で指定されたターゲットを作り直すのではなく、ターゲットを作成 するか、あるいは最終更新日付を現在の時刻に設定することにより、 ターゲットが最新であるかのようにします。 .It Fl V Ar variable グローバルな文脈での .Nm の .Ar variable の値を表示します。如何なるターゲットも生成しません。 このオプションで複数のインスタンスを指定することができます。 変数は、各行毎に表示されます。未定義もしくは空の変数は、空行で 表現されます。 .It Fl v 特に冗長表示させます。 複数ジョブの make においては、ファイルバナーを生成させます。 .It Fl X .Fl V オプションを使用して変数の値を表示するときに、再帰的な値の展開をしません。 .It Ar variable Ns No = Ns Ar value 変数 .Ar variable の値を .Ar value に設定します。 .El .Pp makefile には 7 種類の行があります: 依存関係記述、シェルコマンド、変数 代入、インクルード文、条件命令、for ループ、コメントです。 .Pp 一般に、行は行末にバックスラッシュ .Pq Ql \e を置くことにより次行へ継続させることがで きます。この場合、バックスラッシュ直後の改行と、次の行の先頭の 空白部分は 1 つの空白に置き換えられます。 .Sh ファイル依存関係記述 入力ファイルにおける依存関係記述行は、1 つ以上のターゲット、オペレータ、 0 個 以上のソースからなります。 これは、ターゲットがソースに .Dq 依存 しているという関係を 定義しており、通常は、ソースからターゲットが作成されます。ターゲットと ソースとの厳密な関係はオペレータによって、両者間に指定します。 オペレータには以下の種類があります。 .Bl -tag -width flag .It Ic \&: ターゲットの最終更新日付が、いずれかのソースの最終更新日付よりも 古いものであれば、ターゲットは古いものであり、作り直されるべきものと 判断されます。 別の行でこのオペレータによる同じターゲットに関するソースの記述があれば、 それらはすべて 1 つにまとめられます。ターゲットの作成中に .Nm が中断されると、ターゲットは削除されます。 .It Ic \&! ターゲットはつねに作り直されます。ただし、作り直されるのは、 すべてのソースが検査され、必要と判断されたソースが作り直されたあとです。 このオペレータによる同じターゲットに関するソースの記述が別の行にもあれば、 それらはすべて 1 つにまとめられます。ターゲットの作成中に .Nm が中断されると、ターゲットは削除されます。 .It Ic \&:: ソースが指定されていなかった場合、つねにターゲットは作り直されます。 指定されていた場合にはソースのいずれかがターゲットよりも新しい時だけ ターゲットは作り直されます。本オペレータでは、別の行において同じ ターゲットに関するソースの記述があっても 1 つにまとめません。 ターゲットの作成中に .Nm が中断されても、ターゲットは削除されません。 .El .Pp ターゲットとソースは、シェルのワイルドカード表記として .Ql \&? , .Ql * , .Ql [] , .Ql {} を含むことができます。 .Ql \&? , .Ql * , .Ql [] の表記は、ターゲットまたはソースの最後の要素として記述でき、 存在するファイルを指定するものでなければなりません。 表記 .Ql {} はファイルが存在しなくてもかまいません。シェルのように辞書順に並べられて 展開されることはなく、ファイルシステム上に並んでいる順番のまま行われます。 .Sh シェルコマンド ターゲットは、シェルコマンドの列と関連付けることができ、通常はそれによって ターゲットを作成します。 これに含まれる各コマンドは、 .Em 必ず 行頭のタブに続けて記述します。同一のターゲットに 対して複数の依存記述行がある場合、 .Ql Ic :: オペレータを使用したのでなければ、それらのうちの 1 つにのみコマンド行を 続けることができます。 .Pp コマンドラインの先頭もしくは先頭 2 文字が .Ql Ic @ や .Ql Ic \- ならば、コマンドは特別な扱いを受けます。 .Ql Ic @ は、コマンドが実行前に、コマンド内容の表示を抑制します。 .Ql Ic \- は、コマンドの 0 ではない終了ステータスを無視するように指示します。 .Sh 変数代入 .Nm で使われる変数はシェルでの変数に類似しています。そして、歴史的な経緯から、 すべて大文字からなる名前が用いられます。変数代入には以下の 5 通りの オペレータを使用できます。 .Bl -tag -width Ds .It Ic \&= 変数に値を代入します。その時点までの値は失われます。 .It Ic \&+= 現在の変数の値に、右辺の値を追加します。 .It Ic \&?= 変数が未定義の場合のみ、値を代入します .It Ic \&:= 右辺を展開した値を代入します。つまり、変数に代入する前に値の展開を行います。 通常、値の展開は代入時には行われず、変数が参照されるときに行われます。 .It Ic \&!= 右辺を展開した値をシェルに実行させ、実行結果を左辺の変数に代入します。 結果のなかに含まれる改行は空白に置き換えられます。 .El .Pp いずれの場合も、値の前にある空白は無視されます。値が追加される場合、 変数の直前の値と追加する値との間に空白が挿入されます。 .Pp 変数は、ドル記号 .Pq Ql $ に続いて中括弧 .Pq Ql {} または小括弧 .Pq Ql () で囲まれた変数名を置くことにより展開されます。もし変数名が 1 文字な ら、変数名を囲む括弧は省略できますが、このような省略形は推奨できません。 .Pp 変数置換は、変数が用いられている場所により、 2 つの別々のタイミングで 行われます。依存関係記述行で用いられた変数は、その行が読み込まれたときに 展開されます。シェルコマンド内で用いられた変数は、シェルコマンド実行時に 展開されます。 .Pp 変数には、優先度に従って、4 つの異なるクラスがあります: .Bl -tag -width Ds .It 環境変数 .Nm の環境中で有効な変数 .It グローバル変数 makefile とインクルードされた makefile 内で有効な変数。 .It コマンドライン変数 コマンドラインで指定された変数。 .It ローカル変数 あるターゲットのみに対して定義される変数。ローカル変数には、 以下の 7 種類があります: .Bl -tag -width ".ARCHIVE" .It Va .ALLSRC このターゲットに対するすべてのソースのリスト。 .Ql Va \&> も同じです。 .It Va .ARCHIVE アーカイブファイル名。 .Ql Va \&! も同じです。 .It Va .IMPSRC ターゲット名に変換するのに使用するソースのファイル名またはパス名 ( .Dq 暗黙の ソース)。 .Ql Va \&< も同じです。 .It Va .MEMBER アーカイブのメンバ。 .Ql Va \&% も同じです。 .It Va .OODATE ターゲットよりも新しいソースのリスト。 .Ql Va \&? も同じです。 .It Va .PREFIX ターゲットのディレクトリ名と拡張子を取り除いた名前。 .Ql Va * も同じです。 .It Va .TARGET ターゲットの名前。 .Ql Va @ も同じです。 .El .Pp 短い形式 .Ql Va @ , .Ql Va \&! , .Ql Va \&< , .Ql Va \&% , .Ql Va ? , .Ql Va \&> , .Ql Va * は互換性のためのものですが、利用することは推奨できません。 また、 .Ql Va "@F" , .Ql Va "@D" , .Ql Va " .It Ic \&.include Ar \*qfile\*q 指定した makefile をインクルードします。 アングルブラケットが使用された場合は、 makefile はシステムの makefile ディレクトリにあるものを用います。 ダブルクォートが使用された場合は、 makefile が存在するディレクトリ、 .Fl I オプションで指定されたディレクトリ、システムの makefile ディレクトリの 順に検索します。 .It Ic \&.undef Ar variable 指定したグローバル変数を未定義とします。 グローバル変数のみ、未定義とすることができます。 .It Ic \&.error Ar message makefile の処理を即座に終了します。 makefile のファイル名と、どの行でエラーとなったかと、 指定したエラーメッセージとを、標準出力に表示し、 .Nm は終了コード 1 で終了します。 .El .Pp 条件文は Makefile のどの部分を処理するのかを判定するために使用します。 C プリプロセッサがサポートする条件文と同様に使用されます。 以下の条件文がサポートされています: .Bl -tag -width Ds .It Xo .Ic \&.if .Oo \&! Oc Ns Ar expression .Op Ar operator expression ... .Xc 式の値をテストします。 .It Xo .Ic .ifdef .Oo \&! Oc Ns Ar variable .Op Ar operator variable ... .Xc 変数の値をテストします。 .It Xo .Ic .ifndef .Oo \&! Oc Ns Ar variable .Op Ar operator variable ... .Xc 変数の値をテストします。 .It Xo .Ic .ifmake .Oo \&! Oc Ns Ar target .Op Ar operator target ... .Xc ターゲット .Ar target が作成中かどうかをテストします。 .It Xo .Ic .ifnmake .Oo \&! Oc Ns Ar target .Op Ar operator target ... .Xc ターゲット .Ar target が作成中かどうかをテストします。 .It Ic .else 最後に行った条件文の意味を逆にします。 .It Xo .Ic .elif .Oo \&! Oc Ns Ar expression .Op Ar operator expression ... .Xc .Ql Ic .else と直後の .Ql Ic .if を対にしたものです。 .It Xo .Ic .elifdef .Oo \&! Oc Ns Ar variable .Op Ar operator variable ... .Xc .Ql Ic .else と直後の .Ql Ic .ifdef を対にしたものです。 .It Xo .Ic .elifndef .Oo \&! Oc Ns Ar variable .Op Ar operator variable ... .Xc .Ql Ic .else と直後の .Ql Ic .ifndef を対にしたものです。 .It Xo .Ic .elifmake .Oo \&! Oc Ns Ar target .Op Ar operator target ... .Xc .Ql Ic .else と直後の .Ql Ic .ifmake を対にしたものです。 .It Xo .Ic .elifnmake .Oo \&! Oc Ns Ar target .Op Ar operator target ... .Xc .Ql Ic .else と直後の .Ql Ic .ifnmake を対にしたものです。 .It Ic .endif 条件文の本体を終了させます。 .El .Pp オペレータ .Ar operator は、以下のうちのいずれかです。 .Bl -tag -width "Cm XX" .It Cm \&|\&| 論理 OR。 .It Cm \&&& 論理 AND。 .Ql Ic || より優先順位が上です。 .El .Pp C 言語と同様、 .Nm は条件式を、式の値を決定するのに必要なところまでしか評価しません。 評価順序を変更するには括弧を使います。論理オペレータ .Ql Ic !\& は条件式全体の値を反転するのに使用します。 .Ql Ic !\& は .Ql Ic \&&& より優先順位が上です。 .Pp 式 .Ar expression は、以下のいずれかの形式です: .Bl -tag -width Ic .It Ic defined 引数として変数名をとり、変数が定義されていれば真となる。 .It Ic make 引数としてターゲット名をとり、そのターゲットが .Nm のコマンドライン引数に指定されているか、デフォルトのターゲット .Pq 明示的なものも暗黙的なものも含む。 Va .MAIN の項を参照 として宣言されている場合に真となる。 .It Ic empty 引数として変数名 .Pq と修飾子 をとり、展開した結果が空文字列ならば真となる。 .It Ic exists 引数としてファイル名をとり、ファイルが存在すれば真となる。 ファイルはシステム検索パス .Pq Va .PATH の項を参照 にそって検索される。 .It Ic target 引数としてターゲット名をとり、ターゲットが定義されているなら真となる。 .El .Pp 条件式 .Ar expression としては、数値あるいは文字列の比較を用いることもできます。比較オペレータの 両辺は、変数展開が適用されたあとに比較されます。値が 0x で始まるなら 16 進数 であると解釈し、さもなければ 10 進数と解釈します。8 進数はサポートして いません。標準的な C 言語の関係オペレータは全て利用可能です。 変数展開後、 .Ql Ic == または .Ql Ic "!=" の左辺値または右辺値のいずれかが数値とは認められない場合、文字列として 比較を行います。関係オペレータが指定されなかった場合、展開された変数と 0 とを 比較します。 .Pp 条件式を評価中に、評価できない単語が出現した場合は、条件式の形式によって、 .Dq make または .Dq defined オペレータを適用します。条件式が .Ql Ic .ifdef または .Ql Ic .ifndef ならば .Dq defined を、条件式が .Ql Ic .ifmake または .Ql Ic .ifnmake ならば .Dq make を、それぞれ適用します。 .Pp 条件式が真と評価されたなら、makefile の解析はそのまま続行されます。 偽と評価されたなら、 .Ql Ic .else または .Ql Ic .endif が見つかるまで makefile の解析をスキップします。 .Pp for ループは、いくつかのルールを一連のファイルに適用するのによく 用いられます。以下がループの形式です: .Pp .Bl -tag -width indent -compact .It Ic .for Ar variable Ic in Ar expression .It .It Ic \&.endfor .El .Pp .Ar expression は評価されたあとに単語に分解され、それぞれを .Ar variable に代入 しながら、 .Ic make-rules 部分を繰り返し展開します。 .Sh コメント コメントはハッシュ記号 .Pq Ql \&# から始まり、シェルコマンド行以外のどこにでも置くことができます。 コメントは改行で終わります。 .Sh 特殊ソース .Bl -tag -width Ic .It Ic .IGNORE 本ターゲットに関連したコマンドでのエラーを無視します。シェルコマンドの 先頭にダッシュ .Ql \- を指定したのと等価です。 .It Ic .MAKE たとえ、 -.Fl n や +.Fl n +や .Fl t オプションが指定されていても、このターゲットに関連したシェルコマンドを 実行します。通常、再帰的な .Nm のために用いられます。 .It Ic .NOTMAIN 通常 .Nm は、最初に発見したターゲットをデフォルトのターゲットとみなします。 .Ic .NOTMAIN が指定されたターゲットはデフォルトのターゲットとはみなされなくなります。 .It Ic .OPTIONAL もし .Ic .OPTIONAL が指定されたターゲットの作り方がわからなくても、エラーとはせず、 そのターゲットは必要ないか、すでに存在しているものとみなします。 .It Ic .PRECIOUS 通常 .Nm が中断されたときは、作成途中のターゲットは削除されます。本ソースを 指定することで、そのターゲットを削除しなくなります。 .It Ic .SILENT 指定されたターゲットに関連づけられたシェルコマンドを実行するときに エコーを行いません。シェルコマンドの先頭に .Ql @ を指定したのと等価です。 .It Ic .USE 指定されたターゲットをマクロ的に扱います。 .Ic .USE をソースに持つターゲット .Pq 以下ではマクロと呼びます が別のターゲットのソースとなった場合、その ターゲットはコマンド、ソース、属性( .Ic .USE は除く) をマクロから受け取ります。もし、すでにターゲットにコマンドが指定されていた 場合は、マクロのコマンドが追加されます。 .It Ic .WAIT 特別な .Ic .WAIT ソースが依存関係行に現れた時には、ソースはその行中でソースが 作成されるまで待ちます。ループは検出されず、ループ形式のターゲットは 単に無視されます。 .El .Sh 特殊ターゲット 特殊ターゲットは、他のターゲットとともに使用してはいけません。すなわち、 依存関係記述行の唯一のターゲットとして指定する必要があります。 .Bl -tag -width Ic .It Ic .BEGIN 本ターゲットに指定されたシェルコマンドは他の処理に先立って実行されます。 .It Ic .DEFAULT これは、作成方法がわからないどんなターゲットにも適用される .Ic .USE ルールのようなものです。シェルスクリプトのみを使用します。 .Ic .DEFAULT に指定されたコマンド中の .Ic .IMPSRC 変数はターゲット自身の名前に置換されます。 .It Ic .END 本ターゲットに指定されたシェルコマンドは、他のすべての処理の終了後に 実行されます。 .It Ic .IGNORE 指定されたソースに .Ic .IGNORE 属性を付与します。もしソースが指定されていなければ、 .Fl i オプションを指定したのと同じ意味になります。 .It Ic .INCLUDES ソースファイル中で include される可能性のあるファイルの拡張子のリスト。 拡張子はあらかじめ .Ic .SUFFIXES で宣言されていなければなりません; このように宣言された拡張子は自身の検索パス( .Ic .PATH 参照) にそれぞれ .Fl I フラグを前に付けた状態で .Va .INCLUDES 特殊変数に設定されます。 .It Ic .INTERRUPT .Nm が中断されたとき、本ターゲットに指定されたコマンドを実行します。 .It Ic .LIBS .Ic .INCLUDES が include ファイルに対して行なうことと同じことを ライブラリに対して行ないます。ただし .Fl L フラグが使われます。 .It Ic .MAIN ターゲットを指定せずに .Nm が起動された場合、本ターゲットを処理します。 .Nm がデフォルトターゲットを選択した際に、 利用者がコマンドラインからデフォルトターゲットを指示できるようにするため、 明示的・暗黙的に関わらず必ず設定されます。 .It Ic .MAKEFLAGS ソースにおいて、 .Nm に指定するフラグを指定します。フラグはシェルでタイプしたのと同様に 渡されますが、 .Fl f オプションは無効になります。 .\" XXX: NOT YET!!!! .\" .It Ic .NOTPARALLEL .\" この名前のターゲットは、並列モードを使わすに実行されます。 .\" ターゲットが指定されていない時には、全てのターゲットが非並列モード .\" で実行されます。 .It Ic .NOTPARALLEL 並列モードを使いません。 .It Ic .NO_PARALLEL 上と同じですが、 pmake の変種のための互換性のためにあります。 .It Ic .ORDER シーケンス中の名前付きターゲットが作成されます。 .\" XXX: NOT YET!!!! .\" .It Ic .PARALLEL .\" 名前付きターゲットが並列モードで実行されます。 .\" ターゲットが指定されない時には、全てのターゲットが並列モードで実行 .\" されます。 .It Ic .PATH カレントディレクトリに発見できなかったときのファイルの検索パスを、 本ターゲットのソースとして指定します。ソースが指定されなかった場合、 以前に設定されていたディレクトリが無効になります。 可能であれば .Ic .PATH を利用する方が、 .Va VPATH 変数を利用するよりも好まれています。 .It Ic .PATH\fIsuffix\fR カレントディレクトリに発見できなかったときの suffix のついたファイルの検索パスをソースとして指定します。 .Nm はファイルが見つからなかった場合に、 デフォルトパスよりも先に、まず suffix の付いた検索パスで探します。 この形式は .Ic .LIBS と .Ic .INCLUDES が動作するために必要です。 .It Ic .PHONY .Ic .PHONY 属性を指定したソースに適用します。この属性を持ったターゲットは いつでも更新されていると考えられます。 .It Ic .PRECIOUS 指定されたソースに .Ic .PRECIOUS 属性を付与します。もし、ソースが指定されなかった場合、 すべてのターゲットに .Ic .PRECIOUS 属性を与えます。 .It Ic .SILENT 指定されたソースに .Ic .SILENT 属性を付与します。もし、ソースが指定されなかった場合、 ファイル中のすべてのコマンドに .Ic .SILENT 属性を与えます。 .It Ic .SUFFIXES ソースにおいて、 .Nm で用いる拡張子を指定します。ソースが指定されなかった場合は、 以前の指定が無効になります。 .El .Sh 互換性 .Nm の古いバージョンは .Ev MAKEFLAGS の代わりに .Ev MAKE を使っていました。 この機能は POSIX への互換性のために削除されました。 内部変数 .Va MAKE は .Va .MAKE と同じ値が代入されます ; この機能は将来削除されるかもしれません。 .Pp .Nm のたくさんの秘密にされいている機能の多くは、 より多くの互換性を保つために使用を避けるべきです。 .Sh 環境変数 .Nm は次の環境変数の値を用います: .Ev MACHINE , .Ev MAKE , .Ev MAKEFLAGS , .Ev MAKEOBJDIR , .Ev MAKEOBJDIRPREFIX , .Ev PWD .Sh 関連ファイル .Bl -tag -width /usr/share/doc/psd/12.make -compact .It Pa .depend 依存関係リスト .It Pa Makefile 依存関係リスト .It Pa makefile 依存関係リスト .It obj オブジェクトディレクトリ .It Pa sys.mk システム定義の makefile (他のすべてのファイルよりも前に処理されます。これには .Pa makefile と .Pa Makefile も含まれます) .It Pa /usr/share/mk システム定義の makefile が置かれるディレクトリ .It /usr/share/doc/psd/12.make PMake のチュートリアル .It Pa /usr/obj デフォルトの .Ev MAKEOBJDIRPREFIX ディレクトリ .El .Sh バグ .Va .OBJDIR の決定は不条理といっていいほどまで曲解されます。 .Pp 複数の .Ic .MAIN 特殊ターゲットが存在した場合、 .Nm は最初のもの以外は黙って無視します。 .Pp .Nm がターゲット名なしに起動された場合と .Ic .MAIN 特殊ターゲットが存在しなかった場合、 .Va .TARGETS は設定されません。 .Pp テスト時の .Ar expression の評価はあまり気が配られていません。今のところ、 .Ql .if ${VAR} op something という形式でしか動きません。 例えば、テストは .Ql .if ${VAR} = "string" のように書かなければなりません。 他の書き方では動きません。 .Pp for ループはテストされる前に展開されるため、 .Bd -literal \&.for TMACHINE in ${SHARED_ARCHS} \&.if ${TMACHINE} = ${MACHINE} ... \&.endif \&.endfor .Ed のような断片は動きません。他の方法を使って書き直す必要があります。 .Sh 関連項目 .Xr mkdep 1 , .Xr make.conf 5 .Rs .%T "PMake - A Tutorial" .Re .Pa /usr/share/doc/psd/12.make にあります。 .Sh 歴史 .Nm は .At v7 において追加されました。 diff --git a/ja_JP.eucJP/man/man1/objcopy.1 b/ja_JP.eucJP/man/man1/objcopy.1 index a4e92582b7..97ee118d6e 100644 --- a/ja_JP.eucJP/man/man1/objcopy.1 +++ b/ja_JP.eucJP/man/man1/objcopy.1 @@ -1,729 +1,730 @@ .\" Copyright (c) 1991, 93, 94, 95, 96, 97, 98, 99, 2000 Free Software Foundation .\" See section COPYING for conditions for redistribution .\" .\" Copyright (c) 2001 FreeBSD jpman project .\" This is for Japanese translation done by FreeBSD jpman project. .\" %FreeBSD: src/contrib/binutils/binutils/objcopy.1,v 1.2.6.3 2001/08/01 23:02:44 obrien Exp % -.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/objcopy.1,v 1.6 2001/07/29 05:14:51 horikawa Exp $ +.\" $FreeBSD$ .TH objcopy 1 "05 April 2000" "Free Software Foundation" "GNU Development Tools" .de BP .sp .ti \-.2i \(** .. .SH 名称 objcopy \- オブジェクトファイルのコピーと変換 .SH 書式 .hy 0 .na .TP .B objcopy .RB "[\|" \-F\ \fIbfdname\fR\ |\ \fB\-\-target=\fIbfdname\fR "\|]" .RB "[\|" \-I\ \fIbfdname\fR\ |\ \fB\-\-input\-target=\fIbfdname\fR "\|]" .RB "[\|" \-O\ \fIbfdname\fR\ |\ \fB\-\-output\-target=\fIbfdname\fR "\|]" .RB "[\|" \-j\ \fIsectionname\fR\ |\ \fB\-\-only\-section=\fIsectionname\fR "\|]" .RB "[\|" \-R\ \fIsectionname\fR\ |\ \fB\-\-remove\-section=\fIsectionname\fR "\|]" .RB "[\|" \-S\fR\ |\ \fB\-\-strip\-all\fR "\|]" .RB "[\|" \-g\fR\ |\ \fB\-\-strip\-debug\fR "\|]" .RB "[\|" \-\-strip\-unneeded\fR "\|]" .RB "[\|" \-K\ \fIsymbolname\fR\ |\ \fB\-\-keep\-symbol=\fIsymbolname\fR "\|]" .RB "[\|" \-N\ \fIsymbolname\fR\ |\ \fB\-\-strip\-symbol=\fIsymbolname\fR "\|]" .RB "[\|" \-L\ \fIsymbolname\fR\ |\ \fB\-\-localize\-symbol=\fIsymbolname\fR "\|]" .RB "[\|" \-W\ \fIsymbolname\fR\ |\ \fB\-\-weaken\-symbol=\fIsymbolname\fR "\|]" .RB "[\|" \-x\fR\ |\ \fB\-\-discard\-all\fR "\|]" .RB "[\|" \-X\fR\ |\ \fB\-\-discard\-locals\fR "\|]" .RB "[\|" \-b\ \fIbyte\fR\ |\ \fB\-\-byte=\fIbyte\fR "\|]" .RB "[\|" \-i\ \fIinterleave\fR\ |\ \fB\-\-interleave=\fIinterleave\fR "\|]" .RB "[\|" \-p\fR\ |\ \fB\-\-preserve\-dates\fR "\|]" .RB "[\|" \-\-debugging "\|]" .RB "[\|" \-\-gap\-fill=\fIval\fR "\|]" .RB "[\|" \-\-pad\-to=\fIaddress\fR "\|]" .RB "[\|" \-\-set\-start=\fIval\fR "\|]" .RB "[\|" \-\-change\-start=\fIincr\fR "\|]" .RB "[\|" \-\-change\-addresses=\fIincr\fR "\|]" .RB "[\|" \-\-change\-section\-address\ \fIsection{=,+,-}val\fR "\|]" .RB "[\|" \-\-change\-section\-lma\ \fIsection{=,+,-}val\fR "\|]" .RB "[\|" \-\-change\-section\-vma\ \fIsection{=,+,-}val\fR "\|]" .RB "[\|" \-\-change\-warnings\fR "\|]" .RB "[\|" \-\-no\-change\-warnings\fR "\|]" .RB "[\|" \-\-set\-section\-flags\ \fIsection=flags\fR "\|]" .RB "[\|" \-\-add\-section\ \fIsectionname=filename\fR "\|]" .RB "[\|" \-\-change\-leading\-char\fR "\|]" .RB "[\|" \-\-remove\-leading\-char\fR "\|]" .RB "[\|" \-\-srec\-len=\fIval\fR "\|]" .RB "[\|" \-\-srec\-forceS3\fR "\|]" .RB "[\|" \-\-redefine\-sym\ \fIold=new\fR "\|]" .RB "[\|" \-\-weaken\fR "\|]" .RB "[\|" \-v\ |\ \-\-verbose\fR "\|]" .RB "[\|" \-V\ |\ \-\-version\fR "\|]" .RB "[\|" \-\-help\fR "\|]" .B infile .RB "[\|" outfile\fR "\|]" .SH 解説 GNU .B objcopy ユーティリティはあるオブジェクトファイルの内容を他へコピーします。 .B objcopy はオブジェクトファイルの読み書きに GNU BFD ライブラリを使います。 元のオブジェクトファイルと異なるフォーマットでコピー先の オブジェクトファイルに書き込む事が可能です。 .B objcopy の厳密な挙動はコマンドラインの引数で制御します。 .PP .B objcopy は変換のために一時ファイルを作成して後でそれらを削除します。 .B objcopy はすべての変換作業で BFD を使います; つまり BFD が知っている フォーマットはすべて知っている事になるので、明示的に指定しなくても 大部分のフォーマットを認識する事が出来ます。 .PP .B objcopy で出力先に .B srec を指定する (例えば .B -O srec を使う) ことで Sレコードを生成できます。 .PP .B objcopy で出力先に .B binary を指定する (例えば .B -O binary を使う) ことで生のバイナリファイルを生成できます。 .B objcopy で生のバイナリファイルを生成することは、本質的には入力の オブジェクトファイルの内容のメモリダンプを生成することに なるでしょう。シンボルと 再配置情報はすべて捨て去られます。メモリダンプは出力ファイルに コピーされる中で最も低位のセクションの仮想アドレスから始まります。 .PP Sレコードや生のバイナリファイルを生成する場合は、 .B -S を使ってデバッグ情報を含むセクションを削除するのが良いかもしれません。 場合によっては .B -R が、バイナリファイルに必要無い情報を含むセクションを削除するのに有用でしょう。 .PP .I infile と .I outfile は それぞれ入力と出力ファイルです。 .IR outfile を指定しないと、 .B objcopy は一時ファイルを作成してから そのファイル名を入力ファイル名に付けかえて しまいます。 .SH オプション .TP .B \-I \fIbfdname\fR, \fB\-\-input\-target=\fIbfdname 入力ファイルのオブジェクト形式を推測しようとするかわりに .IR bfdname であるとして扱います。 .TP .B \-O \fIbfdname\fR, \fB\-\-output\-target=\fIbfdname オブジェクト形式として .IR bfdname を使って出力ファイルに書き込みます。 .TP .B \-F \fIbfdname\fR, \fB\-\-target=\fIbfdname 入出力両方のオブジェクト形式が .I bfdname であるとします; つまり、入力から出力へ無変換でデータを 単純に転送するということです。 .TP .B \-j \fIsectionname\fR, \fB\-\-only\-section=\fIsectionname 指定したセクションのみ入力ファイルから出力ファイルへコピーし、 他のすべてのセクションを捨てます。 このオプションは 2 回以上指定できます。このオプションを不適切に使うと出力ファイルが -利用できない物になるので注意して下さい。.TP +利用できない物になるので注意して下さい。 +.TP .B \-R \fIsectionname\fR, \fB\-\-remove-section=\fIsectionname 指定されたセクションをファイルから取り除きます。このオプションは 2 回以上指定できます。このオプションを不適切に使うと出力ファイルが 利用できない物になるので注意して下さい。 .TP .B \-S\fR, \fB\-\-strip\-all 再配置とシンボルの情報を入力ファイルからコピーしません。 .TP .B \-g\fR, \fB\-\-strip\-debug デバッグシンボルを入力ファイルからコピーしません。 .TP .B \-\-strip\-unneeded 再配置処理に不要なシンボルをすべて取り除きます。 .TP .B \-K \fIsymbolname\fR, \fB\-\-keep\-symbol=\fIsymbolname 入力ファイルからシンボル \fIsymbolname\fP だけをコピーします。 このオプションは 2 回以上指定できます。 .TP .B \-N \fIsymbolname\fR, \fB\-\-strip\-symbol=\fIsymbolname 入力ファイルからシンボル \fIsymbolname\fP をコピーしません。 このオプションは 2 回以上指定できます。 .TP .B \-L \fIsymbolname\fR, \fB\-\-localize\-symbol=\fIsymbolname シンボル \fIsymbolname\fP を、外部から参照できないようにファイル内 ローカルにします。このオプションは 2 回以上指定できます。 .TP .B \-W \fIsymbolname\fR, \fB\-\-weaken\-symbol=\fIsymbolname シンボル \fIsymbolname\fP を weak にします。 このオプションは 2 回以上指定できます。 .TP .B \-x\fR, \fB\-\-discard\-all 入力ファイルからグローバルでないシンボルをコピーしません。 .TP .B \-X\fR, \fB\-\-discard\-locals コンパイラが生成したローカルシンボルをコピーしません。 (それらは通常 "L" か "." で始まります。) .TP .B \-b \fIbyte\fR, \fB\-\-byte=\fIbyte 入力ファイルの各 \fIbyte\fP番めのバイトのみを取り出します (ヘッダデータには影響しません)。\fIbyte\fP には 0 から interleave-1 の範囲の値を指定できます。 このオプションは ROM に書き込むためのファイルを作成するために有用です。 典型的には srec の出力指定と共に使います。 .TP .B \-i \fIinterleave\fR, \fB\-\-interleave=\fIinterleave 各 \fIinterleave\fPバイト毎に 1バイトだけをコピーします。 どれをコピーするかは \fB\-b\fP か \fB\-\-byte\fP オプションで 選びます。デフォルトは 4です。 interleave は \fB\-b\fP か \fB\-\-byte\fP のどちらも指定されていない 場合は無視されます。 .TP .B \-p\fR, \fB\-\-preserve\-dates 出力ファイルのアクセス時刻と更新時刻を入力ファイルに合わせます。 .TP .B \-\-debugging 可能であればデバッグ情報を変換します。 特定のデバッグ情報しかサポートしておらず、変換処理は時間を 要する可能性があるので、これはデフォルトではありません。 .TP .B \-\-gap\-fill=\fIval セクション間のすきまを \fIval\fP で埋めます。 この操作はセクションの \fIload address\fP (LMA) に適用されます。 低位アドレスのセクションのサイズを増やし、できた余分の空間を \fIval\fP で 埋める事で実現しています。 .TP .B \-\-pad\-to=\fIaddress ロードアドレス \fIaddress\fP まで出力ファイルに詰め物をします。 これは最後のセクションのサイズを増やす事で行われます。 できた余分の空間は \fB\-\-gap\-fill\fP で 指定された値 (デフォルトは 0) で埋められます。 .TP .B \fB\-\-set\-start=\fIval 新しいファイルの開始アドレスを \fIval\fP に設定します。 すべてのオブジェクトファイル形式が開始アドレスの設定をサポートしている わけではありません。 .TP .B \fB\-\-change\-start=\fIincr\fR, \fB\-\-adjust\-start=\fIincr 開始アドレスを、\fIincr\fP を加算する事で変更します。 すべてのオブジェクトファイル形式が開始アドレスの設定をサポートしている わけではありません。 .TP .B \fB\-\-adjust\-vma=\fIincr 開始アドレスおよびすべてのセクションのアドレスを、\fIincr\fP を 加算する事で変更します。いくつかのオブジェクトファイル形式では セクションのアドレスを任意の値に変更する事は許されていません。 これはセクションを再配置するのではない事に注意して下さい; もしプログラムがセクションが特定のアドレスにロードされる事を 期待しており、そしてこのオプションがセクションを異なるアドレスに ロードするように使われた場合は、プログラムは正常に 動作しないかもしれません。 .TP .B \fB\-\-change\-section\-address\ \fIsection{=,+,-}val\fR, \fB\-\-adjust\-section\-vma\ \fIsection{=,+,-}val 指定された \fIsection\fP の VMA および LMA アドレスを、 設定または変更します。\fI=\fP が 指定された場合は、セクションのアドレスは \fIval\fP に設定されます。 そうでなければ \fIval\fP がセクションのアドレスに加算または減算されます。 上の \fB\-\-adjust\-vma\fP に書かれているコメントも参照して下さい。 入力ファイルに \fIsection\fP が存在しない場合は、 \fB\-\-no\-adjust\-warnings\fP が指定されていなければ警告が出力されます。 .TP .B \fB\-\-change\-section\-lma\ \fIsection{=,+,-}val 指定された \fIsection\fP の LMA アドレスを、 設定または変更します。\fI=\fP が 指定された場合は、セクションのアドレスは \fIval\fP に設定されます。 そうでなければ \fIval\fP がセクションのアドレスに加算または減算されます。 上の \fB\-\-adjust\-addresses\fP に書かれているコメントも参照して下さい。 入力ファイルに \fIsection\fP が存在しない場合は、 \fB\-\-no\-change\-warnings\fP が指定されていなければ警告が出力されます。 .B \fB\-\-change\-section\-vma\ \fIsection{=,+,-}val 指定された \fIsection\fP の VMA アドレスを、 設定または変更します。\fI=\fP が 指定された場合は、セクションのアドレスは \fIval\fP に設定されます。 そうでなければ \fIval\fP がセクションのアドレスに加算または減算されます。 上の \fB\-\-adjust\-addresses\fP に書かれているコメントも参照して下さい。 入力ファイルに \fIsection\fP が存在しない場合は、 \fB\-\-no\-change\-warnings\fP が指定されていなければ警告が出力されます。 .TP .B \fB\-\-change\-warnings\fR, \fB\-\-adjust\-warnings \fB\-\-adjust\-section\-XXX\fP が指定され、 指定されたセクションが存在しないと警告が出力されます。 これはデフォルトです。 .TP .B \fB\-\-no\-change\-warnings\fR, \fB\-\-no\-adjust\-warnings \fB\-\-adjust\-section\-XXX\fP が指定されて、指定された セクションが存在しなくても警告を出力しません。 .TP .B \fB\-\-set\-section\-flags\ \fIsection=flags 指定されたセクションのフラグを設定します。引数 \fIflags\fP は フラグ名をコンマで区切った文字列です。認識するフラグ名は -+\fIalloc\fP, \fIcontents\fP, \fIload\fP, \fInoload\fP, \fIreadonly\fP, -+\fIcode\fP, \fIdata\fP, \fIrom\fP, \fIshare\fP, \fIdebug\fP +\fIalloc\fP, \fIcontents\fP, \fIload\fP, \fInoload\fP, \fIreadonly\fP, +\fIcode\fP, \fIdata\fP, \fIrom\fP, \fIshare\fP, \fIdebug\fP です。すべてのフラグがすべてのオブジェクトファイル形式で 意味を持つとは限りません。 .TP .B \fB\-\-add\-section\ \fIsectionname=filename \fIsectionname\fR で指定された名前の新しいセクションをファイルの コピー中に付け加えます。新しいセクションの内容はファイル \fIfilename\fR から取り込まれます。セクションのサイズはファイルの サイズになります。このオプションは任意の名前を持つセクションを サポートできるファイル形式でのみ機能します。 .TP .B \-\-change\-leading\-char いくつかのオブジェクトファイル形式でシンボルの最初に特殊文字が 使われています。もっとも一般的なのはアンダスコアで、しばしば コンパイラが各シンボルの前に付け加えます。 このオプションは .B objcopy に、オブジェクトファイル形式を変換する時に各シンボルの始まりの 文字を変更するよう指示します。 変換前後のオブジェクトファイル形式がシンボルの始まりに同じ文字を 使っている場合は、このオプションは何もしません。そうでなければ、 このオプションで文字を付け加える、または文字を削除する、または 文字を変更する事が、適切に行われます。 .TP .B \-\-remove\-leading\-char グローバルシンボルの最初の文字が、オブジェクトファイル形式で使われる シンボルの最初に付加される特殊文字だった場合は、その文字を取り除きます。 シンボルに前置される最も一般的な文字はアンダスコアです。 このオプションは前置されているアンダスコアをすべての グローバルシンボルから取り除きます。これはシンボル名の取り決めが 異なるファイル形式のファイルを一緒にリンクしたい場合に有用です。 これは \fB\-\-change\-leading\-char\fP とは異なります。 なぜならこのオプションでは適切であれば、 出力のオブジェクトファイル形式とは関係なく 常にシンボル名を変更してしまうからです。 .TP .B \fB\-\-srec\-len=\fIval srec 出力でのみ意味があります。 S レコードの長さを \fIval\fP に設定します。 この長さには、アドレス、データ、CRC フィールドも含まれます。 .TP .B \fB\-\-srec\-forceS3 srec 出力でのみ意味があります。 S1/S2 レコードの生成を防ぎ、S3 レコードのみの書式にします。 .TP .B \-\-redefine\-sym\ \fIold=new シンボルの名前を \fIold\fR から \fInew\fR へ変更します。 ソースが無い 2 つのものリンクしようとしていて、 名前の衝突があるときに有用でしょう。 .TP .B \-\-weaken ファイルのすべてのグローバルシンボルを weak に変更します。 .TP .B \-v\fR, \fB\-\-verbose 出力を冗長にします: 変更されたすべてのオブジェクトファイルをリストします。 アーカイブの場合は "\fBobjcopy \-V\fR" でアーカイブのメンバがすべて リストされます。 .TP .B \-V\fR, \fB\-\-version .B objcopy のバージョン番号を表示して終了します。 .TP .B \-\-help .B objcopy のオプションのサマリを表示して終了します。 .SH "関連項目" .B info\c \& の .RB "`\|" binutils "\|'" の項; .I The GNU Binary Utilities\c \&, Roland H. Pesch (June 1993) .SH COPYING This document is distributed under the terms of the GNU Free Documentation License, version 1.1. That license is described in the sources for this manual page, but it is not displayed here in order to make this manual more consise. Copies of this license can also be obtained from: http://www.gnu.org/copyleft/. \" .SH GNU Free Documentation License \" Version 1.1, March 2000 \" Copyright (C) 2000 Free Software Foundation, Inc. \" 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA \" Everyone is permitted to copy and distribute verbatim \" copies of this license document, but changing it is \" not allowed. \" .PP \" 0. PREAMBLE \" .PP \" The purpose of this License is to make a manual, textbook, or other \" written document "free" in the sense of freedom: to assure everyone \" the effective freedom to copy and redistribute it, with or without \" modifying it, either commercially or noncommercially. Secondarily, \" this License preserves for the author and publisher a way to get \" credit for their work, while not being considered responsible for \" modifications made by others. \" .PP \" This License is a kind of "copyleft", which means that derivative \" works of the document must themselves be free in the same sense. It \" complements the GNU General Public License, which is a copyleft \" license designed for free software. \" .PP \" We have designed this License in order to use it for manuals for free \" software, because free software needs free documentation: a free \" program should come with manuals providing the same freedoms that the \" software does. But this License is not limited to software manuals; \" it can be used for any textual work, regardless of subject matter or \" whether it is published as a printed book. We recommend this License \" principally for works whose purpose is instruction or reference. \" .PP \" 1. APPLICABILITY AND DEFINITIONS \" .PP \" This License applies to any manual or other work that contains a \" notice placed by the copyright holder saying it can be distributed \" under the terms of this License. The "Document", below, refers to any \" such manual or work. Any member of the public is a licensee, and is \" addressed as "you". \" .PP \" A "Modified Version" of the Document means any work containing the \" Document or a portion of it, either copied verbatim, or with \" modifications and/or translated into another language. \" .PP \" A "Secondary Section" is a named appendix or a front-matter section of \" the Document that deals exclusively with the relationship of the \" publishers or authors of the Document to the Document's overall subject \" (or to related matters) and contains nothing that could fall directly \" within that overall subject. (For example, if the Document is in part a \" textbook of mathematics, a Secondary Section may not explain any \" mathematics.) The relationship could be a matter of historical \" connection with the subject or with related matters, or of legal, \" commercial, philosophical, ethical or political position regarding \" them. \" .PP \" The "Invariant Sections" are certain Secondary Sections whose titles \" are designated, as being those of Invariant Sections, in the notice \" that says that the Document is released under this License. \" .PP \" The "Cover Texts" are certain short passages of text that are listed, \" as Front-Cover Texts or Back-Cover Texts, in the notice that says that \" the Document is released under this License. \" .PP \" A "Transparent" copy of the Document means a machine-readable copy, \" represented in a format whose specification is available to the \" general public, whose contents can be viewed and edited directly and \" straightforwardly with generic text editors or (for images composed of \" pixels) generic paint programs or (for drawings) some widely available \" drawing editor, and that is suitable for input to text formatters or \" for automatic translation to a variety of formats suitable for input \" to text formatters. A copy made in an otherwise Transparent file \" format whose markup has been designed to thwart or discourage \" subsequent modification by readers is not Transparent. A copy that is \" not "Transparent" is called "Opaque". \" .PP \" Examples of suitable formats for Transparent copies include plain \" ASCII without markup, Texinfo input format, LaTeX input format, SGML \" or XML using a publicly available DTD, and standard-conforming simple \" HTML designed for human modification. Opaque formats include \" PostScript, PDF, proprietary formats that can be read and edited only \" by proprietary word processors, SGML or XML for which the DTD and/or \" processing tools are not generally available, and the \" machine-generated HTML produced by some word processors for output \" purposes only. \" .PP \" The "Title Page" means, for a printed book, the title page itself, \" plus such following pages as are needed to hold, legibly, the material \" this License requires to appear in the title page. For works in \" formats which do not have any title page as such, "Title Page" means \" the text near the most prominent appearance of the work's title, \" preceding the beginning of the body of the text. \" .PP \" 2. VERBATIM COPYING \" .PP \" You may copy and distribute the Document in any medium, either \" commercially or noncommercially, provided that this License, the \" copyright notices, and the license notice saying this License applies \" to the Document are reproduced in all copies, and that you add no other \" conditions whatsoever to those of this License. You may not use \" technical measures to obstruct or control the reading or further \" copying of the copies you make or distribute. However, you may accept \" compensation in exchange for copies. If you distribute a large enough \" number of copies you must also follow the conditions in section 3. \" .PP \" You may also lend copies, under the same conditions stated above, and \" you may publicly display copies. \" .PP \" 3. COPYING IN QUANTITY \" .PP \" If you publish printed copies of the Document numbering more than 100, \" and the Document's license notice requires Cover Texts, you must enclose \" the copies in covers that carry, clearly and legibly, all these Cover \" Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on \" the back cover. Both covers must also clearly and legibly identify \" you as the publisher of these copies. The front cover must present \" the full title with all words of the title equally prominent and \" visible. You may add other material on the covers in addition. \" Copying with changes limited to the covers, as long as they preserve \" the title of the Document and satisfy these conditions, can be treated \" as verbatim copying in other respects. \" .PP \" If the required texts for either cover are too voluminous to fit \" legibly, you should put the first ones listed (as many as fit \" reasonably) on the actual cover, and continue the rest onto adjacent \" pages. \" .PP \" If you publish or distribute Opaque copies of the Document numbering \" more than 100, you must either include a machine-readable Transparent \" copy along with each Opaque copy, or state in or with each Opaque copy \" a publicly-accessible computer-network location containing a complete \" Transparent copy of the Document, free of added material, which the \" general network-using public has access to download anonymously at no \" charge using public-standard network protocols. If you use the latter \" option, you must take reasonably prudent steps, when you begin \" distribution of Opaque copies in quantity, to ensure that this \" Transparent copy will remain thus accessible at the stated location \" until at least one year after the last time you distribute an Opaque \" copy (directly or through your agents or retailers) of that edition to \" the public. \" .PP \" It is requested, but not required, that you contact the authors of the \" Document well before redistributing any large number of copies, to give \" them a chance to provide you with an updated version of the Document. \" .PP \" 4. MODIFICATIONS \" .PP \" You may copy and distribute a Modified Version of the Document under \" the conditions of sections 2 and 3 above, provided that you release \" the Modified Version under precisely this License, with the Modified \" Version filling the role of the Document, thus licensing distribution \" and modification of the Modified Version to whoever possesses a copy \" of it. In addition, you must do these things in the Modified Version: \" .PP \" A. Use in the Title Page (and on the covers, if any) a title distinct \" from that of the Document, and from those of previous versions \" (which should, if there were any, be listed in the History section \" of the Document). You may use the same title as a previous version \" if the original publisher of that version gives permission. \" .PP \" B. List on the Title Page, as authors, one or more persons or entities \" responsible for authorship of the modifications in the Modified \" Version, together with at least five of the principal authors of the \" Document (all of its principal authors, if it has less than five). \" .PP \" C. State on the Title page the name of the publisher of the \" Modified Version, as the publisher. \" .PP \" D. Preserve all the copyright notices of the Document. \" .PP \" E. Add an appropriate copyright notice for your modifications \" adjacent to the other copyright notices. \" .PP \" F. Include, immediately after the copyright notices, a license notice \" giving the public permission to use the Modified Version under the \" terms of this License, in the form shown in the Addendum below. \" Preserve in that license notice the full lists of Invariant Sections \" and required Cover Texts given in the Document's license notice. \" .PP \" H. Include an unaltered copy of this License. \" .PP \" I. Preserve the section entitled "History", and its title, and add to \" it an item stating at least the title, year, new authors, and \" publisher of the Modified Version as given on the Title Page. If \" there is no section entitled "History" in the Document, create one \" stating the title, year, authors, and publisher of the Document as \" given on its Title Page, then add an item describing the Modified \" Version as stated in the previous sentence. \" .PP \" J. Preserve the network location, if any, given in the Document for \" public access to a Transparent copy of the Document, and likewise \" the network locations given in the Document for previous versions \" it was based on. These may be placed in the "History" section. \" You may omit a network location for a work that was published at \" least four years before the Document itself, or if the original \" publisher of the version it refers to gives permission. \" .PP \" K. In any section entitled "Acknowledgements" or "Dedications", \" preserve the section's title, and preserve in the section all the \" substance and tone of each of the contributor acknowledgements \" and/or dedications given therein. \" .PP \" L. Preserve all the Invariant Sections of the Document, \" unaltered in their text and in their titles. Section numbers \" or the equivalent are not considered part of the section titles. \" .PP \" M. Delete any section entitled "Endorsements". Such a section \" may not be included in the Modified Version. \" .PP \" N. Do not retitle any existing section as "Endorsements" \" or to conflict in title with any Invariant Section. \" .PP \" If the Modified Version includes new front-matter sections or \" appendices that qualify as Secondary Sections and contain no material \" copied from the Document, you may at your option designate some or all \" of these sections as invariant. To do this, add their titles to the \" list of Invariant Sections in the Modified Version's license notice. \" These titles must be distinct from any other section titles. \" .PP \" You may add a section entitled "Endorsements", provided it contains \" nothing but endorsements of your Modified Version by various \" parties--for example, statements of peer review or that the text has \" been approved by an organization as the authoritative definition of a \" standard. \" .PP \" You may add a passage of up to five words as a Front-Cover Text, and a \" passage of up to 25 words as a Back-Cover Text, to the end of the list \" of Cover Texts in the Modified Version. Only one passage of \" Front-Cover Text and one of Back-Cover Text may be added by (or \" through arrangements made by) any one entity. If the Document already \" includes a cover text for the same cover, previously added by you or \" by arrangement made by the same entity you are acting on behalf of, \" you may not add another; but you may replace the old one, on explicit \" permission from the previous publisher that added the old one. \" .PP \" The author(s) and publisher(s) of the Document do not by this License \" give permission to use their names for publicity for or to assert or \" imply endorsement of any Modified Version. \" .PP \" 5. COMBINING DOCUMENTS \" .PP \" You may combine the Document with other documents released under this \" License, under the terms defined in section 4 above for modified \" versions, provided that you include in the combination all of the \" Invariant Sections of all of the original documents, unmodified, and \" list them all as Invariant Sections of your combined work in its \" license notice. \" .PP \" The combined work need only contain one copy of this License, and \" multiple identical Invariant Sections may be replaced with a single \" copy. If there are multiple Invariant Sections with the same name but \" different contents, make the title of each such section unique by \" adding at the end of it, in parentheses, the name of the original \" author or publisher of that section if known, or else a unique number. \" Make the same adjustment to the section titles in the list of \" Invariant Sections in the license notice of the combined work. \" .PP \" In the combination, you must combine any sections entitled "History" \" in the various original documents, forming one section entitled \" "History"; likewise combine any sections entitled "Acknowledgements", \" and any sections entitled "Dedications". You must delete all sections \" entitled "Endorsements." \" .PP \" 6. COLLECTIONS OF DOCUMENTS \" .PP \" You may make a collection consisting of the Document and other documents \" released under this License, and replace the individual copies of this \" License in the various documents with a single copy that is included in \" the collection, provided that you follow the rules of this License for \" verbatim copying of each of the documents in all other respects. \" .PP \" You may extract a single document from such a collection, and distribute \" it individually under this License, provided you insert a copy of this \" License into the extracted document, and follow this License in all \" other respects regarding verbatim copying of that document. \" .PP \" 7. AGGREGATION WITH INDEPENDENT WORKS \" .PP \" A compilation of the Document or its derivatives with other separate \" and independent documents or works, in or on a volume of a storage or \" distribution medium, does not as a whole count as a Modified Version \" of the Document, provided no compilation copyright is claimed for the \" compilation. Such a compilation is called an "aggregate", and this \" License does not apply to the other self-contained works thus compiled \" with the Document, on account of their being thus compiled, if they \" are not themselves derivative works of the Document. \" .PP \" If the Cover Text requirement of section 3 is applicable to these \" copies of the Document, then if the Document is less than one quarter \" of the entire aggregate, the Document's Cover Texts may be placed on \" covers that surround only the Document within the aggregate. \" Otherwise they must appear on covers around the whole aggregate. \" .PP \" 8. TRANSLATION \" .PP \" Translation is considered a kind of modification, so you may \" distribute translations of the Document under the terms of section 4. \" Replacing Invariant Sections with translations requires special \" permission from their copyright holders, but you may include \" translations of some or all Invariant Sections in addition to the \" original versions of these Invariant Sections. You may include a \" translation of this License provided that you also include the \" original English version of this License. In case of a disagreement \" between the translation and the original English version of this \" License, the original English version will prevail. \" .PP \" 9. TERMINATION \" .PP \" You may not copy, modify, sublicense, or distribute the Document except \" as expressly provided for under this License. Any other attempt to \" copy, modify, sublicense or distribute the Document is void, and will \" automatically terminate your rights under this License. However, \" parties who have received copies, or rights, from you under this \" License will not have their licenses terminated so long as such \" parties remain in full compliance. \" .PP \" 10. FUTURE REVISIONS OF THIS LICENSE \" .PP \" The Free Software Foundation may publish new, revised versions \" of the GNU Free Documentation License from time to time. Such new \" versions will be similar in spirit to the present version, but may \" differ in detail to address new problems or concerns. See \" http://www.gnu.org/copyleft/. \" .PP \" Each version of the License is given a distinguishing version number. \" If the Document specifies that a particular numbered version of this \" License "or any later version" applies to it, you have the option of \" following the terms and conditions either of that specified version or \" of any later version that has been published (not as a draft) by the \" Free Software Foundation. If the Document does not specify a version \" number of this License, you may choose any version ever published (not \" as a draft) by the Free Software Foundation. \" .PP \" ADDENDUM: How to use this License for your documents \" .PP \" To use this License in a document you have written, include a copy of \" the License in the document and put the following copyright and \" license notices just after the title page: \" .PP \" Copyright (c) YEAR YOUR NAME. \" Permission is granted to copy, distribute and/or \" modify this document under the terms of the GNU \" Free Documentation License, Version 1.1 or any later \" version published by the Free Software Foundation; \" with the Invariant Sections being LIST THEIR TITLES, \" with the Front-Cover Texts being LIST, and with the \" Back-Cover Texts being LIST. A copy of the license \" is included in the section entitled "GNU Free \" Documentation License". \" .PP \" If you have no Invariant Sections, write "with no Invariant Sections" \" instead of saying which ones are invariant. If you have no \" Front-Cover Texts, write "no Front-Cover Texts" instead of \" "Front-Cover Texts being LIST"; likewise for Back-Cover Texts. \" .PP \" If your document contains nontrivial examples of program code, we \" recommend releasing these examples in parallel under your choice of \" free software license, such as the GNU General Public License, \" to permit their use in free software. .SH 日本語訳 野首 寛高(hnokubi@yyy.or.jp): FreeBSD 用に翻訳 .\" .SH 履歴 .\" 野首 寛高 1998/10/05 FreeBSD 用に翻訳 .\" 堀川和雄 2001/08/04 binutil 2.11.2 用に修正