sbase

suckless unix tools
git clone git://git.suckless.org/sbase
Log | Files | Refs | README | LICENSE

xinstall.1 (1552B)


      1 .Dd December 3, 2016
      2 .Dt INSTALL 1
      3 .Os sbase
      4 .Sh NAME
      5 .Nm install
      6 .Nd copy files and set attributes
      7 .Sh SYNOPSIS
      8 .Nm
      9 .Op Fl g Ar group
     10 .Op Fl o Ar owner
     11 .Op Fl m Ar mode
     12 .Po
     13 .Fl d Ar dir ...
     14 |
     15 .Op Fl D
     16 .Po
     17 .Fl t Ar dest
     18 .Ar source ...
     19 |
     20 .Ar source ...
     21 .Ar dest
     22 .Pc
     23 .Pc
     24 .Sh DESCRIPTION
     25 .Nm
     26 copies
     27 .Ar source
     28 to
     29 .Ar dest .
     30 If more than one
     31 .Ar source
     32 is given
     33 .Ar dest
     34 is treated as a directory.
     35 Otherwise
     36 .Ar dest
     37 is treated as a filename.
     38 .Nm
     39 can also change the attributes of the copies.
     40 .Sh OPTIONS
     41 .Bl -tag -width Ds
     42 .It Fl d
     43 Create the directories
     44 .Ar dir .
     45 .It Fl D
     46 Create missing parent directories to
     47 .Ar dest .
     48 If
     49 .Ar dest
     50 is to be treated as a directory, it is created too if missing.
     51 .It Fl g Ar group
     52 Change the installed files' group to
     53 .Ar group .
     54 This may be a group name or a group identifier.
     55 .It Fl m Ar mode
     56 Change the file modes.
     57 Both numerical and symbolic values are supported.
     58 See
     59 .Xr chmod 1
     60 for the syntex.
     61 Default mode 0755.
     62 If a file has the mode 0644 and is copied with
     63 .It Fl o Ar owner
     64 Change the installed files' owner to
     65 .Ar owner .
     66 This may be a user name or a user identifier.
     67 .It Fl t Ar dest
     68 Copy files into the directory
     69 .Ar dest .
     70 .Nm install ,
     71 the copy's mode will be 0755 unless
     72 .Fl m
     73 is used to select another mode.
     74 When the symbolic notation is used, the base mode is 0000.
     75 .El
     76 .Sh SEE ALSO
     77 .Xr chmod 1 ,
     78 .Xr chown 1 ,
     79 .Xr cp 1 ,
     80 .Xr mkdir 1
     81 .Sh STANDARDS
     82 The
     83 .Nm
     84 utility is not standardized.
     85 This implementation is a subset of the GNU implementation and a subset
     86 with extensions to the FreeBSD implementation.