'\"
'\" Copyright (c) 1989-1993 The Regents of the University of California.
'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
.TH Tcl_AsyncCreate 3 7.0 Tcl "Tcl Library Procedures"
.so man.macros
.BS
.SH NAME
Tcl_AsyncCreate, Tcl_AsyncMark, Tcl_AsyncInvoke, Tcl_AsyncDelete, Tcl_AsyncReady \- handle asynchronous events
.SH SYNOPSIS
.nf
\fB#include <tcl.h>\fR
.sp
Tcl_AsyncHandler
\fBTcl_AsyncCreate\fR(\fIproc, clientData\fR)
.sp
\fBTcl_AsyncMark\fR(\fIasync\fR)


.sp
int
\fBTcl_AsyncInvoke\fR(\fIinterp, code\fR)
.sp
\fBTcl_AsyncDelete\fR(\fIasync\fR)
.sp
int
\fBTcl_AsyncReady\fR()
.SH ARGUMENTS
.AS Tcl_AsyncHandler clientData
.AP Tcl_AsyncProc *proc in
Procedure to invoke to handle an asynchronous event.
.AP ClientData clientData in
One-word value to pass to \fIproc\fR.
.AP Tcl_AsyncHandler async in
Token for asynchronous event handler.


.AP Tcl_Interp *interp in
Tcl interpreter in which command was being evaluated when handler was
invoked, or NULL if handler was invoked when there was no interpreter
active.
.AP int code in
Completion code from command that just completed in \fIinterp\fR,
or 0 if \fIinterp\fR is NULL.

allocation could have been in progress when the event occurred.
The only safe approach is to set a flag indicating that the event
occurred, then handle the event later when the world has returned
to a clean state, such as after the current Tcl command completes.
.PP
\fBTcl_AsyncCreate\fR, \fBTcl_AsyncDelete\fR, and \fBTcl_AsyncReady\fR
are thread sensitive.  They access and/or set a thread-specific data
structure in the event of a core built with \fI\-\-enable\-threads\fR.  The token
created by \fBTcl_AsyncCreate\fR contains the needed thread information it
was called from so that calling \fBTcl_AsyncMark\fR(\fItoken\fR) will only yield

the origin thread into the asynchronous handler.
.PP
\fBTcl_AsyncCreate\fR creates an asynchronous handler and returns
a token for it.
The asynchronous handler must be created before
any occurrences of the asynchronous event that it is intended
to handle (it is not safe to create a handler at the time of
an event).
When an asynchronous event occurs the code that detects the event
(such as a signal handler) should call \fBTcl_AsyncMark\fR with the
token for the handler.
\fBTcl_AsyncMark\fR will mark the handler as ready to execute, but it

will not invoke the handler immediately.
Tcl will call the \fIproc\fR associated with the handler later, when
the world is in a safe state, and \fIproc\fR can then carry out
the actions associated with the asynchronous event.
\fIProc\fR should have arguments and result that match the
type \fBTcl_AsyncProc\fR:
.PP
.CS
typedef int \fBTcl_AsyncProc\fR(
        ClientData \fIclientData\fR,
        Tcl_Interp *\fIinterp\fR,

}

# TIP #400
declare 630 {
    void Tcl_ZlibStreamSetCompressionDictionary(Tcl_ZlibStream zhandle,
	    Tcl_Obj *compressionDictionaryObj)
}





# ----- BASELINE -- FOR -- 8.6.0 ----- #

##############################################################################

# Define the platform specific public Tcl interface. These functions are only
# available on the designated platform.

void
Tcl_AsyncMark(
    Tcl_AsyncHandler async)		/* Token for handler. */
{
    AsyncHandler *token = (AsyncHandler *) async;

    if (TclAsyncInNotifier(&token->ready, -1)) {
	return;
    }
    Tcl_MutexLock(&asyncMutex);
    token->ready = 1;
    if (!token->originTsd->asyncActive) {
	token->originTsd->asyncReady = 1;
	Tcl_ThreadAlert(token->originThrdId);
    }
    Tcl_MutexUnlock(&asyncMutex);

}

































/*
 *----------------------------------------------------------------------
 *
 * TclAsyncMarkFromNotifier --
 *
 *	This procedure is called from the notifier thread and

/* 629 */
EXTERN int		Tcl_FSUnloadFile(Tcl_Interp *interp,
				Tcl_LoadHandle handlePtr);
/* 630 */
EXTERN void		Tcl_ZlibStreamSetCompressionDictionary(
				Tcl_ZlibStream zhandle,
				Tcl_Obj *compressionDictionaryObj);




typedef struct {
    const struct TclPlatStubs *tclPlatStubs;
    const struct TclIntStubs *tclIntStubs;
    const struct TclIntPlatStubs *tclIntPlatStubs;
} TclStubHooks;

    int (*tcl_CloseEx) (Tcl_Interp *interp, Tcl_Channel chan, int flags); /* 624 */
    int (*tcl_NRExprObj) (Tcl_Interp *interp, Tcl_Obj *objPtr, Tcl_Obj *resultPtr); /* 625 */
    int (*tcl_NRSubstObj) (Tcl_Interp *interp, Tcl_Obj *objPtr, int flags); /* 626 */
    int (*tcl_LoadFile) (Tcl_Interp *interp, Tcl_Obj *pathPtr, const char *const symv[], int flags, void *procPtrs, Tcl_LoadHandle *handlePtr); /* 627 */
    void * (*tcl_FindSymbol) (Tcl_Interp *interp, Tcl_LoadHandle handle, const char *symbol); /* 628 */
    int (*tcl_FSUnloadFile) (Tcl_Interp *interp, Tcl_LoadHandle handlePtr); /* 629 */
    void (*tcl_ZlibStreamSetCompressionDictionary) (Tcl_ZlibStream zhandle, Tcl_Obj *compressionDictionaryObj); /* 630 */

} TclStubs;

