System Information API

name: System Information API
description: System calls for retrieving system information and configuration.
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
humanURL: https://man7.org/linux/man-pages/man2/uname.2.html
baseURL: system://unix/sysinfo
tags:
- Configuration
- Groups
- Information
- System
- Users
properties:
- type: Documentation
  url: https://pubs.opengroup.org/onlinepubs/9699919799/functions/uname.html
- type: APIReference
  url: https://man7.org/linux/man-pages/man2/uname.2.html
operations:
- name: uname
  description: Get system information
  parameters:
  - buf
  returns: 0 on success, -1 on error
- name: getuid
  description: Get user identity
  parameters: []
  returns: user ID
- name: getgid
  description: Get group identity
  parameters: []
  returns: group ID
- name: geteuid
  description: Get effective user ID
  parameters: []
  returns: effective user ID
- name: getegid
  description: Get effective group ID
  parameters: []
  returns: effective group ID
- name: setuid
  description: Set user identity
  parameters:
  - uid
  returns: 0 on success, -1 on error
- name: setgid
  description: Set group identity
  parameters:
  - gid
  returns: 0 on success, -1 on error
- name: seteuid
  description: Set effective user ID
  parameters:
  - euid
  returns: 0 on success, -1 on error
- name: setegid
  description: Set effective group ID
  parameters:
  - egid
  returns: 0 on success, -1 on error
- name: getgroups
  description: Get supplementary group IDs
  parameters:
  - size
  - list
  returns: number of supplementary group IDs
- name: getlogin
  description: Get login name
  parameters: []
  returns: pointer to login name string
- name: time
  description: Get time in seconds since Epoch
  parameters:
  - tloc
  returns: time value
- name: gettimeofday
  description: Get time with microsecond precision
  parameters:
  - tv
  - tz
  returns: 0 on success, -1 on error
- name: clock_gettime
  description: Get time from a specified clock with nanosecond precision
  parameters:
  - clockid
  - tp
  returns: 0 on success, -1 on error
- name: clock_settime
  description: Set time for a specified clock
  parameters:
  - clockid
  - tp
  returns: 0 on success, -1 on error
- name: sysconf
  description: Get configurable system variables at runtime
  parameters:
  - name
  returns: value of system variable, -1 on error
- name: pathconf
  description: Get configurable pathname variables
  parameters:
  - path
  - name
  returns: value of variable, -1 on error
- name: getenv
  description: Get value of an environment variable
  parameters:
  - name
  returns: pointer to value string, NULL if not found
- name: setenv
  description: Set or change an environment variable
  parameters:
  - name
  - value
  - overwrite
  returns: 0 on success, -1 on error
- name: gethostname
  description: Get the hostname of the system
  parameters:
  - name
  - len
  returns: 0 on success, -1 on error