update

[l4.git] / l4 / pkg / l4sys / include / irq.h

diff --git a/l4/pkg/l4sys/include/irq.h b/l4/pkg/l4sys/include/irq.h
index acefab980fcb3d57f2d32546be630ebee8097fb6..64490b9d6ce9512d2eac042dd093cee861a297f4 100644 (file)
--- a/l4/pkg/l4sys/include/irq.h
+++ b/l4/pkg/l4sys/include/irq.h
@@ -53,7 +53,6 @@
  *
  * \param irq    IRQ to attach to.
  * \param label  Identifier of the IRQ.
- * \param flow_type Interrupt type, see L4_irq_flow_type
  * \param thread Thread to attach the interrupt to.
  *
  * \return Syscall return tag
@@ -84,7 +83,6 @@ l4_irq_attach_u(l4_cap_idx_t irq, l4_umword_t label,
  *
  * \param irq    The master IRQ object.
  * \param label  Identifier of the IRQ.
- * \param flow_type Interrupt type, see L4_irq_flow_type
  * \param slave  The slave that shall be attached to the master.
  *
  * \return Syscall return tag
@@ -125,8 +123,14 @@ l4_irq_detach_u(l4_cap_idx_t irq, l4_utcb_t *utcb) L4_NOTHROW;
  * \param irq    IRQ to trigger.
  * \pre \a irq must be a reference to an IRQ.
  *
- * \return Syscall return tag, note this is a send only operation, i.e. there
- *         is no return value except for failed sending.
+ * \return Syscall return tag.
+ *
+ * Note that this function is a send only operation, i.e. there is no return
+ * value except for a failed send operation. Especially l4_error() will
+ * return an error value from the message tag which still contains the IRQ
+ * protocol used for the send operation.
+ *
+ * Use l4_ipc_error() to check for (send) errors.
  */
 L4_INLINE l4_msgtag_t
 l4_irq_trigger(l4_cap_idx_t irq) L4_NOTHROW;