extern const TclStubs *tclStubsPtr;

#ifdef __cplusplus
}
#endif

	(tclStubsPtr->tcl_LoadFile) /* 627 */
#define Tcl_FindSymbol \
	(tclStubsPtr->tcl_FindSymbol) /* 628 */
#define Tcl_FSUnloadFile \
	(tclStubsPtr->tcl_FSUnloadFile) /* 629 */
#define Tcl_ZlibStreamSetCompressionDictionary \
	(tclStubsPtr->tcl_ZlibStreamSetCompressionDictionary) /* 630 */



#endif /* defined(USE_TCL_STUBS) */

/* !END!: Do not edit above this line. */

#if defined(USE_TCL_STUBS)
#   undef Tcl_CreateInterp

declare 30 {win unix} {
    int TclUnixOpenTemporaryFile(Tcl_Obj *dirObj, Tcl_Obj *basenameObj,
	    Tcl_Obj *extensionObj, Tcl_Obj *resultingNameObj)
}
# TIP#302 ???
declare 31 {win unix macosx} {
    int TclpGetMonotonicTime(Tcl_Time *timePtr)

declare 32 {win unix macosx} {
    int TclpSigProcMask(int how, const void *set, void *oldset)
}


# Local Variables:
# mode: tcl
# End:

MODULE_SCOPE void	TclArgumentBCEnter(Tcl_Interp *interp,
			    Tcl_Obj *objv[], int objc,
			    void *codePtr, CmdFrame *cfPtr, int cmd, int pc);
MODULE_SCOPE void	TclArgumentBCRelease(Tcl_Interp *interp,
			    CmdFrame *cfPtr);
MODULE_SCOPE void	TclArgumentGet(Tcl_Interp *interp, Tcl_Obj *obj,
			    CmdFrame **cfPtrPtr, int *wordPtr);

MODULE_SCOPE int	TclAsyncInNotifier(int *flagPtr, int value);
MODULE_SCOPE void	TclAsyncMarkFromNotifier(void);
MODULE_SCOPE double	TclBignumToDouble(const mp_int *bignum);
MODULE_SCOPE int	TclByteArrayMatch(const unsigned char *string,
			    int strLen, const unsigned char *pattern,
			    int ptnLen, int flags);
MODULE_SCOPE double	TclCeil(const mp_int *a);
MODULE_SCOPE void	TclChannelPreserve(Tcl_Channel chan);

EXTERN int		TclWinCPUID(unsigned int index, unsigned int *regs);
/* 30 */
EXTERN int		TclUnixOpenTemporaryFile(Tcl_Obj *dirObj,
				Tcl_Obj *basenameObj, Tcl_Obj *extensionObj,
				Tcl_Obj *resultingNameObj);
/* 31 */
EXTERN int		TclpGetMonotonicTime(Tcl_Time *timePtr);
/* 32 */
EXTERN int		TclpSigProcMask(int how, const void *set, void *oldset);
#endif /* UNIX */
#if defined(_WIN32) || defined(__CYGWIN__) /* WIN */
/* 0 */
EXTERN void		TclWinConvertError(DWORD errCode);
/* 1 */
EXTERN void		TclWinConvertWSAError(DWORD errCode);
/* 2 */

EXTERN int		TclWinCPUID(unsigned int index, unsigned int *regs);
/* 30 */
EXTERN int		TclUnixOpenTemporaryFile(Tcl_Obj *dirObj,
				Tcl_Obj *basenameObj, Tcl_Obj *extensionObj,
				Tcl_Obj *resultingNameObj);
/* 31 */
EXTERN int		TclpGetMonotonicTime(Tcl_Time *timePtr);
/* 32 */
EXTERN int		TclpSigProcMask(int how, const void *set, void *oldset);
#endif /* WIN */
#ifdef MAC_OSX_TCL /* MACOSX */
/* 0 */
EXTERN void		TclGetAndDetachPids(Tcl_Interp *interp,
				Tcl_Channel chan);
/* 1 */
EXTERN int		TclpCloseFile(TclFile file);

EXTERN int		TclWinCPUID(unsigned int index, unsigned int *regs);
/* 30 */
EXTERN int		TclUnixOpenTemporaryFile(Tcl_Obj *dirObj,
				Tcl_Obj *basenameObj, Tcl_Obj *extensionObj,
				Tcl_Obj *resultingNameObj);
/* 31 */
EXTERN int		TclpGetMonotonicTime(Tcl_Time *timePtr);
/* 32 */
EXTERN int		TclpSigProcMask(int how, const void *set, void *oldset);
#endif /* MACOSX */

typedef struct TclIntPlatStubs {
    int magic;
    void *hooks;

#if !defined(_WIN32) && !defined(__CYGWIN__) && !defined(MAC_OSX_TCL) /* UNIX */

    void (*reserved25)(void);
    void (*reserved26)(void);
    void (*reserved27)(void);
    void (*reserved28)(void);
    int (*tclWinCPUID) (unsigned int index, unsigned int *regs); /* 29 */
    int (*tclUnixOpenTemporaryFile) (Tcl_Obj *dirObj, Tcl_Obj *basenameObj, Tcl_Obj *extensionObj, Tcl_Obj *resultingNameObj); /* 30 */
    int (*tclpGetMonotonicTime) (Tcl_Time *timePtr); /* 31 */
    int (*tclpSigProcMask) (int how, const void *set, void *oldset); /* 32 */
#endif /* UNIX */
#if defined(_WIN32) || defined(__CYGWIN__) /* WIN */
    void (*tclWinConvertError) (DWORD errCode); /* 0 */
    void (*tclWinConvertWSAError) (DWORD errCode); /* 1 */
    struct servent * (*tclWinGetServByName) (const char *nm, const char *proto); /* 2 */
    int (*tclWinGetSockOpt) (SOCKET s, int level, int optname, char *optval, int *optlen); /* 3 */
    HINSTANCE (*tclWinGetTclInstance) (void); /* 4 */

    void (*reserved25)(void);
    void (*tclWinSetInterfaces) (int wide); /* 26 */
    void (*tclWinFlushDirtyChannels) (void); /* 27 */
    void (*tclWinResetInterfaces) (void); /* 28 */
    int (*tclWinCPUID) (unsigned int index, unsigned int *regs); /* 29 */
    int (*tclUnixOpenTemporaryFile) (Tcl_Obj *dirObj, Tcl_Obj *basenameObj, Tcl_Obj *extensionObj, Tcl_Obj *resultingNameObj); /* 30 */
    int (*tclpGetMonotonicTime) (Tcl_Time *timePtr); /* 31 */
    int (*tclpSigProcMask) (int how, const void *set, void *oldset); /* 32 */
#endif /* WIN */
#ifdef MAC_OSX_TCL /* MACOSX */
    void (*tclGetAndDetachPids) (Tcl_Interp *interp, Tcl_Channel chan); /* 0 */
    int (*tclpCloseFile) (TclFile file); /* 1 */
    Tcl_Channel (*tclpCreateCommandChannel) (TclFile readFile, TclFile writeFile, TclFile errorFile, int numPids, Tcl_Pid *pidPtr); /* 2 */
    int (*tclpCreatePipe) (TclFile *readPipe, TclFile *writePipe); /* 3 */
    int (*tclpCreateProcess) (Tcl_Interp *interp, int argc, const char **argv, TclFile inputFile, TclFile outputFile, TclFile errorFile, Tcl_Pid *pidPtr); /* 4 */

    void (*reserved25)(void);
    void (*reserved26)(void);
    void (*reserved27)(void);
    void (*reserved28)(void);
    int (*tclWinCPUID) (unsigned int index, unsigned int *regs); /* 29 */
    int (*tclUnixOpenTemporaryFile) (Tcl_Obj *dirObj, Tcl_Obj *basenameObj, Tcl_Obj *extensionObj, Tcl_Obj *resultingNameObj); /* 30 */
    int (*tclpGetMonotonicTime) (Tcl_Time *timePtr); /* 31 */
    int (*tclpSigProcMask) (int how, const void *set, void *oldset); /* 32 */
#endif /* MACOSX */
} TclIntPlatStubs;

extern const TclIntPlatStubs *tclIntPlatStubsPtr;

#ifdef __cplusplus
}

