From nobody Tue Feb 10 21:40:57 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id A529AC6FD1C for ; Sat, 25 Mar 2023 12:13:33 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231958AbjCYMNc (ORCPT ); Sat, 25 Mar 2023 08:13:32 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:41610 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231941AbjCYMN2 (ORCPT ); Sat, 25 Mar 2023 08:13:28 -0400 Received: from mail-wr1-x436.google.com (mail-wr1-x436.google.com [IPv6:2a00:1450:4864:20::436]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 418B483E2 for ; Sat, 25 Mar 2023 05:13:25 -0700 (PDT) Received: by mail-wr1-x436.google.com with SMTP id y14so4197321wrq.4 for ; Sat, 25 Mar 2023 05:13:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; t=1679746404; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=x2e6/ZQkaCngsRHjA+j6a0QRk4iZkyejdUWx9nVcumI=; b=ahYQi8kN/zo+Snp4/WZaBlI56NuIHoRnXtP8GqKT+cdg0T6qnGnuhEv5KlHGwFntAN BUDn3WrhCL9oOfaJtZi/Zu4y1e3Y82vWfGZWyyBipwiv/SuyaFO3yDlzyaYnsyledxnC AF5xNNNIvTYXW3UD8v4x4PZmC8Cn20MFMUm+5YAbC3/Um7z8NzDsWYFvgXv0mzK3kIWO WbwtDv70BENcMR/qydCDf3DNSmACBZV67rIbKpWJhlnWUWPTdw42oFcGX0SuygFsbdSz dhT/gVE7dbTt05nAKGdsLUtbllWJGrpPoQvtJsoL0M2TUpHYbHlwMNwrCqe74/KkBI59 ElNg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1679746404; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=x2e6/ZQkaCngsRHjA+j6a0QRk4iZkyejdUWx9nVcumI=; b=jdg66cyuIhMzBTqDn/Tr0OIuE+ooM2tK/5BnTqkB504Ajb5Hb5Rm25VWf83Vi6iinZ CC+1clYNRxKBFW0bH6dX3Y9E20+3pw7kPxCCRqfnlKjrt1pHupBTV884dU3FqUCQG79N r/AONHpqatyxZfcHVf7j5ZLhPjMROcGd3hoIpVBHzjCAS3HeS5dHdARGVA4wo483osLt XfY2wV1W/iFM9ZgUONlAqIy9VlW5dmZsNqBxmpP6pfoKc8OeP1Y8Uck7J16IqlhgLlMh VAVoT+sL4k6Me4AcX/z7v2gAGpLDivSe+BmlsFbtoIzHXJq6+1bCZL4OXCB0VFJoDOyJ RJQg== X-Gm-Message-State: AAQBX9cHaR7q9El8XqbiUPy9SVOvIllLDDTsZ2rIGXFBBm8R0i7ucj4E Zkdm8t6oo/e/K+yV2G3/2l4= X-Google-Smtp-Source: AKy350akCNh1z9/4ihusX6LPOFxMkd5Wi9H/6xHHqu5cJJtHCO3zrnhsVx2+5hf0wCnVZeark8IudA== X-Received: by 2002:a5d:4845:0:b0:2c7:f84:3c41 with SMTP id n5-20020a5d4845000000b002c70f843c41mr4674649wrs.55.1679746403638; Sat, 25 Mar 2023 05:13:23 -0700 (PDT) Received: from khadija-virtual-machine.localdomain ([39.41.14.14]) by smtp.gmail.com with ESMTPSA id c10-20020adffb0a000000b002c70c99db74sm20504791wrr.86.2023.03.25.05.13.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 25 Mar 2023 05:13:23 -0700 (PDT) From: Khadija Kamran To: outreachy@lists.linux.dev Cc: gregkh@linuxfoundation.org, linux-staging@lists.linux.dev, linux-kernel@vger.kernel.org Subject: [PATCH 1/3] staging: rtl8192u: reformat block comments Date: Sat, 25 Mar 2023 17:13:16 +0500 Message-Id: <2974a7ba0e2d3cc693b2a7229cf150c10f395ac5.1679744684.git.kamrankhadijadj@gmail.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Linux kernel coding style for block comments uses a column of '*' on the left side and uses '*/' on a separate line. Fix block comments by adding '*' on subsequent lines and moving '*/' at the end of block comments on a separate line. These issues in block comments are reported by checkpatch.pl script. Signed-off-by: Khadija Kamran --- drivers/staging/rtl8192u/r8192U_dm.c | 162 ++++++++++++++------------- 1 file changed, 86 insertions(+), 76 deletions(-) diff --git a/drivers/staging/rtl8192u/r8192U_dm.c b/drivers/staging/rtl8192= u/r8192U_dm.c index 6a33ca02c3dc..a88686be3523 100644 --- a/drivers/staging/rtl8192u/r8192U_dm.c +++ b/drivers/staging/rtl8192u/r8192U_dm.c @@ -1,19 +1,20 @@ // SPDX-License-Identifier: GPL-2.0 /*++ -Copyright-c Realtek Semiconductor Corp. All rights reserved. - -Module Name: - r8192U_dm.c - -Abstract: - HW dynamic mechanism. - -Major Change History: - When Who What - ---------- --------------- ------------------------------- - 2008-05-14 amy create version 0 porting from windows = code. - ---*/ + * Copyright-c Realtek Semiconductor Corp. All rights reserved. + * + * Module Name: + * r8192U_dm.c + * + * Abstract: + * HW dynamic mechanism. + * + * Major Change History: + * When Who What + * ---------- --------------- ------------------------------- + * 2008-05-14 amy create version 0 porting from window= s code. + * + *-- + */ #include "r8192U.h" #include "r8192U_dm.h" #include "r8192U_hw.h" @@ -147,20 +148,20 @@ void dm_CheckRxAggregation(struct net_device *dev) unsigned long curRxOkCnt =3D 0; =20 /* - if (pHalData->bForcedUsbRxAggr) { - if (pHalData->ForcedUsbRxAggrInfo =3D=3D 0) { - if (pHalData->bCurrentRxAggrEnable) { - Adapter->HalFunc.HalUsbRxAggrHandler(Adapter, FALSE); - } - } else { - if (!pHalData->bCurrentRxAggrEnable || (pHalData->ForcedUsbRxAggrInfo != =3D pHalData->LastUsbRxAggrInfoSetting)) { - Adapter->HalFunc.HalUsbRxAggrHandler(Adapter, TRUE); - } - } - return; - } - -*/ + * if (pHalData->bForcedUsbRxAggr) { + * if (pHalData->ForcedUsbRxAggrInfo =3D=3D 0) { + * if (pHalData->bCurrentRxAggrEnable) { + * Adapter->HalFunc.HalUsbRxAggrHandler(Adapter, FALSE); + * } + * } else { + * if (!pHalData->bCurrentRxAggrEnable || (pHalData->ForcedUsbRxAggrInfo= !=3D pHalData->LastUsbRxAggrInfoSetting)) { + * Adapter->HalFunc.HalUsbRxAggrHandler(Adapter, TRUE); + * } + * } + * return; + * } + * + */ curTxOkCnt =3D priv->stats.txbytesunicast - lastTxOkCnt; curRxOkCnt =3D priv->stats.rxbytesunicast - lastRxOkCnt; =20 @@ -279,7 +280,8 @@ void init_rate_adaptive(struct net_device *dev) * When Who Remark * 05/26/08 amy Create version 0 porting from windows code. * - *------------------------------------------------------------------------= ---*/ + *------------------------------------------------------------------------= --- + */ static void dm_check_rate_adaptive(struct net_device *dev) { struct r8192_priv *priv =3D ieee80211_priv(dev); @@ -377,8 +379,9 @@ static void dm_check_rate_adaptive(struct net_device *d= ev) targetRATR =3D pra->ping_rssi_ratr; ping_rssi_state =3D 1; } - /*else - DbgPrint("TestRSSI is between the range.\n");*/ + /* else + * DbgPrint("TestRSSI is between the range.\n"); + */ } else { /*DbgPrint("TestRSSI Recover to 0x%x\n", targetRATR);*/ ping_rssi_state =3D 0; @@ -719,9 +722,10 @@ static void dm_TXPowerTrackingCallback_ThermalMeter(st= ruct net_device *dev) } tmpCCK40Mindex =3D 0; } - /*DbgPrint("%ddb, tmpOFDMindex =3D %d, tmpCCK20Mindex =3D %d, tmpCCK40Min= dex =3D %d", - ((u1Byte)tmpRegA - pHalData->ThermalMeter[0]), - tmpOFDMindex, tmpCCK20Mindex, tmpCCK40Mindex);*/ + /* DbgPrint("%ddb, tmpOFDMindex =3D %d, tmpCCK20Mindex =3D %d, tmpCCK40Mi= ndex =3D %d", + * ((u1Byte)tmpRegA - pHalData->ThermalMeter[0]), + * tmpOFDMindex, tmpCCK20Mindex, tmpCCK40Mindex); + */ if (priv->CurrentChannelBW !=3D HT_CHANNEL_WIDTH_20) /* 40M */ tmpCCKindex =3D tmpCCK40Mindex; else @@ -1594,7 +1598,8 @@ static void dm_bb_initialgain_backup(struct net_devic= e *dev) * When Who Remark * 05/15/2008 amy Create Version 0 porting from windows code. * - *------------------------------------------------------------------------= ---*/ + *------------------------------------------------------------------------= --- + */ static void dm_dig_init(struct net_device *dev) { struct r8192_priv *priv =3D ieee80211_priv(dev); @@ -1638,7 +1643,8 @@ static void dm_dig_init(struct net_device *dev) * Revised History: * When Who Remark * 05/27/2008 amy Create Version 0 porting from windows code. - *------------------------------------------------------------------------= ---*/ + *------------------------------------------------------------------------= --- + */ static void dm_ctrl_initgain_byrssi(struct net_device *dev) { if (!dm_digtable.dig_enable_flag) @@ -1680,8 +1686,9 @@ static void dm_ctrl_initgain_byrssi_by_driverrssi( else dm_digtable.cur_connect_state =3D DIG_DISCONNECT; =20 - /*DbgPrint("DM_DigTable.PreConnectState =3D %d, DM_DigTable.CurConnectSta= te =3D %d\n", - DM_DigTable.PreConnectState, DM_DigTable.CurConnectState);*/ + /* DbgPrint("DM_DigTable.PreConnectState =3D %d, DM_DigTable.CurConnectSt= ate =3D %d\n", + * DM_DigTable.PreConnectState, DM_DigTable.CurConnectState); + */ =20 dm_digtable.rssi_val =3D priv->undecorated_smoothed_pwdb; /*DbgPrint("DM_DigTable.Rssi_val =3D %d\n", DM_DigTable.Rssi_val);*/ @@ -1720,12 +1727,12 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alar= m( (priv->undecorated_smoothed_pwdb < dm_digtable.rssi_high_thresh)) return; =20 - /*DbgPrint("Dig by Fw False Alarm\n");*/ - /*if (DM_DigTable.Dig_State =3D=3D DM_STA_DIG_OFF)*/ - /*DbgPrint("DIG Check\n\r RSSI=3D%d LOW=3D%d HIGH=3D%d STATE=3D%d", - pHalData->UndecoratedSmoothedPWDB, DM_DigTable.RssiLowThresh, - DM_DigTable.RssiHighThresh, DM_DigTable.Dig_State);*/ - /* 1. When RSSI decrease, We have to judge if it is smaller than a thresh= old + /* DbgPrint("Dig by Fw False Alarm\n"); + * if (DM_DigTable.Dig_State =3D=3D DM_STA_DIG_OFF) + * DbgPrint("DIG Check\n\r RSSI=3D%d LOW=3D%d HIGH=3D%d STATE=3D%d", + * pHalData->UndecoratedSmoothedPWDB, DM_DigTable.RssiLowThresh, + * DM_DigTable.RssiHighThresh, DM_DigTable.Dig_State); + * 1. When RSSI decrease, We have to judge if it is smaller than a thresh= old * and then execute the step below. */ if (priv->undecorated_smoothed_pwdb <=3D dm_digtable.rssi_low_thresh) { @@ -1757,12 +1764,12 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alar= m( * 2008/02/05 MH SD3-Jerry 92U/92E PD_TH are the same. */ write_nic_byte(dev, (rOFDM0_XATxAFE+3), 0x00); - /*else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) - write_nic_byte(pAdapter, rOFDM0_RxDetector1, 0x40); - else if (pAdapter->HardwareType =3D=3D HARDWARE_TYPE_RTL8192E) - else - PlatformEFIOWrite1Byte(pAdapter, rOFDM0_RxDetector1, 0x40); - */ + /* else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) + * write_nic_byte(pAdapter, rOFDM0_RxDetector1, 0x40); + * else if (pAdapter->HardwareType =3D=3D HARDWARE_TYPE_RTL8192E) + * else + * PlatformEFIOWrite1Byte(pAdapter, rOFDM0_RxDetector1, 0x40); + */ } else write_nic_byte(dev, rOFDM0_RxDetector1, 0x42); =20 @@ -1814,13 +1821,12 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alar= m( * 2008/02/05 MH SD3-Jerry 92U/92E PD_TH are the same. */ write_nic_byte(dev, (rOFDM0_XATxAFE+3), 0x20); - /* - else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) - write_nic_byte(dev, rOFDM0_RxDetector1, 0x42); - else if (pAdapter->HardwareType =3D=3D HARDWARE_TYPE_RTL8192E) - else - PlatformEFIOWrite1Byte(pAdapter, rOFDM0_RxDetector1, 0x42); - */ + /* else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) + * write_nic_byte(dev, rOFDM0_RxDetector1, 0x42); + * else if (pAdapter->HardwareType =3D=3D HARDWARE_TYPE_RTL8192E) + * else + * PlatformEFIOWrite1Byte(pAdapter, rOFDM0_RxDetector1, 0x42); + */ } else write_nic_byte(dev, rOFDM0_RxDetector1, 0x44); =20 @@ -1855,7 +1861,8 @@ static void dm_ctrl_initgain_byrssi_by_fwfalse_alarm( * When Who Remark * 05/28/2008 amy Create Version 0 porting from windows code. * - *------------------------------------------------------------------------= ---*/ + *------------------------------------------------------------------------= --- + */ static void dm_ctrl_initgain_byrssi_highpwr( struct net_device *dev) { @@ -1882,9 +1889,9 @@ static void dm_ctrl_initgain_byrssi_highpwr( if (priv->CurrentChannelBW !=3D HT_CHANNEL_WIDTH_20) { write_nic_byte(dev, (rOFDM0_XATxAFE+3), 0x10); =20 - /*else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) - write_nic_byte(dev, rOFDM0_RxDetector1, 0x41); - */ + /* else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) + * write_nic_byte(dev, rOFDM0_RxDetector1, 0x41); + */ =20 } else write_nic_byte(dev, rOFDM0_RxDetector1, 0x43); @@ -1899,9 +1906,9 @@ static void dm_ctrl_initgain_byrssi_highpwr( /* 3.2 Recover PD_TH for OFDM for normal power region. */ if (priv->CurrentChannelBW !=3D HT_CHANNEL_WIDTH_20) { write_nic_byte(dev, (rOFDM0_XATxAFE+3), 0x20); - /*else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) - write_nic_byte(dev, rOFDM0_RxDetector1, 0x42); - */ + /* else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) + * write_nic_byte(dev, rOFDM0_RxDetector1, 0x42); + */ =20 } else write_nic_byte(dev, rOFDM0_RxDetector1, 0x44); @@ -2020,9 +2027,9 @@ static void dm_pd_th( * 2008/02/05 MH SD3-Jerry 92U/92E PD_TH are the same. */ write_nic_byte(dev, (rOFDM0_XATxAFE+3), 0x00); - /*else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) - write_nic_byte(dev, rOFDM0_RxDetector1, 0x40); - */ + /* else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) + * write_nic_byte(dev, rOFDM0_RxDetector1, 0x40); + */ } else write_nic_byte(dev, rOFDM0_RxDetector1, 0x42); } else if (dm_digtable.curpd_thstate =3D=3D DIG_PD_AT_NORMAL_POWER) { @@ -2032,18 +2039,18 @@ static void dm_pd_th( * 2008/02/05 MH SD3-Jerry 92U/92E PD_TH are the same. */ write_nic_byte(dev, (rOFDM0_XATxAFE+3), 0x20); - /*else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) - write_nic_byte(dev, rOFDM0_RxDetector1, 0x42); - */ + /* else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) + * write_nic_byte(dev, rOFDM0_RxDetector1, 0x42); + */ } else write_nic_byte(dev, rOFDM0_RxDetector1, 0x44); } else if (dm_digtable.curpd_thstate =3D=3D DIG_PD_AT_HIGH_POWER) { /* Higher PD_TH for OFDM for high power state. */ if (priv->CurrentChannelBW !=3D HT_CHANNEL_WIDTH_20) { write_nic_byte(dev, (rOFDM0_XATxAFE+3), 0x10); - /*else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) - write_nic_byte(dev, rOFDM0_RxDetector1, 0x41); - */ + /* else if (priv->card_8192 =3D=3D HARDWARE_TYPE_RTL8190P) + * write_nic_byte(dev, rOFDM0_RxDetector1, 0x41); + */ } else write_nic_byte(dev, rOFDM0_RxDetector1, 0x43); } @@ -2274,7 +2281,8 @@ static void dm_ctstoself(struct net_device *dev) * When Who Remark * 05/28/2008 amy Create Version 0 porting from windows code. * - *------------------------------------------------------------------------= ---*/ + *------------------------------------------------------------------------= --- + */ static void dm_check_pbc_gpio(struct net_device *dev) { struct r8192_priv *priv =3D ieee80211_priv(dev); @@ -2308,7 +2316,8 @@ static void dm_check_pbc_gpio(struct net_device *dev) * When Who Remark * 01/30/2008 MHC Create Version 0. * - *------------------------------------------------------------------------= ---*/ + *------------------------------------------------------------------------= --- + */ void dm_rf_pathcheck_workitemcallback(struct work_struct *work) { struct delayed_work *dwork =3D to_delayed_work(work); @@ -2557,7 +2566,8 @@ static void dm_rxpath_sel_byrssi(struct net_device *d= ev) * When Who Remark * 05/28/2008 amy Create Version 0 porting from windows code. * - *------------------------------------------------------------------------= ---*/ + *------------------------------------------------------------------------= --- + */ static void dm_check_rx_path_selection(struct net_device *dev) { struct r8192_priv *priv =3D ieee80211_priv(dev); --=20 2.34.1