2 * -------------------------------------------------------------
4 * Module: sem_trywait.c
7 * Semaphores aren't actually part of the PThreads standard.
8 * They are defined by the POSIX Standard:
10 * POSIX 1003.1b-1993 (POSIX.1b)
12 * -------------------------------------------------------------
14 * --------------------------------------------------------------------------
16 * Pthreads-win32 - POSIX Threads Library for Win32
17 * Copyright(C) 1998 John E. Bossom
18 * Copyright(C) 1999,2005 Pthreads-win32 contributors
20 * Contact Email: rpj@callisto.canberra.edu.au
22 * The current list of contributors is contained
23 * in the file CONTRIBUTORS included with the source
24 * code distribution. The list can also be seen at the
25 * following World Wide Web location:
26 * http://sources.redhat.com/pthreads-win32/contributors.html
28 * This library is free software; you can redistribute it and/or
29 * modify it under the terms of the GNU Lesser General Public
30 * License as published by the Free Software Foundation; either
31 * version 2 of the License, or (at your option) any later version.
33 * This library is distributed in the hope that it will be useful,
34 * but WITHOUT ANY WARRANTY; without even the implied warranty of
35 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
36 * Lesser General Public License for more details.
38 * You should have received a copy of the GNU Lesser General Public
39 * License along with this library in the file COPYING.LIB;
40 * if not, write to the Free Software Foundation, Inc.,
41 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
45 #include "semaphore.h"
46 #include "implement.h"
50 sem_trywait (sem_t
* sem
)
52 * ------------------------------------------------------
54 * This function tries to wait on a semaphore.
58 * pointer to an instance of sem_t
61 * This function tries to wait on a semaphore. If the
62 * semaphore value is greater than zero, it decreases
63 * its value by one. If the semaphore value is zero, then
64 * this function returns immediately with the error EAGAIN
67 * 0 successfully decreased semaphore,
68 * -1 failed, error in errno
70 * EAGAIN the semaphore was already locked,
71 * EINVAL 'sem' is not a valid semaphore,
72 * ENOTSUP sem_trywait is not supported,
73 * EINTR the function was interrupted by a signal,
74 * EDEADLK a deadlock condition was detected.
76 * ------------------------------------------------------
86 else if ((result
= pthread_mutex_lock (&s
->lock
)) == 0)
92 (void) pthread_mutex_unlock (&s
->lock
);
106 (void) pthread_mutex_unlock (&s
->lock
);