rndis.c 29 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175
  1. /*
  2. * RNDIS MSG parser
  3. *
  4. * Authors: Benedikt Spranger, Pengutronix
  5. * Robert Schwebel, Pengutronix
  6. *
  7. * This program is free software; you can redistribute it and/or
  8. * modify it under the terms of the GNU General Public License
  9. * version 2, as published by the Free Software Foundation.
  10. *
  11. * This software was originally developed in conformance with
  12. * Microsoft's Remote NDIS Specification License Agreement.
  13. *
  14. * 03/12/2004 Kai-Uwe Bloem <linux-development@auerswald.de>
  15. * Fixed message length bug in init_response
  16. *
  17. * 03/25/2004 Kai-Uwe Bloem <linux-development@auerswald.de>
  18. * Fixed rndis_rm_hdr length bug.
  19. *
  20. * Copyright (C) 2004 by David Brownell
  21. * updates to merge with Linux 2.6, better match RNDIS spec
  22. */
  23. #include <linux/module.h>
  24. #include <linux/moduleparam.h>
  25. #include <linux/kernel.h>
  26. #include <linux/errno.h>
  27. #include <linux/init.h>
  28. #include <linux/list.h>
  29. #include <linux/proc_fs.h>
  30. #include <linux/slab.h>
  31. #include <linux/seq_file.h>
  32. #include <linux/netdevice.h>
  33. #include <asm/io.h>
  34. #include <asm/byteorder.h>
  35. #include <asm/unaligned.h>
  36. #undef VERBOSE_DEBUG
  37. #include "rndis.h"
  38. /* The driver for your USB chip needs to support ep0 OUT to work with
  39. * RNDIS, plus all three CDC Ethernet endpoints (interrupt not optional).
  40. *
  41. * Windows hosts need an INF file like Documentation/usb/linux.inf
  42. * and will be happier if you provide the host_addr module parameter.
  43. */
  44. #if 0
  45. static int rndis_debug = 0;
  46. module_param (rndis_debug, int, 0);
  47. MODULE_PARM_DESC (rndis_debug, "enable debugging");
  48. #else
  49. #define rndis_debug 0
  50. #endif
  51. #define RNDIS_MAX_CONFIGS 1
  52. static rndis_params rndis_per_dev_params[RNDIS_MAX_CONFIGS];
  53. /* Driver Version */
  54. static const __le32 rndis_driver_version = cpu_to_le32(1);
  55. /* Function Prototypes */
  56. static rndis_resp_t *rndis_add_response(int configNr, u32 length);
  57. /* supported OIDs */
  58. static const u32 oid_supported_list[] =
  59. {
  60. /* the general stuff */
  61. RNDIS_OID_GEN_SUPPORTED_LIST,
  62. RNDIS_OID_GEN_HARDWARE_STATUS,
  63. RNDIS_OID_GEN_MEDIA_SUPPORTED,
  64. RNDIS_OID_GEN_MEDIA_IN_USE,
  65. RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE,
  66. RNDIS_OID_GEN_LINK_SPEED,
  67. RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE,
  68. RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE,
  69. RNDIS_OID_GEN_VENDOR_ID,
  70. RNDIS_OID_GEN_VENDOR_DESCRIPTION,
  71. RNDIS_OID_GEN_VENDOR_DRIVER_VERSION,
  72. RNDIS_OID_GEN_CURRENT_PACKET_FILTER,
  73. RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE,
  74. RNDIS_OID_GEN_MEDIA_CONNECT_STATUS,
  75. RNDIS_OID_GEN_PHYSICAL_MEDIUM,
  76. /* the statistical stuff */
  77. RNDIS_OID_GEN_XMIT_OK,
  78. RNDIS_OID_GEN_RCV_OK,
  79. RNDIS_OID_GEN_XMIT_ERROR,
  80. RNDIS_OID_GEN_RCV_ERROR,
  81. RNDIS_OID_GEN_RCV_NO_BUFFER,
  82. #ifdef RNDIS_OPTIONAL_STATS
  83. RNDIS_OID_GEN_DIRECTED_BYTES_XMIT,
  84. RNDIS_OID_GEN_DIRECTED_FRAMES_XMIT,
  85. RNDIS_OID_GEN_MULTICAST_BYTES_XMIT,
  86. RNDIS_OID_GEN_MULTICAST_FRAMES_XMIT,
  87. RNDIS_OID_GEN_BROADCAST_BYTES_XMIT,
  88. RNDIS_OID_GEN_BROADCAST_FRAMES_XMIT,
  89. RNDIS_OID_GEN_DIRECTED_BYTES_RCV,
  90. RNDIS_OID_GEN_DIRECTED_FRAMES_RCV,
  91. RNDIS_OID_GEN_MULTICAST_BYTES_RCV,
  92. RNDIS_OID_GEN_MULTICAST_FRAMES_RCV,
  93. RNDIS_OID_GEN_BROADCAST_BYTES_RCV,
  94. RNDIS_OID_GEN_BROADCAST_FRAMES_RCV,
  95. RNDIS_OID_GEN_RCV_CRC_ERROR,
  96. RNDIS_OID_GEN_TRANSMIT_QUEUE_LENGTH,
  97. #endif /* RNDIS_OPTIONAL_STATS */
  98. /* mandatory 802.3 */
  99. /* the general stuff */
  100. RNDIS_OID_802_3_PERMANENT_ADDRESS,
  101. RNDIS_OID_802_3_CURRENT_ADDRESS,
  102. RNDIS_OID_802_3_MULTICAST_LIST,
  103. RNDIS_OID_802_3_MAC_OPTIONS,
  104. RNDIS_OID_802_3_MAXIMUM_LIST_SIZE,
  105. /* the statistical stuff */
  106. RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT,
  107. RNDIS_OID_802_3_XMIT_ONE_COLLISION,
  108. RNDIS_OID_802_3_XMIT_MORE_COLLISIONS,
  109. #ifdef RNDIS_OPTIONAL_STATS
  110. RNDIS_OID_802_3_XMIT_DEFERRED,
  111. RNDIS_OID_802_3_XMIT_MAX_COLLISIONS,
  112. RNDIS_OID_802_3_RCV_OVERRUN,
  113. RNDIS_OID_802_3_XMIT_UNDERRUN,
  114. RNDIS_OID_802_3_XMIT_HEARTBEAT_FAILURE,
  115. RNDIS_OID_802_3_XMIT_TIMES_CRS_LOST,
  116. RNDIS_OID_802_3_XMIT_LATE_COLLISIONS,
  117. #endif /* RNDIS_OPTIONAL_STATS */
  118. #ifdef RNDIS_PM
  119. /* PM and wakeup are "mandatory" for USB, but the RNDIS specs
  120. * don't say what they mean ... and the NDIS specs are often
  121. * confusing and/or ambiguous in this context. (That is, more
  122. * so than their specs for the other OIDs.)
  123. *
  124. * FIXME someone who knows what these should do, please
  125. * implement them!
  126. */
  127. /* power management */
  128. OID_PNP_CAPABILITIES,
  129. OID_PNP_QUERY_POWER,
  130. OID_PNP_SET_POWER,
  131. #ifdef RNDIS_WAKEUP
  132. /* wake up host */
  133. OID_PNP_ENABLE_WAKE_UP,
  134. OID_PNP_ADD_WAKE_UP_PATTERN,
  135. OID_PNP_REMOVE_WAKE_UP_PATTERN,
  136. #endif /* RNDIS_WAKEUP */
  137. #endif /* RNDIS_PM */
  138. };
  139. /* NDIS Functions */
  140. static int gen_ndis_query_resp(int configNr, u32 OID, u8 *buf,
  141. unsigned buf_len, rndis_resp_t *r)
  142. {
  143. int retval = -ENOTSUPP;
  144. u32 length = 4; /* usually */
  145. __le32 *outbuf;
  146. int i, count;
  147. rndis_query_cmplt_type *resp;
  148. struct net_device *net;
  149. struct rtnl_link_stats64 temp;
  150. const struct rtnl_link_stats64 *stats;
  151. if (!r) return -ENOMEM;
  152. resp = (rndis_query_cmplt_type *)r->buf;
  153. if (!resp) return -ENOMEM;
  154. if (buf_len && rndis_debug > 1) {
  155. pr_debug("query OID %08x value, len %d:\n", OID, buf_len);
  156. for (i = 0; i < buf_len; i += 16) {
  157. pr_debug("%03d: %08x %08x %08x %08x\n", i,
  158. get_unaligned_le32(&buf[i]),
  159. get_unaligned_le32(&buf[i + 4]),
  160. get_unaligned_le32(&buf[i + 8]),
  161. get_unaligned_le32(&buf[i + 12]));
  162. }
  163. }
  164. /* response goes here, right after the header */
  165. outbuf = (__le32 *)&resp[1];
  166. resp->InformationBufferOffset = cpu_to_le32(16);
  167. net = rndis_per_dev_params[configNr].dev;
  168. stats = dev_get_stats(net, &temp);
  169. switch (OID) {
  170. /* general oids (table 4-1) */
  171. /* mandatory */
  172. case RNDIS_OID_GEN_SUPPORTED_LIST:
  173. pr_debug("%s: RNDIS_OID_GEN_SUPPORTED_LIST\n", __func__);
  174. length = sizeof(oid_supported_list);
  175. count = length / sizeof(u32);
  176. for (i = 0; i < count; i++)
  177. outbuf[i] = cpu_to_le32(oid_supported_list[i]);
  178. retval = 0;
  179. break;
  180. /* mandatory */
  181. case RNDIS_OID_GEN_HARDWARE_STATUS:
  182. pr_debug("%s: RNDIS_OID_GEN_HARDWARE_STATUS\n", __func__);
  183. /* Bogus question!
  184. * Hardware must be ready to receive high level protocols.
  185. * BTW:
  186. * reddite ergo quae sunt Caesaris Caesari
  187. * et quae sunt Dei Deo!
  188. */
  189. *outbuf = cpu_to_le32(0);
  190. retval = 0;
  191. break;
  192. /* mandatory */
  193. case RNDIS_OID_GEN_MEDIA_SUPPORTED:
  194. pr_debug("%s: RNDIS_OID_GEN_MEDIA_SUPPORTED\n", __func__);
  195. *outbuf = cpu_to_le32(rndis_per_dev_params[configNr].medium);
  196. retval = 0;
  197. break;
  198. /* mandatory */
  199. case RNDIS_OID_GEN_MEDIA_IN_USE:
  200. pr_debug("%s: RNDIS_OID_GEN_MEDIA_IN_USE\n", __func__);
  201. /* one medium, one transport... (maybe you do it better) */
  202. *outbuf = cpu_to_le32(rndis_per_dev_params[configNr].medium);
  203. retval = 0;
  204. break;
  205. /* mandatory */
  206. case RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE:
  207. pr_debug("%s: RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE\n", __func__);
  208. if (rndis_per_dev_params[configNr].dev) {
  209. *outbuf = cpu_to_le32(
  210. rndis_per_dev_params[configNr].dev->mtu);
  211. retval = 0;
  212. }
  213. break;
  214. /* mandatory */
  215. case RNDIS_OID_GEN_LINK_SPEED:
  216. if (rndis_debug > 1)
  217. pr_debug("%s: RNDIS_OID_GEN_LINK_SPEED\n", __func__);
  218. if (rndis_per_dev_params[configNr].media_state
  219. == RNDIS_MEDIA_STATE_DISCONNECTED)
  220. *outbuf = cpu_to_le32(0);
  221. else
  222. *outbuf = cpu_to_le32(
  223. rndis_per_dev_params[configNr].speed);
  224. retval = 0;
  225. break;
  226. /* mandatory */
  227. case RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE:
  228. pr_debug("%s: RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE\n", __func__);
  229. if (rndis_per_dev_params[configNr].dev) {
  230. *outbuf = cpu_to_le32(
  231. rndis_per_dev_params[configNr].dev->mtu);
  232. retval = 0;
  233. }
  234. break;
  235. /* mandatory */
  236. case RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE:
  237. pr_debug("%s: RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE\n", __func__);
  238. if (rndis_per_dev_params[configNr].dev) {
  239. *outbuf = cpu_to_le32(
  240. rndis_per_dev_params[configNr].dev->mtu);
  241. retval = 0;
  242. }
  243. break;
  244. /* mandatory */
  245. case RNDIS_OID_GEN_VENDOR_ID:
  246. pr_debug("%s: RNDIS_OID_GEN_VENDOR_ID\n", __func__);
  247. *outbuf = cpu_to_le32(
  248. rndis_per_dev_params[configNr].vendorID);
  249. retval = 0;
  250. break;
  251. /* mandatory */
  252. case RNDIS_OID_GEN_VENDOR_DESCRIPTION:
  253. pr_debug("%s: RNDIS_OID_GEN_VENDOR_DESCRIPTION\n", __func__);
  254. if (rndis_per_dev_params[configNr].vendorDescr) {
  255. length = strlen(rndis_per_dev_params[configNr].
  256. vendorDescr);
  257. memcpy(outbuf,
  258. rndis_per_dev_params[configNr].vendorDescr,
  259. length);
  260. } else {
  261. outbuf[0] = 0;
  262. }
  263. retval = 0;
  264. break;
  265. case RNDIS_OID_GEN_VENDOR_DRIVER_VERSION:
  266. pr_debug("%s: RNDIS_OID_GEN_VENDOR_DRIVER_VERSION\n", __func__);
  267. /* Created as LE */
  268. *outbuf = rndis_driver_version;
  269. retval = 0;
  270. break;
  271. /* mandatory */
  272. case RNDIS_OID_GEN_CURRENT_PACKET_FILTER:
  273. pr_debug("%s: RNDIS_OID_GEN_CURRENT_PACKET_FILTER\n", __func__);
  274. *outbuf = cpu_to_le32(*rndis_per_dev_params[configNr].filter);
  275. retval = 0;
  276. break;
  277. /* mandatory */
  278. case RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE:
  279. pr_debug("%s: RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE\n", __func__);
  280. *outbuf = cpu_to_le32(RNDIS_MAX_TOTAL_SIZE);
  281. retval = 0;
  282. break;
  283. /* mandatory */
  284. case RNDIS_OID_GEN_MEDIA_CONNECT_STATUS:
  285. if (rndis_debug > 1)
  286. pr_debug("%s: RNDIS_OID_GEN_MEDIA_CONNECT_STATUS\n", __func__);
  287. *outbuf = cpu_to_le32(rndis_per_dev_params[configNr]
  288. .media_state);
  289. retval = 0;
  290. break;
  291. case RNDIS_OID_GEN_PHYSICAL_MEDIUM:
  292. pr_debug("%s: RNDIS_OID_GEN_PHYSICAL_MEDIUM\n", __func__);
  293. *outbuf = cpu_to_le32(0);
  294. retval = 0;
  295. break;
  296. /* The RNDIS specification is incomplete/wrong. Some versions
  297. * of MS-Windows expect OIDs that aren't specified there. Other
  298. * versions emit undefined RNDIS messages. DOCUMENT ALL THESE!
  299. */
  300. case RNDIS_OID_GEN_MAC_OPTIONS: /* from WinME */
  301. pr_debug("%s: RNDIS_OID_GEN_MAC_OPTIONS\n", __func__);
  302. *outbuf = cpu_to_le32(
  303. RNDIS_MAC_OPTION_RECEIVE_SERIALIZED
  304. | RNDIS_MAC_OPTION_FULL_DUPLEX);
  305. retval = 0;
  306. break;
  307. /* statistics OIDs (table 4-2) */
  308. /* mandatory */
  309. case RNDIS_OID_GEN_XMIT_OK:
  310. if (rndis_debug > 1)
  311. pr_debug("%s: RNDIS_OID_GEN_XMIT_OK\n", __func__);
  312. if (stats) {
  313. *outbuf = cpu_to_le32(stats->tx_packets
  314. - stats->tx_errors - stats->tx_dropped);
  315. retval = 0;
  316. }
  317. break;
  318. /* mandatory */
  319. case RNDIS_OID_GEN_RCV_OK:
  320. if (rndis_debug > 1)
  321. pr_debug("%s: RNDIS_OID_GEN_RCV_OK\n", __func__);
  322. if (stats) {
  323. *outbuf = cpu_to_le32(stats->rx_packets
  324. - stats->rx_errors - stats->rx_dropped);
  325. retval = 0;
  326. }
  327. break;
  328. /* mandatory */
  329. case RNDIS_OID_GEN_XMIT_ERROR:
  330. if (rndis_debug > 1)
  331. pr_debug("%s: RNDIS_OID_GEN_XMIT_ERROR\n", __func__);
  332. if (stats) {
  333. *outbuf = cpu_to_le32(stats->tx_errors);
  334. retval = 0;
  335. }
  336. break;
  337. /* mandatory */
  338. case RNDIS_OID_GEN_RCV_ERROR:
  339. if (rndis_debug > 1)
  340. pr_debug("%s: RNDIS_OID_GEN_RCV_ERROR\n", __func__);
  341. if (stats) {
  342. *outbuf = cpu_to_le32(stats->rx_errors);
  343. retval = 0;
  344. }
  345. break;
  346. /* mandatory */
  347. case RNDIS_OID_GEN_RCV_NO_BUFFER:
  348. pr_debug("%s: RNDIS_OID_GEN_RCV_NO_BUFFER\n", __func__);
  349. if (stats) {
  350. *outbuf = cpu_to_le32(stats->rx_dropped);
  351. retval = 0;
  352. }
  353. break;
  354. /* ieee802.3 OIDs (table 4-3) */
  355. /* mandatory */
  356. case RNDIS_OID_802_3_PERMANENT_ADDRESS:
  357. pr_debug("%s: RNDIS_OID_802_3_PERMANENT_ADDRESS\n", __func__);
  358. if (rndis_per_dev_params[configNr].dev) {
  359. length = ETH_ALEN;
  360. memcpy(outbuf,
  361. rndis_per_dev_params[configNr].host_mac,
  362. length);
  363. retval = 0;
  364. }
  365. break;
  366. /* mandatory */
  367. case RNDIS_OID_802_3_CURRENT_ADDRESS:
  368. pr_debug("%s: RNDIS_OID_802_3_CURRENT_ADDRESS\n", __func__);
  369. if (rndis_per_dev_params[configNr].dev) {
  370. length = ETH_ALEN;
  371. memcpy(outbuf,
  372. rndis_per_dev_params [configNr].host_mac,
  373. length);
  374. retval = 0;
  375. }
  376. break;
  377. /* mandatory */
  378. case RNDIS_OID_802_3_MULTICAST_LIST:
  379. pr_debug("%s: RNDIS_OID_802_3_MULTICAST_LIST\n", __func__);
  380. /* Multicast base address only */
  381. *outbuf = cpu_to_le32(0xE0000000);
  382. retval = 0;
  383. break;
  384. /* mandatory */
  385. case RNDIS_OID_802_3_MAXIMUM_LIST_SIZE:
  386. pr_debug("%s: RNDIS_OID_802_3_MAXIMUM_LIST_SIZE\n", __func__);
  387. /* Multicast base address only */
  388. *outbuf = cpu_to_le32(1);
  389. retval = 0;
  390. break;
  391. case RNDIS_OID_802_3_MAC_OPTIONS:
  392. pr_debug("%s: RNDIS_OID_802_3_MAC_OPTIONS\n", __func__);
  393. *outbuf = cpu_to_le32(0);
  394. retval = 0;
  395. break;
  396. /* ieee802.3 statistics OIDs (table 4-4) */
  397. /* mandatory */
  398. case RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT:
  399. pr_debug("%s: RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT\n", __func__);
  400. if (stats) {
  401. *outbuf = cpu_to_le32(stats->rx_frame_errors);
  402. retval = 0;
  403. }
  404. break;
  405. /* mandatory */
  406. case RNDIS_OID_802_3_XMIT_ONE_COLLISION:
  407. pr_debug("%s: RNDIS_OID_802_3_XMIT_ONE_COLLISION\n", __func__);
  408. *outbuf = cpu_to_le32(0);
  409. retval = 0;
  410. break;
  411. /* mandatory */
  412. case RNDIS_OID_802_3_XMIT_MORE_COLLISIONS:
  413. pr_debug("%s: RNDIS_OID_802_3_XMIT_MORE_COLLISIONS\n", __func__);
  414. *outbuf = cpu_to_le32(0);
  415. retval = 0;
  416. break;
  417. default:
  418. pr_warning("%s: query unknown OID 0x%08X\n",
  419. __func__, OID);
  420. }
  421. if (retval < 0)
  422. length = 0;
  423. resp->InformationBufferLength = cpu_to_le32(length);
  424. r->length = length + sizeof(*resp);
  425. resp->MessageLength = cpu_to_le32(r->length);
  426. return retval;
  427. }
  428. static int gen_ndis_set_resp(u8 configNr, u32 OID, u8 *buf, u32 buf_len,
  429. rndis_resp_t *r)
  430. {
  431. rndis_set_cmplt_type *resp;
  432. int i, retval = -ENOTSUPP;
  433. struct rndis_params *params;
  434. if (!r)
  435. return -ENOMEM;
  436. resp = (rndis_set_cmplt_type *)r->buf;
  437. if (!resp)
  438. return -ENOMEM;
  439. if (buf_len && rndis_debug > 1) {
  440. pr_debug("set OID %08x value, len %d:\n", OID, buf_len);
  441. for (i = 0; i < buf_len; i += 16) {
  442. pr_debug("%03d: %08x %08x %08x %08x\n", i,
  443. get_unaligned_le32(&buf[i]),
  444. get_unaligned_le32(&buf[i + 4]),
  445. get_unaligned_le32(&buf[i + 8]),
  446. get_unaligned_le32(&buf[i + 12]));
  447. }
  448. }
  449. params = &rndis_per_dev_params[configNr];
  450. switch (OID) {
  451. case RNDIS_OID_GEN_CURRENT_PACKET_FILTER:
  452. /* these NDIS_PACKET_TYPE_* bitflags are shared with
  453. * cdc_filter; it's not RNDIS-specific
  454. * NDIS_PACKET_TYPE_x == USB_CDC_PACKET_TYPE_x for x in:
  455. * PROMISCUOUS, DIRECTED,
  456. * MULTICAST, ALL_MULTICAST, BROADCAST
  457. */
  458. *params->filter = (u16)get_unaligned_le32(buf);
  459. pr_debug("%s: RNDIS_OID_GEN_CURRENT_PACKET_FILTER %08x\n",
  460. __func__, *params->filter);
  461. /* this call has a significant side effect: it's
  462. * what makes the packet flow start and stop, like
  463. * activating the CDC Ethernet altsetting.
  464. */
  465. retval = 0;
  466. if (*params->filter) {
  467. params->state = RNDIS_DATA_INITIALIZED;
  468. netif_carrier_on(params->dev);
  469. if (netif_running(params->dev))
  470. netif_wake_queue(params->dev);
  471. } else {
  472. params->state = RNDIS_INITIALIZED;
  473. netif_carrier_off(params->dev);
  474. netif_stop_queue(params->dev);
  475. }
  476. break;
  477. case RNDIS_OID_802_3_MULTICAST_LIST:
  478. /* I think we can ignore this */
  479. pr_debug("%s: RNDIS_OID_802_3_MULTICAST_LIST\n", __func__);
  480. retval = 0;
  481. break;
  482. default:
  483. pr_warning("%s: set unknown OID 0x%08X, size %d\n",
  484. __func__, OID, buf_len);
  485. }
  486. return retval;
  487. }
  488. /*
  489. * Response Functions
  490. */
  491. static int rndis_init_response(int configNr, rndis_init_msg_type *buf)
  492. {
  493. rndis_init_cmplt_type *resp;
  494. rndis_resp_t *r;
  495. struct rndis_params *params = rndis_per_dev_params + configNr;
  496. if (!params->dev)
  497. return -ENOTSUPP;
  498. r = rndis_add_response(configNr, sizeof(rndis_init_cmplt_type));
  499. if (!r)
  500. return -ENOMEM;
  501. resp = (rndis_init_cmplt_type *)r->buf;
  502. resp->MessageType = cpu_to_le32(RNDIS_MSG_INIT_C);
  503. resp->MessageLength = cpu_to_le32(52);
  504. resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
  505. resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
  506. resp->MajorVersion = cpu_to_le32(RNDIS_MAJOR_VERSION);
  507. resp->MinorVersion = cpu_to_le32(RNDIS_MINOR_VERSION);
  508. resp->DeviceFlags = cpu_to_le32(RNDIS_DF_CONNECTIONLESS);
  509. resp->Medium = cpu_to_le32(RNDIS_MEDIUM_802_3);
  510. resp->MaxPacketsPerTransfer = cpu_to_le32(1);
  511. resp->MaxTransferSize = cpu_to_le32(
  512. params->dev->mtu
  513. + sizeof(struct ethhdr)
  514. + sizeof(struct rndis_packet_msg_type)
  515. + 22);
  516. resp->PacketAlignmentFactor = cpu_to_le32(0);
  517. resp->AFListOffset = cpu_to_le32(0);
  518. resp->AFListSize = cpu_to_le32(0);
  519. params->resp_avail(params->v);
  520. return 0;
  521. }
  522. static int rndis_query_response(int configNr, rndis_query_msg_type *buf)
  523. {
  524. rndis_query_cmplt_type *resp;
  525. rndis_resp_t *r;
  526. struct rndis_params *params = rndis_per_dev_params + configNr;
  527. /* pr_debug("%s: OID = %08X\n", __func__, cpu_to_le32(buf->OID)); */
  528. if (!params->dev)
  529. return -ENOTSUPP;
  530. /*
  531. * we need more memory:
  532. * gen_ndis_query_resp expects enough space for
  533. * rndis_query_cmplt_type followed by data.
  534. * oid_supported_list is the largest data reply
  535. */
  536. r = rndis_add_response(configNr,
  537. sizeof(oid_supported_list) + sizeof(rndis_query_cmplt_type));
  538. if (!r)
  539. return -ENOMEM;
  540. resp = (rndis_query_cmplt_type *)r->buf;
  541. resp->MessageType = cpu_to_le32(RNDIS_MSG_QUERY_C);
  542. resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
  543. if (gen_ndis_query_resp(configNr, le32_to_cpu(buf->OID),
  544. le32_to_cpu(buf->InformationBufferOffset)
  545. + 8 + (u8 *)buf,
  546. le32_to_cpu(buf->InformationBufferLength),
  547. r)) {
  548. /* OID not supported */
  549. resp->Status = cpu_to_le32(RNDIS_STATUS_NOT_SUPPORTED);
  550. resp->MessageLength = cpu_to_le32(sizeof *resp);
  551. resp->InformationBufferLength = cpu_to_le32(0);
  552. resp->InformationBufferOffset = cpu_to_le32(0);
  553. } else
  554. resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
  555. params->resp_avail(params->v);
  556. return 0;
  557. }
  558. static int rndis_set_response(int configNr, rndis_set_msg_type *buf)
  559. {
  560. u32 BufLength, BufOffset;
  561. rndis_set_cmplt_type *resp;
  562. rndis_resp_t *r;
  563. struct rndis_params *params = rndis_per_dev_params + configNr;
  564. r = rndis_add_response(configNr, sizeof(rndis_set_cmplt_type));
  565. if (!r)
  566. return -ENOMEM;
  567. resp = (rndis_set_cmplt_type *)r->buf;
  568. BufLength = le32_to_cpu(buf->InformationBufferLength);
  569. BufOffset = le32_to_cpu(buf->InformationBufferOffset);
  570. #ifdef VERBOSE_DEBUG
  571. pr_debug("%s: Length: %d\n", __func__, BufLength);
  572. pr_debug("%s: Offset: %d\n", __func__, BufOffset);
  573. pr_debug("%s: InfoBuffer: ", __func__);
  574. for (i = 0; i < BufLength; i++) {
  575. pr_debug("%02x ", *(((u8 *) buf) + i + 8 + BufOffset));
  576. }
  577. pr_debug("\n");
  578. #endif
  579. resp->MessageType = cpu_to_le32(RNDIS_MSG_SET_C);
  580. resp->MessageLength = cpu_to_le32(16);
  581. resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
  582. if (gen_ndis_set_resp(configNr, le32_to_cpu(buf->OID),
  583. ((u8 *)buf) + 8 + BufOffset, BufLength, r))
  584. resp->Status = cpu_to_le32(RNDIS_STATUS_NOT_SUPPORTED);
  585. else
  586. resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
  587. params->resp_avail(params->v);
  588. return 0;
  589. }
  590. static int rndis_reset_response(int configNr, rndis_reset_msg_type *buf)
  591. {
  592. rndis_reset_cmplt_type *resp;
  593. rndis_resp_t *r;
  594. struct rndis_params *params = rndis_per_dev_params + configNr;
  595. r = rndis_add_response(configNr, sizeof(rndis_reset_cmplt_type));
  596. if (!r)
  597. return -ENOMEM;
  598. resp = (rndis_reset_cmplt_type *)r->buf;
  599. resp->MessageType = cpu_to_le32(RNDIS_MSG_RESET_C);
  600. resp->MessageLength = cpu_to_le32(16);
  601. resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
  602. /* resent information */
  603. resp->AddressingReset = cpu_to_le32(1);
  604. params->resp_avail(params->v);
  605. return 0;
  606. }
  607. static int rndis_keepalive_response(int configNr,
  608. rndis_keepalive_msg_type *buf)
  609. {
  610. rndis_keepalive_cmplt_type *resp;
  611. rndis_resp_t *r;
  612. struct rndis_params *params = rndis_per_dev_params + configNr;
  613. /* host "should" check only in RNDIS_DATA_INITIALIZED state */
  614. r = rndis_add_response(configNr, sizeof(rndis_keepalive_cmplt_type));
  615. if (!r)
  616. return -ENOMEM;
  617. resp = (rndis_keepalive_cmplt_type *)r->buf;
  618. resp->MessageType = cpu_to_le32(RNDIS_MSG_KEEPALIVE_C);
  619. resp->MessageLength = cpu_to_le32(16);
  620. resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
  621. resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
  622. params->resp_avail(params->v);
  623. return 0;
  624. }
  625. /*
  626. * Device to Host Comunication
  627. */
  628. static int rndis_indicate_status_msg(int configNr, u32 status)
  629. {
  630. rndis_indicate_status_msg_type *resp;
  631. rndis_resp_t *r;
  632. struct rndis_params *params = rndis_per_dev_params + configNr;
  633. if (params->state == RNDIS_UNINITIALIZED)
  634. return -ENOTSUPP;
  635. r = rndis_add_response(configNr,
  636. sizeof(rndis_indicate_status_msg_type));
  637. if (!r)
  638. return -ENOMEM;
  639. resp = (rndis_indicate_status_msg_type *)r->buf;
  640. resp->MessageType = cpu_to_le32(RNDIS_MSG_INDICATE);
  641. resp->MessageLength = cpu_to_le32(20);
  642. resp->Status = cpu_to_le32(status);
  643. resp->StatusBufferLength = cpu_to_le32(0);
  644. resp->StatusBufferOffset = cpu_to_le32(0);
  645. params->resp_avail(params->v);
  646. return 0;
  647. }
  648. int rndis_signal_connect(int configNr)
  649. {
  650. rndis_per_dev_params[configNr].media_state
  651. = RNDIS_MEDIA_STATE_CONNECTED;
  652. return rndis_indicate_status_msg(configNr,
  653. RNDIS_STATUS_MEDIA_CONNECT);
  654. }
  655. int rndis_signal_disconnect(int configNr)
  656. {
  657. rndis_per_dev_params[configNr].media_state
  658. = RNDIS_MEDIA_STATE_DISCONNECTED;
  659. return rndis_indicate_status_msg(configNr,
  660. RNDIS_STATUS_MEDIA_DISCONNECT);
  661. }
  662. void rndis_uninit(int configNr)
  663. {
  664. u8 *buf;
  665. u32 length;
  666. if (configNr >= RNDIS_MAX_CONFIGS)
  667. return;
  668. rndis_per_dev_params[configNr].state = RNDIS_UNINITIALIZED;
  669. /* drain the response queue */
  670. while ((buf = rndis_get_next_response(configNr, &length)))
  671. rndis_free_response(configNr, buf);
  672. }
  673. void rndis_set_host_mac(int configNr, const u8 *addr)
  674. {
  675. rndis_per_dev_params[configNr].host_mac = addr;
  676. }
  677. /*
  678. * Message Parser
  679. */
  680. int rndis_msg_parser(u8 configNr, u8 *buf)
  681. {
  682. u32 MsgType, MsgLength;
  683. __le32 *tmp;
  684. struct rndis_params *params;
  685. if (!buf)
  686. return -ENOMEM;
  687. tmp = (__le32 *)buf;
  688. MsgType = get_unaligned_le32(tmp++);
  689. MsgLength = get_unaligned_le32(tmp++);
  690. if (configNr >= RNDIS_MAX_CONFIGS)
  691. return -ENOTSUPP;
  692. params = &rndis_per_dev_params[configNr];
  693. /* NOTE: RNDIS is *EXTREMELY* chatty ... Windows constantly polls for
  694. * rx/tx statistics and link status, in addition to KEEPALIVE traffic
  695. * and normal HC level polling to see if there's any IN traffic.
  696. */
  697. /* For USB: responses may take up to 10 seconds */
  698. switch (MsgType) {
  699. case RNDIS_MSG_INIT:
  700. pr_debug("%s: RNDIS_MSG_INIT\n",
  701. __func__);
  702. params->state = RNDIS_INITIALIZED;
  703. return rndis_init_response(configNr,
  704. (rndis_init_msg_type *)buf);
  705. case RNDIS_MSG_HALT:
  706. pr_debug("%s: RNDIS_MSG_HALT\n",
  707. __func__);
  708. params->state = RNDIS_UNINITIALIZED;
  709. if (params->dev) {
  710. netif_carrier_off(params->dev);
  711. netif_stop_queue(params->dev);
  712. }
  713. return 0;
  714. case RNDIS_MSG_QUERY:
  715. return rndis_query_response(configNr,
  716. (rndis_query_msg_type *)buf);
  717. case RNDIS_MSG_SET:
  718. return rndis_set_response(configNr,
  719. (rndis_set_msg_type *)buf);
  720. case RNDIS_MSG_RESET:
  721. pr_debug("%s: RNDIS_MSG_RESET\n",
  722. __func__);
  723. return rndis_reset_response(configNr,
  724. (rndis_reset_msg_type *)buf);
  725. case RNDIS_MSG_KEEPALIVE:
  726. /* For USB: host does this every 5 seconds */
  727. if (rndis_debug > 1)
  728. pr_debug("%s: RNDIS_MSG_KEEPALIVE\n",
  729. __func__);
  730. return rndis_keepalive_response(configNr,
  731. (rndis_keepalive_msg_type *)
  732. buf);
  733. default:
  734. /* At least Windows XP emits some undefined RNDIS messages.
  735. * In one case those messages seemed to relate to the host
  736. * suspending itself.
  737. */
  738. pr_warning("%s: unknown RNDIS message 0x%08X len %d\n",
  739. __func__, MsgType, MsgLength);
  740. print_hex_dump_bytes(__func__, DUMP_PREFIX_OFFSET,
  741. buf, MsgLength);
  742. break;
  743. }
  744. return -ENOTSUPP;
  745. }
  746. int rndis_register(void (*resp_avail)(void *v), void *v)
  747. {
  748. u8 i;
  749. if (!resp_avail)
  750. return -EINVAL;
  751. for (i = 0; i < RNDIS_MAX_CONFIGS; i++) {
  752. if (!rndis_per_dev_params[i].used) {
  753. rndis_per_dev_params[i].used = 1;
  754. rndis_per_dev_params[i].resp_avail = resp_avail;
  755. rndis_per_dev_params[i].v = v;
  756. pr_debug("%s: configNr = %d\n", __func__, i);
  757. return i;
  758. }
  759. }
  760. pr_debug("failed\n");
  761. return -ENODEV;
  762. }
  763. void rndis_deregister(int configNr)
  764. {
  765. pr_debug("%s:\n", __func__);
  766. if (configNr >= RNDIS_MAX_CONFIGS) return;
  767. rndis_per_dev_params[configNr].used = 0;
  768. }
  769. int rndis_set_param_dev(u8 configNr, struct net_device *dev, u16 *cdc_filter)
  770. {
  771. pr_debug("%s:\n", __func__);
  772. if (!dev)
  773. return -EINVAL;
  774. if (configNr >= RNDIS_MAX_CONFIGS) return -1;
  775. rndis_per_dev_params[configNr].dev = dev;
  776. rndis_per_dev_params[configNr].filter = cdc_filter;
  777. return 0;
  778. }
  779. int rndis_set_param_vendor(u8 configNr, u32 vendorID, const char *vendorDescr)
  780. {
  781. pr_debug("%s:\n", __func__);
  782. if (!vendorDescr) return -1;
  783. if (configNr >= RNDIS_MAX_CONFIGS) return -1;
  784. rndis_per_dev_params[configNr].vendorID = vendorID;
  785. rndis_per_dev_params[configNr].vendorDescr = vendorDescr;
  786. return 0;
  787. }
  788. int rndis_set_param_medium(u8 configNr, u32 medium, u32 speed)
  789. {
  790. pr_debug("%s: %u %u\n", __func__, medium, speed);
  791. if (configNr >= RNDIS_MAX_CONFIGS) return -1;
  792. rndis_per_dev_params[configNr].medium = medium;
  793. rndis_per_dev_params[configNr].speed = speed;
  794. return 0;
  795. }
  796. void rndis_add_hdr(struct sk_buff *skb)
  797. {
  798. struct rndis_packet_msg_type *header;
  799. if (!skb)
  800. return;
  801. header = (void *)skb_push(skb, sizeof(*header));
  802. memset(header, 0, sizeof *header);
  803. header->MessageType = cpu_to_le32(RNDIS_MSG_PACKET);
  804. header->MessageLength = cpu_to_le32(skb->len);
  805. header->DataOffset = cpu_to_le32(36);
  806. header->DataLength = cpu_to_le32(skb->len - sizeof(*header));
  807. }
  808. void rndis_free_response(int configNr, u8 *buf)
  809. {
  810. rndis_resp_t *r;
  811. struct list_head *act, *tmp;
  812. list_for_each_safe(act, tmp,
  813. &(rndis_per_dev_params[configNr].resp_queue))
  814. {
  815. r = list_entry(act, rndis_resp_t, list);
  816. if (r && r->buf == buf) {
  817. list_del(&r->list);
  818. kfree(r);
  819. }
  820. }
  821. }
  822. u8 *rndis_get_next_response(int configNr, u32 *length)
  823. {
  824. rndis_resp_t *r;
  825. struct list_head *act, *tmp;
  826. if (!length) return NULL;
  827. list_for_each_safe(act, tmp,
  828. &(rndis_per_dev_params[configNr].resp_queue))
  829. {
  830. r = list_entry(act, rndis_resp_t, list);
  831. if (!r->send) {
  832. r->send = 1;
  833. *length = r->length;
  834. return r->buf;
  835. }
  836. }
  837. return NULL;
  838. }
  839. static rndis_resp_t *rndis_add_response(int configNr, u32 length)
  840. {
  841. rndis_resp_t *r;
  842. /* NOTE: this gets copied into ether.c USB_BUFSIZ bytes ... */
  843. r = kmalloc(sizeof(rndis_resp_t) + length, GFP_ATOMIC);
  844. if (!r) return NULL;
  845. r->buf = (u8 *)(r + 1);
  846. r->length = length;
  847. r->send = 0;
  848. list_add_tail(&r->list,
  849. &(rndis_per_dev_params[configNr].resp_queue));
  850. return r;
  851. }
  852. int rndis_rm_hdr(struct gether *port,
  853. struct sk_buff *skb,
  854. struct sk_buff_head *list)
  855. {
  856. /* tmp points to a struct rndis_packet_msg_type */
  857. __le32 *tmp = (void *)skb->data;
  858. /* MessageType, MessageLength */
  859. if (cpu_to_le32(RNDIS_MSG_PACKET)
  860. != get_unaligned(tmp++)) {
  861. dev_kfree_skb_any(skb);
  862. return -EINVAL;
  863. }
  864. tmp++;
  865. /* DataOffset, DataLength */
  866. if (!skb_pull(skb, get_unaligned_le32(tmp++) + 8)) {
  867. dev_kfree_skb_any(skb);
  868. return -EOVERFLOW;
  869. }
  870. skb_trim(skb, get_unaligned_le32(tmp++));
  871. skb_queue_tail(list, skb);
  872. return 0;
  873. }
  874. #ifdef CONFIG_USB_GADGET_DEBUG_FILES
  875. static int rndis_proc_show(struct seq_file *m, void *v)
  876. {
  877. rndis_params *param = m->private;
  878. seq_printf(m,
  879. "Config Nr. %d\n"
  880. "used : %s\n"
  881. "state : %s\n"
  882. "medium : 0x%08X\n"
  883. "speed : %d\n"
  884. "cable : %s\n"
  885. "vendor ID : 0x%08X\n"
  886. "vendor : %s\n",
  887. param->confignr, (param->used) ? "y" : "n",
  888. ({ char *s = "?";
  889. switch (param->state) {
  890. case RNDIS_UNINITIALIZED:
  891. s = "RNDIS_UNINITIALIZED"; break;
  892. case RNDIS_INITIALIZED:
  893. s = "RNDIS_INITIALIZED"; break;
  894. case RNDIS_DATA_INITIALIZED:
  895. s = "RNDIS_DATA_INITIALIZED"; break;
  896. }; s; }),
  897. param->medium,
  898. (param->media_state) ? 0 : param->speed*100,
  899. (param->media_state) ? "disconnected" : "connected",
  900. param->vendorID, param->vendorDescr);
  901. return 0;
  902. }
  903. static ssize_t rndis_proc_write(struct file *file, const char __user *buffer,
  904. size_t count, loff_t *ppos)
  905. {
  906. rndis_params *p = PDE(file_inode(file))->data;
  907. u32 speed = 0;
  908. int i, fl_speed = 0;
  909. for (i = 0; i < count; i++) {
  910. char c;
  911. if (get_user(c, buffer))
  912. return -EFAULT;
  913. switch (c) {
  914. case '0':
  915. case '1':
  916. case '2':
  917. case '3':
  918. case '4':
  919. case '5':
  920. case '6':
  921. case '7':
  922. case '8':
  923. case '9':
  924. fl_speed = 1;
  925. speed = speed * 10 + c - '0';
  926. break;
  927. case 'C':
  928. case 'c':
  929. rndis_signal_connect(p->confignr);
  930. break;
  931. case 'D':
  932. case 'd':
  933. rndis_signal_disconnect(p->confignr);
  934. break;
  935. default:
  936. if (fl_speed) p->speed = speed;
  937. else pr_debug("%c is not valid\n", c);
  938. break;
  939. }
  940. buffer++;
  941. }
  942. return count;
  943. }
  944. static int rndis_proc_open(struct inode *inode, struct file *file)
  945. {
  946. return single_open(file, rndis_proc_show, PDE(inode)->data);
  947. }
  948. static const struct file_operations rndis_proc_fops = {
  949. .owner = THIS_MODULE,
  950. .open = rndis_proc_open,
  951. .read = seq_read,
  952. .llseek = seq_lseek,
  953. .release = single_release,
  954. .write = rndis_proc_write,
  955. };
  956. #define NAME_TEMPLATE "driver/rndis-%03d"
  957. static struct proc_dir_entry *rndis_connect_state [RNDIS_MAX_CONFIGS];
  958. #endif /* CONFIG_USB_GADGET_DEBUG_FILES */
  959. int rndis_init(void)
  960. {
  961. u8 i;
  962. for (i = 0; i < RNDIS_MAX_CONFIGS; i++) {
  963. #ifdef CONFIG_USB_GADGET_DEBUG_FILES
  964. char name [20];
  965. sprintf(name, NAME_TEMPLATE, i);
  966. rndis_connect_state[i] = proc_create_data(name, 0660, NULL,
  967. &rndis_proc_fops,
  968. (void *)(rndis_per_dev_params + i));
  969. if (!rndis_connect_state[i]) {
  970. pr_debug("%s: remove entries", __func__);
  971. while (i) {
  972. sprintf(name, NAME_TEMPLATE, --i);
  973. remove_proc_entry(name, NULL);
  974. }
  975. pr_debug("\n");
  976. return -EIO;
  977. }
  978. #endif
  979. rndis_per_dev_params[i].confignr = i;
  980. rndis_per_dev_params[i].used = 0;
  981. rndis_per_dev_params[i].state = RNDIS_UNINITIALIZED;
  982. rndis_per_dev_params[i].media_state
  983. = RNDIS_MEDIA_STATE_DISCONNECTED;
  984. INIT_LIST_HEAD(&(rndis_per_dev_params[i].resp_queue));
  985. }
  986. return 0;
  987. }
  988. void rndis_exit(void)
  989. {
  990. #ifdef CONFIG_USB_GADGET_DEBUG_FILES
  991. u8 i;
  992. char name[20];
  993. for (i = 0; i < RNDIS_MAX_CONFIGS; i++) {
  994. sprintf(name, NAME_TEMPLATE, i);
  995. remove_proc_entry(name, NULL);
  996. }
  997. #endif
  998. }