Back to home page

OSCL-LXR
 
 

     

0001 /* SPDX-License-Identifier: GPL-2.0 */
0002 /*
0003  * security/tomoyo/common.h
0004  *
0005  * Header file for TOMOYO.
0006  *
0007  * Copyright (C) 2005-2011  NTT DATA CORPORATION
0008  */
0009 
0010 #ifndef _SECURITY_TOMOYO_COMMON_H
0011 #define _SECURITY_TOMOYO_COMMON_H
0012 
0013 #define pr_fmt(fmt) fmt
0014 
0015 #include <linux/ctype.h>
0016 #include <linux/string.h>
0017 #include <linux/mm.h>
0018 #include <linux/file.h>
0019 #include <linux/kmod.h>
0020 #include <linux/fs.h>
0021 #include <linux/sched.h>
0022 #include <linux/namei.h>
0023 #include <linux/mount.h>
0024 #include <linux/list.h>
0025 #include <linux/cred.h>
0026 #include <linux/poll.h>
0027 #include <linux/binfmts.h>
0028 #include <linux/highmem.h>
0029 #include <linux/net.h>
0030 #include <linux/inet.h>
0031 #include <linux/in.h>
0032 #include <linux/in6.h>
0033 #include <linux/un.h>
0034 #include <linux/lsm_hooks.h>
0035 #include <net/sock.h>
0036 #include <net/af_unix.h>
0037 #include <net/ip.h>
0038 #include <net/ipv6.h>
0039 #include <net/udp.h>
0040 
0041 /********** Constants definitions. **********/
0042 
0043 /*
0044  * TOMOYO uses this hash only when appending a string into the string
0045  * table. Frequency of appending strings is very low. So we don't need
0046  * large (e.g. 64k) hash size. 256 will be sufficient.
0047  */
0048 #define TOMOYO_HASH_BITS  8
0049 #define TOMOYO_MAX_HASH (1u<<TOMOYO_HASH_BITS)
0050 
0051 /*
0052  * TOMOYO checks only SOCK_STREAM, SOCK_DGRAM, SOCK_RAW, SOCK_SEQPACKET.
0053  * Therefore, we don't need SOCK_MAX.
0054  */
0055 #define TOMOYO_SOCK_MAX 6
0056 
0057 #define TOMOYO_EXEC_TMPSIZE     4096
0058 
0059 /* Garbage collector is trying to kfree() this element. */
0060 #define TOMOYO_GC_IN_PROGRESS -1
0061 
0062 /* Profile number is an integer between 0 and 255. */
0063 #define TOMOYO_MAX_PROFILES 256
0064 
0065 /* Group number is an integer between 0 and 255. */
0066 #define TOMOYO_MAX_ACL_GROUPS 256
0067 
0068 /* Index numbers for "struct tomoyo_condition". */
0069 enum tomoyo_conditions_index {
0070     TOMOYO_TASK_UID,             /* current_uid()   */
0071     TOMOYO_TASK_EUID,            /* current_euid()  */
0072     TOMOYO_TASK_SUID,            /* current_suid()  */
0073     TOMOYO_TASK_FSUID,           /* current_fsuid() */
0074     TOMOYO_TASK_GID,             /* current_gid()   */
0075     TOMOYO_TASK_EGID,            /* current_egid()  */
0076     TOMOYO_TASK_SGID,            /* current_sgid()  */
0077     TOMOYO_TASK_FSGID,           /* current_fsgid() */
0078     TOMOYO_TASK_PID,             /* sys_getpid()   */
0079     TOMOYO_TASK_PPID,            /* sys_getppid()  */
0080     TOMOYO_EXEC_ARGC,            /* "struct linux_binprm *"->argc */
0081     TOMOYO_EXEC_ENVC,            /* "struct linux_binprm *"->envc */
0082     TOMOYO_TYPE_IS_SOCKET,       /* S_IFSOCK */
0083     TOMOYO_TYPE_IS_SYMLINK,      /* S_IFLNK */
0084     TOMOYO_TYPE_IS_FILE,         /* S_IFREG */
0085     TOMOYO_TYPE_IS_BLOCK_DEV,    /* S_IFBLK */
0086     TOMOYO_TYPE_IS_DIRECTORY,    /* S_IFDIR */
0087     TOMOYO_TYPE_IS_CHAR_DEV,     /* S_IFCHR */
0088     TOMOYO_TYPE_IS_FIFO,         /* S_IFIFO */
0089     TOMOYO_MODE_SETUID,          /* S_ISUID */
0090     TOMOYO_MODE_SETGID,          /* S_ISGID */
0091     TOMOYO_MODE_STICKY,          /* S_ISVTX */
0092     TOMOYO_MODE_OWNER_READ,      /* S_IRUSR */
0093     TOMOYO_MODE_OWNER_WRITE,     /* S_IWUSR */
0094     TOMOYO_MODE_OWNER_EXECUTE,   /* S_IXUSR */
0095     TOMOYO_MODE_GROUP_READ,      /* S_IRGRP */
0096     TOMOYO_MODE_GROUP_WRITE,     /* S_IWGRP */
0097     TOMOYO_MODE_GROUP_EXECUTE,   /* S_IXGRP */
0098     TOMOYO_MODE_OTHERS_READ,     /* S_IROTH */
0099     TOMOYO_MODE_OTHERS_WRITE,    /* S_IWOTH */
0100     TOMOYO_MODE_OTHERS_EXECUTE,  /* S_IXOTH */
0101     TOMOYO_EXEC_REALPATH,
0102     TOMOYO_SYMLINK_TARGET,
0103     TOMOYO_PATH1_UID,
0104     TOMOYO_PATH1_GID,
0105     TOMOYO_PATH1_INO,
0106     TOMOYO_PATH1_MAJOR,
0107     TOMOYO_PATH1_MINOR,
0108     TOMOYO_PATH1_PERM,
0109     TOMOYO_PATH1_TYPE,
0110     TOMOYO_PATH1_DEV_MAJOR,
0111     TOMOYO_PATH1_DEV_MINOR,
0112     TOMOYO_PATH2_UID,
0113     TOMOYO_PATH2_GID,
0114     TOMOYO_PATH2_INO,
0115     TOMOYO_PATH2_MAJOR,
0116     TOMOYO_PATH2_MINOR,
0117     TOMOYO_PATH2_PERM,
0118     TOMOYO_PATH2_TYPE,
0119     TOMOYO_PATH2_DEV_MAJOR,
0120     TOMOYO_PATH2_DEV_MINOR,
0121     TOMOYO_PATH1_PARENT_UID,
0122     TOMOYO_PATH1_PARENT_GID,
0123     TOMOYO_PATH1_PARENT_INO,
0124     TOMOYO_PATH1_PARENT_PERM,
0125     TOMOYO_PATH2_PARENT_UID,
0126     TOMOYO_PATH2_PARENT_GID,
0127     TOMOYO_PATH2_PARENT_INO,
0128     TOMOYO_PATH2_PARENT_PERM,
0129     TOMOYO_MAX_CONDITION_KEYWORD,
0130     TOMOYO_NUMBER_UNION,
0131     TOMOYO_NAME_UNION,
0132     TOMOYO_ARGV_ENTRY,
0133     TOMOYO_ENVP_ENTRY,
0134 };
0135 
0136 
0137 /* Index numbers for stat(). */
0138 enum tomoyo_path_stat_index {
0139     /* Do not change this order. */
0140     TOMOYO_PATH1,
0141     TOMOYO_PATH1_PARENT,
0142     TOMOYO_PATH2,
0143     TOMOYO_PATH2_PARENT,
0144     TOMOYO_MAX_PATH_STAT
0145 };
0146 
0147 /* Index numbers for operation mode. */
0148 enum tomoyo_mode_index {
0149     TOMOYO_CONFIG_DISABLED,
0150     TOMOYO_CONFIG_LEARNING,
0151     TOMOYO_CONFIG_PERMISSIVE,
0152     TOMOYO_CONFIG_ENFORCING,
0153     TOMOYO_CONFIG_MAX_MODE,
0154     TOMOYO_CONFIG_WANT_REJECT_LOG =  64,
0155     TOMOYO_CONFIG_WANT_GRANT_LOG  = 128,
0156     TOMOYO_CONFIG_USE_DEFAULT     = 255,
0157 };
0158 
0159 /* Index numbers for entry type. */
0160 enum tomoyo_policy_id {
0161     TOMOYO_ID_GROUP,
0162     TOMOYO_ID_ADDRESS_GROUP,
0163     TOMOYO_ID_PATH_GROUP,
0164     TOMOYO_ID_NUMBER_GROUP,
0165     TOMOYO_ID_TRANSITION_CONTROL,
0166     TOMOYO_ID_AGGREGATOR,
0167     TOMOYO_ID_MANAGER,
0168     TOMOYO_ID_CONDITION,
0169     TOMOYO_ID_NAME,
0170     TOMOYO_ID_ACL,
0171     TOMOYO_ID_DOMAIN,
0172     TOMOYO_MAX_POLICY
0173 };
0174 
0175 /* Index numbers for domain's attributes. */
0176 enum tomoyo_domain_info_flags_index {
0177     /* Quota warnning flag.   */
0178     TOMOYO_DIF_QUOTA_WARNED,
0179     /*
0180      * This domain was unable to create a new domain at
0181      * tomoyo_find_next_domain() because the name of the domain to be
0182      * created was too long or it could not allocate memory.
0183      * More than one process continued execve() without domain transition.
0184      */
0185     TOMOYO_DIF_TRANSITION_FAILED,
0186     TOMOYO_MAX_DOMAIN_INFO_FLAGS
0187 };
0188 
0189 /* Index numbers for audit type. */
0190 enum tomoyo_grant_log {
0191     /* Follow profile's configuration. */
0192     TOMOYO_GRANTLOG_AUTO,
0193     /* Do not generate grant log. */
0194     TOMOYO_GRANTLOG_NO,
0195     /* Generate grant_log. */
0196     TOMOYO_GRANTLOG_YES,
0197 };
0198 
0199 /* Index numbers for group entries. */
0200 enum tomoyo_group_id {
0201     TOMOYO_PATH_GROUP,
0202     TOMOYO_NUMBER_GROUP,
0203     TOMOYO_ADDRESS_GROUP,
0204     TOMOYO_MAX_GROUP
0205 };
0206 
0207 /* Index numbers for type of numeric values. */
0208 enum tomoyo_value_type {
0209     TOMOYO_VALUE_TYPE_INVALID,
0210     TOMOYO_VALUE_TYPE_DECIMAL,
0211     TOMOYO_VALUE_TYPE_OCTAL,
0212     TOMOYO_VALUE_TYPE_HEXADECIMAL,
0213 };
0214 
0215 /* Index numbers for domain transition control keywords. */
0216 enum tomoyo_transition_type {
0217     /* Do not change this order, */
0218     TOMOYO_TRANSITION_CONTROL_NO_RESET,
0219     TOMOYO_TRANSITION_CONTROL_RESET,
0220     TOMOYO_TRANSITION_CONTROL_NO_INITIALIZE,
0221     TOMOYO_TRANSITION_CONTROL_INITIALIZE,
0222     TOMOYO_TRANSITION_CONTROL_NO_KEEP,
0223     TOMOYO_TRANSITION_CONTROL_KEEP,
0224     TOMOYO_MAX_TRANSITION_TYPE
0225 };
0226 
0227 /* Index numbers for Access Controls. */
0228 enum tomoyo_acl_entry_type_index {
0229     TOMOYO_TYPE_PATH_ACL,
0230     TOMOYO_TYPE_PATH2_ACL,
0231     TOMOYO_TYPE_PATH_NUMBER_ACL,
0232     TOMOYO_TYPE_MKDEV_ACL,
0233     TOMOYO_TYPE_MOUNT_ACL,
0234     TOMOYO_TYPE_INET_ACL,
0235     TOMOYO_TYPE_UNIX_ACL,
0236     TOMOYO_TYPE_ENV_ACL,
0237     TOMOYO_TYPE_MANUAL_TASK_ACL,
0238 };
0239 
0240 /* Index numbers for access controls with one pathname. */
0241 enum tomoyo_path_acl_index {
0242     TOMOYO_TYPE_EXECUTE,
0243     TOMOYO_TYPE_READ,
0244     TOMOYO_TYPE_WRITE,
0245     TOMOYO_TYPE_APPEND,
0246     TOMOYO_TYPE_UNLINK,
0247     TOMOYO_TYPE_GETATTR,
0248     TOMOYO_TYPE_RMDIR,
0249     TOMOYO_TYPE_TRUNCATE,
0250     TOMOYO_TYPE_SYMLINK,
0251     TOMOYO_TYPE_CHROOT,
0252     TOMOYO_TYPE_UMOUNT,
0253     TOMOYO_MAX_PATH_OPERATION
0254 };
0255 
0256 /* Index numbers for /sys/kernel/security/tomoyo/stat interface. */
0257 enum tomoyo_memory_stat_type {
0258     TOMOYO_MEMORY_POLICY,
0259     TOMOYO_MEMORY_AUDIT,
0260     TOMOYO_MEMORY_QUERY,
0261     TOMOYO_MAX_MEMORY_STAT
0262 };
0263 
0264 enum tomoyo_mkdev_acl_index {
0265     TOMOYO_TYPE_MKBLOCK,
0266     TOMOYO_TYPE_MKCHAR,
0267     TOMOYO_MAX_MKDEV_OPERATION
0268 };
0269 
0270 /* Index numbers for socket operations. */
0271 enum tomoyo_network_acl_index {
0272     TOMOYO_NETWORK_BIND,    /* bind() operation. */
0273     TOMOYO_NETWORK_LISTEN,  /* listen() operation. */
0274     TOMOYO_NETWORK_CONNECT, /* connect() operation. */
0275     TOMOYO_NETWORK_SEND,    /* send() operation. */
0276     TOMOYO_MAX_NETWORK_OPERATION
0277 };
0278 
0279 /* Index numbers for access controls with two pathnames. */
0280 enum tomoyo_path2_acl_index {
0281     TOMOYO_TYPE_LINK,
0282     TOMOYO_TYPE_RENAME,
0283     TOMOYO_TYPE_PIVOT_ROOT,
0284     TOMOYO_MAX_PATH2_OPERATION
0285 };
0286 
0287 /* Index numbers for access controls with one pathname and one number. */
0288 enum tomoyo_path_number_acl_index {
0289     TOMOYO_TYPE_CREATE,
0290     TOMOYO_TYPE_MKDIR,
0291     TOMOYO_TYPE_MKFIFO,
0292     TOMOYO_TYPE_MKSOCK,
0293     TOMOYO_TYPE_IOCTL,
0294     TOMOYO_TYPE_CHMOD,
0295     TOMOYO_TYPE_CHOWN,
0296     TOMOYO_TYPE_CHGRP,
0297     TOMOYO_MAX_PATH_NUMBER_OPERATION
0298 };
0299 
0300 /* Index numbers for /sys/kernel/security/tomoyo/ interfaces. */
0301 enum tomoyo_securityfs_interface_index {
0302     TOMOYO_DOMAINPOLICY,
0303     TOMOYO_EXCEPTIONPOLICY,
0304     TOMOYO_PROCESS_STATUS,
0305     TOMOYO_STAT,
0306     TOMOYO_AUDIT,
0307     TOMOYO_VERSION,
0308     TOMOYO_PROFILE,
0309     TOMOYO_QUERY,
0310     TOMOYO_MANAGER
0311 };
0312 
0313 /* Index numbers for special mount operations. */
0314 enum tomoyo_special_mount {
0315     TOMOYO_MOUNT_BIND,            /* mount --bind /source /dest   */
0316     TOMOYO_MOUNT_MOVE,            /* mount --move /old /new       */
0317     TOMOYO_MOUNT_REMOUNT,         /* mount -o remount /dir        */
0318     TOMOYO_MOUNT_MAKE_UNBINDABLE, /* mount --make-unbindable /dir */
0319     TOMOYO_MOUNT_MAKE_PRIVATE,    /* mount --make-private /dir    */
0320     TOMOYO_MOUNT_MAKE_SLAVE,      /* mount --make-slave /dir      */
0321     TOMOYO_MOUNT_MAKE_SHARED,     /* mount --make-shared /dir     */
0322     TOMOYO_MAX_SPECIAL_MOUNT
0323 };
0324 
0325 /* Index numbers for functionality. */
0326 enum tomoyo_mac_index {
0327     TOMOYO_MAC_FILE_EXECUTE,
0328     TOMOYO_MAC_FILE_OPEN,
0329     TOMOYO_MAC_FILE_CREATE,
0330     TOMOYO_MAC_FILE_UNLINK,
0331     TOMOYO_MAC_FILE_GETATTR,
0332     TOMOYO_MAC_FILE_MKDIR,
0333     TOMOYO_MAC_FILE_RMDIR,
0334     TOMOYO_MAC_FILE_MKFIFO,
0335     TOMOYO_MAC_FILE_MKSOCK,
0336     TOMOYO_MAC_FILE_TRUNCATE,
0337     TOMOYO_MAC_FILE_SYMLINK,
0338     TOMOYO_MAC_FILE_MKBLOCK,
0339     TOMOYO_MAC_FILE_MKCHAR,
0340     TOMOYO_MAC_FILE_LINK,
0341     TOMOYO_MAC_FILE_RENAME,
0342     TOMOYO_MAC_FILE_CHMOD,
0343     TOMOYO_MAC_FILE_CHOWN,
0344     TOMOYO_MAC_FILE_CHGRP,
0345     TOMOYO_MAC_FILE_IOCTL,
0346     TOMOYO_MAC_FILE_CHROOT,
0347     TOMOYO_MAC_FILE_MOUNT,
0348     TOMOYO_MAC_FILE_UMOUNT,
0349     TOMOYO_MAC_FILE_PIVOT_ROOT,
0350     TOMOYO_MAC_NETWORK_INET_STREAM_BIND,
0351     TOMOYO_MAC_NETWORK_INET_STREAM_LISTEN,
0352     TOMOYO_MAC_NETWORK_INET_STREAM_CONNECT,
0353     TOMOYO_MAC_NETWORK_INET_DGRAM_BIND,
0354     TOMOYO_MAC_NETWORK_INET_DGRAM_SEND,
0355     TOMOYO_MAC_NETWORK_INET_RAW_BIND,
0356     TOMOYO_MAC_NETWORK_INET_RAW_SEND,
0357     TOMOYO_MAC_NETWORK_UNIX_STREAM_BIND,
0358     TOMOYO_MAC_NETWORK_UNIX_STREAM_LISTEN,
0359     TOMOYO_MAC_NETWORK_UNIX_STREAM_CONNECT,
0360     TOMOYO_MAC_NETWORK_UNIX_DGRAM_BIND,
0361     TOMOYO_MAC_NETWORK_UNIX_DGRAM_SEND,
0362     TOMOYO_MAC_NETWORK_UNIX_SEQPACKET_BIND,
0363     TOMOYO_MAC_NETWORK_UNIX_SEQPACKET_LISTEN,
0364     TOMOYO_MAC_NETWORK_UNIX_SEQPACKET_CONNECT,
0365     TOMOYO_MAC_ENVIRON,
0366     TOMOYO_MAX_MAC_INDEX
0367 };
0368 
0369 /* Index numbers for category of functionality. */
0370 enum tomoyo_mac_category_index {
0371     TOMOYO_MAC_CATEGORY_FILE,
0372     TOMOYO_MAC_CATEGORY_NETWORK,
0373     TOMOYO_MAC_CATEGORY_MISC,
0374     TOMOYO_MAX_MAC_CATEGORY_INDEX
0375 };
0376 
0377 /*
0378  * Retry this request. Returned by tomoyo_supervisor() if policy violation has
0379  * occurred in enforcing mode and the userspace daemon decided to retry.
0380  *
0381  * We must choose a positive value in order to distinguish "granted" (which is
0382  * 0) and "rejected" (which is a negative value) and "retry".
0383  */
0384 #define TOMOYO_RETRY_REQUEST 1
0385 
0386 /* Index numbers for /sys/kernel/security/tomoyo/stat interface. */
0387 enum tomoyo_policy_stat_type {
0388     /* Do not change this order. */
0389     TOMOYO_STAT_POLICY_UPDATES,
0390     TOMOYO_STAT_POLICY_LEARNING,   /* == TOMOYO_CONFIG_LEARNING */
0391     TOMOYO_STAT_POLICY_PERMISSIVE, /* == TOMOYO_CONFIG_PERMISSIVE */
0392     TOMOYO_STAT_POLICY_ENFORCING,  /* == TOMOYO_CONFIG_ENFORCING */
0393     TOMOYO_MAX_POLICY_STAT
0394 };
0395 
0396 /* Index numbers for profile's PREFERENCE values. */
0397 enum tomoyo_pref_index {
0398     TOMOYO_PREF_MAX_AUDIT_LOG,
0399     TOMOYO_PREF_MAX_LEARNING_ENTRY,
0400     TOMOYO_MAX_PREF
0401 };
0402 
0403 /********** Structure definitions. **********/
0404 
0405 /* Common header for holding ACL entries. */
0406 struct tomoyo_acl_head {
0407     struct list_head list;
0408     s8 is_deleted; /* true or false or TOMOYO_GC_IN_PROGRESS */
0409 } __packed;
0410 
0411 /* Common header for shared entries. */
0412 struct tomoyo_shared_acl_head {
0413     struct list_head list;
0414     atomic_t users;
0415 } __packed;
0416 
0417 struct tomoyo_policy_namespace;
0418 
0419 /* Structure for request info. */
0420 struct tomoyo_request_info {
0421     /*
0422      * For holding parameters specific to operations which deal files.
0423      * NULL if not dealing files.
0424      */
0425     struct tomoyo_obj_info *obj;
0426     /*
0427      * For holding parameters specific to execve() request.
0428      * NULL if not dealing execve().
0429      */
0430     struct tomoyo_execve *ee;
0431     struct tomoyo_domain_info *domain;
0432     /* For holding parameters. */
0433     union {
0434         struct {
0435             const struct tomoyo_path_info *filename;
0436             /* For using wildcards at tomoyo_find_next_domain(). */
0437             const struct tomoyo_path_info *matched_path;
0438             /* One of values in "enum tomoyo_path_acl_index". */
0439             u8 operation;
0440         } path;
0441         struct {
0442             const struct tomoyo_path_info *filename1;
0443             const struct tomoyo_path_info *filename2;
0444             /* One of values in "enum tomoyo_path2_acl_index". */
0445             u8 operation;
0446         } path2;
0447         struct {
0448             const struct tomoyo_path_info *filename;
0449             unsigned int mode;
0450             unsigned int major;
0451             unsigned int minor;
0452             /* One of values in "enum tomoyo_mkdev_acl_index". */
0453             u8 operation;
0454         } mkdev;
0455         struct {
0456             const struct tomoyo_path_info *filename;
0457             unsigned long number;
0458             /*
0459              * One of values in
0460              * "enum tomoyo_path_number_acl_index".
0461              */
0462             u8 operation;
0463         } path_number;
0464         struct {
0465             const struct tomoyo_path_info *name;
0466         } environ;
0467         struct {
0468             const __be32 *address;
0469             u16 port;
0470             /* One of values smaller than TOMOYO_SOCK_MAX. */
0471             u8 protocol;
0472             /* One of values in "enum tomoyo_network_acl_index". */
0473             u8 operation;
0474             bool is_ipv6;
0475         } inet_network;
0476         struct {
0477             const struct tomoyo_path_info *address;
0478             /* One of values smaller than TOMOYO_SOCK_MAX. */
0479             u8 protocol;
0480             /* One of values in "enum tomoyo_network_acl_index". */
0481             u8 operation;
0482         } unix_network;
0483         struct {
0484             const struct tomoyo_path_info *type;
0485             const struct tomoyo_path_info *dir;
0486             const struct tomoyo_path_info *dev;
0487             unsigned long flags;
0488             int need_dev;
0489         } mount;
0490         struct {
0491             const struct tomoyo_path_info *domainname;
0492         } task;
0493     } param;
0494     struct tomoyo_acl_info *matched_acl;
0495     u8 param_type;
0496     bool granted;
0497     u8 retry;
0498     u8 profile;
0499     u8 mode; /* One of tomoyo_mode_index . */
0500     u8 type;
0501 };
0502 
0503 /* Structure for holding a token. */
0504 struct tomoyo_path_info {
0505     const char *name;
0506     u32 hash;          /* = full_name_hash(name, strlen(name)) */
0507     u16 const_len;     /* = tomoyo_const_part_length(name)     */
0508     bool is_dir;       /* = tomoyo_strendswith(name, "/")      */
0509     bool is_patterned; /* = tomoyo_path_contains_pattern(name) */
0510 };
0511 
0512 /* Structure for holding string data. */
0513 struct tomoyo_name {
0514     struct tomoyo_shared_acl_head head;
0515     struct tomoyo_path_info entry;
0516 };
0517 
0518 /* Structure for holding a word. */
0519 struct tomoyo_name_union {
0520     /* Either @filename or @group is NULL. */
0521     const struct tomoyo_path_info *filename;
0522     struct tomoyo_group *group;
0523 };
0524 
0525 /* Structure for holding a number. */
0526 struct tomoyo_number_union {
0527     unsigned long values[2];
0528     struct tomoyo_group *group; /* Maybe NULL. */
0529     /* One of values in "enum tomoyo_value_type". */
0530     u8 value_type[2];
0531 };
0532 
0533 /* Structure for holding an IP address. */
0534 struct tomoyo_ipaddr_union {
0535     struct in6_addr ip[2]; /* Big endian. */
0536     struct tomoyo_group *group; /* Pointer to address group. */
0537     bool is_ipv6; /* Valid only if @group == NULL. */
0538 };
0539 
0540 /* Structure for "path_group"/"number_group"/"address_group" directive. */
0541 struct tomoyo_group {
0542     struct tomoyo_shared_acl_head head;
0543     const struct tomoyo_path_info *group_name;
0544     struct list_head member_list;
0545 };
0546 
0547 /* Structure for "path_group" directive. */
0548 struct tomoyo_path_group {
0549     struct tomoyo_acl_head head;
0550     const struct tomoyo_path_info *member_name;
0551 };
0552 
0553 /* Structure for "number_group" directive. */
0554 struct tomoyo_number_group {
0555     struct tomoyo_acl_head head;
0556     struct tomoyo_number_union number;
0557 };
0558 
0559 /* Structure for "address_group" directive. */
0560 struct tomoyo_address_group {
0561     struct tomoyo_acl_head head;
0562     /* Structure for holding an IP address. */
0563     struct tomoyo_ipaddr_union address;
0564 };
0565 
0566 /* Subset of "struct stat". Used by conditional ACL and audit logs. */
0567 struct tomoyo_mini_stat {
0568     kuid_t uid;
0569     kgid_t gid;
0570     ino_t ino;
0571     umode_t mode;
0572     dev_t dev;
0573     dev_t rdev;
0574 };
0575 
0576 /* Structure for dumping argv[] and envp[] of "struct linux_binprm". */
0577 struct tomoyo_page_dump {
0578     struct page *page;    /* Previously dumped page. */
0579     char *data;           /* Contents of "page". Size is PAGE_SIZE. */
0580 };
0581 
0582 /* Structure for attribute checks in addition to pathname checks. */
0583 struct tomoyo_obj_info {
0584     /*
0585      * True if tomoyo_get_attributes() was already called, false otherwise.
0586      */
0587     bool validate_done;
0588     /* True if @stat[] is valid. */
0589     bool stat_valid[TOMOYO_MAX_PATH_STAT];
0590     /* First pathname. Initialized with { NULL, NULL } if no path. */
0591     struct path path1;
0592     /* Second pathname. Initialized with { NULL, NULL } if no path. */
0593     struct path path2;
0594     /*
0595      * Information on @path1, @path1's parent directory, @path2, @path2's
0596      * parent directory.
0597      */
0598     struct tomoyo_mini_stat stat[TOMOYO_MAX_PATH_STAT];
0599     /*
0600      * Content of symbolic link to be created. NULL for operations other
0601      * than symlink().
0602      */
0603     struct tomoyo_path_info *symlink_target;
0604 };
0605 
0606 /* Structure for argv[]. */
0607 struct tomoyo_argv {
0608     unsigned long index;
0609     const struct tomoyo_path_info *value;
0610     bool is_not;
0611 };
0612 
0613 /* Structure for envp[]. */
0614 struct tomoyo_envp {
0615     const struct tomoyo_path_info *name;
0616     const struct tomoyo_path_info *value;
0617     bool is_not;
0618 };
0619 
0620 /* Structure for execve() operation. */
0621 struct tomoyo_execve {
0622     struct tomoyo_request_info r;
0623     struct tomoyo_obj_info obj;
0624     struct linux_binprm *bprm;
0625     const struct tomoyo_path_info *transition;
0626     /* For dumping argv[] and envp[]. */
0627     struct tomoyo_page_dump dump;
0628     /* For temporary use. */
0629     char *tmp; /* Size is TOMOYO_EXEC_TMPSIZE bytes */
0630 };
0631 
0632 /* Structure for entries which follows "struct tomoyo_condition". */
0633 struct tomoyo_condition_element {
0634     /*
0635      * Left hand operand. A "struct tomoyo_argv" for TOMOYO_ARGV_ENTRY, a
0636      * "struct tomoyo_envp" for TOMOYO_ENVP_ENTRY is attached to the tail
0637      * of the array of this struct.
0638      */
0639     u8 left;
0640     /*
0641      * Right hand operand. A "struct tomoyo_number_union" for
0642      * TOMOYO_NUMBER_UNION, a "struct tomoyo_name_union" for
0643      * TOMOYO_NAME_UNION is attached to the tail of the array of this
0644      * struct.
0645      */
0646     u8 right;
0647     /* Equation operator. True if equals or overlaps, false otherwise. */
0648     bool equals;
0649 };
0650 
0651 /* Structure for optional arguments. */
0652 struct tomoyo_condition {
0653     struct tomoyo_shared_acl_head head;
0654     u32 size; /* Memory size allocated for this entry. */
0655     u16 condc; /* Number of conditions in this struct. */
0656     u16 numbers_count; /* Number of "struct tomoyo_number_union values". */
0657     u16 names_count; /* Number of "struct tomoyo_name_union names". */
0658     u16 argc; /* Number of "struct tomoyo_argv". */
0659     u16 envc; /* Number of "struct tomoyo_envp". */
0660     u8 grant_log; /* One of values in "enum tomoyo_grant_log". */
0661     const struct tomoyo_path_info *transit; /* Maybe NULL. */
0662     /*
0663      * struct tomoyo_condition_element condition[condc];
0664      * struct tomoyo_number_union values[numbers_count];
0665      * struct tomoyo_name_union names[names_count];
0666      * struct tomoyo_argv argv[argc];
0667      * struct tomoyo_envp envp[envc];
0668      */
0669 };
0670 
0671 /* Common header for individual entries. */
0672 struct tomoyo_acl_info {
0673     struct list_head list;
0674     struct tomoyo_condition *cond; /* Maybe NULL. */
0675     s8 is_deleted; /* true or false or TOMOYO_GC_IN_PROGRESS */
0676     u8 type; /* One of values in "enum tomoyo_acl_entry_type_index". */
0677 } __packed;
0678 
0679 /* Structure for domain information. */
0680 struct tomoyo_domain_info {
0681     struct list_head list;
0682     struct list_head acl_info_list;
0683     /* Name of this domain. Never NULL.          */
0684     const struct tomoyo_path_info *domainname;
0685     /* Namespace for this domain. Never NULL. */
0686     struct tomoyo_policy_namespace *ns;
0687     /* Group numbers to use.   */
0688     unsigned long group[TOMOYO_MAX_ACL_GROUPS / BITS_PER_LONG];
0689     u8 profile;        /* Profile number to use. */
0690     bool is_deleted;   /* Delete flag.           */
0691     bool flags[TOMOYO_MAX_DOMAIN_INFO_FLAGS];
0692     atomic_t users; /* Number of referring tasks. */
0693 };
0694 
0695 /*
0696  * Structure for "task manual_domain_transition" directive.
0697  */
0698 struct tomoyo_task_acl {
0699     struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_MANUAL_TASK_ACL */
0700     /* Pointer to domainname. */
0701     const struct tomoyo_path_info *domainname;
0702 };
0703 
0704 /*
0705  * Structure for "file execute", "file read", "file write", "file append",
0706  * "file unlink", "file getattr", "file rmdir", "file truncate",
0707  * "file symlink", "file chroot" and "file unmount" directive.
0708  */
0709 struct tomoyo_path_acl {
0710     struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_PATH_ACL */
0711     u16 perm; /* Bitmask of values in "enum tomoyo_path_acl_index". */
0712     struct tomoyo_name_union name;
0713 };
0714 
0715 /*
0716  * Structure for "file create", "file mkdir", "file mkfifo", "file mksock",
0717  * "file ioctl", "file chmod", "file chown" and "file chgrp" directive.
0718  */
0719 struct tomoyo_path_number_acl {
0720     struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_PATH_NUMBER_ACL */
0721     /* Bitmask of values in "enum tomoyo_path_number_acl_index". */
0722     u8 perm;
0723     struct tomoyo_name_union name;
0724     struct tomoyo_number_union number;
0725 };
0726 
0727 /* Structure for "file mkblock" and "file mkchar" directive. */
0728 struct tomoyo_mkdev_acl {
0729     struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_MKDEV_ACL */
0730     u8 perm; /* Bitmask of values in "enum tomoyo_mkdev_acl_index". */
0731     struct tomoyo_name_union name;
0732     struct tomoyo_number_union mode;
0733     struct tomoyo_number_union major;
0734     struct tomoyo_number_union minor;
0735 };
0736 
0737 /*
0738  * Structure for "file rename", "file link" and "file pivot_root" directive.
0739  */
0740 struct tomoyo_path2_acl {
0741     struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_PATH2_ACL */
0742     u8 perm; /* Bitmask of values in "enum tomoyo_path2_acl_index". */
0743     struct tomoyo_name_union name1;
0744     struct tomoyo_name_union name2;
0745 };
0746 
0747 /* Structure for "file mount" directive. */
0748 struct tomoyo_mount_acl {
0749     struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_MOUNT_ACL */
0750     struct tomoyo_name_union dev_name;
0751     struct tomoyo_name_union dir_name;
0752     struct tomoyo_name_union fs_type;
0753     struct tomoyo_number_union flags;
0754 };
0755 
0756 /* Structure for "misc env" directive in domain policy. */
0757 struct tomoyo_env_acl {
0758     struct tomoyo_acl_info head;        /* type = TOMOYO_TYPE_ENV_ACL  */
0759     const struct tomoyo_path_info *env; /* environment variable */
0760 };
0761 
0762 /* Structure for "network inet" directive. */
0763 struct tomoyo_inet_acl {
0764     struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_INET_ACL */
0765     u8 protocol;
0766     u8 perm; /* Bitmask of values in "enum tomoyo_network_acl_index" */
0767     struct tomoyo_ipaddr_union address;
0768     struct tomoyo_number_union port;
0769 };
0770 
0771 /* Structure for "network unix" directive. */
0772 struct tomoyo_unix_acl {
0773     struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_UNIX_ACL */
0774     u8 protocol;
0775     u8 perm; /* Bitmask of values in "enum tomoyo_network_acl_index" */
0776     struct tomoyo_name_union name;
0777 };
0778 
0779 /* Structure for holding a line from /sys/kernel/security/tomoyo/ interface. */
0780 struct tomoyo_acl_param {
0781     char *data;
0782     struct list_head *list;
0783     struct tomoyo_policy_namespace *ns;
0784     bool is_delete;
0785 };
0786 
0787 #define TOMOYO_MAX_IO_READ_QUEUE 64
0788 
0789 /*
0790  * Structure for reading/writing policy via /sys/kernel/security/tomoyo
0791  * interfaces.
0792  */
0793 struct tomoyo_io_buffer {
0794     void (*read)(struct tomoyo_io_buffer *head);
0795     int (*write)(struct tomoyo_io_buffer *head);
0796     __poll_t (*poll)(struct file *file, poll_table *wait);
0797     /* Exclusive lock for this structure.   */
0798     struct mutex io_sem;
0799     char __user *read_user_buf;
0800     size_t read_user_buf_avail;
0801     struct {
0802         struct list_head *ns;
0803         struct list_head *domain;
0804         struct list_head *group;
0805         struct list_head *acl;
0806         size_t avail;
0807         unsigned int step;
0808         unsigned int query_index;
0809         u16 index;
0810         u16 cond_index;
0811         u8 acl_group_index;
0812         u8 cond_step;
0813         u8 bit;
0814         u8 w_pos;
0815         bool eof;
0816         bool print_this_domain_only;
0817         bool print_transition_related_only;
0818         bool print_cond_part;
0819         const char *w[TOMOYO_MAX_IO_READ_QUEUE];
0820     } r;
0821     struct {
0822         struct tomoyo_policy_namespace *ns;
0823         /* The position currently writing to.   */
0824         struct tomoyo_domain_info *domain;
0825         /* Bytes available for writing.         */
0826         size_t avail;
0827         bool is_delete;
0828     } w;
0829     /* Buffer for reading.                  */
0830     char *read_buf;
0831     /* Size of read buffer.                 */
0832     size_t readbuf_size;
0833     /* Buffer for writing.                  */
0834     char *write_buf;
0835     /* Size of write buffer.                */
0836     size_t writebuf_size;
0837     /* Type of this interface.              */
0838     enum tomoyo_securityfs_interface_index type;
0839     /* Users counter protected by tomoyo_io_buffer_list_lock. */
0840     u8 users;
0841     /* List for telling GC not to kfree() elements. */
0842     struct list_head list;
0843 };
0844 
0845 /*
0846  * Structure for "initialize_domain"/"no_initialize_domain"/"keep_domain"/
0847  * "no_keep_domain" keyword.
0848  */
0849 struct tomoyo_transition_control {
0850     struct tomoyo_acl_head head;
0851     u8 type; /* One of values in "enum tomoyo_transition_type".  */
0852     /* True if the domainname is tomoyo_get_last_name(). */
0853     bool is_last_name;
0854     const struct tomoyo_path_info *domainname; /* Maybe NULL */
0855     const struct tomoyo_path_info *program;    /* Maybe NULL */
0856 };
0857 
0858 /* Structure for "aggregator" keyword. */
0859 struct tomoyo_aggregator {
0860     struct tomoyo_acl_head head;
0861     const struct tomoyo_path_info *original_name;
0862     const struct tomoyo_path_info *aggregated_name;
0863 };
0864 
0865 /* Structure for policy manager. */
0866 struct tomoyo_manager {
0867     struct tomoyo_acl_head head;
0868     /* A path to program or a domainname. */
0869     const struct tomoyo_path_info *manager;
0870 };
0871 
0872 struct tomoyo_preference {
0873     unsigned int learning_max_entry;
0874     bool enforcing_verbose;
0875     bool learning_verbose;
0876     bool permissive_verbose;
0877 };
0878 
0879 /* Structure for /sys/kernel/security/tomnoyo/profile interface. */
0880 struct tomoyo_profile {
0881     const struct tomoyo_path_info *comment;
0882     struct tomoyo_preference *learning;
0883     struct tomoyo_preference *permissive;
0884     struct tomoyo_preference *enforcing;
0885     struct tomoyo_preference preference;
0886     u8 default_config;
0887     u8 config[TOMOYO_MAX_MAC_INDEX + TOMOYO_MAX_MAC_CATEGORY_INDEX];
0888     unsigned int pref[TOMOYO_MAX_PREF];
0889 };
0890 
0891 /* Structure for representing YYYY/MM/DD hh/mm/ss. */
0892 struct tomoyo_time {
0893     u16 year;
0894     u8 month;
0895     u8 day;
0896     u8 hour;
0897     u8 min;
0898     u8 sec;
0899 };
0900 
0901 /* Structure for policy namespace. */
0902 struct tomoyo_policy_namespace {
0903     /* Profile table. Memory is allocated as needed. */
0904     struct tomoyo_profile *profile_ptr[TOMOYO_MAX_PROFILES];
0905     /* List of "struct tomoyo_group". */
0906     struct list_head group_list[TOMOYO_MAX_GROUP];
0907     /* List of policy. */
0908     struct list_head policy_list[TOMOYO_MAX_POLICY];
0909     /* The global ACL referred by "use_group" keyword. */
0910     struct list_head acl_group[TOMOYO_MAX_ACL_GROUPS];
0911     /* List for connecting to tomoyo_namespace_list list. */
0912     struct list_head namespace_list;
0913     /* Profile version. Currently only 20150505 is defined. */
0914     unsigned int profile_version;
0915     /* Name of this namespace (e.g. "<kernel>", "</usr/sbin/httpd>" ). */
0916     const char *name;
0917 };
0918 
0919 /* Structure for "struct task_struct"->security. */
0920 struct tomoyo_task {
0921     struct tomoyo_domain_info *domain_info;
0922     struct tomoyo_domain_info *old_domain_info;
0923 };
0924 
0925 /********** Function prototypes. **********/
0926 
0927 bool tomoyo_address_matches_group(const bool is_ipv6, const __be32 *address,
0928                   const struct tomoyo_group *group);
0929 bool tomoyo_compare_number_union(const unsigned long value,
0930                  const struct tomoyo_number_union *ptr);
0931 bool tomoyo_condition(struct tomoyo_request_info *r,
0932               const struct tomoyo_condition *cond);
0933 bool tomoyo_correct_domain(const unsigned char *domainname);
0934 bool tomoyo_correct_path(const char *filename);
0935 bool tomoyo_correct_word(const char *string);
0936 bool tomoyo_domain_def(const unsigned char *buffer);
0937 bool tomoyo_domain_quota_is_ok(struct tomoyo_request_info *r);
0938 bool tomoyo_dump_page(struct linux_binprm *bprm, unsigned long pos,
0939               struct tomoyo_page_dump *dump);
0940 bool tomoyo_memory_ok(void *ptr);
0941 bool tomoyo_number_matches_group(const unsigned long min,
0942                  const unsigned long max,
0943                  const struct tomoyo_group *group);
0944 bool tomoyo_parse_ipaddr_union(struct tomoyo_acl_param *param,
0945                    struct tomoyo_ipaddr_union *ptr);
0946 bool tomoyo_parse_name_union(struct tomoyo_acl_param *param,
0947                  struct tomoyo_name_union *ptr);
0948 bool tomoyo_parse_number_union(struct tomoyo_acl_param *param,
0949                    struct tomoyo_number_union *ptr);
0950 bool tomoyo_path_matches_pattern(const struct tomoyo_path_info *filename,
0951                  const struct tomoyo_path_info *pattern);
0952 bool tomoyo_permstr(const char *string, const char *keyword);
0953 bool tomoyo_str_starts(char **src, const char *find);
0954 char *tomoyo_encode(const char *str);
0955 char *tomoyo_encode2(const char *str, int str_len);
0956 char *tomoyo_init_log(struct tomoyo_request_info *r, int len, const char *fmt,
0957               va_list args);
0958 char *tomoyo_read_token(struct tomoyo_acl_param *param);
0959 char *tomoyo_realpath_from_path(const struct path *path);
0960 char *tomoyo_realpath_nofollow(const char *pathname);
0961 const char *tomoyo_get_exe(void);
0962 const struct tomoyo_path_info *tomoyo_compare_name_union
0963 (const struct tomoyo_path_info *name, const struct tomoyo_name_union *ptr);
0964 const struct tomoyo_path_info *tomoyo_get_domainname
0965 (struct tomoyo_acl_param *param);
0966 const struct tomoyo_path_info *tomoyo_get_name(const char *name);
0967 const struct tomoyo_path_info *tomoyo_path_matches_group
0968 (const struct tomoyo_path_info *pathname, const struct tomoyo_group *group);
0969 int tomoyo_check_open_permission(struct tomoyo_domain_info *domain,
0970                  const struct path *path, const int flag);
0971 void tomoyo_close_control(struct tomoyo_io_buffer *head);
0972 int tomoyo_env_perm(struct tomoyo_request_info *r, const char *env);
0973 int tomoyo_execute_permission(struct tomoyo_request_info *r,
0974                   const struct tomoyo_path_info *filename);
0975 int tomoyo_find_next_domain(struct linux_binprm *bprm);
0976 int tomoyo_get_mode(const struct tomoyo_policy_namespace *ns, const u8 profile,
0977             const u8 index);
0978 int tomoyo_init_request_info(struct tomoyo_request_info *r,
0979                  struct tomoyo_domain_info *domain,
0980                  const u8 index);
0981 int tomoyo_mkdev_perm(const u8 operation, const struct path *path,
0982               const unsigned int mode, unsigned int dev);
0983 int tomoyo_mount_permission(const char *dev_name, const struct path *path,
0984                 const char *type, unsigned long flags,
0985                 void *data_page);
0986 int tomoyo_open_control(const u8 type, struct file *file);
0987 int tomoyo_path2_perm(const u8 operation, const struct path *path1,
0988               const struct path *path2);
0989 int tomoyo_path_number_perm(const u8 operation, const struct path *path,
0990                 unsigned long number);
0991 int tomoyo_path_perm(const u8 operation, const struct path *path,
0992              const char *target);
0993 __poll_t tomoyo_poll_control(struct file *file, poll_table *wait);
0994 __poll_t tomoyo_poll_log(struct file *file, poll_table *wait);
0995 int tomoyo_socket_bind_permission(struct socket *sock, struct sockaddr *addr,
0996                   int addr_len);
0997 int tomoyo_socket_connect_permission(struct socket *sock,
0998                      struct sockaddr *addr, int addr_len);
0999 int tomoyo_socket_listen_permission(struct socket *sock);
1000 int tomoyo_socket_sendmsg_permission(struct socket *sock, struct msghdr *msg,
1001                      int size);
1002 int tomoyo_supervisor(struct tomoyo_request_info *r, const char *fmt, ...)
1003     __printf(2, 3);
1004 int tomoyo_update_domain(struct tomoyo_acl_info *new_entry, const int size,
1005              struct tomoyo_acl_param *param,
1006              bool (*check_duplicate)
1007              (const struct tomoyo_acl_info *,
1008               const struct tomoyo_acl_info *),
1009              bool (*merge_duplicate)
1010              (struct tomoyo_acl_info *, struct tomoyo_acl_info *,
1011               const bool));
1012 int tomoyo_update_policy(struct tomoyo_acl_head *new_entry, const int size,
1013              struct tomoyo_acl_param *param,
1014              bool (*check_duplicate)
1015              (const struct tomoyo_acl_head *,
1016               const struct tomoyo_acl_head *));
1017 int tomoyo_write_aggregator(struct tomoyo_acl_param *param);
1018 int tomoyo_write_file(struct tomoyo_acl_param *param);
1019 int tomoyo_write_group(struct tomoyo_acl_param *param, const u8 type);
1020 int tomoyo_write_misc(struct tomoyo_acl_param *param);
1021 int tomoyo_write_inet_network(struct tomoyo_acl_param *param);
1022 int tomoyo_write_transition_control(struct tomoyo_acl_param *param,
1023                     const u8 type);
1024 int tomoyo_write_unix_network(struct tomoyo_acl_param *param);
1025 ssize_t tomoyo_read_control(struct tomoyo_io_buffer *head, char __user *buffer,
1026                 const int buffer_len);
1027 ssize_t tomoyo_write_control(struct tomoyo_io_buffer *head,
1028                  const char __user *buffer, const int buffer_len);
1029 struct tomoyo_condition *tomoyo_get_condition(struct tomoyo_acl_param *param);
1030 struct tomoyo_domain_info *tomoyo_assign_domain(const char *domainname,
1031                         const bool transit);
1032 struct tomoyo_domain_info *tomoyo_domain(void);
1033 struct tomoyo_domain_info *tomoyo_find_domain(const char *domainname);
1034 struct tomoyo_group *tomoyo_get_group(struct tomoyo_acl_param *param,
1035                       const u8 idx);
1036 struct tomoyo_policy_namespace *tomoyo_assign_namespace
1037 (const char *domainname);
1038 struct tomoyo_profile *tomoyo_profile(const struct tomoyo_policy_namespace *ns,
1039                       const u8 profile);
1040 unsigned int tomoyo_check_flags(const struct tomoyo_domain_info *domain,
1041                 const u8 index);
1042 u8 tomoyo_parse_ulong(unsigned long *result, char **str);
1043 void *tomoyo_commit_ok(void *data, const unsigned int size);
1044 void __init tomoyo_load_builtin_policy(void);
1045 void __init tomoyo_mm_init(void);
1046 void tomoyo_check_acl(struct tomoyo_request_info *r,
1047               bool (*check_entry)(struct tomoyo_request_info *,
1048                       const struct tomoyo_acl_info *));
1049 void tomoyo_check_profile(void);
1050 void tomoyo_convert_time(time64_t time, struct tomoyo_time *stamp);
1051 void tomoyo_del_condition(struct list_head *element);
1052 void tomoyo_fill_path_info(struct tomoyo_path_info *ptr);
1053 void tomoyo_get_attributes(struct tomoyo_obj_info *obj);
1054 void tomoyo_init_policy_namespace(struct tomoyo_policy_namespace *ns);
1055 void tomoyo_load_policy(const char *filename);
1056 void tomoyo_normalize_line(unsigned char *buffer);
1057 void tomoyo_notify_gc(struct tomoyo_io_buffer *head, const bool is_register);
1058 void tomoyo_print_ip(char *buf, const unsigned int size,
1059              const struct tomoyo_ipaddr_union *ptr);
1060 void tomoyo_print_ulong(char *buffer, const int buffer_len,
1061             const unsigned long value, const u8 type);
1062 void tomoyo_put_name_union(struct tomoyo_name_union *ptr);
1063 void tomoyo_put_number_union(struct tomoyo_number_union *ptr);
1064 void tomoyo_read_log(struct tomoyo_io_buffer *head);
1065 void tomoyo_update_stat(const u8 index);
1066 void tomoyo_warn_oom(const char *function);
1067 void tomoyo_write_log(struct tomoyo_request_info *r, const char *fmt, ...)
1068     __printf(2, 3);
1069 void tomoyo_write_log2(struct tomoyo_request_info *r, int len, const char *fmt,
1070                va_list args);
1071 
1072 /********** External variable definitions. **********/
1073 
1074 extern bool tomoyo_policy_loaded;
1075 extern int tomoyo_enabled;
1076 extern const char * const tomoyo_condition_keyword
1077 [TOMOYO_MAX_CONDITION_KEYWORD];
1078 extern const char * const tomoyo_dif[TOMOYO_MAX_DOMAIN_INFO_FLAGS];
1079 extern const char * const tomoyo_mac_keywords[TOMOYO_MAX_MAC_INDEX
1080                           + TOMOYO_MAX_MAC_CATEGORY_INDEX];
1081 extern const char * const tomoyo_mode[TOMOYO_CONFIG_MAX_MODE];
1082 extern const char * const tomoyo_path_keyword[TOMOYO_MAX_PATH_OPERATION];
1083 extern const char * const tomoyo_proto_keyword[TOMOYO_SOCK_MAX];
1084 extern const char * const tomoyo_socket_keyword[TOMOYO_MAX_NETWORK_OPERATION];
1085 extern const u8 tomoyo_index2category[TOMOYO_MAX_MAC_INDEX];
1086 extern const u8 tomoyo_pn2mac[TOMOYO_MAX_PATH_NUMBER_OPERATION];
1087 extern const u8 tomoyo_pnnn2mac[TOMOYO_MAX_MKDEV_OPERATION];
1088 extern const u8 tomoyo_pp2mac[TOMOYO_MAX_PATH2_OPERATION];
1089 extern struct list_head tomoyo_condition_list;
1090 extern struct list_head tomoyo_domain_list;
1091 extern struct list_head tomoyo_name_list[TOMOYO_MAX_HASH];
1092 extern struct list_head tomoyo_namespace_list;
1093 extern struct mutex tomoyo_policy_lock;
1094 extern struct srcu_struct tomoyo_ss;
1095 extern struct tomoyo_domain_info tomoyo_kernel_domain;
1096 extern struct tomoyo_policy_namespace tomoyo_kernel_namespace;
1097 extern unsigned int tomoyo_memory_quota[TOMOYO_MAX_MEMORY_STAT];
1098 extern unsigned int tomoyo_memory_used[TOMOYO_MAX_MEMORY_STAT];
1099 extern struct lsm_blob_sizes tomoyo_blob_sizes;
1100 
1101 /********** Inlined functions. **********/
1102 
1103 /**
1104  * tomoyo_read_lock - Take lock for protecting policy.
1105  *
1106  * Returns index number for tomoyo_read_unlock().
1107  */
1108 static inline int tomoyo_read_lock(void)
1109 {
1110     return srcu_read_lock(&tomoyo_ss);
1111 }
1112 
1113 /**
1114  * tomoyo_read_unlock - Release lock for protecting policy.
1115  *
1116  * @idx: Index number returned by tomoyo_read_lock().
1117  *
1118  * Returns nothing.
1119  */
1120 static inline void tomoyo_read_unlock(int idx)
1121 {
1122     srcu_read_unlock(&tomoyo_ss, idx);
1123 }
1124 
1125 /**
1126  * tomoyo_sys_getppid - Copy of getppid().
1127  *
1128  * Returns parent process's PID.
1129  *
1130  * Alpha does not have getppid() defined. To be able to build this module on
1131  * Alpha, I have to copy getppid() from kernel/timer.c.
1132  */
1133 static inline pid_t tomoyo_sys_getppid(void)
1134 {
1135     pid_t pid;
1136 
1137     rcu_read_lock();
1138     pid = task_tgid_vnr(rcu_dereference(current->real_parent));
1139     rcu_read_unlock();
1140     return pid;
1141 }
1142 
1143 /**
1144  * tomoyo_sys_getpid - Copy of getpid().
1145  *
1146  * Returns current thread's PID.
1147  *
1148  * Alpha does not have getpid() defined. To be able to build this module on
1149  * Alpha, I have to copy getpid() from kernel/timer.c.
1150  */
1151 static inline pid_t tomoyo_sys_getpid(void)
1152 {
1153     return task_tgid_vnr(current);
1154 }
1155 
1156 /**
1157  * tomoyo_pathcmp - strcmp() for "struct tomoyo_path_info" structure.
1158  *
1159  * @a: Pointer to "struct tomoyo_path_info".
1160  * @b: Pointer to "struct tomoyo_path_info".
1161  *
1162  * Returns true if @a == @b, false otherwise.
1163  */
1164 static inline bool tomoyo_pathcmp(const struct tomoyo_path_info *a,
1165                   const struct tomoyo_path_info *b)
1166 {
1167     return a->hash != b->hash || strcmp(a->name, b->name);
1168 }
1169 
1170 /**
1171  * tomoyo_put_name - Drop reference on "struct tomoyo_name".
1172  *
1173  * @name: Pointer to "struct tomoyo_path_info". Maybe NULL.
1174  *
1175  * Returns nothing.
1176  */
1177 static inline void tomoyo_put_name(const struct tomoyo_path_info *name)
1178 {
1179     if (name) {
1180         struct tomoyo_name *ptr =
1181             container_of(name, typeof(*ptr), entry);
1182         atomic_dec(&ptr->head.users);
1183     }
1184 }
1185 
1186 /**
1187  * tomoyo_put_condition - Drop reference on "struct tomoyo_condition".
1188  *
1189  * @cond: Pointer to "struct tomoyo_condition". Maybe NULL.
1190  *
1191  * Returns nothing.
1192  */
1193 static inline void tomoyo_put_condition(struct tomoyo_condition *cond)
1194 {
1195     if (cond)
1196         atomic_dec(&cond->head.users);
1197 }
1198 
1199 /**
1200  * tomoyo_put_group - Drop reference on "struct tomoyo_group".
1201  *
1202  * @group: Pointer to "struct tomoyo_group". Maybe NULL.
1203  *
1204  * Returns nothing.
1205  */
1206 static inline void tomoyo_put_group(struct tomoyo_group *group)
1207 {
1208     if (group)
1209         atomic_dec(&group->head.users);
1210 }
1211 
1212 /**
1213  * tomoyo_task - Get "struct tomoyo_task" for specified thread.
1214  *
1215  * @task - Pointer to "struct task_struct".
1216  *
1217  * Returns pointer to "struct tomoyo_task" for specified thread.
1218  */
1219 static inline struct tomoyo_task *tomoyo_task(struct task_struct *task)
1220 {
1221     return task->security + tomoyo_blob_sizes.lbs_task;
1222 }
1223 
1224 /**
1225  * tomoyo_same_name_union - Check for duplicated "struct tomoyo_name_union" entry.
1226  *
1227  * @a: Pointer to "struct tomoyo_name_union".
1228  * @b: Pointer to "struct tomoyo_name_union".
1229  *
1230  * Returns true if @a == @b, false otherwise.
1231  */
1232 static inline bool tomoyo_same_name_union
1233 (const struct tomoyo_name_union *a, const struct tomoyo_name_union *b)
1234 {
1235     return a->filename == b->filename && a->group == b->group;
1236 }
1237 
1238 /**
1239  * tomoyo_same_number_union - Check for duplicated "struct tomoyo_number_union" entry.
1240  *
1241  * @a: Pointer to "struct tomoyo_number_union".
1242  * @b: Pointer to "struct tomoyo_number_union".
1243  *
1244  * Returns true if @a == @b, false otherwise.
1245  */
1246 static inline bool tomoyo_same_number_union
1247 (const struct tomoyo_number_union *a, const struct tomoyo_number_union *b)
1248 {
1249     return a->values[0] == b->values[0] && a->values[1] == b->values[1] &&
1250         a->group == b->group && a->value_type[0] == b->value_type[0] &&
1251         a->value_type[1] == b->value_type[1];
1252 }
1253 
1254 /**
1255  * tomoyo_same_ipaddr_union - Check for duplicated "struct tomoyo_ipaddr_union" entry.
1256  *
1257  * @a: Pointer to "struct tomoyo_ipaddr_union".
1258  * @b: Pointer to "struct tomoyo_ipaddr_union".
1259  *
1260  * Returns true if @a == @b, false otherwise.
1261  */
1262 static inline bool tomoyo_same_ipaddr_union
1263 (const struct tomoyo_ipaddr_union *a, const struct tomoyo_ipaddr_union *b)
1264 {
1265     return !memcmp(a->ip, b->ip, sizeof(a->ip)) && a->group == b->group &&
1266         a->is_ipv6 == b->is_ipv6;
1267 }
1268 
1269 /**
1270  * tomoyo_current_namespace - Get "struct tomoyo_policy_namespace" for current thread.
1271  *
1272  * Returns pointer to "struct tomoyo_policy_namespace" for current thread.
1273  */
1274 static inline struct tomoyo_policy_namespace *tomoyo_current_namespace(void)
1275 {
1276     return tomoyo_domain()->ns;
1277 }
1278 
1279 #if defined(CONFIG_SLOB)
1280 
1281 /**
1282  * tomoyo_round2 - Round up to power of 2 for calculating memory usage.
1283  *
1284  * @size: Size to be rounded up.
1285  *
1286  * Returns @size.
1287  *
1288  * Since SLOB does not round up, this function simply returns @size.
1289  */
1290 static inline int tomoyo_round2(size_t size)
1291 {
1292     return size;
1293 }
1294 
1295 #else
1296 
1297 /**
1298  * tomoyo_round2 - Round up to power of 2 for calculating memory usage.
1299  *
1300  * @size: Size to be rounded up.
1301  *
1302  * Returns rounded size.
1303  *
1304  * Strictly speaking, SLAB may be able to allocate (e.g.) 96 bytes instead of
1305  * (e.g.) 128 bytes.
1306  */
1307 static inline int tomoyo_round2(size_t size)
1308 {
1309 #if PAGE_SIZE == 4096
1310     size_t bsize = 32;
1311 #else
1312     size_t bsize = 64;
1313 #endif
1314     if (!size)
1315         return 0;
1316     while (size > bsize)
1317         bsize <<= 1;
1318     return bsize;
1319 }
1320 
1321 #endif
1322 
1323 /**
1324  * list_for_each_cookie - iterate over a list with cookie.
1325  * @pos:        the &struct list_head to use as a loop cursor.
1326  * @head:       the head for your list.
1327  */
1328 #define list_for_each_cookie(pos, head)                 \
1329     if (!pos)                           \
1330         pos =  srcu_dereference((head)->next, &tomoyo_ss);  \
1331     for ( ; pos != (head); pos = srcu_dereference(pos->next, &tomoyo_ss))
1332 
1333 #endif /* !defined(_SECURITY_TOMOYO_COMMON_H) */
[ Source navigation ] [ Diff markup ] [ Identifier search ] [ general search ]

This page was automatically generated by the 2.1.0 LXR engine.

The LXR team
Valid CSS 2.1! Valid HTML 4.01!