HP 3000 Manuals HP 3000 Manuals
uname
Returns current system ID's.
Syntax
#include <sys/utsname.h>
init uname(struct utsname *name);
Parameters
name A pointer to a string of characters that will
return system identification.
Return Values
>=0 Successful completion.
-1 Error and errno is set to indicate the error.
Description
The uname() function stores information identifying the current operating
system in the utsname structure pointed to by the argument name.
The structure utsname is defined in the header <sys/utsname.h> and
contains at least the members shown below:
sysname Name of this implementation of the operating system.
nodename Name of this node within an implementation-specified
communications network.
release Current operation system release ID.
version Current operation system version ID.
machine Name of the hardware type on which the system is running.
Each of these data items is a null-terminated array of char.
The inclusion of the nodename member in this structure does not imply
that it is sufficient information for interfacing to communications
networks.
A sample output of this parameter displays as follow:
sysname = MPE/iX
nodename = STARS.ITG.HP
release = A.41.00
version = A.51.07
machine = SERIES 955
Implementation Considerations
The node name is retrieved from NMCONFIG.PUB.SYS and is not necessarily
sufficient information for interfacing to communications networks. The
release ID is the manufacture release ID, known as the release vuf on
MPE/iX. The version ID stands for the version of the MPE/iX OS product.
Since the POSIX standard does not specify any error conditions that are
required to be detected for the uname() function, all the error
conditions are implementation defined. Successful completion will have a
function return of zero.
Errors
If an error occurs, errno is set to one of the following values:
EFAULT CAUSE A null or bad address was detected in attempting to
use the structure pointed to by the name argument.
ACTION Check to see if the pointer is initialized and/or the
structure is defined correctly.
ESYSERR CAUSE An internal operating system error has occurred; an
error not directly applicable to the POSIX.1
functionality.
ACTION Contact Hewlett-Packard for support.
See Also
exec(), getuid(), POSIX.1 (Section 3.3.2).