networking.h
4.46 KB
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
/*
* "Software G3270, desenvolvido com base nos códigos fontes do WC3270 e X3270
* (Paul Mattes Paul.Mattes@usa.net), de emulação de terminal 3270 para acesso a
* aplicativos mainframe. Registro no INPI sob o nome G3270.
*
* Copyright (C) <2008> <Banco do Brasil S.A.>
*
* Este programa é software livre. Você pode redistribuí-lo e/ou modificá-lo sob
* os termos da GPL v.2 - Licença Pública Geral ', conforme publicado pela
* Free Software Foundation.
*
* Este programa é distribuído na expectativa de ser útil, mas SEM QUALQUER
* GARANTIA; sem mesmo a garantia implícita de COMERCIALIZAÇÃO ou de ADEQUAÇÃO
* A QUALQUER PROPÓSITO EM PARTICULAR. Consulte a Licença Pública Geral GNU para
* obter mais detalhes.
*
* Você deve ter recebido uma cópia da Licença Pública Geral GNU junto com este
* programa; se não, escreva para a Free Software Foundation, Inc., 51 Franklin
* St, Fifth Floor, Boston, MA 02110-1301 USA
*
* Este programa está nomeado como networking.h e possui - linhas de código.
*
* Contatos:
*
* perry.werneck@gmail.com (Alexandre Perry de Souza Werneck)
* erico.mendonca@gmail.com (Erico Mascarenhas de Mendonça)
*
*/
#ifndef LIB3270_NETWORKING_H_INCLUDED
#define LIB3270_NETWORKING_H_INCLUDED
#include <lib3270/popup.h>
#include <sys/socket.h>
typedef struct lib3270_network_state {
int syserror; ///< @brief System error (errno)
#ifdef _WIN32
DWORD winerror; ///< @brief Win32 error got from GetLastError()
#endif // _WIN32
const LIB3270_POPUP *popup; /// @brief Detailed info for popup.
} LIB3270_NETWORK_STATE;
typedef struct _lib3270_new_context LIB3270_NET_CONTEXT;
typedef struct lib3270_net_module {
const char * name; ///< @brief The network module name.
/// @brief Initialize network module
///
/// @param hSession TN3270 session.
/// @param state Pointer to state message.
///
/// @return Allocated network context.
///
/// @retval NULL Initialization failed.
///
LIB3270_NET_CONTEXT * (*init)(H3270 *hSession, LIB3270_NETWORK_STATE *state);
/// @brief Deinitialize network module.
///
/// @param context Network context.
/// @param hSession TN3270 session.
/// @param state Pointer to state message.
///
void (*deinit)(H3270 *hSession, LIB3270_NETWORK_STATE *state);
/// @brief Connect to host.
///
/// @param context Network context.
/// @param hSession TN3270 session.
/// @param seconds Seconds for timeout.
/// @param state Pointer to state message.
///
int (*connect)(H3270 *hSession, int seconds, LIB3270_NETWORK_STATE *state);
/// @brief Disconnect from host.
///
/// @param context Network context.
/// @param hSession TN3270 session.
/// @param state Pointer to state message.
///
int (*disconnect)(H3270 *hSession, LIB3270_NETWORK_STATE *state);
int (*start_tls)(H3270 *hSession, LIB3270_NETWORK_STATE *msg);
/// @brief Send on network context.
///
/// @return Positive on data received, negative on error.
///
ssize_t (*send)(H3270 *hSession, const void *buffer, size_t length);
/// @brief Receive on network context.
///
/// @return Positive on data received, negative on error.
///
/// @retval -ENOTCONN Not connected to host.
///
ssize_t (*recv)(H3270 *hSession, void *buf, size_t len);
/// @brief Add socket in poll list.
void * (*add_poll)(H3270 *hSession, LIB3270_IO_FLAG flag, void(*call)(H3270 *, int, LIB3270_IO_FLAG, void *), void *userdata);
/// @brief Set non blocking mode.
///
/// @retval 0 Not connected or Success.
/// @retval -1 Failed (popup was sent).
int (*non_blocking)(H3270 *hSession, const unsigned char on);
/// @brief Check if the session is online.
///
/// @retval 0 The session is offline.
int (*is_connected)(H3270 *hSession);
/// @brief get socket name.
///
/// @return On success, zero is returned. On error, -1 is returned, and errno is set appropriately.
///
/// @retval 0 Success.
/// @retval -1 Error (errno is set).
int (*getsockname)(const H3270 *hSession, struct sockaddr *addr, socklen_t *addrlen);
/// @brief Set socket options.
int (*setsockopt)(H3270 *hSession, int level, int optname, void *optval, size_t optlen);
/// @brief Get socket options.
int (*getsockopt)(H3270 *hSession, int level, int optname, void *optval, socklen_t *optlen);
} LIB3270_NET_MODULE;
LIB3270_NET_CONTEXT * lib3270_get_net_context(H3270 *hSession);
LIB3270_NET_CONTEXT * lib3270_get_default_net_context(void);
#endif // LIB3270_NETWORKING_H_INCLUDED