6.59.4 ARC Built-in Functions

The following built-in functions are provided for ARC targets. The built-ins generate the corresponding assembly instructions. In the examples given below, the generated code often requires an operand or result to be in a register. Where necessary further code will be generated to ensure this is true, but for brevity this is not described in each case.

Note: Using a built-in to generate an instruction not supported by a target may cause problems. At present the compiler is not guaranteed to detect such misuse, and as a result an internal compiler error may be generated.

— Built-in Function: int __builtin_arc_aligned (void *val, int alignval )

Return 1 if val is known to have the byte alignment given by alignval , otherwise return 0. Note that this is different from

          __alignof__(*(char *)val
) >= alignval

because __alignof__ sees only the type of the dereference, whereas __builtin_arc_align uses alignment information from the pointer as well as from the pointed-to type. The information available will depend on optimization level.

— Built-in Function: void __builtin_arc_brk (void )

Generates

          brk
— Built-in Function: unsigned int __builtin_arc_core_read (unsigned int regno )

The operand is the number of a register to be read. Generates:

          mov  dest
, rregno

where the value in dest will be the result returned from the built-in.

— Built-in Function: void __builtin_arc_core_write (unsigned int regno, unsigned int val )

The first operand is the number of a register to be written, the second operand is a compile time constant to write into that register. Generates:

          mov  rregno
, val

— Built-in Function: int __builtin_arc_divaw (int a, int b )

Only available if either -mcpu=ARC700 or -meA is set. Generates:

          divaw  dest
, a
, b

where the value in dest will be the result returned from the built-in.

— Built-in Function: void __builtin_arc_flag (unsigned int a )

Generates

          flag  a

— Built-in Function: unsigned int __builtin_arc_lr (unsigned int auxr )

The operand, auxv , is the address of an auxiliary register and must be a compile time constant. Generates:

          lr  dest
, [auxr
]

Where the value in dest will be the result returned from the built-in.

— Built-in Function: void __builtin_arc_mul64 (int a, int b )

Only available with -mmul64 . Generates:

          mul64  a
, b

— Built-in Function: void __builtin_arc_mulu64 (unsigned int a, unsigned int b )

Only available with -mmul64 . Generates:

          mulu64  a
, b

— Built-in Function: void __builtin_arc_nop (void )

Generates:

          nop
— Built-in Function: int __builtin_arc_norm (int src )

Only valid if the ‘ norm ’ instruction is available through the -mnorm option or by default with -mcpu=ARC700 . Generates:

          norm  dest
, src

Where the value in dest will be the result returned from the built-in.

— Built-in Function: short int __builtin_arc_normw (short int src )

Only valid if the ‘ normw ’ instruction is available through the -mnorm option or by default with -mcpu=ARC700 . Generates:

          normw  dest
, src

Where the value in dest will be the result returned from the built-in.

— Built-in Function: void __builtin_arc_rtie (void )

Generates:

          rtie
— Built-in Function: void __builtin_arc_sleep (int a

Generates:

          sleep  a

— Built-in Function: void __builtin_arc_sr (unsigned int auxr, unsigned int val )

The first argument, auxv , is the address of an auxiliary register, the second argument, val , is a compile time constant to be written to the register. Generates:

          sr  auxr
, [val
]
— Built-in Function: int __builtin_arc_swap (int src )

Only valid with -mswap . Generates:

          swap  dest
, src

Where the value in dest will be the result returned from the built-in.

— Built-in Function: void __builtin_arc_swi (void )

Generates:

          swi
— Built-in Function: void __builtin_arc_sync (void )

Only available with -mcpu=ARC700 . Generates:

          sync
— Built-in Function: void __builtin_arc_trap_s (unsigned int c )

Only available with -mcpu=ARC700 . Generates:

          trap_s  c

— Built-in Function: void __builtin_arc_unimp_s (void )

Only available with -mcpu=ARC700 . Generates:

          unimp_s

The instructions generated by the following builtins are not considered as candidates for scheduling. They are not moved around by the compiler during scheduling, and thus can be expected to appear where they are put in the C code:

     __builtin_arc_brk()
     __builtin_arc_core_read()
     __builtin_arc_core_write()
     __builtin_arc_flag()
     __builtin_arc_lr()
     __builtin_arc_sleep()
     __builtin_arc_sr()
     __builtin_arc_swi()