libosmocore  1.4.0
Osmocom core library
tdef.h
Go to the documentation of this file.
1 
4 /*
5  * (C) 2018-2019 by sysmocom - s.f.m.c. GmbH <info@sysmocom.de>
6  *
7  * All Rights Reserved
8  *
9  * SPDX-License-Identifier: GPL-2.0+
10  *
11  * Author: Neels Hofmeyr <neels@hofmeyr.de>
12  *
13  * This program is free software; you can redistribute it and/or modify
14  * it under the terms of the GNU Affero General Public License as published by
15  * the Free Software Foundation; either version 3 of the License, or
16  * (at your option) any later version.
17  *
18  * This program is distributed in the hope that it will be useful,
19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21  * GNU Affero General Public License for more details.
22  *
23  * You should have received a copy of the GNU Affero General Public License
24  * along with this program. If not, see <http://www.gnu.org/licenses/>.
25  */
26 #pragma once
27 
28 #include <stdint.h>
29 #include <osmocom/core/utils.h>
30 
31 struct osmo_fsm_inst;
32 
43 };
44 
45 extern const struct value_string osmo_tdef_unit_names[];
47 static inline const char *osmo_tdef_unit_name(enum osmo_tdef_unit val)
48 { return get_value_string(osmo_tdef_unit_names, val); }
49 
64 struct osmo_tdef {
69  const int T;
72  const unsigned long default_val;
73  const enum osmo_tdef_unit unit;
76  const char *desc;
79  unsigned long val;
81  unsigned long min_val;
83  unsigned long max_val;
84 };
85 
97 #define osmo_tdef_for_each(t, tdefs) \
98  for (t = tdefs; t && (t->T || t->default_val || t->desc); t++)
99 
100 void osmo_tdefs_reset(struct osmo_tdef *tdefs);
101 unsigned long osmo_tdef_get(const struct osmo_tdef *tdefs, int T, enum osmo_tdef_unit as_unit,
102  long val_if_not_present);
103 struct osmo_tdef *osmo_tdef_get_entry(struct osmo_tdef *tdefs, int T);
104 int osmo_tdef_set(struct osmo_tdef *tdefs, int T, unsigned long val, enum osmo_tdef_unit val_unit);
105 bool osmo_tdef_val_in_range(struct osmo_tdef *tdef, unsigned long new_val);
106 int osmo_tdef_range_str_buf(char *buf, size_t buf_len, struct osmo_tdef *t);
107 
114  int T;
118 };
119 
120 const struct osmo_tdef_state_timeout *osmo_tdef_get_state_timeout(uint32_t state,
121  const struct osmo_tdef_state_timeout *timeouts_array);
122 
159 #define osmo_tdef_fsm_inst_state_chg(fi, state, timeouts_array, tdefs, default_timeout) \
160  _osmo_tdef_fsm_inst_state_chg(fi, state, timeouts_array, tdefs, default_timeout, \
161  __FILE__, __LINE__)
162 int _osmo_tdef_fsm_inst_state_chg(struct osmo_fsm_inst *fi, uint32_t state,
163  const struct osmo_tdef_state_timeout *timeouts_array,
164  const struct osmo_tdef *tdefs, unsigned long default_timeout,
165  const char *file, int line);
166 
172  const char *name;
173  const char *desc;
174  struct osmo_tdef *tdefs;
175 };
176 
181 #define osmo_tdef_groups_for_each(g, tdef_groups) \
182  for (g = tdef_groups; g && g->tdefs; g++)
183 
struct osmo_tdef * tdefs
void osmo_tdefs_reset(struct osmo_tdef *tdefs)
Set all osmo_tdef values to the default_val.
Definition: tdef.c:143
struct osmo_tdef * osmo_tdef_get_entry(struct osmo_tdef *tdefs, int T)
Find tdef entry matching T.
Definition: tdef.c:212
unsigned long osmo_tdef_get(const struct osmo_tdef *tdefs, int T, enum osmo_tdef_unit as_unit, long val_if_not_present)
Return the value of a T timer from a list of osmo_tdef, in the given unit.
Definition: tdef.c:195
int _osmo_tdef_fsm_inst_state_chg(struct osmo_fsm_inst *fi, uint32_t state, const struct osmo_tdef_state_timeout *timeouts_array, const struct osmo_tdef *tdefs, unsigned long default_timeout, const char *file, int line)
See invocation macro osmo_tdef_fsm_inst_state_chg() instead.
Definition: tdef.c:321
const struct value_string osmo_tdef_unit_names[]
Definition: tdef.c:349
bool osmo_tdef_val_in_range(struct osmo_tdef *tdef, unsigned long new_val)
Check if value new_val is in range of valid possible values for timer entry tdef.
Definition: tdef.c:250
const struct osmo_tdef_state_timeout * osmo_tdef_get_state_timeout(uint32_t state, const struct osmo_tdef_state_timeout *timeouts_array)
Using osmo_tdef for osmo_fsm_inst: find a given state's osmo_tdef_state_timeout entry.
Definition: tdef.c:307
int osmo_tdef_range_str_buf(char *buf, size_t buf_len, struct osmo_tdef *t)
Write string representation of osmo_tdef range into buf.
Definition: tdef.c:263
osmo_tdef_unit
Definition: tdef.h:38
int osmo_tdef_set(struct osmo_tdef *tdefs, int T, unsigned long val, enum osmo_tdef_unit val_unit)
Set value in entry matching T, converting val from val_unit to unit of T.
Definition: tdef.c:230
static const char * osmo_tdef_unit_name(enum osmo_tdef_unit val)
Definition: tdef.h:47
@ OSMO_TDEF_CUSTOM
unspecified unit, explained in osmo_tdef.desc.
Definition: tdef.h:42
@ OSMO_TDEF_M
minutes
Definition: tdef.h:41
@ OSMO_TDEF_S
most T are in seconds, keep 0 as default.
Definition: tdef.h:39
@ OSMO_TDEF_MS
milliseconds
Definition: tdef.h:40
write Write running configuration to or terminal n Write configuration to the file(same as write file)\n") ALIAS(config_write_file
const char * get_value_string(const struct value_string *vs, uint32_t val)
get human-readable string for given value
Definition: utils.c:57
a single instanceof an osmocom finite state machine
Definition: fsm.h:87
Manage timer definitions in named groups.
Definition: tdef.h:171
const char * name
Definition: tdef.h:172
struct osmo_tdef * tdefs
Definition: tdef.h:174
const char * desc
Definition: tdef.h:173
Using osmo_tdef for osmo_fsm_inst: array entry for a mapping of state numbers to timeout definitions.
Definition: tdef.h:110
bool keep_timer
If true, call osmo_fsm_inst_state_chg_keep_timer().
Definition: tdef.h:117
int T
Timer number to match struct osmo_tdef.T, and to pass to osmo_fsm_inst_state_chg().
Definition: tdef.h:114
Define a GSM timer of the form Tnnn, with unit, default value and doc string.
Definition: tdef.h:64
enum osmo_tdef_unit unit
Definition: tdef.h:73
unsigned long max_val
Maximum timer value (in this tdef unit), checked if set (not zero).
Definition: tdef.h:83
const char * desc
Human readable description.
Definition: tdef.h:76
const int T
T1234 or X1234 number, corresponding to struct osmo_fsm_inst::T.
Definition: tdef.h:69
const unsigned long default_val
Timeout duration (according to unit), default value; type corresponds to osmo_fsm_inst_state_chg()'s ...
Definition: tdef.h:72
unsigned long min_val
Minimum timer value (in this tdef unit), checked if set (not zero).
Definition: tdef.h:81
unsigned long val
Currently active timeout value, e.g.
Definition: tdef.h:79
A mapping between human-readable string and numeric value.
Definition: utils.h:42