66

Chapter 8. Assembler Directives

the name of a node specified in the version script supplied to the linker when building a shared library.

If you are attempting to override a versioned symbol from a shared library, then

nodename

should

correspond to the nodename of the symbol you are trying to override.

If the symbol

name

is not defined within the file being assembled, all references to

name

will be

changed to

name2@nodename

. If no reference to

name

is made,

name2@nodename

will be removed

from the symbol table.

Another usage of the

.symver

directive is:

.symver name, name2@@nodename

In this case, the symbol

name

must exist and be defined within the file being assembled. It is similar

to

name2@nodename

. The difference is

name2@@nodename

will also be used to resolve references to

name2

by the linker.

The third usage of the

.symver

directive is:

.symver name, name2@@@nodename

When

name

is not defined within the file being assembled, it is treated as

name2@nodename

.

When

name

is defined within the file being assembled, the symbol name,

name

, will be changed to

name2@@nodename

.

8.91.

.tag structname

This directive is generated by compilers to include auxiliary debugging information in the symbol

table. It is only permitted inside

.def

/

.endef

pairs. Tags are used to link structure definitions in the

symbol table with instances of those structures.

.tag

is only used when generating COFF format output; when

as

is generating

b.out

, it accepts this

directive but ignores it.

8.92.

.text subsection

Tells

as

to assemble the following statements onto the end of the text subsection numbered

subsection

, which is an absolute expression. If

subsection

is omitted, subsection number zero is

used.

8.93.

.title "heading"

Use

heading

as the title (second line, immediately after the source file name and pagenumber) when

generating assembly listings.

This directive affects subsequent pages, as well as the current page if it appears within ten lines of the

top of a page.

8.94.

.type

This directive is used to set the type of a symbol.