You copied the Doc URL to your clipboard.

__attribute__((alias)) variable attribute

This variable attribute enables you to specify multiple aliases for a variable.

Aliases must be declared in the same translation unit as the definition of the original variable.


Aliases cannot be specified in block scope. The compiler ignores aliasing attributes attached to local variable definitions and treats the variable definition as a normal local definition.

In the output object file, the compiler replaces alias references with a reference to the original variable name, and emits the alias alongside the original name. For example:

int oldname = 1;
extern int newname __attribute__((alias("oldname")));

This code compiles to:

        .type   oldname,%object         @ @oldname
        .globl  oldname
        .align  2
        .long   1                       @ 0x1
        .size   oldname, 4
        .globl  newname
newname = oldname


Function names can also be aliased using the corresponding function attribute __attribute__((alias)).


type newname __attribute__((alias("oldname")));



is the name of the variable to be aliased


is the new name of the aliased variable.


#include <stdio.h>
int oldname = 1;
extern int newname __attribute__((alias("oldname"))); // declaration
void foo(void){
    printf("newname = %d\n", newname); // prints 1