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]
/usr/sbin/hostconfig -p protocol [-d] [ -h] [-n] [-v] [-i interface] [-f hostname]
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.
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.
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'
hostname(1), domainname(1M), route(1M), attributes(5)