zmwangx/install.1.html

## install.1.html

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>&#105;&#110;&#115;&#116;&#97;&#108;&#108;&#46;&#49;</title>
<style type="text/css">
    body {
        text-align: center;
    }

    #manpage {
        text-align: left;
        display: inline-block;
    }
</style>
</head>
<body>
<pre id="manpage">

INSTALL(1)                BSD General Commands Manual               INSTALL(1)

<b>NAME</b>
     <b>install</b> -- install binaries

<b>SYNOPSIS</b>
     <b>install</b> [<b>-bCcMpSsv</b>] [<b>-B</b> <u>suffix</u>] [<b>-f</b> <u>flags</u>] [<b>-g</b> <u>group</u>] [<b>-m</b> <u>mode</u>] [<b>-o</b> <u>owner</u>] <u>file1</u> <u>file2</u>
     <b>install</b> [<b>-bCcMpSsv</b>] [<b>-B</b> <u>suffix</u>] [<b>-f</b> <u>flags</u>] [<b>-g</b> <u>group</u>] [<b>-m</b> <u>mode</u>] [<b>-o</b> <u>owner</u>] <u>file1</u> <u>...</u> <u>fileN</u> <u>directory</u>
     <b>install</b> <b>-d</b> [<b>-v</b>] [<b>-g</b> <u>group</u>] [<b>-m</b> <u>mode</u>] [<b>-o</b> <u>owner</u>] <u>directory</u> <u>...</u>

<b>DESCRIPTION</b>
     The file(s) are copied to the target file or directory.  If the destination is a directory, then the
     <u>file</u> is copied into <u>directory</u> with its original filename.  If the target file already exists, it is
     either renamed to <u>file.old</u> if the <b>-b</b> option is given or overwritten if permissions allow.  An alternate
     backup suffix may be specified via the <b>-B</b> option's argument.

     The options are as follows:

     <b>-B</b> <u>suffix</u>
             Use <u>suffix</u> as the backup suffix if <b>-b</b> is given.

     <b>-b</b>      Back up any existing files before overwriting them by renaming them to <u>file.old</u>.  See <b>-B</b> for
             specifying a different backup suffix.

     <b>-C</b>      Copy the file.  If the target file already exists and the files are the same, then don't change
             the modification time of the target.

     <b>-c</b>      Copy the file.  This is actually the default.  The <b>-c</b> option is only included for backwards
             compatibility.

     <b>-d</b>      Create directories.  Missing parent directories are created as required.

     <b>-f</b>      Specify the target's file flags; see chflags(1) for a list of possible flags and their mean-
             ings.

     <b>-g</b>      Specify a group.  A numeric GID is allowed.

     <b>-M</b>      Disable all use of mmap(2).

     <b>-m</b>      Specify an alternate mode.  The default mode is set to rwxr-xr-x (0755).  The specified mode
             may be either an octal or symbolic value; see chmod(1) for a description of possible mode val-
             ues.

     <b>-o</b>      Specify an owner.  A numeric UID is allowed.

     <b>-p</b>      Preserve the modification time.  Copy the file, as if the <b>-C</b> (compare and copy) option is spec-
             ified, except if the target file doesn't already exist or is different, then preserve the modi-
             fication time of the file.

     <b>-S</b>      Safe copy.  Normally, <b>install</b> unlinks an existing target before installing the new file.  With
             the <b>-S</b> flag a temporary file is used and then renamed to be the target.  The reason this is
             safer is that if the copy or rename fails, the existing target is left untouched.

     <b>-s</b>      <b>install</b> exec's the command strip(1) to strip binaries so that <b>install</b> can be portable over a
             large number of systems and binary types.

     <b>-v</b>      Causes <b>install</b> to show when <b>-C</b> actually installs something.

     By default, <b>install</b> preserves all file flags, with the exception of the ``nodump'' flag.

     The <b>install</b> utility attempts to prevent moving a file onto itself.

     Installing <u>/dev/null</u> creates an empty file.

<b>DIAGNOSTICS</b>
     The <b>install</b> utility exits 0 on success, and 1 otherwise.

<b>FILES</b>
     INS@XXXX  If either <b>-S</b> option is specified, or the <b>-C</b> or <b>-p</b> option is used in conjuction with the <b>-s</b>
               option, temporary files named <u>INS@XXXX</u>, where <u>XXXX</u> is decided by mkstemp(3), are created in
               the target directory.

<b>COMPATIBILITY</b>
     Historically <b>install</b> moved files by default.  The default was changed to copy in FreeBSD 4.4.

<b>SEE</b> <b>ALSO</b>
     chflags(1), chgrp(1), chmod(1), cp(1), mv(1), strip(1), mmap(2), chown(8)

<b>HISTORY</b>
     The <b>install</b> utility appeared in 4.2BSD.

<b>BUGS</b>
     Temporary files may be left in the target directory if <b>install</b> exits abnormally.

     File flags cannot be set by fchflags(2) over a NFS file system.  Other file systems do not have a con-
     cept of flags.  <b>install</b> will only warn when flags could not be set on a file system that does not sup-
     port them.

     <b>install</b> with <b>-v</b> falsely says a file is copied when <b>-C</b> snaps hard links.

BSD                               May 7, 2001                              BSD

