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)