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 #include "../librpc/ndr/libndr.h"
27 /* the client asks for a smaller buffer to save ram and also to get more
28 overlap on the wire. This size gives us a nice read/write size, which
29 will be a multiple of the page size on almost any system */
30 #define CLI_BUFFER_SIZE (0xFFFF)
31 #define CLI_SAMBA_MAX_LARGE_READX_SIZE (127*1024) /* Works for Samba servers */
32 #define CLI_SAMBA_MAX_LARGE_WRITEX_SIZE (127*1024) /* Works for Samba servers */
33 #define CLI_WINDOWS_MAX_LARGE_READX_SIZE ((64*1024)-2) /* Windows servers are broken.... */
34 #define CLI_WINDOWS_MAX_LARGE_WRITEX_SIZE ((64*1024)-2) /* Windows servers are broken.... */
35 #define CLI_SAMBA_MAX_POSIX_LARGE_READX_SIZE (0xFFFF00) /* 24-bit len. */
36 #define CLI_SAMBA_MAX_POSIX_LARGE_WRITEX_SIZE (0xFFFF00) /* 24-bit len. */
39 * These definitions depend on smb.h
42 struct print_job_info
{
52 * rpc_cli_transport defines a transport mechanism to ship rpc requests
53 * asynchronously to a server and receive replies
56 struct rpc_cli_transport
{
58 enum dcerpc_transport_t transport
;
61 * Trigger an async read from the server. May return a short read.
63 struct tevent_req
*(*read_send
)(TALLOC_CTX
*mem_ctx
,
64 struct event_context
*ev
,
65 uint8_t *data
, size_t size
,
68 * Get the result from the read_send operation.
70 NTSTATUS (*read_recv
)(struct tevent_req
*req
, ssize_t
*preceived
);
73 * Trigger an async write to the server. May return a short write.
75 struct tevent_req
*(*write_send
)(TALLOC_CTX
*mem_ctx
,
76 struct event_context
*ev
,
77 const uint8_t *data
, size_t size
,
80 * Get the result from the read_send operation.
82 NTSTATUS (*write_recv
)(struct tevent_req
*req
, ssize_t
*psent
);
85 * This is an optimization for the SMB transport. It models the
86 * TransactNamedPipe API call: Send and receive data in one round
87 * trip. The transport implementation is free to set this to NULL,
88 * cli_pipe.c will fall back to the explicit write/read routines.
90 struct tevent_req
*(*trans_send
)(TALLOC_CTX
*mem_ctx
,
91 struct event_context
*ev
,
92 uint8_t *data
, size_t data_len
,
93 uint32_t max_rdata_len
,
96 * Get the result from the trans_send operation.
98 NTSTATUS (*trans_recv
)(struct tevent_req
*req
, TALLOC_CTX
*mem_ctx
,
99 uint8_t **prdata
, uint32_t *prdata_len
);
101 bool (*is_connected
)(void *priv
);
102 unsigned int (*set_timeout
)(void *priv
, unsigned int timeout
);
107 struct dcerpc_binding_handle
;
109 struct rpc_pipe_client
{
110 struct rpc_pipe_client
*prev
, *next
;
112 struct rpc_cli_transport
*transport
;
113 struct dcerpc_binding_handle
*binding_handle
;
115 struct ndr_syntax_id abstract_syntax
;
116 struct ndr_syntax_id transfer_syntax
;
119 char *srv_name_slash
;
121 uint16 max_xmit_frag
;
122 uint16 max_recv_frag
;
124 struct pipe_auth_data
*auth
;
126 /* The following is only non-null on a netlogon client pipe. */
127 struct netlogon_creds_CredentialState
*dc
;
130 /* Transport encryption state. */
131 enum smb_trans_enc_type
{
133 #if defined(HAVE_GSSAPI) && defined(HAVE_KRB5)
138 #if defined(HAVE_GSSAPI) && defined(HAVE_KRB5)
139 struct smb_tran_enc_state_gss
{
140 gss_ctx_id_t gss_ctx
;
145 struct smb_trans_enc_state
{
146 enum smb_trans_enc_type smb_enc_type
;
150 struct ntlmssp_state
*ntlmssp_state
;
151 #if defined(HAVE_GSSAPI) && defined(HAVE_KRB5)
152 struct smb_tran_enc_state_gss
*gss_state
;
157 struct cli_state_seqnum
{
158 struct cli_state_seqnum
*prev
, *next
;
166 * A list of subsidiary connections for DFS.
168 struct cli_state
*prev
, *next
;
171 /* Last read or write error. */
172 enum smb_read_errors smb_rw_error
;
184 /* The credentials used to open the cli_state connection. */
187 char *password
; /* Can be null to force use of zero NTLMSSP session key. */
190 * The following strings are the
191 * ones returned by the server if
192 * the protocol > NT1.
196 fstring server_domain
;
200 struct nmb_name called
;
201 struct nmb_name calling
;
202 struct sockaddr_storage dest_ss
;
204 DATA_BLOB secblob
; /* cryptkey or negTokenInit */
208 int readbraw_supported
;
209 int writebraw_supported
;
210 int timeout
; /* in milliseconds. */
214 struct cli_state_seqnum
*seqnum
;
216 unsigned int bufsize
;
221 /* What the server offered. */
222 uint32_t server_posix_capabilities
;
223 /* What the client requested. */
224 uint32_t requested_posix_capabilities
;
227 struct smb_signing_state
*signing_state
;
229 struct smb_trans_enc_state
*trans_enc_state
; /* Setup if we're encrypting SMB's. */
231 /* the session key for this CLI, outside
232 any per-pipe authenticaion */
233 DATA_BLOB user_session_key
;
235 /* The list of pipes currently open on this connection. */
236 struct rpc_pipe_client
*pipe_list
;
239 bool fallback_after_kerberos
;
242 bool got_kerberos_mechanism
; /* Server supports krb5 in SPNEGO. */
244 bool use_oplocks
; /* should we use oplocks? */
245 bool use_level_II_oplocks
; /* should we use level II oplocks? */
247 /* a oplock break request handler */
248 NTSTATUS (*oplock_handler
)(struct cli_state
*cli
, uint16_t fnum
, unsigned char level
);
250 bool force_dos_errors
;
251 bool case_sensitive
; /* False by default. */
253 /* Where (if anywhere) this is mounted under DFS. */
254 char *dfs_mountpoint
;
256 struct tevent_queue
*outgoing
;
257 struct tevent_req
**pending
;
265 /* these times are normally kept in GMT */
266 struct timespec mtime_ts
;
267 struct timespec atime_ts
;
268 struct timespec ctime_ts
;
270 char short_name
[13*3]; /* the *3 is to cope with multi-byte */
273 #define CLI_FULL_CONNECTION_DONT_SPNEGO 0x0001
274 #define CLI_FULL_CONNECTION_USE_KERBEROS 0x0002
275 #define CLI_FULL_CONNECTION_ANONYMOUS_FALLBACK 0x0004
276 #define CLI_FULL_CONNECTION_FALLBACK_AFTER_KERBEROS 0x0008
277 #define CLI_FULL_CONNECTION_OPLOCKS 0x0010
278 #define CLI_FULL_CONNECTION_LEVEL_II_OPLOCKS 0x0020
279 #define CLI_FULL_CONNECTION_USE_CCACHE 0x0040
281 #endif /* _CLIENT_H */