Fix devices test on OS w/o hard-linked devices.
[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 to omit its prerequisite args,
37but keep in mind that this will make a manual removal of "proto.h-tstamp"
38necessary anytime the function prototypes change.
39
40RPM NOTES
41---------
42
43Under packaging you will find .spec files for several distributions.
44The .spec file in packaging/lsb can be used for Linux systems that
45adhere to the Linux Standards Base (e.g., RedHat and others).
46
47HP-UX NOTES
48-----------
49
50The HP-UX 10.10 "bundled" C compiler seems not to be able to cope with
51ANSI C. You may see this error message in config.log if ./configure
52fails:
53
54 (Bundled) cc: "configure", line 2162: error 1705: Function prototypes are an ANSI feature.
55
56Install gcc or HP's "ANSI/C Compiler".
57
58MAC OSX NOTES
59-------------
60
61Some versions of Mac OS X (Darwin) seem to have an IPv6 stack, but do
62not completely implement the "New Sockets" API.
63
64<http://www.ipv6.org/impl/mac.html> says that Apple started to support
65IPv6 in 10.2 (Jaguar). If your build fails, try again after running
66configure with --disable-ipv6.
67
68IBM AIX NOTES
69-------------
70
71IBM AIX has a largefile problem with mkstemp. See IBM PR-51921.
72The workaround is to append the below to config.h
73 #ifdef _LARGE_FILES
74 #undef HAVE_SECURE_MKSTEMP
75 #endif