From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752894Ab1AYLRw (ORCPT ); Tue, 25 Jan 2011 06:17:52 -0500 Received: from caramon.arm.linux.org.uk ([78.32.30.218]:36643 "EHLO caramon.arm.linux.org.uk" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752384Ab1AYLRv (ORCPT ); Tue, 25 Jan 2011 06:17:51 -0500 Date: Tue, 25 Jan 2011 11:17:01 +0000 From: Russell King - ARM Linux To: walter harms Cc: Julia Lawall , Vasiliy Kulikov , Ryan Mallon , kernel-janitors@vger.kernel.org, Nicolas Ferre , Jean-Christophe PLAGNIOL-VILLARD , Andrew Victor , linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH 2/4] arch/arm/mach-at91/clock.c: Add missing IS_ERR test Message-ID: <20110125111701.GF11507@n2100.arm.linux.org.uk> References: <1295898922-18822-1-git-send-email-julia@diku.dk> <1295898922-18822-3-git-send-email-julia@diku.dk> <4D3DD964.9020107@bluewatersys.com> <20110124200515.GA30963@albatros> <4D3EA6EC.5050305@bfs.de> <20110125104333.GE11507@n2100.arm.linux.org.uk> <4D3EB02D.6090302@bfs.de> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4D3EB02D.6090302@bfs.de> User-Agent: Mutt/1.5.19 (2009-01-05) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Jan 25, 2011 at 12:12:45PM +0100, walter harms wrote: > Am 25.01.2011 11:43, schrieb Russell King - ARM Linux: > > On Tue, Jan 25, 2011 at 11:33:16AM +0100, walter harms wrote: > >> Would it be more easy to return NULL in the error case of clk_get() instead > >> of ERR_PTR(-ENOENT) ? > >> > >> So the default could be return NULL and an architecture depending solution > >> replacing that. > > > > That's not how the API is defined. The API defines error-pointers to be > > errors, everything should be considered valid. Please don't go down the > > route of doing something architecturally different from that. > > > > What if, say, you couldn't return the struct clk because maybe it could > > only be controlled by one user? Returning an EBUSY error pointer would > > indicate this condition. What if the module providing the struct clk > > hasn't finished initializing - that's another reason for EBUSY rather > > than ENOENT. > > > > Error codes are useful to describe why something failed. NULL pointers > > can't do that. > > > > On Mon, 24 Jan 2011, Vasiliy Kulikov wrote: > > > ... > > clk_get() is defined per-architecture, sometimes it is NULL only. > > > > So these is a bug ? They should return -ENOENT ? You're stuck in "NULL is an error" mode. struct clk * is a cookie which only the clk API implementation understands. It must not be treated as anything different by drivers. The only defined values for drivers are error pointer codes which translate to errors. Everything else, drivers must assume is valid. Drivers are not allowed to dereference struct clk. It is for the clk API to interpret the struct clk * cookie as it sees fit. From mboxrd@z Thu Jan 1 00:00:00 1970 From: Russell King - ARM Linux Date: Tue, 25 Jan 2011 11:17:01 +0000 Subject: Re: [PATCH 2/4] arch/arm/mach-at91/clock.c: Add missing IS_ERR test Message-Id: <20110125111701.GF11507@n2100.arm.linux.org.uk> List-Id: References: <1295898922-18822-1-git-send-email-julia@diku.dk> <1295898922-18822-3-git-send-email-julia@diku.dk> <4D3DD964.9020107@bluewatersys.com> <20110124200515.GA30963@albatros> <4D3EA6EC.5050305@bfs.de> <20110125104333.GE11507@n2100.arm.linux.org.uk> <4D3EB02D.6090302@bfs.de> In-Reply-To: <4D3EB02D.6090302@bfs.de> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: linux-arm-kernel@lists.infradead.org On Tue, Jan 25, 2011 at 12:12:45PM +0100, walter harms wrote: > Am 25.01.2011 11:43, schrieb Russell King - ARM Linux: > > On Tue, Jan 25, 2011 at 11:33:16AM +0100, walter harms wrote: > >> Would it be more easy to return NULL in the error case of clk_get() instead > >> of ERR_PTR(-ENOENT) ? > >> > >> So the default could be return NULL and an architecture depending solution > >> replacing that. > > > > That's not how the API is defined. The API defines error-pointers to be > > errors, everything should be considered valid. Please don't go down the > > route of doing something architecturally different from that. > > > > What if, say, you couldn't return the struct clk because maybe it could > > only be controlled by one user? Returning an EBUSY error pointer would > > indicate this condition. What if the module providing the struct clk > > hasn't finished initializing - that's another reason for EBUSY rather > > than ENOENT. > > > > Error codes are useful to describe why something failed. NULL pointers > > can't do that. > > > > On Mon, 24 Jan 2011, Vasiliy Kulikov wrote: > > > ... > > clk_get() is defined per-architecture, sometimes it is NULL only. > > > > So these is a bug ? They should return -ENOENT ? You're stuck in "NULL is an error" mode. struct clk * is a cookie which only the clk API implementation understands. It must not be treated as anything different by drivers. The only defined values for drivers are error pointer codes which translate to errors. Everything else, drivers must assume is valid. Drivers are not allowed to dereference struct clk. It is for the clk API to interpret the struct clk * cookie as it sees fit. From mboxrd@z Thu Jan 1 00:00:00 1970 From: linux@arm.linux.org.uk (Russell King - ARM Linux) Date: Tue, 25 Jan 2011 11:17:01 +0000 Subject: [PATCH 2/4] arch/arm/mach-at91/clock.c: Add missing IS_ERR test In-Reply-To: <4D3EB02D.6090302@bfs.de> References: <1295898922-18822-1-git-send-email-julia@diku.dk> <1295898922-18822-3-git-send-email-julia@diku.dk> <4D3DD964.9020107@bluewatersys.com> <20110124200515.GA30963@albatros> <4D3EA6EC.5050305@bfs.de> <20110125104333.GE11507@n2100.arm.linux.org.uk> <4D3EB02D.6090302@bfs.de> Message-ID: <20110125111701.GF11507@n2100.arm.linux.org.uk> To: linux-arm-kernel@lists.infradead.org List-Id: linux-arm-kernel.lists.infradead.org On Tue, Jan 25, 2011 at 12:12:45PM +0100, walter harms wrote: > Am 25.01.2011 11:43, schrieb Russell King - ARM Linux: > > On Tue, Jan 25, 2011 at 11:33:16AM +0100, walter harms wrote: > >> Would it be more easy to return NULL in the error case of clk_get() instead > >> of ERR_PTR(-ENOENT) ? > >> > >> So the default could be return NULL and an architecture depending solution > >> replacing that. > > > > That's not how the API is defined. The API defines error-pointers to be > > errors, everything should be considered valid. Please don't go down the > > route of doing something architecturally different from that. > > > > What if, say, you couldn't return the struct clk because maybe it could > > only be controlled by one user? Returning an EBUSY error pointer would > > indicate this condition. What if the module providing the struct clk > > hasn't finished initializing - that's another reason for EBUSY rather > > than ENOENT. > > > > Error codes are useful to describe why something failed. NULL pointers > > can't do that. > > > > On Mon, 24 Jan 2011, Vasiliy Kulikov wrote: > > > ... > > clk_get() is defined per-architecture, sometimes it is NULL only. > > > > So these is a bug ? They should return -ENOENT ? You're stuck in "NULL is an error" mode. struct clk * is a cookie which only the clk API implementation understands. It must not be treated as anything different by drivers. The only defined values for drivers are error pointer codes which translate to errors. Everything else, drivers must assume is valid. Drivers are not allowed to dereference struct clk. It is for the clk API to interpret the struct clk * cookie as it sees fit.