/* Slot 28 is reserved */
#define TclWinCPUID \
	(tclIntPlatStubsPtr->tclWinCPUID) /* 29 */
#define TclUnixOpenTemporaryFile \
	(tclIntPlatStubsPtr->tclUnixOpenTemporaryFile) /* 30 */
#define TclpGetMonotonicTime \
	(tclIntPlatStubsPtr->tclpGetMonotonicTime) /* 31 */
#define TclpSigProcMask \
	(tclIntPlatStubsPtr->tclpSigProcMask) /* 32 */
#endif /* UNIX */
#if defined(_WIN32) || defined(__CYGWIN__) /* WIN */
#define TclWinConvertError \
	(tclIntPlatStubsPtr->tclWinConvertError) /* 0 */
#define TclWinConvertWSAError \
	(tclIntPlatStubsPtr->tclWinConvertWSAError) /* 1 */
#define TclWinGetServByName \

	(tclIntPlatStubsPtr->tclWinResetInterfaces) /* 28 */
#define TclWinCPUID \
	(tclIntPlatStubsPtr->tclWinCPUID) /* 29 */
#define TclUnixOpenTemporaryFile \
	(tclIntPlatStubsPtr->tclUnixOpenTemporaryFile) /* 30 */
#define TclpGetMonotonicTime \
	(tclIntPlatStubsPtr->tclpGetMonotonicTime) /* 31 */
#define TclpSigProcMask \
	(tclIntPlatStubsPtr->tclpSigProcMask) /* 32 */
#endif /* WIN */
#ifdef MAC_OSX_TCL /* MACOSX */
#define TclGetAndDetachPids \
	(tclIntPlatStubsPtr->tclGetAndDetachPids) /* 0 */
#define TclpCloseFile \
	(tclIntPlatStubsPtr->tclpCloseFile) /* 1 */
#define TclpCreateCommandChannel \

/* Slot 28 is reserved */
#define TclWinCPUID \
	(tclIntPlatStubsPtr->tclWinCPUID) /* 29 */
#define TclUnixOpenTemporaryFile \
	(tclIntPlatStubsPtr->tclUnixOpenTemporaryFile) /* 30 */
#define TclpGetMonotonicTime \
	(tclIntPlatStubsPtr->tclpGetMonotonicTime) /* 31 */
#define TclpSigProcMask \
	(tclIntPlatStubsPtr->tclpSigProcMask) /* 32 */
#endif /* MACOSX */

#endif /* defined(USE_TCL_STUBS) */

/* !END!: Do not edit above this line. */

#undef TCL_STORAGE_CLASS

	tsdPtr->clientData = Tcl_InitNotifier();
	tsdPtr->initialized = 1;
	tsdPtr->nextPtr = firstNotifierPtr;
	firstNotifierPtr = tsdPtr;
    }
    Tcl_MutexUnlock(&listLock);

#if !defined(_WIN32) && !defined(ANDROID)
    /*
     * Kick off notifier thread if it is not running already.
     * Needed for proper setup of signal masks.
     */
    Tcl_SetServiceMode(TCL_SERVICE_ALL);
#endif
}

