Hi All,
On Sun, May 29, 2016 at 1:30 PM, Kirtika Ruchandani
<kirtika.ruchandani@xxxxxxxxx> wrote:
> This patch fixes the following checkpatch.pl warnings about
> comments in nl80211.c :
> - networking block comments don't use an empty '/*' line
> - block comments use a trailing '*/' on a separate line
>
> Signed-off-by: Kirtika Ruchandani <kirtika.ruchandani@xxxxxxxxx>
The change and logic behind it are sound, so it gets my:
Reviewed-by: Julian Calaby <julian.calaby@xxxxxxxxx>
however I'm concerned that this file is a deliberate exception to the
networking comment rules.
Johannes?
Thanks,
Julian Calaby
> ---
> net/wireless/nl80211.c | 129 +++++++++++++++++--------------------------------
> 1 file changed, 45 insertions(+), 84 deletions(-)
>
> diff --git a/net/wireless/nl80211.c b/net/wireless/nl80211.c
> index d759901..50a0de0 100644
> --- a/net/wireless/nl80211.c
> +++ b/net/wireless/nl80211.c
> @@ -196,8 +196,7 @@ __cfg80211_rdev_from_attrs(struct net *netns, struct nlattr **attrs)
> return rdev;
> }
>
> -/*
> - * This function returns a pointer to the driver
> +/* This function returns a pointer to the driver
> * that the genl_info item that is passed refers to.
> *
> * The result of this can be a PTR_ERR and hence must
> @@ -1624,8 +1623,7 @@ static int nl80211_send_wiphy(struct cfg80211_registered_device *rdev,
> goto nla_put_failure;
>
> features = rdev->wiphy.features;
> - /*
> - * We can only add the per-channel limit information if the
> + /* We can only add the per-channel limit information if the
> * dump is split, otherwise it makes it too big. Therefore
> * only advertise it in that case.
> */
> @@ -1646,8 +1644,7 @@ static int nl80211_send_wiphy(struct cfg80211_registered_device *rdev,
> rdev->wiphy.max_acl_mac_addrs))
> goto nla_put_failure;
>
> - /*
> - * Any information below this point is only available to
> + /* Any information below this point is only available to
> * applications that can deal with it being split. This
> * helps ensure that newly added capabilities don't break
> * older tools by overrunning their buffers.
> @@ -1847,8 +1844,7 @@ static int nl80211_dump_wiphy(struct sk_buff *skb, struct netlink_callback *cb)
> cb->nlh->nlmsg_seq,
> NLM_F_MULTI, state);
> if (ret < 0) {
> - /*
> - * If sending the wiphy data didn't fit (ENOBUFS
> + /* If sending the wiphy data didn't fit (ENOBUFS
> * or EMSGSIZE returned), this SKB is still
> * empty (so it's not too big because another
> * wiphy dataset is already in the skb) and
> @@ -1937,8 +1933,7 @@ static int parse_txq_params(struct nlattr *tb[],
>
> static bool nl80211_can_set_dev_channel(struct wireless_dev *wdev)
> {
> - /*
> - * You can only set the channel explicitly for WDS interfaces,
> + /* You can only set the channel explicitly for WDS interfaces,
> * all others have their channel managed via their respective
> * "establish a connection" command (connect, join, ...)
> *
> @@ -2131,8 +2126,7 @@ static int nl80211_set_wiphy(struct sk_buff *skb, struct genl_info *info)
>
> ASSERT_RTNL();
>
> - /*
> - * Try to find the wiphy and netdev. Normally this
> + /* Try to find the wiphy and netdev. Normally this
> * function shouldn't need the netdev, but this is
> * done for backward compatibility -- previously
> * setting the channel was done per wiphy, but now
> @@ -2162,8 +2156,7 @@ static int nl80211_set_wiphy(struct sk_buff *skb, struct genl_info *info)
> } else
> wdev = netdev->ieee80211_ptr;
>
> - /*
> - * end workaround code, by now the rdev is available
> + /* end workaround code, by now the rdev is available
> * and locked, and wdev may or may not be NULL.
> */
>
> @@ -2260,7 +2253,8 @@ static int nl80211_set_wiphy(struct sk_buff *skb, struct genl_info *info)
> rx_ant = nla_get_u32(info->attrs[NL80211_ATTR_WIPHY_ANTENNA_RX]);
>
> /* reject antenna configurations which don't match the
> - * available antenna masks, except for the "all" mask */
> + * available antenna masks, except for the "all" mask
> + */
> if ((~tx_ant && (tx_ant & ~rdev->wiphy.available_antennas_tx)) ||
> (~rx_ant && (rx_ant & ~rdev->wiphy.available_antennas_rx)))
> return -EINVAL;
> @@ -2300,8 +2294,7 @@ static int nl80211_set_wiphy(struct sk_buff *skb, struct genl_info *info)
> return -EINVAL;
>
> if (frag_threshold != (u32) -1) {
> - /*
> - * Fragments (apart from the last one) are required to
> + /* Fragments (apart from the last one) are required to
> * have even length. Make the fragmentation code
> * simpler by stripping LSB should someone try to use
> * odd threshold value.
> @@ -2751,8 +2744,7 @@ static int nl80211_new_interface(struct sk_buff *skb, struct genl_info *info)
> wdev_unlock(wdev);
> break;
> case NL80211_IFTYPE_P2P_DEVICE:
> - /*
> - * P2P Device doesn't have a netdev, so doesn't go
> + /* P2P Device doesn't have a netdev, so doesn't go
> * through the netdev notifier and must be added here
> */
> mutex_init(&wdev->mtx);
> @@ -2808,8 +2800,7 @@ static int nl80211_del_interface(struct sk_buff *skb, struct genl_info *info)
> msg = NULL;
> }
>
> - /*
> - * If we remove a wireless device without a netdev then clear
> + /* If we remove a wireless device without a netdev then clear
> * user_ptr[1] so that nl80211_post_doit won't dereference it
> * to check if it needs to do dev_put(). Otherwise it crashes
> * since the wdev has been freed, unlike with a netdev where
> @@ -3160,8 +3151,7 @@ static int validate_acl_mac_addrs(struct nlattr *nl_attr)
> return n_entries;
> }
>
> -/*
> - * This function parses ACL information and allocates memory for ACL data.
> +/* This function parses ACL information and allocates memory for ACL data.
> * On successful return, the calling function is responsible to free the
> * ACL buffer returned by this function.
> */
> @@ -3377,8 +3367,7 @@ static int nl80211_start_ap(struct sk_buff *skb, struct genl_info *info)
> if (err)
> return err;
>
> - /*
> - * In theory, some of these attributes should be required here
> + /* In theory, some of these attributes should be required here
> * but since they were not used when the command was originally
> * added, keep them optional for old user space programs to let
> * them continue to work with drivers that do not need the
> @@ -3567,8 +3556,7 @@ static int parse_station_flags(struct genl_info *info,
> struct nlattr *nla;
> int flag;
>
> - /*
> - * Try parsing the new attribute first so userspace
> + /* Try parsing the new attribute first so userspace
> * can specify both for older kernels.
> */
> nla = info->attrs[NL80211_ATTR_STA_FLAGS2];
> @@ -3595,8 +3583,7 @@ static int parse_station_flags(struct genl_info *info,
> nla, sta_flags_policy))
> return -EINVAL;
>
> - /*
> - * Only allow certain flags for interface types so that
> + /* Only allow certain flags for interface types so that
> * other attributes are silently ignored. Remember that
> * this is backward compatibility code with old userspace
> * and shouldn't be hit in other cases anyway.
> @@ -4032,8 +4019,7 @@ int cfg80211_check_station_change(struct wiphy *wiphy,
> switch (statype) {
> case CFG80211_STA_MESH_PEER_KERNEL:
> case CFG80211_STA_MESH_PEER_USER:
> - /*
> - * No ignoring the TDLS flag here -- the userspace mesh
> + /* No ignoring the TDLS flag here -- the userspace mesh
> * code doesn't have the bug of including TDLS in the
> * mask everywhere.
> */
> @@ -4065,8 +4051,7 @@ int cfg80211_check_station_change(struct wiphy *wiphy,
> /* TDLS can't be set, ... */
> if (params->sta_flags_set & BIT(NL80211_STA_FLAG_TDLS_PEER))
> return -EINVAL;
> - /*
> - * ... but don't bother the driver with it. This works around
> + /* ... but don't bother the driver with it. This works around
> * a hostapd/wpa_supplicant issue -- it always includes the
> * TLDS_PEER flag in the mask even for AP mode.
> */
> @@ -4151,8 +4136,7 @@ int cfg80211_check_station_change(struct wiphy *wiphy,
> }
> EXPORT_SYMBOL(cfg80211_check_station_change);
>
> -/*
> - * Get vlan interface making sure it is running and on the right wiphy.
> +/* Get vlan interface making sure it is running and on the right wiphy.
> */
> static struct net_device *get_vlan(struct genl_info *info,
> struct cfg80211_registered_device *rdev)
> @@ -4239,8 +4223,7 @@ static int nl80211_parse_sta_channel_info(struct genl_info *info,
> nla_data(info->attrs[NL80211_ATTR_STA_SUPPORTED_CHANNELS]);
> params->supported_channels_len =
> nla_len(info->attrs[NL80211_ATTR_STA_SUPPORTED_CHANNELS]);
> - /*
> - * Need to include at least one (first channel, number of
> + /* Need to include at least one (first channel, number of
> * channels) tuple for each subband, and must have proper
> * tuples for the rest of the data as well.
> */
> @@ -4255,8 +4238,7 @@ static int nl80211_parse_sta_channel_info(struct genl_info *info,
> nla_data(info->attrs[NL80211_ATTR_STA_SUPPORTED_OPER_CLASSES]);
> params->supported_oper_classes_len =
> nla_len(info->attrs[NL80211_ATTR_STA_SUPPORTED_OPER_CLASSES]);
> - /*
> - * The value of the Length field of the Supported Operating
> + /* The value of the Length field of the Supported Operating
> * Classes element is between 2 and 253.
> */
> if (params->supported_oper_classes_len < 2 ||
> @@ -4300,8 +4282,7 @@ static int nl80211_set_station(struct sk_buff *skb, struct genl_info *info)
> if (!rdev->ops->change_station)
> return -EOPNOTSUPP;
>
> - /*
> - * AID and listen_interval properties can be set only for unassociated
> + /* AID and listen_interval properties can be set only for unassociated
> * station. Include these parameters here and will check them in
> * cfg80211_check_station_change().
> */
> @@ -4458,8 +4439,7 @@ static int nl80211_new_station(struct sk_buff *skb, struct genl_info *info)
>
> params.support_p2p_ps = tmp;
> } else {
> - /*
> - * if not specified, assume it's supported for P2P GO interface,
> + /* if not specified, assume it's supported for P2P GO interface,
> * and is NOT supported for AP interface
> */
> params.support_p2p_ps =
> @@ -4604,8 +4584,7 @@ static int nl80211_new_station(struct sk_buff *skb, struct genl_info *info)
> /* ... with external setup is supported */
> if (!(rdev->wiphy.flags & WIPHY_FLAG_TDLS_EXTERNAL_SETUP))
> return -EOPNOTSUPP;
> - /*
> - * Older wpa_supplicant versions always mark the TDLS peer
> + /* Older wpa_supplicant versions always mark the TDLS peer
> * as authorized, but it shouldn't yet be.
> */
> params.sta_flags_mask &= ~BIT(NL80211_STA_FLAG_AUTHORIZED);
> @@ -5054,8 +5033,7 @@ static int nl80211_req_set_reg(struct sk_buff *skb, struct genl_info *info)
> u32 owner_nlportid;
>
>
> - /*
> - * You should only get this when cfg80211 hasn't yet initialized
> + /* You should only get this when cfg80211 hasn't yet initialized
> * completely when built-in to the kernel right between the time
> * window between nl80211_init() and regulatory_init(), if that is
> * even possible.
> @@ -5271,7 +5249,8 @@ do { \
> return -EINVAL;
>
> /* This makes sure that there aren't more than 32 mesh config
> - * parameters (otherwise our bitfield scheme would not work.) */
> + * parameters (otherwise our bitfield scheme would not work.)
> + */
> BUILD_BUG_ON(NL80211_MESHCONF_ATTR_MAX > 32);
>
> /* Fill in the params struct */
> @@ -5770,8 +5749,7 @@ static int nl80211_set_reg(struct sk_buff *skb, struct genl_info *info)
> rd->alpha2[0] = alpha2[0];
> rd->alpha2[1] = alpha2[1];
>
> - /*
> - * Disable DFS master mode if the DFS region was
> + /* Disable DFS master mode if the DFS region was
> * not supported or known on this kernel.
> */
> if (reg_supported_dfs_region(dfs_region))
> @@ -5813,8 +5791,7 @@ static int validate_scan_freqs(struct nlattr *freqs)
>
> nla_for_each_nested(attr1, freqs, tmp1) {
> n_channels++;
> - /*
> - * Some hardware has a limited channel list for
> + /* Some hardware has a limited channel list for
> * scanning, and it is pretty much nonsensical
> * to scan for a channel twice, so disallow that
> * and don't require drivers to check that the
> @@ -5924,8 +5901,7 @@ static int nl80211_parse_random_mac(struct nlattr **attrs,
> is_multicast_ether_addr(mac_addr))
> return -EINVAL;
>
> - /*
> - * allow users to pass a MAC address that has bits set outside
> + /* allow users to pass a MAC address that has bits set outside
> * of the mask, but don't bother drivers with having to deal
> * with such bits
> */
> @@ -6192,8 +6168,7 @@ nl80211_parse_sched_scan_plans(struct wiphy *wiphy, int n_plans,
> if (!attrs[NL80211_ATTR_SCHED_SCAN_PLANS]) {
> u32 interval;
>
> - /*
> - * If scan plans are not specified,
> + /* If scan plans are not specified,
> * %NL80211_ATTR_SCHED_SCAN_INTERVAL must be specified. In this
> * case one scan plan will be set with the specified scan
> * interval and infinite number of iterations.
> @@ -6248,8 +6223,7 @@ nl80211_parse_sched_scan_plans(struct wiphy *wiphy, int n_plans,
> wiphy->max_sched_scan_plan_iterations))
> return -EINVAL;
> } else if (i < n_plans - 1) {
> - /*
> - * All scan plans but the last one must specify
> + /* All scan plans but the last one must specify
> * a finite number of iterations
> */
> return -EINVAL;
> @@ -6258,8 +6232,7 @@ nl80211_parse_sched_scan_plans(struct wiphy *wiphy, int n_plans,
> i++;
> }
>
> - /*
> - * The last scan plan must not specify the number of
> + /* The last scan plan must not specify the number of
> * iterations, it is supposed to run infinitely
> */
> if (request->scan_plans[n_plans - 1].iterations)
> @@ -6300,8 +6273,7 @@ nl80211_parse_sched_scan(struct wiphy *wiphy, struct wireless_dev *wdev,
> if (n_ssids > wiphy->max_sched_scan_ssids)
> return ERR_PTR(-EINVAL);
>
> - /*
> - * First, count the number of 'real' matchsets. Due to an issue with
> + /* First, count the number of 'real' matchsets. Due to an issue with
> * the old implementation, matchsets containing only the RSSI attribute
> * (NL80211_SCHED_SCAN_MATCH_ATTR_RSSI) are considered as the 'default'
> * RSSI for all matchsets, rather than their own matchset for reporting
> @@ -6347,8 +6319,7 @@ nl80211_parse_sched_scan(struct wiphy *wiphy, struct wireless_dev *wdev,
> return ERR_PTR(-EINVAL);
>
> if (attrs[NL80211_ATTR_SCHED_SCAN_PLANS]) {
> - /*
> - * NL80211_ATTR_SCHED_SCAN_INTERVAL must not be specified since
> + /* NL80211_ATTR_SCHED_SCAN_INTERVAL must not be specified since
> * each scan plan already specifies its own interval
> */
> if (attrs[NL80211_ATTR_SCHED_SCAN_INTERVAL])
> @@ -6358,8 +6329,7 @@ nl80211_parse_sched_scan(struct wiphy *wiphy, struct wireless_dev *wdev,
> attrs[NL80211_ATTR_SCHED_SCAN_PLANS], tmp)
> n_plans++;
> } else {
> - /*
> - * The scan interval attribute is kept for backward
> + /* The scan interval attribute is kept for backward
> * compatibility. If no scan plans are specified and sched scan
> * interval is specified, one scan plan will be set with this
> * scan interval and infinite number of iterations.
> @@ -7255,8 +7225,7 @@ static int nl80211_authenticate(struct sk_buff *skb, struct genl_info *info)
>
> local_state_change = !!info->attrs[NL80211_ATTR_LOCAL_STATE_CHANGE];
>
> - /*
> - * Since we no longer track auth state, ignore
> + /* Since we no longer track auth state, ignore
> * requests to only change local state.
> */
> if (local_state_change)
> @@ -7918,8 +7887,7 @@ static int nl80211_testmode_dump(struct sk_buff *skb,
> rtnl_lock();
>
> if (cb->args[0]) {
> - /*
> - * 0 is a valid index, but not valid for args[0],
> + /* 0 is a valid index, but not valid for args[0],
> * so we need to offset by 1.
> */
> phy_idx = cb->args[0] - 1;
> @@ -8364,8 +8332,7 @@ static int nl80211_remain_on_channel(struct sk_buff *skb,
> !(rdev->wiphy.flags & WIPHY_FLAG_HAS_REMAIN_ON_CHANNEL))
> return -EOPNOTSUPP;
>
> - /*
> - * We should be on that channel for at least a minimum amount of
> + /* We should be on that channel for at least a minimum amount of
> * time (10ms) but no longer than the driver supports.
> */
> if (duration < NL80211_MIN_REMAIN_ON_CHANNEL_TIME ||
> @@ -8586,8 +8553,7 @@ static int nl80211_set_tx_bitrate_mask(struct sk_buff *skb,
> if (!info->attrs[NL80211_ATTR_TX_RATES])
> goto out;
>
> - /*
> - * The nested attribute uses enum nl80211_band as the index. This maps
> + /* The nested attribute uses enum nl80211_band as the index. This maps
> * directly to the enum nl80211_band values used in cfg80211.
> */
> BUILD_BUG_ON(NL80211_MAX_SUPP_HT_RATES > IEEE80211_HT_MCS_MASK_LEN * 8);
> @@ -8736,8 +8702,7 @@ static int nl80211_tx_mgmt(struct sk_buff *skb, struct genl_info *info)
> return -EINVAL;
> params.wait = nla_get_u32(info->attrs[NL80211_ATTR_DURATION]);
>
> - /*
> - * We should wait on the channel for at least a minimum amount
> + /* We should wait on the channel for at least a minimum amount
> * of time (10ms) but no longer than the driver supports.
> */
> if (params.wait < NL80211_MIN_REMAIN_ON_CHANNEL_TIME ||
> @@ -10758,8 +10723,7 @@ static int nl80211_tdls_channel_switch(struct sk_buff *skb,
> if (err)
> return err;
>
> - /*
> - * Don't allow wide channels on the 2.4Ghz band, as per IEEE802.11-2012
> + /* Don't allow wide channels on the 2.4Ghz band, as per IEEE802.11-2012
> * section 10.22.6.2.1. Disallow 5/10Mhz channels as well for now, the
> * specification is not defined for them.
> */
> @@ -11899,8 +11863,7 @@ nla_put_failure:
> return false;
> }
>
> -/*
> - * This can happen on global regulatory changes or device specific settings
> +/* This can happen on global regulatory changes or device specific settings
> * based on custom regulatory domains.
> */
> void nl80211_common_reg_change_event(enum nl80211_commands cmd_id,
> @@ -12337,8 +12300,7 @@ void nl80211_send_beacon_hint_event(struct wiphy *wiphy,
> return;
> }
>
> - /*
> - * Since we are applying the beacon hint to a wiphy we know its
> + /* Since we are applying the beacon hint to a wiphy we know its
> * wiphy_idx is valid
> */
> if (nla_put_u32(msg, NL80211_ATTR_WIPHY, get_wiphy_idx(wiphy)))
> @@ -13453,8 +13415,7 @@ static int nl80211_netlink_notify(struct notifier_block * nb,
>
> rcu_read_unlock();
>
> - /*
> - * It is possible that the user space process that is controlling the
> + /* It is possible that the user space process that is controlling the
> * indoor setting disappeared, so notify the regulatory core.
> */
> regulatory_netlink_notify(notify->portid);
> --
> 2.8.0.rc3.226.g39d4020
>
> --
> To unsubscribe from this list: send the line "unsubscribe linux-wireless" in
> the body of a message to majordomo@xxxxxxxxxxxxxxx
> More majordomo info at http://vger.kernel.org/majordomo-info.html
--
Julian Calaby
Email: julian.calaby@xxxxxxxxx
Profile: http://www.google.com/profiles/julian.calaby/
--
To unsubscribe from this list: send the line "unsubscribe linux-wireless" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
