cfgutils Module
__________________________________________________________
Table of Contents
1. Admin Guide
1.1. Overview
1.2. Dependencies
1.3. Exported Parameters
1.3.1. initial_probability (string)
1.3.2. hash_file (string)
1.3.3. shv_hash_size (integer)
1.3.4. shvset (string)
1.3.5. varset (string)
1.3.6. lock_pool_size (integer)
1.4. Exported Functions
1.4.1. rand_event([probability])
1.4.2. rand_set_prob(probability)
1.4.3. rand_reset_prob()
1.4.4. rand_get_prob()
1.4.5. sleep(time)
1.4.6. usleep(time)
1.4.7. abort()
1.4.8. pkg_status()
1.4.9. shm_status()
1.4.10. set_count(var_to_count, ret_var)
1.4.11. set_select_weight(int_list_var)
1.4.12. ts_usec_delta(t1_sec, t1_usec, t2_sec,
t2_usec, delta)
1.4.13. check_time_rec(time_string, [timestamp])
1.4.14. get_static_lock(key)
1.4.15. release_static_lock(key)
1.4.16. get_dynamic_lock(key)
1.4.17. release_dynamic_lock(key)
1.4.18. strings_share_lock(key1, key2)
1.4.19. get_accurate_time(sec, usec, [str_sec_usec])
1.5. Exported Asyncronous Functions
1.5.1. sleep(seconds)
1.5.2. usleep(seconds)
1.6. Exported MI Functions
1.6.1. rand_set_prop
1.6.2. rand_reset_prob
1.6.3. rand_get_prob
1.6.4. check_config_hash
1.6.5. get_config_hash
1.6.6. shv_set
1.6.7. shv_get
1.7. Exported Pseudo-Variables
1.7.1. $env(name)
1.7.2. $RANDOM
1.7.3. $ctime(name)
1.7.4. $shv(name)
2. Contributors
2.1. By Commit Statistics
2.2. By Commit Activity
3. Documentation
3.1. Contributors
List of Tables
2.1. Top contributors by DevScore^(1), authored commits^(2) and
lines added/removed^(3)
2.2. Most recently active contributors^(1) to this module
List of Examples
1.1. initial_probability parameter usage
1.2. hash_file parameter usage
1.3. shv_hash_size parameter usage
1.4. shvset parameter usage
1.5. varset parameter usage
1.6. Setting lock_pool_size module parameter
1.7. rand_event() usage
1.8. rand_set_prob() usage
1.9. rand_reset_prob() usage
1.10. rand_get_prob() usage
1.11. sleep usage
1.12. usleep usage
1.13. abort usage
1.14. pkg_status usage
1.15. shm_status usage
1.16. set_count usage
1.17. set_select_weight usage
1.18. ts_usec_delta usage
1.19. check_time_rec usage
1.20. get_static_lock usage
1.21. release_static_lock usage
1.22. get_dynamic_lock usage
1.23. release_dynamic_lock usage
1.24. strings_share_lock usage
1.25. get_accurate_time usage
1.26. async sleep usage
1.27. async usleep usage
1.28. rand_set_prob usage
1.29. rand_reset_prob usage
1.30. rand_get_prob usage
1.31. check_config_hash usage
1.32. get_config_hash usage
1.33. shv_set usage
1.34. shv_get usage
1.35. env(name) pseudo-variable usage
1.36. RANDOM pseudo-variable usage
1.37. ctime(name) pseudo-variable usage
1.38. shv(name) pseudo-variable usage
Chapter 1. Admin Guide
1.1. Overview
Useful extensions for the server configuration.
The cfgutils module can be used to introduce randomness to the
behaviour of the server. It provides setup functions and the
"rand_event" function. This function return either true or
false, depending on a random value and a specified probability.
E.g. if you set via fifo or script a probability value of 5%,
then 5% of all calls to rand_event will return false. The
pseudovariable "$RANDOM" could be used to introduce random
values e.g. into a SIP reply.
The benefit of this module is the probability of the decision
can be manipulated by external applications such as web
interface or command line tools. The probability must be
specified as percent value, ranging from 0 to 100.
The module exports commands to FIFO server that can be used to
change the global settings via FIFO interface. The FIFO
commands are: "set_prob", "reset_prob" and "get_prob".
This module can be used for simple load-shedding, e.g. reply 5%
of the Invites with a 503 error and a adequate random
Retry-After value.
The module provides as well functions to delay the execution of
the server. The functions "sleep" and "usleep" could be used to
let the server wait a specific time interval.
It can also hash the config file used from the server with a
(weak) cryptographic hash function on startup. This value is
saved and can be later compared to the actual hash, to detect
modifications of this file after the server start. This
functions are available as the FIFO commands
"check_config_hash" and "get_config_hash".
1.2. Dependencies
The module depends on the following modules (in the other words
the listed modules must be loaded before this module):
* none
1.3. Exported Parameters
1.3.1. initial_probability (string)
The initial value of the probability.
Default value is "10".
Example 1.1. initial_probability parameter usage
modparam("cfgutils", "initial_probability", 15)
1.3.2. hash_file (string)
The config file name for that a hash value should be calculated
on startup.
There is no default value, is no parameter is given the hash
functionality is disabled.
Example 1.2. hash_file parameter usage
modparam("cfgutils", "hash_file", "/etc/opensips/opensips.cfg")
1.3.3. shv_hash_size (integer)
The size of the hash table used to store the shared variables
($shv).
Default value is "64".
Example 1.3. shv_hash_size parameter usage
modparam("cfgutils", "shv_hash_size", 1024)
1.3.4. shvset (string)
Set the value of a shared variable ($shv(name)). The parameter
can be set many times.
The value of the parameter has the format: _name_ '=' _type_
':' _value_
* _name_: shared variable name
* _type_: type of the value
+ "i": integer value
+ "s": string value
* _value_: value to be set
Default value is "NULL".
Example 1.4. shvset parameter usage
...
modparam("cfgutils", "shvset", "debug=i:1")
modparam("cfgutils", "shvset", "pstngw=s:sip:10.10.10.10")
...
1.3.5. varset (string)
Set the value of a script variable ($var(name)). The parameter
can be set many times.
The value of the parameter has the format: _name_ '=' _type_
':' _value_
* _name_: shared variable name
* _type_: type of the value
+ "i": integer value
+ "s": string value
* _value_: value to be set
Default value is "NULL".
Example 1.5. varset parameter usage
...
modparam("cfgutils", "varset", "init=i:1")
modparam("cfgutils", "varset", "gw=s:sip:11.11.11.11;transport=tcp")
...
1.3.6. lock_pool_size (integer)
The number of dynamic script locks to be allocated at OpenSIPS
startup. This number must be a power of 2. (i.e. 1, 2, 4, 8,
16, 32, 64 ...)
Note that the lock_pool_size parameter only affects the number
of dynamic locks created at startup. The pool of static locks
only depends on the number of unique static strings supplied
throughout the script to the set of static lock functions.
Default value is "32".
Example 1.6. Setting lock_pool_size module parameter
modparam("cfgutils", "lock_pool_size", 64)
1.4. Exported Functions
1.4.1. rand_event([probability])
Generates a random floating point value between 0 - 100 and
returns true if the value is less or equal to the currently set
probability. If "probability" parameter is given, it will
override the global parameter set by rand_set_prob().
Parameters:
* probability (int, optional) - probability override
Example 1.7. rand_event() usage
...
if (rand_event()) {
append_to_reply("Retry-After: 120\n");
sl_send_reply(503, "Try later");
exit;
}
# normal message processing follows
...
1.4.2. rand_set_prob(probability)
Set the "probability" of the decision.
Parameters:
* probability (int) - number ranging from 0 - 99, inclusively
Example 1.8. rand_set_prob() usage
...
rand_set_prob(4);
...
1.4.3. rand_reset_prob()
Reset the probability back to the initial_probability value.
Example 1.9. rand_reset_prob() usage
...
rand_reset_prob();
...
1.4.4. rand_get_prob()
Return the current probability setting, e.g. for logging
purposes.
Example 1.10. rand_get_prob() usage
...
rand_get_prob();
1.4.5. sleep(time)
Waits "time" seconds.
Meaning of the parameters is as follows:
* time (int) - time to wait in seconds
This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE,
FAILURE_ROUTE, BRANCH_ROUTE.
Example 1.11. sleep usage
...
sleep(1);
...
$var(secs) = 10;
sleep($var(secs));
...
1.4.6. usleep(time)
Waits "time" micro-seconds.
Meaning of the parameters is as follows:
* time (int) - time to wait in micro-seconds
This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE,
FAILURE_ROUTE, BRANCH_ROUTE.
Example 1.12. usleep usage
...
usleep(500000); # sleep half a sec
...
1.4.7. abort()
Debugging function that aborts the server. Depending on the
configuration of the server a core dump will be created.
This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE,
FAILURE_ROUTE, BRANCH_ROUTE.
Example 1.13. abort usage
...
abort();
...
1.4.8. pkg_status()
Debugging function that dumps the status for the private (PKG)
memory. This information is logged to the default log facility,
depending on the general log level and the memlog setting. You
need to compile the server with activated memory debugging to
get detailed informations.
This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE,
FAILURE_ROUTE, BRANCH_ROUTE.
Example 1.14. pkg_status usage
...
pkg_status();
...
1.4.9. shm_status()
Debugging function that dumps the status for the shared (SHM)
memory. This information is logged to the default log facility,
depending on the general log level and the memlog setting. You
need to compile the server with activated memory debugging to
get detailed informations.
This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE,
FAILURE_ROUTE, BRANCH_ROUTE.
Example 1.15. shm_status usage
...
shm_status();
...
1.4.10. set_count(var_to_count, ret_var)
Counts the number of values of a given variable. It makes sense
to call this function only for variables that can take more
values (AVPs, headers).
The result is returned in the second parameter.
This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE,
FAILURE_ROUTE, BRANCH_ROUTE.
Example 1.16. set_count usage
...
set_count($avp(dids), $var(num_dids));
...
1.4.11. set_select_weight(int_list_var)
This function selects an element from a set formed by the
integer values of the given "int_list_var" variable. It applies
the genetic algorithm - roulette-wheel selection to choose an
element from a set. The probability of selecting a certain
element is proportionate with its weight. It will return the
index of that selected element.
This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE,
FAILURE_ROUTE, BRANCH_ROUTE.
Example 1.17. set_select_weight usage
...
$var(next_gw_idx) = set_select_weight($avp(gw_success_rates));
...
1.4.12. ts_usec_delta(t1_sec, t1_usec, t2_sec, t2_usec, delta)
This function returns the difference between two timestamps,
specified in seconds and microseconds. The result is returned
in the last parameter, expressed in microseconds.
This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE,
FAILURE_ROUTE, BRANCH_ROUTE.
Example 1.18. ts_usec_delta usage
...
ts_usec_delta($var(t1s), 300, 10, $var(t2ms), $var(result));
...
1.4.13. check_time_rec(time_string, [timestamp])
The function returns a positive value if the specified time
recurrence string matches the current time, or a negative value
otherwise.
For checking something else than the current time, the third
parameter will contain the UNIX timestamp of the time to check.
The syntax of each field is identical to the corresponding
field from RFC 2445.
This function may be used from any route. It returns 1 on
success and -1, -2 or -3 on failure, parsing or internal
errors, respectively.
Meaning of the parameters is as follows:
* time_string (string) - Time recurrence string which will be
matched against the current time. Its fields are separated
by "|" and the order in which they are given is: "timezone
| dtstart | dtend | duration | freq | until | interval |
byday | bymday | byyday | byweekno | bymonth".
None of the fields following "freq" is used unless "freq"
is defined. If the string ends in multiple null fields,
they can all be ommited.
The "timezone" field is optional. It represents the
timezone in which to interpret the time recurrence elements
(e.g. dtstart, dtend, until). By default, the system time
zone is used.
* timestamp (string, optional) - A specific UNIX time to
check. The function simply expects the actual UNIX time
here, there is no need to perform any timezone adjustments.
Additionally, more complex time recurrence strings may be built
by connecting multiple time recurrence strings (described
above) using the logical AND ("&"), OR ("/") and NEG ("!")
operators. Furthermore, the expressions may be paranthesized.
Some examples:
* 20210104T080000|20211231T180000||WEEKLY|||MO,TU,WE,TH,FR &
!20210104T120000|20211231T140000||WEEKLY|||MO,TU,WE,TH,FR
This example multi-recurrence expresses the working days
schedule for company X during 2021: workdays from 8-18,
except the 12-14 interval, when everyone is out for lunch
break and the business is closed. Since the timezone is
omitted from each schedule, the operating system timezone
will be used instead.
* America/New_York|20210104T090000|20210104T170000||WEEKLY|||
MO,TU,WE,TH,FR &
!(Europe/Amsterdam|20210427T000000|20210428T000000 /
Europe/London|20211227T000000|20211228T000000)
This example multi-recurrence expresses the working days
schedule for US-based company Y during 2021: workdays from
9-17 (NY timezone), except european holidays such as King's
Day (April 27th, NL) or the Spring Bank Holiday (May 31st,
UK), when most of its workforce will have flown back to
Europe.
Example 1.19. check_time_rec usage
...
# Only passing if still in 2012 and on a Bucharest-compatible timezone
if (check_time_rec("Europe/Bucharest|20120101T000000|20130101T000000"))
xlog("Current system time matches the given Romanian time interv
al\n");
...
# Only passing if less than 30 days have passed from "dtstart", system t
imezone
if (check_time_rec("20121101T000000||p30d"))
xlog("Current time matches the given interval\n");
...
1.4.14. get_static_lock(key)
Acquire the static lock which corresponds to "key". In case the
lock is taken by another process, script execution will halt
until the lock is released. Attempting to acquire the lock a
second time by the same process, without releasing it first,
will result in a deadlock.
The static lock functions guarantee that two different strings
will never point to the same lock, thus avoiding introducing
unnecessary (and transparent!) synchronization between
processes. Their disadvantage is the nature of their parameters
(static strings), making them inappropriate in certain
scenarios.
Meaning of the parameters is as follows:
* key (static string) - key to be hashed in order to obtain
the index of a static lock
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE,
ONREPLY_ROUTE, BRANCH_ROUTE, LOCAL_ROUTE, STARTUP_ROUTE,
TIMER_ROUTE, EVENT_ROUTE.
Example 1.20. get_static_lock usage
# acquire and release a static lock
...
get_static_lock("Zone_1");
...
release_static_lock("Zone_1");
...
1.4.15. release_static_lock(key)
Release the static lock corresponding to "key". Nothing will
happen if the lock is not acquired.
Meaning of the parameters is as follows:
* key (static string) - key to be hashed in order to obtain
the index of a static lock.
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE,
ONREPLY_ROUTE, BRANCH_ROUTE, LOCAL_ROUTE, STARTUP_ROUTE,
TIMER_ROUTE|EVENT_ROUTE.
Example 1.21. release_static_lock usage
# acquire and release a static lock
...
get_static_lock("Zone_1");
...
release_static_lock("Zone_1");
...
1.4.16. get_dynamic_lock(key)
Acquire the dynamic lock corresponding to "key". In case the
lock is taken by another process, script execution will halt
until the lock is released. Attempting to acquire the lock a
second time by the same process, without releasing it first,
will result in a deadlock.
The dynamic lock functions have the advantage of allowing
string variables to be given as parameters, but the drawback to
this is that two strings may have the same hashed value, thus
pointing to the same lock. As a consequence, either two totally
separate regions of the script will be synchronized (they will
not execute in parallel), or a process could end up in a
deadlock by acquiring two locks in a row on two different (but
equally hashed) strings. To address the latter issue, use the
strings_share_lock() function to test if two strings hash into
the same dynamic lock.
Meaning of the parameters is as follows:
* key (var) - key to be hashed in order to obtain the index
of a dynamic lock from the pool
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE,
ONREPLY_ROUTE, BRANCH_ROUTE, LOCAL_ROUTE, STARTUP_ROUTE,
TIMER_ROUTE|EVENT_ROUTE.
Example 1.22. get_dynamic_lock usage
...
# acquire and release a dynamic lock on the "Call-ID" header field value
if (!get_dynamic_lock($ci)) {
xlog("Error while getting dynamic lock!\n");
}
...
if (!release_dynamic_lock($ci) {
xlog("Error while releasing dynamic lock!\n");
}
...
1.4.17. release_dynamic_lock(key)
Release the dynamic lock corresponding to "key". Nothing will
happen if the lock is not acquired.
Meaning of the parameters is as follows:
* key (var) - key to be hashed in order to obtain the index
of a dynamic lock from the pool
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE,
ONREPLY_ROUTE, BRANCH_ROUTE, LOCAL_ROUTE, STARTUP_ROUTE,
TIMER_ROUTE|EVENT_ROUTE.
Example 1.23. release_dynamic_lock usage
...
# acquire and release a dynamic lock on the "Call-ID" header field value
if (!get_dynamic_lock($ci)) {
xlog("Error while getting dynamic lock!\n");
}
...
if (!release_dynamic_lock($ci) {
xlog("Error while releasing dynamic lock!\n");
}
...
1.4.18. strings_share_lock(key1, key2)
A function used to test if two strings will generate the same
hash value. Its purpose is to prevent deadlocks resulted when a
process successively acquires two dynamic locks on two strings
which happen to point to the same lock.
Theoretically, the chance of two strings generating the same
hash value decreases proportionally to the increase of the
lock_pool_size parameter. In other words, the more dynamic
locks you configure the module with, the higher the chance that
all individual protected regions of your script will run in
parallel, without waiting for each other.
Meaning of the parameters is as follows:
* key1, key2 (string) - strings which will have their hash
values compared
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE,
ONREPLY_ROUTE, BRANCH_ROUTE, LOCAL_ROUTE, STARTUP_ROUTE,
TIMER_ROUTE|EVENT_ROUTE.
Example 1.24. strings_share_lock usage
...
# Proper way of acquiring two dynamic locks successively
if (!get_dynamic_lock($avp(foo))) {
xlog("Error while getting dynamic lock!\n");
}
if (!strings_share_lock($avp(foo), $avp(bar)) {
if (!get_dynamic_lock($avp(bar))) {
xlog("Error while getting dynamic lock!\n");
}
}
...
if (!strings_share_lock($avp(foo), $avp(bar)) {
if (!release_dynamic_lock($avp(bar)) {
xlog("Error while releasing dynamic lock!\n");
}
}
if (!release_dynamic_lock($avp(foo)) {
xlog("Error while releasing dynamic lock!\n");
}
...
1.4.19. get_accurate_time(sec, usec, [str_sec_usec])
Fetch the current UNIX time epoch with microsecond precision.
Optionally, print this value as a floating point number (3rd
parameter).
Meaning of the parameters is as follows:
* sec (int) - the current UNIX timestamp (integer part)
* usec (int) - the current UNIX timestamp (decimal part)
* str_sec_usec (string, optional) - the current UNIX
timestamp as a floating point number (6-digit precision)
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE,
ONREPLY_ROUTE, BRANCH_ROUTE, LOCAL_ROUTE, STARTUP_ROUTE,
TIMER_ROUTE, EVENT_ROUTE.
Example 1.25. get_accurate_time usage
...
get_accurate_time($var(sec), $var(usec));
xlog("Current UNIX timestamp: $var(sec) s, $var(usec) us\n");
...
1.5. Exported Asyncronous Functions
1.5.1. sleep(seconds)
Waits a number of seconds. This function does exactly the same
as sleep(), but in an asynchronous way. The script execution is
suspended until the waiting is done; then OpenSIPS resumes the
script execution via the resume route.
To read and understand more on the asynchronous functions, how
to use them and what are their advantages, please refer to the
OpenSIPS online Manual.
Example 1.26. async sleep usage
{
...
async( sleep("5"), after_sleep );
}
route[after_sleep] {
...
}
1.5.2. usleep(seconds)
Waits a number of micro-seconds. This function does exactly the
same as usleep(), but in an asynchronous way. The script
execution is suspended until the waiting is done; then OpenSIPS
resumes the script execution via the resume route.
To read and understand more on the asynchronous functions, how
to use them and what are their advantages, please refer to the
OpenSIPS online Manual.
Example 1.27. async usleep usage
{
...
async( usleep("1000"), after_usleep );
}
route[after_usleep] {
...
}
1.6. Exported MI Functions
1.6.1. rand_set_prop
Set the probability value to the given parameter.
Parameters:
* prob_proc - the parameter should be a percent value (number
from 0 to 99).
Example 1.28. rand_set_prob usage
...
$ opensips-cli -x mi rand_set_prob 10
...
1.6.2. rand_reset_prob
Reset the probability value to the inital start value.
This command don't need a parameter.
Example 1.29. rand_reset_prob usage
...
$ opensips-cli -x mi rand_reset_prob
...
1.6.3. rand_get_prob
Return the actual probability setting.
The function return the actual probability value.
Example 1.30. rand_get_prob usage
...
$ opensips-cli -x mi get_prob
The actual probability is 50 percent.
...
1.6.4. check_config_hash
Check if the actual config file hash is identical to the stored
one.
The function returns 200 OK if the hash values are identical,
400 if there are not identical, 404 if no file for hashing has
been configured and 500 on errors. Additional a short text
message is printed.
Example 1.31. check_config_hash usage
...
$ opensips-cli -x mi check_config_hash
The actual config file hash is identical to the stored one.
...
1.6.5. get_config_hash
Return the stored config file hash.
The function returns 200 OK and the hash value on success or
404 if no file for hashing has been configured.
Example 1.32. get_config_hash usage
...
$ opensips-cli -x mi get_config_hash
1580a37104eb4de69ab9f31ce8d6e3e0
...
1.6.6. shv_set
Set the value of a shared variable ($shv(name)).
Parameters:
* name : shared variable name
* type : type of the value
+ "int": integer value
+ "str": string value
* value : value to be set
Example 1.33. shv_set usage
...
$ opensips-cli -x mi shv_set debug int 0
...
1.6.7. shv_get
Get the value of a shared variable ($shv(name)).
Parameters:
* name : shared variable name. If this parameter is missing,
all shared variables are returned.
Example 1.34. shv_get usage
...
$ opensips-cli -x mi shv_get debug
$ opensips-cli -x mi shv_get
...
1.7. Exported Pseudo-Variables
1.7.1. $env(name)
This PV provides access to the environment variable 'name'.
Example 1.35. env(name) pseudo-variable usage
...
xlog("PATH environment variable is $env(PATH)\n");
...
1.7.2. $RANDOM
Returns a random value from the [0 - 2^31) range.
Example 1.36. RANDOM pseudo-variable usage
...
$avp(10) = ($RANDOM / 16777216); # 2^24
if ($avp(10) < 10) {
$avp(10) = 10;
}
append_to_reply("Retry-After: $avp(10)\n");
sl_send_reply(503, "Try later");
exit;
# normal message processing follows
1.7.3. $ctime(name)
The PV provides access to broken-down time attributes.
The "name" can be:
* sec - return seconds (int 0-59)
* min - return minutes (int 0-59)
* hour - return hours (int 0-23)
* mday - return the day of month (int 0-59)
* mon - return the month (int 1-12)
* year - return the year (int, e.g., 2008)
* wday - return the day of week (int, 1=Sunday - 7=Saturday)
* yday - return the day of year (int, 1-366)
* isdst - return daylight saving time status (int, 0 - DST
off, >0 DST on)
Example 1.37. ctime(name) pseudo-variable usage
...
if ($ctime(year) == 2008) {
xlog("request: $rm from $fu to $ru in year 2008\n");
}
...
1.7.4. $shv(name)
It is a class of pseudo-variables stored in shared memory. The
value of $shv(name) is visible across all opensips processes.
Each "shv" has single value and it is initialized to integer 0.
You can use "shvset" parameter to initialize the shared
variable. The module exports a set of MI functions to get/set
the value of shared variables.
Example 1.38. shv(name) pseudo-variable usage
...
modparam("cfgutils", "shvset", "debug=i:1")
...
if ($shv(debug) == 1) {
xlog("request: $rm from $fu to $ru\n");
}
...
Chapter 2. Contributors
2.1. By Commit Statistics
Table 2.1. Top contributors by DevScore^(1), authored
commits^(2) and lines added/removed^(3)
Name DevScore Commits Lines ++ Lines --
1. Liviu Chircu (@liviuchircu) 88 39 2903 1482
2. Henning Westerholt (@henningw) 29 18 1088 86
3. Bogdan-Andrei Iancu (@bogdan-iancu) 27 22 367 109
4. Razvan Crainea (@razvancrainea) 20 15 289 79
5. Vlad Patrascu (@rvlad-patrascu) 18 6 355 547
6. Elena-Ramona Modroiu 14 3 1183 7
7. Daniel-Constantin Mierla (@miconda) 12 10 84 32
8. Anca Vamanu 6 3 220 14
9. Ionel Cerghit (@ionel-cerghit) 5 1 18 161
10. Maksym Sobolyev (@sobomax) 4 2 15 8
All remaining contributors: Vlad Paiu (@vladpaiu), Sergio
Gutierrez, Konstantin Bokarius, Walter Doekes (@wdoekes), Peter
Lemenkov (@lemenkov), Edson Gellert Schubert.
(1) DevScore = author_commits + author_lines_added /
(project_lines_added / project_commits) + author_lines_deleted
/ (project_lines_deleted / project_commits)
(2) including any documentation-related commits, excluding
merge commits. Regarding imported patches/code, we do our best
to count the work on behalf of the proper owner, as per the
"fix_authors" and "mod_renames" arrays in
opensips/doc/build-contrib.sh. If you identify any
patches/commits which do not get properly attributed to you,
please submit a pull request which extends "fix_authors" and/or
"mod_renames".
(3) ignoring whitespace edits, renamed files and auto-generated
files
2.2. By Commit Activity
Table 2.2. Most recently active contributors^(1) to this module
Name Commit Activity
1. Liviu Chircu (@liviuchircu) Sep 2012 - Mar 2021
2. Maksym Sobolyev (@sobomax) Dec 2015 - Jan 2021
3. Razvan Crainea (@razvancrainea) Oct 2010 - Jan 2020
4. Bogdan-Andrei Iancu (@bogdan-iancu) Jul 2007 - Oct 2019
5. Vlad Patrascu (@rvlad-patrascu) May 2017 - Apr 2019
6. Peter Lemenkov (@lemenkov) Jun 2018 - Jun 2018
7. Ionel Cerghit (@ionel-cerghit) Dec 2015 - Dec 2015
8. Walter Doekes (@wdoekes) Jan 2015 - Jan 2015
9. Vlad Paiu (@vladpaiu) Jan 2013 - Jul 2014
10. Anca Vamanu Aug 2009 - Sep 2009
All remaining contributors: Sergio Gutierrez, Henning
Westerholt (@henningw), Daniel-Constantin Mierla (@miconda),
Elena-Ramona Modroiu, Konstantin Bokarius, Edson Gellert
Schubert.
(1) including any documentation-related commits, excluding
merge commits
Chapter 3. Documentation
3.1. Contributors
Last edited by: Liviu Chircu (@liviuchircu), Bogdan-Andrei
Iancu (@bogdan-iancu), Razvan Crainea (@razvancrainea), Peter
Lemenkov (@lemenkov), Vlad Patrascu (@rvlad-patrascu), Anca
Vamanu, Sergio Gutierrez, Henning Westerholt (@henningw),
Daniel-Constantin Mierla (@miconda), Elena-Ramona Modroiu,
Konstantin Bokarius, Edson Gellert Schubert.
Documentation Copyrights:
Copyright © 2007-2008 1und1 Internet AG
Copyright © 2007-2008 BASIS AudioNet GmbH
Copyright © 2007-2008 Elena-Ramona Modroiu
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。