[mono-symbolicate] Added tool man page and script.

diff --git a/man/Makefile.am b/man/Makefile.am
index 0610c017729fcafd2c99e4adf214e0521bd91fab..de2b6ac7c3ff22a480831f8a10292f0846749835 100644 (file)
--- a/man/Makefile.am
+++ b/man/Makefile.am
@@ -56,6 +56,7 @@ man_MANS = \
        xsd.1                 \
        mono-configuration-crypto.1 \
        ccrewrite.1                     \
-       cccheck.1
+       cccheck.1                       \
+       mono-symbolicate.1
 
 EXTRA_DIST = $(man_MANS)

diff --git a/man/mono-symbolicate.1 b/man/mono-symbolicate.1
new file mode 100644 (file)
index 0000000..e5f8ee5
--- /dev/null
+++ b/man/mono-symbolicate.1
@@ -0,0 +1,39 @@
+.\" 
+.\" mono-symbolicate manual page.
+.\" Copyright 2015 Xamarin
+.\" Author:
+.\"   Marcos Henrich <marcos.henrich@xamarin.com>
+.\"
+.TH "mono-symbolicate" 1
+.SH NAME
+mono-symbolicate \- Mono Symbolicate Tool
+.SH SYNOPSIS
+.PP
+.B mono-symbolicate exefile stacktracesfile [directories...]
+.SH DESCRIPTION
+mono-symbolicate is a tool that converts a stack trace with <filename unknown>:0
+into one with file names and line numbers.
+.PP
+The output of calling this tool will be the provided
+.I stacktracesfile
+where <filename unknown>:0 parts are replaced by
+a file name and a line number.
+.PP
+For the tool to work it needs to load referenced assemblies, it will first look
+in the same folder as
+.I exefile
+then from one of the provided
+.I directories.
+.PP
+The tool assumes that the folder with a referenced assembly called for example
+name.dll will also include name.dll.mdb,
+if the referenced assembly is AOT compiled then the tool is also expecting to find
+name.dll.msym.
+.SH AUTHOR
+Written by Marcos Henrich
+.SH COPYRIGHT
+Copyright (C) 2015 Xamarin.
+.SH MAILING LISTS
+Visit http://lists.ximian.com/mailman/listinfo/mono-devel-list for details.
+.SH WEB SITE
+Visit http://www.mono-project.com for details

diff --git a/scripts/Makefile.am b/scripts/Makefile.am
index 90ee65b7234e6a039063b5aba05a4177904cd8ee..daa0204872fd02cd37ad869315971341156c7487 100644 (file)
--- a/scripts/Makefile.am
+++ b/scripts/Makefile.am
@@ -100,7 +100,8 @@ scripts_4_0 = \
        ccrewrite$(SCRIPT_SUFFIX)               \
        cccheck$(SCRIPT_SUFFIX)                 \
        mdbrebase$(SCRIPT_SUFFIX)               \
-       ikdasm$(SCRIPT_SUFFIX)
+       ikdasm$(SCRIPT_SUFFIX)                  \
+       mono-symbolicate$(SCRIPT_SUFFIX)
 
 MDOC_SUBCOMMANDS = \
        mdoc-assemble \

diff --git a/scripts/mono-symbolicate.in b/scripts/mono-symbolicate.in
new file mode 100644 (file)
index 0000000..4cec564
--- /dev/null
+++ b/scripts/mono-symbolicate.in
@@ -0,0 +1,2 @@
+#!/bin/sh
+exec @bindir@/mono $MONO_OPTIONS @mono_instdir@/4.5/mono-symbolicate.exe "$@"