move win32 crash handler and versioning helpers into archutils
This commit is contained in:
Glenn Maynard
@@ -62,8 +62,8 @@ IntDir=.\../Debug6
|
||||
TargetDir=\temp\stepmania\Program
|
||||
TargetName=StepMania-debug
|
||||
SOURCE="$(InputPath)"
|
||||
PreLink_Cmds=disasm\verinc cl /Zl /nologo /c verstub.cpp /Fo$(IntDir)\
|
||||
PostBuild_Cmds=disasm\mapconv $(IntDir)\$(TargetName).map $(TargetDir)\StepMania.vdi
|
||||
PreLink_Cmds=archutils\Win32\verinc cl /Zl /nologo /c verstub.cpp /Fo$(IntDir)\
|
||||
PostBuild_Cmds=archutils\Win32\mapconv $(IntDir)\$(TargetName).map $(TargetDir)\StepMania.vdi
|
||||
# End Special Build Tool
|
||||
|
||||
!ELSEIF "$(CFG)" == "StepMania - Win32 Release"
|
||||
@@ -99,7 +99,7 @@ IntDir=.\../Release6
|
||||
TargetDir=\temp\stepmania\Program
|
||||
TargetName=StepMania
|
||||
SOURCE="$(InputPath)"
|
||||
PreLink_Cmds=disasm\verinc cl /Zl /nologo /c verstub.cpp /Fo$(IntDir)\
|
||||
PreLink_Cmds=disasm\verinc cl /Zl /nologo /c verstub.cpp /Fo$(IntDir)\
|
||||
PostBuild_Cmds=disasm\mapconv $(IntDir)\$(TargetName).map $(TargetDir)\StepMania.vdi
|
||||
# End Special Build Tool
|
||||
|
||||
|
||||
@@ -141,10 +141,10 @@ cl /Zl /nologo /c verstub.cpp /Fo"$(IntDir)"\
|
||||
TypeLibraryName=".\../StepMania.tlb"/>
|
||||
<Tool
|
||||
Name="VCPostBuildEventTool"
|
||||
CommandLine="disasm\mapconv "$(IntDir)\$(TargetName).map" "$(TargetDir)\StepMania.vdi""/>
|
||||
CommandLine="archutils\Win32\mapconv "$(IntDir)\$(TargetName).map" "$(TargetDir)\StepMania.vdi""/>
|
||||
<Tool
|
||||
Name="VCPreBuildEventTool"
|
||||
CommandLine="disasm\verinc
|
||||
CommandLine="archutils\Win32\verinc
|
||||
cl /Zl /nologo /c verstub.cpp /Fo"$(IntDir)"\
|
||||
"/>
|
||||
<Tool
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@@ -1,112 +0,0 @@
|
||||
This stuff is all built manually; just do "nmake foo.exe" for each binary.
|
||||
It's not worth making a project for each since that'll just triple the number
|
||||
of files, and they probably won't be updated much, and since they're prereqs
|
||||
for building the main project, it's not worth the hassle of VC dependencies.
|
||||
(I'll check in binaries for the actual utils, since they're tiny.) I've modified
|
||||
verinc to output C++ instead of assembly, so we don't introduce asm deps, and
|
||||
removed most output, since it's too noisy.
|
||||
- glenn
|
||||
|
||||
mapconv - symbolic debugging info generator for VirtualDub
|
||||
Copyright (C) 1998-2002 Avery Lee, All Rights Reserved
|
||||
|
||||
disasm - Disassembly module compiler for VirtualDub
|
||||
Copyright (C) 2002 Avery Lee, All Rights Reserved
|
||||
|
||||
These programs are free software; you can redistribute them and/or modify
|
||||
then under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
These programs are distributed in the hope that they will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||||
|
||||
|
||||
verinc is public domain since it's too short and simple to bother -- but
|
||||
you still get no warranty with it.
|
||||
|
||||
|
||||
|
||||
=============================================================================
|
||||
Verinc
|
||||
=============================================================================
|
||||
Verinc takes version.bin, which holds a single four-byte binary build number,
|
||||
increments it, generates an .asm file with the current build number and date,
|
||||
and then exits. That's it.
|
||||
|
||||
=============================================================================
|
||||
Mapconv
|
||||
=============================================================================
|
||||
When VirtualDub crashes, it takes a snapshot of the current stack and code
|
||||
around EIP, and produces a crash dump that I can use to diagnose the cause
|
||||
of the failure. Part of this process is producing a disassembly. IA-32
|
||||
(x86) is non-trivial to parse, and the current version of VirtualDub
|
||||
(1.4.10) requires both a table to drive the disassembler and a list of
|
||||
symbols to guide the disassembly and call stack generation.
|
||||
|
||||
Mapconv produces the symbolic debugging tables. It accepts a map file from
|
||||
the Visual C++ linker and produces a .vdi file with a segment list and
|
||||
a table for translating relative virtual addresses (RVAs) to symbols. It
|
||||
also prepends a disassembler table to the beginning of the file (see below).
|
||||
At runtime, VirtualDub uses the segment list to determine which entries on
|
||||
the stack are likely valid return addresses, and then consults the symbol
|
||||
table to translate the addresses to symbols.
|
||||
|
||||
Run mapconv as follows:
|
||||
mapconv virtualdub.map virtualdub.vdi ia32.bin
|
||||
|
||||
=============================================================================
|
||||
Disasm
|
||||
=============================================================================
|
||||
Disasm produces the table that drives the 1.4.10+ disassembler.
|
||||
|
||||
The table itself is a list of rules, which are sequentially applied against
|
||||
the code bytes. When one matches, the rule's result string is expanded to
|
||||
produce the disassembly for that instruction. Rules may embed other sets
|
||||
of rules as part of their pattern; this functionality avoids having to
|
||||
replicate rules for the mod-reg-mem (modrm) and scale-index-base (sib) bytes.
|
||||
Full documentation for the pattern matching and result languages is included
|
||||
in the ia32.txt file.
|
||||
|
||||
There are two ways you can run disasm:
|
||||
disasm
|
||||
disasm <source.txt> <dst.bin>
|
||||
|
||||
In the first case, the source is assumed to be 'ia32.txt' and the destination
|
||||
'ia32.bin'. Disasm will read the source file and attempt to compile it. If
|
||||
the compilation fails, an error will be printed. Otherwise, disasm will write
|
||||
out the compiled module, and then attempt to test the module against some of
|
||||
its own code. If you have trouble compiling disasm, it may be due to
|
||||
P4/Athlon instructions in test1(); you can safely delete the offending
|
||||
instructions from this function as it is never executed.
|
||||
|
||||
Once the disassembler module (ia32.bin) is produced, you can do two things
|
||||
with it. The usual use is to feed it as input to the 1.1 version of mapconv
|
||||
to fold it into the VirtualDub.vdi file, but you can also copy the ia32.bin
|
||||
file to the VirtualDub directory as ia32.vdi. VirtualDub looks for this
|
||||
file on a crash and will use the disassembler table in it before using the
|
||||
table in VirtualDub.vdi; this allows the table to be updated without having
|
||||
to recompile the debug module. You can also rename the .vdi file from a
|
||||
newer version of VirtualDub to ia32.vdi to use it on an older version,
|
||||
provided that the table format in the newer file is not incompatible.
|
||||
|
||||
VirtualDub has a special command-line option to test the disassembler:
|
||||
virtualdub /fsck
|
||||
|
||||
This will execute a rather strange instruction and manually trigger the
|
||||
crash dialog. Note that the disassembler in disasm.exe is slightly older
|
||||
than the module in 1.4.10 -- the 1.4.10 disassembler fixes a couple of
|
||||
cosmetic bugs (most notably symbol lookup syntax). The table formats are
|
||||
the same, however.
|
||||
|
||||
If you have any questions or comments, I'd like to hear them. Let me know
|
||||
if any instructions are missing or decoded incorrectly.
|
||||
|
||||
-- Avery Lee <phaeron@virtualdub.org>
|
||||
April 10, 2002
|
||||
Reference in New Issue
Block a user