| .. | .. |
|---|
| 1 | +// SPDX-License-Identifier: GPL-2.0-only |
|---|
| 1 | 2 | /* |
|---|
| 2 | 3 | * WL3501 Wireless LAN PCMCIA Card Driver for Linux |
|---|
| 3 | 4 | * Written originally for Linux 2.0.30 by Fox Chen, mhchen@golf.ccl.itri.org.tw |
|---|
| .. | .. |
|---|
| 133 | 134 | |
|---|
| 134 | 135 | /** |
|---|
| 135 | 136 | * iw_valid_channel - validate channel in regulatory domain |
|---|
| 136 | | - * @reg_comain - regulatory domain |
|---|
| 137 | | - * @channel - channel to validate |
|---|
| 137 | + * @reg_comain: regulatory domain |
|---|
| 138 | + * @channel: channel to validate |
|---|
| 138 | 139 | * |
|---|
| 139 | 140 | * Returns 0 if invalid in the specified regulatory domain, non-zero if valid. |
|---|
| 140 | 141 | */ |
|---|
| .. | .. |
|---|
| 153 | 154 | |
|---|
| 154 | 155 | /** |
|---|
| 155 | 156 | * iw_default_channel - get default channel for a regulatory domain |
|---|
| 156 | | - * @reg_comain - regulatory domain |
|---|
| 157 | + * @reg_domain: regulatory domain |
|---|
| 157 | 158 | * |
|---|
| 158 | 159 | * Returns the default channel for a regulatory domain |
|---|
| 159 | 160 | */ |
|---|
| .. | .. |
|---|
| 236 | 237 | |
|---|
| 237 | 238 | /** |
|---|
| 238 | 239 | * wl3501_set_to_wla - Move 'size' bytes from PC to card |
|---|
| 240 | + * @this: Card |
|---|
| 239 | 241 | * @dest: Card addressing space |
|---|
| 240 | 242 | * @src: PC addressing space |
|---|
| 241 | 243 | * @size: Bytes to move |
|---|
| .. | .. |
|---|
| 258 | 260 | |
|---|
| 259 | 261 | /** |
|---|
| 260 | 262 | * wl3501_get_from_wla - Move 'size' bytes from card to PC |
|---|
| 263 | + * @this: Card |
|---|
| 261 | 264 | * @src: Card addressing space |
|---|
| 262 | 265 | * @dest: PC addressing space |
|---|
| 263 | 266 | * @size: Bytes to move |
|---|
| .. | .. |
|---|
| 454 | 457 | |
|---|
| 455 | 458 | /** |
|---|
| 456 | 459 | * wl3501_send_pkt - Send a packet. |
|---|
| 457 | | - * @this - card |
|---|
| 460 | + * @this: Card |
|---|
| 458 | 461 | * |
|---|
| 459 | 462 | * Send a packet. |
|---|
| 460 | 463 | * |
|---|
| .. | .. |
|---|
| 722 | 725 | |
|---|
| 723 | 726 | /** |
|---|
| 724 | 727 | * wl3501_block_interrupt - Mask interrupt from SUTRO |
|---|
| 725 | | - * @this - card |
|---|
| 728 | + * @this: Card |
|---|
| 726 | 729 | * |
|---|
| 727 | 730 | * Mask interrupt from SUTRO. (i.e. SUTRO cannot interrupt the HOST) |
|---|
| 728 | 731 | * Return: 1 if interrupt is originally enabled |
|---|
| .. | .. |
|---|
| 739 | 742 | |
|---|
| 740 | 743 | /** |
|---|
| 741 | 744 | * wl3501_unblock_interrupt - Enable interrupt from SUTRO |
|---|
| 742 | | - * @this - card |
|---|
| 745 | + * @this: Card |
|---|
| 743 | 746 | * |
|---|
| 744 | 747 | * Enable interrupt from SUTRO. (i.e. SUTRO can interrupt the HOST) |
|---|
| 745 | 748 | * Return: 1 if interrupt is originally enabled |
|---|
| .. | .. |
|---|
| 1113 | 1116 | |
|---|
| 1114 | 1117 | /** |
|---|
| 1115 | 1118 | * wl3501_interrupt - Hardware interrupt from card. |
|---|
| 1116 | | - * @irq - Interrupt number |
|---|
| 1117 | | - * @dev_id - net_device |
|---|
| 1119 | + * @irq: Interrupt number |
|---|
| 1120 | + * @dev_id: net_device |
|---|
| 1118 | 1121 | * |
|---|
| 1119 | 1122 | * We must acknowledge the interrupt as soon as possible, and block the |
|---|
| 1120 | 1123 | * interrupt from the same card immediately to prevent re-entry. |
|---|
| .. | .. |
|---|
| 1229 | 1232 | static int wl3501_close(struct net_device *dev) |
|---|
| 1230 | 1233 | { |
|---|
| 1231 | 1234 | struct wl3501_card *this = netdev_priv(dev); |
|---|
| 1232 | | - int rc = -ENODEV; |
|---|
| 1233 | 1235 | unsigned long flags; |
|---|
| 1234 | 1236 | struct pcmcia_device *link; |
|---|
| 1235 | 1237 | link = this->p_dev; |
|---|
| .. | .. |
|---|
| 1244 | 1246 | /* Mask interrupts from the SUTRO */ |
|---|
| 1245 | 1247 | wl3501_block_interrupt(this); |
|---|
| 1246 | 1248 | |
|---|
| 1247 | | - rc = 0; |
|---|
| 1248 | 1249 | printk(KERN_INFO "%s: WL3501 closed\n", dev->name); |
|---|
| 1249 | 1250 | spin_unlock_irqrestore(&this->lock, flags); |
|---|
| 1250 | | - return rc; |
|---|
| 1251 | + return 0; |
|---|
| 1251 | 1252 | } |
|---|
| 1252 | 1253 | |
|---|
| 1253 | 1254 | /** |
|---|
| 1254 | 1255 | * wl3501_reset - Reset the SUTRO. |
|---|
| 1255 | | - * @dev - network device |
|---|
| 1256 | + * @dev: network device |
|---|
| 1256 | 1257 | * |
|---|
| 1257 | 1258 | * It is almost the same as wl3501_open(). In fact, we may just wl3501_close() |
|---|
| 1258 | 1259 | * and wl3501_open() again, but I wouldn't like to free_irq() when the driver |
|---|
| .. | .. |
|---|
| 1290 | 1291 | return rc; |
|---|
| 1291 | 1292 | } |
|---|
| 1292 | 1293 | |
|---|
| 1293 | | -static void wl3501_tx_timeout(struct net_device *dev) |
|---|
| 1294 | +static void wl3501_tx_timeout(struct net_device *dev, unsigned int txqueue) |
|---|
| 1294 | 1295 | { |
|---|
| 1295 | 1296 | struct net_device_stats *stats = &dev->stats; |
|---|
| 1296 | 1297 | int rc; |
|---|
| .. | .. |
|---|
| 1415 | 1416 | |
|---|
| 1416 | 1417 | /** |
|---|
| 1417 | 1418 | * wl3501_detach - deletes a driver "instance" |
|---|
| 1418 | | - * @link - FILL_IN |
|---|
| 1419 | + * @link: FILL_IN |
|---|
| 1419 | 1420 | * |
|---|
| 1420 | 1421 | * This deletes a driver "instance". The device is de-registered with Card |
|---|
| 1421 | 1422 | * Services. If it has been released, all local data structures are freed. |
|---|
| .. | .. |
|---|
| 1436 | 1437 | wl3501_release(link); |
|---|
| 1437 | 1438 | |
|---|
| 1438 | 1439 | unregister_netdev(dev); |
|---|
| 1439 | | - |
|---|
| 1440 | | - if (link->priv) |
|---|
| 1441 | | - free_netdev(link->priv); |
|---|
| 1440 | + free_netdev(dev); |
|---|
| 1442 | 1441 | } |
|---|
| 1443 | 1442 | |
|---|
| 1444 | 1443 | static int wl3501_get_name(struct net_device *dev, struct iw_request_info *info, |
|---|