napcok/calamares
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Docs: reformat table of GS keys

Browse Source 
- add fullname key
- make table a little easier-on-the-eyes in text mode

While here, merge some 3.3 updates; just don't talk about PythonQt
any more.
This commit is contained in:
Adriaan de Groot 2022-04-13 14:40:00 +02:00
parent a67adf7702
commit b0837b1a98
1 changed files with 20 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
src/modules/README.md
View File

@ -58,10 +58,10 @@ Module descriptors for C++ modules **may** have the following key:
Module descriptors for Python modules **must** have the following key: Module descriptors for Python modules **must** have the following key:
- *script* (the name of the Python script to load, nearly always `main.py`) - *script* (the name of the Python script to load, nearly always `main.py`)
Module descriptors for process modules **must** have the following key: Module descriptors for process modules **must** have the following key:
- *command* (the command to run) - *command* (the command to run)
Module descriptors for process modules **may** have the following keys: Module descriptors for process modules **may** have the following keys:
- *timeout* (how long, in seconds, to wait for the command to run) - *timeout* (how long, in seconds, to wait for the command to run)
- *chroot* (if true, run the command in the target system rather than the host) - *chroot* (if true, run the command in the target system rather than the host)
Note that process modules are not recommended. Note that process modules are not recommended.
@ -181,23 +181,25 @@ for determining the relative weights there.
## Global storage keys ## Global storage keys
Some modules place values in global storage so that they can be referenced later by other modules or even other parts of the same module. The following table represents a partial list of the values available as well as where they originate from and which module consume them. Some modules place values in global storage so that they can be referenced later by other modules or even other parts of the same module. The following table represents a partial list of the values available as well as where they originate from and which module consume them.
Key|Source|Consumers|Description Key |Source |Consumers|Description
---|---|---|--- ------------------|----------------|---|---
btrfsSubvolumes|mount|fstab|List of maps containing the mountpoint and btrtfs subvolume btrfsSubvolumes |mount |fstab|List of maps containing the mountpoint and btrtfs subvolume
btrfsRootSubvolume|mount|bootloader, luksopenswaphook|String containing the subvolume mounted at root btrfsRootSubvolume|mount |bootloader, luksopenswaphook|String containing the subvolume mounted at root
efiSystemPartition|partition|bootloader, fstab|String containing the path to the ESP relative to the installed system efiSystemPartition|partition |bootloader, fstab|String containing the path to the ESP relative to the installed system
extraMounts|mount|unpackfs|List of maps holding metadata for the temporary mountpoints used by the installer extraMounts |mount |unpackfs|List of maps holding metadata for the temporary mountpoints used by the installer
hostname|users||A string containing the hostname of the new system fullname |users ||The full username (e.g. "Jane Q. Public")
netinstallAdd|packagechooser|netinstall|Data to add to netinstall tree. Same format as netinstall.yaml hostname |users ||A string containing the hostname of the new system
netinstallSelect|packagechooser|netinstall|List of group names to select in the netinstall tree netinstallAdd |packagechooser |netinstall|Data to add to netinstall tree. Same format as netinstall.yaml
partitions|partition, rawfs|numerous modules|List of maps of metadata about each partition netinstallSelect |packagechooser |netinstall|List of group names to select in the netinstall tree
rootMountPoint|mount|numerous modules|A string with the absolute path to the root mountpoint partitions |partition, rawfs|numerous modules|List of maps of metadata about each partition
username|users|networkcfg, plasmainf, preservefiles|A string containing the username of the new user rootMountPoint |mount |numerous modules|A string with the absolute path to the root mountpoint
zfsDatasets|zfs|bootloader, grubcfg, mount|List of maps of zfs datasets including the name and mount information username |users |networkcfg, plasmainf, preservefiles|A string containing the username of the new user
zfsInfo|partition|mount, zfs|List of encrypted zfs partitions and the encription info zfsDatasets |zfs |bootloader, grubcfg, mount|List of maps of zfs datasets including the name and mount information
zfsPoolInfo|zfs|mount, umount|List of maps of zfs pool info including the name and mountpoint zfsInfo |partition |mount, zfs|List of encrypted zfs partitions and the encription info
zfsPoolInfo |zfs |mount, umount|List of maps of zfs pool info including the name and mountpoint
## C++ modules ## C++ modules
@ -478,17 +480,6 @@ all be considered deprecated by the callback-enabled functions, above.
All of the API functions for running commands set the environment All of the API functions for running commands set the environment
LC_ALL and LANG to "C" for the called command. LC_ALL and LANG to "C" for the called command.
## PythonQt modules (deprecated)
> Type: viewmodule, jobmodule
> Interface: pythonqt
The PythonQt modules are deprecated and will be removed in Calamares 3.3.
Their documentation is also almost completely lacking.
## Process modules ## Process modules
Use of this kind of module is **not** recommended. Use of this kind of module is **not** recommended.