SYSCONF

Section: Misc. Reference Manual Pages (2P)
Updated: August 1, 1992
Index Return to Main Contents
 

NAME

sysconf - (POSIX only) get configurable system variables  

SYNOPSIS

#include <unistd.h>

long sysconf(int name);
 

DESCRIPTION

The information in this specification applies only to POSIX applications.

The sysconf function provides a method for an application to determined the current value of a configurable system limit or option.

The name argument represents the system variable to be queried. The following variables are supported:

Variable
name Value                     
{ARG_MAX}
{_SC_ARG_MAX}          
{CHILD_MAX}
{_SC_CHILD_MAX}                
{clock ticks/second}
{_SC_CLK_TCK}  
{NGROUPS_MAX}
{_SC_NGROUPS_MAX}              
{OPEN_MAX}
{_SC_OPEN_MAX}
{STREAM_BUF}
{_SC_STREAM_BUF}
{TZNAME_MAX}
{_SC_TZNAME_MAX}
{_POSIX_JOB_CONTROL}
{_SC_JOB_CONTROL}
{_POSIX_SAVED_IDS}
{_SC_SAVED_IDS}
{_POSIX_VERSION}
{_SC_VERSION}

The meaning of each variable is as follows:

Variable
Description
{ARG_MAX}
Maximum length of all arguments + environment strings to exec().
{CHILD_MAX}
Maximum number of simultaneous processes per real user ID.
{clock ticks/second}
The number of clock ticks per second.
{NGROUPS_MAX}
Maximum number of simultaneous supplementary group IDs per process.
{OPEN_MAX}
Maximum number of simultaneous open files per process.
{STREAM_BUF}
The number of streams that one process can have open at one time.
{TZNAME_MAX}
The maximum number of bytes supported for the name of a time zone.
{_POSIX_JOB_CONTROL}
If defined, the system supports POSIX job control.
{_POSIX_SAVED_IDS}
If defined, saved set-user-IDs and set-group-IDS are supported.
{_POSIX_VERSION}
The version of POSIX supported by the system.

The values for the variables above are given in the headers <limits.h> or <unistd.h>. The symbolic constants used as values for name are given in <unistd.h>.  

RETURN VALUE

Upon successful completion sysconf returns the current variable value on the system. If name is an invalid value, sysconf returns -1. If the variable corresponding to name is associated with functionality that is not supported by the system, sysconf shall return -1 without changing the value of errno.  

ERRORS

If any of the following conditions occur, sysconf returns -1 and set errno to the corresponding value:
[EINVAL]
The value of name is invalid.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS

This document was created by man2html, using the manual pages.
Time: 17:22:41 GMT, March 25, 2025