/*
 *----------------------------------------------------------------------

    0, /* 25 */
    0, /* 26 */
    0, /* 27 */
    0, /* 28 */
    TclWinCPUID, /* 29 */
    TclUnixOpenTemporaryFile, /* 30 */
    TclpGetMonotonicTime, /* 31 */
    TclpSigProcMask, /* 32 */
#endif /* UNIX */
#if defined(_WIN32) || defined(__CYGWIN__) /* WIN */
    TclWinConvertError, /* 0 */
    TclWinConvertWSAError, /* 1 */
    TclWinGetServByName, /* 2 */
    TclWinGetSockOpt, /* 3 */
    TclWinGetTclInstance, /* 4 */

    0, /* 25 */
    TclWinSetInterfaces, /* 26 */
    TclWinFlushDirtyChannels, /* 27 */
    TclWinResetInterfaces, /* 28 */
    TclWinCPUID, /* 29 */
    TclUnixOpenTemporaryFile, /* 30 */
    TclpGetMonotonicTime, /* 31 */
    TclpSigProcMask, /* 32 */
#endif /* WIN */
#ifdef MAC_OSX_TCL /* MACOSX */
    TclGetAndDetachPids, /* 0 */
    TclpCloseFile, /* 1 */
    TclpCreateCommandChannel, /* 2 */
    TclpCreatePipe, /* 3 */
    TclpCreateProcess, /* 4 */

    0, /* 25 */
    0, /* 26 */
    0, /* 27 */
    0, /* 28 */
    TclWinCPUID, /* 29 */
    TclUnixOpenTemporaryFile, /* 30 */
    TclpGetMonotonicTime, /* 31 */
    TclpSigProcMask, /* 32 */
#endif /* MACOSX */
};

static const TclPlatStubs tclPlatStubs = {
    TCL_STUB_MAGIC,
    0,
#if defined(_WIN32) || defined(__CYGWIN__) /* WIN */

    Tcl_CloseEx, /* 624 */
    Tcl_NRExprObj, /* 625 */
    Tcl_NRSubstObj, /* 626 */
    Tcl_LoadFile, /* 627 */
    Tcl_FindSymbol, /* 628 */
    Tcl_FSUnloadFile, /* 629 */
    Tcl_ZlibStreamSetCompressionDictionary, /* 630 */

};

/* !END!: Do not edit above this line. */

/*
 * Signal mask information for notifier thread.
 */
static sigset_t notifierSigMask;
static sigset_t allSigMask;

/*
 * Structure for TclpSigProcMask() rendez-vous with notifier thread.
 * Protected by NOTIFIER_INIT_LOCK, sigMaskMutex, and sigMaskCV.
 */

static pthread_mutex_t sigMaskMutex = PTHREAD_MUTEX_INITIALIZER;
static pthread_cond_t sigMaskCV = PTHREAD_COND_INITIALIZER;

static struct {
    int run;			/* Run state flag. */
    int ret;			/* Return code of pthread_sigmask(). */
    int how;			/* 1st argument for pthread_sigmask(). */
    const sigset_t *set;	/* 2nd argument for pthread_sigmask(). */
    sigset_t *oldset;		/* 3rt argument for pthread_sigmask(). */
} SigMaskInfo;

/*
 * This is the thread ID of the notifier thread that does select. Only valid
 * when notifierThreadRunning is non-zero.
 *
 * You must hold the notifierInitLock before accessing this variable.
 */

	Tcl_Panic("StartNotifierThread: notifier not initialized");
    }
    if (!notifierThreadRunning) {
	int result;
	pthread_attr_t attr;

	/*
	 * Signal handling vs. pthreads:
	 * Now that we start the notifier thread we block all signals
	 * in the calling thread which is inherited by the notifier thread.
	 * Later on, the notifier thread unblocks/re-blocks all signals
	 * when it waits for events. The overall effect is that only the
	 * notifier catches and dispatches signals, given that this code
	 * was called before any further threads were created.
	 */

	sigfillset(&allSigMask);
	pthread_sigmask(SIG_BLOCK, &allSigMask, &notifierSigMask);

	pthread_attr_init(&attr);
	pthread_attr_setscope(&attr, PTHREAD_SCOPE_SYSTEM);
	pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_JOINABLE);
	pthread_attr_setstacksize(&attr, 60 * 1024);
	result = pthread_create(&notifierThread, &attr,
		(void * (*)(void *))NotifierThreadProc, NULL);
	pthread_attr_destroy(&attr);
	if (result) {
	    Tcl_Panic("StartNotifierThread: unable to start notifier thread");
	}
	notifierThreadRunning = 1;






    }
    UNLOCK_NOTIFIER_INIT;
}


/*
 *----------------------------------------------------------------------

		if (result) {
		    Tcl_Panic("Tcl_FinalizeNotifier: unable to join notifier "
			    "thread");
		}
		notifierThreadRunning = 0;

		/*
		 * Unblock all signals now, since the notifier isn't
		 * anymore to deal with them.
		 */
		pthread_sigmask(SIG_SETMASK, &notifierSigMask, NULL);

		/*
		 * If async marks are outstanding, perform actions now.
		 */
		if (asyncPending) {
		    asyncPending = 0;
		    TclAsyncMarkFromNotifier();
		}

    }
    return result;
}

/*
 *----------------------------------------------------------------------
 *
 * TclAsyncInNotifier --
 *
 *	This procedure sets the async mark of an async handler to a
 *	given value, if it is called from the notifier thread.
 *
 * Result:
 *	True, when flag set. False, otherwise.
 *
 * Side effetcs:
 *	The trigger pipe is written when called from the notifier
 *	thread.
 *
 *----------------------------------------------------------------------
 */

