ultrix getsysinfo.2

Go back to listing by section, keyword search or top of ultrix man page tree.

Man pages named getsysinfo in this section of the manual for other systems: OSF

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  instal-
        lation.

     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  struc-
        ture 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, allow-
     ing 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 infor-
     mation 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  ille-
                    gal address to be referenced.

     [EINVAL]       The op argument is invalid.

     [EPERM]        Permission  is  denied  for   the   operation
                    requested

See Also
     setsysinfo(2)