Hi Henning,
On 02/17/2010 11:22 AM, Henning Westerholt wrote:
On Wednesday 17 February 2010, Miklos Tirpak wrote:
[..]
2) Some modules update local or even shared memory variables based on
cfg variable changes. It would be nice to solve as many cases within the
framework as possible. For example the modules could have write access
to their variables during fixup, or more complicated structures could be
stored not only int and str vars. If you miss any feature therefore you
keep variables outside of the framework then please speak up!
Hi Miklos,
indeed this is another problem which we've also discussed during the planning
for the cfg framework migration work, its present for example in the ratelimit
and carrierroute modules.
Quite a few kamailio modules implemented also their own version of reload
functionality with a FIFO command, e.g. "reload_fifo" in
modules/carrierroute/cr_fifo.c. This is more or less a similar use case like
the cfg framework represents (atomic reload of a variable), but with a a bit
more complicated data structure (route_data_t).
So having a generic version for this in the cfg framework would be indeed nice
in my opinion.
the route_data_t structure seems to be the routing data similar to what
a route block does in the script, I mean that it is not like a modparam.
This is a bit far from the initial concept of the cfg framework but this
would not be a problem.
In the framework, there are module and core parameters declared by the
modules/core and there are cfg drivers that write the parameters. They
can work on any backend, file, DB, srcmd... Hence, the drivers or the
framework must know the structure of the configuration, i.e. what type
of value is stored in which slot. The route_data_t structure is quite
complex, the number of carriers and the number of domains is not known
in advance, therefore the size of the structure is also unknown. The
framework could hardly tell what is stored on a given memory address.
The best we could do is to let the carrierroute module write its own
configuration and do not touch it by other modules, I mean by the cfg
drivers.
Actually the framework already supports the void* type that could be
used for this purpose (with some enhancements). The module could load
the config, allocate the necessary space in shm mem, and link it to the
global configuration via the void* pointer. From this point the
framework could offer:
- consistency: The config would remain the same during a SIP message
processing. Even if there is a new config available, it would be used
only for the next message routeing.
- locking: The carrierroute module should not care about locking the
data structures during reading because it is the task of the framework.
In fact, the framework supports lockless read because all modifications
(except with the atomic flag) copy the entire config block first and
modify the clone. This is done for performance reasons because the
assumption is that the config rarely changes but it is read many times.
This means that even the carrierroute module is not allowed to simply
write its data structures. It should always construct a new structure
(or clone the existing one) and link the new configuration to the global
cfg structure via some interface.
So I do not see to much benefit of using the cfg framework in this case
because the structure that needs to be stored does not have a fixed
size, therefore it is hard to specify for the framework. In this case
the carrierroute module would be the only one that can read/write the
config which is nothing different from the current situation.
Or do you think that the consistency and locking are worth the effort?
Regards,
Miklos
Cheers,
Henning