int
TclAsyncInNotifier(


    int *flagPtr,		/* Flag to mark. */
    int value)			/* Value of mark. */
{
#ifdef TCL_THREADS

    /*
     * WARNING:
     * This code most likely runs in a signal handler. Thus,
     * only few async-signal-safe system calls are allowed,
     * e.g. pthread_self(), sem_post(), write().
     */

    if (pthread_self() == notifierThread) {
	if (notifierThreadRunning) {
	    *flagPtr = value;
	    asyncPending = 1;
	    write(triggerPipe, "S", 1);

	    return 1;
	}
    }





#endif
    return 0;
}

/*
 *----------------------------------------------------------------------
 *
 * NotifierThreadProc --
 *

    ClientData clientData)	/* Not used. */
{
    ThreadSpecificData *tsdPtr;
    fd_set readableMask, writableMask, exceptionalMask;
    int i, ret, numFdBits = 0, polling;
    struct timeval poll = {0., 0.}, *timePtr;
    char buf[2];
    sigset_t newset, oldset, *newsetPtr = NULL;
    int run = 0, how;

    /*
     * Look for file events and report them to interested threads.
     */

    while (1) {
	FD_ZERO(&readableMask);

	 */

	if (receivePipe >= numFdBits) {
	    numFdBits = receivePipe + 1;
	}
	FD_SET(receivePipe, &readableMask);

	if (run) {
	    /*
	     * Perform query/change of notifier thread's signal mask.
	     * On success, re-query the current signal mask for result.
	     */
	    if ((how != SIG_SETMASK) || (newsetPtr == NULL)) {
		pthread_sigmask(SIG_SETMASK, &notifierSigMask, NULL);
	    }
	    ret = pthread_sigmask(how, newsetPtr, &oldset);
	    if (ret == 0) {
		pthread_sigmask(SIG_BLOCK, NULL, &notifierSigMask);
	    }

	    /*
	     * Transfer result back to caller.
	     */
	    pthread_mutex_lock(&sigMaskMutex);
	    SigMaskInfo.ret = ret;
	    if (SigMaskInfo.oldset != NULL) {
		*SigMaskInfo.oldset = oldset;
	    }
	    SigMaskInfo.run = 2;			/* set to done */
	    pthread_cond_broadcast(&sigMaskCV);
	    pthread_mutex_unlock(&sigMaskMutex);
	    run = 0;
	} else {
	    pthread_sigmask(SIG_SETMASK, &notifierSigMask, NULL);
	}

	ret = select(numFdBits, &readableMask, &writableMask, &exceptionalMask,
		    timePtr);

	pthread_sigmask(SIG_BLOCK, &allSigMask, NULL);

	if (ret == -1) {









	    /*
	     * Try again immediately on an error.
	     */
	    continue;
	}

	/*

		    CFRunLoopWakeUp(tsdPtr->runLoop);
		}
	    }
	}

	UNLOCK_NOTIFIER;

	/*
	 * Remember request to query/change notifier thread's signal mask.
	 */
	pthread_mutex_lock(&sigMaskMutex);
	if (!run && SigMaskInfo.run == 1) {		/* perform run */
	    run = 1;
	    how = SigMaskInfo.how;
	    if (SigMaskInfo.set != NULL) {
		newset = *SigMaskInfo.set;
		newsetPtr = &newset;
	    } else {
		newsetPtr = NULL;
	    }
	}
	pthread_mutex_unlock(&sigMaskMutex);

	/*
	 * Consume the next byte from the notifier pipe if the pipe was
	 * readable. Note that there may be multiple bytes pending, but to
	 * avoid a race condition we only read one at a time.
	 */

	if (FD_ISSET(receivePipe, &readableMask)) {

{
    ThreadSpecificData *tsdPtr = TCL_TSD_INIT(&dataKey);

    UNLOCK_NOTIFIER_TSD;
    UNLOCK_NOTIFIER;
    UNLOCK_NOTIFIER_INIT;

    pthread_mutex_init(&sigMaskMutex, NULL);
    pthread_cond_init(&sigMaskCV, NULL);

    asyncPending = 0;
    SigMaskInfo.run = 0;				/* set to idle */

    if (tsdPtr->runLoop) {
	tsdPtr->runLoop = NULL;
	if (!noCFafterFork) {
	    CFRunLoopSourceInvalidate(tsdPtr->runLoopSource);
	    CFRelease(tsdPtr->runLoopSource);
	    if (tsdPtr->runLoopTimer) {
		CFRunLoopTimerInvalidate(tsdPtr->runLoopTimer);
		CFRelease(tsdPtr->runLoopTimer);
	    }
	}
	tsdPtr->runLoopSource = NULL;
	tsdPtr->runLoopTimer = NULL;
    }
    if (notifierCount > 0) {
	notifierCount = 1;
	notifierThreadRunning = 0;

	/*
	 * Unblock all signals now, since the notifier isn't
	 * anymore to deal with them.
	 */
	pthread_sigmask(SIG_SETMASK, &notifierSigMask, NULL);

	/*
	 * Assume that the return value of Tcl_InitNotifier in the child will
	 * be identical to the one stored as clientData in tclNotify.c's
	 * ThreadSpecificData by the parent's TclInitNotifier, so discard the
	 * return value here. This assumption may require the fork() to be
	 * executed in the main thread of the parent, otherwise
	 * Tcl_AlertNotifier may break in the child.

    const void *runLoopMode)
{
    Tcl_Panic("TclMacOSXNotifierAddRunLoopMode: "
	    "Tcl not built with CoreFoundation support");
}

#endif /* HAVE_COREFOUNDATION */

/*
 *----------------------------------------------------------------------
 *
 * TclpSigProcMask --
 *
 *	This routine is a wrapper for sigprocmask(2)/pthread_sigmask(3).
 *	It uses a rendez-vous with the notifier thread in order to
 *	query or change its signal mask.
 *
 * Result:
 *	0 on success, else error number, similar to pthread_sigmask(3).
 *
 * Side effects:
 *	See manual page sigprocmask(2) and pthread_sigmask(3).
 *
 *----------------------------------------------------------------------
 */

int
TclpSigProcMask(
    int how,
    const void *set,
    void *oldset)
{
#ifdef TCL_THREADS
    int ret, fromNotifier = 0;

    LOCK_NOTIFIER_INIT;
    if (notifierThreadRunning) {
	pthread_mutex_lock(&sigMaskMutex);
	while (SigMaskInfo.run != 0) {			/* wait for idle */
	    pthread_cond_wait(&sigMaskCV, &sigMaskMutex);
	}
	SigMaskInfo.how = how;
	SigMaskInfo.set = (const sigset_t *) set;
	SigMaskInfo.oldset = (sigset_t *) oldset;
	SigMaskInfo.run = 1;				/* set to run */
	if (write(triggerPipe, "m", 1) != 1) {
	    ret = errno;
	    SigMaskInfo.run = 0;			/* set to idle */
	} else {
	    while (SigMaskInfo.run != 2) {		/* wait for done */
		pthread_cond_wait(&sigMaskCV, &sigMaskMutex);
	    }
	    ret = SigMaskInfo.ret;
	    SigMaskInfo.run = 0;			/* set to idle */
	    pthread_cond_broadcast(&sigMaskCV);
	}
	pthread_mutex_unlock(&sigMaskMutex);
	fromNotifier = 1;
    }
    UNLOCK_NOTIFIER_INIT;
    if (fromNotifier) {
	return ret;
    }
#endif
    return pthread_sigmask(how, (const sigset_t *) set, (sigset_t *) oldset);
}

/*
 * Local Variables:
 * mode: c
 * c-basic-offset: 4
 * fill-column: 78
 * End:
 */

static int notifierThreadRunning = 0;

/*
 * The following static flag indicates that async handlers are pending.
 */

#if defined(TCL_THREADS) && !defined(ANDROID)
static int asyncPending = 0;
#endif

/*
 * The notifier thread signals the notifierCV when it has finished
 * initializing the triggerPipe and right before the notifier thread
 * terminates. This condition is used to deal with the signal mask, too.
 */

static Tcl_ThreadId notifierThread;

/*
 * Signal mask information for notifier thread.
 */

#ifndef ANDROID
static sigset_t notifierSigMask;
static sigset_t allSigMask;
#endif

/*
 * Structure for TclpSigProcMask() rendez-vous with notifier thread.
 * Protected by notifier(Init)Mutex and notifierCV.
 */

#ifndef ANDROID
static struct {
    int run;			/* Run state flag. */
    int ret;			/* Return code of pthread_sigmask(). */
    int how;			/* 1st argument for pthread_sigmask(). */
    const sigset_t *set;	/* 2nd argument for pthread_sigmask(). */
    sigset_t *oldset;		/* 3rt argument for pthread_sigmask(). */
} SigMaskInfo;
#endif

#endif /* TCL_THREADS */

/*
 * Static routines defined in this file.
 */

 */
static void
StartNotifierThread(const char *proc)
{
    if (!notifierThreadRunning) {
	pthread_mutex_lock(&notifierInitMutex);
	if (!notifierThreadRunning) {
#ifndef ANDROID
	    /*
	     * Signal handling vs. pthreads:
	     * Now that we start the notifier thread we block all signals
	     * in the calling thread which is inherited by the notifier thread.
	     * Later on, the notifier thread unblocks/re-blocks all signals
	     * when it waits for events. The overall effect is that only the
	     * notifier catches and dispatches signals, given that this code
	     * was called before any further threads were created.
	     */

	    sigfillset(&allSigMask);
	    pthread_sigmask(SIG_BLOCK, &allSigMask, &notifierSigMask);
#endif
	    pthread_mutex_lock(&notifierMutex);
	    if (TclpThreadCreate(&notifierThread, NotifierThreadProc, NULL,
		    TCL_THREAD_STACK_DEFAULT, TCL_THREAD_JOINABLE) != TCL_OK) {
		Tcl_Panic("%s: unable to start notifier thread", proc);
	    }

	    /*
	     * Wait for the notifier pipe to be created.
	     */

	    while (triggerPipe < 0) {
		pthread_cond_wait(&notifierCV, &notifierMutex);
	    }
	    pthread_mutex_unlock(&notifierMutex);

	    notifierThreadRunning = 1;






	}
	pthread_mutex_unlock(&notifierInitMutex);
    }
}
#endif /* TCL_THREADS */

/*

		    if (result) {
			Tcl_Panic("Tcl_FinalizeNotifier: unable to join notifier "
				"thread");
		    }
		    notifierThreadRunning = 0;

#ifndef ANDROID
		    /*
		     * Unblock all signals now, since the notifier isn't
		     * anymore to deal with them.
		     */
		    pthread_sigmask(SIG_SETMASK, &notifierSigMask, NULL);

		    /*
		     * If async marks are outstanding, perform actions now.
		     */
		    if (asyncPending) {
			asyncPending = 0;
			TclAsyncMarkFromNotifier();
		    }
#endif
		}
	    }
	}

	/*
	 * Clean up any synchronization objects in the thread local storage.
	 */

	return 0;
    }
}

