summaryrefslogtreecommitdiff
path: root/source4/ntvfs/ntvfs.h
blob: c9fe276f5441850d235e98d438bbbcaa10414660 (plain)
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
142
143
144
145
/* 
   Unix SMB/CIFS implementation.
   NTVFS structures and defines
   Copyright (C) Andrew Tridgell			2003
   Copyright (C) Stefan Metzmacher			2004
   
   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.
*/

/* modules can use the following to determine if the interface has changed */
/* version 1 -> 0 - make module stacking easier -- metze */
#define NTVFS_INTERFACE_VERSION 0

struct ntvfs_module_context;

/* each backend has to be one one of the following 3 basic types. In
 * earlier versions of Samba backends needed to handle all types, now
 * we implement them separately. */
enum ntvfs_type {NTVFS_DISK, NTVFS_PRINT, NTVFS_IPC};

/* the ntvfs operations structure - contains function pointers to 
   the backend implementations of each operation */
struct ntvfs_ops {
	const char *name;
	enum ntvfs_type type;
	
	/* initial setup */
	NTSTATUS (*connect)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, const char *sharename);
	NTSTATUS (*disconnect)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_tcon *tcon);

	/* path operations */
	NTSTATUS (*unlink)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, struct smb_unlink *unl);
	NTSTATUS (*chkpath)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, struct smb_chkpath *cp);
	NTSTATUS (*qpathinfo)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_fileinfo *st);
	NTSTATUS (*setpathinfo)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_setfileinfo *st);
	NTSTATUS (*open)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_open *oi);
	NTSTATUS (*mkdir)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_mkdir *md);
	NTSTATUS (*rmdir)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, struct smb_rmdir *rd);
	NTSTATUS (*rename)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_rename *ren);
	NTSTATUS (*copy)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, struct smb_copy *cp);

	/* directory search */
	NTSTATUS (*search_first)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_search_first *io, void *private,
				 BOOL (*callback)(void *private, union smb_search_data *file));
	NTSTATUS (*search_next)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_search_next *io, void *private,
				 BOOL (*callback)(void *private, union smb_search_data *file));
	NTSTATUS (*search_close)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_search_close *io);

	/* operations on open files */
	NTSTATUS (*ioctl)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_ioctl *io);
	NTSTATUS (*read)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_read *io);
	NTSTATUS (*write)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_write *io);
	NTSTATUS (*seek)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, struct smb_seek *io);
	NTSTATUS (*flush)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, struct smb_flush *flush);
	NTSTATUS (*close)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_close *io);
	NTSTATUS (*exit)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req);
	NTSTATUS (*lock)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_lock *lck);
	NTSTATUS (*setfileinfo)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_setfileinfo *info);
	NTSTATUS (*qfileinfo)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_fileinfo *info);

	/* filesystem operations */
	NTSTATUS (*fsinfo)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_fsinfo *fs);

	/* printing specific operations */
	NTSTATUS (*lpq)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, union smb_lpq *lpq);

	/* trans2 interface - only used by CIFS backend to prover complete passthru for testing */
	NTSTATUS (*trans2)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, struct smb_trans2 *trans2);

	/* trans interface - used by IPC backend for pipes and RAP calls */
	NTSTATUS (*trans)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, struct smb_trans2 *trans);

	/* logoff - called when a vuid is closed */
	NTSTATUS (*logoff)(struct ntvfs_module_context *ntvfs, 
			   struct smbsrv_request *req);

	/* async_setup - called when a backend is processing a async request */
	NTSTATUS (*async_setup)(struct ntvfs_module_context *ntvfs, 
				struct smbsrv_request *req, void *private);
};

struct ntvfs_module_context {
	struct ntvfs_module_context *prev, *next;
	void *private_data;
	const struct ntvfs_ops *ops;
	int depth;
};

struct ntvfs_context {
	enum ntvfs_type type;
	/* 
	 * linked list of module contexts
	 */
	struct ntvfs_module_context *modules;
};

/* this structure is used by backends to determine the size of some critical types */
struct ntvfs_critical_sizes {
	int interface_version;
	int sizeof_ntvfs_context;
	int sizeof_ntvfs_module_context;
	int sizeof_ntvfs_ops;
	int sizeof_smbsrv_tcon;
	int sizeof_smbsrv_request;
};