2 Unix SMB/CIFS implementation.
3 SMB parameters and setup
4 Copyright (C) Andrew Tridgell 1992-1997
5 Copyright (C) Luke Kenneth Casson Leighton 1996-1997
6 Copyright (C) Paul Ashton 1997
7 Copyright (C) Simo Sorce 2003
8 Copyright (C) Gerald (Jerry) Carter 2005
9 Copyright (C) Andrew Bartlett 2010
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 3 of the License, or
14 (at your option) any later version.
16 This program 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
19 GNU General Public License for more details.
21 You should have received a copy of the GNU General Public License
22 along with this program. If not, see <http://www.gnu.org/licenses/>.
28 #include "../librpc/gen_ndr/lsa.h"
29 #include "../librpc/gen_ndr/security.h"
31 /* privilege bitmask */
33 /* common privilege defines */
37 #define SE_ALL_PRIVS (uint64_t)-1
40 /* defined in lib/privilegs_basic.c */
42 extern const uint64_t se_priv_all;
44 extern const uint64_t se_priv_none;
45 extern const uint64_t se_machine_account;
46 extern const uint64_t se_print_operator;
47 extern const uint64_t se_add_users;
48 extern const uint64_t se_disk_operators;
49 extern const uint64_t se_remote_shutdown;
50 extern const uint64_t se_restore;
51 extern const uint64_t se_take_ownership;
55 * These are used in Lsa replies (srv_lsa_nt.c)
63 struct lsa_LUIDAttribute *set;
67 enum sec_privilege luid;
68 uint64_t privilege_mask;
70 const char *description;
73 /***************************************************************************
74 copy an uint64_t structure
75 ****************************************************************************/
77 bool se_priv_copy( uint64_t *dst, const uint64_t *src );
79 /***************************************************************************
80 put all privileges into a mask
81 ****************************************************************************/
83 bool se_priv_put_all_privileges(uint64_t *privilege_mask);
85 /***************************************************************************
86 combine 2 uint64_t structures and store the resulting set in mew_mask
87 ****************************************************************************/
89 void se_priv_add( uint64_t *privilege_mask, const uint64_t *addpriv );
91 /***************************************************************************
92 remove one uint64_t sytucture from another and store the resulting set
94 ****************************************************************************/
96 void se_priv_remove( uint64_t *privilege_mask, const uint64_t *removepriv );
98 /***************************************************************************
99 check if 2 uint64_t structure are equal
100 ****************************************************************************/
102 bool se_priv_equal( const uint64_t *privilege_mask1, const uint64_t *privilege_mask2 );
104 /*********************************************************************
105 Lookup the uint64_t value for a privilege name
106 *********************************************************************/
108 bool se_priv_from_name( const char *name, uint64_t *privilege_mask );
110 /***************************************************************************
111 dump an uint64_t structure to the log files
112 ****************************************************************************/
114 void dump_se_priv( int dbg_cl, int dbg_lvl, const uint64_t *privilege_mask );
116 /****************************************************************************
117 check if the privilege is in the privilege list
118 ****************************************************************************/
120 bool is_privilege_assigned(const uint64_t *privileges,
121 const uint64_t *check);
123 const char* get_privilege_dispname( const char *name );
125 /****************************************************************************
126 Does the user have the specified privilege ? We only deal with one privilege
128 *****************************************************************************/
130 bool user_has_privileges(const struct security_token *token, const uint64_t *privilege_bit);
132 /****************************************************************************
133 Does the user have any of the specified privileges ? We only deal with one privilege
135 *****************************************************************************/
137 bool user_has_any_privilege(struct security_token *token, const uint64_t *privilege_mask);
139 /*******************************************************************
140 return the number of elements in the privlege array
141 *******************************************************************/
143 int count_all_privileges( void );
145 /*********************************************************************
146 Generate the struct lsa_LUIDAttribute structure based on a bitmask
147 The assumption here is that the privilege has already been validated
148 so we are guaranteed to find it in the list.
149 *********************************************************************/
151 enum sec_privilege get_privilege_luid( uint64_t *privilege_mask );
152 /****************************************************************************
153 Convert a LUID to a named string
154 ****************************************************************************/
156 const char *luid_to_privilege_name(const struct lsa_LUID *set);
158 bool se_priv_to_privilege_set( PRIVILEGE_SET *set, uint64_t *privilege_mask );
159 bool privilege_set_to_se_priv( uint64_t *privilege_mask, struct lsa_PrivilegeSet *privset );
162 map a privilege id to the wire string constant
164 const char *sec_privilege_name(enum sec_privilege privilege);
167 map a privilege id to a privilege display name. Return NULL if not found
169 TODO: this should use language mappings
171 const char *sec_privilege_display_name(enum sec_privilege privilege, uint16_t *language);
174 map a privilege name to a privilege id. Return -1 if not found
176 enum sec_privilege sec_privilege_id(const char *name);
179 map a privilege name to a privilege id. Return -1 if not found
181 enum sec_privilege sec_privilege_from_mask(uint64_t mask);
184 map a privilege name to a privilege id. Return -1 if not found
186 enum sec_privilege sec_privilege_from_index(int idx);
189 return true if a security_token has a particular privilege bit set
191 bool security_token_has_privilege(const struct security_token *token, enum sec_privilege privilege);
194 set a bit in the privilege mask
196 void security_token_set_privilege(struct security_token *token, enum sec_privilege privilege);
198 void security_token_debug_privileges(int dbg_lev, const struct security_token *token);
200 #endif /* PRIVILEGES_H */