share/man/man1/isainfo.1

   1 '\" te
   2 .\"  Copyright (c) 2007, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH ISAINFO 1 "Feb 8, 2007"
   7 .SH NAME
   8 isainfo \- describe instruction set architectures
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBisainfo\fR [ [\fB-v\fR] [\fB-b\fR | \fB-n\fR | \fB-k\fR] | [\fB-x\fR]]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBisainfo\fR utility is used to identify various attributes of the
  19 instruction set architectures supported on the currently running system. Among
  20 the questions it can answer are whether 64-bit applications are supported, or
  21 whether the running kernel uses 32-bit or 64-bit device drivers.
  22 .sp
  23 .LP
  24 When invoked with no options, \fBisainfo\fR prints the names of the native
  25 instruction sets for applications supported by the current version of the
  26 operating system. These are a subset of the list returned by \fBisalist\fR(1).
  27 The subset corresponds to the basic applications environments supported by the
  28 currently running system.
  29 .SH OPTIONS
  30 .sp
  31 .LP
  32 The following options are supported:
  33 .sp
  34 .ne 2
  35 .na
  36 \fB\fB-b\fR\fR
  37 .ad
  38 .RS 6n
  39 Prints the number of bits in the address space of the native instruction set.
  40 .RE
  41
  42 .sp
  43 .ne 2
  44 .na
  45 \fB\fB-k\fR\fR
  46 .ad
  47 .RS 6n
  48 Prints the name of the instruction set(s) used by the operating system kernel
  49 components such as device drivers and \fBSTREAMS\fR modules.
  50 .RE
  51
  52 .sp
  53 .ne 2
  54 .na
  55 \fB\fB-n\fR\fR
  56 .ad
  57 .RS 6n
  58 Prints the name of the native instruction set used by portable applications
  59 supported by the current version of the operating system.
  60 .RE
  61
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fB-v\fR\fR
  66 .ad
  67 .RS 6n
  68 When used with the \fB-b\fR, \fB-k\fR or \fB-n\fR options, prints more detailed
  69 information.
  70 .RE
  71
  72 .sp
  73 .ne 2
  74 .na
  75 \fB\fB-x\fR\fR
  76 .ad
  77 .RS 6n
  78 Prints instruction extensions to the native ABI which are supported by the
  79 platform.
  80 .RE
  81
  82 .SH EXAMPLES
  83 .LP
  84 \fBExample 1 \fRInvoking \fBisainfo\fR on a 32-bit x86 Platform
  85 .sp
  86 .LP
  87 The following example invokes \fBisainfo\fR on a 32-bit x86 platform:
  88
  89 .sp
  90 .in +2
  91 .nf
  92 example% isainfo -v
  93 32-bit i386 applications
  94
  95 example% isainfo -k
  96 i386
  97 .fi
  98 .in -2
  99 .sp
 100
 101 .LP
 102 \fBExample 2 \fRInvoking \fBisainfo\fR on a System Running the 64-bit Operating
 103 System on a 64-bit SPARC Processor
 104 .sp
 105 .LP
 106 The following example invokes \fBisainfo\fR on a system running the 64-bit
 107 operating system on a 64-bit SPARC processor:
 108
 109 .sp
 110 .in +2
 111 .nf
 112 example% isainfo
 113 sparcv9 sparc
 114 example% isainfo -n
 115 sparcv9
 116 example% isainfo -v
 117 64-bit sparcv9 applications
 118 32-bit sparc applications
 119 example% isainfo -vk
 120 64-bit sparcv9 kernel modules
 121 .fi
 122 .in -2
 123 .sp
 124
 125 .LP
 126 \fBExample 3 \fRInvoking \fBisainfo\fR \fB-x\fR on an AMD Opteron CPU
 127 .sp
 128 .LP
 129 The following example invokes \fBisainfo\fR with the \fB-x\fR option on an AMD
 130 Opteron CPU:
 131
 132 .sp
 133 .in +2
 134 .nf
 135 example% isainfo -x
 136 i386: fpu tsc cx8 sep cmov mmx ammx a3dnow a3dnowx fxsr sse sse2 pause
 137 .fi
 138 .in -2
 139 .sp
 140
 141 .SH EXIT STATUS
 142 .sp
 143 .ne 2
 144 .na
 145 \fBNon-zero\fR
 146 .ad
 147 .RS 12n
 148 Options are not specified correctly, or the command is unable to recognize
 149 attributes of the system on which it is running. An error message is printed to
 150 \fBstderr\fR.
 151 .RE
 152
 153 .SH SEE ALSO
 154 .sp
 155 .LP
 156 \fBisalist\fR(1), \fBuname\fR(1), \fBpsrinfo\fR(8), \fBgetisax\fR(2),
 157 \fBsysinfo\fR(2), \fBattributes\fR(5), \fBisalist\fR(5)