sysinfo(4) Kernel Interfaces Manual sysinfo(4)
NAME
sysinfo - file for setting system information parameters, used with drd rehost
SYNOPSIS
DESCRIPTION
When present, the file is used during the boot of an Itanium-based system to set system hostname, IP address, timezone, DNS domain, and
other system and networking parameters. Support for the file is not provided for PA-RISC systems.
The file must be located in the EFI/HPUX directory of the EFI (Extensible Firmware Interface) partition of a boot disk. The file is copied
to the EFI partition using the command.
Processing of the file by delivered by the fileset, during the step of the boot of HP-UX 11i v3 was introduced for 11iv3 (11.31) by
PHCO_36525.
When the file is not present, the usual determination for displaying the interactive interface is made. See auto_parms(1M) and
set_parms(1M).
If a required parameter in the file is missing or incorrect, or if the parameter in the file is set to the FIRST-BOOT interactive interface
is displayed.
Messages generated when the file is processed are recorded in
After processing, the field is set to in the file. This prevents the file from being processed on subsequent boots of the same disk.
SYSINFO.TXT File Syntax
The file supports full-line comments, indicated by a in column 1.
Parameters may be entered in any order in the file. If a parameter is listed multiple times, the last occurrence is used.
Each parameter must have the form:
Some parameters are set once for the entire system. Array parameters (those ending in [n] for a non-negative integer n) are set for their
corresponding network interfaces.
In general, the parameters set for the entire system are not required and default to the value already present on the system.
The exception is which must be specified unless is set to (See below for acceptable values of
In contrast, the network interface parameters for the target system must be specified. Pre-existing network interface information on the
system will be removed. For example, is returned to its status before processing the parameters in
Parameters Set for the Entire System
Default The Domain Name System domain setting on the system is not changed.
Status Optional
Value The name of the Domain Name System domain.
Default The Domain Name System setting on the system is not changed.
Status Optional
Value The Domain Name System server, specified as an IP address in decimal-dot notation (e.g. 192.1.2.3).
Default The parameter has no default. It must be specified when is not set to
Status The parameter is required.
Value The value of the hostname
* must consist of the characters:
[a-z] [A-Z] [0-9] [-,_]
* must not begin with a digit, however each dot separated component of a domain name can start with a digit
* must not end with "-" or "_" and
* must not be longer than the value returned by getconf(1).
Default
Status Optional
If is set to it is the only parameter needed in the file.
Processing of other parameters before display of the interactive interface is undefined when is set to
Value Display the FIRST-BOOT interactive interface.
Only display the FIRST-BOOT interactive interface if necessary information is missing or incorrect.
Default The language on the system is not changed.
Status Optional
Value A value displayed by
The language must be installed in the operating system in the HP-UX partition.
Default The Network Information Service domain on the system is not changed.
Status Optional
Value The Network Information Service domain.
Default The Network Information Service server on the system is not changed.
Status Optional
Value The Network Information Service server, specified as an IP address in decimal-dot notation (e.g. 192.1.2.3).
Default
Status This option should not be included. It is added by and set to when the file is processed. If a SYSINFO.TXT file has been
copied to the file system with remove all lines containing SYSINFO_PROCESSED before using the file with the command.
Value The file will be processed the next time the disk is booted.
The file will be not be processed when the disk is booted.
Default The timezone setting on the system is not changed.
Status Optional
Value A value listed in
Parameters Set for Each Network Interface
If no network interface is included in the FIRST-BOOT interactive interface will be displayed.
The minimum index is 0 and the maximum index is 1023. An index need not align with the expected instance number of the network interface.
For example, index 1 can be used to specify an interface which may, upon boot, appear as lan2.
The nth network interface is identified by either setting to the MAC (Media Access Control) address of the interface, or by setting to the
hardware path of the interface.
If both parameters are set for a given index, takes precedence over
A particular interface can be managed by DHCP, or a set of static parameters may be specified to configure the interface.
To configure the nth interface to be managed by DHCP, specify the MAC address or hardware path of the interface and enable DHCP, using the
following parameters:
or
To configure an interface with a set of static parameters, specify the MAC address or hardware path, and also set and for the interface.
To configure the nth interface with static parameters, use the following parameters:
or
In addition, the following parameters are optional for a statically-configured interface:
If both is set to 1 and static parameters are specified for a single interface, DHCP takes precedence over the static parameters.
The syntax of each parameter is described below.
Default 0
Status For a given network interface, either must be set to 1 or and must be specified.
Value The values are:
0 DHCP client functionality is not enabled for this interface.
1 DHCP client functionality is enabled for this interface.
Default None.
Status The must be specified for any interface for which is not supplied.
If both parameters are set for a given index, takes precedence over
Value A hardware path, specified by non-negative integers separated by forward slashes
Default None.
Status An IP address must be specified for any network interface for which is not set to 1.
Value An IP address in decimal-dot notation.
Default None.
Status This parameter is required for any interface for which is not supplied.
If both parameters are set for a given index, takes precedence over
Value The prefix "0x" followed by a value of the MAC address expressed as 12 hex digits (e.g., 0x0017A451E718). The alphabetic
characters A-C must be specified in upper case.
Default None.
Status is optional for a network interface.
Value The values are:
0 is a local or loopback interface.
1 is a remote interface.
Default None
Status is optional for a network interface.
Value The value can only be set to and can only be set for an interface for which DHCP is not enabled.
Default None.
Status The is optional for a network interface.
Value An IP address in decimal-dot notation.
If the loopback interface, 127.0.0.1, is specified, must be set to 0 for this interface.
Default None.
Status must be set for any interface for which is not set to 1.
Value Subnet mask in hexadecimal or decimal-dot notation.
EXAMPLES
To supply a file that will cause the FIRST-BOOT interactive interface to be displayed, enter the following single line in the file:
To supply a file that will cause a DHCP server to be contacted for configuring a system with hostname and a single network interface with
MAC address 0x0017A451E718:
To supply a file that will NOT use DHCP to configure a system with the single network interface with MAC address 0x0017A451E718, specify as
well as the required and optional static values for the network interface:
AUTHOR
was developed by Hewlett-Packard Development Company, L.P.
FILES
Log file.
SEE ALSO
auto_parms(1M), drd(1M), drd-rehost(1M), drd-unrehost(1M), set_parms(1M).
Itanium(R)-based System Only sysinfo(4)