aboutsummaryrefslogtreecommitdiff
path: root/nuttx/sched/usleep.c
diff options
context:
space:
mode:
Diffstat (limited to 'nuttx/sched/usleep.c')
-rw-r--r--nuttx/sched/usleep.c168
1 files changed, 0 insertions, 168 deletions
diff --git a/nuttx/sched/usleep.c b/nuttx/sched/usleep.c
deleted file mode 100644
index 893a420f4..000000000
--- a/nuttx/sched/usleep.c
+++ /dev/null
@@ -1,168 +0,0 @@
-/****************************************************************************
- * sched/usleep.c
- *
- * Copyright (C) 2007, 2009, 2012 Gregory Nutt. All rights reserved.
- * Author: Gregory Nutt <gnutt@nuttx.org>
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- *
- * 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- * 2. Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in
- * the documentation and/or other materials provided with the
- * distribution.
- * 3. Neither the name NuttX nor the names of its contributors may be
- * used to endorse or promote products derived from this software
- * without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
- * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
- * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
- * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
- * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
- * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
- * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
- * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
- * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
- * POSSIBILITY OF SUCH DAMAGE.
- *
- ****************************************************************************/
-
-/****************************************************************************
- * Included Files
- ****************************************************************************/
-
-#include <sys/types.h>
-#include <unistd.h>
-#include <signal.h>
-#include <assert.h>
-#include <errno.h>
-
-/****************************************************************************
- * Definitions
- ****************************************************************************/
-
-/****************************************************************************
- * Private Type Declarations
- ****************************************************************************/
-
-/****************************************************************************
- * Global Variables
- ****************************************************************************/
-
-/****************************************************************************
- * Private Variables
- ****************************************************************************/
-
-/****************************************************************************
- * Private Function Prototypes
- ****************************************************************************/
-
-/****************************************************************************
- * Public Functions
- ****************************************************************************/
-
-/****************************************************************************
- * Name: usleep
- *
- * Description:
- * The usleep() function will cause the calling thread to be suspended
- * from execution until either the number of real-time microseconds
- * specified by the argument 'usec' has elapsed or a signal is delivered
- * to the calling thread. The suspension time may be longer than requested
- * due to the scheduling of other activity by the system.
- *
- * The 'usec' argument must be less than 1,000,000. If the value of
- * 'usec' is 0, then the call has no effect.
- *
- * If a SIGALRM signal is generated for the calling process during
- * execution of usleep() and if the SIGALRM signal is being ignored or
- * blocked from delivery, it is unspecified whether usleep() returns
- * when the SIGALRM signal is scheduled. If the signal is being blocked, it
- * is also unspecified whether it remains pending after usleep() returns or
- * it is discarded.
- *
- * If a SIGALRM signal is generated for the calling process during
- * execution of usleep(), except as a result of a prior call to alarm(),
- * and if the SIGALRM signal is not being ignored or blocked from delivery,
- * it is unspecified whether that signal has any effect other than causing
- * usleep() to return.
- *
- * If a signal-catching function interrupts usleep() and examines or changes
- * either the time a SIGALRM is scheduled to be generated, the action
- * associated with the SIGALRM signal, or whether the SIGALRM signal is
- * blocked from delivery, the results are unspecified.
- *
- * If a signal-catching function interrupts usleep() and calls siglongjmp()
- * or longjmp() to restore an environment saved prior to the usleep() call,
- * the action associated with the SIGALRM signal and the time at which a
- * SIGALRM signal is scheduled to be generated are unspecified. It is also
- * unspecified whether the SIGALRM signal is blocked, unless the process'
- * signal mask is restored as part of the environment.
- *
- * Implementations may place limitations on the granularity of timer values.
- * For each interval timer, if the requested timer value requires a finer
- * granularity than the implementation supports, the actual timer value will
- * be rounded up to the next supported value.
- *
- * Interactions between usleep() and any of the following are unspecified:
- *
- * nanosleep(), setitimer(), timer_create(), timer_delete(), timer_getoverrun(),
- * timer_gettime(), timer_settime(), ualarm(), sleep()
-
- * Parameters:
- * usec - the number of microseconds to wait.
- *
- * Returned Value:
- * On successful completion, usleep() returns 0. Otherwise, it returns -1
- * and sets errno to indicate the error.
- *
- * Assumptions:
- *
- ****************************************************************************/
-
-int usleep(useconds_t usec)
-{
- sigset_t set;
- struct timespec ts;
- struct siginfo value;
- int errval;
- int ret = 0;
-
- if (usec)
- {
- /* Set up for the sleep. Using the empty set means that we are not
- * waiting for any particular signal. However, any unmasked signal
- * can still awaken sigtimedwait().
- */
-
- (void)sigemptyset(&set);
- ts.tv_sec = usec / 1000000;
- ts.tv_nsec = (usec % 1000000) * 1000;
-
- /* usleep is a simple application of sigtimedwait. */
-
- ret = sigtimedwait(&set, &value, &ts);
-
- /* sigtimedwait() cannot succeed. It should always return error with
- * either (1) EAGAIN meaning that the timeout occurred, or (2) EINTR
- * meaning that some other unblocked signal was caught.
- */
-
- errval = errno;
- DEBUGASSERT(ret < 0 && (errval == EAGAIN || errval == EINTR));
- if (errval == EAGAIN)
- {
- /* The timeout "error" is the normal, successful result */
-
- ret = 0;
- }
- }
-
- return ret;
-}