staging: wlan-ng: fix block comment warnings in prism2mgmt.c

This patch fix the following checkpatch.pl warnings in prism2mgmt.c:
WARNING: Block comments should align the * on each line
WARNING: Block comments use a trailing */ on a separate line

Signed-off-by: Sergio Paracuellos <sergio.paracuellos@gmail.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
Sergio Paracuellos 2016-10-09 17:10:28 +02:00 committed by Greg Kroah-Hartman
parent 87f26d08cf
commit 01fe9c92df

View file

@ -1,61 +1,61 @@
/* src/prism2/driver/prism2mgmt.c /* src/prism2/driver/prism2mgmt.c
* *
* Management request handler functions. * Management request handler functions.
* *
* Copyright (C) 1999 AbsoluteValue Systems, Inc. All Rights Reserved. * Copyright (C) 1999 AbsoluteValue Systems, Inc. All Rights Reserved.
* -------------------------------------------------------------------- * --------------------------------------------------------------------
* *
* linux-wlan * linux-wlan
* *
* The contents of this file are subject to the Mozilla Public * The contents of this file are subject to the Mozilla Public
* License Version 1.1 (the "License"); you may not use this file * License Version 1.1 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of * except in compliance with the License. You may obtain a copy of
* the License at http://www.mozilla.org/MPL/ * the License at http://www.mozilla.org/MPL/
* *
* Software distributed under the License is distributed on an "AS * Software distributed under the License is distributed on an "AS
* IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
* implied. See the License for the specific language governing * implied. See the License for the specific language governing
* rights and limitations under the License. * rights and limitations under the License.
* *
* Alternatively, the contents of this file may be used under the * Alternatively, the contents of this file may be used under the
* terms of the GNU Public License version 2 (the "GPL"), in which * terms of the GNU Public License version 2 (the "GPL"), in which
* case the provisions of the GPL are applicable instead of the * case the provisions of the GPL are applicable instead of the
* above. If you wish to allow the use of your version of this file * above. If you wish to allow the use of your version of this file
* only under the terms of the GPL and not to allow others to use * only under the terms of the GPL and not to allow others to use
* your version of this file under the MPL, indicate your decision * your version of this file under the MPL, indicate your decision
* by deleting the provisions above and replace them with the notice * by deleting the provisions above and replace them with the notice
* and other provisions required by the GPL. If you do not delete * and other provisions required by the GPL. If you do not delete
* the provisions above, a recipient may use your version of this * the provisions above, a recipient may use your version of this
* file under either the MPL or the GPL. * file under either the MPL or the GPL.
* *
* -------------------------------------------------------------------- * --------------------------------------------------------------------
* *
* Inquiries regarding the linux-wlan Open Source project can be * Inquiries regarding the linux-wlan Open Source project can be
* made directly to: * made directly to:
* *
* AbsoluteValue Systems Inc. * AbsoluteValue Systems Inc.
* info@linux-wlan.com * info@linux-wlan.com
* http://www.linux-wlan.com * http://www.linux-wlan.com
* *
* -------------------------------------------------------------------- * --------------------------------------------------------------------
* *
* Portions of the development of this software were funded by * Portions of the development of this software were funded by
* Intersil Corporation as part of PRISM(R) chipset product development. * Intersil Corporation as part of PRISM(R) chipset product development.
* *
* -------------------------------------------------------------------- * --------------------------------------------------------------------
* *
* The functions in this file handle management requests sent from * The functions in this file handle management requests sent from
* user mode. * user mode.
* *
* Most of these functions have two separate blocks of code that are * Most of these functions have two separate blocks of code that are
* conditional on whether this is a station or an AP. This is used * conditional on whether this is a station or an AP. This is used
* to separate out the STA and AP responses to these management primitives. * to separate out the STA and AP responses to these management primitives.
* It's a choice (good, bad, indifferent?) to have the code in the same * It's a choice (good, bad, indifferent?) to have the code in the same
* place so it's clear that the same primitive is implemented in both * place so it's clear that the same primitive is implemented in both
* cases but has different behavior. * cases but has different behavior.
* *
* -------------------------------------------------------------------- * --------------------------------------------------------------------
*/ */
#include <linux/if_arp.h> #include <linux/if_arp.h>
#include <linux/module.h> #include <linux/module.h>
@ -90,29 +90,30 @@
(((n)&~BIT(7)) == 22) ? BIT(3) : 0) (((n)&~BIT(7)) == 22) ? BIT(3) : 0)
/*---------------------------------------------------------------- /*----------------------------------------------------------------
* prism2mgmt_scan * prism2mgmt_scan
* *
* Initiate a scan for BSSs. * Initiate a scan for BSSs.
* *
* This function corresponds to MLME-scan.request and part of * This function corresponds to MLME-scan.request and part of
* MLME-scan.confirm. As far as I can tell in the standard, there * MLME-scan.confirm. As far as I can tell in the standard, there
* are no restrictions on when a scan.request may be issued. We have * are no restrictions on when a scan.request may be issued. We have
* to handle in whatever state the driver/MAC happen to be. * to handle in whatever state the driver/MAC happen to be.
* *
* Arguments: * Arguments:
* wlandev wlan device structure * wlandev wlan device structure
* msgp ptr to msg buffer * msgp ptr to msg buffer
* *
* Returns: * Returns:
* 0 success and done * 0 success and done
* <0 success, but we're waiting for something to finish. * <0 success, but we're waiting for something to finish.
* >0 an error occurred while handling the message. * >0 an error occurred while handling the message.
* Side effects: * Side effects:
* *
* Call context: * Call context:
* process thread (usually) * process thread (usually)
* interrupt * interrupt
----------------------------------------------------------------*/ *----------------------------------------------------------------
*/
int prism2mgmt_scan(struct wlandevice *wlandev, void *msgp) int prism2mgmt_scan(struct wlandevice *wlandev, void *msgp)
{ {
int result = 0; int result = 0;
@ -347,25 +348,26 @@ int prism2mgmt_scan(struct wlandevice *wlandev, void *msgp)
} }
/*---------------------------------------------------------------- /*----------------------------------------------------------------
* prism2mgmt_scan_results * prism2mgmt_scan_results
* *
* Retrieve the BSS description for one of the BSSs identified in * Retrieve the BSS description for one of the BSSs identified in
* a scan. * a scan.
* *
* Arguments: * Arguments:
* wlandev wlan device structure * wlandev wlan device structure
* msgp ptr to msg buffer * msgp ptr to msg buffer
* *
* Returns: * Returns:
* 0 success and done * 0 success and done
* <0 success, but we're waiting for something to finish. * <0 success, but we're waiting for something to finish.
* >0 an error occurred while handling the message. * >0 an error occurred while handling the message.
* Side effects: * Side effects:
* *
* Call context: * Call context:
* process thread (usually) * process thread (usually)
* interrupt * interrupt
----------------------------------------------------------------*/ *----------------------------------------------------------------
*/
int prism2mgmt_scan_results(struct wlandevice *wlandev, void *msgp) int prism2mgmt_scan_results(struct wlandevice *wlandev, void *msgp)
{ {
int result = 0; int result = 0;
@ -507,24 +509,25 @@ int prism2mgmt_scan_results(struct wlandevice *wlandev, void *msgp)
} }
/*---------------------------------------------------------------- /*----------------------------------------------------------------
* prism2mgmt_start * prism2mgmt_start
* *
* Start a BSS. Any station can do this for IBSS, only AP for ESS. * Start a BSS. Any station can do this for IBSS, only AP for ESS.
* *
* Arguments: * Arguments:
* wlandev wlan device structure * wlandev wlan device structure
* msgp ptr to msg buffer * msgp ptr to msg buffer
* *
* Returns: * Returns:
* 0 success and done * 0 success and done
* <0 success, but we're waiting for something to finish. * <0 success, but we're waiting for something to finish.
* >0 an error occurred while handling the message. * >0 an error occurred while handling the message.
* Side effects: * Side effects:
* *
* Call context: * Call context:
* process thread (usually) * process thread (usually)
* interrupt * interrupt
----------------------------------------------------------------*/ *----------------------------------------------------------------
*/
int prism2mgmt_start(struct wlandevice *wlandev, void *msgp) int prism2mgmt_start(struct wlandevice *wlandev, void *msgp)
{ {
int result = 0; int result = 0;
@ -689,23 +692,24 @@ int prism2mgmt_start(struct wlandevice *wlandev, void *msgp)
} }
/*---------------------------------------------------------------- /*----------------------------------------------------------------
* prism2mgmt_readpda * prism2mgmt_readpda
* *
* Collect the PDA data and put it in the message. * Collect the PDA data and put it in the message.
* *
* Arguments: * Arguments:
* wlandev wlan device structure * wlandev wlan device structure
* msgp ptr to msg buffer * msgp ptr to msg buffer
* *
* Returns: * Returns:
* 0 success and done * 0 success and done
* <0 success, but we're waiting for something to finish. * <0 success, but we're waiting for something to finish.
* >0 an error occurred while handling the message. * >0 an error occurred while handling the message.
* Side effects: * Side effects:
* *
* Call context: * Call context:
* process thread (usually) * process thread (usually)
----------------------------------------------------------------*/ *----------------------------------------------------------------
*/
int prism2mgmt_readpda(struct wlandevice *wlandev, void *msgp) int prism2mgmt_readpda(struct wlandevice *wlandev, void *msgp)
{ {
struct hfa384x *hw = wlandev->priv; struct hfa384x *hw = wlandev->priv;
@ -748,30 +752,31 @@ int prism2mgmt_readpda(struct wlandevice *wlandev, void *msgp)
} }
/*---------------------------------------------------------------- /*----------------------------------------------------------------
* prism2mgmt_ramdl_state * prism2mgmt_ramdl_state
* *
* Establishes the beginning/end of a card RAM download session. * Establishes the beginning/end of a card RAM download session.
* *
* It is expected that the ramdl_write() function will be called * It is expected that the ramdl_write() function will be called
* one or more times between the 'enable' and 'disable' calls to * one or more times between the 'enable' and 'disable' calls to
* this function. * this function.
* *
* Note: This function should not be called when a mac comm port * Note: This function should not be called when a mac comm port
* is active. * is active.
* *
* Arguments: * Arguments:
* wlandev wlan device structure * wlandev wlan device structure
* msgp ptr to msg buffer * msgp ptr to msg buffer
* *
* Returns: * Returns:
* 0 success and done * 0 success and done
* <0 success, but we're waiting for something to finish. * <0 success, but we're waiting for something to finish.
* >0 an error occurred while handling the message. * >0 an error occurred while handling the message.
* Side effects: * Side effects:
* *
* Call context: * Call context:
* process thread (usually) * process thread (usually)
----------------------------------------------------------------*/ *----------------------------------------------------------------
*/
int prism2mgmt_ramdl_state(struct wlandevice *wlandev, void *msgp) int prism2mgmt_ramdl_state(struct wlandevice *wlandev, void *msgp)
{ {
struct hfa384x *hw = wlandev->priv; struct hfa384x *hw = wlandev->priv;
@ -808,25 +813,26 @@ int prism2mgmt_ramdl_state(struct wlandevice *wlandev, void *msgp)
} }
/*---------------------------------------------------------------- /*----------------------------------------------------------------
* prism2mgmt_ramdl_write * prism2mgmt_ramdl_write
* *
* Writes a buffer to the card RAM using the download state. This * Writes a buffer to the card RAM using the download state. This
* is for writing code to card RAM. To just read or write raw data * is for writing code to card RAM. To just read or write raw data
* use the aux functions. * use the aux functions.
* *
* Arguments: * Arguments:
* wlandev wlan device structure * wlandev wlan device structure
* msgp ptr to msg buffer * msgp ptr to msg buffer
* *
* Returns: * Returns:
* 0 success and done * 0 success and done
* <0 success, but we're waiting for something to finish. * <0 success, but we're waiting for something to finish.
* >0 an error occurred while handling the message. * >0 an error occurred while handling the message.
* Side effects: * Side effects:
* *
* Call context: * Call context:
* process thread (usually) * process thread (usually)
----------------------------------------------------------------*/ *----------------------------------------------------------------
*/
int prism2mgmt_ramdl_write(struct wlandevice *wlandev, void *msgp) int prism2mgmt_ramdl_write(struct wlandevice *wlandev, void *msgp)
{ {
struct hfa384x *hw = wlandev->priv; struct hfa384x *hw = wlandev->priv;
@ -864,30 +870,31 @@ int prism2mgmt_ramdl_write(struct wlandevice *wlandev, void *msgp)
} }
/*---------------------------------------------------------------- /*----------------------------------------------------------------
* prism2mgmt_flashdl_state * prism2mgmt_flashdl_state
* *
* Establishes the beginning/end of a card Flash download session. * Establishes the beginning/end of a card Flash download session.
* *
* It is expected that the flashdl_write() function will be called * It is expected that the flashdl_write() function will be called
* one or more times between the 'enable' and 'disable' calls to * one or more times between the 'enable' and 'disable' calls to
* this function. * this function.
* *
* Note: This function should not be called when a mac comm port * Note: This function should not be called when a mac comm port
* is active. * is active.
* *
* Arguments: * Arguments:
* wlandev wlan device structure * wlandev wlan device structure
* msgp ptr to msg buffer * msgp ptr to msg buffer
* *
* Returns: * Returns:
* 0 success and done * 0 success and done
* <0 success, but we're waiting for something to finish. * <0 success, but we're waiting for something to finish.
* >0 an error occurred while handling the message. * >0 an error occurred while handling the message.
* Side effects: * Side effects:
* *
* Call context: * Call context:
* process thread (usually) * process thread (usually)
----------------------------------------------------------------*/ *----------------------------------------------------------------
*/
int prism2mgmt_flashdl_state(struct wlandevice *wlandev, void *msgp) int prism2mgmt_flashdl_state(struct wlandevice *wlandev, void *msgp)
{ {
int result = 0; int result = 0;
@ -942,23 +949,24 @@ int prism2mgmt_flashdl_state(struct wlandevice *wlandev, void *msgp)
} }
/*---------------------------------------------------------------- /*----------------------------------------------------------------
* prism2mgmt_flashdl_write * prism2mgmt_flashdl_write
* *
* *
* *
* Arguments: * Arguments:
* wlandev wlan device structure * wlandev wlan device structure
* msgp ptr to msg buffer * msgp ptr to msg buffer
* *
* Returns: * Returns:
* 0 success and done * 0 success and done
* <0 success, but we're waiting for something to finish. * <0 success, but we're waiting for something to finish.
* >0 an error occurred while handling the message. * >0 an error occurred while handling the message.
* Side effects: * Side effects:
* *
* Call context: * Call context:
* process thread (usually) * process thread (usually)
----------------------------------------------------------------*/ *----------------------------------------------------------------
*/
int prism2mgmt_flashdl_write(struct wlandevice *wlandev, void *msgp) int prism2mgmt_flashdl_write(struct wlandevice *wlandev, void *msgp)
{ {
struct hfa384x *hw = wlandev->priv; struct hfa384x *hw = wlandev->priv;
@ -1001,24 +1009,25 @@ int prism2mgmt_flashdl_write(struct wlandevice *wlandev, void *msgp)
} }
/*---------------------------------------------------------------- /*----------------------------------------------------------------
* prism2mgmt_autojoin * prism2mgmt_autojoin
* *
* Associate with an ESS. * Associate with an ESS.
* *
* Arguments: * Arguments:
* wlandev wlan device structure * wlandev wlan device structure
* msgp ptr to msg buffer * msgp ptr to msg buffer
* *
* Returns: * Returns:
* 0 success and done * 0 success and done
* <0 success, but we're waiting for something to finish. * <0 success, but we're waiting for something to finish.
* >0 an error occurred while handling the message. * >0 an error occurred while handling the message.
* Side effects: * Side effects:
* *
* Call context: * Call context:
* process thread (usually) * process thread (usually)
* interrupt * interrupt
----------------------------------------------------------------*/ *----------------------------------------------------------------
*/
int prism2mgmt_autojoin(struct wlandevice *wlandev, void *msgp) int prism2mgmt_autojoin(struct wlandevice *wlandev, void *msgp)
{ {
struct hfa384x *hw = wlandev->priv; struct hfa384x *hw = wlandev->priv;
@ -1072,24 +1081,25 @@ int prism2mgmt_autojoin(struct wlandevice *wlandev, void *msgp)
} }
/*---------------------------------------------------------------- /*----------------------------------------------------------------
* prism2mgmt_wlansniff * prism2mgmt_wlansniff
* *
* Start or stop sniffing. * Start or stop sniffing.
* *
* Arguments: * Arguments:
* wlandev wlan device structure * wlandev wlan device structure
* msgp ptr to msg buffer * msgp ptr to msg buffer
* *
* Returns: * Returns:
* 0 success and done * 0 success and done
* <0 success, but we're waiting for something to finish. * <0 success, but we're waiting for something to finish.
* >0 an error occurred while handling the message. * >0 an error occurred while handling the message.
* Side effects: * Side effects:
* *
* Call context: * Call context:
* process thread (usually) * process thread (usually)
* interrupt * interrupt
----------------------------------------------------------------*/ *----------------------------------------------------------------
*/
int prism2mgmt_wlansniff(struct wlandevice *wlandev, void *msgp) int prism2mgmt_wlansniff(struct wlandevice *wlandev, void *msgp)
{ {
int result = 0; int result = 0;