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://gitweb.samba.org/?p=rsync.git">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.git" repository that
 116 represent either some work-in-progress features or features that are considered
 117 to be a little too fringe-interest for the main release.  You can can use
 118 gitweb to <a href="http://gitweb.samba.org/?p=rsync.git/patches.git">browse the
 119 latest patches</a>.  Each branch in the patches repository matches the branch
 120 of the same name in the <a href="http://gitweb.samba.org/?p=rsync.git">main
 121 repository</a>, so "master" matches "master", and "b3.0.x" matches "b3.0.x".
 122
 123 <p>Use the
 124 <a href="http://gitweb.samba.org/?p=rsync.git/patches.git;a=tree;h=refs/heads/master;hb=master">tree
 125 view of the master branch</a> or the
 126 <a href="http://gitweb.samba.org/?p=rsync.git/patches.git;a=tree;h=refs/heads/b3.0.x;hb=refs/heads/b3.0.x">tree
 127 view of the b3.0.x branch</a> to get to the contents of individual files (i.e. click
 128 on the "raw" link for the file you want).
 129
 130 <p>Each release of rsync also has an associated sync-patches-VERSION.tar.gz
 131 file with the patches as they existed at the time of the release.
 132
 133 <!--#include virtual="footer.html" -->