-
Notifications
You must be signed in to change notification settings - Fork 1
/
INSTALL
295 lines (215 loc) · 10.1 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
INSTALL
=======
This version is only known to work on the following systems:
Linux 3.x/4.x/... (i386, x86_64, debian-{7,8,9,10,...}, ubuntu-{14.04,16.04}, ...)
Linux 2.6 (i386, x86_64, debian-5.0.4, ubuntu-10.04, fedora-13)
Solaris 10 10/09 (i386, amd64), 11 (amd64)
OpenSolaris 2009/06 (i386, amd64)
OpenBSD 4.7 (i386, amd64), 6.6 (amd64)
FreeBSD 8.0 (i386, amd64), 12.1 (amd64)
NetBSD 5.0.2 (i386, amd64), 8.1 (amd64)
MacOSX/macOS 10.{4,5,6,11,14,15}, 11 (ppc, i386, x86_64, arm64)
kFreeBSD 20090729 (i386)
GNU/Hurd (i386)
For these systems (or later), just run the "configure" script in the source
directory. It will run the appropriate script in the "conf" directory for
the current host. Perl and GNU make are required for building.
Note: There isn't a real configure script so you will no doubt encounter
problems on other systems. An ISO C and POSIX/XPG4 environment will help
greatly. If your system doesn't have snprintf(3), GNU getopt_long(3),
vsscanf(3), strcasecmp(3), strncasecmp(3), strlcpy(3) or strlcat(3),
uncomment the relevant lines in the libslack/config.h file to include them
in libslack.
If your system doesn't have POSIX 1003.2 compliant regex functions, or they
are buggy, either: install the GNU implementation,
ftp://ftp.gnu.org/gnu/regex/regex-0.12.tar.gz [290K]
(doesn't support internationalisation);
or install Henry Spencer's implementation,
ftp://ftp.zoo.toronto.edu/pub/regex.shar [157K].
If you really, really, really don't want the regular expression functions,
uncomment HAVE_REGEX_H in libslack/config.h to enable the rest of the str
module to be compiled.
If you have a linux-2.2.x system, you must have LinuxThreads-0.8 or
LinuxThreads-0.9 and the latest corresponding version of glibc.
If you have a linux-2.4.x system, you must have at least glibc-2.2.1
and glibc-linuxthreads-2.2.1. They are available from
http://ftp.gnu.org/pub/gnu/glibc/. Older versions can be used but
they have some very nasty bugs.
First, uninstall any previous version (optional):
cd /usr/local/src/daemon-0.8.3
make uninstall
To build and test:
tar xzf daemon-0.8.4.tar.gz
cd daemon-0.8.4
./configure # iff linux, openbsd, freebsd, netbsd, macosx, solaris, gnuhurd or kfreebsd
make # must be gnu make
make test # only tests libslack. to test daemon, see test/README
Note that the configure script is not a GNU autoconf script.
It just has hard-coded settings for certain platforms.
It does not accept all of the usual command line options.
However, it does accept certain options:
--help
Print a help message showing these options, then exit.
--prefix=/path
Changes the installation prefix to a non-standard one (needed for macports).
This also changes the directory that the config file is installed in.
When --prefix=/usr or --prefix=default, the config file is installed in /etc.
Otherwise (e.g. --prefix=/usr/local or --prefix=/opt/local), the config
file is installed under the prefix.
--destdir=/path
Changes the makefile $(DESTDIR) for building packages.
It doesn't affect any paths in the final binary.
--enable-logind
On Linux systems where libsystemd or libelogind headers and libraries
are installed, this option will use them for daemon's --bind option.
It isn't enabled by default.
--disable-logind
This option undoes the effects of --enable-logind.
--enable-mail-test
This option enables testing libslack's mail() function (default).
--disable-mail-test
This option suppresses testing libslack's mail() function which tries
to send an email via the localhost's mail server on port 25 (if any).
This is useful when building packages.
--enable-test
Includes backup implementations of several functions (unnecessary).
--default
This option restores everything to its default state.
It is used by "make dist".
--platform=platform
This option overrides the current platform.
It is used by "./configure --default" and "make dist".
See "./configure --help" for possible values.
To install daemon and its manpage (in /usr/local by default):
make install
To install into somewhere other than /usr/local:
make PREFIX=/opt/daemon install
To install an empty /etc/daemon.conf file and /etc/daemon.conf.d directory:
make install-daemon-conf
To uninstall daemon:
make uninstall
To install libslack and its manpages (into /usr/local by default):
make install-slack
To uninstall libslack:
make uninstall-slack
For more details:
./configure --help
make help
The manpage for daemon is daemon(1). There is one manpage for each module in
libslack (as well as a symlink for each function). The module manpages are
agent(3), coproc(3), daemon(3), err(3), fio(3), hsort(3), lim(3), link(3),
list(3), locker(3), map(3), mem(3), msg(3), net(3), prog(3), prop(3),
pseudo(3), sig(3) and str(3). If necessary, the manpages getopt(3),
snprintf(3) and vsscanf(3) are created as well.
PACKAGING SYSTEMS
=================
Daemon can be installed and kept up-to-date more conveniently on some
systems via their packaging systems.
To install on Debian/Ubuntu Linux systems:
apt install daemon
To install on macOS systems with MacPorts:
port install daemon
To install on macOS or Linux systems with Homebrew:
brew install daemon # homebrew/core version
Or:
brew install rafpkg/tap/daemon # my version
To install on Arch Linux systems with yay:
yay daemon
To install on Slackware Linux systems:
upgradepkg --install-new daemon-0.8.4-i586-1.txz
upgradepkg --install-new daemon-0.8.4-x86_64-1.txz
There might be others.
BINARY PACKAGES
===============
Binary packages are no longer available on daemon's website. The Makefile
contains rules for creating them for several systems (i.e. Debian, Fedora,
OpenBSD, FreeBSD, NetBSD, OSX/macOS, Solaris10) but they might need updating
and they might need to be changed to incorporate signing the package.
The rest of this section shows installation from binary packages if they are
created.
To install from the Fedora RPM binary package (into /usr by default):
rpm -i daemon-X.Y-1.x86_64.rpm # or
rpm -i daemon-X.Y-1.i686.rpm
To install from the OpenBSD binary package (into /usr/local by default):
mv daemon-X.Y-openbsd-amd64.tgz daemon-X.Y.tgz # or
mv daemon-X.Y-openbsd-i386.tgz daemon-X.Y.tgz
# then
pkg_add daemon-X.Y.tar.gz
To install from the FreeBSD binary package (into /usr/local by default):
pkg_add daemon-X.Y-freebsd-amd64.tbz # or
pkg_add daemon-X.Y-freebsd-i386.tbz
To install from the NetBSD binary package (into /usr/local by default):
pkg_add daemon-X.Y-netbsd-amd64.tgz # or
pkg_add daemon-X.Y-netbsd-i386.tgz
To install from the Mac OS X binary package (into /usr/local by default):
cd /usr/local
tar xzf /usr/local/src/daemon-X.Y-macosx-universal.tar.gz # or
tar xzf /usr/local/src/daemon-X.Y-macosx-x86_64.tar.gz # or
tar xzf /usr/local/src/daemon-X.Y-macosx-i386.tar.gz # or
tar xzf /usr/local/src/daemon-X.Y-macosx-powerpc.tar.gz
To install from the Solaris10 binary package (into /usr/local by default):
gunzip daemon-X.Y-solaris-amd64.pkg.gz
pkgadd -d daemon-X.Y-solaris-amd64.pkg
or
gunzip daemon-X.Y-solaris-i386.pkg.gz
pkgadd -d daemon-X.Y-solaris-i386.pkg
REQUIREMENTS
============
Requires GNU make to compile.
Requires perl to run the scripts in the conf directory.
Requires perl to install per-function manpage links.
Requires an ISO C compiler like gcc to compile the source.
Requires pod2man (comes with perl) to make the manpages.
Requires pod2html (comes with perl) to make the html manpages.
Requires POSIX 1003.2 compliant regex functions. See INSTALL.
Requires libpthread. See INSTALL.
PLATFORM NOTES
==============
These platform notes are quite old and probably mostly irrelevant.
Linux
-----
Linux 2.2 always returns 0.0.0.0 on getsockopt(IP_MULTICAST_IF) so
net_multicast_get_interface() always returns 0 under Linux 2.2. Linux 2.4
does not have this bug.
Make sure you have a recent glibc (at least 2.1.3) and libpthread (at least
0.8) (See INSTALL).
Linux 2.2 and 2.4 have a bug-like feature in poll(2). It always times out
10ms later than specified. Libslack corrects for this as best as it can (if
> 10ms -= 10ms) but it's not good enough when you need timers with a
granularity of 10ms. In this case, you have to use
agent_create_with_select() instead of agent_create() under Linux because
select() doesn't have this bug. However, scalable I/O is impossible with
select(). So, if you need timers with a granularity of 10ms *and* scalable
I/O, you need an agent that uses select() in one thread for the timers and
separate agents that use poll() in other threads for the I/O.
Solaris
-------
Solaris (at least 2.6 and 2.7) doesn't return the hardware address or index
of network interfaces from ioctl() with a SIOCGIFINDEX command argument.
Libslack fills in the index in net_interfaces().
UNIX domain datagram sockets aren't supported very nicely. An actual
filesystem entry is needed for the client and it must be unlinked after use.
It's also possible for a malicious local user to deny a client access to the
server. The solution is to always use UNIX domain stream sockets.
Solaris has an inadequate snprintf() function so libslack provides its own
implementation. When configured for Solaris, this snprintf() function will
format exactly like the system's sprintf() function, even though it has
incorrect behaviour with respect to the ISO C standard. I thought this was
better than having thousands of module tests apparently "fail".
OpenBSD
-------
Has the same UNIX domain datagram socket problem as Solaris.
FreeBSD
-------
Has the same UNIX domain datagram socket problem as Solaris.
Can't lock fifos so fifo_open() can't guarantee a unique reader.
Mac OS X
--------
Probably has the same UNIX domain datagram problem as Solaris.
--------------------------------------------------------------------------------
URL: https://libslack.org/daemon
URL: https://raf.org/daemon
GIT: https://github.com/raforg/daemon
GIT: https://codeberg.org/raforg/daemon
Date: 20230824
Author: raf <[email protected]>