1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
.\" Copyright (c) 1987, 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: @(#)install.1 8.1 (Berkeley) 6/6/93
.\" %FreeBSD: src/usr.bin/xinstall/install.1,v 1.13.2.1 1999/08/29 15:34:56 peter Exp %
.\"
.\" jpman %Id: install.1,v 1.3 1997/11/12 13:03:24 horikawa Stab %
.Dd September 22, 1996
.Dt INSTALL 1
.Os BSD 4.2
.Sh 名称
.Nm install
.Nd バイナリのインストール
.Sh 書式
.Nm install
.Op Fl CcDMps
.Op Fl f Ar flags
.Op Fl g Ar group
.Op Fl m Ar mode
.Op Fl o Ar owner
.Ar file1 file2
.Nm install
.Op Fl CcDMps
.Op Fl f Ar flags
.Op Fl g Ar group
.Op Fl m Ar mode
.Op Fl o Ar owner
.Ar file1
\&...
.Ar fileN directory
.Nm install
.Fl d
.Op Fl g Ar group
.Op Fl m Ar mode
.Op Fl o Ar owner
.Ar directory
\&...
.Sh 解説
ファイルを指定したファイルもしくはディレクトリへ移動 (
.Fl c
オプションが指定されていればコピー) します。
もしもターゲットがディレクトリであれば、
.Ar file
は元のファイル名のままで
.Ar directory
の中に移動されます。もし指定ファイルがすでに存在してい
る場合、パーミッションが許せば上書きされます。
.Pp
.Bl -tag -width Ds
.It Fl C
.Fl c
オプションが指定されたのと同じように、コピーを行います。
コピー先ファイルがすでに存在しかつ内容が同一である場合には、
ターゲットの修正時刻を変更しないことが異なります。
.It Fl c
ファイルをコピーします。デフォルトでは
.Nm
はターゲットのファイルを作った後にオリジナルのファイルを削除しますが、
.Fl c
オプションはこの動作をオフにします。
.It Fl D
デバッグ情報を表示します。
.Fl D
が一回以上指定されている時、
.Fl C
でのリネーム処理も表示します。
.Fl D
が 2 回以上指定されている時は、
.Fl C
オプションでインストールできなかったファイルに対して警告を発します。
.It Fl d
ディレクトリを作成します。
必要であれば、無い親ディレクトリも作成されます。
.It Fl f
ターゲットファイルのファイルフラグを指定します;
指定可能なフラグのリストとその意味は
.Xr chflags 1
を参照して下さい。
.It Fl g
グループを指定します。数値指定の GID が利用できます。
.It Fl M
.Xr mmap 2
の使用を全面的に禁止します。
.It Fl m
モードを指定します。デフォルトのモードは rwxr-xr-x
(0755) にセットされます。モード指定は 8 進数もしくは
シンボリックな値のどちらでも可能です; 指定可能なモードの値については
.Xr chmod 1
を参照して下さい。
.It Fl o
所有者を指定します。数値指定の UID が利用できます。
.It Fl p
修正時刻を保存します。
.Fl C
(比較してコピー) オプションが指定された場合のようにコピーを行いますが、
ターゲットファイルが存在しないもしくは内容が異る場合、
ファイルの修正時刻を保存します。
.It Fl s
.Nm
は
.Xr strip 1
コマンドを実行してバイナリをストリップします。
.Nm strip
コマンドを別に起動するため、多くのシステムやバイナリ形式に対して
移植性のある方法となっています。
.El
.Pp
デフォルトでは
.Nm
は全てのファイルフラグを保存します。ただし ``nodump'' フラグは例外です。
.Pp
.Nm
ユーティリティは、ファイルをそれ自身に移動しないように試みます。
.Pp
.Pa /dev/null
をインストールすると、空のファイルを作ります。
.Pp
正常終了時は 0 が返ります。他の場合は 1 が返ります。
.Pp
.Sh 関連ファイル
.Bl -tag -width INS@XXXX -compact
.It Pa INS@XXXX
.Fl C
もしくは
.Fl p
オプションが使われている時は、一時ファイル名を INS@XXXXとします。
ここで、 XXXX 部分は
.Xr mkstemp 3
で決定され、ターゲットディレクトリに作成されます。
.Sh 関連項目
.Xr chflags 1 ,
.Xr chgrp 1 ,
.Xr chmod 1 ,
.Xr cp 1 ,
.Xr mv 1 ,
.Xr strip 1 ,
.Xr mmap 2 ,
.Xr chown 8
.Sh 歴史
.Nm
ユーティリティは
.Bx 4.2
から登場しました。
.Sh バグ
.Nm install
が異常終了した場合に、
一時ファイルがターゲットディレクトリに残るかも知れません。
.Pp
NFS ファイルシステム経由では
.Xr fchflags 2
でファイルフラグを設定できません。
他のファイルシステムはフラグの概念がありません。
フラグをサポートしないファイルシステムにおいてフラグ設定に失敗した場合には、
.Nm
は警告だけ行います。
|
