From patchwork Wed Oct 11 11:08:52 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matti Vaittinen X-Patchwork-Id: 151288 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2908:b0:403:3b70:6f57 with SMTP id ib8csp456564vqb; Wed, 11 Oct 2023 04:10:17 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEV6r06yQVPUGYoF0xsWWKyBQaIJXArBDhzkATvu34RXG2jj5XtLbfG3b/Hf6YWUV+9Trws X-Received: by 2002:a05:6e02:2185:b0:357:5188:1f83 with SMTP id j5-20020a056e02218500b0035751881f83mr264309ila.1.1697022616563; Wed, 11 Oct 2023 04:10:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697022616; cv=none; d=google.com; s=arc-20160816; b=0LniANi++nJ5KRRkDy7NYYoySgMyoY4Ji87jS+Fdb54ddkYsZ2UAhEEyWxCrKmNUPH YG6+s5IXhb9VwauNY35O97Dk8V/8jkHh5HtSISRPOPqiFDMpzAvDzBB8zYWXIja/9Hl3 C+cpg+AKIdL01237C1ykdiZIdrPXUdDbfb9+1YLZgOvHwlruzVEXL5hW5f2vOECsuLXG 3hOZ5dhOv8VxHfR8UR4Tfkk0OqFhHVXYuaPB86gMDiGp2sYUQU0JqNmWzP97zG4Qbu4J cbmHPz5yEsT7HsGCgIxvxHIjIpp8bQWpJAp2RuoWM6hYu9SoL2QgzLDZuZ77jE3wYEda EgiQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-disposition:mime-version:message-id :subject:cc:to:from:date:dkim-signature; bh=CJMXxiNJ469KGf6nCkSfy2mUYvFcRBuHmMRl5nRn1Ns=; fh=pyiSSDrIstY1JydMAgLnJMLfRdnhOzY/jxvKfCAsGxw=; b=SdWrLapmluCBtdweFbAVLBOnYYek7wZX9aXIZG6/krHXFdoeXTUUTyWimVg1FTkTBl YnW/AbOf7DKPniV2RenTzbexvQ2DTjzIss+y4VeOdbSFbtJUSmwp7k8wQtHXxWBVGfDN XlkC1wEn5ZWTbfOFgKlO1/mVeSSpRDQ9cs6z1IiTZGg41hLHNfPJ6JA6GRnOnsWAMbom kqMXxYrB0eE8waz96ql8Cv0GNEigZMPIl2AKzT8Xv5Ntal5mtP71B9gSOWzKI9nFZDoI AdwcZbiwgxblRzg3pT1iVuSfeRpS9LXWhW67olL7PG6hB53UogYLDp/CDjl8GuOxiSnf Kecw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=YRH71+Sy; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id i191-20020a6387c8000000b00578a98c0687si1814291pge.99.2023.10.11.04.10.16 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Oct 2023 04:10:16 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=YRH71+Sy; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id 5F5BA81B897C; Wed, 11 Oct 2023 04:10:15 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234829AbjJKLKI (ORCPT + 18 others); Wed, 11 Oct 2023 07:10:08 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:52762 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234761AbjJKLJy (ORCPT ); Wed, 11 Oct 2023 07:09:54 -0400 Received: from mail-lj1-x230.google.com (mail-lj1-x230.google.com [IPv6:2a00:1450:4864:20::230]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 91EB6E4 for ; Wed, 11 Oct 2023 04:09:10 -0700 (PDT) Received: by mail-lj1-x230.google.com with SMTP id 38308e7fff4ca-2bff936e10fso9535491fa.1 for ; Wed, 11 Oct 2023 04:09:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1697022549; x=1697627349; darn=vger.kernel.org; h=content-disposition:mime-version:message-id:subject:cc:to:from:date :from:to:cc:subject:date:message-id:reply-to; bh=CJMXxiNJ469KGf6nCkSfy2mUYvFcRBuHmMRl5nRn1Ns=; b=YRH71+SyZiaqMUfQ2l+Im/sGFK4fsdEw5ydsYihb5RJLga3suEpJvnn1nBsG0huNz/ MzLl8jfYCJPwHyNbQRB0MZAAAe6WdgUGPzwfDSiY4fi+eloDaCUY6JDgN5Smu61Ufq0D Z4wCRPMwH9Rojyjqvnu+FrC+9bVHxiUu8afbU+AkiKV66WHhch9M1PFp0k8dV66rgOQC DcmQHQrIZWpEBZ900FOlygI4UtQDjeGSrWwrGrVBQe3fzpYB0AcFy21jd4MoPyZXJ2Do AfvstQPV/DEVcou62IAIn28K/0ovOVT0PbDjidaHf5l9r+ZwNTRt56ZI+cjS4+IHO9Y9 gJ7g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697022549; x=1697627349; h=content-disposition:mime-version:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=CJMXxiNJ469KGf6nCkSfy2mUYvFcRBuHmMRl5nRn1Ns=; b=etfvBsXePw9l9KyM+DzJ147H+LA2pw6n9Km5kODgp+eOXRZi6dt7IBrG6PzD4CybHc aA95doRPu6zOLadIXHKC2iVdLQ0TotdFk5SNVjfKWTFDW+BXIFbaANId080Zv4rHK0zF U4AIs86YhwL2SE5yJW2FYecyyaxE5DOaQjhgHLvmuTAML0zoIwdoZHjIYxpSj602xzQ3 8d1wgk2OlwuyG1vgVfrlgPLrV1d28dVtQKV5nlM8Ed8FS10Drc2Hg03KxVhPcCkfH2ln o4qPt5JluKosYDrEGKjpKtK0xmJwo5aO0+DV3kZvnVPw+rX36v8tBm8Pqu9/lDFVC6DK yYuw== X-Gm-Message-State: AOJu0YzIeT1G+ZyIJaB+vUUqY9DUxcesiqhfjoqlVt89aTJDvUCD+sLy BKipgkqHnr1Q3U08nBNBxh4= X-Received: by 2002:a05:6512:2308:b0:4ff:839b:5355 with SMTP id o8-20020a056512230800b004ff839b5355mr13937689lfu.18.1697022548448; Wed, 11 Oct 2023 04:09:08 -0700 (PDT) Received: from dc78bmyyyyyyyyyyyyydt-3.rev.dnainternet.fi (dc78bmyyyyyyyyyyyyydt-3.rev.dnainternet.fi. [2001:14ba:16f8:1500::7]) by smtp.gmail.com with ESMTPSA id m6-20020a195206000000b005047a395f24sm2208822lfb.214.2023.10.11.04.09.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Oct 2023 04:09:06 -0700 (PDT) Date: Wed, 11 Oct 2023 14:08:52 +0300 From: Matti Vaittinen To: Matti Vaittinen , Matti Vaittinen Cc: Matti Vaittinen , Mark Brown , Daniel Lezcano , linux-kernel@vger.kernel.org Subject: [RESEND] kernel/reboot: document function parameter Message-ID: MIME-Version: 1.0 Content-Disposition: inline X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM, RCVD_IN_DNSWL_BLOCKED,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Wed, 11 Oct 2023 04:10:15 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779457186995564292 X-GMAIL-MSGID: 1779457186995564292 The hw_failure_emergency_poweroff() has been documented using kernel doc. The documentation omits description of the function parameter 'int poweroff_delay_ms' - which seems like self-explatonary. However, the build bot is nagging about the missing parameter documentation, so add the trivial documentation to shut the bot up. Signed-off-by: Matti Vaittinen Reported-by: kernel test robot Closes: https://lore.kernel.org/oe-kbuild-all/202309040349.HLOK1O5I-lkp@intel.com/ Fixes: dfa19b11385d ("reboot: Add hardware protection power-off") Acked-by: Randy Dunlap --- kernel/reboot.c | 1 + 1 file changed, 1 insertion(+) base-commit: 0bb80ecc33a8fb5a682236443c1e740d5c917d1d diff --git a/kernel/reboot.c b/kernel/reboot.c index 3bba88c7ffc6..c7790711242d 100644 --- a/kernel/reboot.c +++ b/kernel/reboot.c @@ -940,6 +940,7 @@ static DECLARE_DELAYED_WORK(hw_failure_emergency_poweroff_work, /** * hw_failure_emergency_poweroff - Trigger an emergency system poweroff + * @poweroff_delay_ms: Time after which the system is rebooted. In milliseconds. * * This may be called from any critical situation to trigger a system shutdown * after a given period of time. If time is negative this is not scheduled.