hostconfig(1M)

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'

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Availability system/core-os

See also

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