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
;
66 /***************************************************************************
67 copy an uint64_t structure
68 ****************************************************************************/
70 bool se_priv_copy( uint64_t *dst
, const uint64_t *src
);
72 /***************************************************************************
73 put all privileges into a mask
74 ****************************************************************************/
76 bool se_priv_put_all_privileges(uint64_t *privilege_mask
);
78 /*********************************************************************
79 Lookup the uint64_t value for a privilege name
80 *********************************************************************/
82 bool se_priv_from_name( const char *name
, uint64_t *privilege_mask
);
84 /****************************************************************************
85 check if the privilege is in the privilege list
86 ****************************************************************************/
88 bool is_privilege_assigned(const uint64_t *privileges
,
89 const uint64_t *check
);
91 const char* get_privilege_dispname( const char *name
);
93 /****************************************************************************
94 Does the user have the specified privilege ? We only deal with one privilege
96 *****************************************************************************/
98 bool user_has_privileges(const struct security_token
*token
, const uint64_t *privilege_bit
);
100 /****************************************************************************
101 Does the user have any of the specified privileges ? We only deal with one privilege
103 *****************************************************************************/
105 bool user_has_any_privilege(struct security_token
*token
, const uint64_t *privilege_mask
);
107 /*******************************************************************
108 return the number of elements in the 'short' privlege array (traditional source3 behaviour)
109 *******************************************************************/
111 int num_privileges_in_short_list( void );
113 /****************************************************************************
114 Convert a LUID to a named string
115 ****************************************************************************/
117 bool se_priv_to_privilege_set( PRIVILEGE_SET
*set
, uint64_t privilege_mask
);
118 bool privilege_set_to_se_priv( uint64_t *privilege_mask
, struct lsa_PrivilegeSet
*privset
);
121 map a privilege id to the wire string constant
123 const char *sec_privilege_name(enum sec_privilege privilege
);
126 map a privilege id to a privilege display name. Return NULL if not found
128 TODO: this should use language mappings
130 const char *sec_privilege_display_name(enum sec_privilege privilege
, uint16_t *language
);
133 map a privilege name to a privilege id. Return -1 if not found
135 enum sec_privilege
sec_privilege_id(const char *name
);
138 map a privilege name to a privilege id. Return -1 if not found
140 enum sec_privilege
sec_privilege_from_mask(uint64_t mask
);
143 assist in walking the table of privileges - return the LUID (low 32 bits) by index
145 enum sec_privilege
sec_privilege_from_index(int idx
);
148 assist in walking the table of privileges - return the string constant by index
150 const char *sec_privilege_name_from_index(int idx
);
153 return true if a security_token has a particular privilege bit set
155 bool security_token_has_privilege(const struct security_token
*token
, enum sec_privilege privilege
);
158 set a bit in the privilege mask
160 void security_token_set_privilege(struct security_token
*token
, enum sec_privilege privilege
);
162 void security_token_debug_privileges(int dbg_lev
, const struct security_token
*token
);
164 #endif /* PRIVILEGES_H */