Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754075Ab3JDA7R (ORCPT ); Thu, 3 Oct 2013 20:59:17 -0400 Received: from mga11.intel.com ([192.55.52.93]:7237 "EHLO mga11.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751374Ab3JDA7P (ORCPT ); Thu, 3 Oct 2013 20:59:15 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.90,1029,1371106800"; d="scan'208";a="411273988" Date: Thu, 3 Oct 2013 17:59:13 -0700 From: Jon Mason To: Ben Hutchings Cc: Alexander Gordeev , linux-kernel@vger.kernel.org, Bjorn Helgaas , Ralf Baechle , Michael Ellerman , Benjamin Herrenschmidt , Martin Schwidefsky , Ingo Molnar , Tejun Heo , Dan Williams , Andy King , Matt Porter , stable@vger.kernel.org, linux-pci@vger.kernel.org, linux-mips@linux-mips.org, linuxppc-dev@lists.ozlabs.org, linux390@de.ibm.com, linux-s390@vger.kernel.org, x86@kernel.org, linux-ide@vger.kernel.org, iss_storagedev@hp.com, linux-nvme@lists.infradead.org, linux-rdma@vger.kernel.org, netdev@vger.kernel.org, e1000-devel@lists.sourceforge.net, linux-driver@qlogic.com, Solarflare linux maintainers , "VMware, Inc." , linux-scsi@vger.kernel.org Subject: Re: [PATCH RFC 01/77] PCI/MSI: Fix return value when populate_msi_sysfs() failed Message-ID: <20131004005912.GB4787@jonmason-lab> References: <3ff5236944aae69f2cd934b5b6da7c1c269df7c1.1380703262.git.agordeev@redhat.com> <20131003003905.GK6768@jonmason-lab> <1380836781.3419.17.camel@bwh-desktop.uk.level5networks.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1380836781.3419.17.camel@bwh-desktop.uk.level5networks.com> User-Agent: Mutt/1.5.21 (2010-09-15) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1453 Lines: 34 On Thu, Oct 03, 2013 at 10:46:21PM +0100, Ben Hutchings wrote: > On Wed, 2013-10-02 at 17:39 -0700, Jon Mason wrote: > > On Wed, Oct 02, 2013 at 12:48:17PM +0200, Alexander Gordeev wrote: > > > Signed-off-by: Alexander Gordeev > > > > Since you are changing the behavior of the msix_capability_init > > function on populate_msi_sysfs error, a comment describing why in this > > commit would be nice. > [...] > > This function was already treating that error as fatal, and freeing the > MSIs. The change in behaviour is that it now returns the error code in > this case, rather than 0. This is obviously correct and properly > described by the one-line summary. If someone dumb, like me, is looking at this commit and trying to figure out what is happening, having ANY commit message is good. "Fix the return value" doesn't tell me anything. Documenting what issue(s) would've been seen had the error case been encountered and what will now been seen would be very nice. > > Ben. > > -- > Ben Hutchings, Staff Engineer, Solarflare > Not speaking for my employer; that's the marketing department's job. > They asked us to note that Solarflare product names are trademarked. > -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/