GETISAX(2) System Calls GETISAX(2)

NAME


getisax - extract valid instruction set extensions

SYNOPSIS


#include <sys/auxv.h>

uint_t getisax(uint32_t *array, uint_t n);


DESCRIPTION


The getisax() function sets the vector array of n 32-bit integers to
contain the bits from the AV_xxx_yyy namespace of the given instruction
set architecture.


Values for AV_xxx_yyy for SPARC and SPARCV9, and their associated
descriptions, can be found in <sys/auxv_SPARC.h>.


Values for AV_xxx_yyy for i386 and AMD64, and their associated
descriptions, can be found in <sys/auxv_386.h>.

RETURN VALUES


The getisax() function returns the number of array elements that contain
non-zero values.

EXAMPLES


Example 1: Use getisax() to determine if the SSE2 instruction set is


present.


In the following example, if the message is written, the SSE2 instruction
set is present and fully supported by the operating system.


uint_t ui;

(void) getisax(&ui, 1);

if (ui & AV_386_SSE2)
printf("SSE2 instruction set extension is present.\n");


ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+

SEE ALSO


isainfo(1), ld(1), pargs(1), attributes(7)


Linker and Libraries Guide


SPARC Assembly Language Reference Manual


x86 Assembly Language Reference Manual

November 7, 2007 GETISAX(2)