✎ project:kernel-autobuild:structure [Fischglas]

project:kernel-autobuild:structure

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== structure of kernel-autobuild (as of 2015-12-22, 0.9) (work in progress) =======

===== /usr/bin/kernel-autobuild =====

^ task                                                ^ command                              ^ detail                             ^ VAR in              ^ VAR out                                                                     ^
|                                                     |                                      |                                    |                     |                                                                             |
| source /usr/share/kernel-autobuild/global-static    | cpt. obv.                            | define usage()                     | $@                  | TOOL_DIR=/usr/share/kernel-autobuild                                        |
|                                                     |                                      | define command line parser doopt() |                     | KERNEL_AUTOBUILD_BASEDIR=/var/lib/kernel-autobuild                          |
|                                                     |                                      | read /etc/kernel-autobuild.conf    |                     | GLOBAL_DATE="$(date '+%Y%m%d-%H%M%S')"                                      |
|                                                     |                                      | read ~/.kernel-autobuild           |                     | DO_DOWNLOAD=1                                                               |
|                                                     |                                      | set defaults                       |                     | DO_UNPACK=1                                                                 |
|                                                     |                                      | run doopt()                        |                     | DO_VSPATCH=1                                                                |
|                                                     |                                      |                                    |                     | DO_COMPILE=1                                                                |
|                                                     |                                      |                                    |                     | DEBUG=0                                                                     |
|                                                     |                                      |                                    |                     | KSRCVER=""                                                                  |
|                                                     |                                      |                                    |                     | PVER=""                                                                     |
|                                                     |                                      |                                    |                     | PROVIDER_TAG="kernelautobuild"                                              |
|                                                     |                                      |                                    |                     | IDENTIFY_SOURCES=""                                                         |
|                                                     |                                      |                                    |                     | DOWNLOAD_ONLY=""                                                            |
|                                                     |                                      |                                    |                     | PATCHES=""                                                                  |
|                                                     |                                      |                                    |                     | VSPATCHPATCHES=""                                                           |
|                                                     |                                      |                                    |                     | DOTCONFIG_SETTING=""                                                        |
|                                                     |                                      |                                    |                     | DOTCONFIG_SETTING_FILE=""                                                   |
|                                                     |                                      |                                    |                     | DO_VNC="1"                                                                  |
|                                                     |                                      |                                    |                     | USE_CPUS="4"                                                                |
|                                                     |                                      |                                    |                     | LASTCONFIG=""                                                               |
|                                                     |                                      |                                    |                     | DO_TESTS="1"                                                                |
|                                                     |                                      |                                    |                     | DO_UPLOAD="1"                                                               |
|                                                     |                                      |                                    |                     | STRIP_SYMBOLS="INSTALL_MOD_STRIP=1"                                         |
|                                                     |                                      |                                    |                     | SEQUENTIAL="1"                                                              |
|                                                     |                                      |                                    |                     | KERNEL_BASE_VERSION="3.4"                                                   |
|                                                     |                                      |                                    |                     | NAMEEXT_VSERVER="-vserver"                                                  |
|                                                     |                                      |                                    |                     | NAMEEXT_ARCH="-amd64"                                                       |
|                                                     |                                      |                                    |                     | WORKDIR=/var/lib/kernel-autobuild/$KERNEL_BASE_VERSION                      |
|                                                     |                                      |                                    |                     | SOURCE_IMG=/var/lib/kernel-autobuild/00-resources/squeeze-kerneltest.img.xz |
|                                                     |                                      |                                    |                     |                                                                             |
| check for prerequisite executables                  | (inline)                             |                                    | HAVE_VNCCLIENT      |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| identify kernel source                              | kab_identify_kernel_source_version   |                                    | KSRCVER             | ARCNAME                                                                     |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION | KERNEL_VER                                                                  |
|                                                     |                                      |                                    |                     | KERNEL_PL                                                                   |
|                                                     |                                      |                                    |                     | KERNEL_SL                                                                   |
|                                                     |                                      |                                    |                     |                                                                             |
| identify vserver patch                              | kab_identify_vserver_patch           |                                    | KSRCVER             | PATCHNAME                                                                   |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION | RAW_PATCHNAME                                                               |
|                                                     |                                      |                                    |                     | PVER                                                                        |
|                                                     |                                      |                                    |                     | PURL                                                                        |
|                                                     |                                      |                                    |                     | KURL                                                                        |
|                                                     |                                      |                                    |                     | KSRCURL                                                                     |
|                                                     |                                      |                                    |                     | KSRCDATE                                                                    |
|                                                     |                                      |                                    |                     |                                                                             |
| identify a kernel config file                       | kab_identify_kernel_config_file      |                                    | KSRCVER             | LASTCONFIG                                                                  |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| free diskspace if needed                            | maintain-diskspace                   |                                    | --free              |                                                                             |
|                                                     |                                      |                                    | --workdir           |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| setup directory structure                           | (inline)                             |                                    | KSRCVER             | CURRENT_BUILD                                                               |
|                                                     |                                      |                                    | PVER                | SRC_DIR                                                                     |
|                                                     |                                      |                                    | SEQUENTIAL          | BUILD_DIR                                                                   |
|                                                     |                                      |                                    |                     | LOG_DIR                                                                     |
|                                                     |                                      |                                    |                     | INFO_DIR                                                                    |
|                                                     |                                      |                                    |                     | MP_DIR                                                                      |
|                                                     |                                      |                                    |                     | MNT_DIR                                                                     |
|                                                     |                                      |                                    |                     | IMG_DIR                                                                     |
|                                                     |                                      |                                    |                     | TMP TEMP TMPDIR TEMPDIR                                                     |
|                                                     |                                      |                                    |                     |                                                                             |
| perform downloads of sources, patches & changes     | kab_downloads                        |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | PATCHES             |                                                                             |
|                                                     |                                      |                                    | KSRCURL             |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | PURL                |                                                                             |
|                                                     |                                      |                                    | LASTCONFIG          |                                                                             |
|                                                     |                                      |                                    | VSPATCHPATCHES      |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| unpack kernel source code                           | kab_unpack_kernel_source             |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | ARCNAME             |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| get patches from previous kernel if appropriate     | kab_apply_vserver_patch              |                                    | KSRCVER             | KERN_FULL_VERSION                                                           |
|   appropriate: if we _not_ have a matching vs patch |                                      |                                    | KERNEL_BASE_VERSION | MOD_PATCHNAME                                                               |
|                                                     |                                      |                                    | PATCHNAME           |                                                                             |
|  modify these                                       |                                      |                                    | RAW_PATCHNAME       |                                                                             |
|  apply these                                        |                                      |                                    | KSRCURL             |                                                                             |
|  apply vs patch                                     |                                      |                                    | PKVER               |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | PROVIDER_TAG        |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | MP_DIR              |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | ARCNAME             |                                                                             |
|                                                     |                                      |                                    | LASTCONFIG          |                                                                             |
|                                                     |                                      |                                    | KERNEL_VER          |                                                                             |
|                                                     |                                      |                                    | KERNEL_PL           |                                                                             |
|                                                     |                                      |                                    | KERNEL_SL           |                                                                             |
|                                                     |                                      |                                    | SEQUENTIAL          |                                                                             |
|                                                     |                                      |                                    | DO_VSPATCH          |                                                                             |
|                                                     |                                      |                                    | VSPATCHPATCHES      |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| apply patches to be applied after the vserver patch | kab_apply_post_vserver_patch_patches |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| modify .config, frontend                            | kab_apply_dotconfigsettings          |                                    | DOTCONFIG_SETTING   | KAB_CHANGELOG                                                               |
|                                                     |                                      |                                    | DOTCONFIG_SETTING_FILE |                                                                          |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| modify .config, backend                             | kab_modify_dotconfig                 | actually modifies .config          |                     |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| compile & build package                             | kab_compile_and_package              |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | PROVIDER_TAG        |                                                                             |
|                                                     |                                      |                                    | USE_CPUS            |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | STRIP_SYMBOLS       |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    | KAB_CHANGELOG       |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| run tests                                           | kab_run_tests                        |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | IMG_DIR             |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | MNT_DIR             |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    | DO_VNC              |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| build meta package                                  | kab_build_meta_package               |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | SEQUENTIAL          |                                                                             |
|                                                     |                                      |                                    | PROVIDER_TAG        |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| upload packages                                     | kab_upload_packages                  |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| general                                             | (inline)                             |                                    |                     |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |

