hostconfig(1M)						  System Administration Commands					    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 param-
       eters. 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		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

SunOS 5.10							    6 Nov 2000							    hostconfig(1M)