share/man/man1/hostname.1

   1 .\" Copyright (c) 1992, Sun Microsystems, Inc.
   2 .\" Copyright 2016 Joyent, Inc.
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .Dd Aug 26, 2016
   7 .Dt HOSTNAME 1
   8 .Os
   9 .Sh NAME
  10 .Nm hostname
  11 .Nd set or print name of current host system
  12 .Sh SYNOPSIS
  13 .Nm
  14 .Op Fl s
  15 .Op Ar name-of-host
  16 .Sh DESCRIPTION
  17 The
  18 .Nm
  19 command prints the name of the current host, as given before the
  20 .Xr login 1
  21 prompt. The super-user can set the hostname by giving
  22 .Ar name-of-host .
  23 .Pp
  24 While setting the hostname changes the hostname for the running system,
  25 it does not persist the change. The proper way to update the hostname
  26 will vary depending on how the system is configured. For most systems,
  27 the persistent hostname is stored in the file
  28 .Pa /etc/nodename .
  29 See
  30 .Xr nodename 4
  31 for more information on how to update it. Note, the
  32 .Pa /etc/nodename
  33 file may be ignored in cases where the system is configured to use DHCP.
  34 .Sh OPTIONS
  35 .Bl -tag -width Ds
  36 .It Fl s
  37 Prints only the part of the hostname preceding the first dot.
  38 .El
  39 .Sh SEE ALSO
  40 .Xr uname 1 ,
  41 .Xr nodename 4 ,
  42 .Xr attributes 5