1GST2ASCII(1)                   Hatari utilities                   GST2ASCII(1)
2
3
4

NAME

6       gst2ascii - Filter and output Atari program symbol table as ASCII
7

SYNOPSIS

9       gst2ascii [options] <program>
10

DESCRIPTION

12       gst2ascii  reads  (GNU-style a.out or traditional DRI/GST) symbol table
13       from given Atari program and outputs it in the ASCII format  understood
14       by Hatari debugger and its profiler data post-processor (latter doesn't
15       accept any other format).
16
17       All symbol addresses output by the tool  are  TEXT  relative,  so  when
18       loading  them in Hatari debugger, one needs to give just TEXT as offset
19       for the 'symbols' command.
20
21       There are some options for filtering the symbol table content, and  the
22       resulting ASCII output is easy to edit also by hand, in case other sym‐
23       bols (e.g. loop labels) need to be removed from it, or missing function
24       symbols need to be added to it.
25

OPTIONS

27       -a     Filter absolute (= value, not address) symbols out from the out‐
28              put.
29
30       -b     Filter BSS symbols out from the output.
31
32       -d     Filter DATA symbols out from the output.
33
34       -t     Filter TEXT symbols out from the output.
35
36       -l     Filter local (.L*) symbols out.  Usually they're useless because
37              they don't have names, just numbers.
38
39       -o     Filter symbols for object files (*.o) out.
40
41       -n     Sort symbol output by symbol name, not by their addresses.
42

NOTES

44       If  you  have  problems,  try  with 'nm -n <program>' instead (Atari or
45       cross-compiler version). If nm works,  but  gst2ascii  doesn't,  please
46       report a bug on it.
47

EXAMPLES

49       Save 'program.prg' symbol table in ASCII format with local symbols fil‐
50       tered out:
51            gst2ascii -l program.prg > program.sym
52
53       Load generated ASCII symbols file in Hatari debugger:
54            symbols program.sym TEXT DATA BSS
55

SEE ALSO

57       hatari(1), hatari_profile(1)
58

AUTHOR

60       Written by Eero Tamminen <oak at helsinkinet fi>.
61

LICENSE

63       This program is free software; you can redistribute it and/or modify it
64       under  the  terms of the GNU General Public License as published by the
65       Free Software Foundation; either version 2 of the License, or (at  your
66       option) any later version.
67

NO WARRANTY

69       This  program  is  distributed  in the hope that it will be useful, but
70       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
71       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
72       Public License for more details.
73
74
75
76Hatari                            2017-11-11                      GST2ASCII(1)
Impressum