2 * Routines to report version information for stuff used by Wireshark
6 * Wireshark - Network traffic analyzer
7 * By Gerald Combs <gerald@wireshark.org>
8 * Copyright 1998 Gerald Combs
10 * This program is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU General Public License
12 * as published by the Free Software Foundation; either version 2
13 * of the License, or (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
30 #include <Python.h> /* to get the Python version number (PY_VERSION) */
41 #include <zlib.h> /* to get the libz version number */
45 #include <pcre.h> /* to get the libpcre version number */
46 #endif /* HAVE_LIBPCRE */
48 #ifdef HAVE_SYS_UTSNAME_H
49 #include <sys/utsname.h>
52 #include "version_info.h"
53 #include "capture-pcap-util.h"
54 #include <wsutil/unicode-utils.h>
56 #include "svnversion.h"
62 #ifdef HAVE_OS_X_FRAMEWORKS
63 #include <CoreServices/CoreServices.h>
67 # include <sys/capability.h>
71 #include <epan/geoip_db.h>
75 const char *wireshark_svnversion = " (" SVNVERSION " from " SVNPATH ")";
77 const char *wireshark_svnversion = "";
81 * If the string doesn't end with a newline, append one.
82 * Then word-wrap it to 80 columns.
85 end_string(GString *str)
91 if (point == 0 || str->str[point - 1] != '\n')
92 g_string_append(str, "\n");
98 * Break at or before this point.
101 while (q > p && *q != ' ')
111 * Get various library compile-time versions and append them to
112 * the specified GString.
114 * "additional_info" is called at the end to append any additional
115 * information; this is required in order to, for example, put the
116 * Portaudio information at the end of the string, as we currently
117 * don't use Portaudio in TShark.
120 get_compiled_version_info(GString *str, void (*prepend_info)(GString *),
121 void (*append_info)(GString *))
123 if (sizeof(str) == 4)
124 g_string_append(str, "(32-bit) ");
126 g_string_append(str, "(64-bit) ");
129 (*prepend_info)(str);
132 g_string_append(str, "with ");
133 g_string_append_printf(str,
134 #ifdef GLIB_MAJOR_VERSION
135 "GLib %d.%d.%d", GLIB_MAJOR_VERSION, GLIB_MINOR_VERSION,
138 "GLib (version unknown)");
142 g_string_append(str, ", ");
143 get_compiled_pcap_version(str);
146 g_string_append(str, ", ");
148 g_string_append(str, "with libz ");
150 g_string_append(str, ZLIB_VERSION);
151 #else /* ZLIB_VERSION */
152 g_string_append(str, "(version unknown)");
153 #endif /* ZLIB_VERSION */
154 #else /* HAVE_LIBZ */
155 g_string_append(str, "without libz");
156 #endif /* HAVE_LIBZ */
159 g_string_append(str, ", ");
161 g_string_append(str, "with POSIX capabilities");
162 #ifdef _LINUX_CAPABILITY_VERSION
163 g_string_append(str, " (Linux)");
164 #endif /* _LINUX_CAPABILITY_VERSION */
165 #else /* HAVE_LIBCAP */
166 g_string_append(str, "without POSIX capabilities");
167 #endif /* HAVE_LIBCAP */
169 /* Additional application-dependent information */
172 g_string_append(str, ".");
174 #if !defined(HAVE_LIBPCRE) && !GLIB_CHECK_VERSION(2,14,0)
176 "\nNOTE: this build doesn't support the \"matches\" operator for Wireshark filter syntax");
177 g_string_append(str, ".");
178 #endif /* HAVE_LIBPCRE */
184 typedef void (WINAPI *nativesi_func_ptr)(LPSYSTEM_INFO);
188 * Get various library run-time versions, and the OS version, and append
189 * them to the specified GString.
192 get_runtime_version_info(GString *str, void (*additional_info)(GString *))
195 OSVERSIONINFOEX info;
196 SYSTEM_INFO system_info;
197 nativesi_func_ptr nativesi_func;
198 #elif defined(HAVE_SYS_UTSNAME_H)
201 #if HAVE_OS_X_FRAMEWORKS
202 SInt32 macosx_ver, macosx_major_ver, macosx_minor_ver, macosx_bugfix_ver;
205 g_string_append(str, "on ");
211 * http://msdn.microsoft.com/library/default.asp?url=/library/en-us/sysinfo/base/getting_the_system_version.asp
213 * for more than you ever wanted to know about determining the
214 * flavor of Windows on which you're running. Implementing more
215 * of that is left as an exercise to the reader - who should
216 * check any copyright information about code samples on MSDN
217 * before cutting and pasting into Wireshark.
219 * They should also note that you need an OSVERSIONINFOEX structure
220 * to get some of that information, and that not only is that
221 * structure not supported on older versions of Windows, you might
222 * not even be able to compile code that *uses* that structure with
223 * older versions of the SDK.
226 memset(&info, '\0', sizeof info);
227 info.dwOSVersionInfoSize = sizeof info;
228 if (!GetVersionEx((OSVERSIONINFO *)&info)) {
230 * XXX - get the failure reason.
232 g_string_append(str, "unknown Windows version");
236 memset(&system_info, '\0', sizeof system_info);
237 /* Look for and use the GetNativeSystemInfo() function if available to get the correct processor
238 * architecture even when running 32-bit Wireshark in WOW64 (x86 emulation on 64-bit Windows) */
239 nativesi_func = (nativesi_func_ptr)GetProcAddress(GetModuleHandle(_T("kernel32.dll")), "GetNativeSystemInfo");
241 nativesi_func(&system_info);
243 GetSystemInfo(&system_info);
245 switch (info.dwPlatformId) {
247 case VER_PLATFORM_WIN32s:
249 g_string_append_printf(str, "Windows 3.1 with Win32s");
252 case VER_PLATFORM_WIN32_WINDOWS:
254 switch (info.dwMajorVersion) {
257 /* 3 cheers for Microsoft marketing! */
258 switch (info.dwMinorVersion) {
261 g_string_append_printf(str, "Windows 95");
265 g_string_append_printf(str, "Windows 98");
269 g_string_append_printf(str, "Windows Me");
273 g_string_append_printf(str, "Windows OT, unknown version %lu.%lu",
274 info.dwMajorVersion, info.dwMinorVersion);
280 g_string_append_printf(str, "Windows OT, unknown version %lu.%lu",
281 info.dwMajorVersion, info.dwMinorVersion);
286 case VER_PLATFORM_WIN32_NT:
288 switch (info.dwMajorVersion) {
292 g_string_append_printf(str, "Windows NT %lu.%lu",
293 info.dwMajorVersion, info.dwMinorVersion);
297 /* 3 cheers for Microsoft marketing! */
298 switch (info.dwMinorVersion) {
301 g_string_append_printf(str, "Windows 2000");
305 g_string_append_printf(str, "Windows XP");
309 if ((info.wProductType == VER_NT_WORKSTATION) &&
310 (system_info.wProcessorArchitecture == PROCESSOR_ARCHITECTURE_AMD64)) {
311 g_string_append_printf(str, "Windows XP Professional x64 Edition");
313 g_string_append_printf(str, "Windows Server 2003");
314 if (system_info.wProcessorArchitecture == PROCESSOR_ARCHITECTURE_AMD64)
315 g_string_append_printf(str, " x64 Edition");
320 g_string_append_printf(str, "Windows NT, unknown version %lu.%lu",
321 info.dwMajorVersion, info.dwMinorVersion);
327 gboolean is_nt_workstation;
329 if (system_info.wProcessorArchitecture == PROCESSOR_ARCHITECTURE_AMD64)
330 g_string_append(str, "64-bit ");
331 else if (system_info.wProcessorArchitecture == PROCESSOR_ARCHITECTURE_INTEL)
332 g_string_append(str, "32-bit ");
333 #ifndef VER_NT_WORKSTATION
334 #define VER_NT_WORKSTATION 0x01
335 is_nt_workstation = ((info.wReserved[1] & 0xff) == VER_NT_WORKSTATION);
337 is_nt_workstation = (info.wProductType == VER_NT_WORKSTATION);
339 switch (info.dwMinorVersion) {
341 g_string_append_printf(str, is_nt_workstation ? "Windows Vista" : "Windows Server 2008");
344 g_string_append_printf(str, is_nt_workstation ? "Windows 7" : "Windows Server 2008 R2");
347 g_string_append_printf(str, "Windows NT, unknown version %lu.%lu",
348 info.dwMajorVersion, info.dwMinorVersion);
354 g_string_append_printf(str, "Windows NT, unknown version %lu.%lu",
355 info.dwMajorVersion, info.dwMinorVersion);
357 } /* info.dwMajorVersion */
361 g_string_append_printf(str, "Unknown Windows platform %lu version %lu.%lu",
362 info.dwPlatformId, info.dwMajorVersion, info.dwMinorVersion);
365 if (info.szCSDVersion[0] != '\0')
366 g_string_append_printf(str, " %s", utf_16to8(info.szCSDVersion));
367 g_string_append_printf(str, ", build %lu", info.dwBuildNumber);
368 #elif defined(HAVE_SYS_UTSNAME_H)
370 * We have <sys/utsname.h>, so we assume we have "uname()".
372 if (uname(&name) < 0) {
373 g_string_append_printf(str, "unknown OS version (uname failed - %s)",
378 if (strcmp(name.sysname, "AIX") == 0) {
380 * Yay, IBM! Thanks for doing something different
381 * from most of the other UNIXes out there, and
382 * making "name.version" apparently be the major
383 * version number and "name.release" be the minor
386 g_string_append_printf(str, "%s %s.%s", name.sysname, name.version,
390 * XXX - get "version" on any other platforms?
392 * On Digital/Tru64 UNIX, it's something unknown.
393 * On Solaris, it's some kind of build information.
394 * On HP-UX, it appears to be some sort of subrevision
396 * On *BSD and Darwin/OS X, it's a long string giving
397 * a build date, config file name, etc., etc., etc..
399 #ifdef HAVE_OS_X_FRAMEWORKS
401 * On Mac OS X, report the Mac OS X version number as
402 * the OS, and put the Darwin information in parentheses.
404 * XXX - can we get the build name? There's no API to
405 * get it; it's currently in
406 * /System/Library/CoreServices/SystemVersion.plist
407 * but there's no guarantee that it will continue to
410 Gestalt(gestaltSystemVersion, &macosx_ver);
412 /* The following functions are only available in Mac OS 10.4+ */
413 if(macosx_ver >= 0x1040) {
414 Gestalt(gestaltSystemVersionMajor, &macosx_major_ver);
415 Gestalt(gestaltSystemVersionMinor, &macosx_minor_ver);
416 Gestalt(gestaltSystemVersionBugFix, &macosx_bugfix_ver);
418 g_string_append_printf(str, "Mac OS %ld.%ld.%ld",
419 (long)macosx_major_ver,
420 (long)macosx_minor_ver,
421 (long)macosx_bugfix_ver);
423 g_string_append_printf(str, "Mac OS X < 10.4 [%lx]",
425 /* See Apple's Gestalt Manager Reference for meanings
426 * of the macosx_ver values. */
428 g_string_append_printf(str, " (%s %s)", name.sysname, name.release);
429 #else /* HAVE_OS_X_FRAMEWORKS */
431 * XXX - on Linux, are there any APIs to get the distribution
432 * name and version number? I think some distributions have
435 * At least on Linux Standard Base-compliant distributions,
436 * there's an "lsb_release" command. However:
438 * http://forums.fedoraforum.org/showthread.php?t=220885
440 * seems to suggest that if you don't have the redhat-lsb
441 * package installed, you don't have lsb_release, and that
442 * /etc/fedora-release has the release information on
445 * http://linux.die.net/man/1/lsb_release
447 * suggests that there's an /etc/distrib-release file, but
448 * it doesn't indicate whether "distrib" is literally
449 * "distrib" or is the name for the distribution, and
450 * also speaks of an /etc/debian_version file.
452 * "lsb_release" apparently parses /etc/lsb-release, which
453 * has shell-style assignments, assigning to, among other
454 * values, DISTRIB_ID (distributor/distribution name),
455 * DISTRIB_RELEASE (release number of the distribution),
456 * DISTRIB_DESCRIPTION (*might* be name followed by version,
457 * but the manpage for lsb_release seems to indicate that's
458 * not guaranteed), and DISTRIB_CODENAME (code name, e.g.
459 * "licentious" for the Ubuntu Licentious Lemur release).
460 * the lsb_release man page also speaks of the distrib-release
461 * file, but Debian doesn't have one, and Ubuntu 7's
462 * lsb_release command doesn't look for one.
464 * I've seen references to /etc/redhat-release as well.
466 * At least on my Ubuntu 7 system, /etc/debian_version
467 * doesn't contain anything interesting (just some Debian
472 * http://bugs.python.org/issue1322
474 * http://www.novell.com/coolsolutions/feature/11251.html
476 * http://linuxmafia.com/faq/Admin/release-files.html
478 * and the Lib/Platform.py file in recent Python 2.x
481 g_string_append_printf(str, "%s %s", name.sysname, name.release);
482 #endif /* HAVE_OS_X_FRAMEWORKS */
485 g_string_append(str, "an unknown OS");
489 g_string_append(str, ", ");
490 get_runtime_pcap_version(str);
493 #if defined(HAVE_LIBZ) && !defined(_WIN32)
494 g_string_append_printf(str, ", with libz %s", zlibVersion());
497 /* Additional application-dependent information */
499 (*additional_info)(str);
501 g_string_append(str, ".");
506 * See http://predef.sourceforge.net/precomp.html for
507 * information on various defined strings.
509 * GCC's __VERSION__ is a nice text string for humans to
510 * read. The page at predef.sourceforge.net largely
511 * describes numeric #defines that encode the version;
512 * if the compiler doesn't also offer a nice printable
513 * string, we should probably prettify the number somehow.
515 #if defined(__GNUC__) && defined(__VERSION__)
516 #if defined(__clang__)
517 g_string_append_printf(str, "\n\nBuilt using clang %s.\n", __VERSION__);
518 #elif defined(__llvm__)
519 g_string_append_printf(str, "\n\nBuilt using llvm-gcc %s.\n", __VERSION__);
520 #else /* boring old GCC */
521 g_string_append_printf(str, "\n\nBuilt using gcc %s.\n", __VERSION__);
523 #elif defined(__HP_aCC)
524 g_string_append_printf(str, "\n\nBuilt using HP aCC %d.\n", __HP_aCC);
525 #elif defined(__xlC__)
526 g_string_append_printf(str, "\n\nBuilt using IBM XL C %d.%d\n",
527 (__xlC__ >> 8) & 0xFF, __xlC__ & 0xFF);
529 if ((__IBMC__ % 10) != 0)
530 g_string_append_printf(str, " patch %d", __IBMC__ % 10);
531 #endif /* __IBMC__ */
532 g_string_append_printf(str, "\n");
533 #elif defined(__INTEL_COMPILER)
534 g_string_append_printf(str, "\n\nBuilt using Intel C %d.%d",
535 __INTEL_COMPILER / 100, (__INTEL_COMPILER / 10) % 10);
536 if ((__INTEL_COMPILER % 10) != 0)
537 g_string_append_printf(str, " patch %d", __INTEL_COMPILER % 10);
538 #ifdef __INTEL_COMPILER_BUILD_DATE
539 g_string_sprinta(str, ", compiler built %04d-%02d-%02d",
540 __INTEL_COMPILER_BUILD_DATE / 10000,
541 (__INTEL_COMPILER_BUILD_DATE / 100) % 100,
542 __INTEL_COMPILER_BUILD_DATE % 100);
543 #endif /* __INTEL_COMPILER_BUILD_DATE */
544 g_string_append_printf(str, "\n");
545 #elif defined(_MSC_FULL_VER)
546 if (_MSC_FULL_VER > 99999999) {
547 g_string_append_printf(str, "\n\nBuilt using Microsoft Visual C++ %d.%d",
548 (_MSC_FULL_VER / 10000000) - 6,
549 (_MSC_FULL_VER / 100000) % 100);
550 if ((_MSC_FULL_VER % 100000) != 0)
551 g_string_append_printf(str, " build %d",
552 _MSC_FULL_VER % 100000);
554 g_string_append_printf(str, "\n\nBuilt using Microsoft Visual C++ %d.%d",
555 (_MSC_FULL_VER / 1000000) - 6,
556 (_MSC_FULL_VER / 10000) % 100);
557 if ((_MSC_FULL_VER % 10000) != 0)
558 g_string_append_printf(str, " build %d",
559 _MSC_FULL_VER % 10000);
561 g_string_append_printf(str, "\n");
562 #elif defined(_MSC_VER)
563 /* _MSC_FULL_VER not defined, but _MSC_VER defined */
564 g_string_append_printf(str, "\n\nBuilt using Microsoft Visual C++ %d.%d\n",
565 (_MSC_VER / 100) - 6, _MSC_VER % 100);
566 #elif defined(__SUNPRO_C)
567 g_string_append_printf(str, "\n\nBuilt using Sun C %d.%d",
568 (__SUNPRO_C >> 8) & 0xF, (__SUNPRO_C >> 4) & 0xF);
569 if ((__SUNPRO_C & 0xF) != 0)
570 g_string_append_printf(str, " patch %d", __SUNPRO_C & 0xF);
571 g_string_append_printf(str, "\n");
578 * Get copyright information.
581 get_copyright_info(void)
584 "Copyright 1998-2011 Gerald Combs <gerald@wireshark.org> and contributors.\n"
585 "This is free software; see the source for copying conditions. There is NO\n"
586 "warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n";
591 * Get the major OS version.
593 /* XXX - Should this return the minor version as well, e.g. 0x00050002? */
595 get_os_major_version()
598 info.dwOSVersionInfoSize = sizeof info;
599 if (GetVersionEx(&info)) {
600 return info.dwMajorVersion;
612 * indent-tabs-mode: t
615 * ex: set shiftwidth=8 tabstop=8 noexpandtab
616 * :indentSize=8:tabSize=8:noTabs=false: