kisscommunity

kisscommunity.bvnf.space site sources
git clone git://bvnf.space/home/kiss/kisscommunity.git
Log | Files | Refs | Submodules | README

commit 3f39ad9e67b50c7bf0ff09e843f5bb29fb417fae
parent b4aa24c2bedb8baaf0db6be53188c62ea973dba6
Author: aabacchus <ben@bvnf.space>
Date:   Sun,  7 Aug 2022 20:34:56 +0100

add preliminary FAQ page

Diffstat:
Awiki/FAQ/index.md | 64++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 64 insertions(+), 0 deletions(-)

diff --git a/wiki/FAQ/index.md b/wiki/FAQ/index.md @@ -0,0 +1,64 @@ +# Frequently Asked Questions + +Many people who install KISS come across similar problems and misunderstandings +in the process. Almost all of these have solutions documented somewhere in the +KISS documentation, but it can be spread out, hard to find, and easy to miss. +Therefore, this page collects solutions to some of the most common problems. + +**This is not a substitute for a thorough reading of the +[install guide](https://kisslinux.org/install) and the appropriate +[wiki](https://kisslinux.org/wiki/) page.** + +This page does not answer questions about the philosophy of KISS, or why KISS +is designed in any certain way. For those questions, refer to <https://kisslinux.org/answers>. + +## [%[000]] General tips for identifying build errors + +If you use parallel make (`make -jN`), the actual error probably isn't at the +bottom of the log. You'll need to look back through it, and find the first +occurence of "Waiting for unfinished jobs....". + +Try to find the particular command which failed (make gives you a file and line +number), and see if you can reproduce the error by running that command by itself. + +Often you might be missing a hidden dependency. Look for errors like "not found" +or "no such file or directory". + +Make sure your CFLAGS are like `-O2` not `-02` (letter O not number 0). + +Search online for the error message. Look through [issues in the community +repo](https://github.com/kiss-community/community/issues?q=is%3Aissue), +in case someone's encountered it before. + +If you need more help, the best place is IRC. Upload a *full* log to a pastebin. + +Once you've found the solution, make a note of it so that others can learn. You +could contribute it to this page. + +## [%[010]] My kernel doesn't build! + +### [%[011]] Busybox diff given unrecognized options +These are not causing the build to fail; they are only warnings. +### [%[012]] Errors about `__always_inline`, versions 5.12-5.18 +Kernels with minor version 5.12-5.18 require the following patch to add an include: + + $ sed -i '/<stdlib.h>/a #include <linux/stddef.h>' tools/objtool/arch/x86/decode.c + +### [%[013]] `env: can't execute 'bash': No such file or directory`, version 5.19 +Kernels with minor version 5.19 currently require bash to be built. There is a +patch by [$/ioraff](https://github.com/ioraff) available +[here](https://github.com/kiss-community/repo/issues/79) to remove this dependency. + + +## [%[020]] Kernel config/boot problems + +### [%[021]] Filesystem drivers +Make sure you've enabled drivers for at least your boot and root filesystems. + +### [%[022]] Including firmware +Choose some location, such as `/usr/lib/firmware` and install the firmware you need into it. +This alone isn't enough; you need to tell the kernel the directory where to find firmware, and +the filenames relative to this directory for everything you want to use. +See [kernel/firmware](/kernel/firmware/) for details. + +Firmware problems are most easily diagnosed by looking through `dmesg`.