====== structure of kernel-autobuild (as of 2014-04-10, devel, upcoming 0.7) =======

===== /usr/bin/kernel-autobuild =====

^ task                                                ^ command                              ^ detail                             ^ VAR in              ^ VAR out                                                                     ^
|                                                     |                                      |                                    |                     |                                                                             |
| source /usr/share/kernel-autobuild/global-static    | cpt. obv.                            | define usage()                     | $@                  | TOOL_DIR=/usr/share/kernel-autobuild                                        |
|                                                     |                                      | define command line parser doopt() |                     | KERNEL_AUTOBUILD_BASEDIR=/var/lib/kernel-autobuild                          |
|                                                     |                                      | read /etc/kernel-autobuild.conf    |                     | GLOBAL_DATE="$(date '+%Y%m%d-%H%M%S')"                                      |
|                                                     |                                      | read ~/.kernel-autobuild           |                     | DO_DOWNLOAD=1                                                               |
|                                                     |                                      | set defaults                       |                     | DO_UNPACK=1                                                                 |
|                                                     |                                      | run doopt()                        |                     | DO_VSPATCH=1                                                                |
|                                                     |                                      |                                    |                     | DO_COMPILE=1                                                                |
|                                                     |                                      |                                    |                     | DEBUG=0                                                                     |
|                                                     |                                      |                                    |                     | KSRCVER=""                                                                  |
|                                                     |                                      |                                    |                     | PVER=""                                                                     |
|                                                     |                                      |                                    |                     | PROVIDER_TAG="kernelautobuild"                                              |
|                                                     |                                      |                                    |                     | IDENTIFY_SOURCES=""                                                         |
|                                                     |                                      |                                    |                     | DOWNLOAD_ONLY=""                                                            |
|                                                     |                                      |                                    |                     | PATCHES=""                                                                  |
|                                                     |                                      |                                    |                     | VSPATCHPATCHES=""                                                           |
|                                                     |                                      |                                    |                     | DOTCONFIG_SETTING=""                                                        |
|                                                     |                                      |                                    |                     | DOTCONFIG_SETTING_FILE=""                                                   |
|                                                     |                                      |                                    |                     | DO_VNC="1"                                                                  |
|                                                     |                                      |                                    |                     | USE_CPUS="4"                                                                |
|                                                     |                                      |                                    |                     | LASTCONFIG=""                                                               |
|                                                     |                                      |                                    |                     | DO_TESTS="1"                                                                |
|                                                     |                                      |                                    |                     | DO_UPLOAD="1"                                                               |
|                                                     |                                      |                                    |                     | STRIP_SYMBOLS="INSTALL_MOD_STRIP=1"                                         |
|                                                     |                                      |                                    |                     | SEQUENTIAL="1"                                                              |
|                                                     |                                      |                                    |                     | KERNEL_BASE_VERSION="3.4"                                                   |
|                                                     |                                      |                                    |                     | NAMEEXT_VSERVER="-vserver"                                                  |
|                                                     |                                      |                                    |                     | NAMEEXT_ARCH="-amd64"                                                       |
|                                                     |                                      |                                    |                     | WORKDIR=/var/lib/kernel-autobuild/$KERNEL_BASE_VERSION                      |
|                                                     |                                      |                                    |                     | SOURCE_IMG=/var/lib/kernel-autobuild/00-resources/squeeze-kerneltest.img.xz |
|                                                     |                                      |                                    |                     |                                                                             |
| check for prerequisite executables                  | (inline)                             |                                    | HAVE_VNCCLIENT      |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| identify kernel source                              | kab_identify_kernel_source_version   |                                    | KSRCVER             | ARCNAME                                                                     |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION | KERNEL_VER                                                                  |
|                                                     |                                      |                                    |                     | KERNEL_PL                                                                   |
|                                                     |                                      |                                    |                     | KERNEL_SL                                                                   |
|                                                     |                                      |                                    |                     |                                                                             |
| identify vserver patch                              | kab_identify_vserver_patch           |                                    | KSRCVER             | PATCHNAME                                                                   |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION | RAW_PATCHNAME                                                               |
|                                                     |                                      |                                    |                     | PVER                                                                        |
|                                                     |                                      |                                    |                     | PURL                                                                        |
|                                                     |                                      |                                    |                     | KURL                                                                        |
|                                                     |                                      |                                    |                     | KSRCURL                                                                     |
|                                                     |                                      |                                    |                     | KSRCDATE                                                                    |
|                                                     |                                      |                                    |                     |                                                                             |
| identify a kernel config file                       | kab_identify_kernel_config_file      |                                    | KSRCVER             | LASTCONFIG                                                                  |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| free diskspace if needed                            | maintain-diskspace                   |                                    | --free              |                                                                             |
|                                                     |                                      |                                    | --workdir           |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| setup directory structure                           | (inline)                             |                                    | KSRCVER             | CURRENT_BUILD                                                               |
|                                                     |                                      |                                    | PVER                | SRC_DIR                                                                     |
|                                                     |                                      |                                    | SEQUENTIAL          | BUILD_DIR                                                                   |
|                                                     |                                      |                                    |                     | LOG_DIR                                                                     |
|                                                     |                                      |                                    |                     | INFO_DIR                                                                    |
|                                                     |                                      |                                    |                     | MP_DIR                                                                      |
|                                                     |                                      |                                    |                     | MNT_DIR                                                                     |
|                                                     |                                      |                                    |                     | IMG_DIR                                                                     |
|                                                     |                                      |                                    |                     | TMP TEMP TMPDIR TEMPDIR                                                     |
|                                                     |                                      |                                    |                     |                                                                             |
| perform downloads of sources, patches & changes     | kab_downloads                        |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | PATCHES             |                                                                             |
|                                                     |                                      |                                    | KSRCURL             |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | PURL                |                                                                             |
|                                                     |                                      |                                    | LASTCONFIG          |                                                                             |
|                                                     |                                      |                                    | VSPATCHPATCHES      |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| unpack kernel source code                           | kab_unpack_kernel_source             |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | ARCNAME             |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| get patches from previous kernel if appropriate     | kab_apply_vserver_patch              |                                    | KSRCVER             | KERN_FULL_VERSION                                                           |
|   appropriate: if we _not_ have a matching vs patch |                                      |                                    | KERNEL_BASE_VERSION | MOD_PATCHNAME                                                               |
|                                                     |                                      |                                    | PATCHNAME           |                                                                             |
|  modify these                                       |                                      |                                    | RAW_PATCHNAME       |                                                                             |
|  apply these                                        |                                      |                                    | KSRCURL             |                                                                             |
|  apply vs patch                                     |                                      |                                    | PKVER               |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | PROVIDER_TAG        |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | MP_DIR              |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | ARCNAME             |                                                                             |
|                                                     |                                      |                                    | LASTCONFIG          |                                                                             |
|                                                     |                                      |                                    | KERNEL_VER          |                                                                             |
|                                                     |                                      |                                    | KERNEL_PL           |                                                                             |
|                                                     |                                      |                                    | KERNEL_SL           |                                                                             |
|                                                     |                                      |                                    | SEQUENTIAL          |                                                                             |
|                                                     |                                      |                                    | DO_VSPATCH          |                                                                             |
|                                                     |                                      |                                    | VSPATCHPATCHES      |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| apply patches to be applied after the vserver patch | kab_apply_post_vserver_patch_patches |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| modify .config, frontend                            | kab_apply_dotconfigsettings          |                                    | DOTCONFIG_SETTING   | KAB_CHANGELOG                                                               |
|                                                     |                                      |                                    | DOTCONFIG_SETTING_FILE |                                                                          |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| modify .config, backend                             | kab_modify_dotconfig                 | actually modifies .config          |                     |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| compile & build package                             | kab_compile_and_package              |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | PROVIDER_TAG        |                                                                             |
|                                                     |                                      |                                    | USE_CPUS            |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | STRIP_SYMBOLS       |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    | KAB_CHANGELOG       |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| run tests                                           | kab_run_tests                        |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | IMG_DIR             |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | MNT_DIR             |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    | DO_VNC              |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| build meta package                                  | kab_build_meta_package               |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | SEQUENTIAL          |                                                                             |
|                                                     |                                      |                                    | PROVIDER_TAG        |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| upload packages                                     | kab_upload_packages                  |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| general                                             | (inline)                             |                                    |                     |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |

