Received: by 2002:a05:6a10:6744:0:0:0:0 with SMTP id w4csp4893498pxu; Tue, 13 Oct 2020 09:31:04 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzuOqOJ9ijUCEsyBaOQN7fcEIr6pE5dLd2k94Pe5bDl/gxS02AqFoVyo+Myh5BOQZsnhxIP X-Received: by 2002:a50:b023:: with SMTP id i32mr314104edd.357.1602606664140; Tue, 13 Oct 2020 09:31:04 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1602606664; cv=none; d=google.com; s=arc-20160816; b=MghmnY7J4E46C8xwyrFxkB6e7i9oFRardB9Svx32GudYgXIeGHsJTttg7fjtLyrNSM 4yJd1ZktQf79v29Lv+7F7Klebga+UIJCgPs7VQD5YtMfoc8vZheutMAPQce/RoATwHnZ +SJ4/L53JGpuTlc02Phix+82ojFX0Ifux4TdU8mvg0oz38xIm2a5fL3z41B09YncYkAP QuAE7h03/G2/O5C3fNQYcpm8xHpJU0tgho2CltuDvCArmdK8z3UJUva2nt6aE/9/PE3L w9im5J2DS8Por7P8fSuw8lgfWoD9wicflnTclO+o/jRw16py+fVPiTE3flw4ZcSl4Vix GHVg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-disposition:mime-version :references:message-id:subject:cc:to:from:date:dkim-signature; bh=+NnF8mXNakRlzoqAgkjq1DF0tdaTbndVS0Kzp4/RQv8=; b=Qdz4CvWmaYPqfRXoByv20x5GpUyEWaBmjL/AD6vjJpjwCDEIViOPni41W9vpyE3rKD DCvZfjVgTpZLx/Zbix2q+8Oy4KWvLkChky2FHlT2qNKKFdJbm1kQ+UbjxAP2TYtfkMzc lAM5eil4Pw79p6ilHkOYYzeJuyasi94m5uqAnMUZdH49p358xhX5vrt1VjeshuoOzwFc Ebk8dTbRegZdHsS4ChqkJRjF3ceyx1hAacM2Yv5Xd8ZBhNBSUZ32OwdIlkR6lEJ5yTlS PROEzSPd7xBrXUqsofKzuHdiPCzDPQo4nsYaB/5wXAnryeDHIMUzQTn9RV+smFQXR6Xe KLDw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=merlin.20170209 header.b=A19mXaDM; 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 Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id m34si151666ede.50.2020.10.13.09.30.40; Tue, 13 Oct 2020 09:31:04 -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=@infradead.org header.s=merlin.20170209 header.b=A19mXaDM; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728221AbgJMMwP (ORCPT + 99 others); Tue, 13 Oct 2020 08:52:15 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49264 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727260AbgJMMwO (ORCPT ); Tue, 13 Oct 2020 08:52:14 -0400 Received: from merlin.infradead.org (merlin.infradead.org [IPv6:2001:8b0:10b:1231::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 71939C0613D0; Tue, 13 Oct 2020 05:52:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=merlin.20170209; h=In-Reply-To:Content-Type:MIME-Version: References:Message-ID:Subject:Cc:To:From:Date:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description; bh=+NnF8mXNakRlzoqAgkjq1DF0tdaTbndVS0Kzp4/RQv8=; b=A19mXaDMPQsr3FhPWF2UXpJ7XG YeIVyZgXhf5umYX/r2JsYFErELnBSXQGZruOQCU+UQ2s5xN5+gdRpqSieWngDw9irvE+kRzsflk+U BvcdMCER/qjonBmM3Gq/HSHRlPuVyo4LAc7Wu7UrehXDob6mVeABVncf53KlG/28ej+tccGIu6ZIt bMBwSSXcofP3dCvy08oosGaaMACgLjQVrcZzFW9h7HgjEcQCBK/iHZbnZyYuVBVetISjIaMuz3zWO x1QHz+peNsj/dG1enb92qMLJwuSS3AcoN/yTPSTplv9lhS6jmOKw6+30JcYmAJ78sKPukF4snTfYP 6BjBOppA==; Received: from j217100.upc-j.chello.nl ([24.132.217.100] helo=noisy.programming.kicks-ass.net) by merlin.infradead.org with esmtpsa (Exim 4.92.3 #3 (Red Hat Linux)) id 1kSJmj-0008Mk-0D; Tue, 13 Oct 2020 12:52:09 +0000 Received: from hirez.programming.kicks-ass.net (hirez.programming.kicks-ass.net [192.168.1.225]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by noisy.programming.kicks-ass.net (Postfix) with ESMTPS id 1E458301959; Tue, 13 Oct 2020 14:52:07 +0200 (CEST) Received: by hirez.programming.kicks-ass.net (Postfix, from userid 1000) id 03A442B4F909A; Tue, 13 Oct 2020 14:52:06 +0200 (CEST) Date: Tue, 13 Oct 2020 14:52:06 +0200 From: Peter Zijlstra To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Jonathan Corbet , Boqun Feng , Ingo Molnar , Will Deacon , linux-kernel@vger.kernel.org Subject: Re: [PATCH v2 04/24] docs: lockdep-design: fix some warning issues Message-ID: <20201013125206.GU2611@hirez.programming.kicks-ass.net> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Oct 13, 2020 at 02:14:31PM +0200, Mauro Carvalho Chehab wrote: > + ===== =================================================== > + ``.`` acquired while irqs disabled and not in irq context > + ``-`` acquired in irq context > + ``+`` acquired with irqs enabled > + ``?`` acquired in irq context with irqs enabled. > + ===== =================================================== > > The bits are illustrated with an example:: > > @@ -96,14 +99,14 @@ exact case is for the lock as of the reporting time. > +--------------+-------------+--------------+ > | | irq enabled | irq disabled | > +--------------+-------------+--------------+ > - | ever in irq | ? | - | > + | ever in irq | ``?`` | ``-`` | > +--------------+-------------+--------------+ > - | never in irq | + | . | > + | never in irq | ``+`` | ``.`` | > +--------------+-------------+--------------+ > > -The character '-' suggests irq is disabled because if otherwise the > -charactor '?' would have been shown instead. Similar deduction can be > -applied for '+' too. > +The character ``-`` suggests irq is disabled because if otherwise the > +charactor ``?`` would have been shown instead. Similar deduction can be > +applied for ``+`` too. > NAK!