NAME[名称]
install - 复制文件并设置属性
SYNOPSIS[总览]
install [options] [-s] [--strip] source dest
install [options] [-s] [--strip] source... directory
install [options] [-d,--directory] directory...
选项(最短格式):
[-b] [-c] [-D] [-g group] [-m mode] [-o owner] [-S SUFFIX] [-V {numbered,existing,simple}] [--help] [--version] [--]
DESCRIPTION(描述)
install 复制文件并设置它们的权限模式,如果可能,还将设置其所有者和组别.
在第一种调用格式中, source 文件被复制为 dest 目标文件. 在第二种格式中,每个 source 文件都被复制到目的端 directory 中. 在最后一种格式中,将创建每个 directory (以及任何缺失的父目录).
install 类似于 cp, 不过它允许你控制目的文件的属性. 它的典型应用是 Makefile 文件中复制程序到它们的目标目录中. 它拒绝复制文件为其自身.
OPTIONS(选项)
- -c
- 可忽略;这是为了与老Unix版本的 install 相兼容.
- -d, --directory
- 创建每个给定的目录以及任何缺失的父目录, 按照命令行要求来设置所有者,组别和模式,或者设为默认值. 它也授予任何它创建的父目录以这些属性. (这有别于SunOS 4.x的 install, 该 install 授予其创建目录以默认的属性.)
- -D
- 创建 dest 的所有前面部分,只有最后一个除外,然后复制 source 到 dest. 该选项在如上总览中列出的第一种格式中有用. (fileutils-4.0中的新功能.)
- -g group, --group=group
- 设置安装的文件或目录的组所有权为 group 这可能是组名,或者是数字化组标识.
- -m mode, --mode=mode
- 设置安装的文件或目录的权限为 mode, 这可以为八进制数,也可以为 chmod 中的符号化的模式,且都以0开头.默认的模式是0755 - 对所有者可读,可写并且可执行,对于组用户和其它用户可读和可执行.
- -o owner, --owner=owner
- 如果 install 有合适的特权(运行为root),则设置安装的文件或目录的所有权为 owner. 默认为'root'. owner 可以为用户名,也可以为数字化用户标识.
- -s, --strip
- 从安装的二进制可执行程序剥离符号表.
GNU BACKUP OPTIONS(GNU备份选项)
GNU版本的程序如 cp, mv, ln, install 和 patch 会按需求对将要被覆盖,修改或者毁坏的文件进行备份. 所需要的备份文件由-b选项指定. 它们怎样命名则由-V选项确定. 在备份文件名通过后缀扩展方式给定的情况下,该后缀由-S选项确定.
- -b, --backup
- 备份那些将要被覆盖或者移除的文件.
- -S SUFFIX, --suffix=SUFFIX
- 添加 SUFFIX 到每个生成的备份文件后. 如果该选项未被确定,那么将使用 SIMPLE_BACKUP_SUFFIX 环境变量.又如果 SIMPLE_BACKUP_SUFFIX 未设置,那么默认为'~'.
- -V METHOD, --version-control=METHOD
- 确定备份文件怎样命名. METHOD 参数可以为'numbered'(或者't'),'existing'(或者'nil'),或'never'(或者'simple'). 如果未指定该选项,将使用 VERSION_CONTROL 环境变量.又如果 VERSION_CONTROL 未设置,那么默认的备份类型为'existing'.
该选项相当于Emacs变量'version-control'.有效的 METHODs 有(只接受唯一的缩写方式):
- t, numbered
- 总作数码标识的备份.
- nil, existing
- 对已有文件作数码标识的备份,而对其它文件作简单备份.
- never, simple
- 总作简单备份.
- 确定备份文件怎样命名. METHOD 参数可以为'numbered'(或者't'),'existing'(或者'nil'),或'never'(或者'simple'). 如果未指定该选项,将使用 VERSION_CONTROL 环境变量.又如果 VERSION_CONTROL 未设置,那么默认的备份类型为'existing'.
GNU STANDARD OPTIONS(GNU标准选项)
- --help
- 在标准输出上打印一条用法信息,并以成功状态退出.
- --version
- 在标准输出上打印版本信息,然后以成功状态退出.
- --
- 终止选项列表.
ENVIRONMENT(环境变量)
变量LANG, LC_ALL, LC_CTYPE和LC_MESSAGES取其常用义.对于GNU的版本,如上所述,变量 SIMPLE_BACKUP_SUFFIX和VERSION_CONTROL控制着备份文件的命名.
CONFORMING TO(遵循规则)
BSD 4.2 (它带有-c, -m, -o, -g和-s选项).
NOTES(备注)
本页介绍了包含在fileutils-4.0包中的 install ; 其他版本可能会有细微差别. 请把您的修正和增补建议发邮件到aeb@cwi.nl. 报告程序中的bug请发到 fileutils-bugs@gnu.ai.mit.edu.
#p#
NAME
ginstall - copy files and set attributes
SYNOPSIS
install [OPTION]... SOURCE DEST (1st format)
install [OPTION]... SOURCE... DIRECTORY (2nd format)
install -d [OPTION]... DIRECTORY... (3rd format)
DESCRIPTION
In the first two formats, copy SOURCE to DEST or multiple SOURCE(s) to the existing DIRECTORY, while setting permission modes and owner/group. In the third format, create all components of the given DIRECTORY(ies).
Mandatory arguments to long options are mandatory for short options too.
- --backup[=CONTROL] make a backup of each existing destination file
- -b
- like --backup but does not accept an argument
- -c
- (ignored)
- -C
- Install file, unless target already exists and is the same as the new file, in which case the modification time won't be changed.
- -d, --directory
- treat all arguments as directory names; create all components of the specified directories
- -D
- create all leading components of DEST except the last, then copy SOURCE to DEST; useful in the 1st format
- -g, --group=GROUP
- set group ownership, instead of process' current group
- -m, --mode=MODE
- set permission mode (as in chmod), instead of rwxr-xr-x
- -o, --owner=OWNER
- set ownership (super-user only)
- -p, --preserve-timestamps
- apply access/modification times of SOURCE files to corresponding destination files
- -s, --strip
- strip symbol tables, only for 1st and 2nd formats
- -S, --suffix=SUFFIX override the usual backup suffix
- -v, --verbose
- print the name of each directory as it is created
- -P, --preserve_context (SELinux) Preserve security context
- -Z, --context=CONTEXT
- (SELinux) Set security context of files and directories
- --help
- display this help and exit
- --version
- output version information and exit
The backup suffix is `~', unless set with --suffix or SIMPLE_BACKUP_SUFFIX. The version control method may be selected via the --backup option or through the VERSION_CONTROL environment variable. Here are the values:
- none, off
- never make backups (even if --backup is given)
- numbered, t
- make numbered backups
- existing, nil
- numbered if numbered backups exist, simple otherwise
- simple, never
- always make simple backups
AUTHOR
Written by David MacKenzie.
REPORTING BUGS
Report bugs to <bug-coreutils@gnu.org>.
COPYRIGHT
Copyright © 2004 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
SEE ALSO
The full documentation for install is maintained as a Texinfo manual. If the info and install programs are properly installed at your site, the command
- info coreutils install
should give you access to the complete manual.