improve documentation

This commit is contained in:
ading2210 2023-12-26 03:33:28 +00:00
parent c0daaf71fa
commit 3de0b9aa55
4 changed files with 8 additions and 7 deletions

View File

@ -33,9 +33,10 @@ Driver support depends on the device you are using shimboot on. This list is for
- Bluetooth - Bluetooth
- Zram - Zram
- Wifi - Wifi
- Booting a squashfs
### What Doesn't Work: ### What Doesn't Work:
- Audio - Audio (due to a firmware bug)
- Suspend (disabled by the kernel) - Suspend (disabled by the kernel)
- Swap (disabled by the kernel) - Swap (disabled by the kernel)
@ -91,11 +92,14 @@ Driver support depends on the device you are using shimboot on. This list is for
Using any Linux distro is possible, provided that you apply the [proper patches](https://github.com/ading2210/chromeos-systemd) to systemd and recompile it. Most distros have some sort of bootstrapping tool that allows you to install it to a directory on your host PC. Then, you can just pass that rootfs dir into `build.sh`. Using any Linux distro is possible, provided that you apply the [proper patches](https://github.com/ading2210/chromeos-systemd) to systemd and recompile it. Most distros have some sort of bootstrapping tool that allows you to install it to a directory on your host PC. Then, you can just pass that rootfs dir into `build.sh`.
#### How can I install a desktop environment other than XFCE? #### How can I install a desktop environment other than XFCE?
Simply edit `rootfs/opt/setup_rootfs.sh`, and change the line after the `#install desktop` comment. By default, this is set to install XFCE using the `task-xfce-desktop` package, but you can change this to install whatever you want. You can pass another argument to the `build_rootfs.sh` script, like this: `sudo ./build_rootfs.sh data/rootfs bookworm "task-lxde-desktop"`. The third argument is a list of packages that will be installed in the place of XFCE.
#### Will this prevent me from using Chrome OS normally? #### Will this prevent me from using Chrome OS normally?
Shimboot does not touch the internal storage at all, so you will be able to use Chrome OS as if nothing happened. However, if you are on an enterprise enrolled device, booting Chrome OS again will force a powerwash due to the attempted switch into developer mode. Shimboot does not touch the internal storage at all, so you will be able to use Chrome OS as if nothing happened. However, if you are on an enterprise enrolled device, booting Chrome OS again will force a powerwash due to the attempted switch into developer mode.
#### Can I unplug the USB drive while using Debian?
By default, this is not possible. However, you can simply copy your Debian rootfs onto your internal storage by first using `fdisk` to repartition it, using `dd` to copy the partition, and `resize2fs` to have it take up the entire drive. In the future, loading the OS to RAM may be supported, but this isn't a priority at the moment.
## Copyright: ## Copyright:
Shimboot is licensed under the [GNU GPL v3](https://www.gnu.org/licenses/gpl-3.0.txt). Unless otherwise indicated, all code has been written by me, [ading2210](https://github.com/ading2210). Shimboot is licensed under the [GNU GPL v3](https://www.gnu.org/licenses/gpl-3.0.txt). Unless otherwise indicated, all code has been written by me, [ading2210](https://github.com/ading2210).

View File

@ -58,7 +58,6 @@ echo "extracting data from kernel"
initramfs_dir=/tmp/shim_initramfs initramfs_dir=/tmp/shim_initramfs
rm -rf $initramfs_dir rm -rf $initramfs_dir
extract_initramfs $kernel_dir/kernel.bin $kernel_dir $initramfs_dir extract_initramfs $kernel_dir/kernel.bin $kernel_dir $initramfs_dir
umount $shim_rootfs
losetup -d $shim_loop losetup -d $shim_loop
echo "patching initramfs" echo "patching initramfs"
@ -66,7 +65,7 @@ patch_initramfs $initramfs_dir
echo "creating disk image" echo "creating disk image"
rootfs_size=$(du -sm $rootfs_dir | cut -f 1) rootfs_size=$(du -sm $rootfs_dir | cut -f 1)
rootfs_part_size=$(($rootfs_size * 11 / 10)) rootfs_part_size=$(($rootfs_size * 12 / 10))
#create a 20mb bootloader partition #create a 20mb bootloader partition
#rootfs partition is 20% larger than its contents #rootfs partition is 20% larger than its contents
create_image $output_path 20 $rootfs_part_size create_image $output_path 20 $rootfs_part_size

View File

@ -44,6 +44,7 @@ packages="${3-'task-xfce-desktop'}"
debootstrap --arch amd64 $release_name $rootfs_dir http://deb.debian.org/debian/ debootstrap --arch amd64 $release_name $rootfs_dir http://deb.debian.org/debian/
cp -ar rootfs/* $rootfs_dir cp -ar rootfs/* $rootfs_dir
cp /etc/resolv.conf $rootfs_dir/etc/resolv.conf
chroot_mounts="proc sys dev run" chroot_mounts="proc sys dev run"
for mountpoint in $chroot_mounts; do for mountpoint in $chroot_mounts; do

View File

@ -24,9 +24,6 @@ Pin: origin ${custom_repo_domain}
Pin-Priority: 1001 Pin-Priority: 1001
END END
#fix name servers
echo "nameserver 1.1.1.1" > /etc/resolv.conf
#install the patched systemd #install the patched systemd
apt-get install -y ca-certificates apt-get install -y ca-certificates
apt-get update apt-get update