'\" te
.\" Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
.TH hostconfig 1M "6 Nov 2000" "SunOS 5.11" "System Administration Commands"
.SH NAME
hostconfig \- configure a system's host parameters
.SH SYNOPSIS
.LP
.nf
\fB/usr/sbin/hostconfig\fR \fB-p\fR \fIprotocol\fR [\fB-d\fR] [ \fB-h\fR] [\fB-n\fR] [\fB-v\fR]
[\fB-i\fR \fIinterface\fR] [\fB-f\fR \fIhostname\fR]
.fi
.SH DESCRIPTION
.sp
.LP
The \fBhostconfig\fR program uses a network protocol to acquire a machine's \fBhost parameters\fR and set these parameters on the system.
.sp
.LP
The program selects which protocol to use based on the argument to the required \fB-p\fR flag. Different protocols may set different host parameters. Currently, only one protocol (\fBbootparams\fR) is defined.
.SH OPTIONS
.sp
.LP
The following options are supported:
.sp
.ne 2
.mk
.na
\fB\fB-d\fR\fR
.ad
.RS 16n
.rt
Enable \fBdebug\fR output.
.RE
.sp
.ne 2
.mk
.na
\fB\fB-f\fR\fI hostname\fR\fR
.ad
.RS 16n
.rt
Run the protocol as if this machine were named \fBhostname\fR.
.RE
.sp
.ne 2
.mk
.na
\fB\fB-h\fR\fR
.ad
.RS 16n
.rt
Echo the received \fBhostname\fR to \fBstdout\fR, rather than setting \fBhostname\fR using the system name directly.
.RE
.sp
.ne 2
.mk
.na
\fB\fB-i\fR\fI interface\fR\fR
.ad
.RS 16n
.rt
Use only the named network interface to run the protocol.
.RE
.sp
.ne 2
.mk
.na
\fB\fB-n\fR\fR
.ad
.RS 16n
.rt
Run the network protocol, but do not set the acquired parameters into the system.
.RE
.sp
.ne 2
.mk
.na
\fB\fB-p\fR \fIprotocol\fR\fR
.ad
.RS 16n
.rt
Run \fBhostconfig\fR using \fIprotocol\fR. Currently, only one protocol (\fBbootparams\fR) is available. This option is required.
.sp
Specifying the \fB-p\fR \fBbootparams\fR option uses the \fBwhoami\fR call of the RPC \fBbootparams\fR protocol. This sets the system's \fBhostname\fR, \fBdomainname\fR, and default IP router parameters.
.RE
.sp
.ne 2
.mk
.na
\fB\fB-v\fR\fR
.ad
.RS 16n
.rt
Enable verbose output.
.RE
.SH EXAMPLES
.LP
\fBExample 1 \fRConfiguring Host Parameters with Verbose Output
.sp
.LP
The following command configures a machine's host parameters using the \fBwhoami\fR call of the RPC \fBbootparams\fR protocol with a verbose output.
.sp
.in +2
.nf
example# hostconfig \fB-p\fR bootparams \fB-v\fR
.fi
.in -2
.sp
.LP
\fBExample 2 \fRDisplaying Host Parameters
.sp
.LP
The following command displays the parameters that would be set using the \fBwhoami\fR call of the RPC \fBbootparams\fR protocol.
.sp
.in +2
.nf
example# hostconfig \fB-p\fR bootparams \fB-n\fR \fB-v\fR
.fi
.in -2
.sp
.LP
\fBExample 3 \fRConfiguring Host Parameters Less the System Name
.sp
.LP
The following command configures a machine's host parameters, less the system name, using the \fBwhoami\fR call of the RPC \fBbootparams\fR protocol.
.sp
.in +2
.nf
example# hostconfig='hostconfig \fB-p\fR bootparams \fB-h\fR'
.fi
.in -2
.sp
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i)
lw(2.75i) |lw(2.75i)
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Availabilitysystem/core-os
.TE
.SH SEE ALSO
.sp
.LP
\fBhostname\fR(1), \fBdomainname\fR(1M), \fBroute\fR(1M), \fBattributes\fR(5)