Label Directive, Label labelid | HP UX Developer Tools specification

NOTE

Assembler Directives and Pseudo-Operations

.LABEL Directive

.LABEL Directive

The .LABEL directive permits a label deﬁnition to appear within a sequence of instructions that occur on a single line.

Syntax

.LABEL label_id

Parameters

label_id

Names the label identiﬁer.

The .LABEL directive is especially useful when using the M4 macro processor or the C preprocessor (cpp). You would normally use this directive in a DEFINE macro that includes multiple instructions.

Example

This example deﬁnes a cpp macro named Loop.

#define Loop(xx) LDO xx(%r0),%r1 ! .LABEL Loop ! ADDI,=-1,%r1,%r1 \

!BL Loop,%r0 ! NOP ! LDI 1,%ret0 ; macro

.CODE

step_ten

.PROC

.CALLINFO

.ENTER

Loop(10)

.LEAVE

.PROCEND

.EXPORT step_ten,ENTRY

92

Chapter 4

Image 92

HP UX Developer Tools manual Label Directive, Label labelid, Labelid Names the label identiﬁer

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-RISC 2.0W Wide Mode, 64-bitSummary of Changes for PA-RISC 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 Expressions ExpressionsStandard Arithmetic Operators 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 Align Directive SyntaxParameters 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 Form of argument-description is Arg=location Where arg can Return value for a procedureﬁrst word in the argument list 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 Comm Directive Comm DirectiveLabel .COMM numbytes Label Labels the location of the reserved storage Company-name Copyright DirectiveCopyright Directive Proc Callinfo Enter Integer .fraction E power Fraction E powerDouble Pseudo-Operation 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 Symbolicname .EQU value EQU DirectiveEQU 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 Directive Label DirectiveLabel labelid 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 REG Directive REG DirectiveLabel .REG typedregister 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 Subspa Directive Subspa DirectiveName An identiﬁer that names the current subspace Chapter 111 112 Chapter 113 114 Version DirectiveVersion Directive Word Pseudo-Operation Word Pseudo-OperationWord initvalue , initvalue Chapter 115 Directive Space Name Default Parameters Programming AidsProgramming 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 Using the as Command Using the as CommandAssemble code for the architecture 124 Chapter 125 ﬁlenameLevel Wnumber Tables, see HP-UX Linker and LibrariesOnline User Guide 126 Using the cc Command Using the cc CommandPassing Arguments to the Assembler 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 Demonstrating the Procedure Calling Convention Demonstrating the Procedure Calling ConventionProgram Listing 136 Assembly Program Listing Chapter 137 Output of the cc -S Command Assembly Program Listing From the C CompilerOutput of the cc -S Command 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 1027 10281029 1030 1031 10321033 1034 1035 10361037 1038 162 Chapter 163 1054 10551056 1057 Chapter 165 166 Chapter 167 168 Format keyword=value 10801081 1082 170 1088 10891090 Chapter 171 1091 10941095 1096 1097 10981099 1100 1101 11021103 1104 1105 Chapter 175 176 Panic MessagesPanic Messages 2005 20062007 2008 178 User Warning MessagesUser Warning Messages 7003 70047005 7006 180 Chapter 181 182 Limit Error Messages Limit Error Messages7200 7201 7202 72037204 184 Diagnostic Messages Chapter 185 186 Chapter 187 Branching Error MessagesBranching Error Messages 188 Chapter 189 190 Chapter 191 192 7827 78287834 7835 7836 7837Expr 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