usr/src/man/man1m/setuname.1m

   1 '\" te
   2 .\"  Copyright 1989 AT&T Copyright (c) 1998 Sun Microsystems, Inc. All Rights Reserved.
   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 .TH SETUNAME 1M "Jul 9, 2003"
   7 .SH NAME
   8 setuname \- change machine information
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBsetuname\fR [\fB-t\fR] [\fB-n\fR \fInode\fR] [\fB-s\fR \fIname\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBsetuname\fR utility changes the parameter value for the system name and
  19 node name. Each parameter can be changed using \fBsetuname\fR and the
  20 appropriate option.
  21 .sp
  22 .LP
  23 Either or both the \fB-s\fR and \fB-n\fR options must be given when invoking
  24 \fBsetuname\fR.
  25 .sp
  26 .LP
  27 The system architecture may place requirements on the size of the system and
  28 network node name. The command will issue a fatal warning message and an error
  29 message if the name entered is incompatible with the system requirements.
  30 .SH OPTIONS
  31 .sp
  32 .LP
  33 The following options are supported:
  34 .sp
  35 .ne 2
  36 .na
  37 \fB\fB-n\fR\fI node\fR\fR
  38 .ad
  39 .RS 11n
  40 Changes the node name. \fInode\fR specifies the new network node name and can
  41 consist of alphanumeric characters and the special characters dash, underbar,
  42 and dollar sign.
  43 .RE
  44
  45 .sp
  46 .ne 2
  47 .na
  48 \fB\fB-s\fR\fI name\fR\fR
  49 .ad
  50 .RS 11n
  51 Changes the system name. \fIname\fR specifies new system name and can consist
  52 of alphanumeric characters and the special characters dash, underbar, and
  53 dollar sign.
  54 .RE
  55
  56 .sp
  57 .ne 2
  58 .na
  59 \fB\fB-t\fR\fR
  60 .ad
  61 .RS 11n
  62 Temporary change. No attempt will be made to create a permanent change.
  63 .RE
  64
  65 .SH SEE ALSO
  66 .sp
  67 .LP
  68 \fBattributes\fR(5)
  69 .SH NOTES
  70 .sp
  71 .LP
  72 \fBsetuname\fR attempts to change the parameter values in two places: the
  73 running kernel and, as necessary per implementation, to cross system reboots. A
  74 temporary change changes only the running kernel.