.machine pseudo-op

Edit online

Purpose

Defines the intended target environment.

Syntax

Item Description
.machine StringConstant

Description

The .machine pseudo-op selects the correct instruction mnemonics set for the target machine. It provides symbol table information necessary for the use of the linkage editor. The .machine pseudo-op overrides the setting of the as command's -m flag, which can also be used to specify the instruction mnemonics set for the target machine.

The .machine pseudo-op can occur in the source program more than once. The value specified by a .machine pseudo-op overrides any value specified by an earlier .machine pseudo-op. It is not necessary to place the first .machine pseudo-op at the beginning of a source program. If no .machine pseudo-op occurs at the beginning of a source program and the -m flag is not used with the as command, the default assembly mode is used. The default assembly mode is overridden by the first .machine pseudo-op.

If a .machine pseudo-op specifies a value that is not valid, an error is reported. As a result, the last valid value specified by the default mode value, the -m flag, or a previous .machine pseudo-op is used for the remainder of the instruction validation in the assembler pass one.

Parameters

Item Description
StringConstant Specifies the assembly mode. This parameter is not case-sensitive, and can be any of the values which can be specified with the -m flag on the command line. Possible values, enclosed in quotation marks, are:
Null string ("") or nothing
Specifies the default assembly mode. A source program can contain only instructions that are common to both POWER® family and PowerPC®. Any other instruction causes an error.
push
Saves the current assembly mode in the assembly mode pushdown stack.
pop
Removes a previously saved value from the assembly mode pushdown stack and restore the assembly mode to this saved value.
Note: The intended use of push and pop is inside of include files which alter the current assembly mode. .machine "push" should be used in the included file, before it changes the current assembly mode with another .machine. Similarly, .machine "pop" should be used at the end of the included file, to restore the input assembly mode.

Attempting to hold more than 100 values in the assembly mode pushdown stack will result in an assembly error. The pseudo-ops .machine "push" and .machine "pop" are used in pairs.

ppc
Specifies the PowerPC® common architecture, 32-bit mode. A source program can contain only PowerPC® common architecture, 32-bit instructions. Any other instruction causes an error.
ppc64
Specifies the PowerPC® 64-bit mode. A source program can contain only PowerPC 64-bit instructions. Any other instruction causes an error.
com
Specifies the POWER® family and PowerPC® architecture intersection mode. A source program can contain only instructions that are common to both POWER® family and PowerPC®. Any other instruction causes an error.
pwr
Specifies the POWER® family architecture, POWER® family implementation mode. A source program can contain only instructions for the POWER® family implementation of the POWER® family architecture. Any other instruction causes an error.
pwr2 or pwrx
POWER® family architecture, POWER2™ implementation. A source program can contain only instructions for the POWER2™ implementation of the POWER® family architecture. Any other instruction causes an error.
pwr4 or 620
Specifies the POWER4 mode. A source program can contain only instructions compatible with the POWER4 processor.
pwr5
For AIX® 5.3 and later, POWER® family architecture, POWER5™ implementation. A source program can contain only instructions for the POWER5™ implementation of the POWER® family architecture. Any other instruction causes an error.
pwr5x
Specifies the POWER5+™ mode. A source program can contain only instructions compatible with the POWER5+™ processor.
Item Description
 
pwr6
Specifies the POWER6® mode. A source program can contain only instructions compatible with the POWER6® processor.
pwr6e
Specifies the POWER6E mode. A source program can contain only instructions compatible with the POWER6E processor.
pwr7
Specifies the POWER7® mode. A source program can contain only instructions compatible with the POWER7 processor.
pwr8
Specifies the POWER8® mode. A source program can only contain instructions compatible with the POWER8 processor
start of changepwr9end of change
start of changeSpecifies the POWER9™ mode. A source program can only contain instructions compatible with the POWER9 processor.end of change
start of changepwr10end of change
start of changeSpecifies the POWER10 mode. A source program can only contain instructions compatible with the POWER10 processor.end of change
any
Any nonspecific POWER® family/PowerPC® architecture or implementation mode. This includes mixtures of instructions from any of the valid architectures or implementations.
601
Specifies the PowerPC® architecture, PowerPC® 601 RISC Microprocessor mode. A source program can contain only instructions for the PowerPC® architecture, PowerPC® 601 RISC Microprocessor. Any other instruction causes an error.
Attention: It is recommended that the 601 assembly mode not be used for applications that are intended to be portable to future PowerPC® systems. The com or ppc assembly mode should be used for such applications.

The PowerPC® 601 RISC Microprocessor implements the PowerPC® architecture, plus some POWER® family instructions which are not included in the PowerPC® architecture. This allows existing POWER® family applications to run with acceptable performance on PowerPC® systems. Future PowerPC® systems will not have this feature. The 601 assembly mode may result in applications that will not run on existing POWER® family systems and that may not have acceptable performance on future PowerPC® systems, because the 601 assembly mode permits the use of all the instructions provided by the PowerPC® 601 RISC Microprocessor.

603
Specifies the PowerPC® architecture, PowerPC 603 RISC Microprocessor mode. A source program can contain only instructions for the PowerPC® architecture, PowerPC 603 RISC Microprocessor. Any other instruction causes an error.
 
604
Specifies the PowerPC® architecture, PowerPC 604 RISC Microprocessor mode. A source program can contain only instructions for the PowerPC® architecture, PowerPC 604 RISC Microprocessor. Any other instruction causes an error.
ppc970 or 970
Specifies the PPC970 mode. A source program can contain only instructions compatible with the PPC970 processor.
A35
Specifies the A35 mode. A source program can contain only instructions for the A35. Any other instruction causes an error.

Examples

  1. To set the target environment to POWER® family architecture, POWER® family implementation: 
    
.machine "pwr"
  2. To set the target environment to any non-specific POWER® family/PowerPC® architecture or implementation mode: 
    
.machine "any"
  3. To explicitly select the default assembly mode: 
    
.machine ""
  4. The following example of assembler output for a fragment of code shows the usage of .machine "push" and .machine "pop": 
    
 push1.s                              V4.1                04/15/94
File# Line#  Mode Name   Loc Ctr   Object Code            Source
0       1 |                                              .machine   "pwr2"
0       2 |                                              .csect    longname1[PR]
0       3 |  PWR2 longna 00000000  0000000a              .long   10
0       4 |  PWR2 longna 00000004  329e000a              ai    20,30,10
0       5 |  PWR2 longna 00000008  81540014              l    10, 20(20)
0       6 |                                              .machine "push"
0       7 |                                              .machine  "ppc"
0       8 |                                              .csect  a2[PR]
0       9 |  PPC  a2     00000000  7d4c42e6               mftb  10
0      10 |                                              .machine "pop"
0      11 |  PWR2 a2     00000004  329e000a              ai    20,30,10
0      12 |