Commit 0bb10830 authored by David Binder's avatar David Binder Committed by Greg Kroah-Hartman

staging: unisys: visornic: visornic_main.c: Remove kernel-doc comments

Removes kernel-doc formatting for comments that precede static functions.
Signed-off-by: default avatarDavid Binder <david.binder@unisys.com>
Signed-off-by: default avatarDavid Kershner <david.kershner@unisys.com>
Reviewed-by: default avatarTim Sell <timothy.sell@unisys.com>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 4a1f98f1
...@@ -141,7 +141,7 @@ struct visornic_devdata { ...@@ -141,7 +141,7 @@ struct visornic_devdata {
struct uiscmdrsp cmdrsp[SIZEOF_CMDRSP]; struct uiscmdrsp cmdrsp[SIZEOF_CMDRSP];
}; };
/** /*
* visor_copy_fragsinfo_from_skb( * visor_copy_fragsinfo_from_skb(
* @skb_in: skbuff that we are pulling the frags from * @skb_in: skbuff that we are pulling the frags from
* @firstfraglen: length of first fragment in skb * @firstfraglen: length of first fragment in skb
...@@ -250,7 +250,7 @@ static const struct file_operations debugfs_enable_ints_fops = { ...@@ -250,7 +250,7 @@ static const struct file_operations debugfs_enable_ints_fops = {
.write = enable_ints_write, .write = enable_ints_write,
}; };
/** /*
* visornic_serverdown_complete - IOPART went down, pause device * visornic_serverdown_complete - IOPART went down, pause device
* @work: Work queue it was scheduled on * @work: Work queue it was scheduled on
* *
...@@ -285,7 +285,7 @@ visornic_serverdown_complete(struct visornic_devdata *devdata) ...@@ -285,7 +285,7 @@ visornic_serverdown_complete(struct visornic_devdata *devdata)
devdata->server_down_complete_func = NULL; devdata->server_down_complete_func = NULL;
} }
/** /*
* visornic_serverdown - Command has notified us that IOPART is down * visornic_serverdown - Command has notified us that IOPART is down
* @devdata: device that is being managed by IOPART * @devdata: device that is being managed by IOPART
* *
...@@ -332,7 +332,7 @@ visornic_serverdown(struct visornic_devdata *devdata, ...@@ -332,7 +332,7 @@ visornic_serverdown(struct visornic_devdata *devdata,
return err; return err;
} }
/** /*
* alloc_rcv_buf - alloc rcv buffer to be given to the IO Partition. * alloc_rcv_buf - alloc rcv buffer to be given to the IO Partition.
* @netdev: network adapter the rcv bufs are attached too. * @netdev: network adapter the rcv bufs are attached too.
* *
...@@ -363,7 +363,7 @@ alloc_rcv_buf(struct net_device *netdev) ...@@ -363,7 +363,7 @@ alloc_rcv_buf(struct net_device *netdev)
return skb; return skb;
} }
/** /*
* post_skb - post a skb to the IO Partition. * post_skb - post a skb to the IO Partition.
* @cmdrsp: cmdrsp packet to be send to the IO Partition * @cmdrsp: cmdrsp packet to be send to the IO Partition
* @devdata: visornic_devdata to post the skb too * @devdata: visornic_devdata to post the skb too
...@@ -397,7 +397,7 @@ post_skb(struct uiscmdrsp *cmdrsp, ...@@ -397,7 +397,7 @@ post_skb(struct uiscmdrsp *cmdrsp,
} }
} }
/** /*
* send_enbdis - send NET_RCV_ENBDIS to IO Partition * send_enbdis - send NET_RCV_ENBDIS to IO Partition
* @netdev: netdevice we are enable/disable, used as context * @netdev: netdevice we are enable/disable, used as context
* return value * return value
...@@ -421,7 +421,7 @@ send_enbdis(struct net_device *netdev, int state, ...@@ -421,7 +421,7 @@ send_enbdis(struct net_device *netdev, int state,
devdata->chstat.sent_enbdis++; devdata->chstat.sent_enbdis++;
} }
/** /*
* visornic_disable_with_timeout - Disable network adapter * visornic_disable_with_timeout - Disable network adapter
* @netdev: netdevice to disable * @netdev: netdevice to disable
* @timeout: timeout to wait for disable * @timeout: timeout to wait for disable
...@@ -507,7 +507,7 @@ visornic_disable_with_timeout(struct net_device *netdev, const int timeout) ...@@ -507,7 +507,7 @@ visornic_disable_with_timeout(struct net_device *netdev, const int timeout)
return 0; return 0;
} }
/** /*
* init_rcv_bufs -- initialize receive bufs and send them to the IO Part * init_rcv_bufs -- initialize receive bufs and send them to the IO Part
* @netdev: struct netdevice * @netdev: struct netdevice
* @devdata: visornic_devdata * @devdata: visornic_devdata
...@@ -554,7 +554,7 @@ init_rcv_bufs(struct net_device *netdev, struct visornic_devdata *devdata) ...@@ -554,7 +554,7 @@ init_rcv_bufs(struct net_device *netdev, struct visornic_devdata *devdata)
return 0; return 0;
} }
/** /*
* visornic_enable_with_timeout - send enable to IO Part * visornic_enable_with_timeout - send enable to IO Part
* @netdev: struct net_device * @netdev: struct net_device
* @timeout: Time to wait for the ACK from the enable * @timeout: Time to wait for the ACK from the enable
...@@ -626,7 +626,7 @@ visornic_enable_with_timeout(struct net_device *netdev, const int timeout) ...@@ -626,7 +626,7 @@ visornic_enable_with_timeout(struct net_device *netdev, const int timeout)
return 0; return 0;
} }
/** /*
* visornic_timeout_reset - handle xmit timeout resets * visornic_timeout_reset - handle xmit timeout resets
* @work work item that scheduled the work * @work work item that scheduled the work
* *
...@@ -669,7 +669,7 @@ visornic_timeout_reset(struct work_struct *work) ...@@ -669,7 +669,7 @@ visornic_timeout_reset(struct work_struct *work)
rtnl_unlock(); rtnl_unlock();
} }
/** /*
* visornic_open - Enable the visornic device and mark the queue started * visornic_open - Enable the visornic device and mark the queue started
* @netdev: netdevice to start * @netdev: netdevice to start
* *
...@@ -684,7 +684,7 @@ visornic_open(struct net_device *netdev) ...@@ -684,7 +684,7 @@ visornic_open(struct net_device *netdev)
return 0; return 0;
} }
/** /*
* visornic_close - Disables the visornic device and stops the queues * visornic_close - Disables the visornic device and stops the queues
* @netdev: netdevice to start * @netdev: netdevice to start
* *
...@@ -699,7 +699,7 @@ visornic_close(struct net_device *netdev) ...@@ -699,7 +699,7 @@ visornic_close(struct net_device *netdev)
return 0; return 0;
} }
/** /*
* devdata_xmits_outstanding - compute outstanding xmits * devdata_xmits_outstanding - compute outstanding xmits
* @devdata: visornic_devdata for device * @devdata: visornic_devdata for device
* *
...@@ -714,7 +714,7 @@ static unsigned long devdata_xmits_outstanding(struct visornic_devdata *devdata) ...@@ -714,7 +714,7 @@ static unsigned long devdata_xmits_outstanding(struct visornic_devdata *devdata)
+ devdata->chstat.sent_xmit + 1); + devdata->chstat.sent_xmit + 1);
} }
/** /*
* vnic_hit_high_watermark * vnic_hit_high_watermark
* @devdata: indicates visornic device we are checking * @devdata: indicates visornic device we are checking
* @high_watermark: max num of unacked xmits we will tolerate, * @high_watermark: max num of unacked xmits we will tolerate,
...@@ -729,7 +729,7 @@ static inline bool vnic_hit_high_watermark(struct visornic_devdata *devdata, ...@@ -729,7 +729,7 @@ static inline bool vnic_hit_high_watermark(struct visornic_devdata *devdata,
return (devdata_xmits_outstanding(devdata) >= high_watermark); return (devdata_xmits_outstanding(devdata) >= high_watermark);
} }
/** /*
* vnic_hit_low_watermark * vnic_hit_low_watermark
* @devdata: indicates visornic device we are checking * @devdata: indicates visornic device we are checking
* @low_watermark: we will wait until the num of unacked xmits * @low_watermark: we will wait until the num of unacked xmits
...@@ -745,7 +745,7 @@ static inline bool vnic_hit_low_watermark(struct visornic_devdata *devdata, ...@@ -745,7 +745,7 @@ static inline bool vnic_hit_low_watermark(struct visornic_devdata *devdata,
return (devdata_xmits_outstanding(devdata) <= low_watermark); return (devdata_xmits_outstanding(devdata) <= low_watermark);
} }
/** /*
* visornic_xmit - send a packet to the IO Partition * visornic_xmit - send a packet to the IO Partition
* @skb: Packet to be sent * @skb: Packet to be sent
* @netdev: net device the packet is being sent from * @netdev: net device the packet is being sent from
...@@ -916,7 +916,7 @@ visornic_xmit(struct sk_buff *skb, struct net_device *netdev) ...@@ -916,7 +916,7 @@ visornic_xmit(struct sk_buff *skb, struct net_device *netdev)
return NETDEV_TX_OK; return NETDEV_TX_OK;
} }
/** /*
* visornic_get_stats - returns net_stats of the visornic device * visornic_get_stats - returns net_stats of the visornic device
* @netdev: netdevice * @netdev: netdevice
* *
...@@ -930,7 +930,7 @@ visornic_get_stats(struct net_device *netdev) ...@@ -930,7 +930,7 @@ visornic_get_stats(struct net_device *netdev)
return &devdata->net_stats; return &devdata->net_stats;
} }
/** /*
* visornic_change_mtu - changes mtu of device. * visornic_change_mtu - changes mtu of device.
* @netdev: netdevice * @netdev: netdevice
* @new_mtu: value of new mtu * @new_mtu: value of new mtu
...@@ -947,7 +947,7 @@ visornic_change_mtu(struct net_device *netdev, int new_mtu) ...@@ -947,7 +947,7 @@ visornic_change_mtu(struct net_device *netdev, int new_mtu)
return -EINVAL; return -EINVAL;
} }
/** /*
* visornic_set_multi - changes mtu of device. * visornic_set_multi - changes mtu of device.
* @netdev: netdevice * @netdev: netdevice
* *
...@@ -984,7 +984,7 @@ visornic_set_multi(struct net_device *netdev) ...@@ -984,7 +984,7 @@ visornic_set_multi(struct net_device *netdev)
devdata->old_flags = netdev->flags; devdata->old_flags = netdev->flags;
} }
/** /*
* visornic_xmit_timeout - request to timeout the xmit * visornic_xmit_timeout - request to timeout the xmit
* @netdev * @netdev
* *
...@@ -1019,7 +1019,7 @@ visornic_xmit_timeout(struct net_device *netdev) ...@@ -1019,7 +1019,7 @@ visornic_xmit_timeout(struct net_device *netdev)
spin_unlock_irqrestore(&devdata->priv_lock, flags); spin_unlock_irqrestore(&devdata->priv_lock, flags);
} }
/** /*
* repost_return - repost rcv bufs that have come back * repost_return - repost rcv bufs that have come back
* @cmdrsp: io channel command struct to post * @cmdrsp: io channel command struct to post
* @devdata: visornic devdata for the device * @devdata: visornic devdata for the device
...@@ -1091,7 +1091,7 @@ repost_return(struct uiscmdrsp *cmdrsp, struct visornic_devdata *devdata, ...@@ -1091,7 +1091,7 @@ repost_return(struct uiscmdrsp *cmdrsp, struct visornic_devdata *devdata,
return status; return status;
} }
/** /*
* visornic_rx - Handle receive packets coming back from IO Part * visornic_rx - Handle receive packets coming back from IO Part
* @cmdrsp: Receive packet returned from IO Part * @cmdrsp: Receive packet returned from IO Part
* *
...@@ -1293,7 +1293,7 @@ visornic_rx(struct uiscmdrsp *cmdrsp) ...@@ -1293,7 +1293,7 @@ visornic_rx(struct uiscmdrsp *cmdrsp)
return 1; return 1;
} }
/** /*
* devdata_initialize - Initialize devdata structure * devdata_initialize - Initialize devdata structure
* @devdata: visornic_devdata structure to initialize * @devdata: visornic_devdata structure to initialize
* #dev: visorbus_deviced it belongs to * #dev: visorbus_deviced it belongs to
...@@ -1310,7 +1310,7 @@ devdata_initialize(struct visornic_devdata *devdata, struct visor_device *dev) ...@@ -1310,7 +1310,7 @@ devdata_initialize(struct visornic_devdata *devdata, struct visor_device *dev)
return devdata; return devdata;
} }
/** /*
* devdata_release - Frees up references in devdata * devdata_release - Frees up references in devdata
* @devdata: struct to clean up * @devdata: struct to clean up
* *
...@@ -1487,7 +1487,7 @@ static const struct file_operations debugfs_info_fops = { ...@@ -1487,7 +1487,7 @@ static const struct file_operations debugfs_info_fops = {
.read = info_debugfs_read, .read = info_debugfs_read,
}; };
/** /*
* send_rcv_posts_if_needed * send_rcv_posts_if_needed
* @devdata: visornic device * @devdata: visornic device
* *
...@@ -1530,7 +1530,7 @@ send_rcv_posts_if_needed(struct visornic_devdata *devdata) ...@@ -1530,7 +1530,7 @@ send_rcv_posts_if_needed(struct visornic_devdata *devdata)
devdata->num_rcv_bufs_could_not_alloc -= rcv_bufs_allocated; devdata->num_rcv_bufs_could_not_alloc -= rcv_bufs_allocated;
} }
/** /*
* drain_resp_queue - drains and ignores all messages from the resp queue * drain_resp_queue - drains and ignores all messages from the resp queue
* @cmdrsp: io channel command response message * @cmdrsp: io channel command response message
* @devdata: visornic device to drain * @devdata: visornic device to drain
...@@ -1544,7 +1544,7 @@ drain_resp_queue(struct uiscmdrsp *cmdrsp, struct visornic_devdata *devdata) ...@@ -1544,7 +1544,7 @@ drain_resp_queue(struct uiscmdrsp *cmdrsp, struct visornic_devdata *devdata)
; ;
} }
/** /*
* service_resp_queue - drains the response queue * service_resp_queue - drains the response queue
* @cmdrsp: io channel command response message * @cmdrsp: io channel command response message
* @devdata: visornic device to drain * @devdata: visornic device to drain
...@@ -1661,7 +1661,7 @@ static int visornic_poll(struct napi_struct *napi, int budget) ...@@ -1661,7 +1661,7 @@ static int visornic_poll(struct napi_struct *napi, int budget)
return rx_count; return rx_count;
} }
/** /*
* poll_for_irq - Checks the status of the response queue. * poll_for_irq - Checks the status of the response queue.
* @v: void pointer to the visronic devdata * @v: void pointer to the visronic devdata
* *
...@@ -1684,7 +1684,7 @@ poll_for_irq(unsigned long v) ...@@ -1684,7 +1684,7 @@ poll_for_irq(unsigned long v)
mod_timer(&devdata->irq_poll_timer, msecs_to_jiffies(2)); mod_timer(&devdata->irq_poll_timer, msecs_to_jiffies(2));
} }
/** /*
* visornic_probe - probe function for visornic devices * visornic_probe - probe function for visornic devices
* @dev: The visor device discovered * @dev: The visor device discovered
* *
...@@ -1881,7 +1881,7 @@ static int visornic_probe(struct visor_device *dev) ...@@ -1881,7 +1881,7 @@ static int visornic_probe(struct visor_device *dev)
return err; return err;
} }
/** /*
* host_side_disappeared - IO part is gone. * host_side_disappeared - IO part is gone.
* @devdata: device object * @devdata: device object
* *
...@@ -1897,7 +1897,7 @@ static void host_side_disappeared(struct visornic_devdata *devdata) ...@@ -1897,7 +1897,7 @@ static void host_side_disappeared(struct visornic_devdata *devdata)
spin_unlock_irqrestore(&devdata->priv_lock, flags); spin_unlock_irqrestore(&devdata->priv_lock, flags);
} }
/** /*
* visornic_remove - Called when visornic dev goes away * visornic_remove - Called when visornic dev goes away
* @dev: visornic device that is being removed * @dev: visornic device that is being removed
* *
...@@ -1944,7 +1944,7 @@ static void visornic_remove(struct visor_device *dev) ...@@ -1944,7 +1944,7 @@ static void visornic_remove(struct visor_device *dev)
free_netdev(netdev); free_netdev(netdev);
} }
/** /*
* visornic_pause - Called when IO Part disappears * visornic_pause - Called when IO Part disappears
* @dev: visornic device that is being serviced * @dev: visornic device that is being serviced
* @complete_func: call when finished. * @complete_func: call when finished.
...@@ -1966,7 +1966,7 @@ static int visornic_pause(struct visor_device *dev, ...@@ -1966,7 +1966,7 @@ static int visornic_pause(struct visor_device *dev,
return 0; return 0;
} }
/** /*
* visornic_resume - Called when IO part has recovered * visornic_resume - Called when IO part has recovered
* @dev: visornic device that is being serviced * @dev: visornic device that is being serviced
* @compelte_func: call when finished * @compelte_func: call when finished
...@@ -2036,7 +2036,7 @@ static struct visor_driver visornic_driver = { ...@@ -2036,7 +2036,7 @@ static struct visor_driver visornic_driver = {
.channel_interrupt = NULL, .channel_interrupt = NULL,
}; };
/** /*
* visornic_init - Init function * visornic_init - Init function
* *
* Init function for the visornic driver. Do initial driver setup * Init function for the visornic driver. Do initial driver setup
...@@ -2073,7 +2073,7 @@ static int visornic_init(void) ...@@ -2073,7 +2073,7 @@ static int visornic_init(void)
return err; return err;
} }
/** /*
* visornic_cleanup - driver exit routine * visornic_cleanup - driver exit routine
* *
* Unregister driver from the bus and free up memory. * Unregister driver from the bus and free up memory.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment