s390/lcs: remove incorrect kernel doc indicators
Many comments above functions start with a kernel doc indicator, but the comments are not using kernel doc style. Get rid of the warnings by simply removing the indicator. E.g.: drivers/s390/net/lcs.c:2355: warning: This comment starts with '/**', but isn't a kernel-doc comment. Acked-by: Alexandra Winter <wintera@linux.ibm.com> Signed-off-by: Heiko Carstens <hca@linux.ibm.com> Signed-off-by: Karsten Graul <kgraul@linux.ibm.com> Signed-off-by: David S. Miller <davem@davemloft.net>
This commit is contained in:
Heiko Carstens
David S. Miller
parent
a962cc4ba1
commit
239686c11f
|
|
@ -40,18 +40,18 @@
|
|||
#error Cannot compile lcs.c without some net devices switched on.
|
||||
#endif
|
||||
|
||||
/**
|
||||
/*
|
||||
* initialization string for output
|
||||
*/
|
||||
|
||||
static char version[] __initdata = "LCS driver";
|
||||
|
||||
/**
|
||||
/*
|
||||
* the root device for lcs group devices
|
||||
*/
|
||||
static struct device *lcs_root_dev;
|
||||
|
||||
/**
|
||||
/*
|
||||
* Some prototypes.
|
||||
*/
|
||||
static void lcs_tasklet(unsigned long);
|
||||
|
|
@ -62,14 +62,14 @@ static int lcs_send_delipm(struct lcs_card *, struct lcs_ipm_list *);
|
|||
#endif /* CONFIG_IP_MULTICAST */
|
||||
static int lcs_recovery(void *ptr);
|
||||
|
||||
/**
|
||||
/*
|
||||
* Debug Facility Stuff
|
||||
*/
|
||||
static char debug_buffer[255];
|
||||
static debug_info_t *lcs_dbf_setup;
|
||||
static debug_info_t *lcs_dbf_trace;
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS Debug Facility functions
|
||||
*/
|
||||
static void
|
||||
|
|
@ -96,7 +96,7 @@ lcs_register_debug_facility(void)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Allocate io buffers.
|
||||
*/
|
||||
static int
|
||||
|
|
@ -123,7 +123,7 @@ lcs_alloc_channel(struct lcs_channel *channel)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Free io buffers.
|
||||
*/
|
||||
static void
|
||||
|
|
@ -151,7 +151,7 @@ lcs_cleanup_channel(struct lcs_channel *channel)
|
|||
lcs_free_channel(channel);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS free memory for card and channels.
|
||||
*/
|
||||
static void
|
||||
|
|
@ -162,7 +162,7 @@ lcs_free_card(struct lcs_card *card)
|
|||
kfree(card);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS alloc memory for card and channels
|
||||
*/
|
||||
static struct lcs_card *
|
||||
|
|
@ -402,7 +402,7 @@ lcs_do_start_thread(struct lcs_card *card, unsigned long thread)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Initialize channels,card and state machines.
|
||||
*/
|
||||
static void
|
||||
|
|
@ -451,7 +451,8 @@ static void lcs_clear_multicast_list(struct lcs_card *card)
|
|||
spin_unlock_irqrestore(&card->ipm_lock, flags);
|
||||
#endif
|
||||
}
|
||||
/**
|
||||
|
||||
/*
|
||||
* Cleanup channels,card and state machines.
|
||||
*/
|
||||
static void
|
||||
|
|
@ -468,7 +469,7 @@ lcs_cleanup_card(struct lcs_card *card)
|
|||
lcs_cleanup_channel(&card->read);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Start channel.
|
||||
*/
|
||||
static int
|
||||
|
|
@ -517,7 +518,7 @@ lcs_clear_channel(struct lcs_channel *channel)
|
|||
}
|
||||
|
||||
|
||||
/**
|
||||
/*
|
||||
* Stop channel.
|
||||
*/
|
||||
static int
|
||||
|
|
@ -545,7 +546,7 @@ lcs_stop_channel(struct lcs_channel *channel)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* start read and write channel
|
||||
*/
|
||||
static int
|
||||
|
|
@ -565,7 +566,7 @@ lcs_start_channels(struct lcs_card *card)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* stop read and write channel
|
||||
*/
|
||||
static int
|
||||
|
|
@ -577,7 +578,7 @@ lcs_stop_channels(struct lcs_card *card)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Get empty buffer.
|
||||
*/
|
||||
static struct lcs_buffer *
|
||||
|
|
@ -610,7 +611,7 @@ lcs_get_buffer(struct lcs_channel *channel)
|
|||
return buffer;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Resume channel program if the channel is suspended.
|
||||
*/
|
||||
static int
|
||||
|
|
@ -636,7 +637,7 @@ __lcs_resume_channel(struct lcs_channel *channel)
|
|||
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Make a buffer ready for processing.
|
||||
*/
|
||||
static void __lcs_ready_buffer_bits(struct lcs_channel *channel, int index)
|
||||
|
|
@ -678,7 +679,7 @@ lcs_ready_buffer(struct lcs_channel *channel, struct lcs_buffer *buffer)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Mark the buffer as processed. Take care of the suspend bit
|
||||
* of the previous buffer. This function is called from
|
||||
* interrupt context, so the lock must not be taken.
|
||||
|
|
@ -712,7 +713,7 @@ __lcs_processed_buffer(struct lcs_channel *channel, struct lcs_buffer *buffer)
|
|||
return __lcs_resume_channel(channel);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Put a processed buffer back to state empty.
|
||||
*/
|
||||
static void
|
||||
|
|
@ -728,7 +729,7 @@ lcs_release_buffer(struct lcs_channel *channel, struct lcs_buffer *buffer)
|
|||
spin_unlock_irqrestore(get_ccwdev_lock(channel->ccwdev), flags);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Get buffer for a lan command.
|
||||
*/
|
||||
static struct lcs_buffer *
|
||||
|
|
@ -785,7 +786,7 @@ lcs_alloc_reply(struct lcs_cmd *cmd)
|
|||
return reply;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Notifier function for lancmd replies. Called from read irq.
|
||||
*/
|
||||
static void
|
||||
|
|
@ -813,7 +814,7 @@ lcs_notify_lancmd_waiters(struct lcs_card *card, struct lcs_cmd *cmd)
|
|||
spin_unlock(&card->lock);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Emit buffer of a lan command.
|
||||
*/
|
||||
static void
|
||||
|
|
@ -877,7 +878,7 @@ lcs_send_lancmd(struct lcs_card *card, struct lcs_buffer *buffer,
|
|||
return rc ? -EIO : 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS startup command
|
||||
*/
|
||||
static int
|
||||
|
|
@ -895,7 +896,7 @@ lcs_send_startup(struct lcs_card *card, __u8 initiator)
|
|||
return lcs_send_lancmd(card, buffer, NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS shutdown command
|
||||
*/
|
||||
static int
|
||||
|
|
@ -912,7 +913,7 @@ lcs_send_shutdown(struct lcs_card *card)
|
|||
return lcs_send_lancmd(card, buffer, NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS lanstat command
|
||||
*/
|
||||
static void
|
||||
|
|
@ -939,7 +940,7 @@ lcs_send_lanstat(struct lcs_card *card)
|
|||
return lcs_send_lancmd(card, buffer, __lcs_lanstat_cb);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* send stoplan command
|
||||
*/
|
||||
static int
|
||||
|
|
@ -958,7 +959,7 @@ lcs_send_stoplan(struct lcs_card *card, __u8 initiator)
|
|||
return lcs_send_lancmd(card, buffer, NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* send startlan command
|
||||
*/
|
||||
static void
|
||||
|
|
@ -986,7 +987,7 @@ lcs_send_startlan(struct lcs_card *card, __u8 initiator)
|
|||
}
|
||||
|
||||
#ifdef CONFIG_IP_MULTICAST
|
||||
/**
|
||||
/*
|
||||
* send setipm command (Multicast)
|
||||
*/
|
||||
static int
|
||||
|
|
@ -1010,7 +1011,7 @@ lcs_send_setipm(struct lcs_card *card,struct lcs_ipm_list *ipm_list)
|
|||
return lcs_send_lancmd(card, buffer, NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* send delipm command (Multicast)
|
||||
*/
|
||||
static int
|
||||
|
|
@ -1034,7 +1035,7 @@ lcs_send_delipm(struct lcs_card *card,struct lcs_ipm_list *ipm_list)
|
|||
return lcs_send_lancmd(card, buffer, NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* check if multicast is supported by LCS
|
||||
*/
|
||||
static void
|
||||
|
|
@ -1074,7 +1075,7 @@ lcs_check_multicast_support(struct lcs_card *card)
|
|||
return -EOPNOTSUPP;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* set or del multicast address on LCS card
|
||||
*/
|
||||
static void
|
||||
|
|
@ -1129,7 +1130,7 @@ list_modified:
|
|||
spin_unlock_irqrestore(&card->ipm_lock, flags);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* get mac address for the relevant Multicast address
|
||||
*/
|
||||
static void
|
||||
|
|
@ -1139,7 +1140,7 @@ lcs_get_mac_for_ipm(__be32 ipm, char *mac, struct net_device *dev)
|
|||
ip_eth_mc_map(ipm, mac);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* function called by net device to handle multicast address relevant things
|
||||
*/
|
||||
static void lcs_remove_mc_addresses(struct lcs_card *card,
|
||||
|
|
@ -1260,7 +1261,7 @@ out:
|
|||
}
|
||||
#endif /* CONFIG_IP_MULTICAST */
|
||||
|
||||
/**
|
||||
/*
|
||||
* function called by net device to
|
||||
* handle multicast address relevant things
|
||||
*/
|
||||
|
|
@ -1355,7 +1356,7 @@ lcs_schedule_recovery(struct lcs_card *card)
|
|||
schedule_work(&card->kernel_thread_starter);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* IRQ Handler for LCS channels
|
||||
*/
|
||||
static void
|
||||
|
|
@ -1439,7 +1440,7 @@ lcs_irq(struct ccw_device *cdev, unsigned long intparm, struct irb *irb)
|
|||
tasklet_schedule(&channel->irq_tasklet);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Tasklet for IRQ handler
|
||||
*/
|
||||
static void
|
||||
|
|
@ -1476,7 +1477,7 @@ lcs_tasklet(unsigned long data)
|
|||
wake_up(&channel->wait_q);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Finish current tx buffer and make it ready for transmit.
|
||||
*/
|
||||
static void
|
||||
|
|
@ -1490,7 +1491,7 @@ __lcs_emit_txbuffer(struct lcs_card *card)
|
|||
card->tx_emitted++;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Callback for finished tx buffers.
|
||||
*/
|
||||
static void
|
||||
|
|
@ -1515,7 +1516,7 @@ lcs_txbuffer_cb(struct lcs_channel *channel, struct lcs_buffer *buffer)
|
|||
spin_unlock(&card->lock);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Packet transmit function called by network stack
|
||||
*/
|
||||
static int
|
||||
|
|
@ -1593,7 +1594,7 @@ lcs_start_xmit(struct sk_buff *skb, struct net_device *dev)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* send startlan and lanstat command to make LCS device ready
|
||||
*/
|
||||
static int
|
||||
|
|
@ -1648,7 +1649,7 @@ lcs_startlan(struct lcs_card *card)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS detect function
|
||||
* setup channels and make them I/O ready
|
||||
*/
|
||||
|
|
@ -1680,7 +1681,7 @@ lcs_detect(struct lcs_card *card)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS Stop card
|
||||
*/
|
||||
static int
|
||||
|
|
@ -1705,7 +1706,7 @@ lcs_stopcard(struct lcs_card *card)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Kernel Thread helper functions for LGW initiated commands
|
||||
*/
|
||||
static void
|
||||
|
|
@ -1721,7 +1722,7 @@ lcs_start_kernel_thread(struct work_struct *work)
|
|||
#endif
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Process control frames.
|
||||
*/
|
||||
static void
|
||||
|
|
@ -1748,7 +1749,7 @@ lcs_get_control(struct lcs_card *card, struct lcs_cmd *cmd)
|
|||
lcs_notify_lancmd_waiters(card, cmd);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* Unpack network packet.
|
||||
*/
|
||||
static void
|
||||
|
|
@ -1779,7 +1780,7 @@ lcs_get_skb(struct lcs_card *card, char *skb_data, unsigned int skb_len)
|
|||
netif_rx(skb);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS main routine to get packets and lancmd replies from the buffers
|
||||
*/
|
||||
static void
|
||||
|
|
@ -1829,7 +1830,7 @@ lcs_get_frames_cb(struct lcs_channel *channel, struct lcs_buffer *buffer)
|
|||
lcs_ready_buffer(&card->read, buffer);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* get network statistics for ifconfig and other user programs
|
||||
*/
|
||||
static struct net_device_stats *
|
||||
|
|
@ -1842,7 +1843,7 @@ lcs_getstats(struct net_device *dev)
|
|||
return &card->stats;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* stop lcs device
|
||||
* This function will be called by user doing ifconfig xxx down
|
||||
*/
|
||||
|
|
@ -1866,7 +1867,7 @@ lcs_stop_device(struct net_device *dev)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* start lcs device and make it runnable
|
||||
* This function will be called by user doing ifconfig xxx up
|
||||
*/
|
||||
|
|
@ -1892,7 +1893,7 @@ lcs_open_device(struct net_device *dev)
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* show function for portno called by cat or similar things
|
||||
*/
|
||||
static ssize_t
|
||||
|
|
@ -1908,7 +1909,7 @@ lcs_portno_show (struct device *dev, struct device_attribute *attr, char *buf)
|
|||
return sprintf(buf, "%d\n", card->portno);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* store the value which is piped to file portno
|
||||
*/
|
||||
static ssize_t
|
||||
|
|
@ -2033,7 +2034,7 @@ static const struct device_type lcs_devtype = {
|
|||
.groups = lcs_attr_groups,
|
||||
};
|
||||
|
||||
/**
|
||||
/*
|
||||
* lcs_probe_device is called on establishing a new ccwgroup_device.
|
||||
*/
|
||||
static int
|
||||
|
|
@ -2077,7 +2078,7 @@ lcs_register_netdev(struct ccwgroup_device *ccwgdev)
|
|||
return register_netdev(card->dev);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* lcs_new_device will be called by setting the group device online.
|
||||
*/
|
||||
static const struct net_device_ops lcs_netdev_ops = {
|
||||
|
|
@ -2199,7 +2200,7 @@ out_err:
|
|||
return -ENODEV;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* lcs_shutdown_device, called when setting the group device offline.
|
||||
*/
|
||||
static int
|
||||
|
|
@ -2240,7 +2241,7 @@ lcs_shutdown_device(struct ccwgroup_device *ccwgdev)
|
|||
return __lcs_shutdown_device(ccwgdev, 0);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* drive lcs recovery after startup and startlan initiated by Lan Gateway
|
||||
*/
|
||||
static int
|
||||
|
|
@ -2271,7 +2272,7 @@ lcs_recovery(void *ptr)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* lcs_remove_device, free buffers and card
|
||||
*/
|
||||
static void
|
||||
|
|
@ -2315,7 +2316,7 @@ static struct ccw_driver lcs_ccw_driver = {
|
|||
.int_class = IRQIO_LCS,
|
||||
};
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS ccwgroup driver registration
|
||||
*/
|
||||
static struct ccwgroup_driver lcs_group_driver = {
|
||||
|
|
@ -2351,7 +2352,7 @@ static const struct attribute_group *lcs_drv_attr_groups[] = {
|
|||
NULL,
|
||||
};
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS Module/Kernel initialization function
|
||||
*/
|
||||
static int
|
||||
|
|
@ -2389,7 +2390,7 @@ out_err:
|
|||
}
|
||||
|
||||
|
||||
/**
|
||||
/*
|
||||
* LCS module cleanup function
|
||||
*/
|
||||
static void
|
||||
|
|
|
|||
Loading…
Reference in New Issue