Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sysconf(2) [hpux man page]

sysconf(2)							System Calls Manual							sysconf(2)

NAME
sysconf(), CPU_IS_PA_RISC() - get configurable system variables SYNOPSIS
DESCRIPTION
The system call provides a way for applications to determine the current value of a configurable limit or variable. The name argument represents the system variable being queried. The following table lists the configuration variable name, the associated value for the name argument that is used in the call and the value returned. is described in the entry for Some of the variables in the table are defined as constants in (see limits(5)). The associated values of the name argument are defined in ______________________________________________________________________ Configuration Variable (Value for name Argument) Value Returned by sysconf() ______________________________________________________________________ Version number of OSF/AES OSC supported. Maximum number of aio operations that can be specified in a call (see lio_listio(2)). Maximum number of aio operations that can be queued at any time (see aio(5)). Maximum slowdown factor that can be specified in the field of a structure (see aio(5)). Maximum total length of the arguments for in bytes, including environment data (see exec(2)). Maximum number of functions that can be registered with (see atexit(3)). Maximum ibase (input number radix) and obase (output number radix) allowed by (see bc(1)). Maximum number of elements in an array permitted by (see bc(1)). Maximum scale factor (number of digits to the right of the decimal point) allowed by (see bc(1)). Maximum length of strings allowed by (see bc(1)). Positive if the implementation supports multiple locality domains; otherwise (see mpctl(2)). Maximum number of simultaneous processes per user ID (see fork(2)). Number of clock intervals per second for (see times(2)). Number of clock ticks per second for (see clock(3C)). Maximum number of weights that can be assigned to an entry of the order keyword in a input file (see localedef(1M)). systems: CPUID Register 3 of the Itanium-based processor identification registers. See the Itanium-based architecture definition for this platform for the meaning of each bit. Itanium-based systems: CPUID Register 4 of the Itanium-based processor identification registers. See the Itanium-based architecture definition for this platform for the meaning of each bit. PA-RISC: Processor Extensions. The availability of architecture specific instructions is indicated by the key bit data returned by Upon successful completion, the data returned will be the logical OR of the defined values for the features supported. The possible values returned by and their meanings for PA-RISC platforms are shown in the following table. Return Value Instruction Supported Halfword parallel add, subtract, and average Halfword parallel shift-and-add Version of CPU architecture. The possible values of the variable returned by and their meanings are: Value Meaning HP Precision Architecture RISC Version 1.0 HP Precision Architecture RISC Version 1.1 HP Precision Architecture RISC Version 2.0 HP Itanium-based Architecture Version 0 The function classifies cpuvers, a value of the variable, as to its processor family. Maximum timer overrun count. Maximum parenthesis nesting level for expressions (see expr(1)). Equal to if the optional Numeric User Group Name feature is installed (see usergroupname(5)); otherwise. Maximum data buffer size. Maximum data buffer size. Maximum length of a host name (not including the terminating null) (see gethostname(2)). if the hardware is capable of HyperThreading. if the hardware is not capable of HyperThreading. Note: The value returned may change during the lifetime of the calling process, if the system administra- tor changes the hardware configuration. if the hardware is HyperThreading enabled and OS supports HyperThreading. if the hardware is not HyperThreading enabled. Note: The value returned may change during the lifetime of the calling process, if the system administra- tor changes the hardware configuration. Returns which kernel is supported on the hardware. The value returned is an encoding that may be interpreted using the and macros defined in For example: Type of I/O drivers the kernel supports; currently, only the value Returns the number of bits used by the kernel for pointer and long data types. Current values include 32 and 64. The version of libc that is in use by the application that is requesting this information. The format of the value returned by is XXyyZZZZqN, where: XX HP-UX major release number yy HP-UX minor release number ZZZZ Library-specific number q One of the following values: 32PA 64PA 32EM 64EM Reserved N One of the following values: Archive library System V version of shared library Maximum number of bytes in an input line (including the newline) for POSIX.2 utilities. Maximum length of user name in bytes. Not supported. Positive if the system supports POSIX memory locking (see mlockall(2), munlockall(2)). Positive if the system supports POSIX memory range locking. Not supported. Positive if the system supports POSIX message queues. Positive if the system supports mincore(2) system call. 1 if the system is in LORA mode and 0 otherwise. See numa_policy(5). Note: The value returned may change during the lifetime of the calling process, if the sys- tem administrator changes the kernel configuration Maximum number of per-process open message queue descriptors. Maximum limit for message priority. Maximum number of simultaneous supplementary group IDs per process. Maximum number of files that one process can have open at one time. Kernel memory page size. Maximum number of significant bytes in a password. Equal to Note: The value returned may change during the lifetime of the calling process, if the system administrator changes the hardware configuration. if the Advisory Information option is supported; otherwise. Positive if the system supports POSIX Asynchronous Input and Output. Equal to if the Barriers option is supported; otherwise. Equal to if the Clock Selection option is supported; otherwise. Equal to if the Process CPU-Time Clocks option is supported; otherwise. Positive if the File Synchronization option is supported (see fsync(2)). Equal to if the IPv6 option is supported; otherwise. Positive if the system supports POSIX job control; otherwise. Positive if the system supports POSIX memory locking (see mlockall(2), munlockall(2)). Positive if the system supports POSIX memory mapped files. Positive if the system supports POSIX memory range locking. Positive if the system supports POSIX memory protection. Positive if the system supports POSIX Prioritized Input and Output. Equal to if the Monotonic Clock option is supported; otherwise. Positive if the system supports POSIX message queues. Positive if the system supports POSIX.4 priority scheduling; otherwise. Equal to if the Raw Sockets option is supported; otherwise. Equal to if the Read-Write Locks option is supported; otherwise. Positive if the system supports POSIX.4 real time signal extensions; otherwise. Equal to if the Regular Expression Handling option is supported; otherwise. Positive if each process has a saved set-user-ID and a saved set-group-ID; otherwise. Positive if the system supports POSIX semaphores. Positive if the system supports POSIX shared memory. Equal to if the POSIX shell is supported; otherwise. Equal to if the Spawn option is supported; otherwise. Equal to if the Spin Locks option is supported; otherwise. Equal to if the Process Sporadic Server option is supported; otherwise. Not supported. Positive if the Synchronized IO option is supported (see open(2)). Positive if the implementation supports the POSIX Thread Stack Address Attribute option; otherwise. Positive if the implementation supports the POSIX Thread Stack Size Attribute option; otherwise. Equal to if the Thread CPU-Time Clocks option is supported; otherwise. Positive if the implementation supports the POSIX Thread Priority Scheduling option; otherwise. Positive if the implementation supports the POSIX Thread Priority Inheritance option; otherwise. Positive if the implementation supports the POSIX Thread Priority Protection option; otherwise. Positive if the implementation supports the POSIX Thread Process-Shared Synchronization option; otherwise. Positive if the implementation supports the POSIX Thread Thread-Safe Functions option; otherwise. Equal to if the Thread Sporadic Server option is supported; otherwise. Positive if the implementation supports POSIX threads; otherwise. Equal to if the Timeouts option is supported; otherwise. Positive if the system supports POSIX.4 clocks and timers; otherwise. Equal to if the Trace option is supported; otherwise. Equal to if the Trace Event Filter option is supported; otherwise. Maximum length of the trace event name. Equal to if the Trace Inherit option is supported; otherwise. Equal to if the Trace Log option is supported; otherwise. Maximum length of the trace generation version string or of the trace stream name. Maximum number of trace streams that may simultaneously exist in the system. Maximum number of user trace event type identifiers that may simultaneously exist in a traced process Maximum length of a terminal device name. Equal to if the Typed Memory Objects option is supported; otherwise. Approval date of the POSIX.1 Standard (such as 199009 for POSIX.1-1990) to which the system conforms. This value indicates the year (first four digits) and month (next two digits) that the standard was approved by the IEEE Standards Board. Equal to if the POSIX.2 C Language Bindings Option is available through the utility; otherwise. Equal to if the POSIX.2 C Language Development Utilities Option is supported; otherwise. Current version of the POSIX.2 C Language Binding Option supported (same format as otherwise. Equal to if the POSIX.2 FORTRAN Development Utilities Option is supported; otherwise. Equal to if the POSIX.2 Fortran Runtime Utilities Option is supported; otherwise. Equal to if locales can be created with the POSIX.2 localedef utility; otherwise. Equal to if the Batch Environment Services and Utilities option is supported; otherwise. Equal to if the Batch Accounting option is supported; otherwise. Equal to if the Batch Checkpoint/Restart option is supported; otherwise. Equal to if the Locate Batch job request option is supported; otherwise. Equal to if the Batch Job Message Request option is supported; otherwise. Equal to if the Track Batch Job Request option is supported; otherwise. Equal to if the POSIX.2 Software Development Utilities Option is supported; otherwise. Equal to if the POSIX.2 User Portability Utilities Option is supported; otherwise. Current version of POSIX.2 (same format as Not supported. Positive if the implementation supports the Processor Set Functions; otherwise. Equal to if the optional HP Process Resource Management (PRM) software is installed and configured; otherwise (see prmconfig(1)). The number of attempts made to destroy a pthread's thread-specific data values on thread exit. The number of pthread data keys per process. Minimum size in bytes of pthread stack storage. Maximum number of pthreads that can be created per process. Maximum number of repeated occurrences of a regular expression permitted when using the interval notation (see regcomp(3C)). Maximum number of realtime signals reserved for application use. (No DoD security level supported). Positive if the system supports POSIX semaphores. Maximum number of open semaphores per process. Maximum semaphore value. Positive if the system supports POSIX shared memory. Maximum number of queued signals that a process may send and have pending at the receivers at any time. Maximum number of streams that one process can have open at one time. Maximum number of POSIX.4 timers per process, if POSIX.4 timers are supported; otherwise. Value of Maximum number of bytes in a time zone name for the environment variable. Equal to if the X/Open Encryption Feature Group is supported; otherwise. Equal to if the X/Open Enhanced Internationalization Feature Group is supported; otherwise. Not supported. Not supported. Not supported. Equal to if the X/Open Shared Memory Feature Group is supported; otherwise. Equal to if the Streams option is supported; otherwise. Issue number of supported. A flag that denotes whether and are supported by A return value of indicates they are not supported. A flag that denotes whether and are supported by A return value of indicates they are not supported. A flag that denotes whether and are supported by A return value of indicates they are not supported. A flag that denotes whether and are supported by A return value of indicates they are not supported. ______________________________________________________________________ RETURN VALUE
Upon successful completion, returns the value of the named variable. If the value of name is not recognized, returns and sets to If the value in name is defined but is not supported in this environment, returns but does not change returns positive nonzero if cpuvers is an HP PA-RISC processor; zero if not. ERRORS
If fails, the value of (see errno(2)) is set to: The value of name is not valid. EXAMPLES
The following example determines the number of times the system clock ticks each second: ... The following example determines if the current processor is an HP PA-RISC machine: ... WARNINGS
is implemented as a macro. Normally, the values returned from do not change during the lifetime of the calling process. However, the value of the symbolic constant and thus the value of can vary under certain circumstances. If either of the feature test macros or is defined by the programmer prior to including the value of is defined as in conformance with POSIX.1-1988, FIPS 151-1, and XPG3. Otherwise, the value of is defined as in con- formance with POSIX.1-1990. Similarly, the value of the symbolic constant and thus the value of can vary under certain circumstances. If the feature test macro is defined by the programmer prior to including the value of is defined as in conformance with XPG3. Otherwise, the value of is defined as in conformance with XPG4. See stdsyms(5) for more information about these feature test macros. Any application that has a dependency on libdld.sl is a potential user of both archived and shared libc. Applications that comprise both archived and shared components where may be invoked from both the archived and shared components may get inconsistent return values from AUTHOR
was developed by HP and POSIX. was developed by HP. SEE ALSO
bc(1), expr(1), getconf(1), prmconfig(1), localedef(1M), errno(2), exec(2), fork(2), fsync(2), gethostname(2), getrlimit(2), lio_listio(2), mlockall(2), mpctl(2), munlockall(2), open(2), pathconf(2), times(2), atexit(3), clock(3C), confstr(3C), regcomp(3C), aio(5), limits(5), stdsyms(5), thread_safety(5), unistd(5), usergroupname(5). HP Process Resource Manager: prmconfig(1) in STANDARDS CONFORMANCE
sysconf(2)

Featured Tech Videos