lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [thread-next>] [day] [month] [year] [list]
Message-ID: <20240329-mac80211-kdoc-retval-v1-0-5e4d1ad6c250@quicinc.com>
Date: Fri, 29 Mar 2024 13:27:16 -0700
From: Jeff Johnson <quic_jjohnson@...cinc.com>
To: Johannes Berg <johannes@...solutions.net>,
        "David S. Miller"
	<davem@...emloft.net>,
        Eric Dumazet <edumazet@...gle.com>, Jakub Kicinski
	<kuba@...nel.org>,
        Paolo Abeni <pabeni@...hat.com>, Randy Dunlap
	<rdunlap@...radead.org>
CC: <linux-wireless@...r.kernel.org>, <netdev@...r.kernel.org>,
        <linux-kernel@...r.kernel.org>,
        Jeff Johnson <quic_jjohnson@...cinc.com>
Subject: [PATCH 0/2] wifi: mac80211: Fix mac80211.h kernel-doc issues

Once again my process to validate a Qualcomm Innovation Center patch
has exposed pre-existing kernel-doc issues in mac80211.h. I think I
had previously fixed all of the issues here, but that was before Randy
made me aware that I was missing some warnings which I'm now seeing
using -Wall.

One of the issues was for a function which has a prototype but which
doesn't have an implementation, so just delete that one.

---
Jeff Johnson (2):
      wifi: mac80211: remove ieee80211_set_hw_80211_encap()
      wifi: mac80211: Add missing return value documentation

 include/net/mac80211.h | 50 ++++++++++++++++++++++++++++++--------------------
 1 file changed, 30 insertions(+), 20 deletions(-)
---
base-commit: 8ea3f4f1a1b4242d5fc273f41aa7c86f6b40178c
change-id: 20240329-mac80211-kdoc-retval-de18b807d7b9


