nodehostnamesize(5) File Formats Manual nodehostnamesize(5)NAME
nodehostnamesize - size of node name and host name
DESCRIPTION
The HP-UX operating system default configuration allows the system node name and host name to be up to 8 and 64 bytes in length, respec-
tively. The node name supports the UUCP utilities. The host name supports the internet Domain Name Services (DNS) host name label.
Setting a node name of more than 8 bytes or a host name of more than 64 bytes is possible only with the appropriate configuration options
enabled.
APPLICATION USAGE
See the whitepaper for more information.
WARNINGS
It is strongly recommended that all related documentation be completely understood before setting a larger node or host name. A node name
larger than 8 bytes, or host name larger than 64 bytes, can cause anomalous behavior or failure in applications which use the and/or com-
mands or the and/or system functions to obtain the names.
SEE ALSO hostname(1), uname(1), uucp(1), setuname(1M), gethostname(2), sethostname(2), uname(2), hostname(5).
whitepaper, available on
nodehostnamesize(5)
Check Out this Related Man Page
uname(2) System Calls Manual uname(2)NAME
uname(), setuname() - get information about computer system; set node name (system name)
SYNOPSIS DESCRIPTION
uname()
The system call places information identifying the computer system in the structure pointed to by name.
The structure, defined in is set up as follows:
Each field is a null-terminated string.
The field contains the name of the operating system, on standard HP-UX systems.
The field contains the name by which the computer system is known in a communications network.
The field contains the release identifier of the operating system, such as
The field contains additional information about the operating system. This value can change in future releases. The first character of
the field identifies the license level:
Two-user system
16-user system
32-user system
64-user system
8-user system
128-user, 256-user, or unlimited-user system
The field contains the hardware and model identifiers of the computer system. On this field always returns
The field contains a unique identification number within that class of hardware, possibly a hardware or software serial number. This field
contains a null string if there is no identification number. On systems this number may not be unique. To get a unique id, use the option
of
setuname()
The system call sets the node name (system name), as returned in the field of the structure, to name, which has a length of namelen charac-
ters. This is usually executed by at system boot time. Names are limited to 1 characters; is defined in
Security Restrictions
The actions associated with this system call require the privilege Processes owned by the superuser have this privilege. Processes owned
by other users may have this privilege, depending on system configuration.
See privileges(5) for more information about privileged access on systems that support fine-grained privileges.
RETURN VALUE
and return the following values:
Successful completion.
n is a nonnegative value.
Failure.
is set to indicate the error.
The function may return truncated results when the non-expanded version of the structure is used. See
ERRORS
If or fails, is set to one of the following values.
name points to an illegal address. The reliable detection of this error is implementation dependent.
was attempted by a process lacking
appropriate privileges.
This error may be detected and indicates that the
structure version used does not accommodate the full values of one or more fields.
WARNINGS
returns one of two versions of the structure:
o HP-UX compatible version (compatible with all HP-UX versions)
o Expanded version of the structure which can accommodate larger values.
The compatible structure is used by default. To use the expanded structure, see nodehostnamesize(5).
If the administrator has configured a node name with a length larger than 8 bytes, the compatible version of the structure, as returned by
contains just the first 8 bytes (plus null) in the field. In a future release the field will not contain any data bytes if the entire node
name cannot fit.
Setting a node name of more than 8 bytes with is only possible with the appropriate configuration options enabled. It is strongly recom-
mended that all related documentation be completely understood before setting a larger node name. A node name larger than 8 bytes can
cause anomalous behavior or failure in applications which use the command or the system function to access the name.
It is recommended that, whenever possible, programs use the host name as returned by the function rather than the field. It can be given a
sufficiently large buffer to avoid truncation issues. See gethostname(2) for more information.
AUTHOR
was developed by AT&T and HP.
SEE ALSO hostname(1), uname(1), setuname(1M), gethostname(2), sethostname(2), nodehostnamesize(5), privileges(5).
STANDARDS CONFORMANCE uname(2)