util.hh

Go to the documentation of this file.

 
#pragma once
 
#ifdef _WIN32
#include <winsock2.h>
#include <windows.h>
#else
#include <sys/time.h>
#endif
 
// ssize_t definition for all systems
#if defined(_MSC_VER)
typedef SSIZE_T ssize_t;
#else
#include <sys/types.h>
#endif
 
#include <stdint.h>
 
 
typedef enum RTP_ERROR {
    RTP_MULTIPLE_PKTS_READY = 6,
    RTP_PKT_READY           = 5,
    RTP_PKT_MODIFIED        = 4,
    RTP_PKT_NOT_HANDLED     = 3,
    RTP_INTERRUPTED         = 2,
    RTP_NOT_READY           = 1,
    RTP_OK                  = 0,    
    RTP_GENERIC_ERROR       = -1,   
    RTP_SOCKET_ERROR        = -2,   
    RTP_BIND_ERROR          = -3,   
    RTP_INVALID_VALUE       = -4,   
    RTP_SEND_ERROR          = -5,   
    RTP_MEMORY_ERROR        = -6,   
    RTP_SSRC_COLLISION      = -7,   
    RTP_INITIALIZED         = -8,   
    RTP_NOT_INITIALIZED     = -9,   
    RTP_NOT_SUPPORTED       = -10,  
    RTP_RECV_ERROR          = -11,  
    RTP_TIMEOUT             = -12,  
    RTP_NOT_FOUND           = -13,  
    RTP_AUTH_TAG_MISMATCH   = -14,  
} rtp_error_t;
 
typedef enum RTP_FORMAT {
    // See RFC 3551 for more details
 
    // static audio profiles
    RTP_FORMAT_GENERIC    = 0,   
    RTP_FORMAT_PCMU       = 0,   
    // 1 is reserved in RFC 3551 
    // 2 is reserved in RFC 3551
    RTP_FORMAT_GSM        = 3,   
    RTP_FORMAT_G723       = 4,   
    RTP_FORMAT_DVI4_32    = 5,   
    RTP_FORMAT_DVI4_64    = 6,   
    RTP_FORMAT_LPC        = 7,   
    RTP_FORMAT_PCMA       = 8,   
    RTP_FORMAT_G722       = 9,   
    RTP_FORMAT_L16_STEREO = 10,  
    RTP_FORMAT_L16_MONO   = 11,  
    // 12 QCELP is unsupported in uvgRTP
    // 13 CN is unsupported in uvgRTP
    // 14 MPA is unsupported in uvgRTP
    RTP_FORMAT_G728       = 15,  
    RTP_FORMAT_DVI4_441   = 16,  
    RTP_FORMAT_DVI4_882   = 17,  
    RTP_FORMAT_G729       = 18,  
    // 19 is reserved in RFC 3551
    // 20 - 23 are unassigned in RFC 3551
 
    /* static video profiles, unsupported in uvgRTP
    * 24 is unassigned
    * 25 is CelB, 
    * 26 is JPEG
    * 27 is unassigned
    * 28 is nv
    * 29 is unassigned
    * 30 is unassigned
    * 31 is H261
    * 32 is MPV
    * 33 is MP2T
    * 32 is H263
    */
 
    /* Rest of static numbers
    * 35 - 71 are unassigned
    * 72 - 76 are reserved
    * 77 - 95 are unassigned
    */
    
    /* Formats with dynamic payload numbers 96 - 127, including default values.
    * Use RCC_DYN_PAYLOAD_TYPE flag to change the number if desired. */
 
    RTP_FORMAT_G726_40   = 96,  
    RTP_FORMAT_G726_32   = 97,  
    RTP_FORMAT_G726_24   = 98,  
    RTP_FORMAT_G726_16   = 99,  
    RTP_FORMAT_G729D     = 100, 
    RTP_FORMAT_G729E     = 101, 
    RTP_FORMAT_GSM_EFR   = 102, 
    RTP_FORMAT_L8        = 103, 
    // RED is unsupported in uvgRTP
    RTP_FORMAT_VDVI      = 104, 
    RTP_FORMAT_OPUS      = 105, 
    // H263-1998 is unsupported in uvgRTP
    RTP_FORMAT_H264      = 106, 
    RTP_FORMAT_H265      = 107, 
    RTP_FORMAT_H266      = 108  
    
} rtp_format_t;
 
