OpenTTD Source  20241121-master-g67a0fccfad
crashlog.cpp
Go to the documentation of this file.
1 /*
2  * This file is part of OpenTTD.
3  * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
4  * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
5  * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
6  */
7 
10 #include "stdafx.h"
11 #include "crashlog.h"
12 #include "survey.h"
13 #include "gamelog.h"
14 #include "map_func.h"
15 #include "music/music_driver.hpp"
16 #include "sound/sound_driver.hpp"
17 #include "video/video_driver.hpp"
18 #include "saveload/saveload.h"
19 #include "screenshot.h"
20 #include "network/network_survey.h"
21 #include "news_gui.h"
22 #include "fileio_func.h"
23 #include "fileio_type.h"
24 
25 #include "company_func.h"
26 #include "3rdparty/fmt/chrono.h"
27 #include "3rdparty/fmt/std.h"
28 #include "core/format.hpp"
29 
30 #include "safeguards.h"
31 
32 /* static */ std::string CrashLog::message{};
33 
35 constexpr uint8_t CRASHLOG_SURVEY_VERSION = 1;
36 
41 static void SurveyGamelog(nlohmann::json &json)
42 {
43  json = nlohmann::json::array();
44 
45  _gamelog.Print([&json](const std::string &s) {
46  json.push_back(s);
47  });
48 }
49 
54 static void SurveyRecentNews(nlohmann::json &json)
55 {
56  json = nlohmann::json::array();
57 
58  int i = 0;
59  for (const auto &news : GetNews()) {
60  TimerGameCalendar::YearMonthDay ymd = TimerGameCalendar::ConvertDateToYMD(news.date);
61  json.push_back(fmt::format("({}-{:02}-{:02}) StringID: {}, Type: {}, Ref1: {}, {}, Ref2: {}, {}",
62  ymd.year, ymd.month + 1, ymd.day, news.string_id, news.type,
63  news.reftype1, news.ref1, news.reftype2, news.ref2));
64  if (++i > 32) break;
65  }
66 }
67 
74 std::string CrashLog::CreateFileName(const char *ext, bool with_dir) const
75 {
76  static std::string crashname;
77 
78  if (crashname.empty()) {
79  crashname = fmt::format("crash{:%Y%m%d%H%M%S}", fmt::gmtime(time(nullptr)));
80  }
81  return fmt::format("{}{}{}", with_dir ? _personal_dir : std::string{}, crashname, ext);
82 }
83 
88 {
89  /* Reminder: this JSON is read in an automated fashion.
90  * If any structural changes are applied, please bump the version. */
91  this->survey["schema"] = CRASHLOG_SURVEY_VERSION;
92  this->survey["date"] = fmt::format("{:%Y-%m-%d %H:%M:%S} (UTC)", fmt::gmtime(time(nullptr)));
93 
94  /* If no internal reason was logged, it must be a crash. */
95  if (CrashLog::message.empty()) {
96  this->SurveyCrash(this->survey["crash"]);
97  } else {
98  this->survey["crash"]["reason"] = CrashLog::message;
99  CrashLog::message.clear();
100  }
101 
102  if (!this->TryExecute("stacktrace", [this]() { this->SurveyStacktrace(this->survey["stacktrace"]); return true; })) {
103  this->survey["stacktrace"] = "crashed while gathering information";
104  }
105 
106  if (!this->TryExecute("session", [this]() { SurveyGameSession(this->survey["session"]); return true; })) {
107  this->survey["session"] = "crashed while gathering information";
108  }
109 
110  {
111  auto &info = this->survey["info"];
112  if (!this->TryExecute("os", [&info]() { SurveyOS(info["os"]); return true; })) {
113  info["os"] = "crashed while gathering information";
114  }
115  if (!this->TryExecute("openttd", [&info]() { SurveyOpenTTD(info["openttd"]); return true; })) {
116  info["openttd"] = "crashed while gathering information";
117  }
118  if (!this->TryExecute("configuration", [&info]() { SurveyConfiguration(info["configuration"]); return true; })) {
119  info["configuration"] = "crashed while gathering information";
120  }
121  if (!this->TryExecute("font", [&info]() { SurveyFont(info["font"]); return true; })) {
122  info["font"] = "crashed while gathering information";
123  }
124  if (!this->TryExecute("compiler", [&info]() { SurveyCompiler(info["compiler"]); return true; })) {
125  info["compiler"] = "crashed while gathering information";
126  }
127  if (!this->TryExecute("libraries", [&info]() { SurveyLibraries(info["libraries"]); return true; })) {
128  info["libraries"] = "crashed while gathering information";
129  }
130  if (!this->TryExecute("plugins", [&info]() { SurveyPlugins(info["plugins"]); return true; })) {
131  info["plugins"] = "crashed while gathering information";
132  }
133  }
134 
135  {
136  auto &game = this->survey["game"];
137  game["local_company"] = _local_company;
138  game["current_company"] = _current_company;
139 
140  if (!this->TryExecute("timers", [&game]() { SurveyTimers(game["timers"]); return true; })) {
141  game["libraries"] = "crashed while gathering information";
142  }
143  if (!this->TryExecute("companies", [&game]() { SurveyCompanies(game["companies"]); return true; })) {
144  game["companies"] = "crashed while gathering information";
145  }
146  if (!this->TryExecute("settings", [&game]() { SurveySettings(game["settings_changed"], true); return true; })) {
147  game["settings"] = "crashed while gathering information";
148  }
149  if (!this->TryExecute("grfs", [&game]() { SurveyGrfs(game["grfs"]); return true; })) {
150  game["grfs"] = "crashed while gathering information";
151  }
152  if (!this->TryExecute("game_script", [&game]() { SurveyGameScript(game["game_script"]); return true; })) {
153  game["game_script"] = "crashed while gathering information";
154  }
155  if (!this->TryExecute("gamelog", [&game]() { SurveyGamelog(game["gamelog"]); return true; })) {
156  game["gamelog"] = "crashed while gathering information";
157  }
158  if (!this->TryExecute("news", [&game]() { SurveyRecentNews(game["news"]); return true; })) {
159  game["news"] = "crashed while gathering information";
160  }
161  }
162 }
163 
164 void CrashLog::PrintCrashLog() const
165 {
166  fmt::print(" OpenTTD version:\n");
167  fmt::print(" Version: {}\n", this->survey["info"]["openttd"]["version"]["revision"].get<std::string>());
168  fmt::print(" Hash: {}\n", this->survey["info"]["openttd"]["version"]["hash"].get<std::string>());
169  fmt::print(" NewGRF ver: {}\n", this->survey["info"]["openttd"]["version"]["newgrf"].get<std::string>());
170  fmt::print(" Content ver: {}\n", this->survey["info"]["openttd"]["version"]["content"].get<std::string>());
171  fmt::print("\n");
172 
173  fmt::print(" Crash:\n");
174  fmt::print(" Reason: {}\n", this->survey["crash"]["reason"].get<std::string>());
175  fmt::print("\n");
176 
177  fmt::print(" Stacktrace:\n");
178  for (const auto &line : this->survey["stacktrace"]) {
179  fmt::print(" {}\n", line.get<std::string>());
180  }
181  fmt::print("\n");
182 }
183 
190 {
191  this->crashlog_filename = this->CreateFileName(".json.log");
192 
193  auto file = FioFOpenFile(this->crashlog_filename, "w", NO_DIRECTORY);
194  if (!file.has_value()) return false;
195 
196  std::string survey_json = this->survey.dump(4);
197 
198  size_t len = survey_json.size();
199  size_t written = fwrite(survey_json.data(), 1, len, *file);
200 
201  return len == written;
202 }
203 
210 /* virtual */ bool CrashLog::WriteCrashDump()
211 {
212  fmt::print("No method to create a crash.dmp available.\n");
213  return false;
214 }
215 
222 {
223  /* If the map doesn't exist, saving will fail too. If the map got
224  * initialised, there is a big chance the rest is initialised too. */
225  if (!Map::IsInitialized()) return false;
226 
227  try {
229 
230  this->savegame_filename = this->CreateFileName(".sav");
231 
232  /* Don't do a threaded saveload. */
233  return SaveOrLoad(this->savegame_filename, SLO_SAVE, DFT_GAME_FILE, NO_DIRECTORY, false) == SL_OK;
234  } catch (...) {
235  return false;
236  }
237 }
238 
245 {
246  /* Don't draw when we have invalid screen size */
247  if (_screen.width < 1 || _screen.height < 1 || _screen.dst_ptr == nullptr) return false;
248 
249  std::string filename = this->CreateFileName("", false);
250  bool res = MakeScreenshot(SC_CRASHLOG, filename);
251  if (res) this->screenshot_filename = _full_screenshot_path;
252  return res;
253 }
254 
259 {
260  if (_game_mode == GM_NORMAL) {
262  }
263 }
264 
271 {
272  /* Don't keep looping logging crashes. */
273  static bool crashlogged = false;
274  if (crashlogged) return;
275  crashlogged = true;
276 
277  fmt::print("Crash encountered, generating crash log...\n");
278  this->FillCrashLog();
279  fmt::print("Crash log generated.\n\n");
280 
281  fmt::print("Crash in summary:\n");
282  this->TryExecute("crashlog", [this]() { this->PrintCrashLog(); return true; });
283 
284  fmt::print("Writing crash log to disk...\n");
285  bool ret = this->TryExecute("crashlog", [this]() { return this->WriteCrashLog(); });
286  if (ret) {
287  fmt::print("Crash log written to {}. Please add this file to any bug reports.\n\n", this->crashlog_filename);
288  } else {
289  fmt::print("Writing crash log failed. Please attach the output above to any bug reports.\n\n");
290  this->crashlog_filename = "(failed to write crash log)";
291  }
292 
293  fmt::print("Writing crash dump to disk...\n");
294  ret = this->TryExecute("crashdump", [this]() { return this->WriteCrashDump(); });
295  if (ret) {
296  fmt::print("Crash dump written to {}. Please add this file to any bug reports.\n\n", this->crashdump_filename);
297  } else {
298  fmt::print("Writing crash dump failed.\n\n");
299  this->crashdump_filename = "(failed to write crash dump)";
300  }
301 
302  fmt::print("Writing crash savegame...\n");
303  ret = this->TryExecute("savegame", [this]() { return this->WriteSavegame(); });
304  if (ret) {
305  fmt::print("Crash savegame written to {}. Please add this file and the last (auto)save to any bug reports.\n\n", this->savegame_filename);
306  } else {
307  fmt::print("Writing crash savegame failed. Please attach the last (auto)save to any bug reports.\n\n");
308  this->savegame_filename = "(failed to write crash savegame)";
309  }
310 
311  fmt::print("Writing crash screenshot...\n");
312  ret = this->TryExecute("screenshot", [this]() { return this->WriteScreenshot(); });
313  if (ret) {
314  fmt::print("Crash screenshot written to {}. Please add this file to any bug reports.\n\n", this->screenshot_filename);
315  } else {
316  fmt::print("Writing crash screenshot failed.\n\n");
317  this->screenshot_filename = "(failed to write crash screenshot)";
318  }
319 
320  this->TryExecute("survey", [this]() { this->SendSurvey(); return true; });
321 }
322 
327 /* static */ void CrashLog::SetErrorMessage(const std::string &message)
328 {
330 }
331 
337 {
341 }
void MakeCrashLog()
Makes the crash log, writes it to a file and then subsequently tries to make a crash dump and crash s...
Definition: crashlog.cpp:270
bool WriteCrashLog()
Write the crash log to a file.
Definition: crashlog.cpp:189
virtual void SurveyStacktrace(nlohmann::json &survey) const =0
Convert stacktrace to JSON.
std::string CreateFileName(const char *ext, bool with_dir=true) const
Create a timestamped filename.
Definition: crashlog.cpp:74
static std::string message
Error message coming from #FatalError(format, ...).
Definition: crashlog.h:21
void SendSurvey() const
Send the survey result, noting it was a crash.
Definition: crashlog.cpp:258
virtual bool TryExecute(std::string_view section_name, std::function< bool()> &&func)=0
Execute the func() and return its value.
virtual bool WriteCrashDump()
Write the (crash) dump to a file.
Definition: crashlog.cpp:210
bool WriteSavegame()
Write the (crash) savegame to a file.
Definition: crashlog.cpp:221
bool WriteScreenshot()
Write the (crash) screenshot to a file.
Definition: crashlog.cpp:244
void FillCrashLog()
Fill the crash log buffer with all data of a crash log.
Definition: crashlog.cpp:87
static void SetErrorMessage(const std::string &message)
Sets a message for the error message handler.
Definition: crashlog.cpp:327
virtual void SurveyCrash(nlohmann::json &survey) const =0
Convert system crash reason to JSON.
static void AfterCrashLogCleanup()
Try to close the sound/video stuff so it doesn't keep lingering around incorrect video states or so,...
Definition: crashlog.cpp:336
virtual void Stop()=0
Stop this driver.
void Emergency()
Logs a emergency savegame.
Definition: gamelog.cpp:352
void Print(std::function< void(const std::string &)> proc)
Prints active gamelog.
Definition: gamelog.cpp:147
static MusicDriver * GetInstance()
Get the currently active instance of the music driver.
void Transmit(Reason reason, bool blocking=false)
Transmit the survey.
static SoundDriver * GetInstance()
Get the currently active instance of the sound driver.
static YearMonthDay ConvertDateToYMD(Date date)
Converts a Date to a Year, Month & Day.
static VideoDriver * GetInstance()
Get the currently active instance of the video driver.
CompanyID _local_company
Company controlled by the human player at this client. Can also be COMPANY_SPECTATOR.
Definition: company_cmd.cpp:52
CompanyID _current_company
Company currently doing an action.
Definition: company_cmd.cpp:53
Functions related to companies.
static void SurveyRecentNews(nlohmann::json &json)
Writes up to 32 recent news messages to the buffer, with the most recent first.
Definition: crashlog.cpp:54
constexpr uint8_t CRASHLOG_SURVEY_VERSION
The version of the schema of the JSON information.
Definition: crashlog.cpp:35
static void SurveyGamelog(nlohmann::json &json)
Writes the gamelog data to the buffer.
Definition: crashlog.cpp:41
Functions to be called to log a crash.
std::string _personal_dir
custom directory for personal settings, saves, newgrf, etc.
Definition: fileio.cpp:869
std::optional< FileHandle > FioFOpenFile(const std::string &filename, const char *mode, Subdirectory subdir, size_t *filesize)
Opens a OpenTTD file somewhere in a personal or global directory.
Definition: fileio.cpp:242
Functions for Standard In/Out file operations.
Types for Standard In/Out file operations.
@ SLO_SAVE
File is being saved.
Definition: fileio_type.h:56
@ DFT_GAME_FILE
Save game or scenario file.
Definition: fileio_type.h:32
@ NO_DIRECTORY
A path without any base directory.
Definition: fileio_type.h:133
String formatting functions and helpers.
Gamelog _gamelog
Gamelog instance.
Definition: gamelog.cpp:31
Functions to be called to log fundamental changes to the game.
Functions related to maps.
Base for all music playback.
Part of the network protocol handling opt-in survey.
const NewsContainer & GetNews()
Get read-only reference to all news items.
Definition: news_gui.cpp:79
GUI functions related to the news.
A number of safeguards to prevent using unsafe methods.
SaveOrLoadResult SaveOrLoad(const std::string &filename, SaveLoadOperation fop, DetailedFileType dft, Subdirectory sb, bool threaded)
Main Save or Load function where the high-level saveload functions are handled.
Definition: saveload.cpp:3097
Functions/types related to saving and loading games.
@ SL_OK
completed successfully
Definition: saveload.h:402
bool MakeScreenshot(ScreenshotType t, std::string name, uint32_t width, uint32_t height)
Schedule making a screenshot.
Definition: screenshot.cpp:949
std::string _full_screenshot_path
Pathname of the screenshot file.
Definition: screenshot.cpp:42
Functions to make screenshots.
@ SC_CRASHLOG
Raw screenshot from blitter buffer.
Definition: screenshot.h:20
Base for all sound drivers.
Definition of base types and functions in a cross-platform compatible way.
static bool IsInitialized()
Check whether the map has been initialized, as to not try to save the map during crashlog when the ma...
Definition: map_func.h:354
void SurveySettings(nlohmann::json &survey, bool skip_if_default)
Convert settings to JSON.
Definition: survey.cpp:160
void SurveyPlugins(nlohmann::json &survey)
Convert plugin information to JSON.
Definition: survey.cpp:464
void SurveyTimers(nlohmann::json &survey)
Convert timer information to JSON.
Definition: survey.cpp:339
void SurveyGameSession(nlohmann::json &survey)
Convert game session information to JSON.
Definition: survey.cpp:238
void SurveyGameScript(nlohmann::json &survey)
Convert game-script information to JSON.
Definition: survey.cpp:382
void SurveyConfiguration(nlohmann::json &survey)
Convert generic game information to JSON.
Definition: survey.cpp:252
void SurveyOpenTTD(nlohmann::json &survey)
Convert generic OpenTTD information to JSON.
Definition: survey.cpp:206
void SurveyFont(nlohmann::json &survey)
Convert font information to JSON.
Definition: survey.cpp:295
void SurveyCompanies(nlohmann::json &survey)
Convert company information to JSON.
Definition: survey.cpp:308
void SurveyCompiler(nlohmann::json &survey)
Convert compiler information to JSON.
Definition: survey.cpp:178
void SurveyLibraries(nlohmann::json &survey)
Convert compiled libraries information to JSON.
Definition: survey.cpp:394
void SurveyGrfs(nlohmann::json &survey)
Convert GRF information to JSON.
Definition: survey.cpp:355
Functions to survey the current game / system, for crashlog and network-survey.
Base of all video drivers.