From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.2 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,UNPARSEABLE_RELAY,USER_AGENT_SANE_1 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id BDF56C433DF for ; Wed, 3 Jun 2020 13:07:38 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id A672E207D8 for ; Wed, 3 Jun 2020 13:07:38 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1725948AbgFCNHi (ORCPT ); Wed, 3 Jun 2020 09:07:38 -0400 Received: from bhuna.collabora.co.uk ([46.235.227.227]:38064 "EHLO bhuna.collabora.co.uk" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725854AbgFCNHh (ORCPT ); Wed, 3 Jun 2020 09:07:37 -0400 Received: from [127.0.0.1] (localhost [127.0.0.1]) (Authenticated sender: andrzej.p) with ESMTPSA id 6958A2A3C84 Subject: Re: [PATCHv2 0/7] Support inhibiting input devices To: Hans de Goede , Dmitry Torokhov Cc: linux-input@vger.kernel.org, linux-acpi@vger.kernel.org, linux-iio@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-samsung-soc@vger.kernel.org, linux-tegra@vger.kernel.org, patches@opensource.cirrus.com, ibm-acpi-devel@lists.sourceforge.net, platform-driver-x86@vger.kernel.org, "Rafael J . Wysocki" , Len Brown , Jonathan Cameron , Hartmut Knaack , Lars-Peter Clausen , Peter Meerwald-Stadler , Kukjin Kim , Krzysztof Kozlowski , Shawn Guo , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , NXP Linux Team , Vladimir Zapolskiy , Sylvain Lemieux , Laxman Dewangan , Thierry Reding , Jonathan Hunter , Barry Song , Michael Hennerich , Nick Dyer , Ferruh Yigit , Sangwon Jee , Henrique de Moraes Holschuh , kernel@collabora.com, Peter Hutterer , Benjamin Tissoires References: <20200515164943.28480-1-andrzej.p@collabora.com> <842b95bb-8391-5806-fe65-be64b02de122@redhat.com> <6d9921fc-5c2f-beda-4dcd-66d6970a22fe@redhat.com> <09679de4-75d3-1f29-ec5f-8d42c84273dd@collabora.com> <2d224833-3a7e-bc7c-af15-1f803f466697@collabora.com> <20200527063430.GJ89269@dtor-ws> <88f939cd-1518-d516-59f2-8f627a6a70d2@collabora.com> <20200602175241.GO89269@dtor-ws> <82e9f2ab-a16e-51ee-1413-bedf0122026a@collabora.com> <8f97d2e1-497a-495d-bc82-f46dbeba440c@redhat.com> From: Andrzej Pietrasiewicz Message-ID: Date: Wed, 3 Jun 2020 15:07:29 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.8.0 MIME-Version: 1.0 In-Reply-To: <8f97d2e1-497a-495d-bc82-f46dbeba440c@redhat.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit Sender: linux-iio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-iio@vger.kernel.org Hi Hans, hi Dmitry, W dniu 02.06.2020 o 22:19, Hans de Goede pisze: > Hi, > > On 6/2/20 8:50 PM, Andrzej Pietrasiewicz wrote: >> Hi Dmitry, >> >> W dniu 02.06.2020 o 19:52, Dmitry Torokhov pisze: >>> Hi Andrzej, >>> >>> On Tue, Jun 02, 2020 at 06:56:40PM +0200, Andrzej Pietrasiewicz wrote: >>>> Hi Dmitry, >>>> >>>> W dniu 27.05.2020 o 08:34, Dmitry Torokhov pisze: >>>>> That said, I think the way we should handle inhibit/uninhibit, is that >>>>> if we have the callback defined, then we call it, and only call open and >>>>> close if uninhibit or inhibit are _not_ defined. >>>>> >>>> >>>> If I understand you correctly you suggest to call either inhibit, >>>> if provided or close, if inhibit is not provided, but not both, >>>> that is, if both are provided then on the inhibit path only >>>> inhibit is called. And, consequently, you suggest to call either >>>> uninhibit or open, but not both. The rest of my mail makes this >>>> assumption, so kindly confirm if I understand you correctly. >>> >>> Yes, that is correct. If a driver wants really fine-grained control, it >>> will provide inhibit (or both inhibit and close), otherwise it will rely >>> on close in place of inhibit. >>> >>>> >>>> In my opinion this idea will not work. >>>> >>>> The first question is should we be able to inhibit a device >>>> which is not opened? In my opinion we should, in order to be >>>> able to inhibit a device in anticipation without needing to >>>> open it first. >>> >>> I agree. >>> >>>> >>>> Then what does opening (with input_open_device()) an inhibited >>>> device mean? Should it succeed or should it fail? >>> >>> It should succeed. >>> >>>> If it is not >>>> the first opening then effectively it boils down to increasing >>>> device's and handle's counters, so we can allow it to succeed. >>>> If, however, the device is being opened for the first time, >>>> the ->open() method wants to be called, but that somehow >>>> contradicts the device's inhibited state. So a logical thing >>>> to do is to either fail input_open_device() or postpone ->open() >>>> invocation to the moment of uninhibiting - and the latter is >>>> what the patches in this series currently do. >>>> >>>> Failing input_open_device() because of the inhibited state is >>>> not the right thing to do. Let me explain. Suppose that a device >>>> is already inhibited and then a new matching handler appears >>>> in the system. Most handlers (apm-power.c, evbug.c, input-leds.c, >>>> mac_hid.c, sysrq.c, vt/keyboard.c and rfkill/input.c) don't create >>>> any character devices (only evdev.c, joydev.c and mousedev.c do), >>>> so for them it makes no sense to delay calling input_open_device() >>>> and it is called in handler's ->connect(). If input_open_device() >>>> now fails, we have lost the only chance for this ->connect() to >>>> succeed. >>>> >>>> Summarizing, IMO the uninhibit path should be calling both >>>> ->open() and ->uninhibit() (if provided), and conversely, the inhibit >>>> path should be calling both ->inhibit() and ->close() (if provided). >>> >>> So what you are trying to say is that you see inhibit as something that >>> is done in addition to what happens in close. But what exactly do you >>> want to do in inhibit, in addition to what close is doing? >> >> See below (*). >> >>> >>> In my view, if we want to have a dedicated inhibit callback, then it >>> will do everything that close does, they both are aware of each other >>> and can sort out the state transitions between them. For drivers that do >>> not have dedicated inhibit/uninhibit, we can use open and close >>> handlers, and have input core sort out when each should be called. That >>> means that we should not call dev->open() in input_open_device() when >>> device is inhibited (and same for dev->close() in input_close_device). >>> And when uninhibiting, we should not call dev->open() when there are no >>> users for the device, and no dev->close() when inhibiting with no users. >>> >>> Do you see any problems with this approach? >> >> My concern is that if e.g. both ->open() and ->uninhibit() are provided, >> then in certain circumstances ->open() won't be called: >> >> 1. users == 0 >> 2. inhibit happens >> 3. input_open_device() happens, ->open() not called >> 4. uninhibit happens >> 5. as part of uninhibit ->uninhibit() is only called, but ->open() is not. >> >> They way I understand your answer is that we implicitly impose requirements >> on drivers which choose to implement e.g. both ->open() and ->uninhibit(): >> in such a case ->uninhibit() should be doing exactly the same things as >> ->open() does. Which leads to a conclusion that in practice no drivers >> should choose to implement both, otherwise they must be aware that >> ->uninhibit() can be sometimes called instead of ->open(). Then ->open() >> becomes synonymous with ->uninhibit(), and ->close() with ->inhibit(). >> Or, maybe, then ->inhibit() can be a superset of ->close() and >> ->uninhibit() a superset of ->open(). >> >> If such an approach is ok with you, it is ok with me, too. >> >> (*) >> Calling both ->inhibit() and ->close() (if they are provided) allows >> drivers to go fancy and fail inhibiting (which is impossible using >> only ->close() as it does not return a value, but ->inhibit() by design >> does). Then ->uninhibit() is mostly for symmetry. > > All the complications discussed above are exactly why I still > believe that there should be only open and close. > > If error propagation on inhibit is considered as something > really important to have then we can make the input driver close > callback return an error (*), note I'm talking about the > driver close callback here, not the system call. > > If the close callback is called for actually closing the fd > referring to the input node, then the new error return code > can be ignored, as we already do for errors on close atm > since the driver close callback returns void. > > I still have not seen a very convincing argument for having > separate inhibit and close callbacks and as the messy discussion > above shows, having 2 such very similar yet subtly different > calls seems like a bad idea... > > Regards, > > Hans > > > *) This will require a flag day where "return 0" is added > to all current close handlers > I'm taking one step back and looking at the ->open() and ->close() driver callbacks. They are called from input_open_device() and input_close_device(), respectively: input_open_device(): "This function should be called by input handlers when they want to start receive events from given input device." ->open() callback: "this method is called when the very first user calls input_open_device(). The driver must prepare the device to start generating events (start polling thread, request an IRQ, submit URB, etc.)" input_close_device(): "This function should be called by input handlers when they want to stop receive events from given input device." ->close() callback: "this method is called when the very last user calls input_close_device()" It seems to me that the callback names do not reflect their purpose: their meaning is not to "open" or to "close" but to give drivers a chance to control when they start or stop providing events to the input core. What would you say about changing the callbacks' names? I'd envsion: ->provide_events() instead of ->open() and ->stop_events() instead of ->close(). Of course drivers can exploit the fact of knowing that nobody wants any events from them and do whatever they consider appropriate, for example go into a low power mode - but the latter is beyond the scope of the input subsystem and is driver-specific. With such a naming change in mind let's consider inhibiting. We want to be able to control when to disregard events from a given device. It makes sense to do it at device level, otherwise such an operation would have to be invoked in all associated handlers (those that have an open handle associating them with the device in question). But of course we can do better than merely ignoring the events received: we can tell the drivers that we don't want any events from them, and later, at uninhibit time, tell them to start providing the events again. Conceptually, the two operations (provide or don't provide envents) are exactly the same thing we want to be happening at input_open_device() and input_close_device() time. To me, changing the names of ->open() and ->close() exposes this fact very well. Consequently, ->inhibit() and ->uninhibit() won't be needed, and drivers which already implement ->provide_events() (formerly ->open()) and ->stop_events() (formerly ->close()) will receive full inhibit/uninhibit support for free (subject to how well they implement ->provide_events()/->stop_events()). Unless we can come up with what the drivers might be doing on top of ->stop_events() and ->provide_events() when inhibiting/uninhibiting, but it seems to me we can't. Can we? Optionally ->close() (only the callback, not input_close_device()) can be made return a value, just as Hans suggests. The value can be ignored in input_close_device() but used in input_inhibit(). No strong opinion here, though. (btw it seems to me that input_inhibit() should be renamed to input_inhibit_device()). Regards, Andrzej