Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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'

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/core-os

See Also

hostname(1), attributes(7), domainname(8), route(8)