1 GETISAX(2)                       System Calls                       GETISAX(2)
   2 
   3 
   4 
   5 NAME
   6        getisax - extract valid instruction set extensions
   7 
   8 SYNOPSIS
   9        #include <sys/auxv.h>
  10 
  11        uint_t getisax(uint32_t *array, uint_t n);
  12 
  13 
  14 DESCRIPTION
  15        The getisax() function sets the vector array of n 32-bit integers to
  16        contain the bits from the AV_xxx_yyy namespace of the given instruction
  17        set architecture.
  18 
  19 
  20        Values for AV_xxx_yyy for SPARC and SPARCV9, and their associated
  21        descriptions, can be found in <sys/auxv_SPARC.h>.
  22 
  23 
  24        Values for AV_xxx_yyy for i386 and AMD64, and their associated
  25        descriptions, can be found in <sys/auxv_386.h>.
  26 
  27 RETURN VALUES
  28        The getisax() function returns the number of array elements that
  29        contain non-zero values.
  30 
  31 EXAMPLES
  32        Example 1 Use getisax() to determine if the SSE2 instruction set is
  33        present.
  34 
  35 
  36        In the following example, if the message is written, the SSE2
  37        instruction set is present and fully supported by the operating system.
  38 
  39 
  40          uint_t ui;
  41 
  42          (void) getisax(&ui, 1);
  43 
  44          if (ui & AV_386_SSE2)
  45                  printf("SSE2 instruction set extension is present.\n");
  46 
  47 
  48 ATTRIBUTES
  49        See attributes(5) for descriptions of the following attributes:
  50 
  51 
  52 
  53 
  54        +--------------------+-----------------+
  55        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
  56        +--------------------+-----------------+
  57        |Interface Stability | Committed       |
  58        +--------------------+-----------------+
  59        |MT-Level            | Safe            |
  60        +--------------------+-----------------+
  61 
  62 SEE ALSO
  63        isainfo(1), ld(1), pargs(1), attributes(5)
  64 
  65 
  66        Linker and Libraries Guide
  67 
  68 
  69        SPARC Assembly Language Reference Manual
  70 
  71 
  72        x86 Assembly Language Reference Manual
  73 
  74 
  75 
  76                                November 7, 2007                     GETISAX(2)