[review] core: notif: interrupt notification

Clarify inline description of notif_itr_set_mask(), notif_itr_set_state()
and notif_itr_set_wakeup() regarding input arguments being provided by
normal world hence to sanitize before using.

Signed-off-by: Etienne Carriere <[email protected]>

core/include/kernel/notif.h

@@ -206,10 +206,10 @@ void notif_itr_raise_event(struct notif_itr *notif);
 /*
  * Mask/unmask an interrupt notification
  *
- * @itr_num Interrupt identifier
+ * @itr_num Interrupt identifier provided by normal world
  * @do_mask True to mask the event, false to unmask the event
  *
- * This function is called from a fastcall context.
+ * This function is called from a fastcall context
  */
 void notif_itr_set_mask(unsigned int itr_num, bool do_mask);
 
@@ -267,15 +267,15 @@ TEE_Result notif_itr_unregister(struct notif_itr *notif);
 /*
  * Activate (enable) or deactivate (disable) an interrupt notification
  *
- * @itr_num Interrupt identifier
+ * @itr_num Interrupt identifier provided by normal world
  * @do_enable True to enable the event detection, false disable it
  */
 TEE_Result notif_itr_set_state(unsigned int itr_num, bool do_enable);
 
 /*
  * Enable or disable the low power wakeup capability of the interrupt event
  *
- * @itr_num Interrupt identifier
+ * @itr_num Interrupt identifier provided by normal world
  * @do_enable True to enable the event detection, false disable it
  */
 TEE_Result notif_itr_set_wakeup(unsigned int itr_num, bool do_enable);