noderb 0.0.2
Sign up to get free protection for your applications and to get access to all the features.
- data/LICENSE +19 -0
- data/README.md +25 -0
- data/ext/noderb_extension/extconf.rb +11 -0
- data/ext/noderb_extension/libuv/AUTHORS +11 -0
- data/ext/noderb_extension/libuv/LICENSE +48 -0
- data/ext/noderb_extension/libuv/Makefile +119 -0
- data/ext/noderb_extension/libuv/README +45 -0
- data/ext/noderb_extension/libuv/build/all.gyp +254 -0
- data/ext/noderb_extension/libuv/build/common.gypi +13 -0
- data/ext/noderb_extension/libuv/build/gyp_uv +43 -0
- data/ext/noderb_extension/libuv/config-mingw.mk +67 -0
- data/ext/noderb_extension/libuv/config-unix.mk +121 -0
- data/ext/noderb_extension/libuv/create-msvs-files.bat +14 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ANNOUNCE +482 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/BUGS +141 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/Bmakefile +268 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/CONTRIBUTORS +140 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/COPYING +150 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/COPYING.LIB +504 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ChangeLog +5194 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/FAQ +451 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/GNUmakefile +593 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/MAINTAINERS +4 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/Makefile +516 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/NEWS +1245 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/Nmakefile +24 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/Nmakefile.tests +260 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/PROGRESS +4 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/README +601 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/README.Borland +57 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/README.CV +3036 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/README.NONPORTABLE +783 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/README.Watcom +62 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/README.WinCE +6 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/TODO +7 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/WinCE-PORT +222 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/attr.c +53 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/autostatic.c +69 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/barrier.c +47 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/build/all.gyp +207 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/builddmc.bat +9 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/cancel.c +44 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/cleanup.c +148 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/condvar.c +50 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/config.h +153 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/context.h +74 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/create.c +308 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/dll.c +92 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/errno.c +94 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/exit.c +44 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/fork.c +39 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/global.c +107 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/implement.h +944 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/misc.c +50 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/mutex.c +62 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/need_errno.h +145 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/nonportable.c +47 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/private.c +54 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread.c +66 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread.dsp +142 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread.dsw +29 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread.h +1368 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_destroy.c +79 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_getdetachstate.c +86 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_getinheritsched.c +51 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_getschedparam.c +52 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_getschedpolicy.c +61 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_getscope.c +54 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_getstackaddr.c +97 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_getstacksize.c +100 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_init.c +117 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_setdetachstate.c +91 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_setinheritsched.c +57 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_setschedparam.c +63 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_setschedpolicy.c +55 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_setscope.c +62 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_setstackaddr.c +97 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_attr_setstacksize.c +110 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_barrier_destroy.c +103 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_barrier_init.c +69 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_barrier_wait.c +104 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_barrierattr_destroy.c +83 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_barrierattr_getpshared.c +95 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_barrierattr_init.c +85 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_barrierattr_setpshared.c +119 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_cancel.c +189 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_cond_destroy.c +253 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_cond_init.c +167 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_cond_signal.c +231 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_cond_wait.c +567 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_condattr_destroy.c +86 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_condattr_getpshared.c +97 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_condattr_init.c +87 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_condattr_setpshared.c +117 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_delay_np.c +172 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_detach.c +136 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_equal.c +76 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_exit.c +106 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_getconcurrency.c +45 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_getschedparam.c +75 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_getspecific.c +87 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_getunique_np.c +47 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_getw32threadhandle_np.c +65 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_join.c +157 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_key_create.c +108 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_key_delete.c +125 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_kill.c +105 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutex_consistent.c +187 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutex_destroy.c +148 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutex_init.c +130 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutex_lock.c +269 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutex_timedlock.c +324 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutex_trylock.c +154 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutex_unlock.c +175 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutexattr_destroy.c +83 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutexattr_getkind_np.c +44 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutexattr_getpshared.c +95 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutexattr_getrobust.c +113 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutexattr_gettype.c +56 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutexattr_init.c +86 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutexattr_setkind_np.c +44 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutexattr_setpshared.c +119 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutexattr_setrobust.c +119 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_mutexattr_settype.c +143 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_num_processors_np.c +56 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_once.c +79 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlock_destroy.c +143 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlock_init.c +109 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlock_rdlock.c +102 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlock_timedrdlock.c +109 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlock_timedwrlock.c +139 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlock_tryrdlock.c +102 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlock_trywrlock.c +122 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlock_unlock.c +93 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlock_wrlock.c +133 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlockattr_destroy.c +84 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlockattr_getpshared.c +97 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlockattr_init.c +83 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_rwlockattr_setpshared.c +120 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_self.c +141 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_setcancelstate.c +125 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_setcanceltype.c +126 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_setconcurrency.c +53 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_setschedparam.c +123 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_setspecific.c +167 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_spin_destroy.c +111 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_spin_init.c +123 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_spin_lock.c +80 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_spin_trylock.c +77 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_spin_unlock.c +71 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_testcancel.c +103 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_timechange_handler_np.c +108 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/pthread_win32_attach_detach_np.c +258 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_MCS_lock.c +278 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_callUserDestroyRoutines.c +232 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_calloc.c +56 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_cond_check_need_init.c +78 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_getprocessors.c +91 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_is_attr.c +47 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_mutex_check_need_init.c +92 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_new.c +94 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_processInitialize.c +92 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_processTerminate.c +105 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_relmillisecs.c +132 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_reuse.c +151 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_rwlock_cancelwrwait.c +50 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_rwlock_check_need_init.c +77 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_semwait.c +135 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_spinlock_check_need_init.c +78 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_threadDestroy.c +79 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_threadStart.c +357 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_throw.c +189 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_timespec.c +83 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_tkAssocCreate.c +118 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/ptw32_tkAssocDestroy.c +114 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/rwlock.c +51 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sched.c +53 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sched.h +183 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sched_get_priority_max.c +134 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sched_get_priority_min.c +135 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sched_getscheduler.c +71 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sched_setscheduler.c +83 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sched_yield.c +71 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sem_close.c +58 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sem_destroy.c +144 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sem_getvalue.c +110 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sem_init.c +169 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sem_open.c +58 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sem_post.c +128 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sem_post_multiple.c +142 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sem_timedwait.c +238 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sem_trywait.c +117 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sem_unlink.c +58 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sem_wait.c +187 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/semaphore.c +69 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/semaphore.h +169 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/signal.c +179 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/spin.c +46 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/sync.c +43 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/tsd.c +44 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/version.rc +388 -0
- data/ext/noderb_extension/libuv/deps/pthread-win32/w32_CancelableWait.c +161 -0
- data/ext/noderb_extension/libuv/doc/desired-api.md +159 -0
- data/ext/noderb_extension/libuv/doc/iocp-links.html +574 -0
- data/ext/noderb_extension/libuv/include/ares.h +582 -0
- data/ext/noderb_extension/libuv/include/ares_version.h +24 -0
- data/ext/noderb_extension/libuv/include/eio.h +376 -0
- data/ext/noderb_extension/libuv/include/ev.h +835 -0
- data/ext/noderb_extension/libuv/include/ngx-queue.h +102 -0
- data/ext/noderb_extension/libuv/include/tree.h +762 -0
- data/ext/noderb_extension/libuv/include/uv-unix.h +138 -0
- data/ext/noderb_extension/libuv/include/uv-win.h +187 -0
- data/ext/noderb_extension/libuv/include/uv.h +635 -0
- data/ext/noderb_extension/libuv/src/ares/AUTHORS +37 -0
- data/ext/noderb_extension/libuv/src/ares/CHANGES +1198 -0
- data/ext/noderb_extension/libuv/src/ares/CMakeLists.txt +22 -0
- data/ext/noderb_extension/libuv/src/ares/NEWS +21 -0
- data/ext/noderb_extension/libuv/src/ares/README +60 -0
- data/ext/noderb_extension/libuv/src/ares/README.cares +13 -0
- data/ext/noderb_extension/libuv/src/ares/README.msvc +118 -0
- data/ext/noderb_extension/libuv/src/ares/README.node +21 -0
- data/ext/noderb_extension/libuv/src/ares/RELEASE-NOTES +25 -0
- data/ext/noderb_extension/libuv/src/ares/TODO +23 -0
- data/ext/noderb_extension/libuv/src/ares/ares__close_sockets.c +66 -0
- data/ext/noderb_extension/libuv/src/ares/ares__get_hostent.c +263 -0
- data/ext/noderb_extension/libuv/src/ares/ares__read_line.c +71 -0
- data/ext/noderb_extension/libuv/src/ares/ares__timeval.c +111 -0
- data/ext/noderb_extension/libuv/src/ares/ares_cancel.c +63 -0
- data/ext/noderb_extension/libuv/src/ares/ares_data.c +190 -0
- data/ext/noderb_extension/libuv/src/ares/ares_data.h +65 -0
- data/ext/noderb_extension/libuv/src/ares/ares_destroy.c +105 -0
- data/ext/noderb_extension/libuv/src/ares/ares_dns.h +90 -0
- data/ext/noderb_extension/libuv/src/ares/ares_expand_name.c +193 -0
- data/ext/noderb_extension/libuv/src/ares/ares_expand_string.c +75 -0
- data/ext/noderb_extension/libuv/src/ares/ares_fds.c +62 -0
- data/ext/noderb_extension/libuv/src/ares/ares_free_hostent.c +39 -0
- data/ext/noderb_extension/libuv/src/ares/ares_free_string.c +25 -0
- data/ext/noderb_extension/libuv/src/ares/ares_gethostbyaddr.c +292 -0
- data/ext/noderb_extension/libuv/src/ares/ares_gethostbyname.c +515 -0
- data/ext/noderb_extension/libuv/src/ares/ares_getnameinfo.c +426 -0
- data/ext/noderb_extension/libuv/src/ares/ares_getopt.c +122 -0
- data/ext/noderb_extension/libuv/src/ares/ares_getopt.h +53 -0
- data/ext/noderb_extension/libuv/src/ares/ares_getsock.c +72 -0
- data/ext/noderb_extension/libuv/src/ares/ares_init.c +1665 -0
- data/ext/noderb_extension/libuv/src/ares/ares_ipv6.h +78 -0
- data/ext/noderb_extension/libuv/src/ares/ares_library_init.c +132 -0
- data/ext/noderb_extension/libuv/src/ares/ares_library_init.h +39 -0
- data/ext/noderb_extension/libuv/src/ares/ares_llist.c +86 -0
- data/ext/noderb_extension/libuv/src/ares/ares_llist.h +42 -0
- data/ext/noderb_extension/libuv/src/ares/ares_mkquery.c +195 -0
- data/ext/noderb_extension/libuv/src/ares/ares_nowarn.c +59 -0
- data/ext/noderb_extension/libuv/src/ares/ares_nowarn.h +24 -0
- data/ext/noderb_extension/libuv/src/ares/ares_options.c +253 -0
- data/ext/noderb_extension/libuv/src/ares/ares_parse_a_reply.c +260 -0
- data/ext/noderb_extension/libuv/src/ares/ares_parse_aaaa_reply.c +256 -0
- data/ext/noderb_extension/libuv/src/ares/ares_parse_mx_reply.c +170 -0
- data/ext/noderb_extension/libuv/src/ares/ares_parse_ns_reply.c +182 -0
- data/ext/noderb_extension/libuv/src/ares/ares_parse_ptr_reply.c +208 -0
- data/ext/noderb_extension/libuv/src/ares/ares_parse_srv_reply.c +179 -0
- data/ext/noderb_extension/libuv/src/ares/ares_parse_txt_reply.c +201 -0
- data/ext/noderb_extension/libuv/src/ares/ares_private.h +351 -0
- data/ext/noderb_extension/libuv/src/ares/ares_process.c +1296 -0
- data/ext/noderb_extension/libuv/src/ares/ares_query.c +183 -0
- data/ext/noderb_extension/libuv/src/ares/ares_rules.h +144 -0
- data/ext/noderb_extension/libuv/src/ares/ares_search.c +322 -0
- data/ext/noderb_extension/libuv/src/ares/ares_send.c +134 -0
- data/ext/noderb_extension/libuv/src/ares/ares_setup.h +191 -0
- data/ext/noderb_extension/libuv/src/ares/ares_strcasecmp.c +66 -0
- data/ext/noderb_extension/libuv/src/ares/ares_strcasecmp.h +30 -0
- data/ext/noderb_extension/libuv/src/ares/ares_strdup.c +42 -0
- data/ext/noderb_extension/libuv/src/ares/ares_strdup.h +26 -0
- data/ext/noderb_extension/libuv/src/ares/ares_strerror.c +56 -0
- data/ext/noderb_extension/libuv/src/ares/ares_timeout.c +80 -0
- data/ext/noderb_extension/libuv/src/ares/ares_version.c +11 -0
- data/ext/noderb_extension/libuv/src/ares/ares_writev.c +79 -0
- data/ext/noderb_extension/libuv/src/ares/ares_writev.h +36 -0
- data/ext/noderb_extension/libuv/src/ares/bitncmp.c +59 -0
- data/ext/noderb_extension/libuv/src/ares/bitncmp.h +26 -0
- data/ext/noderb_extension/libuv/src/ares/config_cygwin/ares_config.h +510 -0
- data/ext/noderb_extension/libuv/src/ares/config_darwin/ares_config.h +510 -0
- data/ext/noderb_extension/libuv/src/ares/config_freebsd/ares_config.h +510 -0
- data/ext/noderb_extension/libuv/src/ares/config_linux/ares_config.h +510 -0
- data/ext/noderb_extension/libuv/src/ares/config_openbsd/ares_config.h +510 -0
- data/ext/noderb_extension/libuv/src/ares/config_sunos/ares_config.h +510 -0
- data/ext/noderb_extension/libuv/src/ares/config_win32/ares_config.h +369 -0
- data/ext/noderb_extension/libuv/src/ares/get_ver.awk +35 -0
- data/ext/noderb_extension/libuv/src/ares/inet_net_pton.c +450 -0
- data/ext/noderb_extension/libuv/src/ares/inet_net_pton.h +31 -0
- data/ext/noderb_extension/libuv/src/ares/inet_ntop.c +232 -0
- data/ext/noderb_extension/libuv/src/ares/inet_ntop.h +27 -0
- data/ext/noderb_extension/libuv/src/ares/nameser.h +193 -0
- data/ext/noderb_extension/libuv/src/ares/setup_once.h +488 -0
- data/ext/noderb_extension/libuv/src/ares/windows_port.c +22 -0
- data/ext/noderb_extension/libuv/src/eio/Changes +63 -0
- data/ext/noderb_extension/libuv/src/eio/LICENSE +36 -0
- data/ext/noderb_extension/libuv/src/eio/Makefile.am +15 -0
- data/ext/noderb_extension/libuv/src/eio/aclocal.m4 +8957 -0
- data/ext/noderb_extension/libuv/src/eio/autogen.sh +3 -0
- data/ext/noderb_extension/libuv/src/eio/config.h.in +86 -0
- data/ext/noderb_extension/libuv/src/eio/config_cygwin.h +77 -0
- data/ext/noderb_extension/libuv/src/eio/config_darwin.h +137 -0
- data/ext/noderb_extension/libuv/src/eio/config_freebsd.h +78 -0
- data/ext/noderb_extension/libuv/src/eio/config_linux.h +101 -0
- data/ext/noderb_extension/libuv/src/eio/config_sunos.h +81 -0
- data/ext/noderb_extension/libuv/src/eio/configure.ac +22 -0
- data/ext/noderb_extension/libuv/src/eio/demo.c +194 -0
- data/ext/noderb_extension/libuv/src/eio/ecb.h +370 -0
- data/ext/noderb_extension/libuv/src/eio/eio.3 +3428 -0
- data/ext/noderb_extension/libuv/src/eio/eio.c +2562 -0
- data/ext/noderb_extension/libuv/src/eio/eio.pod +969 -0
- data/ext/noderb_extension/libuv/src/eio/libeio.m4 +195 -0
- data/ext/noderb_extension/libuv/src/eio/xthread.h +164 -0
- data/ext/noderb_extension/libuv/src/ev/Changes +388 -0
- data/ext/noderb_extension/libuv/src/ev/LICENSE +36 -0
- data/ext/noderb_extension/libuv/src/ev/Makefile.am +18 -0
- data/ext/noderb_extension/libuv/src/ev/Makefile.in +771 -0
- data/ext/noderb_extension/libuv/src/ev/README +58 -0
- data/ext/noderb_extension/libuv/src/ev/aclocal.m4 +8957 -0
- data/ext/noderb_extension/libuv/src/ev/autogen.sh +6 -0
- data/ext/noderb_extension/libuv/src/ev/config.guess +1526 -0
- data/ext/noderb_extension/libuv/src/ev/config.h.in +125 -0
- data/ext/noderb_extension/libuv/src/ev/config.sub +1658 -0
- data/ext/noderb_extension/libuv/src/ev/config_cygwin.h +123 -0
- data/ext/noderb_extension/libuv/src/ev/config_darwin.h +122 -0
- data/ext/noderb_extension/libuv/src/ev/config_freebsd.h +120 -0
- data/ext/noderb_extension/libuv/src/ev/config_linux.h +130 -0
- data/ext/noderb_extension/libuv/src/ev/config_sunos.h +122 -0
- data/ext/noderb_extension/libuv/src/ev/configure +13037 -0
- data/ext/noderb_extension/libuv/src/ev/configure.ac +18 -0
- data/ext/noderb_extension/libuv/src/ev/depcomp +630 -0
- data/ext/noderb_extension/libuv/src/ev/ev++.h +816 -0
- data/ext/noderb_extension/libuv/src/ev/ev.3 +5311 -0
- data/ext/noderb_extension/libuv/src/ev/ev.c +3913 -0
- data/ext/noderb_extension/libuv/src/ev/ev.pod +5243 -0
- data/ext/noderb_extension/libuv/src/ev/ev_epoll.c +266 -0
- data/ext/noderb_extension/libuv/src/ev/ev_kqueue.c +198 -0
- data/ext/noderb_extension/libuv/src/ev/ev_poll.c +148 -0
- data/ext/noderb_extension/libuv/src/ev/ev_port.c +179 -0
- data/ext/noderb_extension/libuv/src/ev/ev_select.c +310 -0
- data/ext/noderb_extension/libuv/src/ev/ev_vars.h +203 -0
- data/ext/noderb_extension/libuv/src/ev/ev_win32.c +153 -0
- data/ext/noderb_extension/libuv/src/ev/ev_wrap.h +196 -0
- data/ext/noderb_extension/libuv/src/ev/event.c +402 -0
- data/ext/noderb_extension/libuv/src/ev/event.h +170 -0
- data/ext/noderb_extension/libuv/src/ev/install-sh +294 -0
- data/ext/noderb_extension/libuv/src/ev/libev.m4 +39 -0
- data/ext/noderb_extension/libuv/src/ev/ltmain.sh +8413 -0
- data/ext/noderb_extension/libuv/src/ev/missing +336 -0
- data/ext/noderb_extension/libuv/src/ev/mkinstalldirs +111 -0
- data/ext/noderb_extension/libuv/src/uv-common.c +172 -0
- data/ext/noderb_extension/libuv/src/uv-common.h +53 -0
- data/ext/noderb_extension/libuv/src/uv-cygwin.c +52 -0
- data/ext/noderb_extension/libuv/src/uv-darwin.c +64 -0
- data/ext/noderb_extension/libuv/src/uv-eio.c +113 -0
- data/ext/noderb_extension/libuv/src/uv-eio.h +13 -0
- data/ext/noderb_extension/libuv/src/uv-freebsd.c +65 -0
- data/ext/noderb_extension/libuv/src/uv-linux.c +51 -0
- data/ext/noderb_extension/libuv/src/uv-sunos.c +60 -0
- data/ext/noderb_extension/libuv/src/uv-unix.c +2408 -0
- data/ext/noderb_extension/libuv/src/win/async.c +129 -0
- data/ext/noderb_extension/libuv/src/win/cares.c +304 -0
- data/ext/noderb_extension/libuv/src/win/core.c +155 -0
- data/ext/noderb_extension/libuv/src/win/error.c +140 -0
- data/ext/noderb_extension/libuv/src/win/getaddrinfo.c +341 -0
- data/ext/noderb_extension/libuv/src/win/handle.c +176 -0
- data/ext/noderb_extension/libuv/src/win/internal.h +237 -0
- data/ext/noderb_extension/libuv/src/win/loop-watcher.c +128 -0
- data/ext/noderb_extension/libuv/src/win/pipe.c +828 -0
- data/ext/noderb_extension/libuv/src/win/process.c +936 -0
- data/ext/noderb_extension/libuv/src/win/req.c +141 -0
- data/ext/noderb_extension/libuv/src/win/stdio.c +75 -0
- data/ext/noderb_extension/libuv/src/win/stream.c +149 -0
- data/ext/noderb_extension/libuv/src/win/tcp.c +895 -0
- data/ext/noderb_extension/libuv/src/win/timer.c +269 -0
- data/ext/noderb_extension/libuv/src/win/util.c +82 -0
- data/ext/noderb_extension/libuv/test/benchmark-ares.c +117 -0
- data/ext/noderb_extension/libuv/test/benchmark-getaddrinfo.c +90 -0
- data/ext/noderb_extension/libuv/test/benchmark-list.h +77 -0
- data/ext/noderb_extension/libuv/test/benchmark-ping-pongs.c +210 -0
- data/ext/noderb_extension/libuv/test/benchmark-pound.c +237 -0
- data/ext/noderb_extension/libuv/test/benchmark-pump.c +459 -0
- data/ext/noderb_extension/libuv/test/benchmark-sizes.c +39 -0
- data/ext/noderb_extension/libuv/test/benchmark-spawn.c +154 -0
- data/ext/noderb_extension/libuv/test/dns-server.c +323 -0
- data/ext/noderb_extension/libuv/test/echo-server.c +299 -0
- data/ext/noderb_extension/libuv/test/run-benchmarks.c +64 -0
- data/ext/noderb_extension/libuv/test/run-tests.c +82 -0
- data/ext/noderb_extension/libuv/test/runner-unix.c +335 -0
- data/ext/noderb_extension/libuv/test/runner-unix.h +36 -0
- data/ext/noderb_extension/libuv/test/runner-win.c +343 -0
- data/ext/noderb_extension/libuv/test/runner-win.h +42 -0
- data/ext/noderb_extension/libuv/test/runner.c +311 -0
- data/ext/noderb_extension/libuv/test/runner.h +155 -0
- data/ext/noderb_extension/libuv/test/task.h +111 -0
- data/ext/noderb_extension/libuv/test/test-async.c +218 -0
- data/ext/noderb_extension/libuv/test/test-callback-stack.c +205 -0
- data/ext/noderb_extension/libuv/test/test-connection-fail.c +149 -0
- data/ext/noderb_extension/libuv/test/test-delayed-accept.c +198 -0
- data/ext/noderb_extension/libuv/test/test-fail-always.c +29 -0
- data/ext/noderb_extension/libuv/test/test-get-currentexe.c +53 -0
- data/ext/noderb_extension/libuv/test/test-getaddrinfo.c +110 -0
- data/ext/noderb_extension/libuv/test/test-gethostbyname.c +192 -0
- data/ext/noderb_extension/libuv/test/test-getsockname.c +196 -0
- data/ext/noderb_extension/libuv/test/test-hrtime.c +51 -0
- data/ext/noderb_extension/libuv/test/test-idle.c +83 -0
- data/ext/noderb_extension/libuv/test/test-list.h +165 -0
- data/ext/noderb_extension/libuv/test/test-loop-handles.c +361 -0
- data/ext/noderb_extension/libuv/test/test-pass-always.c +28 -0
- data/ext/noderb_extension/libuv/test/test-ping-pong.c +256 -0
- data/ext/noderb_extension/libuv/test/test-pipe-bind-error.c +148 -0
- data/ext/noderb_extension/libuv/test/test-ref.c +91 -0
- data/ext/noderb_extension/libuv/test/test-shutdown-eof.c +183 -0
- data/ext/noderb_extension/libuv/test/test-spawn.c +345 -0
- data/ext/noderb_extension/libuv/test/test-tcp-bind-error.c +204 -0
- data/ext/noderb_extension/libuv/test/test-tcp-bind6-error.c +164 -0
- data/ext/noderb_extension/libuv/test/test-tcp-writealot.c +198 -0
- data/ext/noderb_extension/libuv/test/test-timer-again.c +141 -0
- data/ext/noderb_extension/libuv/test/test-timer.c +134 -0
- data/ext/noderb_extension/noderb.c +340 -0
- data/ext/noderb_extension/noderb.h +2 -0
- data/lib/noderb/connection.rb +21 -0
- data/lib/noderb/process.rb +17 -0
- data/lib/noderb.rb +25 -0
- metadata +470 -0
@@ -0,0 +1,451 @@
|
|
1
|
+
=========================================
|
2
|
+
PTHREADS-WIN32 Frequently Asked Questions
|
3
|
+
=========================================
|
4
|
+
|
5
|
+
INDEX
|
6
|
+
-----
|
7
|
+
|
8
|
+
Q 1 What is it?
|
9
|
+
|
10
|
+
Q 2 Which of the several dll versions do I use?
|
11
|
+
or,
|
12
|
+
What are all these pthread*.dll and pthread*.lib files?
|
13
|
+
|
14
|
+
Q 3 What is the library naming convention?
|
15
|
+
|
16
|
+
Q 4 Cleanup code default style or: it used to work when I built
|
17
|
+
the library myself, but now it doesn't - why?
|
18
|
+
|
19
|
+
Q 5 Why is the default library version now less exception-friendly?
|
20
|
+
|
21
|
+
Q 6 Should I use Cygwin or Mingw32 as a development environment?
|
22
|
+
|
23
|
+
Q 7 Now that pthreads-win32 builds under Mingw32, why do I get
|
24
|
+
memory access violations (segfaults)?
|
25
|
+
|
26
|
+
Q 8 How do I use pthread.dll for Win32 (Visual C++ 5.0)
|
27
|
+
|
28
|
+
Q 9 Cancelation doesn't work for me, why?
|
29
|
+
|
30
|
+
Q 10 How do I generate pthreadGCE.dll and libpthreadw32.a for use
|
31
|
+
with Mingw32?
|
32
|
+
|
33
|
+
Q 11 Why isn't pthread_t defined as a scalar (e.g. pointer or int)
|
34
|
+
like it is for other POSIX threads implementations?
|
35
|
+
|
36
|
+
=============================================================================
|
37
|
+
|
38
|
+
Q 1 What is it?
|
39
|
+
---
|
40
|
+
|
41
|
+
Pthreads-win32 is an Open Source Software implementation of the
|
42
|
+
Threads component of the POSIX 1003.1c 1995 Standard for Microsoft's
|
43
|
+
Win32 environment. Some functions from POSIX 1003.1b are also
|
44
|
+
supported including semaphores. Other related functions include
|
45
|
+
the set of read-write lock functions. The library also supports
|
46
|
+
some of the functionality of the Open Group's Single Unix
|
47
|
+
specification, version 2, namely mutex types.
|
48
|
+
|
49
|
+
See the file "ANNOUNCE" for more information including standards
|
50
|
+
conformance details and list of supported routines.
|
51
|
+
|
52
|
+
|
53
|
+
------------------------------------------------------------------------------
|
54
|
+
|
55
|
+
Q 2 Which of the several dll versions do I use?
|
56
|
+
--- or,
|
57
|
+
What are all these pthread*.dll and pthread*.lib files?
|
58
|
+
|
59
|
+
Simply, you only use one of them, but you need to choose carefully.
|
60
|
+
|
61
|
+
The most important choice you need to make is whether to use a
|
62
|
+
version that uses exceptions internally, or not (there are versions
|
63
|
+
of the library that use exceptions as part of the thread
|
64
|
+
cancelation and cleanup implementation, and one that uses
|
65
|
+
setjmp/longjmp instead).
|
66
|
+
|
67
|
+
There is some contension amongst POSIX threads experts as
|
68
|
+
to how POSIX threads cancelation and exit should work
|
69
|
+
with languages that include exceptions and handlers, e.g.
|
70
|
+
C++ and even C (Microsoft's Structured Exceptions).
|
71
|
+
|
72
|
+
The issue is: should cancelation of a thread in, say,
|
73
|
+
a C++ application cause object destructors and C++ exception
|
74
|
+
handlers to be invoked as the stack unwinds during thread
|
75
|
+
exit, or not?
|
76
|
+
|
77
|
+
There seems to be more opinion in favour of using the
|
78
|
+
standard C version of the library (no EH) with C++ applications
|
79
|
+
since this appears to be the assumption commercial pthreads
|
80
|
+
implementations make. Therefore, if you use an EH version
|
81
|
+
of pthreads-win32 then you may be under the illusion that
|
82
|
+
your application will be portable, when in fact it is likely to
|
83
|
+
behave very differently linked with other pthreads libraries.
|
84
|
+
|
85
|
+
Now you may be asking: why have you kept the EH versions of
|
86
|
+
the library?
|
87
|
+
|
88
|
+
There are a couple of reasons:
|
89
|
+
- there is division amongst the experts and so the code may
|
90
|
+
be needed in the future. (Yes, it's in the repository and we
|
91
|
+
can get it out anytime in the future, but ...)
|
92
|
+
- pthreads-win32 is one of the few implementations, and possibly
|
93
|
+
the only freely available one, that has EH versions. It may be
|
94
|
+
useful to people who want to play with or study application
|
95
|
+
behaviour under these conditions.
|
96
|
+
|
97
|
+
|
98
|
+
------------------------------------------------------------------------------
|
99
|
+
|
100
|
+
Q 3 What is the library naming convention?
|
101
|
+
---
|
102
|
+
|
103
|
+
Because the library is being built using various exception
|
104
|
+
handling schemes and compilers - and because the library
|
105
|
+
may not work reliably if these are mixed in an application,
|
106
|
+
each different version of the library has it's own name.
|
107
|
+
|
108
|
+
Note 1: the incompatibility is really between EH implementations
|
109
|
+
of the different compilers. It should be possible to use the
|
110
|
+
standard C version from either compiler with C++ applications
|
111
|
+
built with a different compiler. If you use an EH version of
|
112
|
+
the library, then you must use the same compiler for the
|
113
|
+
application. This is another complication and dependency that
|
114
|
+
can be avoided by using only the standard C library version.
|
115
|
+
|
116
|
+
Note 2: if you use a standard C pthread*.dll with a C++
|
117
|
+
application, then any functions that you define that are
|
118
|
+
intended to be called via pthread_cleanup_push() must be
|
119
|
+
__cdecl.
|
120
|
+
|
121
|
+
Note 3: the intention is to also name either the VC or GC
|
122
|
+
version (it should be arbitrary) as pthread.dll, including
|
123
|
+
pthread.lib and libpthread.a as appropriate.
|
124
|
+
|
125
|
+
In general:
|
126
|
+
pthread[VG]{SE,CE,C}.dll
|
127
|
+
pthread[VG]{SE,CE,C}.lib
|
128
|
+
|
129
|
+
where:
|
130
|
+
[VG] indicates the compiler
|
131
|
+
V - MS VC
|
132
|
+
G - GNU C
|
133
|
+
|
134
|
+
{SE,CE,C} indicates the exception handling scheme
|
135
|
+
SE - Structured EH
|
136
|
+
CE - C++ EH
|
137
|
+
C - no exceptions - uses setjmp/longjmp
|
138
|
+
|
139
|
+
For example:
|
140
|
+
pthreadVSE.dll (MSVC/SEH)
|
141
|
+
pthreadGCE.dll (GNUC/C++ EH)
|
142
|
+
pthreadGC.dll (GNUC/not dependent on exceptions)
|
143
|
+
|
144
|
+
The GNU library archive file names have changed to:
|
145
|
+
|
146
|
+
libpthreadGCE.a
|
147
|
+
libpthreadGC.a
|
148
|
+
|
149
|
+
|
150
|
+
------------------------------------------------------------------------------
|
151
|
+
|
152
|
+
Q 4 Cleanup code default style or: it used to work when I built
|
153
|
+
--- the library myself, but now it doesn't - why?
|
154
|
+
|
155
|
+
Up to and including snapshot 2001-07-12, if not defined, the cleanup
|
156
|
+
style was determined automatically from the compiler used, and one
|
157
|
+
of the following was defined accordingly:
|
158
|
+
|
159
|
+
__CLEANUP_SEH MSVC only
|
160
|
+
__CLEANUP_CXX C++, including MSVC++, GNU G++
|
161
|
+
__CLEANUP_C C, including GNU GCC, not MSVC
|
162
|
+
|
163
|
+
These defines determine the style of cleanup (see pthread.h) and,
|
164
|
+
most importantly, the way that cancelation and thread exit (via
|
165
|
+
pthread_exit) is performed (see the routine ptw32_throw() in private.c).
|
166
|
+
|
167
|
+
In short, the exceptions versions of the library throw an exception
|
168
|
+
when a thread is canceled or exits (via pthread_exit()), which is
|
169
|
+
caught by a handler in the thread startup routine, so that the
|
170
|
+
the correct stack unwinding occurs regardless of where the thread
|
171
|
+
is when it's canceled or exits via pthread_exit().
|
172
|
+
|
173
|
+
After snapshot 2001-07-12, unless your build explicitly defines (e.g.
|
174
|
+
via a compiler option) __CLEANUP_SEH, __CLEANUP_CXX, or __CLEANUP_C, then
|
175
|
+
the build now ALWAYS defaults to __CLEANUP_C style cleanup. This style
|
176
|
+
uses setjmp/longjmp in the cancelation and pthread_exit implementations,
|
177
|
+
and therefore won't do stack unwinding even when linked to applications
|
178
|
+
that have it (e.g. C++ apps). This is for consistency with most/all
|
179
|
+
commercial Unix POSIX threads implementations.
|
180
|
+
|
181
|
+
Although it was not clearly documented before, it is still necessary to
|
182
|
+
build your application using the same __CLEANUP_* define as was
|
183
|
+
used for the version of the library that you link with, so that the
|
184
|
+
correct parts of pthread.h are included. That is, the possible
|
185
|
+
defines require the following library versions:
|
186
|
+
|
187
|
+
__CLEANUP_SEH pthreadVSE.dll
|
188
|
+
__CLEANUP_CXX pthreadVCE.dll or pthreadGCE.dll
|
189
|
+
__CLEANUP_C pthreadVC.dll or pthreadGC.dll
|
190
|
+
|
191
|
+
THE POINT OF ALL THIS IS: if you have not been defining one of these
|
192
|
+
explicitly, then the defaults have been set according to the compiler
|
193
|
+
and language you are using, as described at the top of this
|
194
|
+
section.
|
195
|
+
|
196
|
+
THIS NOW CHANGES, as has been explained above. For example:
|
197
|
+
|
198
|
+
If you were building your application with MSVC++ i.e. using C++
|
199
|
+
exceptions (rather than SEH) and not explicitly defining one of
|
200
|
+
__CLEANUP_*, then __CLEANUP_C++ was defined for you in pthread.h.
|
201
|
+
You should have been linking with pthreadVCE.dll, which does
|
202
|
+
stack unwinding.
|
203
|
+
|
204
|
+
If you now build your application as you had before, pthread.h will now
|
205
|
+
set __CLEANUP_C as the default style, and you will need to link
|
206
|
+
with pthreadVC.dll. Stack unwinding will now NOT occur when a
|
207
|
+
thread is canceled, nor when the thread calls pthread_exit().
|
208
|
+
|
209
|
+
Your application will now most likely behave differently to previous
|
210
|
+
versions, and in non-obvious ways. Most likely is that local
|
211
|
+
objects may not be destroyed or cleaned up after a thread
|
212
|
+
is canceled.
|
213
|
+
|
214
|
+
If you want the same behaviour as before, then you must now define
|
215
|
+
__CLEANUP_C++ explicitly using a compiler option and link with
|
216
|
+
pthreadVCE.dll as you did before.
|
217
|
+
|
218
|
+
|
219
|
+
------------------------------------------------------------------------------
|
220
|
+
|
221
|
+
Q 5 Why is the default library version now less exception-friendly?
|
222
|
+
---
|
223
|
+
|
224
|
+
Because most commercial Unix POSIX threads implementations don't allow you to
|
225
|
+
choose to have stack unwinding. (Compaq's TRU64 Unix is possibly an exception.)
|
226
|
+
|
227
|
+
Therefore, providing it in pthread-win32 as a default could be dangerous
|
228
|
+
and non-portable. We still provide the choice but you must now consciously
|
229
|
+
make it.
|
230
|
+
|
231
|
+
WHY NOT REMOVE THE EXCEPTIONS VERSIONS OF THE LIBRARY ALTOGETHER?
|
232
|
+
There are a few reasons:
|
233
|
+
- because there are well respected POSIX threads people who believe
|
234
|
+
that POSIX threads implementations should be exceptions-aware and
|
235
|
+
do the expected thing in that context. (There are equally respected
|
236
|
+
people who believe it should not be easily accessible, if it's there
|
237
|
+
at all.)
|
238
|
+
- because pthreads-win32 is one of the few implementations that has
|
239
|
+
the choice, perhaps the only freely available one, and so offers
|
240
|
+
a laboratory to people who may want to explore the effects;
|
241
|
+
- although the code will always be around somewhere for anyone who
|
242
|
+
wants it, once it's removed from the current version it will not be
|
243
|
+
nearly as visible to people who may have a use for it.
|
244
|
+
|
245
|
+
|
246
|
+
------------------------------------------------------------------------------
|
247
|
+
|
248
|
+
Q 6 Should I use Cygwin or Mingw32 as a development environment?
|
249
|
+
---
|
250
|
+
|
251
|
+
Important: see Q7 also.
|
252
|
+
|
253
|
+
Use Mingw32 with the MSVCRT library to build applications that use
|
254
|
+
the pthreads DLL.
|
255
|
+
|
256
|
+
Cygwin's own internal support for POSIX threads is growing.
|
257
|
+
Consult that project's documentation for more information.
|
258
|
+
|
259
|
+
------------------------------------------------------------------------------
|
260
|
+
|
261
|
+
Q 7 Now that pthreads-win32 builds under Mingw32, why do I get
|
262
|
+
--- memory access violations (segfaults)?
|
263
|
+
|
264
|
+
The latest Mingw32 package has thread-safe exception handling (see Q10).
|
265
|
+
Also, see Q6 above.
|
266
|
+
|
267
|
+
------------------------------------------------------------------------------
|
268
|
+
|
269
|
+
Q 8 How do I use pthread.dll for Win32 (Visual C++ 5.0)
|
270
|
+
---
|
271
|
+
|
272
|
+
>
|
273
|
+
> I'm a "rookie" when it comes to your pthread implementation. I'm currently
|
274
|
+
> desperately trying to install the prebuilt .dll file into my MSVC compiler.
|
275
|
+
> Could you please provide me with explicit instructions on how to do this (or
|
276
|
+
> direct me to a resource(s) where I can acquire such information)?
|
277
|
+
>
|
278
|
+
> Thank you,
|
279
|
+
>
|
280
|
+
|
281
|
+
You should have a .dll, .lib, .def, and three .h files. It is recommended
|
282
|
+
that you use pthreadVC.dll, rather than pthreadVCE.dll or pthreadVSE.dll
|
283
|
+
(see Q2 above).
|
284
|
+
|
285
|
+
The .dll can go in any directory listed in your PATH environment
|
286
|
+
variable, so putting it into C:\WINDOWS should work.
|
287
|
+
|
288
|
+
The .lib file can go in any directory listed in your LIB environment
|
289
|
+
variable.
|
290
|
+
|
291
|
+
The .h files can go in any directory listed in your INCLUDE
|
292
|
+
environment variable.
|
293
|
+
|
294
|
+
Or you might prefer to put the .lib and .h files into a new directory
|
295
|
+
and add its path to LIB and INCLUDE. You can probably do this easiest
|
296
|
+
by editing the file:-
|
297
|
+
|
298
|
+
C:\Program Files\DevStudio\vc\bin\vcvars32.bat
|
299
|
+
|
300
|
+
The .def file isn't used by anything in the pre-compiled version but
|
301
|
+
is included for information.
|
302
|
+
|
303
|
+
Cheers.
|
304
|
+
Ross
|
305
|
+
|
306
|
+
------------------------------------------------------------------------------
|
307
|
+
|
308
|
+
Q 9 Cancelation doesn't work for me, why?
|
309
|
+
---
|
310
|
+
|
311
|
+
> I'm investigating a problem regarding thread cancelation. The thread I want
|
312
|
+
> to cancel has PTHREAD_CANCEL_ASYNCHRONOUS, however, this piece of code
|
313
|
+
> blocks on the join():
|
314
|
+
>
|
315
|
+
> if ((retv = Pthread_cancel( recvThread )) == 0)
|
316
|
+
> {
|
317
|
+
> retv = Pthread_join( recvThread, 0 );
|
318
|
+
> }
|
319
|
+
>
|
320
|
+
> Pthread_* are just macro's; they call pthread_*.
|
321
|
+
>
|
322
|
+
> The thread recvThread seems to block on a select() call. It doesn't get
|
323
|
+
> cancelled.
|
324
|
+
>
|
325
|
+
> Two questions:
|
326
|
+
>
|
327
|
+
> 1) is this normal behaviour?
|
328
|
+
>
|
329
|
+
> 2) if not, how does the cancel mechanism work? I'm not very familliar to
|
330
|
+
> win32 programming, so I don't really understand how the *Event() family of
|
331
|
+
> calls work.
|
332
|
+
|
333
|
+
The answer to your first question is, normal POSIX behaviour would
|
334
|
+
be to asynchronously cancel the thread. However, even that doesn't
|
335
|
+
guarantee cancelation as the standard only says it should be
|
336
|
+
cancelled as soon as possible.
|
337
|
+
|
338
|
+
Snapshot 99-11-02 or earlier only partially supports asynchronous cancellation.
|
339
|
+
Snapshots since then simulate async cancelation by poking the address of
|
340
|
+
a cancelation routine into the PC of the threads context. This requires
|
341
|
+
the thread to be resumed in some way for the cancelation to actually
|
342
|
+
proceed. This is not true async cancelation, but it is as close as we've
|
343
|
+
been able to get to it.
|
344
|
+
|
345
|
+
If the thread you're trying to cancel is blocked (for instance, it could be
|
346
|
+
waiting for data from the network), it will only get cancelled when it unblocks
|
347
|
+
(when the data arrives). For true pre-emptive cancelation in these cases,
|
348
|
+
pthreads-win32 from snapshot 2004-05-16 can automatically recognise and use the
|
349
|
+
QueueUserAPCEx package by Panagiotis E. Hadjidoukas. This package is available
|
350
|
+
from the pthreads-win32 ftp site and is included in the pthreads-win32
|
351
|
+
self-unpacking zip from 2004-05-16 onwards.
|
352
|
+
|
353
|
+
Using deferred cancelation would normally be the way to go, however,
|
354
|
+
even though the POSIX threads standard lists a number of C library
|
355
|
+
functions that are defined as deferred cancelation points, there is
|
356
|
+
no hookup between those which are provided by Windows and the
|
357
|
+
pthreads-win32 library.
|
358
|
+
|
359
|
+
Incidently, it's worth noting for code portability that the older POSIX
|
360
|
+
threads standards cancelation point lists didn't include "select" because
|
361
|
+
(as I read in Butenhof) it wasn't part of POSIX. However, it does appear in
|
362
|
+
the SUSV3.
|
363
|
+
|
364
|
+
Effectively, the only mandatory cancelation points that pthreads-win32
|
365
|
+
recognises are those the library implements itself, ie.
|
366
|
+
|
367
|
+
pthread_testcancel
|
368
|
+
pthread_cond_wait
|
369
|
+
pthread_cond_timedwait
|
370
|
+
pthread_join
|
371
|
+
sem_wait
|
372
|
+
sem_timedwait
|
373
|
+
pthread_delay_np
|
374
|
+
|
375
|
+
The following routines from the non-mandatory list in SUSV3 are
|
376
|
+
cancelation points in pthreads-win32:
|
377
|
+
|
378
|
+
pthread_rwlock_wrlock
|
379
|
+
pthread_rwlock_timedwrlock
|
380
|
+
|
381
|
+
The following routines from the non-mandatory list in SUSV3 are not
|
382
|
+
cancelation points in pthreads-win32:
|
383
|
+
|
384
|
+
pthread_rwlock_rdlock
|
385
|
+
pthread_rwlock_timedrdlock
|
386
|
+
|
387
|
+
Pthreads-win32 also provides two functions that allow you to create
|
388
|
+
cancelation points within your application, but only for cases where
|
389
|
+
a thread is going to block on a Win32 handle. These are:
|
390
|
+
|
391
|
+
pthreadCancelableWait(HANDLE waitHandle) /* Infinite wait */
|
392
|
+
|
393
|
+
pthreadCancelableTimedWait(HANDLE waitHandle, DWORD timeout)
|
394
|
+
|
395
|
+
------------------------------------------------------------------------------
|
396
|
+
|
397
|
+
|
398
|
+
Q 10 How do I create thread-safe applications using
|
399
|
+
---- pthreadGCE.dll, libpthreadw32.a and Mingw32?
|
400
|
+
|
401
|
+
This should not be a problem with recent versions of MinGW32.
|
402
|
+
|
403
|
+
For early versions, see Thomas Pfaff's email at:
|
404
|
+
http://sources.redhat.com/ml/pthreads-win32/2002/msg00000.html
|
405
|
+
------------------------------------------------------------------------------
|
406
|
+
|
407
|
+
Q 11 Why isn't pthread_t defined as a scalar (e.g. pointer or int)
|
408
|
+
like it is for other POSIX threads implementations?
|
409
|
+
----
|
410
|
+
|
411
|
+
Originally pthread_t was defined as a pointer (to the opaque pthread_t_
|
412
|
+
struct) and later it was changed to a struct containing the original
|
413
|
+
pointer plus a sequence counter. This is allowed under both the original
|
414
|
+
POSIX Threads Standard and the current Single Unix Specification.
|
415
|
+
|
416
|
+
When pthread_t is a simple pointer to a struct some very difficult to
|
417
|
+
debug problems arise from the process of freeing and later allocing
|
418
|
+
thread structs because new pthread_t handles can acquire the identity of
|
419
|
+
previously detached threads. The change to a struct was made, along with
|
420
|
+
some changes to their internal managment, in order to guarantee (for
|
421
|
+
practical applications) that the pthread_t handle will be unique over the
|
422
|
+
life of the running process.
|
423
|
+
|
424
|
+
Where application code attempts to compare one pthread_t against another
|
425
|
+
directly, a compiler error will be emitted because structs can't be
|
426
|
+
compared at that level. This should signal a potentially serious problem
|
427
|
+
in the code design, which would go undetected if pthread_t was a scalar.
|
428
|
+
|
429
|
+
The POSIX Threading API provides a function named pthread_equal() to
|
430
|
+
compare pthread_t thread handles.
|
431
|
+
|
432
|
+
Other pthreads implementations, such as Sun's, use an int as the handle
|
433
|
+
but do guarantee uniqueness within the process scope. Win32 scalar typed
|
434
|
+
thread handles also guarantee uniqueness in system scope. It wasn't clear
|
435
|
+
how well the internal management of these handles would scale as the
|
436
|
+
number of threads and the fragmentation of the sequence numbering
|
437
|
+
increased for applications where thousands or millions of threads are
|
438
|
+
created and detached over time. The current management of threads within
|
439
|
+
pthreads-win32 using structs for pthread_t, and reusing without ever
|
440
|
+
freeing them, reduces the management time overheads to a constant, which
|
441
|
+
could be important given that pthreads-win32 threads are built on top of
|
442
|
+
Win32 threads and will therefore include that management overhead on top
|
443
|
+
of their own. The cost is that the memory resources used for thread
|
444
|
+
handles will remain at the peak level until the process exits.
|
445
|
+
|
446
|
+
While it may be inconvenient for developers to be forced away from making
|
447
|
+
assumptions about the internals of pthread_t, the advantage for the
|
448
|
+
future development of pthread-win32, as well as those applications that
|
449
|
+
use it and other pthread implementations, is that the library is free to
|
450
|
+
change pthread_t internals and management as better methods arise.
|
451
|
+
|