sysinfo(4)sysinfo(4)NAMEsysinfo - file for setting system information parameters, used with drd
rehost
SYNOPSISDESCRIPTION
When present, the file is used during the boot of an Itanium-based sys‐
tem 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 (Extensi‐
ble 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 sys‐
tem is not changed.
Status Optional
Value The name of the Domain Name System domain.
Default The Domain Name System setting on the sys‐
tem 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 com‐
ponent 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 parame‐
ters 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
Infor‐
mation
Service
server
on the
system
is not
changed.
Status Optional
Value The
Network
Infor‐
mation
Service
server,
speci‐
fied as
an IP
address
in dec‐
imal-
dot
nota‐
tion
(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
pro‐
cessed.
If
a
SYS‐
INFO.TXT
file
has
been
copied
to
the
file
sys‐
tem
with
remove
all
lines
con‐
tain‐
ing
SYS‐
INFO_PRO‐
CESSED
before
using
the
file
with
the
com‐
mand.
Value The
file
will
be
pro‐
cessed
the
next
time
the
disk
is
booted.
The
file
will
be
not
be
pro‐
cessed
when
the
disk
is
booted.
Default The
time‐
zone
set‐
ting
on
the
sys‐
tem
is
not
changed.
Sta‐
tus
Optional
Value A
value
listed
in
Parameters
Set for
Each
Network
Inter‐
face
If no
network
inter‐
face is
included
in the
FIRST-
BOOT
interac‐
tive
inter‐
face
will be
dis‐
played.
The min‐
imum
index is
0 and
the max‐
imum
index is
1023.
An index
need not
align
with the
expected
instance
number
of the
network
inter‐
face.
For
example,
index 1
can be
used to
specify
an
inter‐
face
which
may,
upon
boot,
appear
as lan2.
The nth
network
inter‐
face is
identi‐
fied by
either
setting
to the
MAC
(Media
Access
Control)
address
of the
inter‐
face, or
by set‐
ting to
the
hardware
path of
the
inter‐
face.
If both
parame‐
ters are
set for
a given
index,
takes
prece‐
dence
over
A par‐
ticular
inter‐
face can
be man‐
aged by
DHCP, or
a set of
static
parame‐
ters may
be spec‐
ified to
config‐
ure the
inter‐
face.
To con‐
figure
the nth
inter‐
face to
be man‐
aged by
DHCP,
specify
the MAC
address
or hard‐
ware
path of
the
inter‐
face and
enable
DHCP,
using
the fol‐
lowing
parame‐
ters:
or
To con‐
figure
an
inter‐
face
with a
set of
static
parame‐
ters,
specify
the MAC
address
or hard‐
ware
path,
and also
set and
for the
inter‐
face.
To con‐
figure
the nth
inter‐
face
with
static
parame‐
ters,
use the
follow‐
ing
parame‐
ters:
or
In addi‐
tion,
the fol‐
lowing
parame‐
ters are
optional
for a
stati‐
cally-
config‐
ured
inter‐
face:
If both
is set
to 1 and
static
parame‐
ters are
speci‐
fied for
a single
inter‐
face,
DHCP
takes
prece‐
dence
over the
static
parame‐
ters.
The syn‐
tax of
each
parame‐
ter is
described
below.
Default 0
Sta‐
tus For
a
given
net‐
work
inter‐
face,
either
must
be
set
to
1
or
and
must
be
spec‐
i‐
fied.
Value The
val‐
ues
are:
0 DHCP
client
func‐
tion‐
al‐
ity
is
not
enabled
for
this
inter‐
face.
1 DHCP
client
func‐
tion‐
al‐
ity
is
enabled
for
this
inter‐
face.
Default None.
Sta‐
tus The
must
be
spec‐
i‐
fied
for
any
inter‐
face
for
which
is
not
sup‐
plied.
If
both
param‐
e‐
ters
are
set
for
a
given
index,
takes
prece‐
dence
over
Value A
hard‐
ware
path,
spec‐
i‐
fied
by
non-
neg‐
a‐
tive
inte‐
gers
sep‐
a‐
rated
by
for‐
ward
slashes
Default None.
Sta‐
tus An
IP
address
must
be
spec‐
i‐
fied
for
any
net‐
work
inter‐
face
for
which
is
not
set
to
1.
Value An
IP
address
in
dec‐
i‐
mal-
dot
nota‐
tion.
Default None.
Sta‐
tus This
param‐
e‐
ter
is
required
for
any
inter‐
face
for
which
is
not
sup‐
plied.
If
both
param‐
e‐
ters
are
set
for
a
given
index,
takes
prece‐
dence
over
Value The
pre‐
fix
"0x"
fol‐
lowed
by
a
value
of
the
MAC
address
expressed
as
12
hex
dig‐
its
(e.g.,
0x0017A451E718).
The
alpha‐
betic
char‐
ac‐
ters
A-
C
must
be
spec‐
i‐
fied
in
upper
case.
Default None.
Sta‐
tus is
optional
for
a
net‐
work
inter‐
face.
Value The
val‐
ues
are:
0 is
a
local
or
loop‐
back
inter‐
face.
1 is
a
remote
inter‐
face.
Default None
Sta‐
tus is
optional
for
a
net‐
work
inter‐
face.
Value The
value
can
only
be
set
to
and
can
only
be
set
for
an
inter‐
face
for
which
DHCP
is
not
enabled.
Default None.
Sta‐
tus The
is
optional
for
a
net‐
work
inter‐
face.
Value An
IP
address
in
dec‐
i‐
mal-
dot
nota‐
tion.
If
the
loop‐
back
inter‐
face,
127.0.0.1,
is
spec‐
i‐
fied,
must
be
set
to
0
for
this
inter‐
face.
Default None.
Sta‐
tus must
be
set
for
any
inter‐
face
for
which
is
not
set
to
1.
Value Sub‐
net
mask
in
hexa‐
dec‐
i‐
mal
or
dec‐
i‐
mal-
dot
nota‐
tion.
EXAM‐
PLES
To
sup‐
ply
a
file
that
will
cause
the
FIRST-
BOOT
inter‐
ac‐
tive
inter‐
face
to
be
dis‐
played,
enter
the
fol‐
low‐
ing
sin‐
gle
line
in
the
file:
To
sup‐
ply
a
file
that
will
cause
a
DHCP
server
to
be
con‐
tacted
for
con‐
fig‐
ur‐
ing
a
sys‐
tem
with
host‐
name
and
a
sin‐
gle
net‐
work
inter‐
face
with
MAC
address
0x0017A451E718:
To
sup‐
ply
a
file
that
will
NOT
use
DHCP
to
con‐
fig‐
ure
a
sys‐
tem
with
the
sin‐
gle
net‐
work
inter‐
face
with
MAC
address
0x0017A451E718,
spec‐
ify
as
well
as
the
required
and
optional
static
val‐
ues
for
the
net‐
work
inter‐
face:
AUTHOR
was
devel‐
oped
by
Hewlett-
Packard
Devel‐
op‐
ment
Com‐
pany,
L.P.
FILES
Log
file.
SEE
ALSO
auto_parms(1M),
drd(1M),
drd-
rehost(1M),
drd-
unre‐
host(1M),
set_parms(1M).
Itanium(R)-based System Only sysinfo(4)