Tweak the list of 3rd-party rsync versions.
[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="https://download.samba.org/pub/rsync/">http</a> (the standard web-browser protocol)
18
19 <li><p>via <i>anonymous rsync</i> from:
20 <code><small>rsync://rsync.samba.org/rsyncftp/</small></code>
21
22 </ul>
23
24 <p>Also, an unpacked copy of the latest development version can be
25 <a href="https://download.samba.org/pub/unpacked/rsync/">browsed on the web</a> or obtained via
26 <i>anonymous rsync</i>, as described in the Source Repository section.
27
28 <h2>The GPG Signing Key</h2>
29
30 The GPG signing key that is used to sign the release files and the postings to
31 the rsync-announce mailing list is available from the public pgp key-server
32 network.  If you have automatic key-fetching enabled, just running a normal
33 "gpg&nbsp;--verify" will grab my key automatically.
34 Or, feel free to grab <a href="http://opencoder.net/WayneDavison.key">the gpp
35 key for Wayne Davison</a> manually.
36
37 <h2>Binaries</h2>
38
39 <p>Precompiled binaries are available in most modern OS distributions, so
40 you should first check if you can install an rsync package via your
41 standard package-install tools for your OS.
42
43 <p>There are also packages available from some <b>3rd-parties</b> (note that we cannot
44 vouch for 3rd parties, so use a source that you trust):
45
46 <ul>
47
48 <li><p><a href="https://www.cygwin.com/">Cygwin</a> is a Posix runtime for MS Windows that includes rsync among their many packages.</p></li>
49
50 <li><p><a href="https://www.itefix.net/cwrsync">cwRsync</a> is a native packaging of rsync for MS Windows (they appear to only provide paid releases, though).</p></li>
51
52 </ul>
53
54 <h2>Nightly tar-file snapshots</h2>
55
56 <p><a href="https://download.samba.org/pub/rsync/nightly/">Nightly snapshots of the
57 rsync source tree</a> are also available for people who want to try the latest
58 development version.  If you want to track development, then using an anonymous
59 rsync copy will not require as much bandwidth (see below).  Or, updating a git
60 repository can automatically merge your local changes with our version.
61 However, one thing the tar file has going for it is that it contains several
62 generated files that are not present in the source repository (such as
63 configure.sh, config.h.in, etc.).  It can also be helpful if you cannot use
64 rsync or git because of firewall, network, or software issues.
65
66 <h2>Source repository</h2>
67
68 <p> The rsync development tree is publicly available by various methods so that
69 you can try out the latest changes and give feedback to the developers.
70
71 <p> <b>Note:</b> Since the source repository is a work in progress it may, at
72 times, not compile or fail in various ways, though it is usually pretty good.
73
74 <p>Anyone can browse the development history through
75 <a href="http://gitweb.samba.org/?p=rsync.git">gitweb</a>.
76
77 <p>You may also use the git version-control system to check out the latest
78 development version, especially if you want to make local changes.  The
79 following command will check-out the latest version into a directory named
80 "rsync":
81
82 <blockquote><pre>git clone git://git.samba.org/rsync.git</pre></blockquote>
83
84 <p>After the initial clone, I also recommend running the git-set-file-times
85 script to set each file's last-modified time based on its last commit (don't
86 run it again after that unless you do a "make distclean").  You'll also need
87 autoconf and autoheader installed for the "prepare-source" command to succeed
88 unless you use either the "fetch" or "fetchall" option (these options can only
89 fetch the most recent generated file that goes with the latest git version):
90
91 <blockquote><pre>cd rsync
92 support/git-set-file-times &nbsp; &nbsp; &nbsp; &nbsp; # optional
93 ./prepare-source</pre></blockquote>
94
95 <p>
96
97 <p>Updating your git checkout with the latest source is very easy:
98
99 <blockquote><pre>git pull</pre></blockquote>
100
101 <p>Those wanting to just obtain the latest source without the entire git
102 repository can either use a nightly tar-file snapshot (see above)
103 or use an <i>anonymous rsync</i> copy of the unpacked source files:
104
105 <blockquote><pre>rsync -av --exclude=.git/ rsync://rsync.samba.org/ftp/unpacked/rsync /dest/dir/</pre></blockquote>
106
107 <h2>Source repository patches</h2>
108
109 <p>There are also various patch files in the "rsync-patches.git" repository that
110 represent either some work-in-progress features or features that are considered
111 to be a little too fringe-interest for the main release.  You can use
112 gitweb to <a href="http://gitweb.samba.org/?p=rsync-patches.git">browse the
113 latest patches</a>.  Each branch in the patches repository matches the branch
114 of the same name in the <a href="http://gitweb.samba.org/?p=rsync.git">main
115 repository</a>, so "master" matches "master", and "b3.0.x" matches "b3.0.x".
116
117 <p>Use the
118 <a href="http://gitweb.samba.org/?p=rsync-patches.git;a=tree;h=refs/heads/master;hb=master">tree
119 view of the master branch</a> or the
120 <a href="http://gitweb.samba.org/?p=rsync-patches.git;a=tree;h=refs/heads/b3.0.x;hb=refs/heads/b3.0.x">tree
121 view of the b3.0.x branch</a> to get to the contents of individual files (i.e. click
122 on the "raw" link for the file you want).
123
124 <p>Each release of rsync also has an associated sync-patches-VERSION.tar.gz
125 file with the patches as they existed at the time of the release.
126
127 <!--#include virtual="footer.html" -->