Return to gst2ascii.1 CVS log

Up to [HATARI the Atari ST Emulator] / hatari / tools / debugger

Annotation of hatari/tools/debugger/gst2ascii.1, revision 1.1.1.2

1.1       root        1: .\" Hey, EMACS: -*- nroff -*-
                      2: .\" First parameter, NAME, should be all caps
                      3: .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
                      4: .\" other parameters are allowed: see man(7), man(1)
1.1.1.2 ! root        5: .TH "GST2ASCII" "1" "2014-05-08" "Hatari" "Hatari utilities"
1.1       root        6: .SH "NAME"
                      7: gst2ascii \- Output Atari program DRI/GST format symbol table
                      8: .SH "SYNOPSIS"
                      9: .B gst2ascii
                     10: .RI  [options]
                     11: .RI  <program>
                     12: .SH "DESCRIPTION"
                     13: \fIgst2ascii\fP reads DRI/GST symbol table from given Atari program and
                     14: outputs it in the ASCII format understood by Hatari debugger and its
                     15: profiler data post-processor (which doesn't accept any other format). 
                     16: .PP
                     17: There are some options to filter the symbol table content and the
                     18: resulting ASCII output is easy to edit also by hand, if other symbols
                     19: (for e.g. loop labels) need to be removed or missing function symbols
                     20: need to be added.
                     21: .SH "OPTIONS"
                     22: .TP
                     23: \fB-n\fP
                     24: Sort symbol output by symbol name, not by their addresses.
                     25: .TP
                     26: \fB-b\fP
                     27: Filter BSS symbols out from the output.
                     28: .TP
                     29: \fB-b\fP
                     30: Filter DATA symbols out from the output.
                     31: .TP
                     32: \fB-t\fP
                     33: Filter TEXT symbols out from the output.
                     34: .TP
                     35: \fB-l\fP
                     36: Filter local (.L*) symbols out.  Usually they're useless because
                     37: they don't have names, just numbers.
                     38: .TP
                     39: \fB-o\fP
                     40: Filter symbols for object files (*.o) out.
1.1.1.2 ! root       41: .SH "NOTES"
        !            42: If you have problems, try with 'nm -n <program>' instead
        !            43: (Atari or cross-compiler version). If \fInm\fP works,
        !            44: but \fIgst2ascii\fP doesn't, please report a bug on it.
1.1       root       45: .SH "EXAMPLES"
                     46: Save 'program.prg' symbol table in ASCII format with
                     47: local symbols filtered out:
                     48: .br
                     49:        gst2ascii -l program.prg > program.sym
1.1.1.2 ! root       50: .PP
        !            51: Load generated ASCII symbols file in Hatari debugger:
        !            52: .br
        !            53:        symbols program.sym TEXT DATA BSS
1.1       root       54: .SH "SEE ALSO"
                     55: .IR hatari (1),
                     56: .IR hatari_profile (1)
                     57: .SH "AUTHOR"
                     58: Written by Eero Tamminen <oak at helsinkinet fi>.
                     59: .SH "LICENSE"
                     60: This program is free software; you can redistribute it and/or modify
                     61: it under the terms of the GNU General Public License as published by
                     62: the Free Software Foundation; either version 2 of the License, or (at
                     63: your option) any later version.
                     64: .SH "NO WARRANTY"
                     65: This program is distributed in the hope that it will be useful, but
                     66: WITHOUT ANY WARRANTY; without even the implied warranty of
                     67: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
                     68: General Public License for more details.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.