X-sender: <linux-wireless+bounces-5624-peter.schumann=secunet.com@...r.kernel.org>
X-Receiver: <peter.schumann@...unet.com> ORCPT=rfc822;peter.schumann@...unet.com NOTIFY=NEVER; X-ExtendedProps=BQAVABYAAgAAAAUAFAARAJ05ab4WgQhHsqdZ7WUjHykPADUAAABNaWNyb3NvZnQuRXhjaGFuZ2UuVHJhbnNwb3J0LkRpcmVjdG9yeURhdGEuSXNSZXNvdXJjZQIAAAUAagAJAAEAAAAAAAAABQAWAAIAAAUAQwACAAAFAEYABwADAAAABQBHAAIAAAUAEgAPAGAAAAAvbz1zZWN1bmV0L291PUV4Y2hhbmdlIEFkbWluaXN0cmF0aXZlIEdyb3VwIChGWURJQk9IRjIzU1BETFQpL2NuPVJlY2lwaWVudHMvY249UGV0ZXIgU2NodW1hbm41ZTcFAAsAFwC+AAAAQ5IZ35DtBUiRVnd98bETxENOPURCNCxDTj1EYXRhYmFzZXMsQ049RXhjaGFuZ2UgQWRtaW5pc3RyYXRpdmUgR3JvdXAgKEZZRElCT0hGMjNTUERMVCksQ049QWRtaW5pc3RyYXRpdmUgR3JvdXBzLENOPXNlY3VuZXQsQ049TWljcm9zb2Z0IEV4Y2hhbmdlLENOPVNlcnZpY2VzLENOPUNvbmZpZ3VyYXRpb24sREM9c2VjdW5ldCxEQz1kZQUADgARAC7JU/le071Fhs0mWv1VtVsFAB0ADwAMAAAAbWJ4LWVzc2VuLTAxBQA8AAIAAA8ANgAAAE1pY3Jvc29mdC5FeGNoYW5nZS5UcmFuc3BvcnQuTWFpbFJlY2lwaWVudC5EaXNwbGF5TmFtZQ8ADwAAAFNjaHVtYW5uLCBQZXRlcgUADAACAAAFAGwAAgAABQBYABcASAAAAJ05ab4WgQhHsqdZ7WUjHylDTj1TY2h1bWFubiBQZXRlcixPVT1Vc2VycyxPVT1NaWdyYXRpb24sREM9c2VjdW5ldCxEQz1kZQUAJgACAAEFACIADwAxAAAAQXV0b1Jlc3BvbnNlU3VwcHJlc3M6IDANClRyYW5zbWl0SGlzdG9yeTogRmFsc2UNCg8ALwAAAE1pY3Jvc29mdC5FeGNoYW5nZS5UcmFuc3BvcnQuRXhwYW5zaW9uR3JvdXBUeXBlDwAVAAAATWVtYmVyc0dyb3VwRXhwYW5zaW9uBQAjAAIAAQ==
X-CreatedBy: MSExchange15
X-HeloDomain: a.mx.secunet.com
X-ExtendedProps: BQBjAAoAw0WmlidQ3AgFAGEACAABAAAABQA3AAIAAA8APAAAAE1pY3Jvc29mdC5FeGNoYW5nZS5UcmFuc3BvcnQuTWFpbFJlY2lwaWVudC5Pcmdhbml6YXRpb25TY29wZREAAAAAAAAAAAAAAAAAAAAAAAUASQACAAEFAAQAFCABAAAAGgAAAHBldGVyLnNjaHVtYW5uQHNlY3VuZXQuY29tBQAGAAIAAQUAKQACAAEPAAkAAABDSUF1ZGl0ZWQCAAEFAAIABwABAAAABQADAAcAAAAAAAUABQACAAEFAGIACgBnAAAAy4oAAAUAZAAPAAMAAABIdWI=
X-Source: SMTP:Default MBX-ESSEN-02
X-SourceIPAddress: 62.96.220.36
X-EndOfInjectedXHeaders: 12036
Received: from cas-essen-01.secunet.de (10.53.40.201) by
 mbx-essen-02.secunet.de (10.53.40.198) with Microsoft SMTP Server
 (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id
 15.1.2507.37; Fri, 29 Mar 2024 21:28:20 +0100
Received: from a.mx.secunet.com (62.96.220.36) by cas-essen-01.secunet.de
 (10.53.40.201) with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35 via Frontend
 Transport; Fri, 29 Mar 2024 21:28:20 +0100
Received: from localhost (localhost [127.0.0.1])
	by a.mx.secunet.com (Postfix) with ESMTP id 4DF972087C
	for <peter.schumann@...unet.com>; Fri, 29 Mar 2024 21:28:20 +0100 (CET)
X-Virus-Scanned: by secunet
X-Spam-Flag: NO
X-Spam-Score: -5.051
X-Spam-Level:
X-Spam-Status: No, score=-5.051 tagged_above=-999 required=2.1
	tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1,
	DKIM_VALID_AU=-0.1, HEADER_FROM_DIFFERENT_DOMAINS=0.249,
	MAILING_LIST_MULTI=-1, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001,
	SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: a.mx.secunet.com (amavisd-new);
	dkim=pass (2048-bit key) header.d=quicinc.com
Received: from a.mx.secunet.com ([127.0.0.1])
	by localhost (a.mx.secunet.com [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id VgejM7I3KT5B for <peter.schumann@...unet.com>;
	Fri, 29 Mar 2024 21:28:17 +0100 (CET)
Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=139.178.88.99; helo=sv.mirrors.kernel.org; envelope-from=linux-wireless+bounces-5624-peter.schumann=secunet.com@...r.kernel.org; receiver=peter.schumann@...unet.com 
DKIM-Filter: OpenDKIM Filter v2.11.0 a.mx.secunet.com A21642087B
Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org [139.178.88.99])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by a.mx.secunet.com (Postfix) with ESMTPS id A21642087B
	for <peter.schumann@...unet.com>; Fri, 29 Mar 2024 21:28:16 +0100 (CET)
Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by sv.mirrors.kernel.org (Postfix) with ESMTPS id 12681285D7D
	for <peter.schumann@...unet.com>; Fri, 29 Mar 2024 20:28:15 +0000 (UTC)
Received: from localhost.localdomain (localhost.localdomain [127.0.0.1])
	by smtp.subspace.kernel.org (Postfix) with ESMTP id 3573C13D257;
	Fri, 29 Mar 2024 20:27:37 +0000 (UTC)
Authentication-Results: smtp.subspace.kernel.org;
	dkim=pass (2048-bit key) header.d=quicinc.com header.i=@...cinc.com header.b="L8gRcOX1"
X-Original-To: linux-wireless@...r.kernel.org
Received: from mx0b-0031df01.pphosted.com (mx0b-0031df01.pphosted.com [205.220.180.131])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by smtp.subspace.kernel.org (Postfix) with ESMTPS id 148B013BC2E;
	Fri, 29 Mar 2024 20:27:34 +0000 (UTC)
Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.180.131
ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;
	t=1711744056; cv=none; b=OPBSKjFrF2w/aKYgriC1IBh2znuljYTNiT01Z6mT0viLFA0xBB0ZYLJKG0/Ja3AuvXXN3wyyLOWWizWI/LJB4m56eONH9Fs28ZZNQefAgtAR63FeTt2IwSXkMwnxCu7rdDXMaGwIjmA9yGcoljmpDmd4NMz0hf0UBlOke9h/Y3s=
ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org;
	s=arc-20240116; t=1711744056; c=relaxed/simple;
	bh=DmN7SbvHc83v86CT34JrU35maYPW9TcbhqkpKuMp20Y=;
	h=From:Subject:Date:Message-ID:MIME-Version:Content-Type:To:CC; b=H/bY0uIMvO9080riphCTnhAJyyCLI/j/xGw61vVnuhIf7UMYCAOMxUcSIrHrvlWPiv59BL8WxrWA+6dtvpp45DjpWY7lhZGjRcLAOYIhydsxyb6gcgixbZN+lKkPbHC6Bno7TVZ3mSTh8PNNJ1quw8AW/mJ6yUBnWhvyBiZFqkY=
ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=quicinc.com; spf=pass smtp.mailfrom=quicinc.com; dkim=pass (2048-bit key) header.d=quicinc.com header.i=@...cinc.com header.b=L8gRcOX1; arc=none smtp.client-ip=205.220.180.131
Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=quicinc.com
Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=quicinc.com
Received: from pps.filterd (m0279869.ppops.net [127.0.0.1])
	by mx0a-0031df01.pphosted.com (8.17.1.24/8.17.1.24) with ESMTP id 42TKODvm021226;
	Fri, 29 Mar 2024 20:27:20 GMT
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=quicinc.com; h=
	from:subject:date:message-id:mime-version:content-type
	:content-transfer-encoding:to:cc; s=qcppdkim1; bh=FA9/ZSidqDsn9N
	VYFrPdU6Qa0ODwOHndzWtzGX+s/uM=; b=L8gRcOX1nJQyvvw8Is1dU9SwHRjpR0
	rSAud7fuaXBCp2r/JHEPiVUfVmakPG2ntQupOiXnKxe8UVQSCcTKIhwuF6+6W4D1
	Sj9oMXYgCSxQs5AhJTUBFMKU/zXNdecykatd68XTV40/GOyC602wi6KWaFMFMbC+
	6LJ/91HDbxvcwffFVI+IsgByH2lkll+uAPVJOfFFLhq3/DPLI4IPZK2KJ0G1W7Ve
	pkTtSorFBxyknvra0hSbVx/pbszz69FMudR+QoaTZq2LBMlQb67T9BS77JFq42FX
	ZR7Hr1kyoAiegRhT9wfWOd5v6GqLqrEmEafEkKU4NMOvyfoq1fEBkiIw==
Received: from nalasppmta04.qualcomm.com (Global_NAT1.qualcomm.com [129.46.96.20])
	by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 3x5dkykc05-1
	(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);
	Fri, 29 Mar 2024 20:27:20 +0000 (GMT)
Received: from nalasex01a.na.qualcomm.com (nalasex01a.na.qualcomm.com [10.47.209.196])
	by NALASPPMTA04.qualcomm.com (8.17.1.5/8.17.1.5) with ESMTPS id 42TKRIYp018570
	(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);
	Fri, 29 Mar 2024 20:27:18 GMT
Received: from [169.254.0.1] (10.49.16.6) by nalasex01a.na.qualcomm.com
 (10.47.209.196) with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1118.40; Fri, 29 Mar
 2024 13:27:18 -0700
From: Jeff Johnson <quic_jjohnson@...cinc.com>
Subject: [PATCH 0/2] wifi: mac80211: Fix mac80211.h kernel-doc issues
Date: Fri, 29 Mar 2024 13:27:16 -0700
Message-ID: <20240329-mac80211-kdoc-retval-v1-0-5e4d1ad6c250@...cinc.com>
Precedence: bulk
X-Mailing-List: linux-wireless@...r.kernel.org
List-Id: <linux-wireless.vger.kernel.org>
List-Subscribe: <mailto:linux-wireless+subscribe@...r.kernel.org>
List-Unsubscribe: <mailto:linux-wireless+unsubscribe@...r.kernel.org>
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
X-B4-Tracking: v=1; b=H4sIACQkB2YC/x3MTQrCQAxA4auUrA3MjEKnXkVczE+0wTqVpFSh9
 O5Gl9/ivQ2UhEnh3G0gtLLy3Az+0EEZU7sTcjVDcOHkjmHAZyrRBe/xUeeCQsuaJqzkY46ur30
 ewNKX0I0//+3las5JCbOkVsbf7M1CE6najBvs+xeSJLS4hgAAAA==
To: Johannes Berg <johannes@...solutions.net>,
        "David S. Miller"
	<davem@...emloft.net>,
        Eric Dumazet <edumazet@...gle.com>, Jakub Kicinski
	<kuba@...nel.org>,
        Paolo Abeni <pabeni@...hat.com>, Randy Dunlap
	<rdunlap@...radead.org>
CC: <linux-wireless@...r.kernel.org>, <netdev@...r.kernel.org>,
        <linux-kernel@...r.kernel.org>,
        Jeff Johnson <quic_jjohnson@...cinc.com>
X-Mailer: b4 0.13.0
X-ClientProxiedBy: nalasex01b.na.qualcomm.com (10.47.209.197) To
 nalasex01a.na.qualcomm.com (10.47.209.196)
X-QCInternal: smtphost
X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=5800 signatures=585085
X-Proofpoint-ORIG-GUID: cxJzS-vHLDcJd2RlKp36N6LAAiQgnjHC
X-Proofpoint-GUID: cxJzS-vHLDcJd2RlKp36N6LAAiQgnjHC
X-Proofpoint-Virus-Version: vendor=baseguard
 engine=ICAP:2.0.272,Aquarius:18.0.1011,Hydra:6.0.619,FMLib:17.11.176.26
 definitions=2024-03-29_13,2024-03-28_01,2023-05-22_02
X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 mlxlogscore=367 mlxscore=0
 phishscore=0 lowpriorityscore=0 suspectscore=0 spamscore=0 impostorscore=0
 priorityscore=1501 bulkscore=0 clxscore=1011 malwarescore=0 adultscore=0
 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.19.0-2403210001
 definitions=main-2403290183
Return-Path: linux-wireless+bounces-5624-peter.schumann=secunet.com@...r.kernel.org
X-MS-Exchange-Organization-OriginalArrivalTime: 29 Mar 2024 20:28:20.3319
 (UTC)
X-MS-Exchange-Organization-Network-Message-Id: 7aeda0bf-bd8a-47e0-177e-08dc502ec62d
X-MS-Exchange-Organization-OriginalClientIPAddress: 62.96.220.36
X-MS-Exchange-Organization-OriginalServerIPAddress: 10.53.40.201
X-MS-Exchange-Organization-Cross-Premises-Headers-Processed: cas-essen-01.secunet.de
X-MS-Exchange-Organization-OrderedPrecisionLatencyInProgress: LSRV=mbx-essen-02.secunet.de:TOTAL-HUB=0.185|SMR=0.142(SMRDE=0.003|SMRC=0.139(SMRCL=0.103|X-SMRCR=0.138))|CAT=0.041(CATRESL=0.022
 (CATRESLP2R=0.002)|CATORES=0.016(CATRS=0.016(CATRS-Index Routing
 Agent=0.015)));2024-03-29T20:28:20.531Z
X-MS-Exchange-Forest-ArrivalHubServer: mbx-essen-02.secunet.de
X-MS-Exchange-Organization-AuthSource: cas-essen-01.secunet.de
X-MS-Exchange-Organization-AuthAs: Anonymous
X-MS-Exchange-Organization-FromEntityHeader: Internet
X-MS-Exchange-Organization-OriginalSize: 9265
X-MS-Exchange-Organization-HygienePolicy: Standard
X-MS-Exchange-Organization-MessageLatency: SRV=cas-essen-01.secunet.de:TOTAL-FE=0.014|SMR=0.008(SMRPI=0.006(SMRPI-FrontendProxyAgent=0.005))|SMS=0.005
X-MS-Exchange-Organization-Recipient-Limit-Verified: True
X-MS-Exchange-Organization-TotalRecipientCount: 1
X-MS-Exchange-Organization-Rules-Execution-History: 0b0cf904-14ac-4724-8bdf-482ee6223cf2%%%fd34672d-751c-45ae-a963-ed177fcabe23%%%d8080257-b0c3-47b4-b0db-23bc0c8ddb3c%%%95e591a2-5d7d-4afa-b1d0-7573d6c0a5d9%%%f7d0f6bc-4dcc-4876-8c5d-b3d6ddbb3d55%%%16355082-c50b-4214-9c7d-d39575f9f79b
X-MS-Exchange-Forest-RulesExecuted: mbx-essen-02
X-MS-Exchange-Organization-RulesExecuted: mbx-essen-02
X-MS-Exchange-Forest-IndexAgent-0: AQ0CZW4AAc8CAAAPAAADH4sIAAAAAAAEAH1STU/bQBRcB/JlcKnaaw
 /vBoEY4hBIyK3qKVxQe+kRbexn7GLvRt41Aan/rH+u4zXQqmrrw+p9
 zszO+kfvRsVM8k7mison2lQ6ZmPIanqQRZ5IiyZ9rmUR67KklVL6Qd
 pcK/rEynJFG2njLPAzaYgfN9pwAgwO+TE3Nld3dM+V4iJMdEy5MTUb
 aohkvJhMo+g0O6UV2SxX97RqQNzyQ65rUzxRmj8CTRYF6RRD/AKQcc
 VjWtcWRWlpC+o1p7pi+iJV8hT4pUyYSgjfShTd0MqNlUBoRBmNLpoK
 iaFtlscZrQ5LUnpLhhnVwK/dZPgV/KeBH/g3iv/Q0SCCFv6ktYqdKS
 1UY4ZsrLTaPm3YSXWdwE80G3VoMfIAfYryclNwCSudqWMoo2+1sZRw
 wfZZu1bsFIRhGPjXnKZ0rTNlQHc0HS0Dn9y3zdN8+erskiouNThyZn
 aVW8P2NtvetgmrWG6ORv9a/pgkr2ZVbOtKNb9DzYR3rF/lNqLwnHFR
 J3ym2J79elf6ThcTOvnvF/7lA2CEhy+Y4kyqO07GdD4Bh+GqYTRHJ6
 MxTSetP64Qjp6dWUvDYfOX5nZJC5bn6SyNZLSeTWfT5CKNp3NUIinn
 8eIyvVzPJtF8EQd+yxPmyRK409nkfHoVvtwjvMd9QxiAy4cJR4v1Yj
 JP5uur5uaBL8Su6HZFryN2+mKAcyCGnujg9MVeT/S7or8jdtHa8cS+
 2EW95wnfFdF9mUezAxAEqGMRMYKOSzG261IQtWm3qXTRxRgC7LYUiI
 HW7rrJgZsc/g7VtlqF7STiofARYLgFwfAb8RYnYscO3gBn34NU4Yk9
 6BkIHy3kH9xux4MYAcCuOGi7rSSntheId40D7vqeBzGi4y0cVKeFbS
 pix/cO2mAo3kPWXsM+OBLH8GUIrzysi4EnjsUQOK22/Z/UPO85vQQA
 AAEOzgFSZXRyaWV2ZXJPcGVyYXRvciwxMCwwO1JldHJpZXZlck9wZX
 JhdG9yLDExLDE7UG9zdERvY1BhcnNlck9wZXJhdG9yLDEwLDA7UG9z
 dERvY1BhcnNlck9wZXJhdG9yLDExLDA7UG9zdFdvcmRCcmVha2VyRG
 lhZ25vc3RpY09wZXJhdG9yLDEwLDA7UG9zdFdvcmRCcmVha2VyRGlh
 Z25vc3RpY09wZXJhdG9yLDExLDA7VHJhbnNwb3J0V3JpdGVyUHJvZH VjZXIsMjAsNw==
X-MS-Exchange-Forest-IndexAgent: 1 940
X-MS-Exchange-Forest-EmailMessageHash: 0EED6740
X-MS-Exchange-Forest-Language: en
X-MS-Exchange-Organization-Processed-By-Journaling: Journal Agent

Once again my process to validate a Qualcomm Innovation Center patch
has exposed pre-existing kernel-doc issues in mac80211.h. I think I
had previously fixed all of the issues here, but that was before Randy
made me aware that I was missing some warnings which I'm now seeing
using -Wall.

One of the issues was for a function which has a prototype but which
doesn't have an implementation, so just delete that one.

---
Jeff Johnson (2):
      wifi: mac80211: remove ieee80211_set_hw_80211_encap()
      wifi: mac80211: Add missing return value documentation

 include/net/mac80211.h | 50 ++++++++++++++++++++++++++++++--------------------
 1 file changed, 30 insertions(+), 20 deletions(-)
---
base-commit: 8ea3f4f1a1b4242d5fc273f41aa7c86f6b40178c
change-id: 20240329-mac80211-kdoc-retval-de18b807d7b9


X-sender: <linux-kernel+bounces-125390-steffen.klassert=secunet.com@...r.kernel.org>
X-Receiver: <steffen.klassert@...unet.com> ORCPT=rfc822;steffen.klassert@...unet.com NOTIFY=NEVER; X-ExtendedProps=BQAVABYAAgAAAAUAFAARAPDFCS25BAlDktII2g02frgPADUAAABNaWNyb3NvZnQuRXhjaGFuZ2UuVHJhbnNwb3J0LkRpcmVjdG9yeURhdGEuSXNSZXNvdXJjZQIAAAUAagAJAAEAAAAAAAAABQAWAAIAAAUAQwACAAAFAEYABwADAAAABQBHAAIAAAUAEgAPAGIAAAAvbz1zZWN1bmV0L291PUV4Y2hhbmdlIEFkbWluaXN0cmF0aXZlIEdyb3VwIChGWURJQk9IRjIzU1BETFQpL2NuPVJlY2lwaWVudHMvY249U3RlZmZlbiBLbGFzc2VydDY4YwUACwAXAL4AAACheZxkHSGBRqAcAp3ukbifQ049REI2LENOPURhdGFiYXNlcyxDTj1FeGNoYW5nZSBBZG1pbmlzdHJhdGl2ZSBHcm91cCAoRllESUJPSEYyM1NQRExUKSxDTj1BZG1pbmlzdHJhdGl2ZSBHcm91cHMsQ049c2VjdW5ldCxDTj1NaWNyb3NvZnQgRXhjaGFuZ2UsQ049U2VydmljZXMsQ049Q29uZmlndXJhdGlvbixEQz1zZWN1bmV0LERDPWRlBQAOABEABiAS9uuMOkqzwmEZDvWNNQUAHQAPAAwAAABtYngtZXNzZW4tMDIFADwAAgAADwA2AAAATWljcm9zb2Z0LkV4Y2hhbmdlLlRyYW5zcG9ydC5NYWlsUmVjaXBpZW50LkRpc3BsYXlOYW1lDwARAAAAS2xhc3NlcnQsIFN0ZWZmZW4FAAwAAgAABQBsAAIAAAUAWAAXAEoAAADwxQktuQQJQ5LSCNoNNn64Q049S2xhc3NlcnQgU3RlZmZlbixPVT1Vc2VycyxPVT1NaWdyYXRpb24sREM9c2VjdW5ldCxEQz1kZQUAJgACAAEFACIADwAxAAAAQXV0b1Jlc3BvbnNlU3VwcHJlc3M6IDANClRyYW5zbWl0SGlzdG9yeTogRmFsc2UNCg8ALwAAAE1pY3Jvc29mdC5FeGNoYW5nZS5UcmFuc3BvcnQuRXhwYW5zaW9uR3JvdXBUeXBlDwAVAAAATWVtYmVyc0dyb3VwRXhwYW5zaW9uBQAjAAIAAQ==
X-CreatedBy: MSExchange15
X-HeloDomain: b.mx.secunet.com
X-ExtendedProps: BQBjAAoAw0WmlidQ3AgFAGEACAABAAAABQA3AAIAAA8APAAAAE1pY3Jvc29mdC5FeGNoYW5nZS5UcmFuc3BvcnQuTWFpbFJlY2lwaWVudC5Pcmdhbml6YXRpb25TY29wZREAAAAAAAAAAAAAAAAAAAAAAAUASQACAAEFAAQAFCABAAAAHAAAAHN0ZWZmZW4ua2xhc3NlcnRAc2VjdW5ldC5jb20FAAYAAgABBQApAAIAAQ8ACQAAAENJQXVkaXRlZAIAAQUAAgAHAAEAAAAFAAMABwAAAAAABQAFAAIAAQUAYgAKAGsAAADLigAABQBkAA8AAwAAAEh1Yg==
X-Source: SMTP:Default MBX-ESSEN-02
X-SourceIPAddress: 62.96.220.37
X-EndOfInjectedXHeaders: 12218
Received: from cas-essen-01.secunet.de (10.53.40.201) by
 mbx-essen-02.secunet.de (10.53.40.198) with Microsoft SMTP Server
 (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id
 15.1.2507.37; Fri, 29 Mar 2024 21:28:40 +0100
Received: from b.mx.secunet.com (62.96.220.37) by cas-essen-01.secunet.de
 (10.53.40.201) with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35 via Frontend
 Transport; Fri, 29 Mar 2024 21:28:40 +0100
Received: from localhost (localhost [127.0.0.1])
	by b.mx.secunet.com (Postfix) with ESMTP id 467CD2032C
	for <steffen.klassert@...unet.com>; Fri, 29 Mar 2024 21:28:40 +0100 (CET)
X-Virus-Scanned: by secunet
X-Spam-Flag: NO
X-Spam-Score: -2.751
X-Spam-Level:
X-Spam-Status: No, score=-2.751 tagged_above=-999 required=2.1
	tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1,
	DKIM_VALID_AU=-0.1, HEADER_FROM_DIFFERENT_DOMAINS=0.249,
	MAILING_LIST_MULTI=-1, RCVD_IN_DNSWL_NONE=-0.0001,
	SPF_HELO_NONE=0.001, SPF_PASS=-0.001]
	autolearn=unavailable autolearn_force=no
Authentication-Results: a.mx.secunet.com (amavisd-new);
	dkim=pass (2048-bit key) header.d=quicinc.com
Received: from b.mx.secunet.com ([127.0.0.1])
	by localhost (a.mx.secunet.com [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id Flb3RkhXB_Tm for <steffen.klassert@...unet.com>;
	Fri, 29 Mar 2024 21:28:39 +0100 (CET)
Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=147.75.48.161; helo=sy.mirrors.kernel.org; envelope-from=linux-kernel+bounces-125390-steffen.klassert=secunet.com@...r.kernel.org; receiver=steffen.klassert@...unet.com 
DKIM-Filter: OpenDKIM Filter v2.11.0 b.mx.secunet.com 469F120270
Authentication-Results: b.mx.secunet.com;
	dkim=pass (2048-bit key) header.d=quicinc.com header.i=@...cinc.com header.b="L8gRcOX1"
Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org [147.75.48.161])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by b.mx.secunet.com (Postfix) with ESMTPS id 469F120270
	for <steffen.klassert@...unet.com>; Fri, 29 Mar 2024 21:28:39 +0100 (CET)
Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by sy.mirrors.kernel.org (Postfix) with ESMTPS id 9BBEEB23B0F
	for <steffen.klassert@...unet.com>; Fri, 29 Mar 2024 20:28:35 +0000 (UTC)
Received: from localhost.localdomain (localhost.localdomain [127.0.0.1])
	by smtp.subspace.kernel.org (Postfix) with ESMTP id 0AE6E13DDCB;
	Fri, 29 Mar 2024 20:27:39 +0000 (UTC)
Authentication-Results: smtp.subspace.kernel.org;
	dkim=pass (2048-bit key) header.d=quicinc.com header.i=@...cinc.com header.b="L8gRcOX1"
Received: from mx0b-0031df01.pphosted.com (mx0b-0031df01.pphosted.com [205.220.180.131])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by smtp.subspace.kernel.org (Postfix) with ESMTPS id 148B013BC2E;
	Fri, 29 Mar 2024 20:27:34 +0000 (UTC)
Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.180.131
ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;
	t=1711744056; cv=none; b=OPBSKjFrF2w/aKYgriC1IBh2znuljYTNiT01Z6mT0viLFA0xBB0ZYLJKG0/Ja3AuvXXN3wyyLOWWizWI/LJB4m56eONH9Fs28ZZNQefAgtAR63FeTt2IwSXkMwnxCu7rdDXMaGwIjmA9yGcoljmpDmd4NMz0hf0UBlOke9h/Y3s=
ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org;
	s=arc-20240116; t=1711744056; c=relaxed/simple;
	bh=DmN7SbvHc83v86CT34JrU35maYPW9TcbhqkpKuMp20Y=;
	h=From:Subject:Date:Message-ID:MIME-Version:Content-Type:To:CC; b=H/bY0uIMvO9080riphCTnhAJyyCLI/j/xGw61vVnuhIf7UMYCAOMxUcSIrHrvlWPiv59BL8WxrWA+6dtvpp45DjpWY7lhZGjRcLAOYIhydsxyb6gcgixbZN+lKkPbHC6Bno7TVZ3mSTh8PNNJ1quw8AW/mJ6yUBnWhvyBiZFqkY=
ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=quicinc.com; spf=pass smtp.mailfrom=quicinc.com; dkim=pass (2048-bit key) header.d=quicinc.com header.i=@...cinc.com header.b=L8gRcOX1; arc=none smtp.client-ip=205.220.180.131
Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=quicinc.com
Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=quicinc.com
Received: from pps.filterd (m0279869.ppops.net [127.0.0.1])
	by mx0a-0031df01.pphosted.com (8.17.1.24/8.17.1.24) with ESMTP id 42TKODvm021226;
	Fri, 29 Mar 2024 20:27:20 GMT
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=quicinc.com; h=
	from:subject:date:message-id:mime-version:content-type
	:content-transfer-encoding:to:cc; s=qcppdkim1; bh=FA9/ZSidqDsn9N
	VYFrPdU6Qa0ODwOHndzWtzGX+s/uM=; b=L8gRcOX1nJQyvvw8Is1dU9SwHRjpR0
	rSAud7fuaXBCp2r/JHEPiVUfVmakPG2ntQupOiXnKxe8UVQSCcTKIhwuF6+6W4D1
	Sj9oMXYgCSxQs5AhJTUBFMKU/zXNdecykatd68XTV40/GOyC602wi6KWaFMFMbC+
	6LJ/91HDbxvcwffFVI+IsgByH2lkll+uAPVJOfFFLhq3/DPLI4IPZK2KJ0G1W7Ve
	pkTtSorFBxyknvra0hSbVx/pbszz69FMudR+QoaTZq2LBMlQb67T9BS77JFq42FX
	ZR7Hr1kyoAiegRhT9wfWOd5v6GqLqrEmEafEkKU4NMOvyfoq1fEBkiIw==
Received: from nalasppmta04.qualcomm.com (Global_NAT1.qualcomm.com [129.46.96.20])
	by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 3x5dkykc05-1
	(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);
	Fri, 29 Mar 2024 20:27:20 +0000 (GMT)
Received: from nalasex01a.na.qualcomm.com (nalasex01a.na.qualcomm.com [10.47.209.196])
	by NALASPPMTA04.qualcomm.com (8.17.1.5/8.17.1.5) with ESMTPS id 42TKRIYp018570
	(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);
	Fri, 29 Mar 2024 20:27:18 GMT
Received: from [169.254.0.1] (10.49.16.6) by nalasex01a.na.qualcomm.com
 (10.47.209.196) with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1118.40; Fri, 29 Mar
 2024 13:27:18 -0700
From: Jeff Johnson <quic_jjohnson@...cinc.com>
Subject: [PATCH 0/2] wifi: mac80211: Fix mac80211.h kernel-doc issues
Date: Fri, 29 Mar 2024 13:27:16 -0700
Message-ID: <20240329-mac80211-kdoc-retval-v1-0-5e4d1ad6c250@...cinc.com>
Precedence: bulk
X-Mailing-List: linux-kernel@...r.kernel.org
List-Id: <linux-kernel.vger.kernel.org>
List-Subscribe: <mailto:linux-kernel+subscribe@...r.kernel.org>
List-Unsubscribe: <mailto:linux-kernel+unsubscribe@...r.kernel.org>
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
X-B4-Tracking: v=1; b=H4sIACQkB2YC/x3MTQrCQAxA4auUrA3MjEKnXkVczE+0wTqVpFSh9
 O5Gl9/ivQ2UhEnh3G0gtLLy3Az+0EEZU7sTcjVDcOHkjmHAZyrRBe/xUeeCQsuaJqzkY46ur30
 ewNKX0I0//+3las5JCbOkVsbf7M1CE6najBvs+xeSJLS4hgAAAA==
To: Johannes Berg <johannes@...solutions.net>,
        "David S. Miller"
	<davem@...emloft.net>,
        Eric Dumazet <edumazet@...gle.com>, Jakub Kicinski
	<kuba@...nel.org>,
        Paolo Abeni <pabeni@...hat.com>, Randy Dunlap
	<rdunlap@...radead.org>
CC: <linux-wireless@...r.kernel.org>, <netdev@...r.kernel.org>,
        <linux-kernel@...r.kernel.org>,
        Jeff Johnson <quic_jjohnson@...cinc.com>
X-Mailer: b4 0.13.0
X-ClientProxiedBy: nalasex01b.na.qualcomm.com (10.47.209.197) To
 nalasex01a.na.qualcomm.com (10.47.209.196)
X-QCInternal: smtphost
X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=5800 signatures=585085
X-Proofpoint-ORIG-GUID: cxJzS-vHLDcJd2RlKp36N6LAAiQgnjHC
X-Proofpoint-GUID: cxJzS-vHLDcJd2RlKp36N6LAAiQgnjHC
X-Proofpoint-Virus-Version: vendor=baseguard
 engine=ICAP:2.0.272,Aquarius:18.0.1011,Hydra:6.0.619,FMLib:17.11.176.26
 definitions=2024-03-29_13,2024-03-28_01,2023-05-22_02
X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 mlxlogscore=367 mlxscore=0
 phishscore=0 lowpriorityscore=0 suspectscore=0 spamscore=0 impostorscore=0
 priorityscore=1501 bulkscore=0 clxscore=1011 malwarescore=0 adultscore=0
 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.19.0-2403210001
 definitions=main-2403290183
Return-Path: linux-kernel+bounces-125390-steffen.klassert=secunet.com@...r.kernel.org
X-MS-Exchange-Organization-OriginalArrivalTime: 29 Mar 2024 20:28:40.3174
 (UTC)
X-MS-Exchange-Organization-Network-Message-Id: 8503ecc5-4503-48b6-ca2f-08dc502ed216
X-MS-Exchange-Organization-OriginalClientIPAddress: 62.96.220.37
X-MS-Exchange-Organization-OriginalServerIPAddress: 10.53.40.201
X-MS-Exchange-Organization-Cross-Premises-Headers-Processed: cas-essen-01.secunet.de
X-MS-Exchange-Organization-OrderedPrecisionLatencyInProgress: LSRV=mbx-essen-02.secunet.de:TOTAL-HUB=0.196|SMR=0.139(SMRDE=0.003|SMRC=0.135(SMRCL=0.102|X-SMRCR=0.134))|CAT=0.056(CATOS=0.001
 |CATRESL=0.029(CATRESLP2R=0.004)|CATORES=0.022(CATRS=0.022(CATRS-Transport
 Rule Agent=0.001 (X-ETREX=0.001)|CATRS-Index Routing
 Agent=0.018))|CATORT=0.001);2024-03-29T20:28:40.529Z
X-MS-Exchange-Forest-ArrivalHubServer: mbx-essen-02.secunet.de
X-MS-Exchange-Organization-AuthSource: cas-essen-01.secunet.de
X-MS-Exchange-Organization-AuthAs: Anonymous
X-MS-Exchange-Organization-FromEntityHeader: Internet
X-MS-Exchange-Organization-OriginalSize: 9371
X-MS-Exchange-Organization-HygienePolicy: Standard
X-MS-Exchange-Organization-MessageLatency: SRV=cas-essen-01.secunet.de:TOTAL-FE=0.015|SMR=0.008(SMRPI=0.005(SMRPI-FrontendProxyAgent=0.005))|SMS=0.007
X-MS-Exchange-Organization-Recipient-Limit-Verified: True
X-MS-Exchange-Organization-TotalRecipientCount: 1
X-MS-Exchange-Organization-Rules-Execution-History: 0b0cf904-14ac-4724-8bdf-482ee6223cf2%%%fd34672d-751c-45ae-a963-ed177fcabe23%%%d8080257-b0c3-47b4-b0db-23bc0c8ddb3c%%%95e591a2-5d7d-4afa-b1d0-7573d6c0a5d9%%%f7d0f6bc-4dcc-4876-8c5d-b3d6ddbb3d55%%%16355082-c50b-4214-9c7d-d39575f9f79b
X-MS-Exchange-Forest-RulesExecuted: mbx-essen-02
X-MS-Exchange-Organization-RulesExecuted: mbx-essen-02
X-MS-Exchange-Forest-IndexAgent-0: AQ0CZW4AAc8CAAAPAAADH4sIAAAAAAAEAH1STU/bQBRcB/JlcKnaaw
 /vBoEY4hBIyK3qKVxQe+kRbexn7GLvRt41Aan/rH+u4zXQqmrrw+p9
 zszO+kfvRsVM8k7mison2lQ6ZmPIanqQRZ5IiyZ9rmUR67KklVL6Qd
 pcK/rEynJFG2njLPAzaYgfN9pwAgwO+TE3Nld3dM+V4iJMdEy5MTUb
 aohkvJhMo+g0O6UV2SxX97RqQNzyQ65rUzxRmj8CTRYF6RRD/AKQcc
 VjWtcWRWlpC+o1p7pi+iJV8hT4pUyYSgjfShTd0MqNlUBoRBmNLpoK
 iaFtlscZrQ5LUnpLhhnVwK/dZPgV/KeBH/g3iv/Q0SCCFv6ktYqdKS
 1UY4ZsrLTaPm3YSXWdwE80G3VoMfIAfYryclNwCSudqWMoo2+1sZRw
 wfZZu1bsFIRhGPjXnKZ0rTNlQHc0HS0Dn9y3zdN8+erskiouNThyZn
 aVW8P2NtvetgmrWG6ORv9a/pgkr2ZVbOtKNb9DzYR3rF/lNqLwnHFR
 J3ym2J79elf6ThcTOvnvF/7lA2CEhy+Y4kyqO07GdD4Bh+GqYTRHJ6
 MxTSetP64Qjp6dWUvDYfOX5nZJC5bn6SyNZLSeTWfT5CKNp3NUIinn
 8eIyvVzPJtF8EQd+yxPmyRK409nkfHoVvtwjvMd9QxiAy4cJR4v1Yj
 JP5uur5uaBL8Su6HZFryN2+mKAcyCGnujg9MVeT/S7or8jdtHa8cS+
 2EW95wnfFdF9mUezAxAEqGMRMYKOSzG261IQtWm3qXTRxRgC7LYUiI
 HW7rrJgZsc/g7VtlqF7STiofARYLgFwfAb8RYnYscO3gBn34NU4Yk9
 6BkIHy3kH9xux4MYAcCuOGi7rSSntheId40D7vqeBzGi4y0cVKeFbS
 pix/cO2mAo3kPWXsM+OBLH8GUIrzysi4EnjsUQOK22/Z/UPO85vQQA
 AAEOzgFSZXRyaWV2ZXJPcGVyYXRvciwxMCwyO1JldHJpZXZlck9wZX
 JhdG9yLDExLDE7UG9zdERvY1BhcnNlck9wZXJhdG9yLDEwLDA7UG9z
 dERvY1BhcnNlck9wZXJhdG9yLDExLDA7UG9zdFdvcmRCcmVha2VyRG
 lhZ25vc3RpY09wZXJhdG9yLDEwLDA7UG9zdFdvcmRCcmVha2VyRGlh
 Z25vc3RpY09wZXJhdG9yLDExLDA7VHJhbnNwb3J0V3JpdGVyUHJvZH VjZXIsMjAsOA==
X-MS-Exchange-Forest-IndexAgent: 1 940
X-MS-Exchange-Forest-EmailMessageHash: 0EED6740
X-MS-Exchange-Forest-Language: en
X-MS-Exchange-Organization-Processed-By-Journaling: Journal Agent

Once again my process to validate a Qualcomm Innovation Center patch
has exposed pre-existing kernel-doc issues in mac80211.h. I think I
had previously fixed all of the issues here, but that was before Randy
made me aware that I was missing some warnings which I'm now seeing
using -Wall.

One of the issues was for a function which has a prototype but which
doesn't have an implementation, so just delete that one.

---
Jeff Johnson (2):
      wifi: mac80211: remove ieee80211_set_hw_80211_encap()
      wifi: mac80211: Add missing return value documentation

 include/net/mac80211.h | 50 ++++++++++++++++++++++++++++++--------------------
 1 file changed, 30 insertions(+), 20 deletions(-)
---
base-commit: 8ea3f4f1a1b4242d5fc273f41aa7c86f6b40178c
change-id: 20240329-mac80211-kdoc-retval-de18b807d7b9



Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