summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobert Mustacchi <rm@joyent.com>2016-08-26 22:22:41 +0000
committerRobert Mustacchi <rm@joyent.com>2016-08-30 00:05:55 +0000
commit201e46a67cf405090460eeeb55f709c75ee7cffd (patch)
treea4ed4165f2aaed4dcb03d67234e4349b264dd4a6
parent6ad556a7e5c9aef7d5908f5538e4d74ee0e063d5 (diff)
downloadillumos-joyent-201e46a67cf405090460eeeb55f709c75ee7cffd.tar.gz
OS-5635 hostname(1) manual page should talk about persistence
Reviewed by: Trent Mick <trent.mick@joyent.com> Reviewed by: Cody Mello <melloc@joyent.com> Approved by: Dave Pacheco <dap@joyent.com>
-rw-r--r--usr/src/man/man1/hostname.115
1 files changed, 14 insertions, 1 deletions
diff --git a/usr/src/man/man1/hostname.1 b/usr/src/man/man1/hostname.1
index 5b63dab64a..75a24a0437 100644
--- a/usr/src/man/man1/hostname.1
+++ b/usr/src/man/man1/hostname.1
@@ -1,8 +1,9 @@
.\" Copyright (c) 1992, Sun Microsystems, Inc.
+.\" Copyright 2016 Joyent, Inc.
.\" 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]
-.Dd May 12, 2016
+.Dd Aug 26, 2016
.Dt HOSTNAME 1
.Os
.Sh NAME
@@ -19,6 +20,17 @@ command prints the name of the current host, as given before the
.Xr login 1
prompt. The super-user can set the hostname by giving
.Ar name-of-host .
+.Pp
+While setting the hostname changes the hostname for the running system,
+it does not persist the change. The proper way to update the hostname
+will vary depending on how the system is configured. For most systems,
+the persistent hostname is stored in the file
+.Pa /etc/nodename .
+See
+.Xr nodename 4
+for more information on how to update it. Note, the
+.Pa /etc/nodename
+file may be ignored in cases where the system is configured to use DHCP.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl s
@@ -26,4 +38,5 @@ Prints only the part of the hostname preceding the first dot.
.El
.Sh SEE ALSO
.Xr uname 1 ,
+.Xr nodename 4 ,
.Xr attributes 5