RTEMS | cpukit/dev: Document exclusive iodev access (!1581)

[Kinsey Moore (@opticron)]

Kinsey Moore started a new discussion on cpukit/include/dev/io/iodev.h: https://gitlab.rtems.org/rtems/rtos/rtems/-/merge_requests/1581#note_162497

 >    );
 >  
 >    /**
 > -   * @brief Call to the device driver to wait on event. The iodev lock is not
 > -   * held when event_wait is called to allow other IOCTL calls while waiting
 > -   * on an event.
 > +   * @brief Call to the device driver to wait on event.
 > +   *
 > +   * The iodev lock is released while waiting for an event only if the
 > +   * calling task does not hold exclusive access obtained through
 > +   * RTEMS_IODEV_IOCTL_OBTAIN.

To be more clear, I'd reword this as: `The iodev lock is not held by iodev internals when wait_event is called so that other IOCTL calls can occur while waiting on an event. This does not affect exclusive access obtained through the use of RTEMS_IODEV_IOCTL_OBTAIN.`

-- 
View it on GitLab: https://gitlab.rtems.org/rtems/rtos/rtems/-/merge_requests/1581#note_162497
You're receiving this email because of your account on gitlab.rtems.org. Unsubscribe from this thread: https://gitlab.rtems.org/-/namespace/49/sent_notifications/6-6lbkznm8pvaqawhjj1848pem0-1d/unsubscribe | Manage all notifications: https://gitlab.rtems.org/-/profile/notifications | Help: https://gitlab.rtems.org/help


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/bugs/attachments/20261112/82645212/attachment.htm>