Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Linux Security Module interfaces |
| 3 | * |
| 4 | * Copyright (C) 2001 WireX Communications, Inc <chris@wirex.com> |
| 5 | * Copyright (C) 2001 Greg Kroah-Hartman <greg@kroah.com> |
| 6 | * Copyright (C) 2001 Networks Associates Technology, Inc <ssmalley@nai.com> |
| 7 | * Copyright (C) 2001 James Morris <jmorris@intercode.com.au> |
| 8 | * Copyright (C) 2001 Silicon Graphics, Inc. (Trust Technology Group) |
| 9 | * Copyright (C) 2015 Intel Corporation. |
| 10 | * Copyright (C) 2015 Casey Schaufler <casey@schaufler-ca.com> |
| 11 | * |
| 12 | * This program is free software; you can redistribute it and/or modify |
| 13 | * it under the terms of the GNU General Public License as published by |
| 14 | * the Free Software Foundation; either version 2 of the License, or |
| 15 | * (at your option) any later version. |
| 16 | * |
| 17 | * Due to this file being licensed under the GPL there is controversy over |
| 18 | * whether this permits you to write a module that #includes this file |
| 19 | * without placing your module under the GPL. Please consult a lawyer for |
| 20 | * advice before doing this. |
| 21 | * |
| 22 | */ |
| 23 | |
| 24 | #ifndef __LINUX_LSM_HOOKS_H |
| 25 | #define __LINUX_LSM_HOOKS_H |
| 26 | |
| 27 | #include <linux/security.h> |
Casey Schaufler | b1d9e6b | 2015-05-02 15:11:42 -0700 | [diff] [blame] | 28 | #include <linux/init.h> |
| 29 | #include <linux/rculist.h> |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 30 | |
Casey Schaufler | fe7bb27 | 2015-05-02 15:10:53 -0700 | [diff] [blame] | 31 | /** |
Casey Schaufler | fe7bb27 | 2015-05-02 15:10:53 -0700 | [diff] [blame] | 32 | * Security hooks for program execution operations. |
| 33 | * |
| 34 | * @bprm_set_creds: |
| 35 | * Save security information in the bprm->security field, typically based |
| 36 | * on information about the bprm->file, for later use by the apply_creds |
| 37 | * hook. This hook may also optionally check permissions (e.g. for |
| 38 | * transitions between security domains). |
| 39 | * This hook may be called multiple times during a single execve, e.g. for |
| 40 | * interpreters. The hook can tell whether it has already been called by |
| 41 | * checking to see if @bprm->security is non-NULL. If so, then the hook |
| 42 | * may decide either to retain the security information saved earlier or |
| 43 | * to replace it. |
| 44 | * @bprm contains the linux_binprm structure. |
| 45 | * Return 0 if the hook is successful and permission is granted. |
| 46 | * @bprm_check_security: |
| 47 | * This hook mediates the point when a search for a binary handler will |
| 48 | * begin. It allows a check the @bprm->security value which is set in the |
| 49 | * preceding set_creds call. The primary difference from set_creds is |
| 50 | * that the argv list and envp list are reliably available in @bprm. This |
| 51 | * hook may be called multiple times during a single execve; and in each |
| 52 | * pass set_creds is called first. |
| 53 | * @bprm contains the linux_binprm structure. |
| 54 | * Return 0 if the hook is successful and permission is granted. |
| 55 | * @bprm_committing_creds: |
| 56 | * Prepare to install the new security attributes of a process being |
| 57 | * transformed by an execve operation, based on the old credentials |
| 58 | * pointed to by @current->cred and the information set in @bprm->cred by |
| 59 | * the bprm_set_creds hook. @bprm points to the linux_binprm structure. |
| 60 | * This hook is a good place to perform state changes on the process such |
| 61 | * as closing open file descriptors to which access will no longer be |
| 62 | * granted when the attributes are changed. This is called immediately |
| 63 | * before commit_creds(). |
| 64 | * @bprm_committed_creds: |
| 65 | * Tidy up after the installation of the new security attributes of a |
| 66 | * process being transformed by an execve operation. The new credentials |
| 67 | * have, by this point, been set to @current->cred. @bprm points to the |
| 68 | * linux_binprm structure. This hook is a good place to perform state |
| 69 | * changes on the process such as clearing out non-inheritable signal |
| 70 | * state. This is called immediately after commit_creds(). |
| 71 | * @bprm_secureexec: |
| 72 | * Return a boolean value (0 or 1) indicating whether a "secure exec" |
| 73 | * is required. The flag is passed in the auxiliary table |
| 74 | * on the initial stack to the ELF interpreter to indicate whether libc |
| 75 | * should enable secure mode. |
| 76 | * @bprm contains the linux_binprm structure. |
| 77 | * |
| 78 | * Security hooks for filesystem operations. |
| 79 | * |
| 80 | * @sb_alloc_security: |
| 81 | * Allocate and attach a security structure to the sb->s_security field. |
| 82 | * The s_security field is initialized to NULL when the structure is |
| 83 | * allocated. |
| 84 | * @sb contains the super_block structure to be modified. |
| 85 | * Return 0 if operation was successful. |
| 86 | * @sb_free_security: |
| 87 | * Deallocate and clear the sb->s_security field. |
| 88 | * @sb contains the super_block structure to be modified. |
| 89 | * @sb_statfs: |
| 90 | * Check permission before obtaining filesystem statistics for the @mnt |
| 91 | * mountpoint. |
| 92 | * @dentry is a handle on the superblock for the filesystem. |
| 93 | * Return 0 if permission is granted. |
| 94 | * @sb_mount: |
| 95 | * Check permission before an object specified by @dev_name is mounted on |
| 96 | * the mount point named by @nd. For an ordinary mount, @dev_name |
| 97 | * identifies a device if the file system type requires a device. For a |
| 98 | * remount (@flags & MS_REMOUNT), @dev_name is irrelevant. For a |
| 99 | * loopback/bind mount (@flags & MS_BIND), @dev_name identifies the |
| 100 | * pathname of the object being mounted. |
| 101 | * @dev_name contains the name for object being mounted. |
| 102 | * @path contains the path for mount point object. |
| 103 | * @type contains the filesystem type. |
| 104 | * @flags contains the mount flags. |
| 105 | * @data contains the filesystem-specific data. |
| 106 | * Return 0 if permission is granted. |
| 107 | * @sb_copy_data: |
| 108 | * Allow mount option data to be copied prior to parsing by the filesystem, |
| 109 | * so that the security module can extract security-specific mount |
| 110 | * options cleanly (a filesystem may modify the data e.g. with strsep()). |
| 111 | * This also allows the original mount data to be stripped of security- |
| 112 | * specific options to avoid having to make filesystems aware of them. |
| 113 | * @type the type of filesystem being mounted. |
| 114 | * @orig the original mount data copied from userspace. |
| 115 | * @copy copied data which will be passed to the security module. |
| 116 | * Returns 0 if the copy was successful. |
| 117 | * @sb_remount: |
| 118 | * Extracts security system specific mount options and verifies no changes |
| 119 | * are being made to those options. |
| 120 | * @sb superblock being remounted |
| 121 | * @data contains the filesystem-specific data. |
| 122 | * Return 0 if permission is granted. |
| 123 | * @sb_umount: |
| 124 | * Check permission before the @mnt file system is unmounted. |
| 125 | * @mnt contains the mounted file system. |
| 126 | * @flags contains the unmount flags, e.g. MNT_FORCE. |
| 127 | * Return 0 if permission is granted. |
| 128 | * @sb_pivotroot: |
| 129 | * Check permission before pivoting the root filesystem. |
| 130 | * @old_path contains the path for the new location of the |
| 131 | * current root (put_old). |
| 132 | * @new_path contains the path for the new root (new_root). |
| 133 | * Return 0 if permission is granted. |
| 134 | * @sb_set_mnt_opts: |
| 135 | * Set the security relevant mount options used for a superblock |
| 136 | * @sb the superblock to set security mount options for |
| 137 | * @opts binary data structure containing all lsm mount data |
| 138 | * @sb_clone_mnt_opts: |
| 139 | * Copy all security options from a given superblock to another |
| 140 | * @oldsb old superblock which contain information to clone |
| 141 | * @newsb new superblock which needs filled in |
| 142 | * @sb_parse_opts_str: |
| 143 | * Parse a string of security data filling in the opts structure |
| 144 | * @options string containing all mount options known by the LSM |
| 145 | * @opts binary data structure usable by the LSM |
| 146 | * @dentry_init_security: |
| 147 | * Compute a context for a dentry as the inode is not yet available |
| 148 | * since NFSv4 has no label backed by an EA anyway. |
| 149 | * @dentry dentry to use in calculating the context. |
| 150 | * @mode mode used to determine resource type. |
| 151 | * @name name of the last path component used to create file |
| 152 | * @ctx pointer to place the pointer to the resulting context in. |
| 153 | * @ctxlen point to place the length of the resulting context. |
| 154 | * |
| 155 | * |
| 156 | * Security hooks for inode operations. |
| 157 | * |
| 158 | * @inode_alloc_security: |
| 159 | * Allocate and attach a security structure to @inode->i_security. The |
| 160 | * i_security field is initialized to NULL when the inode structure is |
| 161 | * allocated. |
| 162 | * @inode contains the inode structure. |
| 163 | * Return 0 if operation was successful. |
| 164 | * @inode_free_security: |
| 165 | * @inode contains the inode structure. |
| 166 | * Deallocate the inode security structure and set @inode->i_security to |
| 167 | * NULL. |
| 168 | * @inode_init_security: |
| 169 | * Obtain the security attribute name suffix and value to set on a newly |
| 170 | * created inode and set up the incore security field for the new inode. |
| 171 | * This hook is called by the fs code as part of the inode creation |
| 172 | * transaction and provides for atomic labeling of the inode, unlike |
| 173 | * the post_create/mkdir/... hooks called by the VFS. The hook function |
| 174 | * is expected to allocate the name and value via kmalloc, with the caller |
| 175 | * being responsible for calling kfree after using them. |
| 176 | * If the security module does not use security attributes or does |
| 177 | * not wish to put a security attribute on this particular inode, |
| 178 | * then it should return -EOPNOTSUPP to skip this processing. |
| 179 | * @inode contains the inode structure of the newly created inode. |
| 180 | * @dir contains the inode structure of the parent directory. |
| 181 | * @qstr contains the last path component of the new object |
| 182 | * @name will be set to the allocated name suffix (e.g. selinux). |
| 183 | * @value will be set to the allocated attribute value. |
| 184 | * @len will be set to the length of the value. |
| 185 | * Returns 0 if @name and @value have been successfully set, |
| 186 | * -EOPNOTSUPP if no security attribute is needed, or |
| 187 | * -ENOMEM on memory allocation failure. |
| 188 | * @inode_create: |
| 189 | * Check permission to create a regular file. |
| 190 | * @dir contains inode structure of the parent of the new file. |
| 191 | * @dentry contains the dentry structure for the file to be created. |
| 192 | * @mode contains the file mode of the file to be created. |
| 193 | * Return 0 if permission is granted. |
| 194 | * @inode_link: |
| 195 | * Check permission before creating a new hard link to a file. |
| 196 | * @old_dentry contains the dentry structure for an existing |
| 197 | * link to the file. |
| 198 | * @dir contains the inode structure of the parent directory |
| 199 | * of the new link. |
| 200 | * @new_dentry contains the dentry structure for the new link. |
| 201 | * Return 0 if permission is granted. |
| 202 | * @path_link: |
| 203 | * Check permission before creating a new hard link to a file. |
| 204 | * @old_dentry contains the dentry structure for an existing link |
| 205 | * to the file. |
| 206 | * @new_dir contains the path structure of the parent directory of |
| 207 | * the new link. |
| 208 | * @new_dentry contains the dentry structure for the new link. |
| 209 | * Return 0 if permission is granted. |
| 210 | * @inode_unlink: |
| 211 | * Check the permission to remove a hard link to a file. |
| 212 | * @dir contains the inode structure of parent directory of the file. |
| 213 | * @dentry contains the dentry structure for file to be unlinked. |
| 214 | * Return 0 if permission is granted. |
| 215 | * @path_unlink: |
| 216 | * Check the permission to remove a hard link to a file. |
| 217 | * @dir contains the path structure of parent directory of the file. |
| 218 | * @dentry contains the dentry structure for file to be unlinked. |
| 219 | * Return 0 if permission is granted. |
| 220 | * @inode_symlink: |
| 221 | * Check the permission to create a symbolic link to a file. |
| 222 | * @dir contains the inode structure of parent directory of |
| 223 | * the symbolic link. |
| 224 | * @dentry contains the dentry structure of the symbolic link. |
| 225 | * @old_name contains the pathname of file. |
| 226 | * Return 0 if permission is granted. |
| 227 | * @path_symlink: |
| 228 | * Check the permission to create a symbolic link to a file. |
| 229 | * @dir contains the path structure of parent directory of |
| 230 | * the symbolic link. |
| 231 | * @dentry contains the dentry structure of the symbolic link. |
| 232 | * @old_name contains the pathname of file. |
| 233 | * Return 0 if permission is granted. |
| 234 | * @inode_mkdir: |
| 235 | * Check permissions to create a new directory in the existing directory |
| 236 | * associated with inode structure @dir. |
| 237 | * @dir contains the inode structure of parent of the directory |
| 238 | * to be created. |
| 239 | * @dentry contains the dentry structure of new directory. |
| 240 | * @mode contains the mode of new directory. |
| 241 | * Return 0 if permission is granted. |
| 242 | * @path_mkdir: |
| 243 | * Check permissions to create a new directory in the existing directory |
| 244 | * associated with path structure @path. |
| 245 | * @dir contains the path structure of parent of the directory |
| 246 | * to be created. |
| 247 | * @dentry contains the dentry structure of new directory. |
| 248 | * @mode contains the mode of new directory. |
| 249 | * Return 0 if permission is granted. |
| 250 | * @inode_rmdir: |
| 251 | * Check the permission to remove a directory. |
| 252 | * @dir contains the inode structure of parent of the directory |
| 253 | * to be removed. |
| 254 | * @dentry contains the dentry structure of directory to be removed. |
| 255 | * Return 0 if permission is granted. |
| 256 | * @path_rmdir: |
| 257 | * Check the permission to remove a directory. |
| 258 | * @dir contains the path structure of parent of the directory to be |
| 259 | * removed. |
| 260 | * @dentry contains the dentry structure of directory to be removed. |
| 261 | * Return 0 if permission is granted. |
| 262 | * @inode_mknod: |
| 263 | * Check permissions when creating a special file (or a socket or a fifo |
| 264 | * file created via the mknod system call). Note that if mknod operation |
| 265 | * is being done for a regular file, then the create hook will be called |
| 266 | * and not this hook. |
| 267 | * @dir contains the inode structure of parent of the new file. |
| 268 | * @dentry contains the dentry structure of the new file. |
| 269 | * @mode contains the mode of the new file. |
| 270 | * @dev contains the device number. |
| 271 | * Return 0 if permission is granted. |
| 272 | * @path_mknod: |
| 273 | * Check permissions when creating a file. Note that this hook is called |
| 274 | * even if mknod operation is being done for a regular file. |
| 275 | * @dir contains the path structure of parent of the new file. |
| 276 | * @dentry contains the dentry structure of the new file. |
| 277 | * @mode contains the mode of the new file. |
| 278 | * @dev contains the undecoded device number. Use new_decode_dev() to get |
| 279 | * the decoded device number. |
| 280 | * Return 0 if permission is granted. |
| 281 | * @inode_rename: |
| 282 | * Check for permission to rename a file or directory. |
| 283 | * @old_dir contains the inode structure for parent of the old link. |
| 284 | * @old_dentry contains the dentry structure of the old link. |
| 285 | * @new_dir contains the inode structure for parent of the new link. |
| 286 | * @new_dentry contains the dentry structure of the new link. |
| 287 | * Return 0 if permission is granted. |
| 288 | * @path_rename: |
| 289 | * Check for permission to rename a file or directory. |
| 290 | * @old_dir contains the path structure for parent of the old link. |
| 291 | * @old_dentry contains the dentry structure of the old link. |
| 292 | * @new_dir contains the path structure for parent of the new link. |
| 293 | * @new_dentry contains the dentry structure of the new link. |
| 294 | * Return 0 if permission is granted. |
| 295 | * @path_chmod: |
| 296 | * Check for permission to change DAC's permission of a file or directory. |
| 297 | * @dentry contains the dentry structure. |
| 298 | * @mnt contains the vfsmnt structure. |
| 299 | * @mode contains DAC's mode. |
| 300 | * Return 0 if permission is granted. |
| 301 | * @path_chown: |
| 302 | * Check for permission to change owner/group of a file or directory. |
| 303 | * @path contains the path structure. |
| 304 | * @uid contains new owner's ID. |
| 305 | * @gid contains new group's ID. |
| 306 | * Return 0 if permission is granted. |
| 307 | * @path_chroot: |
| 308 | * Check for permission to change root directory. |
| 309 | * @path contains the path structure. |
| 310 | * Return 0 if permission is granted. |
| 311 | * @inode_readlink: |
| 312 | * Check the permission to read the symbolic link. |
| 313 | * @dentry contains the dentry structure for the file link. |
| 314 | * Return 0 if permission is granted. |
| 315 | * @inode_follow_link: |
| 316 | * Check permission to follow a symbolic link when looking up a pathname. |
| 317 | * @dentry contains the dentry structure for the link. |
Linus Torvalds | e22619a | 2015-06-27 13:26:03 -0700 | [diff] [blame] | 318 | * @inode contains the inode, which itself is not stable in RCU-walk |
| 319 | * @rcu indicates whether we are in RCU-walk mode. |
Casey Schaufler | fe7bb27 | 2015-05-02 15:10:53 -0700 | [diff] [blame] | 320 | * Return 0 if permission is granted. |
| 321 | * @inode_permission: |
| 322 | * Check permission before accessing an inode. This hook is called by the |
| 323 | * existing Linux permission function, so a security module can use it to |
| 324 | * provide additional checking for existing Linux permission checks. |
| 325 | * Notice that this hook is called when a file is opened (as well as many |
| 326 | * other operations), whereas the file_security_ops permission hook is |
| 327 | * called when the actual read/write operations are performed. |
| 328 | * @inode contains the inode structure to check. |
| 329 | * @mask contains the permission mask. |
| 330 | * Return 0 if permission is granted. |
| 331 | * @inode_setattr: |
| 332 | * Check permission before setting file attributes. Note that the kernel |
| 333 | * call to notify_change is performed from several locations, whenever |
| 334 | * file attributes change (such as when a file is truncated, chown/chmod |
| 335 | * operations, transferring disk quotas, etc). |
| 336 | * @dentry contains the dentry structure for the file. |
| 337 | * @attr is the iattr structure containing the new file attributes. |
| 338 | * Return 0 if permission is granted. |
| 339 | * @path_truncate: |
| 340 | * Check permission before truncating a file. |
| 341 | * @path contains the path structure for the file. |
| 342 | * Return 0 if permission is granted. |
| 343 | * @inode_getattr: |
| 344 | * Check permission before obtaining file attributes. |
| 345 | * @mnt is the vfsmount where the dentry was looked up |
| 346 | * @dentry contains the dentry structure for the file. |
| 347 | * Return 0 if permission is granted. |
| 348 | * @inode_setxattr: |
| 349 | * Check permission before setting the extended attributes |
| 350 | * @value identified by @name for @dentry. |
| 351 | * Return 0 if permission is granted. |
| 352 | * @inode_post_setxattr: |
| 353 | * Update inode security field after successful setxattr operation. |
| 354 | * @value identified by @name for @dentry. |
| 355 | * @inode_getxattr: |
| 356 | * Check permission before obtaining the extended attributes |
| 357 | * identified by @name for @dentry. |
| 358 | * Return 0 if permission is granted. |
| 359 | * @inode_listxattr: |
| 360 | * Check permission before obtaining the list of extended attribute |
| 361 | * names for @dentry. |
| 362 | * Return 0 if permission is granted. |
| 363 | * @inode_removexattr: |
| 364 | * Check permission before removing the extended attribute |
| 365 | * identified by @name for @dentry. |
| 366 | * Return 0 if permission is granted. |
| 367 | * @inode_getsecurity: |
| 368 | * Retrieve a copy of the extended attribute representation of the |
| 369 | * security label associated with @name for @inode via @buffer. Note that |
| 370 | * @name is the remainder of the attribute name after the security prefix |
| 371 | * has been removed. @alloc is used to specify of the call should return a |
| 372 | * value via the buffer or just the value length Return size of buffer on |
| 373 | * success. |
| 374 | * @inode_setsecurity: |
| 375 | * Set the security label associated with @name for @inode from the |
| 376 | * extended attribute value @value. @size indicates the size of the |
| 377 | * @value in bytes. @flags may be XATTR_CREATE, XATTR_REPLACE, or 0. |
| 378 | * Note that @name is the remainder of the attribute name after the |
| 379 | * security. prefix has been removed. |
| 380 | * Return 0 on success. |
| 381 | * @inode_listsecurity: |
| 382 | * Copy the extended attribute names for the security labels |
| 383 | * associated with @inode into @buffer. The maximum size of @buffer |
| 384 | * is specified by @buffer_size. @buffer may be NULL to request |
| 385 | * the size of the buffer required. |
| 386 | * Returns number of bytes used/required on success. |
| 387 | * @inode_need_killpriv: |
| 388 | * Called when an inode has been changed. |
| 389 | * @dentry is the dentry being changed. |
| 390 | * Return <0 on error to abort the inode change operation. |
| 391 | * Return 0 if inode_killpriv does not need to be called. |
| 392 | * Return >0 if inode_killpriv does need to be called. |
| 393 | * @inode_killpriv: |
| 394 | * The setuid bit is being removed. Remove similar security labels. |
| 395 | * Called with the dentry->d_inode->i_mutex held. |
| 396 | * @dentry is the dentry being changed. |
| 397 | * Return 0 on success. If error is returned, then the operation |
| 398 | * causing setuid bit removal is failed. |
| 399 | * @inode_getsecid: |
| 400 | * Get the secid associated with the node. |
| 401 | * @inode contains a pointer to the inode. |
| 402 | * @secid contains a pointer to the location where result will be saved. |
| 403 | * In case of failure, @secid will be set to zero. |
| 404 | * |
| 405 | * Security hooks for file operations |
| 406 | * |
| 407 | * @file_permission: |
| 408 | * Check file permissions before accessing an open file. This hook is |
| 409 | * called by various operations that read or write files. A security |
| 410 | * module can use this hook to perform additional checking on these |
| 411 | * operations, e.g. to revalidate permissions on use to support privilege |
| 412 | * bracketing or policy changes. Notice that this hook is used when the |
| 413 | * actual read/write operations are performed, whereas the |
| 414 | * inode_security_ops hook is called when a file is opened (as well as |
| 415 | * many other operations). |
| 416 | * Caveat: Although this hook can be used to revalidate permissions for |
| 417 | * various system call operations that read or write files, it does not |
| 418 | * address the revalidation of permissions for memory-mapped files. |
| 419 | * Security modules must handle this separately if they need such |
| 420 | * revalidation. |
| 421 | * @file contains the file structure being accessed. |
| 422 | * @mask contains the requested permissions. |
| 423 | * Return 0 if permission is granted. |
| 424 | * @file_alloc_security: |
| 425 | * Allocate and attach a security structure to the file->f_security field. |
| 426 | * The security field is initialized to NULL when the structure is first |
| 427 | * created. |
| 428 | * @file contains the file structure to secure. |
| 429 | * Return 0 if the hook is successful and permission is granted. |
| 430 | * @file_free_security: |
| 431 | * Deallocate and free any security structures stored in file->f_security. |
| 432 | * @file contains the file structure being modified. |
| 433 | * @file_ioctl: |
| 434 | * @file contains the file structure. |
| 435 | * @cmd contains the operation to perform. |
| 436 | * @arg contains the operational arguments. |
| 437 | * Check permission for an ioctl operation on @file. Note that @arg |
| 438 | * sometimes represents a user space pointer; in other cases, it may be a |
| 439 | * simple integer value. When @arg represents a user space pointer, it |
| 440 | * should never be used by the security module. |
| 441 | * Return 0 if permission is granted. |
| 442 | * @mmap_addr : |
| 443 | * Check permissions for a mmap operation at @addr. |
| 444 | * @addr contains virtual address that will be used for the operation. |
| 445 | * Return 0 if permission is granted. |
| 446 | * @mmap_file : |
| 447 | * Check permissions for a mmap operation. The @file may be NULL, e.g. |
| 448 | * if mapping anonymous memory. |
| 449 | * @file contains the file structure for file to map (may be NULL). |
| 450 | * @reqprot contains the protection requested by the application. |
| 451 | * @prot contains the protection that will be applied by the kernel. |
| 452 | * @flags contains the operational flags. |
| 453 | * Return 0 if permission is granted. |
| 454 | * @file_mprotect: |
| 455 | * Check permissions before changing memory access permissions. |
| 456 | * @vma contains the memory region to modify. |
| 457 | * @reqprot contains the protection requested by the application. |
| 458 | * @prot contains the protection that will be applied by the kernel. |
| 459 | * Return 0 if permission is granted. |
| 460 | * @file_lock: |
| 461 | * Check permission before performing file locking operations. |
| 462 | * Note: this hook mediates both flock and fcntl style locks. |
| 463 | * @file contains the file structure. |
| 464 | * @cmd contains the posix-translated lock operation to perform |
| 465 | * (e.g. F_RDLCK, F_WRLCK). |
| 466 | * Return 0 if permission is granted. |
| 467 | * @file_fcntl: |
| 468 | * Check permission before allowing the file operation specified by @cmd |
| 469 | * from being performed on the file @file. Note that @arg sometimes |
| 470 | * represents a user space pointer; in other cases, it may be a simple |
| 471 | * integer value. When @arg represents a user space pointer, it should |
| 472 | * never be used by the security module. |
| 473 | * @file contains the file structure. |
| 474 | * @cmd contains the operation to be performed. |
| 475 | * @arg contains the operational arguments. |
| 476 | * Return 0 if permission is granted. |
| 477 | * @file_set_fowner: |
| 478 | * Save owner security information (typically from current->security) in |
| 479 | * file->f_security for later use by the send_sigiotask hook. |
| 480 | * @file contains the file structure to update. |
| 481 | * Return 0 on success. |
| 482 | * @file_send_sigiotask: |
| 483 | * Check permission for the file owner @fown to send SIGIO or SIGURG to the |
| 484 | * process @tsk. Note that this hook is sometimes called from interrupt. |
| 485 | * Note that the fown_struct, @fown, is never outside the context of a |
| 486 | * struct file, so the file structure (and associated security information) |
| 487 | * can always be obtained: |
| 488 | * container_of(fown, struct file, f_owner) |
| 489 | * @tsk contains the structure of task receiving signal. |
| 490 | * @fown contains the file owner information. |
| 491 | * @sig is the signal that will be sent. When 0, kernel sends SIGIO. |
| 492 | * Return 0 if permission is granted. |
| 493 | * @file_receive: |
| 494 | * This hook allows security modules to control the ability of a process |
| 495 | * to receive an open file descriptor via socket IPC. |
| 496 | * @file contains the file structure being received. |
| 497 | * Return 0 if permission is granted. |
| 498 | * @file_open |
| 499 | * Save open-time permission checking state for later use upon |
| 500 | * file_permission, and recheck access if anything has changed |
| 501 | * since inode_permission. |
| 502 | * |
| 503 | * Security hooks for task operations. |
| 504 | * |
| 505 | * @task_create: |
| 506 | * Check permission before creating a child process. See the clone(2) |
| 507 | * manual page for definitions of the @clone_flags. |
| 508 | * @clone_flags contains the flags indicating what should be shared. |
| 509 | * Return 0 if permission is granted. |
| 510 | * @task_free: |
| 511 | * @task task being freed |
| 512 | * Handle release of task-related resources. (Note that this can be called |
| 513 | * from interrupt context.) |
| 514 | * @cred_alloc_blank: |
| 515 | * @cred points to the credentials. |
| 516 | * @gfp indicates the atomicity of any memory allocations. |
| 517 | * Only allocate sufficient memory and attach to @cred such that |
| 518 | * cred_transfer() will not get ENOMEM. |
| 519 | * @cred_free: |
| 520 | * @cred points to the credentials. |
| 521 | * Deallocate and clear the cred->security field in a set of credentials. |
| 522 | * @cred_prepare: |
| 523 | * @new points to the new credentials. |
| 524 | * @old points to the original credentials. |
| 525 | * @gfp indicates the atomicity of any memory allocations. |
| 526 | * Prepare a new set of credentials by copying the data from the old set. |
| 527 | * @cred_transfer: |
| 528 | * @new points to the new credentials. |
| 529 | * @old points to the original credentials. |
| 530 | * Transfer data from original creds to new creds |
| 531 | * @kernel_act_as: |
| 532 | * Set the credentials for a kernel service to act as (subjective context). |
| 533 | * @new points to the credentials to be modified. |
| 534 | * @secid specifies the security ID to be set |
| 535 | * The current task must be the one that nominated @secid. |
| 536 | * Return 0 if successful. |
| 537 | * @kernel_create_files_as: |
| 538 | * Set the file creation context in a set of credentials to be the same as |
| 539 | * the objective context of the specified inode. |
| 540 | * @new points to the credentials to be modified. |
| 541 | * @inode points to the inode to use as a reference. |
| 542 | * The current task must be the one that nominated @inode. |
| 543 | * Return 0 if successful. |
Casey Schaufler | fe7bb27 | 2015-05-02 15:10:53 -0700 | [diff] [blame] | 544 | * @kernel_module_request: |
| 545 | * Ability to trigger the kernel to automatically upcall to userspace for |
| 546 | * userspace to load a kernel module with the given name. |
| 547 | * @kmod_name name of the module requested by the kernel |
| 548 | * Return 0 if successful. |
Mimi Zohar | 39eeb4f | 2016-01-30 22:23:26 -0500 | [diff] [blame] | 549 | * @kernel_read_file: |
| 550 | * Read a file specified by userspace. |
| 551 | * @file contains the file structure pointing to the file being read |
| 552 | * by the kernel. |
| 553 | * @id kernel read file identifier |
| 554 | * Return 0 if permission is granted. |
Mimi Zohar | b44a7df | 2015-12-28 16:02:29 -0500 | [diff] [blame] | 555 | * @kernel_post_read_file: |
| 556 | * Read a file specified by userspace. |
| 557 | * @file contains the file structure pointing to the file being read |
| 558 | * by the kernel. |
| 559 | * @buf pointer to buffer containing the file contents. |
| 560 | * @size length of the file contents. |
Mimi Zohar | bc8ca5b | 2016-01-24 10:07:32 -0500 | [diff] [blame] | 561 | * @id kernel read file identifier |
Mimi Zohar | b44a7df | 2015-12-28 16:02:29 -0500 | [diff] [blame] | 562 | * Return 0 if permission is granted. |
Casey Schaufler | fe7bb27 | 2015-05-02 15:10:53 -0700 | [diff] [blame] | 563 | * @task_fix_setuid: |
| 564 | * Update the module's state after setting one or more of the user |
| 565 | * identity attributes of the current process. The @flags parameter |
| 566 | * indicates which of the set*uid system calls invoked this hook. If |
| 567 | * @new is the set of credentials that will be installed. Modifications |
| 568 | * should be made to this rather than to @current->cred. |
| 569 | * @old is the set of credentials that are being replaces |
| 570 | * @flags contains one of the LSM_SETID_* values. |
| 571 | * Return 0 on success. |
| 572 | * @task_setpgid: |
| 573 | * Check permission before setting the process group identifier of the |
| 574 | * process @p to @pgid. |
| 575 | * @p contains the task_struct for process being modified. |
| 576 | * @pgid contains the new pgid. |
| 577 | * Return 0 if permission is granted. |
| 578 | * @task_getpgid: |
| 579 | * Check permission before getting the process group identifier of the |
| 580 | * process @p. |
| 581 | * @p contains the task_struct for the process. |
| 582 | * Return 0 if permission is granted. |
| 583 | * @task_getsid: |
| 584 | * Check permission before getting the session identifier of the process |
| 585 | * @p. |
| 586 | * @p contains the task_struct for the process. |
| 587 | * Return 0 if permission is granted. |
| 588 | * @task_getsecid: |
| 589 | * Retrieve the security identifier of the process @p. |
| 590 | * @p contains the task_struct for the process and place is into @secid. |
| 591 | * In case of failure, @secid will be set to zero. |
| 592 | * |
| 593 | * @task_setnice: |
| 594 | * Check permission before setting the nice value of @p to @nice. |
| 595 | * @p contains the task_struct of process. |
| 596 | * @nice contains the new nice value. |
| 597 | * Return 0 if permission is granted. |
| 598 | * @task_setioprio |
| 599 | * Check permission before setting the ioprio value of @p to @ioprio. |
| 600 | * @p contains the task_struct of process. |
| 601 | * @ioprio contains the new ioprio value |
| 602 | * Return 0 if permission is granted. |
| 603 | * @task_getioprio |
| 604 | * Check permission before getting the ioprio value of @p. |
| 605 | * @p contains the task_struct of process. |
| 606 | * Return 0 if permission is granted. |
| 607 | * @task_setrlimit: |
| 608 | * Check permission before setting the resource limits of the current |
| 609 | * process for @resource to @new_rlim. The old resource limit values can |
| 610 | * be examined by dereferencing (current->signal->rlim + resource). |
| 611 | * @resource contains the resource whose limit is being set. |
| 612 | * @new_rlim contains the new limits for @resource. |
| 613 | * Return 0 if permission is granted. |
| 614 | * @task_setscheduler: |
| 615 | * Check permission before setting scheduling policy and/or parameters of |
| 616 | * process @p based on @policy and @lp. |
| 617 | * @p contains the task_struct for process. |
| 618 | * @policy contains the scheduling policy. |
| 619 | * @lp contains the scheduling parameters. |
| 620 | * Return 0 if permission is granted. |
| 621 | * @task_getscheduler: |
| 622 | * Check permission before obtaining scheduling information for process |
| 623 | * @p. |
| 624 | * @p contains the task_struct for process. |
| 625 | * Return 0 if permission is granted. |
| 626 | * @task_movememory |
| 627 | * Check permission before moving memory owned by process @p. |
| 628 | * @p contains the task_struct for process. |
| 629 | * Return 0 if permission is granted. |
| 630 | * @task_kill: |
| 631 | * Check permission before sending signal @sig to @p. @info can be NULL, |
| 632 | * the constant 1, or a pointer to a siginfo structure. If @info is 1 or |
| 633 | * SI_FROMKERNEL(info) is true, then the signal should be viewed as coming |
| 634 | * from the kernel and should typically be permitted. |
| 635 | * SIGIO signals are handled separately by the send_sigiotask hook in |
| 636 | * file_security_ops. |
| 637 | * @p contains the task_struct for process. |
| 638 | * @info contains the signal information. |
| 639 | * @sig contains the signal value. |
| 640 | * @secid contains the sid of the process where the signal originated |
| 641 | * Return 0 if permission is granted. |
| 642 | * @task_wait: |
| 643 | * Check permission before allowing a process to reap a child process @p |
| 644 | * and collect its status information. |
| 645 | * @p contains the task_struct for process. |
| 646 | * Return 0 if permission is granted. |
| 647 | * @task_prctl: |
| 648 | * Check permission before performing a process control operation on the |
| 649 | * current process. |
| 650 | * @option contains the operation. |
| 651 | * @arg2 contains a argument. |
| 652 | * @arg3 contains a argument. |
| 653 | * @arg4 contains a argument. |
| 654 | * @arg5 contains a argument. |
| 655 | * Return -ENOSYS if no-one wanted to handle this op, any other value to |
| 656 | * cause prctl() to return immediately with that value. |
| 657 | * @task_to_inode: |
| 658 | * Set the security attributes for an inode based on an associated task's |
| 659 | * security attributes, e.g. for /proc/pid inodes. |
| 660 | * @p contains the task_struct for the task. |
| 661 | * @inode contains the inode structure for the inode. |
| 662 | * |
| 663 | * Security hooks for Netlink messaging. |
| 664 | * |
| 665 | * @netlink_send: |
| 666 | * Save security information for a netlink message so that permission |
| 667 | * checking can be performed when the message is processed. The security |
| 668 | * information can be saved using the eff_cap field of the |
| 669 | * netlink_skb_parms structure. Also may be used to provide fine |
| 670 | * grained control over message transmission. |
| 671 | * @sk associated sock of task sending the message. |
| 672 | * @skb contains the sk_buff structure for the netlink message. |
| 673 | * Return 0 if the information was successfully saved and message |
| 674 | * is allowed to be transmitted. |
| 675 | * |
| 676 | * Security hooks for Unix domain networking. |
| 677 | * |
| 678 | * @unix_stream_connect: |
| 679 | * Check permissions before establishing a Unix domain stream connection |
| 680 | * between @sock and @other. |
| 681 | * @sock contains the sock structure. |
| 682 | * @other contains the peer sock structure. |
| 683 | * @newsk contains the new sock structure. |
| 684 | * Return 0 if permission is granted. |
| 685 | * @unix_may_send: |
| 686 | * Check permissions before connecting or sending datagrams from @sock to |
| 687 | * @other. |
| 688 | * @sock contains the socket structure. |
| 689 | * @other contains the peer socket structure. |
| 690 | * Return 0 if permission is granted. |
| 691 | * |
| 692 | * The @unix_stream_connect and @unix_may_send hooks were necessary because |
| 693 | * Linux provides an alternative to the conventional file name space for Unix |
| 694 | * domain sockets. Whereas binding and connecting to sockets in the file name |
| 695 | * space is mediated by the typical file permissions (and caught by the mknod |
| 696 | * and permission hooks in inode_security_ops), binding and connecting to |
| 697 | * sockets in the abstract name space is completely unmediated. Sufficient |
| 698 | * control of Unix domain sockets in the abstract name space isn't possible |
| 699 | * using only the socket layer hooks, since we need to know the actual target |
| 700 | * socket, which is not looked up until we are inside the af_unix code. |
| 701 | * |
| 702 | * Security hooks for socket operations. |
| 703 | * |
| 704 | * @socket_create: |
| 705 | * Check permissions prior to creating a new socket. |
| 706 | * @family contains the requested protocol family. |
| 707 | * @type contains the requested communications type. |
| 708 | * @protocol contains the requested protocol. |
| 709 | * @kern set to 1 if a kernel socket. |
| 710 | * Return 0 if permission is granted. |
| 711 | * @socket_post_create: |
| 712 | * This hook allows a module to update or allocate a per-socket security |
| 713 | * structure. Note that the security field was not added directly to the |
| 714 | * socket structure, but rather, the socket security information is stored |
| 715 | * in the associated inode. Typically, the inode alloc_security hook will |
| 716 | * allocate and and attach security information to |
| 717 | * sock->inode->i_security. This hook may be used to update the |
| 718 | * sock->inode->i_security field with additional information that wasn't |
| 719 | * available when the inode was allocated. |
| 720 | * @sock contains the newly created socket structure. |
| 721 | * @family contains the requested protocol family. |
| 722 | * @type contains the requested communications type. |
| 723 | * @protocol contains the requested protocol. |
| 724 | * @kern set to 1 if a kernel socket. |
| 725 | * @socket_bind: |
| 726 | * Check permission before socket protocol layer bind operation is |
| 727 | * performed and the socket @sock is bound to the address specified in the |
| 728 | * @address parameter. |
| 729 | * @sock contains the socket structure. |
| 730 | * @address contains the address to bind to. |
| 731 | * @addrlen contains the length of address. |
| 732 | * Return 0 if permission is granted. |
| 733 | * @socket_connect: |
| 734 | * Check permission before socket protocol layer connect operation |
| 735 | * attempts to connect socket @sock to a remote address, @address. |
| 736 | * @sock contains the socket structure. |
| 737 | * @address contains the address of remote endpoint. |
| 738 | * @addrlen contains the length of address. |
| 739 | * Return 0 if permission is granted. |
| 740 | * @socket_listen: |
| 741 | * Check permission before socket protocol layer listen operation. |
| 742 | * @sock contains the socket structure. |
| 743 | * @backlog contains the maximum length for the pending connection queue. |
| 744 | * Return 0 if permission is granted. |
| 745 | * @socket_accept: |
| 746 | * Check permission before accepting a new connection. Note that the new |
| 747 | * socket, @newsock, has been created and some information copied to it, |
| 748 | * but the accept operation has not actually been performed. |
| 749 | * @sock contains the listening socket structure. |
| 750 | * @newsock contains the newly created server socket for connection. |
| 751 | * Return 0 if permission is granted. |
| 752 | * @socket_sendmsg: |
| 753 | * Check permission before transmitting a message to another socket. |
| 754 | * @sock contains the socket structure. |
| 755 | * @msg contains the message to be transmitted. |
| 756 | * @size contains the size of message. |
| 757 | * Return 0 if permission is granted. |
| 758 | * @socket_recvmsg: |
| 759 | * Check permission before receiving a message from a socket. |
| 760 | * @sock contains the socket structure. |
| 761 | * @msg contains the message structure. |
| 762 | * @size contains the size of message structure. |
| 763 | * @flags contains the operational flags. |
| 764 | * Return 0 if permission is granted. |
| 765 | * @socket_getsockname: |
| 766 | * Check permission before the local address (name) of the socket object |
| 767 | * @sock is retrieved. |
| 768 | * @sock contains the socket structure. |
| 769 | * Return 0 if permission is granted. |
| 770 | * @socket_getpeername: |
| 771 | * Check permission before the remote address (name) of a socket object |
| 772 | * @sock is retrieved. |
| 773 | * @sock contains the socket structure. |
| 774 | * Return 0 if permission is granted. |
| 775 | * @socket_getsockopt: |
| 776 | * Check permissions before retrieving the options associated with socket |
| 777 | * @sock. |
| 778 | * @sock contains the socket structure. |
| 779 | * @level contains the protocol level to retrieve option from. |
| 780 | * @optname contains the name of option to retrieve. |
| 781 | * Return 0 if permission is granted. |
| 782 | * @socket_setsockopt: |
| 783 | * Check permissions before setting the options associated with socket |
| 784 | * @sock. |
| 785 | * @sock contains the socket structure. |
| 786 | * @level contains the protocol level to set options for. |
| 787 | * @optname contains the name of the option to set. |
| 788 | * Return 0 if permission is granted. |
| 789 | * @socket_shutdown: |
| 790 | * Checks permission before all or part of a connection on the socket |
| 791 | * @sock is shut down. |
| 792 | * @sock contains the socket structure. |
| 793 | * @how contains the flag indicating how future sends and receives |
| 794 | * are handled. |
| 795 | * Return 0 if permission is granted. |
| 796 | * @socket_sock_rcv_skb: |
| 797 | * Check permissions on incoming network packets. This hook is distinct |
| 798 | * from Netfilter's IP input hooks since it is the first time that the |
| 799 | * incoming sk_buff @skb has been associated with a particular socket, @sk. |
| 800 | * Must not sleep inside this hook because some callers hold spinlocks. |
| 801 | * @sk contains the sock (not socket) associated with the incoming sk_buff. |
| 802 | * @skb contains the incoming network data. |
| 803 | * @socket_getpeersec_stream: |
| 804 | * This hook allows the security module to provide peer socket security |
| 805 | * state for unix or connected tcp sockets to userspace via getsockopt |
| 806 | * SO_GETPEERSEC. For tcp sockets this can be meaningful if the |
| 807 | * socket is associated with an ipsec SA. |
| 808 | * @sock is the local socket. |
| 809 | * @optval userspace memory where the security state is to be copied. |
| 810 | * @optlen userspace int where the module should copy the actual length |
| 811 | * of the security state. |
| 812 | * @len as input is the maximum length to copy to userspace provided |
| 813 | * by the caller. |
| 814 | * Return 0 if all is well, otherwise, typical getsockopt return |
| 815 | * values. |
| 816 | * @socket_getpeersec_dgram: |
| 817 | * This hook allows the security module to provide peer socket security |
| 818 | * state for udp sockets on a per-packet basis to userspace via |
| 819 | * getsockopt SO_GETPEERSEC. The application must first have indicated |
| 820 | * the IP_PASSSEC option via getsockopt. It can then retrieve the |
| 821 | * security state returned by this hook for a packet via the SCM_SECURITY |
| 822 | * ancillary message type. |
| 823 | * @skb is the skbuff for the packet being queried |
| 824 | * @secdata is a pointer to a buffer in which to copy the security data |
| 825 | * @seclen is the maximum length for @secdata |
| 826 | * Return 0 on success, error on failure. |
| 827 | * @sk_alloc_security: |
| 828 | * Allocate and attach a security structure to the sk->sk_security field, |
| 829 | * which is used to copy security attributes between local stream sockets. |
| 830 | * @sk_free_security: |
| 831 | * Deallocate security structure. |
| 832 | * @sk_clone_security: |
| 833 | * Clone/copy security structure. |
| 834 | * @sk_getsecid: |
| 835 | * Retrieve the LSM-specific secid for the sock to enable caching |
| 836 | * of network authorizations. |
| 837 | * @sock_graft: |
| 838 | * Sets the socket's isec sid to the sock's sid. |
| 839 | * @inet_conn_request: |
| 840 | * Sets the openreq's sid to socket's sid with MLS portion taken |
| 841 | * from peer sid. |
| 842 | * @inet_csk_clone: |
| 843 | * Sets the new child socket's sid to the openreq sid. |
| 844 | * @inet_conn_established: |
| 845 | * Sets the connection's peersid to the secmark on skb. |
| 846 | * @secmark_relabel_packet: |
| 847 | * check if the process should be allowed to relabel packets to |
| 848 | * the given secid |
| 849 | * @security_secmark_refcount_inc |
| 850 | * tells the LSM to increment the number of secmark labeling rules loaded |
| 851 | * @security_secmark_refcount_dec |
| 852 | * tells the LSM to decrement the number of secmark labeling rules loaded |
| 853 | * @req_classify_flow: |
| 854 | * Sets the flow's sid to the openreq sid. |
| 855 | * @tun_dev_alloc_security: |
| 856 | * This hook allows a module to allocate a security structure for a TUN |
| 857 | * device. |
| 858 | * @security pointer to a security structure pointer. |
| 859 | * Returns a zero on success, negative values on failure. |
| 860 | * @tun_dev_free_security: |
| 861 | * This hook allows a module to free the security structure for a TUN |
| 862 | * device. |
| 863 | * @security pointer to the TUN device's security structure |
| 864 | * @tun_dev_create: |
| 865 | * Check permissions prior to creating a new TUN device. |
| 866 | * @tun_dev_attach_queue: |
| 867 | * Check permissions prior to attaching to a TUN device queue. |
| 868 | * @security pointer to the TUN device's security structure. |
| 869 | * @tun_dev_attach: |
| 870 | * This hook can be used by the module to update any security state |
| 871 | * associated with the TUN device's sock structure. |
| 872 | * @sk contains the existing sock structure. |
| 873 | * @security pointer to the TUN device's security structure. |
| 874 | * @tun_dev_open: |
| 875 | * This hook can be used by the module to update any security state |
| 876 | * associated with the TUN device's security structure. |
| 877 | * @security pointer to the TUN devices's security structure. |
| 878 | * |
| 879 | * Security hooks for XFRM operations. |
| 880 | * |
| 881 | * @xfrm_policy_alloc_security: |
| 882 | * @ctxp is a pointer to the xfrm_sec_ctx being added to Security Policy |
| 883 | * Database used by the XFRM system. |
| 884 | * @sec_ctx contains the security context information being provided by |
| 885 | * the user-level policy update program (e.g., setkey). |
| 886 | * Allocate a security structure to the xp->security field; the security |
| 887 | * field is initialized to NULL when the xfrm_policy is allocated. |
| 888 | * Return 0 if operation was successful (memory to allocate, legal context) |
| 889 | * @gfp is to specify the context for the allocation |
| 890 | * @xfrm_policy_clone_security: |
| 891 | * @old_ctx contains an existing xfrm_sec_ctx. |
| 892 | * @new_ctxp contains a new xfrm_sec_ctx being cloned from old. |
| 893 | * Allocate a security structure in new_ctxp that contains the |
| 894 | * information from the old_ctx structure. |
| 895 | * Return 0 if operation was successful (memory to allocate). |
| 896 | * @xfrm_policy_free_security: |
| 897 | * @ctx contains the xfrm_sec_ctx |
| 898 | * Deallocate xp->security. |
| 899 | * @xfrm_policy_delete_security: |
| 900 | * @ctx contains the xfrm_sec_ctx. |
| 901 | * Authorize deletion of xp->security. |
| 902 | * @xfrm_state_alloc: |
| 903 | * @x contains the xfrm_state being added to the Security Association |
| 904 | * Database by the XFRM system. |
| 905 | * @sec_ctx contains the security context information being provided by |
| 906 | * the user-level SA generation program (e.g., setkey or racoon). |
| 907 | * Allocate a security structure to the x->security field; the security |
| 908 | * field is initialized to NULL when the xfrm_state is allocated. Set the |
| 909 | * context to correspond to sec_ctx. Return 0 if operation was successful |
| 910 | * (memory to allocate, legal context). |
| 911 | * @xfrm_state_alloc_acquire: |
| 912 | * @x contains the xfrm_state being added to the Security Association |
| 913 | * Database by the XFRM system. |
| 914 | * @polsec contains the policy's security context. |
| 915 | * @secid contains the secid from which to take the mls portion of the |
| 916 | * context. |
| 917 | * Allocate a security structure to the x->security field; the security |
| 918 | * field is initialized to NULL when the xfrm_state is allocated. Set the |
| 919 | * context to correspond to secid. Return 0 if operation was successful |
| 920 | * (memory to allocate, legal context). |
| 921 | * @xfrm_state_free_security: |
| 922 | * @x contains the xfrm_state. |
| 923 | * Deallocate x->security. |
| 924 | * @xfrm_state_delete_security: |
| 925 | * @x contains the xfrm_state. |
| 926 | * Authorize deletion of x->security. |
| 927 | * @xfrm_policy_lookup: |
| 928 | * @ctx contains the xfrm_sec_ctx for which the access control is being |
| 929 | * checked. |
| 930 | * @fl_secid contains the flow security label that is used to authorize |
| 931 | * access to the policy xp. |
| 932 | * @dir contains the direction of the flow (input or output). |
| 933 | * Check permission when a flow selects a xfrm_policy for processing |
| 934 | * XFRMs on a packet. The hook is called when selecting either a |
| 935 | * per-socket policy or a generic xfrm policy. |
| 936 | * Return 0 if permission is granted, -ESRCH otherwise, or -errno |
| 937 | * on other errors. |
| 938 | * @xfrm_state_pol_flow_match: |
| 939 | * @x contains the state to match. |
| 940 | * @xp contains the policy to check for a match. |
| 941 | * @fl contains the flow to check for a match. |
| 942 | * Return 1 if there is a match. |
| 943 | * @xfrm_decode_session: |
| 944 | * @skb points to skb to decode. |
| 945 | * @secid points to the flow key secid to set. |
| 946 | * @ckall says if all xfrms used should be checked for same secid. |
| 947 | * Return 0 if ckall is zero or all xfrms used have the same secid. |
| 948 | * |
| 949 | * Security hooks affecting all Key Management operations |
| 950 | * |
| 951 | * @key_alloc: |
| 952 | * Permit allocation of a key and assign security data. Note that key does |
| 953 | * not have a serial number assigned at this point. |
| 954 | * @key points to the key. |
| 955 | * @flags is the allocation flags |
| 956 | * Return 0 if permission is granted, -ve error otherwise. |
| 957 | * @key_free: |
| 958 | * Notification of destruction; free security data. |
| 959 | * @key points to the key. |
| 960 | * No return value. |
| 961 | * @key_permission: |
| 962 | * See whether a specific operational right is granted to a process on a |
| 963 | * key. |
| 964 | * @key_ref refers to the key (key pointer + possession attribute bit). |
| 965 | * @cred points to the credentials to provide the context against which to |
| 966 | * evaluate the security data on the key. |
| 967 | * @perm describes the combination of permissions required of this key. |
| 968 | * Return 0 if permission is granted, -ve error otherwise. |
| 969 | * @key_getsecurity: |
| 970 | * Get a textual representation of the security context attached to a key |
| 971 | * for the purposes of honouring KEYCTL_GETSECURITY. This function |
| 972 | * allocates the storage for the NUL-terminated string and the caller |
| 973 | * should free it. |
| 974 | * @key points to the key to be queried. |
| 975 | * @_buffer points to a pointer that should be set to point to the |
| 976 | * resulting string (if no label or an error occurs). |
| 977 | * Return the length of the string (including terminating NUL) or -ve if |
| 978 | * an error. |
| 979 | * May also return 0 (and a NULL buffer pointer) if there is no label. |
| 980 | * |
| 981 | * Security hooks affecting all System V IPC operations. |
| 982 | * |
| 983 | * @ipc_permission: |
| 984 | * Check permissions for access to IPC |
| 985 | * @ipcp contains the kernel IPC permission structure |
| 986 | * @flag contains the desired (requested) permission set |
| 987 | * Return 0 if permission is granted. |
| 988 | * @ipc_getsecid: |
| 989 | * Get the secid associated with the ipc object. |
| 990 | * @ipcp contains the kernel IPC permission structure. |
| 991 | * @secid contains a pointer to the location where result will be saved. |
| 992 | * In case of failure, @secid will be set to zero. |
| 993 | * |
| 994 | * Security hooks for individual messages held in System V IPC message queues |
| 995 | * @msg_msg_alloc_security: |
| 996 | * Allocate and attach a security structure to the msg->security field. |
| 997 | * The security field is initialized to NULL when the structure is first |
| 998 | * created. |
| 999 | * @msg contains the message structure to be modified. |
| 1000 | * Return 0 if operation was successful and permission is granted. |
| 1001 | * @msg_msg_free_security: |
| 1002 | * Deallocate the security structure for this message. |
| 1003 | * @msg contains the message structure to be modified. |
| 1004 | * |
| 1005 | * Security hooks for System V IPC Message Queues |
| 1006 | * |
| 1007 | * @msg_queue_alloc_security: |
| 1008 | * Allocate and attach a security structure to the |
| 1009 | * msq->q_perm.security field. The security field is initialized to |
| 1010 | * NULL when the structure is first created. |
| 1011 | * @msq contains the message queue structure to be modified. |
| 1012 | * Return 0 if operation was successful and permission is granted. |
| 1013 | * @msg_queue_free_security: |
| 1014 | * Deallocate security structure for this message queue. |
| 1015 | * @msq contains the message queue structure to be modified. |
| 1016 | * @msg_queue_associate: |
| 1017 | * Check permission when a message queue is requested through the |
| 1018 | * msgget system call. This hook is only called when returning the |
| 1019 | * message queue identifier for an existing message queue, not when a |
| 1020 | * new message queue is created. |
| 1021 | * @msq contains the message queue to act upon. |
| 1022 | * @msqflg contains the operation control flags. |
| 1023 | * Return 0 if permission is granted. |
| 1024 | * @msg_queue_msgctl: |
| 1025 | * Check permission when a message control operation specified by @cmd |
| 1026 | * is to be performed on the message queue @msq. |
| 1027 | * The @msq may be NULL, e.g. for IPC_INFO or MSG_INFO. |
| 1028 | * @msq contains the message queue to act upon. May be NULL. |
| 1029 | * @cmd contains the operation to be performed. |
| 1030 | * Return 0 if permission is granted. |
| 1031 | * @msg_queue_msgsnd: |
| 1032 | * Check permission before a message, @msg, is enqueued on the message |
| 1033 | * queue, @msq. |
| 1034 | * @msq contains the message queue to send message to. |
| 1035 | * @msg contains the message to be enqueued. |
| 1036 | * @msqflg contains operational flags. |
| 1037 | * Return 0 if permission is granted. |
| 1038 | * @msg_queue_msgrcv: |
| 1039 | * Check permission before a message, @msg, is removed from the message |
| 1040 | * queue, @msq. The @target task structure contains a pointer to the |
| 1041 | * process that will be receiving the message (not equal to the current |
| 1042 | * process when inline receives are being performed). |
| 1043 | * @msq contains the message queue to retrieve message from. |
| 1044 | * @msg contains the message destination. |
| 1045 | * @target contains the task structure for recipient process. |
| 1046 | * @type contains the type of message requested. |
| 1047 | * @mode contains the operational flags. |
| 1048 | * Return 0 if permission is granted. |
| 1049 | * |
| 1050 | * Security hooks for System V Shared Memory Segments |
| 1051 | * |
| 1052 | * @shm_alloc_security: |
| 1053 | * Allocate and attach a security structure to the shp->shm_perm.security |
| 1054 | * field. The security field is initialized to NULL when the structure is |
| 1055 | * first created. |
| 1056 | * @shp contains the shared memory structure to be modified. |
| 1057 | * Return 0 if operation was successful and permission is granted. |
| 1058 | * @shm_free_security: |
| 1059 | * Deallocate the security struct for this memory segment. |
| 1060 | * @shp contains the shared memory structure to be modified. |
| 1061 | * @shm_associate: |
| 1062 | * Check permission when a shared memory region is requested through the |
| 1063 | * shmget system call. This hook is only called when returning the shared |
| 1064 | * memory region identifier for an existing region, not when a new shared |
| 1065 | * memory region is created. |
| 1066 | * @shp contains the shared memory structure to be modified. |
| 1067 | * @shmflg contains the operation control flags. |
| 1068 | * Return 0 if permission is granted. |
| 1069 | * @shm_shmctl: |
| 1070 | * Check permission when a shared memory control operation specified by |
| 1071 | * @cmd is to be performed on the shared memory region @shp. |
| 1072 | * The @shp may be NULL, e.g. for IPC_INFO or SHM_INFO. |
| 1073 | * @shp contains shared memory structure to be modified. |
| 1074 | * @cmd contains the operation to be performed. |
| 1075 | * Return 0 if permission is granted. |
| 1076 | * @shm_shmat: |
| 1077 | * Check permissions prior to allowing the shmat system call to attach the |
| 1078 | * shared memory segment @shp to the data segment of the calling process. |
| 1079 | * The attaching address is specified by @shmaddr. |
| 1080 | * @shp contains the shared memory structure to be modified. |
| 1081 | * @shmaddr contains the address to attach memory region to. |
| 1082 | * @shmflg contains the operational flags. |
| 1083 | * Return 0 if permission is granted. |
| 1084 | * |
| 1085 | * Security hooks for System V Semaphores |
| 1086 | * |
| 1087 | * @sem_alloc_security: |
| 1088 | * Allocate and attach a security structure to the sma->sem_perm.security |
| 1089 | * field. The security field is initialized to NULL when the structure is |
| 1090 | * first created. |
| 1091 | * @sma contains the semaphore structure |
| 1092 | * Return 0 if operation was successful and permission is granted. |
| 1093 | * @sem_free_security: |
| 1094 | * deallocate security struct for this semaphore |
| 1095 | * @sma contains the semaphore structure. |
| 1096 | * @sem_associate: |
| 1097 | * Check permission when a semaphore is requested through the semget |
| 1098 | * system call. This hook is only called when returning the semaphore |
| 1099 | * identifier for an existing semaphore, not when a new one must be |
| 1100 | * created. |
| 1101 | * @sma contains the semaphore structure. |
| 1102 | * @semflg contains the operation control flags. |
| 1103 | * Return 0 if permission is granted. |
| 1104 | * @sem_semctl: |
| 1105 | * Check permission when a semaphore operation specified by @cmd is to be |
| 1106 | * performed on the semaphore @sma. The @sma may be NULL, e.g. for |
| 1107 | * IPC_INFO or SEM_INFO. |
| 1108 | * @sma contains the semaphore structure. May be NULL. |
| 1109 | * @cmd contains the operation to be performed. |
| 1110 | * Return 0 if permission is granted. |
| 1111 | * @sem_semop |
| 1112 | * Check permissions before performing operations on members of the |
| 1113 | * semaphore set @sma. If the @alter flag is nonzero, the semaphore set |
| 1114 | * may be modified. |
| 1115 | * @sma contains the semaphore structure. |
| 1116 | * @sops contains the operations to perform. |
| 1117 | * @nsops contains the number of operations to perform. |
| 1118 | * @alter contains the flag indicating whether changes are to be made. |
| 1119 | * Return 0 if permission is granted. |
| 1120 | * |
| 1121 | * @binder_set_context_mgr |
| 1122 | * Check whether @mgr is allowed to be the binder context manager. |
| 1123 | * @mgr contains the task_struct for the task being registered. |
| 1124 | * Return 0 if permission is granted. |
| 1125 | * @binder_transaction |
| 1126 | * Check whether @from is allowed to invoke a binder transaction call |
| 1127 | * to @to. |
| 1128 | * @from contains the task_struct for the sending task. |
| 1129 | * @to contains the task_struct for the receiving task. |
| 1130 | * @binder_transfer_binder |
| 1131 | * Check whether @from is allowed to transfer a binder reference to @to. |
| 1132 | * @from contains the task_struct for the sending task. |
| 1133 | * @to contains the task_struct for the receiving task. |
| 1134 | * @binder_transfer_file |
| 1135 | * Check whether @from is allowed to transfer @file to @to. |
| 1136 | * @from contains the task_struct for the sending task. |
| 1137 | * @file contains the struct file being transferred. |
| 1138 | * @to contains the task_struct for the receiving task. |
| 1139 | * |
| 1140 | * @ptrace_access_check: |
| 1141 | * Check permission before allowing the current process to trace the |
| 1142 | * @child process. |
| 1143 | * Security modules may also want to perform a process tracing check |
| 1144 | * during an execve in the set_security or apply_creds hooks of |
| 1145 | * tracing check during an execve in the bprm_set_creds hook of |
| 1146 | * binprm_security_ops if the process is being traced and its security |
| 1147 | * attributes would be changed by the execve. |
| 1148 | * @child contains the task_struct structure for the target process. |
| 1149 | * @mode contains the PTRACE_MODE flags indicating the form of access. |
| 1150 | * Return 0 if permission is granted. |
| 1151 | * @ptrace_traceme: |
| 1152 | * Check that the @parent process has sufficient permission to trace the |
| 1153 | * current process before allowing the current process to present itself |
| 1154 | * to the @parent process for tracing. |
| 1155 | * @parent contains the task_struct structure for debugger process. |
| 1156 | * Return 0 if permission is granted. |
| 1157 | * @capget: |
| 1158 | * Get the @effective, @inheritable, and @permitted capability sets for |
| 1159 | * the @target process. The hook may also perform permission checking to |
| 1160 | * determine if the current process is allowed to see the capability sets |
| 1161 | * of the @target process. |
| 1162 | * @target contains the task_struct structure for target process. |
| 1163 | * @effective contains the effective capability set. |
| 1164 | * @inheritable contains the inheritable capability set. |
| 1165 | * @permitted contains the permitted capability set. |
| 1166 | * Return 0 if the capability sets were successfully obtained. |
| 1167 | * @capset: |
| 1168 | * Set the @effective, @inheritable, and @permitted capability sets for |
| 1169 | * the current process. |
| 1170 | * @new contains the new credentials structure for target process. |
| 1171 | * @old contains the current credentials structure for target process. |
| 1172 | * @effective contains the effective capability set. |
| 1173 | * @inheritable contains the inheritable capability set. |
| 1174 | * @permitted contains the permitted capability set. |
| 1175 | * Return 0 and update @new if permission is granted. |
| 1176 | * @capable: |
| 1177 | * Check whether the @tsk process has the @cap capability in the indicated |
| 1178 | * credentials. |
| 1179 | * @cred contains the credentials to use. |
| 1180 | * @ns contains the user namespace we want the capability in |
| 1181 | * @cap contains the capability <include/linux/capability.h>. |
| 1182 | * @audit: Whether to write an audit message or not |
| 1183 | * Return 0 if the capability is granted for @tsk. |
| 1184 | * @syslog: |
| 1185 | * Check permission before accessing the kernel message ring or changing |
| 1186 | * logging to the console. |
| 1187 | * See the syslog(2) manual page for an explanation of the @type values. |
| 1188 | * @type contains the type of action. |
| 1189 | * @from_file indicates the context of action (if it came from /proc). |
| 1190 | * Return 0 if permission is granted. |
| 1191 | * @settime: |
| 1192 | * Check permission to change the system time. |
Baolin Wang | 457db29 | 2016-04-08 14:02:11 +0800 | [diff] [blame] | 1193 | * struct timespec64 is defined in include/linux/time64.h and timezone |
| 1194 | * is defined in include/linux/time.h |
Casey Schaufler | fe7bb27 | 2015-05-02 15:10:53 -0700 | [diff] [blame] | 1195 | * @ts contains new time |
| 1196 | * @tz contains new timezone |
| 1197 | * Return 0 if permission is granted. |
| 1198 | * @vm_enough_memory: |
| 1199 | * Check permissions for allocating a new virtual mapping. |
| 1200 | * @mm contains the mm struct it is being added to. |
| 1201 | * @pages contains the number of pages. |
| 1202 | * Return 0 if permission is granted. |
| 1203 | * |
| 1204 | * @ismaclabel: |
| 1205 | * Check if the extended attribute specified by @name |
| 1206 | * represents a MAC label. Returns 1 if name is a MAC |
| 1207 | * attribute otherwise returns 0. |
| 1208 | * @name full extended attribute name to check against |
| 1209 | * LSM as a MAC label. |
| 1210 | * |
| 1211 | * @secid_to_secctx: |
| 1212 | * Convert secid to security context. If secdata is NULL the length of |
| 1213 | * the result will be returned in seclen, but no secdata will be returned. |
| 1214 | * This does mean that the length could change between calls to check the |
| 1215 | * length and the next call which actually allocates and returns the |
| 1216 | * secdata. |
| 1217 | * @secid contains the security ID. |
| 1218 | * @secdata contains the pointer that stores the converted security |
| 1219 | * context. |
| 1220 | * @seclen pointer which contains the length of the data |
| 1221 | * @secctx_to_secid: |
| 1222 | * Convert security context to secid. |
| 1223 | * @secid contains the pointer to the generated security ID. |
| 1224 | * @secdata contains the security context. |
| 1225 | * |
| 1226 | * @release_secctx: |
| 1227 | * Release the security context. |
| 1228 | * @secdata contains the security context. |
| 1229 | * @seclen contains the length of the security context. |
| 1230 | * |
| 1231 | * Security hooks for Audit |
| 1232 | * |
| 1233 | * @audit_rule_init: |
| 1234 | * Allocate and initialize an LSM audit rule structure. |
| 1235 | * @field contains the required Audit action. |
| 1236 | * Fields flags are defined in include/linux/audit.h |
| 1237 | * @op contains the operator the rule uses. |
| 1238 | * @rulestr contains the context where the rule will be applied to. |
| 1239 | * @lsmrule contains a pointer to receive the result. |
| 1240 | * Return 0 if @lsmrule has been successfully set, |
| 1241 | * -EINVAL in case of an invalid rule. |
| 1242 | * |
| 1243 | * @audit_rule_known: |
| 1244 | * Specifies whether given @rule contains any fields related to |
| 1245 | * current LSM. |
| 1246 | * @rule contains the audit rule of interest. |
| 1247 | * Return 1 in case of relation found, 0 otherwise. |
| 1248 | * |
| 1249 | * @audit_rule_match: |
| 1250 | * Determine if given @secid matches a rule previously approved |
| 1251 | * by @audit_rule_known. |
| 1252 | * @secid contains the security id in question. |
| 1253 | * @field contains the field which relates to current LSM. |
| 1254 | * @op contains the operator that will be used for matching. |
| 1255 | * @rule points to the audit rule that will be checked against. |
| 1256 | * @actx points to the audit context associated with the check. |
| 1257 | * Return 1 if secid matches the rule, 0 if it does not, -ERRNO on failure. |
| 1258 | * |
| 1259 | * @audit_rule_free: |
| 1260 | * Deallocate the LSM audit rule structure previously allocated by |
| 1261 | * audit_rule_init. |
| 1262 | * @rule contains the allocated rule |
| 1263 | * |
Andreas Gruenbacher | 6f3be9f | 2015-12-24 11:09:40 -0500 | [diff] [blame] | 1264 | * @inode_invalidate_secctx: |
| 1265 | * Notify the security module that it must revalidate the security context |
| 1266 | * of an inode. |
| 1267 | * |
Casey Schaufler | fe7bb27 | 2015-05-02 15:10:53 -0700 | [diff] [blame] | 1268 | * @inode_notifysecctx: |
| 1269 | * Notify the security module of what the security context of an inode |
| 1270 | * should be. Initializes the incore security context managed by the |
| 1271 | * security module for this inode. Example usage: NFS client invokes |
| 1272 | * this hook to initialize the security context in its incore inode to the |
| 1273 | * value provided by the server for the file when the server returned the |
| 1274 | * file's attributes to the client. |
| 1275 | * |
| 1276 | * Must be called with inode->i_mutex locked. |
| 1277 | * |
| 1278 | * @inode we wish to set the security context of. |
| 1279 | * @ctx contains the string which we wish to set in the inode. |
| 1280 | * @ctxlen contains the length of @ctx. |
| 1281 | * |
| 1282 | * @inode_setsecctx: |
| 1283 | * Change the security context of an inode. Updates the |
| 1284 | * incore security context managed by the security module and invokes the |
| 1285 | * fs code as needed (via __vfs_setxattr_noperm) to update any backing |
| 1286 | * xattrs that represent the context. Example usage: NFS server invokes |
| 1287 | * this hook to change the security context in its incore inode and on the |
| 1288 | * backing filesystem to a value provided by the client on a SETATTR |
| 1289 | * operation. |
| 1290 | * |
| 1291 | * Must be called with inode->i_mutex locked. |
| 1292 | * |
| 1293 | * @dentry contains the inode we wish to set the security context of. |
| 1294 | * @ctx contains the string which we wish to set in the inode. |
| 1295 | * @ctxlen contains the length of @ctx. |
| 1296 | * |
| 1297 | * @inode_getsecctx: |
| 1298 | * On success, returns 0 and fills out @ctx and @ctxlen with the security |
| 1299 | * context for the given @inode. |
| 1300 | * |
| 1301 | * @inode we wish to get the security context of. |
| 1302 | * @ctx is a pointer in which to place the allocated security context. |
| 1303 | * @ctxlen points to the place to put the length of @ctx. |
| 1304 | * This is the main security structure. |
| 1305 | */ |
| 1306 | |
Casey Schaufler | b1d9e6b | 2015-05-02 15:11:42 -0700 | [diff] [blame] | 1307 | union security_list_options { |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1308 | int (*binder_set_context_mgr)(struct task_struct *mgr); |
| 1309 | int (*binder_transaction)(struct task_struct *from, |
| 1310 | struct task_struct *to); |
| 1311 | int (*binder_transfer_binder)(struct task_struct *from, |
| 1312 | struct task_struct *to); |
| 1313 | int (*binder_transfer_file)(struct task_struct *from, |
| 1314 | struct task_struct *to, |
| 1315 | struct file *file); |
| 1316 | |
| 1317 | int (*ptrace_access_check)(struct task_struct *child, |
| 1318 | unsigned int mode); |
| 1319 | int (*ptrace_traceme)(struct task_struct *parent); |
| 1320 | int (*capget)(struct task_struct *target, kernel_cap_t *effective, |
| 1321 | kernel_cap_t *inheritable, kernel_cap_t *permitted); |
| 1322 | int (*capset)(struct cred *new, const struct cred *old, |
| 1323 | const kernel_cap_t *effective, |
| 1324 | const kernel_cap_t *inheritable, |
| 1325 | const kernel_cap_t *permitted); |
| 1326 | int (*capable)(const struct cred *cred, struct user_namespace *ns, |
| 1327 | int cap, int audit); |
| 1328 | int (*quotactl)(int cmds, int type, int id, struct super_block *sb); |
| 1329 | int (*quota_on)(struct dentry *dentry); |
| 1330 | int (*syslog)(int type); |
Baolin Wang | 457db29 | 2016-04-08 14:02:11 +0800 | [diff] [blame] | 1331 | int (*settime)(const struct timespec64 *ts, const struct timezone *tz); |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1332 | int (*vm_enough_memory)(struct mm_struct *mm, long pages); |
| 1333 | |
| 1334 | int (*bprm_set_creds)(struct linux_binprm *bprm); |
| 1335 | int (*bprm_check_security)(struct linux_binprm *bprm); |
| 1336 | int (*bprm_secureexec)(struct linux_binprm *bprm); |
| 1337 | void (*bprm_committing_creds)(struct linux_binprm *bprm); |
| 1338 | void (*bprm_committed_creds)(struct linux_binprm *bprm); |
| 1339 | |
| 1340 | int (*sb_alloc_security)(struct super_block *sb); |
| 1341 | void (*sb_free_security)(struct super_block *sb); |
| 1342 | int (*sb_copy_data)(char *orig, char *copy); |
| 1343 | int (*sb_remount)(struct super_block *sb, void *data); |
| 1344 | int (*sb_kern_mount)(struct super_block *sb, int flags, void *data); |
| 1345 | int (*sb_show_options)(struct seq_file *m, struct super_block *sb); |
| 1346 | int (*sb_statfs)(struct dentry *dentry); |
Al Viro | 8a04c43 | 2016-03-25 14:52:53 -0400 | [diff] [blame] | 1347 | int (*sb_mount)(const char *dev_name, const struct path *path, |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1348 | const char *type, unsigned long flags, void *data); |
| 1349 | int (*sb_umount)(struct vfsmount *mnt, int flags); |
Al Viro | 3b73b68 | 2016-03-25 15:31:19 -0400 | [diff] [blame] | 1350 | int (*sb_pivotroot)(const struct path *old_path, const struct path *new_path); |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1351 | int (*sb_set_mnt_opts)(struct super_block *sb, |
| 1352 | struct security_mnt_opts *opts, |
| 1353 | unsigned long kern_flags, |
| 1354 | unsigned long *set_kern_flags); |
| 1355 | int (*sb_clone_mnt_opts)(const struct super_block *oldsb, |
| 1356 | struct super_block *newsb); |
| 1357 | int (*sb_parse_opts_str)(char *options, struct security_mnt_opts *opts); |
| 1358 | int (*dentry_init_security)(struct dentry *dentry, int mode, |
| 1359 | struct qstr *name, void **ctx, |
| 1360 | u32 *ctxlen); |
| 1361 | |
| 1362 | |
| 1363 | #ifdef CONFIG_SECURITY_PATH |
Al Viro | 989f74e | 2016-03-25 15:13:39 -0400 | [diff] [blame] | 1364 | int (*path_unlink)(const struct path *dir, struct dentry *dentry); |
Al Viro | d360775 | 2016-03-25 15:21:09 -0400 | [diff] [blame] | 1365 | int (*path_mkdir)(const struct path *dir, struct dentry *dentry, |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1366 | umode_t mode); |
Al Viro | 989f74e | 2016-03-25 15:13:39 -0400 | [diff] [blame] | 1367 | int (*path_rmdir)(const struct path *dir, struct dentry *dentry); |
Al Viro | d360775 | 2016-03-25 15:21:09 -0400 | [diff] [blame] | 1368 | int (*path_mknod)(const struct path *dir, struct dentry *dentry, |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1369 | umode_t mode, unsigned int dev); |
Al Viro | 81f4c50 | 2016-03-25 14:22:01 -0400 | [diff] [blame] | 1370 | int (*path_truncate)(const struct path *path); |
Al Viro | d360775 | 2016-03-25 15:21:09 -0400 | [diff] [blame] | 1371 | int (*path_symlink)(const struct path *dir, struct dentry *dentry, |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1372 | const char *old_name); |
Al Viro | 3ccee46 | 2016-03-25 15:27:45 -0400 | [diff] [blame] | 1373 | int (*path_link)(struct dentry *old_dentry, const struct path *new_dir, |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1374 | struct dentry *new_dentry); |
Al Viro | 3ccee46 | 2016-03-25 15:27:45 -0400 | [diff] [blame] | 1375 | int (*path_rename)(const struct path *old_dir, struct dentry *old_dentry, |
| 1376 | const struct path *new_dir, |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1377 | struct dentry *new_dentry); |
Al Viro | be01f9f | 2016-03-25 14:56:23 -0400 | [diff] [blame] | 1378 | int (*path_chmod)(const struct path *path, umode_t mode); |
Al Viro | 7fd25da | 2016-03-25 14:44:41 -0400 | [diff] [blame] | 1379 | int (*path_chown)(const struct path *path, kuid_t uid, kgid_t gid); |
Al Viro | 77b286c | 2016-03-25 15:28:43 -0400 | [diff] [blame] | 1380 | int (*path_chroot)(const struct path *path); |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1381 | #endif |
| 1382 | |
| 1383 | int (*inode_alloc_security)(struct inode *inode); |
| 1384 | void (*inode_free_security)(struct inode *inode); |
| 1385 | int (*inode_init_security)(struct inode *inode, struct inode *dir, |
| 1386 | const struct qstr *qstr, |
| 1387 | const char **name, void **value, |
| 1388 | size_t *len); |
| 1389 | int (*inode_create)(struct inode *dir, struct dentry *dentry, |
| 1390 | umode_t mode); |
| 1391 | int (*inode_link)(struct dentry *old_dentry, struct inode *dir, |
| 1392 | struct dentry *new_dentry); |
| 1393 | int (*inode_unlink)(struct inode *dir, struct dentry *dentry); |
| 1394 | int (*inode_symlink)(struct inode *dir, struct dentry *dentry, |
| 1395 | const char *old_name); |
| 1396 | int (*inode_mkdir)(struct inode *dir, struct dentry *dentry, |
| 1397 | umode_t mode); |
| 1398 | int (*inode_rmdir)(struct inode *dir, struct dentry *dentry); |
| 1399 | int (*inode_mknod)(struct inode *dir, struct dentry *dentry, |
| 1400 | umode_t mode, dev_t dev); |
| 1401 | int (*inode_rename)(struct inode *old_dir, struct dentry *old_dentry, |
| 1402 | struct inode *new_dir, |
| 1403 | struct dentry *new_dentry); |
| 1404 | int (*inode_readlink)(struct dentry *dentry); |
Linus Torvalds | e22619a | 2015-06-27 13:26:03 -0700 | [diff] [blame] | 1405 | int (*inode_follow_link)(struct dentry *dentry, struct inode *inode, |
| 1406 | bool rcu); |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1407 | int (*inode_permission)(struct inode *inode, int mask); |
| 1408 | int (*inode_setattr)(struct dentry *dentry, struct iattr *attr); |
| 1409 | int (*inode_getattr)(const struct path *path); |
| 1410 | int (*inode_setxattr)(struct dentry *dentry, const char *name, |
| 1411 | const void *value, size_t size, int flags); |
| 1412 | void (*inode_post_setxattr)(struct dentry *dentry, const char *name, |
| 1413 | const void *value, size_t size, |
| 1414 | int flags); |
| 1415 | int (*inode_getxattr)(struct dentry *dentry, const char *name); |
| 1416 | int (*inode_listxattr)(struct dentry *dentry); |
| 1417 | int (*inode_removexattr)(struct dentry *dentry, const char *name); |
| 1418 | int (*inode_need_killpriv)(struct dentry *dentry); |
| 1419 | int (*inode_killpriv)(struct dentry *dentry); |
Andreas Gruenbacher | ea861df | 2015-12-24 11:09:39 -0500 | [diff] [blame] | 1420 | int (*inode_getsecurity)(struct inode *inode, const char *name, |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1421 | void **buffer, bool alloc); |
| 1422 | int (*inode_setsecurity)(struct inode *inode, const char *name, |
| 1423 | const void *value, size_t size, |
| 1424 | int flags); |
| 1425 | int (*inode_listsecurity)(struct inode *inode, char *buffer, |
| 1426 | size_t buffer_size); |
Andreas Gruenbacher | d6335d7 | 2015-12-24 11:09:39 -0500 | [diff] [blame] | 1427 | void (*inode_getsecid)(struct inode *inode, u32 *secid); |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1428 | |
| 1429 | int (*file_permission)(struct file *file, int mask); |
| 1430 | int (*file_alloc_security)(struct file *file); |
| 1431 | void (*file_free_security)(struct file *file); |
| 1432 | int (*file_ioctl)(struct file *file, unsigned int cmd, |
| 1433 | unsigned long arg); |
| 1434 | int (*mmap_addr)(unsigned long addr); |
| 1435 | int (*mmap_file)(struct file *file, unsigned long reqprot, |
| 1436 | unsigned long prot, unsigned long flags); |
| 1437 | int (*file_mprotect)(struct vm_area_struct *vma, unsigned long reqprot, |
| 1438 | unsigned long prot); |
| 1439 | int (*file_lock)(struct file *file, unsigned int cmd); |
| 1440 | int (*file_fcntl)(struct file *file, unsigned int cmd, |
| 1441 | unsigned long arg); |
| 1442 | void (*file_set_fowner)(struct file *file); |
| 1443 | int (*file_send_sigiotask)(struct task_struct *tsk, |
| 1444 | struct fown_struct *fown, int sig); |
| 1445 | int (*file_receive)(struct file *file); |
| 1446 | int (*file_open)(struct file *file, const struct cred *cred); |
| 1447 | |
| 1448 | int (*task_create)(unsigned long clone_flags); |
| 1449 | void (*task_free)(struct task_struct *task); |
| 1450 | int (*cred_alloc_blank)(struct cred *cred, gfp_t gfp); |
| 1451 | void (*cred_free)(struct cred *cred); |
| 1452 | int (*cred_prepare)(struct cred *new, const struct cred *old, |
| 1453 | gfp_t gfp); |
| 1454 | void (*cred_transfer)(struct cred *new, const struct cred *old); |
| 1455 | int (*kernel_act_as)(struct cred *new, u32 secid); |
| 1456 | int (*kernel_create_files_as)(struct cred *new, struct inode *inode); |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1457 | int (*kernel_module_request)(char *kmod_name); |
| 1458 | int (*kernel_module_from_file)(struct file *file); |
Mimi Zohar | 39eeb4f | 2016-01-30 22:23:26 -0500 | [diff] [blame] | 1459 | int (*kernel_read_file)(struct file *file, enum kernel_read_file_id id); |
Mimi Zohar | bc8ca5b | 2016-01-24 10:07:32 -0500 | [diff] [blame] | 1460 | int (*kernel_post_read_file)(struct file *file, char *buf, loff_t size, |
| 1461 | enum kernel_read_file_id id); |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1462 | int (*task_fix_setuid)(struct cred *new, const struct cred *old, |
| 1463 | int flags); |
| 1464 | int (*task_setpgid)(struct task_struct *p, pid_t pgid); |
| 1465 | int (*task_getpgid)(struct task_struct *p); |
| 1466 | int (*task_getsid)(struct task_struct *p); |
| 1467 | void (*task_getsecid)(struct task_struct *p, u32 *secid); |
| 1468 | int (*task_setnice)(struct task_struct *p, int nice); |
| 1469 | int (*task_setioprio)(struct task_struct *p, int ioprio); |
| 1470 | int (*task_getioprio)(struct task_struct *p); |
| 1471 | int (*task_setrlimit)(struct task_struct *p, unsigned int resource, |
| 1472 | struct rlimit *new_rlim); |
| 1473 | int (*task_setscheduler)(struct task_struct *p); |
| 1474 | int (*task_getscheduler)(struct task_struct *p); |
| 1475 | int (*task_movememory)(struct task_struct *p); |
| 1476 | int (*task_kill)(struct task_struct *p, struct siginfo *info, |
| 1477 | int sig, u32 secid); |
| 1478 | int (*task_wait)(struct task_struct *p); |
| 1479 | int (*task_prctl)(int option, unsigned long arg2, unsigned long arg3, |
| 1480 | unsigned long arg4, unsigned long arg5); |
| 1481 | void (*task_to_inode)(struct task_struct *p, struct inode *inode); |
| 1482 | |
| 1483 | int (*ipc_permission)(struct kern_ipc_perm *ipcp, short flag); |
| 1484 | void (*ipc_getsecid)(struct kern_ipc_perm *ipcp, u32 *secid); |
| 1485 | |
| 1486 | int (*msg_msg_alloc_security)(struct msg_msg *msg); |
| 1487 | void (*msg_msg_free_security)(struct msg_msg *msg); |
| 1488 | |
| 1489 | int (*msg_queue_alloc_security)(struct msg_queue *msq); |
| 1490 | void (*msg_queue_free_security)(struct msg_queue *msq); |
| 1491 | int (*msg_queue_associate)(struct msg_queue *msq, int msqflg); |
| 1492 | int (*msg_queue_msgctl)(struct msg_queue *msq, int cmd); |
| 1493 | int (*msg_queue_msgsnd)(struct msg_queue *msq, struct msg_msg *msg, |
| 1494 | int msqflg); |
| 1495 | int (*msg_queue_msgrcv)(struct msg_queue *msq, struct msg_msg *msg, |
| 1496 | struct task_struct *target, long type, |
| 1497 | int mode); |
| 1498 | |
| 1499 | int (*shm_alloc_security)(struct shmid_kernel *shp); |
| 1500 | void (*shm_free_security)(struct shmid_kernel *shp); |
| 1501 | int (*shm_associate)(struct shmid_kernel *shp, int shmflg); |
| 1502 | int (*shm_shmctl)(struct shmid_kernel *shp, int cmd); |
| 1503 | int (*shm_shmat)(struct shmid_kernel *shp, char __user *shmaddr, |
| 1504 | int shmflg); |
| 1505 | |
| 1506 | int (*sem_alloc_security)(struct sem_array *sma); |
| 1507 | void (*sem_free_security)(struct sem_array *sma); |
| 1508 | int (*sem_associate)(struct sem_array *sma, int semflg); |
| 1509 | int (*sem_semctl)(struct sem_array *sma, int cmd); |
| 1510 | int (*sem_semop)(struct sem_array *sma, struct sembuf *sops, |
| 1511 | unsigned nsops, int alter); |
| 1512 | |
| 1513 | int (*netlink_send)(struct sock *sk, struct sk_buff *skb); |
| 1514 | |
| 1515 | void (*d_instantiate)(struct dentry *dentry, struct inode *inode); |
| 1516 | |
| 1517 | int (*getprocattr)(struct task_struct *p, char *name, char **value); |
| 1518 | int (*setprocattr)(struct task_struct *p, char *name, void *value, |
| 1519 | size_t size); |
| 1520 | int (*ismaclabel)(const char *name); |
| 1521 | int (*secid_to_secctx)(u32 secid, char **secdata, u32 *seclen); |
| 1522 | int (*secctx_to_secid)(const char *secdata, u32 seclen, u32 *secid); |
| 1523 | void (*release_secctx)(char *secdata, u32 seclen); |
| 1524 | |
Andreas Gruenbacher | 6f3be9f | 2015-12-24 11:09:40 -0500 | [diff] [blame] | 1525 | void (*inode_invalidate_secctx)(struct inode *inode); |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1526 | int (*inode_notifysecctx)(struct inode *inode, void *ctx, u32 ctxlen); |
| 1527 | int (*inode_setsecctx)(struct dentry *dentry, void *ctx, u32 ctxlen); |
| 1528 | int (*inode_getsecctx)(struct inode *inode, void **ctx, u32 *ctxlen); |
| 1529 | |
| 1530 | #ifdef CONFIG_SECURITY_NETWORK |
| 1531 | int (*unix_stream_connect)(struct sock *sock, struct sock *other, |
| 1532 | struct sock *newsk); |
| 1533 | int (*unix_may_send)(struct socket *sock, struct socket *other); |
| 1534 | |
| 1535 | int (*socket_create)(int family, int type, int protocol, int kern); |
| 1536 | int (*socket_post_create)(struct socket *sock, int family, int type, |
| 1537 | int protocol, int kern); |
| 1538 | int (*socket_bind)(struct socket *sock, struct sockaddr *address, |
| 1539 | int addrlen); |
| 1540 | int (*socket_connect)(struct socket *sock, struct sockaddr *address, |
| 1541 | int addrlen); |
| 1542 | int (*socket_listen)(struct socket *sock, int backlog); |
| 1543 | int (*socket_accept)(struct socket *sock, struct socket *newsock); |
| 1544 | int (*socket_sendmsg)(struct socket *sock, struct msghdr *msg, |
| 1545 | int size); |
| 1546 | int (*socket_recvmsg)(struct socket *sock, struct msghdr *msg, |
| 1547 | int size, int flags); |
| 1548 | int (*socket_getsockname)(struct socket *sock); |
| 1549 | int (*socket_getpeername)(struct socket *sock); |
| 1550 | int (*socket_getsockopt)(struct socket *sock, int level, int optname); |
| 1551 | int (*socket_setsockopt)(struct socket *sock, int level, int optname); |
| 1552 | int (*socket_shutdown)(struct socket *sock, int how); |
| 1553 | int (*socket_sock_rcv_skb)(struct sock *sk, struct sk_buff *skb); |
| 1554 | int (*socket_getpeersec_stream)(struct socket *sock, |
| 1555 | char __user *optval, |
| 1556 | int __user *optlen, unsigned len); |
| 1557 | int (*socket_getpeersec_dgram)(struct socket *sock, |
| 1558 | struct sk_buff *skb, u32 *secid); |
| 1559 | int (*sk_alloc_security)(struct sock *sk, int family, gfp_t priority); |
| 1560 | void (*sk_free_security)(struct sock *sk); |
| 1561 | void (*sk_clone_security)(const struct sock *sk, struct sock *newsk); |
| 1562 | void (*sk_getsecid)(struct sock *sk, u32 *secid); |
| 1563 | void (*sock_graft)(struct sock *sk, struct socket *parent); |
| 1564 | int (*inet_conn_request)(struct sock *sk, struct sk_buff *skb, |
| 1565 | struct request_sock *req); |
| 1566 | void (*inet_csk_clone)(struct sock *newsk, |
| 1567 | const struct request_sock *req); |
| 1568 | void (*inet_conn_established)(struct sock *sk, struct sk_buff *skb); |
| 1569 | int (*secmark_relabel_packet)(u32 secid); |
| 1570 | void (*secmark_refcount_inc)(void); |
| 1571 | void (*secmark_refcount_dec)(void); |
| 1572 | void (*req_classify_flow)(const struct request_sock *req, |
| 1573 | struct flowi *fl); |
| 1574 | int (*tun_dev_alloc_security)(void **security); |
| 1575 | void (*tun_dev_free_security)(void *security); |
| 1576 | int (*tun_dev_create)(void); |
| 1577 | int (*tun_dev_attach_queue)(void *security); |
| 1578 | int (*tun_dev_attach)(struct sock *sk, void *security); |
| 1579 | int (*tun_dev_open)(void *security); |
| 1580 | #endif /* CONFIG_SECURITY_NETWORK */ |
| 1581 | |
| 1582 | #ifdef CONFIG_SECURITY_NETWORK_XFRM |
| 1583 | int (*xfrm_policy_alloc_security)(struct xfrm_sec_ctx **ctxp, |
| 1584 | struct xfrm_user_sec_ctx *sec_ctx, |
| 1585 | gfp_t gfp); |
| 1586 | int (*xfrm_policy_clone_security)(struct xfrm_sec_ctx *old_ctx, |
| 1587 | struct xfrm_sec_ctx **new_ctx); |
| 1588 | void (*xfrm_policy_free_security)(struct xfrm_sec_ctx *ctx); |
| 1589 | int (*xfrm_policy_delete_security)(struct xfrm_sec_ctx *ctx); |
| 1590 | int (*xfrm_state_alloc)(struct xfrm_state *x, |
| 1591 | struct xfrm_user_sec_ctx *sec_ctx); |
| 1592 | int (*xfrm_state_alloc_acquire)(struct xfrm_state *x, |
| 1593 | struct xfrm_sec_ctx *polsec, |
| 1594 | u32 secid); |
| 1595 | void (*xfrm_state_free_security)(struct xfrm_state *x); |
| 1596 | int (*xfrm_state_delete_security)(struct xfrm_state *x); |
| 1597 | int (*xfrm_policy_lookup)(struct xfrm_sec_ctx *ctx, u32 fl_secid, |
| 1598 | u8 dir); |
| 1599 | int (*xfrm_state_pol_flow_match)(struct xfrm_state *x, |
| 1600 | struct xfrm_policy *xp, |
| 1601 | const struct flowi *fl); |
| 1602 | int (*xfrm_decode_session)(struct sk_buff *skb, u32 *secid, int ckall); |
| 1603 | #endif /* CONFIG_SECURITY_NETWORK_XFRM */ |
| 1604 | |
| 1605 | /* key management security hooks */ |
| 1606 | #ifdef CONFIG_KEYS |
| 1607 | int (*key_alloc)(struct key *key, const struct cred *cred, |
| 1608 | unsigned long flags); |
| 1609 | void (*key_free)(struct key *key); |
| 1610 | int (*key_permission)(key_ref_t key_ref, const struct cred *cred, |
| 1611 | unsigned perm); |
| 1612 | int (*key_getsecurity)(struct key *key, char **_buffer); |
| 1613 | #endif /* CONFIG_KEYS */ |
| 1614 | |
| 1615 | #ifdef CONFIG_AUDIT |
| 1616 | int (*audit_rule_init)(u32 field, u32 op, char *rulestr, |
| 1617 | void **lsmrule); |
| 1618 | int (*audit_rule_known)(struct audit_krule *krule); |
| 1619 | int (*audit_rule_match)(u32 secid, u32 field, u32 op, void *lsmrule, |
| 1620 | struct audit_context *actx); |
| 1621 | void (*audit_rule_free)(void *lsmrule); |
| 1622 | #endif /* CONFIG_AUDIT */ |
| 1623 | }; |
| 1624 | |
Casey Schaufler | e20b043 | 2015-05-02 15:11:36 -0700 | [diff] [blame] | 1625 | struct security_hook_heads { |
| 1626 | struct list_head binder_set_context_mgr; |
| 1627 | struct list_head binder_transaction; |
| 1628 | struct list_head binder_transfer_binder; |
| 1629 | struct list_head binder_transfer_file; |
| 1630 | struct list_head ptrace_access_check; |
| 1631 | struct list_head ptrace_traceme; |
| 1632 | struct list_head capget; |
| 1633 | struct list_head capset; |
| 1634 | struct list_head capable; |
| 1635 | struct list_head quotactl; |
| 1636 | struct list_head quota_on; |
| 1637 | struct list_head syslog; |
| 1638 | struct list_head settime; |
| 1639 | struct list_head vm_enough_memory; |
| 1640 | struct list_head bprm_set_creds; |
| 1641 | struct list_head bprm_check_security; |
| 1642 | struct list_head bprm_secureexec; |
| 1643 | struct list_head bprm_committing_creds; |
| 1644 | struct list_head bprm_committed_creds; |
| 1645 | struct list_head sb_alloc_security; |
| 1646 | struct list_head sb_free_security; |
| 1647 | struct list_head sb_copy_data; |
| 1648 | struct list_head sb_remount; |
| 1649 | struct list_head sb_kern_mount; |
| 1650 | struct list_head sb_show_options; |
| 1651 | struct list_head sb_statfs; |
| 1652 | struct list_head sb_mount; |
| 1653 | struct list_head sb_umount; |
| 1654 | struct list_head sb_pivotroot; |
| 1655 | struct list_head sb_set_mnt_opts; |
| 1656 | struct list_head sb_clone_mnt_opts; |
| 1657 | struct list_head sb_parse_opts_str; |
| 1658 | struct list_head dentry_init_security; |
| 1659 | #ifdef CONFIG_SECURITY_PATH |
| 1660 | struct list_head path_unlink; |
| 1661 | struct list_head path_mkdir; |
| 1662 | struct list_head path_rmdir; |
| 1663 | struct list_head path_mknod; |
| 1664 | struct list_head path_truncate; |
| 1665 | struct list_head path_symlink; |
| 1666 | struct list_head path_link; |
| 1667 | struct list_head path_rename; |
| 1668 | struct list_head path_chmod; |
| 1669 | struct list_head path_chown; |
| 1670 | struct list_head path_chroot; |
| 1671 | #endif |
| 1672 | struct list_head inode_alloc_security; |
| 1673 | struct list_head inode_free_security; |
| 1674 | struct list_head inode_init_security; |
| 1675 | struct list_head inode_create; |
| 1676 | struct list_head inode_link; |
| 1677 | struct list_head inode_unlink; |
| 1678 | struct list_head inode_symlink; |
| 1679 | struct list_head inode_mkdir; |
| 1680 | struct list_head inode_rmdir; |
| 1681 | struct list_head inode_mknod; |
| 1682 | struct list_head inode_rename; |
| 1683 | struct list_head inode_readlink; |
| 1684 | struct list_head inode_follow_link; |
| 1685 | struct list_head inode_permission; |
| 1686 | struct list_head inode_setattr; |
| 1687 | struct list_head inode_getattr; |
| 1688 | struct list_head inode_setxattr; |
| 1689 | struct list_head inode_post_setxattr; |
| 1690 | struct list_head inode_getxattr; |
| 1691 | struct list_head inode_listxattr; |
| 1692 | struct list_head inode_removexattr; |
| 1693 | struct list_head inode_need_killpriv; |
| 1694 | struct list_head inode_killpriv; |
| 1695 | struct list_head inode_getsecurity; |
| 1696 | struct list_head inode_setsecurity; |
| 1697 | struct list_head inode_listsecurity; |
| 1698 | struct list_head inode_getsecid; |
| 1699 | struct list_head file_permission; |
| 1700 | struct list_head file_alloc_security; |
| 1701 | struct list_head file_free_security; |
| 1702 | struct list_head file_ioctl; |
| 1703 | struct list_head mmap_addr; |
| 1704 | struct list_head mmap_file; |
| 1705 | struct list_head file_mprotect; |
| 1706 | struct list_head file_lock; |
| 1707 | struct list_head file_fcntl; |
| 1708 | struct list_head file_set_fowner; |
| 1709 | struct list_head file_send_sigiotask; |
| 1710 | struct list_head file_receive; |
| 1711 | struct list_head file_open; |
| 1712 | struct list_head task_create; |
| 1713 | struct list_head task_free; |
| 1714 | struct list_head cred_alloc_blank; |
| 1715 | struct list_head cred_free; |
| 1716 | struct list_head cred_prepare; |
| 1717 | struct list_head cred_transfer; |
| 1718 | struct list_head kernel_act_as; |
| 1719 | struct list_head kernel_create_files_as; |
Mimi Zohar | 39eeb4f | 2016-01-30 22:23:26 -0500 | [diff] [blame] | 1720 | struct list_head kernel_read_file; |
Mimi Zohar | b44a7df | 2015-12-28 16:02:29 -0500 | [diff] [blame] | 1721 | struct list_head kernel_post_read_file; |
Casey Schaufler | e20b043 | 2015-05-02 15:11:36 -0700 | [diff] [blame] | 1722 | struct list_head kernel_module_request; |
Casey Schaufler | e20b043 | 2015-05-02 15:11:36 -0700 | [diff] [blame] | 1723 | struct list_head task_fix_setuid; |
| 1724 | struct list_head task_setpgid; |
| 1725 | struct list_head task_getpgid; |
| 1726 | struct list_head task_getsid; |
| 1727 | struct list_head task_getsecid; |
| 1728 | struct list_head task_setnice; |
| 1729 | struct list_head task_setioprio; |
| 1730 | struct list_head task_getioprio; |
| 1731 | struct list_head task_setrlimit; |
| 1732 | struct list_head task_setscheduler; |
| 1733 | struct list_head task_getscheduler; |
| 1734 | struct list_head task_movememory; |
| 1735 | struct list_head task_kill; |
| 1736 | struct list_head task_wait; |
| 1737 | struct list_head task_prctl; |
| 1738 | struct list_head task_to_inode; |
| 1739 | struct list_head ipc_permission; |
| 1740 | struct list_head ipc_getsecid; |
| 1741 | struct list_head msg_msg_alloc_security; |
| 1742 | struct list_head msg_msg_free_security; |
| 1743 | struct list_head msg_queue_alloc_security; |
| 1744 | struct list_head msg_queue_free_security; |
| 1745 | struct list_head msg_queue_associate; |
| 1746 | struct list_head msg_queue_msgctl; |
| 1747 | struct list_head msg_queue_msgsnd; |
| 1748 | struct list_head msg_queue_msgrcv; |
| 1749 | struct list_head shm_alloc_security; |
| 1750 | struct list_head shm_free_security; |
| 1751 | struct list_head shm_associate; |
| 1752 | struct list_head shm_shmctl; |
| 1753 | struct list_head shm_shmat; |
| 1754 | struct list_head sem_alloc_security; |
| 1755 | struct list_head sem_free_security; |
| 1756 | struct list_head sem_associate; |
| 1757 | struct list_head sem_semctl; |
| 1758 | struct list_head sem_semop; |
| 1759 | struct list_head netlink_send; |
| 1760 | struct list_head d_instantiate; |
| 1761 | struct list_head getprocattr; |
| 1762 | struct list_head setprocattr; |
| 1763 | struct list_head ismaclabel; |
| 1764 | struct list_head secid_to_secctx; |
| 1765 | struct list_head secctx_to_secid; |
| 1766 | struct list_head release_secctx; |
Andreas Gruenbacher | 6f3be9f | 2015-12-24 11:09:40 -0500 | [diff] [blame] | 1767 | struct list_head inode_invalidate_secctx; |
Casey Schaufler | e20b043 | 2015-05-02 15:11:36 -0700 | [diff] [blame] | 1768 | struct list_head inode_notifysecctx; |
| 1769 | struct list_head inode_setsecctx; |
| 1770 | struct list_head inode_getsecctx; |
| 1771 | #ifdef CONFIG_SECURITY_NETWORK |
| 1772 | struct list_head unix_stream_connect; |
| 1773 | struct list_head unix_may_send; |
| 1774 | struct list_head socket_create; |
| 1775 | struct list_head socket_post_create; |
| 1776 | struct list_head socket_bind; |
| 1777 | struct list_head socket_connect; |
| 1778 | struct list_head socket_listen; |
| 1779 | struct list_head socket_accept; |
| 1780 | struct list_head socket_sendmsg; |
| 1781 | struct list_head socket_recvmsg; |
| 1782 | struct list_head socket_getsockname; |
| 1783 | struct list_head socket_getpeername; |
| 1784 | struct list_head socket_getsockopt; |
| 1785 | struct list_head socket_setsockopt; |
| 1786 | struct list_head socket_shutdown; |
| 1787 | struct list_head socket_sock_rcv_skb; |
| 1788 | struct list_head socket_getpeersec_stream; |
| 1789 | struct list_head socket_getpeersec_dgram; |
| 1790 | struct list_head sk_alloc_security; |
| 1791 | struct list_head sk_free_security; |
| 1792 | struct list_head sk_clone_security; |
| 1793 | struct list_head sk_getsecid; |
| 1794 | struct list_head sock_graft; |
| 1795 | struct list_head inet_conn_request; |
| 1796 | struct list_head inet_csk_clone; |
| 1797 | struct list_head inet_conn_established; |
| 1798 | struct list_head secmark_relabel_packet; |
| 1799 | struct list_head secmark_refcount_inc; |
| 1800 | struct list_head secmark_refcount_dec; |
| 1801 | struct list_head req_classify_flow; |
| 1802 | struct list_head tun_dev_alloc_security; |
| 1803 | struct list_head tun_dev_free_security; |
| 1804 | struct list_head tun_dev_create; |
| 1805 | struct list_head tun_dev_attach_queue; |
| 1806 | struct list_head tun_dev_attach; |
| 1807 | struct list_head tun_dev_open; |
Casey Schaufler | e20b043 | 2015-05-02 15:11:36 -0700 | [diff] [blame] | 1808 | #endif /* CONFIG_SECURITY_NETWORK */ |
| 1809 | #ifdef CONFIG_SECURITY_NETWORK_XFRM |
| 1810 | struct list_head xfrm_policy_alloc_security; |
| 1811 | struct list_head xfrm_policy_clone_security; |
| 1812 | struct list_head xfrm_policy_free_security; |
| 1813 | struct list_head xfrm_policy_delete_security; |
| 1814 | struct list_head xfrm_state_alloc; |
| 1815 | struct list_head xfrm_state_alloc_acquire; |
| 1816 | struct list_head xfrm_state_free_security; |
| 1817 | struct list_head xfrm_state_delete_security; |
| 1818 | struct list_head xfrm_policy_lookup; |
| 1819 | struct list_head xfrm_state_pol_flow_match; |
| 1820 | struct list_head xfrm_decode_session; |
| 1821 | #endif /* CONFIG_SECURITY_NETWORK_XFRM */ |
| 1822 | #ifdef CONFIG_KEYS |
| 1823 | struct list_head key_alloc; |
| 1824 | struct list_head key_free; |
| 1825 | struct list_head key_permission; |
| 1826 | struct list_head key_getsecurity; |
| 1827 | #endif /* CONFIG_KEYS */ |
| 1828 | #ifdef CONFIG_AUDIT |
| 1829 | struct list_head audit_rule_init; |
| 1830 | struct list_head audit_rule_known; |
| 1831 | struct list_head audit_rule_match; |
| 1832 | struct list_head audit_rule_free; |
| 1833 | #endif /* CONFIG_AUDIT */ |
| 1834 | }; |
| 1835 | |
| 1836 | /* |
Casey Schaufler | b1d9e6b | 2015-05-02 15:11:42 -0700 | [diff] [blame] | 1837 | * Security module hook list structure. |
| 1838 | * For use with generic list macros for common operations. |
| 1839 | */ |
| 1840 | struct security_hook_list { |
| 1841 | struct list_head list; |
| 1842 | struct list_head *head; |
| 1843 | union security_list_options hook; |
| 1844 | }; |
| 1845 | |
| 1846 | /* |
Casey Schaufler | e20b043 | 2015-05-02 15:11:36 -0700 | [diff] [blame] | 1847 | * Initializing a security_hook_list structure takes |
| 1848 | * up a lot of space in a source file. This macro takes |
| 1849 | * care of the common case and reduces the amount of |
| 1850 | * text involved. |
Casey Schaufler | e20b043 | 2015-05-02 15:11:36 -0700 | [diff] [blame] | 1851 | */ |
Casey Schaufler | b1d9e6b | 2015-05-02 15:11:42 -0700 | [diff] [blame] | 1852 | #define LSM_HOOK_INIT(HEAD, HOOK) \ |
| 1853 | { .head = &security_hook_heads.HEAD, .hook = { .HEAD = HOOK } } |
Casey Schaufler | e20b043 | 2015-05-02 15:11:36 -0700 | [diff] [blame] | 1854 | |
Casey Schaufler | b1d9e6b | 2015-05-02 15:11:42 -0700 | [diff] [blame] | 1855 | extern struct security_hook_heads security_hook_heads; |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1856 | |
Casey Schaufler | b1d9e6b | 2015-05-02 15:11:42 -0700 | [diff] [blame] | 1857 | static inline void security_add_hooks(struct security_hook_list *hooks, |
| 1858 | int count) |
| 1859 | { |
| 1860 | int i; |
| 1861 | |
| 1862 | for (i = 0; i < count; i++) |
| 1863 | list_add_tail_rcu(&hooks[i].list, hooks[i].head); |
| 1864 | } |
| 1865 | |
| 1866 | #ifdef CONFIG_SECURITY_SELINUX_DISABLE |
| 1867 | /* |
| 1868 | * Assuring the safety of deleting a security module is up to |
| 1869 | * the security module involved. This may entail ordering the |
| 1870 | * module's hook list in a particular way, refusing to disable |
| 1871 | * the module once a policy is loaded or any number of other |
| 1872 | * actions better imagined than described. |
| 1873 | * |
| 1874 | * The name of the configuration option reflects the only module |
| 1875 | * that currently uses the mechanism. Any developer who thinks |
| 1876 | * disabling their module is a good idea needs to be at least as |
| 1877 | * careful as the SELinux team. |
| 1878 | */ |
| 1879 | static inline void security_delete_hooks(struct security_hook_list *hooks, |
| 1880 | int count) |
| 1881 | { |
| 1882 | int i; |
| 1883 | |
| 1884 | for (i = 0; i < count; i++) |
| 1885 | list_del_rcu(&hooks[i].list); |
| 1886 | } |
| 1887 | #endif /* CONFIG_SECURITY_SELINUX_DISABLE */ |
| 1888 | |
| 1889 | extern int __init security_module_enable(const char *module); |
| 1890 | extern void __init capability_add_hooks(void); |
Kees Cook | 730daa1 | 2015-07-23 18:02:48 -0700 | [diff] [blame] | 1891 | #ifdef CONFIG_SECURITY_YAMA |
| 1892 | extern void __init yama_add_hooks(void); |
| 1893 | #else |
| 1894 | static inline void __init yama_add_hooks(void) { } |
Casey Schaufler | b1d9e6b | 2015-05-02 15:11:42 -0700 | [diff] [blame] | 1895 | #endif |
Kees Cook | 9b09155 | 2016-04-20 15:46:28 -0700 | [diff] [blame] | 1896 | #ifdef CONFIG_SECURITY_LOADPIN |
| 1897 | void __init loadpin_add_hooks(void); |
| 1898 | #else |
| 1899 | static inline void loadpin_add_hooks(void) { }; |
| 1900 | #endif |
Casey Schaufler | 3c4ed7b | 2015-05-02 15:10:46 -0700 | [diff] [blame] | 1901 | |
| 1902 | #endif /* ! __LINUX_LSM_HOOKS_H */ |