xinstall.1 - sbase - suckless unix tools
(HTM) git clone git://git.suckless.org/sbase
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) 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.