setuname.1m (2010 09)

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 (for example, HP-UX) in the

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

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

cial 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

WARNINGS

Setting a nodename of more than 8 bytes is possible only with the appropriate conﬁguration 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.

PAGE 1
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.
PAGE 2
(Notes) A (Notes) sA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010