diff options
-rw-r--r-- | devel/script/2_keys.xml | 138 |
1 files changed, 137 insertions, 1 deletions
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 </formalpara> <formalpara id="keymap.format"> <title>Format</title> - <para>The <literal>keymap</literal> key is a string value that specifies the name of a keyboard layout. Valid keyboard layouts are listed in <filename class="file">/etc/console-setup/ckb/rules/xorg.lst</filename> under the <literal>! layout</literal> heading. <literal>keymap</literal> may appear at most once in a HorizonScript.</para> + <para>The <literal>keymap</literal> key is a string value that specifies the name of a keyboard layout. Valid keyboard layouts are listed in <filename>/etc/console-setup/ckb/rules/xorg.lst</filename> under the <literal>! layout</literal> heading. <literal>keymap</literal> may appear at most once in a HorizonScript.</para> </formalpara> <formalpara id="keymap.default"> <title>Default</title> @@ -174,5 +174,141 @@ firmware false </para> </formalpara> </section> + <section id="netaddress"> + <title><literal>netaddress</literal></title> + <formalpara id="netaddress.name"> + <title>Name</title> + <para><literal>netaddress</literal></para> + </formalpara> + <formalpara id="netaddress.purpose"> + <title>Purpose</title> + <para>The <literal>netaddress</literal> key determines the network configuration used on the target computer.</para> + </formalpara> + <formalpara id="netaddress.format"> + <title>Format</title> + <para>The <literal>netaddress</literal> key is a space-separated list of network configuration information: + <orderedlist id="netaddress.format.items"> + <listitem><para>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).</para></listitem> + <listitem><para>The addressing type. Valid values are <literal>dhcp</literal> for DHCP v4 and v6, <literal>slaac</literal> for IPv6 Stateless Automatic Address Configuration, and <literal>static</literal> for Administrator-specified addressing. The list must end here unless the address type specified is <literal>static</literal>. Any additional items constitute a configuration error and an invalid HorizonScript.</para></listitem> + <listitem><para>The IP address. The value specified must be a valid IPv4 or IPv6 address.</para></listitem> + <listitem><para>The prefix or network mask. The value must be either: + <orderedlist id="netaddress.format.prefix_types"> + <listitem><para>A whole number in the range of 1-32 for IPv4 addresses, or 1-64 for IPv6 addresses.</para></listitem> + <listitem><para>An IPv4 network mask, in the format <literal><replaceable>octet</replaceable>.<replaceable>octet</replaceable>.<replaceable>octet</replaceable>.<replaceable>octet</replaceable></literal>.</para></listitem> + </orderedlist> + </para></listitem> + <listitem><para>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.</para></listitem> + </orderedlist> + <literal>netaddress</literal> must not appear unless <literal>network</literal> is <literal>true</literal>. If <literal>network</literal> is <literal>true</literal>, then <literal>netaddress</literal> must appear at least once, and may appear up to 255 times per interface. + </para> + </formalpara> + <formalpara id="netaddress.default"> + <title>Default</title> + <para>There is no default for this key. It is invalid to enable networking and not provide at least one <literal>netaddress</literal> key.</para> + </formalpara> + <formalpara id="netaddress.example"> + <title>Example</title> + <para> + <example> + <title>The <literal>netaddress</literal> Key — Simple DHCP</title> + <programlisting> +netaddress eth0 dhcp + </programlisting> + <para>This configures the target computer to use DHCP on interface <literal>eth0</literal>.</para> + </example> + <example> + <title>The <literal>netaddress</literal> Key — Static Addressing</title> + <programlisting> +netaddress eth0 2001:db8::1337 64 2001:db8::1 +netaddress eth0 198.51.100.37 24 198.51.100.1 + </programlisting> + <para>This configures the target computer to use the addresses <literal>2001:db::1337/64</literal> and <literal>198.51.100.37/24</literal> on interface <literal>eth0</literal>. The default gateways are <literal>2001:db::1</literal> and <literal>198.51.100.1</literal>.</para> + </example> + </para> + </formalpara> + </section> + <section id="nameserver"> + <title><literal>nameserver</literal></title> + <formalpara id="nameserver.name"> + <title>Name</title> + <para><literal>nameserver</literal></para> + </formalpara> + <formalpara id="nameserver.purpose"> + <title>Purpose</title> + <para>The <literal>nameserver</literal> key determines the DNS server used for name queries on the target computer.</para> + </formalpara> + <formalpara id="nameserver.format"> + <title>Format</title> + <para>The <literal>nameserver</literal> key takes either an IPv4 address or IPv6 address. Any other value is invalid. The <literal>nameserver</literal> may appear up to four times in a HorizonScript, or be omitted. It is valid to specify <literal>nameserver</literal> even if <literal>network</literal> is <literal>false</literal>, but name queries will not function properly without a network configuration.</para> + </formalpara> + <formalpara id="nameserver.default"> + <title>Default</title> + <para>If the <literal>nameserver</literal> key is not specified, name queries requiring the DNS will not succeed on the target computer.</para> + </formalpara> + <formalpara id="nameserver.example"> + <title>Example</title> + <para> + <example> + <title>The <literal>nameserver</literal> Key</title> + <programlisting> +nameserver 2620:fe::fe + </programlisting> + <para>This configures the target computer to use <ulink url="https://www.quad9.net/about/">Quad9</ulink>'s public resolver, <literal>2620:fe::fe</literal>, for name queries.</para> + </example> + </para> + </formalpara> + </section> + <section id="netssid"> + <title><literal>netssid</literal></title> + <formalpara id="netssid.name"> + <title>Name</title> + <para><literal>netssid</literal></para> + </formalpara> + <formalpara id="netssid.purpose"> + <title>Purpose</title> + <para>The <literal>netssid</literal> key determines the wireless networking configuration on the target computer.</para> + </formalpara> + <formalpara id="netssid.format"> + <title>Format</title> + <para>The <literal>netssid</literal> is a space-separated list of wireless networking configuration information: + <orderedlist id="netssid.format.items"> + <listitem><para>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).</para></listitem> + <listitem><para>The SSID name to connect to. This must be a string value enclosed by ASCII double-quotes (<literal>"</literal>). System behaviour is undefined if the SSID name contains an ASCII double-quote.</para></listitem> + <listitem><para>The security type of the SSID. Valid values are <literal>none</literal> for an open access point, <literal>wep</literal> for a WEP passphrase, and <literal>wpa</literal> for a WPA pre-shared key (PSK).</para></listitem> + <listitem><para>If the security type is not <literal>none</literal>, 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.</para></listitem> + </orderedlist> + </para> + </formalpara> + <formalpara id="netssid.default"> + <title>Default</title> + <para>If the <literal>netssid</literal> key is not specified, no wireless network configuration will be present on the target computer.</para> + </formalpara> + <formalpara id="netssid.examples"> + <title>Examples</title> + <para> + <example> + <title>The <literal>netssid</literal> Key — Open Network</title> + <programlisting> +netssid wlan0 "Insecure Net" none + </programlisting> + <para>This configures the target computer to connect to the access point with name <literal>Insecure Net</literal>, with no security.</para> + </example> + <example> + <title>The <literal>netssid</literal> Key — WEP Network</title> + <programlisting> +netssid wlan0 "Hophop" wep omgitsarabbit + </programlisting> + <para>This configures the target computer to connect to the access point with name <literal>Hophop</literal>, and the WEP passphrase <literal>omgitsarabbit</literal>.</para> + </example> + <example> + <title>The <literal>netssid</literal> Key — WPA2 Network</title> + <programlisting> +netssid wlan0 "The New Fox 5G" wpa shh sekrit + </programlisting> + <para>This configures the target computer to connect to the access point with name <literal>The New Fox 5G</literal>, with the WPA PSK <literal>shh sekrit</literal>.</para> + </example> + </para> + </formalpara> + </section> </section> </chapter> |