aboutsummaryrefslogtreecommitdiff
path: root/src/docs/Chroot.html
diff options
context:
space:
mode:
Diffstat (limited to 'src/docs/Chroot.html')
-rw-r--r--src/docs/Chroot.html206
1 files changed, 206 insertions, 0 deletions
diff --git a/src/docs/Chroot.html b/src/docs/Chroot.html
new file mode 100644
index 0000000..07c41b5
--- /dev/null
+++ b/src/docs/Chroot.html
@@ -0,0 +1,206 @@
+<!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>Chroot (Carbs Linux User Manual)</title>
+
+<meta name="description" content="Chroot (Carbs Linux User Manual)">
+<meta name="keywords" content="Chroot (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="Installation.html" rel="up" title="Installation">
+<link href="System-Configuration.html" rel="next" title="System Configuration">
+<link href="Preparing-Environment.html" rel="prev" title="Preparing Environment">
+<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="Chroot"></span><div class="header">
+<p>
+Next: <a href="System-Configuration.html" accesskey="n" rel="next">System Configuration</a>, Previous: <a href="Preparing-Environment.html" accesskey="p" rel="prev">Preparing Environment</a>, Up: <a href="Installation.html" accesskey="u" rel="up">Installation</a> &nbsp; </p>
+</div>
+<hr>
+<span id="Chroot-1"></span><h3 class="section">1.2 Chroot</h3>
+
+<p>Chroot into Carbs Linux!
+</p>
+<div class="example">
+<pre class="example">$ ./cpt-chroot /mnt
+</pre></div>
+
+<span id="Setting-up-repositories"></span><h4 class="subsection">1.2.1 Setting up repositories</h4>
+
+<p>Newest tarballs do not come with repositories, so you will need to manually
+obtain them, and set your <code>CPT_PATH</code> environment variable. Carbs Linux
+repositories can either be obtained by <code>git</code> or <code>rsync</code>.
+While rsync repositories are overall faster and smaller, git offers the whole
+history of the repository and a means to manipulate your repository as you like
+it. If you want to obtain the git repository, you will need to install
+<code>git</code> itself.
+</p>
+<p>The following guide will assume that you put the repositories into
+<samp>~/repos/</samp> directory, but you can put the repositories into any directory
+you want. So go ahead and create that directory. <code>mkdir -p $HOME/repos</code>.
+</p>
+<span id="Obtaining-from-rsync"></span><h4 class="subsubsection">1.2.1.1 Obtaining from rsync</h4>
+
+<p>Carbs Linux rsync repositories live in <a href="rsync://carbslinux.org/repo">rsync://carbslinux.org/repo</a>. In
+order to obtain it, run the following:
+</p>
+<div class="example">
+<pre class="example">$ rsync -avc rsync://carbslinux.org/repo $HOME/repos/carbs
+</pre></div>
+
+<span id="Obtaining-from-git"></span><h4 class="subsubsection">1.2.1.2 Obtaining from git</h4>
+
+<p>Carbs Linux git repositories can be found both from the main server and GitHub
+(mirror). Here are both their repository links. You can clone any of them.
+</p>
+<ul>
+<li> <a href="git://git.carbslinux.org/repository">git://git.carbslinux.org/repository</a>
+</li><li> <a href="https://github.com/carbslinux/repository">https://github.com/carbslinux/repository</a>
+</li></ul>
+
+<div class="example">
+<pre class="example">$ git clone git://git.carbslinux.org/repository $HOME/repos/carbs
+</pre></div>
+
+<span id="Making-the-package-manager-use-the-repositories"></span><h4 class="subsubsection">1.2.1.3 Making the package manager use the repositories</h4>
+
+<p>In your shell&rsquo;s configuration file, or in your <samp>~/.profile</samp> file, add the
+following lines:
+</p>
+<div class="example">
+<pre class="example">export CPT_PATH=''
+CPT_PATH=$CPT_PATH:$HOME/repos/carbs/core
+CPT_PATH=$CPT_PATH:$HOME/repos/carbs/extra
+CPT_PATH=$CPT_PATH:$HOME/repos/carbs/xorg
+CPT_PATH=$CPT_PATH:$HOME/repos/carbs/community
+export CPT_PATH
+</pre></div>
+
+<span id="Updating-packages"></span><h4 class="subsection">1.2.2 Updating packages</h4>
+
+<p>It is good practice to make sure your system is up to date, especially before
+building new packages. If there is an update for the package manager you will
+need to update twice.
+</p>
+<div class="example">
+<pre class="example">$ cpt update
+</pre></div>
+
+<span id="Installing-packages"></span><h4 class="subsection">1.2.3 Installing packages</h4>
+
+<p>Since you are operating on a really small base, you might need to build and
+install new programs to extend the functionality of your system. In order to
+build and install packages new packages in Carbs, you need to execute the
+following.
+</p>
+<div class="example">
+<pre class="example">$ cpt build package
+$ cpt install package
+</pre></div>
+
+<span id="Essential-Software"></span><h4 class="subsection">1.2.4 Essential Software</h4>
+
+<p>Here is a list of software that you might want to have on your system.
+</p>
+<p>BOOTLOADERS
+</p><ul>
+<li> efibootmgr
+</li><li> grub
+</li></ul>
+<p>FILESYSTEMS
+</p><ul>
+<li> e2fsprogs
+</li><li> dosfstools
+</li><li> ntfs-3g
+</li></ul>
+<p>NETWORKING
+</p><ul>
+<li> dhcpcd
+</li><li> wpa_supplicant
+</li></ul>
+<p>TEXT EDITORS
+</p><ul>
+<li> nano
+</li><li> vim
+</li><li> neatvi
+</li><li> nvi
+</li><li> emacs
+</li><li> emacs-nox (terminal-only version of emacs)
+</li></ul>
+<p>USER SHELLS
+</p><ul>
+<li> bash
+</li><li> zsh
+</li><li> dash
+</li><li> oksh
+</li><li> rc
+</li></ul>
+<p>POSIX BASE UTILITIES
+</p><ul>
+<li> busybox
+</li><li> sbase
+</li><li> coreutils
+</li></ul>
+<p>DOCUMENTATION
+</p><ul>
+<li> carbs-docs
+</li><li> man-pages
+</li><li> man-pages-posix
+</li></ul>
+
+<span id="Obtaining-the-documentation-_0028optional_0029"></span><h4 class="subsection">1.2.5 Obtaining the documentation (optional)</h4>
+
+<p>All the documentation for Carbs Linux can be found on a single info manual to be
+viewed offline. You can obtain texinfo or the info (standalone) package in order
+to view the documentation.
+</p>
+<div class="example">
+<pre class="example">Install the documentation.
+$ cpt b carbs-docs &amp;&amp; cpt i carbs-docs
+
+Install either texinfo or the info package. We will be installing standalone info
+as it doesn't need perl.
+$ cpt b info &amp;&amp; cpt i info
+
+You can then run info and navigate through the documentation.
+$ info carbslinux
+</pre></div>
+
+<hr>
+<div class="header">
+<p>
+Next: <a href="System-Configuration.html" accesskey="n" rel="next">System Configuration</a>, Previous: <a href="Preparing-Environment.html" accesskey="p" rel="prev">Preparing Environment</a>, Up: <a href="Installation.html" accesskey="u" rel="up">Installation</a> &nbsp; </p>
+</div>
+
+
+
+</body>
+</html>