1 /*****************************************************************************\
3 * Name : check_version *
4 * Author : Chris Koeritz *
6 *******************************************************************************
7 * Copyright (c) 1996-$now By Author. This program is free software; you can *
8 * redistribute it and/or modify it under the terms of the GNU General Public *
9 * License as published by the Free Software Foundation; either version 2 of *
10 * the License or (at your option) any later version. This is online at: *
11 * http://www.fsf.org/copyleft/gpl.html *
12 * Please send any updates to: fred@gruntose.com *
13 \*****************************************************************************/
15 #include "version_checker.h"
17 #include <application/windoze_helper.h>
18 #include <basis/astring.h>
19 #include <basis/environment.h>
20 #include <basis/functions.h>
21 #include <basis/guards.h>
22 #include <basis/utf_conversion.h>
23 #include <configuration/application_configuration.h>
24 #include <filesystem/filename.h>
25 #include <loggers/critical_events.h>
29 using namespace basis;
30 using namespace configuration;
31 using namespace loggers;
32 using namespace structures;
34 #ifndef BOOT_STRAPPING
35 // pull in the version specified for this build.
36 ///hmmm: on hold! #include <__build_version.h>
38 // plug in a fake version for our bootstrapping process.
39 #define __build_FILE_VERSION "108.420.1024.10008"
49 // ensures that we handle the data properly regardless of unicode settings.
51 #define render_ptr(ptr) from_unicode_temp( (UTF16 *) ptr)
53 #define render_ptr(ptr) ( (char *) ptr)
61 version_checker::version_checker(const astring &library_file_name,
62 const version &expected_version, const astring &version_complaint)
63 : _library_file_name(new astring(library_file_name)),
64 _expected_version(new version(expected_version)),
65 _version_complaint(new astring(version_complaint))
68 version_checker::~version_checker()
70 WHACK(_library_file_name);
71 WHACK(_expected_version);
72 WHACK(_version_complaint);
75 astring version_checker::text_form() const
77 return astring(class_name()) + ": library_file_name=" + *_library_file_name
78 + ", expected_version=" + _expected_version->text_form()
79 + ", complaint_message=" + *_version_complaint;
82 bool version_checker::good_version() const
84 astring version_disabler = environment::TMP();
85 version_disabler += "/no_version_check.txt";
86 FILE *always_okay = fopen(version_disabler.s(), "r");
92 version version_found = retrieve_version(*_library_file_name);
93 if (version_found.compatible(*_expected_version)) return true; // success.
94 complain_wrong_version(*_library_file_name, *_expected_version,
99 bool version_checker::loaded(const astring &library_file_name)
102 #if defined(_MSC_VER)
103 return bool(get_handle(library_file_name) != 0);
106 return true || library_file_name.t();
110 void *version_checker::get_handle(const astring &library_file_name)
113 #if defined(_MSC_VER)
114 return GetModuleHandle(to_unicode_temp(library_file_name));
116 if (library_file_name.t()) return NULL_POINTER; else return NULL_POINTER;
120 astring version_checker::module_name(const void *module_handle)
122 #if defined(__UNIX__) || defined(__GNU_WINDOWS__)
123 if (module_handle) {}
124 return application_configuration::application_name();
125 #elif defined(_MSC_VER)
126 //#elif defined(__WIN32__)
127 flexichar low_buff[MAX_ABS_PATH + 1];
128 GetModuleFileName((HMODULE)module_handle, low_buff, MAX_ABS_PATH - 1);
129 astring buff = from_unicode_temp(low_buff);
133 #pragma message("module_name unknown for this operating system.")
134 return application_configuration::application_name();
138 astring version_checker::get_name(const void *to_find)
139 { return module_name(to_find); }
141 bool version_checker::retrieve_version_info(const astring &filename,
144 to_fill.reset(); // clear the buffer.
146 // determine the required size of the version info buffer.
148 #if defined(_MSC_VER)
150 un_long module_handle; // filled with the dll or exe handle.
151 required_size = GetFileVersionInfoSize(to_unicode_temp(filename), &module_handle);
153 required_size = 0 && filename.t();
155 if (!required_size) return false;
156 to_fill.reset(required_size); // resize the buffer.
158 // read the version info into our buffer.
159 bool success = false;
160 #if defined(_MSC_VER)
162 success = GetFileVersionInfo(to_unicode_temp(filename), module_handle,
163 required_size, to_fill.access());
170 bool version_checker::get_language(byte_array &version_chunk,
171 basis::un_short &high, basis::un_short &low)
175 #if defined(_MSC_VER)
177 // determine the language that the version's written in.
178 basis::un_int data_size;
179 void *pointer_to_language_structure;
180 // query the information from the version blob.
181 if (!VerQueryValue(version_chunk.access(),
182 to_unicode_temp("\\VarFileInfo\\Translation"),
183 &pointer_to_language_structure, &data_size))
185 // get the low & high shorts of the structure.
186 high = LOWORD(*(unsigned int *)pointer_to_language_structure);
187 low = HIWORD(*(unsigned int *)pointer_to_language_structure);
189 high = 0 && version_chunk.length();
196 version version_checker::retrieve_version(const astring &filename)
199 #if defined(__UNIX__) || defined(__GNU_WINDOWS__)
201 // totally bogus stand-in; this just returns the version we were built with
202 // rather than the version that's actually tagged on the file.
204 //hmmm: fix this! get the version header back.
205 // return version(__build_FILE_VERSION);
210 byte_array version_info_found(0, NULL_POINTER);
211 if (!retrieve_version_info(filename, version_info_found))
212 return version(0, 0, 0, 0);
214 basis::un_short high, low; // holds the language of the version data.
215 if (!get_language(version_info_found, high, low))
216 return version(0, 0, 0, 0);
218 // retrieve the file version from version info using the appropriate
220 astring root_key(astring::SPRINTF, "\\StringFileInfo\\%04x%04x", high, low);
221 astring file_version_key(root_key + astring("\\FileVersion"));
223 astring version_string;
225 abyte *file_version_pointer;
226 basis::un_int data_size;
227 if (!VerQueryValue(version_info_found.access(),
228 to_unicode_temp(file_version_key),
229 (LPVOID *)&file_version_pointer, &data_size))
230 return version(0, 0, 0, 0);
231 version_string = render_ptr(file_version_pointer);
232 // clean any spaces out of the string; people sometimes format these
234 for (int i = 0; i < version_string.length(); i++) {
235 if (version_string[i] == ' ') {
236 version_string.zap(i, i);
237 i--; // skip back a beat.
241 return version(0, 0, 0, 0);
244 return version::from_text(version_string);
247 bool version_checker::get_record(const astring &filename,
248 version_record &to_fill)
250 to_fill = version_record();
251 byte_array version_info_found(0, NULL_POINTER);
252 if (!retrieve_version_info(filename, version_info_found))
255 basis::un_short high, low; // holds the language of the version data.
256 if (!get_language(version_info_found, high, low))
259 // set the root key for all accesses of the version chunk.
260 astring root_key(astring::SPRINTF, "\\StringFileInfo\\%04x%04x", high, low);
262 // reports whether all lookups succeeded or not.
263 bool total_success = true;
265 // the various version pieces are retrieved...
269 basis::un_int data_size;
273 if (!VerQueryValue(version_info_found.access(), to_unicode_temp(root_key
274 + astring("\\FileVersion")), &data_pointer, &data_size))
275 total_success = false;
277 to_fill.file_version = version::from_text(render_ptr(data_pointer));
280 if (!VerQueryValue(version_info_found.access(), to_unicode_temp(root_key
281 + astring("\\CompanyName")), &data_pointer, &data_size))
282 total_success = false;
284 to_fill.company_name = render_ptr(data_pointer);
287 if (!VerQueryValue(version_info_found.access(), to_unicode_temp(root_key
288 + astring("\\FileDescription")), &data_pointer, &data_size))
289 total_success = false;
291 to_fill.description = render_ptr(data_pointer);
294 if (!VerQueryValue(version_info_found.access(), to_unicode_temp(root_key
295 + astring("\\InternalName")), &data_pointer, &data_size))
296 total_success = false;
298 to_fill.internal_name = render_ptr(data_pointer);
301 if (!VerQueryValue(version_info_found.access(), to_unicode_temp(root_key
302 + astring("\\LegalCopyright")), &data_pointer, &data_size))
303 total_success = false;
305 to_fill.copyright = render_ptr(data_pointer);
308 if (!VerQueryValue(version_info_found.access(), to_unicode_temp(root_key
309 + astring("\\LegalTrademarks")), &data_pointer, &data_size))
310 total_success = false;
312 to_fill.trademarks = render_ptr(data_pointer);
314 // original file name.
315 if (!VerQueryValue(version_info_found.access(), to_unicode_temp(root_key
316 + astring("\\OriginalFilename")), &data_pointer, &data_size))
317 total_success = false;
319 to_fill.original_name = render_ptr(data_pointer);
322 if (!VerQueryValue(version_info_found.access(), to_unicode_temp(root_key
323 + astring("\\ProductName")), &data_pointer, &data_size))
324 total_success = false;
326 to_fill.product_name = render_ptr(data_pointer);
329 if (!VerQueryValue(version_info_found.access(), to_unicode_temp(root_key
330 + astring("\\ProductVersion")), &data_pointer, &data_size))
331 total_success = false;
333 to_fill.product_version = version::from_text(render_ptr(data_pointer));
335 // hmmm: chunks missing in version check.
338 return total_success;
341 void version_checker::complain_wrong_version(const astring &library_file_name,
342 const version &expected_version, const version &version_found) const
344 astring to_show("There has been a Version Mismatch: The module \"");
345 // use embedded module handle to retrieve name of dll or exe.
346 astring module_name = get_name(version::__global_module_handle());
347 if (!module_name) module_name = "Unknown";
348 to_show += module_name;
349 to_show += astring("\" cannot load. This is because the file \"");
350 to_show += library_file_name;
351 to_show += astring("\" was expected to have a version of [");
353 to_show += expected_version.flex_text_form(version::DOTS);
355 to_show += astring("] but it instead had a version of [");
356 to_show += version_found.flex_text_form(version::DOTS);
358 to_show += astring("]. ");
359 to_show += *_version_complaint;
361 #if defined(__UNIX__) || defined(__GNU_WINDOWS__)
362 continuable_error("version checking", "failure", to_show.s());
363 #elif defined(_MSC_VER)
364 MessageBox(0, to_unicode_temp(to_show),
365 to_unicode_temp("version_checking::failure"), MB_OK);
369 void version_checker::complain_cannot_load(const astring &lib_file) const
371 astring to_show("There has been a failure in Version Checking: The file \"");
373 to_show += astring("\" could not be loaded or found. ");
374 to_show += *_version_complaint;
375 continuable_error("version checking", "loading dll", to_show.s());