logo

cross-unix-documentation

documentation of similarities and (noteworthy) differencies between Unix systems git clone https://hacktivis.me/git/cross-unix-documentation.git

install.1x (2389B)


  1. .\" This file is part of Cross Unix Documentation
  2. .\" Copyright © 2019-2020 Haelwenn (lanodan) Monnier <contact@hacktivis.me>
  3. .\" SPDX-License-Identifier: CC-BY-4.0
  4. .Dd 2019-11-16
  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. .Ss BusyBox, GNU coreutils, OpenBSD
  16. .Nm
  17. .Op Fl bcDsp
  18. .Op Fl g Ar group
  19. .Op Fl m Ar mode
  20. .Op Fl o Ar owner
  21. .Op Ar source
  22. .Op Ar destination
  23. .Ss NetBSD, FreeBSD
  24. .Nm
  25. .Op Fl bcsp
  26. .Op Fl g Ar group
  27. .Op Fl m Ar mode
  28. .Op Fl o Ar owner
  29. .Op Fl D Ar destdir
  30. .Op Ar source
  31. .Op Ar destination
  32. .Sh DESCRIPTION
  33. .Nm
  34. copies
  35. .Ar source
  36. to
  37. .Ar destination ,
  38. if
  39. .Ar destination
  40. already exists it is removed or renamed if
  41. .Fl b
  42. is specified before source is copied. If destination is a directory then source is copied into destination with its original filename.
  43. The mode of
  44. .Ar destination
  45. is set to 755 unless
  46. .Fl m Ar mode
  47. is specified.
  48. .Bl -tag -width Ds
  49. .It Fl b
  50. backup any existing files before overwriting them by renaming them. (GNU appends '~' by default,
  51. BSDs
  52. appends .old by default)
  53. .It Fl c
  54. Copy the file.
  55. .Bx 4.2
  56. default behaviour is to move the binary unless
  57. .Fl c
  58. is specified. Copying the file is now the default behaviour; the flag is maintained for backwards compatibility only.
  59. .It Fl D
  60. BusyBox, GNU coreutils,
  61. .Ox :
  62. Create any missing directories for
  63. .Ar destination
  64. (which still points to a file).
  65. .It Fl D Ar destdir
  66. .Nx ,
  67. .Fx :
  68. Sets the DESTDIR (top of the file hierarchy) that the items are installed in to.
  69. .It Fl g Ar group
  70. Sets group ownership.
  71. GNU: instead of the process' current group
  72. .It Fl m Ar mode
  73. Sets alternative mode.
  74. The default mode is set to rwr-xr-x(0755).
  75. .It Fl o Ar owner
  76. Sets user ownership.
  77. .It Fl p
  78. Preserve file access and modification times.
  79. .It Fl s
  80. executes
  81. .Xr strip 1
  82. on each binary/file
  83. .El
  84. .Pp
  85. There are many extra flags in GNU/*BSD versions of
  86. .Xr install 1
  87. but this is kept to the common ones.
  88. .Sh SOURCE
  89. .Nx 8.1 ,
  90. .Fx 12.1 ,
  91. .Ox 6.6 ,
  92. GNU coreutils 8.30, Busybox 1.30.1,
  93. .Bx 4.2 .
  94. .Sh HISTORY
  95. The
  96. .Nm
  97. utility appeared in
  98. .Bx 4.2 .
  99. .Sh AUTHORS
  100. .An Haelwenn (lanodan) Monnier Aq Mt contact+c-u-d@hacktivis.me