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
|
/*
* Unix SMB/CIFS implementation.
* RPC client transport
* Copyright (C) Volker Lendecke 2009
* Copyright (C) Simo Sorce 2010
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, see <http://www.gnu.org/licenses/>.
*/
#ifndef _RPC_CLIENT_RPC_TRANSPORT_H_
#define _RPC_CLIENT_RPC_TRANSPORT_H_
#include "librpc/rpc/dcerpc.h"
/**
* rpc_cli_transport defines a transport mechanism to ship rpc requests
* asynchronously to a server and receive replies
*/
struct rpc_cli_transport {
enum dcerpc_transport_t transport;
/**
* Trigger an async read from the server. May return a short read.
*/
struct tevent_req *(*read_send)(TALLOC_CTX *mem_ctx,
struct tevent_context *ev,
uint8_t *data, size_t size,
void *priv);
/**
* Get the result from the read_send operation.
*/
NTSTATUS (*read_recv)(struct tevent_req *req, ssize_t *preceived);
/**
* Trigger an async write to the server. May return a short write.
*/
struct tevent_req *(*write_send)(TALLOC_CTX *mem_ctx,
struct tevent_context *ev,
const uint8_t *data, size_t size,
void *priv);
/**
* Get the result from the read_send operation.
*/
NTSTATUS (*write_recv)(struct tevent_req *req, ssize_t *psent);
/**
* This is an optimization for the SMB transport. It models the
* TransactNamedPipe API call: Send and receive data in one round
* trip. The transport implementation is free to set this to NULL,
* cli_pipe.c will fall back to the explicit write/read routines.
*/
struct tevent_req *(*trans_send)(TALLOC_CTX *mem_ctx,
struct tevent_context *ev,
const uint8_t *data, size_t data_len,
uint32_t max_rdata_len,
void *priv);
/**
* Get the result from the trans_send operation.
*/
NTSTATUS (*trans_recv)(struct tevent_req *req, TALLOC_CTX *mem_ctx,
uint8_t **prdata, uint32_t *prdata_len);
bool (*is_connected)(void *priv);
unsigned int (*set_timeout)(void *priv, unsigned int timeout);
void *priv;
};
/* The following definitions come from rpc_client/rpc_transport_np.c */
struct cli_state;
struct tevent_req *rpc_transport_np_init_send(TALLOC_CTX *mem_ctx,
struct tevent_context *ev,
struct cli_state *cli,
const struct ndr_interface_table *table);
NTSTATUS rpc_transport_np_init_recv(struct tevent_req *req,
TALLOC_CTX *mem_ctx,
struct rpc_cli_transport **presult);
/* The following definitions come from rpc_client/rpc_transport_sock.c */
NTSTATUS rpc_transport_sock_init(TALLOC_CTX *mem_ctx, int fd,
struct rpc_cli_transport **presult);
/* The following definitions come from rpc_client/rpc_transport_tstream.c */
NTSTATUS rpc_transport_tstream_init(TALLOC_CTX *mem_ctx,
struct tstream_context **stream,
struct rpc_cli_transport **presult);
struct tstream_context *rpc_transport_get_tstream(
struct rpc_cli_transport *transport);
#endif /* _RPC_CLIENT_RPC_TRANSPORT_H_ */
|
