File: globus_i_xio_win32.h

package info (click to toggle)
globus-xio 6.1-1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 8,120 kB
  • sloc: ansic: 46,711; sh: 11,139; perl: 1,598; makefile: 355
file content (146 lines) | stat: -rw-r--r-- 5,477 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
/*
 * Copyright 1999-2014 University of Chicago
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef GLOBUS_I_XIO_WIN32_H_
#define GLOBUS_I_XIO_WIN32_H_

#include "globus_i_xio_system_common.h"
#include <windows.h>
#include <process.h>
#include <winsock2.h>

typedef struct globus_l_xio_win32_event_entry_s *
    globus_i_xio_win32_event_entry_t;
    
/**
 * this callback is called from within threads managed by this lib.
 * 
 * you must synchronize access between this and globus interface calls
 * and you must not call into globus calls unless globus has been built
 * threaded.
 * 
 * this callback is called while holding the 
 * globus_i_xio_win32_event_lock()
 * 
 * return false to unregister event handle, true to keep it
 * 
 * (this callback will not be reentered for any given event object)
 */
typedef
globus_bool_t
(*globus_i_xio_win32_event_cb_t)(
    void *                              user_arg);

globus_result_t
globus_i_xio_win32_event_register(
    globus_i_xio_win32_event_entry_t *  entry_handle,
    HANDLE                              event_handle,
    globus_i_xio_win32_event_cb_t       callback,
    void *                              user_arg);

/**
 * must be called after globus_i_xio_win32_event_lock()
 * Do NOT call within globus_i_xio_win32_event_cb_t callback
 */
void
globus_i_xio_win32_event_unregister(
    globus_i_xio_win32_event_entry_t    entry_handle);

/**
 * this lock effectively prevents events from occurring on the specified
 * handle (and others, but not all) while it is held.  This lock is also
 * held while calling event callbacks (so, don't call it within callbacks)
 */
void
globus_i_xio_win32_event_lock(
    globus_i_xio_win32_event_entry_t    entry_handle);

void
globus_i_xio_win32_event_unlock(
    globus_i_xio_win32_event_entry_t    entry_handle);

/**
 * must be called after globus_i_xio_win32_event_lock()
 * Do NOT call within globus_i_xio_win32_event_cb_t callback
 */
void
globus_i_xio_win32_event_post(
    globus_i_xio_win32_event_entry_t    entry_handle);

int
globus_i_xio_win32_complete_activate(void);

int
globus_i_xio_win32_complete_deactivate(void);

int
globus_i_xio_win32_file_activate(void);

int
globus_i_xio_win32_file_deactivate(void);

/**
 * dispatch callback to globus threads
 */
globus_result_t
globus_i_xio_win32_complete(
    globus_callback_func_t              callback,
    void *                              user_arg);

int
globus_i_xio_win32_mode_activate(void);

globus_bool_t
globus_i_xio_win32_mode_is_overlapped(
    HANDLE                              handle);

typedef CRITICAL_SECTION win32_mutex_t;

#define win32_mutex_init(x, y) InitializeCriticalSection(x)
#define win32_mutex_destroy(x) DeleteCriticalSection(x)
#define win32_mutex_lock(x) EnterCriticalSection(x)
#define win32_mutex_unlock(x) LeaveCriticalSection(x)

#define GlobusXIOSystemDebugSysError(message, err)                          \
    do                                                                      \
    {                                                                       \
        if(GlobusDebugTrue(                                                 \
            GLOBUS_XIO_SYSTEM, GLOBUS_I_XIO_SYSTEM_DEBUG_INFO))             \
        {                                                                   \
            char *                      msg = NULL;                         \
            int                         err_ = err;                         \
                                                                            \
            FormatMessage(                                                  \
                FORMAT_MESSAGE_ALLOCATE_BUFFER|FORMAT_MESSAGE_FROM_SYSTEM,  \
                NULL,                                                       \
                err_,                                                       \
                0,                                                          \
                (LPTSTR)&msg,                                               \
                0,                                                          \
                NULL);                                                      \
                                                                            \
            GlobusDebugMyPrintf(                                            \
                GLOBUS_XIO_SYSTEM,                                          \
                ("[%s] %s: %d:%s", _xio_name, message, err_, msg));         \
                                                                            \
            if(msg)                                                         \
            {                                                               \
                LocalFree(msg);                                             \
            }                                                               \
        }                                                                   \
    } while(0)

#endif