aboutsummaryrefslogtreecommitdiff
path: root/src/wiki
diff options
context:
space:
mode:
Diffstat (limited to 'src/wiki')
-rw-r--r--src/wiki/boot/module-management.md15
-rw-r--r--src/wiki/index.md17
-rw-r--r--src/wiki/init/switching-to-sinit.md52
-rw-r--r--src/wiki/install.md310
-rw-r--r--src/wiki/keymaps/X-keymaps.md0
-rw-r--r--src/wiki/keymaps/keymaps.md53
-rw-r--r--src/wiki/system/service-management.md82
7 files changed, 0 insertions, 529 deletions
diff --git a/src/wiki/boot/module-management.md b/src/wiki/boot/module-management.md
deleted file mode 100644
index c9cdffb..0000000
--- a/src/wiki/boot/module-management.md
+++ /dev/null
@@ -1,15 +0,0 @@
-Title: Module Management
-
-Module Management
-=================
-
-With **busybox-init**, a module can be loaded at boot by adding such a line to your `inittab`
-
- ::once:/bin/modprobe module-name
-
-
-With **sinit**, a module can be loaded from your `/etc/rc.local` file. Add this to your file
-
- /bin/modprobe module-name
-
-
diff --git a/src/wiki/index.md b/src/wiki/index.md
deleted file mode 100644
index 3d64de9..0000000
--- a/src/wiki/index.md
+++ /dev/null
@@ -1,17 +0,0 @@
-Wiki
-================================================================================
-
-Welcome to the Carbs Linux wiki! This wiki is open for access, and can be edited
-freely by anyone who wants to contribute.
-
-If you want to make a contribution, go to <https://github.com/CarbsLinux/wiki>
-
-Content
---------------------------------------------------------------------------------
-
-* [Module Management](boot/module-management.html)
-* [Switching to Sinit](init/switching-to-sinit.html)
-* [Install](install.html)
-* [X-keymaps](keymaps/X-keymaps.html)
-* [Keymaps in TTY](keymaps/keymaps.html)
-* [Service Management](system/service-management.html)
diff --git a/src/wiki/init/switching-to-sinit.md b/src/wiki/init/switching-to-sinit.md
deleted file mode 100644
index 180b736..0000000
--- a/src/wiki/init/switching-to-sinit.md
+++ /dev/null
@@ -1,52 +0,0 @@
-Title: Switching to Sinit
-
-Switching to Sinit
-==================
-
-Carbs Linux runs `busybox-init` by default. You can switch to
-anything else you desire, but only busybox-init and sinit are
-officially supported. Switching to sinit is extremely easy, you
-can be up and running within minutes. The only "hard" requirement
-is an environment you will be chrooting in. So, let's begin!
-
-
-Preparing your environment
---------------------------
-
-From your other environment, download the kiss-chroot utility
-and make it executable.
-
- $ wget https://dl.getkiss.org/kiss-chroot
- $ chmod +x kiss-chroot
-
- # From your environment start the chroot
- $ kiss-chroot /mnt
-
-Removing busybox-init
----------------------
-
-Now that we are in chroot environment, let's remove busybox-init.
-
- $ kiss r busybox-init
-
-
-Installing and configuring sinit
---------------------------------
-
-Build and install sinit
-
- $ kiss b sinit
- $ kiss i sinit
-
-Open up your `/etc/init/rc.conf` now and uncomment
-the variables regarding SINIT. You are ready now.
-
-If you edited your inittab, make sure you reflect your changes
-on the `/etc/init/sinit-launch-services.boot` file.
-
-
-Finishing up
-------------
-
-If all of the above is done, simply exit the chroot and reboot.
-Sinit should be functioning without any issues.
diff --git a/src/wiki/install.md b/src/wiki/install.md
deleted file mode 100644
index f49da4d..0000000
--- a/src/wiki/install.md
+++ /dev/null
@@ -1,310 +0,0 @@
-Title: Install
-
-Installation Instructions
-=========================
-
-This post will guide you step-by-step in order to install
-Carbs Linux. It is not complete yet.
-
-
-Downloading and Getting Ready to Chroot
----------------------------------------
-
-Installing Carbs Linux is the same as installing most
-rootfs distributions, such as Gentoo, or Void Linux.
-
-
-### Requirements
-
-You simply need a Live Linux ISO. Gentoo would be the best
-as programs you will require will be already there. Get the
-ISO, boot it and set up your network.
-
-**Required Programs:**
-
-* tar
-* wget
-* xz
-
-Rest of the instructions assume that you have set all of these
-up, and will continue on.
-
-
-### Download
-
-
-First, we need to download the rootfs tarball. In your terminal
-type
-
- $ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz
-
-
-### Check the integrity of the tarball
-
-While optional, it is highly recommended to check the integrity
-of the tarball.
-
- $ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz.sha256sum
- $ sha256sum -c carbs-rootfs-20191210.tar.xz.sha256sum
-
-
-### Check the signatures
-
-While optional, it is highly recommended to check the signature
-of the tarball
-
- $ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz.sig
-
- Import the public key of release@carbslinux.org
-
- $ gpg --recv-keys FF484BDFEFCEF8FF
-
- $ gpg --verify carbs-rootfs-20191210.tar.xz.sig
-
-### Download Kiss Linux Chroot Helper
-
- $ wget https://dl.getkiss.org/kiss-chroot
-
- Make the script executable
-
- $ chmod +x kiss-chroot
-
-### Extract the rootfs tarball
-
-You need to extract the tarball to your mounted partition
-
- $ tar xvpf carbs-rootfs-20191210.tar.xz -C /mnt
-
-Chroot
-------
-Chroot into Carbs Linux
-
- $ ./kiss-chroot /mnt
-
-### Enable repository signing (Highly Recommended)
-
-This step is optional, but very highly recommended
-(I cannot stress out the amount I am recommending this).
-This ensures you are receiving updates from Carbs Linux
-and not some other source.
-
-**Install GnuPG**
-
-It is also a great time to learn how to use your new
-package manager, KISS! You simply build and install
-the package
-
- $ kiss build gnupg1
- $ kiss install gnupg1
-
-**Import my key**
-
-
- Import my public key (cem@ckyln.com)
-
- $ gpg --recv-key 4356EE08A364CE09
-
- Create a .gnupg directory if it doesn't exist
-
- $ mkdir -p /root/.gnupg
-
- Trust my public key
-
- $ echo trusted-key 0x4356ee08a364ce09 >> /root/.gnupg/gpg.conf
-
-**Enable signature verification**
-
-
-Git has a built in signature verification feature.
-You can go to the repository directory and enable it
-
- $ cd /var/db/kiss/repo
- $ git config merge.verifySignatures true
-
-### Installing Important Tools
-
-Since Carbs gives you one of the most minimal base,
-you might need to apply some add-ons to your system.
-
-**Update packages**
-
-It might be a good idea to update your packages before
-installing new packages. This ensure compatibility.
-
- $ kiss update
-
-**Filesystems**
-
-
-Currently, e2fsprogs and dosfstools are supported,
-as they are the most-used filesystems.
-
- Support for ext2, ext3, and ex4
-
- $ kiss build e2fsprogs
- $ kiss install e2fsprogs
-
- Support for dosfstools
-
- $ kiss build dosfstools
- $ kiss install dosfstools
-
-**Device management**
-
- $ kiss build eudev
- $ kiss install eudev
-
-**Wireless**
-
-**wpa_supplicant**
-
- $ kiss build wpa_supplicant
- $ kiss install wpa_supplicant
-
-**eiwd (WIP)**
-
- $ kiss build eiwd
- $ kiss install eiwd
-
-**dhcpcd**
-
- $ kiss build dhcpcd
- $ kiss install dhcpcd
-
-**Shells**
-
-Carbs Linux comes preinstalled with busybox ash, but other shells
-can be found on the repository
-
- Install bash
-
- $ kiss build bash
- $ kiss install bash
-
- Install zsh
-
- $ kiss build zsh
- $ kiss install zsh
-
- Install Plan9 rc-shell
-
- $ kiss build 9base
- $ kiss install 9base
-
-
-### Install the Kernel
-
-**IMPORTANT:** If you have GCC 10.x on your system, you need to apply
-this [patch] to your kernel sources. Otherwise your kernel will panic
-during the boot stage.
-
-Next step is installing the kernel, which might sound as a challenge
-you should download and extract the kernel tarball first.
-
- $ wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.5.tar.xz
-
- Let's move the sources to /usr/src
-
- $ mv linux-5.5.tar.xz /usr/src
- $ tar xf linux-5.5.tar.xz
- $ cd linux-5.5
-
-[patch]: https://dl.carbslinux.org/distfiles/linux-gcc-10-bootfix.patch
-
-**Configure the Kernel**
-
-You can check <https://wiki.gentoo.org/wiki/Kernel/Configuration>
-to learn more about kernel configuration. Overall, [Gentoo Wiki](https://wiki.gentoo.org)
-is a good place to learn about kernel configuration related to
-your hardware.
-
-**Build and install the kernel**
-
-The rest of it is simple, build the kernel with
-`make` and install it with `make install`
-
-### Bootloader
-
-The default bootloader is GRUB (GRand Unified Bootloader).
-
-Build and install GRUB
-
- $ kiss b grub
- $ kiss i grub
-
- Install efibootmgr as well if your
- system requires it
-
- $ kiss b efibootmgr
- $ kiss i efibootmgr
-
-
-**Setup GRUB**
-
- For BIOS:
- $ grub-install --target=i386-pc /dev/sdX
-
- For UEFI:
- $ grub-install --target=x86_64-efi --efi-directory=esp --bootloader-id=CarbsLinux
-
- $ grub-mkconfig -o /boot/grub/grub.cfg
-
-
-### Install init
-
-Currently, default init for Carbs Linux is `sinit`, but
-busybox-init is also supported. You can also change this yourself.
-
-To install init, you have to
-
- $ kiss b sinit
- $ kiss i sinit
-
-This will also fetch busybox-init as its dependency.
-
-
-### Enabling other repositories
-
-There are other repositories out there that might be of your
-interest. The Official Repositories come with community and testing
-repositories that are not enabled by default. You could also want to
-add the Kiss Linux community repository, or someone's personal kiss
-repository.
-
-**Obtaining repositories**
-
-Obtaining a repository is as simple as a git clone. You can do it
-with Cem's personal repository as an example, but any other repository
-will be the same.
-
- # Clone the repository to your desired location
- # Optionally add "--depth 1" to save precious disk space
-
- $ git clone --depth 1 git://git.ckyln.com/kiss-repository /var/db/kiss/cem-repository
-
-That's it, you have obtained a new repository!
-
-<strong>Adding a repository to your KISS_PATH</strong>
-
-Now that we have obtained Cem's repository, we can add it to our KISS\_PATH!
-
-We need to edit `/etc/profile.d/kiss_path.sh` for this, but you
-can also change your KISS\_PATH from your shellrc.
-
-Add the full path to the repository, in this case
-`/var/db/kiss/cem-repository/cem` to the variable
-and add a `:` before/after it.
-
-It must be looking like this.
-
- export KISS_PATH=/var/db/kiss/repo/core:/var/db/kiss/repo/extra:/var/db/kiss/repo/xorg:/var/db/kiss/cem-repository/cem
-
-Update your shell variables by doing `. /etc/profile.d/kiss_path.sh` so you can
-immediately access the repository packages
-
-
-More
-----
-
-You should now be able to boot into you Carbs Linux installation.
-To learn more, you can visit the [wiki](//carbslinux.org/wiki)
diff --git a/src/wiki/keymaps/X-keymaps.md b/src/wiki/keymaps/X-keymaps.md
deleted file mode 100644
index e69de29..0000000
--- a/src/wiki/keymaps/X-keymaps.md
+++ /dev/null
diff --git a/src/wiki/keymaps/keymaps.md b/src/wiki/keymaps/keymaps.md
deleted file mode 100644
index 6bcce03..0000000
--- a/src/wiki/keymaps/keymaps.md
+++ /dev/null
@@ -1,53 +0,0 @@
-Title: Keymaps in TTY
-
-Installing and Using Keymaps
-============================
-
-Unlike most other distributions out there
-Carbs Linux does not come preinstalled with console
-keys. You probably won't be using more than
-two either. There are two ways of using keymaps
-
-Installing the "bkeymaps" package
----------------------------------
-
-You can get the `bkeymaps` package from the
-[KISS community repository](https://github.com/kisslinux/community).
-
-Build and install `bkeymaps`.
-
- -> kiss b bkeymaps
- -> kiss i bkeymaps
-
-Now you can find the keymaps in `/usr/share/bkeymaps`.
-
-
-Downloading the keymaps you require
------------------------------------
-
-*This will assume that you are using the us keyboard layout*
-
-You firstly will need to go to <https://dev.alpinelinux.org/bkeymaps/>
-and download the keymap you need
-
-Loading keymap, doing it on login/boot
---------------------------------------
-
-- Run `loadkmap < file` to load the keymap.
-
-**Load keymap at login**
-
-If you want to load a keymap at login, you can
-add the command above to your `.profile` file.
-
-**Load keymap at boot**
-
-You can also load keymap during boot. You should edit
-`/lib/init/rc.boot` file and add something like
-
- # assuming you are using trq as your keymap
- log "Setting keymap to trq..."; {
- loadkmap < /path/to/trq.bmap
- }
-
-to your main function.
diff --git a/src/wiki/system/service-management.md b/src/wiki/system/service-management.md
deleted file mode 100644
index 8aff8a6..0000000
--- a/src/wiki/system/service-management.md
+++ /dev/null
@@ -1,82 +0,0 @@
-Title: Service Management
-
-Carbs Linux uses `busybox-runit` by default, but the repository additionally has the
-original `runit` and `sysmgr`. You can install either with `kiss b runit; kiss i runit`
-or `kiss b sysmgr; kiss i sysmgr`.
-
-runit
-=====
-
-**Enabling a Service**
-
- ln -sf /etc/sv/acpid /var/service
-
-**Disabling a Service**
-
- unlink /var/service/acpid
-
-**Starting a Service**
-
- sv start acpid
-
-**Stopping a Service**
-
- sv stop acpid
-
-For more information refer to the `sv --help` output. Also check out the `sv(8)`
-manual page if you have installed the `runit` package.
-
-
-sysmgr
-======
-
-[sysmgr] is POSIX-sh service supervisor written by me. Its usage resembles
-`runit`. The biggest difference is that `sysmgr` uses service files instead
-of directories with run scripts inside.
-
-
-svctl
------
-
-`svctl` is the equivalant of `sv` for sysmgr. You can run the above commands for
-`runit` and use `svctl` instead of `sv`. Those would be as follows.
-
-
-**Enabling a Service**
-
- ln -sf /etc/sysmgr/acpid /var/sysmgr
-
-**Disabling a Service**
-
- unlink /var/sysmgr/acpid
-
-**Starting a Service**
-
- svctl start acpid
-
-**Stopping a Service**
-
- svctl stop acpid
-
-
-Switching from runit
---------------------
-
-Switching from `runit` is fairly easy. You can run the following commands to get
-started with `sysmgr`.
-
-
- # Create the directories if you haven't yet
- mkdir -p /var/sysmgr /etc/sysmgr
-
- # Copy all of the run scripts to /etc/sysmgr
- set -- /etc/sv/*
- for service; do cp "$service/run" "/etc/sysmgr/${service##*/}" ; done
-
- # Link all enabled services
- set -- /var/service/*
- for service; do ln -sf /etc/sysmgr/${service##*/} /var/sysmgr ; done
-
-
-
-[sysmgr]: https://github.com/cemkeylan/sysmgr