diff options
Diffstat (limited to 'src/docs/Rsync-Repositories.html')
| -rw-r--r-- | src/docs/Rsync-Repositories.html | 101 |
1 files changed, 101 insertions, 0 deletions
diff --git a/src/docs/Rsync-Repositories.html b/src/docs/Rsync-Repositories.html new file mode 100644 index 0000000..847b22c --- /dev/null +++ b/src/docs/Rsync-Repositories.html @@ -0,0 +1,101 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Rsync Repositories (Carbs Linux User Manual)</title> + +<meta name="description" content="Rsync Repositories (Carbs Linux User Manual)"> +<meta name="keywords" content="Rsync Repositories (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="index.html" rel="start" title="Top"> +<link href="Package-Manager.html" rel="up" title="Package Manager"> +<link href="Setting-up-an-rsync-repository-for-distribution.html" rel="next" title="Setting up an rsync repository for distribution"> +<link href="Packaging-System.html" rel="prev" title="Packaging System"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + +</head> + +<body lang="en"> +<span id="Rsync-Repositories"></span><div class="header"> +<p> +Previous: <a href="Packaging-System.html" accesskey="p" rel="prev">Packaging System</a>, Up: <a href="Package-Manager.html" accesskey="u" rel="up">Package Manager</a> </p> +</div> +<hr> +<span id="Rsync-Repositories-1"></span><h3 class="section">2.3 Rsync Repositories</h3> + +<p>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: +</p> +<div class="example"> +<pre class="example">rsync://carbslinux.org/repo/core +</pre></div> + +<p>Rsync repositories have some few distinctions when it comes to fetching them. +They can be either synced individually or as a “root”. There are 2 important +files, those are <samp>.rsync</samp> and <samp>.rsync_root</samp>. Here is the Carbs Linux +rsync repository structure. +</p> +<div class="example"> +<pre class="example"> / + ----------------- + | | +.rsync core/ + ---------------- + | | + .rsync .rsync_root +</pre></div> + +<p>Unlike git repositories, they don’t have a defined “root” directory. This is +both an advantage and a disadvantage. This way, we can sync individual +repositories, but that also means we need extra files to define root directories +and repository locations. Here is the content for each of these files: +</p> +<div class="example"> +<pre class="example">/.rsync: rsync://carbslinux.org/repo +/core/.rsync: rsync://carbslinux.org/repo/core +/core/.rsync_root: .. +</pre></div> + +<p>The <samp>.rsync_root</samp> file on the core repository points to the upper directory. +If a <samp>.rsync</samp> file exists on the upper directory, this means that is the whole +repository and will sync the entire repository instead of each individual repository. +</p> +<p>If the upper directory doesn’t have this <samp>.rsync</samp> file, this means that this +is an individual repository, and the package manager will fetch accordingly. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="Setting-up-an-rsync-repository-for-distribution.html" accesskey="1">Setting up an rsync repository for distribution</a></td><td> </td><td align="left" valign="top"> +</td></tr> +</table> + + + + +</body> +</html> |