Received: by 2002:a05:6a10:a0d1:0:0:0:0 with SMTP id j17csp237704pxa; Tue, 4 Aug 2020 23:02:40 -0700 (PDT) X-Google-Smtp-Source: ABdhPJz2i79VA0MWwlbLbCpXmhWgH0boqzSMNvcVGbtTTXGQJRBXq2cK7A1AaQWEH866eKZ9ye+U X-Received: by 2002:a17:906:c2c8:: with SMTP id ch8mr1576064ejb.161.1596607360223; Tue, 04 Aug 2020 23:02:40 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1596607360; cv=none; d=google.com; s=arc-20160816; b=BqEFOYx6z+OWvFIsjZXuL9gEvS+VtUWcbyh6BKMebklyhKlA00WWd14r9OjfbqEIGx G1A34KSlztZHmBO/jFOIyHIYJSydrrnowV1hhxksXX+/3XFpUDeXGvRIia9AY1qRAuaC 5WeZqBl8rwdtj0EYbkf8mk0YADFFS7yNBFWpztxNVnFD6k7s2KzXkP4h66/OEADiOPL7 hO1t/j+noMkNcwg1zoRH1QK/HdJtapeiK7MQynwmHdLMR9TJRnlCSEQAj9vC0hjGirUz 59IBKjloCOgGaq31rz/N1C3U0o3lmdrOPRKNCGsTf7COoVkdtw7A4Cm5nH2WnbvgOJH6 Kkyg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:user-agent:message-id:date:to:cc:from :subject:references:in-reply-to:content-transfer-encoding :mime-version:dkim-signature; bh=en0Y3BVXe2NAW2vOrLtsk0UbPu9NYvr0Oqs1IOEgCuw=; b=HbrRwnvP+0jUcJEnNEnkebH1xUlVjvctQRlGrJZxpRd1MLFq3QPFG9tRwpXY8WxaaJ lcaVD1GgZrV7r6RH3W6ALX7z9w0r5Fh8HbPrhs248YQmcqGHJdWU7g1rIxdyEZ/NYhSj UY5mLxV1zn0qXlC6I2XvApYjbwoBdir3xwlINhgvVjKhy3UeZNWICpTj1JSUIsLLC3pa vld38l+agYAJh1Nafauu3hmpE7HN4ZGPYMK8CKENIFN4dCZTx/U1THX3JnCRPlGuK4WU gvdoFCRMFOdMNldaL92omfQC20jJpsmdvm7tDPqLaGmYlOg9luxhCSrRSkj4KnBmt9vF T9+Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=R7sn2dyD; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id r17si815717eda.525.2020.08.04.23.02.15; Tue, 04 Aug 2020 23:02:40 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=R7sn2dyD; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726915AbgHEGBG (ORCPT + 99 others); Wed, 5 Aug 2020 02:01:06 -0400 Received: from mail.kernel.org ([198.145.29.99]:53776 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726382AbgHEGBC (ORCPT ); Wed, 5 Aug 2020 02:01:02 -0400 Received: from kernel.org (unknown [104.132.0.74]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 327A020842; Wed, 5 Aug 2020 06:01:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1596607262; bh=GwODHQP5f3m1ZPOaXoOR2GBwrPzaDHh5wSknqwF8wIM=; h=In-Reply-To:References:Subject:From:Cc:To:Date:From; b=R7sn2dyDd5RQkvjd02GllD6XEFhU/fWt1RyrqkPk7FXA3d8GUX+nL8YqafM92yU4R 7gcrKWgqfj52viL9XuEU+zze7w0QZ1hF1m/K7T9xdmP53NjhNsfom6oswJIzSO7wNU 9eDfZKv8ytYNuD8zDfkXPi6xpZjohJdWmjtdnfAc= Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable In-Reply-To: <20200804204745.987648-6-brendanhiggins@google.com> References: <20200804204745.987648-1-brendanhiggins@google.com> <20200804204745.987648-6-brendanhiggins@google.com> Subject: Re: [PATCH v6 5/5] Documentation: kunit: add a brief blurb about kunit_test_suite From: Stephen Boyd Cc: gregkh@linuxfoundation.org, logang@deltatee.com, mcgrof@kernel.org, linux-arch@vger.kernel.org, linux-kselftest@vger.kernel.org, kunit-dev@googlegroups.com, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, Brendan Higgins To: Brendan Higgins , akpm@linux-foundation.org, alan.maguire@oracle.com, anton.ivanov@cambridgegreys.com, arnd@arndb.de, davidgow@google.com, frowand.list@gmail.com, jdike@addtoit.com, keescook@chromium.org, richard@nod.at, rppt@linux.ibm.com, skhan@linuxfoundation.org, yzaikin@google.com Date: Tue, 04 Aug 2020 23:01:01 -0700 Message-ID: <159660726105.1360974.11438808412702251122@swboyd.mtv.corp.google.com> User-Agent: alot/0.9.1 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Quoting Brendan Higgins (2020-08-04 13:47:45) > Add a brief blurb saying how and when the kunit_test_suite() macro > works to the usage documentation. >=20 > Signed-off-by: Brendan Higgins > --- > Documentation/dev-tools/kunit/usage.rst | 5 +++++ > 1 file changed, 5 insertions(+) >=20 > diff --git a/Documentation/dev-tools/kunit/usage.rst b/Documentation/dev-= tools/kunit/usage.rst > index 3c3fe8b5feccf..961d3ea3ca19a 100644 > --- a/Documentation/dev-tools/kunit/usage.rst > +++ b/Documentation/dev-tools/kunit/usage.rst > @@ -211,6 +211,11 @@ KUnit test framework. > .. note:: > A test case will only be run if it is associated with a test suite. > =20 > +``kunit_test_suite(...)`` is a macro which tells the linker to put the s= pecified > +test suite in a special linker section so that it can be run by KUnit ei= ther > +after late_init, or when the test module is loaded (depending on whether= the "late_init" probably needs some italics or something, but otherwise. Reviewed-by: Stephen Boyd