blob: 583e32acd1833aec71c20cd621139efdd9b442c8 [file] [log] [blame]
Emeric Brun3bd697e2010-01-04 15:23:48 +01001/*
2 * include/proto/stick_table.h
3 * Functions for stick tables management.
4 *
5 * Copyright (C) 2009-2010 EXCELIANCE, Emeric Brun <ebrun@exceliance.fr>
Willy Tarreau08d5f982010-06-06 13:34:54 +02006 * Copyright (C) 2010 Willy Tarreau <w@1wt.eu>
Emeric Brun3bd697e2010-01-04 15:23:48 +01007 *
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation, version 2.1
11 * exclusively.
12 *
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
17 *
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21 */
22
23#ifndef _PROTO_STICK_TABLE_H
24#define _PROTO_STICK_TABLE_H
25
Willy Tarreau888617d2010-06-20 09:11:39 +020026#include <common/errors.h>
Willy Tarreauf6efda12010-08-03 20:34:06 +020027#include <common/ticks.h>
28#include <common/time.h>
Emeric Brun3bd697e2010-01-04 15:23:48 +010029#include <types/stick_table.h>
30
Willy Tarreau68129b92010-06-06 16:06:52 +020031#define stktable_data_size(type) (sizeof(((union stktable_data*)0)->type))
32#define stktable_data_cast(ptr, type) ((union stktable_data*)(ptr))->type
33
Willy Tarreau41883e22010-06-06 17:39:30 +020034extern struct stktable_key static_table_key;
35
Emeric Brun3bd697e2010-01-04 15:23:48 +010036struct stksess *stksess_new(struct stktable *t, struct stktable_key *key);
Willy Tarreau393379c2010-06-06 12:11:37 +020037void stksess_setkey(struct stktable *t, struct stksess *ts, struct stktable_key *key);
Emeric Brun3bd697e2010-01-04 15:23:48 +010038void stksess_free(struct stktable *t, struct stksess *ts);
Willy Tarreauf6efda12010-08-03 20:34:06 +020039void stksess_kill(struct stktable *t, struct stksess *ts);
Emeric Brun3bd697e2010-01-04 15:23:48 +010040
41int stktable_init(struct stktable *t);
42int stktable_parse_type(char **args, int *idx, unsigned long *type, size_t *key_size);
Willy Tarreau9ba2dcc2010-06-14 21:04:55 +020043struct stksess *stktable_get_entry(struct stktable *table, struct stktable_key *key);
Willy Tarreauf16d2b82010-06-06 15:38:59 +020044struct stksess *stktable_store(struct stktable *t, struct stksess *ts);
Willy Tarreaucb183642010-06-06 17:58:34 +020045struct stksess *stktable_touch(struct stktable *t, struct stksess *ts);
Willy Tarreauf16d2b82010-06-06 15:38:59 +020046struct stksess *stktable_lookup(struct stktable *t, struct stksess *ts);
47struct stksess *stktable_lookup_key(struct stktable *t, struct stktable_key *key);
Willy Tarreau1f7e9252010-06-20 12:27:21 +020048struct stksess *stktable_update_key(struct stktable *table, struct stktable_key *key);
Willy Tarreauf0b38bf2010-06-06 13:22:23 +020049struct stktable_key *stktable_fetch_key(struct proxy *px, struct session *l4,
50 void *l7, int dir, struct pattern_expr *expr,
51 unsigned long table_type);
52int stktable_compatible_pattern(struct pattern_expr *expr, unsigned long table_type);
Willy Tarreau08d5f982010-06-06 13:34:54 +020053int stktable_get_data_type(char *name);
Willy Tarreau4a0347a2010-06-18 17:26:50 +020054struct proxy *find_stktable(const char *name);
Willy Tarreau08d5f982010-06-06 13:34:54 +020055
Willy Tarreau3b9c6e02010-07-18 08:04:30 +020056/* return allocation size for standard data type <type> */
57static inline int stktable_type_size(int type)
58{
59 switch(type) {
60 case STD_T_SINT:
61 case STD_T_UINT:
62 return sizeof(int);
63 case STD_T_ULL:
64 return sizeof(unsigned long long);
65 case STD_T_FRQP:
66 return sizeof(struct freq_ctr_period);
67 }
68 return 0;
69}
70
Willy Tarreau888617d2010-06-20 09:11:39 +020071/* reserve some space for data type <type>, and associate argument at <sa> if
72 * not NULL. Returns PE_NONE (0) if OK or an error code among :
73 * - PE_ENUM_OOR if <type> does not exist
74 * - PE_EXIST if <type> is already registered
Willy Tarreauac782882010-06-20 10:41:54 +020075 * - PE_ARG_NOT_USE if <sa> was provided but not expected
76 * - PE_ARG_MISSING if <sa> was expected but not provided
Willy Tarreau08d5f982010-06-06 13:34:54 +020077 */
Willy Tarreau888617d2010-06-20 09:11:39 +020078static inline int stktable_alloc_data_type(struct stktable *t, int type, const char *sa)
Willy Tarreau08d5f982010-06-06 13:34:54 +020079{
80 if (type >= STKTABLE_DATA_TYPES)
Willy Tarreau888617d2010-06-20 09:11:39 +020081 return PE_ENUM_OOR;
Willy Tarreau08d5f982010-06-06 13:34:54 +020082
83 if (t->data_ofs[type])
84 /* already allocated */
Willy Tarreau888617d2010-06-20 09:11:39 +020085 return PE_EXIST;
Emeric Brun3bd697e2010-01-04 15:23:48 +010086
Willy Tarreauac782882010-06-20 10:41:54 +020087 switch (stktable_data_types[type].arg_type) {
88 case ARG_T_NONE:
89 if (sa)
90 return PE_ARG_NOT_USED;
91 break;
92 case ARG_T_INT:
93 if (!sa)
94 return PE_ARG_MISSING;
95 t->data_arg[type].i = atoi(sa);
96 break;
97 case ARG_T_DELAY:
98 if (!sa)
99 return PE_ARG_MISSING;
100 sa = parse_time_err(sa, &t->data_arg[type].u, TIME_UNIT_MS);
101 if (sa)
102 return PE_ARG_INVC; /* invalid char */
103 break;
104 }
105
Willy Tarreau3b9c6e02010-07-18 08:04:30 +0200106 t->data_size += stktable_type_size(stktable_data_types[type].std_type);
Willy Tarreau08d5f982010-06-06 13:34:54 +0200107 t->data_ofs[type] = -t->data_size;
Willy Tarreau888617d2010-06-20 09:11:39 +0200108 return PE_NONE;
Willy Tarreau08d5f982010-06-06 13:34:54 +0200109}
Emeric Brun3bd697e2010-01-04 15:23:48 +0100110
Willy Tarreau68129b92010-06-06 16:06:52 +0200111/* return pointer for data type <type> in sticky session <ts> of table <t>, or
112 * NULL if either <ts> is NULL or the type is not stored.
113 */
114static inline void *stktable_data_ptr(struct stktable *t, struct stksess *ts, int type)
115{
116 if (type >= STKTABLE_DATA_TYPES)
117 return NULL;
118
119 if (!t->data_ofs[type]) /* type not stored */
120 return NULL;
121
122 if (!ts)
123 return NULL;
124
125 return (void *)ts + t->data_ofs[type];
126}
127
Willy Tarreauf6efda12010-08-03 20:34:06 +0200128/* kill an entry if it's expired and its ref_cnt is zero */
129static inline void stksess_kill_if_expired(struct stktable *t, struct stksess *ts)
130{
131 if (tick_is_expired(ts->expire, now_ms))
132 stksess_kill(t, ts);
133}
134
Emeric Brun3bd697e2010-01-04 15:23:48 +0100135#endif /* _PROTO_STICK_TABLE_H */