HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)

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 conﬁguration 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 (e.g., HP-UX) in the

sysname ﬁeld of the utsname struc-

ture 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 ﬁeld of the utsname structure where node

speciﬁes the new node name and consists of alphanumeric characters and the special

characters dash, underbar, and dollar sign.

-t Signiﬁes 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 deﬁned 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