]> git.saurik.com Git - apple/xnu.git/blobdiff - security/mac_framework.h
xnu-4903.241.1.tar.gz
[apple/xnu.git] / security / mac_framework.h
index 4b9613d2fca2da4d8c59089a65aa9e2b59a7179c..d735e01242c58ccec74b1d6f394aacf2b354837e 100644 (file)
@@ -2,7 +2,7 @@
  * Copyright (c) 2007 Apple Inc. All rights reserved.
  *
  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
- * 
+ *
  * This file contains Original Code and/or Modifications of Original Code
  * as defined in and that are subject to the Apple Public Source License
  * Version 2.0 (the 'License'). You may not use this file except in
  * unlawful or unlicensed copies of an Apple operating system, or to
  * circumvent, violate, or enable the circumvention or violation of, any
  * terms of an Apple operating system software license agreement.
- * 
+ *
  * Please obtain a copy of the License at
  * http://www.opensource.apple.com/apsl/ and read it before using this file.
- * 
+ *
  * The Original Code and all software distributed under the License are
  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
@@ -22,7 +22,7 @@
  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  * Please see the License for the specific language governing rights and
  * limitations under the License.
- * 
+ *
  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  */
 /*-
 #error "no user-serviceable parts inside"
 #endif
 
-#if CONFIG_MACF
+#ifndef PRIVATE
+#warning "MAC policy is not KPI, see Technical Q&A QA1574, this header will be removed in next version"
+#endif
 
 struct attrlist;
 struct auditinfo;
 struct bpf_d;
 struct componentname;
+struct cs_blob;
 struct devnode;
+struct exception_action;
 struct flock;
 struct fdescnode;
 struct fileglob;
@@ -92,9 +96,9 @@ struct ifnet;
 struct ifreq;
 struct image_params;
 struct inpcb;
+struct ipc_port;
 struct ipq;
 struct knote;
-struct lctx;
 struct m_tag;
 struct mac;
 struct mac_module_data;
@@ -114,24 +118,34 @@ struct socket;
 struct task;
 struct thread;
 struct timespec;
+struct tty;
 struct ucred;
 struct uio;
+struct uthread;
 struct vfs_attr;
 struct vfs_context;
 struct vnode;
 struct vnode_attr;
 struct vop_setlabel_args;
 
-/*@ macros */
-#define        VNODE_LABEL_CREATE      1
-#define        VNODE_LABEL_NEEDREF     2
+#include <sys/kauth.h>
+#include <sys/kernel_types.h>
 
-#if CONFIG_MACF_MACH
-#define mac_task_label_update_cred(cred, task)                         \
-        mac_task_label_update_internal(((cred)->cr_label), task)
+#if CONFIG_MACF
+
+#ifndef __IOKIT_PORTS_DEFINED__
+#define __IOKIT_PORTS_DEFINED__
+#ifdef __cplusplus
+class OSObject;
+typedef OSObject *io_object_t;
 #else
-#define mac_task_label_update_cred(cred, task)
+struct OSObject;
+typedef struct OSObject *io_object_t;
 #endif
