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 argu-
     ment  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  host-
           name.

     -h    Echo the received hostname to stdout, rather than set-
           ting hostname using the system name directly.

     -i interface
           Use only the named network interface to run the proto-
           col.

     -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  parame-
     ters,  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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO

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