syms_init

Syntax

#include <debug/syms.h> void syms_init (char *file);

Description

This function reads debugging symbols from the named file, which should be an executable program (either a `.exe' file or a raw COFF image created by `ld.exe', the linker). It then processes the symbols: classifies them by type, sorts them by name and value, and stores them in internal data structures used by other symbol-related functions, such as syms_val2name, syms_val2line, etc.

You must call syms_init before calling the other syms_* functions.

Currently, syms_init only supports COFF and AOUT debugging format, so programs compiled with `-gstabs' cannot be processed by it.

Return Value

None.

ANSI/ISO C	No
POSIX	No

Example

syms_init("c:/foo/bar/baz.exe");