UdpTransport.hxx

Go to the documentation of this file.

#if !defined(RESIP_UDPTRANSPORT_HXX)
#define RESIP_UDPTRANSPORT_HXX
 
#include <memory>
#include "resip/stack/InternalTransport.hxx"
#include "resip/stack/MsgHeaderScanner.hxx"
#include "rutil/HeapInstanceCounter.hxx"
#include "resip/stack/Compression.hxx"
 
#include <array>
 
namespace osc { class Stack; }
 
namespace resip
{
class UdpTransport;
 
class ExternalUnknownDatagramHandler {
public:
   virtual ~ExternalUnknownDatagramHandler(){};
 
   virtual void operator()(UdpTransport* transport, const Tuple& source, std::unique_ptr<Data> unknownDatagram) = 0;
};
 
class UdpTransport : public InternalTransport, public FdPollItemIf
{
public:
   RESIP_HeapCount(UdpTransport);
   UdpTransport(Fifo<TransactionMessage>& fifo,
                int portNum,
                IpVersion version,
                StunSetting stun,
                const Data& interfaceObj,
                AfterSocketCreationFuncPtr socketFunc = nullptr,
                Compression &compression = Compression::Disabled,
                unsigned transportFlags = 0);
   virtual  ~UdpTransport();
 
   virtual bool isReliable() const { return false; }
   virtual bool isDatagram() const { return true; }
 
   virtual void process(FdSet& fdset);
   virtual void process();
   virtual bool hasDataToSend() const;
   virtual void buildFdSet( FdSet& fdset);
   virtual void setPollGrp(FdPollGrp *grp);
   virtual void setRcvBufLen(int buflen);
 
   // FdPollItemIf
   // virtual Socket getPollSocket() const;
   virtual void processPollEvent(FdPollEventMask mask);
 
   static constexpr int MaxMessageSize = 65535;
 
   // STUN client functionality
   enum StunResult
   {
       StunResultUnknown,
       StunResultSuccess,
       StunResultNoResponse,
       StunResultResponseParseFailed
   };
 
   bool stunSendTest(const Tuple& dest);
 
   StunResult stunResult(Tuple& mappedAddress);
 
   void setExternalUnknownDatagramHandler(ExternalUnknownDatagramHandler *handler);
 
protected:
 
   void processRxAll();
   int processRxRecv(Tuple& sender);
   void processRxParse(int len, const Tuple& sender);
   void processRxParseSip(char* buffer, int len, const Tuple& sender);
   void processTxAll();
   void processTxOne(SendData *data);
   void updateEvents();
 
   osc::Stack *mSigcompStack;
 
   // statistics
   unsigned mPollEventCnt;
   unsigned mTxTryCnt;
   unsigned mTxMsgCnt;
   unsigned mTxFailCnt;
   unsigned mRxTryCnt;
   unsigned mRxMsgCnt;
   unsigned mRxKeepaliveCnt;
   unsigned mRxTransactionCnt;
   std::array<char, MaxMessageSize> mRxBuffer{};
private:
#ifdef USE_SIGCOMP
   std::array<char, MaxMessageSize> mRxUncompressedBuffer{};
#endif
   MsgHeaderScanner mMsgHeaderScanner;
   mutable resip::Mutex  myMutex;
   Tuple mStunMappedAddress;
 
   StunResult mStunResult;
   StunSetting mStunSetting;
 
   // STUN client state for the outstanding Binding Request (guarded by myMutex).
   // Used to authenticate responses by source address and transaction id.
   bool mStunTxIdValid;                  // true while a request is outstanding
   std::array<unsigned char, 16> mStunTxId;  // transaction id (incl. magic cookie) of the request
   Tuple mStunServerTuple;               // address the request was sent to
 
   ExternalUnknownDatagramHandler* mExternalUnknownDatagramHandler;
   bool mInWritable;
};
 
}
 
#endif
 
/* ====================================================================
 * The Vovida Software License, Version 1.0
 *
 * Copyright (c) 2026 SIP Spectrum, Inc. https://www.sipspectrum.com
 * Copyright (c) 2000 Vovida Networks, Inc.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *
 * 3. The names "VOCAL", "Vovida Open Communication Application Library",
 *    and "Vovida Open Communication Application Library (VOCAL)" must
 *    not be used to endorse or promote products derived from this
 *    software without prior written permission. For written
 *    permission, please contact vocal@vovida.org.
 *
 * 4. Products derived from this software may not be called "VOCAL", nor
 *    may "VOCAL" appear in their name, without prior written
 *    permission of Vovida Networks, Inc.
 *
 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
 * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
 * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
 * IN EXCESS OF $1,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
 * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
 * DAMAGE.
 *
 * ====================================================================
 *
 * This software consists of voluntary contributions made by Vovida
 * Networks, Inc. and many individuals on behalf of Vovida Networks,
 * Inc.  For more information on Vovida Networks, Inc., please see
 * <http://www.vovida.org/>.
 *
 * vi: set shiftwidth=3 expandtab:
 */