gatos

README

gatos

gatos is an atos-like tool for Mach-O/DWARF address symbolification.

It is distributed under the BSD licence.

Usage

gatos --raddr=xxx --laddr=xxxx --macho=xxx --dsym=xxx

Example

Thread 0 Crashed:
0   AppName                  0x000043cc 0x1000 + 13260
                             ^          ^
               runtime address          load address
1   CoreFoundation           0x37d7342e 0x37d60000 + 78894
2   UIKit                    0x351ec9e4 0x351ce000 + 125412
3   UIKit                    0x351ec9a0 0x351ce000 + 125344
 
$ gatos --raddr=0x000043cc --laddr=0x1000 --macho=appname --dsym=appname.dsym
-[CPrefsViewController pickImage:] (CPrefsViewController.mm:332)

Notes

• Input files are found inside app/.dSYM bundles.
• Does not support fat binaries; lipo -thin the app/dsym before processing.
• Does not support DWARF line table; line numbers are to the function, not address.

Documentation

Overview

NAME:
	gatos.go

DESCRIPTION:
	Mach-O/dwarf symbol lookup.

COPYRIGHT:
	Copyright (c) 2006-2019, refNum Software
	All rights reserved.

	Redistribution and use in source and binary forms, with or without
	modification, are permitted provided that the following conditions
	are met:

	1. Redistributions of source code must retain the above copyright
	notice, this list of conditions and the following disclaimer.

	2. Redistributions in binary form must reproduce the above copyright
	notice, this list of conditions and the following disclaimer in the
	documentation and/or other materials provided with the distribution.

	3. Neither the name of the copyright holder nor the names of its
	contributors may be used to endorse or promote products derived from
	this software without specific prior written permission.

	THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
	"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
	LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
	A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
	HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
	SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
	LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
	DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
	THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
	(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
	OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
___________________________________________________________________________

============================================================================

Imports

----------------------------------------------------------------------------