From 5e0f4a31787c2d70d6315bcd3b8269ecc28fe16b Mon Sep 17 00:00:00 2001 From: merakor Date: Mon, 8 Jun 2020 08:21:03 +0000 Subject: docs: update FossilOrigin-Name: 847bc8766ca22fb708b3bab900513b5468720d80e8689bb7e75feeb8e424a1e9 --- doc/rsync-repositories.txt | 43 ++++++++++++++++++++++++++++--------------- 1 file changed, 28 insertions(+), 15 deletions(-) (limited to 'doc') diff --git a/doc/rsync-repositories.txt b/doc/rsync-repositories.txt index dfe3cb5..999824d 100644 --- a/doc/rsync-repositories.txt +++ b/doc/rsync-repositories.txt @@ -1,27 +1,28 @@ RSYNC REPOSITORIES +================================================================================= RSYNC repositories are simple to serve and simple to use. In the repository -directory, there needs to be a '.rsync' file that points to the remote of -the repository. This is used in order to fetch changes from the upstream. -'.rsync' file looks like this for the core repository: +directory, there needs to be a '.rsync' file that points to the remote of the +repository. This is used in order to fetch changes from the upstream. '.rsync' +file looks like this for the core repository: rsync://carbslinux.org/repo/core -RSYNC repositories have some few distinctions when it comes to fetching -them. Unlike GIT repositories, they don't have a defined "root" directory. -When there are multiple repositories in a shared repository (such as the -Carbs Linux and KISS Linux repositories), individual repositories need to -have this '.rsync' file. This doesn't, however, slow down operations. -Fetching from rsync repositories are still considerably faster and smaller. +RSYNC repositories have some few distinctions when it comes to fetching them. +Unlike GIT repositories, they don't have a defined "root" directory. When there +are multiple repositories in a shared repository (such as the Carbs Linux and +KISS Linux repositories), individual repositories need to have this '.rsync' +file. This doesn't, however, slow down operations. Fetching from rsync +repositories are still considerably faster and smaller. -SETTING UP AN RSYNC REPOSITORY -Carbs Linux repositories automatically sync from the git repostitories -and serve it through the rsync daemon. Here is a sample shell script -that I use in order to sync repositories. Feel free to customize for your -own use. +Setting up an rsync repository +--------------------------------------------------------------------------------- +Carbs Linux repositories automatically sync from the git repostitories and serve +it through the rsync daemon. Here is a sample shell script that I use in order to +sync repositories. Feel free to customize for your own use. #!/bin/sh HOSTNAME=rsync://carbslinux.org/repo @@ -41,7 +42,7 @@ own use. You can then create an 'rsync' user for serving the repositories. - -> adduser -SD rsync + $ adduser -SD rsync Create '/etc/rsyncd.conf' and a service configuration as well. @@ -63,3 +64,15 @@ rsyncd.conf: #!/bin/sh exec rsync --daemon --no-detach + + +Switching to an rsync repository +--------------------------------------------------------------------------------- + +It is considerably easy to switch to the Carbs Linux rsync repository. + + $ mkdir -p /path/to/repo + $ rsync -az rsync://carbslinux.org/repo/ /path/to/repo + +This will fetch the repository to the given location, you can then add it to your +$KISS_PATH. -- cgit v1.2.3