1 /******************************************************************************
 
   2  *  usbatm.c - Generic USB xDSL driver core
 
   4  *  Copyright (C) 2001, Alcatel
 
   5  *  Copyright (C) 2003, Duncan Sands, SolNegro, Josep Comas
 
   6  *  Copyright (C) 2004, David Woodhouse, Roman Kagan
 
   8  *  This program is free software; you can redistribute it and/or modify it
 
   9  *  under the terms of the GNU General Public License as published by the Free
 
  10  *  Software Foundation; either version 2 of the License, or (at your option)
 
  13  *  This program is distributed in the hope that it will be useful, but WITHOUT
 
  14  *  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 
  15  *  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
 
  18  *  You should have received a copy of the GNU General Public License along with
 
  19  *  this program; if not, write to the Free Software Foundation, Inc., 59
 
  20  *  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
  22  ******************************************************************************/
 
  25  *  Written by Johan Verrept, Duncan Sands (duncan.sands@free.fr) and David Woodhouse
 
  27  *  1.7+:       - See the check-in logs
 
  29  *  1.6:        - No longer opens a connection if the firmware is not loaded
 
  30  *              - Added support for the speedtouch 330
 
  31  *              - Removed the limit on the number of devices
 
  32  *              - Module now autoloads on device plugin
 
  33  *              - Merged relevant parts of sarlib
 
  34  *              - Replaced the kernel thread with a tasklet
 
  35  *              - New packet transmission code
 
  36  *              - Changed proc file contents
 
  37  *              - Fixed all known SMP races
 
  38  *              - Many fixes and cleanups
 
  39  *              - Various fixes by Oliver Neukum (oliver@neukum.name)
 
  41  *  1.5A:       - Version for inclusion in 2.5 series kernel
 
  42  *              - Modifications by Richard Purdie (rpurdie@rpsys.net)
 
  43  *              - made compatible with kernel 2.5.6 onwards by changing
 
  44  *              usbatm_usb_send_data_context->urb to a pointer and adding code
 
  45  *              to alloc and free it
 
  46  *              - remove_wait_queue() added to usbatm_atm_processqueue_thread()
 
  48  *  1.5:        - fixed memory leak when atmsar_decode_aal5 returned NULL.
 
  49  *              (reported by stephen.robinson@zen.co.uk)
 
  51  *  1.4:        - changed the spin_lock() under interrupt to spin_lock_irqsave()
 
  52  *              - unlink all active send urbs of a vcc that is being closed.
 
  54  *  1.3.1:      - added the version number
 
  56  *  1.3:        - Added multiple send urb support
 
  57  *              - fixed memory leak and vcc->tx_inuse starvation bug
 
  58  *                when not enough memory left in vcc.
 
  60  *  1.2:        - Fixed race condition in usbatm_usb_send_data()
 
  61  *  1.1:        - Turned off packet debugging
 
  67 #include <asm/uaccess.h>
 
  68 #include <linux/crc32.h>
 
  69 #include <linux/errno.h>
 
  70 #include <linux/init.h>
 
  71 #include <linux/interrupt.h>
 
  72 #include <linux/kernel.h>
 
  73 #include <linux/module.h>
 
  74 #include <linux/moduleparam.h>
 
  75 #include <linux/netdevice.h>
 
  76 #include <linux/proc_fs.h>
 
  77 #include <linux/sched.h>
 
  78 #include <linux/signal.h>
 
  79 #include <linux/slab.h>
 
  80 #include <linux/stat.h>
 
  81 #include <linux/timer.h>
 
  82 #include <linux/wait.h>
 
  83 #include <linux/kthread.h>
 
  86 static int usbatm_print_packet(const unsigned char *data, int len);
 
  87 #define PACKETDEBUG(arg...)     usbatm_print_packet (arg)
 
  88 #define vdbg(arg...)            dbg (arg)
 
  90 #define PACKETDEBUG(arg...)
 
  94 #define DRIVER_AUTHOR   "Johan Verrept, Duncan Sands <duncan.sands@free.fr>"
 
  95 #define DRIVER_VERSION  "1.10"
 
  96 #define DRIVER_DESC     "Generic USB ATM/DSL I/O, version " DRIVER_VERSION
 
  98 static const char usbatm_driver_name[] = "usbatm";
 
 100 #define UDSL_MAX_RCV_URBS               16
 
 101 #define UDSL_MAX_SND_URBS               16
 
 102 #define UDSL_MAX_BUF_SIZE               65536
 
 103 #define UDSL_DEFAULT_RCV_URBS           4
 
 104 #define UDSL_DEFAULT_SND_URBS           4
 
 105 #define UDSL_DEFAULT_RCV_BUF_SIZE       3392    /* 64 * ATM_CELL_SIZE */
 
 106 #define UDSL_DEFAULT_SND_BUF_SIZE       3392    /* 64 * ATM_CELL_SIZE */
 
 108 #define ATM_CELL_HEADER                 (ATM_CELL_SIZE - ATM_CELL_PAYLOAD)
 
 110 #define THROTTLE_MSECS                  100     /* delay to recover processing after urb submission fails */
 
 112 static unsigned int num_rcv_urbs = UDSL_DEFAULT_RCV_URBS;
 
 113 static unsigned int num_snd_urbs = UDSL_DEFAULT_SND_URBS;
 
 114 static unsigned int rcv_buf_bytes = UDSL_DEFAULT_RCV_BUF_SIZE;
 
 115 static unsigned int snd_buf_bytes = UDSL_DEFAULT_SND_BUF_SIZE;
 
 117 module_param(num_rcv_urbs, uint, S_IRUGO);
 
 118 MODULE_PARM_DESC(num_rcv_urbs,
 
 119                  "Number of urbs used for reception (range: 0-"
 
 120                  __MODULE_STRING(UDSL_MAX_RCV_URBS) ", default: "
 
 121                  __MODULE_STRING(UDSL_DEFAULT_RCV_URBS) ")");
 
 123 module_param(num_snd_urbs, uint, S_IRUGO);
 
 124 MODULE_PARM_DESC(num_snd_urbs,
 
 125                  "Number of urbs used for transmission (range: 0-"
 
 126                  __MODULE_STRING(UDSL_MAX_SND_URBS) ", default: "
 
 127                  __MODULE_STRING(UDSL_DEFAULT_SND_URBS) ")");
 
 129 module_param(rcv_buf_bytes, uint, S_IRUGO);
 
 130 MODULE_PARM_DESC(rcv_buf_bytes,
 
 131                  "Size of the buffers used for reception, in bytes (range: 1-"
 
 132                  __MODULE_STRING(UDSL_MAX_BUF_SIZE) ", default: "
 
 133                  __MODULE_STRING(UDSL_DEFAULT_RCV_BUF_SIZE) ")");
 
 135 module_param(snd_buf_bytes, uint, S_IRUGO);
 
 136 MODULE_PARM_DESC(snd_buf_bytes,
 
 137                  "Size of the buffers used for transmission, in bytes (range: 1-"
 
 138                  __MODULE_STRING(UDSL_MAX_BUF_SIZE) ", default: "
 
 139                  __MODULE_STRING(UDSL_DEFAULT_SND_BUF_SIZE) ")");
 
 144 struct usbatm_vcc_data {
 
 146         struct list_head list;
 
 151         /* raw cell reassembly */
 
 152         struct sk_buff *sarb;
 
 158 struct usbatm_control {
 
 159         struct atm_skb_data atm;
 
 164 #define UDSL_SKB(x)             ((struct usbatm_control *)(x)->cb)
 
 169 static void usbatm_atm_dev_close(struct atm_dev *atm_dev);
 
 170 static int usbatm_atm_open(struct atm_vcc *vcc);
 
 171 static void usbatm_atm_close(struct atm_vcc *vcc);
 
 172 static int usbatm_atm_ioctl(struct atm_dev *atm_dev, unsigned int cmd, void __user * arg);
 
 173 static int usbatm_atm_send(struct atm_vcc *vcc, struct sk_buff *skb);
 
 174 static int usbatm_atm_proc_read(struct atm_dev *atm_dev, loff_t * pos, char *page);
 
 176 static struct atmdev_ops usbatm_atm_devops = {
 
 177         .dev_close      = usbatm_atm_dev_close,
 
 178         .open           = usbatm_atm_open,
 
 179         .close          = usbatm_atm_close,
 
 180         .ioctl          = usbatm_atm_ioctl,
 
 181         .send           = usbatm_atm_send,
 
 182         .proc_read      = usbatm_atm_proc_read,
 
 183         .owner          = THIS_MODULE,
 
 191 static inline unsigned int usbatm_pdu_length(unsigned int length)
 
 193         length += ATM_CELL_PAYLOAD - 1 + ATM_AAL5_TRAILER;
 
 194         return length - length % ATM_CELL_PAYLOAD;
 
 197 static inline void usbatm_pop(struct atm_vcc *vcc, struct sk_buff *skb)
 
 202                 dev_kfree_skb_any(skb);
 
 210 static struct urb *usbatm_pop_urb(struct usbatm_channel *channel)
 
 214         spin_lock_irq(&channel->lock);
 
 215         if (list_empty(&channel->list)) {
 
 216                 spin_unlock_irq(&channel->lock);
 
 220         urb = list_entry(channel->list.next, struct urb, urb_list);
 
 221         list_del(&urb->urb_list);
 
 222         spin_unlock_irq(&channel->lock);
 
 227 static int usbatm_submit_urb(struct urb *urb)
 
 229         struct usbatm_channel *channel = urb->context;
 
 232         vdbg("%s: submitting urb 0x%p, size %u",
 
 233              __func__, urb, urb->transfer_buffer_length);
 
 235         ret = usb_submit_urb(urb, GFP_ATOMIC);
 
 237                 if (printk_ratelimit())
 
 238                         atm_warn(channel->usbatm, "%s: urb 0x%p submission failed (%d)!\n",
 
 241                 /* consider all errors transient and return the buffer back to the queue */
 
 242                 urb->status = -EAGAIN;
 
 243                 spin_lock_irq(&channel->lock);
 
 245                 /* must add to the front when sending; doesn't matter when receiving */
 
 246                 list_add(&urb->urb_list, &channel->list);
 
 248                 spin_unlock_irq(&channel->lock);
 
 250                 /* make sure the channel doesn't stall */
 
 251                 mod_timer(&channel->delay, jiffies + msecs_to_jiffies(THROTTLE_MSECS));
 
 257 static void usbatm_complete(struct urb *urb)
 
 259         struct usbatm_channel *channel = urb->context;
 
 261         int status = urb->status;
 
 263         vdbg("%s: urb 0x%p, status %d, actual_length %d",
 
 264              __func__, urb, status, urb->actual_length);
 
 266         /* usually in_interrupt(), but not always */
 
 267         spin_lock_irqsave(&channel->lock, flags);
 
 269         /* must add to the back when receiving; doesn't matter when sending */
 
 270         list_add_tail(&urb->urb_list, &channel->list);
 
 272         spin_unlock_irqrestore(&channel->lock, flags);
 
 274         if (unlikely(status) &&
 
 275                         (!(channel->usbatm->flags & UDSL_IGNORE_EILSEQ) ||
 
 278                 if (status == -ESHUTDOWN)
 
 281                 if (printk_ratelimit())
 
 282                         atm_warn(channel->usbatm, "%s: urb 0x%p failed (%d)!\n",
 
 283                                 __func__, urb, status);
 
 284                 /* throttle processing in case of an error */
 
 285                 mod_timer(&channel->delay, jiffies + msecs_to_jiffies(THROTTLE_MSECS));
 
 287                 tasklet_schedule(&channel->tasklet);
 
 295 static inline struct usbatm_vcc_data *usbatm_find_vcc(struct usbatm_data *instance,
 
 298         struct usbatm_vcc_data *vcc_data;
 
 300         list_for_each_entry(vcc_data, &instance->vcc_list, list)
 
 301                 if ((vcc_data->vci == vci) && (vcc_data->vpi == vpi))
 
 306 static void usbatm_extract_one_cell(struct usbatm_data *instance, unsigned char *source)
 
 309         struct sk_buff *sarb;
 
 310         short vpi = ((source[0] & 0x0f) << 4)  | (source[1] >> 4);
 
 311         int vci = ((source[1] & 0x0f) << 12) | (source[2] << 4) | (source[3] >> 4);
 
 312         u8 pti = ((source[3] & 0xe) >> 1);
 
 314         vdbg("%s: vpi %hd, vci %d, pti %d", __func__, vpi, vci, pti);
 
 316         if ((vci != instance->cached_vci) || (vpi != instance->cached_vpi)) {
 
 317                 instance->cached_vpi = vpi;
 
 318                 instance->cached_vci = vci;
 
 320                 instance->cached_vcc = usbatm_find_vcc(instance, vpi, vci);
 
 322                 if (!instance->cached_vcc)
 
 323                         atm_rldbg(instance, "%s: unknown vpi/vci (%hd/%d)!\n", __func__, vpi, vci);
 
 326         if (!instance->cached_vcc)
 
 329         vcc = instance->cached_vcc->vcc;
 
 331         /* OAM F5 end-to-end */
 
 332         if (pti == ATM_PTI_E2EF5) {
 
 333                 if (printk_ratelimit())
 
 334                         atm_warn(instance, "%s: OAM not supported (vpi %d, vci %d)!\n",
 
 336                 atomic_inc(&vcc->stats->rx_err);
 
 340         sarb = instance->cached_vcc->sarb;
 
 342         if (sarb->tail + ATM_CELL_PAYLOAD > sarb->end) {
 
 343                 atm_rldbg(instance, "%s: buffer overrun (sarb->len %u, vcc: 0x%p)!\n",
 
 344                                 __func__, sarb->len, vcc);
 
 345                 /* discard cells already received */
 
 347                 UDSL_ASSERT(instance, sarb->tail + ATM_CELL_PAYLOAD <= sarb->end);
 
 350         memcpy(skb_tail_pointer(sarb), source + ATM_CELL_HEADER, ATM_CELL_PAYLOAD);
 
 351         __skb_put(sarb, ATM_CELL_PAYLOAD);
 
 356                 unsigned int pdu_length;
 
 358                 length = (source[ATM_CELL_SIZE - 6] << 8) + source[ATM_CELL_SIZE - 5];
 
 360                 /* guard against overflow */
 
 361                 if (length > ATM_MAX_AAL5_PDU) {
 
 362                         atm_rldbg(instance, "%s: bogus length %u (vcc: 0x%p)!\n",
 
 363                                   __func__, length, vcc);
 
 364                         atomic_inc(&vcc->stats->rx_err);
 
 368                 pdu_length = usbatm_pdu_length(length);
 
 370                 if (sarb->len < pdu_length) {
 
 371                         atm_rldbg(instance, "%s: bogus pdu_length %u (sarb->len: %u, vcc: 0x%p)!\n",
 
 372                                   __func__, pdu_length, sarb->len, vcc);
 
 373                         atomic_inc(&vcc->stats->rx_err);
 
 377                 if (crc32_be(~0, skb_tail_pointer(sarb) - pdu_length, pdu_length) != 0xc704dd7b) {
 
 378                         atm_rldbg(instance, "%s: packet failed crc check (vcc: 0x%p)!\n",
 
 380                         atomic_inc(&vcc->stats->rx_err);
 
 384                 vdbg("%s: got packet (length: %u, pdu_length: %u, vcc: 0x%p)", __func__, length, pdu_length, vcc);
 
 386                 if (!(skb = dev_alloc_skb(length))) {
 
 387                         if (printk_ratelimit())
 
 388                                 atm_err(instance, "%s: no memory for skb (length: %u)!\n",
 
 390                         atomic_inc(&vcc->stats->rx_drop);
 
 394                 vdbg("%s: allocated new sk_buff (skb: 0x%p, skb->truesize: %u)", __func__, skb, skb->truesize);
 
 396                 if (!atm_charge(vcc, skb->truesize)) {
 
 397                         atm_rldbg(instance, "%s: failed atm_charge (skb->truesize: %u)!\n",
 
 398                                   __func__, skb->truesize);
 
 399                         dev_kfree_skb_any(skb);
 
 400                         goto out;       /* atm_charge increments rx_drop */
 
 403                 skb_copy_to_linear_data(skb,
 
 404                                         skb_tail_pointer(sarb) - pdu_length,
 
 406                 __skb_put(skb, length);
 
 408                 vdbg("%s: sending skb 0x%p, skb->len %u, skb->truesize %u",
 
 409                      __func__, skb, skb->len, skb->truesize);
 
 411                 PACKETDEBUG(skb->data, skb->len);
 
 415                 atomic_inc(&vcc->stats->rx);
 
 421 static void usbatm_extract_cells(struct usbatm_data *instance,
 
 422                 unsigned char *source, unsigned int avail_data)
 
 424         unsigned int stride = instance->rx_channel.stride;
 
 425         unsigned int buf_usage = instance->buf_usage;
 
 427         /* extract cells from incoming data, taking into account that
 
 428          * the length of avail data may not be a multiple of stride */
 
 431                 /* we have a partially received atm cell */
 
 432                 unsigned char *cell_buf = instance->cell_buf;
 
 433                 unsigned int space_left = stride - buf_usage;
 
 435                 UDSL_ASSERT(instance, buf_usage <= stride);
 
 437                 if (avail_data >= space_left) {
 
 438                         /* add new data and process cell */
 
 439                         memcpy(cell_buf + buf_usage, source, space_left);
 
 440                         source += space_left;
 
 441                         avail_data -= space_left;
 
 442                         usbatm_extract_one_cell(instance, cell_buf);
 
 443                         instance->buf_usage = 0;
 
 445                         /* not enough data to fill the cell */
 
 446                         memcpy(cell_buf + buf_usage, source, avail_data);
 
 447                         instance->buf_usage = buf_usage + avail_data;
 
 452         for (; avail_data >= stride; avail_data -= stride, source += stride)
 
 453                 usbatm_extract_one_cell(instance, source);
 
 455         if (avail_data > 0) {
 
 456                 /* length was not a multiple of stride -
 
 457                  * save remaining data for next call */
 
 458                 memcpy(instance->cell_buf, source, avail_data);
 
 459                 instance->buf_usage = avail_data;
 
 468 static unsigned int usbatm_write_cells(struct usbatm_data *instance,
 
 470                                        u8 *target, unsigned int avail_space)
 
 472         struct usbatm_control *ctrl = UDSL_SKB(skb);
 
 473         struct atm_vcc *vcc = ctrl->atm.vcc;
 
 474         unsigned int bytes_written;
 
 475         unsigned int stride = instance->tx_channel.stride;
 
 477         vdbg("%s: skb->len=%d, avail_space=%u", __func__, skb->len, avail_space);
 
 478         UDSL_ASSERT(instance, !(avail_space % stride));
 
 480         for (bytes_written = 0; bytes_written < avail_space && ctrl->len;
 
 481              bytes_written += stride, target += stride) {
 
 482                 unsigned int data_len = min_t(unsigned int, skb->len, ATM_CELL_PAYLOAD);
 
 483                 unsigned int left = ATM_CELL_PAYLOAD - data_len;
 
 486                 ptr[0] = vcc->vpi >> 4;
 
 487                 ptr[1] = (vcc->vpi << 4) | (vcc->vci >> 12);
 
 488                 ptr[2] = vcc->vci >> 4;
 
 489                 ptr[3] = vcc->vci << 4;
 
 491                 ptr += ATM_CELL_HEADER;
 
 493                 skb_copy_from_linear_data(skb, ptr, data_len);
 
 495                 __skb_pull(skb, data_len);
 
 500                 memset(ptr, 0, left);
 
 502                 if (left >= ATM_AAL5_TRAILER) { /* trailer will go in this cell */
 
 503                         u8 *trailer = target + ATM_CELL_SIZE - ATM_AAL5_TRAILER;
 
 504                         /* trailer[0] = 0;              UU = 0 */
 
 505                         /* trailer[1] = 0;              CPI = 0 */
 
 506                         trailer[2] = ctrl->len >> 8;
 
 507                         trailer[3] = ctrl->len;
 
 509                         ctrl->crc = ~ crc32_be(ctrl->crc, ptr, left - 4);
 
 511                         trailer[4] = ctrl->crc >> 24;
 
 512                         trailer[5] = ctrl->crc >> 16;
 
 513                         trailer[6] = ctrl->crc >> 8;
 
 514                         trailer[7] = ctrl->crc;
 
 516                         target[3] |= 0x2;       /* adjust PTI */
 
 518                         ctrl->len = 0;          /* tag this skb finished */
 
 521                         ctrl->crc = crc32_be(ctrl->crc, ptr, left);
 
 524         return bytes_written;
 
 532 static void usbatm_rx_process(unsigned long data)
 
 534         struct usbatm_data *instance = (struct usbatm_data *)data;
 
 537         while ((urb = usbatm_pop_urb(&instance->rx_channel))) {
 
 538                 vdbg("%s: processing urb 0x%p", __func__, urb);
 
 540                 if (usb_pipeisoc(urb->pipe)) {
 
 541                         unsigned char *merge_start = NULL;
 
 542                         unsigned int merge_length = 0;
 
 543                         const unsigned int packet_size = instance->rx_channel.packet_size;
 
 546                         for (i = 0; i < urb->number_of_packets; i++) {
 
 547                                 if (!urb->iso_frame_desc[i].status) {
 
 548                                         unsigned int actual_length = urb->iso_frame_desc[i].actual_length;
 
 550                                         UDSL_ASSERT(instance, actual_length <= packet_size);
 
 553                                                 merge_start = (unsigned char *)urb->transfer_buffer + urb->iso_frame_desc[i].offset;
 
 554                                         merge_length += actual_length;
 
 555                                         if (merge_length && (actual_length < packet_size)) {
 
 556                                                 usbatm_extract_cells(instance, merge_start, merge_length);
 
 560                                         atm_rldbg(instance, "%s: status %d in frame %d!\n", __func__, urb->status, i);
 
 562                                                 usbatm_extract_cells(instance, merge_start, merge_length);
 
 564                                         instance->buf_usage = 0;
 
 569                                 usbatm_extract_cells(instance, merge_start, merge_length);
 
 572                                 usbatm_extract_cells(instance, urb->transfer_buffer, urb->actual_length);
 
 574                                 instance->buf_usage = 0;
 
 576                 if (usbatm_submit_urb(urb))
 
 586 static void usbatm_tx_process(unsigned long data)
 
 588         struct usbatm_data *instance = (struct usbatm_data *)data;
 
 589         struct sk_buff *skb = instance->current_skb;
 
 590         struct urb *urb = NULL;
 
 591         const unsigned int buf_size = instance->tx_channel.buf_size;
 
 592         unsigned int bytes_written = 0;
 
 596                 skb = skb_dequeue(&instance->sndqueue);
 
 600                         urb = usbatm_pop_urb(&instance->tx_channel);
 
 602                                 break;          /* no more senders */
 
 603                         buffer = urb->transfer_buffer;
 
 604                         bytes_written = (urb->status == -EAGAIN) ?
 
 605                                 urb->transfer_buffer_length : 0;
 
 608                 bytes_written += usbatm_write_cells(instance, skb,
 
 609                                                   buffer + bytes_written,
 
 610                                                   buf_size - bytes_written);
 
 612                 vdbg("%s: wrote %u bytes from skb 0x%p to urb 0x%p",
 
 613                      __func__, bytes_written, skb, urb);
 
 615                 if (!UDSL_SKB(skb)->len) {
 
 616                         struct atm_vcc *vcc = UDSL_SKB(skb)->atm.vcc;
 
 618                         usbatm_pop(vcc, skb);
 
 619                         atomic_inc(&vcc->stats->tx);
 
 621                         skb = skb_dequeue(&instance->sndqueue);
 
 624                 if (bytes_written == buf_size || (!skb && bytes_written)) {
 
 625                         urb->transfer_buffer_length = bytes_written;
 
 627                         if (usbatm_submit_urb(urb))
 
 633         instance->current_skb = skb;
 
 636 static void usbatm_cancel_send(struct usbatm_data *instance,
 
 639         struct sk_buff *skb, *n;
 
 641         atm_dbg(instance, "%s entered\n", __func__);
 
 642         spin_lock_irq(&instance->sndqueue.lock);
 
 643         skb_queue_walk_safe(&instance->sndqueue, skb, n) {
 
 644                 if (UDSL_SKB(skb)->atm.vcc == vcc) {
 
 645                         atm_dbg(instance, "%s: popping skb 0x%p\n", __func__, skb);
 
 646                         __skb_unlink(skb, &instance->sndqueue);
 
 647                         usbatm_pop(vcc, skb);
 
 650         spin_unlock_irq(&instance->sndqueue.lock);
 
 652         tasklet_disable(&instance->tx_channel.tasklet);
 
 653         if ((skb = instance->current_skb) && (UDSL_SKB(skb)->atm.vcc == vcc)) {
 
 654                 atm_dbg(instance, "%s: popping current skb (0x%p)\n", __func__, skb);
 
 655                 instance->current_skb = NULL;
 
 656                 usbatm_pop(vcc, skb);
 
 658         tasklet_enable(&instance->tx_channel.tasklet);
 
 659         atm_dbg(instance, "%s done\n", __func__);
 
 662 static int usbatm_atm_send(struct atm_vcc *vcc, struct sk_buff *skb)
 
 664         struct usbatm_data *instance = vcc->dev->dev_data;
 
 665         struct usbatm_control *ctrl = UDSL_SKB(skb);
 
 668         vdbg("%s called (skb 0x%p, len %u)", __func__, skb, skb->len);
 
 670         /* racy disconnection check - fine */
 
 671         if (!instance || instance->disconnected) {
 
 673                 if (printk_ratelimit())
 
 674                         printk(KERN_DEBUG "%s: %s!\n", __func__, instance ? "disconnected" : "NULL instance");
 
 680         if (vcc->qos.aal != ATM_AAL5) {
 
 681                 atm_rldbg(instance, "%s: unsupported ATM type %d!\n", __func__, vcc->qos.aal);
 
 686         if (skb->len > ATM_MAX_AAL5_PDU) {
 
 687                 atm_rldbg(instance, "%s: packet too long (%d vs %d)!\n",
 
 688                                 __func__, skb->len, ATM_MAX_AAL5_PDU);
 
 693         PACKETDEBUG(skb->data, skb->len);
 
 695         /* initialize the control block */
 
 697         ctrl->len = skb->len;
 
 698         ctrl->crc = crc32_be(~0, skb->data, skb->len);
 
 700         skb_queue_tail(&instance->sndqueue, skb);
 
 701         tasklet_schedule(&instance->tx_channel.tasklet);
 
 706         usbatm_pop(vcc, skb);
 
 711 /********************
 
 713 ********************/
 
 715 static void usbatm_destroy_instance(struct kref *kref)
 
 717         struct usbatm_data *instance = container_of(kref, struct usbatm_data, refcount);
 
 721         tasklet_kill(&instance->rx_channel.tasklet);
 
 722         tasklet_kill(&instance->tx_channel.tasklet);
 
 723         usb_put_dev(instance->usb_dev);
 
 727 static void usbatm_get_instance(struct usbatm_data *instance)
 
 731         kref_get(&instance->refcount);
 
 734 static void usbatm_put_instance(struct usbatm_data *instance)
 
 738         kref_put(&instance->refcount, usbatm_destroy_instance);
 
 746 static void usbatm_atm_dev_close(struct atm_dev *atm_dev)
 
 748         struct usbatm_data *instance = atm_dev->dev_data;
 
 755         atm_dev->dev_data = NULL; /* catch bugs */
 
 756         usbatm_put_instance(instance);  /* taken in usbatm_atm_init */
 
 759 static int usbatm_atm_proc_read(struct atm_dev *atm_dev, loff_t * pos, char *page)
 
 761         struct usbatm_data *instance = atm_dev->dev_data;
 
 765                 dbg("%s: NULL instance!", __func__);
 
 770                 return sprintf(page, "%s\n", instance->description);
 
 773                 return sprintf(page, "MAC: %pM\n", atm_dev->esi);
 
 777                                "AAL5: tx %d ( %d err ), rx %d ( %d err, %d drop )\n",
 
 778                                atomic_read(&atm_dev->stats.aal5.tx),
 
 779                                atomic_read(&atm_dev->stats.aal5.tx_err),
 
 780                                atomic_read(&atm_dev->stats.aal5.rx),
 
 781                                atomic_read(&atm_dev->stats.aal5.rx_err),
 
 782                                atomic_read(&atm_dev->stats.aal5.rx_drop));
 
 785                 if (instance->disconnected)
 
 786                         return sprintf(page, "Disconnected\n");
 
 788                         switch (atm_dev->signal) {
 
 789                         case ATM_PHY_SIG_FOUND:
 
 790                                 return sprintf(page, "Line up\n");
 
 791                         case ATM_PHY_SIG_LOST:
 
 792                                 return sprintf(page, "Line down\n");
 
 794                                 return sprintf(page, "Line state unknown\n");
 
 801 static int usbatm_atm_open(struct atm_vcc *vcc)
 
 803         struct usbatm_data *instance = vcc->dev->dev_data;
 
 804         struct usbatm_vcc_data *new = NULL;
 
 807         short vpi = vcc->vpi;
 
 810                 dbg("%s: NULL data!", __func__);
 
 814         atm_dbg(instance, "%s: vpi %hd, vci %d\n", __func__, vpi, vci);
 
 816         /* only support AAL5 */
 
 817         if ((vcc->qos.aal != ATM_AAL5)) {
 
 818                 atm_warn(instance, "%s: unsupported ATM type %d!\n", __func__, vcc->qos.aal);
 
 823         if ((vcc->qos.rxtp.max_sdu < 0) || (vcc->qos.rxtp.max_sdu > ATM_MAX_AAL5_PDU)) {
 
 824                 atm_dbg(instance, "%s: max_sdu %d out of range!\n", __func__, vcc->qos.rxtp.max_sdu);
 
 828         mutex_lock(&instance->serialize);       /* vs self, usbatm_atm_close, usbatm_usb_disconnect */
 
 830         if (instance->disconnected) {
 
 831                 atm_dbg(instance, "%s: disconnected!\n", __func__);
 
 836         if (usbatm_find_vcc(instance, vpi, vci)) {
 
 837                 atm_dbg(instance, "%s: %hd/%d already in use!\n", __func__, vpi, vci);
 
 842         if (!(new = kzalloc(sizeof(struct usbatm_vcc_data), GFP_KERNEL))) {
 
 843                 atm_err(instance, "%s: no memory for vcc_data!\n", __func__);
 
 852         new->sarb = alloc_skb(usbatm_pdu_length(vcc->qos.rxtp.max_sdu), GFP_KERNEL);
 
 854                 atm_err(instance, "%s: no memory for SAR buffer!\n", __func__);
 
 861         tasklet_disable(&instance->rx_channel.tasklet);
 
 862         instance->cached_vcc = new;
 
 863         instance->cached_vpi = vpi;
 
 864         instance->cached_vci = vci;
 
 865         list_add(&new->list, &instance->vcc_list);
 
 866         tasklet_enable(&instance->rx_channel.tasklet);
 
 868         set_bit(ATM_VF_ADDR, &vcc->flags);
 
 869         set_bit(ATM_VF_PARTIAL, &vcc->flags);
 
 870         set_bit(ATM_VF_READY, &vcc->flags);
 
 872         mutex_unlock(&instance->serialize);
 
 874         atm_dbg(instance, "%s: allocated vcc data 0x%p\n", __func__, new);
 
 880         mutex_unlock(&instance->serialize);
 
 884 static void usbatm_atm_close(struct atm_vcc *vcc)
 
 886         struct usbatm_data *instance = vcc->dev->dev_data;
 
 887         struct usbatm_vcc_data *vcc_data = vcc->dev_data;
 
 889         if (!instance || !vcc_data) {
 
 890                 dbg("%s: NULL data!", __func__);
 
 894         atm_dbg(instance, "%s entered\n", __func__);
 
 896         atm_dbg(instance, "%s: deallocating vcc 0x%p with vpi %d vci %d\n",
 
 897                 __func__, vcc_data, vcc_data->vpi, vcc_data->vci);
 
 899         usbatm_cancel_send(instance, vcc);
 
 901         mutex_lock(&instance->serialize);       /* vs self, usbatm_atm_open, usbatm_usb_disconnect */
 
 903         tasklet_disable(&instance->rx_channel.tasklet);
 
 904         if (instance->cached_vcc == vcc_data) {
 
 905                 instance->cached_vcc = NULL;
 
 906                 instance->cached_vpi = ATM_VPI_UNSPEC;
 
 907                 instance->cached_vci = ATM_VCI_UNSPEC;
 
 909         list_del(&vcc_data->list);
 
 910         tasklet_enable(&instance->rx_channel.tasklet);
 
 912         kfree_skb(vcc_data->sarb);
 
 913         vcc_data->sarb = NULL;
 
 916         vcc->dev_data = NULL;
 
 918         vcc->vpi = ATM_VPI_UNSPEC;
 
 919         vcc->vci = ATM_VCI_UNSPEC;
 
 920         clear_bit(ATM_VF_READY, &vcc->flags);
 
 921         clear_bit(ATM_VF_PARTIAL, &vcc->flags);
 
 922         clear_bit(ATM_VF_ADDR, &vcc->flags);
 
 924         mutex_unlock(&instance->serialize);
 
 926         atm_dbg(instance, "%s successful\n", __func__);
 
 929 static int usbatm_atm_ioctl(struct atm_dev *atm_dev, unsigned int cmd,
 
 932         struct usbatm_data *instance = atm_dev->dev_data;
 
 934         if (!instance || instance->disconnected) {
 
 935                 dbg("%s: %s!", __func__, instance ? "disconnected" : "NULL instance");
 
 941                 return put_user(ATM_LM_NONE, (int __user *)arg) ? -EFAULT : 0;
 
 947 static int usbatm_atm_init(struct usbatm_data *instance)
 
 949         struct atm_dev *atm_dev;
 
 952         /* ATM init.  The ATM initialization scheme suffers from an intrinsic race
 
 953          * condition: callbacks we register can be executed at once, before we have
 
 954          * initialized the struct atm_dev.  To protect against this, all callbacks
 
 955          * abort if atm_dev->dev_data is NULL. */
 
 956         atm_dev = atm_dev_register(instance->driver_name, &usbatm_atm_devops, -1, NULL);
 
 958                 usb_err(instance, "%s: failed to register ATM device!\n", __func__);
 
 962         instance->atm_dev = atm_dev;
 
 964         atm_dev->ci_range.vpi_bits = ATM_CI_MAX;
 
 965         atm_dev->ci_range.vci_bits = ATM_CI_MAX;
 
 966         atm_dev->signal = ATM_PHY_SIG_UNKNOWN;
 
 968         /* temp init ATM device, set to 128kbit */
 
 969         atm_dev->link_rate = 128 * 1000 / 424;
 
 971         ret = sysfs_create_link(&atm_dev->class_dev.kobj,
 
 972                                 &instance->usb_intf->dev.kobj, "device");
 
 974                 atm_err(instance, "%s: sysfs_create_link failed: %d\n",
 
 979         if (instance->driver->atm_start && ((ret = instance->driver->atm_start(instance, atm_dev)) < 0)) {
 
 980                 atm_err(instance, "%s: atm_start failed: %d!\n", __func__, ret);
 
 984         usbatm_get_instance(instance);  /* dropped in usbatm_atm_dev_close */
 
 986         /* ready for ATM callbacks */
 
 988         atm_dev->dev_data = instance;
 
 990         /* submit all rx URBs */
 
 991         for (i = 0; i < num_rcv_urbs; i++)
 
 992                 usbatm_submit_urb(instance->urbs[i]);
 
 997         sysfs_remove_link(&atm_dev->class_dev.kobj, "device");
 
 999         instance->atm_dev = NULL;
 
1000         atm_dev_deregister(atm_dev); /* usbatm_atm_dev_close will eventually be called */
 
1009 static int usbatm_do_heavy_init(void *arg)
 
1011         struct usbatm_data *instance = arg;
 
1014         allow_signal(SIGTERM);
 
1015         complete(&instance->thread_started);
 
1017         ret = instance->driver->heavy_init(instance, instance->usb_intf);
 
1020                 ret = usbatm_atm_init(instance);
 
1022         mutex_lock(&instance->serialize);
 
1023         instance->thread = NULL;
 
1024         mutex_unlock(&instance->serialize);
 
1026         complete_and_exit(&instance->thread_exited, ret);
 
1029 static int usbatm_heavy_init(struct usbatm_data *instance)
 
1031         struct task_struct *t;
 
1033         t = kthread_create(usbatm_do_heavy_init, instance,
 
1034                         instance->driver->driver_name);
 
1036                 usb_err(instance, "%s: failed to create kernel_thread (%ld)!\n",
 
1037                                 __func__, PTR_ERR(t));
 
1041         instance->thread = t;
 
1043         wait_for_completion(&instance->thread_started);
 
1048 static void usbatm_tasklet_schedule(unsigned long data)
 
1050         tasklet_schedule((struct tasklet_struct *) data);
 
1053 static void usbatm_init_channel(struct usbatm_channel *channel)
 
1055         spin_lock_init(&channel->lock);
 
1056         INIT_LIST_HEAD(&channel->list);
 
1057         channel->delay.function = usbatm_tasklet_schedule;
 
1058         channel->delay.data = (unsigned long) &channel->tasklet;
 
1059         init_timer(&channel->delay);
 
1062 int usbatm_usb_probe(struct usb_interface *intf, const struct usb_device_id *id,
 
1063                      struct usbatm_driver *driver)
 
1065         struct device *dev = &intf->dev;
 
1066         struct usb_device *usb_dev = interface_to_usbdev(intf);
 
1067         struct usbatm_data *instance;
 
1069         int error = -ENOMEM;
 
1071         unsigned int maxpacket, num_packets;
 
1073         dev_dbg(dev, "%s: trying driver %s with vendor=%04x, product=%04x, ifnum %2d\n",
 
1074                         __func__, driver->driver_name,
 
1075                         le16_to_cpu(usb_dev->descriptor.idVendor),
 
1076                         le16_to_cpu(usb_dev->descriptor.idProduct),
 
1077                         intf->altsetting->desc.bInterfaceNumber);
 
1080         instance = kzalloc(sizeof(*instance) + sizeof(struct urb *) * (num_rcv_urbs + num_snd_urbs), GFP_KERNEL);
 
1082                 dev_err(dev, "%s: no memory for instance data!\n", __func__);
 
1088         instance->driver = driver;
 
1089         snprintf(instance->driver_name, sizeof(instance->driver_name), driver->driver_name);
 
1091         instance->usb_dev = usb_dev;
 
1092         instance->usb_intf = intf;
 
1094         buf = instance->description;
 
1095         length = sizeof(instance->description);
 
1097         if ((i = usb_string(usb_dev, usb_dev->descriptor.iProduct, buf, length)) < 0)
 
1103         i = scnprintf(buf, length, " (");
 
1107         if (length <= 0 || (i = usb_make_path(usb_dev, buf, length)) < 0)
 
1113         snprintf(buf, length, ")");
 
1116         if (driver->bind && (error = driver->bind(instance, intf, id)) < 0) {
 
1117                         dev_err(dev, "%s: bind failed: %d!\n", __func__, error);
 
1121         /* private fields */
 
1123         kref_init(&instance->refcount);         /* dropped in usbatm_usb_disconnect */
 
1124         mutex_init(&instance->serialize);
 
1126         instance->thread = NULL;
 
1127         init_completion(&instance->thread_started);
 
1128         init_completion(&instance->thread_exited);
 
1130         INIT_LIST_HEAD(&instance->vcc_list);
 
1131         skb_queue_head_init(&instance->sndqueue);
 
1133         usbatm_init_channel(&instance->rx_channel);
 
1134         usbatm_init_channel(&instance->tx_channel);
 
1135         tasklet_init(&instance->rx_channel.tasklet, usbatm_rx_process, (unsigned long)instance);
 
1136         tasklet_init(&instance->tx_channel.tasklet, usbatm_tx_process, (unsigned long)instance);
 
1137         instance->rx_channel.stride = ATM_CELL_SIZE + driver->rx_padding;
 
1138         instance->tx_channel.stride = ATM_CELL_SIZE + driver->tx_padding;
 
1139         instance->rx_channel.usbatm = instance->tx_channel.usbatm = instance;
 
1141         if ((instance->flags & UDSL_USE_ISOC) && driver->isoc_in)
 
1142                 instance->rx_channel.endpoint = usb_rcvisocpipe(usb_dev, driver->isoc_in);
 
1144                 instance->rx_channel.endpoint = usb_rcvbulkpipe(usb_dev, driver->bulk_in);
 
1146         instance->tx_channel.endpoint = usb_sndbulkpipe(usb_dev, driver->bulk_out);
 
1148         /* tx buffer size must be a positive multiple of the stride */
 
1149         instance->tx_channel.buf_size = max (instance->tx_channel.stride,
 
1150                         snd_buf_bytes - (snd_buf_bytes % instance->tx_channel.stride));
 
1152         /* rx buffer size must be a positive multiple of the endpoint maxpacket */
 
1153         maxpacket = usb_maxpacket(usb_dev, instance->rx_channel.endpoint, 0);
 
1155         if ((maxpacket < 1) || (maxpacket > UDSL_MAX_BUF_SIZE)) {
 
1156                 dev_err(dev, "%s: invalid endpoint %02x!\n", __func__,
 
1157                                 usb_pipeendpoint(instance->rx_channel.endpoint));
 
1162         num_packets = max (1U, (rcv_buf_bytes + maxpacket / 2) / maxpacket); /* round */
 
1164         if (num_packets * maxpacket > UDSL_MAX_BUF_SIZE)
 
1167         instance->rx_channel.buf_size = num_packets * maxpacket;
 
1168         instance->rx_channel.packet_size = maxpacket;
 
1171         for (i = 0; i < 2; i++) {
 
1172                 struct usbatm_channel *channel = i ?
 
1173                         &instance->tx_channel : &instance->rx_channel;
 
1175                 dev_dbg(dev, "%s: using %d byte buffer for %s channel 0x%p\n", __func__, channel->buf_size, i ? "tx" : "rx", channel);
 
1179         /* initialize urbs */
 
1181         for (i = 0; i < num_rcv_urbs + num_snd_urbs; i++) {
 
1183                 struct usbatm_channel *channel = i < num_rcv_urbs ?
 
1184                         &instance->rx_channel : &instance->tx_channel;
 
1186                 unsigned int iso_packets = usb_pipeisoc(channel->endpoint) ? channel->buf_size / channel->packet_size : 0;
 
1188                 UDSL_ASSERT(instance, !usb_pipeisoc(channel->endpoint) || usb_pipein(channel->endpoint));
 
1190                 urb = usb_alloc_urb(iso_packets, GFP_KERNEL);
 
1192                         dev_err(dev, "%s: no memory for urb %d!\n", __func__, i);
 
1197                 instance->urbs[i] = urb;
 
1199                 /* zero the tx padding to avoid leaking information */
 
1200                 buffer = kzalloc(channel->buf_size, GFP_KERNEL);
 
1202                         dev_err(dev, "%s: no memory for buffer %d!\n", __func__, i);
 
1207                 usb_fill_bulk_urb(urb, instance->usb_dev, channel->endpoint,
 
1208                                   buffer, channel->buf_size, usbatm_complete, channel);
 
1212                         urb->transfer_flags = URB_ISO_ASAP;
 
1213                         urb->number_of_packets = iso_packets;
 
1214                         for (j = 0; j < iso_packets; j++) {
 
1215                                 urb->iso_frame_desc[j].offset = channel->packet_size * j;
 
1216                                 urb->iso_frame_desc[j].length = channel->packet_size;
 
1220                 /* put all tx URBs on the list of spares */
 
1221                 if (i >= num_rcv_urbs)
 
1222                         list_add_tail(&urb->urb_list, &channel->list);
 
1224                 vdbg("%s: alloced buffer 0x%p buf size %u urb 0x%p",
 
1225                      __func__, urb->transfer_buffer, urb->transfer_buffer_length, urb);
 
1228         instance->cached_vpi = ATM_VPI_UNSPEC;
 
1229         instance->cached_vci = ATM_VCI_UNSPEC;
 
1230         instance->cell_buf = kmalloc(instance->rx_channel.stride, GFP_KERNEL);
 
1232         if (!instance->cell_buf) {
 
1233                 dev_err(dev, "%s: no memory for cell buffer!\n", __func__);
 
1238         if (!(instance->flags & UDSL_SKIP_HEAVY_INIT) && driver->heavy_init) {
 
1239                 error = usbatm_heavy_init(instance);
 
1241                 complete(&instance->thread_exited);     /* pretend that heavy_init was run */
 
1242                 error = usbatm_atm_init(instance);
 
1248         usb_get_dev(usb_dev);
 
1249         usb_set_intfdata(intf, instance);
 
1254         if (instance->driver->unbind)
 
1255                 instance->driver->unbind(instance, intf);
 
1257         kfree(instance->cell_buf);
 
1259         for (i = 0; i < num_rcv_urbs + num_snd_urbs; i++) {
 
1260                 if (instance->urbs[i])
 
1261                         kfree(instance->urbs[i]->transfer_buffer);
 
1262                 usb_free_urb(instance->urbs[i]);
 
1269 EXPORT_SYMBOL_GPL(usbatm_usb_probe);
 
1271 void usbatm_usb_disconnect(struct usb_interface *intf)
 
1273         struct device *dev = &intf->dev;
 
1274         struct usbatm_data *instance = usb_get_intfdata(intf);
 
1275         struct usbatm_vcc_data *vcc_data;
 
1278         dev_dbg(dev, "%s entered\n", __func__);
 
1281                 dev_dbg(dev, "%s: NULL instance!\n", __func__);
 
1285         usb_set_intfdata(intf, NULL);
 
1287         mutex_lock(&instance->serialize);
 
1288         instance->disconnected = 1;
 
1289         if (instance->thread != NULL)
 
1290                 send_sig(SIGTERM, instance->thread, 1);
 
1291         mutex_unlock(&instance->serialize);
 
1293         wait_for_completion(&instance->thread_exited);
 
1295         mutex_lock(&instance->serialize);
 
1296         list_for_each_entry(vcc_data, &instance->vcc_list, list)
 
1297                 vcc_release_async(vcc_data->vcc, -EPIPE);
 
1298         mutex_unlock(&instance->serialize);
 
1300         tasklet_disable(&instance->rx_channel.tasklet);
 
1301         tasklet_disable(&instance->tx_channel.tasklet);
 
1303         for (i = 0; i < num_rcv_urbs + num_snd_urbs; i++)
 
1304                 usb_kill_urb(instance->urbs[i]);
 
1306         del_timer_sync(&instance->rx_channel.delay);
 
1307         del_timer_sync(&instance->tx_channel.delay);
 
1309         /* turn usbatm_[rt]x_process into something close to a no-op */
 
1310         /* no need to take the spinlock */
 
1311         INIT_LIST_HEAD(&instance->rx_channel.list);
 
1312         INIT_LIST_HEAD(&instance->tx_channel.list);
 
1314         tasklet_enable(&instance->rx_channel.tasklet);
 
1315         tasklet_enable(&instance->tx_channel.tasklet);
 
1317         if (instance->atm_dev && instance->driver->atm_stop)
 
1318                 instance->driver->atm_stop(instance, instance->atm_dev);
 
1320         if (instance->driver->unbind)
 
1321                 instance->driver->unbind(instance, intf);
 
1323         instance->driver_data = NULL;
 
1325         for (i = 0; i < num_rcv_urbs + num_snd_urbs; i++) {
 
1326                 kfree(instance->urbs[i]->transfer_buffer);
 
1327                 usb_free_urb(instance->urbs[i]);
 
1330         kfree(instance->cell_buf);
 
1333         if (instance->atm_dev) {
 
1334                 sysfs_remove_link(&instance->atm_dev->class_dev.kobj, "device");
 
1335                 atm_dev_deregister(instance->atm_dev);
 
1338         usbatm_put_instance(instance);  /* taken in usbatm_usb_probe */
 
1340 EXPORT_SYMBOL_GPL(usbatm_usb_disconnect);
 
1347 static int __init usbatm_usb_init(void)
 
1349         dbg("%s: driver version %s", __func__, DRIVER_VERSION);
 
1351         if (sizeof(struct usbatm_control) > sizeof(((struct sk_buff *) 0)->cb)) {
 
1352                 printk(KERN_ERR "%s unusable with this kernel!\n", usbatm_driver_name);
 
1356         if ((num_rcv_urbs > UDSL_MAX_RCV_URBS)
 
1357             || (num_snd_urbs > UDSL_MAX_SND_URBS)
 
1358             || (rcv_buf_bytes < 1)
 
1359             || (rcv_buf_bytes > UDSL_MAX_BUF_SIZE)
 
1360             || (snd_buf_bytes < 1)
 
1361             || (snd_buf_bytes > UDSL_MAX_BUF_SIZE))
 
1366 module_init(usbatm_usb_init);
 
1368 static void __exit usbatm_usb_exit(void)
 
1370         dbg("%s", __func__);
 
1372 module_exit(usbatm_usb_exit);
 
1374 MODULE_AUTHOR(DRIVER_AUTHOR);
 
1375 MODULE_DESCRIPTION(DRIVER_DESC);
 
1376 MODULE_LICENSE("GPL");
 
1377 MODULE_VERSION(DRIVER_VERSION);
 
1383 #ifdef VERBOSE_DEBUG
 
1384 static int usbatm_print_packet(const unsigned char *data, int len)
 
1386         unsigned char buffer[256];
 
1389         for (i = 0; i < len;) {
 
1391                 sprintf(buffer, "%.3d :", i);
 
1392                 for (j = 0; (j < 16) && (i < len); j++, i++) {
 
1393                         sprintf(buffer, "%s %2.2x", buffer, data[i]);