+#endif /* __IOKIT_PORTS_DEFINED__ */
+
+/*@ macros */
+#define        VNODE_LABEL_CREATE      1
 
 /*@ === */
 int    mac_audit_check_postselect(kauth_cred_t cred, unsigned short syscode,
@@ -145,8 +159,9 @@ void        mac_bpfdesc_label_associate(kauth_cred_t cred, struct bpf_d *bpf_d);
 int    mac_cred_check_label_update(kauth_cred_t cred,
            struct label *newlabel);
 int    mac_cred_check_label_update_execve(vfs_context_t ctx,
-           struct vnode *vp, struct label *scriptvnodelabel, 
-           struct label *execlabel, proc_t proc);
+           struct vnode *vp, off_t offset, struct vnode *scriptvp,
+           struct label *scriptvnodelabel, struct label *execlabel,
+           proc_t proc, void *macextensions);
 int    mac_cred_check_visible(kauth_cred_t u1, kauth_cred_t u2);
 struct label   *mac_cred_label_alloc(void);
 void   mac_cred_label_associate(kauth_cred_t cred_parent,
@@ -158,10 +173,12 @@ void      mac_cred_label_destroy(kauth_cred_t cred);
 int    mac_cred_label_externalize_audit(proc_t p, struct mac *mac);
 void   mac_cred_label_free(struct label *label);
 void   mac_cred_label_init(kauth_cred_t cred);
+int    mac_cred_label_compare(struct label *a, struct label *b);
 void   mac_cred_label_update(kauth_cred_t cred, struct label *newlabel);
 void   mac_cred_label_update_execve(vfs_context_t ctx, kauth_cred_t newcred,
-           struct vnode *vp, struct label *scriptvnodelabel,
-           struct label *execlabel);
+           struct vnode *vp, off_t offset, struct vnode *scriptvp,
+           struct label *scriptvnodelabel, struct label *execlabel, u_int *csflags,
+           void *macextensions, int *disjoint, int *labelupdateerror);
 void   mac_devfs_label_associate_device(dev_t dev, struct devnode *de,
            const char *fullpath);
 void   mac_devfs_label_associate_directory(const char *dirname, int dirnamelen,
@@ -185,8 +202,11 @@ int        mac_file_check_ioctl(kauth_cred_t cred, struct fileglob *fg,
            unsigned int cmd);
 int    mac_file_check_lock(kauth_cred_t cred, struct fileglob *fg, int op,
            struct flock *fl);
+int    mac_file_check_library_validation(struct proc *proc,
+           struct fileglob *fg, off_t slice_offset,
+           user_long_t error_message, size_t error_message_size);
 int    mac_file_check_mmap(kauth_cred_t cred, struct fileglob *fg,
-           int prot, int flags, int *maxprot);
+           int prot, int flags, uint64_t file_pos, int *maxprot);
 void   mac_file_check_mmap_downgrade(kauth_cred_t cred, struct fileglob *fg,
            int *prot);
 int    mac_file_check_receive(kauth_cred_t cred, struct fileglob *fg);
@@ -213,18 +233,16 @@ int       mac_inpcb_label_init(struct inpcb *inp, int flag);
 void   mac_inpcb_label_recycle(struct inpcb *inp);
 void   mac_inpcb_label_update(struct socket *so);
 int    mac_iokit_check_device(char *devtype, struct mac_module_data *mdata);
+int    mac_iokit_check_open(kauth_cred_t cred, io_object_t user_client, unsigned int user_client_type);
+int    mac_iokit_check_set_properties(kauth_cred_t cred, io_object_t registry_entry, io_object_t properties);
+int    mac_iokit_check_filter_properties(kauth_cred_t cred, io_object_t registry_entry);
+int    mac_iokit_check_get_property(kauth_cred_t cred, io_object_t registry_entry, const char *name);
+int    mac_iokit_check_hid_control(kauth_cred_t cred);
 void   mac_ipq_label_associate(struct mbuf *fragment, struct ipq *ipq);
 int    mac_ipq_label_compare(struct mbuf *fragment, struct ipq *ipq);
 void   mac_ipq_label_destroy(struct ipq *ipq);
 int    mac_ipq_label_init(struct ipq *ipq, int flag);
 void   mac_ipq_label_update(struct mbuf *fragment, struct ipq *ipq);
-struct label   *mac_lctx_label_alloc(void);
-void    mac_lctx_label_free(struct label *label);
-void   mac_lctx_label_update(struct lctx *l, struct label *newlabel);
-int    mac_lctx_check_label_update(struct lctx *l, struct label *newlabel);
-void   mac_lctx_notify_create(proc_t proc, struct lctx *l);
-void   mac_lctx_notify_join(proc_t proc, struct lctx *l);
-void   mac_lctx_notify_leave(proc_t proc, struct lctx *l);
 void   mac_mbuf_label_associate_bpfdesc(struct bpf_d *bpf_d, struct mbuf *m);
 void   mac_mbuf_label_associate_ifnet(struct ifnet *ifp, struct mbuf *m);
 void   mac_mbuf_label_associate_inpcb(struct inpcb *inp, struct mbuf *m);
