1 /*
2 * Protocol enumeration functions
3 *
4 * Copyright (C) 2001 Stefan Leichter
5 * Copyright (C) 2004 Hans Leidekker
6 *
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
11 *
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
20 */
21
22 /* 02/11/2004
23 * The protocol enumeration functions were verified to match Win2k versions
24 * for these protocols: IPX, SPX, SPXII, TCP/IP and UDP/IP.
25 */
26
27 #include "config.h"
28
29 #include <stdarg.h>
30 #include <stdio.h>
31 #include <string.h>
32
33 #include <sys/types.h>
34 #ifdef HAVE_ARPA_INET_H
35 #include <arpa/inet.h>
36 #endif
37 #ifdef HAVE_NETDB_H
38 #include <netdb.h>
39 #endif
40
41 #include "windef.h"
42 #include "winbase.h"
43 #include "wtypes.h"
44 #include "nspapi.h"
45 #include "winsock2.h"
46 #include "wsipx.h"
47 #include "wshisotp.h"
48 #include "ws2spi.h"
49
50 #include "wine/unicode.h"
51 #include "wine/debug.h"
52
53 WINE_DEFAULT_DEBUG_CHANNEL(winsock);
54
55 /* names of the protocols */
56 static const CHAR NameIpx[] = "IPX";
57 static const CHAR NameSpx[] = "SPX";
58 static const CHAR NameSpxII[] = "SPX II";
59 static const CHAR NameTcp[] = "TCP/IP";
60 static const CHAR NameUdp[] = "UDP/IP";
61
62 static const WCHAR NameIpxW[] = {'I', 'P', 'X', '\0'};
63 static const WCHAR NameSpxW[] = {'S', 'P', 'X', '\0'};
64 static const WCHAR NameSpxIIW[] = {'S', 'P', 'X', ' ', 'I', 'I', '\0'};
65 static const WCHAR NameTcpW[] = {'T', 'C', 'P', '/', 'I', 'P', '\0'};
66 static const WCHAR NameUdpW[] = {'U', 'D', 'P', '/', 'I', 'P', '\0'};
67
68 /* Taken from Win2k */
69 static const GUID ProviderIdIP = { 0xe70f1aa0, 0xab8b, 0x11cf,
70 { 0x8c, 0xa3, 0x00, 0x80, 0x5f, 0x48, 0xa1, 0x92 } };
71 static const GUID ProviderIdIPX = { 0x11058240, 0xbe47, 0x11cf,
72 { 0x95, 0xc8, 0x00, 0x80, 0x5f, 0x48, 0xa1, 0x92 } };
73 static const GUID ProviderIdSPX = { 0x11058241, 0xbe47, 0x11cf,
74 { 0x95, 0xc8, 0x00, 0x80, 0x5f, 0x48, 0xa1, 0x92 } };
75
76 /*****************************************************************************
77 * WINSOCK_EnterSingleProtocolW [internal]
78 *
79 * enters the protocol information of one given protocol into the given
80 * buffer.
81 *
82 * RETURNS
83 * 1 if a protocol was entered into the buffer.
84 * SOCKET_ERROR otherwise.
85 *
86 * BUGS
87 * - only implemented for IPX, SPX, SPXII, TCP, UDP
88 * - there is no check that the operating system supports the returned
89 * protocols
90 */
91 static INT WINSOCK_EnterSingleProtocolW( INT protocol, WSAPROTOCOL_INFOW* info )
92 {
93 memset( info, 0, sizeof(WSAPROTOCOL_INFOW) );
94 info->iProtocol = protocol;
95
96 switch (protocol)
97 {
98 case WS_IPPROTO_TCP:
99 info->dwServiceFlags1 = XP1_PARTIAL_MESSAGE | XP1_EXPEDITED_DATA |
100 XP1_GRACEFUL_CLOSE | XP1_GUARANTEED_ORDER |
101 XP1_GUARANTEED_DELIVERY;
102 info->ProviderId = ProviderIdIP;
103 info->dwCatalogEntryId = 0x3e9;
104 info->ProtocolChain.ChainLen = 1;
105 info->iVersion = 2;
106 info->iAddressFamily = WS_AF_INET;
107 info->iMaxSockAddr = 0x10;
108 info->iMinSockAddr = 0x10;
109 info->iSocketType = WS_SOCK_STREAM;
110 strcpyW( info->szProtocol, NameTcpW );
111 break;
112
113 case WS_IPPROTO_UDP:
114 info->dwServiceFlags1 = XP1_PARTIAL_MESSAGE | XP1_SUPPORT_BROADCAST |
115 XP1_SUPPORT_MULTIPOINT | XP1_MESSAGE_ORIENTED |
116 XP1_CONNECTIONLESS;
117 info->ProviderId = ProviderIdIP;
118 info->dwCatalogEntryId = 0x3ea;
119 info->ProtocolChain.ChainLen = 1;
120 info->iVersion = 2;
121 info->iAddressFamily = WS_AF_INET;
122 info->iMaxSockAddr = 0x10;
123 info->iMinSockAddr = 0x10;
124 info->iSocketType = WS_SOCK_DGRAM;
125 info->dwMessageSize = 0xffbb;
126 strcpyW( info->szProtocol, NameUdpW );
127 break;
128
129 case NSPROTO_IPX:
130 info->dwServiceFlags1 = XP1_PARTIAL_MESSAGE | XP1_SUPPORT_BROADCAST |
131 XP1_SUPPORT_MULTIPOINT | XP1_MESSAGE_ORIENTED |
132 XP1_CONNECTIONLESS;
133 info->ProviderId = ProviderIdIPX;
134 info->dwCatalogEntryId = 0x406;
135 info->ProtocolChain.ChainLen = 1;
136 info->iVersion = 2;
137 info->iAddressFamily = WS_AF_IPX;
138 info->iMaxSockAddr = 0x10;
139 info->iMinSockAddr = 0x0e;
140 info->iSocketType = WS_SOCK_DGRAM;
141 info->iProtocolMaxOffset = 0xff;
142 info->dwMessageSize = 0x240;
143 strcpyW( info->szProtocol, NameIpxW );
144 break;
145
146 case NSPROTO_SPX:
147 info->dwServiceFlags1 = XP1_IFS_HANDLES | XP1_PSEUDO_STREAM |
148 XP1_MESSAGE_ORIENTED | XP1_GUARANTEED_ORDER |
149 XP1_GUARANTEED_DELIVERY;
150 info->ProviderId = ProviderIdSPX;
151 info->dwCatalogEntryId = 0x407;
152 info->ProtocolChain.ChainLen = 1;
153 info->iVersion = 2;
154 info->iAddressFamily = WS_AF_IPX;
155 info->iMaxSockAddr = 0x10;
156 info->iMinSockAddr = 0x0e;
157 info->iSocketType = 5;
158 info->dwMessageSize = 0xffffffff;
159 strcpyW( info->szProtocol, NameSpxW );
160 break;
161
162 case NSPROTO_SPXII:
163 info->dwServiceFlags1 = XP1_IFS_HANDLES | XP1_GRACEFUL_CLOSE |
164 XP1_PSEUDO_STREAM | XP1_MESSAGE_ORIENTED |
165 XP1_GUARANTEED_ORDER | XP1_GUARANTEED_DELIVERY;
166 info->ProviderId = ProviderIdSPX;
167 info->dwCatalogEntryId = 0x409;
168 info->ProtocolChain.ChainLen = 1;
169 info->iVersion = 2;
170 info->iAddressFamily = WS_AF_IPX;
171 info->iMaxSockAddr = 0x10;
172 info->iMinSockAddr = 0x0e;
173 info->iSocketType = 5;
174 info->dwMessageSize = 0xffffffff;
175 strcpyW( info->szProtocol, NameSpxIIW );
176 break;
177
178 default:
179 if ((protocol == ISOPROTO_TP4) || (protocol == NSPROTO_SPX))
180 FIXME("Protocol <%s> not implemented\n",
181 (protocol == ISOPROTO_TP4) ? "ISOPROTO_TP4" : "NSPROTO_SPX");
182 else
183 FIXME("unknown Protocol <0x%08x>\n", protocol);
184 return SOCKET_ERROR;
185 }
186 return 1;
187 }
188
189 /*****************************************************************************
190 * WINSOCK_EnterSingleProtocolA [internal]
191 *
192 * see function WINSOCK_EnterSingleProtocolW
193 *
194 */
195 static INT WINSOCK_EnterSingleProtocolA( INT protocol, WSAPROTOCOL_INFOA* info )
196 {
197 memset( info, 0, sizeof(WSAPROTOCOL_INFOA) );
198 info->iProtocol = protocol;
199
200 switch (protocol)
201 {
202 case WS_IPPROTO_TCP:
203 info->dwServiceFlags1 = XP1_IFS_HANDLES | XP1_EXPEDITED_DATA |
204 XP1_GRACEFUL_CLOSE | XP1_GUARANTEED_ORDER |
205 XP1_GUARANTEED_DELIVERY;
206 info->ProviderId = ProviderIdIP;
207 info->dwCatalogEntryId = 0x3e9;
208 info->ProtocolChain.ChainLen = 1;
209 info->iVersion = 2;
210 info->iAddressFamily = WS_AF_INET;
211 info->iMaxSockAddr = 0x10;
212 info->iMinSockAddr = 0x10;
213 info->iSocketType = WS_SOCK_STREAM;
214 strcpy( info->szProtocol, NameTcp );
215 break;
216
217 case WS_IPPROTO_UDP:
218 info->dwServiceFlags1 = XP1_IFS_HANDLES | XP1_SUPPORT_BROADCAST |
219 XP1_SUPPORT_MULTIPOINT | XP1_MESSAGE_ORIENTED |
220 XP1_CONNECTIONLESS;
221 info->ProviderId = ProviderIdIP;
222 info->dwCatalogEntryId = 0x3ea;
223 info->ProtocolChain.ChainLen = 1;
224 info->iVersion = 2;
225 info->iAddressFamily = WS_AF_INET;
226 info->iMaxSockAddr = 0x10;
227 info->iMinSockAddr = 0x10;
228 info->iSocketType = WS_SOCK_DGRAM;
229 info->dwMessageSize = 0xffbb;
230 strcpy( info->szProtocol, NameUdp );
231 break;
232
233 case NSPROTO_IPX:
234 info->dwServiceFlags1 = XP1_IFS_HANDLES | XP1_SUPPORT_BROADCAST |
235 XP1_SUPPORT_MULTIPOINT | XP1_MESSAGE_ORIENTED |
236 XP1_CONNECTIONLESS;
237 info->ProviderId = ProviderIdIPX;
238 info->dwCatalogEntryId = 0x406;
239 info->ProtocolChain.ChainLen = 1;
240 info->iVersion = 2;
241 info->iAddressFamily = WS_AF_IPX;
242 info->iMaxSockAddr = 0x10;
243 info->iMinSockAddr = 0x0e;
244 info->iSocketType = WS_SOCK_DGRAM;
245 info->iProtocolMaxOffset = 0xff;
246 info->dwMessageSize = 0x240;
247 strcpy( info->szProtocol, NameIpx );
248 break;
249
250 case NSPROTO_SPX:
251 info->dwServiceFlags1 = XP1_IFS_HANDLES | XP1_PSEUDO_STREAM |
252 XP1_MESSAGE_ORIENTED | XP1_GUARANTEED_ORDER |
253 XP1_GUARANTEED_DELIVERY;
254 info->ProviderId = ProviderIdSPX;
255 info->dwCatalogEntryId = 0x407;
256 info->ProtocolChain.ChainLen = 1;
257 info->iVersion = 2;
258 info->iAddressFamily = WS_AF_IPX;
259 info->iMaxSockAddr = 0x10;
260 info->iMinSockAddr = 0x0e;
261 info->iSocketType = 5;
262 info->dwMessageSize = 0xffffffff;
263 strcpy( info->szProtocol, NameSpx );
264 break;
265
266 case NSPROTO_SPXII:
267 info->dwServiceFlags1 = XP1_IFS_HANDLES | XP1_GRACEFUL_CLOSE |
268 XP1_PSEUDO_STREAM | XP1_MESSAGE_ORIENTED |
269 XP1_GUARANTEED_ORDER | XP1_GUARANTEED_DELIVERY;
270 info->ProviderId = ProviderIdSPX;
271 info->dwCatalogEntryId = 0x409;
272 info->ProtocolChain.ChainLen = 1;
273 info->iVersion = 2;
274 info->iAddressFamily = WS_AF_IPX;
275 info->iMaxSockAddr = 0x10;
276 info->iMinSockAddr = 0x0e;
277 info->iSocketType = 5;
278 info->dwMessageSize = 0xffffffff;
279 strcpy( info->szProtocol, NameSpxII );
280 break;
281
282 default:
283 if ((protocol == ISOPROTO_TP4) || (protocol == NSPROTO_SPX))
284 FIXME("Protocol <%s> not implemented\n",
285 (protocol == ISOPROTO_TP4) ? "ISOPROTO_TP4" : "NSPROTO_SPX");
286 else
287 FIXME("unknown Protocol <0x%08x>\n", protocol);
288 return SOCKET_ERROR;
289 }
290 return 1;
291 }
292
293 /*****************************************************************************
294 * WSAEnumProtocolsA [WS2_32.@]
295 *
296 * see function WSAEnumProtocolsW
297 */
298 INT WINAPI WSAEnumProtocolsA( LPINT protocols, LPWSAPROTOCOL_INFOA buffer, LPDWORD len )
299 {
300 INT i = 0;
301 DWORD size = 0;
302 INT local[] = { WS_IPPROTO_TCP, WS_IPPROTO_UDP, NSPROTO_IPX, NSPROTO_SPX, NSPROTO_SPXII, 0 };
303
304 if (!protocols) protocols = local;
305
306 while (protocols[i]) i++;
307
308 size = i * sizeof(WSAPROTOCOL_INFOA);
309
310 if (*len < size || !buffer)
311 {
312 *len = size;
313 WSASetLastError(WSAENOBUFS);
314 return SOCKET_ERROR;
315 }
316
317 for (i = 0; protocols[i]; i++)
318 {
319 if (WINSOCK_EnterSingleProtocolA( protocols[i], &buffer[i] ) == SOCKET_ERROR)
320 return i;
321 }
322 return i;
323 }
324
325 /*****************************************************************************
326 * WSAEnumProtocolsW [WS2_32.@]
327 *
328 * Retrieves information about specified set of active network protocols.
329 *
330 * PARAMS
331 * protocols [I] Pointer to null-terminated array of protocol id's. NULL
332 * retrieves information on all available protocols.
333 * buffer [I] Pointer to a buffer to be filled with WSAPROTOCOL_INFO
334 * structures.
335 * len [I/O] Pointer to a variable specifying buffer size. On output
336 * the variable holds the number of bytes needed when the
337 * specified size is too small.
338 *
339 * RETURNS
340 * Success: number of WSAPROTOCOL_INFO structures in buffer.
341 * Failure: SOCKET_ERROR
342 *
343 * NOTES
344 * NT4SP5 does not return SPX if protocols == NULL
345 *
346 * BUGS
347 * - NT4SP5 returns in addition these list of NETBIOS protocols
348 * (address family 17), each entry two times one for socket type 2 and 5
349 *
350 * iProtocol szProtocol
351 * 0x80000000 \Device\NwlnkNb
352 * 0xfffffffa \Device\NetBT_CBENT7
353 * 0xfffffffb \Device\Nbf_CBENT7
354 * 0xfffffffc \Device\NetBT_NdisWan5
355 * 0xfffffffd \Device\NetBT_El9202
356 * 0xfffffffe \Device\Nbf_El9202
357 * 0xffffffff \Device\Nbf_NdisWan4
358 *
359 * - there is no check that the operating system supports the returned
360 * protocols
361 */
362 INT WINAPI WSAEnumProtocolsW( LPINT protocols, LPWSAPROTOCOL_INFOW buffer, LPDWORD len )
363 {
364 INT i = 0;
365 DWORD size = 0;
366 INT local[] = { WS_IPPROTO_TCP, WS_IPPROTO_UDP, NSPROTO_IPX, NSPROTO_SPX, NSPROTO_SPXII, 0 };
367
368 if (!protocols) protocols = local;
369
370 while (protocols[i]) i++;
371
372 size = i * sizeof(WSAPROTOCOL_INFOW);
373
374 if (*len < size || !buffer)
375 {
376 *len = size;
377 WSASetLastError(WSAENOBUFS);
378 return SOCKET_ERROR;
379 }
380
381 for (i = 0; protocols[i]; i++)
382 {
383 if (WINSOCK_EnterSingleProtocolW( protocols[i], &buffer[i] ) == SOCKET_ERROR)
384 return i;
385 }
386 return i;
387 }
388
389 /*****************************************************************************
390 * WSCEnumProtocols [WS2_32.@]
391 *
392 * PARAMS
393 * protocols [I] Null-terminated array of iProtocol values.
394 * buffer [O] Buffer of WSAPROTOCOL_INFOW structures.
395 * len [I/O] Size of buffer on input/output.
396 * errno [O] Error code.
397 *
398 * RETURNS
399 * Success: number of protocols to be reported on.
400 * Failure: SOCKET_ERROR. error is in errno.
401 *
402 * BUGS
403 * Doesn't supply info on layered protocols.
404 *
405 */
406 INT WINAPI WSCEnumProtocols( LPINT protocols, LPWSAPROTOCOL_INFOW buffer, LPDWORD len, LPINT err )
407 {
408 INT ret = WSAEnumProtocolsW( protocols, buffer, len );
409
410 if (ret == SOCKET_ERROR) *err = WSAENOBUFS;
411
412 return ret;
413 }
414
This page was automatically generated by the
LXR engine.
Visit the LXR main site for more
information.