ddpi_elf_set_elf_file_name operation

The ddpi_elf_set_elf_file_name operation assigns an ELF file name to the given Ddpi_Elf object and makes a copy of the given name.

Prototype

int   ddpi_elf_set_elf_file_name(
    Ddpi_Elf            elf,
    char*               elf_filename,
    Ddpi_Error*         error); 

Parameters

elf
Input. This accepts a Ddpi_Elf object.
elf_filename
Input. This accepts a new filename. No validation is done on this value. A NULL filename will cause any previous entry to be replaced with NULL.
error
See The libddpi error parameter.

Return values

DW_DLV_OK
Returned upon successful assignment of the object name.
DW_DLV_NO_ENTRY
Never returned.
DW_DLV_ERROR
This value is returned if:
  • elf is NULL
  • The Ddpi_Access or Ddpi_Info object associated with elf is NULL.
  • ret_elf_filename is NULL.
  • The function was unable to make a copy of the given filename