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