hbase

heirloom base
git clone git://git.2f30.org/hbase
Log | Files | Refs | README

install.1b (2935B)

      1 .\"
      2 .\" Copyright (c) 2003 Gunnar Ritter
      3 .\"
      4 .\" This software is provided 'as-is', without any express or implied
      5 .\" warranty. In no event will the authors be held liable for any damages
      6 .\" arising from the use of this software.
      7 .\"
      8 .\" Permission is granted to anyone to use this software for any purpose,
      9 .\" including commercial applications, and to alter it and redistribute
     10 .\" it freely, subject to the following restrictions:
     11 .\"
     12 .\" 1. The origin of this software must not be misrepresented; you must not
     13 .\"    claim that you wrote the original software. If you use this software
     14 .\"    in a product, an acknowledgment in the product documentation would be
     15 .\"    appreciated but is not required.
     16 .\"
     17 .\" 2. Altered source versions must be plainly marked as such, and must not be
     18 .\"    misrepresented as being the original software.
     19 .\"
     20 .\" 3. This notice may not be removed or altered from any source distribution.
     21 .\" Sccsid @(#)install.1b	1.3 (gritter) 4/17/03
     22 .TH INSTALL 1B "4/17/03" "Heirloom Toolchest" "BSD System Compatibility"
     23 .SH NAME
     24 install \- (BSD) install files
     25 .SH SYNOPSIS
     26 .HP
     27 .ad l
     28 .nh
     29 \fB/usr/ucb/install\fR [\fB\-cs\fR] [\fB-g\fI\ group\fR] [\fB\-m\fI\ mode\fR]
     30 [\fB-o\fI\ owner\fR]
     31 \fIfile1 file2\fR
     32 .HP
     33 .ad l
     34 .nh
     35 \fB/usr/ucb/install\fR [\fB\-cs\fR] [\fB-g\fI\ group\fR] [\fB\-m\fI\ mode\fR]
     36 [\fB-o\fI\ owner\fR]
     37 \fIfile\fR\ .\ .\ .\ \fIdirectory\fR
     38 .HP
     39 .ad l
     40 .nh
     41 \fB/usr/ucb/install\fR \fB\-d\fR [\fB\-g\fI\ group\fR] [\fB\-m\fI\ mode\fR]
     42 [\fB\-o\fI\ owner\fR] \fIdirectory\fR
     43 .br
     44 .ad b
     45 .hy 1
     46 .SH DESCRIPTION
     47 The
     48 .I install
     49 command copies one regular file to a destination file
     50 or one or more regular files into a destination directory.
     51 It is commonly used within Makefiles
     52 to install newly created software components.
     53 .PP
     54 If the
     55 .B \-d
     56 option is present,
     57 .I install
     58 creates the named
     59 .IR directory ,
     60 also creating non-existent parent directories.
     61 It is not an error if the directory already exists.
     62 The
     63 .BR \-g ,
     64 .BR \-m ,
     65 and
     66 .B \-o
     67 options
     68 apply to the last pathname component only;
     69 attributes are set whether the directory is newly created or not.
     70 Parent directories are always created using a default mode of 777
     71 minus umask
     72 and default ownerships.
     73 .PP
     74 The following options are also accepted:
     75 .TP 10
     76 .B \-c
     77 This option is ignored and exists for compatibility only.
     78 Ancient versions of this command removed the source file
     79 unless this option was present.
     80 .TP 10
     81 .B \-s
     82 Strip the target files
     83 (i.\|e. execute the
     84 .IR strip (1)
     85 command on them).
     86 .TP 10
     87 \fB\-g\fI group\fR
     88 Use the given
     89 .I group
     90 ownership for target files.
     91 By default,
     92 the group of the invoking user is used.
     93 .TP 10
     94 \fB\-m\fI mode\fR
     95 Set the access permissions of target files to octal
     96 .IR mode .
     97 By default,
     98 mode 755 is used.
     99 .TP 10
    100 \fB\-o\fI owner\fR
    101 Specifies the
    102 .I owner
    103 of target files.
    104 By default,
    105 target files are owned by the invoking user.
    106 .SH "SEE ALSO"
    107 cp(1),
    108 chgrp(1),
    109 chmod(1),
    110 chown(1),
    111 make(1),
    112 mkdir(1),
    113 strip(1)