Method format_from_specification

src/proxy/logging/LogFormat.cc:267–401

  -------------------------------------------------------------------------*/

LogFormat *
LogFormat::format_from_specification(char *spec, char **file_name, char **file_header, LogFileFormat *file_type)
{
  LogFormat *format;
  char      *token;
  int        format_id;
  char      *format_name, *format_str;

  ink_assert(file_name != nullptr);
  ink_assert(file_header != nullptr);
  ink_assert(file_type != nullptr);

  SimpleTokenizer tok(spec, ':');

  //
  // Divide the specification string into tokens using the ':' as a
  // field separator.  There are currently eight (8) tokens that comprise
  // a format specification.  Verify each of the token values and if
  // everything looks ok, then build the LogFormat object.
  //
  // First should be the "format" keyword that says this is a format spec.
  //
  token = tok.getNext();
  if (token == nullptr) {
    Dbg(dbg_ctl_log_format, "token expected");
    return nullptr;
  }
  if (strcasecmp(token, "format") == 0) {
    Dbg(dbg_ctl_log_format, "this is a format");
  } else {
    Dbg(dbg_ctl_log_format, "should be 'format'");
    return nullptr;
  }

  //
  // Next should be the word "enabled" or "disabled", which indicates
  // whether we should care about this format or not.
  //
  token = tok.getNext();
  if (token == nullptr) {
    Dbg(dbg_ctl_log_format, "token expected");
    return nullptr;
  }
  if (!strcasecmp(token, "disabled")) {
    Dbg(dbg_ctl_log_format, "format not enabled, skipping ...");
    return nullptr;
  } else if (!strcasecmp(token, "enabled")) {
    Dbg(dbg_ctl_log_format, "enabled format");
  } else {
    Dbg(dbg_ctl_log_format, "should be 'enabled' or 'disabled', not %s", token);
    return nullptr;
  }

  //
  // Next should be the numeric format identifier
  //
  token = tok.getNext();
  if (token == nullptr) {