NAME¶
Net::SIP::NATHelper::Server - server for Net::SIP::NATHelper::Client
DESCRIPTION¶
This module is a wrapper around Net::SIP::NATHelper::Base and will receive it's
instructions from Net::SIP::NATHelper::Client using RPC via sockets.
CONSTRUCTOR¶
- new ( [ HELPER ], @FDS )
- Will create an object which listens on all file descriptors given in FDS
for RPC from clients.
If HELPER is given and a Net::SIP::NATHelper::Base object or derived it will
be used, otherwise the helper will be created.
METHODS¶
- do_command ( FD )
- Called when FD is available for reading. Calls accept on FD and
reads the RPC packet from the resulting file descriptor, executes it and
returns result back.
Currently implemented commands are "allocate","activate"
and "close" which will map to the local methods
allocate_sockets, activate_session and close_session.
One might redefine or add commands by changing
"$self->{commands}". The key of this hash reference is the
command name and the value is the callback.
Unknown commands will be ignored, e.g nothing returned.
- loop
- This will loop over all file descriptors it gets from callbacks in
Net::SIP::NATHelper::Base and the file descriptors for the RPC sockets.
When file descriptors gets available for reading it will execute the
callbacks, e.g. forward the RTP data or call do_command. In regular
intervals it will call expire from Net::SIP::NATHelper::Base to
expire the RTP sockets and sessions.
- allocate_sockets ( ... )
- Calls allocate_sockets of the local Net::SIP::NATHelper::Base
object. Takes and returns the same arguments.
- activate_session ( ... )
- Calls activate_session of the local Net::SIP::NATHelper::Base
object. Takes the same arguments and returns 1 if the session was newly
activated, -1 if it was activated before and false if activation failed.
Updates callbacks into the event loop.
- close_session ( ... )
- Calls activate_session of the local Net::SIP::NATHelper::Base
object. Takes the same arguments and returns the number of closed
sessions. Updates callbacks into the event loop.
- expire ( ... )
- Calls expire of the local Net::SIP::NATHelper::Base object. Takes
the same arguments and returns the number of expired sessions. Updates
callbacks into the event loop if necessary.
BUGS¶
The local event loop should be pluggable, so that other implementations could be
used. Right now it's a hard coded loop using select.