/*
 *----------------------------------------------------------------------
 *
 * TclAsyncInNotifier --
 *
 *	This procedure sets the async mark of an async handler to a
 *	given value, if it is called from the notifier thread.
 *
 * Result:
 *	True, when flag set. False, otherwise.
 *
 * Side effetcs:
 *	The trigger pipe is written when called from the notifier
 *	thread.
 *
 *----------------------------------------------------------------------
 */

int
TclAsyncInNotifier(


    int *flagPtr,		/* Flag to mark. */
    int value)			/* Value of mark. */
{
#if defined(TCL_THREADS) && !defined(ANDROID)

    /*
     * WARNING:
     * This code most likely runs in a signal handler. Thus,
     * only few async-signal-safe system calls are allowed,
     * e.g. pthread_self(), sem_post(), write().
     */

    if (Tcl_GetCurrentThread() == notifierThread) {
	if (notifierThreadRunning) {
	    *flagPtr = value;
	    asyncPending = 1;
	    write(triggerPipe, "S", 1);

	    return 1;
	}
    }





#endif
    return 0;
}

#ifdef TCL_THREADS
/*
 *----------------------------------------------------------------------
 *
 * NotifierThreadProc --

    fd_set writableMask;
    fd_set exceptionMask;
    int fds[2];
    int i, numFdBits = 0, receivePipe, ret;
    long found;
    struct timeval poll = {0., 0.}, *timePtr;
    char buf[2];
#ifndef ANDROID
    sigset_t newset, oldset, *newsetPtr = NULL;
    int run = 0, how = -1;
#endif

    if (pipe(fds) != 0) {
	Tcl_Panic("NotifierThreadProc: %s", "could not create trigger pipe");
    }

    receivePipe = fds[0];

	 */

	if (receivePipe >= numFdBits) {
	    numFdBits = receivePipe + 1;
	}
	FD_SET(receivePipe, &readableMask);

