Qpid Proton C API  0.32.0
proactor.h
Go to the documentation of this file.
1 #ifndef PROTON_PROACTOR_H
2 #define PROTON_PROACTOR_H 1
3 
4 /*
5  * Licensed to the Apache Software Foundation (ASF) under one
6  * or more contributor license agreements. See the NOTICE file
7  * distributed with this work for additional information
8  * regarding copyright ownership. The ASF licenses this file
9  * to you under the Apache License, Version 2.0 (the
10  * "License"); you may not use this file except in compliance
11  * with the License. You may obtain a copy of the License at
12  *
13  * http://www.apache.org/licenses/LICENSE-2.0
14  *
15  * Unless required by applicable law or agreed to in writing,
16  * software distributed under the License is distributed on an
17  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
18  * KIND, either express or implied. See the License for the
19  * specific language governing permissions and limitations
20  * under the License.
21  */
22 
23 #include <proton/condition.h>
24 #include <proton/event.h>
25 #include <proton/import_export.h>
26 #include <proton/types.h>
27 
28 #ifdef __cplusplus
29 extern "C" {
30 #endif
31 
74 #define PN_MAX_ADDR 1060
75 
86 PNP_EXTERN int pn_proactor_addr(char *addr, size_t size, const char *host, const char *port);
87 
91 PNP_EXTERN pn_proactor_t *pn_proactor(void);
92 
96 PNP_EXTERN void pn_proactor_free(pn_proactor_t *proactor);
97 
122 PNP_EXTERN void pn_proactor_connect2(pn_proactor_t *proactor, pn_connection_t *connection, pn_transport_t *transport, const char *addr);
123 
127 PNP_EXTERN void pn_proactor_connect(pn_proactor_t *proactor, pn_connection_t *connection, const char *addr);
128 
156 PNP_EXTERN void pn_proactor_listen(pn_proactor_t *proactor, pn_listener_t *listener, const char *addr, int backlog);
157 
180 PNP_EXTERN void pn_proactor_disconnect(pn_proactor_t *proactor, pn_condition_t *condition);
181 
199 
207 
219 
228 PNP_EXTERN void pn_proactor_done(pn_proactor_t *proactor, pn_event_batch_t *events);
229 
241 PNP_EXTERN void pn_proactor_interrupt(pn_proactor_t *proactor);
242 
253 PNP_EXTERN void pn_proactor_set_timeout(pn_proactor_t *proactor, pn_millis_t timeout);
254 
261 PNP_EXTERN void pn_proactor_cancel_timeout(pn_proactor_t *proactor);
262 
279 PNP_EXTERN void pn_proactor_release_connection(pn_connection_t *connection);
280 
293 PNP_EXTERN void pn_connection_wake(pn_connection_t *connection);
294 
303 
312 
327 PNP_EXTERN pn_millis_t pn_proactor_now(void);
328 
341 PNP_EXTERN int64_t pn_proactor_now_64(void);
342 
364 PNP_EXTERN void pn_proactor_raw_connect(pn_proactor_t *proactor, pn_raw_connection_t *raw_connection, const char *addr);
365 
430 #ifdef __cplusplus
431 }
432 #endif
433 
434 #endif /* proactor.h */
pn_listener_t
struct pn_listener_t pn_listener_t
A listener for incoming connections.
Definition: types.h:424
pn_event_batch_t
struct pn_event_batch_t pn_event_batch_t
A batch of events that must be handled in sequence.
Definition: types.h:462
pn_proactor_wait
PNP_EXTERN pn_event_batch_t * pn_proactor_wait(pn_proactor_t *proactor)
Wait until there are Proactor events to handle.
types.h
AMQP and API data types.
pn_event_t
struct pn_event_t pn_event_t
Notification of a state change in the protocol engine.
Definition: event.h:75
pn_event_batch_next
PNP_EXTERN pn_event_t * pn_event_batch_next(pn_event_batch_t *batch)
Remove the next event from the batch and return it.
pn_transport_t
struct pn_transport_t pn_transport_t
A network channel supporting an AMQP connection.
Definition: types.h:435
pn_proactor_interrupt
PNP_EXTERN void pn_proactor_interrupt(pn_proactor_t *proactor)
Return a PN_PROACTOR_INTERRUPT event as soon as possible.
pn_proactor_connect2
PNP_EXTERN void pn_proactor_connect2(pn_proactor_t *proactor, pn_connection_t *connection, pn_transport_t *transport, const char *addr)
Connect transport to addr and bind to connection.
pn_proactor_set_timeout
PNP_EXTERN void pn_proactor_set_timeout(pn_proactor_t *proactor, pn_millis_t timeout)
Return a PN_PROACTOR_TIMEOUT after timeout milliseconds elapse.
pn_proactor_disconnect
PNP_EXTERN void pn_proactor_disconnect(pn_proactor_t *proactor, pn_condition_t *condition)
Disconnect all connections and listeners belonging to the proactor.
condition.h
An endpoint error state.
pn_proactor_t
struct pn_proactor_t pn_proactor_t
A harness for multithreaded IO.
Definition: types.h:442
pn_connection_wake
PNP_EXTERN void pn_connection_wake(pn_connection_t *connection)
Return a PN_CONNECTION_WAKE event for connection as soon as possible.
pn_proactor_connect
PNP_EXTERN void pn_proactor_connect(pn_proactor_t *proactor, pn_connection_t *connection, const char *addr)
Deprecated - Use pn_proactor_connect2()
pn_proactor_listen
PNP_EXTERN void pn_proactor_listen(pn_proactor_t *proactor, pn_listener_t *listener, const char *addr, int backlog)
Start listening for incoming connections.
pn_proactor
PNP_EXTERN pn_proactor_t * pn_proactor(void)
Create a proactor.
pn_proactor_raw_connect
PNP_EXTERN void pn_proactor_raw_connect(pn_proactor_t *proactor, pn_raw_connection_t *raw_connection, const char *addr)
Connect addr and bind to raw_connection.
pn_millis_t
uint32_t pn_millis_t
A span of time in milliseconds.
Definition: types.h:149
pn_condition_t
struct pn_condition_t pn_condition_t
An AMQP Condition object.
Definition: condition.h:64
pn_event_proactor
PNP_EXTERN pn_proactor_t * pn_event_proactor(pn_event_t *event)
Return the proactor associated with an event.
pn_connection_proactor
PNP_EXTERN pn_proactor_t * pn_connection_proactor(pn_connection_t *connection)
Return the proactor associated with a connection.
event.h
Protocol and transport events.
pn_proactor_now
PNP_EXTERN pn_millis_t pn_proactor_now(void)
pn_proactor_cancel_timeout
PNP_EXTERN void pn_proactor_cancel_timeout(pn_proactor_t *proactor)
Cancel the pending timeout set by pn_proactor_set_timeout().
pn_connection_t
struct pn_connection_t pn_connection_t
An AMQP Connection object.
Definition: types.h:285
pn_proactor_get
PNP_EXTERN pn_event_batch_t * pn_proactor_get(pn_proactor_t *proactor)
Return Proactor events if any are available immediately.
pn_proactor_free
PNP_EXTERN void pn_proactor_free(pn_proactor_t *proactor)
Free the proactor.
pn_proactor_now_64
PNP_EXTERN int64_t pn_proactor_now_64(void)
Get the real elapsed time since an arbitrary point in the past in milliseconds.
pn_proactor_done
PNP_EXTERN void pn_proactor_done(pn_proactor_t *proactor, pn_event_batch_t *events)
Call when finished handling a batch of events.
pn_raw_connection_t
struct pn_raw_connection_t pn_raw_connection_t
A raw network connection used with the proactor.
Definition: types.h:449
pn_proactor_release_connection
PNP_EXTERN void pn_proactor_release_connection(pn_connection_t *connection)
Release ownership of connection, disassociate it from its proactor.
pn_proactor_addr
PNP_EXTERN int pn_proactor_addr(char *addr, size_t size, const char *host, const char *port)
Format a host:port address string for pn_proactor_connect() or pn_proactor_listen()