2 Unix SMB/CIFS implementation.
3 SMB parameters and setup
4 Copyright (C) Andrew Tridgell 1992-1998
5 Copyright (C) Luke Kenneth Casson Leighton 1996-1998
6 Copyright (C) Jeremy Allison 1998
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>.
25 /* the client asks for a smaller buffer to save ram and also to get more
26 overlap on the wire. This size gives us a nice read/write size, which
27 will be a multiple of the page size on almost any system */
28 #define CLI_BUFFER_SIZE (0xFFFF)
29 #define CLI_SAMBA_MAX_LARGE_READX_SIZE (127*1024) /* Works for Samba servers */
30 #define CLI_SAMBA_MAX_LARGE_WRITEX_SIZE (127*1024) /* Works for Samba servers */
31 #define CLI_WINDOWS_MAX_LARGE_READX_SIZE ((64*1024)-2) /* Windows servers are broken.... */
32 #define CLI_WINDOWS_MAX_LARGE_WRITEX_SIZE ((64*1024)-2) /* Windows servers are broken.... */
33 #define CLI_SAMBA_MAX_POSIX_LARGE_READX_SIZE (0xFFFF00) /* 24-bit len. */
34 #define CLI_SAMBA_MAX_POSIX_LARGE_WRITEX_SIZE (0xFFFF00) /* 24-bit len. */
37 * These definitions depend on smb.h
40 struct print_job_info
{
49 struct cli_pipe_auth_data
{
50 enum pipe_auth_type auth_type
; /* switch for the union below. Defined in ntdomain.h */
51 enum dcerpc_AuthLevel auth_level
; /* defined in ntdomain.h */
55 DATA_BLOB user_session_key
;
58 struct schannel_state
*schannel_auth
;
59 NTLMSSP_STATE
*ntlmssp_state
;
60 struct kerberos_auth_struct
*kerberos_auth
;
65 * rpc_cli_transport defines a transport mechanism to ship rpc requests
66 * asynchronously to a server and receive replies
69 struct rpc_cli_transport
{
71 enum dcerpc_transport_t transport
;
74 * Trigger an async read from the server. May return a short read.
76 struct tevent_req
*(*read_send
)(TALLOC_CTX
*mem_ctx
,
77 struct event_context
*ev
,
78 uint8_t *data
, size_t size
,
81 * Get the result from the read_send operation.
83 NTSTATUS (*read_recv
)(struct tevent_req
*req
, ssize_t
*preceived
);
86 * Trigger an async write to the server. May return a short write.
88 struct tevent_req
*(*write_send
)(TALLOC_CTX
*mem_ctx
,
89 struct event_context
*ev
,
90 const uint8_t *data
, size_t size
,
93 * Get the result from the read_send operation.
95 NTSTATUS (*write_recv
)(struct tevent_req
*req
, ssize_t
*psent
);
98 * This is an optimization for the SMB transport. It models the
99 * TransactNamedPipe API call: Send and receive data in one round
100 * trip. The transport implementation is free to set this to NULL,
101 * cli_pipe.c will fall back to the explicit write/read routines.
103 struct tevent_req
*(*trans_send
)(TALLOC_CTX
*mem_ctx
,
104 struct event_context
*ev
,
105 uint8_t *data
, size_t data_len
,
106 uint32_t max_rdata_len
,
109 * Get the result from the trans_send operation.
111 NTSTATUS (*trans_recv
)(struct tevent_req
*req
, TALLOC_CTX
*mem_ctx
,
112 uint8_t **prdata
, uint32_t *prdata_len
);
114 bool (*is_connected
)(void *priv
);
119 struct rpc_pipe_client
{
120 struct rpc_pipe_client
*prev
, *next
;
122 struct rpc_cli_transport
*transport
;
124 struct ndr_syntax_id abstract_syntax
;
125 struct ndr_syntax_id transfer_syntax
;
127 NTSTATUS (*dispatch
) (struct rpc_pipe_client
*cli
,
129 const struct ndr_interface_table
*table
,
130 uint32_t opnum
, void *r
);
132 struct tevent_req
*(*dispatch_send
)(
134 struct tevent_context
*ev
,
135 struct rpc_pipe_client
*cli
,
136 const struct ndr_interface_table
*table
,
139 NTSTATUS (*dispatch_recv
)(struct tevent_req
*req
,
140 TALLOC_CTX
*mem_ctx
);
144 char *srv_name_slash
;
146 uint16 max_xmit_frag
;
147 uint16 max_recv_frag
;
149 struct cli_pipe_auth_data
*auth
;
151 /* The following is only non-null on a netlogon client pipe. */
152 struct netlogon_creds_CredentialState
*dc
;
154 /* Used by internal rpc_pipe_client */
155 pipes_struct
*pipes_struct
;
158 /* Transport encryption state. */
159 enum smb_trans_enc_type
{
161 #if defined(HAVE_GSSAPI) && defined(HAVE_KRB5)
166 #if defined(HAVE_GSSAPI) && defined(HAVE_KRB5)
167 struct smb_tran_enc_state_gss
{
168 gss_ctx_id_t gss_ctx
;
173 struct smb_trans_enc_state
{
174 enum smb_trans_enc_type smb_enc_type
;
178 NTLMSSP_STATE
*ntlmssp_state
;
179 #if defined(HAVE_GSSAPI) && defined(HAVE_KRB5)
180 struct smb_tran_enc_state_gss
*gss_state
;
185 struct cli_state_seqnum
{
186 struct cli_state_seqnum
*prev
, *next
;
194 * A list of subsidiary connections for DFS.
196 struct cli_state
*prev
, *next
;
199 /* Last read or write error. */
200 enum smb_read_errors smb_rw_error
;
212 /* The credentials used to open the cli_state connection. */
215 char *password
; /* Can be null to force use of zero NTLMSSP session key. */
218 * The following strings are the
219 * ones returned by the server if
220 * the protocol > NT1.
224 fstring server_domain
;
228 struct nmb_name called
;
229 struct nmb_name calling
;
230 fstring full_dest_host_name
;
231 struct sockaddr_storage dest_ss
;
233 DATA_BLOB secblob
; /* cryptkey or negTokenInit */
237 int readbraw_supported
;
238 int writebraw_supported
;
239 int timeout
; /* in milliseconds. */
243 struct cli_state_seqnum
*seqnum
;
245 unsigned int bufsize
;
250 uint32 posix_capabilities
;
254 TALLOC_CTX
*longterm_mem_ctx
;
255 TALLOC_CTX
*call_mem_ctx
;
258 struct smb_signing_state
*signing_state
;
260 struct smb_trans_enc_state
*trans_enc_state
; /* Setup if we're encrypting SMB's. */
262 /* the session key for this CLI, outside
263 any per-pipe authenticaion */
264 DATA_BLOB user_session_key
;
266 /* The list of pipes currently open on this connection. */
267 struct rpc_pipe_client
*pipe_list
;
270 bool fallback_after_kerberos
;
273 bool got_kerberos_mechanism
; /* Server supports krb5 in SPNEGO. */
275 bool use_oplocks
; /* should we use oplocks? */
276 bool use_level_II_oplocks
; /* should we use level II oplocks? */
278 /* a oplock break request handler */
279 NTSTATUS (*oplock_handler
)(struct cli_state
*cli
, uint16_t fnum
, unsigned char level
);
281 bool force_dos_errors
;
282 bool case_sensitive
; /* False by default. */
284 /* Where (if anywhere) this is mounted under DFS. */
285 char *dfs_mountpoint
;
287 struct tevent_queue
*outgoing
;
288 struct tevent_req
**pending
;
291 typedef struct file_info
{
292 struct cli_state
*cli
;
297 /* these times are normally kept in GMT */
298 struct timespec mtime_ts
;
299 struct timespec atime_ts
;
300 struct timespec ctime_ts
;
302 char short_name
[13*3]; /* the *3 is to cope with multi-byte */
305 #define CLI_FULL_CONNECTION_DONT_SPNEGO 0x0001
306 #define CLI_FULL_CONNECTION_USE_KERBEROS 0x0002
307 #define CLI_FULL_CONNECTION_ANONYMOUS_FALLBACK 0x0004
308 #define CLI_FULL_CONNECTION_FALLBACK_AFTER_KERBEROS 0x0008
309 #define CLI_FULL_CONNECTION_OPLOCKS 0x0010
310 #define CLI_FULL_CONNECTION_LEVEL_II_OPLOCKS 0x0020
311 #define CLI_FULL_CONNECTION_USE_CCACHE 0x0040
313 #endif /* _CLIENT_H */