HP-UX Reference (11i v3 07/02) - 1M System Administration Commands N-Z (vol 4)

s
setuname(1M) setuname(1M)
NAME
setuname - change machine information
SYNOPSIS
setuname [-s name][-n node][
-t]
DESCRIPTION
The
setuname command is used to modify the value for system name and/or the node name by using the
appropriate option(s).
The setuname command attempts to change the parameter values in both the running kernel and the
system configuration to cross reboots. A temporary change affects only the running kernel.
Options
The setuname command supports the following options:
-s name Changes the system name (for example, HP-UX) in the
sysname field of the
utsname structure where name is the new system name and consists of
alphanumeric characters and the special characters dash, underbar, and dollar sign.
-n node Changes the name in the nodename field of the utsname structure where node
specifies the new node name and consists of alphanumeric characters and the special
characters dash, underbar, and dollar sign.
-t Signifies a temporary change. The change will not survive a reboot.
Either or both of the -s or -n options must be given when invoking setuname.
The size of the name and node is limited to
UTSLEN−1 characters. UTSLEN is defined in
<sys/utsname.h>. Only users having appropriate privileges can use this command.
EXAMPLES
To permanently change the system name to
HP-UX and the node name to the-node, issue the following
command:
setuname -s HP-UX -n the-node
To temporarily change the system name to SYSTEM and the node name to new-node, issue the following
command:
setuname -s SYSTEM -n new-node -t
WARNINGS
Setting a nodename of more than 8 bytes is possible only with the appropriate configuration options
enabled. It is strongly recommended that all related documentation be completely understood before set-
ting a larger node name. A node name larger than 8 bytes can cause anomalous or incorrect behavior in
applications which use the uname command or the uname() system function to access the name.
SEE ALSO
uname(1), uname(2), nodehostnamesize(5).
374 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007