File: MatcherUtils.h

package info (click to toggle)
trafficserver 6.2.0-1~bpo8%2B1
  • links: PTS, VCS
  • area: main
  • in suites: jessie-backports
  • size: 45,456 kB
  • sloc: cpp: 271,894; ansic: 80,740; sh: 6,032; makefile: 3,364; python: 2,135; perl: 2,040; java: 277; lex: 128; sql: 94; yacc: 68; sed: 8
file content (174 lines) | stat: -rw-r--r-- 4,951 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
/** @file

  A brief file description

  @section license License

  Licensed to the Apache Software Foundation (ASF) under one
  or more contributor license agreements.  See the NOTICE file
  distributed with this work for additional information
  regarding copyright ownership.  The ASF licenses this file
  to you under the Apache License, Version 2.0 (the
  "License"); you may not use this file except in compliance
  with the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
 */

/*****************************************************************************
 *
 *  MatcherUtils.h - Various helper routines used in ControlMatcher
 *                    and ReverseProxy
 *
 *
 ****************************************************************************/

#ifndef _MATCHER_UTILS_H_
#define _MATCHER_UTILS_H_

#include "ts/ParseRules.h"
#include "ts/ink_inet.h"

// Look in MatcherUtils.cc for comments on function usage
char *readIntoBuffer(const char *file_path, const char *module_name, int *read_size_ptr);

int unescapifyStr(char *buffer);

/** Extract an IP range.
    @a min and @a max should be at least the size of @c sockaddr_in6 to hold
    an IP address.
*/
char const *ExtractIpRange(char *match_str, sockaddr *min, sockaddr *max);

/// Convenience overload for IPv4.
char const *ExtractIpRange(char *match_str,
                           in_addr_t *addr1, ///< [in,out] Returned address in host order.
                           in_addr_t *addr2  ///< [in,out] Returned address in host order.
                           );

/// Convenience overload for IPv6.
inline char const *
ExtractIpRange(char *match_str,
               sockaddr_in6 *addr1, ///< [in,out] Returned address in network order.
               sockaddr_in6 *addr2  ///< [in,out] Returned address in network order.
               )
{
  return ExtractIpRange(match_str, ats_ip_sa_cast(addr1), ats_ip_sa_cast(addr2));
}

char *tokLine(char *buf, char **last, char cont = '\0');

const char *processDurationString(char *str, int *seconds);

// The first class types we support matching on
enum matcher_type {
  MATCH_NONE,
  MATCH_HOST,
  MATCH_DOMAIN,
  MATCH_IP,
  MATCH_REGEX,
  MATCH_URL,
  MATCH_HOST_REGEX,
};
extern const char *matcher_type_str[];

// A parsed config file line
const int MATCHER_MAX_TOKENS = 40;
struct matcher_line {
  matcher_type type;                 // dest type
  int dest_entry;                    // entry which specifies the destination
  int num_el;                        // Number of elements
  char *line[2][MATCHER_MAX_TOKENS]; // label, value pairs
  int line_num;                      // config file line number
  matcher_line *next;                // use for linked list
};

// Tag set to use to determining primary selector type
struct matcher_tags {
  const char *match_host;
  const char *match_domain;
  const char *match_ip;
  const char *match_regex;
  const char *match_url;
  const char *match_host_regex;
  bool dest_error_msg; // whether to use src or destination in any error messages

  bool
  empty() const
  {
    return this->match_host == NULL && this->match_domain == NULL && this->match_ip == NULL && this->match_regex == NULL &&
           this->match_url == NULL && this->match_host_regex == NULL;
  }
};

extern const matcher_tags http_dest_tags;
extern const matcher_tags ip_allow_tags;
extern const matcher_tags socks_server_tags;

const char *parseConfigLine(char *line, matcher_line *p_line, const matcher_tags *tags);

struct config_parse_error {
  // Wrapper to make a syntactically nice success value.
  static config_parse_error
  ok()
  {
    return config_parse_error();
  }

  config_parse_error(const config_parse_error &rhs)
  {
    if (rhs.msg.get()) {
      this->msg = ats_strdup(rhs.msg.get());
    }
  }

  explicit config_parse_error(const char *fmt, ...) TS_NONNULL(2) TS_PRINTFLIKE(2, 3);

  config_parse_error &
  operator=(const config_parse_error &rhs)
  {
    if (rhs.msg.get()) {
      this->msg = ats_strdup(rhs.msg.get());
    } else {
      this->msg = (char *)NULL;
    }

    return *this;
  }

  const char *
  get() const
  {
    return msg.get();
  }

  // A config error object evaluates to true if there is an error message.
  operator bool() const { return msg.get() != NULL; }
private:
  config_parse_error() {}
  ats_scoped_str msg;
};

// inline void LowerCaseStr(char* str)
//
//   Modifies str so all characters are lower
//     case
//
static inline void
LowerCaseStr(char *str)
{
  if (!str)
    return;
  while (*str != '\0') {
    *str = ParseRules::ink_tolower(*str);
    str++;
  }
}

#endif