TSTrafficServerVersionGet

Return Traffic Server version information.

Synopsis

include <ts/ts.h>

const char * TSTrafficServerVersionGet(void)

int TSTrafficServerVersionGetMajor(void)

int TSTrafficServerVersionGetMinor(void)

int TSTrafficServerVersionGetPatch(void)

Description

TSTrafficServerVersionGet() returns a pointer to a string of characters that indicates the Traffic Server release version. This string must not be modified.

The other APIs return an integer from the relevant component of the version number string.

Example

  1. #include <stdio.h>
  2. #include <ts/ts.h>
  4. int
  5. check_ts_version()
  6. {
  7.     const char *ts_version = TSTrafficServerVersionGet();
  8.     int result = 0;
  10.     if (ts_version) {
  11.         int major_ts_version = 0;
  12.         int minor_ts_version = 0;
  13.         int patch_ts_version = 0;
  15.         if (sscanf(ts_version, "%d.%d.%d", &major_ts_version,
  16.                 &minor_ts_version, &patch_ts_version) != 3) {
  17.             return 0;
  18.         }
  20.         /* We need at least Traffic Server 3.0 */
  21.         if (major_ts_version >= 3) {
  22.             result = 1;
  23.         }
  24.     }
  26.     return result;
  27. }
  29. void
  30. TSPluginInit (int argc, const char *argv[])
  31. {
  32.     TSPluginRegistrationInfo info;
  33.     info.plugin_name = "hello-world";
  34.     info.vendor_name = "MyCompany";
  35.     info.support_email = "ts-api-support@MyCompany.com";
  37.     if (TSPluginRegister(&info) != TS_SUCCESS) {
  38.         TSError("Plugin registration failed. 0);
  39.     }
  41.     if (!check_ts_version()) {
  42.         TSError("Plugin requires Traffic Server 3.0 or later0);
  43.         return;
  44.     }
  46.     TSDebug("debug-hello", "Hello World!0);
  47. }

See Also

TSAPI(3ts)