From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.19]) (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 C83EF17B402; Sat, 26 Apr 2025 14:15:10 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=192.198.163.19 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1745676913; cv=none; b=selv9e9BS9lZKxWOOQeIdkA6lsPyMw+a38rYOmumFvUJGfu+NB3N3Xnj2LWagM6/f1gyCc3TZUpZT80KlToYALLp/8CJ/wN/FsDGSidscPNDFTEotw5B6aLJ6iysRb4SsnKdZbk1kk3dddf4u4qLUkoxeHs664LheHK+nThSgiQ= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1745676913; c=relaxed/simple; bh=KyPVCDaDId5iuitE9xSrLGPFmYffFbpjaVFQl6C9C90=; h=Date:From:To:Cc:Subject:Message-ID:MIME-Version:Content-Type: Content-Disposition; b=qapW5D4gnm1OJwms+UWwZ4Yf4BeNSErjtStewvX7kE0igeeQYn0SLjrbhJk+dPJ/oamyfMiMRCofkuRHaHhXPwcCtzbrATwQgxV6OU1HfxSuTzJMWVC5fB1ZUH8zSr9EOzWkVc4AUcP8mTypK77fn6gWO6/w8MtlDKLzg3OYLhY= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=intel.com; spf=pass smtp.mailfrom=intel.com; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b=UkcymXCu; arc=none smtp.client-ip=192.198.163.19 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=intel.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=intel.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b="UkcymXCu" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1745676911; x=1777212911; h=date:from:to:cc:subject:message-id:mime-version; bh=KyPVCDaDId5iuitE9xSrLGPFmYffFbpjaVFQl6C9C90=; b=UkcymXCuHAH0gkg5Wt2SmUuKIt1yBGY5ynqj+5S1DZqpDcGJaKzeDDqS IP6EGFFDTVIq7/BrJ4hRo2Ol6d2ypvNJWe1HuEssQntEdaihCUoP1HGeh Smng3To140kaTlSD3Picj9yNuHvD4GABWwlR1ySvOgqEO0SsZ2+oUzX27 8N31MwkDYONDHvtPtRa8cUF3mvHDZV9rzctAtQihZAJPiJ6yNa6LOidNX KdewSEjUJsIHeJ8hpqKuYT4yIEihmHCEwzhwT7gag7uEC8JZeg7yaEjLd hKFdDLjWq86zMkmnqem7YGDtEjyTJOG/c+98JVtERXXpNsOk1ItigUae3 g==; X-CSE-ConnectionGUID: wUvE+2anT7K9kPap3tlGzQ== X-CSE-MsgGUID: LCCHd49CRhedTyToSxvL6Q== X-IronPort-AV: E=McAfee;i="6700,10204,11415"; a="46437831" X-IronPort-AV: E=Sophos;i="6.15,241,1739865600"; d="scan'208";a="46437831" Received: from fmviesa009.fm.intel.com ([10.60.135.149]) by fmvoesa113.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 26 Apr 2025 07:15:10 -0700 X-CSE-ConnectionGUID: 25QIfyFoRGCwRQk8pxa5Qw== X-CSE-MsgGUID: NxBMU5IwTGGLgnHzZ6qFOA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.15,241,1739865600"; d="scan'208";a="134066578" Received: from lkp-server01.sh.intel.com (HELO 050dd05385d1) ([10.239.97.150]) by fmviesa009.fm.intel.com with ESMTP; 26 Apr 2025 07:15:08 -0700 Received: from kbuild by 050dd05385d1 with local (Exim 4.96) (envelope-from ) id 1u8gJ8-0005r3-1L; Sat, 26 Apr 2025 14:15:06 +0000 Date: Sat, 26 Apr 2025 22:14:54 +0800 From: kernel test robot To: Aryan Srivastava Cc: llvm@lists.linux.dev, oe-kbuild-all@lists.linux.dev, linux-kernel@vger.kernel.org, Jakub Kicinski , Andrew Lunn , linux-doc@vger.kernel.org Subject: drivers/net/phy/aquantia/aquantia_main.c:353: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst Message-ID: <202504262247.1UBrDBVN-lkp@intel.com> Precedence: bulk X-Mailing-List: llvm@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master head: 02ddfb981de88a2c15621115dd7be2431252c568 commit: 7e5b547cac7a56515b2838b496923e52ec4eeddd net: phy: aquantia: poll status register date: 7 months ago config: riscv-randconfig-002-20250426 (https://download.01.org/0day-ci/archive/20250426/202504262247.1UBrDBVN-lkp@intel.com/config) compiler: clang version 21.0.0git (https://github.com/llvm/llvm-project f819f46284f2a79790038e1f6649172789734ae8) reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250426/202504262247.1UBrDBVN-lkp@intel.com/reproduce) If you fix the issue in a separate patch/commit (i.e. not just a new version of the same patch/commit), kindly add following tags | Reported-by: kernel test robot | Closes: https://lore.kernel.org/oe-kbuild-all/202504262247.1UBrDBVN-lkp@intel.com/ All warnings (new ones prefixed by >>): >> drivers/net/phy/aquantia/aquantia_main.c:353: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * The status register is not immediately correct on line side link up. vim +353 drivers/net/phy/aquantia/aquantia_main.c 340 341 static int aqr107_read_status(struct phy_device *phydev) 342 { 343 int val, ret; 344 345 ret = aqr_read_status(phydev); 346 if (ret) 347 return ret; 348 349 if (!phydev->link || phydev->autoneg == AUTONEG_DISABLE) 350 return 0; 351 352 /** > 353 * The status register is not immediately correct on line side link up. 354 * Poll periodically until it reflects the correct ON state. 355 * Only return fail for read error, timeout defaults to OFF state. 356 */ 357 ret = phy_read_mmd_poll_timeout(phydev, MDIO_MMD_PHYXS, 358 MDIO_PHYXS_VEND_IF_STATUS, val, 359 (FIELD_GET(MDIO_PHYXS_VEND_IF_STATUS_TYPE_MASK, val) != 360 MDIO_PHYXS_VEND_IF_STATUS_TYPE_OFF), 361 AQR107_OP_IN_PROG_SLEEP, 362 AQR107_OP_IN_PROG_TIMEOUT, false); 363 if (ret && ret != -ETIMEDOUT) 364 return ret; 365 366 switch (FIELD_GET(MDIO_PHYXS_VEND_IF_STATUS_TYPE_MASK, val)) { 367 case MDIO_PHYXS_VEND_IF_STATUS_TYPE_KR: 368 phydev->interface = PHY_INTERFACE_MODE_10GKR; 369 break; 370 case MDIO_PHYXS_VEND_IF_STATUS_TYPE_KX: 371 phydev->interface = PHY_INTERFACE_MODE_1000BASEKX; 372 break; 373 case MDIO_PHYXS_VEND_IF_STATUS_TYPE_XFI: 374 phydev->interface = PHY_INTERFACE_MODE_10GBASER; 375 break; 376 case MDIO_PHYXS_VEND_IF_STATUS_TYPE_USXGMII: 377 phydev->interface = PHY_INTERFACE_MODE_USXGMII; 378 break; 379 case MDIO_PHYXS_VEND_IF_STATUS_TYPE_XAUI: 380 phydev->interface = PHY_INTERFACE_MODE_XAUI; 381 break; 382 case MDIO_PHYXS_VEND_IF_STATUS_TYPE_SGMII: 383 phydev->interface = PHY_INTERFACE_MODE_SGMII; 384 break; 385 case MDIO_PHYXS_VEND_IF_STATUS_TYPE_RXAUI: 386 phydev->interface = PHY_INTERFACE_MODE_RXAUI; 387 break; 388 case MDIO_PHYXS_VEND_IF_STATUS_TYPE_OCSGMII: 389 phydev->interface = PHY_INTERFACE_MODE_2500BASEX; 390 break; 391 case MDIO_PHYXS_VEND_IF_STATUS_TYPE_OFF: 392 default: 393 phydev->link = false; 394 phydev->interface = PHY_INTERFACE_MODE_NA; 395 break; 396 } 397 398 /* Read possibly downshifted rate from vendor register */ 399 return aqr107_read_rate(phydev); 400 } 401 -- 0-DAY CI Kernel Test Service https://github.com/intel/lkp-tests/wiki