From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jan Kiszka Subject: Re: [PATCH] KVM: Start lock documentation Date: Tue, 15 Feb 2011 18:08:10 +0100 Message-ID: <4D5AB2FA.5060408@siemens.com> References: <4D52A090.5010308@siemens.com> <20110215164414.GA12410@amt.cnet> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: Avi Kivity , kvm To: Marcelo Tosatti Return-path: Received: from goliath.siemens.de ([192.35.17.28]:28803 "EHLO goliath.siemens.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752579Ab1BORIY (ORCPT ); Tue, 15 Feb 2011 12:08:24 -0500 In-Reply-To: <20110215164414.GA12410@amt.cnet> Sender: kvm-owner@vger.kernel.org List-ID: On 2011-02-15 17:44, Marcelo Tosatti wrote: > On Wed, Feb 09, 2011 at 03:11:28PM +0100, Jan Kiszka wrote: >> The goal of this document shall be >> - overview of all locks used in KVM core >> - provide details on the scope of each lock >> - explain the lock type, specifically of a raw spin locks >> - provide a lock ordering guide >> >> Start with one dependency chain and two locks. >> >> Signed-off-by: Jan Kiszka >> --- >> Documentation/kvm/locking.txt | 30 ++++++++++++++++++++++++++++++ >> 1 files changed, 30 insertions(+), 0 deletions(-) >> create mode 100644 Documentation/kvm/locking.txt >> >> diff --git a/Documentation/kvm/locking.txt b/Documentation/kvm/locking.txt >> new file mode 100644 >> index 0000000..23f9092 >> --- /dev/null >> +++ b/Documentation/kvm/locking.txt >> @@ -0,0 +1,30 @@ >> +KVM Lock Overview >> +================= >> + >> +1. Acquisition Orders >> +--------------------- >> + >> +kvm_lock >> ++-> kvm::srcu / kvm::lock >> + +-> kvm::slots_lock >> + +-> kvm::mmu_lock >> +... > > Its not easy to understand what you mean here. What kvm_lock has to do > with the ordering described below it? kvm_lock is the head of this chain, i.e. there are code paths where it is taken first, then kvm::lock, etc. Jan -- Siemens AG, Corporate Technology, CT T DE IT 1 Corporate Competence Center Embedded Linux