#include <iax2ep.h>
Inheritance diagram for IAX2EndPoint:
worker Methods | |
| enum | IAX2RemoteAddressFields { protoIndex = 0, userIndex = 1, transportIndex = 2, addressIndex = 3, extensionIndex = 4, contextIndex = 5, maximumIndex = 6 } |
| enum | RegisteredError { RegisteredFailureUnknown } |
| enum | UnregisteredError { UnregisteredFailureUnknown } |
| IAX2Transmit * | transmitter |
| IAX2Receiver * | receiver |
| PBoolean | Initialise () |
| virtual void | IncomingEthernetFrame (IAX2Frame *frame) |
| PBoolean | ConectionForFrameIsAlive (IAX2Frame *f) |
| PINDEX | NextSrcCallNumber (IAX2Processor *processor) |
| void | ReportStoredConnections () |
| WORD | ListenPortNumber () |
| PString | GetLocalUserName () |
| PString | GetLocalNumber () |
| void | SetLocalUserName (PString newValue) |
| void | SetLocalNumber (PString newValue) |
| PString & | GetPassword () |
| void | SetPassword (PString newValue) |
| PBoolean | ConnectionForFrameIsAlive (IAX2Frame *f) |
| PINDEX | GetOutSequenceNumberForStatusQuery () |
| void | StartRinging (PString remoteCaller) |
| void | NewIncomingConnection (IAX2Frame *f) |
| void | OnEstablished (OpalConnection &con) |
| virtual void | OnReleased (OpalConnection &connection) |
| virtual OpalMediaFormatList | GetMediaFormats () const |
| virtual PBoolean | OnIncomingCall (IAX2Connection &conn) |
| PINDEX | GetSupportedCodecs (OpalMediaFormatList &list) |
| PINDEX | GetPreferredCodec (OpalMediaFormatList &list) |
| void | GetCodecLengths (PINDEX src, PINDEX &compressedBytes, PINDEX &duration) |
| void | ProcessReceivedEthernetFrames () |
| void | ReportTransmitterLists (PString &answer, bool getFullReport=false) |
| void | CopyLocalMediaFormats (OpalMediaFormatList &list) |
| void | Register (const PString &host, const PString &username, const PString &password=PString::Empty(), PINDEX requestedRefreshTime=60) |
| virtual void | OnRegistered (const PString &host, const PString &userName, PBoolean isFailure, RegisteredError reason=RegisteredFailureUnknown) |
| void | Unregister (const PString &host, const PString &username) |
| virtual void | OnUnregistered (const PString &host, const PString &userName, PBoolean isFailure, UnregisteredError reason=UnregisteredFailureUnknown) |
| PBoolean | IsRegistered (const PString &host, const PString &username) |
| PINDEX | GetRegistrationsCount () |
| PString | BuildUrl (const PString &host, const PString &userName=PString::Empty(), const PString &extension=PString::Empty(), const PString &context=PString::Empty(), const PString &transport=PString::Empty()) |
| static PStringArray | DissectRemoteParty (const PString &other) |
Public Member Functions | |
connection Connection handling | |
| virtual PBoolean | NewIncomingConnection (OpalTransport *transport) |
| virtual PBoolean | MakeConnection (OpalCall &call, const PString &party, void *userData=NULL, unsigned int options=0, OpalConnection::StringOptions *stringOptions=NULL) |
| virtual IAX2Connection * | CreateConnection (OpalCall &call, const PString &token, void *userData, const PString &remoteParty, const PString &remotePartyName=PString::Empty()) |
Protected Member Functions | |
| PBoolean | ProcessInMatchingConnection (IAX2Frame *f) |
| PBoolean | AddNewTranslationEntry (IAX2Frame *f) |
Protected Attributes | |
| IAX2IncomingEthernetFrames | incomingFrameHandler |
| IAX2FrameList | packetsReadFromEthernet |
| PUDPSocket * | sock |
| int | callnumbs |
| PMutex | callNumbLock |
| PTime | callStartTime |
| PString | localUserName |
| PString | localNumber |
| PString | password |
| PINDEX | statusQueryCounter |
| PMutex | statusQueryMutex |
| IAX2SpecialProcessor * | specialPacketHandler |
| PStringToString | tokenTable |
| PReadWriteMutex | mutexTokenTable |
| PAtomicInteger | callsEstablished |
| OpalMediaFormatList | localMediaFormats |
| PMutex | regProcessorsMutex |
| PArrayObjects | regProcessors |
enum of the components from a remote party address string These fields are from the address,
[iax2:]{username@][transport$]address[/extension][+context]
| IAX2EndPoint::IAX2EndPoint | ( | OpalManager & | manager | ) |
Create the endpoint, and define local variables
| IAX2EndPoint::~IAX2EndPoint | ( | ) |
Destroy the endpoint, and all associated connections
| IAX2EndPoint::IAX2EndPoint | ( | OpalManager & | manager | ) |
Create the endpoint, and define local variables
| IAX2EndPoint::~IAX2EndPoint | ( | ) |
Destroy the endpoint, and all associated connections
| virtual PBoolean IAX2EndPoint::NewIncomingConnection | ( | OpalTransport * | transport | ) | [virtual] |
Handle new incoming connection from listener.
The default behaviour does nothing.
| transport | Transport connection came in on |
Reimplemented from OpalEndPoint.
| virtual PBoolean IAX2EndPoint::MakeConnection | ( | OpalCall & | call, | |
| const PString & | party, | |||
| void * | userData = NULL, |
|||
| unsigned int | options = 0, |
|||
| OpalConnection::StringOptions * | stringOptions = NULL | |||
| ) | [virtual] |
Set up a connection to a remote party. This is called from the OpalManager::MakeConnection() function once it has determined that this is the endpoint for the protocol.
The general form for this party parameter is:
[iax2:]{username@][transport$]address[/extension][+context]
where the various fields will have meanings specific to the endpoint type. For example, with H.323 it could be "h323:Fred@site.com" which indicates a user Fred at gatekeeper size.com. Whereas for the PSTN endpoint it could be "pstn:5551234" which is to call 5551234 on the first available PSTN line.
The proto field is optional when passed to a specific endpoint. If it is present, however, it must agree with the endpoints protocol name or PFalse is returned.
This function usually returns almost immediately with the connection continuing to occur in a new background thread.
If PFalse is returned then the connection could not be established. For example if a PSTN endpoint is used and the assiciated line is engaged then it may return immediately. Returning a non-NULL value does not mean that the connection will succeed, only that an attempt is being made.
The default behaviour is pure.
| call | Owner of connection |
| party | Remote party to call |
| userData | Arbitrary data to pass to connection |
| options | options to pass to connection |
Implements OpalEndPoint.
| virtual IAX2Connection* IAX2EndPoint::CreateConnection | ( | OpalCall & | call, | |
| const PString & | token, | |||
| void * | userData, | |||
| const PString & | remoteParty, | |||
| const PString & | remotePartyName = PString::Empty() | |||
| ) | [virtual] |
Create a connection for the IAX endpoint. The default implementation is to create a IAX2Connection.
| token | Owner of connection |
| userData | token used to identify connection |
| remoteParty | User data for connection |
| remotePartyName | Url to call or is calling. Name to call or is calling. |
| PBoolean IAX2EndPoint::Initialise | ( | ) |
Setup the Endpoint internval variables, which is called at program startup.
| virtual void IAX2EndPoint::IncomingEthernetFrame | ( | IAX2Frame * | frame | ) | [virtual] |
Handle a received IAX frame. This may be a mini frame or full frame
| PBoolean IAX2EndPoint::ConectionForFrameIsAlive | ( | IAX2Frame * | f | ) |
A simple test to report if the connection associated with this frame is still alive. This test is used when transmitting the frame. If the connection is gone, don't bother transmitting the frame. There are exceptins to this rule, such as when a hangup packet is sent (which is after the connections has died.
| PINDEX IAX2EndPoint::NextSrcCallNumber | ( | IAX2Processor * | processor | ) |
Request a new source call number, one that is different to all other source call numbers for this program.
| void IAX2EndPoint::ReportStoredConnections | ( | ) |
Write the token of all connections in the connectionsActive structure to the trace file
| WORD IAX2EndPoint::ListenPortNumber | ( | ) | [inline] |
Report the port in use for IAX calls
| PString IAX2EndPoint::GetLocalUserName | ( | ) | [inline] |
Report the local username
| PString IAX2EndPoint::GetLocalNumber | ( | ) | [inline] |
Report the number used by the computer running this program
| void IAX2EndPoint::SetLocalUserName | ( | PString | newValue | ) |
Set the username to some value
| void IAX2EndPoint::SetLocalNumber | ( | PString | newValue | ) |
Set the local (on this host) number to some value
| PString& IAX2EndPoint::GetPassword | ( | ) | [inline] |
Report the password
| void IAX2EndPoint::SetPassword | ( | PString | newValue | ) |
Set the password to some value
| PBoolean IAX2EndPoint::ConnectionForFrameIsAlive | ( | IAX2Frame * | f | ) |
It is possible that a retransmitted frame has been in the transmit queue, and while sitting there that frames sending connection has died. Thus, prior to transmission, call tis method.
| PINDEX IAX2EndPoint::GetOutSequenceNumberForStatusQuery | ( | ) |
Get out sequence number to use on status query frames
| void IAX2EndPoint::StartRinging | ( | PString | remoteCaller | ) |
We have an incoming call. Do we accept ?
| void IAX2EndPoint::NewIncomingConnection | ( | IAX2Frame * | f | ) |
Handle new incoming connection from listener.
A return value of PTrue indicates that the transport object should be deleted by the caller. PFalse indicates that something else (eg the connection) has taken over responsibility for deleting the transport.
Well, that is true of Opal. In iax2, we do all the work of creating a new connection etc. The transport arguement is ignore. In Iax2, this method is void, as no value is returned. Further, in iax2, we process the incoming frame.
| f | Frame carrying the new request. |
| void IAX2EndPoint::OnEstablished | ( | OpalConnection & | con | ) | [virtual] |
A call back function whenever a connection is established. This indicates that a connection to an endpoint was established. This usually occurs after OnConnected() and indicates that the connection is both connected and has media flowing.
Reimplemented from OpalEndPoint.
| virtual void IAX2EndPoint::OnReleased | ( | OpalConnection & | connection | ) | [virtual] |
Called whenever a connection instance is finished being used to manage a call. We trap this callback to remove the connection from this endpoints token table. Once we are done the token table, we then call the generic OpalEndpoint::OnReleased method.
| connection | Connection that was established |
Reimplemented from OpalEndPoint.
| virtual OpalMediaFormatList IAX2EndPoint::GetMediaFormats | ( | ) | const [virtual] |
Get the data formats this endpoint is capable of operating. This provides a list of media data format names that may be used by an OpalMediaStream may be created by a connection from this endpoint.
Note that a specific connection may not actually support all of the media formats returned here, but should return no more.
The default behaviour is pure.
Reimplemented from OpalEndPoint.
| virtual PBoolean IAX2EndPoint::OnIncomingCall | ( | IAX2Connection & | conn | ) | [virtual] |
| PINDEX IAX2EndPoint::GetSupportedCodecs | ( | OpalMediaFormatList & | list | ) |
Return the bitmask which specifies the possible codecs we support
| PINDEX IAX2EndPoint::GetPreferredCodec | ( | OpalMediaFormatList & | list | ) |
Return the bitmask which specifies the preferred codec
| void IAX2EndPoint::GetCodecLengths | ( | PINDEX | src, | |
| PINDEX & | compressedBytes, | |||
| PINDEX & | duration | |||
| ) |
Get the frame size (bytes) and frame duration (ms) for compressed data from this codec
| static PStringArray IAX2EndPoint::DissectRemoteParty | ( | const PString & | other | ) | [static] |
Given a remote party name of the format:
[proto:][alias@][transport$]address[/extension]
pull the string apart and get the components. The compoents are stored in a PStringList, indexed by the enum RemoteAddressFields
| void IAX2EndPoint::ProcessReceivedEthernetFrames | ( | ) |
Pull frames off the incoming list, and pass on to the relevant connection. If no matching connection found, delete the frame. Repeat the process until no frames are left.
| void IAX2EndPoint::ReportTransmitterLists | ( | PString & | answer, | |
| bool | getFullReport = false | |||
| ) |
Report on the frames in the current transmitter class, which are pending transmission
| void IAX2EndPoint::CopyLocalMediaFormats | ( | OpalMediaFormatList & | list | ) |
Copy to the supplied OpalMediaList the media formats we support
| void IAX2EndPoint::Register | ( | const PString & | host, | |
| const PString & | username, | |||
| const PString & | password = PString::Empty(), |
|||
| PINDEX | requestedRefreshTime = 60 | |||
| ) |
Register with a remote iax2 server. The host can either be a hostname or ip address. The password is optional as some servers may not require it to register. The requested refresh time is the time that the registration should be refreshed in seconds. The time must be more than 10 seconds.
| virtual void IAX2EndPoint::OnRegistered | ( | const PString & | host, | |
| const PString & | userName, | |||
| PBoolean | isFailure, | |||
| RegisteredError | reason = RegisteredFailureUnknown | |||
| ) | [virtual] |
This is a call back if an event related to registration occurs. This callback should return as soon as possible.
| void IAX2EndPoint::Unregister | ( | const PString & | host, | |
| const PString & | username | |||
| ) |
Unregister from a registrar. This function is synchronous so it will block.
| virtual void IAX2EndPoint::OnUnregistered | ( | const PString & | host, | |
| const PString & | userName, | |||
| PBoolean | isFailure, | |||
| UnregisteredError | reason = UnregisteredFailureUnknown | |||
| ) | [virtual] |
This is a call back if an event related to unregistration occurs. This callback should return as soon as possible. Generally even if a failure occurs when unregistering it should be ignored because it does not matter to much that it couldn't unregister.
| PBoolean IAX2EndPoint::IsRegistered | ( | const PString & | host, | |
| const PString & | username | |||
| ) |
Check if an account is registered or being registered
| PINDEX IAX2EndPoint::GetRegistrationsCount | ( | ) |
Get the number of accounts that are being registered
| PString IAX2EndPoint::BuildUrl | ( | const PString & | host, | |
| const PString & | userName = PString::Empty(), |
|||
| const PString & | extension = PString::Empty(), |
|||
| const PString & | context = PString::Empty(), |
|||
| const PString & | transport = PString::Empty() | |||
| ) |
Builds a url
| PBoolean IAX2EndPoint::ProcessInMatchingConnection | ( | IAX2Frame * | f | ) | [protected] |
For the supplied IAX2Frame, pass it to a connection in the connectionsActive structure. If no matching connection is found, return PFalse;
If a matching connections is found, give the frame to the connection (for the connection to process) and return PTrue;
| PBoolean IAX2EndPoint::AddNewTranslationEntry | ( | IAX2Frame * | f | ) | [protected] |
The TokenTranslationDict may need a new entry. Examine the list of active connections, to see if any match this frame. If any do, then we add a new translation entry in tokenTable;
If a matching connection is found in connectionsActive, create a new translation entry and return PTrue. The connection, after processing the frame, will then delete the frame.
Pointer to the transmitter class, which is always valid
Pointer to the receiver class, which is always valid
Thread which transfers frames from the Receiver to the appropriate connection. It momentarily locks the connection list, searches through, and then completes the trasnsfer. If need be, this thread will create a new conneciton (to cope with a new incoming call) and add the new connections to the internal list.
IAX2FrameList IAX2EndPoint::packetsReadFromEthernet [protected] |
List of iax packets which has been read from the ethernet, and is to be sent to the matching IAX2Connection
PUDPSocket* IAX2EndPoint::sock [protected] |
The socket on which all data is sent/received.
int IAX2EndPoint::callnumbs [protected] |
Number of active calls
PMutex IAX2EndPoint::callNumbLock [protected] |
lock on access to call numbers variable
PTime IAX2EndPoint::callStartTime [protected] |
Time when a call was started
PString IAX2EndPoint::localUserName [protected] |
Name of this user, which is used as the IeCallingNumber
PString IAX2EndPoint::localNumber [protected] |
Number, as used by the computer on the host running this program
PString IAX2EndPoint::password [protected] |
Password for this user, which is used when processing an authentication request
PINDEX IAX2EndPoint::statusQueryCounter [protected] |
Counter to use for sending on status query frames
PMutex IAX2EndPoint::statusQueryMutex [protected] |
Mutex for the statusQueryCounter
IAX2SpecialProcessor* IAX2EndPoint::specialPacketHandler [protected] |
Pointer to the Processor class which handles special packets (eg lagrq) that have no destination call to handle them.
PStringToString IAX2EndPoint::tokenTable [protected] |
tokenTable is a hack to allow IAX2 to fit in with one of the demands of the opal library.
Opal demands that at connection setup, we know the unique ID which this call will use.
Since the unique ID is remote ip adress + remote's Source Call number, this is unknown if we are initiating the call. Consequently, this table is needed, as it provides a translation between the initial (or psuedo) token and the token that is later adopted
PReadWriteMutex IAX2EndPoint::mutexTokenTable [protected] |
Threading mutex on the variable tokenTable. We can now safely read/write to this table, with the minimum of interference between threads.
PAtomicInteger IAX2EndPoint::callsEstablished [protected] |
Thread safe counter which keeps track of the calls created by this endpoint. This value is used when giving outgoing calls a unique ID
OpalMediaFormatList IAX2EndPoint::localMediaFormats [protected] |
Local copy of the media types we can handle
PMutex IAX2EndPoint::regProcessorsMutex [protected] |
A mutex to protect the registerProcessors collection
PArrayObjects IAX2EndPoint::regProcessors [protected] |
An array of register processors. These are created when another class calls register and deleted when another class calls unregister or class destructor is called. This collection must be protected by the regProcessorsMutex
1.5.1