HP UX Developer Tools guide

Assembler Directives and Pseudo-Operations

Directive	Function

.CALLINFO	Provides information for generating Entry/Exit
	code sequences and for creating stack unwind
	descriptors.

.COMM	Requests common storage for a speciﬁed number
	of bytes.

.COPYRIGHT	Inserts a string into the object module as a
	copyright notice.

.END	Terminates an assembly language program.

.ENDM	Marks the end of a macro deﬁnition.

.ENTRY	Marks the entry point of the current procedure.

.EQU	Assigns an expression to an identiﬁer.

.EXIT	Marks the return point of the current procedure.

.EXPORT	Makes a speciﬁed symbol available to other
	modules.

.IMPORT	Speciﬁes that the deﬁnition of the given symbol
	occurs in another module.

.LABEL	Permits a label deﬁnition to appear within a
	sequence of directives that occur on a single line.

.LEVEL	Makes the object ﬁle a PA-RISC 1.1, 2.0, or 2.0W
	ﬁle.

.LISTOFF	Controls listing of expanded Assembler
	instructions.

.LISTON	Controls listing of expanded Assembler
	instructions.

.LOCCT	Selects a location counter.

.MACRO	Marks the beginning of macro deﬁnitions.

.ORIGIN	Advances the location counter to a relative
	location from the beginning of the current
	subspace.

54

Chapter 4

Image 54

HP UX Developer Tools manual Requests common storage for a speciﬁed number Bytes

Contents

HP 9000 Computers 92432-90012 June Legal Notices Restricted Rights LegendHanover Street Palo Alto, California Contents Assembler Directives and Pseudo-Operations Contents Contents Contents Contents Pseudo-Instruction Set Assembling Your Program Diagnostic Messages Programming ExamplesIndex Preface Printing HistoryEdition Date Software Version 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 Double-Precision Floating-Point Registers Space RegistersControl Registers Synonyms 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 Deﬁning New Instructions With MacrosMacro Processing Contains general register 19, or binary 10011. These HP-UX Architecture Conventions Spaces Spaces Memory Layout on HP-UX Sr4 Sr5 Sr6 Subspaces AttributesSubspaces Directives Standard Subspaces and Sort KeysSpace Subspace Sort Key Use 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 Assembly Listing Shared LibrariesShared Libraries Assembly Listing Introduction Assembler DirectivesDirective Function 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 DiscussionAllow Directive To the .LEVEL speciﬁed for the ﬁle Block and .BLOCKZ Pseudo-Operations Block and .BLOCKZ Pseudo-Operations Space $TEXT$ Subspa $CODE$ Block Byte Pseudo-Operation Byte Pseudo-OperationByte initvalue , initvalue Call Directive Call DirectiveCall argumentdescription argumentdescription ﬁ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 Directive Callinfo DirectiveCallinfo parameter , parameter 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 Copyright Directive Copyright DirectiveCompany-name Proc Callinfo Enter Double Pseudo-Operation Integer .fraction E powerFraction E power Double Pseudo-Operation Dword Pseudo-Operation Dword Pseudo-OperationDword initvalue , initvalue 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 Pseudo-Operation Half Pseudo-OperationHalf initvalue , initvalue 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 Macro Directive Macro DirectiveLabel .MACRO formalparameter,formalparameter Examples 100 Origin Directive Origin DirectiveChapter 101 Proc and .PROCEND Directives Proc and .PROCEND Directives102 Chapter 103 Label .REG typedregister REG DirectiveREG Directive Label User-deﬁned register name Shlibversion Directive Shlibversion DirectiveChapter 105 Space Directive Space Directive106 Chapter 107 Spnum Pseudo-Operation Spnum Pseudo-Operation108 String and .STRINGZ Pseudo-Operations String and .STRINGZ Pseudo-OperationsChapter 109 110 Name An identiﬁer that names the current subspace Subspa DirectiveSubspa Directive Chapter 111 112 Chapter 113 Version Directive Version Directive114 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 Compare and Branch Conditions Comb and Comib Cond DescriptionChapter 121 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 ﬁlename LevelChapter 125 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 Binary Search for Highest Bit Position Binary Search for Highest Bit Position130 Chapter 131 Copying a String Copying a String132 Chapter 133 Dividing a Double-Word Dividend Dividing a Double-Word Dividend134 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 Wrong register type used Use a general registerChapter 145 Use a space register Use a control register146 Chapter 147 148 Chapter 149 150 Chapter 151 Used to invoke the assembler 152 Chapter 153 Error Messages Error Messages154 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 Panic Messages Panic Messages176 2007 20052006 2008 User Warning Messages User Warning Messages178 7005 70037004 7006 180 Chapter 181 182 7200 Limit Error MessagesLimit Error Messages 7201 7204 72027203 184 Diagnostic Messages Chapter 185 186 Branching Error Messages Branching Error MessagesChapter 187 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