The iPhoneTools package offers convenient tools designed to simplify development for the iPhone/OSX architecture.
The iPhoneTools package offers a variety of tools specifically designed for the iPhone/OSX architecture. While some of these tools work only on the iPhone, others can be used on different Unix systems as well. One of the tools included in the package is the TraceAlloc Library, which traces memory block allocation and is discussed in greater detail on its home page.
Another tool is nma2n, which can be used with any symbol dump file generated by the nm utility. Simply provide nma2n with the symbol dump file and a series of addresses, and it will locate the closest symbol for each address. To generate a symbol dump file, first run: $ nm -n BINPATH > SYMFILE. Then run the nma2n binary to find out which symbols match to a set of addresses: $ nma2n -f SYMFILE ADDR ... To build nma2n, run `make` and `sudo make install` from the iPhoneTools directory.
Another tool to check out is fill-nmdir.sh, a shell script that extracts the set of nm dump files from relevant iPhone dynamic libraries. This script uses the auxiliary script frmk-nmexport.sh, which should be in the same directory as fill-nmdir.sh. To use this tool, create a directory within your home directory and populate it using fill-nmdir.sh. This will create a number of .nmdump files within the current directory. Also, remember to drop your latest build of your application in this directory and run $ nm -n $BINPATH/$APP.app > ~/nmdumps/$APP.nmdump. Failure to update this file will result in incorrect symbol detection for symbols inside your application.
Finally, the package also includes some utility tools. You can use crash-demangle.pl to demangle the cryptic iPhone crash dump files generated inside the /var/logs/CrashReporter directory. Once you have correctly installed iPhoneTools, you can get the demangled version of a CRASH.plist file extracted from the iPhone by issuing $ cat CRASH.plist | $IPTDIR/crash-demangle.pl -D ~/nmdumps. You can also use memdmp-demangle.pl, which is for the TraceAlloc library what crash-demangle.pl is for the iPhone crashdump generator. This Perl script translates numeric addresses to function names.
Another tool is nma2n, which can be used with any symbol dump file generated by the nm utility. Simply provide nma2n with the symbol dump file and a series of addresses, and it will locate the closest symbol for each address. To generate a symbol dump file, first run: $ nm -n BINPATH > SYMFILE. Then run the nma2n binary to find out which symbols match to a set of addresses: $ nma2n -f SYMFILE ADDR ... To build nma2n, run `make` and `sudo make install` from the iPhoneTools directory.
Another tool to check out is fill-nmdir.sh, a shell script that extracts the set of nm dump files from relevant iPhone dynamic libraries. This script uses the auxiliary script frmk-nmexport.sh, which should be in the same directory as fill-nmdir.sh. To use this tool, create a directory within your home directory and populate it using fill-nmdir.sh. This will create a number of .nmdump files within the current directory. Also, remember to drop your latest build of your application in this directory and run $ nm -n $BINPATH/$APP.app > ~/nmdumps/$APP.nmdump. Failure to update this file will result in incorrect symbol detection for symbols inside your application.
Finally, the package also includes some utility tools. You can use crash-demangle.pl to demangle the cryptic iPhone crash dump files generated inside the /var/logs/CrashReporter directory. Once you have correctly installed iPhoneTools, you can get the demangled version of a CRASH.plist file extracted from the iPhone by issuing $ cat CRASH.plist | $IPTDIR/crash-demangle.pl -D ~/nmdumps. You can also use memdmp-demangle.pl, which is for the TraceAlloc library what crash-demangle.pl is for the iPhone crashdump generator. This Perl script translates numeric addresses to function names.
What's New
Version 0.2: N/A