docs: Improve docs on MDADM_CONFIG
[genkernel.git] / genkernel.conf
1 # Configuration file for genkernel
2 # $Id$
3
4 # This file is sourced by genkernel at startup and determines which options
5 # we will be using to compile our kernel.  The order of precidence is simple,
6 # with the internal settings being least important, configuration file
7 # settings next, and command line options being most important.
8
9 # =========Common Command Line Option Defaults=========
10
11 # Run 'make oldconfig' before compiling this kernel?
12 OLDCONFIG="yes"
13
14 # Run 'make menuconfig' before compiling this kernel?
15 MENUCONFIG="no"
16
17 # Run 'make clean' before compilation?
18 # If set to NO, implies MRPROPER WILL NOT be run
19 # Also, if clean is NO, it won't copy over any configuration
20 # file, it will use what's there.
21 CLEAN="yes"
22
23 # Run 'make mrproper' before configuration/compilation?
24 MRPROPER="yes"
25
26 # Override the arch detection?
27 # ARCH_OVERRIDE="x86"
28
29 # Mount BOOTDIR automatically if it isn't mounted?
30 MOUNTBOOT="yes"
31
32 # Make symlinks in BOOTDIR automatically?
33 # SYMLINK="no"
34
35 # Save the new configuration in /etc/kernels upon
36 # successfull compilation
37 SAVE_CONFIG="yes"
38
39 # Use Color output in Genkernel?
40 USECOLOR="yes"
41
42 # Clear build cache dir
43 # CLEAR_CACHE_DIR="yes"
44
45 # Genkernel uses an independent configuration for MAKEOPTS, and does not source
46 # /etc/make.conf . You can override the default setting by uncommenting and
47 # tweaking the following line. Default setting is set up by
48 # ${GK_SHARE}/${ARCH_OVERRIDE}/config.sh . The recommended value for -j
49 # argument is: <number of processors>*<number of cores per processor>+1
50 # MAKEOPTS="-j2"
51
52 # Add in LVM support from static binaries if they exist on the system, or
53 # compile static LVM binaries if static ones do not exist.
54 # LVM="no"
55
56 # Add in Luks support. Needs sys-fs/cryptsetup with -dynamic installed.
57 # LUKS="no"
58
59 # Add in GnuPG support
60 # GPG="no"
61
62 # Add in EVMS support from static binaries if they exist on the system: you
63 # should run "emerge evms" first.
64 # EVMS="no"
65
66 # Add DMRAID support.
67 # DMRAID="no"
68
69 # Include (or suppresses the inclusion of) busybox in the initrd or initramfs.
70 # If included, busybox is rebuilt if the cached copy is out of date.
71 # BUSYBOX="yes"
72
73 # Includes mdadm/mdmon binaries in initramfs.
74 # Without sys-fs/mdadm[static] installed, this will build a static mdadm.
75 # MDADM="no"
76
77 # Specify a custom mdadm.conf.
78 # By default the ramdisk will be built *without* an mdadm.conf and will auto-detect
79 # arrays during bootup.  Usually, this should not be needed.
80 # MDADM_CONFIG="/etc/mdadm.conf"
81
82 # Add Multipath support.
83 # MULTIPATH="no"
84
85 # Add iSCSI support.
86 # ISCSI="no"
87
88 # Enable copying of firmware into initramfs
89 # FIRMWARE="no"
90 # Specify directory to pull from
91 # FIRMWARE_DIR="/lib/firmware"
92 # Specify specific firmware files to include. This overrides FIRMWARE_DIR
93 # FIRMWARE_FILES=""
94
95 # Enable disklabel support (copies blkid to initrd)
96 DISKLABEL="yes"
97
98 # Add new kernel to grub?
99 # BOOTLOADER="grub"
100
101 # Enable splashutils in early space (initrd). Default is "no".
102 # SPLASH="yes"
103
104 # Use this splash theme. If commented out - the "default" name theme is used.
105 # Also, SPLASH="yes" needs to be enabled for this one to one work.
106 # This supersedes the "SPLASH_THEME" option of /etc/conf.d/splash (in early space).
107 # SPLASH_THEME="gentoo"
108
109 # =========Low Level Compile Settings=========
110 #
111 # GNU Make to use for kernel.  See also the --kernel-make command line option.
112 # KERNEL_MAKE="make"
113
114 # Compiler to use for the kernel (e.g. distcc).  See also the --kernel-cc
115 # command line option.
116 # KERNEL_CC="gcc"
117
118 # Assembler to use for the kernel.  See also the --kernel-as command line
119 # option.
120 # KERNEL_AS="as"
121
122 # Linker to use for the kernel.  See also the --kernel-ld command line option.
123 # KERNEL_LD="ld"
124
125 # GNU Make to use for the utilities.  See also the --utils-make command line
126 # option.
127 # UTILS_MAKE="make"
128
129 # Compiler to use for the utilities (e.g. distcc).  See also the --utils-cc
130 # command line option.
131 # UTILS_CC="gcc"
132
133 # Assembler to use for the utilities.  See also the --utils-as command line
134 # option.
135 # UTILS_AS="as"
136
137 # Linker to use for the utilities.  See also the --utils-ld command line
138 # option.
139 # UTILS_LD="ld"
140
141 # =========GENKERNEL LOCATION CONFIGURATION============
142 # Variables:
143 #   %%ARCH%%  - Final determined architecture
144 #   %%CACHE%% - Final determined cache location
145
146 # Set genkernel's temporary work directory.  Default is /var/tmp/genkernel
147 # TMPDIR="/var/tmp/genkernel"
148
149 # Set the boot directory, default is /boot
150 #BOOTDIR="/boot"
151
152 # Default share directory location
153 GK_SHARE="${GK_SHARE:-/usr/share/genkernel}"
154
155 # Location of the default cache
156 CACHE_DIR="/var/cache/genkernel"
157 # Location of DISTDIR, where our source tarballs are stored
158 DISTDIR="${CACHE_DIR}/src"
159 # Log output file
160 LOGFILE="/var/log/genkernel.log"
161 # Debug Level
162 LOGLEVEL=1
163
164 # Default location of kernel source
165 DEFAULT_KERNEL_SOURCE="/usr/src/linux"
166 # Default kernel config (only use to override using
167 # arch/%%ARCH%%/kernel-config-${VER}.${PAT} !)
168 # DEFAULT_KERNEL_CONFIG="${GK_SHARE}/arch/%%ARCH%%/kernel-config"
169
170 BUSYBOX_VER="VERSION_BUSYBOX"
171 BUSYBOX_SRCTAR="${DISTDIR}/busybox-${BUSYBOX_VER}.tar.bz2"
172 BUSYBOX_DIR="busybox-${BUSYBOX_VER}"
173 BUSYBOX_BINCACHE="%%CACHE%%/busybox-${BUSYBOX_VER}-%%ARCH%%.tar.bz2"
174 # BUSYBOX_APPLETS="[ ash sh mount uname echo cut cat"
175
176 DEVICE_MAPPER_VER="VERSION_DMAP"
177 DEVICE_MAPPER_DIR="device-mapper.${DEVICE_MAPPER_VER}"
178 DEVICE_MAPPER_SRCTAR="${DISTDIR}/device-mapper.${DEVICE_MAPPER_VER}.tgz"
179 DEVICE_MAPPER_BINCACHE="%%CACHE%%/device-mapper-${DEVICE_MAPPER_VER}-%%ARCH%%.tar.bz2"
180
181 LVM_VER="VERSION_LVM"
182 LVM_DIR="LVM2.${LVM_VER}"
183 LVM_SRCTAR="${DISTDIR}/LVM2.${LVM_VER}.tgz"
184 LVM_BINCACHE="%%CACHE%%/LVM2.${LVM_VER}-%%ARCH%%.tar.bz2"
185
186 MDADM_VER="VERSION_MDADM"
187 MDADM_DIR="mdadm-${MDADM_VER}"
188 MDADM_SRCTAR="${DISTDIR}/mdadm-${MDADM_VER}.tar.bz2"
189 MDADM_BINCACHE="%%CACHE%%/mdadm-${MDADM_VER}-%%ARCH%%.tar.bz2"
190
191 DMRAID_VER="VERSION_DMRAID"
192 DMRAID_DIR="dmraid/${DMRAID_VER}"
193 DMRAID_SRCTAR="${DISTDIR}/dmraid-${DMRAID_VER}.tar.bz2"
194 DMRAID_BINCACHE="%%CACHE%%/dmraid-${DMRAID_VER}-%%ARCH%%.tar.bz2"
195
196 ISCSI_VER="VERSION_ISCSI"
197 ISCSI_DIR="open-iscsi-${ISCSI_VER}"
198 ISCSI_SRCTAR="${DISTDIR}/open-iscsi-${ISCSI_VER}.tar.gz"
199 ISCSI_BINCACHE="%%CACHE%%/iscsi-${ISCSI_VER}-%%ARCH%%.bz2"
200
201 E2FSPROGS_VER="VERSION_E2FSPROGS"
202 E2FSPROGS_DIR="e2fsprogs-${E2FSPROGS_VER}"
203 E2FSPROGS_SRCTAR="${DISTDIR}/e2fsprogs-${E2FSPROGS_VER}.tar.gz"
204 BLKID_BINCACHE="%%CACHE%%/blkid-${E2FSPROGS_VER}-%%ARCH%%.bz2"
205
206 FUSE_VER="VERSION_FUSE"
207 FUSE_DIR="fuse-${FUSE_VER}"
208 FUSE_SRCTAR="${DISTDIR}/fuse-${FUSE_VER}.tar.gz"
209 FUSE_BINCACHE="%%CACHE%%/fuse-${FUSE_VER}-%%ARCH%%.tar.bz2"
210
211 UNIONFS_FUSE_VER="VERSION_UNIONFS_FUSE"
212 UNIONFS_FUSE_DIR="unionfs-fuse-${UNIONFS_FUSE_VER}"
213 UNIONFS_FUSE_SRCTAR="${DISTDIR}/unionfs-fuse-${UNIONFS_FUSE_VER}.tar.bz2"
214 UNIONFS_FUSE_BINCACHE="%%CACHE%%/unionfs-fuse-${UNIONFS_FUSE_VER}-%%ARCH%%.bz2"
215
216 GPG_VER="VERSION_GPG"
217 GPG_DIR="gnupg-${GPG_VER}"
218 GPG_SRCTAR="${DISTDIR}/gnupg-${GPG_VER}.tar.bz2"
219 GPG_BINCACHE="%%CACHE%%/gnupg-${GPG_VER}-%%ARCH%%.bz2"