Module ida_xref

This function creates xrefs from the indirect jump.

Usually there is no need to call this function directly because the kernel will call it for switch tables

Note: Custom switch information are not supported yet.

Parameters:

• ea - address of the 'indirect jump' instruction
• si - switch information

Returns: bool

Boolean

Get information about a switch's cases.

The returned information can be used as follows:

    for idx in xrange(len(results.cases)):
        cur_case = results.cases[idx]
        for cidx in xrange(len(cur_case)):
            print "case: %d" % cur_case[cidx]
        print "  goto 0x%x" % results.targets[idx]

@param ea: address of the 'indirect jump' instruction
@param si: switch information

@return: a structure with 2 members: 'cases', and 'targets'.

Returns: cases_and_targets_t

Create switch table from the switch information

Parameters:

• ea - address of the 'indirect jump' instruction
• si - switch information

Returns: bool

Boolean

Get character describing the xref type.

Parameters:

• xrtype - combination of Cross-Reference type flags and a cref_t of dref_t value (C++: char)

Returns: char

Create a code cross-reference.

Parameters:

• to - linear address of referenced instruction (C++: ea_t)
• type - cross-reference type (C++: cref_t)

Returns: bool

success

Delete a code cross-reference.

Parameters:

• to - linear address of referenced instruction (C++: ea_t)
• expand - policy to delete the referenced instruction 1: plan to delete the referenced instruction if it has no more references. 0: don't delete the referenced instruction even if no more cross-references point to it (C++: bool)

Returns: int

Create a data cross-reference.

Parameters:

• to - linear address of referenced data (C++: ea_t)
• type - cross-reference type (C++: dref_t)

Returns: bool

success (may fail if user-defined xref exists from->to)

Delete a data cross-reference.

Parameters:

• to - linear address of referenced data (C++: ea_t)

Get first data referenced from the specified address.

Returns: ea_t

linear address of first (lowest) data referenced from the specified address. The lastXR variable contains type of the reference. Return BADADDR if the specified instruction/data doesn't reference to anything.

Get next data referenced from the specified address.

Parameters:

• current - linear address of current referenced data. This value is returned by get_first_dref_from() or previous call to get_next_dref_from() functions. (C++: ea_t)

Returns: ea_t

linear address of next data or BADADDR . The lastXR variable contains type of the reference

Get address of instruction/data referencing to the specified data.

Parameters:

• to - linear address of referencing instruction or data (C++: ea_t)

Returns: ea_t

BADADDR if nobody refers to the specified data. The lastXR variable contains type of the reference.

Get address of instruction/data referencing to the specified data

Parameters:

• to - linear address of referencing instruction or data (C++: ea_t)
• current - current linear address. This value is returned by get_first_dref_to() or previous call to get_next_dref_to() functions. (C++: ea_t)

Returns: ea_t

BADADDR if nobody refers to the specified data. The lastXR variable contains type of the reference.

Get first instruction referenced from the specified instruction. If the specified instruction passes execution to the next instruction then the next instruction is returned. Otherwise the lowest referenced address is returned (remember that xrefs are kept sorted!).

Returns: ea_t

first referenced address. The lastXR variable contains type of the reference. If the specified instruction doesn't reference to other instructions then returns BADADDR .

Get next instruction referenced from the specified instruction.

Parameters:

• current - linear address of current referenced instruction This value is returned by get_first_cref_from() or previous call to get_next_cref_from() functions. (C++: ea_t)

Returns: ea_t

next referenced address or BADADDR . The lastXR variable contains type of the reference.

Get first instruction referencing to the specified instruction. If the specified instruction may be executed immediately after its previous instruction then the previous instruction is returned. Otherwise the lowest referencing address is returned. (remember that xrefs are kept sorted!).

Parameters:

• to - linear address of referenced instruction (C++: ea_t)

Returns: ea_t

linear address of the first referencing instruction or BADADDR . The lastXR variable contains type of the reference.

Get next instruction referencing to the specified instruction.

Parameters:

• to - linear address of referenced instruction (C++: ea_t)
• current - linear address of current referenced instruction This value is returned by get_first_cref_to() or previous call to get_next_cref_to() functions. (C++: ea_t)

Returns: ea_t

linear address of the next referencing instruction or BADADDR . The lastXR variable contains type of the reference.

Has a location external to the function references?

Parameters:

• pfn, (C++ - func_t *)
• ea, (C++ - ea_t)

Returns: bool

XREF_USER

User specified xref. This xref will not be deleted by IDA. This bit should be combined with the existing xref types ( 'cref_t' & 'dref_t' ) Cannot be used for fl_F xrefs

Value:

32

XREF_PASTEND

Reference is past item. This bit may be passed to 'add_dref()' functions but it won't be saved in the database. It will prevent the destruction of eventual alignment directives.

Value:

256