Macro Directive | HP UX Developer Tools specs

Assembler Directives and Pseudo-Operations

.MACRO Directive

.MACRO Directive

The .MACRO directive marks the beginning of a macro deﬁnition. An

.ENDM directive must be used to end the macro deﬁnition.

Syntax

label .MACRO [ formal_parameter[,formal_parameter]...]

Parameters

label	The name of the macro.
formal_parameter	Speciﬁes a string of characters
	treated as a positional parameter.
	The ith actual parameter in a macro
	invocation is substituted for the ith
	formal parameter in the macro
	declaration wherever the formal
	parameter appears in the body of the
	macro deﬁnition.

Discussion

Normal Assembler syntax is observed within macro deﬁnitions, except that text substitution is assumed for formal parameters. The following line is an example of a macro declaration:

DECR	.MACRO LAB,VAL

LAB and VAL are formal parameters. Their actual values are determined by the ﬁrst and second parameters on any invocation of the macro DECR. On the macro invocation, the parameters are delimited by commas.

Successive commas indicate a null parameter, causing the expanded macro to substitute null for one of its formal parameters. When the number of formal parameters exceeds the number of actual parameters, null parameters are inserted for the excess parameter positions. When the number of actual parameters exceeds the number of formal parameters, a warning is issued and the excess parameters are ignored.

98

Chapter 4

Image 98

HP UX Developer Tools manual Macro Directive, Label .MACRO formalparameter,formalparameter

Contents

