// SPDX-License-Identifier: GPL-2.0 /* * RNDIS MSG parser * * Authors: Benedikt Spranger, Pengutronix * Robert Schwebel, Pengutronix * * This software was originally developed in conformance with * Microsoft's Remote NDIS Specification License Agreement. * * 03/12/2004 Kai-Uwe Bloem * Fixed message length bug in init_response * * 03/25/2004 Kai-Uwe Bloem * Fixed rndis_rm_hdr length bug. * * Copyright (C) 2004 by David Brownell * updates to merge with Linux 2.6, better match RNDIS spec */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include "u_rndis.h" #undef VERBOSE_DEBUG #include "rndis.h" /* The driver for your USB chip needs to support ep0 OUT to work with * RNDIS, plus all three CDC Ethernet endpoints (interrupt not optional). * * Windows hosts need an INF file like Documentation/usb/linux.inf * and will be happier if you provide the host_addr module parameter. */ #if 0 static int rndis_debug = 0; module_param (rndis_debug, int, 0); MODULE_PARM_DESC (rndis_debug, "enable debugging"); #else #define rndis_debug 0 #endif #ifdef CONFIG_USB_GADGET_DEBUG_FILES #define NAME_TEMPLATE "driver/rndis-%03d" #endif /* CONFIG_USB_GADGET_DEBUG_FILES */ static DEFINE_IDA(rndis_ida); /* Driver Version */ static const __le32 rndis_driver_version = cpu_to_le32(1); /* Function Prototypes */ static rndis_resp_t *rndis_add_response(struct rndis_params *params, u32 length); #ifdef CONFIG_USB_GADGET_DEBUG_FILES static const struct proc_ops rndis_proc_ops; #endif /* CONFIG_USB_GADGET_DEBUG_FILES */ /* supported OIDs */ static const u32 oid_supported_list[] = { /* the general stuff */ RNDIS_OID_GEN_SUPPORTED_LIST, RNDIS_OID_GEN_HARDWARE_STATUS, RNDIS_OID_GEN_MEDIA_SUPPORTED, RNDIS_OID_GEN_MEDIA_IN_USE, RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE, RNDIS_OID_GEN_LINK_SPEED, RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE, RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE, RNDIS_OID_GEN_VENDOR_ID, RNDIS_OID_GEN_VENDOR_DESCRIPTION, RNDIS_OID_GEN_VENDOR_DRIVER_VERSION, RNDIS_OID_GEN_CURRENT_PACKET_FILTER, RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE, RNDIS_OID_GEN_MEDIA_CONNECT_STATUS, RNDIS_OID_GEN_PHYSICAL_MEDIUM, /* the statistical stuff */ RNDIS_OID_GEN_XMIT_OK, RNDIS_OID_GEN_RCV_OK, RNDIS_OID_GEN_XMIT_ERROR, RNDIS_OID_GEN_RCV_ERROR, RNDIS_OID_GEN_RCV_NO_BUFFER, #ifdef RNDIS_OPTIONAL_STATS RNDIS_OID_GEN_DIRECTED_BYTES_XMIT, RNDIS_OID_GEN_DIRECTED_FRAMES_XMIT, RNDIS_OID_GEN_MULTICAST_BYTES_XMIT, RNDIS_OID_GEN_MULTICAST_FRAMES_XMIT, RNDIS_OID_GEN_BROADCAST_BYTES_XMIT, RNDIS_OID_GEN_BROADCAST_FRAMES_XMIT, RNDIS_OID_GEN_DIRECTED_BYTES_RCV, RNDIS_OID_GEN_DIRECTED_FRAMES_RCV, RNDIS_OID_GEN_MULTICAST_BYTES_RCV, RNDIS_OID_GEN_MULTICAST_FRAMES_RCV, RNDIS_OID_GEN_BROADCAST_BYTES_RCV, RNDIS_OID_GEN_BROADCAST_FRAMES_RCV, RNDIS_OID_GEN_RCV_CRC_ERROR, RNDIS_OID_GEN_TRANSMIT_QUEUE_LENGTH, #endif /* RNDIS_OPTIONAL_STATS */ /* mandatory 802.3 */ /* the general stuff */ RNDIS_OID_802_3_PERMANENT_ADDRESS, RNDIS_OID_802_3_CURRENT_ADDRESS, RNDIS_OID_802_3_MULTICAST_LIST, RNDIS_OID_802_3_MAC_OPTIONS, RNDIS_OID_802_3_MAXIMUM_LIST_SIZE, /* the statistical stuff */ RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT, RNDIS_OID_802_3_XMIT_ONE_COLLISION, RNDIS_OID_802_3_XMIT_MORE_COLLISIONS, #ifdef RNDIS_OPTIONAL_STATS RNDIS_OID_802_3_XMIT_DEFERRED, RNDIS_OID_802_3_XMIT_MAX_COLLISIONS, RNDIS_OID_802_3_RCV_OVERRUN, RNDIS_OID_802_3_XMIT_UNDERRUN, RNDIS_OID_802_3_XMIT_HEARTBEAT_FAILURE, RNDIS_OID_802_3_XMIT_TIMES_CRS_LOST, RNDIS_OID_802_3_XMIT_LATE_COLLISIONS, #endif /* RNDIS_OPTIONAL_STATS */ #ifdef RNDIS_PM /* PM and wakeup are "mandatory" for USB, but the RNDIS specs * don't say what they mean ... and the NDIS specs are often * confusing and/or ambiguous in this context. (That is, more * so than their specs for the other OIDs.) * * FIXME someone who knows what these should do, please * implement them! */ /* power management */ OID_PNP_CAPABILITIES, OID_PNP_QUERY_POWER, OID_PNP_SET_POWER, #ifdef RNDIS_WAKEUP /* wake up host */ OID_PNP_ENABLE_WAKE_UP, OID_PNP_ADD_WAKE_UP_PATTERN, OID_PNP_REMOVE_WAKE_UP_PATTERN, #endif /* RNDIS_WAKEUP */ #endif /* RNDIS_PM */ }; /* NDIS Functions */ static int gen_ndis_query_resp(struct rndis_params *params, u32 OID, u8 *buf, unsigned buf_len, rndis_resp_t *r) { int retval = -ENOTSUPP; u32 length = 4; /* usually */ __le32 *outbuf; int i, count; rndis_query_cmplt_type *resp; struct net_device *net; struct rtnl_link_stats64 temp; const struct rtnl_link_stats64 *stats; if (!r) return -ENOMEM; resp = (rndis_query_cmplt_type *)r->buf; if (!resp) return -ENOMEM; if (buf_len && rndis_debug > 1) { pr_debug("query OID %08x value, len %d:\n", OID, buf_len); for (i = 0; i < buf_len; i += 16) { pr_debug("%03d: %08x %08x %08x %08x\n", i, get_unaligned_le32(&buf[i]), get_unaligned_le32(&buf[i + 4]), get_unaligned_le32(&buf[i + 8]), get_unaligned_le32(&buf[i + 12])); } } /* response goes here, right after the header */ outbuf = (__le32 *)&resp[1]; resp->InformationBufferOffset = cpu_to_le32(16); net = params->dev; stats = dev_get_stats(net, &temp); switch (OID) { /* general oids (table 4-1) */ /* mandatory */ case RNDIS_OID_GEN_SUPPORTED_LIST: pr_debug("%s: RNDIS_OID_GEN_SUPPORTED_LIST\n", __func__); length = sizeof(oid_supported_list); count = length / sizeof(u32); for (i = 0; i < count; i++) outbuf[i] = cpu_to_le32(oid_supported_list[i]); retval = 0; break; /* mandatory */ case RNDIS_OID_GEN_HARDWARE_STATUS: pr_debug("%s: RNDIS_OID_GEN_HARDWARE_STATUS\n", __func__); /* Bogus question! * Hardware must be ready to receive high level protocols. * BTW: * reddite ergo quae sunt Caesaris Caesari * et quae sunt Dei Deo! */ *outbuf = cpu_to_le32(0); retval = 0; break; /* mandatory */ case RNDIS_OID_GEN_MEDIA_SUPPORTED: pr_debug("%s: RNDIS_OID_GEN_MEDIA_SUPPORTED\n", __func__); *outbuf = cpu_to_le32(params->medium); retval = 0; break; /* mandatory */ case RNDIS_OID_GEN_MEDIA_IN_USE: pr_debug("%s: RNDIS_OID_GEN_MEDIA_IN_USE\n", __func__); /* one medium, one transport... (maybe you do it better) */ *outbuf = cpu_to_le32(params->medium); retval = 0; break; /* mandatory */ case RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE: pr_debug("%s: RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE\n", __func__); if (params->dev) { *outbuf = cpu_to_le32(params->dev->mtu); retval = 0; } break; /* mandatory */ case RNDIS_OID_GEN_LINK_SPEED: if (rndis_debug > 1) pr_debug("%s: RNDIS_OID_GEN_LINK_SPEED\n", __func__); if (params->media_state == RNDIS_MEDIA_STATE_DISCONNECTED) *outbuf = cpu_to_le32(0); else *outbuf = cpu_to_le32(params->speed); retval = 0; break; /* mandatory */ case RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE: pr_debug("%s: RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE\n", __func__); if (params->dev) { *outbuf = cpu_to_le32(params->dev->mtu); retval = 0; } break; /* mandatory */ case RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE: pr_debug("%s: RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE\n", __func__); if (params->dev) { *outbuf = cpu_to_le32(params->dev->mtu); retval = 0; } break; /* mandatory */ case RNDIS_OID_GEN_VENDOR_ID: pr_debug("%s: RNDIS_OID_GEN_VENDOR_ID\n", __func__); *outbuf = cpu_to_le32(params->vendorID); retval = 0; break; /* mandatory */ case RNDIS_OID_GEN_VENDOR_DESCRIPTION: pr_debug("%s: RNDIS_OID_GEN_VENDOR_DESCRIPTION\n", __func__); if (params->vendorDescr) { length = strlen(params->vendorDescr); memcpy(outbuf, params->vendorDescr, length); } else { outbuf[0] = 0; } retval = 0; break; case RNDIS_OID_GEN_VENDOR_DRIVER_VERSION: pr_debug("%s: RNDIS_OID_GEN_VENDOR_DRIVER_VERSION\n", __func__); /* Created as LE */ *outbuf = rndis_driver_version; retval = 0; break; /* mandatory */ case RNDIS_OID_GEN_CURRENT_PACKET_FILTER: pr_debug("%s: RNDIS_OID_GEN_CURRENT_PACKET_FILTER\n", __func__); *outbuf = cpu_to_le32(*params->filter); retval = 0; break; /* mandatory */ case RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE: pr_debug("%s: RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE\n", __func__); *outbuf = cpu_to_le32(RNDIS_MAX_TOTAL_SIZE); retval = 0; break; /* mandatory */ case RNDIS_OID_GEN_MEDIA_CONNECT_STATUS: if (rndis_debug > 1) pr_debug("%s: RNDIS_OID_GEN_MEDIA_CONNECT_STATUS\n", __func__); *outbuf = cpu_to_le32(params->media_state); retval = 0; break; case RNDIS_OID_GEN_PHYSICAL_MEDIUM: pr_debug("%s: RNDIS_OID_GEN_PHYSICAL_MEDIUM\n", __func__); *outbuf = cpu_to_le32(0); retval = 0; break; /* The RNDIS specification is incomplete/wrong. Some versions * of MS-Windows expect OIDs that aren't specified there. Other * versions emit undefined RNDIS messages. DOCUMENT ALL THESE! */ case RNDIS_OID_GEN_MAC_OPTIONS: /* from WinME */ pr_debug("%s: RNDIS_OID_GEN_MAC_OPTIONS\n", __func__); *outbuf = cpu_to_le32( RNDIS_MAC_OPTION_RECEIVE_SERIALIZED | RNDIS_MAC_OPTION_FULL_DUPLEX); retval = 0; break; /* statistics OIDs (table 4-2) */ /* mandatory */ case RNDIS_OID_GEN_XMIT_OK: if (rndis_debug > 1) pr_debug("%s: RNDIS_OID_GEN_XMIT_OK\n", __func__); if (stats) { *outbuf = cpu_to_le32(stats->tx_packets - stats->tx_errors - stats->tx_dropped); retval = 0; } break; /* mandatory */ case RNDIS_OID_GEN_RCV_OK: if (rndis_debug > 1) pr_debug("%s: RNDIS_OID_GEN_RCV_OK\n", __func__); if (stats) { *outbuf = cpu_to_le32(stats->rx_packets - stats->rx_errors - stats->rx_dropped); retval = 0; } break; /* mandatory */ case RNDIS_OID_GEN_XMIT_ERROR: if (rndis_debug > 1) pr_debug("%s: RNDIS_OID_GEN_XMIT_ERROR\n", __func__); if (stats) { *outbuf = cpu_to_le32(stats->tx_errors); retval = 0; } break; /* mandatory */ case RNDIS_OID_GEN_RCV_ERROR: if (rndis_debug > 1) pr_debug("%s: RNDIS_OID_GEN_RCV_ERROR\n", __func__); if (stats) { *outbuf = cpu_to_le32(stats->rx_errors); retval = 0; } break; /* mandatory */ case RNDIS_OID_GEN_RCV_NO_BUFFER: pr_debug("%s: RNDIS_OID_GEN_RCV_NO_BUFFER\n", __func__); if (stats) { *outbuf = cpu_to_le32(stats->rx_dropped); retval = 0; } break; /* ieee802.3 OIDs (table 4-3) */ /* mandatory */ case RNDIS_OID_802_3_PERMANENT_ADDRESS: pr_debug("%s: RNDIS_OID_802_3_PERMANENT_ADDRESS\n", __func__); if (params->dev) { length = ETH_ALEN; memcpy(outbuf, params->host_mac, length); retval = 0; } break; /* mandatory */ case RNDIS_OID_802_3_CURRENT_ADDRESS: pr_debug("%s: RNDIS_OID_802_3_CURRENT_ADDRESS\n", __func__); if (params->dev) { length = ETH_ALEN; memcpy(outbuf, params->host_mac, length); retval = 0; } break; /* mandatory */ case RNDIS_OID_802_3_MULTICAST_LIST: pr_debug("%s: RNDIS_OID_802_3_MULTICAST_LIST\n", __func__); /* Multicast base address only */ *outbuf = cpu_to_le32(0xE0000000); retval = 0; break; /* mandatory */ case RNDIS_OID_802_3_MAXIMUM_LIST_SIZE: pr_debug("%s: RNDIS_OID_802_3_MAXIMUM_LIST_SIZE\n", __func__); /* Multicast base address only */ *outbuf = cpu_to_le32(1); retval = 0; break; case RNDIS_OID_802_3_MAC_OPTIONS: pr_debug("%s: RNDIS_OID_802_3_MAC_OPTIONS\n", __func__); *outbuf = cpu_to_le32(0); retval = 0; break; /* ieee802.3 statistics OIDs (table 4-4) */ /* mandatory */ case RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT: pr_debug("%s: RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT\n", __func__); if (stats) { *outbuf = cpu_to_le32(stats->rx_frame_errors); retval = 0; } break; /* mandatory */ case RNDIS_OID_802_3_XMIT_ONE_COLLISION: pr_debug("%s: RNDIS_OID_802_3_XMIT_ONE_COLLISION\n", __func__); *outbuf = cpu_to_le32(0); retval = 0; break; /* mandatory */ case RNDIS_OID_802_3_XMIT_MORE_COLLISIONS: pr_debug("%s: RNDIS_OID_802_3_XMIT_MORE_COLLISIONS\n", __func__); *outbuf = cpu_to_le32(0); retval = 0; break; default: pr_warn("%s: query unknown OID 0x%08X\n", __func__, OID); } if (retval < 0) length = 0; resp->InformationBufferLength = cpu_to_le32(length); r->length = length + sizeof(*resp); resp->MessageLength = cpu_to_le32(r->length); return retval; } static int gen_ndis_set_resp(struct rndis_params *params, u32 OID, u8 *buf, u32 buf_len, rndis_resp_t *r) { rndis_set_cmplt_type *resp; int i, retval = -ENOTSUPP; if (!r) return -ENOMEM; resp = (rndis_set_cmplt_type *)r->buf; if (!resp) return -ENOMEM; if (buf_len && rndis_debug > 1) { pr_debug("set OID %08x value, len %d:\n", OID, buf_len); for (i = 0; i < buf_len; i += 16) { pr_debug("%03d: %08x %08x %08x %08x\n", i, get_unaligned_le32(&buf[i]), get_unaligned_le32(&buf[i + 4]), get_unaligned_le32(&buf[i + 8]), get_unaligned_le32(&buf[i + 12])); } } switch (OID) { case RNDIS_OID_GEN_CURRENT_PACKET_FILTER: /* these NDIS_PACKET_TYPE_* bitflags are shared with * cdc_filter; it's not RNDIS-specific * NDIS_PACKET_TYPE_x == USB_CDC_PACKET_TYPE_x for x in: * PROMISCUOUS, DIRECTED, * MULTICAST, ALL_MULTICAST, BROADCAST */ *params->filter = (u16)get_unaligned_le32(buf); pr_debug("%s: RNDIS_OID_GEN_CURRENT_PACKET_FILTER %08x\n", __func__, *params->filter); /* this call has a significant side effect: it's * what makes the packet flow start and stop, like * activating the CDC Ethernet altsetting. */ retval = 0; if (*params->filter) { params->state = RNDIS_DATA_INITIALIZED; netif_carrier_on(params->dev); if (netif_running(params->dev)) netif_wake_queue(params->dev); } else { params->state = RNDIS_INITIALIZED; netif_carrier_off(params->dev); netif_stop_queue(params->dev); } break; case RNDIS_OID_802_3_MULTICAST_LIST: /* I think we can ignore this */ pr_debug("%s: RNDIS_OID_802_3_MULTICAST_LIST\n", __func__); retval = 0; break; default: pr_warn("%s: set unknown OID 0x%08X, size %d\n", __func__, OID, buf_len); } return retval; } /* * Response Functions */ static int rndis_init_response(struct rndis_params *params, rndis_init_msg_type *buf) { rndis_init_cmplt_type *resp; rndis_resp_t *r; if (!params->dev) return -ENOTSUPP; r = rndis_add_response(params, sizeof(rndis_init_cmplt_type)); if (!r) return -ENOMEM; resp = (rndis_init_cmplt_type *)r->buf; resp->MessageType = cpu_to_le32(RNDIS_MSG_INIT_C); resp->MessageLength = cpu_to_le32(52); resp->RequestID = buf->RequestID; /* Still LE in msg buffer */ resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS); resp->MajorVersion = cpu_to_le32(RNDIS_MAJOR_VERSION); resp->MinorVersion = cpu_to_le32(RNDIS_MINOR_VERSION); resp->DeviceFlags = cpu_to_le32(RNDIS_DF_CONNECTIONLESS); resp->Medium = cpu_to_le32(RNDIS_MEDIUM_802_3); resp->MaxPacketsPerTransfer = cpu_to_le32(1); resp->MaxTransferSize = cpu_to_le32( params->dev->mtu + sizeof(struct ethhdr) + sizeof(struct rndis_packet_msg_type) + 22); resp->PacketAlignmentFactor = cpu_to_le32(0); resp->AFListOffset = cpu_to_le32(0); resp->AFListSize = cpu_to_le32(0); params->resp_avail(params->v); return 0; } static int rndis_query_response(struct rndis_params *params, rndis_query_msg_type *buf) { rndis_query_cmplt_type *resp; rndis_resp_t *r; /* pr_debug("%s: OID = %08X\n", __func__, cpu_to_le32(buf->OID)); */ if (!params->dev) return -ENOTSUPP; /* * we need more memory: * gen_ndis_query_resp expects enough space for * rndis_query_cmplt_type followed by data. * oid_supported_list is the largest data reply */ r = rndis_add_response(params, sizeof(oid_supported_list) + sizeof(rndis_query_cmplt_type)); if (!r) return -ENOMEM; resp = (rndis_query_cmplt_type *)r->buf; resp->MessageType = cpu_to_le32(RNDIS_MSG_QUERY_C); resp->RequestID = buf->RequestID; /* Still LE in msg buffer */ if (gen_ndis_query_resp(params, le32_to_cpu(buf->OID), le32_to_cpu(buf->InformationBufferOffset) + 8 + (u8 *)buf, le32_to_cpu(buf->InformationBufferLength), r)) { /* OID not supported */ resp->Status = cpu_to_le32(RNDIS_STATUS_NOT_SUPPORTED); resp->MessageLength = cpu_to_le32(sizeof *resp); resp->InformationBufferLength = cpu_to_le32(0); resp->InformationBufferOffset = cpu_to_le32(0); } else resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS); params->resp_avail(params->v); return 0; } static int rndis_set_response(struct rndis_params *params, rndis_set_msg_type *buf) { u32 BufLength, BufOffset; rndis_set_cmplt_type *resp; rndis_resp_t *r; BufLength = le32_to_cpu(buf->InformationBufferLength); BufOffset = le32_to_cpu(buf->InformationBufferOffset); if ((BufLength > RNDIS_MAX_TOTAL_SIZE) || (BufOffset + 8 >= RNDIS_MAX_TOTAL_SIZE)) return -EINVAL; r = rndis_add_response(params, sizeof(rndis_set_cmplt_type)); if (!r) return -ENOMEM; resp = (rndis_set_cmplt_type *)r->buf; #ifdef VERBOSE_DEBUG pr_debug("%s: Length: %d\n", __func__, BufLength); pr_debug("%s: Offset: %d\n", __func__, BufOffset); pr_debug("%s: InfoBuffer: ", __func__); for (i = 0; i < BufLength; i++) { pr_debug("%02x ", *(((u8 *) buf) + i + 8 + BufOffset)); } pr_debug("\n"); #endif resp->MessageType = cpu_to_le32(RNDIS_MSG_SET_C); resp->MessageLength = cpu_to_le32(16); resp->RequestID = buf->RequestID; /* Still LE in msg buffer */ if (gen_ndis_set_resp(params, le32_to_cpu(buf->OID), ((u8 *)buf) + 8 + BufOffset, BufLength, r)) resp->Status = cpu_to_le32(RNDIS_STATUS_NOT_SUPPORTED); else resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS); params->resp_avail(params->v); return 0; } static int rndis_reset_response(struct rndis_params *params, rndis_reset_msg_type *buf) { rndis_reset_cmplt_type *resp; rndis_resp_t *r; u8 *xbuf; u32 length; /* drain the response queue */ while ((xbuf = rndis_get_next_response(params, &length))) rndis_free_response(params, xbuf); r = rndis_add_response(params, sizeof(rndis_reset_cmplt_type)); if (!r) return -ENOMEM; resp = (rndis_reset_cmplt_type *)r->buf; resp->MessageType = cpu_to_le32(RNDIS_MSG_RESET_C); resp->MessageLength = cpu_to_le32(16); resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS); /* resent information */ resp->AddressingReset = cpu_to_le32(1); params->resp_avail(params->v); return 0; } static int rndis_keepalive_response(struct rndis_params *params, rndis_keepalive_msg_type *buf) { rndis_keepalive_cmplt_type *resp; rndis_resp_t *r; /* host "should" check only in RNDIS_DATA_INITIALIZED state */ r = rndis_add_response(params, sizeof(rndis_keepalive_cmplt_type)); if (!r) return -ENOMEM; resp = (rndis_keepalive_cmplt_type *)r->buf; resp->MessageType = cpu_to_le32(RNDIS_MSG_KEEPALIVE_C); resp->MessageLength = cpu_to_le32(16); resp->RequestID = buf->RequestID; /* Still LE in msg buffer */ resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS); params->resp_avail(params->v); return 0; } /* * Device to Host Comunication */ static int rndis_indicate_status_msg(struct rndis_params *params, u32 status) { rndis_indicate_status_msg_type *resp; rndis_resp_t *r; if (params->state == RNDIS_UNINITIALIZED) return -ENOTSUPP; r = rndis_add_response(params, sizeof(rndis_indicate_status_msg_type)); if (!r) return -ENOMEM; resp = (rndis_indicate_status_msg_type *)r->buf; resp->MessageType = cpu_to_le32(RNDIS_MSG_INDICATE); resp->MessageLength = cpu_to_le32(20); resp->Status = cpu_to_le32(status); resp->StatusBufferLength = cpu_to_le32(0); resp->StatusBufferOffset = cpu_to_le32(0); params->resp_avail(params->v); return 0; } int rndis_signal_connect(struct rndis_params *params) { params->media_state = RNDIS_MEDIA_STATE_CONNECTED; return rndis_indicate_status_msg(params, RNDIS_STATUS_MEDIA_CONNECT); } EXPORT_SYMBOL_GPL(rndis_signal_connect); int rndis_signal_disconnect(struct rndis_params *params) { params->media_state = RNDIS_MEDIA_STATE_DISCONNECTED; return rndis_indicate_status_msg(params, RNDIS_STATUS_MEDIA_DISCONNECT); } EXPORT_SYMBOL_GPL(rndis_signal_disconnect); void rndis_uninit(struct rndis_params *params) { u8 *buf; u32 length; if (!params) return; params->state = RNDIS_UNINITIALIZED; /* drain the response queue */ while ((buf = rndis_get_next_response(params, &length))) rndis_free_response(params, buf); } EXPORT_SYMBOL_GPL(rndis_uninit); void rndis_set_host_mac(struct rndis_params *params, const u8 *addr) { params->host_mac = addr; } EXPORT_SYMBOL_GPL(rndis_set_host_mac); /* * Message Parser */ int rndis_msg_parser(struct rndis_params *params, u8 *buf) { u32 MsgType, MsgLength; __le32 *tmp; if (!buf) return -ENOMEM; tmp = (__le32 *)buf; MsgType = get_unaligned_le32(tmp++); MsgLength = get_unaligned_le32(tmp++); if (!params) return -ENOTSUPP; /* NOTE: RNDIS is *EXTREMELY* chatty ... Windows constantly polls for * rx/tx statistics and link status, in addition to KEEPALIVE traffic * and normal HC level polling to see if there's any IN traffic. */ /* For USB: responses may take up to 10 seconds */ switch (MsgType) { case RNDIS_MSG_INIT: pr_debug("%s: RNDIS_MSG_INIT\n", __func__); params->state = RNDIS_INITIALIZED; return rndis_init_response(params, (rndis_init_msg_type *)buf); case RNDIS_MSG_HALT: pr_debug("%s: RNDIS_MSG_HALT\n", __func__); params->state = RNDIS_UNINITIALIZED; if (params->dev) { netif_carrier_off(params->dev); netif_stop_queue(params->dev); } return 0; case RNDIS_MSG_QUERY: return rndis_query_response(params, (rndis_query_msg_type *)buf); case RNDIS_MSG_SET: return rndis_set_response(params, (rndis_set_msg_type *)buf); case RNDIS_MSG_RESET: pr_debug("%s: RNDIS_MSG_RESET\n", __func__); return rndis_reset_response(params, (rndis_reset_msg_type *)buf); case RNDIS_MSG_KEEPALIVE: /* For USB: host does this every 5 seconds */ if (rndis_debug > 1) pr_debug("%s: RNDIS_MSG_KEEPALIVE\n", __func__); return rndis_keepalive_response(params, (rndis_keepalive_msg_type *) buf); default: /* At least Windows XP emits some undefined RNDIS messages. * In one case those messages seemed to relate to the host * suspending itself. */ pr_warn("%s: unknown RNDIS message 0x%08X len %d\n", __func__, MsgType, MsgLength); /* Garbled message can be huge, so limit what we display */ if (MsgLength > 16) MsgLength = 16; print_hex_dump_bytes(__func__, DUMP_PREFIX_OFFSET, buf, MsgLength); break; } return -ENOTSUPP; } EXPORT_SYMBOL_GPL(rndis_msg_parser); static inline int rndis_get_nr(void) { return ida_simple_get(&rndis_ida, 0, 0, GFP_KERNEL); } static inline void rndis_put_nr(int nr) { ida_simple_remove(&rndis_ida, nr); } struct rndis_params *rndis_register(void (*resp_avail)(void *v), void *v) { struct rndis_params *params; int i; if (!resp_avail) return ERR_PTR(-EINVAL); i = rndis_get_nr(); if (i < 0) { pr_debug("failed\n"); return ERR_PTR(-ENODEV); } params = kzalloc(sizeof(*params), GFP_KERNEL); if (!params) { rndis_put_nr(i); return ERR_PTR(-ENOMEM); } #ifdef CONFIG_USB_GADGET_DEBUG_FILES { struct proc_dir_entry *proc_entry; char name[20]; sprintf(name, NAME_TEMPLATE, i); proc_entry = proc_create_data(name, 0660, NULL, &rndis_proc_ops, params); if (!proc_entry) { kfree(params); rndis_put_nr(i); return ERR_PTR(-EIO); } } #endif params->confignr = i; params->used = 1; params->state = RNDIS_UNINITIALIZED; params->media_state = RNDIS_MEDIA_STATE_DISCONNECTED; params->resp_avail = resp_avail; params->v = v; INIT_LIST_HEAD(¶ms->resp_queue); pr_debug("%s: configNr = %d\n", __func__, i); return params; } EXPORT_SYMBOL_GPL(rndis_register); void rndis_deregister(struct rndis_params *params) { int i; pr_debug("%s:\n", __func__); if (!params) return; i = params->confignr; #ifdef CONFIG_USB_GADGET_DEBUG_FILES { char name[20]; sprintf(name, NAME_TEMPLATE, i); remove_proc_entry(name, NULL); } #endif kfree(params); rndis_put_nr(i); } EXPORT_SYMBOL_GPL(rndis_deregister); int rndis_set_param_dev(struct rndis_params *params, struct net_device *dev, u16 *cdc_filter) { pr_debug("%s:\n", __func__); if (!dev) return -EINVAL; if (!params) return -1; params->dev = dev; params->filter = cdc_filter; return 0; } EXPORT_SYMBOL_GPL(rndis_set_param_dev); int rndis_set_param_vendor(struct rndis_params *params, u32 vendorID, const char *vendorDescr) { pr_debug("%s:\n", __func__); if (!vendorDescr) return -1; if (!params) return -1; params->vendorID = vendorID; params->vendorDescr = vendorDescr; return 0; } EXPORT_SYMBOL_GPL(rndis_set_param_vendor); int rndis_set_param_medium(struct rndis_params *params, u32 medium, u32 speed) { pr_debug("%s: %u %u\n", __func__, medium, speed); if (!params) return -1; params->medium = medium; params->speed = speed; return 0; } EXPORT_SYMBOL_GPL(rndis_set_param_medium); void rndis_add_hdr(struct sk_buff *skb) { struct rndis_packet_msg_type *header; if (!skb) return; header = skb_push(skb, sizeof(*header)); memset(header, 0, sizeof *header); header->MessageType = cpu_to_le32(RNDIS_MSG_PACKET); header->MessageLength = cpu_to_le32(skb->len); header->DataOffset = cpu_to_le32(36); header->DataLength = cpu_to_le32(skb->len - sizeof(*header)); } EXPORT_SYMBOL_GPL(rndis_add_hdr); void rndis_free_response(struct rndis_params *params, u8 *buf) { rndis_resp_t *r, *n; list_for_each_entry_safe(r, n, ¶ms->resp_queue, list) { if (r->buf == buf) { list_del(&r->list); kfree(r); } } } EXPORT_SYMBOL_GPL(rndis_free_response); u8 *rndis_get_next_response(struct rndis_params *params, u32 *length) { rndis_resp_t *r, *n; if (!length) return NULL; list_for_each_entry_safe(r, n, ¶ms->resp_queue, list) { if (!r->send) { r->send = 1; *length = r->length; return r->buf; } } return NULL; } EXPORT_SYMBOL_GPL(rndis_get_next_response); static rndis_resp_t *rndis_add_response(struct rndis_params *params, u32 length) { rndis_resp_t *r; /* NOTE: this gets copied into ether.c USB_BUFSIZ bytes ... */ r = kmalloc(sizeof(rndis_resp_t) + length, GFP_ATOMIC); if (!r) return NULL; r->buf = (u8 *)(r + 1); r->length = length; r->send = 0; list_add_tail(&r->list, ¶ms->resp_queue); return r; } int rndis_rm_hdr(struct gether *port, struct sk_buff *skb, struct sk_buff_head *list) { /* tmp points to a struct rndis_packet_msg_type */ __le32 *tmp = (void *)skb->data; /* MessageType, MessageLength */ if (cpu_to_le32(RNDIS_MSG_PACKET) != get_unaligned(tmp++)) { dev_kfree_skb_any(skb); return -EINVAL; } tmp++; /* DataOffset, DataLength */ if (!skb_pull(skb, get_unaligned_le32(tmp++) + 8)) { dev_kfree_skb_any(skb); return -EOVERFLOW; } skb_trim(skb, get_unaligned_le32(tmp++)); skb_queue_tail(list, skb); return 0; } EXPORT_SYMBOL_GPL(rndis_rm_hdr); #ifdef CONFIG_USB_GADGET_DEBUG_FILES static int rndis_proc_show(struct seq_file *m, void *v) { rndis_params *param = m->private; seq_printf(m, "Config Nr. %d\n" "used : %s\n" "state : %s\n" "medium : 0x%08X\n" "speed : %d\n" "cable : %s\n" "vendor ID : 0x%08X\n" "vendor : %s\n", param->confignr, (param->used) ? "y" : "n", ({ char *s = "?"; switch (param->state) { case RNDIS_UNINITIALIZED: s = "RNDIS_UNINITIALIZED"; break; case RNDIS_INITIALIZED: s = "RNDIS_INITIALIZED"; break; case RNDIS_DATA_INITIALIZED: s = "RNDIS_DATA_INITIALIZED"; break; } s; }), param->medium, (param->media_state) ? 0 : param->speed*100, (param->media_state) ? "disconnected" : "connected", param->vendorID, param->vendorDescr); return 0; } static ssize_t rndis_proc_write(struct file *file, const char __user *buffer, size_t count, loff_t *ppos) { rndis_params *p = pde_data(file_inode(file)); u32 speed = 0; int i, fl_speed = 0; for (i = 0; i < count; i++) { char c; if (get_user(c, buffer)) return -EFAULT; switch (c) { case '0': case '1': case '2': case '3': case '4': case '5': case '6': case '7': case '8': case '9': fl_speed = 1; speed = speed * 10 + c - '0'; break; case 'C': case 'c': rndis_signal_connect(p); break; case 'D': case 'd': rndis_signal_disconnect(p); break; default: if (fl_speed) p->speed = speed; else pr_debug("%c is not valid\n", c); break; } buffer++; } return count; } static int rndis_proc_open(struct inode *inode, struct file *file) { return single_open(file, rndis_proc_show, pde_data(inode)); } static const struct proc_ops rndis_proc_ops = { .proc_open = rndis_proc_open, .proc_read = seq_read, .proc_lseek = seq_lseek, .proc_release = single_release, .proc_write = rndis_proc_write, }; #define NAME_TEMPLATE "driver/rndis-%03d" #endif /* CONFIG_USB_GADGET_DEBUG_FILES */