HOSTCONFIG(1M) Maintenance Commands HOSTCONFIG(1M)

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.

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'

hostname(1), domainname(1M), route(1M), attributes(5)

November 6, 2000 OmniOS