Libc-825.25.tar.gz

[apple/libc.git] / pthreads / pthread_workqueue.h

diff --git a/pthreads/pthread_workqueue.h b/pthreads/pthread_workqueue.h
index c3b5f9730a528f9d871c900976caea8a5617338a..20edf50b8f888b73fde5f36994172710b0273eba 100644 (file)
--- a/pthreads/pthread_workqueue.h
+++ b/pthreads/pthread_workqueue.h
@@ -27,7 +27,7 @@
 
 #include <sys/cdefs.h>
 #include <pthread.h>
-
+#include <Availability.h>
 
 #define __PTHREAD_WORKQ_SIZE__ 128
 #define __PTHREAD_WORKQ_ATTR_SIZE__ 60
@@ -42,35 +42,48 @@ typedef struct { unsigned int  sig; char opaque[__PTHREAD_WORKQ_ATTR_SIZE__]; }
 typedef void * pthread_workitem_handle_t;
 /* Kernel expected target concurrency of the workqueue clients for the three priority queues */
 
-#define WORKQ_HIGH_PRIOQUEUE   0
-#define WORKQ_DEFAULT_PRIOQUEUE        1
-#define WORKQ_LOW_PRIOQUEUE    2
+#define WORKQ_HIGH_PRIOQUEUE   0       /* high priority queue */
+#define WORKQ_DEFAULT_PRIOQUEUE        1       /* default priority queue */
+#define WORKQ_LOW_PRIOQUEUE    2       /* low priority queue */
+#define WORKQ_BG_PRIOQUEUE     3       /* background priority queue */
 
-#define WORKQ_NUM_PRIOQUEUE    3
+#define WORKQ_NUM_PRIOQUEUE    4
 
 extern __int32_t workq_targetconc[WORKQ_NUM_PRIOQUEUE];
 
 __BEGIN_DECLS
-int pthread_workqueue_init_np(void);
-int pthread_workqueue_attr_init_np(pthread_workqueue_attr_t * attr);
-int pthread_workqueue_attr_destroy_np(pthread_workqueue_attr_t * attr);
-int pthread_workqueue_attr_getqueuepriority_np(const pthread_workqueue_attr_t * attr, int * qprio);
+int pthread_workqueue_init_np(void) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
+int pthread_workqueue_attr_init_np(pthread_workqueue_attr_t * attr) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
+int pthread_workqueue_attr_destroy_np(pthread_workqueue_attr_t * attr) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
+int pthread_workqueue_attr_getqueuepriority_np(const pthread_workqueue_attr_t * attr, int * qprio) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
 /* WORKQ_HIGH/DEFAULT/LOW_PRIOQUEUE are the only valid values */
-int pthread_workqueue_attr_setqueuepriority_np(pthread_workqueue_attr_t * attr, int qprio);
-int pthread_workqueue_attr_getovercommit_np(const pthread_workqueue_attr_t * attr, int * ocommp);
-int pthread_workqueue_attr_setovercommit_np(pthread_workqueue_attr_t * attr, int ocomm);
+int pthread_workqueue_attr_setqueuepriority_np(pthread_workqueue_attr_t * attr, int qprio) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
+int pthread_workqueue_attr_getovercommit_np(const pthread_workqueue_attr_t * attr, int * ocommp) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
+int pthread_workqueue_attr_setovercommit_np(pthread_workqueue_attr_t * attr, int ocomm) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
 
 
-int pthread_workqueue_create_np(pthread_workqueue_t * workqp, const pthread_workqueue_attr_t * attr);
-int pthread_workqueue_additem_np(pthread_workqueue_t workq, void ( *workitem_func)(void *), void * workitem_arg, pthread_workitem_handle_t * itemhandlep, unsigned int *gencountp);
+int pthread_workqueue_create_np(pthread_workqueue_t * workqp, const pthread_workqueue_attr_t * attr) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
+int pthread_workqueue_additem_np(pthread_workqueue_t workq, void ( *workitem_func)(void *), void * workitem_arg, pthread_workitem_handle_t * itemhandlep, unsigned int *gencountp) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
 /* If the queue value is WORKQ_NUM_PRIOQUEUE, the request for concurrency is for all queues */
-int pthread_workqueue_requestconcurrency_np(int queue, int concurrency);
-int pthread_workqueue_getovercommit_np(pthread_workqueue_t workq,  unsigned int *ocommp);
+int pthread_workqueue_requestconcurrency_np(int queue, int concurrency) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
+int pthread_workqueue_getovercommit_np(pthread_workqueue_t workq,  unsigned int *ocommp) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
 /* 
  * If the arg is non zero, it enables kill on current thread.
  * If the arg of zero, it disables kill on current thread.
  */
-int __pthread_workqueue_setkill(int);
+int __pthread_workqueue_setkill(int) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
+
+/* ===================================================================================================
+ * NEW SPIs for 10.8 onwards
+ *
+ * ===================================================================================================
+ */
+
+typedef void (*pthread_workqueue_function_t)(int queue_priority, int options, void *ctxt);
+int pthread_workqueue_setdispatch_np(pthread_workqueue_function_t worker_func) __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
+
+#define WORKQ_ADDTHREADS_OPTION_OVERCOMMIT 0x00000001
+int pthread_workqueue_addthreads_np(int queue_priority, int options, int numthreads) __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
 __END_DECLS
 
 #endif /* _POSIX_PTHREAD_WORKQUEUE_H */