delorie.com/djgpp/doc/libc/libc_791.html   search  
libc.a reference

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

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");


  webmaster     delorie software   privacy  
  Copyright © 2004     Updated Apr 2004