</pre>
</body>
</html>

	<!DOCTYPE html>
	<html>
	<head>
	<meta charset="UTF-8">
	<title>install.1</title>
	<style type="text/css">
	body {
	text-align: center;
	}

	#manpage {
	text-align: left;
	display: inline-block;
	}
	</style>
	</head>
	<body>
	<pre id="manpage">

	INSTALL(1) BSD General Commands Manual INSTALL(1)

	<b>NAME</b>
	<b>install</b> -- install binaries

	<b>SYNOPSIS</b>
	<b>install</b> [<b>-bCcMpSsv</b>] [<b>-B</b> <u>suffix</u>] [<b>-f</b> <u>flags</u>] [<b>-g</b> <u>group</u>] [<b>-m</b> <u>mode</u>] [<b>-o</b> <u>owner</u>] <u>file1</u> <u>file2</u>
	<b>install</b> [<b>-bCcMpSsv</b>] [<b>-B</b> <u>suffix</u>] [<b>-f</b> <u>flags</u>] [<b>-g</b> <u>group</u>] [<b>-m</b> <u>mode</u>] [<b>-o</b> <u>owner</u>] <u>file1</u> <u>...</u> <u>fileN</u> <u>directory</u>
	<b>install</b> <b>-d</b> [<b>-v</b>] [<b>-g</b> <u>group</u>] [<b>-m</b> <u>mode</u>] [<b>-o</b> <u>owner</u>] <u>directory</u> <u>...</u>

	<b>DESCRIPTION</b>
	The file(s) are copied to the target file or directory. If the destination is a directory, then the
	<u>file</u> is copied into <u>directory</u> with its original filename. If the target file already exists, it is
	either renamed to <u>file.old</u> if the <b>-b</b> option is given or overwritten if permissions allow. An alternate
	backup suffix may be specified via the <b>-B</b> option's argument.

	The options are as follows:

	<b>-B</b> <u>suffix</u>
	Use <u>suffix</u> as the backup suffix if <b>-b</b> is given.

	<b>-b</b> Back up any existing files before overwriting them by renaming them to <u>file.old</u>. See <b>-B</b> for
	specifying a different backup suffix.

	<b>-C</b> Copy the file. If the target file already exists and the files are the same, then don't change
	the modification time of the target.

	<b>-c</b> Copy the file. This is actually the default. The <b>-c</b> option is only included for backwards
	compatibility.

	<b>-d</b> Create directories. Missing parent directories are created as required.

	<b>-f</b> Specify the target's file flags; see chflags(1) for a list of possible flags and their mean-
	ings.

	<b>-g</b> Specify a group. A numeric GID is allowed.

	<b>-M</b> Disable all use of mmap(2).

	<b>-m</b> Specify an alternate mode. The default mode is set to rwxr-xr-x (0755). The specified mode
	may be either an octal or symbolic value; see chmod(1) for a description of possible mode val-
	ues.

	<b>-o</b> Specify an owner. A numeric UID is allowed.

	<b>-p</b> Preserve the modification time. Copy the file, as if the <b>-C</b> (compare and copy) option is spec-
	ified, except if the target file doesn't already exist or is different, then preserve the modi-
	fication time of the file.

	<b>-S</b> Safe copy. Normally, <b>install</b> unlinks an existing target before installing the new file. With
	the <b>-S</b> flag a temporary file is used and then renamed to be the target. The reason this is
	safer is that if the copy or rename fails, the existing target is left untouched.

	<b>-s</b> <b>install</b> exec's the command strip(1) to strip binaries so that <b>install</b> can be portable over a
	large number of systems and binary types.

	<b>-v</b> Causes <b>install</b> to show when <b>-C</b> actually installs something.

	By default, <b>install</b> preserves all file flags, with the exception of the ``nodump'' flag.

	The <b>install</b> utility attempts to prevent moving a file onto itself.

	Installing <u>/dev/null</u> creates an empty file.

	<b>DIAGNOSTICS</b>
	The <b>install</b> utility exits 0 on success, and 1 otherwise.

	<b>FILES</b>
	INS@XXXX If either <b>-S</b> option is specified, or the <b>-C</b> or <b>-p</b> option is used in conjuction with the <b>-s</b>
	option, temporary files named <u>INS@XXXX</u>, where <u>XXXX</u> is decided by mkstemp(3), are created in
	the target directory.

	<b>COMPATIBILITY</b>
	Historically <b>install</b> moved files by default. The default was changed to copy in FreeBSD 4.4.

	<b>SEE</b> <b>ALSO</b>
	chflags(1), chgrp(1), chmod(1), cp(1), mv(1), strip(1), mmap(2), chown(8)

	<b>HISTORY</b>
	The <b>install</b> utility appeared in 4.2BSD.

	<b>BUGS</b>
	Temporary files may be left in the target directory if <b>install</b> exits abnormally.

	File flags cannot be set by fchflags(2) over a NFS file system. Other file systems do not have a con-
	cept of flags. <b>install</b> will only warn when flags could not be set on a file system that does not sup-
	port them.

	<b>install</b> with <b>-v</b> falsely says a file is copied when <b>-C</b> snaps hard links.

	BSD May 7, 2001 BSD

	</pre>
	</body>
	</html>