agent/tcf/services/dwarfreloc.h

/*******************************************************************************
 * Copyright (c) 2010, 2013 Wind River Systems, Inc. and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * and Eclipse Distribution License v1.0 which accompany this distribution.
 * The Eclipse Public License is available at
 * http://www.eclipse.org/legal/epl-v10.html
 * and the Eclipse Distribution License is available at
 * http://www.eclipse.org/org/documents/edl-v10.php.
 * You may elect to redistribute this code under either of these licenses.
 *
 * Contributors:
 *     Wind River Systems - initial API and implementation
 *******************************************************************************/

/*
 * This module implements ELF relocation records handling for reading DWARF debug information.
 *
 * Functions in this module use exceptions to report errors, see exceptions.h
 */

#ifndef D_dwarfreloc
#define D_dwarfreloc

#include <tcf/config.h>

#if ENABLE_ELF

#include <tcf/services/tcf_elf.h>

/*
 * Apply relocation for a value in 'buf' that is taken from section 's' at offset 'offset' and
 * has size of 'size' bytes. 'dst' is set to relocation target section.
 * Note: 'buf' has host endianness.
 */
extern void drl_relocate(ELF_Section * s, U8_T offset, void * buf, size_t size, ELF_Section ** dst);

/*
 * Apply relocation for a value in 'buf' that is taken from section 's' at offset 'offset' and
 * has size of 'size' bytes. 'dst' is set to relocation target section.
 * 'ctx' is used to resolve relocations that reference COMMON symbols.
 * 'rt_addr' is set to 1 if the relocation was resolved to a run-time address.
 * Note: 'buf' has host endianness.
 */
extern void drl_relocate_in_context(Context * ctx, ELF_Section * s, U8_T offset, void * buf, size_t size,
                         ELF_Section ** dst, int * rt_addr);

#endif /* ENABLE_ELF */

#endif /* D_dwarfreloc */