@@ -248,6 +266,12 @@ int        mac_mount_check_getattr(vfs_context_t ctx, struct mount *mp,
 int    mac_mount_check_label_update(vfs_context_t ctx, struct mount *mp);
 int    mac_mount_check_mount(vfs_context_t ctx, struct vnode *vp,
            struct componentname *cnp, const char *vfc_name);
+int    mac_mount_check_snapshot_create(vfs_context_t ctx, struct mount *mp,
+           const char *name);
+int    mac_mount_check_snapshot_delete(vfs_context_t ctx, struct mount *mp,
+           const char *name);
+int    mac_mount_check_snapshot_revert(vfs_context_t ctx, struct mount *mp,
+           const char *name);
 int    mac_mount_check_remount(vfs_context_t ctx, struct mount *mp);
 int    mac_mount_check_setattr(vfs_context_t ctx, struct mount *mp,
            struct vfs_attr *vfa);
@@ -297,10 +321,11 @@ void      mac_posixsem_label_init(struct pseminfo *psem);
 int    mac_posixshm_check_create(kauth_cred_t cred, const char *name);
 int    mac_posixshm_check_mmap(kauth_cred_t cred, struct pshminfo *pshm,
            int prot, int flags);
-int    mac_posixshm_check_open(kauth_cred_t cred, struct pshminfo *pshm);
+int    mac_posixshm_check_open(kauth_cred_t cred, struct pshminfo *pshm,
+           int fflags);
 int    mac_posixshm_check_stat(kauth_cred_t cred, struct pshminfo *pshm);
 int    mac_posixshm_check_truncate(kauth_cred_t cred, struct pshminfo *pshm,
-           size_t s);
+           off_t s);
 int    mac_posixshm_check_unlink(kauth_cred_t cred, struct pshminfo *pshm,
            const char *name);
 void   mac_posixshm_vnode_label_associate(kauth_cred_t cred,
@@ -310,25 +335,37 @@ void      mac_posixshm_label_associate(kauth_cred_t cred,
            struct pshminfo *pshm, const char *name);
 void   mac_posixshm_label_destroy(struct pshminfo *pshm);
 void   mac_posixshm_label_init(struct pshminfo *pshm);
+int    mac_priv_check(kauth_cred_t cred, int priv);
+int    mac_priv_grant(kauth_cred_t cred, int priv);
 int    mac_proc_check_debug(proc_t proc1, proc_t proc2);
+int    mac_proc_check_proc_info(proc_t curp, proc_t target, int callnum, int flavor);
+int    mac_proc_check_get_cs_info(proc_t curp, proc_t target, unsigned int op);
+int    mac_proc_check_set_cs_info(proc_t curp, proc_t target, unsigned int op);
 int    mac_proc_check_fork(proc_t proc);
+int    mac_proc_check_suspend_resume(proc_t proc, int sr);
 int    mac_proc_check_get_task_name(kauth_cred_t cred, struct proc *p);
 int    mac_proc_check_get_task(kauth_cred_t cred, struct proc *p);
+int    mac_proc_check_expose_task(kauth_cred_t cred, struct proc *p);
+int    mac_proc_check_inherit_ipc_ports(struct proc *p, struct vnode *cur_vp, off_t cur_offset, struct vnode *img_vp, off_t img_offset, struct vnode *scriptvp);
 int    mac_proc_check_getaudit(proc_t proc);
 int    mac_proc_check_getauid(proc_t proc);
 int     mac_proc_check_getlcid(proc_t proc1, proc_t proc2,
            pid_t pid);
+int     mac_proc_check_ledger(proc_t curp, proc_t target, int op);
+int    mac_proc_check_map_anon(proc_t proc, user_addr_t u_addr,
+           user_size_t u_size, int prot, int flags, int *maxprot);
 int    mac_proc_check_mprotect(proc_t proc,
            user_addr_t addr, user_size_t size, int prot);
+int    mac_proc_check_run_cs_invalid(proc_t proc);
 int    mac_proc_check_sched(proc_t proc, proc_t proc2);
-int    mac_proc_check_setaudit(proc_t proc, struct auditinfo *ai);
+int    mac_proc_check_setaudit(proc_t proc, struct auditinfo_addr *ai);
 int    mac_proc_check_setauid(proc_t proc, uid_t auid);
 int     mac_proc_check_setlcid(proc_t proc1, proc_t proc2,
            pid_t pid1, pid_t pid2);
 int    mac_proc_check_signal(proc_t proc1, proc_t proc2,
            int signum);
 int    mac_proc_check_wait(proc_t proc1, proc_t proc2);
-void   mac_proc_set_enforce(proc_t p, int enforce_flags);
+void   mac_proc_notify_exit(proc_t proc);
 int    mac_setsockopt_label(kauth_cred_t cred, struct socket *so,
            struct mac *extmac);
 int     mac_socket_check_accept(kauth_cred_t cred, struct socket *so);
@@ -340,11 +377,13 @@ int       mac_socket_check_connect(kauth_cred_t cred, struct socket *so,
 int    mac_socket_check_create(kauth_cred_t cred, int domain,
            int type, int protocol);
 int    mac_socket_check_deliver(struct socket *so, struct mbuf *m);
+int    mac_socket_check_ioctl(kauth_cred_t cred, struct socket *so,
+           unsigned int cmd);
 int    mac_socket_check_kqfilter(kauth_cred_t cred, struct knote *kn,
            struct socket *so);
 int    mac_socket_check_listen(kauth_cred_t cred, struct socket *so);
 int    mac_socket_check_receive(kauth_cred_t cred, struct socket *so);
-int    mac_socket_check_received(kauth_cred_t cred, struct socket *so, 
+int    mac_socket_check_received(kauth_cred_t cred, struct socket *so,
            struct sockaddr *saddr);
 int     mac_socket_check_select(kauth_cred_t cred, struct socket *so,
            int which);
@@ -372,15 +411,18 @@ int       mac_system_check_acct(kauth_cred_t cred, struct vnode *vp);
 int    mac_system_check_audit(kauth_cred_t cred, void *record, int length);
 int    mac_system_check_auditctl(kauth_cred_t cred, struct vnode *vp);
 int    mac_system_check_auditon(kauth_cred_t cred, int cmd);
+int    mac_system_check_chud(kauth_cred_t cred);
 int    mac_system_check_host_priv(kauth_cred_t cred);
+int    mac_system_check_info(kauth_cred_t, const char *info_type);
 int    mac_system_check_nfsd(kauth_cred_t cred);
 int    mac_system_check_reboot(kauth_cred_t cred, int howto);
 int    mac_system_check_settime(kauth_cred_t cred);
 int    mac_system_check_swapoff(kauth_cred_t cred, struct vnode *vp);
 int    mac_system_check_swapon(kauth_cred_t cred, struct vnode *vp);
-int    mac_system_check_sysctl(kauth_cred_t cred, int *name,
-           u_int namelen, user_addr_t oldctl, user_addr_t oldlenp, int inkernel,
-           user_addr_t newctl, size_t newlen);
+int    mac_system_check_sysctlbyname(kauth_cred_t cred, const char *namestring, int *name,
+                                     u_int namelen, user_addr_t oldctl, size_t oldlen,
+                                     user_addr_t newctl, size_t newlen);
+int    mac_system_check_kas_info(kauth_cred_t cred, int selector);
 void   mac_sysvmsg_label_associate(kauth_cred_t cred,
            struct msqid_kernel *msqptr, struct msg *msgptr);
 void   mac_sysvmsg_label_init(struct msg *msgptr);
@@ -425,12 +467,13 @@ void      mac_sysvshm_label_associate(kauth_cred_t cred,
 void   mac_sysvshm_label_destroy(struct shmid_kernel *shmsegptr);
 void   mac_sysvshm_label_init(struct shmid_kernel* shmsegptr);
 void   mac_sysvshm_label_recycle(struct shmid_kernel *shmsegptr);
-void   mac_thread_userret(int code, int error, struct thread *thread);
 int    mac_vnode_check_access(vfs_context_t ctx, struct vnode *vp,
            int acc_mode);
 int    mac_vnode_check_chdir(vfs_context_t ctx, struct vnode *dvp);
 int    mac_vnode_check_chroot(vfs_context_t ctx, struct vnode *dvp,
            struct componentname *cnp);
+int    mac_vnode_check_clone(vfs_context_t ctx, struct vnode *dvp,
+           struct vnode *vp, struct componentname *cnp);
 int    mac_vnode_check_create(vfs_context_t ctx, struct vnode *dvp,
            struct componentname *cnp, struct vnode_attr *vap);
 int    mac_vnode_check_deleteextattr(vfs_context_t ctx, struct vnode *vp,
@@ -439,6 +482,9 @@ int mac_vnode_check_exchangedata(vfs_context_t ctx, struct vnode *v1,
            struct vnode *v2);
 int    mac_vnode_check_exec(vfs_context_t ctx, struct vnode *vp,
            struct image_params *imgp);
+int    mac_vnode_check_fsgetpath(vfs_context_t ctx, struct vnode *vp);
+int    mac_vnode_check_getattr(vfs_context_t ctx, struct ucred *file_cred,
+            struct vnode *vp, struct vnode_attr *va);
 int     mac_vnode_check_getattrlist(vfs_context_t ctx, struct vnode *vp,
            struct attrlist *alist);
 int    mac_vnode_check_getextattr(vfs_context_t ctx, struct vnode *vp,
@@ -454,19 +500,24 @@ int       mac_vnode_check_link(vfs_context_t ctx, struct vnode *dvp,
 int    mac_vnode_check_listextattr(vfs_context_t ctx, struct vnode *vp);
 int    mac_vnode_check_lookup(vfs_context_t ctx, struct vnode *dvp,
            struct componentname *cnp);
+int    mac_vnode_check_lookup_preflight(vfs_context_t ctx, struct vnode *dvp,
+           const char *path, size_t pathlen);
 int    mac_vnode_check_open(vfs_context_t ctx, struct vnode *vp,
            int acc_mode);
 int    mac_vnode_check_read(vfs_context_t ctx,
            kauth_cred_t file_cred, struct vnode *vp);
 int    mac_vnode_check_readdir(vfs_context_t ctx, struct vnode *vp);
 int    mac_vnode_check_readlink(vfs_context_t ctx, struct vnode *vp);
-int    mac_vnode_check_rename_from(vfs_context_t ctx, struct vnode *dvp,
-           struct vnode *vp, struct componentname *cnp);
-int    mac_vnode_check_rename_to(vfs_context_t ctx, struct vnode *dvp,
-           struct vnode *vp, int samedir, struct componentname *cnp);
+int    mac_vnode_check_rename(vfs_context_t ctx, struct vnode *dvp,
+           struct vnode *vp, struct componentname *cnp, struct vnode *tdvp,
+           struct vnode *tvp, struct componentname *tcnp);
 int    mac_vnode_check_revoke(vfs_context_t ctx, struct vnode *vp);
+int    mac_vnode_check_searchfs(vfs_context_t ctx, struct vnode *vp,
+           struct attrlist *alist);
 int     mac_vnode_check_select(vfs_context_t ctx, struct vnode *vp,
            int which);
+int    mac_vnode_check_setacl(vfs_context_t ctx, struct vnode *vp,
+           struct kauth_acl *acl);
 int     mac_vnode_check_setattrlist(vfs_context_t ctxd, struct vnode *vp,
            struct attrlist *alist);
 int    mac_vnode_check_setextattr(vfs_context_t ctx, struct vnode *vp,
@@ -479,10 +530,19 @@ int       mac_vnode_check_setowner(vfs_context_t ctx, struct vnode *vp,
            uid_t uid, gid_t gid);
 int    mac_vnode_check_setutimes(vfs_context_t ctx, struct vnode *vp,
            struct timespec atime, struct timespec mtime);
+int    mac_vnode_check_signature(struct vnode *vp,
+           struct cs_blob *cs_blob, struct image_params *imgp,
+           unsigned int *cs_flags, unsigned int *signer_type,
+           int flags);
 int    mac_vnode_check_stat(vfs_context_t ctx,
            kauth_cred_t file_cred, struct vnode *vp);
+int    mac_vnode_check_trigger_resolve(vfs_context_t ctx, struct vnode *dvp,
+           struct componentname *cnp);
 int    mac_vnode_check_truncate(vfs_context_t ctx,
            kauth_cred_t file_cred, struct vnode *vp);
+int    mac_vnode_check_uipc_bind(vfs_context_t ctx, struct vnode *dvp,
+           struct componentname *cnp, struct vnode_attr *vap);
+int    mac_vnode_check_uipc_connect(vfs_context_t ctx, struct vnode *vp, struct socket *so);
 int    mac_vnode_check_unlink(vfs_context_t ctx, struct vnode *dvp,
            struct vnode *vp, struct componentname *cnp);
 int    mac_vnode_check_write(vfs_context_t ctx,
@@ -502,6 +562,7 @@ void        mac_vnode_label_destroy(struct vnode *vp);
 int    mac_vnode_label_externalize_audit(struct vnode *vp, struct mac *mac);
 void   mac_vnode_label_free(struct label *label);
 void   mac_vnode_label_init(struct vnode *vp);
+int    mac_vnode_label_init_needed(struct vnode *vp);
 void   mac_vnode_label_recycle(struct vnode *vp);
 void   mac_vnode_label_update(vfs_context_t ctx, struct vnode *vp,
            struct label *newlabel);
@@ -509,9 +570,31 @@ void       mac_vnode_label_update_extattr(struct mount *mp, struct vnode *vp,
            const char *name);
 int    mac_vnode_notify_create(vfs_context_t ctx, struct mount *mp,
            struct vnode *dvp, struct vnode *vp, struct componentname *cnp);
+void   mac_vnode_notify_deleteextattr(vfs_context_t ctx, struct vnode *vp, const char *name);
+void   mac_vnode_notify_link(vfs_context_t ctx, struct vnode *vp,
+           struct vnode *dvp, struct componentname *cnp);
+void   mac_vnode_notify_open(vfs_context_t ctx, struct vnode *vp, int acc_flags);
+void   mac_vnode_notify_rename(vfs_context_t ctx, struct vnode *vp,
+           struct vnode *dvp, struct componentname *cnp);
+void   mac_vnode_notify_setacl(vfs_context_t ctx, struct vnode *vp, struct kauth_acl *acl);
+void   mac_vnode_notify_setattrlist(vfs_context_t ctx, struct vnode *vp, struct attrlist *alist);
+void   mac_vnode_notify_setextattr(vfs_context_t ctx, struct vnode *vp, const char *name, struct uio *uio);
+void   mac_vnode_notify_setflags(vfs_context_t ctx, struct vnode *vp, u_long flags);
+void   mac_vnode_notify_setmode(vfs_context_t ctx, struct vnode *vp, mode_t mode);
+void   mac_vnode_notify_setowner(vfs_context_t ctx, struct vnode *vp, uid_t uid, gid_t gid);
+void   mac_vnode_notify_setutimes(vfs_context_t ctx, struct vnode *vp, struct timespec atime, struct timespec mtime);
+void   mac_vnode_notify_truncate(vfs_context_t ctx, kauth_cred_t file_cred, struct vnode *vp);
+int    mac_vnode_find_sigs(struct proc *p, struct vnode *vp, off_t offsetInMacho);
 int    vnode_label(struct mount *mp, struct vnode *dvp, struct vnode *vp,
            struct componentname *cnp, int flags, vfs_context_t ctx);
 void   vnode_relabel(struct vnode *vp);
+void   mac_pty_notify_grant(proc_t p, struct tty *tp, dev_t dev, struct label *label);
+void   mac_pty_notify_close(proc_t p, struct tty *tp, dev_t dev, struct label *label);
+int    mac_kext_check_load(kauth_cred_t cred, const char *identifier);
+int    mac_kext_check_unload(kauth_cred_t cred, const char *identifier);
+int    mac_kext_check_query(kauth_cred_t cred);
+int    mac_skywalk_flow_check_connect(proc_t p, void *flow, const struct sockaddr *addr, int type, int protocol);
+int    mac_skywalk_flow_check_listen(proc_t p, void *flow, const struct sockaddr *addr, int type, int protocol);
 
 void psem_label_associate(struct fileproc *fp, struct vnode *vp, struct vfs_context *ctx);
 void pshm_label_associate(struct fileproc *fp, struct vnode *vp, struct vfs_context *ctx);