efi-sync

Automatically install your kernel and initrd into the EFI
git clone git://git.server.ky/slackcoder/efi-sync
Log | Files | Refs | README

README.md (2172B)

      1 # EFI Sync
      2 
      3 Automatically install your kernel and initrd into the EFI when your Slackware system is updated.
      4 
      5 ```
      6 Usage: ./efi-sync {install|watch}
      7 
      8 	- install: install the kernel and initrd into your EFI.
      9 	- watch: install on updates to your kernel
     10 
     11 ```
     12 
     13 `efi-sync watch` watches your kernel path for updates.  Your EFI will be updated once
     14 one is detected and the package commands have completed.
     15 
     16 For systems using an initial ram disk (initrd), `efi-sync watch` watches
     17 /lib/modules and /lib/firmware for updates.  Your system is assumed to use one
     18 if '/etc/mkinitrd.conf' is present on start.  Once changes are detected, the
     19 initrd file is recreated using 'mkinitrd' and with the result installed into
     20 the EFI.
     21 
     22 You will need to manually install the initrd if it was recreated outside of
     23 this program.
     24 
     25 ## Project To Do's
     26 
     27 Planned improvements and known bugs are listed on the project's
     28 [todo](https://git.server.ky/slackcoder/efi-sync/tree?h=todo) branch.
     29 
     30 ## Installation
     31 
     32 Run the following are root to install this command:
     33 ```
     34 cp efi-sync /usr/local/sbin/efi-sync
     35 chown root:root /usr/local/sbin/efi-sync
     36 chmod +x /usr/local/sbin/efi-sync
     37 ```
     38 
     39 The efi-sync will need to be integrated to start automatically on your system.
     40 
     41 ## Configuration
     42 
     43 The command looks for configuration at /etc/efi-sync.conf.
     44 
     45 Here is an example with the default values:
     46 ```
     47 # The kernel path to watch.
     48 KERNEL=/boot/vmlinuz
     49 # The path to the EFI kernel.
     50 EFI_KERNEL=/boot/efi/Slackware/vmlinuz
     51 # The path for the initial ram disk to install.
     52 INITRD=/boot/initrd.gz
     53 # The path to the EFI's initial ram disk.
     54 EFI_INITRD=/boot/efi/Slackware/initrd.gz
     55 ```
     56 
     57 If you want the initial ram disk updated, ensure /etc/mkinitrd.conf exists and
     58 is configured correctly.
     59 
     60 ### Testing
     61 
     62 To test everything is working correctly:
     63 
     64 ```
     65 slackpkg -batch=on -default_answer=y upgrade --reinstall kernel-huge
     66 
     67 # You should confirm the recent update with this output.
     68 date -r /boot/efi/EFI/Slackware/vmlinuz
     69 ```
     70 
     71 For initrd updates:
     72 ```
     73 slackpkg -batch=on -default_answer=y upgrade --reinstall kernel-firmware
     74 
     75 # You should confirm the recent update with this output.
     76 date -r /boot/efi/EFI/Slackware/initrd.gz
     77 ```