From patchwork Mon Apr 8 08:35:00 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alexander Lochmann X-Patchwork-Id: 1080748 Return-Path: X-Original-To: patchwork-incoming@ozlabs.org Delivered-To: patchwork-incoming@ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=linux-ext4-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=tu-dortmund.de Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=tu-dortmund.de header.i=@tu-dortmund.de header.b="bPOtHBlA"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 44d3dk31Clz9sPb for ; Mon, 8 Apr 2019 18:35:22 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726412AbfDHIfR (ORCPT ); Mon, 8 Apr 2019 04:35:17 -0400 Received: from mx1.hrz.uni-dortmund.de ([129.217.128.51]:54283 "EHLO unimail.uni-dortmund.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726189AbfDHIfR (ORCPT ); Mon, 8 Apr 2019 04:35:17 -0400 Received: from ios.cs.uni-dortmund.de (ios.cs.uni-dortmund.de [129.217.43.100]) (authenticated bits=0) by unimail.uni-dortmund.de (8.16.0.41/8.16.0.41) with ESMTPSA id x388Z04q016387 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=NOT); Mon, 8 Apr 2019 10:35:04 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=tu-dortmund.de; s=unimail; t=1554712504; bh=x27WdPJIvTASEktR14WEHuD39tiDkGt0trZKznQVjgc=; h=From:To:Cc:Subject:Date; b=bPOtHBlA6mMk/blHk8rN6mRrKRB7NNhc5XU7G0UE6jGX0ycgfw0y6WIK0S7JQmpVB ZkYsUPjRbU47c7ItCGsMDhwANCBG6Quxq0FI5SZa0uS1ETGw30lKfvJiSXfCgUNyXX UsalZbKNw+WjeC/aMYoWsdOGvvxeYOCAmwAiqbXw= From: Alexander Lochmann To: tytso@mit.edu Cc: Alexander Lochmann , Horst Schirmeier , Jan Kara , linux-ext4@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v3] Updated locking documentation for transaction_t Date: Mon, 8 Apr 2019 10:35:00 +0200 Message-Id: <20190408083500.66759-1-alexander.lochmann@tu-dortmund.de> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Sender: linux-ext4-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-ext4@vger.kernel.org We used LockDoc to derive locking rules for each member of struct transaction_t. Based on those results, we extended the existing documentation by more members of struct transaction_t, and updated the existing documentation. Signed-off-by: Alexander Lochmann Signed-off-by: Horst Schirmeier --- include/linux/jbd2.h | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/include/linux/jbd2.h b/include/linux/jbd2.h index 0f919d5fe84f..34b728e2b702 100644 --- a/include/linux/jbd2.h +++ b/include/linux/jbd2.h @@ -534,6 +534,7 @@ struct transaction_chp_stats_s { * The transaction keeps track of all of the buffers modified by a * running transaction, and all of the buffers committed but not yet * flushed to home for finished transactions. + * (Locking Documentation improved by LockDoc) */ /* @@ -652,12 +653,12 @@ struct transaction_s unsigned long t_start; /* - * When commit was requested + * When commit was requested [journal_t.j_state_lock] */ unsigned long t_requested; /* - * Checkpointing stats [j_checkpoint_sem] + * Checkpointing stats [journal_t.j_list_lock] */ struct transaction_chp_stats_s t_chp_stats;