firmware/arm_scmi/notify.c

30  * effectively registered for an event, so that no support structures or chains
31  * are allocated until at least one user has registered a notifier_block for
33  * level only after at least one user has registered, and it is shutdown after
38  * for still to be registered events are instead kept in the dedicated common
66  * param to the user callback provided by the registered notifier_block, so that
212  *			  all the registered protocol-level specific information
278  * @registered_events: A dynamically allocated array holding all the registered
284  *				descriptors registered for this protocol
291  * Once these descriptors are successfully registered, they are NEVER again
324  * All registered events are represented by one of these structures that are
327  * Once these descriptors are successfully registered, they are NEVER again
345  * @r_evt: A reference to the associated registered event; when this is NULL
348  *	   known nor registered by any protocol at that point in time
416  * buffer and looks for a matching registered event; in case an anomalously
420  * * a reference to the matching registered event when found
421  * * ERR_PTR(-EINVAL) when NO registered event could be found
452  * @r_evt: The registered event descriptor to use
518  *  3. lookup for any registered ALL_SRC_IDs handler:
520  *  4. lookup for any registered specific SRC_ID handler:
673  * scmi_allocate_registered_events_desc()  - Allocate a registered events'
686  * registered.
688  * Return: The allocated and registered descriptor on Success
736  *	    protocol's events are registered
815 		dev_dbg(handle->dev, "registered event - %lX\n",  in scmi_register_protocol_events()
841  *	    protocol's events are registered
915  * If an associated registered event is found, move the handler from the pending
916  * into the registered table.
933 	 * Remove from pending and insert into registered while getting hold  in scmi_bind_event_handler()
939 	 * protocol initialization when a notifier is registered against a still  in scmi_bind_event_handler()
940 	 * not registered protocol, since it would make little sense to force init  in scmi_bind_event_handler()
965  * initialized and registered protocol.
1008 		dev_dbg(ni->handle->dev, "registered NEW handler - key:%X\n",  in scmi_register_event_handler()
1014 				"registered PENDING handler - key:%X\n",  in scmi_register_event_handler()
1029  * registered table and the common pending table:
1032  *   handler could end up being registered as pending if no matching event
1062 	/* Search registered events at first ... if possible at all */  in __scmi_event_handler_get_ops()
1114  * table of registered handlers: this is called only from the dispatching path
1141  * @r_evt: The registered event to act upon
1231  * After having got exclusive access to the registered handlers hashtable,
1273 		 * Only registered handler acquired protocol; must be here  in scmi_put_handler()
1317  *	    callback is registered
1326  * A notifier_block @nb will be registered for each distinct event identified
1341  * an associated registered event is found missing, meaning that the needed
1342  * protocol is still to be initialized and the handler has just been registered
1528  * against a protocol event, which was previously registered using the above
1562  * pending handlers (registered by users while the related protocol was still
1637  * Any user's callback registration attempt, referring a still not registered
1638  * event, will be registered as pending and finalized later (if possible)