getsysinfo(2) System Calls Manual getsysinfo(2)
Name
getsysinfo - get system information
Syntax
#include <sys/types.h>
#include <sys/sysinfo.h>
getsysinfo(op, buffer, nbytes, start, arg)
unsigned op;
char *buffer;
unsigned nbytes;
int *start;
char *arg;
Description
The system call retrieves information from the system.
The op argument specifies the operation to be performed. Values for op are defined in the <sys/sysinfo.h> header file.
Possible op values are as follows:
GSI_BOOTDEV
Return the BOOTDEV string, which is used for the installation.
GSI_NETBLK
Return the entire NETBLK structure, which is used for the network installation.
GSI_PROG_ENV
Return the compatibility mode of the process. Possible values are A_BSD, A_POSIX, A_SYSTEM_FIVE as defined in <sys/exec.h>.
GSI_MAX_UPROCS
Return the maximum number of processes allowed per user id.
GSI_TTYP
Return the major and minor numbers of the controlling terminal.
GSI_UACSYS (RISC only)
Return current value of flag that determines whether or not to print "unaligned access fixup" message on a system-wide basis.
GSI_UACPARNT (RISC only)
Return current value of flag in parent process's structure for printing unaligned access messages.
GSI_UACPROC (RISC only)
Return current value of flag in process's structure for printing of unaligned access messages.
GSI_MMAP_ALIGNMENT (RISC only)
Return the minimum alignment required for an address specified with the option in the system call.
The nbytes argument defines the size of buffer into which the system information is returned.
The start argument is the current logical location within the internal system table referenced by the op, and it must be initially set to
The start argument is updated to reflect the current logical location within the system table, allowing successive executions of to
retrieve information about all the system structures specified by op.
The start argument is set to 0 when all system information requested by op has been retrieved.
The optional arg argument may be used by certain op's for additional information. When arg is not required, it should be set to NULL.
When information about multiple system structures is returned, it is stored within consecutive buffer locations. The information for each
system structure is dependent upon op.
Return Values
Upon successful completion, a value indicating the number of requested items stored in buffer is returned. If the information requested by
op is not available, getsysinfo returns a zero. Otherwise, -1 is returned, and the global variable, is set to indicate the error.
Diagnostics
[EFAULT] Either buffer, start, or arg causes an illegal address to be referenced.
[EINVAL] The op argument is invalid.
[EPERM] Permission is denied for the operation requested
See Also
setsysinfo(2)
getsysinfo(2)