typedef enum RTP_FLAGS {
    RTP_NO_FLAGS      = 0,
 
    RTP_OBSOLETE      = 1,
    RTP_SLICE         = 1, // used to do what RTP_NO_H26X_SCL does, may do something different in the future
 
    RTP_COPY          = 1 << 1,
 
    RTP_NO_H26X_SCL   = 1 << 2
 
} rtp_flags_t;
 
enum RTP_CTX_ENABLE_FLAGS {
    RCE_NO_FLAGS                  = 0,
 
    // Obsolete flags, they do nothing because the feature has been removed or they are enabled by default
    RCE_OBSOLETE                        = 1, // for checking if user inputs obsolete flags
    RCE_SYSTEM_CALL_DISPATCHER          = 1, // removed feature
    RCE_NO_H26X_INTRA_DELAY             = 1, // removed feature
    RCE_NO_H26X_SCL                     = 1, // this flag was moved to be an RTP flag
    RCE_H26X_NO_DEPENDENCY_ENFORCEMENT  = 1, // the feature is disabled by default
    RCE_H26X_PREPEND_SC                 = 1, // the feature is enabled by default
    RCE_NO_SYSTEM_CALL_CLUSTERING       = 1, // disabled by default
    RCE_SRTP_INPLACE_ENCRYPTION         = 1, // the feature is enabled by default
 
    // These can be used to specify what the address does for one address create session
    RCE_SEND_ONLY                   = 1 << 1, // address interpreted as remote, no binding to socket
    RCE_RECEIVE_ONLY                = 1 << 2, // address interpreted as local, sending not possible
 
    RCE_SRTP                        = 1 << 3,
 
    RCE_SRTP_KMNGMNT_ZRTP           = 1 << 4,
 
    RCE_SRTP_KMNGMNT_USER           = 1 << 5,
 
    RCE_H26X_DO_NOT_PREPEND_SC      = 1 << 6,
 
    RCE_H26X_DEPENDENCY_ENFORCEMENT = 1 << 7,
 
    RCE_FRAGMENT_GENERIC            = 1 << 8,
 
    RCE_SYSTEM_CALL_CLUSTERING      = 1 << 9,
 
    RCE_SRTP_NULL_CIPHER            = 1 << 10,
 
    RCE_SRTP_AUTHENTICATE_RTP       = 1 << 11,
 
    RCE_SRTP_REPLAY_PROTECTION      = 1 << 12,
 
    RCE_RTCP                        = 1 << 13,
 
    RCE_HOLEPUNCH_KEEPALIVE         = 1 << 14,
 
    RCE_SRTP_KEYSIZE_192            = 1 << 15,
 
    RCE_SRTP_KEYSIZE_256            = 1 << 16,
 
    RCE_ZRTP_MULTISTREAM_NO_DH      = 1 << 17,
 
    RCE_FRAMERATE                   = 1 << 18,
 
    RCE_FRAGMENT_PACING             = 1 << 19,
 
    RCE_LAST                        = 1 << 20
}; // maximum is 1 << 30 for int
 
 
enum RTP_CTX_CONFIGURATION_FLAGS {
    RCC_NO_FLAGS         = 0,
 
    RCC_UDP_RCV_BUF_SIZE = 1,
 
    RCC_UDP_SND_BUF_SIZE = 2,
 
    RCC_RING_BUFFER_SIZE = 3,
 
    RCC_PKT_MAX_DELAY    = 4,
 
    RCC_DYN_PAYLOAD_TYPE = 5,
 
    RCC_CLOCK_RATE       = 6,
 
    RCC_MTU_SIZE         = 7,
 
    RCC_FPS_ENUMERATOR   = 8,
 
    RCC_FPS_DENOMINATOR  = 9,
 
    RCC_LAST
};
 
extern thread_local rtp_error_t rtp_errno;