logo

utils-std

Collection of commonly available Unix tools git clone https://anongit.hacktivis.me/git/utils-std.git

install.1 (1879B)

    

  1. .\" utils-std: Collection of commonly available Unix tools
  2. .\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
  3. .\" SPDX-License-Identifier: MPL-2.0
  4. .Dd 2024-05-01
  5. .Dt INSTALL 1
  6. .Os
  7. .Sh NAME
  8. .Nm install
  9. .Nd install binaries
  10. .Sh SYNOPSIS
  11. .Nm
  12. .Op Fl CcDpTv
  13. .Op Fl g Ar group
  14. .Op Fl m Ar mode
  15. .Op Fl o Ar owner
  16. .Ar source...
  17. .Ar destination
  18. .Nm
  19. .Op Fl CcDpTv
  20. .Op Fl g Ar group
  21. .Op Fl m Ar mode
  22. .Op Fl o Ar owner
  23. .Fl t Ar destination
  24. .Ar source...
  25. .Nm
  26. .Fl d
  27. .Op Fl cv
  28. .Op Fl g Ar group
  29. .Op Fl m Ar mode
  30. .Op Fl o Ar owner
  31. .Ar directory...
  32. .Sh DESCRIPTION
  33. .Nm
  34. copies the given
  35. .Ar source
  36. files to
  37. .Ar destination .
  38. If
  39. .Ar destination
  40. is a directory then source is copied into destination with its original filename,
  41. otherwise if it already exists, it is removed.
  42. .Pp
  43. The mode of
  44. .Ar destination
  45. is set to 755 unless
  46. .Fl m Ar mode
  47. is specified.
  48. .Sh OPTIONS
  49. .Bl -tag -width _o_owner
  50. .It Fl C
  51. Ignored, for compatibility with other implementations.
  52. .It Fl c
  53. Copy the file, default behavior in all modern implementations.
  54. .It Fl d
  55. Create directories, including their parents.
  56. .It Fl D
  57. Create parent directories for
  58. .Ar destination .
  59. .br
  60. Note that this option isn't portable, as
  61. .Fx
  62. and
  63. .Nx
  64. implementation of
  65. .Nm
  66. takes an argument like so:
  67. .Fl D Ar destdir
  68. .It Fl g Ar group
  69. Sets group ownership.
  70. .It Fl m Ar mode
  71. Sets alternative mode.
  72. The default mode is set to
  73. .Ql 0755/rwr-xr-x .
  74. .It Fl o Ar owner
  75. Sets user ownership.
  76. .It Fl p
  77. Preserve file access and modification times.
  78. .It Fl t Ar destination
  79. Use
  80. .Ar destination
  81. as directory to copy each
  82. .Ar source
  83. into.
  84. .It Fl T
  85. Treat
  86. .Ar destination
  87. as a normal file.
  88. Which asserts a single
  89. .Ar source
  90. operand.
  91. .It Fl v
  92. print the name of each created file or directory
  93. .El
  94. .Sh EXIT STATUS
  95. .Ex -std
  96. .Sh HISTORY
  97. The
  98. .Nm
  99. utility appeared in
  100. .Bx 4.2 .
  101. .Sh AUTHORS
  102. .An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me