====== structure of kernel-autobuild (as of 2013-09-04, 0.6) =======

===== /usr/bin/kernel-autobuild =====

^ task                                                ^ command                              ^ detail                             ^ VAR in              ^ VAR out                                                                     ^
|                                                     |                                      |                                    |                     |                                                                             |
| source /usr/share/kernel-autobuild/global-static    | cpt. obv.                            | define usage()                     | $@                  | TOOL_DIR=/usr/share/kernel-autobuild                                        |
|                                                     |                                      | define command line parser doopt() |                     | KERNEL_AUTOBUILD_BASEDIR=/var/lib/kernel-autobuild                          |
|                                                     |                                      | read /etc/kernel-autobuild.conf    |                     | GLOBAL_DATE="$(date '+%Y%m%d-%H%M%S')"                                      |
|                                                     |                                      | read ~/.kernel-autobuild           |                     | DO_DOWNLOAD=1                                                               |
|                                                     |                                      | set defaults                       |                     | DO_UNPACK=1                                                                 |
|                                                     |                                      | run doopt()                        |                     | DO_VSPATCH=1                                                                |
|                                                     |                                      |                                    |                     | DO_COMPILE=1                                                                |
|                                                     |                                      |                                    |                     | DEBUG=0                                                                     |
|                                                     |                                      |                                    |                     | KSRCVER=""                                                                  |
|                                                     |                                      |                                    |                     | PVER=""                                                                     |
|                                                     |                                      |                                    |                     | PROVIDER_TAG="kernelautobuild"                                              |
|                                                     |                                      |                                    |                     | IDENTIFY_SOURCES=""                                                         |
|                                                     |                                      |                                    |                     | DOWNLOAD_ONLY=""                                                            |
|                                                     |                                      |                                    |                     | PATCHES=""                                                                  |
|                                                     |                                      |                                    |                     | DO_VNC="1"                                                                  |
|                                                     |                                      |                                    |                     | USE_CPUS="4"                                                                |
|                                                     |                                      |                                    |                     | LASTCONFIG=""                                                               |
|                                                     |                                      |                                    |                     | DO_TESTS="1"                                                                |
|                                                     |                                      |                                    |                     | DO_UPLOAD="1"                                                               |
|                                                     |                                      |                                    |                     | STRIP_SYMBOLS="INSTALL_MOD_STRIP=1"                                         |
|                                                     |                                      |                                    |                     | SEQUENTIAL="1"                                                              |
|                                                     |                                      |                                    |                     | KERNEL_BASE_VERSION="3.4"                                                   |
|                                                     |                                      |                                    |                     | NAMEEXT_VSERVER="-vserver"                                                  |
|                                                     |                                      |                                    |                     | NAMEEXT_ARCH="-amd64"                                                       |
|                                                     |                                      |                                    |                     | WORKDIR=/var/lib/kernel-autobuild/$KERNEL_BASE_VERSION                      |
|                                                     |                                      |                                    |                     | SOURCE_IMG=/var/lib/kernel-autobuild/00-resources/squeeze-kerneltest.img.xz |
|                                                     |                                      |                                    |                     |                                                                             |
| check for prerequisite executables                  | (inline)                             |                                    | HAVE_VNCCLIENT      |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| identify kernel source                              | kab_identify_kernel_source_version   |                                    | KSRCVER             | ARCNAME                                                                     |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION | KERNEL_VER                                                                  |
|                                                     |                                      |                                    |                     | KERNEL_PL                                                                   |
|                                                     |                                      |                                    |                     | KERNEL_SL                                                                   |
|                                                     |                                      |                                    |                     |                                                                             |
| identify vserver patch                              | kab_identify_vserver_patch           |                                    | KSRCVER             | PATCHNAME                                                                   |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION | RAW_PATCHNAME                                                               |
|                                                     |                                      |                                    |                     | PVER                                                                        |
|                                                     |                                      |                                    |                     | PURL                                                                        |
|                                                     |                                      |                                    |                     | KURL                                                                        |
|                                                     |                                      |                                    |                     | KSRCURL                                                                     |
|                                                     |                                      |                                    |                     | KSRCDATE                                                                    |
|                                                     |                                      |                                    |                     |                                                                             |
| identify a kernel config file                       | kab_identify_kernel_config_file      |                                    | KSRCVER             | LASTCONFIG                                                                  |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| free diskspace if needed                            | maintain-diskspace                   |                                    | --free              |                                                                             |
|                                                     |                                      |                                    | --workdir           |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| setup directory structure                           | (inline)                             |                                    | KSRCVER             | CURRENT_BUILD                                                               |
|                                                     |                                      |                                    | PVER                | SRC_DIR                                                                     |
|                                                     |                                      |                                    | SEQUENTIAL          | BUILD_DIR                                                                   |
|                                                     |                                      |                                    |                     | LOG_DIR                                                                     |
|                                                     |                                      |                                    |                     | INFO_DIR                                                                    |
|                                                     |                                      |                                    |                     | MP_DIR                                                                      |
|                                                     |                                      |                                    |                     | MNT_DIR                                                                     |
|                                                     |                                      |                                    |                     | IMG_DIR                                                                     |
|                                                     |                                      |                                    |                     | TMP TEMP TMPDIR TEMPDIR                                                     |
|                                                     |                                      |                                    |                     |                                                                             |
| perform downloads of sources, patches & changes     | kab_downloads                        |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | PATCHES             |                                                                             |
|                                                     |                                      |                                    | KSRCURL             |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | PURL                |                                                                             |
|                                                     |                                      |                                    | LASTCONFIG          |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| unpack kernel source code                           | kab_unpack_kernel_source             |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | ARCNAME             |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| get patches from previous kernel if appropriate     | kab_apply_vserver_patch              |                                    | KSRCVER             | KERN_FULL_VERSION                                                           |
|   appropriate: if we _not_ have a matching vs patch |                                      |                                    | KERNEL_BASE_VERSION | MOD_PATCHNAME                                                               |
|                                                     |                                      |                                    | PATCHNAME           |                                                                             |
|  modify these                                       |                                      |                                    | RAW_PATCHNAME       |                                                                             |
|  apply these                                        |                                      |                                    | KSRCURL             |                                                                             |
|  apply vs patch                                     |                                      |                                    | PKVER               |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | PROVIDER_TAG        |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | MP_DIR              |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | ARCNAME             |                                                                             |
|                                                     |                                      |                                    | LASTCONFIG          |                                                                             |
|                                                     |                                      |                                    | KERNEL_VER          |                                                                             |
|                                                     |                                      |                                    | KERNEL_PL           |                                                                             |
|                                                     |                                      |                                    | KERNEL_SL           |                                                                             |
|                                                     |                                      |                                    | SEQUENTIAL          |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| apply patches to be applied after the vserver patch | kab_apply_post_vserver_patch_patches |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| compile & build package                             | kab_compile_and_package              |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | PROVIDER_TAG        |                                                                             |
|                                                     |                                      |                                    | USE_CPUS            |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | STRIP_SYMBOLS       |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| run tests                                           | kab_run_tests                        |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | IMG_DIR             |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | MNT_DIR             |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    | DO_VNC              |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| build meta package                                  | kab_build_meta_package               |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | SEQUENTIAL          |                                                                             |
|                                                     |                                      |                                    | PROVIDER_TAG        |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| upload packages                                     | kab_upload_packages                  |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| general                                             | (inline)                             |                                    |                     |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |

