kernel/README.md

   1 # Kernel
   2
   3 ## Configuration
   4
   5 ### Layout
   6
   7 The kernel configuration files are split into individual configuration files for
   8 each architecture. This way, common options can be changed globally and can be
   9 overwritten for certain architectures which gives us a more consistent configuration
  10 across all architectures.
  11
  12 ### How to update the configuration?
  13
  14 For these steps, you will have to change into a build environment and change to
  15 the kernel directory:
  16
  17   # pakfire-builder shell kernel.nm
  18   (pakfire-shell)> cd /usr/src/packages/kernel-x.y.z...
  19
  20 The following commands are available. Appending the <arch> argument allows you
  21 to edit a specific architecture. Default is x86_64.
  22
  23 #### oldconfig
  24
  25 You can run this when updating the kernel to a new release or after changing any
  26 options manually. All unset or updated options will be prompted for and all
  27 configuration files for all architectures will be updated.
  28
  29   (pakfire-shell)> scripts/configure oldconfig <arch>
  30
  31 #### olddefconfig
  32
  33 Like oldconfig, but automatically answers all options with the default value.
  34
  35   (pakfire-shell)> scripts/configure olddefconfig
  36
  37 #### menuconfig
  38
  39 If you want to edit the configuration using the kernel's config editor. All
  40 configuration files will be updated afterwards and potentially prompted for options
  41 that diverge for different architectures.
  42
  43   (pakfire-shell)> scripts/configure menuconfig <arch>
  44
  45 #### listnewconfig
  46
  47 This will list all unset options.
  48
  49   (pakfire-shell)> scripts/configure listnewconfig <arch>