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 setting 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.
Printable version
