d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
65c127fd42
freebsd-skq/lib/librt/sigev_thread.h

86 lines
2.6 KiB
C
Raw Normal View History

lib: further adoption of SPDX licensing ID tags. Mainly focus on files that use BSD 2-Clause license, however the tool I was using mis-identified many licenses so this was mostly a manual - error prone - task. The Software Package Data Exchange (SPDX) group provides a specification to make it easier for automated tools to detect and summarize well known opensource licenses. We are gradually adopting the specification, noting that the tags are considered only advisory and do not, in any way, superceed or replace the license texts.
2017-11-26 02:00:33 +00:00
/*-
* SPDX-License-Identifier: BSD-2-Clause-FreeBSD
*
Bring in my initial version of POSIX realtime extension library. Current the library implements mqueue, timer and aio with SIGEV_THREAD notification supported. Earlier version reviewed by: deischen
2006-03-01 06:37:34 +00:00
* Copyright (c) 2005 David Xu <davidxu@freebsd.org>
* All rights reserved.
*
* 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 unmodified, 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.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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.
*
* $FreeBSD$
*
*/
#ifndef _SIGEV_THREAD_H_
#define _SIGEV_THREAD_H_
#include <sys/types.h>
#include <sys/queue.h>
1. Always call user callback function in newly created thread, it seems POSIX implies that the user callback function must be executed in clean environment. 2. Use newly introduced pthread stubs in libc.
2006-03-07 08:28:07 +00:00
struct sigev_thread;
Bring in my initial version of POSIX realtime extension library. Current the library implements mqueue, timer and aio with SIGEV_THREAD notification supported. Earlier version reviewed by: deischen
2006-03-01 06:37:34 +00:00
struct sigev_node;
typedef uintptr_t sigev_id_t;
Use a thread pool to process notification if sigev_notify_attributes is default and caller does not require dedicated thread. timer needs a dedicated thread to maintain overrun count correctly in notification context. mqueue and aio can use thread pool to do notification concurrently, the thread pool has lifecycle control, some threads will exit if they have idled for a while.
2006-03-04 00:18:19 +00:00
typedef void (*sigev_dispatch_t)(struct sigev_node *);
Bring in my initial version of POSIX realtime extension library. Current the library implements mqueue, timer and aio with SIGEV_THREAD notification supported. Earlier version reviewed by: deischen
2006-03-01 06:37:34 +00:00
struct sigev_node {
LIST_ENTRY(sigev_node) sn_link;
int sn_type;
sigev_id_t sn_id;
sigev_dispatch_t sn_dispatch;
union sigval sn_value;
void *sn_func;
int sn_flags;
int sn_gen;
Use a thread pool to process notification if sigev_notify_attributes is default and caller does not require dedicated thread. timer needs a dedicated thread to maintain overrun count correctly in notification context. mqueue and aio can use thread pool to do notification concurrently, the thread pool has lifecycle control, some threads will exit if they have idled for a while.
2006-03-04 00:18:19 +00:00
siginfo_t sn_info;
1. Always call user callback function in newly created thread, it seems POSIX implies that the user callback function must be executed in clean environment. 2. Use newly introduced pthread stubs in libc.
2006-03-07 08:28:07 +00:00
pthread_attr_t sn_attr;
struct sigev_thread *sn_tn;
Bring in my initial version of POSIX realtime extension library. Current the library implements mqueue, timer and aio with SIGEV_THREAD notification supported. Earlier version reviewed by: deischen
2006-03-01 06:37:34 +00:00
};
1. Always call user callback function in newly created thread, it seems POSIX implies that the user callback function must be executed in clean environment. 2. Use newly introduced pthread stubs in libc.
2006-03-07 08:28:07 +00:00
struct sigev_thread {
LIST_ENTRY(sigev_thread) tn_link;
Bring in my initial version of POSIX realtime extension library. Current the library implements mqueue, timer and aio with SIGEV_THREAD notification supported. Earlier version reviewed by: deischen
2006-03-01 06:37:34 +00:00
pthread_t tn_thread;
struct sigev_node *tn_cur;
Use a thread pool to process notification if sigev_notify_attributes is default and caller does not require dedicated thread. timer needs a dedicated thread to maintain overrun count correctly in notification context. mqueue and aio can use thread pool to do notification concurrently, the thread pool has lifecycle control, some threads will exit if they have idled for a while.
2006-03-04 00:18:19 +00:00
int tn_refcount;
Bring in my initial version of POSIX realtime extension library. Current the library implements mqueue, timer and aio with SIGEV_THREAD notification supported. Earlier version reviewed by: deischen
2006-03-01 06:37:34 +00:00
long tn_lwpid;
1. Always call user callback function in newly created thread, it seems POSIX implies that the user callback function must be executed in clean environment. 2. Use newly introduced pthread stubs in libc.
2006-03-07 08:28:07 +00:00
pthread_cond_t tn_cv;
Bring in my initial version of POSIX realtime extension library. Current the library implements mqueue, timer and aio with SIGEV_THREAD notification supported. Earlier version reviewed by: deischen
2006-03-01 06:37:34 +00:00
};
#define SNF_WORKING 0x01
#define SNF_REMOVED 0x02
1. Always call user callback function in newly created thread, it seems POSIX implies that the user callback function must be executed in clean environment. 2. Use newly introduced pthread stubs in libc.
2006-03-07 08:28:07 +00:00
#define SNF_SYNC 0x04
Bring in my initial version of POSIX realtime extension library. Current the library implements mqueue, timer and aio with SIGEV_THREAD notification supported. Earlier version reviewed by: deischen
2006-03-01 06:37:34 +00:00
int __sigev_check_init();
Use a thread pool to process notification if sigev_notify_attributes is default and caller does not require dedicated thread. timer needs a dedicated thread to maintain overrun count correctly in notification context. mqueue and aio can use thread pool to do notification concurrently, the thread pool has lifecycle control, some threads will exit if they have idled for a while.
2006-03-04 00:18:19 +00:00
struct sigev_node *__sigev_alloc(int, const struct sigevent *,
1. Always call user callback function in newly created thread, it seems POSIX implies that the user callback function must be executed in clean environment. 2. Use newly introduced pthread stubs in libc.
2006-03-07 08:28:07 +00:00
struct sigev_node *, int);
Bring in my initial version of POSIX realtime extension library. Current the library implements mqueue, timer and aio with SIGEV_THREAD notification supported. Earlier version reviewed by: deischen
2006-03-01 06:37:34 +00:00
struct sigev_node *__sigev_find(int, sigev_id_t);
void __sigev_get_sigevent(struct sigev_node *, struct sigevent *,
sigev_id_t);
int __sigev_register(struct sigev_node *);
int __sigev_delete(int, sigev_id_t);
int __sigev_delete_node(struct sigev_node *);
1. Always call user callback function in newly created thread, it seems POSIX implies that the user callback function must be executed in clean environment. 2. Use newly introduced pthread stubs in libc.
2006-03-07 08:28:07 +00:00
void __sigev_list_lock(void);
void __sigev_list_unlock(void);
Bring in my initial version of POSIX realtime extension library. Current the library implements mqueue, timer and aio with SIGEV_THREAD notification supported. Earlier version reviewed by: deischen
2006-03-01 06:37:34 +00:00
void __sigev_free(struct sigev_node *);
#endif
Reference in New Issue Copy Permalink