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