manual/gnumaniak/draft/man1/install.1

   1 .\" Copyright Andries Brouwer, A. Wik 1998, Ragnar Hojland Espinosa 1998-2002
   2 .\"
   3 .\" This file may be copied under the conditions described
   4 .\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
   5 .\" that should have been distributed together with this file.
   6 .\"
   7 .\" Japanese Version Copyright (c) 1999-2003 Yuichi SATO
   8 .\"         all rights reserved.
   9 .\" Translated Sat Oct 30 00:21:57 JST 1999
  10 .\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
  11 .\" Updated & Modified Sat Mar  1 23:04:53 JST 2003
  12 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  13 .\"
  14 .\"WORD:        permissions             アクセス権
  15 .\"WORD:        attribute               属性
  16 .\"WORD:        symbolic mode           シンボルモード
  17 .\"WORD:        numeric mode            数値モード
  18 .\"WORD:        octal number            8 進数
  19 .\"
  20 .TH INSTALL 1 "18 June 2002" "GNU fileutils 4.1"
  21 .\"O .SH NAME
  22 .SH 名前
  23 .\"O install \- copy files and set attributes
  24 install \- ファイルをコピーし、その属性を設定する
  25 .\"O .SH SYNOPSIS
  26 .SH 書式
  27 .B install
  28 .BI [ options ]
  29 .B [\-s] [\-\-strip]
  30 .I source dest
  31 .br
  32 .B install
  33 .BI [ options ]
  34 .B [\-s] [\-\-strip]
  35 .I source... directory
  36 .br
  37 .B install
  38 .BI [ options ]
  39 .B [\-d,\-\-directory]
  40 .I directory...
  41 .sp
  42 .\"O Options (shortest form):
  43 オプション (簡略形式):
  44 .br
  45 .B [\-bcpvD]
  46 .BI "[\-g " group ]
  47 .BI "[\-m " mode ]
  48 .BI "[\-o " owner ]
  49 .BI "[\-S " suffix ]
  50 .B [\-V {numbered,existing,simple}]
  51 .B [\-\-preserve\-timestamps]
  52 .BI [\-\-target\-directory= dir ]
  53 .B [\-\-help] [\-\-version] [\-\-]
  54 .\"O .SH DESCRIPTION
  55 .SH 説明
  56 .\"O .B install
  57 .\"O copies files while setting their permission modes and, if
  58 .\"O possible, their owner and group.
  59 .B install
  60 はファイルをコピーし、そのアクセス権を設定する。
  61 可能ならば所有者とグループを設定する。
  62 .PP
  63 .\"O In the first of these invocation forms, the
  64 .\"O .I source
  65 .\"O file is copied to the
  66 .\"O .I dest
  67 .\"O target file.  In the second, each of the
  68 .\"O .I source
  69 .\"O files are copied to the destination
  70 .\"O .IR directory .
  71 .\"O In the last, each
  72 .\"O .I directory
  73 .\"O (and any missing parent directories) is created.
  74 1 番目の呼び出し形式では、ファイル
  75 .I source
  76 が目的のファイル
  77 .I dest
  78 にコピーされる。
  79 2 番目の形式では、複数のファイル
  80 .I source
  81 のそれぞれが指定ディレクトリ
  82 .I directory
  83 にコピーされる。
  84 最後の形式では、個々のディレクトリ
  85 .I directory
  86 が (親ディレクトリがない場合はそれも含めて) 作成される。
  87 .PP
  88 .\"O .B install
  89 .\"O is similar to
  90 .\"O .BR cp ,
  91 .\"O but allows you to control the attributes of destination files.
  92 .\"O It is typically used in Makefiles to copy programs into their
  93 .\"O destination directories.  It refuses to copy files onto themselves.
  94 .B install
  95 は
  96 .B cp
  97 と似ているが、コピー先ファイルの属性を制御できる。
  98 プログラムを指定ディレクトリにコピーするために、
  99 Makefile 内でよく用いられる。
 100 ファイルをそれ自身へコピーすることはできない。
 101 .PP
 102 .\"O .SH OPTIONS
 103 .SH オプション
 104 .TP
 105 .B "\-c"
 106 .\"O Ignored; for compatibility with old Unix versions of
 107 .\"O .BR install .
 108 無視される。古い Uxix 版の
 109 .B install
 110 との互換性のためにある。
 111 .TP
 112 .B "\-d, \-\-directory"
 113 .\"O Create each given directory and any missing parent directories,
 114 .\"O setting the owner, group and mode as given on the command line or
 115 .\"O to the defaults.  It also gives any parent directories it creates
 116 .\"O those attributes.
 117 指定されたディレクトリを作成する。
 118 親ディレクトリが存在しない場合は、それも作成する。
 119 所有者・グループ・モードを、コマンドラインで指定された設定、
 120 またはデフォルトの設定にする。
 121 このとき作成した親ディレクトリにも同じ属性を与える。
 122 .TP
 123 .BI "\-g " "group" ", \-\-group=" "group"
 124 .\"O Set the group ownership of installed files or directories to
 125 .\"O .IR group .
 126 .\"O The default is the process's current group.
 127 .\"O .I group
 128 .\"O may be either a group name or a numeric group id.
 129 インストールされたファイルやディレクトリの所有グループを
 130 .I group
 131 に設定する。
 132 デフォルトではプロセスが属する現在のグループになる。
 133 .I group
 134 はグループ名でも数字のグループ ID でもよい。
 135 .TP
 136 .BI "\-m " "mode" ", \-\-mode=" "mode"
 137 .\"O Set the permissions for the installed file or directory to
 138 .\"O .IR mode ,
 139 .\"O which can be either an octal number, or a symbolic mode as in
 140 .\"O .BR chmod ,
 141 .\"O with 0 as the point of departure. The default mode is 0755 - read,
 142 .\"O write, and execute for the owner,
 143 .\"O and read and execute for group and other.
 144 インストールされたファイルやディレクトリのアクセス権を
 145 .I mode
 146 に設定する。
 147 モードは 0 を基点とし、8 進数、
 148 .B chmod
 149 におけるシンボルモードのどちらでもよい。
 150 デフォルトのモードは 0755 で、所有者の読み取り・書き込み・実行、
 151 グループとその他の人の読み取り・実行が可能である。
 152 .TP
 153 .BI "\-o " "owner" ", \-\-owner=" "owner"
 154 .\"O If
 155 .\"O .B install
 156 .\"O has appropriate privileges (is run as root), set the ownership of
 157 .\"O installed files or directories to
 158 .\"O .IR owner .
 159 .\"O The default is `root'.
 160 .\"O .I owner
 161 .\"O may be either a user name or a numeric user ID.
 162 .B install
 163 が適正な権利を持っている (root で実行された) 場合、
 164 インストールされたファイルやディレクトリの所有者を
 165 .I owner
 166 に設定する。
 167 デフォルトは `root' である。
 168 .I owner
 169 はユーザー名でも数字のユーザー ID でもよい。
 170 .TP
 171 .B \-p, \-\-preserve\-timestamps
 172 .\"O Set the time of last access and the time of last modification of
 173 .\"O each installed file to match those of each corresponding original
 174 .\"O file.
 175 インストールされたファイルの最終アクセス時刻と最終修正時刻を
 176 それぞれコピー元ファイルと合わせる。
 177
 178 .\"O When a file is installed without this option, its last
 179 .\"O file.  When a file is installed without this option, its last
 180 .\"O access and last modification times are
 181 .\"O both set to the time of installation.
 182 .\"O This option is useful if you want to use the last modification times of
 183 .\"O installed files to keep track of when they were last built as opposed to
 184 .\"O when they were last installed.
 185 このオプションなしでファイルがインストールされると、
 186 最終アクセス時刻と最終修正時刻は共にインストール時刻に合わせられる。
 187 このオプションは、インストールされたファイルの最終修正時刻を、
 188 「いつインストールされたか」ではなく「いつ作られたか」を
 189 記憶させるために使いたい場合に便利である。
 190 .TP
 191 .B "\-s, \-\-strip"
 192 .\"O Strip the symbol tables from installed binary executables.
 193 インストールされたバイナリ実行ファイルからシンボルテーブルを strip する。
 194 .TP
 195 .BI "\-\-target\-directory=" dir
 196 .\"O Specify the the target directory with an option instead of as the last arg
 197 .\"O in the command line.  This is useful with \fBxargs(1)\fR.
 198 コマンドラインの最後の引き数ではなく、
 199 オプションでインストール先ディレクトリを指定する。
 200 \fBxargs(1)\fR と一緒に使う場合に役立つ。
 201 .TP
 202 .B \-D
 203 .\"O Create all leading components of \fIdest\fR except the last,
 204 .\"O then copy \fIsource\fR to \fIdest\fR; useful in the 1st format.
 205 \fIdest\fR にコピーするために必要な全ディレクトリ構造を
 206 (それがない場合は) 前もって作成する。
 207 それから \fIsource\fR を \fIdest\fR にコピーする。
 208 1 番目の形式の場合に便利である。
 209 .TP
 210 .B \-v, \-\-verbose
 211 .\"O Print the name of each file before installing it.
 212 インストールする前にそれぞれのファイル名を出力する。
 213 .\"O .SH "GNU BACKUP OPTIONS"
 214 .SH "GNU バックアップオプション"
 215 .\"O The GNU versions of programs like
 216 .\"O .BR cp ,
 217 .\"O .BR mv ,
 218 .\"O .BR ln ,
 219 .\"O .B install
 220 .\"O and
 221 .\"O .B patch
 222 .\"O will make a backup of files about to be overwritten, changed or destroyed
 223 .\"O if that is desired. That backup files are desired is indicated by
 224 .\"O the \-b option. How they should be named is specified by the \-\-backup option.
 225 .\"O In case the name of the backup file is given by the name of the file
 226 .\"O extended by a suffix, this suffix is specified by the \-S option.
 227 GNU 版のプログラム
 228 .BR cp ,
 229 .BR mv ,
 230 .BR ln ,
 231 .BR install ,
 232 .B patch
 233 は、上書き・修正・削除といった場合に、指示すればファイルの
 234 バックアップを作成する。
 235 バックアップファイルを必要とする場合は \-b オプションで指定する。
 236 どのような名前にするかは \-\-backup オプションで指定する。
 237 バックアップファイルの名前を、ファイル名に拡張子を追加する形で
 238 与えるようにしたい場合、
 239 この拡張子を \-S オプションで指示する。
 240 .TP
 241 .BI "\-b, \-\-backup[=" method ]
 242 .\"O Make backups of files that are about to be overwritten or removed.  Note
 243 .\"O that \fB\-b\fR does not take args.
 244 上書きもしくは削除の必要がある場合には、
 245 ファイルのバックアップを作成する。
 246 \fB\-b\fR が引き数をとらない点に注意すること。
 247 .TP
 248 .BI "\-S " suffix ", \-\-suffix=" suffix
 249 .\"O Append
 250 .\"O .I SUFFIX
 251 .\"O to each backup file made.
 252 .\"O If this option is not specified, the value of the
 253 .\"O .B SIMPLE_BACKUP_SUFFIX
 254 .\"O environment variable is used.  And if
 255 .\"O .B SIMPLE_BACKUP_SUFFIX
 256 .\"O is not set, the default is `~'.
 257 .I SUFFIX
 258 をバックアップファイルそれぞれに付け加える。
 259 このオプションが指定されていない場合、環境変数
 260 .B SIMPLE_BACKUP_SUFFIX
 261 に設定されている値が使われる。
 262 .B SIMPLE_BACKUP_SUFFIX
 263 が設定されていない場合のデフォルトは `~' である。
 264 .TP
 265 .BI "\-V " method ", \-\-version\-control=" method
 266 .RS
 267 .\"O Specify how backup files are named. The
 268 .\"O .I method
 269 .\"O argument can be `numbered' (or `t'), `existing' (or `nil'), or `never' (or
 270 .\"O `simple').
 271 .\"O If this option is not specified, the value of the
 272 .\"O .B VERSION_CONTROL
 273 .\"O environment variable is used.  And if
 274 .\"O .B VERSION_CONTROL
 275 .\"O is not set, the default backup type is `existing'.
 276 バックアップファイルの命名方法を指定する。
 277 引き数
 278 .I method
 279 には、`numbered' (または `t')、`existing' (または `nil')、
 280 `never' (または `simple') を指定できる。
 281 このオプションが指定されていない場合、環境変数
 282 .B VERSION_CONTROL
 283 の値が使われる。
 284 .B VERSION_CONTROL
 285 が設定されていない場合のデフォルトは `existing' である。
 286 .PP
 287 .\"O This option corresponds to the Emacs variable `version-control'.
 288 .\"O The valid
 289 .\"O .IR method s
 290 .\"O are (unique abbreviations are accepted):
 291 このオプションは Emacs 変数の `version-control' に対応している。
 292 有効な
 293 .I method
 294 は以下の通り。(他と重複しない短縮形が使える):
 295 .TP
 296 .BR t ", " numbered
 297 .\"O Always make numbered backups.
 298 常に番号の拡張子を持つバックアップが作られる。
 299 .TP
 300 .BR nil ", " existing
 301 .\"O Make numbered backups of files that already have them, simple
 302 .\"O backups of the others.
 303 番号の拡張子を持つバックアップがすでにある場合には
 304 番号の拡張子を持つバックアップを、
 305 そうでない場合には単純なバックアップを作成する。
 306 .TP
 307 .BR never ", " simple
 308 .\"O Always make simple backups.
 309 常に単純なバックアップが作られる。
 310 .\"O .RE
 311 .\"O This option is deprecated, use \fB\-\-backup=\fImethod\fR instead.
 312 .PP
 313 このオプションは推奨されない。
 314 代りに \fB\-\-backup=\fImethod\fR を使うこと。
 315 .RE
 316 .\"O .SH "GNU STANDARD OPTIONS"
 317 .SH "GNU 標準オプション"
 318 .TP
 319 .B "\-\-help"
 320 .\"O Print a usage message on standard output and exit successfully.
 321 標準出力に使用方法のメッセージを出力して正常終了する。
 322 .TP
 323 .B "\-\-version"
 324 .\"O Print version information on standard output, then exit successfully.
 325 標準出力にバージョン情報を出力して正常終了する。
 326 .TP
 327 .B "\-\-"
 328 .\"O Terminate option list.
 329 オプションリストの終りを示す。
 330 .\"O .SH ENVIRONMENT
 331 .SH 環境変数
 332 .\"O The variables LANG, LC_ALL, LC_CTYPE and LC_MESSAGES have the
 333 .\"O usual meaning. For the GNU version, the variables SIMPLE_BACKUP_SUFFIX
 334 .\"O and VERSION_CONTROL control backup file naming, as described above.
 335 変数 LANG, LC_ALL, LC_CTYPE, LC_MESSAGES が通常の意味を持つ。
 336 GNU 版では、変数 SIMPLE_BACKUP_SUFFIX と VERSION_CONTROL が
 337 バックアップファイルの命名法を上で説明した方法で管理する。
 338 .\"O .SH "CONFORMING TO"
 339 .SH 準拠
 340 .\"O BSD 4.2 (which had the \-c, \-m, \-o, \-g and \-s options).
 341 BSD 4.2 (\-c, \-m, \-o, \-g, \-s オプションがある)。
 342 .\"O .SH NOTES
 343 .SH 注意
 344 .\"O This page describes
 345 .\"O .B install
 346 .\"O as found in the fileutils-4.1 package;
 347 .\"O other versions may differ slightly. Mail corrections and additions to
 348 .\"O aeb@cwi.nl and aw@mail1.bet1.puv.fi and ragnar@ragnar-hojland.com
 349 .\"O Report bugs in the program to bug-fileutils@gnu.org.
 350 このページは fileutils-4.1 パッケージの
 351 .B install
 352 コマンドについて説明したものである;
 353 その他のバージョンでは少し違いがあるかもしれない。
 354 修正や追加は aeb@cwi.nl, aw@mail1.bet1.puv.fi, ragnar@ragnar-hojland.com
 355 宛にメールで連絡してください。
 356 プログラムのバグについては bug-fileutils@gnu.org へ報告してください。