HOSTCONFIG(8) Maintenance Commands and Procedures HOSTCONFIG(8)
hostconfig - configure a system's host parameters
/usr/sbin/hostconfig -p protocol [-d] [ -h] [-n] [-v]
[-i interface] [-f hostname]
The hostconfig program uses a network protocol to acquire a
machine's host parameters and set these parameters on the system.
The program selects which protocol to use based on the argument to
the required -p flag. Different protocols may set different host
parameters. Currently, only one protocol (bootparams) is defined.
The following options are supported:
-d
Enable debug output.
-f hostname
Run the protocol as if this machine were named
hostname.
-h
Echo the received hostname to stdout, rather than
setting hostname using the system name directly.
-i interface
Use only the named network interface to run the
protocol.
-n
Run the network protocol, but do not set the acquired
parameters into the system.
-p protocol
Run hostconfig using protocol. Currently, only one
protocol (bootparams) is available. This option is
required.
Specifying the -p bootparams option uses the whoami
call of the RPC bootparams protocol. This sets the
system's hostname, domainname, and default IP router
parameters.
-v
Enable verbose output.
The following command configures a machine's host parameters using
the whoami call of the RPC bootparams protocol with a verbose output.
example# hostconfig -p bootparams -v
The following command displays the parameters that would be set using
the whoami call of the RPC bootparams protocol.
example# hostconfig -p bootparams -n -v
The following command configures a machine's host parameters, less
the system name, using the whoami call of the RPC bootparams
protocol.
example# hostconfig='hostconfig -p bootparams -h'
hostname(1), attributes(7), domainname(8), route(8)
November 6, 2000 HOSTCONFIG(8)
NAME
hostconfig - configure a system's host parameters
SYNOPSIS
/usr/sbin/hostconfig -p protocol [-d] [ -h] [-n] [-v]
[-i interface] [-f hostname]
DESCRIPTION
The hostconfig program uses a network protocol to acquire a
machine's host parameters and set these parameters on the system.
The program selects which protocol to use based on the argument to
the required -p flag. Different protocols may set different host
parameters. Currently, only one protocol (bootparams) is defined.
OPTIONS
The following options are supported:
-d
Enable debug output.
-f hostname
Run the protocol as if this machine were named
hostname.
-h
Echo the received hostname to stdout, rather than
setting hostname using the system name directly.
-i interface
Use only the named network interface to run the
protocol.
-n
Run the network protocol, but do not set the acquired
parameters into the system.
-p protocol
Run hostconfig using protocol. Currently, only one
protocol (bootparams) is available. This option is
required.
Specifying the -p bootparams option uses the whoami
call of the RPC bootparams protocol. This sets the
system's hostname, domainname, and default IP router
parameters.
-v
Enable verbose output.
EXAMPLES
Example 1: Configuring Host Parameters with Verbose Output
The following command configures a machine's host parameters using
the whoami call of the RPC bootparams protocol with a verbose output.
example# hostconfig -p bootparams -v
Example 2: Displaying Host Parameters
The following command displays the parameters that would be set using
the whoami call of the RPC bootparams protocol.
example# hostconfig -p bootparams -n -v
Example 3: Configuring Host Parameters Less the System Name
The following command configures a machine's host parameters, less
the system name, using the whoami call of the RPC bootparams
protocol.
example# hostconfig='hostconfig -p bootparams -h'
SEE ALSO
hostname(1), attributes(7), domainname(8), route(8)
November 6, 2000 HOSTCONFIG(8)