====== structure of kernel-autobuild (as of 2013-07-10) =======

===== /usr/bin/kernel-autobuild =====

^ task                                                ^ command                              ^ detail                             ^ VAR in              ^ VAR out                                                                     ^
|                                                     |                                      |                                    |                     |                                                                             |
| source /usr/share/kernel-autobuild/global-static    | cpt. obv.                            | define usage()                     | $@                  | TOOL_DIR=/usr/share/kernel-autobuild                                        |
|                                                     |                                      | define command line parser doopt() |                     | KERNEL_AUTOBUILD_BASEDIR=/var/lib/kernel-autobuild                          |
|                                                     |                                      | read /etc/kernel-autobuild.conf    |                     | GLOBAL_DATE="$(date '+%Y%m%d-%H%M%S')"                                      |
|                                                     |                                      | read ~/.kernel-autobuild           |                     | DO_DOWNLOAD=1                                                               |
|                                                     |                                      | set defaults                       |                     | DO_UNPACK=1                                                                 |
|                                                     |                                      | run doopt()                        |                     | DO_VSPATCH=1                                                                |
|                                                     |                                      |                                    |                     | DO_COMPILE=1                                                                |
|                                                     |                                      |                                    |                     | DEBUG=0                                                                     |
|                                                     |                                      |                                    |                     | KSRCVER=""                                                                  |
|                                                     |                                      |                                    |                     | PVER=""                                                                     |
|                                                     |                                      |                                    |                     | IDENTIFY_SOURCES=""                                                         |
|                                                     |                                      |                                    |                     | DOWNLOAD_ONLY=""                                                            |
|                                                     |                                      |                                    |                     | PATCHES=""                                                                  |
|                                                     |                                      |                                    |                     | DO_VNC="1"                                                                  |
|                                                     |                                      |                                    |                     | USE_CPUS="4"                                                                |
|                                                     |                                      |                                    |                     | LASTCONFIG=""                                                               |
|                                                     |                                      |                                    |                     | DO_TESTS="1"                                                                |
|                                                     |                                      |                                    |                     | DO_UPLOAD="1"                                                               |
|                                                     |                                      |                                    |                     | STRIP_SYMBOLS="INSTALL_MOD_STRIP=1"                                         |
|                                                     |                                      |                                    |                     | SEQUENTIAL="1"                                                              |
|                                                     |                                      |                                    |                     | KERNEL_BASE_VERSION="3.4"                                                   |
|                                                     |                                      |                                    |                     | NAMEEXT_VSERVER="-vserver"                                                  |
|                                                     |                                      |                                    |                     | NAMEEXT_ARCH="-amd64"                                                       |
|                                                     |                                      |                                    |                     | WORKDIR=/var/lib/kernel-autobuild/$KERNEL_BASE_VERSION                      |
|                                                     |                                      |                                    |                     | SOURCE_IMG=/var/lib/kernel-autobuild/00-resources/squeeze-kerneltest.img.xz |
|                                                     |                                      |                                    |                     |                                                                             |
| check for prerequisite executables                  | (inline)                             |                                    | HAVE_VNCCLIENT      |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| identify kernel source                              | kab_identify_kernel_source_version   |                                    | KSRCVER             | ARCNAME                                                                     |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION | KERNEL_VER                                                                  |
|                                                     |                                      |                                    |                     | KERNEL_PL                                                                   |
|                                                     |                                      |                                    |                     | KERNEL_SL                                                                   |
|                                                     |                                      |                                    |                     |                                                                             |
| identify vserver patch                              | kab_identify_vserver_patch           |                                    | KSRCVER             | PATCHNAME                                                                   |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION | RAW_PATCHNAME                                                               |
|                                                     |                                      |                                    |                     | PVER                                                                        |
|                                                     |                                      |                                    |                     | PURL                                                                        |
|                                                     |                                      |                                    |                     | KURL                                                                        |
|                                                     |                                      |                                    |                     | KSRCURL                                                                     |
|                                                     |                                      |                                    |                     | KSRCDATE                                                                    |
|                                                     |                                      |                                    |                     |                                                                             |
| identify a kernel config file                       | kab_identify_kernel_config_file      |                                    | KSRCVER             | LASTCONFIG                                                                  |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| free diskspace if needed                            | maintain-diskspace                   |                                    | --free              |                                                                             |
|                                                     |                                      |                                    | --workdir           |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| setup directory structure                           | (inline)                             |                                    | KSRCVER             | CURRENT_BUILD                                                               |
|                                                     |                                      |                                    | PVER                | SRC_DIR                                                                     |
|                                                     |                                      |                                    | SEQUENTIAL          | BUILD_DIR                                                                   |
|                                                     |                                      |                                    |                     | LOG_DIR                                                                     |
|                                                     |                                      |                                    |                     | INFO_DIR                                                                    |
|                                                     |                                      |                                    |                     | MP_DIR                                                                      |
|                                                     |                                      |                                    |                     | MNT_DIR                                                                     |
|                                                     |                                      |                                    |                     | IMG_DIR                                                                     |
|                                                     |                                      |                                    |                     | TMP TEMP TMPDIR TEMPDIR                                                     |
|                                                     |                                      |                                    |                     |                                                                             |
| perform downloads of sources, patches & changes     | kab_downloads                        |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | PATCHES             |                                                                             |
|                                                     |                                      |                                    | KSRCURL             |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | PURL                |                                                                             |
|                                                     |                                      |                                    | LASTCONFIG          |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| unpack kernel source code                           | kab_unpack_kernel_source             |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | ARCNAME             |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| get patches from previous kernel if appropriate     | kab_apply_vserver_patch              |                                    | KSRCVER             |                                                                             |
|   appropriate: if we _not_ have a matching vs patch |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
| apply these                                         |                                      |                                    | PATCHNAME           |                                                                             |
| apply vs patch                                      |                                      |                                    | RAW_PATCHNAME       |                                                                             |
|                                                     |                                      |                                    | KSRCURL             |                                                                             |
|                                                     |                                      |                                    | PKVER               |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | MP_DIR              |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | ARCNAME             |                                                                             |
|                                                     |                                      |                                    | LASTCONFIG          |                                                                             |
|                                                     |                                      |                                    | KERNEL_VER          |                                                                             |
|                                                     |                                      |                                    | KERNEL_PL           |                                                                             |
|                                                     |                                      |                                    | KERNEL_SL           |                                                                             |
|                                                     |                                      |                                    | SEQUENTIAL          |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| apply patches to be applied after the vserver patch | kab_apply_post_vserver_patch_patches |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| compile & build package                             | kab_compile_and_package              |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | USE_CPUS            |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | SRC_DIR             |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | STRIP_SYMBOLS       |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| run tests                                           | kab_run_tests                        |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | IMG_DIR             |                                                                             |
|                                                     |                                      |                                    | LOG_DIR             |                                                                             |
|                                                     |                                      |                                    | MNT_DIR             |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    | DO_VNC              |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| build meta package                                  | kab_build_meta_package               |                                    | KSRCVER             |                                                                             |
|                                                     |                                      |                                    | KERNEL_BASE_VERSION |                                                                             |
|                                                     |                                      |                                    | PVER                |                                                                             |
|                                                     |                                      |                                    | SEQUENTIAL          |                                                                             |
|                                                     |                                      |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| upload packages                                     | kab_upload_packages                  |                                    | BUILD_DIR           |                                                                             |
|                                                     |                                      |                                    | INFO_DIR            |                                                                             |
|                                                     |                                      |                                    | DEBUG               |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |
| general                                             | (inline)                             |                                    |                     |                                                                             |
|                                                     |                                      |                                    |                     |                                                                             |

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International

project/kernel-autobuild/structure.1460571596.txt.gz · Last modified: 2016/04/13 20:19 by 91.89.129.106