sysinfo(2)							System Calls Manual							sysinfo(2)

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 exe-
	      cuted 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 sys-
	      info 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  implementa-
       tion.  Specifies that an invalid command was specified.	See the RESTRICTIONS section.  Specifies that the process does not have the appro-
       priate privileges for a SET command.

SEE ALSO

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

																	sysinfo(2)