Scribd
Upload
2 views

WinsockTechNote

Uploaded by

Fabio Gaeta
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
2 views

WinsockTechNote

Uploaded by

Fabio Gaeta
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 6

TECHNOTE for Winsock API

Copyright © 1996-2008 by IntervalZero, Inc. All rights reserved.


No part of this document may be reproduced or transmitted in any form or by any means, graphic, electronic, or mechanical,
including photocopying, and recording or by any information storage or retrieval system without the prior written permission of
IntervalZero, Inc. unless such copying is expressly permitted by federal copyright law.
While every effort has been made to ensure the accuracy and completeness of all information in this document, IntervalZero,
Inc. assumes no liability to any party for any loss or damage caused by errors or omissions or by statements of any kind in this
document, its updates, supplements, or special editions, whether such errors, omissions, or statements result from negligence,
accident, or any other cause. IntervalZero, Inc. further assumes no liability arising out of the application or use of any product
or system described herein; nor any liability for incidental or consequential damages arising from the use of this document.
IntervalZero, Inc. disclaims all warranties regarding the information contained herein, whether expressed, implied or statutory,
including implied warranties of merchantability or fitness for a particular purpose.
IntervalZero, Inc. reserves the right to make changes to this document or to the products described herein without further
notice.
RTX, RT-TCP/IP, RtxTcpIpStack, Platform Evaluator, and TimeView are all trademarks of IntervalZero, Inc.
Microsoft, MS, and Win32 are registered trademarks and Windows Vista, Windows Server 2003, Windows XP, and Windows
2000 Server are trademarks of Microsoft Corporation.
All other companies and product names may be trademarks or registered trademarks of their respective holders.
TECHNOTE for Winsock API
September 2008
TECHNOTE

Overview
An RT-TCP/IP design goal is to have as much source-level compatibility as
possible between the RT-TCP/IP stack and the Winsock API (the API used to
develop TCP/IP applications for Microsoft Windows). The RT-TCP/IP stack is
based on Unicoi System's Fusion TCP/IP protocol stack. This stack implements
its own set of Fusion BSD Socket APIs for socket communication and
management. In order to accomplish source-level compatibility, a layer was
inserted into the RT-TCP/IP stack that translates between Microsoft Winsock
APIs and the Fusion BSD Socket APIs. During the course of this implementation,
a number of areas were identified where the Winsock API could not be translated
into a corresponding Fusion function call. For this reason, not all Winsock
functions and options are available when using the RT-TCP/IP stack. This
document details the most commonly used Winsock functions and options that
are not supported by RTX. Future documentation will expand this list to provide
details for all unsupported functions and options.

Unsupported Winsock Features


API Unsupported Features
getsockopt Some values for the optname parameter are not supported. See
“Unsupported Options for getsockopt and setsockopt” below.
recv This value for the optname parameter is not supported:
MSG_WAITALL
setsockopt Some values for the optname parameter are not supported. See
“Unsupported Options for getsockopt and setsockopt” below.
getaddrinfo These values for ai_flags in the hints parameter are not
supported:
AI_ADDRCONFIG
AI_NON_AUTHORITATIVE
AI_SECURE
AI_RETURN_PREFERRED_NAMES
getnameinfo These values for the flag parameter are not supported:
NI_NOFQDN
NI_NAMEREQD
NI_DGRAM
ioctlsocket This command is not supported for RTX 8.1 and earlier:
FIONREAD
WSAEventSelect These network event types are not supported in the RT-TCP/IP stack:
FD_QOS
FD_GROUP_QOS
FD_ROUTING_INTERFACE_CHANGE
FD_ADDRESS_LIST_CHANGE
4 TECHNOTE for Winsock API

Unsupported Options for getsockopt and setsockopt


Some values for the optname parameter are not supported for the
getsockopt and setsockopt functions. The following sections list the
unsupported options by socket type.

Note None of the options for the IPPROTO_RM, NSPROTO_IPX,


SOL_APPLETALK, and SOL_IRLMP socket types are supported.

Unsupported IPPROTO_IP socket options:


IP_HDRINCL
IP_OPTIONS
IP_PKTINFO
IP_RECEIVE_BROADCAST
IP_TOS

Unsupported IPPROTO_IPV6 socket options:


IPV6_ADD_MEMBERSHIP
IPV6_DROP_MEMBERSHIP
IPV6_HDRINCL
IPV6_HOPLIMIT
IPV6_MULTICAST_LOOP
IPV6_PKTINFO
IPV6_PROTECTION_LEVEL
IPV6_UNICAST_HOPS
IPV6_V6ONLY

Unsupported IPPROTO_TCP socket options:


TCP_BSDURGENT
TCP_EXPEDITED_1122

Unsupported IPPROTO_UDP socket options:


UDP_CHECKSUM_COVERAGE
UDP_NOCHECKSUM
5

Unsupported SOL_SOCKET socket options:


PVD_CONFIG
SO_BSP_STATE
SO_CONDITIONAL_ACCEPT
SO_CONNDATA
SO_CONNDATALEN
SO_CONNECT_TIME
SO_CONNOPT
SO_CONNOPTLEN
SO_DISCDATA
SO_DISCDATALEN
SO_DISCOPT
SO_DISCOPTLEN
SO_DONTLINGER
SO_ERROR
SO_EXCLUSIVEADDRUSE
SO_GROUP_ID
SO_GROUP_PRIORITY
SO_MAX_MSG_SIZE
SO_MAXDG
SO_MAXPATHDG
SO_OPENTYPE
SO_PORT_SCALABILITY
SO_PROTOCOL_INFO
SO_PROTOCOL_INFOA
SO_PROTOCOL_INFOW
SO_RCVLOWAT
SO_RCVTIMEO
SO_SNDLOWAT
SO_SNDTIMEO
SO_TYPE
SO_UPDATE_ACCEPT_CONTEXT
6 TECHNOTE for Winsock API

SO_UPDATE_CONNECT_CONTEXT
SO_USELOOPBACK

You might also like