From aae3f5877f339d9e4d53a4ad9205a8ad086fe14c Mon Sep 17 00:00:00 2001 From: "A. Wilcox" Date: Thu, 5 Sep 2019 09:34:36 -0500 Subject: script: keys: Add network-related keys --- devel/script/2_keys.xml | 138 +++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 137 insertions(+), 1 deletion(-) (limited to 'devel/script') diff --git a/devel/script/2_keys.xml b/devel/script/2_keys.xml index 632efe3..221180f 100644 --- a/devel/script/2_keys.xml +++ b/devel/script/2_keys.xml @@ -124,7 +124,7 @@ language fr_CA Format - The keymap key is a string value that specifies the name of a keyboard layout. Valid keyboard layouts are listed in /etc/console-setup/ckb/rules/xorg.lst under the ! layout heading. keymap may appear at most once in a HorizonScript. + The keymap key is a string value that specifies the name of a keyboard layout. Valid keyboard layouts are listed in /etc/console-setup/ckb/rules/xorg.lst under the ! layout heading. keymap may appear at most once in a HorizonScript. Default @@ -174,5 +174,141 @@ firmware false +
+ <literal>netaddress</literal> + + Name + netaddress + + + Purpose + The netaddress key determines the network configuration used on the target computer. + + + Format + The netaddress key is a space-separated list of network configuration information: + + The kernel interface name. If the interface specified does not exist, the system will issue a soft error (logging the failure but attempting to continue with installation). + The addressing type. Valid values are dhcp for DHCP v4 and v6, slaac for IPv6 Stateless Automatic Address Configuration, and static for Administrator-specified addressing. The list must end here unless the address type specified is static. Any additional items constitute a configuration error and an invalid HorizonScript. + The IP address. The value specified must be a valid IPv4 or IPv6 address. + The prefix or network mask. The value must be either: + + A whole number in the range of 1-32 for IPv4 addresses, or 1-64 for IPv6 addresses. + An IPv4 network mask, in the format octet.octet.octet.octet. + + + Optionally, the default gateway. The value specified must be a valid IP address of the same family as the IP address specified in item 3. + + netaddress must not appear unless network is true. If network is true, then netaddress must appear at least once, and may appear up to 255 times per interface. + + + + Default + There is no default for this key. It is invalid to enable networking and not provide at least one netaddress key. + + + Example + + + The <literal>netaddress</literal> Key — Simple DHCP + +netaddress eth0 dhcp + + This configures the target computer to use DHCP on interface eth0. + + + The <literal>netaddress</literal> Key — Static Addressing + +netaddress eth0 2001:db8::1337 64 2001:db8::1 +netaddress eth0 198.51.100.37 24 198.51.100.1 + + This configures the target computer to use the addresses 2001:db::1337/64 and 198.51.100.37/24 on interface eth0. The default gateways are 2001:db::1 and 198.51.100.1. + + + +
+
+ <literal>nameserver</literal> + + Name + nameserver + + + Purpose + The nameserver key determines the DNS server used for name queries on the target computer. + + + Format + The nameserver key takes either an IPv4 address or IPv6 address. Any other value is invalid. The nameserver may appear up to four times in a HorizonScript, or be omitted. It is valid to specify nameserver even if network is false, but name queries will not function properly without a network configuration. + + + Default + If the nameserver key is not specified, name queries requiring the DNS will not succeed on the target computer. + + + Example + + + The <literal>nameserver</literal> Key + +nameserver 2620:fe::fe + + This configures the target computer to use Quad9's public resolver, 2620:fe::fe, for name queries. + + + +
+
+ <literal>netssid</literal> + + Name + netssid + + + Purpose + The netssid key determines the wireless networking configuration on the target computer. + + + Format + The netssid is a space-separated list of wireless networking configuration information: + + The kernel interface name. If the interface specified does not exist, the system will issue a soft error (logging the failure but attempting to continue with installation). + The SSID name to connect to. This must be a string value enclosed by ASCII double-quotes ("). System behaviour is undefined if the SSID name contains an ASCII double-quote. + The security type of the SSID. Valid values are none for an open access point, wep for a WEP passphrase, and wpa for a WPA pre-shared key (PSK). + If the security type is not none, the passphrase or pre-shared key. WPA PSKs may be specified in hexadecimal or as a raw string. The remainder of the line will be used verbatim. + + + + + Default + If the netssid key is not specified, no wireless network configuration will be present on the target computer. + + + Examples + + + The <literal>netssid</literal> Key — Open Network + +netssid wlan0 "Insecure Net" none + + This configures the target computer to connect to the access point with name Insecure Net, with no security. + + + The <literal>netssid</literal> Key — WEP Network + +netssid wlan0 "Hophop" wep omgitsarabbit + + This configures the target computer to connect to the access point with name Hophop, and the WEP passphrase omgitsarabbit. + + + The <literal>netssid</literal> Key — WPA2 Network + +netssid wlan0 "The New Fox 5G" wpa shh sekrit + + This configures the target computer to connect to the access point with name The New Fox 5G, with the WPA PSK shh sekrit. + + + +
-- cgit v1.2.3-60-g2f50