1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-23 17:34:34 +03:00
samba-mirror/source4/include/cli_context.h
Herb Lewis 3ae6d32e5e signed bitfields cannot be 1 bit long
(This used to be commit 5fce80e757)
2003-08-15 17:15:05 +00:00

309 lines
8.5 KiB
C

/*
Unix SMB/CIFS implementation.
SMB parameters and setup
Copyright (C) Andrew Tridgell 1992-1998
Copyright (C) Luke Kenneth Casson Leighton 1996-1998
Copyright (C) Jeremy Allison 1998
Copyright (C) James Myers 2003 <myersjj@samba.org>
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 2 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, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#ifndef _CLI_CONTEXT_H
#define _CLI_CONTEXT_H
struct cli_tree; /* forward declare */
struct cli_request; /* forward declare */
struct cli_session; /* forward declare */
struct cli_transport; /* forward declare */
typedef struct smb_sign_info {
void (*sign_outgoing_message)(struct cli_request *req);
BOOL (*check_incoming_message)(struct cli_request *req);
void (*free_signing_context)(struct cli_transport *transport);
void *signing_context;
BOOL doing_signing;
} smb_sign_info;
/* context that will be and has been negotiated between the client and server */
struct cli_negotiate {
/*
* negotiated maximum transmit size - this is given to us by the server
*/
unsigned max_xmit;
/* maximum number of requests that can be multiplexed */
uint16 max_mux;
/* the negotiatiated protocol */
enum protocol_types protocol;
int sec_mode; /* security mode returned by negprot */
DATA_BLOB secblob; /* cryptkey or negTokenInit blob */
uint32 sesskey;
smb_sign_info sign_info;
/* capabilities that the server reported */
uint32 capabilities;
int server_zone;
time_t server_time;
unsigned int readbraw_supported:1;
unsigned int writebraw_supported:1;
const char *server_domain;
};
/* this is the context for a SMB socket associated with the socket itself */
struct cli_socket {
TALLOC_CTX *mem_ctx; /* life of socket pool */
/* when the reference count reaches zero then the socket is destroyed */
int reference_count;
struct in_addr dest_ip;
/* the port used */
int port;
/* the open file descriptor */
int fd;
/* a count of the number of packets we have received. We
* actually only care about zero/non-zero at this stage */
unsigned pkt_count;
/* the network address of the client */
char *client_addr;
/* timeout for socket operations in milliseconds. */
int timeout;
};
/*
this structure allows applications to control the behaviour of the
client library
*/
struct cli_options {
unsigned int use_oplocks:1;
unsigned int use_level2_oplocks:1;
unsigned int use_spnego:1;
};
/* this is the context for the client transport layer */
struct cli_transport {
TALLOC_CTX *mem_ctx;
/* when the reference count reaches zero then the transport is destroyed */
int reference_count;
/* socket level info */
struct cli_socket *socket;
/* the next mid to be allocated - needed for signing and
request matching */
uint16 next_mid;
/* negotiated protocol information */
struct cli_negotiate negotiate;
/* options to control the behaviour of the client code */
struct cli_options options;
/* is a readbraw pending? we need to handle that case
specially on receiving packets */
unsigned int readbraw_pending:1;
/* an idle function - if this is defined then it will be
called once every period milliseconds while we are waiting
for a packet */
struct {
void (*func)(struct cli_transport *, void *);
void *private;
uint_t period;
} idle;
/* the error fields from the last message */
struct {
enum {ETYPE_NONE, ETYPE_DOS, ETYPE_NT, ETYPE_SOCKET, ETYPE_NBT} etype;
union {
struct {
uint8 eclass;
uint16 ecode;
} dos;
NTSTATUS nt_status;
enum socket_error socket_error;
unsigned nbt_error;
} e;
} error;
struct {
/* a oplock break request handler */
BOOL (*handler)(struct cli_transport *transport,
uint16 tid, uint16 fnum, uint8 level, void *private);
/* private data passed to the oplock handler */
void *private;
} oplock;
/* a list of async requests that are pending on this connection */
struct cli_request *pending_requests;
};
/* this is the context for the user */
/* this is the context for the session layer */
struct cli_session {
TALLOC_CTX *mem_ctx; /* life of session */
/* when the reference count reaches zero then the session is destroyed */
int reference_count;
/* transport layer info */
struct cli_transport *transport;
/* after a session setup the server provides us with
a vuid identifying the security context */
uint16 vuid;
/* default pid for this session */
uint32 pid;
};
/*
cli_tree context: internal state for a tree connection.
*/
struct cli_tree {
/* life of tree tree */
TALLOC_CTX *mem_ctx;
/* when the reference count reaches zero then the tree is destroyed */
int reference_count;
/* session layer info */
struct cli_session *session;
uint16 tid; /* tree id, aka cnum */
char *device;
char *fs_type;
};
/* the context for a single SMB request. This is passed to any request-context
* functions (similar to context.h, the server version).
* This will allow requests to be multi-threaded. */
struct cli_request {
/* allow a request to be part of a list of requests */
struct cli_request *next, *prev;
/* a talloc context for the lifetime of this request */
TALLOC_CTX *mem_ctx;
/* a request always has a transport context, nearly always has
a session context and usually has a tree context */
struct cli_transport *transport;
struct cli_session *session;
struct cli_tree *tree;
/* the flags2 from the SMB request, in raw form (host byte
order). Used to parse strings */
uint16 flags2;
/* the NT status for this request. Set by packet receive code
or code detecting error. */
NTSTATUS status;
/* the sequence number of this packet - used for signing */
unsigned seq_num;
/* set if this is a one-way request, meaning we are not
expecting a reply from the server. */
unsigned int one_way_request:1;
/* the mid of this packet - used to match replies */
uint16 mid;
struct {
/* the raw SMB buffer, including the 4 byte length header */
char *buffer;
/* the size of the raw buffer, including 4 byte header */
unsigned size;
/* how much has been allocated - on reply the buffer is over-allocated to
prevent too many realloc() calls
*/
unsigned allocated;
/* the start of the SMB header - this is always buffer+4 */
char *hdr;
/* the command words and command word count. vwv points
into the raw buffer */
char *vwv;
unsigned wct;
/* the data buffer and size. data points into the raw buffer */
char *data;
unsigned data_size;
/* ptr is used as a moving pointer into the data area
* of the packet. The reason its here and not a local
* variable in each function is that when a realloc of
* a send packet is done we need to move this
* pointer */
char *ptr;
} in, out;
/* information on what to do with a reply when it is received
asyncronously. If this is not setup when a reply is received then
the reply is discarded
The private pointer is private to the caller of the client
library (the application), not private to the library
*/
struct {
void (*fn)(struct cli_request *);
void *private;
} async;
};
/*
cli_state: internal state used in libcli library for single-threaded callers,
i.e. a single session on a single socket.
*/
struct cli_state {
TALLOC_CTX *mem_ctx; /* life of client pool */
struct cli_transport *transport;
struct cli_session *session;
struct cli_tree *tree;
struct substitute_context substitute;
};
/* useful way of catching wct errors with file and line number */
#define CLI_CHECK_MIN_WCT(req, wcount) if ((req)->in.wct < (wcount)) { \
DEBUG(1,("Unexpected WCT %d at %s(%d) - expected min %d\n", (req)->in.wct, __FILE__, __LINE__, wcount)); \
req->status = NT_STATUS_INVALID_PARAMETER; \
goto failed; \
}
#define CLI_CHECK_WCT(req, wcount) if ((req)->in.wct != (wcount)) { \
DEBUG(1,("Unexpected WCT %d at %s(%d) - expected %d\n", (req)->in.wct, __FILE__, __LINE__, wcount)); \
req->status = NT_STATUS_INVALID_PARAMETER; \
goto failed; \
}
#endif /* _CLI_CONTEXT_H */