HP 9000 Computers 92432-90012 June Hanover Street Palo Alto, California Legal NoticesRestricted Rights Legend Contents Assembler Directives and Pseudo-Operations Contents Contents Contents Contents Pseudo-Instruction Set Assembling Your Program Index Diagnostic MessagesProgramming Examples Edition Date Software Version PrefacePrinting History Audience Related Documentation Typographical Conventions This Manual Summary of Technical Changes for HP-UX Assembly Language Assembler Features Assembler Features Summary of Changes for PA-RISC Summary of Changes for PA-RISCSummary of Changes for PA-RISC 2.0W Wide Mode, 64-bit Chapter Summary of Changes for PA-RISC 2.0W Wide Mode, 64-bit Program Structure Program Structure Label Opcode Operands Comments Symbols and Constants Symbols and Constants Integer Constants Signed Unsigned Registers and Register Mnemonics Registers and Register Mnemonics Registers by using an L or R sufﬁx General Registers Single-Precision Floating-Point Registers Control Registers Synonyms Double-Precision Floating-Point RegistersSpace Registers Register Procedure Calling Conventions Register Synonyms Description Standard Arithmetic Operators ExpressionsExpressions Operator Operation Legal Combinations For Relocatable Terms Operation Result Available Field Selectors Meaning Field Meaning Selector Multiple of 2048 allows a three-instruction sequence Parenthesized Subexpressions Operands and Completers Operands and Completers Addi Macro Processing Macro ProcessingDeﬁning New Instructions With Macros Contains general register 19, or binary 10011. These HP-UX Architecture Conventions Spaces Spaces Memory Layout on HP-UX Sr4 Sr5 Sr6 Subspaces SubspacesAttributes Space Subspace Sort Key Use DirectivesStandard Subspaces and Sort Keys Sections in 64-bit Mode Sections in 64-bit Mode $INIT$ Location Counters Location Counters Compiler Conventions Compiler Conventions Compiler Conventions Global Symbol Usage Mfctl Shared Libraries Assembly ListingShared Libraries Assembly Listing Directive Function IntroductionAssembler Directives Requests common storage for a speciﬁed number Bytes Pseudo-Operations Directive Function Reserves 16 bits a half word of storage Parameters Align DirectiveSyntax Example Allow Directive Allow DirectiveDiscussion To the .LEVEL speciﬁed for the ﬁle Block and .BLOCKZ Pseudo-Operations Block and .BLOCKZ Pseudo-Operations Space $TEXT$ Subspa $CODE$ Block Byte initvalue , initvalue Byte Pseudo-OperationByte Pseudo-Operation Call argumentdescription argumentdescription Call DirectiveCall Directive ﬁrst word in the argument list Form of argument-description is Arg=location Where arg canReturn value for a procedure Second word in the argument list LIT Align Word Procend Export Callinfo parameter , parameter Callinfo DirectiveCallinfo Directive Register ENTRYSR= Unwound It restores the RP value when it encounters a .LEAVE Callinfo Directive Stack Frames Re-enter code subspace Label .COMM numbytes Comm DirectiveComm Directive Label Labels the location of the reserved storage Company-name Copyright DirectiveCopyright Directive Proc Callinfo Enter Double Pseudo-Operation Integer .fraction E powerFraction E power Double Pseudo-Operation Dword initvalue , initvalue Dword Pseudo-OperationDword Pseudo-Operation END Directive END Directive Endm Directive Endm Directive Enter and .LEAVE Pseudo-Operations Enter and .LEAVE Pseudo-Operations Space $TEXT$ Entry and .EXIT Directives Entry and .EXIT Directives EQU Directive Symbolicname .EQU valueEQU Directive Value Export Directive Export Directive Argument Export proc,ENTRY,ARGW0=GR Float Pseudo-Operation Float Pseudo-Operation Half initvalue , initvalue Half Pseudo-OperationHalf Pseudo-Operation Import Directive Import Directive NOP END Label labelid Label DirectiveLabel Directive Labelid Names the label identiﬁer Level Directive Level Directive Level Directive Listoff and .LISTON Directives Listoff and .LISTON Directives Liston Code Space $TEXT$ SPNUM=0,SORT=0 Subspa $CODE$ Locct Directive Locct Directive Label .MACRO formalparameter,formalparameter Macro DirectiveMacro Directive Examples 100 Chapter 101 Origin DirectiveOrigin Directive 102 Proc and .PROCEND DirectivesProc and .PROCEND Directives Chapter 103 Label .REG typedregister REG DirectiveREG Directive Label User-deﬁned register name Chapter 105 Shlibversion DirectiveShlibversion Directive 106 Space DirectiveSpace Directive Chapter 107 108 Spnum Pseudo-OperationSpnum Pseudo-Operation Chapter 109 String and .STRINGZ Pseudo-OperationsString and .STRINGZ Pseudo-Operations 110 Name An identiﬁer that names the current subspace Subspa DirectiveSubspa Directive Chapter 111 112 Chapter 113 114 Version DirectiveVersion Directive Word initvalue , initvalue Word Pseudo-OperationWord Pseudo-Operation Chapter 115 Programming Aids Directive Space Name Default ParametersProgramming Aids Predeﬁned Subspace Directives Shortdata Chapter 117 Programming Aids 118 Pseudo-Instruction Set 119 120 Chapter 121 Compare and Branch Conditions Comb and ComibCond Description Add and Branch Conditions Addb and Addib Description 122 Invoking the Assembler 123 Assemble code for the architecture Using the as CommandUsing the as Command 124 Chapter 125 ﬁlenameLevel Online User Guide WnumberTables, see HP-UX Linker and Libraries 126 Passing Arguments to the Assembler Using the cc CommandUsing the cc Command Wa, ,as-argument as-argument Cpp Preprocessor 128 Programming Examples 129 130 Binary Search for Highest Bit PositionBinary Search for Highest Bit Position Chapter 131 132 Copying a StringCopying a String Chapter 133 134 Dividing a Double-Word DividendDividing a Double-Word Dividend Programming Examples Chapter 135 Program Listing Demonstrating the Procedure Calling ConventionDemonstrating the Procedure Calling Convention 136 Assembly Program Listing Chapter 137 Output of the cc -S Command Output of the cc -S CommandAssembly Program Listing From the C Compiler 138 Chapter 139 Output of the cc -S Command 140 141 Option operand 142 Chapter 143 Reserve 144 Chapter 145 Wrong register type usedUse a general register 146 Use a space registerUse a control register Chapter 147 148 Chapter 149 150 Chapter 151 Used to invoke the assembler 152 Chapter 153 154 Error MessagesError Messages Chapter 155 156 Chapter 157 158 1029 10271028 1030 1033 10311032 1034 1037 10351036 1038 162 Chapter 163 1056 10541055 1057 Chapter 165 166 Chapter 167 168 1081 Format keyword=value1080 1082 170 1090 10881089 Chapter 171 1095 10911094 1096 1099 10971098 1100 1103 11011102 1104 1105 Chapter 175 176 Panic MessagesPanic Messages 2007 20052006 2008 178 User Warning MessagesUser Warning Messages 7005 70037004 7006 180 Chapter 181 182 7200 Limit Error MessagesLimit Error Messages 7201 7204 72027203 184 Diagnostic Messages Chapter 185 186 Chapter 187 Branching Error MessagesBranching Error Messages 188 Chapter 189 190 Chapter 191 192 7834 78277828 7835 Expr 78367837 194 Index Index 195 196 Numerics Index 197 Copyright 198 HP C/HP-UX,49 Index 199 Mfctl 200 Double Index 201 See also memory 202