r20116: Start merging in the work done to create the new idmap subsystem.
[samba.git] / source3 / include / idmap.h
1 #ifndef _IDMAP_H_
2 #define _IDMAP_H_
3 /* 
4    Unix SMB/CIFS implementation.
5
6    Idmap headers
7
8    Copyright (C) Jim McDonough <jmcd@us.ibm.com> 2003
9    Copyright (C) Simo Sorce 2003
10    
11    This library is free software; you can redistribute it and/or
12    modify it under the terms of the GNU Library General Public
13    License as published by the Free Software Foundation; either
14    version 2 of the License, or (at your option) any later version.
15    
16    This library is distributed in the hope that it will be useful,
17    but WITHOUT ANY WARRANTY; without even the implied warranty of
18    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
19    Library General Public License for more details.
20    
21    You should have received a copy of the GNU Library General Public
22    License along with this library; if not, write to the
23    Free Software Foundation, Inc., 59 Temple Place - Suite 330,
24    Boston, MA  02111-1307, USA.   
25 */
26
27 /* idmap version determines auto-conversion - this is the database
28    structure version specifier. */
29
30 #define IDMAP_VERSION 2
31
32 /* The interface version specifier. 
33    Updated to 3 for enum types by JRA. */
34
35 /* Updated to 4, completely new interface, SSS */
36
37 #define SMB_IDMAP_INTERFACE_VERSION 4
38
39 struct idmap_domain {
40         DOM_SID *sid;
41         const char *name;
42         BOOL default_domain;
43         BOOL readonly;
44         void *private_data;
45         struct idmap_methods *methods;
46 };
47
48 /* Filled out by IDMAP backends */
49 struct idmap_methods {
50
51         /* Called when backend is first loaded */
52         NTSTATUS (*init)(struct idmap_domain *dom, const char *compat_params);
53
54         NTSTATUS (*unixids_to_sids)(struct idmap_domain *dom, struct id_map **ids);
55         NTSTATUS (*sids_to_unixids)(struct idmap_domain *dom, struct id_map **ids);
56         NTSTATUS (*set_mapping)(struct idmap_domain *dom, const struct id_map *map);
57         NTSTATUS (*remove_mapping)(struct idmap_domain *dom, const struct id_map *map);
58
59         /* Called to dump backends data */
60         /* NOTE: caller must use talloc_free to free maps when done */
61         NTSTATUS (*dump_data)(struct idmap_domain *dom, struct id_map **maps, int *num_maps);
62
63         /* Called when backend is unloaded */
64         NTSTATUS (*close_fn)(struct idmap_domain *dom);
65 };
66
67 struct idmap_alloc_methods {
68
69         /* Called when backend is first loaded */
70         NTSTATUS (*init)(const char *compat_params);
71
72         NTSTATUS (*allocate_id)(struct unixid *id);
73         NTSTATUS (*get_id_hwm)(struct unixid *id);
74         NTSTATUS (*set_id_hwm)(struct unixid *id);
75
76         /* Called when backend is unloaded */
77         NTSTATUS (*close_fn)(void);
78 };
79
80 #endif /* _IDMAP_H_ */