setuname(1M) System Administration Commands setuname(1M)NAME
setuname - change machine information
SYNOPSIS
setuname [-t] [-n node] [-s name]
DESCRIPTION
The setuname utility changes the parameter value for the system name and node name. Each parameter can be changed using setuname and the
appropriate option.
Either or both the -s and -n options must be given when invoking setuname.
The system architecture may place requirements on the size of the system and network node name. The command will issue a fatal warning mes-
sage and an error message if the name entered is incompatible with the system requirements.
OPTIONS
The following options are supported:
-n node Changes the node name. node specifies the new network node name and can consist of alphanumeric characters and the special char-
acters dash, underbar, and dollar sign.
-s name Changes the system name. name specifies new system name and can consist of alphanumeric characters and the special characters
dash, underbar, and dollar sign.
-t Temporary change. No attempt will be made to create a permanent change.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWcsu |
+-----------------------------+-----------------------------+
SEE ALSO attributes(5)NOTES
setuname attempts to change the parameter values in two places: the running kernel and, as necessary per implementation, to cross system
reboots. A temporary change changes only the running kernel.
SunOS 5.11 9 Jul 2003 setuname(1M)
Check Out this Related Man Page
expanded_node_host_names(5) File Formats Manual expanded_node_host_names(5)NAME
expanded_node_host_names - enable maximum length expansion of the system node and host names
VALUES
Failsafe
Default
Allowed Values
DESCRIPTION
The tunable controls the length of the system node and host names. When this tunable value is 0, the system utilities used to set node and
host names allow compatible name lengths. That is, 8 and 64 bytes for node and host name, respectively. When this tunable value is 1, the
utilities allow expanded lengths up to 255 bytes.
Changing this tunable does not affect the current system node and host names.
Node and host names larger than 8 and 64 bytes, respectively, can cause anomalous or incorrect behavior in applications using these names.
See the WARNINGS section for more information.
Who Is Expected to Change This Tunable?
The system administrator may change this tunable when it is necessary to change the maximum allowed length of the system node and/or host
names.
Restrictions on Changing
This tunable is dynamic. Changing its value to 1 immediately allows the administrator to assign expanded (up to 255 bytes) node or host
names. Changing its value to 0 enforces the compatible maximum of 8 and 64 byte node and host names on any subsequent name setting but
does not affect the current name settings.
When Should the Value of This Tunable Be Raised?
This tunable may be raised to 1 when it is necessary to assign an expanded node and/or host name.
What are the Side Effects of Raising the Value?
Raising the tunable value to 1 causes the system utilities used to set node and host names to allow names up to 255 bytes.
When Should the Value of This Tunable Be Lowered?
This tunable should be lowered to 0 when it is determined that expanded node and host names are not necessary.
What are the Side Effects of Lowering the Value?
Lowering the tunable value to 0 causes the system utilities used to set node and host names to allow names up to 8 and 64 bytes, respec-
tively.
What Other Tunable Values Should Be Changed at the Same Time?
None.
APPLICATION USAGE
For more information on usage see the whitepaper
WARNINGS
Node and host names in excess of 8 and 64 bytes, respectively, can cause anomalous behavior or failure in applications using these names.
The administrator should read and understand the issues as described in the related documentation (see the whitepaper and nodehostname-
size(5)).
Warnings are always issued from the tunable handler when this tunable is changed.
When this tunable value is 0 (off), the system interfaces and commands which set node and host names quietly truncate inputs to 8 or 64
bytes, respectively. This behavior is consistent with previous versions. There is no error nor warning provided.
Installation of optional kernel software, from HP or other vendors, may cause changes to tunable parameter values. After installation,
some tunable parameters may no longer be at the default or recommended values. For information about the effects of installation on tun-
able values, consult the documentation for the kernel software being installed. For information about optional kernel software that was
factory installed on your system, see at
All HP-UX kernel tunable parameters are release specific. This parameter may be removed or have its meaning changed in future releases of
HP-UX.
AUTHOR
was developed by HP.
SEE ALSO hostname(1), uname(1), setuname(1M), gethostname(2), sethostname(2), uname(2), hostname(5), nodehostnamesize(5).
whitepaper, available on
Tunable Kernel Parameters expanded_node_host_names(5)