From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from us-smtp-delivery-1.mimecast.com (us-smtp-delivery-1.mimecast.com [205.139.110.61]) by mx.groups.io with SMTP id smtpd.web12.3413.1585737678688608546 for ; Wed, 01 Apr 2020 03:41:19 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=JGzEZY3u; spf=pass (domain: redhat.com, ip: 205.139.110.61, mailfrom: lersek@redhat.com) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1585737677; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=/69wXz3pamaDEziMkF1x/TrNxtKCCN995XGjY/37MrA=; b=JGzEZY3uwEvjd0CaA2zuejhTyQIfeETQGW9IxgRwCQuox3tjVr9Eb81ozZexcStd6XMimh HM6+IMtfK9CMAhTV7d7yO/mdx05uvjyKYt109CIArhb1TH1vwnWJYnlNMmV1t6cyWHlMwe 100+5o5wuMoxqUpKe+zatMdtvIv4eOI= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-380-gtWITn3aM42ODwCG44jBBg-1; Wed, 01 Apr 2020 06:41:13 -0400 X-MC-Unique: gtWITn3aM42ODwCG44jBBg-1 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 732BA8017F4; Wed, 1 Apr 2020 10:41:12 +0000 (UTC) Received: from lacos-laptop-7.usersys.redhat.com (ovpn-114-94.ams2.redhat.com [10.36.114.94]) by smtp.corp.redhat.com (Postfix) with ESMTP id C60395C1C5; Wed, 1 Apr 2020 10:41:10 +0000 (UTC) Subject: Re: [PATCH v2] OvmfPkg/PvScsiDxe: Refactor setup of rings to separate function To: Liran Alon , devel@edk2.groups.io Cc: nikita.leshchenko@oracle.com, aaron.young@oracle.com, jordan.l.justen@intel.com, ard.biesheuvel@linaro.org References: <20200331225637.123318-1-liran.alon@oracle.com> From: "Laszlo Ersek" Message-ID: <7378622f-092c-e7b2-6309-903a4dcc4f13@redhat.com> Date: Wed, 1 Apr 2020 12:41:09 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 MIME-Version: 1.0 In-Reply-To: <20200331225637.123318-1-liran.alon@oracle.com> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Language: en-US Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit On 04/01/20 00:56, Liran Alon wrote: > Previous to this change, PvScsiFreeRings() was not undoing all > operations that was done by PvScsiInitRings(). > This is because PvScsiInitRings() was both preparing rings (Allocate > memory and map it for device DMA) and setup the rings against device by > issueing a device command. While PvScsiFreeRings() only unmaps the rings > and free their memory. > > Driver do not have a functional error as it makes sure to reset device > before every call site to PvScsiFreeRings(). However, this is not > intuitive. > > Therefore, prefer to refactor the setup of the ring against device to a > separate function than PvScsiInitRings(). > > Signed-off-by: Liran Alon > --- > OvmfPkg/PvScsiDxe/PvScsi.c | 163 +++++++++++++++++++------------------ > 1 file changed, 85 insertions(+), 78 deletions(-) > > diff --git a/OvmfPkg/PvScsiDxe/PvScsi.c b/OvmfPkg/PvScsiDxe/PvScsi.c > index 1ca50390c0e5..8c458ecceeb0 100644 > --- a/OvmfPkg/PvScsiDxe/PvScsi.c > +++ b/OvmfPkg/PvScsiDxe/PvScsi.c > @@ -991,13 +991,6 @@ PvScsiInitRings ( > ) > { > EFI_STATUS Status; > - union { > - PVSCSI_CMD_DESC_SETUP_RINGS Cmd; > - UINT32 Uint32; > - } AlignedCmd; > - PVSCSI_CMD_DESC_SETUP_RINGS *Cmd; > - > - Cmd = &AlignedCmd.Cmd; > > Status = PvScsiAllocateSharedPages ( > Dev, > @@ -1032,6 +1025,69 @@ PvScsiInitRings ( > } > ZeroMem (Dev->RingDesc.RingCmps, EFI_PAGE_SIZE); > > + return EFI_SUCCESS; > + > +FreeRingReqs: > + PvScsiFreeSharedPages ( > + Dev, > + 1, > + Dev->RingDesc.RingReqs, > + &Dev->RingDesc.RingReqsDmaDesc > + ); > + > +FreeRingState: > + PvScsiFreeSharedPages ( > + Dev, > + 1, > + Dev->RingDesc.RingState, > + &Dev->RingDesc.RingStateDmaDesc > + ); > + > + return Status; > +} > + > +STATIC > +VOID > +PvScsiFreeRings ( > + IN OUT PVSCSI_DEV *Dev > + ) > +{ > + PvScsiFreeSharedPages ( > + Dev, > + 1, > + Dev->RingDesc.RingCmps, > + &Dev->RingDesc.RingCmpsDmaDesc > + ); > + > + PvScsiFreeSharedPages ( > + Dev, > + 1, > + Dev->RingDesc.RingReqs, > + &Dev->RingDesc.RingReqsDmaDesc > + ); > + > + PvScsiFreeSharedPages ( > + Dev, > + 1, > + Dev->RingDesc.RingState, > + &Dev->RingDesc.RingStateDmaDesc > + ); > +} > + > +STATIC > +EFI_STATUS > +PvScsiSetupRings ( > + IN OUT PVSCSI_DEV *Dev > + ) > +{ > + union { > + PVSCSI_CMD_DESC_SETUP_RINGS Cmd; > + UINT32 Uint32; > + } AlignedCmd; > + PVSCSI_CMD_DESC_SETUP_RINGS *Cmd; > + > + Cmd = &AlignedCmd.Cmd; > + > ZeroMem (Cmd, sizeof (*Cmd)); > Cmd->ReqRingNumPages = 1; > Cmd->CmpRingNumPages = 1; > @@ -1052,71 +1108,12 @@ PvScsiInitRings ( > sizeof (*Cmd) % sizeof (UINT32) == 0, > "Cmd must be multiple of 32-bit words" > ); > - Status = PvScsiWriteCmdDesc ( > - Dev, > - PvScsiCmdSetupRings, > - (UINT32 *)Cmd, > - sizeof (*Cmd) / sizeof (UINT32) > - ); > - if (EFI_ERROR (Status)) { > - goto FreeRingCmps; > - } > - > - return EFI_SUCCESS; > - > -FreeRingCmps: > - PvScsiFreeSharedPages ( > - Dev, > - 1, > - Dev->RingDesc.RingCmps, > - &Dev->RingDesc.RingCmpsDmaDesc > - ); > - > -FreeRingReqs: > - PvScsiFreeSharedPages ( > - Dev, > - 1, > - Dev->RingDesc.RingReqs, > - &Dev->RingDesc.RingReqsDmaDesc > - ); > - > -FreeRingState: > - PvScsiFreeSharedPages ( > - Dev, > - 1, > - Dev->RingDesc.RingState, > - &Dev->RingDesc.RingStateDmaDesc > - ); > - > - return Status; > -} > - > -STATIC > -VOID > -PvScsiFreeRings ( > - IN OUT PVSCSI_DEV *Dev > - ) > -{ > - PvScsiFreeSharedPages ( > - Dev, > - 1, > - Dev->RingDesc.RingCmps, > - &Dev->RingDesc.RingCmpsDmaDesc > - ); > - > - PvScsiFreeSharedPages ( > - Dev, > - 1, > - Dev->RingDesc.RingReqs, > - &Dev->RingDesc.RingReqsDmaDesc > - ); > - > - PvScsiFreeSharedPages ( > - Dev, > - 1, > - Dev->RingDesc.RingState, > - &Dev->RingDesc.RingStateDmaDesc > - ); > + return PvScsiWriteCmdDesc ( > + Dev, > + PvScsiCmdSetupRings, > + (UINT32 *)Cmd, > + sizeof (*Cmd) / sizeof (UINT32) > + ); > } > > STATIC > @@ -1171,6 +1168,14 @@ PvScsiInit ( > goto FreeRings; > } > > + // > + // Setup rings against device > + // > + Status = PvScsiSetupRings (Dev); > + if (EFI_ERROR (Status)) { > + goto FreeDMACommBuffer; I'm going to rename this label to "FreeDmaCommBuffer" upon pushing (due to de-capitalization of acronyms in edk2 CamelCase). Reviewed-by: Laszlo Ersek Thank you! Laszlo > + } > + > // > // Populate the exported interface's attributes > // > @@ -1202,13 +1207,15 @@ PvScsiInit ( > > return EFI_SUCCESS; > > +FreeDMACommBuffer: > + PvScsiFreeSharedPages ( > + Dev, > + EFI_SIZE_TO_PAGES (sizeof (*Dev->DmaBuf)), > + Dev->DmaBuf, > + &Dev->DmaBufDmaDesc > + ); > + > FreeRings: > - // > - // Reset device to stop device usage of the rings. > - // This is required to safely free the rings. > - // > - PvScsiResetAdapter (Dev); > - > PvScsiFreeRings (Dev); > > RestorePciAttributes: >