.\" 版權所有 Andries Brouwer, Ragnar Hojland Espinosa and A.Wik,1998.
.\" 中文版版權所有 riser,BitBIRD www.linuxforum.net 2000
.\" 本文件可在遵照LDP GENERAL PUBLIC LICENSE，Version 1, September 1998
.\" 中描述的條件下進行複製,且該許可可同本檔案一起分發。
.\"
.TH INSTALL 1 "1998年11月" "GNU fileutils 4.0"
.SH NAME[名稱]
install \- 複製檔案並設置屬性
.SH SYNOPSIS[總覽]
.B install
.BI [ options ]
.B [\-s] [\-\-strip]
.I source dest
.br
.B install
.BI [ options ]
.B [\-s] [\-\-strip]
.I source... directory
.br
.B install
.BI [ options ]
.B [\-d,\-\-directory]
.I directory...
.sp
選項(最短格式):
.br
.B [\-b]
.B [\-c]
.B [\-D]
.BI "[\-g " group ]
.BI "[\-m " mode ]
.BI "[\-o " owner ]
.BI "[\-S " SUFFIX ]
.B [\-V {numbered,existing,simple}]
.B [\-\-help] [\-\-version] [\-\-]
.SH DESCRIPTION(描述)
.B install
複製檔案並設置它們的權限模式,如果可能,還將設置其所有者和組別.
.PP
在第一種調用格式中,
.I source
檔案被複製為
.I dest
目標檔案. 在第二種格式中,每個
.I source
檔案都被複製到目的端
.IR directory
中. 在最後一種格式中,將創建每個
.I directory
(以及任何缺失的父目錄).
.PP
.B install
類似於
.BR cp,
不過它允許你控制目的檔案的屬性.
它的典型應用是 Makefile 檔案中複製程式到它們的目標目錄中.
它拒絕複製檔案為其自身.
.PP
.SH OPTIONS(選項)
.TP
.B "\-c"
可忽略;這是為了與老Unix版本的
.BR install
相相容.
.TP
.B "\-d, \-\-directory"
創建每個給定的目錄以及任何缺失的父目錄,
按照命令行要求來設置所有者,組別和模式,或者設為預設值.
它也授予任何它創建的父目錄以這些屬性. (這有別於SunOS 4.x的
.BR install ,
該
.BR install
授予其創建目錄以預設的屬性.)
.TP
.B "\-D"
創建
.I dest
的所有前面部分,只有最後一個除外,然後複製
.I source
到
.IR dest .
該選項在如上總覽中列出的第一種格式中有用.
(file\%utils-4.0中的新功能.)
.TP
.BI "\-g " "group" ", \-\-group=" "group"
設置安裝的檔案或目錄的組所有權為
.IR group
這可能是組名,或者是數字化組標識.
.TP
.BI "\-m " "mode" ", \-\-mode=" "mode"
設置安裝的檔案或目錄的權限為
.IR mode ,
這可以為八進制數,也可以為
.BR chmod
中的符號化的模式,且都以0開頭.預設的模式是0755 \- 
對所有者可讀,可寫並且可執行,對於組使用者和其它使用者可讀和可執行.
.TP
.BI "\-o " "owner" ", \-\-owner=" "owner"
如果
.B install
有合適的特權(運行為root),則設置安裝的檔案或目錄的所有權為
.IR owner .
預設為'root'.
.I owner
可以為使用者名,也可以為數字化使用者標識.
.TP
.B "\-s, \-\-strip"
從安裝的二進制可執行程式剝離符號表.
.SH "GNU BACKUP OPTIONS(GNU備份選項)"
GNU版本的程式如
.BR cp ,
.BR mv ,
.BR ln ,
.B install
和
.B patch
會按需求對將要被覆蓋,修改或者毀壞的檔案進行備份.
所需要的備份檔案由\-b選項指定.
它們怎樣命名則由\-V選項確定.
在備份檔名通過延伸檔名擴展方式給定的情況下,該延伸檔名由-S選項確定.
.TP
.B "\-b, \-\-backup"
備份那些將要被覆蓋或者移除的檔案.
.TP
.BI "\-S " SUFFIX ", \-\-suffix=" SUFFIX
添加
.I SUFFIX
到每個生成的備份檔案後.
如果該選項未被確定,那麼將使用
.B SIMPLE_BACKUP_SUFFIX
環境變量.又如果
.B SIMPLE_BACKUP_SUFFIX
未設置,那麼預設為'~'.
.TP
.BI "\-V " METHOD ", \-\-version\-control=" METHOD
.RS
確定備份檔案怎樣命名.
.I METHOD
參數可以為'numbered'(或者't'),'existing'(或者'nil'),或'never'(或者'simple').
如果未指定該選項,將使用
.B VERSION_CONTROL
環境變量.又如果
.B VERSION_CONTROL
未設置,那麼預設的備份類型為'existing'.
.PP
該選項相當於Emacs變量'version-control'.有效的
.IR METHOD s
有(只接受唯一的縮寫方式):
.TP
.BR t ", " numbered
總作數碼標識的備份.
.TP
.BR nil ", " existing
對已有檔案作數碼標識的備份,而對其它檔案作簡單備份.
.TP
.BR never ", " simple
總作簡單備份.
.RE
.SH "GNU STANDARD OPTIONS(GNU標準選項)"
.TP
.B "\-\-help"
在標準輸出上列印一條用法信息,並以成功狀態退出.
.TP
.B "\-\-version"
在標準輸出上列印版本信息,然後以成功狀態退出.
.TP
.B "\-\-"
終止選項列表.
.SH ENVIRONMENT(環境變量)
變量LANG, LC_ALL, LC_CTYPE和LC_MESSAGES取其常用義.對於GNU的版本,如上所述,變量
SIMPLE_BACKUP_SUFFIX和VERSION_CONTROL控制著備份檔案的命名.
.SH "CONFORMING TO(遵循規則)"
BSD 4.2 (它帶有\-c, \-m, \-o, \-g 和 \-s 選項).
.SH NOTES(備注)
本頁介紹了包含在fileutils-4.0包中的
.B install ;
其他版本可能會有細微差別.
請把您的修正和增補建議發郵件到aeb@cwi.nl.
報告程式中的bug請發到
fileutils-bugs@gnu.ai.mit.edu.

.SH "[中文版維護人]"
.B riser <boomer@ccidnet.com>
.SH "[中文版最新更新]"
.BR 2000/10/19
.SH "《中國linux論壇man手冊頁翻譯計劃》:"
.BI http://cmpp.linuxforum.net