Handle EINTR when reading the pre-xfer exec message.
[rsync/rsync.git] / INSTALL
... / ...
CommitLineData
1To build and install rsync:
2
3 $ ./configure
4 $ make
5 # make install
6
7You may set the installation directory and other parameters by options
8to ./configure. To see them, use:
9
10 $ ./configure --help
11
12Configure tries to figure out if the local system uses group "nobody" or
13"nogroup" by looking in the /etc/group file. (This is only used for the
14default group of an rsync daemon, which attempts to run with "nobody"
15user and group permissions.) You can change the default user and group
16for the daemon by editing the NOBODY_USER and NOBODY_GROUP defines in
17config.h, or just override them in your /etc/rsyncd.conf file.
18
19As of 2.4.7, rsync uses Eric Troan's popt option-parsing library. A
20cut-down copy of a recent release is included in the rsync distribution,
21and will be used if there is no popt library on your build host, or if
22the --with-included-popt option is passed to ./configure.
23
24If you configure using --enable-maintainer-mode, then rsync will try
25to pop up an xterm on DISPLAY=:0 if it crashes. You might find this
26useful, but it should be turned off for production builds.
27
28MAKE COMPATIBILITY
29------------------
30
31Note that Makefile.in has a rule that uses a wildcard in a prerequisite. If
32your make has a problem with this rule, you will see an error like this:
33
34 Don't know how to make ./*.c
35
36You can change the "proto.h-tstamp" target in Makefile.in to list all the *.c
37filenames explicitly in order to avoid this issue.
38
39RPM NOTES
40---------
41
42Under packaging you will find .spec files for several distributions.
43The .spec file in packaging/lsb can be used for Linux systems that
44adhere to the Linux Standards Base (e.g., RedHat and others).
45
46HP-UX NOTES
47-----------
48
49The HP-UX 10.10 "bundled" C compiler seems not to be able to cope with
50ANSI C. You may see this error message in config.log if ./configure
51fails:
52
53 (Bundled) cc: "configure", line 2162: error 1705: Function prototypes are an ANSI feature.
54
55Install gcc or HP's "ANSI/C Compiler".
56
57MAC OSX NOTES
58-------------
59
60Some versions of Mac OS X (Darwin) seem to have an IPv6 stack, but do
61not completely implement the "New Sockets" API.
62
63<http://www.ipv6.org/impl/mac.html> says that Apple started to support
64IPv6 in 10.2 (Jaguar). If your build fails, try again after running
65configure with --disable-ipv6.
66
67IBM AIX NOTES
68-------------
69
70IBM AIX has a largefile problem with mkstemp. See IBM PR-51921.
71The workaround is to append the below to config.h
72 #ifdef _LARGE_FILES
73 #undef HAVE_SECURE_MKSTEMP
74 #endif