|
Packit |
1fb8d4 |
/**
|
|
Packit |
1fb8d4 |
* FreeRDP: A Remote Desktop Protocol Implementation
|
|
Packit |
1fb8d4 |
* Transport Packets (TPKTs)
|
|
Packit |
1fb8d4 |
*
|
|
Packit |
1fb8d4 |
* Copyright 2011 Marc-Andre Moreau <marcandre.moreau@gmail.com>
|
|
Packit |
1fb8d4 |
*
|
|
Packit |
1fb8d4 |
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
Packit |
1fb8d4 |
* you may not use this file except in compliance with the License.
|
|
Packit |
1fb8d4 |
* You may obtain a copy of the License at
|
|
Packit |
1fb8d4 |
*
|
|
Packit |
1fb8d4 |
* http://www.apache.org/licenses/LICENSE-2.0
|
|
Packit |
1fb8d4 |
*
|
|
Packit |
1fb8d4 |
* Unless required by applicable law or agreed to in writing, software
|
|
Packit |
1fb8d4 |
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
Packit |
1fb8d4 |
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
Packit |
1fb8d4 |
* See the License for the specific language governing permissions and
|
|
Packit |
1fb8d4 |
* limitations under the License.
|
|
Packit |
1fb8d4 |
*/
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
#ifdef HAVE_CONFIG_H
|
|
Packit |
1fb8d4 |
#include "config.h"
|
|
Packit |
1fb8d4 |
#endif
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
#include "tpdu.h"
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
#include "tpkt.h"
|
|
Packit |
1fb8d4 |
|
|
Packit Service |
5a9772 |
#include <winpr/wlog.h>
|
|
Packit Service |
5a9772 |
|
|
Packit Service |
5a9772 |
#define TAG FREERDP_TAG("core.tpkt")
|
|
Packit Service |
5a9772 |
|
|
Packit |
1fb8d4 |
/**
|
|
Packit |
1fb8d4 |
* TPKTs are defined in:
|
|
Packit |
1fb8d4 |
*
|
|
Packit |
1fb8d4 |
* http://tools.ietf.org/html/rfc1006/
|
|
Packit |
1fb8d4 |
* RFC 1006 - ISO Transport Service on top of the TCP
|
|
Packit |
1fb8d4 |
*
|
|
Packit |
1fb8d4 |
* http://www.itu.int/rec/T-REC-T.123/
|
|
Packit |
1fb8d4 |
* ITU-T T.123 (01/2007) - Network-specific data protocol stacks for multimedia conferencing
|
|
Packit |
1fb8d4 |
*
|
|
Packit |
1fb8d4 |
* TPKT Header
|
|
Packit |
1fb8d4 |
* ____________________ byte
|
|
Packit |
1fb8d4 |
* | |
|
|
Packit |
1fb8d4 |
* | 3 (version) | 1
|
|
Packit |
1fb8d4 |
* |____________________|
|
|
Packit |
1fb8d4 |
* | |
|
|
Packit |
1fb8d4 |
* | Reserved | 2
|
|
Packit |
1fb8d4 |
* |____________________|
|
|
Packit |
1fb8d4 |
* | |
|
|
Packit |
1fb8d4 |
* | Length (MSB) | 3
|
|
Packit |
1fb8d4 |
* |____________________|
|
|
Packit |
1fb8d4 |
* | |
|
|
Packit |
1fb8d4 |
* | Length (LSB) | 4
|
|
Packit |
1fb8d4 |
* |____________________|
|
|
Packit |
1fb8d4 |
* | |
|
|
Packit |
1fb8d4 |
* | X.224 TPDU | 5 - ?
|
|
Packit |
1fb8d4 |
* ....
|
|
Packit |
1fb8d4 |
*
|
|
Packit |
1fb8d4 |
* A TPKT header is of fixed length 4, and the following X.224 TPDU is at least three bytes long.
|
|
Packit |
1fb8d4 |
* Therefore, the minimum TPKT length is 7, and the maximum TPKT length is 65535. Because the TPKT
|
|
Packit |
1fb8d4 |
* length includes the TPKT header (4 bytes), the maximum X.224 TPDU length is 65531.
|
|
Packit |
1fb8d4 |
*/
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
/**
|
|
Packit |
1fb8d4 |
* Verify if a packet has valid TPKT header.\n
|
|
Packit |
1fb8d4 |
* @param s
|
|
Packit |
1fb8d4 |
* @return BOOL
|
|
Packit |
1fb8d4 |
*/
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
BOOL tpkt_verify_header(wStream* s)
|
|
Packit |
1fb8d4 |
{
|
|
Packit |
1fb8d4 |
BYTE version;
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
Stream_Peek_UINT8(s, version);
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
if (version == 3)
|
|
Packit |
1fb8d4 |
return TRUE;
|
|
Packit |
1fb8d4 |
else
|
|
Packit |
1fb8d4 |
return FALSE;
|
|
Packit |
1fb8d4 |
}
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
/**
|
|
Packit |
1fb8d4 |
* Read a TPKT header.\n
|
|
Packit |
1fb8d4 |
* @param s
|
|
Packit |
1fb8d4 |
* @param length
|
|
Packit |
1fb8d4 |
* @return success
|
|
Packit |
1fb8d4 |
*/
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
BOOL tpkt_read_header(wStream* s, UINT16* length)
|
|
Packit |
1fb8d4 |
{
|
|
Packit |
1fb8d4 |
BYTE version;
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
if (Stream_GetRemainingLength(s) < 1)
|
|
Packit |
1fb8d4 |
return FALSE;
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
Stream_Peek_UINT8(s, version);
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
if (version == 3)
|
|
Packit |
1fb8d4 |
{
|
|
Packit Service |
5a9772 |
size_t slen;
|
|
Packit |
1fb8d4 |
UINT16 len;
|
|
Packit |
1fb8d4 |
if (Stream_GetRemainingLength(s) < 4)
|
|
Packit |
1fb8d4 |
return FALSE;
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
Stream_Seek(s, 2);
|
|
Packit |
1fb8d4 |
Stream_Read_UINT16_BE(s, len);
|
|
Packit Service |
5a9772 |
|
|
Packit Service |
5a9772 |
/* ITU-T Rec. T.123 8 Packet header to delimit data units in an octet stream */
|
|
Packit Service |
5a9772 |
if (len < 7)
|
|
Packit Service |
5a9772 |
{
|
|
Packit Service |
5a9772 |
WLog_ERR(TAG, "TPKT header too short, require minimum of 7 bytes, got %" PRId16, len);
|
|
Packit |
1fb8d4 |
return FALSE;
|
|
Packit Service |
5a9772 |
}
|
|
Packit |
1fb8d4 |
|
|
Packit Service |
5a9772 |
slen = Stream_GetRemainingLength(s) + 4;
|
|
Packit Service |
5a9772 |
if (len > slen)
|
|
Packit Service |
5a9772 |
{
|
|
Packit Service |
5a9772 |
WLog_ERR(TAG, "TPKT header length %" PRIu16 ", but only received %" PRIdz, len, slen);
|
|
Packit Service |
5a9772 |
return FALSE;
|
|
Packit Service |
5a9772 |
}
|
|
Packit |
1fb8d4 |
*length = len;
|
|
Packit |
1fb8d4 |
}
|
|
Packit |
1fb8d4 |
else
|
|
Packit |
1fb8d4 |
{
|
|
Packit |
1fb8d4 |
/* not a TPKT header */
|
|
Packit |
1fb8d4 |
*length = 0;
|
|
Packit |
1fb8d4 |
}
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
return TRUE;
|
|
Packit |
1fb8d4 |
}
|
|
Packit |
1fb8d4 |
|
|
Packit Service |
5a9772 |
BOOL tpkt_ensure_stream_consumed_(wStream* s, UINT16 length, const char* fkt)
|
|
Packit Service |
5a9772 |
{
|
|
Packit Service |
5a9772 |
size_t rem = Stream_GetRemainingLength(s);
|
|
Packit Service |
5a9772 |
if (rem > 0)
|
|
Packit Service |
5a9772 |
{
|
|
Packit Service |
5a9772 |
WLog_ERR(TAG,
|
|
Packit Service |
5a9772 |
"[%s] Received invalid TPKT header length %" PRIu16 ", %" PRIdz " bytes too long!",
|
|
Packit Service |
5a9772 |
fkt, length, rem);
|
|
Packit Service |
5a9772 |
return FALSE;
|
|
Packit Service |
5a9772 |
}
|
|
Packit Service |
5a9772 |
return TRUE;
|
|
Packit Service |
5a9772 |
}
|
|
Packit Service |
5a9772 |
|
|
Packit |
1fb8d4 |
/**
|
|
Packit |
1fb8d4 |
* Write a TPKT header.\n
|
|
Packit |
1fb8d4 |
* @param s
|
|
Packit |
1fb8d4 |
* @param length
|
|
Packit |
1fb8d4 |
*/
|
|
Packit |
1fb8d4 |
|
|
Packit |
1fb8d4 |
void tpkt_write_header(wStream* s, UINT16 length)
|
|
Packit |
1fb8d4 |
{
|
|
Packit Service |
5a9772 |
Stream_Write_UINT8(s, 3); /* version */
|
|
Packit Service |
5a9772 |
Stream_Write_UINT8(s, 0); /* reserved */
|
|
Packit |
1fb8d4 |
Stream_Write_UINT16_BE(s, length); /* length */
|
|
Packit |
1fb8d4 |
}
|