HOSTCONFIG(8) Maintenance Commands and Procedures 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)