verify the return value of append_branch()

[Port from 2.0] Fixed authentication issue for non-REGISTER requests
Thanks to Stefan Sayer for this out!

Two configuration variables are introduced that can help
troubleshooting memory leaks: mem_dump_pkg, and mem_dump_shm
Useage:

sercmd cfg.set_now_int mem_dump_pkg <pid_number>
  Dumps the pkg memory status of the given processs

sercmd cfg.set_now_int mem_dump_shm 1
  Dumps the shm memory status

include cfg_rpc module in the standard module list

added missing '{'

missing include statement is fixed

adding sems to dependencies of ser-ai1 package

added registrar module modparam to limit maximum number of contacts

Various warnings fixed (mostly appearing with 64b compiles).

Closes issue SER-343.

New selects exported, allowing to dissecting the content of an attribute by
interpreting it as a "name-addr" value.

Ex.:
$loaded_uri = "\"display name\" <UserName@HostName;param>"
$user = @avp["$loaded_uri"].nameaddr.uri.user

'$user' will contain "UserName".

Closes issue #SER-365.

New TM export - cancel_all_uacs() - to allow canceling all branches of a
transaction. (Closes issue #SER-253).

Some error messages are corrected to reflect new function name.

(Bits of code for the AS support also added; issue #SER-346 in the works.)

Message flags are updated in shared memory even if they are modified
after the first t_newtran() function call.
Fixes SER-297

New script directive to allow specifying the modules' path. This is equivalent
to the command line parameter -L.

Example:

loadpath "/usr/lib/ser/modules/"
loadmodule "maxfwd"

Closes issue #SER-364.

Do not print out "no more records" ERROR message when use_dns_failover
is enabled, it is not an error, simply there is no more destination
in the SRV or A record.

Message lumps are saved to shared memory when t_relay() is called
the first time, instead of saving them by t_newtran(). The advantage is
that the SIP msg modifications that are made after t_newtran() are saved
as well, and they are propagated to failure route.
t_save_lumps() function is introduced, it can be used to force saving
the lumps before t_relay(), check the doc for details.
Fixes SER-303

The change can be reverted by uncommenting #define POSTPONE_MSG_CLONING
in sip_msg.h.

select_list() function must not return the global class when the global
flag is not set.
Fixes SER-368

- added support for extra authentication checks along with comments explaining
  what is checked when and why. Disabled by default.

- Session Timer proxy support is introduced (RFC 4028)
- custom config parameters are added to the script
- t_relay_cancel() is enabled to bypass the routing logic if possible
- NAT fixes (patch from Nils Ohlmeier)
- Record routing and loose routing is split into two parts to support
encoding of AVPs that are lately set in the script (patch from
Nils Ohlmeier)

on_sl_reply module parameter is introduced:
It defines the route block that is called if a reply with no associated
transaction is received.
Closes SER-330

t_drop_replies() script function is introduced.
It can be used to drop the received replies in failure_route block,
and disable all the previous replies to be selected again.
Closes SER-301

fixing function name in the error message

typo fixed

fixing nathelper module parameter name to natping_crlf

- fix: sip_msg_cloner wrongly translated parsed_uri when the message had
 new_uri set (probably not seen until now because we set parsed_uri_ok to 0
  on failure route and we didn't have non-failure callbacks causing the uri to
  be reparsed)

- use cancel_b_method also when CANCEL-ing due to received 6xx

- cancel_b_method is now 1 by default => changes default cancel unreplied
 branch behaviour: keep retransmitting the INVITE until a response is received
 or the timeout kicks in (if the received response is provisional a CANCEL
 will be automatically sent back). To revert to the old behaviour (stop
 retransmissions and send back fake 487s) use
 modparam("tm", "cancel_b_method", 0).

uncommented disabling crlf natping

reparse_on_dns_failover module parameter is introduced
(I forgot the commint the config files)

- Requests after a DNS failover are constructed from the outgoing
message buffer of the failed branch instead of from the incomming
request.
- reparse_on_dns_failover module parameter is introduced.
Closes SER-300

log message is changed to debug level in cfg_lookup_var(),
the message does not indicate an error in the framework

debian debconf - forgotten +++ removed

- missing docs for the cancel_b_method tm parameter

debian debconf configuration - new separate question for ip address used for sending REGISTER replication

- added a new tm parameter (cancel_b_method) that selects between 3 different
behaviours when attempting to cancel a branch where no reply was received:
 0 (default) - stop request retransmission and send back a fake 487 (old ser
 behaviour) ;
 1 - keep retransmitting the request until a reply is received or the final
  reply timeout kicks in ;
 2 - stop request retransmission and send and retransmit a cancel on the
  branch (this is not rfc conformant, but IMHO it wouldn't hurt) .

added improved and modified onsip.org make_and_install wrapper script to simplify compile and installation. Run ./make_and_install to see docs. NOTE! Currently only tested for bash, patches to improve compatibility are welcome!

- base64 functions from rr module moved to libcds to make them accessible from
  other modules.

various patches from Alfred, anti-relay-to-private-address-space
protection added

- fixed latest changes: restored @ (don't show .d creation commands), restored
  set -e, replaced {} with () (more portable)

Fixed %.d:%.c rule to fail if the target file was not created or is empty

- warning fix

- replaced strndup() in get_abs_pathname() since strndup is a GNU extensions
  not present in non glibc based OSes

- .d generation fix: sed with POSIX.1 re (e.g. Darwin, Solaris) does not
  support '\?' (or '\+' or '\|')

- store all the module response_f callbacks in an array (small performance
 improvement when lots of modules are loaded)

log_facility config parameter is declared in the cfg framework

- new script function: t_grep_status("code") -- returns true if any branch received code as the final reply (or if no final reply was yet received, but a
 "code" provisional reply).  [old patch]

- slight optimization of the pre-RFC3261 matching

- try matching e2e acks in t_lookup() only for transactions which are
interested in them (have the TMCB_E2EACK_IN or TMCB_E2EACK_RETR_IN callbacks
 registered). This should improve performance a little in the common case
 when no E2EACK callbacks are registered.
- e2e ack fix: when matching e2e acks use the saved totag list => no more
  problems with possible wrong transaction matching when a downstream forked
  INVITE arrives and more then one branch is replied with 2xx.

- e2e ack related fixes: - atomically mark seen e2e ack for a specific
                           branch/totag (the TMCB_E2EACK_IN callbacks should
                           now be called only once)
                         - for local transaction remember totags only if
                           the TMCB_LOCAL_COMPLETED callback is registered
                           (we use totags to avoid calling this callback
                            multiple times for the same retrans. final reply)

- fix: try to match acks first to negative replied transaction and only if
this fails take into account possible e2e proxied transaction matching (
matching to transactions replied w/ 2xx). This bug will appear if we have
several forked invites arriving at the proxy and one of them gets a negative
reply while another one gets a 2xx => the 2xx replied one might steal the
negative ack. Note: this doesn't fix the same problem when all the invites are
replied with 2xx (in this case all the e2e acks will be matched to the last
invite, but this would be a problem only for properly accounting e2e acks).
Thanks to Bogdan Pintea for spotting it.
Related to SER-346.

- cleanup: e2e_cancel() sets the cancel transaction label to be the same as the invite one only if E2E_CANCEL_HOP_BY_HOP is not defined. This is not a bugfix, because even if the labels are the same and the cancel is sent hop by hop there won't be any problem: the upstream cancel replies will match only the invite transaction and not the cancel, because the cancel transaction always has 0 branches in this case (it's used only for sending a reply back downstream).
Related to SER-346.

- t_check_status() fix: in some error case a noninit pointer could be used
 (patch from Bogdan Pintea <pintea@iptego.de>, part of SER-346)

- stop retransmissions even if a final reply is received before we have
 got a chance to start the retransmission timers.
Closes SER-362.

Select fixup is postponed until the config is shmized, if the fixup
fails at parsing time. It can happen that the config group is not ready
at parsing time (dynamic group), but a module tries to parse a @cfg_get
select call in mod_init, or when the modparams are parsed.

added depenedency to serweb to ser-ai1 meta-package

Call set_final_timer() only if the reply is really going to be
sent out.
Closes SER-302

Do not check uac->request.t_active when performing DNS failover
upon receiving a 503 response, t_active is always 0 in this case.
Closes SER-361

t_reset_fr(), t_reset_retr(), and t_reset_max_lifetime() are added,
they can be used to reset the timer values to the default setting.
Closes SER-360

- make config parse error stick out
 Patch from Bogdan Pintea <pintea@iptego.de>.
Closes: SER-337

- fix/improvement: the cmd line option '-c' returns -1, no matter if config is
 OK or not, making it difficult to use from start scripts that want to check
 the config first. Now it returns 0 if the config is ok.i
 Patch from Bogdan Pintea <pintea@iptego.de>.
Closes SER-336.

- fix: return status not checked when converting a string into a number in
comp_str(...) (used when comparing string to numbers in ser.cfg). Patch from
  Bogdan Pintea <pintea@iptego.de>.
Closes SER-338.

- CFG_ATOMIC flag is introduced: indicates that the variable can
be changed at any time, there is no need to wait for the SIP
message processing to finish

- debug config parameter is changed to CFG_ATOMIC type

NULL child callback value was not checked, when a cfg driver called
cfg_set_now() before forking.

- tcp flags cleanup (preparation for bigger tls related changes)

cfg_get_handle() is introduced, the function can be used to get the handle
of a module config group. Modules can read each other's configuration
if neccessary this way.

- fix: compile problems in io_watch_add if ser is compiled on linux with
NO_SIGIO=1 (patch from  Ondrej Martinek <ondra@iptel.org>)

fixing wrong placement of cfg_update() (thanks to Ondrej Martinek)

minor simplification: some memcpy()s are replaced with assignment

- adding any_uri.transport select
NOTE: if there is no transport parameter in the uri, it returns the default transport based on the uri type (sip/sips).

- fix e2e ACK with maddr in request-uri

tm module parameters are changed to use the configuration framework,
that means the parameters are changeable on-the-fly.
("fr_timer_avp", "fr_inv_timer_avp", and "tw_append" are left untouched)

CFG_UNREF is moved outside of the lock in cfg_install_global function
(shm_free()s might take longer)
Patch from Andrei

fixing the parameter of the per-child process callback, it did not
alway contain the variable name properly

do not allow dns_servers_no to be set higher than the number of
DNS servers defined in /etc/resolv.conf

pass the name of the changed variable to the callback in resolv_reinit()

- Added DB_NO_TZ flag, when set on a timestamp fields then
  timezone shifts/conversions will be inhibited. The flag
  has no effect on other field types.

fixing the construction of ACK and CANCEL: the requests may end with
CRLF CR CRLF by mistake (patch from Bogdan Pintea)

- use_dns_cache can be enabled/disabled runtime
- dns_cache_init is introduced: if set to 0, the dns cache is not
initialized, and cannot be enabled later (default is 1)
- dst_blacklist_init is introduced: if set to 0, the dst blacklist is
not initialized (similar to dns_cache_init) (default is 1)

- missing '(' in sed dep. rules fixed (thanks to Ondrej <ondra@iptel.org)

Closes: SER-354

- applied patch by Brocha Strous and Stefan Sayer
  closes SER-247

"#include <libgen.h>" is moved to ut.c because of dirname() function

DNS resolver and cache parameters use the configuration framework
that makes the config variables changeable on-the-fly.

- The resolver is reinitialized by each child process separately
when dns_retr_time, dns_retr_no, dns_servers_no, or dns_use_search_list
is changed.

- dns_reinit is introduced: the resolver is reinitialized when the
variable is set to 1, and the variable is reseted to 0 again.
It can be set via RPC for example, when /etc/resolv.conf changes,
but none of the SER config parameters are affected.

- A callback function is called by each child process after the resolver
has been reinitialized, if DNS_WATCHDOG_SUPPORT is enabled.

- socket_types is changed to be a global variable, and set by
fix_all_socket_lists(), because we have to remember for
the socket types, and do not allow dns_try_ipv6 to be enabled if there
is no ipv6 interface.

- minor bug is corrected: the expiration check is removed from
dns_cache_clean() function, when non-expired entries are deleted.

- Call the per-child process callback functions even if the
config variables are changed before forking, so the modules/core
will not miss the change.

- fixing a very unlikely bug: when a module kept forking and destroying
new processes runtime (only jabber module does so), and two variables
were changed after the forked process called called cfg_update()
and before exited, and both variables had per-child process callback,
and all the other child processes updated their own local config faster
then this one, the list of the callbacks was not released, thus the
memory was not freed.

- Make sure that the global cfg_file variable always contains
  full absolute pathname.
- Added get_abs_pathname function that can be used to convert
  relative pathnames to absolutes with using the location of
  cfg_file (or another file) as reference.

- make default pathnames of certificate files relative to the main
  SER config file

- verno++ to reflect the tcp changes

- avoid extra read syscalls (detect short reads) in poll_et or sigio_rt case
 (should improve performace)
- if POLLRDHUP or EPOLLRDHUP are supported (linux >= 2.6.17) use them
 and avoid an extra syscall on EOF
- on write error try to see if there's still some data in the socket read
 buffer and try to process it first (if there's no more data do a quick
  connection destroy)

- automatically "listen" for POLLRDHUP or EPOLLRDHUP if supported (linux
 only)

- uses spaces instead of tabs, otherwise gmake refuses to process it

- server-side database functions added

Make a difference between non-existing variable, and not readable variable
when the value cannot be retrieved. (reported by Vladimir Marek)

typo fixed

- fixed wrong request method check, discovered by Jan Andres

- fixed wrong variable used in get_to_uid, reported by
  Jan Andres

- added misssing get_to_uid, reported by Jan Andres

- obsolete scripts and utilities removed
  closes SER-308

- removed duplicated doxygen comment

- doxygen comment moved to the header file

- get_to_uid modified to retrieve the UID from the Request-URI for
  non-REGISTER requests, and from the To header for REGISTER requests.
  Closes SER-234

- fixed testing of return value of fix_param
  closes SER-323

cut'n'paste errors fixed