dwarf_get_cie_info3

Usage

Library

library “libdwarf”

Overview

Function dwarf_get_cie_info() retrieves the information associated with a given CIE descriptor.

Argument cie should reference a valid DWARF CIE descriptor, such as would be returned by function dwarf_get_cie_of_fde(3).

Argument cie_byte_len should point to a location that will hold the length in bytes of the CIE descriptor itself.

Argument version should point to a location that will hold the version number of the CIE descriptor.

Arugment augmentation should point to a location that will be set to a pointer to a NUL-terminated string containing augmentation data encoded as UTF-8.

Argument caf should point to a location that will hold the code alignment factor recorded in the CIE descriptor.

Arugment daf should point to a location that will hold the data alignment factor recorded in the CIE descriptor.

Argument ra should point to a location that will hold the return address recorded in the CIE descriptor.

Argument init_inst should point to a location that will be set to a pointer to an array of bytes containing the initial instructions associated with the CIE descriptor.

Argument inst_len should point to a location that will hold the length in bytes of the initial instructions returned in argument init_inst.

If argument err is not NULL, it will be used to store error information in case of an error.

Return values

Function dwarf_get_cie_info() returns DW_DLV_OK when it succeeds. In case of an error, it returns DW_DLV_ERROR and sets the argument err.

Errors

Function dwarf_get_cie_info() can fail with:

[DW_DLE_ARGUMENT]

One of the arguments cie, cie_byte_len, version, augmentation, caf, daf, ra, init_inst or inst_len was NULL.