isabella232 / windows-crash-report-cpp

Automatically grabs newly occurred Windows crash logs and sends the version/offset to an external online database for you to review

Windows-Crash-Report-Cpp

This C++11 library automatically grabs newly occurred Windows crash logs and sends the version/offset to an external online database for you to review.

When a crash occurs on the user side, it is crucial for you to know the crash offset value in order to find the bug and provide support.

There are several ways of achieving this. For instance, the user can click on the crash windows details button and copy the offset value for you.

In the case where the user closes the crash window, it is still possible to grab the crash log. The standard procedure is for the user to open the "Event Viewer" (Windows+R > eventvwr), look for the specific log in the list, open it and copy the offset value for you.

These two approaches involve manual control and are annoying for both users and developers.

Our alternative approach consists of performing the crash lookup automatically and will save the crash report on your server. You'll need a server with SQL support.

1. Create a sql table:

2. Upload the PHP script on your server.

3. Use the evlog lib (in the lib folder) and adapt your PHP script accordingly:

od::Http::callUrl("http://mysite.com/crash_report.php?version=" + std::to_string(err.version.value()) + "&error=" + std::to_string(err.offset), 3000);

All that's left for you is to look up the received crash offset value and find the origin of the bug in your application. To achieve this, using gcc, you can generate a .map file containing all functions/methods offsets: -Wl,-Map,file.map

It is good practice to generate map files for each of your releases.

MIT Licence

Copyright (c) 2015 Marmontel Boris

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.