#ifndef ANDROID
	if (run) {
	    /*
	     * Perform query/change of notifier thread's signal mask.
	     * On success, re-query the current signal mask for result.
	     */
	    if ((how != SIG_SETMASK) || (newsetPtr == NULL)) {
		pthread_sigmask(SIG_SETMASK, &notifierSigMask, NULL);
	    }
	    ret = pthread_sigmask(how, newsetPtr, &oldset);
	    if (ret == 0) {

		pthread_sigmask(SIG_BLOCK, NULL, &notifierSigMask);
	    }

	    /*
	     * Transfer result back to caller.


	     */
	    pthread_mutex_lock(&notifierMutex);
	    SigMaskInfo.ret = ret;
	    if (SigMaskInfo.oldset != NULL) {
		*SigMaskInfo.oldset = oldset;
	    }
	    SigMaskInfo.run = 2;			/* set to done */
	    pthread_cond_broadcast(&notifierCV);
	    pthread_mutex_unlock(&notifierMutex);
	    run = 0;
	} else {
	    pthread_sigmask(SIG_SETMASK, &notifierSigMask, NULL);
	}
#endif

	ret = select(numFdBits, &readableMask, &writableMask, &exceptionMask,
			timePtr);

#ifndef ANDROID
	pthread_sigmask(SIG_BLOCK, &allSigMask, NULL);
#endif

	if (ret == -1) {
	    /*
	     * Try again immediately on select() error.
	     */
	    continue;
	}

	/*

		PostMessageW(tsdPtr->hwnd, 1024, 0, 0);
#else /* __CYGWIN__ */
		pthread_cond_broadcast(&tsdPtr->waitCV);
#endif /* __CYGWIN__ */
	    }
	}

#ifndef ANDROID
	/*
	 * Remember request to query/change notifier thread's signal mask.
	 */
	if (!run && SigMaskInfo.run == 1) {		/* perform run */
	    run = 1;
	    how = SigMaskInfo.how;
	    if (SigMaskInfo.set != NULL) {
		newset = *SigMaskInfo.set;
		newsetPtr = &newset;
	    } else {
		newsetPtr = NULL;
	    }
	}
#endif
	pthread_mutex_unlock(&notifierMutex);

	/*
	 * Consume the next byte from the notifier pipe if the pipe was
	 * readable. Note that there may be multiple bytes pending, but to
	 * avoid a race condition we only read one at a time.
	 */

	if (FD_ISSET(receivePipe, &readableMask)) {
	    i = read(receivePipe, buf, 1);

	    if ((i == 0) || ((i == 1) && (buf[0] == 'q'))) {
		/*
		 * Someone closed the write end of the pipe or sent us a Quit
		 * message [Bug: 4139] and then closed the write end of the
		 * pipe so we need to shut down the notifier thread.
		 */

		break;
	    }

#ifndef ANDROID
	    if (asyncPending) {
		asyncPending = 0;
		TclAsyncMarkFromNotifier();
	    }
#endif
	}
    }

    /*
     * Clean up the read end of the pipe and signal any threads waiting on
     * termination of the notifier thread.
     */

    if (notifierThreadRunning == 1) {
	pthread_cond_destroy(&notifierCV);
    }
    pthread_mutex_init(&notifierInitMutex, NULL);
    pthread_mutex_init(&notifierMutex, NULL);
    pthread_cond_init(&notifierCV, NULL);

#ifndef ANDROID
    asyncPending = 0;
    SigMaskInfo.run = 0;				/* set to idle */
#endif

    /*
     * notifierThreadRunning == 1: thread is running, (there might be data in notifier lists)
     * atForkInit == 0: InitNotifier was never called
     * notifierCount != 0: unbalanced  InitNotifier() / FinalizeNotifier calls
     * waitingListPtr != 0: there are threads currently waiting for events.
     */

    }

    Tcl_InitNotifier();
}
#endif /* HAVE_PTHREAD_ATFORK */

#endif /* TCL_THREADS */

/*
 *----------------------------------------------------------------------
 *
 * TclpSigProcMask --
 *
 *	This routine is a wrapper for sigprocmask(2)/pthread_sigmask(3).
 *	It uses a rendez-vous with the notifier thread in order to
 *	query or change its signal mask.
 *
 * Result:
 *	0 on success, else error number, similar to pthread_sigmask(3).
 *
 * Side effects:
 *	See manual page sigprocmask(2) and pthread_sigmask(3).
 *
 *----------------------------------------------------------------------
 */

