uname.2 (2011 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

uname(2) uname(2)

NAME

uname(), setuname() - get information about computer system; set node name (system name)

SYNOPSIS

#include <sys/utsname.h>

int uname(struct utsname *name);

int setuname(const char *name, size_t namelen);

DESCRIPTION

uname()

The uname() system call places information identifying the computer system in the

utsname structure

pointed to by name.

The

utsname structure, deﬁned in <sys/utsname.h>

, is set up as follows:

char sysname[];

char nodename[];

char release[];

char version[];

char machine[];

char idnumber[];

Each ﬁeld is a null-terminated string.

The

sysname ﬁeld contains the name of the operating system, HP-UX on standard HP-UX systems.

The

nodename ﬁeld contains the name by which the computer system is known in a communications

network.

The

release ﬁeld contains the release identiﬁer of the operating system, such as B.11.23

The

version ﬁeld contains additional information about the operating system. This value can change

in future releases. The ﬁrst character of the version ﬁeld identiﬁes the license level:

A Two-user system

B 16-user system

C 32-user system

D 64-user system

E 8-user system

U 128-user, 256-user, or unlimited-user system

The

machine ﬁeld contains the hardware and model identiﬁers of the computer system. On Itanium-

based systems, this ﬁeld always returns

ia64.

The

idnumber ﬁeld contains a unique identiﬁcation number within that class of hardware, possibly a

hardware or software serial number. This ﬁeld contains a null string if there is no identiﬁcation number.

On Itanium-based systems this number may not be unique. To get a unique id, use the

_CS_MACHINE_IDENT option of confstr.

setuname()

The

setuname() system call sets the node name (system name), as returned in the nodename ﬁeld of

the utsname structure, to name, which has a length of namelen characters. This is usually executed by

/sbin/init.d/hostname at system boot time. Names are limited to UTSLEN - 1 characters;

UTSLEN is deﬁned in <sys/utsname.h>.

Security Restrictions

Prior to ContainmentExt B.11.31.03, the actions associated with this system call require the

PRIV_SYSATTR privilege (SYSATTR). If ContainmentExt B.11.31.03 or a later version of HP-UX Con-

tainment product is installed on the system, either the PRIV_SYSATTR privilege (SYSATTR) or the

PRIV_HOSTATTR privilege (HOSTATTR) is required. Processes owned by the superuser have this

privilege. Processes owned by other users may have this privilege, depending on system conﬁguration.

See privileges (5) for more information about privileged access on systems that support ﬁne-grained

privileges.

HP-UX 11i Version 3: September 2011 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)

PAGE 1
uname(2) uname(2) NAME uname(), setuname() - get information about computer system; set node name (system name) SYNOPSIS #include int uname(struct utsname *name); int setuname(const char *name, size_t namelen); DESCRIPTION uname() The uname() system call places information identifying the computer system in the utsname structure pointed to by name. The utsname structure, defined in
PAGE 2
uname(2) uname(2) RETURN VALUE uname() and setuname() return the following values: n Successful completion. n is a nonnegative value. Failure. errno is set to indicate the error. -1 The uname() function may return truncated results when the non-expanded version of the utsname structure is used. See WARNINGS. ERRORS If uname() or setuname() fails, errno is set to one of the following values. [EFAULT] name points to an illegal address. The reliable detection of this error is implementation dependent.