logo

cross-unix-documentation

documentation of similarities and (noteworthy) differencies between Unix systems

install.1x (1970B)


      1 .\" This file is part of Cross Unix Documentation
      2 .\" Copyright © 2019 Haelwenn (lanodan) Monnier <contact@hacktivis.me>
      3 .\" SPDX-License-Identifier: CC-BY-4.0
      4 .Dd 2019-03-03
      5 .Dt INSTALL 1x
      6 .Os
      7 .Sh PROLOG
      8 This manual page is part of
      9 .Lk https://hacktivis.me/git/cross-unix-documentation "Cross-Unix Documentation"
     10 which is an attempt to provide documentation of similarities and (noteworthy) differencies between Unix-like systems. To be used as an addition to the POSIX standard.
     11 .Sh NAME
     12 .Nm install
     13 .Nd install binairies
     14 .Sh SYNOPSIS
     15 .Nm
     16 .Op Fl bcsp
     17 .Op Fl g Ar group
     18 .Op Fl m Ar mode
     19 .Op Fl o Ar owner
     20 .Op Ar source
     21 .Op Ar destination
     22 .Sh DESCRIPTION
     23 .Nm
     24 copies
     25 .Ar source
     26 to
     27 .Ar destination ,
     28 if
     29 .Ar destination
     30 already exists it is removed or renamed if
     31 .Fl b
     32 is specified before source is copied. If destination is a directory then source is copied into destination with its original filename.
     33 The mode of
     34 .Ar destination
     35 is set to 755 unless
     36 .Fl m Ar mode
     37 is specified.
     38 .Bl -tag -width Ds
     39 .It Fl b
     40 backup any existing files before overwriting them by renaming them. (GNU appends '~' by default,
     41 BSDs
     42 appends .old by default)
     43 .It Fl c
     44 Copy the file.
     45 .Bx 4.2
     46 default behaviour is to move the binary unless
     47 .Fl c
     48 is specified. Copying the file is now the default behaviour; the flag is maintained for backwards compatibility only.
     49 .It Fl g Ar group
     50 Sets group ownership.
     51 GNU: instead of the process' current group
     52 .It Fl m Ar mode
     53 Sets alternative mode.
     54 The default mode is set to rwr-xr-x(0755).
     55 .It Fl o Ar owner
     56 Sets user ownership.
     57 .It Fl p
     58 Preserve file access and modification times.
     59 .It Fl s
     60 executes
     61 .Xr strip 1
     62 on each binary/file
     63 .El
     64 .Pp
     65 There are many extra flags in GNU/*BSD versions of
     66 .Xr install 1
     67 but this is kept to the common ones.
     68 .Sh SOURCE
     69 .Nx 8.0 ,
     70 .Fx 12.0 ,
     71 .Ox 6.4 ,
     72 GNU coreutils 8.30, Busybox 1.30.1,
     73 .Bx 4.2 .
     74 .Sh HISTORY
     75 The
     76 .Nm
     77 utility appeared in
     78 .Bx 4.2 .
     79 .Sh AUTHORS
     80 .An Haelwenn (lanodan) Monnier Aq Mt contact+c-u-d@hacktivis.me