~ubuntu-branches/ubuntu/saucy/resiprocate/saucy-proposed

virtual asio::error_code connect(const std::string& address, unsigned short port) = 0; // !slg! modify port parameter later to be able to do SRV lookups

// Note: Shared Secret requests have been deprecated by RFC5389, and not

// widely implemented in RFC3489 - so not really needed at all

asio::error_code requestSharedSecret(char* username, unsigned int usernameSize,

char* password, unsigned int passwordSize);

// Set the username and password for all future requests

void setUsernameAndPassword(const char* username, const char* password, bool shortTermAuth=false);

// Stun Binding Method - use getReflexiveTuple() to get binding info

asio::error_code bindRequest();

// Turn Allocation Methods

asio::error_code createAllocation(unsigned int lifetime = UnspecifiedLifetime,

unsigned int bandwidth = UnspecifiedBandwidth,

unsigned char requestedProps = StunMessage::PropsNone,

UInt64 reservationToken = UnspecifiedToken,

StunTuple::TransportType requestedTransportType = StunTuple::None);

asio::error_code refreshAllocation();

asio::error_code destroyAllocation();

// Accessors for properties associated with an allocation

StunTuple& getRelayTuple();

StunTuple& getReflexiveTuple();

unsigned int getLifetime();

unsigned int getBandwidth();

// Methods to control active destination

asio::error_code setActiveDestination(const asio::ip::address& address, unsigned short port);

asio::error_code clearActiveDestination();

// Turn Send Methods

asio::error_code send(const char* buffer, unsigned int size);

asio::error_code sendTo(const asio::ip::address& address, unsigned short port, const char* buffer, unsigned int size);

// Receive Methods

asio::error_code receive(char* buffer, unsigned int& size, unsigned int timeout, asio::ip::address* sourceAddress=0, unsigned short* sourcePort=0);

asio::error_code receiveFrom(const asio::ip::address& address, unsigned short port, char* buffer, unsigned int& size, unsigned int timeout);

protected:

virtual asio::error_code rawWrite(const char* buffer, unsigned int size) = 0;

virtual asio::error_code rawWrite(const std::vector<asio::const_buffer>& buffers) = 0;

virtual asio::error_code rawRead(unsigned int timeout, unsigned int* bytesRead, asio::ip::address* sourceAddress=0, unsigned short* sourcePort=0) = 0;

virtual void cancelSocket() = 0;

// Local Binding Info

StunTuple mLocalBinding;

StunTuple mConnectedTuple;

// Authentication Info

resip::Data mUsername;

resip::Data mPassword;

resip::Data mHmacKey;

resip::Data mRealm;

resip::Data mNonce;

// Turn Allocation Properties used in request

unsigned int mRequestedLifetime;

unsigned int mRequestedBandwidth;

unsigned char mRequestedProps;

UInt64 mReservationToken;

StunTuple::TransportType mRequestedTransportType;

// Turn Allocation Properties from response

bool mHaveAllocation;

100

time_t mAllocationRefreshTime;

101

StunTuple mRelayTuple;

102

StunTuple mReflexiveTuple;

103

unsigned int mLifetime;

104

unsigned int mBandwidth;

105

106

ChannelManager mChannelManager;

107

typedef std::map<unsigned short, time_t> ChannelBindingRefreshTimeMap;

108

ChannelBindingRefreshTimeMap mChannelBindingRefreshTimes;

109

RemotePeer* mActiveDestination;

110

111

asio::io_service mIOService;

112

113

// handlers and timers required to do a timed out read

114

asio::deadline_timer mReadTimer;

115

size_t mBytesRead;

116

asio::error_code mReadErrorCode;

117

void startReadTimer(unsigned int timeout);

118

void handleRawRead(const asio::error_code& errorCode, size_t bytesRead);

119

void handleRawReadTimeout(const asio::error_code& errorCode);

120

121

// Read/Write Buffers

122

char mReadBuffer[8192];

123

char mWriteBuffer[8192];

124

bool mConnected;

125

126

private:

127

resip::Mutex mMutex;

128

asio::error_code channelBind(RemotePeer& remotePeer);

129

asio::error_code checkIfAllocationRefreshRequired();

130

asio::error_code checkIfChannelBindingRefreshRequired();

131

StunMessage* sendRequestAndGetResponse(StunMessage& request, asio::error_code& errorCode, bool addAuthInfo=true);

132

asio::error_code sendTo(RemotePeer& remotePeer, const char* buffer, unsigned int size);

133

asio::error_code handleStunMessage(StunMessage& stunMessage, char* buffer, unsigned int& size, asio::ip::address* sourceAddress=0, unsigned short* sourcePort=0);

134

asio::error_code handleRawData(char* data, unsigned int dataSize, unsigned int expectedSize, char* buffer, unsigned int& bufferSize);

135

};

136

137

}

138

139

#endif

140

141

142

/* ====================================================================

143

144

145

146

147

Redistribution and use in source and binary forms, with or without

148

modification, are permitted provided that the following conditions are

149

met:

150

151

1. Redistributions of source code must retain the above copyright

152

notice, this list of conditions and the following disclaimer.

153

154

2. Redistributions in binary form must reproduce the above copyright

155

notice, this list of conditions and the following disclaimer in the

156

documentation and/or other materials provided with the distribution.

157

158

3. Neither the name of Plantronics nor the names of its contributors

159

may be used to endorse or promote products derived from this

160

software without specific prior written permission.

161

162

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

163

"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

164

LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

165

A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

166

OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

167

SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

168

LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

169

DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

170

THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

171

(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

172

OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

173

174

==================================================================== */

Older »