OSDN Git Service

void-66boot-.md: almost complete.
authormobinmob <mobinmob@disroot.org>
Sat, 6 May 2023 10:12:55 +0000 (13:12 +0300)
committermobinmob <mobinmob@disroot.org>
Sat, 6 May 2023 10:12:55 +0000 (13:12 +0300)
conf/void-66boot-.md

index 5186fc9..7d52ca3 100644 (file)
@@ -12,13 +12,14 @@ These are:
 
 `66boot-initial-setup` is the first script written. 
 It can be used to create basic `trees` (boot, default and runit) and enable:
+
 - the `boot@system` module service in the *boot* tree, 
 - the `switch-initutils` service in the *default* tree and the 
 - `runit` service in the *runit* tree.
 
 The default tree is set as the current tree and the runit tree is configured to run after the default.
  
-It also makes certain that the default *boot@system* environment file (configuration) is in the proper path and can be acceses using the `/etc/66rc.conf` symlink.
+It also makes certain that the default *boot@system* environment file (configuration) is in the proper path and can be accesed using the `/etc/66rc.conf` symlink.
 
 All that means that `66boot-initial-setup`, besides helping the user with basic configuration, implements a barebones policy for a 66-booted voidlinux system.
 This policy is modeled after the current official runit voidlinux policy.
@@ -28,14 +29,14 @@ These are all implemented as an external script - the user is not required to us
 
 ### 2.2 66boot-rcdotconf
 
-After running `66boot-initial-setup` a user is expected to configure their system, either by editing directly /etc/66rc.conf or by using `66-env`.
+After running `66boot-initial-setup` a user is expected to configure their system, either by editing directly `/etc/66rc.conf` or by using `66-env`.
 The boot@ service gives the user a lot of power in order to configure the boot process and that is awesome and... dangerous.
 Some basic configuration keys correspond to the configurations keys in /etc/rc.conf and these settings can be safely transferred to the new configuration format. That is exactly what `66boot-rc.conf` does. And in many cases it will be enough to run it in order to configure  the system.
 A user can then either continue using rc.conf and re-run the script on configuration changes or gradually learn and take advantag of the new configuration format.
 
 ### 2.3 66boot-storage-autoconf
 
-When an option in the `boot@` module service configuration is disabled,the corresponding service script will not run at all. That is a very nice feature that lets a user finetune the boot process and avoid execution of what they do not need.
+When an option in the `boot@` module service configuration is disabled,the corresponding service script will not run at all. That is a very nice feature that lets a user fine-tune the boot process and avoid execution of what they do not need.
 It can also lead to severe problems in boot if a needed options are disabled. `66boot-rcdotconf` will check for the validity of some configuration keys when applying configurationf from `/etc/rc.conf`, but there was another area with potential issues.
 
 `boot@` has seperate services for the support of lvm, mdraid, dmraid, luks, zfs, btrfs. In the original implementation enabling one of these if the necessary utilities were not present in the system or even if there were but no storage device of the type was detected, the boot will fail. 
@@ -51,3 +52,10 @@ These three scripts are in some ways voidlinux-specific:
 - `66boot-rcdotconf` is tranlating the voidlinux `/etc/rc.conf`, and while they are other distributions with similar configurations it is not certain that translated to exactly the same or compatible implementation.
 - `66boot-storage-autoconf` is probably the most distribution-independent of the three. But it still has some aspects - such as package names- that are voidlinux-specific. These are clearly documented in the script comments.
 
+Code and ideas from `66boot-rcdotconf` and `66boot-storage-autoconf` has been used to improve the configure script in the upstream boot@ service. If anyone needs to leard the gory details, they can [read the MR comments](https://git.obarun.org/obmods/boot-66serv/-/merge_requests/1).
+
+## 4. Future work
+
+There is not much to do in adding features to the scripts - they will follow the development off 66. That means that in the next version they will need to be adjusted for the major cli ui changes. 
+
+There will probably be a feature removal for 66boot-initial setup. Creating trees and populating them will be streamlined and the -effective but crude- way to  do that will be obsolete.