.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" 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. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "DH_INSTALL 1" .TH DH_INSTALL 1 "2019-02-23" "12.1.1" "Debhelper" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "名前" .IX Header "名前" dh_install \- パッケージビルドディレクトリにファイルをインストールする .SH "書式" .IX Header "書式" \&\fBdh_install\fR [\fB\-X\fR\fIitem\fR] [\fB\-\-autodest\fR] [\fB\-\-sourcedir=\fR\fIdir\fR] [\fIdebhelper options\fR] [\fIfile|dir\fR ... \fIdestdir\fR] .SH "説明" .IX Header "説明" \&\fBdh_install\fR はパッケージビルドディレクトリにファイルをインストールする debhelper プログラムです。なお、沢山の \&\fBdh_install\fR\fI*\fR コマンドは、文章や例、あるいは man ページ等のファイルの種類に応じたインストールを担います。こちらのコマンドは、特定の処理を行う為に各々専用の処理を持っていますので、可能な限り、これらのファイルをインストールするときには、\fBdh_install\fR\fI*\fR コマンドを使ってください。なお、\fBdh_install\fR は、ファイルにあわせた特別な処理が不要なファイルをインストールする時に使うと良いでしょう。\fBdh_install\fR は、以前存在した \&\fBdh_movefiles\fR コマンドを置き換えるコマンドです。 .PP このプログラムは２つの用途で利用されます。１つ目は、単に１つ２つのファイルについて開発元 (upstream) の Makefile がインストールをしようとしない時、\fBdh_install\fR を使ってこれらのファイルを目的の場所へ移動できます。２つ目としては、複数のバイナリパッケージをビルドするような大きなパッケージの元で利用する場合であり、開発元 (upstream) の Makefile により、\fIdebian/tmp\fR へ一旦インストールしてから、\fBdh_install\fR を使って適切なパッケージビルドディレクトリへディレクトリとファイルをコピーするのに使うというものです。 .PP From debhelper compatibility level 7 on, \fBdh_install\fR will fall back to looking in \fIdebian/tmp\fR for files, if it does not find them in the current directory (or wherever you've told it to look using \fB\-\-sourcedir\fR). .SH "ファイル" .IX Header "ファイル" .IP "debian/\fIpackage\fR.install" 4 .IX Item "debian/package.install" List the files to install into each package and the directory they should be installed to. The format is a set of lines, where each line lists a file or files to install, and at the end of the line tells the directory it should be installed in. The name of the files (or directories) to install should be given relative to the current directory, while the installation directory is given relative to the package build directory. You may use wildcards in the names of the files to install. .Sp 明示的にインストール先を記述せず、ただ１つのファイル名もしくはワイルドカードパターンを指定した行を列挙した場合は、\-\-autodest オプションが使われた時同様に \fBdh_install\fR は自動的に利用されるインストール先を推測します。 .IP "debian/not\-installed" 4 .IX Item "debian/not-installed" Used with the deprecated \fB\-\-list\-missing\fR and \fB\-\-fail\-missing\fR options. Please refer to \fBdh_missing\fR\|(1) for the documentation of this file. .SH "オプション" .IX Header "オプション" .IP "\fB\-\-list\-missing\fR" 4 .IX Item "--list-missing" \&\fBDeprecated\fR: Please use \fBdh_missing \-\-list\-missing\fR instead. If you use this option, \fBdh_install\fR will call \fBdh_missing\fR with that option after it has processed all the files. Please see \fBdh_missing\fR\|(1) for the documentation of this option. .Sp This option is removed in compat 12. .IP "\fB\-\-fail\-missing\fR" 4 .IX Item "--fail-missing" \&\fBDeprecated\fR: Please use \fBdh_missing \-\-fail\-missing\fR instead. If you use this option, \fBdh_install\fR will call \fBdh_missing\fR with that option after it has processed all the files. Please see \fBdh_missing\fR\|(1) for the documentation of this option. .Sp This option is removed in compat 12. .IP "\fB\-\-sourcedir=\fR\fIdir\fR" 4 .IX Item "--sourcedir=dir" インストールするファイルを指定されたディレクトリ内で探します。 .Sp このオプションは、\fBdh_auto_\fR\fI*\fR にあるような \fB\-\-sourcedirectory\fR とは異なる事に注意が必要です。このコマンドではあまりこのオプションは利用する機会がありません。というのも \fBdh_install\fR は互換性レベル v7 以上では自動的に \fIdebian/tmp\fR へファイルを探しに行く為です。 .IP "\fB\-\-autodest\fR" 4 .IX Item "--autodest" Guess as the destination directory to install things to. If this is specified, you should not list destination directories in \&\fIdebian/package.install\fR files or on the command line. Instead, \&\fBdh_install\fR will guess as follows: .Sp まず、インストール元のファイル名の先頭から \fIdebian/tmp\fR の文字列 (あるいは指定されていればソースディレクトリ名) を取り除きます。ファイル名が残っていれば、これをディレクトリ名としてその中にインストールします。つまり、ソースディレクトリとして \&\fIdebian/tmp/usr/bin\fR が与えられると、ファイルのコピー先のディレクトリは \fIdebian/package/usr/\fR となります。ファイル名が \fIdebian/tmp/etc/passwd\fR であれば、\fIdebian/package/etc/\fR へ行われます。 .IP "\fIfile|dir\fR ... \fIdestdir\fR" 4 .IX Item "file|dir ... destdir" インストールするファイル (またはディレクトリ) と、どこへインストールするかについて列挙します。ファイルは \fIdh_install\fR が処理する最初のパッケージへインストールされます。 .SH "制限事項" .IX Header "制限事項" \&\fBdh_install\fR はファイルやディレクトリをリネームできません。パッケージビルドツリー内のどこへでも望む場所へ、既に付けられた名前でそれらをインストールすることだけが可能です。 .PP ですが、リネームは互換性レベル 9 以上で \fBdh-exec\fR を使うことで実現できます。\fBdh-exec\fR を使う debian/\fIpackage\fR.install ファイルの例は以下のようになります: .PP .Vb 2 \& #!/usr/bin/dh\-exec \& debian/default.conf => /etc/my\-package/start.conf .Ve .PP 以下の 3 点に留意して下さい: .IP "\(bu" 4 パッケージは互換性レベル 9 以降を使う必要があります (\fBdebhelper\fR\|(7) 参照) .IP "\(bu" 4 パッケージは dh-exec へのビルド依存が必要になります。 .IP "\(bu" 4 install ファイルは実行可能になっている必要があります。 .SH "参照" .IX Header "参照" \&\fBdebhelper\fR\|(7) .PP このプログラムは debhelper の一部です。 .SH "作者" .IX Header "作者" Joey Hess