xref: /illumos-gate/usr/src/man/man2/getisax.2 (revision 5422785d352a2bb398daceab3d1898a8aa64d006)
te
Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
GETISAX 2 "Nov 7, 2007"
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 supportred by the operating system.

uint_t ui;

(void) getisax(&ui, 1);

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

See attributes(5) 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(5)

Linker and Libraries Guide

SPARC Assembly Language Reference Manual

x86 Assembly Language Reference Manual