Fixed a typo.
[rsync-web.git] / download.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
2 <html>
3 <head>
4 <TITLE>rsync download</TITLE>
5 </head>
6 <!--#include virtual="header.html" -->
7
8 <h2 align="center">rsync download</h2>
9
10 <h2>Source-code releases (tar files)</h2>
11
12 <p>You can grab the latest source code tar file, its gpg signature, and other
13 related files in a variety of ways:
14
15 <ul>
16
17 <li><p>via <a href="/ftp/rsync/">http</a> (the standard web-browser protocol)
18
19 <li><p>via <a href="ftp://ftp.samba.org/pub/rsync/">ftp</a> (file-transfer protocol)
20
21 <li><p>via <i>anonymous rsync</i> from:
22 <code><small>rsync://rsync.samba.org/rsyncftp/</small></code>
23
24 </ul>
25
26 <p>Also, an unpacked copy of the latest development version can be
27 <a href="/ftp/unpacked/rsync/">browsed on the web</a> or obtained via
28 <i>anonymous rsync</i>, as described in the Source Repository section.
29
30 <h2>The GPG Signing Key</h2>
31
32 The GPG signing key that is used to sign the release files and the postings to
33 the rsync-announce mailing list is available from the public pgp key-server
34 network.  If you have automatic key-fetching enabled, just running a normal
35 "gpg&nbsp;--verify" will grab my key automatically.
36 Or, feel free to grab <a href="http://opencoder.net/WayneDavison.key">the gpp
37 key for Wayne Davison</a> manually.
38
39 <h2>Binaries</h2>
40
41 <p>Precompiled binaries are available in most modern OS distributions, so
42 you should first check if you can install an rsync package via your
43 standard package-install tools for your OS.
44
45 <p>There are also packages available from some <b>3rd-parties</b> (note that we cannot
46 vouch for 3rd parties, so use a source that you trust):
47
48 <ul>
49
50 <li><p><a href="http://dag.wieers.com/packages/rsync/">RPMs for Red Hat/Fedora</a> from Dag Wieers.
51
52 <li><p><a href="http://mattmccutchen.net/rsync/#rsync-packages">RPMs packages for i386 linux</a> from Matt McCutchen.
53
54 <li><p><a href="http://sunfreeware.com">Packages for SPARC/Solaris 2.5-10 and x86/Solaris 8-10</a>.
55
56 <li><p><a href="http://itefix.no/cwrsync/">cwRsync</a> is a packaging of rsync for MS Windows.
57
58 </ul>
59
60 <h2>Nightly tar-file snapshots</h2>
61
62 <p><a href="/ftp/rsync/nightly/">Nightly snapshots of the
63 rsync source tree</a> are also available for people who want to try the latest
64 development version.  If you want to track development, then using an anonymous
65 rsync copy will not require as much bandwidth (see below).  Or, updating a git
66 repository can automatically merge your local changes with our version.
67 However, one thing the tar file has going for it is that it contains several
68 generated files that are not present in the source repository (such as
69 configure.sh, config.h.in, etc.).  It can also be helpful if you cannot use
70 rsync or git because of firewall, network, or software issues.
71
72 <h2>Source repository</h2>
73
74 <p> The rsync development tree is publicly available by various methods so that
75 you can try out the latest changes and give feedback to the developers.
76
77 <p> <b>Note:</b> Since the source repository is a work in progress it may, at
78 times, not compile or fail in various ways, though it is usually pretty good.
79
80 <p>Anyone can browse the development history through
81 <a href="http://git.samba.org/?p=rsync.git;a=summary">gitweb</a>.
82
83 <p>You may also use the git version-control system to check out the latest
84 development version, especially if you want to make local changes.  The
85 following command will check-out the latest version into a directory named
86 "rsync":
87
88 <blockquote><pre>git clone git://git.samba.org/rsync.git</pre></blockquote>
89
90 <p>After the initial clone, I also recommend running the git-set-file-times
91 script to set each file's last-modified time based on its last commit (don't
92 run it again after that unless you do a "make distclean").  You'll also need
93 autoconf and autoheader installed for the "prepare-source" command to succeed
94 unless you use either the "fetch" or "fetchall" option (these options can only
95 fetch the most recent generated file that goes with the latest git version):
96
97 <blockquote><pre>cd rsync
98 support/git-set-file-times &nbsp; &nbsp; &nbsp; &nbsp; # optional
99 ./prepare-source</pre></blockquote>
100
101 <p>
102
103 <p>Updating your git checkout with the latest source is very easy:
104
105 <blockquote><pre>git pull</pre></blockquote>
106
107 <p>Those wanting to just obtain the latest source without the entire git
108 repository can either use a nightly tar-file snapshot (see above)
109 or use an <i>anonymous rsync</i> copy of the unpacked source files:
110
111 <blockquote><pre>rsync -av --exclude=.git/ rsync://rsync.samba.org/ftp/unpacked/rsync /dest/dir/</pre></blockquote>
112
113 <h2>Source repository patches</h2>
114
115 <p>There are also various patch files in the "patches" branch of the git
116 repository that represent either some work-in-progress features or features
117 that are considered to be a little too fringe-interest for the main release.
118 You can <a href="/ftp/rsync/dev/patches/">browse the latest patches</a>, which
119 is a collection that applies to the development sources.  The patches are also
120 available in the git repository in the "patches" branch, where you can find
121 older version.  There are also the rsync-patches tar files that are paired
122 with each source tar file.
123
124 <!--#include virtual="footer.html" -->