int
TclpSigProcMask(
    int how,
    const void *set,
    void *oldset)
{
#if defined(TCL_THREADS) && !defined(ANDROID)
    int ret, fromNotifier = 0;

    pthread_mutex_lock(&notifierInitMutex);
    if (notifierThreadRunning) {
	pthread_mutex_lock(&notifierMutex);
	while (SigMaskInfo.run != 0) {			/* wait for idle */
	    pthread_cond_wait(&notifierCV, &notifierMutex);
	}
	SigMaskInfo.how = how;
	SigMaskInfo.set = (const sigset_t *) set;
	SigMaskInfo.oldset = (sigset_t *) oldset;
	SigMaskInfo.run = 1;				/* set to run */
	if (write(triggerPipe, "m", 1) != 1) {
	    ret = errno;
	    SigMaskInfo.run = 0;			/* set to idle */
	} else {
	    while (SigMaskInfo.run != 2) {		/* wait for done */
		pthread_cond_wait(&notifierCV, &notifierMutex);
	    }
	    ret = SigMaskInfo.ret;
	    SigMaskInfo.run = 0;			/* set to idle */
	    pthread_cond_broadcast(&notifierCV);
	}
	pthread_mutex_unlock(&notifierMutex);
	fromNotifier = 1;
    }
    pthread_mutex_unlock(&notifierInitMutex);
    if (fromNotifier) {
	return ret;
    }
#endif
    return pthread_sigmask(how, (const sigset_t *) set, (sigset_t *) oldset);
}

#endif /* !HAVE_COREFOUNDATION */

/*
 * Local Variables:
 * mode: c
 * c-basic-offset: 4
 * fill-column: 78
 * End:
 */

	}
    }
}

/*
 *----------------------------------------------------------------------
 *
 * TclAsyncInNotifier --
 *
 *	This procedure is a no-op on Windows.
 *
 * Result:
 *	Always false.
 *
 * Side effetcs:
 *	None.
 *----------------------------------------------------------------------
 */

int
TclAsyncInNotifier(


    int *flagPtr,		/* Flag to mark. */
    int value)			/* Value of mark. */
{
    return 0;
}

/*
 *----------------------------------------------------------------------
 *
 * NotifierProc --
 *

	tclScaleTimeProcPtr(&vdelay, tclTimeClientData);
	sleepTime = vdelay.sec * 1000 + vdelay.usec / 1000;
	if (sleepTime == INFINITE) {
	    --sleepTime;
	}
    }
}

/*
 *----------------------------------------------------------------------
 *
 * TclpSigProcMask --
 *
 *	This routine is a no-op on Windows.
 *
 * Result:
 *	Always EINVAL.
 *
 * Side effects:
 *	None.
 *
 *----------------------------------------------------------------------
 */

int
TclpSigProcMask(
    int how,
    const void *set,
    void *oldset)
{
    return EINVAL;
}

/*
 * Local Variables:
 * mode: c
 * c-basic-offset: 4
 * fill-column: 78
 * End:
 */

static TclX_AppSignalErrorHandler appSigErrorHandler = NULL;
static ClientData                 appSigErrorClientData = NULL;

/*
 * Counters of signals that have occured but have not been processed.
 */
static unsigned signalsReceived[MAXSIG];



/*
 * Table of commands to evaluate when a signal occurs.  If the command is
 * NULL and the signal is received, an error is returned.
 */
static char *signalTrapCmds[MAXSIG];

 *-----------------------------------------------------------------------------
 */
static int
BlockSignals (Tcl_Interp *interp, int action, unsigned char signals[])
{
#ifndef NO_SIGACTION
    int      signalNum;
    sigset_t sigBlockSet;

    sigemptyset (&sigBlockSet);

    for (signalNum = 0; signalNum < MAXSIG; signalNum++) {
        if (signals [signalNum])


            sigaddset (&sigBlockSet, signalNum);
    }

    if (TclpSigProcMask (action, &sigBlockSet, NULL)) {
        TclX_AppendObjResult (interp, Tcl_PosixError (interp), (char *) NULL);
        return TCL_ERROR;
    }

    return TCL_OK;
#else
    TclX_AppendObjResult (interp,
                          "Posix signals are not available on this system, ",
                          "can not block signals");

 * boolean object.
 *-----------------------------------------------------------------------------
 */
static Tcl_Obj *
SignalBlocked (int signalNum)
{
#ifndef NO_SIGACTION
    sigset_t sigBlockSet;

    if (TclpSigProcMask (SIG_BLOCK, NULL, &sigBlockSet)) {
        return NULL;
    }
    return Tcl_NewBooleanObj (sigismember (&sigBlockSet, signalNum));
#else
    return Tcl_NewBooleanObj (FALSE);
#endif
}

/*-----------------------------------------------------------------------------
 * SigNameToNum --

{
    if (asyncHandler == NULL)
        return;
    /*
     * Record the count of the number of this type of signal that has occured
     * and tell all the interpreters to call the async handler when safe.
     */






    signalsReceived [signalNum]++;

    Tcl_AsyncMark (asyncHandler);

#ifdef NO_SIGACTION
    /*
     * For old-style Unix signals, the signal must be explictly re-enabled.
     * Not done for SIGCHLD, as we would continue to the signal until the
     * wait is done.  This is fixed by Posix signals and is not necessary under
     * BSD, but it done this way for consistency.

    if (numInterps == 0) {
        interpTableSize = 4;
        interpTable = (Tcl_Interp **)
            ckalloc (sizeof (Tcl_Interp *) * interpTableSize);

        for (idx = 0; idx < MAXSIG; idx++) {
            signalsReceived [idx] = 0;


            signalTrapCmds [idx] = NULL;
        }
        asyncHandler = Tcl_AsyncCreate (ProcessSignals, (ClientData) NULL);
        /*
         * Get address of "unknown signal" message.
         */
        unknownSignalIdMsg = Tcl_SignalId (20000);