mirror of
https://github.com/samba-team/samba.git
synced 2025-10-24 15:33:20 +03:00
a256e71029
in the right state when called. For example, when we use the unixuid handler in the chain of handlers, and a backend decides to continue a call asynchronously then we need to ensure that the continuation happens with the right security context. The solution is to add a new ntvfs operation ntvfs_async_setup(), which calls all the way down through the layers, setting up anything that is required, and takes a private pointer. The backend wanting to make a async calls can use ntvfs_async_setup() to ensure that the modules above it are called when doing async processing.
146 lines
5.9 KiB
C
146 lines
5.9 KiB
C
/*
|
|
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;
|
|
};
|