Re: [Libguestfs] [nbdkit PATCH 3/3] server: Add and use nbdkit_nanosleep

+=head2 C<nbdkit_nanosleep> +

+This is similar to L<nanosleep(3)>, although you specify the +components as separate parameters rather than as a C<struct timespec>. +This wrapper provides two benefits over the system library: in one +direction, the system library has no easy way to abort a sleep early +if other information determines that there is no point in finishing +the sleep (handling a signal in the same thread as the sleep will do +that, but you don't have full control over the signal masks of other +threads to ensure that your thread will get the intended interrupting +signal). In the other direction, the system library has no easy way +to avoid aborting a sleep early (you can restart the sleep with any +remaining unslept time, but calculating this gets tedious; or you can +use signal masks to avoid handling a signal, but risk making your +thread non-responsive to signals that were important after all, +stalling a timely shutdown of nbdkit). The system call L<ppoll(2)> +can solve these issues, but requires access to internal file +descriptors that the plugin does not need access to, hence this +function exists to do the work on your behalf.