Bugzilla Bug 52666

There are three or four different ways to start and setup the rsync server
depending on your starting point.  This makes it very confusing to set up
either an official or local rsync server.

1.  net-misc/rsync ebuild init.d script doesn't use the start-stop-daemon -
should it? The offical rsync mirror docs say it should.

2.  app-admin/gentoo-rsync-mirror is outdated compared to the
http://www.gentoo.org/doc/en/rsync.xml Official doc.  The ebuild still uses the
insecure (?) chroot=no), no start-stop-daemon and different rsync options etc.

3.  Looking at the differences, I believe the official docs at
http://www.gentoo.org/doc/en/rsync.xml are the most current.  It uses the
start-stop-daemon, simple, secure options, chroot=yes, etc.

4.  There are a couple of posts in the forum talking about setting up an rsync
server.  They are outdated.

What I would recommend is to:

1.  Sync up the ebuilds for net-misc/rsync and app-admin/gentoo-rsync-mirror
with respect to the init.d script.  Since the net-misc/rsync config is there
but has no config options, consider an uncomment this section for local rsync
and this section for official mirror etc.  That way the gentoo-mirror ebuild
would not have a duplicate config and only add the special scripts to manage an
official mirror.  Would this make keeping the ebuilds in sync easier?  Would
this make it easier for a user to create a local rsync server without tempting
him with every 30 min updated automated sync scripts?

2.  Add local rsync mirror options to the Official docs and the
gentoo-rsync-mirror ebuilds if the configs aren't consolidated as above.  There
are several forum posts suggesting many people are setting up a local rsync
server using the offical doc's and syncing every 30 min and other bloopers
because the docs said it was important.

I've set up a local rsync howto on the forum that may be of help. 

http://forums.gentoo.org/viewtopic.php?t=180336

updated the ebuild to add more info to the einfo message. That should clarify
when to sync every 30 min vs. once a day.

Also updated rsyncd.conf and rsyncd.init to reflect current gentoo policy.

As for synchronizing between net-misc/rsync, I don't think we should do that. 
rsyncd.conf, for one, has to be totally different in
app-admin/gentoo-rsync-mirror.  I'm not sure about the rsync init script, but
that's up to the maintainer of net-misc/rsync.

Basically, Gentoo rsync policy only applies to official gentoo mirrors.  I'm
not sure we should make widespread changes to the main net-misc/rsync package
just to avoid duplicating a few files.

cc'ing vapier on this bug since he maintains net-misc/rsync.  Mike -- if you
want to update the init script per the suggestion on this bug, feel free.  Up
to you.

marking as fixed.