Revision history for Net::SIP

0.64 2011-10-25
- in stateless proxy: if incoming leg and outgoing leg are different add
  via header for incoming leg and use it when response comes in to find 
  the outgoing leg for the response
0.63 2011-10-10
- just call 0.62_12 0.63 because the last stable was released long ago
0.62_12 2011-10-07
- authorization infos gets copied to new call object if INVITE was received.
- add create_auth to Net::SIP::Simple, fix authorization for registrar (only
- add cb_invite callback to Net::SIP::Simple::Call, which gets triggered on
  reinvite from peer
- added more samples below samples/ directory
0.62_11 2011-09-11
- add authorization to listen, registrar, proxy
- add test for invite+reinvite+bye with authorization
- fix so that ACK and CANCEL reuse authorization from INVITE
0.62_10 2011-08-26
- reorder actions in Endpoint::Context::handle_response, so that 
  response requesting authorized BYE gets handled with authorized BYE 
  instead of ignoring it.
  Thanks to Roland Mas lolando[AT]debian[DOT]org for reporting the problem.
0.62_9 2011-05-17
- clarify behavior for bad packets in documentation (e.g. throw
0.62_8 2011-05-13
- deal with mailformed SDP body in Net::SIP::Simple::Call, e.g. catch
  error and ignore packet instead of letting the application die.
  Thanks to vitspec[AT]gmail[DOT]com reporting the problem.
0.62_7 2011-05-02
- fix Dispatcher::add_leg for arguments IO::Handle and Hash.
  Thanks to DetlefPilzecker[AT]web[DOT]de for reporting
0.62_6 2011-04-15
- fix UAC behavior for response to REGISTER in Net::SIP::Simple::register
  Thanks to dmw for reporting
0.62_5 2011-03-08
- fix to Net::SIP::Authorize::FromIsRealm. Here was not only the domain
  part compared to the realm but additionally the port if the sender
  was given as sip:user@host:port
  Thanks to DetlefPilzecker[AT]web[DOT]de for reporting
0.62_4 2011-02-14
- on permanent delivery failure callback was called within context
  with wrong order of arguments. Thanks to 
  james[AT]bolderthinking[DOT]com for reporting problem.
0.62_3 2011-02-03
- track which method started context and close context on final
  response (>=200) unless method was INVITE.
  Thanks to james[AT]bolderthinking[DOT]com for reporting problem.
0.62_2 2011-02-03
- changes to Net::SIP::Dropper* based on feedback from
0.62_1 2011-01-18
- add Net::SIP::Dropper incl. ...Dropper::{ByIPPort,ByField} based
  on a lot of input and code from DetlefPilzecker[AT]web[DOT]de
0.62 2010-12-06
- overwrite route header from record-route only for 200 response
  which established dialog, not for further responses
  Thanks to vitspec[AT]gmail[DOT]com for reporting.
0.61 2010-12-06
- overwrite route header from record-route only for first INVITE
  in context, not for re-INVITEs.
  Thanks to vitspec[AT]gmail[DOT]com for reporting.
0.60 2010-11-30
- overwrite route header from record-route only for INVITE.
  Thanks to vitspec[AT]gmail[DOT]com for reporting.
0.59_11 2010-11-02
- overwrite a given route header for any new request if there is
  already a route information for the given context.
  Thanks to vitspec[AT]gmail[DOT]com for reporting.
0.59_10 2010-11-01
- the route header in ACK must be set to the route it got by 
  record-route from the response (if any), instead of using the
  route from the INVITE.
  Thanks to vitspec[AT]gmail[DOT]com for reporting the bug. 
0.59_9 2010-09-09
- bugfix rport handling by DetlefPilzecker[AT]web[DOT]de
- clarify documentation of Net::SIP::Packet, e.g. that it die()s if
  it cannot parse string as SIP packet
0.59_8 2010-08-20
- fixes to 0.59_7 from DetlefPilzecker[AT]web[DOT]de
- added documentation for filter in Authorize
0.59_7 2010-08-17
- additional authorization based on idea of 
0.59_6 2010-08-09 
- fix unitialized warning in Authorize if user neither in user2a1
  nor in user2pass. 
- dispatcher: add recieved + rport to via only for requests
- Thanks again to DetlefPilzecker[AT]web[DOT]de
0.59_5 2010-08-09 
- fix Registrar to get the address for registration from 'To' header, 
  not 'From' header. Thanks again to DetlefPilzecker[AT]web[DOT]de
0.59_4 2010-08-08 
- fix rport handling. Thanks again to DetlefPilzecker[AT]web[DOT]de
0.59_3 2010-07-26
- fix Via:..;received= handling - should by IP of sending host, not
  of receiving leg. Moved setting it to dispatcher, and set target addr
  from received in Statelessproxy instead of lookup for leg with this
  addr.  Thanks again to DetlefPilzecker[AT]web[DOT]de
- added rport support to Via header (RFC 3581)
0.59_1 2010-07-22
- Leg: Via..received= should only contain ip, not ip:port.
  Thanks to DetlefPilzecker[AT]web[DOT]de for pointing out. Fix
  Leg and StatelessProxy (where it expects to get port)
0.59 2010-07-12
- Dispatcher::cancel_delivery returns true if delivery was canceled
- Blocker blocks all ACKS if all INVITE will be blocked, no mattter
  if the response is in delivery queue. Thanks to 
0.58_11 2010-07-09
- fix for Blocker + test from DetlefPilzecker[AT]web[DOT]de
0.58_10 2010-06-24
- if qop=auth,auth-int given respond with qop=auth
0.58_9 2010-06-24
- Endpoint::Context::request_delivery_done - do not remove 
  transaction, because in case of tcp delivery done will be called
  once request is send. transaction will be removed in handle_response
0.58_8 2010-06-24
- Request::authorize - accept qop="auth,auth-int".., e.g. es long 
  auth is specifified its ok. Based on Bug report from 
0.58_7 2010-06-11
- removed unused field outgoing_leg from Net::SIP::Dispatcher.
  Thanks to DetlefPilzecker[AT]web[DOT]de for pointing this out
0.58_6 2010-06-02
- fixes on based on reports from 
  - cancel_delivery in Authorize on ACK
0.58_4 2010-05-31
- fixes on based on reports from 
  - respond 200 to CANCEL
  - redirect everything except REGISTER, not only INVITE
0.58_3 2010-05-31
Based on patches from DetlefPilzecker[AT]web[DOT]de
- Net::SIP::Request::create_response - msg is optional, if not given
  a builtin msg for the code will be used. 
- new functionality: Net::SIP::Blocker provides way to block requests
  by method name with custom code
0.58_2 2010-05-31
- fix Net::SIP::Simple::register, so that it uses an explicitly 
  given contact unchanged. Bug report by 
0.58_1 2010-05-28
various fixes based on feedback and patches from 
- check authorization for CANCEL not only against INVITE:uri but also
  against CANCEL:uri. The RFC is not specific in this area
- Authorize: don't forward unauthorized ACKs
- ReceiveChain: filter callback need not to be code ref, especially
  if methods arg was used. Now called with invoke_callback instead

0.58 2010-04-15
- with 'perl -MNet::SIP=rtp:min-max' the ports to used for RTP can be
  restricted, useful if behind firewall with limited forwarding.
  See Net::SIP doku for more information.
  Thanks to DetlefPilzecker[AT]web[DOT]de for pointing out the problem.
0.57_4 2010-04-15
- Net::SIP::Endpoint::Context - set based on reply before
  invoking callback. Thanks <vitspec[AT]gmail[DOT]com> for input.
0.57_3 2010-04-15
- Net::SIP::Leg::receive: ignore packets with len<13 because any valid
  packet must be larger. Such packets are used for keep-alives.
  Thanks to DetlefPilzecker[AT]web[DOT]de for pointing out the problem.
0.57_2 2010-04-13
- added Net::SIP::Simple::Call::get_param as pendant to set_param based
  on patch from <dave[AT]3c[DOT]co[DOT]uk>
0.57_1 2010-04-13
- dispatcher calls receive callback with eval so that it does not 
  die on bad or unexpected packets. Thanks to <vitspec[AT]gmail[DOT]com>
  for pointing out the problem

0.57 2010-03-19
- save remote_contact from successful responses in context and use
  them as remote-URI in new requests. 
  Thanks to <vitspec[AT]gmail[DOT]com> for pointing out the problem.

0.56 2010-02-02
- fix CANCEL handling: instead of closing the context immediatly:
  - server should return 487 to client before closing the context
  - server should ignore ACKs for unknown contexts instead of 
    replying with 481
  - client should not close context after CANCEL but wait for 
    response too invite (probably 487) so that it can ACK it
  - extend t/11_invite_timeout.t to test for the behavior
  - thanks to <vitspec[AT]gmail[DOT]com> for pointing out the problems.

0.55_1 2010-02-02
- add samples/

0.55 2010-01-27
- Net::SIP::Redirect provides functionlity to redirect INVITES using
  information from registrar. Sample program
- fixes for Net::SIP::Authorize if no pass is known for user (or user
  is not known).
- fixes for Net::SIP::Authorize for ACK an CANCEL (no challenge 
  possible, credentials should be compared against INVITE method)

0.54 2009-09-04
- bugfix in Net::SIP::Packet::new_from_parts when the header was already
  given as list of Net::SIP::HeaderPair objects

0.53 2009-01-26
- add Option force_rewrite to Net::SIP::StatelessProxy so that it rewrites
  the contact even if incoming and outgoing legs are the same

0.52 2008-12-17
- removed changes from 0.47 - if 2xx response to INVITE contains
  contact header this is used as the base for the request-URI in ACK,
  not the one from the original INVITE

0.51 2008-12-16
- get to+tag from 2xx response on invite only when call is outgoing,
  e.g. not on re-INVITE from UAS where UAC send initial INVITE

0.50 2008-10-31
- release 0.49_3 as 0.50
0.49_3 2008-10-29
- Net::SIP::StatelessProxy - observe maddr of URI when forwarding
0.49_2 2008-10-29
- Net::SIP::Dispatcher - observe maddr and transport parameter of URI
  when finding peer
0.49_1 2008-10-23
- fixed code in Net::SIP::Simple::RTP where it dropped packets
  (and subsequently terminated the connection due to inactivity)
  when the 16bit RTP sequence counter overflowed

0.49  2008-09-30
- fixed Socket6::inet_pton based check for valid IP6 address in 
- fix bugs reported by gilad[AT]summit-tech[DOT]ca:
  - force Allow and Supported header only on INVITE req and 2xx response
    to INVITE, on 2xx responses to OPTIONS and on 405 responses
  - force Contact header only on INVITE req and it's 2xx response

- new function Net::SIP::Util::sip_uri_eq to check if two URIs mean the 
- fix bugs reported by gilad[AT]summit-tech[DOT]ca:
  - when comparing Route header in incoming/outgoing request with myself
    use sip_uri_eq instead of simple eq, because the URIs might be
    the same, but one might specify a default port while the other not
  - when adding record-route header in forward_outgoing check that the 
    top record-route header isn't myself (in case incoming and outgoing
    leg are the same)

- if contact header changes the URI of the dialog send the ACK with
  the original URI of the INVITE and change the dialogs URI afterwards

- support for canceling a call after some time of ringing based on
  input from
  see Net::SIP::Simple::Call documentation for sub reinvite, parameters
  ring_time, cb_noanswer. See also method cancel in this package
  feature gets used in samples/ too
- fix for t/*_fdleak for platforms, which use 2 fd for tempfiles (see Now it allocates a
  new fd simply by dup()ing STDOUT
- fix in Net::SIP::Dispatcher::Eventloop in case the select returned
  because of EINTR
- fixes in handling response in Net::SIP::Endpoint::Context for the case,
  that multiple requests shared the same tid (e.g. INVITE,CANCEL)
- support for user2a1 instead of user2pass in Net::SIP::Authorize based
  on input from Alex Revetski <revetski[AT]gmail[DOT]com>

- Net::SIP::Packet::sdp_body - content type is case insensitive,
  accept application/SDP etc
- more debug statements
- Dispatcher::EventLoop::addFD
  3rd arg name of callback to aid debugging
- Net::SIP::SDP - better check for IP6 address
- Leg: allow multiple contact header in request/response
- StatelessProxy: 
  - rewrite contact header only if incoming_leg!=outgoing_leg,
  - let it actuall define external rewrite function
  - prefix user in default rewrite contact with 'r' so that it does
    not look like phone number and doesn't irritate rewriting
  - fix rewriting, so that user part does not need to be \w+
  - split __forward_request into __forward_request_getleg and 
    __forward_request_getaddr for better subclassing
  - reduce <..> into .. in route before processing it
- Registrar: 
  - update all contact information at once, don't combine information 
    from different register requests
  - access to internal store, to save/restore it from disk with
- fix and extend bin/
  - add rewriting, e.g. 0XXX gets forward as XXX to host 
  - restore/save registry data on start/exit
  - rework lots of code
- Net::SIP::Debug: import can set debug function, level and export 
  function within the same call
- bugfix Net::SIP::Endpoint::Context::handle_response, see

- Net::SIP::Packet::get_header: if called in scalar to get the only
  one value and we have multiple values try if they are all the same
  and in this case return the uniq value instead of croaking
  Works around bug in proxy which issued two content-length headers
  with the same length as reported in
- fix test skip in t/*fdleak.t 

- enforce codec 0 PCMU/8000 in outgoing SDP generated based on
  incoming SDP, don't just accept all codecs the other party offers
  because Net::SIP::Simple can only PCMU/8000
- make header names per default ucfirst (Via not via)
- add default allow and supported headers to INVITE requests and
  2xx responses if none where given
- fix bug indroduced in 0.42, where contact from incoming INVITE
  was not used as URI for outgoing BYE for the call

- on 2xx responses set the URI of the dialog to the contact given
  in the response. For 302 retry the request with the URI set to
  the contact given in the 302 response.
- make sure that the right contact header is set. for outgoing
  invites and 2xx responses to invite combine the user part from the 
  sender ('from' for requests, 'to' for responses) with addr and port 
  from the outgoing leg - unless the contact was explicitly set.
- if a contact header was given in Net::SIP::Simple which had a
  port specification the port would be duplicated, e.g. 

- give 'contact' header to Net::SIP::Simple which is then used for
  invite and register
- more checks of data when parsing SIP header, more knowledge about 
  keys, where the values cannot be comma-seperated
- fix wrong call of ok() in t/03_forward_stateless
- fix
  (Net::SIP::Request::set_uri did not update string representation)

- Net::SIP::Simple::RTP - when sending data from file set the timestamp
  based on sequence number and packet size ( == samples in packet for 8bit)
- set Via header correct in the case of udp and port 5061.
  No longer set Via based on contact header, base it only on address
  of leg
- primitive support for other codecs in Net::SIP::Simple, see 
  rtp_param in Net::SIP::Simple::Call

- work around missing support for non-blocking sockets in IO::Socket
  on MSWin32 platform
- fix where the same realm
  was authorized again and again if the given user/pass where wrong

- fix dns lookup problem for SRV records. Instead of using the
  IP it used the service name (e.g. _sip._udp....) as the target
  of the packet
- bin/ - crude attempt to create filenames
  which don't have chars special to windows ('<',...)

- Endpoint::close_context now cancel all outstanding deliveries 
  for this context in the dispatcher. Extented queue objects 
  and Dispatcher::cancel_delivery to make this possible
- tests for file descriptor leaks (09_fdleak.t,10_fdleak.t)
- some more Scalar::Util::weaken for callbacks in Simple::Call
  to stop circular references

- small performance improvements for Net::SIP::Simple::RTP
  and samples/bench
- fixed race condition on Net::SIP::Dispatcher::Eventloop (e.g
  one callback disabled fd, but it tried to call callback for the
  disabled fd)
- added Net::SIP::Simple::cleanup and made some references to the
  objects within callbacks weak, so that no objects and file
  descriptors would leak if properly used

- Net::SIP::Simple::Call - close call context in $call->cleanup,
  otherwise it could leak file descriptors if the call wasn't
  closed clean (with BYE or CANCEL).
- new test applications for simple benchmarks in samples/bench
- documentation: new file samples/README describes the files in 

- Net::SIP::Simple: handle OPTIONS requests. These are for 
  instance used by Asterisk to determine if the registered 
  party accepts incoming calls.
- fix rt#29153 in ($1 from prev regex
  used after call of user function, which could change it)
- Endpoint::new_response - make sure that 2xx responses to
  INVITE carry a contact header

- Net::SIP::Registrar checks on non-REGISTER requests if the
  target it registered with itself and then rewrites the URI in
  the packet. This can be used for a combined Registar+Proxy,
  see samples/
- samples/invite_and_*.pl have now option -L|--leg to specify
  a local address

- make it usable for perl5.9, tested with 5.9.5

- Option cb_preliminary for Simple::Call:reinvite to specify
  callback which will be triggered when preliminary response
  is received
  more parameter for cb_create in Simple::listen, so that
  it can create a response (like 180 Ringing) to the peer
  see documentation and the adapted t/02_listen_and_invite.t

- make sure that max-forwards is added to every Request from the
  endpoint and that all INVITE have a contact header because these
  are mandatory according to RFC
- invoke 'filter' callback in Net::SIP::Simple::listen with the
  Request object as an additional argument, cb_create callback
  in listen needs to return TRUE or the call will be closed
  !!!! Warning: this might break code which did not return TRUE
  from cb_create !!!!!

- - make sure that nc-count is send when authorizing
  and qop was set. This is required according to rfc2617

-, - support 'opaque' field in digest
  authorization (when authorizing or when requesting authorization)

- - fix regex for IP4 which did not include all IPv4 addr

- small fixes to SDP
- added concept of chains, e.g. put an Authorize object in
  front of Registrar inside a ReceiveChain and all REGISTER
  requests will be authorized,
  see Net::SIP::{Authorize,ReceiveChain}
- StatelessProxy can no longer have an internal Registrar.
  use ReceiveChain to put a Registrar in front of the proxy
- new test t/ to test Authorize 
  and ReceiveChain
- fix Request::authorize
- make adding commands to NATHelper::Server easier
- add user params for NATHelper::Session during activate_session
- SDP: make sure that IP4/IP6 is valid IP
- small fixes

- fix memleak in NATHelper::Base
- support for derived NATHelper::Base in NATHelper::Server 
- update docu for NATHelper::Base::expire

- enforce perl5.8 and prerequisite Net::DNS in Makefile.PL
- NATHelper::Base - more controling of resource usage with
  max_sockets and max_sockets_in_group and/or by redefining

- new sample samples/ for 3rd party call control
- small fixes

- enhancements on tests, new tests for reinvite and call on hold
- lots of bugfixes: re-invites, NAT, call on hold, branch tag
  on via and 'tag' on to|from in responses, max-forwards handling,
  response caching in dispatcher....
- set route from record-route in responses, use route header
  in dispatching outgoing requests
- early loop detection for outgoing packets
- new param call_on_hold for Net::Simple::Call to set call on
  hold on reinvite...

- NATHelper::* changes in the return values of expire,
  close_session, activate_session to aid logging of
  sessions (see updated doc)
- NATHelper::Local has smarter _update_callbacks
- bugfixes, especially on Net::Simple regarding handling 
  of re-invites in existing call
- new test t/06_call_with_reinvite.t

- added documentation for Net::SIP::NATHelper::*
- updated doc for Net::SIP::StatelessProxy regarding NAT
- added HOWTO with some Q+A
- new method 'method' in Net::SIP::Response
- small bugfixes

- lots of bugfixes
- removed leg2proxy and domain2leg from Net::SIP::Dispatcher
  again because they do not fit into concept, see 
  bin/ how to achieve similar things
- lot of bugfixes, changes and enhancement on StatelessProxy
- Net::SIP can now export useful things, see doc
- a lot of enhancements for NAT, implementation of local
  (inside process) and remote NAT helpers which forward
  RTP data
- Net::SIP::Dispatcher: lookup for A an SRV records now in
  seperate, callback oriented method (which are not asynchronous
  yet, but have an asynchronous interface)
- moved real world usable programs from samples/ to bin/
- more tests, samples/ and bins/

- various bugfixes
- limit Max-Forwards header to 70 while forwarding packets
  for security reasons (to avoid bad clients which will set
  it to something very high and then try to force loop)
- do not add Record-Route header to REGISTER requests
- major changes and enhancements on Net::SIP::StatelessProxy
- rename Net::SIP::Dispatcher::Eventloop::addTimer to add_timer
  so that it is the same name like in the other modules
- Net::SIP::Simple: way to add explicit Route headers#
- new package Net::SIP::NATHelper do aid in the writing of 
  SIP proxies which do NAT (no documentation yet)
- support for debug levels in Net::SIP::Debug
  sample scripts support various debug levels, see doc to
  Net::SIP::Debug for meaning of different levels
- samples/ as sample implementation for
  slightly complex stateless proxy (not fully tested yet)
- new function sip_uri2parts in Net::SIP::Util
- ways to specify custom headers in Net::SIP::Simple using
  option 'sip_header'
- new keys domain2leg and leg2proxy in Net::SIP::Dispatcher
  which influence routing
- new method resolve_uri in Net::SIP::Dispatcher to asnychronously
  resolve URI (was __resolve_uri, but now public with slightly
  different interface)
- new test 03_forward_stateless which tests parts of routing
  for stateless proxy

- forgot to include samples to MANIFEST, this is fixed now
  so that they get included into the distribution

- samples/ as a sample implementation
  of an answer machine
- new methods peer in Net::SIP::Endpoint::Context and
  get_peer in Net::SIP::Simple::Call
- fix inactivity timeout for media_recv_send in Net::SIP::Simple::RTP
- media_send_recv, media_recv_echo in Net::SIP::Simple::RTP can use 
  callback for read/write data instead of filenames

- samples/ as new sample client
  which can invite and send multiple voice file
  to peer (using re-invites)
- various small bug fixes

- samples/ as new sample client
  which can invite and record a message
- various small features and bug fixes

0.1 - first public version