Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

isainfo(1)

Name

isainfo - describe instruction set architectures

Synopsis

isainfo
isainfo -{bkn} [-eNv]
isainfo -B [-N]
isainfo -x [-eN]

Description

The isainfo utility is used to identify various attributes of the instruction set architectures supported on the currently running system.

When invoked with no options, isainfo prints the names of the native instruction sets for applications supported by the current version of the operating system. These are a subset of the list returned by isalist(1). The subset corresponds to the basic application environments supported by the currently running system.

Options

The following options are supported:

–b

Prints the number of bits in the address space of the native instruction set.

–B

Prints baseline capabilities for the current release of Oracle Solaris. See NOTES.

–e

Subtract the baseline hardware capabilities from the list of capabilities displayed by the –v and –x options. See NOTES. When used alone, or with the –b, –k, or –n options, the use of –e also causes –v to be set.

–k

Prints the name of the instruction set(s) used by the operating system kernel components such as device drivers and STREAMS modules.

–n

Prints the name of the native instruction set used by portable applications supported by the current version of the operating system.

–N

Display hardware capabilities as hexadecimal values rather than printing their symbolic names.

–v

When used alone, or with the –b, –k or –n options, prints more detailed information which includes the associated hardware capabilities.

–x

Prints instruction extensions to the native ABI which are supported by the platform.

–?
–-help

Print usage message and immediately exit.

Examples

Example 1 Invoking isainfo (x86 Platform)

The following example invokes isainfo on an x86 platform:

example% isainfo
amd64 i386

example% isainfo -n
amd64

example% isainfo -v
64-bit amd64 applications
        mpx prfchw adx rdseed efs rtm hle bmi2 avx2 bmi1 f16c fma
        rdrand avx xsave pclmulqdq aes movbe sse4_2 sse4_1 ssse3
        amd_lzcnt popcnt tscp ahf cx16 sse3 sse2 sse fxsr mmx cmov
        amd_sysc cx8 tsc fpu
32-bit i386 applications
        mpx prfchw adx rdseed efs rtm hle bmi2 avx2 bmi1 f16c fma
        rdrand avx xsave pclmulqdq aes movbe sse4_2 sse4_1 ssse3
        amd_lzcnt popcnt tscp ahf cx16 sse3 sse2 sse fxsr mmx cmov
        sep cx8 tsc fpu

example% isainfo -kv
        mpx prfchw adx rdseed efs rtm hle bmi2 avx2 bmi1 f16c fma
        rdrand avx xsave pclmulqdq aes movbe sse4_2 sse4_1 ssse3
        amd_lzcnt popcnt tscp ahf cx16 sse3 sse2 sse fxsr mmx cmov
        amd_sysc cx8 tsc fpu
Example 2 Invoking isainfo (SPARC Platform)

The following example invokes isainfo on a SPARC platform:

example% isainfo
sparcv9 sparc

example% isainfo -n
sparcv9

example% isainfo -v
64-bit sparcv9 applications
        sparc5b vis3c vamask pause_nsec xmont xmpmul mwait sparc5
        adi vis3b crc32c cbcond pause mont mpmul sha512 sha256 sha1
        md5 camellia des aes ima hpc vis3 fmaf asi_blk_init vis2 vis
        popc fsmuld div32 mul32
32-bit sparc applications
        sparc5b vis3c pause_nsec xmont xmpmul mwait sparc5 vis3b
        crc32c cbcond pause mont mpmul sha512 sha256 sha1 md5
        camellia des aes ima hpc vis3 fmaf asi_blk_init vis2 vis
        popc v8plus fsmuld div32 mul32

example% isainfo -kv
64-bit sparcv9 kernel modules
        sparc5b vis3c vamask pause_nsec xmont xmpmul mwait sparc5
        adi vis3b crc32c cbcond pause mont mpmul sha512 sha256 sha1
        md5 camellia des aes ima hpc vis3 fmaf asi_blk_init vis2 vis
        popc fsmuld div32 mul32
Example 3 Baseline Hardware Capabilities (SPARC Platform)

The following example uses the –B option to print the baseline capabilities for the running system, and uses the –e option to show the available capabilities of the system with the baseline capabilities removed. Comparing these effective capabilities to the full set shown with the –v option in the previous example reveals that a relatively small set of newer capabilities affect runtime linker decisions:

example% isainfo -B
fjorclnum fjieeedec crc32c cbcond pause mont mpmul sha512 sha256
sha1 md5 camellia kasumi des aes fjaes ima fjfmau fjdes fjathhpc hpc
vis3 fmaf asi_blk_init vis2 vis popc v8plus fsmuld div32 mul32

example% isainfo -e
64-bit sparcv9 applications
        sparc5b vis3c vamask pause_nsec xmont xmpmul mwait sparc5
        adi vis3b
32-bit sparc applications
        sparc5b vis3c pause_nsec xmont xmpmul mwait sparc5 vis3b
Example 4 Numeric Format Hardware Capabilities (SPARC Platform)

The following example repeats the hardware capabilities from the previous examples, displaying the capabilities of the running system as hexadecimal values rather than as symbolic names:

example% isainfo -BN
HW_1: 0xffffffff
HW_2: 0

example% isainfo -Nv
64-bit sparcv9 applications
        HW_1: 0x3ff68df7
        HW_2: 0xc01fe
32-bit sparc applications
        HW_1: 0x3ff68dff
        HW_2: 0xc00fa

example% isainfo -eN
64-bit sparcv9 applications
        HW_1: 0
        HW_2: 0xc01fe
32-bit sparc applications
        HW_1: 0
        HW_2: 0xc00fa
Example 5 Invoking isainfo –x (x86 CPU)

The following example invokes isainfo with the –x option on an x86 CPU. The –x writes all information for each architecture on a single line. In this example, ellipses are used to represent output removed from the middle of these lines for display purposes:

example% isainfo -x
amd64: mpx prfchw adx rdseed efs rtm ... amd_sysc cx8 tsc fpu
i386: mpx prfchw adx rdseed efs rtm ... sep cx8 tsc fpu

Exit Status

Non-zero

Options are not specified correctly, or the command is unable to recognize attributes of the system on which it is running. An error message is printed to stderr.

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/core-os
Interface Stability
Committed

See Also

isalist(1), uname(1), ld.so.1(1), getisax(2), sysinfo(2), attributes(7), isalist(7), psrinfo(8)

Oracle Solaris 11.4 Linkers and Libraries Guide

Notes

Instruction extensions to the native platform ABI are represented by hardware capabilities. For a complete description of hardware capabilities, refer to the Oracle Solaris 11.4 Linkers and Libraries Guide. The –v and –x options cause isainfo to display the hardware capabilities supported by the currently running system.

Baseline capabilities are the set of older hardware capabilities that are available on all currently supported hardware. The –B option displays the baseline capabilities for the current version of Oracle Solaris. The –e option causes the baseline capabilities to be subtracted from the list of displayed hardware capabilities shown by the –v or –x options. The resulting shorter list of effective capabilities contains only capabilities that affect capability based decisions made by the runtime linker on the current version of Oracle Solaris. See ld.so.1(1).