Content-type: text/html Man page of sysinfo

sysinfo

Section: System Calls (2)
Index Return to Main Contents
 

NAME

sysinfo - manages system information strings  

SYNOPSIS

#include <sys/systeminfo.h>

long sysinfo( int command, char *buf, long count );
 

PARAMETERS

Specifies the commands that manage the system information strings. They are described in the Available Commands section. Specifies the buffer used for the storage of system information. Specifies the size of the buffer pointed to by the buf parameter.
 

DESCRIPTION

The sysinfo function retrieves and sets information relating to the operating system into a buffer pointed to by the buf parameter. This function is similar to the sysconf function which returns an integer instead of a string.
 

Available Commands

This section describes the commands that may be specified with the command parameter. The commands allow you to set certain attributes and they are listed in alphabetical order: Copies a string into the specified buffer that describes the instruction set of the current system's architecture. These names cannot conflict with predefined names in the C language compilation system. Copies a string into the specified buffer that represents the name of the present host machine. This is the same string that would be returned by the uname function in the nodename field. The name is typically the hostname or nodename that the machine is recognized by locally.

The hostname is the name of the target machine as it is used in a network. Although the hostname may differ on various networks, the nodename that is presented to the appropriate network directory or name-to-address mapping service should produce a transport end point address. The name may not be fully qualified.
Internet host names can be up to 256 bytes in length including the terminating null. Copies a string into the specified buffer that represents the name of the hardware manufacturer. This command is not supported in this implementation of the operating system. Copies a string into the specified buffer the ASCII representation of the hardware-specific serial number of the machine that executed the function call. This can be initiated in Read Only Memory through the software constants set when the machine is built. The string can contain non-numeric characters. This command is not supported in this implementation of the operating system. Copies a string into the specified buffer that represents the name of the machine. This is the same string that would be returned by the uname function in the machine field. Copies a string into the specified buffer that represents the name of the release. This is the same string that would be returned by the uname function in the release field. Copies the null-terminated contents of the specified buffer into the string that is maintained by the kernel. This value will be returned by successive calls to the sysinfo function when used with the SI_HOSTNAME command. Superuser privileges are required to perform this action. Specifies that the string returned by the sysinfo function using the SI_SRPC_DOMAIN command is to be set to the value of the array pointed to by the buf parameter. This command is not supported in this implementation of the operating system. The command SI_SET_SYSNAME sets the system name. Copies the Secure Remote Procedure Call command name into the specified buffer. This command is not supported in this implementation of the operating system. Copies a string into the specified buffer the value that would be returned by the uname function in the sysname field. This is the name of the implementation of the operating system.
 

RESTRICTIONS

Two commands, SI_SRPC_DOMAIN and SI_SET_SRPC_DOMAIN, are not currently supported. If either of these commands is specified, a value of -1 is returned and errno is set.
 

RETURN VALUES

On success, the return value specifies the size in bytes required for the buffer to hold the value and terminating character of the string. If this value does not exceed the value specified in the count parameter, the string is copied. If this value exceeds the value specified by the count parameter, the string that is copied to the specified buffer is truncated to the count-1 bytes and a terminating character.

If an error is encountered, a value of -1 is returned and errno is set to indicate the error.
 

ERRORS

Specifies that the buf parameter does not point to a valid address, or that the data for a SET command is not allowed in this implementation. Specifies that an invalid command was specified. See the RESTRICTIONS section. Specifies that the process does not have the appropriate privileges for a SET command.
 

SEE ALSO

Functions:  getrlimit(2), setrlimit(2), sysconf(3), uname(2)


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
Available Commands
RESTRICTIONS
RETURN VALUES
ERRORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:40:14 GMT, October 02, 2010