diff options
| -rw-r--r-- | carbslinux.org | 8 | ||||
| -rw-r--r-- | carbslinux.texi | 11 | ||||
| -rw-r--r-- | carbslinux.txt | 8 | ||||
| -rw-r--r-- | install.org | 39 | ||||
| -rw-r--r-- | install.txt | 6 |
5 files changed, 22 insertions, 50 deletions
diff --git a/carbslinux.org b/carbslinux.org index 21b8117..1a28795 100644 --- a/carbslinux.org +++ b/carbslinux.org @@ -1,5 +1,5 @@ #+TITLE: Carbs Linux User Manual -#+AUTHOR: Cem Keylan +#+AUTHOR: Ceylin Keylan #+TEXINFO_FILENAME: carbslinux.info #+TEXINFO_DIR_CATEGORY: System Administration #+TEXINFO_DIR_TITLE: Carbs Linux: (carbslinux) @@ -88,7 +88,7 @@ with your favorite pager. You can install either the @command{info} or :COPYING: t :END: -Copyright \copy 2020-{{{time(%Y)}}} Cem Keylan +Copyright \copy 2020-{{{time(%Y)}}} Ceylin Keylan #+BEGIN_QUOTE Permission is granted to copy, distribute and/or modify this document @@ -437,7 +437,7 @@ su foo :END: Kernel isn't managed under the main repositories, even though you could package -one for your personal use. Here is an [[https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux][example kernel package]], which you will +one for your personal use. Here is an [[https://github.com/ceylinkeylan/kiss-repository/tree/master/personal/linux][example kernel package]], which you will need to reconfigure for your specific setup if you want to make use of it. *** Obtaining the kernel sources @@ -564,7 +564,7 @@ You can now manually edit your fstab entry, or you can use the genfstab tool. If you want to use the tool, exit the chroot and run the following: #+BEGIN_SRC sh -wget https://github.com/cemkeylan/genfstab/raw/master/genfstab +wget https://github.com/ceylinkeylan/genfstab/raw/master/genfstab chmod +x genfstab ./genfstab -U /mnt >> /mnt/etc/fstab #+END_SRC diff --git a/carbslinux.texi b/carbslinux.texi index d3be7f9..40864aa 100644 --- a/carbslinux.texi +++ b/carbslinux.texi @@ -7,7 +7,7 @@ @c %**end of header @copying -Copyright @copyright{} 2020-2024 Cem Keylan +Copyright @copyright{} 2020-2026 Ceylin Keylan @quotation Permission is granted to copy, distribute and/or modify this document @@ -28,7 +28,7 @@ Documentation License." @finalout @titlepage @title Carbs Linux User Manual -@author Cem Keylan +@author Ceylin Keylan @page @vskip 0pt plus 1filll @insertcopying @@ -56,6 +56,7 @@ This documentation is also available in the distribution by the with your favorite pager. You can install either the @command{info} or @command{texinfo} for doing the first. @end ifhtml + @end ifnottex @menu @@ -513,7 +514,7 @@ su foo @section Kernel Kernel isn't managed under the main repositories, even though you could package -one for your personal use. Here is an @uref{https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux, example kernel package}, which you will +one for your personal use. Here is an @uref{https://github.com/ceylinkeylan/kiss-repository/tree/master/personal/linux, example kernel package}, which you will need to reconfigure for your specific setup if you want to make use of it. @menu @@ -644,7 +645,7 @@ You can now manually edit your fstab entry, or you can use the genfstab tool. If you want to use the tool, exit the chroot and run the following: @example -wget https://github.com/cemkeylan/genfstab/raw/master/genfstab +wget https://github.com/ceylinkeylan/genfstab/raw/master/genfstab chmod +x genfstab ./genfstab -U /mnt >> /mnt/etc/fstab @end example @@ -1833,4 +1834,4 @@ recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software. -@bye
\ No newline at end of file +@bye diff --git a/carbslinux.txt b/carbslinux.txt index 5fde782..59981aa 100644 --- a/carbslinux.txt +++ b/carbslinux.txt @@ -2,7 +2,7 @@ CARBS LINUX USER MANUAL - Cem Keylan + Ceylin Keylan _________________________ @@ -69,7 +69,7 @@ with the info reader. It is divided into sections and easier to read. 1 Copying ========= - Copyright (c) 2020-2024 Cem Keylan + Copyright (c) 2020-2026 Ceylin Keylan Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free @@ -442,7 +442,7 @@ with the info reader. It is divided into sections and easier to read. [example kernel package] -<https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux> +<https://github.com/ceylinkeylan/kiss-repository/tree/master/personal/linux> 2.4.1 Obtaining the kernel sources ---------------------------------- @@ -574,7 +574,7 @@ with the info reader. It is divided into sections and easier to read. the following: ,---- - | wget https://github.com/cemkeylan/genfstab/raw/master/genfstab + | wget https://github.com/ceylinkeylan/genfstab/raw/master/genfstab | chmod +x genfstab | ./genfstab -U /mnt >> /mnt/etc/fstab `---- diff --git a/install.org b/install.org index 59d3acc..dbc22d6 100644 --- a/install.org +++ b/install.org @@ -1,6 +1,6 @@ -# Created 2024-03-06 Wed 16:19 +# Created 2026-08-17 Mon 20:20 #+title: Carbs Linux Installation Guide -#+author: Cem Keylan +#+author: Ceylin Keylan These are the step-by-step instructions for installing Carbs Linux. It can be acquired as plain-text to be viewed offline with a pager from [[https://carbslinux.org/install.txt]]. @@ -24,7 +24,6 @@ You will need the following programs in order to install Carbs Linux: Rest of these instructions will assume that you have set all of these up, and will continue on that point. - ** Download First, we need to download the rootfs tarball. You can do the following in order to obtain the rootfs. If you are using an i686 machine, replace the =x86_64= @@ -36,7 +35,6 @@ write it every time. wget $URL/carbs-rootfs.tar.xz.sha256 sha256sum -c carbs-rootfs.tar.xz.sha256 #+end_src - ** Signature verification It is highly recommended to verify the signature of the tarball. You will need the OpenBSD tool =signify(1)= for this. Many distributions provide a package for @@ -60,7 +58,7 @@ latest Signify public key is also available on the [[https://git.carbslinux.org/ check the validity of the public key from multiple locations, or just copy paste that portion to a file and use that instead. -#+begin_src sh +#+begin_src sh :noweb yes PUBKEY=carbslinux-2023.02.pub wget https://dl.carbslinux.org/keys/$PUBKEY #+end_src @@ -76,7 +74,6 @@ If everything went alright, this should output: #+begin_example Signature Verified #+end_example - ** Extracting the tarball You will need to extract the tarball to your desired location. For partitioning, you can follow [[https://wiki.archlinux.org/index.php/Partitioning][this guide]]. This will assume that you will be mounting your root @@ -86,14 +83,12 @@ partition to =/mnt=. mount /dev/sdx1 /mnt tar xf carbs-rootfs.tar.xz -C /mnt #+end_src - * Chroot Chroot into Carbs Linux by running the chroot helper inside the rootfs! #+begin_src sh /mnt/bin/cpt-chroot /mnt #+end_src - ** Setting up repositories Newest tarballs do not come with repositories, so you will need to manually obtain them, and set your =CPT_PATH= environment variable. Carbs Linux @@ -109,7 +104,6 @@ ahead and create that directory: #+begin_src sh mkdir -p $HOME/repos #+end_src - *** Obtaining from git Carbs Linux git repositories can be found both from the main server and GitHub @@ -121,7 +115,6 @@ Carbs Linux git repositories can be found both from the main server and GitHub #+begin_src sh git clone git://git.carbslinux.org/repository $HOME/repos/carbs #+end_src - *** Obtaining from rsync Carbs Linux rsync repositories live in rsync://carbslinux.org/repo. In @@ -130,7 +123,6 @@ order to obtain it, run the following: #+begin_src sh rsync -avc rsync://vaylin.carbslinux.org/repo $HOME/repos/carbs #+end_src - *** Making the package manager use the repositories In your shell's configuration file, or in your =~/.profile= file, add the @@ -143,7 +135,6 @@ following lines: CPT_PATH=$CPT_PATH:$HOME/repos/carbs/community export CPT_PATH #+end_src - ** Updating packages 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 @@ -152,7 +143,6 @@ need to update twice. #+begin_src sh cpt-update && cpt-update #+end_src - ** Installing packages 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 @@ -163,7 +153,6 @@ following. "Package" is not actually a package and is given as an example. cpt-build package cpt-install package #+end_src - ** Essential Software Here is a small list of software that you might want to have on your system as you are setting up. You might want to check the *Software* section in the full @@ -195,7 +184,6 @@ documentation to learn more about other packaged software. - carbs-docs - man-pages - man-pages-posix - ** Obtaining the documentation All the documentation for Carbs Linux can be found on a single info manual to be viewed offline. You can obtain either =texinfo= or the =info= packages in order @@ -212,11 +200,9 @@ to view the documentation. # You can then run info and navigate through the documentation. info carbslinux #+end_src - * System Configuration After you have finished installing some extra packages, you can configure your system to your liking. - ** Configuring hostname You might want to add a hostname, especially in a networked environment. Your hostname will default to 'carbslinux' unless you set this. @@ -224,7 +210,6 @@ hostname will default to 'carbslinux' unless you set this. #+begin_src sh echo your-hostname > /etc/hostname #+end_src - ** Hosts file You can edit your /etc/hosts file, which is the static lookup table for host names. By default, there are two entries for localhost which are OKAY. You can @@ -234,7 +219,6 @@ replace the 'localhost' part of these entries to your hostname. 127.0.0.1 localhost.localdomain localhost ::1 localhost.localdomain localhost ip6-localhost #+end_example - ** Creating a user Creating a new user is not strictly necessary, but it is highly recommended. Especially for building packages, it is the safest option to create an @@ -261,12 +245,10 @@ After you are finished you can switch to the new user by running #+begin_src sh su foo #+end_src - * Kernel Kernel isn't managed under the main repositories, even though you could package -one for your personal use. Here is an [[https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux][example kernel package]], which you will +one for your personal use. Here is an [[https://github.com/ceylinkeylan/kiss-repository/tree/master/personal/linux][example kernel package]], which you will need to reconfigure for your specific setup if you want to make use of it. - ** Obtaining the kernel sources You can visit the [[https://kernel.org]] website to choose a kernel that you want to install. Though only the latest stable and longterm (LTS) versions are @@ -284,7 +266,6 @@ likely outdated, so don't run it verbatim. *NOTE:* If you want to validate the kernel signature, install the =gnupg2= package, and follow the instructions provided at [[https://kernel.org/category/signatures.html]]. - ** Kernel dependencies In order to compile the kernel you will need to install some dependencies. You will need =libelf=, and =bison= to compile the kernel. If you want to configure @@ -305,7 +286,6 @@ source directory. wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch patch -p1 < kernel-no-perl.patch #+end_src - ** Building the kernel Next step is configuring and building the kernel. You can check Gentoo's [[https://wiki.gentoo.org/wiki/Kernel/Configuration][kernel configuration guide]] to learn more about the matter. Overall, Gentoo Wiki @@ -317,18 +297,15 @@ following will assume a monolithic kernel. make install -Dm755 $(make -s image_name) /boot/vmlinuz-linux #+end_src - * Making your system bootable In order to be able to boot your fresh system, wou will need an init-daemon, init-scripts and a bootloader. The init daemon is already provided by busybox, but you can optionally change it. - ** Bootloader In the main repository, there is efibootmgr and grub to serve as bootloaders. efibootmgr can be used as a standalone bootloader, or can be used to install grub in a UEFI environment. efibootmgr is needed unless you are using a device without UEFI support (or you really want to use BIOS for a reason). - *** GRUB BIOS installation #+begin_src sh @@ -336,7 +313,6 @@ without UEFI support (or you really want to use BIOS for a reason). grub-install --target=i386-pc /dev/sdX grub-mkconfig -o /boot/grub/grub.cfg #+end_src - *** GRUB UEFI installation #+begin_src sh @@ -349,7 +325,6 @@ without UEFI support (or you really want to use BIOS for a reason). grub-mkconfig -o /boot/grub/grub.cfg #+end_src - ** Init scripts Only thing left to do is installing the init-scripts, and now you are almost ready to boot your system! @@ -357,27 +332,23 @@ ready to boot your system! #+begin_src sh cpt b carbs-init && cpt i carbs-init #+end_src - ** Fstab You can now manually edit your fstab entry, or you can use the genfstab tool. If you want to use the tool, exit the chroot and run the following: #+begin_src sh - wget https://github.com/cemkeylan/genfstab/raw/master/genfstab + wget https://github.com/ceylinkeylan/genfstab/raw/master/genfstab chmod +x genfstab ./genfstab -U /mnt >> /mnt/etc/fstab #+end_src - * Post-installation The base installation is now complete, you can now fine tune your system according to your needs. Rest of these instructions are completely optional. You can check the rest of the documentation to learn more about the system. - ** IRC The IRC channel for Carbs Linux is located in =#carbslinux= on [[https://libera.chat][libera.chat]]. You can install the =catgirl= package from the repository, or use a client of your preference to join. Feel free to ask for help, or have a general chat. - ** KISS repositories There have been recent changes to the =kiss= package manager that breaks compatibility with =cpt=. These changes throw away the entire premise of their diff --git a/install.txt b/install.txt index 00c7109..0845b18 100644 --- a/install.txt +++ b/install.txt @@ -2,7 +2,7 @@ CARBS LINUX INSTALLATION GUIDE - Cem Keylan + Ceylin Keylan ________________________________ @@ -373,7 +373,7 @@ can be acquired as plain-text to be viewed offline with a pager from [example kernel package] -<https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux> +<https://github.com/ceylinkeylan/kiss-repository/tree/master/personal/linux> 4.1 Obtaining the kernel sources ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -507,7 +507,7 @@ can be acquired as plain-text to be viewed offline with a pager from the following: ,---- - | wget https://github.com/cemkeylan/genfstab/raw/master/genfstab + | wget https://github.com/ceylinkeylan/genfstab/raw/master/genfstab | chmod +x genfstab | ./genfstab -U /mnt >> /mnt/etc/fstab `---- |