GNU Development Tools                                  C]FILT(1)



NAME
     c]filt - Demangle C] and Java symbols.

SYNOPSIS
     c]filt [---strip-underscores]
             [-j--java]
             [-n--no-strip-underscores]
             [-p--no-params]
             [-s format--format=format]
             [--help]  [--version]  [symbol...]

DESCRIPTION
     The C] and Java languages  provides  function  overloading,
     which  means that you can write many functions with the same
     name (providing each takes parameters of  different  types).
     All C] and Java function names are encoded into a low-level
     assembly label (this process  is  known  as  mangling).  The
     c]filt  [1]  program  does  the inverse mapping: it decodes
     (demangles) low-level names into user-level  names  so  that
     the   linker   can  keep  these  overloaded  functions  from
     clashing.

     Every alphanumeric  word  (consisting  of  letters,  digits,
     underscores,  dollars,  or  periods)  seen in the input is a
     potential label.  If the label decodes into a C] name,  the
     C] name replaces the low-level name in the output.

     You can use c]filt to decipher individual symbols:

             c]filt 

     If no symbol arguments are given, c]filt reads symbol names
     from  the  standard  input and writes the demangled names to
     the  standard  output.   All  results  are  printed  on  the
     standard output.

OPTIONS
     -
     --strip-underscores
         On some systems, both the C and  C]  compilers  put  an
         underscore  in  front of every name.  For example, the C
         name "foo" gets the low-level name "foo".  This  option
         removes the initial underscore.  Whether c]filt removes
         the underscore by default is target dependent.

     -j
     --java
         Prints demangled names using Java syntax.   The  default
         is to use C] syntax.

     -n
     --no-strip-underscores



binutils-2.14.91     Last change: 2004-04-09                    1






GNU Development Tools                                  C]FILT(1)



         Do not remove the initial underscore.

     -p
     --no-params
         When demangling the name of a function, do  not  display
         the types of the function's parameters.

     -s format
     --format=format
         c]filt can decode various methods of mangling, used  by
         different   compilers.   The  argument  to  this  option
         selects which method it uses:

         "auto"
             Automatic selection based on executable (the default
             method)

         "gnu"
             the one used by the GNU C] compiler (g])

         "lucid"
             the one used by the Lucid compiler (lcc)

         "arm"
             the one specified by  the  C]  Annotated  Reference
             Manual

         "hp"
             the one used by the HP compiler (aC)

         "edg"
             the one used by the EDG compiler

         "gnu-v3"
             the one used by the GNU C] compiler (g]) with  the
             V3 ABI.

         "java"
             the one used by the GNU Java compiler (gcj)

         "gnat"
             the one used by the GNU Ada compiler (GNAT).

     --help
         Print a summary of the options to c]filt and exit.

     --version
         Print the version number of c]filt and exit.

FOTNOTES
     1.  MS-DOS does not allow "]" characters in file  names,  so
         on MS-DOS this program is named c]filt.



binutils-2.14.91     Last change: 2004-04-09                    2






GNU Development Tools                                  C]FILT(1)



SEE ALSO
     the Info entries for binutils.

COPYRIGHT
     Copyright (c) 1991, 92, 93, 94, 95, 96, 97,  98,  99,  2000,
     2001, 2002, 2003 Free Software Foundation, Inc.

     Permission is granted to copy, distribute and/or modify this
     document  under  the  terms  of  the  GNU Free Documentation
     License, Version 1.1 or any later version published  by  the
     Free  Software  Foundation; with no Invariant Sections, with
     no Front-Cover Texts, and with no Back-Cover Texts.  A  copy
     of  the  license  is  included in the section entitled ``GNU
     Free Documentation License''.

ATRIBUTES
     See  attributes(5)  for  descriptions   of   the   following
     attributes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWbinutils   
    
     Interface Stability  External       
    

NOTES
     Source    for    GNU    binutils     is     available     on
     http:/opensolaris.org.

























binutils-2.14.91     Last change: 2004-04-09                    3