/*
- * Copyright (c) 1999-2007 Apple Inc. All Rights Reserved.
- *
- * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
+ * Copyright (c) 2004-2008, Apple Inc. All rights reserved.
*
- * 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
- * compliance with the License. The rights granted to you under the License
- * may not be used to create, or enable the creation or redistribution of,
- * 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.
+ * @APPLE_BSD_LICENSE_HEADER_START@
*
- * Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this file.
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
*
- * 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,
- * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
- * 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.
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ * 3. Neither the name of Apple Inc. ("Apple") nor the names of
+ * its contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
*
- * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
- */
+ * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
+ * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @APPLE_BSD_LICENSE_HEADER_END@
+*/
/*
* NOTICE: This file was modified by SPARTA, Inc. in 2005 to introduce
* support for mandatory and extensible security protections. This notice
#ifndef _BSM_AUDIT_KERNEL_H
#define _BSM_AUDIT_KERNEL_H
-#if CONFIG_MACF
-#include <sys/queue.h>
-#include <security/mac_framework.h>
-#endif
-
-#ifdef KERNEL
-
-#include <bsm/audit.h>
-
-#include <sys/sysctl.h>
-#include <sys/user.h>
-#include <sys/ipc.h>
-
-/*
- * Audit subsystem condition flags. The audit_enabled flag is set and
- * removed automatically as a result of configuring log files, and
- * can be observed but should not be directly manipulated. The audit
- * suspension flag permits audit to be temporarily disabled without
- * reconfiguring the audit target.
- */
-extern int audit_enabled;
-extern int audit_suspended;
-
-#define BSM_SUCCESS 0
-#define BSM_FAILURE 1
-#define BSM_NOAUDIT 2
-
-/*
- * Define the masks for the audited arguments.
- */
-#define ARG_EUID 0x0000000000000001ULL
-#define ARG_RUID 0x0000000000000002ULL
-#define ARG_SUID 0x0000000000000004ULL
-#define ARG_EGID 0x0000000000000008ULL
-#define ARG_RGID 0x0000000000000010ULL
-#define ARG_SGID 0x0000000000000020ULL
-#define ARG_PID 0x0000000000000040ULL
-#define ARG_UID 0x0000000000000080ULL
-#define ARG_AUID 0x0000000000000100ULL
-#define ARG_GID 0x0000000000000200ULL
-#define ARG_FD 0x0000000000000400ULL
-#define ARG_POSIX_IPC_PERM 0x0000000000000800ULL
-#define ARG_FFLAGS 0x0000000000001000ULL
-#define ARG_MODE 0x0000000000002000ULL
-#define ARG_DEV 0x0000000000004000ULL
-#define ARG_ADDR 0x0000000000008000ULL
-#define ARG_LEN 0x0000000000010000ULL
-#define ARG_MASK 0x0000000000020000ULL
-#define ARG_SIGNUM 0x0000000000040000ULL
-#define ARG_LOGIN 0x0000000000080000ULL
-#define ARG_SADDRINET 0x0000000000100000ULL
-#define ARG_SADDRINET6 0x0000000000200000ULL
-#define ARG_SADDRUNIX 0x0000000000400000ULL
-#define ARG_KPATH1 0x0000000000800000ULL
-#define ARG_KPATH2 0x0000000001000000ULL
-#define ARG_UPATH1 0x0000000002000000ULL
-#define ARG_UPATH2 0x0000000004000000ULL
-#define ARG_TEXT 0x0000000008000000ULL
-#define ARG_VNODE1 0x0000000010000000ULL
-#define ARG_VNODE2 0x0000000020000000ULL
-#define ARG_SVIPC_CMD 0x0000000040000000ULL
-#define ARG_SVIPC_PERM 0x0000000080000000ULL
-#define ARG_SVIPC_ID 0x0000000100000000ULL
-#define ARG_SVIPC_ADDR 0x0000000200000000ULL
-#define ARG_GROUPSET 0x0000000400000000ULL
-#define ARG_CMD 0x0000000800000000ULL
-#define ARG_SOCKINFO 0x0000001000000000ULL
-#define ARG_ASID 0x0000002000000000ULL
-#define ARG_TERMID 0x0000004000000000ULL
-#define ARG_AUDITON 0x0000008000000000ULL
-#define ARG_VALUE 0x0000010000000000ULL
-#define ARG_AMASK 0x0000020000000000ULL
-#define ARG_CTLNAME 0x0000040000000000ULL
-#define ARG_PROCESS 0x0000080000000000ULL
-#define ARG_MACHPORT1 0x0000100000000000ULL
-#define ARG_MACHPORT2 0x0000200000000000ULL
-#define ARG_MAC_STRING 0x0000400000000000ULL
-#define ARG_NONE 0x0000000000000000ULL
-#define ARG_ALL 0xFFFFFFFFFFFFFFFFULL
-
-/* Defines for the kernel audit record k_ar_commit field */
-#define AR_COMMIT_KERNEL 0x00000001U
-#define AR_COMMIT_USER 0x00000010U
-
-struct vnode_au_info {
- mode_t vn_mode;
- uid_t vn_uid;
- gid_t vn_gid;
- dev_t vn_dev;
- long vn_fsid;
- long vn_fileid;
- long vn_gen;
-};
-
-struct groupset {
- gid_t gidset[NGROUPS];
- u_int gidset_size;
-};
-
-struct socket_au_info {
- int so_domain;
- int so_type;
- int so_protocol;
- in_addr_t so_raddr; /* remote address if INET socket */
- in_addr_t so_laddr; /* local address if INET socket */
- u_short so_rport; /* remote port */
- u_short so_lport; /* local port */
-};
-
-union auditon_udata {
- char au_path[MAXPATHLEN];
- long au_cond;
- long au_flags;
- long au_policy;
- au_evclass_map_t au_evclass;
- au_mask_t au_mask;
- auditinfo_t au_auinfo;
- auditpinfo_t au_aupinfo;
- auditpinfo_addr_t au_aupinfo_addr;
- au_qctrl_t au_qctrl;
- au_stat_t au_stat;
- au_fstat_t au_fstat;
-};
-
-struct posix_ipc_perm {
- uid_t pipc_uid;
- gid_t pipc_gid;
- mode_t pipc_mode;
-};
-
-#if CONFIG_MACF
-
-#define MAC_AUDIT_LABEL_LEN 1024
-#define MAC_AUDIT_DATA_TYPE 0
-#define MAC_AUDIT_TEXT_TYPE 1
-
-struct mac_audit_record {
- int type; // one of the types defined above
- int length; // byte length of the data field
- u_char *data; // the payload
- LIST_ENTRY(mac_audit_record) records;
-};
-
-#endif
-
-struct audit_record {
- /* Audit record header. */
- u_int32_t ar_magic;
- int ar_event;
- int ar_retval; /* value returned to the process */
- int ar_errno; /* return status of system call */
- struct timespec ar_starttime;
- struct timespec ar_endtime;
- u_int64_t ar_valid_arg; /* Bitmask of valid arguments */
-
- /* Audit subject information. */
- struct xucred ar_subj_cred;
- uid_t ar_subj_ruid;
- gid_t ar_subj_rgid;
- gid_t ar_subj_egid;
- uid_t ar_subj_auid; /* Audit user ID */
- pid_t ar_subj_asid; /* Audit session ID */
- pid_t ar_subj_pid;
- struct au_tid ar_subj_term;
- char ar_subj_comm[MAXCOMLEN + 1];
- struct au_mask ar_subj_amask;
-
- /* Operation arguments. */
- uid_t ar_arg_euid;
- uid_t ar_arg_ruid;
- uid_t ar_arg_suid;
- gid_t ar_arg_egid;
- gid_t ar_arg_rgid;
- gid_t ar_arg_sgid;
- pid_t ar_arg_pid;
- pid_t ar_arg_asid;
- struct au_tid ar_arg_termid;
- uid_t ar_arg_uid;
- uid_t ar_arg_auid;
- gid_t ar_arg_gid;
- struct groupset ar_arg_groups;
- int ar_arg_fd;
- int ar_arg_fflags;
- mode_t ar_arg_mode;
- int ar_arg_dev;
- long ar_arg_value;
- void * ar_arg_addr;
- int ar_arg_len;
- int ar_arg_mask;
- u_int ar_arg_signum;
- char ar_arg_login[MAXLOGNAME];
- int ar_arg_ctlname[CTL_MAXNAME];
- struct sockaddr ar_arg_sockaddr;
- struct socket_au_info ar_arg_sockinfo;
- char *ar_arg_upath1;
- char *ar_arg_upath2;
- char *ar_arg_kpath1;
- char *ar_arg_kpath2;
-#if CONFIG_MACF
- char *ar_vnode1_mac_labels;
- char *ar_vnode2_mac_labels;
- char *ar_cred_mac_labels;
- char *ar_arg_mac_string;
-#endif
- char *ar_arg_text;
- struct au_mask ar_arg_amask;
- struct vnode_au_info ar_arg_vnode1;
- struct vnode_au_info ar_arg_vnode2;
- int ar_arg_cmd;
- int ar_arg_svipc_cmd;
- struct ipc_perm ar_arg_svipc_perm;
- int ar_arg_svipc_id;
- user_addr_t ar_arg_svipc_addr;
- struct posix_ipc_perm ar_arg_pipc_perm;
- mach_port_name_t ar_arg_mach_port1;
- mach_port_name_t ar_arg_mach_port2;
- union auditon_udata ar_arg_auditon;
-
-#if CONFIG_MACF
- /* MAC security related fields added by MAC policies
- * ar_forced_by_mac is 1 if mac_audit_check_preselect() forced this
- * call to be audited, 0 otherwise.
- */
- LIST_HEAD(mac_audit_record_list_t, mac_audit_record) *ar_mac_records;
- int ar_forced_by_mac;
-#endif
-
-};
-
-/*
- * In-kernel version of audit record; the basic record plus queue meta-data.
- * This record can also have a pointer set to some opaque data that will
- * be passed through to the audit writing mechanism.
- */
-struct kaudit_record {
- struct audit_record k_ar;
- u_int32_t k_ar_commit;
- void *k_udata; /* user data */
- u_int k_ulen; /* user data length */
- struct uthread *k_uthread; /* thread we are auditing */
- TAILQ_ENTRY(kaudit_record) k_q;
-};
-
-struct proc;
-struct vnode;
-struct componentname;
-
-int kau_will_audit(void);
-
-void audit_abort(struct kaudit_record *ar);
-void audit_commit(struct kaudit_record *ar, int error,
- int retval);
-void audit_init(void);
-void audit_shutdown(void);
-
-struct kaudit_record *audit_new(int event, struct proc *p,
- struct uthread *uthread);
-
-void audit_syscall_enter(unsigned short code,
- struct proc *proc, struct uthread *uthread);
-#if CONFIG_MACF
-/*
- * The parameter list of audit_syscall_exit() was modified to also take the
- * Darwin syscall number, which is required by mac_audit_check_postselect().
- */
-void audit_syscall_exit(unsigned short code, int error,
- struct proc *proc, struct uthread *uthread);
-#else
-void audit_syscall_exit(int error, struct proc *proc,
- struct uthread *uthread);
-#endif
-void audit_mach_syscall_enter(unsigned short audit_event);
-void audit_mach_syscall_exit(int retval,
- struct uthread *uthread);
-
-int kaudit_to_bsm(struct kaudit_record *kar,
- struct au_record **pau);
-
-int bsm_rec_verify(void *rec);
-
-/*
- * Kernel versions of the BSM audit record functions.
- */
-struct au_record *kau_open(void);
-int kau_write(struct au_record *rec, token_t *m);
-int kau_close(struct au_record *rec,
- struct timespec *endtime, short event);
-void kau_free(struct au_record *rec);
-void kau_init(void);
-token_t *kau_to_file(const char *file, const struct timeval *tv);
-token_t *kau_to_header(const struct timespec *ctime, int rec_size,
- au_event_t e_type, au_emod_t e_mod);
-token_t *kau_to_header32(const struct timespec *ctime, int rec_size,
- au_event_t e_type, au_emod_t e_mod);
-token_t *kau_to_header64(const struct timespec *ctime, int rec_size,
- au_event_t e_type, au_emod_t e_mod);
-/*
- * The remaining kernel functions are conditionally compiled in as they
- * are wrapped by a macro, and the macro should be the only place in
- * the source tree where these functions are referenced.
- */
-#if AUDIT
-void audit_arg_addr(user_addr_t addr);
-void audit_arg_len(user_size_t len);
-void audit_arg_fd(int fd);
-void audit_arg_fflags(int fflags);
-void audit_arg_gid(gid_t gid, gid_t egid, gid_t rgid,
- gid_t sgid);
-void audit_arg_uid(uid_t uid, uid_t euid, uid_t ruid,
- uid_t suid);
-void audit_arg_groupset(const gid_t *gidset, u_int gidset_size);
-void audit_arg_login(const char *login);
-void audit_arg_ctlname(const int *name, int namelen);
-void audit_arg_mask(int mask);
-void audit_arg_mode(mode_t mode);
-void audit_arg_dev(int dev);
-void audit_arg_value(long value);
-void audit_arg_owner(uid_t uid, gid_t gid);
-void audit_arg_pid(pid_t pid);
-void audit_arg_process(struct proc *p);
-void audit_arg_signum(u_int signum);
-void audit_arg_socket(int sodomain, int sotype,
- int soprotocol);
-void audit_arg_sockaddr(struct vnode *cwd_vp,
- struct sockaddr *so);
-void audit_arg_auid(uid_t auid);
-void audit_arg_auditinfo(const struct auditinfo *au_info);
-void audit_arg_upath(struct vnode *cwd_vp, char *upath,
- u_int64_t flags);
-void audit_arg_vnpath(struct vnode *vp, u_int64_t flags);
-void audit_arg_vnpath_withref(struct vnode *vp, u_int64_t flags);
-void audit_arg_text(const char *text);
-void audit_arg_cmd(int cmd);
-void audit_arg_svipc_cmd(int cmd);
-void audit_arg_svipc_perm(const struct ipc_perm *perm);
-void audit_arg_svipc_id(int id);
-void audit_arg_svipc_addr(user_addr_t addr);
-void audit_arg_posix_ipc_perm(uid_t uid, gid_t gid,
- mode_t mode);
-void audit_arg_auditon(const union auditon_udata *udata);
-void audit_arg_file(struct proc *p, const struct fileproc *fp);
-void audit_arg_mach_port1(mach_port_name_t port);
-void audit_arg_mach_port2(mach_port_name_t port);
-
-void audit_sysclose(struct proc *p, int fd);
-
-void audit_proc_init(struct proc *p);
-void audit_proc_fork(struct proc *parent,
- struct proc *child);
-void audit_proc_free(struct proc *p);
-
-#if CONFIG_MACF
-/*
- * audit_mac_data() is the MAC Framework's entry point to the audit subsystem.
- * It currently creates only text and data audit tokens.
- */
-int audit_mac_data(int type, int len, u_char *data);
-void audit_arg_mac_string(const char *string);
-
-#endif
-
-/*
- * Define a macro to wrap the audit_arg_* calls by checking the global
- * audit_enabled flag before performing the actual call.
- */
-#define AUDIT_ARG(op, args...) do { \
- if (audit_enabled) \
- audit_arg_ ## op (args); \
- } while (0)
-
-#define AUDIT_SYSCALL_ENTER(args...) do { \
- if (audit_enabled) { \
- audit_syscall_enter(args); \
- } \
- } while (0)
-
-/*
- * Wrap the audit_syscall_exit() function so that it is called only when
- * auditing is enabled, or we have a audit record on the thread. It is
- * possible that an audit record was begun before auditing was turned off.
- */
-#define AUDIT_SYSCALL_EXIT(code, proc, uthread, error) do { \
- if (audit_enabled || (uthread->uu_ar != NULL)) { \
- audit_syscall_exit(code, error, proc, uthread); \
- } \
- } while (0)
-
-/*
- * Wrap the audit_mach_syscall_enter() and audit_mach_syscall_exit()
- * functions in a manner similar to other system call enter/exit functions.
- */
-#define AUDIT_MACH_SYSCALL_ENTER(args...) do { \
- if (audit_enabled) { \
- audit_mach_syscall_enter(args); \
- } \
- } while (0)
-
-#define AUDIT_MACH_SYSCALL_EXIT(retval) do { \
- struct uthread *__uthread = get_bsdthread_info(current_thread()); \
- if (audit_enabled || (__uthread->uu_ar != NULL)) { \
- audit_mach_syscall_exit(retval, __uthread); \
- } \
- } while (0)
-
-/*
- * A Macro to wrap the audit_sysclose() function.
- */
-#define AUDIT_SYSCLOSE(args...) do { \
- if (audit_enabled) \
- audit_sysclose(args); \
- } while (0)
-
-#else /* !AUDIT */
-
-#define AUDIT_ARG(op, args...) do { \
- } while (0)
-
-#define AUDIT_SYSCALL_ENTER(args...) do { \
- } while (0)
-
-#define AUDIT_SYSCALL_EXIT(code, proc, uthread, error) do { \
- } while (0)
-
-#define AUDIT_MACH_SYSCALL_ENTER(args...) do { \
- } while (0)
-
-#define AUDIT_MACH_SYSCALL_EXIT(retval) do { \
- } while (0)
-
-#define AUDIT_SYSCLOSE(op, args...) do { \
- } while (0)
-
-#endif /* AUDIT */
+#warning "<bsm/audit_kernel.h> is deprecated. Please use <security/audit/audit.h> instead."
-#endif /* KERNEL */
+#include <security/audit/audit.h>
#endif /* !_BSM_AUDIT_KERNEL_H */
projects / apple / xnu.git / blobdiff