BG-InitRamFS

BG-InitRamFS is a simple initramfs to run LVM2, decode the root 
parameter and to finally mount root.

It is fully embeddable into the Linux kernel.

It supports LVM2, UUID, LABEL and LILO-style "root" parameters. It
is compatible with i386 and amd64 systems and depends on devtmpfs.

The primary use for this project is when you use your own kernel 
with everything for root-access compiled in but want to use a 
modern way of passing the root parameter or want to use LVM2.
 
Booting from LUKS-encrypted (LUKS1/LUKS2) root device is supported.
If using encryption:
  - "cryptroot" points to the ENcrypted device
  - "root" points to the DEcrypted device (as it should be created)

NOTA BENE: The included cryptsetup relies solely on kernel functions
           instead of libcrypt and therefore needs some more kernel
           modules compared to a regular debian install!
           For a typical aes-xts-plain64 encryption you will need 
           ciphers, hashes, modules to access the root device,
           filesystem-modules and dm-crypt like a usual debian system,
           and ADDITIONALLY AT LEAST: algif_skcipher, algif_hash, af_alg

This program uses code derived from initramfs-tools 0.120


This program makes use of:

busybox  1.32.1		  (GNU GENERAL PUBLIC LICENSE, Version 2)
cryptsetup  2.3.4	  (GNU GENERAL PUBLIC LICENSE, Version 2;
			   GNU LESSER GENERAL PUBLIC LICENSE, Version 2.1)
initramfs-tools  0.120    (GNU GENERAL PUBLIC LICENSE, Version 2)
json-c  0.15-20200726	  (Expat License)
libaio  0.3.112		  (GNU LESSER GENERAL PUBLIC LICENSE, Version 2.1)
LVM2  2.03.11             (GNU GENERAL PUBLIC LICENSE, Version 2;
                           GNU LESSER GENERAL PUBLIC LICENSE, Version 2.1;
			   BSD 2-Clause License)
musl libc (i386)  1.1.21  (Standard MIT License)
popt  1.18		  (X-Consortium License)
util-linux  2.36.2        (GNU GENERAL PUBLIC LICENSE, Version 2)


Version:

  3.0  (Released 07 May 2021)  by Bodo Giannone (http://www.giannone.ch)
  
Download: bginitramfs-3.0.tar.gz
 
SHA1-SUM: cbf9a0009b85d7728b26927029c4c994315d5cf3

License: GNU GENERAL PUBLIC LICENSE


Usage:

  To use it just pass "initrd=bginitramfs.img" and a correct 
  "root=..." option and optionally "cryptroot=..." 
  as boot parameters.

  Additional optional parameters are:
  break, cryptflags, devmount, init, modules, rootflags, 
  rootfstype, rootwait

  You need devtmpfs, all modules neccessary to access your
  root device, possibly ciphers and hashes for cryptroot 
  and gzip-compressed initramfs support compiled
  directly into the kernel.
                

Contact:

  Bodo Giannone:  Contact Information