include/linux/lsm_hooks.h

2  * Linux Security Module interfaces
28 #include <linux/security.h>
33  * union security_list_options - Linux Security Module hook function list
35  * Security hooks for program execution operations.
38  *	If the setup in prepare_exec_creds did not setup @bprm->cred->security
40  *	@bprm->cred->security to be what commit_creds needs to install for the
42  *	(e.g. for transitions between security domains).
55  *	between security domains).
64  *	begin.  It allows a check against the @bprm->cred->security value
71  *	Prepare to install the new security attributes of a process being
80  *	Tidy up after the installation of the new security attributes of a
87  * Security hooks for mount using fs_context.
91  *	Allocate and attach a security structure to sc->security.  This pointer
103  * Security hooks for filesystem operations.
106  *	Allocate and attach a security structure to the sb->s_security field.
138  *	so that the security module can extract security-specific mount
140  *	This also allows the original mount data to be stripped of security-
143  *	@copy copied data which will be passed to the security module.
146  *	Extracts security system specific mount options and verifies no changes
167  *	Set the security relevant mount options used for a superblock
168  *	@sb the superblock to set security mount options for
171  *	Copy all security options from a given superblock to another
177  *	Parse a string of security data filling in the opts structure
204  * Security hooks for inode operations.
207  *	Allocate and attach a security structure to @inode->i_security.  The
214  *	Deallocate the inode security structure and set @inode->i_security to
217  *	Obtain the security attribute name suffix and value to set on a newly
218  *	created inode and set up the incore security field for the new inode.
224  *	If the security module does not use security attributes or does
225  *	not wish to put a security attribute on this particular inode,
234  *	-EOPNOTSUPP if no security attribute is needed, or
375  *	existing Linux permission function, so a security module can use it to
404  *	Update inode security field after successful setxattr operation.
420  *	security label associated with @name for @inode via @buffer.  Note that
421  *	@name is the remainder of the attribute name after the security prefix
426  *	Set the security label associated with @name for @inode from the
430  *	security. prefix has been removed.
433  *	Copy the extended attribute names for the security labels
445  *	The setuid bit is being removed.  Remove similar security labels.
457  *	overlay filesystem. Security module can prepare a set of new creds
469  *	security module does not know about attribute or a negative error code
473  * 	Fill in @inode security information for a @dentry if allowed.
479  * Security hooks for kernfs node operations
482  *	Initialize the security context of a newly created kernfs node based
488  * Security hooks for file operations
492  *	called by various operations that read or write files.  A security
502  *	Security modules must handle this separately if they need such
508  *	Allocate and attach a security structure to the file->f_security field.
509  *	The security field is initialized to NULL when the structure is first
514  *	Deallocate and free any security structures stored in file->f_security.
523  *	should never be used by the security module.
555  *	never be used by the security module.
561  *	Save owner security information (typically from current->security) in
569  *	struct file, so the file structure (and associated security information)
576  *	This hook allows security modules to control the ability of a process
585  * Security hooks for task operations.
603  *	Deallocate and clear the cred->security field in a set of credentials.
614  *	Retrieve the security identifier of the cred structure @c
620  *	@secid specifies the security ID to be set
701  *	Retrieve the security identifier of the process @p.
773  *	Set the security attributes for an inode based on an associated task's
774  *	security attributes, e.g. for /proc/pid inodes.
778  * Security hooks for Netlink messaging.
781  *	Save security information for a netlink message so that permission
782  *	checking can be performed when the message is processed.  The security
791  * Security hooks for Unix domain networking.
817  * Security hooks for socket operations.
827  *	This hook allows a module to update or allocate a per-socket security
828  *	structure. Note that the security field was not added directly to the
829  *	socket structure, but rather, the socket security information is stored
831  *	allocate and attach security information to
924  *	This hook allows the security module to provide peer socket security
929  *	@optval userspace memory where the security state is to be copied.
931  *	of the security state.
937  *	This hook allows the security module to provide peer socket security
941  *	security state returned by this hook for a packet via the SCM_SECURITY
948  *	Allocate and attach a security structure to the sk->sk_security field,
949  *	which is used to copy security attributes between local stream sockets.
951  *	Deallocate security structure.
953  *	Clone/copy security structure.
976  *	This hook allows a module to allocate a security structure for a TUN
978  *	@security pointer to a security structure pointer.
981  *	This hook allows a module to free the security structure for a TUN
983  *	@security pointer to the TUN device's security structure
988  *	@security pointer to the TUN device's security structure.
990  *	This hook can be used by the module to update any security state
993  *	@security pointer to the TUN device's security structure.
995  *	This hook can be used by the module to update any security state
996  *	associated with the TUN device's security structure.
997  *	@security pointer to the TUN devices's security structure.
999  * Security hooks for SCTP
1003  *	the security module.
1026  * Security hooks for Infiniband
1032  *	@sec pointer to a security structure.
1037  *	@sec pointer to a security structure.
1039  *	Allocate a security structure for Infiniband objects.
1040  *	@sec pointer to a security structure pointer.
1043  *	Deallocate an Infiniband security structure.
1044  *	@sec contains the security structure to be freed.
1046  * Security hooks for XFRM operations.
1049  *	@ctxp is a pointer to the xfrm_sec_ctx being added to Security Policy
1051  *	@sec_ctx contains the security context information being provided by
1053  *	Allocate a security structure to the xp->security field; the security
1060  *	Allocate a security structure in new_ctxp that contains the
1065  *	Deallocate xp->security.
1068  *	Authorize deletion of xp->security.
1070  *	@x contains the xfrm_state being added to the Security Association
1072  *	@sec_ctx contains the security context information being provided by
1074  *	Allocate a security structure to the x->security field; the security
1079  *	@x contains the xfrm_state being added to the Security Association
1081  *	@polsec contains the policy's security context.
1084  *	Allocate a security structure to the x->security field; the security
1090  *	Deallocate x->security.
1093  *	Authorize deletion of x->security.
1097  *	@fl_secid contains the flow security label that is used to authorize
1116  * Security hooks affecting all Key Management operations
1119  *	Permit allocation of a key and assign security data. Note that key does
1125  *	Notification of destruction; free security data.
1133  *	evaluate the security data on the key.
1137  *	Get a textual representation of the security context attached to a key
1148  * Security hooks affecting all System V IPC operations.
1161  * Security hooks for individual messages held in System V IPC message queues
1164  *	Allocate and attach a security structure to the msg->security field.
1165  *	The security field is initialized to NULL when the structure is first
1170  *	Deallocate the security structure for this message.
1173  * Security hooks for System V IPC Message Queues
1176  *	Allocate and attach a security structure to the
1177  *	@perm->security field. The security field is initialized to
1182  *	Deallocate security field @perm->security for the message queue.
1218  * Security hooks for System V Shared Memory Segments
1221  *	Allocate and attach a security structure to the @perm->security
1222  *	field. The security field is initialized to NULL when the structure is
1227  *	Deallocate the security structure @perm->security for the memory segment.
1253  * Security hooks for System V Semaphores
1256  *	Allocate and attach a security structure to the @perm->security
1257  *	field. The security field is initialized to NULL when the structure is
1262  *	Deallocate security structure @perm->security for the semaphore.
1311  *	Security modules may also want to perform a process tracing check
1314  *	binprm_security_ops if the process is being traced and its security
1350  *	@opts contains options for the capable check <include/linux/security.h>
1383  *	Convert secid to security context.  If secdata is NULL the length of
1388  *	@secid contains the security ID.
1389  *	@secdata contains the pointer that stores the converted security
1393  *	Convert security context to secid.
1394  *	@secid contains the pointer to the generated security ID.
1395  *	@secdata contains the security context.
1398  *	Release the security context.
1399  *	@secdata contains the security context.
1400  *	@seclen contains the length of the security context.
1402  * Security hooks for Audit
1423  *	@secid contains the security id in question.
1435  *	Notify the security module that it must revalidate the security context
1439  *	Notify the security module of what the security context of an inode
1440  *	should be.  Initializes the incore security context managed by the
1441  *	security module for this inode.  Example usage:  NFS client invokes
1442  *	this hook to initialize the security context in its incore inode to the
1446  *	@inode we wish to set the security context of.
1451  *	Change the security context of an inode.  Updates the
1452  *	incore security context managed by the security module and invokes the
1455  *	this hook to change the security context in its incore inode and on the
1459  *	@dentry contains the inode we wish to set the security context of.
1464  *	On success, returns 0 and fills out @ctx and @ctxlen with the security
1466  *	@inode we wish to get the security context of.
1467  *	@ctx is a pointer in which to place the allocated security context.
1470  * Security hooks for the general notification queue:
1484  * Security hooks for using the eBPF maps and programs functionalities through
1489  *	into the kernel. The actual security module can implement their own
1506  *	Initialize the security field inside bpf map.
1509  *	Clean up the security information stored inside bpf map.
1512  *	Initialize the security field inside bpf program.
1515  *	Clean up the security information stored inside bpf prog.
1523  * Security hooks for perf events
1528  * 	Allocate and save perf_event security info.
1530  * 	Release (free) perf_event security info.
1532  * 	Read perf_event security info if allowed.
1534  * 	Write perf_event security info if allowed.
1549  * Security module hook list structure.
1560  * Security blob size or offset data.
1624  * Assuring the safety of deleting a security module is up to
1625  * the security module involved. This may entail ordering the