uname()
Get information about the operating system
Synopsis:
#include <sys/utsname.h> int uname( struct utsname * name );
Since:
BlackBerry 10.0.0
Arguments:
- name
- A pointer to a utsname where the function can store the information; see below.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The uname() function stores information about the current operating system in the structure pointed to by the argument name.
The system name structure, utsname, is defined in <sys/utsname.h>, and contains at least the following structure members:
- char* sysname
- The name of the OS.
- char* nodename
- The name of this node.
- char* release
- The current release level.
- char* version
- The current version level.
- char* machine
- The hardware type.
Each of these items is a null-terminated character array.
Returns:
- 0
- Success.
- -1
- An error occurred ( errno is set).
Examples:
/*
* The following program prints some information about the
* system it's running on.
*/
#include <stdio.h>
#include <stdlib.h>
#include <sys/types.h>
#include <sys/utsname.h>
int main( void )
{
struct utsname sysinfo;
if( uname( &sysinfo ) == -1 ) {
perror( "uname" );
return EXIT_FAILURE;
}
printf( "system name : %s\n", sysinfo.sysname );
printf( "node name : %s\n", sysinfo.nodename );
printf( "release name : %s\n", sysinfo.release );
printf( "version name : %s\n", sysinfo.version );
return EXIT_SUCCESS;
}
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | No |
| Signal handler | Yes |
| Thread | Yes |
Last modified: 2014-06-24