8 Star 30 Fork 29

橘色的喵 / CrashExporter

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

#CrashExporter

1. CrashExporter是什么?

CrashExporter是基于开源项目crashrpt(https://code.google.com/p/crashrpt/) 基础上改造的、基于Windows平台的轻量级异常导出组件。 原crashrpt 主要将远端的崩溃信息压缩包通过网络发送到本地,而往往我们希望崩溃信息只在本地生成。同时crashrpt 没有生成我们感兴趣的堆栈打印文件。 CrashExportercrashrpt的区别是:CrashExporter只保留了crashrpt的导出dmp和抓屏功能,并增加了堆栈打印功能。

2. 程序崩溃后会生成什么?

当程序崩溃后,会在程序执行的crashrpt目录下,增加一个以崩溃时间命名的文件夹。 文件夹里有三个文件:

  • crashdump.dmp为minidump文件;可以使用windbg工具查看(需要pdb文件一起使用,常用命令.ecxr和!analyze -v),或者直接用vs2010打开。
  • crashinfo.txt为堆栈打印;记录了异常时系统信息和堆栈信息打印,可以定位到代码文件的某一行。
  • screenshot0.png为屏幕截屏文件;抓取崩溃时的屏幕图像。

3. 使用CrashExporter时,工程怎么配置?

主要是release工程的配置。 对于VC6工程:

  • Properties->C/C++->General中的Debug info,选择Program Database;
  • 设置Properties->C/C++->Code Generation中的Use run-time library为Multithreaded DLL;
  • Properties->C/C++->link中勾选上Generate debug info。

对于vs2010工程:

  • 使用多线程DLL(/MD) 设置方法,右击工程,选择属性->C/C++->代码生成,在当前页的“运行库”中选择“多线程 DLL(/MD)”。
  • 设置debugging symbols (PDB文件) 设置方法,右击工程,选择属性->C/C++->常规,在当前页“调试信息格式”中选择“程序数据库(/Zi)”。
  • 打开链接器调试“生成调试信息”功能 设置方法,右击工程,选择属性->链接器->调试,在当前页“生成调试信息”中选择“是(/DEBUG)”。

4. MFC 程序中如何使用CashExporter?

你可以重写CWinApp::Run(),在Run函数里安装CrashExporter。代码类似如下:

int CYourApp::Run() 
{
  // Call your crInstall code here ...
  BOOL bRun;
  BOOL bExit=FALSE;
  while(!bExit)
  {
    bRun= CWinApp::Run();
    bExit=TRUE;
  }
  return bRun;
}

5. 如何在多线程程序中使用?

一般直接调用CrInstall即可获取所有线程异常信息。你也可以在每个线程的起始调用crInstallToCurrentThread来分别获取线程的异常信息,但是别忘记在线程退出是调用crUninstallFromCurrentThread。

6. 程序僵死了,这种情况怎么处理?

这时候可以通过crGenerateErrorReport接口手动获取异常信息。

7. CrashExporter支持程序自动重启么?

支持。 程序重启需要两个条件:

  • 程序运行需要超过1分钟。
  • 需要设置了CR_INSTALL_INFO中dwFlags|CR_INST_APP_RESTART。

8. 当程序发布时,我需要打包进哪些东西?

你至少需要打包进三个东西:

  • CrashRpt.dll
  • CrashExporter.exe
  • dbghelp.dll 另外,你也必须确保客户机器安装了vs2010运行库。没有的话,可以让客户安装vs2010运行库,或者打包msvcp100.dll和msvcr100.dll。

9. 我的程序是一个DLL,这种情况下怎么使用CrashExporter?

你可以在DLL程序初始化之前加载CrashExporter,比如DllMain()。 但是,调用DLL的主程序也可能加载了CrashExporter,这样情况下会屏蔽掉主线程的崩溃信息获取。这种冲突,就需要人为控制了,建议是在主程序中加载CrashExporter。

10. 使用CrashExporter会不会影响我程序的性能?

不会!因为CrashExporter不会在后台执行任何任务,也不会占用多余的内存。CrashExporter仅仅会在程序崩溃的时候被调用。但是,CrashExporter会延长异常程序退出时间,因为CrashExporter需要加载symbols,分析堆栈,写dmp和调用堆栈文件。

11. CrashExporter可以获取所有的异常吗?

可以获取大多数常见的异常。 因为安全原因,微软是不允许我们拦截某些异常的。 还有一种情况: CPoint* pt = new CPoint; delete pt; delete pt; 这种是因为堆损坏引起的,这种情况有时候会导致程序立即崩溃,有时候却是可以继续工作。对于这种随机的异常,CrashExporter是不能获取的。 因此,我们建议删除指针内存时,采用这样类似宏。 #define SAFE_DELETE(ptr) { delete(ptr); (ptr)=NULL; }

12. 我仔细检查了一切配置都是正确的,但是仍然不能获取到异常信息,这是为什么?

一个可能的原因是你异常的程序连给CrashExporter分配资源的机会都没给,比如你程序中有一个循环递归。

13. 有没有异常信息指向CrashExporter本身出错的情况?比如跟踪异常堆栈跟踪到Crashrpt.dll。

有的。 当异常产生时,Crashrpt.dll需要检查异常指针的结构,这个指针结构一般由操作系统分配。但是,有时候这个指针结构会不存在(比如无效的参数),这时候Crashrpt.dll会根据当前CPU寄存器状态分配指针结构。这种情况下,你会在异常堆栈中跟踪到Crashrpt.dll了。

14. 简述CrashExporter原理?

CrashExporter由两个core组成。分别为CrashRpt.dll 和 CrashExporter.exe。

CrashRpt.dll负责获取程序的异常信息并保存至共享内存;CrashExporter.exe负责从共享内存中获取异常信息,写dmp和堆栈调用文件、生成屏幕截屏。 这样做的目的是把容易出错的写文件等操作分离到CrashExporter.exe中,主程序只会加载CrashRpt.dll到其地址空间,这样减少了主程序因为CrashExporter出现异常的可能性。

CrashRpt.dll 和 CrashExporter.exe使用共享内存传递数据。

15. 应该用什么类型的minidump?

建议用MiniDumpNormal,因为MiniDumpNormal包含了我们感兴趣的每个线程堆栈信息。

16. 哪些情况都会导致异常?

程序访问了一块非法的内存地址(比如NULL指针).
在无限递归中,栈溢出.
大块数据被写入一片小缓冲区
C++类中的纯虚函数被调用
内存无法分配(内存不足)
向C++的系统函数中传入非法的参数
C运行库遇到错误,需要停止程序运行
主要有两种类型的异常:SEH异常(结构化异常处理)和标准C++异常

空文件

简介

基于crashrpt修改的Windows平台C++崩溃信息打印组件,可打印堆栈 展开 收起
C++ 等 3 种语言
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
C++
1
https://gitee.com/liudegui/CrashExporter.git
git@gitee.com:liudegui/CrashExporter.git
liudegui
CrashExporter
CrashExporter
master

搜索帮助

14c37bed 8189591 565d56ea 8189591