INSTALL(1)

名称
install - バイナリのインストール

書式
install [-CcDMps] [-f flags] [-g group] [-m mode] [-o owner] file1 file2 install [-CcDMps] [-f flags] [-g group] [-m mode] [-o owner] file1 ... fileN directory install -d [-g group] [-m mode] [-o owner] directory ...

解説
ファイルを指定したファイルもしくはディレクトリへ移動 ( -c オプションが指定されていればコピー) します。 もしもターゲットがディレクトリであれば、 file は元のファイル名のままで directory の中に移動されます。もし指定ファイルがすでに存在してい る場合、パーミッションが許せば上書きされます。

-C  -c オプションが指定されたのと同じように、コピーを行います。 コピー先ファイルがすでに存在しかつ内容が同一である場合には、 ターゲットの修正時刻を変更しないことが異なります。

-c  ファイルをコピーします。デフォルトでは install はターゲットのファイルを作った後にオリジナルのファイルを削除しますが、 -c オプションはこの動作をオフにします。

-D  デバッグ情報を表示します。 -D が一回以上指定されている時、 -C でのリネーム処理も表示します。 -D が 2 回以上指定されている時は、 -C オプションでインストールできなかったファイルに対して警告を発します。

-d  ディレクトリを作成します。 必要であれば、無い親ディレクトリも作成されます。

-f  ターゲットファイルのファイルフラグを指定します; 指定可能なフラグのリストとその意味は chflags(1) を参照して下さい。

-g  グループを指定します。数値指定の GID が利用できます。

-M  mmap(2) の使用を全面的に禁止します。

-m  モードを指定します。デフォルトのモードは rwxr-xr-x (0755) にセットされます。モード指定は 8 進数もしくは シンボリックな値のどちらでも可能です; 指定可能なモードの値については chmod(1) を参照して下さい。

-o  所有者を指定します。数値指定の UID が利用できます。

-p  修正時刻を保存します。 -C (比較してコピー) オプションが指定された場合のようにコピーを行いますが、 ターゲットファイルが存在しないもしくは内容が異る場合、 ファイルの修正時刻を保存します。

-s  install は strip(1) コマンドを実行してバイナリをストリップします。 strip コマンドを別に起動するため、多くのシステムやバイナリ形式に対して 移植性のある方法となっています。

デフォルトでは install は全てのファイルフラグを保存します。ただし ``nodump'' フラグは例外です。

install ユーティリティは、ファイルをそれ自身に移動しないように試みます。

/dev/null をインストールすると、空のファイルを作ります。

正常終了時は 0 が返ります。他の場合は 1 が返ります。

関連ファイル
INS@XXXX
    -C もしくは -p オプションが使われている時は、一時ファイル名を INS@XXXXとします。 ここで、 XXXX 部分は mkstemp(3) で決定され、ターゲットディレクトリに作成されます。

関連項目
chflags(1), chgrp(1), chmod(1), cp(1), mv(1), strip(1), mmap(2), chown(8)

歴史
install ユーティリティは 4.2BSD から登場しました。

バグ
install が異常終了した場合に、 一時ファイルがターゲットディレクトリに残るかも知れません。

NFS ファイルシステム経由では fchflags(2) でファイルフラグを設定できません。 他のファイルシステムはフラグの概念がありません。 フラグをサポートしないファイルシステムにおいてフラグ設定に失敗した場合には、 install は警告だけ行います。