ultrix man page for getsysinfo

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)