1 /* 2 * Linux Security plug 3 * 4 * Copyright (C) 2001 WireX Communications, Inc <[email protected]> 5 * Copyright (C) 2001 Greg Kroah-Hartman <[email protected]> 6 * Copyright (C) 2001 Networks Associates Technology, Inc <[email protected]> 7 * Copyright (C) 2001 James Morris <[email protected]> 8 * Copyright (C) 2001 Silicon Graphics, Inc. (Trust Technology Group) 9 * 10 * This program is free software; you can redistribute it and/or modify 11 * it under the terms of the GNU General Public License as published by 12 * the Free Software Foundation; either version 2 of the License, or 13 * (at your option) any later version. 14 * 15 * Due to this file being licensed under the GPL there is controversy over 16 * whether this permits you to write a module that #includes this file 17 * without placing your module under the GPL. Please consult a lawyer for 18 * advice before doing this. 19 * 20 */ 21 22 #ifndef __LINUX_SECURITY_H 23 #define __LINUX_SECURITY_H 24 25 #include <linux/key.h> 26 #include <linux/capability.h> 27 #include <linux/slab.h> 28 #include <linux/err.h> 29 30 struct linux_binprm; 31 struct cred; 32 struct rlimit; 33 struct siginfo; 34 struct sem_array; 35 struct sembuf; 36 struct kern_ipc_perm; 37 struct audit_context; 38 struct super_block; 39 struct inode; 40 struct dentry; 41 struct file; 42 struct vfsmount; 43 struct path; 44 struct qstr; 45 struct nameidata; 46 struct iattr; 47 struct fown_struct; 48 struct file_operations; 49 struct shmid_kernel; 50 struct msg_msg; 51 struct msg_queue; 52 struct xattr; 53 struct xfrm_sec_ctx; 54 struct mm_struct; 55 56 /* Maximum number of letters for an LSM name string */ 57 #define SECURITY_NAME_MAX 10 58 59 /* If capable should audit the security request */ 60 #define SECURITY_CAP_NOAUDIT 0 61 #define SECURITY_CAP_AUDIT 1 62 63 struct ctl_table; 64 struct audit_krule; 65 struct user_namespace; 66 struct timezone; 67 68 /* 69 * These functions are in security/capability.c and are used 70 * as the default capabilities functions 71 */ 72 extern int cap_capable(const struct cred *cred, struct user_namespace *ns, 73 int cap, int audit); 74 extern int cap_settime(const struct timespec *ts, const struct timezone *tz); 75 extern int cap_ptrace_access_check(struct task_struct *child, unsigned int mode); 76 extern int cap_ptrace_traceme(struct task_struct *parent); 77 extern int cap_capget(struct task_struct *target, kernel_cap_t *effective, kernel_cap_t *inheritable, kernel_cap_t *permitted); 78 extern int cap_capset(struct cred *new, const struct cred *old, 79 const kernel_cap_t *effective, 80 const kernel_cap_t *inheritable, 81 const kernel_cap_t *permitted); 82 extern int cap_bprm_set_creds(struct linux_binprm *bprm); 83 extern int cap_bprm_secureexec(struct linux_binprm *bprm); 84 extern int cap_inode_setxattr(struct dentry *dentry, const char *name, 85 const void *value, size_t size, int flags); 86 extern int cap_inode_removexattr(struct dentry *dentry, const char *name); 87 extern int cap_inode_need_killpriv(struct dentry *dentry); 88 extern int cap_inode_killpriv(struct dentry *dentry); 89 extern int cap_file_mmap(struct file *file, unsigned long reqprot, 90 unsigned long prot, unsigned long flags, 91 unsigned long addr, unsigned long addr_only); 92 extern int cap_task_fix_setuid(struct cred *new, const struct cred *old, int flags); 93 extern int cap_task_prctl(int option, unsigned long arg2, unsigned long arg3, 94 unsigned long arg4, unsigned long arg5); 95 extern int cap_task_setscheduler(struct task_struct *p); 96 extern int cap_task_setioprio(struct task_struct *p, int ioprio); 97 extern int cap_task_setnice(struct task_struct *p, int nice); 98 extern int cap_vm_enough_memory(struct mm_struct *mm, long pages); 99 100 struct msghdr; 101 struct sk_buff; 102 struct sock; 103 struct sockaddr; 104 struct socket; 105 struct flowi; 106 struct dst_entry; 107 struct xfrm_selector; 108 struct xfrm_policy; 109 struct xfrm_state; 110 struct xfrm_user_sec_ctx; 111 struct seq_file; 112 113 extern int cap_netlink_send(struct sock *sk, struct sk_buff *skb); 114 115 void reset_security_ops(void); 116 117 #ifdef CONFIG_MMU 118 extern unsigned long mmap_min_addr; 119 extern unsigned long dac_mmap_min_addr; 120 #else 121 #define dac_mmap_min_addr 0UL 122 #endif 123 124 /* 125 * Values used in the task_security_ops calls 126 */ 127 /* setuid or setgid, id0 == uid or gid */ 128 #define LSM_SETID_ID 1 129 130 /* setreuid or setregid, id0 == real, id1 == eff */ 131 #define LSM_SETID_RE 2 132 133 /* setresuid or setresgid, id0 == real, id1 == eff, uid2 == saved */ 134 #define LSM_SETID_RES 4 135 136 /* setfsuid or setfsgid, id0 == fsuid or fsgid */ 137 #define LSM_SETID_FS 8 138 139 /* forward declares to avoid warnings */ 140 struct sched_param; 141 struct request_sock; 142 143 /* bprm->unsafe reasons */ 144 #define LSM_UNSAFE_SHARE 1 145 #define LSM_UNSAFE_PTRACE 2 146 #define LSM_UNSAFE_PTRACE_CAP 4 147 #define LSM_UNSAFE_NO_NEW_PRIVS 8 148 149 #ifdef CONFIG_MMU 150 extern int mmap_min_addr_handler(struct ctl_table *table, int write, 151 void __user *buffer, size_t *lenp, loff_t *ppos); 152 #endif 153 154 /* security_inode_init_security callback function to write xattrs */ 155 typedef int (*initxattrs) (struct inode *inode, 156 const struct xattr *xattr_array, void *fs_data); 157 158 #ifdef CONFIG_SECURITY 159 160 struct security_mnt_opts { 161 char **mnt_opts; 162 int *mnt_opts_flags; 163 int num_mnt_opts; 164 }; 165 166 static inline void security_init_mnt_opts(struct security_mnt_opts *opts) 167 { 168 opts->mnt_opts = NULL; 169 opts->mnt_opts_flags = NULL; 170 opts->num_mnt_opts = 0; 171 } 172 173 static inline void security_free_mnt_opts(struct security_mnt_opts *opts) 174 { 175 int i; 176 if (opts->mnt_opts) 177 for (i = 0; i < opts->num_mnt_opts; i++) 178 kfree(opts->mnt_opts[i]); 179 kfree(opts->mnt_opts); 180 opts->mnt_opts = NULL; 181 kfree(opts->mnt_opts_flags); 182 opts->mnt_opts_flags = NULL; 183 opts->num_mnt_opts = 0; 184 } 185 186 /** 187 * struct security_operations - main security structure 188 * 189 * Security module identifier. 190 * 191 * @name: 192 * A string that acts as a unique identifier for the LSM with max number 193 * of characters = SECURITY_NAME_MAX. 194 * 195 * Security hooks for program execution operations. 196 * 197 * @bprm_set_creds: 198 * Save security information in the bprm->security field, typically based 199 * on information about the bprm->file, for later use by the apply_creds 200 * hook. This hook may also optionally check permissions (e.g. for 201 * transitions between security domains). 202 * This hook may be called multiple times during a single execve, e.g. for 203 * interpreters. The hook can tell whether it has already been called by 204 * checking to see if @bprm->security is non-NULL. If so, then the hook 205 * may decide either to retain the security information saved earlier or 206 * to replace it. 207 * @bprm contains the linux_binprm structure. 208 * Return 0 if the hook is successful and permission is granted. 209 * @bprm_check_security: 210 * This hook mediates the point when a search for a binary handler will 211 * begin. It allows a check the @bprm->security value which is set in the 212 * preceding set_creds call. The primary difference from set_creds is 213 * that the argv list and envp list are reliably available in @bprm. This 214 * hook may be called multiple times during a single execve; and in each 215 * pass set_creds is called first. 216 * @bprm contains the linux_binprm structure. 217 * Return 0 if the hook is successful and permission is granted. 218 * @bprm_committing_creds: 219 * Prepare to install the new security attributes of a process being 220 * transformed by an execve operation, based on the old credentials 221 * pointed to by @current->cred and the information set in @bprm->cred by 222 * the bprm_set_creds hook. @bprm points to the linux_binprm structure. 223 * This hook is a good place to perform state changes on the process such 224 * as closing open file descriptors to which access will no longer be 225 * granted when the attributes are changed. This is called immediately 226 * before commit_creds(). 227 * @bprm_committed_creds: 228 * Tidy up after the installation of the new security attributes of a 229 * process being transformed by an execve operation. The new credentials 230 * have, by this point, been set to @current->cred. @bprm points to the 231 * linux_binprm structure. This hook is a good place to perform state 232 * changes on the process such as clearing out non-inheritable signal 233 * state. This is called immediately after commit_creds(). 234 * @bprm_secureexec: 235 * Return a boolean value (0 or 1) indicating whether a "secure exec" 236 * is required. The flag is passed in the auxiliary table 237 * on the initial stack to the ELF interpreter to indicate whether libc 238 * should enable secure mode. 239 * @bprm contains the linux_binprm structure. 240 * 241 * Security hooks for filesystem operations. 242 * 243 * @sb_alloc_security: 244 * Allocate and attach a security structure to the sb->s_security field. 245 * The s_security field is initialized to NULL when the structure is 246 * allocated. 247 * @sb contains the super_block structure to be modified. 248 * Return 0 if operation was successful. 249 * @sb_free_security: 250 * Deallocate and clear the sb->s_security field. 251 * @sb contains the super_block structure to be modified. 252 * @sb_statfs: 253 * Check permission before obtaining filesystem statistics for the @mnt 254 * mountpoint. 255 * @dentry is a handle on the superblock for the filesystem. 256 * Return 0 if permission is granted. 257 * @sb_mount: 258 * Check permission before an object specified by @dev_name is mounted on 259 * the mount point named by @nd. For an ordinary mount, @dev_name 260 * identifies a device if the file system type requires a device. For a 261 * remount (@flags & MS_REMOUNT), @dev_name is irrelevant. For a 262 * loopback/bind mount (@flags & MS_BIND), @dev_name identifies the 263 * pathname of the object being mounted. 264 * @dev_name contains the name for object being mounted. 265 * @path contains the path for mount point object. 266 * @type contains the filesystem type. 267 * @flags contains the mount flags. 268 * @data contains the filesystem-specific data. 269 * Return 0 if permission is granted. 270 * @sb_copy_data: 271 * Allow mount option data to be copied prior to parsing by the filesystem, 272 * so that the security module can extract security-specific mount 273 * options cleanly (a filesystem may modify the data e.g. with strsep()). 274 * This also allows the original mount data to be stripped of security- 275 * specific options to avoid having to make filesystems aware of them. 276 * @type the type of filesystem being mounted. 277 * @orig the original mount data copied from userspace. 278 * @copy copied data which will be passed to the security module. 279 * Returns 0 if the copy was successful. 280 * @sb_remount: 281 * Extracts security system specific mount options and verifies no changes 282 * are being made to those options. 283 * @sb superblock being remounted 284 * @data contains the filesystem-specific data. 285 * Return 0 if permission is granted. 286 * @sb_umount: 287 * Check permission before the @mnt file system is unmounted. 288 * @mnt contains the mounted file system. 289 * @flags contains the unmount flags, e.g. MNT_FORCE. 290 * Return 0 if permission is granted. 291 * @sb_pivotroot: 292 * Check permission before pivoting the root filesystem. 293 * @old_path contains the path for the new location of the current root (put_old). 294 * @new_path contains the path for the new root (new_root). 295 * Return 0 if permission is granted. 296 * @sb_set_mnt_opts: 297 * Set the security relevant mount options used for a superblock 298 * @sb the superblock to set security mount options for 299 * @opts binary data structure containing all lsm mount data 300 * @sb_clone_mnt_opts: 301 * Copy all security options from a given superblock to another 302 * @oldsb old superblock which contain information to clone 303 * @newsb new superblock which needs filled in 304 * @sb_parse_opts_str: 305 * Parse a string of security data filling in the opts structure 306 * @options string containing all mount options known by the LSM 307 * @opts binary data structure usable by the LSM 308 * 309 * Security hooks for inode operations. 310 * 311 * @inode_alloc_security: 312 * Allocate and attach a security structure to @inode->i_security. The 313 * i_security field is initialized to NULL when the inode structure is 314 * allocated. 315 * @inode contains the inode structure. 316 * Return 0 if operation was successful. 317 * @inode_free_security: 318 * @inode contains the inode structure. 319 * Deallocate the inode security structure and set @inode->i_security to 320 * NULL. 321 * @inode_init_security: 322 * Obtain the security attribute name suffix and value to set on a newly 323 * created inode and set up the incore security field for the new inode. 324 * This hook is called by the fs code as part of the inode creation 325 * transaction and provides for atomic labeling of the inode, unlike 326 * the post_create/mkdir/... hooks called by the VFS. The hook function 327 * is expected to allocate the name and value via kmalloc, with the caller 328 * being responsible for calling kfree after using them. 329 * If the security module does not use security attributes or does 330 * not wish to put a security attribute on this particular inode, 331 * then it should return -EOPNOTSUPP to skip this processing. 332 * @inode contains the inode structure of the newly created inode. 333 * @dir contains the inode structure of the parent directory. 334 * @qstr contains the last path component of the new object 335 * @name will be set to the allocated name suffix (e.g. selinux). 336 * @value will be set to the allocated attribute value. 337 * @len will be set to the length of the value. 338 * Returns 0 if @name and @value have been successfully set, 339 * -EOPNOTSUPP if no security attribute is needed, or 340 * -ENOMEM on memory allocation failure. 341 * @inode_create: 342 * Check permission to create a regular file. 343 * @dir contains inode structure of the parent of the new file. 344 * @dentry contains the dentry structure for the file to be created. 345 * @mode contains the file mode of the file to be created. 346 * Return 0 if permission is granted. 347 * @inode_link: 348 * Check permission before creating a new hard link to a file. 349 * @old_dentry contains the dentry structure for an existing link to the file. 350 * @dir contains the inode structure of the parent directory of the new link. 351 * @new_dentry contains the dentry structure for the new link. 352 * Return 0 if permission is granted. 353 * @path_link: 354 * Check permission before creating a new hard link to a file. 355 * @old_dentry contains the dentry structure for an existing link 356 * to the file. 357 * @new_dir contains the path structure of the parent directory of 358 * the new link. 359 * @new_dentry contains the dentry structure for the new link. 360 * Return 0 if permission is granted. 361 * @inode_unlink: 362 * Check the permission to remove a hard link to a file. 363 * @dir contains the inode structure of parent directory of the file. 364 * @dentry contains the dentry structure for file to be unlinked. 365 * Return 0 if permission is granted. 366 * @path_unlink: 367 * Check the permission to remove a hard link to a file. 368 * @dir contains the path structure of parent directory of the file. 369 * @dentry contains the dentry structure for file to be unlinked. 370 * Return 0 if permission is granted. 371 * @inode_symlink: 372 * Check the permission to create a symbolic link to a file. 373 * @dir contains the inode structure of parent directory of the symbolic link. 374 * @dentry contains the dentry structure of the symbolic link. 375 * @old_name contains the pathname of file. 376 * Return 0 if permission is granted. 377 * @path_symlink: 378 * Check the permission to create a symbolic link to a file. 379 * @dir contains the path structure of parent directory of 380 * the symbolic link. 381 * @dentry contains the dentry structure of the symbolic link. 382 * @old_name contains the pathname of file. 383 * Return 0 if permission is granted. 384 * @inode_mkdir: 385 * Check permissions to create a new directory in the existing directory 386 * associated with inode structure @dir. 387 * @dir contains the inode structure of parent of the directory to be created. 388 * @dentry contains the dentry structure of new directory. 389 * @mode contains the mode of new directory. 390 * Return 0 if permission is granted. 391 * @path_mkdir: 392 * Check permissions to create a new directory in the existing directory 393 * associated with path structure @path. 394 * @dir contains the path structure of parent of the directory 395 * to be created. 396 * @dentry contains the dentry structure of new directory. 397 * @mode contains the mode of new directory. 398 * Return 0 if permission is granted. 399 * @inode_rmdir: 400 * Check the permission to remove a directory. 401 * @dir contains the inode structure of parent of the directory to be removed. 402 * @dentry contains the dentry structure of directory to be removed. 403 * Return 0 if permission is granted. 404 * @path_rmdir: 405 * Check the permission to remove a directory. 406 * @dir contains the path structure of parent of the directory to be 407 * removed. 408 * @dentry contains the dentry structure of directory to be removed. 409 * Return 0 if permission is granted. 410 * @inode_mknod: 411 * Check permissions when creating a special file (or a socket or a fifo 412 * file created via the mknod system call). Note that if mknod operation 413 * is being done for a regular file, then the create hook will be called 414 * and not this hook. 415 * @dir contains the inode structure of parent of the new file. 416 * @dentry contains the dentry structure of the new file. 417 * @mode contains the mode of the new file. 418 * @dev contains the device number. 419 * Return 0 if permission is granted. 420 * @path_mknod: 421 * Check permissions when creating a file. Note that this hook is called 422 * even if mknod operation is being done for a regular file. 423 * @dir contains the path structure of parent of the new file. 424 * @dentry contains the dentry structure of the new file. 425 * @mode contains the mode of the new file. 426 * @dev contains the undecoded device number. Use new_decode_dev() to get 427 * the decoded device number. 428 * Return 0 if permission is granted. 429 * @inode_rename: 430 * Check for permission to rename a file or directory. 431 * @old_dir contains the inode structure for parent of the old link. 432 * @old_dentry contains the dentry structure of the old link. 433 * @new_dir contains the inode structure for parent of the new link. 434 * @new_dentry contains the dentry structure of the new link. 435 * Return 0 if permission is granted. 436 * @path_rename: 437 * Check for permission to rename a file or directory. 438 * @old_dir contains the path structure for parent of the old link. 439 * @old_dentry contains the dentry structure of the old link. 440 * @new_dir contains the path structure for parent of the new link. 441 * @new_dentry contains the dentry structure of the new link. 442 * Return 0 if permission is granted. 443 * @path_chmod: 444 * Check for permission to change DAC's permission of a file or directory. 445 * @dentry contains the dentry structure. 446 * @mnt contains the vfsmnt structure. 447 * @mode contains DAC's mode. 448 * Return 0 if permission is granted. 449 * @path_chown: 450 * Check for permission to change owner/group of a file or directory. 451 * @path contains the path structure. 452 * @uid contains new owner's ID. 453 * @gid contains new group's ID. 454 * Return 0 if permission is granted. 455 * @path_chroot: 456 * Check for permission to change root directory. 457 * @path contains the path structure. 458 * Return 0 if permission is granted. 459 * @inode_readlink: 460 * Check the permission to read the symbolic link. 461 * @dentry contains the dentry structure for the file link. 462 * Return 0 if permission is granted. 463 * @inode_follow_link: 464 * Check permission to follow a symbolic link when looking up a pathname. 465 * @dentry contains the dentry structure for the link. 466 * @nd contains the nameidata structure for the parent directory. 467 * Return 0 if permission is granted. 468 * @inode_permission: 469 * Check permission before accessing an inode. This hook is called by the 470 * existing Linux permission function, so a security module can use it to 471 * provide additional checking for existing Linux permission checks. 472 * Notice that this hook is called when a file is opened (as well as many 473 * other operations), whereas the file_security_ops permission hook is 474 * called when the actual read/write operations are performed. 475 * @inode contains the inode structure to check. 476 * @mask contains the permission mask. 477 * Return 0 if permission is granted. 478 * @inode_setattr: 479 * Check permission before setting file attributes. Note that the kernel 480 * call to notify_change is performed from several locations, whenever 481 * file attributes change (such as when a file is truncated, chown/chmod 482 * operations, transferring disk quotas, etc). 483 * @dentry contains the dentry structure for the file. 484 * @attr is the iattr structure containing the new file attributes. 485 * Return 0 if permission is granted. 486 * @path_truncate: 487 * Check permission before truncating a file. 488 * @path contains the path structure for the file. 489 * Return 0 if permission is granted. 490 * @inode_getattr: 491 * Check permission before obtaining file attributes. 492 * @mnt is the vfsmount where the dentry was looked up 493 * @dentry contains the dentry structure for the file. 494 * Return 0 if permission is granted. 495 * @inode_setxattr: 496 * Check permission before setting the extended attributes 497 * @value identified by @name for @dentry. 498 * Return 0 if permission is granted. 499 * @inode_post_setxattr: 500 * Update inode security field after successful setxattr operation. 501 * @value identified by @name for @dentry. 502 * @inode_getxattr: 503 * Check permission before obtaining the extended attributes 504 * identified by @name for @dentry. 505 * Return 0 if permission is granted. 506 * @inode_listxattr: 507 * Check permission before obtaining the list of extended attribute 508 * names for @dentry. 509 * Return 0 if permission is granted. 510 * @inode_removexattr: 511 * Check permission before removing the extended attribute 512 * identified by @name for @dentry. 513 * Return 0 if permission is granted. 514 * @inode_getsecurity: 515 * Retrieve a copy of the extended attribute representation of the 516 * security label associated with @name for @inode via @buffer. Note that 517 * @name is the remainder of the attribute name after the security prefix 518 * has been removed. @alloc is used to specify of the call should return a 519 * value via the buffer or just the value length Return size of buffer on 520 * success. 521 * @inode_setsecurity: 522 * Set the security label associated with @name for @inode from the 523 * extended attribute value @value. @size indicates the size of the 524 * @value in bytes. @flags may be XATTR_CREATE, XATTR_REPLACE, or 0. 525 * Note that @name is the remainder of the attribute name after the 526 * security. prefix has been removed. 527 * Return 0 on success. 528 * @inode_listsecurity: 529 * Copy the extended attribute names for the security labels 530 * associated with @inode into @buffer. The maximum size of @buffer 531 * is specified by @buffer_size. @buffer may be NULL to request 532 * the size of the buffer required. 533 * Returns number of bytes used/required on success. 534 * @inode_need_killpriv: 535 * Called when an inode has been changed. 536 * @dentry is the dentry being changed. 537 * Return <0 on error to abort the inode change operation. 538 * Return 0 if inode_killpriv does not need to be called. 539 * Return >0 if inode_killpriv does need to be called. 540 * @inode_killpriv: 541 * The setuid bit is being removed. Remove similar security labels. 542 * Called with the dentry->d_inode->i_mutex held. 543 * @dentry is the dentry being changed. 544 * Return 0 on success. If error is returned, then the operation 545 * causing setuid bit removal is failed. 546 * @inode_getsecid: 547 * Get the secid associated with the node. 548 * @inode contains a pointer to the inode. 549 * @secid contains a pointer to the location where result will be saved. 550 * In case of failure, @secid will be set to zero. 551 * 552 * Security hooks for file operations 553 * 554 * @file_permission: 555 * Check file permissions before accessing an open file. This hook is 556 * called by various operations that read or write files. A security 557 * module can use this hook to perform additional checking on these 558 * operations, e.g. to revalidate permissions on use to support privilege 559 * bracketing or policy changes. Notice that this hook is used when the 560 * actual read/write operations are performed, whereas the 561 * inode_security_ops hook is called when a file is opened (as well as 562 * many other operations). 563 * Caveat: Although this hook can be used to revalidate permissions for 564 * various system call operations that read or write files, it does not 565 * address the revalidation of permissions for memory-mapped files. 566 * Security modules must handle this separately if they need such 567 * revalidation. 568 * @file contains the file structure being accessed. 569 * @mask contains the requested permissions. 570 * Return 0 if permission is granted. 571 * @file_alloc_security: 572 * Allocate and attach a security structure to the file->f_security field. 573 * The security field is initialized to NULL when the structure is first 574 * created. 575 * @file contains the file structure to secure. 576 * Return 0 if the hook is successful and permission is granted. 577 * @file_free_security: 578 * Deallocate and free any security structures stored in file->f_security. 579 * @file contains the file structure being modified. 580 * @file_ioctl: 581 * @file contains the file structure. 582 * @cmd contains the operation to perform. 583 * @arg contains the operational arguments. 584 * Check permission for an ioctl operation on @file. Note that @arg 585 * sometimes represents a user space pointer; in other cases, it may be a 586 * simple integer value. When @arg represents a user space pointer, it 587 * should never be used by the security module. 588 * Return 0 if permission is granted. 589 * @file_mmap : 590 * Check permissions for a mmap operation. The @file may be NULL, e.g. 591 * if mapping anonymous memory. 592 * @file contains the file structure for file to map (may be NULL). 593 * @reqprot contains the protection requested by the application. 594 * @prot contains the protection that will be applied by the kernel. 595 * @flags contains the operational flags. 596 * @addr contains virtual address that will be used for the operation. 597 * @addr_only contains a boolean: 0 if file-backed VMA, otherwise 1. 598 * Return 0 if permission is granted. 599 * @file_mprotect: 600 * Check permissions before changing memory access permissions. 601 * @vma contains the memory region to modify. 602 * @reqprot contains the protection requested by the application. 603 * @prot contains the protection that will be applied by the kernel. 604 * Return 0 if permission is granted. 605 * @file_lock: 606 * Check permission before performing file locking operations. 607 * Note: this hook mediates both flock and fcntl style locks. 608 * @file contains the file structure. 609 * @cmd contains the posix-translated lock operation to perform 610 * (e.g. F_RDLCK, F_WRLCK). 611 * Return 0 if permission is granted. 612 * @file_fcntl: 613 * Check permission before allowing the file operation specified by @cmd 614 * from being performed on the file @file. Note that @arg sometimes 615 * represents a user space pointer; in other cases, it may be a simple 616 * integer value. When @arg represents a user space pointer, it should 617 * never be used by the security module. 618 * @file contains the file structure. 619 * @cmd contains the operation to be performed. 620 * @arg contains the operational arguments. 621 * Return 0 if permission is granted. 622 * @file_set_fowner: 623 * Save owner security information (typically from current->security) in 624 * file->f_security for later use by the send_sigiotask hook. 625 * @file contains the file structure to update. 626 * Return 0 on success. 627 * @file_send_sigiotask: 628 * Check permission for the file owner @fown to send SIGIO or SIGURG to the 629 * process @tsk. Note that this hook is sometimes called from interrupt. 630 * Note that the fown_struct, @fown, is never outside the context of a 631 * struct file, so the file structure (and associated security information) 632 * can always be obtained: 633 * container_of(fown, struct file, f_owner) 634 * @tsk contains the structure of task receiving signal. 635 * @fown contains the file owner information. 636 * @sig is the signal that will be sent. When 0, kernel sends SIGIO. 637 * Return 0 if permission is granted. 638 * @file_receive: 639 * This hook allows security modules to control the ability of a process 640 * to receive an open file descriptor via socket IPC. 641 * @file contains the file structure being received. 642 * Return 0 if permission is granted. 643 * @file_open 644 * Save open-time permission checking state for later use upon 645 * file_permission, and recheck access if anything has changed 646 * since inode_permission. 647 * 648 * Security hooks for task operations. 649 * 650 * @task_create: 651 * Check permission before creating a child process. See the clone(2) 652 * manual page for definitions of the @clone_flags. 653 * @clone_flags contains the flags indicating what should be shared. 654 * Return 0 if permission is granted. 655 * @task_free: 656 * @task task being freed 657 * Handle release of task-related resources. (Note that this can be called 658 * from interrupt context.) 659 * @cred_alloc_blank: 660 * @cred points to the credentials. 661 * @gfp indicates the atomicity of any memory allocations. 662 * Only allocate sufficient memory and attach to @cred such that 663 * cred_transfer() will not get ENOMEM. 664 * @cred_free: 665 * @cred points to the credentials. 666 * Deallocate and clear the cred->security field in a set of credentials. 667 * @cred_prepare: 668 * @new points to the new credentials. 669 * @old points to the original credentials. 670 * @gfp indicates the atomicity of any memory allocations. 671 * Prepare a new set of credentials by copying the data from the old set. 672 * @cred_transfer: 673 * @new points to the new credentials. 674 * @old points to the original credentials. 675 * Transfer data from original creds to new creds 676 * @kernel_act_as: 677 * Set the credentials for a kernel service to act as (subjective context). 678 * @new points to the credentials to be modified. 679 * @secid specifies the security ID to be set 680 * The current task must be the one that nominated @secid. 681 * Return 0 if successful. 682 * @kernel_create_files_as: 683 * Set the file creation context in a set of credentials to be the same as 684 * the objective context of the specified inode. 685 * @new points to the credentials to be modified. 686 * @inode points to the inode to use as a reference. 687 * The current task must be the one that nominated @inode. 688 * Return 0 if successful. 689 * @kernel_module_request: 690 * Ability to trigger the kernel to automatically upcall to userspace for 691 * userspace to load a kernel module with the given name. 692 * @kmod_name name of the module requested by the kernel 693 * Return 0 if successful. 694 * @task_fix_setuid: 695 * Update the module's state after setting one or more of the user 696 * identity attributes of the current process. The @flags parameter 697 * indicates which of the set*uid system calls invoked this hook. If 698 * @new is the set of credentials that will be installed. Modifications 699 * should be made to this rather than to @current->cred. 700 * @old is the set of credentials that are being replaces 701 * @flags contains one of the LSM_SETID_* values. 702 * Return 0 on success. 703 * @task_setpgid: 704 * Check permission before setting the process group identifier of the 705 * process @p to @pgid. 706 * @p contains the task_struct for process being modified. 707 * @pgid contains the new pgid. 708 * Return 0 if permission is granted. 709 * @task_getpgid: 710 * Check permission before getting the process group identifier of the 711 * process @p. 712 * @p contains the task_struct for the process. 713 * Return 0 if permission is granted. 714 * @task_getsid: 715 * Check permission before getting the session identifier of the process 716 * @p. 717 * @p contains the task_struct for the process. 718 * Return 0 if permission is granted. 719 * @task_getsecid: 720 * Retrieve the security identifier of the process @p. 721 * @p contains the task_struct for the process and place is into @secid. 722 * In case of failure, @secid will be set to zero. 723 * 724 * @task_setnice: 725 * Check permission before setting the nice value of @p to @nice. 726 * @p contains the task_struct of process. 727 * @nice contains the new nice value. 728 * Return 0 if permission is granted. 729 * @task_setioprio 730 * Check permission before setting the ioprio value of @p to @ioprio. 731 * @p contains the task_struct of process. 732 * @ioprio contains the new ioprio value 733 * Return 0 if permission is granted. 734 * @task_getioprio 735 * Check permission before getting the ioprio value of @p. 736 * @p contains the task_struct of process. 737 * Return 0 if permission is granted. 738 * @task_setrlimit: 739 * Check permission before setting the resource limits of the current 740 * process for @resource to @new_rlim. The old resource limit values can 741 * be examined by dereferencing (current->signal->rlim + resource). 742 * @resource contains the resource whose limit is being set. 743 * @new_rlim contains the new limits for @resource. 744 * Return 0 if permission is granted. 745 * @task_setscheduler: 746 * Check permission before setting scheduling policy and/or parameters of 747 * process @p based on @policy and @lp. 748 * @p contains the task_struct for process. 749 * @policy contains the scheduling policy. 750 * @lp contains the scheduling parameters. 751 * Return 0 if permission is granted. 752 * @task_getscheduler: 753 * Check permission before obtaining scheduling information for process 754 * @p. 755 * @p contains the task_struct for process. 756 * Return 0 if permission is granted. 757 * @task_movememory 758 * Check permission before moving memory owned by process @p. 759 * @p contains the task_struct for process. 760 * Return 0 if permission is granted. 761 * @task_kill: 762 * Check permission before sending signal @sig to @p. @info can be NULL, 763 * the constant 1, or a pointer to a siginfo structure. If @info is 1 or 764 * SI_FROMKERNEL(info) is true, then the signal should be viewed as coming 765 * from the kernel and should typically be permitted. 766 * SIGIO signals are handled separately by the send_sigiotask hook in 767 * file_security_ops. 768 * @p contains the task_struct for process. 769 * @info contains the signal information. 770 * @sig contains the signal value. 771 * @secid contains the sid of the process where the signal originated 772 * Return 0 if permission is granted. 773 * @task_wait: 774 * Check permission before allowing a process to reap a child process @p 775 * and collect its status information. 776 * @p contains the task_struct for process. 777 * Return 0 if permission is granted. 778 * @task_prctl: 779 * Check permission before performing a process control operation on the 780 * current process. 781 * @option contains the operation. 782 * @arg2 contains a argument. 783 * @arg3 contains a argument. 784 * @arg4 contains a argument. 785 * @arg5 contains a argument. 786 * Return -ENOSYS if no-one wanted to handle this op, any other value to 787 * cause prctl() to return immediately with that value. 788 * @task_to_inode: 789 * Set the security attributes for an inode based on an associated task's 790 * security attributes, e.g. for /proc/pid inodes. 791 * @p contains the task_struct for the task. 792 * @inode contains the inode structure for the inode. 793 * 794 * Security hooks for Netlink messaging. 795 * 796 * @netlink_send: 797 * Save security information for a netlink message so that permission 798 * checking can be performed when the message is processed. The security 799 * information can be saved using the eff_cap field of the 800 * netlink_skb_parms structure. Also may be used to provide fine 801 * grained control over message transmission. 802 * @sk associated sock of task sending the message. 803 * @skb contains the sk_buff structure for the netlink message. 804 * Return 0 if the information was successfully saved and message 805 * is allowed to be transmitted. 806 * 807 * Security hooks for Unix domain networking. 808 * 809 * @unix_stream_connect: 810 * Check permissions before establishing a Unix domain stream connection 811 * between @sock and @other. 812 * @sock contains the sock structure. 813 * @other contains the peer sock structure. 814 * @newsk contains the new sock structure. 815 * Return 0 if permission is granted. 816 * @unix_may_send: 817 * Check permissions before connecting or sending datagrams from @sock to 818 * @other. 819 * @sock contains the socket structure. 820 * @other contains the peer socket structure. 821 * Return 0 if permission is granted. 822 * 823 * The @unix_stream_connect and @unix_may_send hooks were necessary because 824 * Linux provides an alternative to the conventional file name space for Unix 825 * domain sockets. Whereas binding and connecting to sockets in the file name 826 * space is mediated by the typical file permissions (and caught by the mknod 827 * and permission hooks in inode_security_ops), binding and connecting to 828 * sockets in the abstract name space is completely unmediated. Sufficient 829 * control of Unix domain sockets in the abstract name space isn't possible 830 * using only the socket layer hooks, since we need to know the actual target 831 * socket, which is not looked up until we are inside the af_unix code. 832 * 833 * Security hooks for socket operations. 834 * 835 * @socket_create: 836 * Check permissions prior to creating a new socket. 837 * @family contains the requested protocol family. 838 * @type contains the requested communications type. 839 * @protocol contains the requested protocol. 840 * @kern set to 1 if a kernel socket. 841 * Return 0 if permission is granted. 842 * @socket_post_create: 843 * This hook allows a module to update or allocate a per-socket security 844 * structure. Note that the security field was not added directly to the 845 * socket structure, but rather, the socket security information is stored 846 * in the associated inode. Typically, the inode alloc_security hook will 847 * allocate and and attach security information to 848 * sock->inode->i_security. This hook may be used to update the 849 * sock->inode->i_security field with additional information that wasn't 850 * available when the inode was allocated. 851 * @sock contains the newly created socket structure. 852 * @family contains the requested protocol family. 853 * @type contains the requested communications type. 854 * @protocol contains the requested protocol. 855 * @kern set to 1 if a kernel socket. 856 * @socket_bind: 857 * Check permission before socket protocol layer bind operation is 858 * performed and the socket @sock is bound to the address specified in the 859 * @address parameter. 860 * @sock contains the socket structure. 861 * @address contains the address to bind to. 862 * @addrlen contains the length of address. 863 * Return 0 if permission is granted. 864 * @socket_connect: 865 * Check permission before socket protocol layer connect operation 866 * attempts to connect socket @sock to a remote address, @address. 867 * @sock contains the socket structure. 868 * @address contains the address of remote endpoint. 869 * @addrlen contains the length of address. 870 * Return 0 if permission is granted. 871 * @socket_listen: 872 * Check permission before socket protocol layer listen operation. 873 * @sock contains the socket structure. 874 * @backlog contains the maximum length for the pending connection queue. 875 * Return 0 if permission is granted. 876 * @socket_accept: 877 * Check permission before accepting a new connection. Note that the new 878 * socket, @newsock, has been created and some information copied to it, 879 * but the accept operation has not actually been performed. 880 * @sock contains the listening socket structure. 881 * @newsock contains the newly created server socket for connection. 882 * Return 0 if permission is granted. 883 * @socket_sendmsg: 884 * Check permission before transmitting a message to another socket. 885 * @sock contains the socket structure. 886 * @msg contains the message to be transmitted. 887 * @size contains the size of message. 888 * Return 0 if permission is granted. 889 * @socket_recvmsg: 890 * Check permission before receiving a message from a socket. 891 * @sock contains the socket structure. 892 * @msg contains the message structure. 893 * @size contains the size of message structure. 894 * @flags contains the operational flags. 895 * Return 0 if permission is granted. 896 * @socket_getsockname: 897 * Check permission before the local address (name) of the socket object 898 * @sock is retrieved. 899 * @sock contains the socket structure. 900 * Return 0 if permission is granted. 901 * @socket_getpeername: 902 * Check permission before the remote address (name) of a socket object 903 * @sock is retrieved. 904 * @sock contains the socket structure. 905 * Return 0 if permission is granted. 906 * @socket_getsockopt: 907 * Check permissions before retrieving the options associated with socket 908 * @sock. 909 * @sock contains the socket structure. 910 * @level contains the protocol level to retrieve option from. 911 * @optname contains the name of option to retrieve. 912 * Return 0 if permission is granted. 913 * @socket_setsockopt: 914 * Check permissions before setting the options associated with socket 915 * @sock. 916 * @sock contains the socket structure. 917 * @level contains the protocol level to set options for. 918 * @optname contains the name of the option to set. 919 * Return 0 if permission is granted. 920 * @socket_shutdown: 921 * Checks permission before all or part of a connection on the socket 922 * @sock is shut down. 923 * @sock contains the socket structure. 924 * @how contains the flag indicating how future sends and receives are handled. 925 * Return 0 if permission is granted. 926 * @socket_sock_rcv_skb: 927 * Check permissions on incoming network packets. This hook is distinct 928 * from Netfilter's IP input hooks since it is the first time that the 929 * incoming sk_buff @skb has been associated with a particular socket, @sk. 930 * Must not sleep inside this hook because some callers hold spinlocks. 931 * @sk contains the sock (not socket) associated with the incoming sk_buff. 932 * @skb contains the incoming network data. 933 * @socket_getpeersec_stream: 934 * This hook allows the security module to provide peer socket security 935 * state for unix or connected tcp sockets to userspace via getsockopt 936 * SO_GETPEERSEC. For tcp sockets this can be meaningful if the 937 * socket is associated with an ipsec SA. 938 * @sock is the local socket. 939 * @optval userspace memory where the security state is to be copied. 940 * @optlen userspace int where the module should copy the actual length 941 * of the security state. 942 * @len as input is the maximum length to copy to userspace provided 943 * by the caller. 944 * Return 0 if all is well, otherwise, typical getsockopt return 945 * values. 946 * @socket_getpeersec_dgram: 947 * This hook allows the security module to provide peer socket security 948 * state for udp sockets on a per-packet basis to userspace via 949 * getsockopt SO_GETPEERSEC. The application must first have indicated 950 * the IP_PASSSEC option via getsockopt. It can then retrieve the 951 * security state returned by this hook for a packet via the SCM_SECURITY 952 * ancillary message type. 953 * @skb is the skbuff for the packet being queried 954 * @secdata is a pointer to a buffer in which to copy the security data 955 * @seclen is the maximum length for @secdata 956 * Return 0 on success, error on failure. 957 * @sk_alloc_security: 958 * Allocate and attach a security structure to the sk->sk_security field, 959 * which is used to copy security attributes between local stream sockets. 960 * @sk_free_security: 961 * Deallocate security structure. 962 * @sk_clone_security: 963 * Clone/copy security structure. 964 * @sk_getsecid: 965 * Retrieve the LSM-specific secid for the sock to enable caching of network 966 * authorizations. 967 * @sock_graft: 968 * Sets the socket's isec sid to the sock's sid. 969 * @inet_conn_request: 970 * Sets the openreq's sid to socket's sid with MLS portion taken from peer sid. 971 * @inet_csk_clone: 972 * Sets the new child socket's sid to the openreq sid. 973 * @inet_conn_established: 974 * Sets the connection's peersid to the secmark on skb. 975 * @secmark_relabel_packet: 976 * check if the process should be allowed to relabel packets to the given secid 977 * @security_secmark_refcount_inc 978 * tells the LSM to increment the number of secmark labeling rules loaded 979 * @security_secmark_refcount_dec 980 * tells the LSM to decrement the number of secmark labeling rules loaded 981 * @req_classify_flow: 982 * Sets the flow's sid to the openreq sid. 983 * @tun_dev_create: 984 * Check permissions prior to creating a new TUN device. 985 * @tun_dev_post_create: 986 * This hook allows a module to update or allocate a per-socket security 987 * structure. 988 * @sk contains the newly created sock structure. 989 * @tun_dev_attach: 990 * Check permissions prior to attaching to a persistent TUN device. This 991 * hook can also be used by the module to update any security state 992 * associated with the TUN device's sock structure. 993 * @sk contains the existing sock structure. 994 * 995 * Security hooks for XFRM operations. 996 * 997 * @xfrm_policy_alloc_security: 998 * @ctxp is a pointer to the xfrm_sec_ctx being added to Security Policy 999 * Database used by the XFRM system. 1000 * @sec_ctx contains the security context information being provided by 1001 * the user-level policy update program (e.g., setkey). 1002 * Allocate a security structure to the xp->security field; the security 1003 * field is initialized to NULL when the xfrm_policy is allocated. 1004 * Return 0 if operation was successful (memory to allocate, legal context) 1005 * @xfrm_policy_clone_security: 1006 * @old_ctx contains an existing xfrm_sec_ctx. 1007 * @new_ctxp contains a new xfrm_sec_ctx being cloned from old. 1008 * Allocate a security structure in new_ctxp that contains the 1009 * information from the old_ctx structure. 1010 * Return 0 if operation was successful (memory to allocate). 1011 * @xfrm_policy_free_security: 1012 * @ctx contains the xfrm_sec_ctx 1013 * Deallocate xp->security. 1014 * @xfrm_policy_delete_security: 1015 * @ctx contains the xfrm_sec_ctx. 1016 * Authorize deletion of xp->security. 1017 * @xfrm_state_alloc_security: 1018 * @x contains the xfrm_state being added to the Security Association 1019 * Database by the XFRM system. 1020 * @sec_ctx contains the security context information being provided by 1021 * the user-level SA generation program (e.g., setkey or racoon). 1022 * @secid contains the secid from which to take the mls portion of the context. 1023 * Allocate a security structure to the x->security field; the security 1024 * field is initialized to NULL when the xfrm_state is allocated. Set the 1025 * context to correspond to either sec_ctx or polsec, with the mls portion 1026 * taken from secid in the latter case. 1027 * Return 0 if operation was successful (memory to allocate, legal context). 1028 * @xfrm_state_free_security: 1029 * @x contains the xfrm_state. 1030 * Deallocate x->security. 1031 * @xfrm_state_delete_security: 1032 * @x contains the xfrm_state. 1033 * Authorize deletion of x->security. 1034 * @xfrm_policy_lookup: 1035 * @ctx contains the xfrm_sec_ctx for which the access control is being 1036 * checked. 1037 * @fl_secid contains the flow security label that is used to authorize 1038 * access to the policy xp. 1039 * @dir contains the direction of the flow (input or output). 1040 * Check permission when a flow selects a xfrm_policy for processing 1041 * XFRMs on a packet. The hook is called when selecting either a 1042 * per-socket policy or a generic xfrm policy. 1043 * Return 0 if permission is granted, -ESRCH otherwise, or -errno 1044 * on other errors. 1045 * @xfrm_state_pol_flow_match: 1046 * @x contains the state to match. 1047 * @xp contains the policy to check for a match. 1048 * @fl contains the flow to check for a match. 1049 * Return 1 if there is a match. 1050 * @xfrm_decode_session: 1051 * @skb points to skb to decode. 1052 * @secid points to the flow key secid to set. 1053 * @ckall says if all xfrms used should be checked for same secid. 1054 * Return 0 if ckall is zero or all xfrms used have the same secid. 1055 * 1056 * Security hooks affecting all Key Management operations 1057 * 1058 * @key_alloc: 1059 * Permit allocation of a key and assign security data. Note that key does 1060 * not have a serial number assigned at this point. 1061 * @key points to the key. 1062 * @flags is the allocation flags 1063 * Return 0 if permission is granted, -ve error otherwise. 1064 * @key_free: 1065 * Notification of destruction; free security data. 1066 * @key points to the key. 1067 * No return value. 1068 * @key_permission: 1069 * See whether a specific operational right is granted to a process on a 1070 * key. 1071 * @key_ref refers to the key (key pointer + possession attribute bit). 1072 * @cred points to the credentials to provide the context against which to 1073 * evaluate the security data on the key. 1074 * @perm describes the combination of permissions required of this key. 1075 * Return 0 if permission is granted, -ve error otherwise. 1076 * @key_getsecurity: 1077 * Get a textual representation of the security context attached to a key 1078 * for the purposes of honouring KEYCTL_GETSECURITY. This function 1079 * allocates the storage for the NUL-terminated string and the caller 1080 * should free it. 1081 * @key points to the key to be queried. 1082 * @_buffer points to a pointer that should be set to point to the 1083 * resulting string (if no label or an error occurs). 1084 * Return the length of the string (including terminating NUL) or -ve if 1085 * an error. 1086 * May also return 0 (and a NULL buffer pointer) if there is no label. 1087 * 1088 * Security hooks affecting all System V IPC operations. 1089 * 1090 * @ipc_permission: 1091 * Check permissions for access to IPC 1092 * @ipcp contains the kernel IPC permission structure 1093 * @flag contains the desired (requested) permission set 1094 * Return 0 if permission is granted. 1095 * @ipc_getsecid: 1096 * Get the secid associated with the ipc object. 1097 * @ipcp contains the kernel IPC permission structure. 1098 * @secid contains a pointer to the location where result will be saved. 1099 * In case of failure, @secid will be set to zero. 1100 * 1101 * Security hooks for individual messages held in System V IPC message queues 1102 * @msg_msg_alloc_security: 1103 * Allocate and attach a security structure to the msg->security field. 1104 * The security field is initialized to NULL when the structure is first 1105 * created. 1106 * @msg contains the message structure to be modified. 1107 * Return 0 if operation was successful and permission is granted. 1108 * @msg_msg_free_security: 1109 * Deallocate the security structure for this message. 1110 * @msg contains the message structure to be modified. 1111 * 1112 * Security hooks for System V IPC Message Queues 1113 * 1114 * @msg_queue_alloc_security: 1115 * Allocate and attach a security structure to the 1116 * msq->q_perm.security field. The security field is initialized to 1117 * NULL when the structure is first created. 1118 * @msq contains the message queue structure to be modified. 1119 * Return 0 if operation was successful and permission is granted. 1120 * @msg_queue_free_security: 1121 * Deallocate security structure for this message queue. 1122 * @msq contains the message queue structure to be modified. 1123 * @msg_queue_associate: 1124 * Check permission when a message queue is requested through the 1125 * msgget system call. This hook is only called when returning the 1126 * message queue identifier for an existing message queue, not when a 1127 * new message queue is created. 1128 * @msq contains the message queue to act upon. 1129 * @msqflg contains the operation control flags. 1130 * Return 0 if permission is granted. 1131 * @msg_queue_msgctl: 1132 * Check permission when a message control operation specified by @cmd 1133 * is to be performed on the message queue @msq. 1134 * The @msq may be NULL, e.g. for IPC_INFO or MSG_INFO. 1135 * @msq contains the message queue to act upon. May be NULL. 1136 * @cmd contains the operation to be performed. 1137 * Return 0 if permission is granted. 1138 * @msg_queue_msgsnd: 1139 * Check permission before a message, @msg, is enqueued on the message 1140 * queue, @msq. 1141 * @msq contains the message queue to send message to. 1142 * @msg contains the message to be enqueued. 1143 * @msqflg contains operational flags. 1144 * Return 0 if permission is granted. 1145 * @msg_queue_msgrcv: 1146 * Check permission before a message, @msg, is removed from the message 1147 * queue, @msq. The @target task structure contains a pointer to the 1148 * process that will be receiving the message (not equal to the current 1149 * process when inline receives are being performed). 1150 * @msq contains the message queue to retrieve message from. 1151 * @msg contains the message destination. 1152 * @target contains the task structure for recipient process. 1153 * @type contains the type of message requested. 1154 * @mode contains the operational flags. 1155 * Return 0 if permission is granted. 1156 * 1157 * Security hooks for System V Shared Memory Segments 1158 * 1159 * @shm_alloc_security: 1160 * Allocate and attach a security structure to the shp->shm_perm.security 1161 * field. The security field is initialized to NULL when the structure is 1162 * first created. 1163 * @shp contains the shared memory structure to be modified. 1164 * Return 0 if operation was successful and permission is granted. 1165 * @shm_free_security: 1166 * Deallocate the security struct for this memory segment. 1167 * @shp contains the shared memory structure to be modified. 1168 * @shm_associate: 1169 * Check permission when a shared memory region is requested through the 1170 * shmget system call. This hook is only called when returning the shared 1171 * memory region identifier for an existing region, not when a new shared 1172 * memory region is created. 1173 * @shp contains the shared memory structure to be modified. 1174 * @shmflg contains the operation control flags. 1175 * Return 0 if permission is granted. 1176 * @shm_shmctl: 1177 * Check permission when a shared memory control operation specified by 1178 * @cmd is to be performed on the shared memory region @shp. 1179 * The @shp may be NULL, e.g. for IPC_INFO or SHM_INFO. 1180 * @shp contains shared memory structure to be modified. 1181 * @cmd contains the operation to be performed. 1182 * Return 0 if permission is granted. 1183 * @shm_shmat: 1184 * Check permissions prior to allowing the shmat system call to attach the 1185 * shared memory segment @shp to the data segment of the calling process. 1186 * The attaching address is specified by @shmaddr. 1187 * @shp contains the shared memory structure to be modified. 1188 * @shmaddr contains the address to attach memory region to. 1189 * @shmflg contains the operational flags. 1190 * Return 0 if permission is granted. 1191 * 1192 * Security hooks for System V Semaphores 1193 * 1194 * @sem_alloc_security: 1195 * Allocate and attach a security structure to the sma->sem_perm.security 1196 * field. The security field is initialized to NULL when the structure is 1197 * first created. 1198 * @sma contains the semaphore structure 1199 * Return 0 if operation was successful and permission is granted. 1200 * @sem_free_security: 1201 * deallocate security struct for this semaphore 1202 * @sma contains the semaphore structure. 1203 * @sem_associate: 1204 * Check permission when a semaphore is requested through the semget 1205 * system call. This hook is only called when returning the semaphore 1206 * identifier for an existing semaphore, not when a new one must be 1207 * created. 1208 * @sma contains the semaphore structure. 1209 * @semflg contains the operation control flags. 1210 * Return 0 if permission is granted. 1211 * @sem_semctl: 1212 * Check permission when a semaphore operation specified by @cmd is to be 1213 * performed on the semaphore @sma. The @sma may be NULL, e.g. for 1214 * IPC_INFO or SEM_INFO. 1215 * @sma contains the semaphore structure. May be NULL. 1216 * @cmd contains the operation to be performed. 1217 * Return 0 if permission is granted. 1218 * @sem_semop 1219 * Check permissions before performing operations on members of the 1220 * semaphore set @sma. If the @alter flag is nonzero, the semaphore set 1221 * may be modified. 1222 * @sma contains the semaphore structure. 1223 * @sops contains the operations to perform. 1224 * @nsops contains the number of operations to perform. 1225 * @alter contains the flag indicating whether changes are to be made. 1226 * Return 0 if permission is granted. 1227 * 1228 * @ptrace_access_check: 1229 * Check permission before allowing the current process to trace the 1230 * @child process. 1231 * Security modules may also want to perform a process tracing check 1232 * during an execve in the set_security or apply_creds hooks of 1233 * tracing check during an execve in the bprm_set_creds hook of 1234 * binprm_security_ops if the process is being traced and its security 1235 * attributes would be changed by the execve. 1236 * @child contains the task_struct structure for the target process. 1237 * @mode contains the PTRACE_MODE flags indicating the form of access. 1238 * Return 0 if permission is granted. 1239 * @ptrace_traceme: 1240 * Check that the @parent process has sufficient permission to trace the 1241 * current process before allowing the current process to present itself 1242 * to the @parent process for tracing. 1243 * The parent process will still have to undergo the ptrace_access_check 1244 * checks before it is allowed to trace this one. 1245 * @parent contains the task_struct structure for debugger process. 1246 * Return 0 if permission is granted. 1247 * @capget: 1248 * Get the @effective, @inheritable, and @permitted capability sets for 1249 * the @target process. The hook may also perform permission checking to 1250 * determine if the current process is allowed to see the capability sets 1251 * of the @target process. 1252 * @target contains the task_struct structure for target process. 1253 * @effective contains the effective capability set. 1254 * @inheritable contains the inheritable capability set. 1255 * @permitted contains the permitted capability set. 1256 * Return 0 if the capability sets were successfully obtained. 1257 * @capset: 1258 * Set the @effective, @inheritable, and @permitted capability sets for 1259 * the current process. 1260 * @new contains the new credentials structure for target process. 1261 * @old contains the current credentials structure for target process. 1262 * @effective contains the effective capability set. 1263 * @inheritable contains the inheritable capability set. 1264 * @permitted contains the permitted capability set. 1265 * Return 0 and update @new if permission is granted. 1266 * @capable: 1267 * Check whether the @tsk process has the @cap capability in the indicated 1268 * credentials. 1269 * @cred contains the credentials to use. 1270 * @ns contains the user namespace we want the capability in 1271 * @cap contains the capability <include/linux/capability.h>. 1272 * @audit: Whether to write an audit message or not 1273 * Return 0 if the capability is granted for @tsk. 1274 * @syslog: 1275 * Check permission before accessing the kernel message ring or changing 1276 * logging to the console. 1277 * See the syslog(2) manual page for an explanation of the @type values. 1278 * @type contains the type of action. 1279 * @from_file indicates the context of action (if it came from /proc). 1280 * Return 0 if permission is granted. 1281 * @settime: 1282 * Check permission to change the system time. 1283 * struct timespec and timezone are defined in include/linux/time.h 1284 * @ts contains new time 1285 * @tz contains new timezone 1286 * Return 0 if permission is granted. 1287 * @vm_enough_memory: 1288 * Check permissions for allocating a new virtual mapping. 1289 * @mm contains the mm struct it is being added to. 1290 * @pages contains the number of pages. 1291 * Return 0 if permission is granted. 1292 * 1293 * @secid_to_secctx: 1294 * Convert secid to security context. If secdata is NULL the length of 1295 * the result will be returned in seclen, but no secdata will be returned. 1296 * This does mean that the length could change between calls to check the 1297 * length and the next call which actually allocates and returns the secdata. 1298 * @secid contains the security ID. 1299 * @secdata contains the pointer that stores the converted security context. 1300 * @seclen pointer which contains the length of the data 1301 * @secctx_to_secid: 1302 * Convert security context to secid. 1303 * @secid contains the pointer to the generated security ID. 1304 * @secdata contains the security context. 1305 * 1306 * @release_secctx: 1307 * Release the security context. 1308 * @secdata contains the security context. 1309 * @seclen contains the length of the security context. 1310 * 1311 * Security hooks for Audit 1312 * 1313 * @audit_rule_init: 1314 * Allocate and initialize an LSM audit rule structure. 1315 * @field contains the required Audit action. Fields flags are defined in include/linux/audit.h 1316 * @op contains the operator the rule uses. 1317 * @rulestr contains the context where the rule will be applied to. 1318 * @lsmrule contains a pointer to receive the result. 1319 * Return 0 if @lsmrule has been successfully set, 1320 * -EINVAL in case of an invalid rule. 1321 * 1322 * @audit_rule_known: 1323 * Specifies whether given @rule contains any fields related to current LSM. 1324 * @rule contains the audit rule of interest. 1325 * Return 1 in case of relation found, 0 otherwise. 1326 * 1327 * @audit_rule_match: 1328 * Determine if given @secid matches a rule previously approved 1329 * by @audit_rule_known. 1330 * @secid contains the security id in question. 1331 * @field contains the field which relates to current LSM. 1332 * @op contains the operator that will be used for matching. 1333 * @rule points to the audit rule that will be checked against. 1334 * @actx points to the audit context associated with the check. 1335 * Return 1 if secid matches the rule, 0 if it does not, -ERRNO on failure. 1336 * 1337 * @audit_rule_free: 1338 * Deallocate the LSM audit rule structure previously allocated by 1339 * audit_rule_init. 1340 * @rule contains the allocated rule 1341 * 1342 * @inode_notifysecctx: 1343 * Notify the security module of what the security context of an inode 1344 * should be. Initializes the incore security context managed by the 1345 * security module for this inode. Example usage: NFS client invokes 1346 * this hook to initialize the security context in its incore inode to the 1347 * value provided by the server for the file when the server returned the 1348 * file's attributes to the client. 1349 * 1350 * Must be called with inode->i_mutex locked. 1351 * 1352 * @inode we wish to set the security context of. 1353 * @ctx contains the string which we wish to set in the inode. 1354 * @ctxlen contains the length of @ctx. 1355 * 1356 * @inode_setsecctx: 1357 * Change the security context of an inode. Updates the 1358 * incore security context managed by the security module and invokes the 1359 * fs code as needed (via __vfs_setxattr_noperm) to update any backing 1360 * xattrs that represent the context. Example usage: NFS server invokes 1361 * this hook to change the security context in its incore inode and on the 1362 * backing filesystem to a value provided by the client on a SETATTR 1363 * operation. 1364 * 1365 * Must be called with inode->i_mutex locked. 1366 * 1367 * @dentry contains the inode we wish to set the security context of. 1368 * @ctx contains the string which we wish to set in the inode. 1369 * @ctxlen contains the length of @ctx. 1370 * 1371 * @inode_getsecctx: 1372 * Returns a string containing all relevant security context information 1373 * 1374 * @inode we wish to get the security context of. 1375 * @ctx is a pointer in which to place the allocated security context. 1376 * @ctxlen points to the place to put the length of @ctx. 1377 * This is the main security structure. 1378 */ 1379 struct security_operations { 1380 char name[SECURITY_NAME_MAX + 1]; 1381 1382 int (*ptrace_access_check) (struct task_struct *child, unsigned int mode); 1383 int (*ptrace_traceme) (struct task_struct *parent); 1384 int (*capget) (struct task_struct *target, 1385 kernel_cap_t *effective, 1386 kernel_cap_t *inheritable, kernel_cap_t *permitted); 1387 int (*capset) (struct cred *new, 1388 const struct cred *old, 1389 const kernel_cap_t *effective, 1390 const kernel_cap_t *inheritable, 1391 const kernel_cap_t *permitted); 1392 int (*capable) (const struct cred *cred, struct user_namespace *ns, 1393 int cap, int audit); 1394 int (*quotactl) (int cmds, int type, int id, struct super_block *sb); 1395 int (*quota_on) (struct dentry *dentry); 1396 int (*syslog) (int type); 1397 int (*settime) (const struct timespec *ts, const struct timezone *tz); 1398 int (*vm_enough_memory) (struct mm_struct *mm, long pages); 1399 1400 int (*bprm_set_creds) (struct linux_binprm *bprm); 1401 int (*bprm_check_security) (struct linux_binprm *bprm); 1402 int (*bprm_secureexec) (struct linux_binprm *bprm); 1403 void (*bprm_committing_creds) (struct linux_binprm *bprm); 1404 void (*bprm_committed_creds) (struct linux_binprm *bprm); 1405 1406 int (*sb_alloc_security) (struct super_block *sb); 1407 void (*sb_free_security) (struct super_block *sb); 1408 int (*sb_copy_data) (char *orig, char *copy); 1409 int (*sb_remount) (struct super_block *sb, void *data); 1410 int (*sb_kern_mount) (struct super_block *sb, int flags, void *data); 1411 int (*sb_show_options) (struct seq_file *m, struct super_block *sb); 1412 int (*sb_statfs) (struct dentry *dentry); 1413 int (*sb_mount) (char *dev_name, struct path *path, 1414 char *type, unsigned long flags, void *data); 1415 int (*sb_umount) (struct vfsmount *mnt, int flags); 1416 int (*sb_pivotroot) (struct path *old_path, 1417 struct path *new_path); 1418 int (*sb_set_mnt_opts) (struct super_block *sb, 1419 struct security_mnt_opts *opts); 1420 void (*sb_clone_mnt_opts) (const struct super_block *oldsb, 1421 struct super_block *newsb); 1422 int (*sb_parse_opts_str) (char *options, struct security_mnt_opts *opts); 1423 1424 #ifdef CONFIG_SECURITY_PATH 1425 int (*path_unlink) (struct path *dir, struct dentry *dentry); 1426 int (*path_mkdir) (struct path *dir, struct dentry *dentry, umode_t mode); 1427 int (*path_rmdir) (struct path *dir, struct dentry *dentry); 1428 int (*path_mknod) (struct path *dir, struct dentry *dentry, umode_t mode, 1429 unsigned int dev); 1430 int (*path_truncate) (struct path *path); 1431 int (*path_symlink) (struct path *dir, struct dentry *dentry, 1432 const char *old_name); 1433 int (*path_link) (struct dentry *old_dentry, struct path *new_dir, 1434 struct dentry *new_dentry); 1435 int (*path_rename) (struct path *old_dir, struct dentry *old_dentry, 1436 struct path *new_dir, struct dentry *new_dentry); 1437 int (*path_chmod) (struct path *path, umode_t mode); 1438 int (*path_chown) (struct path *path, uid_t uid, gid_t gid); 1439 int (*path_chroot) (struct path *path); 1440 #endif 1441 1442 int (*inode_alloc_security) (struct inode *inode); 1443 void (*inode_free_security) (struct inode *inode); 1444 int (*inode_init_security) (struct inode *inode, struct inode *dir, 1445 const struct qstr *qstr, char **name, 1446 void **value, size_t *len); 1447 int (*inode_create) (struct inode *dir, 1448 struct dentry *dentry, umode_t mode); 1449 int (*inode_link) (struct dentry *old_dentry, 1450 struct inode *dir, struct dentry *new_dentry); 1451 int (*inode_unlink) (struct inode *dir, struct dentry *dentry); 1452 int (*inode_symlink) (struct inode *dir, 1453 struct dentry *dentry, const char *old_name); 1454 int (*inode_mkdir) (struct inode *dir, struct dentry *dentry, umode_t mode); 1455 int (*inode_rmdir) (struct inode *dir, struct dentry *dentry); 1456 int (*inode_mknod) (struct inode *dir, struct dentry *dentry, 1457 umode_t mode, dev_t dev); 1458 int (*inode_rename) (struct inode *old_dir, struct dentry *old_dentry, 1459 struct inode *new_dir, struct dentry *new_dentry); 1460 int (*inode_readlink) (struct dentry *dentry); 1461 int (*inode_follow_link) (struct dentry *dentry, struct nameidata *nd); 1462 int (*inode_permission) (struct inode *inode, int mask); 1463 int (*inode_setattr) (struct dentry *dentry, struct iattr *attr); 1464 int (*inode_getattr) (struct vfsmount *mnt, struct dentry *dentry); 1465 int (*inode_setxattr) (struct dentry *dentry, const char *name, 1466 const void *value, size_t size, int flags); 1467 void (*inode_post_setxattr) (struct dentry *dentry, const char *name, 1468 const void *value, size_t size, int flags); 1469 int (*inode_getxattr) (struct dentry *dentry, const char *name); 1470 int (*inode_listxattr) (struct dentry *dentry); 1471 int (*inode_removexattr) (struct dentry *dentry, const char *name); 1472 int (*inode_need_killpriv) (struct dentry *dentry); 1473 int (*inode_killpriv) (struct dentry *dentry); 1474 int (*inode_getsecurity) (const struct inode *inode, const char *name, void **buffer, bool alloc); 1475 int (*inode_setsecurity) (struct inode *inode, const char *name, const void *value, size_t size, int flags); 1476 int (*inode_listsecurity) (struct inode *inode, char *buffer, size_t buffer_size); 1477 void (*inode_getsecid) (const struct inode *inode, u32 *secid); 1478 1479 int (*file_permission) (struct file *file, int mask); 1480 int (*file_alloc_security) (struct file *file); 1481 void (*file_free_security) (struct file *file); 1482 int (*file_ioctl) (struct file *file, unsigned int cmd, 1483 unsigned long arg); 1484 int (*file_mmap) (struct file *file, 1485 unsigned long reqprot, unsigned long prot, 1486 unsigned long flags, unsigned long addr, 1487 unsigned long addr_only); 1488 int (*file_mprotect) (struct vm_area_struct *vma, 1489 unsigned long reqprot, 1490 unsigned long prot); 1491 int (*file_lock) (struct file *file, unsigned int cmd); 1492 int (*file_fcntl) (struct file *file, unsigned int cmd, 1493 unsigned long arg); 1494 int (*file_set_fowner) (struct file *file); 1495 int (*file_send_sigiotask) (struct task_struct *tsk, 1496 struct fown_struct *fown, int sig); 1497 int (*file_receive) (struct file *file); 1498 int (*file_open) (struct file *file, const struct cred *cred); 1499 1500 int (*task_create) (unsigned long clone_flags); 1501 void (*task_free) (struct task_struct *task); 1502 int (*cred_alloc_blank) (struct cred *cred, gfp_t gfp); 1503 void (*cred_free) (struct cred *cred); 1504 int (*cred_prepare)(struct cred *new, const struct cred *old, 1505 gfp_t gfp); 1506 void (*cred_transfer)(struct cred *new, const struct cred *old); 1507 int (*kernel_act_as)(struct cred *new, u32 secid); 1508 int (*kernel_create_files_as)(struct cred *new, struct inode *inode); 1509 int (*kernel_module_request)(char *kmod_name); 1510 int (*task_fix_setuid) (struct cred *new, const struct cred *old, 1511 int flags); 1512 int (*task_setpgid) (struct task_struct *p, pid_t pgid); 1513 int (*task_getpgid) (struct task_struct *p); 1514 int (*task_getsid) (struct task_struct *p); 1515 void (*task_getsecid) (struct task_struct *p, u32 *secid); 1516 int (*task_setnice) (struct task_struct *p, int nice); 1517 int (*task_setioprio) (struct task_struct *p, int ioprio); 1518 int (*task_getioprio) (struct task_struct *p); 1519 int (*task_setrlimit) (struct task_struct *p, unsigned int resource, 1520 struct rlimit *new_rlim); 1521 int (*task_setscheduler) (struct task_struct *p); 1522 int (*task_getscheduler) (struct task_struct *p); 1523 int (*task_movememory) (struct task_struct *p); 1524 int (*task_kill) (struct task_struct *p, 1525 struct siginfo *info, int sig, u32 secid); 1526 int (*task_wait) (struct task_struct *p); 1527 int (*task_prctl) (int option, unsigned long arg2, 1528 unsigned long arg3, unsigned long arg4, 1529 unsigned long arg5); 1530 void (*task_to_inode) (struct task_struct *p, struct inode *inode); 1531 1532 int (*ipc_permission) (struct kern_ipc_perm *ipcp, short flag); 1533 void (*ipc_getsecid) (struct kern_ipc_perm *ipcp, u32 *secid); 1534 1535 int (*msg_msg_alloc_security) (struct msg_msg *msg); 1536 void (*msg_msg_free_security) (struct msg_msg *msg); 1537 1538 int (*msg_queue_alloc_security) (struct msg_queue *msq); 1539 void (*msg_queue_free_security) (struct msg_queue *msq); 1540 int (*msg_queue_associate) (struct msg_queue *msq, int msqflg); 1541 int (*msg_queue_msgctl) (struct msg_queue *msq, int cmd); 1542 int (*msg_queue_msgsnd) (struct msg_queue *msq, 1543 struct msg_msg *msg, int msqflg); 1544 int (*msg_queue_msgrcv) (struct msg_queue *msq, 1545 struct msg_msg *msg, 1546 struct task_struct *target, 1547 long type, int mode); 1548 1549 int (*shm_alloc_security) (struct shmid_kernel *shp); 1550 void (*shm_free_security) (struct shmid_kernel *shp); 1551 int (*shm_associate) (struct shmid_kernel *shp, int shmflg); 1552 int (*shm_shmctl) (struct shmid_kernel *shp, int cmd); 1553 int (*shm_shmat) (struct shmid_kernel *shp, 1554 char __user *shmaddr, int shmflg); 1555 1556 int (*sem_alloc_security) (struct sem_array *sma); 1557 void (*sem_free_security) (struct sem_array *sma); 1558 int (*sem_associate) (struct sem_array *sma, int semflg); 1559 int (*sem_semctl) (struct sem_array *sma, int cmd); 1560 int (*sem_semop) (struct sem_array *sma, 1561 struct sembuf *sops, unsigned nsops, int alter); 1562 1563 int (*netlink_send) (struct sock *sk, struct sk_buff *skb); 1564 1565 void (*d_instantiate) (struct dentry *dentry, struct inode *inode); 1566 1567 int (*getprocattr) (struct task_struct *p, char *name, char **value); 1568 int (*setprocattr) (struct task_struct *p, char *name, void *value, size_t size); 1569 int (*secid_to_secctx) (u32 secid, char **secdata, u32 *seclen); 1570 int (*secctx_to_secid) (const char *secdata, u32 seclen, u32 *secid); 1571 void (*release_secctx) (char *secdata, u32 seclen); 1572 1573 int (*inode_notifysecctx)(struct inode *inode, void *ctx, u32 ctxlen); 1574 int (*inode_setsecctx)(struct dentry *dentry, void *ctx, u32 ctxlen); 1575 int (*inode_getsecctx)(struct inode *inode, void **ctx, u32 *ctxlen); 1576 1577 #ifdef CONFIG_SECURITY_NETWORK 1578 int (*unix_stream_connect) (struct sock *sock, struct sock *other, struct sock *newsk); 1579 int (*unix_may_send) (struct socket *sock, struct socket *other); 1580 1581 int (*socket_create) (int family, int type, int protocol, int kern); 1582 int (*socket_post_create) (struct socket *sock, int family, 1583 int type, int protocol, int kern); 1584 int (*socket_bind) (struct socket *sock, 1585 struct sockaddr *address, int addrlen); 1586 int (*socket_connect) (struct socket *sock, 1587 struct sockaddr *address, int addrlen); 1588 int (*socket_listen) (struct socket *sock, int backlog); 1589 int (*socket_accept) (struct socket *sock, struct socket *newsock); 1590 int (*socket_sendmsg) (struct socket *sock, 1591 struct msghdr *msg, int size); 1592 int (*socket_recvmsg) (struct socket *sock, 1593 struct msghdr *msg, int size, int flags); 1594 int (*socket_getsockname) (struct socket *sock); 1595 int (*socket_getpeername) (struct socket *sock); 1596 int (*socket_getsockopt) (struct socket *sock, int level, int optname); 1597 int (*socket_setsockopt) (struct socket *sock, int level, int optname); 1598 int (*socket_shutdown) (struct socket *sock, int how); 1599 int (*socket_sock_rcv_skb) (struct sock *sk, struct sk_buff *skb); 1600 int (*socket_getpeersec_stream) (struct socket *sock, char __user *optval, int __user *optlen, unsigned len); 1601 int (*socket_getpeersec_dgram) (struct socket *sock, struct sk_buff *skb, u32 *secid); 1602 int (*sk_alloc_security) (struct sock *sk, int family, gfp_t priority); 1603 void (*sk_free_security) (struct sock *sk); 1604 void (*sk_clone_security) (const struct sock *sk, struct sock *newsk); 1605 void (*sk_getsecid) (struct sock *sk, u32 *secid); 1606 void (*sock_graft) (struct sock *sk, struct socket *parent); 1607 int (*inet_conn_request) (struct sock *sk, struct sk_buff *skb, 1608 struct request_sock *req); 1609 void (*inet_csk_clone) (struct sock *newsk, const struct request_sock *req); 1610 void (*inet_conn_established) (struct sock *sk, struct sk_buff *skb); 1611 int (*secmark_relabel_packet) (u32 secid); 1612 void (*secmark_refcount_inc) (void); 1613 void (*secmark_refcount_dec) (void); 1614 void (*req_classify_flow) (const struct request_sock *req, struct flowi *fl); 1615 int (*tun_dev_create)(void); 1616 void (*tun_dev_post_create)(struct sock *sk); 1617 int (*tun_dev_attach)(struct sock *sk); 1618 #endif /* CONFIG_SECURITY_NETWORK */ 1619 1620 #ifdef CONFIG_SECURITY_NETWORK_XFRM 1621 int (*xfrm_policy_alloc_security) (struct xfrm_sec_ctx **ctxp, 1622 struct xfrm_user_sec_ctx *sec_ctx); 1623 int (*xfrm_policy_clone_security) (struct xfrm_sec_ctx *old_ctx, struct xfrm_sec_ctx **new_ctx); 1624 void (*xfrm_policy_free_security) (struct xfrm_sec_ctx *ctx); 1625 int (*xfrm_policy_delete_security) (struct xfrm_sec_ctx *ctx); 1626 int (*xfrm_state_alloc_security) (struct xfrm_state *x, 1627 struct xfrm_user_sec_ctx *sec_ctx, 1628 u32 secid); 1629 void (*xfrm_state_free_security) (struct xfrm_state *x); 1630 int (*xfrm_state_delete_security) (struct xfrm_state *x); 1631 int (*xfrm_policy_lookup) (struct xfrm_sec_ctx *ctx, u32 fl_secid, u8 dir); 1632 int (*xfrm_state_pol_flow_match) (struct xfrm_state *x, 1633 struct xfrm_policy *xp, 1634 const struct flowi *fl); 1635 int (*xfrm_decode_session) (struct sk_buff *skb, u32 *secid, int ckall); 1636 #endif /* CONFIG_SECURITY_NETWORK_XFRM */ 1637 1638 /* key management security hooks */ 1639 #ifdef CONFIG_KEYS 1640 int (*key_alloc) (struct key *key, const struct cred *cred, unsigned long flags); 1641 void (*key_free) (struct key *key); 1642 int (*key_permission) (key_ref_t key_ref, 1643 const struct cred *cred, 1644 key_perm_t perm); 1645 int (*key_getsecurity)(struct key *key, char **_buffer); 1646 #endif /* CONFIG_KEYS */ 1647 1648 #ifdef CONFIG_AUDIT 1649 int (*audit_rule_init) (u32 field, u32 op, char *rulestr, void **lsmrule); 1650 int (*audit_rule_known) (struct audit_krule *krule); 1651 int (*audit_rule_match) (u32 secid, u32 field, u32 op, void *lsmrule, 1652 struct audit_context *actx); 1653 void (*audit_rule_free) (void *lsmrule); 1654 #endif /* CONFIG_AUDIT */ 1655 }; 1656 1657 /* prototypes */ 1658 extern int security_init(void); 1659 extern int security_module_enable(struct security_operations *ops); 1660 extern int register_security(struct security_operations *ops); 1661 extern void __init security_fixup_ops(struct security_operations *ops); 1662 1663 1664 /* Security operations */ 1665 int security_ptrace_access_check(struct task_struct *child, unsigned int mode); 1666 int security_ptrace_traceme(struct task_struct *parent); 1667 int security_capget(struct task_struct *target, 1668 kernel_cap_t *effective, 1669 kernel_cap_t *inheritable, 1670 kernel_cap_t *permitted); 1671 int security_capset(struct cred *new, const struct cred *old, 1672 const kernel_cap_t *effective, 1673 const kernel_cap_t *inheritable, 1674 const kernel_cap_t *permitted); 1675 int security_capable(const struct cred *cred, struct user_namespace *ns, 1676 int cap); 1677 int security_capable_noaudit(const struct cred *cred, struct user_namespace *ns, 1678 int cap); 1679 int security_quotactl(int cmds, int type, int id, struct super_block *sb); 1680 int security_quota_on(struct dentry *dentry); 1681 int security_syslog(int type); 1682 int security_settime(const struct timespec *ts, const struct timezone *tz); 1683 int security_vm_enough_memory_mm(struct mm_struct *mm, long pages); 1684 int security_bprm_set_creds(struct linux_binprm *bprm); 1685 int security_bprm_check(struct linux_binprm *bprm); 1686 void security_bprm_committing_creds(struct linux_binprm *bprm); 1687 void security_bprm_committed_creds(struct linux_binprm *bprm); 1688 int security_bprm_secureexec(struct linux_binprm *bprm); 1689 int security_sb_alloc(struct super_block *sb); 1690 void security_sb_free(struct super_block *sb); 1691 int security_sb_copy_data(char *orig, char *copy); 1692 int security_sb_remount(struct super_block *sb, void *data); 1693 int security_sb_kern_mount(struct super_block *sb, int flags, void *data); 1694 int security_sb_show_options(struct seq_file *m, struct super_block *sb); 1695 int security_sb_statfs(struct dentry *dentry); 1696 int security_sb_mount(char *dev_name, struct path *path, 1697 char *type, unsigned long flags, void *data); 1698 int security_sb_umount(struct vfsmount *mnt, int flags); 1699 int security_sb_pivotroot(struct path *old_path, struct path *new_path); 1700 int security_sb_set_mnt_opts(struct super_block *sb, struct security_mnt_opts *opts); 1701 void security_sb_clone_mnt_opts(const struct super_block *oldsb, 1702 struct super_block *newsb); 1703 int security_sb_parse_opts_str(char *options, struct security_mnt_opts *opts); 1704 1705 int security_inode_alloc(struct inode *inode); 1706 void security_inode_free(struct inode *inode); 1707 int security_inode_init_security(struct inode *inode, struct inode *dir, 1708 const struct qstr *qstr, 1709 initxattrs initxattrs, void *fs_data); 1710 int security_old_inode_init_security(struct inode *inode, struct inode *dir, 1711 const struct qstr *qstr, char **name, 1712 void **value, size_t *len); 1713 int security_inode_create(struct inode *dir, struct dentry *dentry, umode_t mode); 1714 int security_inode_link(struct dentry *old_dentry, struct inode *dir, 1715 struct dentry *new_dentry); 1716 int security_inode_unlink(struct inode *dir, struct dentry *dentry); 1717 int security_inode_symlink(struct inode *dir, struct dentry *dentry, 1718 const char *old_name); 1719 int security_inode_mkdir(struct inode *dir, struct dentry *dentry, umode_t mode); 1720 int security_inode_rmdir(struct inode *dir, struct dentry *dentry); 1721 int security_inode_mknod(struct inode *dir, struct dentry *dentry, umode_t mode, dev_t dev); 1722 int security_inode_rename(struct inode *old_dir, struct dentry *old_dentry, 1723 struct inode *new_dir, struct dentry *new_dentry); 1724 int security_inode_readlink(struct dentry *dentry); 1725 int security_inode_follow_link(struct dentry *dentry, struct nameidata *nd); 1726 int security_inode_permission(struct inode *inode, int mask); 1727 int security_inode_setattr(struct dentry *dentry, struct iattr *attr); 1728 int security_inode_getattr(struct vfsmount *mnt, struct dentry *dentry); 1729 int security_inode_setxattr(struct dentry *dentry, const char *name, 1730 const void *value, size_t size, int flags); 1731 void security_inode_post_setxattr(struct dentry *dentry, const char *name, 1732 const void *value, size_t size, int flags); 1733 int security_inode_getxattr(struct dentry *dentry, const char *name); 1734 int security_inode_listxattr(struct dentry *dentry); 1735 int security_inode_removexattr(struct dentry *dentry, const char *name); 1736 int security_inode_need_killpriv(struct dentry *dentry); 1737 int security_inode_killpriv(struct dentry *dentry); 1738 int security_inode_getsecurity(const struct inode *inode, const char *name, void **buffer, bool alloc); 1739 int security_inode_setsecurity(struct inode *inode, const char *name, const void *value, size_t size, int flags); 1740 int security_inode_listsecurity(struct inode *inode, char *buffer, size_t buffer_size); 1741 void security_inode_getsecid(const struct inode *inode, u32 *secid); 1742 int security_file_permission(struct file *file, int mask); 1743 int security_file_alloc(struct file *file); 1744 void security_file_free(struct file *file); 1745 int security_file_ioctl(struct file *file, unsigned int cmd, unsigned long arg); 1746 int security_file_mmap(struct file *file, unsigned long reqprot, 1747 unsigned long prot, unsigned long flags, 1748 unsigned long addr, unsigned long addr_only); 1749 int security_file_mprotect(struct vm_area_struct *vma, unsigned long reqprot, 1750 unsigned long prot); 1751 int security_file_lock(struct file *file, unsigned int cmd); 1752 int security_file_fcntl(struct file *file, unsigned int cmd, unsigned long arg); 1753 int security_file_set_fowner(struct file *file); 1754 int security_file_send_sigiotask(struct task_struct *tsk, 1755 struct fown_struct *fown, int sig); 1756 int security_file_receive(struct file *file); 1757 int security_file_open(struct file *file, const struct cred *cred); 1758 int security_task_create(unsigned long clone_flags); 1759 void security_task_free(struct task_struct *task); 1760 int security_cred_alloc_blank(struct cred *cred, gfp_t gfp); 1761 void security_cred_free(struct cred *cred); 1762 int security_prepare_creds(struct cred *new, const struct cred *old, gfp_t gfp); 1763 void security_transfer_creds(struct cred *new, const struct cred *old); 1764 int security_kernel_act_as(struct cred *new, u32 secid); 1765 int security_kernel_create_files_as(struct cred *new, struct inode *inode); 1766 int security_kernel_module_request(char *kmod_name); 1767 int security_task_fix_setuid(struct cred *new, const struct cred *old, 1768 int flags); 1769 int security_task_setpgid(struct task_struct *p, pid_t pgid); 1770 int security_task_getpgid(struct task_struct *p); 1771 int security_task_getsid(struct task_struct *p); 1772 void security_task_getsecid(struct task_struct *p, u32 *secid); 1773 int security_task_setnice(struct task_struct *p, int nice); 1774 int security_task_setioprio(struct task_struct *p, int ioprio); 1775 int security_task_getioprio(struct task_struct *p); 1776 int security_task_setrlimit(struct task_struct *p, unsigned int resource, 1777 struct rlimit *new_rlim); 1778 int security_task_setscheduler(struct task_struct *p); 1779 int security_task_getscheduler(struct task_struct *p); 1780 int security_task_movememory(struct task_struct *p); 1781 int security_task_kill(struct task_struct *p, struct siginfo *info, 1782 int sig, u32 secid); 1783 int security_task_wait(struct task_struct *p); 1784 int security_task_prctl(int option, unsigned long arg2, unsigned long arg3, 1785 unsigned long arg4, unsigned long arg5); 1786 void security_task_to_inode(struct task_struct *p, struct inode *inode); 1787 int security_ipc_permission(struct kern_ipc_perm *ipcp, short flag); 1788 void security_ipc_getsecid(struct kern_ipc_perm *ipcp, u32 *secid); 1789 int security_msg_msg_alloc(struct msg_msg *msg); 1790 void security_msg_msg_free(struct msg_msg *msg); 1791 int security_msg_queue_alloc(struct msg_queue *msq); 1792 void security_msg_queue_free(struct msg_queue *msq); 1793 int security_msg_queue_associate(struct msg_queue *msq, int msqflg); 1794 int security_msg_queue_msgctl(struct msg_queue *msq, int cmd); 1795 int security_msg_queue_msgsnd(struct msg_queue *msq, 1796 struct msg_msg *msg, int msqflg); 1797 int security_msg_queue_msgrcv(struct msg_queue *msq, struct msg_msg *msg, 1798 struct task_struct *target, long type, int mode); 1799 int security_shm_alloc(struct shmid_kernel *shp); 1800 void security_shm_free(struct shmid_kernel *shp); 1801 int security_shm_associate(struct shmid_kernel *shp, int shmflg); 1802 int security_shm_shmctl(struct shmid_kernel *shp, int cmd); 1803 int security_shm_shmat(struct shmid_kernel *shp, char __user *shmaddr, int shmflg); 1804 int security_sem_alloc(struct sem_array *sma); 1805 void security_sem_free(struct sem_array *sma); 1806 int security_sem_associate(struct sem_array *sma, int semflg); 1807 int security_sem_semctl(struct sem_array *sma, int cmd); 1808 int security_sem_semop(struct sem_array *sma, struct sembuf *sops, 1809 unsigned nsops, int alter); 1810 void security_d_instantiate(struct dentry *dentry, struct inode *inode); 1811 int security_getprocattr(struct task_struct *p, char *name, char **value); 1812 int security_setprocattr(struct task_struct *p, char *name, void *value, size_t size); 1813 int security_netlink_send(struct sock *sk, struct sk_buff *skb); 1814 int security_secid_to_secctx(u32 secid, char **secdata, u32 *seclen); 1815 int security_secctx_to_secid(const char *secdata, u32 seclen, u32 *secid); 1816 void security_release_secctx(char *secdata, u32 seclen); 1817 1818 int security_inode_notifysecctx(struct inode *inode, void *ctx, u32 ctxlen); 1819 int security_inode_setsecctx(struct dentry *dentry, void *ctx, u32 ctxlen); 1820 int security_inode_getsecctx(struct inode *inode, void **ctx, u32 *ctxlen); 1821 #else /* CONFIG_SECURITY */ 1822 struct security_mnt_opts { 1823 }; 1824 1825 static inline void security_init_mnt_opts(struct security_mnt_opts *opts) 1826 { 1827 } 1828 1829 static inline void security_free_mnt_opts(struct security_mnt_opts *opts) 1830 { 1831 } 1832 1833 /* 1834 * This is the default capabilities functionality. Most of these functions 1835 * are just stubbed out, but a few must call the proper capable code. 1836 */ 1837 1838 static inline int security_init(void) 1839 { 1840 return 0; 1841 } 1842 1843 static inline int security_ptrace_access_check(struct task_struct *child, 1844 unsigned int mode) 1845 { 1846 return cap_ptrace_access_check(child, mode); 1847 } 1848 1849 static inline int security_ptrace_traceme(struct task_struct *parent) 1850 { 1851 return cap_ptrace_traceme(parent); 1852 } 1853 1854 static inline int security_capget(struct task_struct *target, 1855 kernel_cap_t *effective, 1856 kernel_cap_t *inheritable, 1857 kernel_cap_t *permitted) 1858 { 1859 return cap_capget(target, effective, inheritable, permitted); 1860 } 1861 1862 static inline int security_capset(struct cred *new, 1863 const struct cred *old, 1864 const kernel_cap_t *effective, 1865 const kernel_cap_t *inheritable, 1866 const kernel_cap_t *permitted) 1867 { 1868 return cap_capset(new, old, effective, inheritable, permitted); 1869 } 1870 1871 static inline int security_capable(const struct cred *cred, 1872 struct user_namespace *ns, int cap) 1873 { 1874 return cap_capable(cred, ns, cap, SECURITY_CAP_AUDIT); 1875 } 1876 1877 static inline int security_capable_noaudit(const struct cred *cred, 1878 struct user_namespace *ns, int cap) { 1879 return cap_capable(cred, ns, cap, SECURITY_CAP_NOAUDIT); 1880 } 1881 1882 static inline int security_quotactl(int cmds, int type, int id, 1883 struct super_block *sb) 1884 { 1885 return 0; 1886 } 1887 1888 static inline int security_quota_on(struct dentry *dentry) 1889 { 1890 return 0; 1891 } 1892 1893 static inline int security_syslog(int type) 1894 { 1895 return 0; 1896 } 1897 1898 static inline int security_settime(const struct timespec *ts, 1899 const struct timezone *tz) 1900 { 1901 return cap_settime(ts, tz); 1902 } 1903 1904 static inline int security_vm_enough_memory_mm(struct mm_struct *mm, long pages) 1905 { 1906 return cap_vm_enough_memory(mm, pages); 1907 } 1908 1909 static inline int security_bprm_set_creds(struct linux_binprm *bprm) 1910 { 1911 return cap_bprm_set_creds(bprm); 1912 } 1913 1914 static inline int security_bprm_check(struct linux_binprm *bprm) 1915 { 1916 return 0; 1917 } 1918 1919 static inline void security_bprm_committing_creds(struct linux_binprm *bprm) 1920 { 1921 } 1922 1923 static inline void security_bprm_committed_creds(struct linux_binprm *bprm) 1924 { 1925 } 1926 1927 static inline int security_bprm_secureexec(struct linux_binprm *bprm) 1928 { 1929 return cap_bprm_secureexec(bprm); 1930 } 1931 1932 static inline int security_sb_alloc(struct super_block *sb) 1933 { 1934 return 0; 1935 } 1936 1937 static inline void security_sb_free(struct super_block *sb) 1938 { } 1939 1940 static inline int security_sb_copy_data(char *orig, char *copy) 1941 { 1942 return 0; 1943 } 1944 1945 static inline int security_sb_remount(struct super_block *sb, void *data) 1946 { 1947 return 0; 1948 } 1949 1950 static inline int security_sb_kern_mount(struct super_block *sb, int flags, void *data) 1951 { 1952 return 0; 1953 } 1954 1955 static inline int security_sb_show_options(struct seq_file *m, 1956 struct super_block *sb) 1957 { 1958 return 0; 1959 } 1960 1961 static inline int security_sb_statfs(struct dentry *dentry) 1962 { 1963 return 0; 1964 } 1965 1966 static inline int security_sb_mount(char *dev_name, struct path *path, 1967 char *type, unsigned long flags, 1968 void *data) 1969 { 1970 return 0; 1971 } 1972 1973 static inline int security_sb_umount(struct vfsmount *mnt, int flags) 1974 { 1975 return 0; 1976 } 1977 1978 static inline int security_sb_pivotroot(struct path *old_path, 1979 struct path *new_path) 1980 { 1981 return 0; 1982 } 1983 1984 static inline int security_sb_set_mnt_opts(struct super_block *sb, 1985 struct security_mnt_opts *opts) 1986 { 1987 return 0; 1988 } 1989 1990 static inline void security_sb_clone_mnt_opts(const struct super_block *oldsb, 1991 struct super_block *newsb) 1992 { } 1993 1994 static inline int security_sb_parse_opts_str(char *options, struct security_mnt_opts *opts) 1995 { 1996 return 0; 1997 } 1998 1999 static inline int security_inode_alloc(struct inode *inode) 2000 { 2001 return 0; 2002 } 2003 2004 static inline void security_inode_free(struct inode *inode) 2005 { } 2006 2007 static inline int security_inode_init_security(struct inode *inode, 2008 struct inode *dir, 2009 const struct qstr *qstr, 2010 const initxattrs initxattrs, 2011 void *fs_data) 2012 { 2013 return 0; 2014 } 2015 2016 static inline int security_old_inode_init_security(struct inode *inode, 2017 struct inode *dir, 2018 const struct qstr *qstr, 2019 char **name, void **value, 2020 size_t *len) 2021 { 2022 return -EOPNOTSUPP; 2023 } 2024 2025 static inline int security_inode_create(struct inode *dir, 2026 struct dentry *dentry, 2027 umode_t mode) 2028 { 2029 return 0; 2030 } 2031 2032 static inline int security_inode_link(struct dentry *old_dentry, 2033 struct inode *dir, 2034 struct dentry *new_dentry) 2035 { 2036 return 0; 2037 } 2038 2039 static inline int security_inode_unlink(struct inode *dir, 2040 struct dentry *dentry) 2041 { 2042 return 0; 2043 } 2044 2045 static inline int security_inode_symlink(struct inode *dir, 2046 struct dentry *dentry, 2047 const char *old_name) 2048 { 2049 return 0; 2050 } 2051 2052 static inline int security_inode_mkdir(struct inode *dir, 2053 struct dentry *dentry, 2054 int mode) 2055 { 2056 return 0; 2057 } 2058 2059 static inline int security_inode_rmdir(struct inode *dir, 2060 struct dentry *dentry) 2061 { 2062 return 0; 2063 } 2064 2065 static inline int security_inode_mknod(struct inode *dir, 2066 struct dentry *dentry, 2067 int mode, dev_t dev) 2068 { 2069 return 0; 2070 } 2071 2072 static inline int security_inode_rename(struct inode *old_dir, 2073 struct dentry *old_dentry, 2074 struct inode *new_dir, 2075 struct dentry *new_dentry) 2076 { 2077 return 0; 2078 } 2079 2080 static inline int security_inode_readlink(struct dentry *dentry) 2081 { 2082 return 0; 2083 } 2084 2085 static inline int security_inode_follow_link(struct dentry *dentry, 2086 struct nameidata *nd) 2087 { 2088 return 0; 2089 } 2090 2091 static inline int security_inode_permission(struct inode *inode, int mask) 2092 { 2093 return 0; 2094 } 2095 2096 static inline int security_inode_setattr(struct dentry *dentry, 2097 struct iattr *attr) 2098 { 2099 return 0; 2100 } 2101 2102 static inline int security_inode_getattr(struct vfsmount *mnt, 2103 struct dentry *dentry) 2104 { 2105 return 0; 2106 } 2107 2108 static inline int security_inode_setxattr(struct dentry *dentry, 2109 const char *name, const void *value, size_t size, int flags) 2110 { 2111 return cap_inode_setxattr(dentry, name, value, size, flags); 2112 } 2113 2114 static inline void security_inode_post_setxattr(struct dentry *dentry, 2115 const char *name, const void *value, size_t size, int flags) 2116 { } 2117 2118 static inline int security_inode_getxattr(struct dentry *dentry, 2119 const char *name) 2120 { 2121 return 0; 2122 } 2123 2124 static inline int security_inode_listxattr(struct dentry *dentry) 2125 { 2126 return 0; 2127 } 2128 2129 static inline int security_inode_removexattr(struct dentry *dentry, 2130 const char *name) 2131 { 2132 return cap_inode_removexattr(dentry, name); 2133 } 2134 2135 static inline int security_inode_need_killpriv(struct dentry *dentry) 2136 { 2137 return cap_inode_need_killpriv(dentry); 2138 } 2139 2140 static inline int security_inode_killpriv(struct dentry *dentry) 2141 { 2142 return cap_inode_killpriv(dentry); 2143 } 2144 2145 static inline int security_inode_getsecurity(const struct inode *inode, const char *name, void **buffer, bool alloc) 2146 { 2147 return -EOPNOTSUPP; 2148 } 2149 2150 static inline int security_inode_setsecurity(struct inode *inode, const char *name, const void *value, size_t size, int flags) 2151 { 2152 return -EOPNOTSUPP; 2153 } 2154 2155 static inline int security_inode_listsecurity(struct inode *inode, char *buffer, size_t buffer_size) 2156 { 2157 return 0; 2158 } 2159 2160 static inline void security_inode_getsecid(const struct inode *inode, u32 *secid) 2161 { 2162 *secid = 0; 2163 } 2164 2165 static inline int security_file_permission(struct file *file, int mask) 2166 { 2167 return 0; 2168 } 2169 2170 static inline int security_file_alloc(struct file *file) 2171 { 2172 return 0; 2173 } 2174 2175 static inline void security_file_free(struct file *file) 2176 { } 2177 2178 static inline int security_file_ioctl(struct file *file, unsigned int cmd, 2179 unsigned long arg) 2180 { 2181 return 0; 2182 } 2183 2184 static inline int security_file_mmap(struct file *file, unsigned long reqprot, 2185 unsigned long prot, 2186 unsigned long flags, 2187 unsigned long addr, 2188 unsigned long addr_only) 2189 { 2190 return cap_file_mmap(file, reqprot, prot, flags, addr, addr_only); 2191 } 2192 2193 static inline int security_file_mprotect(struct vm_area_struct *vma, 2194 unsigned long reqprot, 2195 unsigned long prot) 2196 { 2197 return 0; 2198 } 2199 2200 static inline int security_file_lock(struct file *file, unsigned int cmd) 2201 { 2202 return 0; 2203 } 2204 2205 static inline int security_file_fcntl(struct file *file, unsigned int cmd, 2206 unsigned long arg) 2207 { 2208 return 0; 2209 } 2210 2211 static inline int security_file_set_fowner(struct file *file) 2212 { 2213 return 0; 2214 } 2215 2216 static inline int security_file_send_sigiotask(struct task_struct *tsk, 2217 struct fown_struct *fown, 2218 int sig) 2219 { 2220 return 0; 2221 } 2222 2223 static inline int security_file_receive(struct file *file) 2224 { 2225 return 0; 2226 } 2227 2228 static inline int security_file_open(struct file *file, 2229 const struct cred *cred) 2230 { 2231 return 0; 2232 } 2233 2234 static inline int security_task_create(unsigned long clone_flags) 2235 { 2236 return 0; 2237 } 2238 2239 static inline void security_task_free(struct task_struct *task) 2240 { } 2241 2242 static inline int security_cred_alloc_blank(struct cred *cred, gfp_t gfp) 2243 { 2244 return 0; 2245 } 2246 2247 static inline void security_cred_free(struct cred *cred) 2248 { } 2249 2250 static inline int security_prepare_creds(struct cred *new, 2251 const struct cred *old, 2252 gfp_t gfp) 2253 { 2254 return 0; 2255 } 2256 2257 static inline void security_transfer_creds(struct cred *new, 2258 const struct cred *old) 2259 { 2260 } 2261 2262 static inline int security_kernel_act_as(struct cred *cred, u32 secid) 2263 { 2264 return 0; 2265 } 2266 2267 static inline int security_kernel_create_files_as(struct cred *cred, 2268 struct inode *inode) 2269 { 2270 return 0; 2271 } 2272 2273 static inline int security_kernel_module_request(char *kmod_name) 2274 { 2275 return 0; 2276 } 2277 2278 static inline int security_task_fix_setuid(struct cred *new, 2279 const struct cred *old, 2280 int flags) 2281 { 2282 return cap_task_fix_setuid(new, old, flags); 2283 } 2284 2285 static inline int security_task_setpgid(struct task_struct *p, pid_t pgid) 2286 { 2287 return 0; 2288 } 2289 2290 static inline int security_task_getpgid(struct task_struct *p) 2291 { 2292 return 0; 2293 } 2294 2295 static inline int security_task_getsid(struct task_struct *p) 2296 { 2297 return 0; 2298 } 2299 2300 static inline void security_task_getsecid(struct task_struct *p, u32 *secid) 2301 { 2302 *secid = 0; 2303 } 2304 2305 static inline int security_task_setnice(struct task_struct *p, int nice) 2306 { 2307 return cap_task_setnice(p, nice); 2308 } 2309 2310 static inline int security_task_setioprio(struct task_struct *p, int ioprio) 2311 { 2312 return cap_task_setioprio(p, ioprio); 2313 } 2314 2315 static inline int security_task_getioprio(struct task_struct *p) 2316 { 2317 return 0; 2318 } 2319 2320 static inline int security_task_setrlimit(struct task_struct *p, 2321 unsigned int resource, 2322 struct rlimit *new_rlim) 2323 { 2324 return 0; 2325 } 2326 2327 static inline int security_task_setscheduler(struct task_struct *p) 2328 { 2329 return cap_task_setscheduler(p); 2330 } 2331 2332 static inline int security_task_getscheduler(struct task_struct *p) 2333 { 2334 return 0; 2335 } 2336 2337 static inline int security_task_movememory(struct task_struct *p) 2338 { 2339 return 0; 2340 } 2341 2342 static inline int security_task_kill(struct task_struct *p, 2343 struct siginfo *info, int sig, 2344 u32 secid) 2345 { 2346 return 0; 2347 } 2348 2349 static inline int security_task_wait(struct task_struct *p) 2350 { 2351 return 0; 2352 } 2353 2354 static inline int security_task_prctl(int option, unsigned long arg2, 2355 unsigned long arg3, 2356 unsigned long arg4, 2357 unsigned long arg5) 2358 { 2359 return cap_task_prctl(option, arg2, arg3, arg3, arg5); 2360 } 2361 2362 static inline void security_task_to_inode(struct task_struct *p, struct inode *inode) 2363 { } 2364 2365 static inline int security_ipc_permission(struct kern_ipc_perm *ipcp, 2366 short flag) 2367 { 2368 return 0; 2369 } 2370 2371 static inline void security_ipc_getsecid(struct kern_ipc_perm *ipcp, u32 *secid) 2372 { 2373 *secid = 0; 2374 } 2375 2376 static inline int security_msg_msg_alloc(struct msg_msg *msg) 2377 { 2378 return 0; 2379 } 2380 2381 static inline void security_msg_msg_free(struct msg_msg *msg) 2382 { } 2383 2384 static inline int security_msg_queue_alloc(struct msg_queue *msq) 2385 { 2386 return 0; 2387 } 2388 2389 static inline void security_msg_queue_free(struct msg_queue *msq) 2390 { } 2391 2392 static inline int security_msg_queue_associate(struct msg_queue *msq, 2393 int msqflg) 2394 { 2395 return 0; 2396 } 2397 2398 static inline int security_msg_queue_msgctl(struct msg_queue *msq, int cmd) 2399 { 2400 return 0; 2401 } 2402 2403 static inline int security_msg_queue_msgsnd(struct msg_queue *msq, 2404 struct msg_msg *msg, int msqflg) 2405 { 2406 return 0; 2407 } 2408 2409 static inline int security_msg_queue_msgrcv(struct msg_queue *msq, 2410 struct msg_msg *msg, 2411 struct task_struct *target, 2412 long type, int mode) 2413 { 2414 return 0; 2415 } 2416 2417 static inline int security_shm_alloc(struct shmid_kernel *shp) 2418 { 2419 return 0; 2420 } 2421 2422 static inline void security_shm_free(struct shmid_kernel *shp) 2423 { } 2424 2425 static inline int security_shm_associate(struct shmid_kernel *shp, 2426 int shmflg) 2427 { 2428 return 0; 2429 } 2430 2431 static inline int security_shm_shmctl(struct shmid_kernel *shp, int cmd) 2432 { 2433 return 0; 2434 } 2435 2436 static inline int security_shm_shmat(struct shmid_kernel *shp, 2437 char __user *shmaddr, int shmflg) 2438 { 2439 return 0; 2440 } 2441 2442 static inline int security_sem_alloc(struct sem_array *sma) 2443 { 2444 return 0; 2445 } 2446 2447 static inline void security_sem_free(struct sem_array *sma) 2448 { } 2449 2450 static inline int security_sem_associate(struct sem_array *sma, int semflg) 2451 { 2452 return 0; 2453 } 2454 2455 static inline int security_sem_semctl(struct sem_array *sma, int cmd) 2456 { 2457 return 0; 2458 } 2459 2460 static inline int security_sem_semop(struct sem_array *sma, 2461 struct sembuf *sops, unsigned nsops, 2462 int alter) 2463 { 2464 return 0; 2465 } 2466 2467 static inline void security_d_instantiate(struct dentry *dentry, struct inode *inode) 2468 { } 2469 2470 static inline int security_getprocattr(struct task_struct *p, char *name, char **value) 2471 { 2472 return -EINVAL; 2473 } 2474 2475 static inline int security_setprocattr(struct task_struct *p, char *name, void *value, size_t size) 2476 { 2477 return -EINVAL; 2478 } 2479 2480 static inline int security_netlink_send(struct sock *sk, struct sk_buff *skb) 2481 { 2482 return cap_netlink_send(sk, skb); 2483 } 2484 2485 static inline int security_secid_to_secctx(u32 secid, char **secdata, u32 *seclen) 2486 { 2487 return -EOPNOTSUPP; 2488 } 2489 2490 static inline int security_secctx_to_secid(const char *secdata, 2491 u32 seclen, 2492 u32 *secid) 2493 { 2494 return -EOPNOTSUPP; 2495 } 2496 2497 static inline void security_release_secctx(char *secdata, u32 seclen) 2498 { 2499 } 2500 2501 static inline int security_inode_notifysecctx(struct inode *inode, void *ctx, u32 ctxlen) 2502 { 2503 return -EOPNOTSUPP; 2504 } 2505 static inline int security_inode_setsecctx(struct dentry *dentry, void *ctx, u32 ctxlen) 2506 { 2507 return -EOPNOTSUPP; 2508 } 2509 static inline int security_inode_getsecctx(struct inode *inode, void **ctx, u32 *ctxlen) 2510 { 2511 return -EOPNOTSUPP; 2512 } 2513 #endif /* CONFIG_SECURITY */ 2514 2515 #ifdef CONFIG_SECURITY_NETWORK 2516 2517 int security_unix_stream_connect(struct sock *sock, struct sock *other, struct sock *newsk); 2518 int security_unix_may_send(struct socket *sock, struct socket *other); 2519 int security_socket_create(int family, int type, int protocol, int kern); 2520 int security_socket_post_create(struct socket *sock, int family, 2521 int type, int protocol, int kern); 2522 int security_socket_bind(struct socket *sock, struct sockaddr *address, int addrlen); 2523 int security_socket_connect(struct socket *sock, struct sockaddr *address, int addrlen); 2524 int security_socket_listen(struct socket *sock, int backlog); 2525 int security_socket_accept(struct socket *sock, struct socket *newsock); 2526 int security_socket_sendmsg(struct socket *sock, struct msghdr *msg, int size); 2527 int security_socket_recvmsg(struct socket *sock, struct msghdr *msg, 2528 int size, int flags); 2529 int security_socket_getsockname(struct socket *sock); 2530 int security_socket_getpeername(struct socket *sock); 2531 int security_socket_getsockopt(struct socket *sock, int level, int optname); 2532 int security_socket_setsockopt(struct socket *sock, int level, int optname); 2533 int security_socket_shutdown(struct socket *sock, int how); 2534 int security_sock_rcv_skb(struct sock *sk, struct sk_buff *skb); 2535 int security_socket_getpeersec_stream(struct socket *sock, char __user *optval, 2536 int __user *optlen, unsigned len); 2537 int security_socket_getpeersec_dgram(struct socket *sock, struct sk_buff *skb, u32 *secid); 2538 int security_sk_alloc(struct sock *sk, int family, gfp_t priority); 2539 void security_sk_free(struct sock *sk); 2540 void security_sk_clone(const struct sock *sk, struct sock *newsk); 2541 void security_sk_classify_flow(struct sock *sk, struct flowi *fl); 2542 void security_req_classify_flow(const struct request_sock *req, struct flowi *fl); 2543 void security_sock_graft(struct sock*sk, struct socket *parent); 2544 int security_inet_conn_request(struct sock *sk, 2545 struct sk_buff *skb, struct request_sock *req); 2546 void security_inet_csk_clone(struct sock *newsk, 2547 const struct request_sock *req); 2548 void security_inet_conn_established(struct sock *sk, 2549 struct sk_buff *skb); 2550 int security_secmark_relabel_packet(u32 secid); 2551 void security_secmark_refcount_inc(void); 2552 void security_secmark_refcount_dec(void); 2553 int security_tun_dev_create(void); 2554 void security_tun_dev_post_create(struct sock *sk); 2555 int security_tun_dev_attach(struct sock *sk); 2556 2557 #else /* CONFIG_SECURITY_NETWORK */ 2558 static inline int security_unix_stream_connect(struct sock *sock, 2559 struct sock *other, 2560 struct sock *newsk) 2561 { 2562 return 0; 2563 } 2564 2565 static inline int security_unix_may_send(struct socket *sock, 2566 struct socket *other) 2567 { 2568 return 0; 2569 } 2570 2571 static inline int security_socket_create(int family, int type, 2572 int protocol, int kern) 2573 { 2574 return 0; 2575 } 2576 2577 static inline int security_socket_post_create(struct socket *sock, 2578 int family, 2579 int type, 2580 int protocol, int kern) 2581 { 2582 return 0; 2583 } 2584 2585 static inline int security_socket_bind(struct socket *sock, 2586 struct sockaddr *address, 2587 int addrlen) 2588 { 2589 return 0; 2590 } 2591 2592 static inline int security_socket_connect(struct socket *sock, 2593 struct sockaddr *address, 2594 int addrlen) 2595 { 2596 return 0; 2597 } 2598 2599 static inline int security_socket_listen(struct socket *sock, int backlog) 2600 { 2601 return 0; 2602 } 2603 2604 static inline int security_socket_accept(struct socket *sock, 2605 struct socket *newsock) 2606 { 2607 return 0; 2608 } 2609 2610 static inline int security_socket_sendmsg(struct socket *sock, 2611 struct msghdr *msg, int size) 2612 { 2613 return 0; 2614 } 2615 2616 static inline int security_socket_recvmsg(struct socket *sock, 2617 struct msghdr *msg, int size, 2618 int flags) 2619 { 2620 return 0; 2621 } 2622 2623 static inline int security_socket_getsockname(struct socket *sock) 2624 { 2625 return 0; 2626 } 2627 2628 static inline int security_socket_getpeername(struct socket *sock) 2629 { 2630 return 0; 2631 } 2632 2633 static inline int security_socket_getsockopt(struct socket *sock, 2634 int level, int optname) 2635 { 2636 return 0; 2637 } 2638 2639 static inline int security_socket_setsockopt(struct socket *sock, 2640 int level, int optname) 2641 { 2642 return 0; 2643 } 2644 2645 static inline int security_socket_shutdown(struct socket *sock, int how) 2646 { 2647 return 0; 2648 } 2649 static inline int security_sock_rcv_skb(struct sock *sk, 2650 struct sk_buff *skb) 2651 { 2652 return 0; 2653 } 2654 2655 static inline int security_socket_getpeersec_stream(struct socket *sock, char __user *optval, 2656 int __user *optlen, unsigned len) 2657 { 2658 return -ENOPROTOOPT; 2659 } 2660 2661 static inline int security_socket_getpeersec_dgram(struct socket *sock, struct sk_buff *skb, u32 *secid) 2662 { 2663 return -ENOPROTOOPT; 2664 } 2665 2666 static inline int security_sk_alloc(struct sock *sk, int family, gfp_t priority) 2667 { 2668 return 0; 2669 } 2670 2671 static inline void security_sk_free(struct sock *sk) 2672 { 2673 } 2674 2675 static inline void security_sk_clone(const struct sock *sk, struct sock *newsk) 2676 { 2677 } 2678 2679 static inline void security_sk_classify_flow(struct sock *sk, struct flowi *fl) 2680 { 2681 } 2682 2683 static inline void security_req_classify_flow(const struct request_sock *req, struct flowi *fl) 2684 { 2685 } 2686 2687 static inline void security_sock_graft(struct sock *sk, struct socket *parent) 2688 { 2689 } 2690 2691 static inline int security_inet_conn_request(struct sock *sk, 2692 struct sk_buff *skb, struct request_sock *req) 2693 { 2694 return 0; 2695 } 2696 2697 static inline void security_inet_csk_clone(struct sock *newsk, 2698 const struct request_sock *req) 2699 { 2700 } 2701 2702 static inline void security_inet_conn_established(struct sock *sk, 2703 struct sk_buff *skb) 2704 { 2705 } 2706 2707 static inline int security_secmark_relabel_packet(u32 secid) 2708 { 2709 return 0; 2710 } 2711 2712 static inline void security_secmark_refcount_inc(void) 2713 { 2714 } 2715 2716 static inline void security_secmark_refcount_dec(void) 2717 { 2718 } 2719 2720 static inline int security_tun_dev_create(void) 2721 { 2722 return 0; 2723 } 2724 2725 static inline void security_tun_dev_post_create(struct sock *sk) 2726 { 2727 } 2728 2729 static inline int security_tun_dev_attach(struct sock *sk) 2730 { 2731 return 0; 2732 } 2733 #endif /* CONFIG_SECURITY_NETWORK */ 2734 2735 #ifdef CONFIG_SECURITY_NETWORK_XFRM 2736 2737 int security_xfrm_policy_alloc(struct xfrm_sec_ctx **ctxp, struct xfrm_user_sec_ctx *sec_ctx); 2738 int security_xfrm_policy_clone(struct xfrm_sec_ctx *old_ctx, struct xfrm_sec_ctx **new_ctxp); 2739 void security_xfrm_policy_free(struct xfrm_sec_ctx *ctx); 2740 int security_xfrm_policy_delete(struct xfrm_sec_ctx *ctx); 2741 int security_xfrm_state_alloc(struct xfrm_state *x, struct xfrm_user_sec_ctx *sec_ctx); 2742 int security_xfrm_state_alloc_acquire(struct xfrm_state *x, 2743 struct xfrm_sec_ctx *polsec, u32 secid); 2744 int security_xfrm_state_delete(struct xfrm_state *x); 2745 void security_xfrm_state_free(struct xfrm_state *x); 2746 int security_xfrm_policy_lookup(struct xfrm_sec_ctx *ctx, u32 fl_secid, u8 dir); 2747 int security_xfrm_state_pol_flow_match(struct xfrm_state *x, 2748 struct xfrm_policy *xp, 2749 const struct flowi *fl); 2750 int security_xfrm_decode_session(struct sk_buff *skb, u32 *secid); 2751 void security_skb_classify_flow(struct sk_buff *skb, struct flowi *fl); 2752 2753 #else /* CONFIG_SECURITY_NETWORK_XFRM */ 2754 2755 static inline int security_xfrm_policy_alloc(struct xfrm_sec_ctx **ctxp, struct xfrm_user_sec_ctx *sec_ctx) 2756 { 2757 return 0; 2758 } 2759 2760 static inline int security_xfrm_policy_clone(struct xfrm_sec_ctx *old, struct xfrm_sec_ctx **new_ctxp) 2761 { 2762 return 0; 2763 } 2764 2765 static inline void security_xfrm_policy_free(struct xfrm_sec_ctx *ctx) 2766 { 2767 } 2768 2769 static inline int security_xfrm_policy_delete(struct xfrm_sec_ctx *ctx) 2770 { 2771 return 0; 2772 } 2773 2774 static inline int security_xfrm_state_alloc(struct xfrm_state *x, 2775 struct xfrm_user_sec_ctx *sec_ctx) 2776 { 2777 return 0; 2778 } 2779 2780 static inline int security_xfrm_state_alloc_acquire(struct xfrm_state *x, 2781 struct xfrm_sec_ctx *polsec, u32 secid) 2782 { 2783 return 0; 2784 } 2785 2786 static inline void security_xfrm_state_free(struct xfrm_state *x) 2787 { 2788 } 2789 2790 static inline int security_xfrm_state_delete(struct xfrm_state *x) 2791 { 2792 return 0; 2793 } 2794 2795 static inline int security_xfrm_policy_lookup(struct xfrm_sec_ctx *ctx, u32 fl_secid, u8 dir) 2796 { 2797 return 0; 2798 } 2799 2800 static inline int security_xfrm_state_pol_flow_match(struct xfrm_state *x, 2801 struct xfrm_policy *xp, const struct flowi *fl) 2802 { 2803 return 1; 2804 } 2805 2806 static inline int security_xfrm_decode_session(struct sk_buff *skb, u32 *secid) 2807 { 2808 return 0; 2809 } 2810 2811 static inline void security_skb_classify_flow(struct sk_buff *skb, struct flowi *fl) 2812 { 2813 } 2814 2815 #endif /* CONFIG_SECURITY_NETWORK_XFRM */ 2816 2817 #ifdef CONFIG_SECURITY_PATH 2818 int security_path_unlink(struct path *dir, struct dentry *dentry); 2819 int security_path_mkdir(struct path *dir, struct dentry *dentry, umode_t mode); 2820 int security_path_rmdir(struct path *dir, struct dentry *dentry); 2821 int security_path_mknod(struct path *dir, struct dentry *dentry, umode_t mode, 2822 unsigned int dev); 2823 int security_path_truncate(struct path *path); 2824 int security_path_symlink(struct path *dir, struct dentry *dentry, 2825 const char *old_name); 2826 int security_path_link(struct dentry *old_dentry, struct path *new_dir, 2827 struct dentry *new_dentry); 2828 int security_path_rename(struct path *old_dir, struct dentry *old_dentry, 2829 struct path *new_dir, struct dentry *new_dentry); 2830 int security_path_chmod(struct path *path, umode_t mode); 2831 int security_path_chown(struct path *path, uid_t uid, gid_t gid); 2832 int security_path_chroot(struct path *path); 2833 #else /* CONFIG_SECURITY_PATH */ 2834 static inline int security_path_unlink(struct path *dir, struct dentry *dentry) 2835 { 2836 return 0; 2837 } 2838 2839 static inline int security_path_mkdir(struct path *dir, struct dentry *dentry, 2840 umode_t mode) 2841 { 2842 return 0; 2843 } 2844 2845 static inline int security_path_rmdir(struct path *dir, struct dentry *dentry) 2846 { 2847 return 0; 2848 } 2849 2850 static inline int security_path_mknod(struct path *dir, struct dentry *dentry, 2851 umode_t mode, unsigned int dev) 2852 { 2853 return 0; 2854 } 2855 2856 static inline int security_path_truncate(struct path *path) 2857 { 2858 return 0; 2859 } 2860 2861 static inline int security_path_symlink(struct path *dir, struct dentry *dentry, 2862 const char *old_name) 2863 { 2864 return 0; 2865 } 2866 2867 static inline int security_path_link(struct dentry *old_dentry, 2868 struct path *new_dir, 2869 struct dentry *new_dentry) 2870 { 2871 return 0; 2872 } 2873 2874 static inline int security_path_rename(struct path *old_dir, 2875 struct dentry *old_dentry, 2876 struct path *new_dir, 2877 struct dentry *new_dentry) 2878 { 2879 return 0; 2880 } 2881 2882 static inline int security_path_chmod(struct path *path, umode_t mode) 2883 { 2884 return 0; 2885 } 2886 2887 static inline int security_path_chown(struct path *path, uid_t uid, gid_t gid) 2888 { 2889 return 0; 2890 } 2891 2892 static inline int security_path_chroot(struct path *path) 2893 { 2894 return 0; 2895 } 2896 #endif /* CONFIG_SECURITY_PATH */ 2897 2898 #ifdef CONFIG_KEYS 2899 #ifdef CONFIG_SECURITY 2900 2901 int security_key_alloc(struct key *key, const struct cred *cred, unsigned long flags); 2902 void security_key_free(struct key *key); 2903 int security_key_permission(key_ref_t key_ref, 2904 const struct cred *cred, key_perm_t perm); 2905 int security_key_getsecurity(struct key *key, char **_buffer); 2906 2907 #else 2908 2909 static inline int security_key_alloc(struct key *key, 2910 const struct cred *cred, 2911 unsigned long flags) 2912 { 2913 return 0; 2914 } 2915 2916 static inline void security_key_free(struct key *key) 2917 { 2918 } 2919 2920 static inline int security_key_permission(key_ref_t key_ref, 2921 const struct cred *cred, 2922 key_perm_t perm) 2923 { 2924 return 0; 2925 } 2926 2927 static inline int security_key_getsecurity(struct key *key, char **_buffer) 2928 { 2929 *_buffer = NULL; 2930 return 0; 2931 } 2932 2933 #endif 2934 #endif /* CONFIG_KEYS */ 2935 2936 #ifdef CONFIG_AUDIT 2937 #ifdef CONFIG_SECURITY 2938 int security_audit_rule_init(u32 field, u32 op, char *rulestr, void **lsmrule); 2939 int security_audit_rule_known(struct audit_krule *krule); 2940 int security_audit_rule_match(u32 secid, u32 field, u32 op, void *lsmrule, 2941 struct audit_context *actx); 2942 void security_audit_rule_free(void *lsmrule); 2943 2944 #else 2945 2946 static inline int security_audit_rule_init(u32 field, u32 op, char *rulestr, 2947 void **lsmrule) 2948 { 2949 return 0; 2950 } 2951 2952 static inline int security_audit_rule_known(struct audit_krule *krule) 2953 { 2954 return 0; 2955 } 2956 2957 static inline int security_audit_rule_match(u32 secid, u32 field, u32 op, 2958 void *lsmrule, struct audit_context *actx) 2959 { 2960 return 0; 2961 } 2962 2963 static inline void security_audit_rule_free(void *lsmrule) 2964 { } 2965 2966 #endif /* CONFIG_SECURITY */ 2967 #endif /* CONFIG_AUDIT */ 2968 2969 #ifdef CONFIG_SECURITYFS 2970 2971 extern struct dentry *securityfs_create_file(const char *name, umode_t mode, 2972 struct dentry *parent, void *data, 2973 const struct file_operations *fops); 2974 extern struct dentry *securityfs_create_dir(const char *name, struct dentry *parent); 2975 extern void securityfs_remove(struct dentry *dentry); 2976 2977 #else /* CONFIG_SECURITYFS */ 2978 2979 static inline struct dentry *securityfs_create_dir(const char *name, 2980 struct dentry *parent) 2981 { 2982 return ERR_PTR(-ENODEV); 2983 } 2984 2985 static inline struct dentry *securityfs_create_file(const char *name, 2986 umode_t mode, 2987 struct dentry *parent, 2988 void *data, 2989 const struct file_operations *fops) 2990 { 2991 return ERR_PTR(-ENODEV); 2992 } 2993 2994 static inline void securityfs_remove(struct dentry *dentry) 2995 {} 2996 2997 #endif 2998 2999 #ifdef CONFIG_SECURITY 3000 3001 static inline char *alloc_secdata(void) 3002 { 3003 return (char *)get_zeroed_page(GFP_KERNEL); 3004 } 3005 3006 static inline void free_secdata(void *secdata) 3007 { 3008 free_page((unsigned long)secdata); 3009 } 3010 3011 #else 3012 3013 static inline char *alloc_secdata(void) 3014 { 3015 return (char *)1; 3016 } 3017 3018 static inline void free_secdata(void *secdata) 3019 { } 3020 #endif /* CONFIG_SECURITY */ 3021 3022 #endif /* ! __LINUX_SECURITY_H */ 3023 3024