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.1

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)
                      5: .TH "GST2ASCII" "1" "2013-04-19" "Hatari" "Hatari utilities"
                      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.
                     41: .SH "EXAMPLES"
                     42: Save 'program.prg' symbol table in ASCII format with
                     43: local symbols filtered out:
                     44: .br
                     45:        gst2ascii -l program.prg > program.sym
                     46: .SH "SEE ALSO"
                     47: .IR hatari (1),
                     48: .IR hatari_profile (1)
                     49: .SH "AUTHOR"
                     50: Written by Eero Tamminen <oak at helsinkinet fi>.
                     51: .SH "LICENSE"
                     52: This program is free software; you can redistribute it and/or modify
                     53: it under the terms of the GNU General Public License as published by
                     54: the Free Software Foundation; either version 2 of the License, or (at
                     55: your option) any later version.
                     56: .SH "NO WARRANTY"
                     57: This program is distributed in the hope that it will be useful, but
                     58: WITHOUT ANY WARRANTY; without even the implied warranty of
                     59: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
                     60: 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.