~ubuntu-branches/ubuntu/raring/clamav/raring-updates

« back to all changes in this revision

Viewing changes to win32/3rdparty/pthreads/manual/pthread_timechange_handler_np.html

  • Committer: Bazaar Package Importer
  • Author(s): Scott Kitterman
  • Date: 2011-06-18 11:56:34 UTC
  • mfrom: (0.35.21 sid)
  • Revision ID: james.westby@ubuntu.com-20110618115634-u2lovivet0qx34d0
Tags: 0.97.1+dfsg-1ubuntu1
* Merge from debian unstable.  Remaining changes:
  - Drop build-dep on electric-fence (in Universe)
  - Add apparmor profiles for clamd and freshclam along with maintainer
    script changes

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2
 
<HTML>
3
 
<HEAD>
4
 
        <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
5
 
        <TITLE>PTHREAD_TIMECHANGE_HANDLER_NP manual page</TITLE>
6
 
        <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.3  (Linux)">
7
 
        <META NAME="CREATED" CONTENT="20050505;322600">
8
 
        <META NAME="CHANGED" CONTENT="20050505;22110600">
9
 
        <!-- manual page source format generated by PolyglotMan v3.2, -->
10
 
        <!-- available at http://polyglotman.sourceforge.net/ -->
11
 
</HEAD>
12
 
<BODY LANG="en-GB" BGCOLOR="#ffffff" DIR="LTR">
13
 
<H4>POSIX Threads for Windows – REFERENCE - <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A></H4>
14
 
<P><A HREF="index.html">Reference Index</A></P>
15
 
<P><A HREF="#toc">Table of Contents</A></P>
16
 
<H2><A HREF="#toc0" NAME="sect0">Name</A></H2>
17
 
<P STYLE="font-weight: medium">pthread_timechange_handler_np –
18
 
alert timed waiting condition variables to system time changes.</P>
19
 
<H2><A HREF="#toc1" NAME="sect1">Synopsis</A></H2>
20
 
<P><B>#include &lt;pthread.h&gt;</B> 
21
 
</P>
22
 
<P><B>void * pthread_timechange_handler_np(void * </B><I>dummy</I><B>);</B></P>
23
 
<H2><A HREF="#toc2" NAME="sect2">Description</A></H2>
24
 
<P>To improve tolerance against operator or time service initiated
25
 
system clock changes.</P>
26
 
<P><B>pthread_timechange_handler_np </B>can be called by an
27
 
application when it receives a WM_TIMECHANGE message from the system.
28
 
At present it broadcasts all condition variables so that waiting
29
 
threads can wake up and re-evaluate their conditions and restart
30
 
their timed waits if required.</P>
31
 
<P><B>pthread_timechange_handler_np </B>has the same return type and
32
 
argument type as a thread routine so that it may be called directly
33
 
through pthread_create(), i.e. as a separate thread. If run as a
34
 
thread, the return code must be retrieved through <A HREF="pthread_join.html"><B>pthread_join</B>()</A>.</P>
35
 
<P>Although the <I>dummy</I> parameter is required it is not used and
36
 
any value including NULL can be given.</P>
37
 
<H2><A HREF="#toc3" NAME="sect3">Cancellation</A></H2>
38
 
<P>None.</P>
39
 
<H2><A HREF="#toc4" NAME="sect4"><FONT COLOR="#000080">Return Value</FONT></A></H2>
40
 
<P><B>pthread_timechange_handler_np</B> returns 0 on success, or an
41
 
error code.</P>
42
 
<H2><A HREF="#toc5" NAME="sect5">Errors</A></H2>
43
 
<P>The <B>pthread_timechange_handler_np</B> function returns the
44
 
following error code on error: 
45
 
</P>
46
 
<DL>
47
 
        <DL>
48
 
                <DT STYLE="margin-right: 1cm; margin-bottom: 0.5cm"><B>EAGAIN</B> 
49
 
                </DT></DL>
50
 
</DL>
51
 
<P STYLE="margin-left: 2cm; margin-bottom: 0cm">
52
 
To indicate that not all condition variables were signalled for some
53
 
reason.</P>
54
 
<H2><A HREF="#toc6" NAME="sect6">Author</A></H2>
55
 
<P>Ross Johnson for use with <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A>.</P>
56
 
<HR>
57
 
<P><A NAME="toc"></A><B>Table of Contents</B></P>
58
 
<UL>
59
 
        <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect0" NAME="toc0">Name</A>
60
 
                </P>
61
 
        <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect1" NAME="toc1">Synopsis</A>
62
 
                </P>
63
 
        <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect2" NAME="toc2">Description</A>
64
 
                </P>
65
 
        <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect3" NAME="toc3">Cancellation</A>
66
 
                </P>
67
 
        <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect4" NAME="toc4">Return
68
 
        Value</A> 
69
 
        </P>
70
 
        <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect5" NAME="toc5">Errors</A>
71
 
                </P>
72
 
        <LI><P><A HREF="#sect6" NAME="toc6">Author</A> 
73
 
        </P>
74
 
</UL>
75
 
</BODY>
76
 
</HTML>