man/man1m/hostconfig.1m

         te
 Copyright (c) 1999, Sun Microsystems, Inc. All Rights Reserved
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
 When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 HOSTCONFIG 1M "Nov 6, 2000"
 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), domainname(1M), route(1M), attributes(5)