aboutsummaryrefslogtreecommitdiff
path: root/doc/rsync-repositories.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/rsync-repositories.txt')
-rw-r--r--doc/rsync-repositories.txt43
1 files changed, 28 insertions, 15 deletions
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.