2 * Copyright (c) 2008-2009 Apple Inc.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. Neither the name of Apple Inc. ("Apple") nor the names of
14 * its contributors may be used to endorse or promote products derived
15 * from this software without specific prior written permission.
17 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR
21 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
25 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
26 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27 * POSSIBILITY OF SUCH DAMAGE.
32 #include <sys/kernel.h>
33 #include <sys/fcntl.h>
34 #include <sys/kauth.h>
38 #include <sys/queue.h>
39 #include <sys/signalvar.h>
40 #include <sys/syscall.h>
41 #include <sys/sysent.h>
42 #include <sys/sysproto.h>
43 #include <sys/systm.h>
44 #include <sys/ucred.h>
47 #include <miscfs/devfs/devfs.h>
49 #include <libkern/OSAtomic.h>
51 #include <bsm/audit.h>
52 #include <bsm/audit_internal.h>
53 #include <bsm/audit_kevents.h>
55 #include <security/audit/audit.h>
56 #include <security/audit/audit_bsd.h>
57 #include <security/audit/audit_ioctl.h>
58 #include <security/audit/audit_private.h>
60 #include <vm/vm_protos.h>
61 #include <mach/mach_port.h>
62 #include <kern/audit_sessionport.h>
64 #include <libkern/OSDebug.h>
67 * Audit Session Entry. This is treated as an object with public and private
68 * data. The se_auinfo field is the only information that is public and
69 * needs to be the first entry.
72 auditinfo_addr_t se_auinfo
; /* Public audit session data. */
73 #define se_asid se_auinfo.ai_asid
74 #define se_auid se_auinfo.ai_auid
75 #define se_mask se_auinfo.ai_mask
76 #define se_termid se_auinfo.ai_termid
77 #define se_flags se_auinfo.ai_flags
79 long se_refcnt
; /* Reference count. */
80 long se_procnt
; /* Processes in session. */
81 ipc_port_t se_port
; /* Session port. */
82 LIST_ENTRY(au_sentry
) se_link
; /* Hash bucket link list (1) */
84 typedef struct au_sentry au_sentry_t
;
86 #define AU_SENTRY_PTR(aia_p) ((au_sentry_t *)(aia_p))
89 * The default au_sentry/auditinfo_addr entry for ucred.
92 static au_sentry_t audit_default_se
= {
94 .ai_auid
= AU_DEFAUDITID
,
95 .ai_asid
= AU_DEFAUDITSID
,
96 .ai_termid
= { .at_type
= AU_IPv4
, },
102 struct auditinfo_addr
* const audit_default_aia_p
= &audit_default_se
.se_auinfo
;
104 /* Copied from <ipc/ipc_object.h> */
105 #define IPC_OBJECT_COPYIN_FLAGS_ALLOW_IMMOVABLE_SEND 0x1
106 kern_return_t
ipc_object_copyin(ipc_space_t
, mach_port_name_t
,
107 mach_msg_type_name_t
, ipc_port_t
*, mach_port_context_t
, mach_msg_guard_flags_t
*, uint32_t);
108 void ipc_port_release_send(ipc_port_t
);
114 * Currently the hash table is a fixed size.
116 #define HASH_TABLE_SIZE 97
117 #define HASH_ASID(asid) (audit_session_hash(asid) % HASH_TABLE_SIZE)
119 static struct rwlock se_entry_lck
; /* (1) lock for se_link above */
121 LIST_HEAD(au_sentry_head
, au_sentry
);
122 static struct au_sentry_head
*au_sentry_bucket
= NULL
;
124 #define AU_HISTORY_LOGGING 0
125 #if AU_HISTORY_LOGGING
126 typedef enum au_history_event
{
127 AU_HISTORY_EVENT_UNKNOWN
= 0,
128 AU_HISTORY_EVENT_REF
= 1,
129 AU_HISTORY_EVENT_UNREF
= 2,
130 AU_HISTORY_EVENT_BIRTH
= 3,
131 AU_HISTORY_EVENT_DEATH
= 4,
132 AU_HISTORY_EVENT_FIND
= 5
133 } au_history_event_t
;
135 #define AU_HISTORY_MAX_STACK_DEPTH 8
138 struct au_sentry
*ptr
;
140 void *stack
[AU_HISTORY_MAX_STACK_DEPTH
];
141 unsigned int stack_depth
;
142 au_history_event_t event
;
145 static struct au_history
*au_history
;
146 static size_t au_history_size
= 65536;
147 static unsigned int au_history_index
;
149 static inline unsigned int
150 au_history_entries(void)
152 if (au_history_index
>= au_history_size
) {
153 return au_history_size
;
155 return au_history_index
;
160 au_history_record(au_sentry_t
*se
, au_history_event_t event
)
162 struct au_history
*p
;
165 i
= OSAddAtomic(1, &au_history_index
);
166 p
= &au_history
[i
% au_history_size
];
168 bzero(p
, sizeof(*p
));
170 bcopy(se
, &p
->se
, sizeof(p
->se
));
171 p
->stack_depth
= OSBacktrace(&p
->stack
[0], AU_HISTORY_MAX_STACK_DEPTH
);
175 #define au_history_record(se, event) do {} while (0)
178 MALLOC_DEFINE(M_AU_SESSION
, "audit_session", "Audit session data");
180 static void audit_ref_session(au_sentry_t
*se
);
181 static void audit_unref_session(au_sentry_t
*se
);
183 static void audit_session_event(int event
, auditinfo_addr_t
*aia_p
);
186 * Audit session device.
189 static MALLOC_DEFINE(M_AUDIT_SDEV
, "audit_sdev", "Audit sdevs");
190 static MALLOC_DEFINE(M_AUDIT_SDEV_ENTRY
, "audit_sdevent",
191 "Audit sdev entries and buffers");
194 * Default audit sdev buffer parameters.
196 #define AUDIT_SDEV_QLIMIT_DEFAULT 128
197 #define AUDIT_SDEV_QLIMIT_MIN 1
198 #define AUDIT_SDEV_QLIMIT_MAX 1024
203 struct audit_sdev_entry
{
205 u_int ase_record_len
;
206 TAILQ_ENTRY(audit_sdev_entry
) ase_queue
;
210 * Per audit sdev structure.
216 #define AUDIT_SDEV_ASYNC 0x00000001
217 #define AUDIT_SDEV_NBIO 0x00000002
219 #define AUDIT_SDEV_ALLSESSIONS 0x00010000
222 struct selinfo asdev_selinfo
;
226 au_asid_t asdev_asid
;
228 /* Per-sdev mutex for most fields in this struct. */
229 struct mtx asdev_mtx
;
232 * Per-sdev sleep lock serializing user-generated reads and
233 * flushes. uiomove() is called to copy out the current head
234 * record's data whie the record remains in the queue, so we
235 * prevent other threads from removing it using this lock.
237 struct slck asdev_sx
;
240 * Condition variable to signal when data has been delivered to
245 /* Count and bound of records in the queue. */
249 /* The number of bytes of data across all records. */
250 u_int asdev_qbyteslen
;
253 * The amount read so far of the first record in the queue.
254 * (The number of bytes available for reading in the queue is
255 * qbyteslen - qoffset.)
260 * Per-sdev operation statistics.
262 u_int64_t asdev_inserts
; /* Records added. */
263 u_int64_t asdev_reads
; /* Records read. */
264 u_int64_t asdev_drops
; /* Records dropped. */
267 * Current pending record list. This is protected by a
268 * combination of asdev_mtx and asdev_sx. Note that both
269 * locks are required to remove a record from the head of the
270 * queue, as an in-progress read may sleep while copying and,
271 * therefore, cannot hold asdev_mtx.
273 TAILQ_HEAD(, audit_sdev_entry
) asdev_queue
;
275 /* Global sdev list. */
276 TAILQ_ENTRY(audit_sdev
) asdev_list
;
279 #define AUDIT_SDEV_LOCK(asdev) mtx_lock(&(asdev)->asdev_mtx)
280 #define AUDIT_SDEV_LOCK_ASSERT(asdev) mtx_assert(&(asdev)->asdev_mtx, \
282 #define AUDIT_SDEV_LOCK_DESTROY(asdev) mtx_destroy(&(asdev)->asdev_mtx)
283 #define AUDIT_SDEV_LOCK_INIT(asdev) mtx_init(&(asdev)->asdev_mtx, \
284 "audit_sdev_mtx", NULL, MTX_DEF)
285 #define AUDIT_SDEV_UNLOCK(asdev) mtx_unlock(&(asdev)->asdev_mtx)
286 #define AUDIT_SDEV_MTX(asdev) (&(asdev)->asdev_mtx)
288 #define AUDIT_SDEV_SX_LOCK_DESTROY(asd) slck_destroy(&(asd)->asdev_sx)
289 #define AUDIT_SDEV_SX_LOCK_INIT(asd) slck_init(&(asd)->asdev_sx, \
291 #define AUDIT_SDEV_SX_XLOCK_ASSERT(asd) slck_assert(&(asd)->asdev_sx, \
293 #define AUDIT_SDEV_SX_XLOCK_SIG(asd) slck_lock_sig(&(asd)->asdev_sx)
294 #define AUDIT_SDEV_SX_XUNLOCK(asd) slck_unlock(&(asd)->asdev_sx)
297 * Cloning variables and constants.
299 #define AUDIT_SDEV_NAME "auditsessions"
300 #define MAX_AUDIT_SDEVS 32
302 static int audit_sdev_major
;
303 static void *devnode
;
306 * Global list of audit sdevs. The list is protected by a rw lock.
307 * Individaul record queues are protected by per-sdev locks. These
308 * locks synchronize between threads walking the list to deliver to
309 * individual sdevs and adds/removes of sdevs.
311 static TAILQ_HEAD(, audit_sdev
) audit_sdev_list
;
312 static struct rwlock audit_sdev_lock
;
314 #define AUDIT_SDEV_LIST_LOCK_INIT() rw_init(&audit_sdev_lock, \
315 "audit_sdev_list_lock")
316 #define AUDIT_SDEV_LIST_RLOCK() rw_rlock(&audit_sdev_lock)
317 #define AUDIT_SDEV_LIST_RUNLOCK() rw_runlock(&audit_sdev_lock)
318 #define AUDIT_SDEV_LIST_WLOCK() rw_wlock(&audit_sdev_lock)
319 #define AUDIT_SDEV_LIST_WLOCK_ASSERT() rw_assert(&audit_sdev_lock, \
321 #define AUDIT_SDEV_LIST_WUNLOCK() rw_wunlock(&audit_sdev_lock)
324 * dev_t doesn't have a pointer for "softc" data so we have to keep track of
325 * it with the following global array (indexed by the minor number).
327 * XXX We may want to dynamically grow this as need.
329 static struct audit_sdev
*audit_sdev_dtab
[MAX_AUDIT_SDEVS
];
332 * Special device methods and definition.
334 static open_close_fcn_t audit_sdev_open
;
335 static open_close_fcn_t audit_sdev_close
;
336 static read_write_fcn_t audit_sdev_read
;
337 static ioctl_fcn_t audit_sdev_ioctl
;
338 static select_fcn_t audit_sdev_poll
;
340 static const struct cdevsw audit_sdev_cdevsw
= {
341 .d_open
= audit_sdev_open
,
342 .d_close
= audit_sdev_close
,
343 .d_read
= audit_sdev_read
,
344 .d_write
= eno_rdwrt
,
345 .d_ioctl
= audit_sdev_ioctl
,
347 .d_reset
= eno_reset
,
349 .d_select
= audit_sdev_poll
,
351 .d_strategy
= eno_strat
,
356 * Global statistics on audit sdevs.
358 static int audit_sdev_count
; /* Current number of sdevs. */
359 static u_int64_t audit_sdev_ever
; /* Sdevs ever allocated. */
360 static u_int64_t audit_sdev_records
; /* Total records seen. */
361 static u_int64_t audit_sdev_drops
; /* Global record drop count. */
363 static int audit_sdev_init(void);
365 #define AUDIT_SENTRY_RWLOCK_INIT() rw_init(&se_entry_lck, \
367 #define AUDIT_SENTRY_RLOCK() rw_rlock(&se_entry_lck)
368 #define AUDIT_SENTRY_WLOCK() rw_wlock(&se_entry_lck)
369 #define AUDIT_SENTRY_RWLOCK_ASSERT() rw_assert(&se_entry_lck, RA_LOCKED)
370 #define AUDIT_SENTRY_RUNLOCK() rw_runlock(&se_entry_lck)
371 #define AUDIT_SENTRY_WUNLOCK() rw_wunlock(&se_entry_lck)
373 /* Access control on the auditinfo_addr.ai_flags member. */
374 static uint64_t audit_session_superuser_set_sflags_mask
;
375 static uint64_t audit_session_superuser_clear_sflags_mask
;
376 static uint64_t audit_session_member_set_sflags_mask
;
377 static uint64_t audit_session_member_clear_sflags_mask
;
378 SYSCTL_NODE(, OID_AUTO
, audit
, CTLFLAG_RW
| CTLFLAG_LOCKED
, 0, "Audit controls");
379 SYSCTL_NODE(_audit
, OID_AUTO
, session
, CTLFLAG_RW
| CTLFLAG_LOCKED
, 0, "Audit sessions");
380 SYSCTL_QUAD(_audit_session
, OID_AUTO
, superuser_set_sflags_mask
, CTLFLAG_RW
| CTLFLAG_LOCKED
,
381 &audit_session_superuser_set_sflags_mask
,
382 "Audit session flags settable by superuser");
383 SYSCTL_QUAD(_audit_session
, OID_AUTO
, superuser_clear_sflags_mask
, CTLFLAG_RW
| CTLFLAG_LOCKED
,
384 &audit_session_superuser_clear_sflags_mask
,
385 "Audit session flags clearable by superuser");
386 SYSCTL_QUAD(_audit_session
, OID_AUTO
, member_set_sflags_mask
, CTLFLAG_RW
| CTLFLAG_LOCKED
,
387 &audit_session_member_set_sflags_mask
,
388 "Audit session flags settable by a session member");
389 SYSCTL_QUAD(_audit_session
, OID_AUTO
, member_clear_sflags_mask
, CTLFLAG_RW
| CTLFLAG_LOCKED
,
390 &audit_session_member_clear_sflags_mask
,
391 "Audit session flags clearable by a session member");
393 extern int set_security_token_task_internal(proc_t p
, void *task
);
395 #define AUDIT_SESSION_DEBUG 0
396 #if AUDIT_SESSION_DEBUG
398 * The following is debugging code that can be used to get a snapshot of the
399 * session state. The audit session information is read out using sysctl:
401 * error = sysctlbyname("kern.audit_session_debug", buffer_ptr, &buffer_len,
404 #include <kern/kalloc.h>
407 * The per session record structure for the snapshot data.
409 struct au_sentry_debug
{
410 auditinfo_addr_t se_auinfo
;
411 int64_t se_refcnt
; /* refereence count */
412 int64_t se_procnt
; /* process count */
413 int64_t se_ptcnt
; /* process count from
416 typedef struct au_sentry_debug au_sentry_debug_t
;
418 static int audit_sysctl_session_debug(struct sysctl_oid
*oidp
, void *arg1
,
419 int arg2
, struct sysctl_req
*req
);
421 SYSCTL_PROC(_kern
, OID_AUTO
, audit_session_debug
, CTLFLAG_RD
| CTLFLAG_LOCKED
,
422 NULL
, 0, audit_sysctl_session_debug
, "S,audit_session_debug",
423 "Current session debug info for auditing.");
426 * Callouts for proc_interate() which is used to reconcile the audit session
427 * proc state information with the proc table. We get everything we need
428 * in the filterfn while the proc_lock() is held so we really don't need the
429 * callout() function.
432 audit_session_debug_callout(__unused proc_t p
, __unused
void *arg
)
434 return PROC_RETURNED_DONE
;
438 audit_session_debug_filterfn(proc_t p
, void *st
)
440 kauth_cred_t cred
= p
->p_ucred
;
441 auditinfo_addr_t
*aia_p
= cred
->cr_audit
.as_aia_p
;
442 au_sentry_debug_t
*sed_tab
= (au_sentry_debug_t
*) st
;
443 au_sentry_debug_t
*sdtp
;
446 if (IS_VALID_SESSION(aia_p
)) {
449 if (aia_p
->ai_asid
== sdtp
->se_asid
) {
452 /* Do some santy checks. */
453 se
= AU_SENTRY_PTR(aia_p
);
454 if (se
->se_refcnt
!= sdtp
->se_refcnt
) {
456 (int64_t)se
->se_refcnt
;
458 if (se
->se_procnt
!= sdtp
->se_procnt
) {
460 (int64_t)se
->se_procnt
;
465 } while (sdtp
->se_asid
!= 0 && sdtp
->se_auid
!= 0);
467 /* add it to the default sesison */
475 * Copy out the session debug info via the sysctl interface.
479 audit_sysctl_session_debug(__unused
struct sysctl_oid
*oidp
,
480 __unused
void *arg1
, __unused
int arg2
, struct sysctl_req
*req
)
483 au_sentry_debug_t
*sed_tab
, *next_sed
;
484 int i
, entry_cnt
= 0;
489 * This provides a read-only node.
491 if (req
->newptr
!= USER_ADDR_NULL
) {
496 * Walk the audit session hash table to determine the size.
498 AUDIT_SENTRY_RLOCK();
499 for (i
= 0; i
< HASH_TABLE_SIZE
; i
++) {
500 LIST_FOREACH(se
, &au_sentry_bucket
[i
], se_link
)
506 entry_cnt
++; /* add one for the default entry */
508 * If just querying then return the space required. There is an
509 * obvious race condition here so we just fudge this by 3 in case
510 * the audit session table grows.
512 if (req
->oldptr
== USER_ADDR_NULL
) {
513 req
->oldidx
= (entry_cnt
+ 3) * sizeof(au_sentry_debug_t
);
514 AUDIT_SENTRY_RUNLOCK();
519 * Alloc a temporary buffer.
521 if (req
->oldlen
< (entry_cnt
* sizeof(au_sentry_debug_t
))) {
522 AUDIT_SENTRY_RUNLOCK();
526 * We hold the lock over the alloc since we don't want the table to
527 * grow on us. Therefore, use the non-blocking version of kalloc().
529 sed_tab
= (au_sentry_debug_t
*)kheap_alloc(KHEAP_TEMP
,
530 entry_cnt
* sizeof(au_sentry_debug_t
), Z_NOWAIT
| Z_ZERO
);
531 if (sed_tab
== NULL
) {
532 AUDIT_SENTRY_RUNLOCK();
537 * Walk the audit session hash table and build the record array.
541 /* add the first entry for processes not tracked in sessions. */
542 bcopy(audit_default_aia_p
, &next_sed
->se_auinfo
, sizeof(au_sentry_t
));
543 next_sed
->se_refcnt
= (int64_t)audit_default_se
.se_refcnt
;
544 next_sed
->se_procnt
= (int64_t)audit_default_se
.se_procnt
;
546 sz
+= sizeof(au_sentry_debug_t
);
547 for (i
= 0; i
< HASH_TABLE_SIZE
; i
++) {
548 LIST_FOREACH(se
, &au_sentry_bucket
[i
], se_link
) {
550 next_sed
->se_auinfo
= se
->se_auinfo
;
551 next_sed
->se_refcnt
= (int64_t)se
->se_refcnt
;
552 next_sed
->se_procnt
= (int64_t)se
->se_procnt
;
554 sz
+= sizeof(au_sentry_debug_t
);
558 AUDIT_SENTRY_RUNLOCK();
560 /* Reconcile with the process table. */
561 proc_iterate(PROC_ALLPROCLIST
| PROC_ZOMBPROCLIST
,
562 audit_session_debug_callout
, NULL
,
563 audit_session_debug_filterfn
, (void *)&sed_tab
[0]);
567 err
= SYSCTL_OUT(req
, sed_tab
, sz
);
568 kheap_free(KHEAP_TEMP
, sed_tab
, entry_cnt
* sizeof(au_sentry_debug_t
));
573 #endif /* AUDIT_SESSION_DEBUG */
576 * Create and commit a session audit event. The proc and se arguments needs to
577 * be that of the subject and not necessarily the current process.
580 audit_session_event(int event
, auditinfo_addr_t
*aia_p
)
582 struct kaudit_record
*ar
;
584 KASSERT(AUE_SESSION_START
== event
|| AUE_SESSION_UPDATE
== event
||
585 AUE_SESSION_END
== event
|| AUE_SESSION_CLOSE
== event
,
586 ("audit_session_event: invalid event: %d", event
));
593 * Create a new audit record. The record will contain the subject
594 * ruid, rgid, egid, pid, auid, asid, amask, and term_addr
595 * (implicitly added by audit_new).
597 ar
= audit_new(event
, PROC_NULL
, /* Not used */ NULL
);
603 * Audit session events are always generated because they are used
604 * by some userland consumers so just set the preselect flag.
606 ar
->k_ar_commit
|= AR_PRESELECT_FILTER
;
609 * Populate the subject information. Note that the ruid, rgid,
610 * egid, and pid values are incorrect. We only need the auditinfo_addr
613 ar
->k_ar
.ar_subj_ruid
= 0;
614 ar
->k_ar
.ar_subj_rgid
= 0;
615 ar
->k_ar
.ar_subj_egid
= 0;
616 ar
->k_ar
.ar_subj_pid
= 0;
617 ar
->k_ar
.ar_subj_auid
= aia_p
->ai_auid
;
618 ar
->k_ar
.ar_subj_asid
= aia_p
->ai_asid
;
619 bcopy(&aia_p
->ai_termid
, &ar
->k_ar
.ar_subj_term_addr
,
620 sizeof(struct au_tid_addr
));
622 /* Add the audit masks to the record. */
623 ar
->k_ar
.ar_arg_amask
.am_success
= aia_p
->ai_mask
.am_success
;
624 ar
->k_ar
.ar_arg_amask
.am_failure
= aia_p
->ai_mask
.am_failure
;
625 ARG_SET_VALID(ar
, ARG_AMASK
);
627 /* Add the audit session flags to the record. */
628 ar
->k_ar
.ar_arg_value64
= aia_p
->ai_flags
;
629 ARG_SET_VALID(ar
, ARG_VALUE64
);
632 /* Commit the record to the queue. */
633 audit_commit(ar
, 0, 0);
637 * Hash the audit session ID using a simple 32-bit mix.
639 static inline uint32_t
640 audit_session_hash(au_asid_t asid
)
642 uint32_t a
= (uint32_t) asid
;
644 a
= (a
- (a
<< 6)) ^ (a
>> 17);
645 a
= (a
- (a
<< 9)) ^ (a
<< 4);
646 a
= (a
- (a
<< 3)) ^ (a
<< 10);
653 * Do an hash lookup and find the session entry for a given ASID. Return NULL
654 * if not found. If the session is found then audit_session_find takes a
658 audit_session_find(au_asid_t asid
)
661 au_sentry_t
*found_se
;
663 AUDIT_SENTRY_RWLOCK_ASSERT();
665 hkey
= HASH_ASID(asid
);
667 LIST_FOREACH(found_se
, &au_sentry_bucket
[hkey
], se_link
)
668 if (found_se
->se_asid
== asid
) {
669 au_history_record(found_se
, AU_HISTORY_EVENT_FIND
);
670 audit_ref_session(found_se
);
677 * Remove the given audit_session entry from the hash table.
680 audit_session_remove(au_sentry_t
*se
)
683 au_sentry_t
*found_se
, *tmp_se
;
685 au_history_record(se
, AU_HISTORY_EVENT_DEATH
);
686 KASSERT(se
->se_refcnt
== 0, ("audit_session_remove: ref count != 0"));
687 KASSERT(se
!= &audit_default_se
,
688 ("audit_session_remove: removing default session"));
690 hkey
= HASH_ASID(se
->se_asid
);
692 AUDIT_SENTRY_WLOCK();
694 * Check and see if someone got a reference before we got the lock.
696 if (se
->se_refcnt
!= 0) {
697 AUDIT_SENTRY_WUNLOCK();
701 audit_session_portdestroy(&se
->se_port
);
702 LIST_FOREACH_SAFE(found_se
, &au_sentry_bucket
[hkey
], se_link
, tmp_se
) {
703 if (found_se
== se
) {
705 * Generate an audit event to notify userland of the
708 audit_session_event(AUE_SESSION_CLOSE
,
709 &found_se
->se_auinfo
);
711 LIST_REMOVE(found_se
, se_link
);
712 AUDIT_SENTRY_WUNLOCK();
713 free(found_se
, M_AU_SESSION
);
718 AUDIT_SENTRY_WUNLOCK();
722 * Reference the session by incrementing the sentry ref count.
725 audit_ref_session(au_sentry_t
*se
)
729 if (se
== NULL
|| se
== &audit_default_se
) {
733 au_history_record(se
, AU_HISTORY_EVENT_REF
);
735 old_val
= OSAddAtomicLong(1, &se
->se_refcnt
);
736 KASSERT(old_val
< 100000,
737 ("audit_ref_session: Too many references on session."));
741 * Decrement the sentry ref count and remove the session entry if last one.
744 audit_unref_session(au_sentry_t
*se
)
748 if (se
== NULL
|| se
== &audit_default_se
) {
752 au_history_record(se
, AU_HISTORY_EVENT_UNREF
);
754 old_val
= OSAddAtomicLong(-1, &se
->se_refcnt
);
756 audit_session_remove(se
);
759 ("audit_unref_session: Too few references on session."));
763 * Increment the process count in the session.
766 audit_inc_procount(au_sentry_t
*se
)
770 if (se
== NULL
|| se
== &audit_default_se
) {
774 old_val
= OSAddAtomicLong(1, &se
->se_procnt
);
775 KASSERT(old_val
<= PID_MAX
,
776 ("audit_inc_procount: proc count > PID_MAX"));
780 * Decrement the process count and add a knote if it is the last process
781 * to exit the session.
784 audit_dec_procount(au_sentry_t
*se
)
788 if (se
== NULL
|| se
== &audit_default_se
) {
792 old_val
= OSAddAtomicLong(-1, &se
->se_procnt
);
794 * If this was the last process generate an audit event to notify
795 * userland of the session ending.
798 audit_session_event(AUE_SESSION_END
, &se
->se_auinfo
);
800 KASSERT(old_val
>= 1,
801 ("audit_dec_procount: proc count < 0"));
805 * Update the session entry and check to see if anything was updated.
807 * 0 Nothing was updated (We don't care about process preselection masks)
808 * 1 Something was updated.
811 audit_update_sentry(au_sentry_t
*se
, auditinfo_addr_t
*new_aia
)
813 auditinfo_addr_t
*aia
= &se
->se_auinfo
;
816 KASSERT(new_aia
!= audit_default_aia_p
,
817 ("audit_update_sentry: Trying to update the default aia."));
819 update
= (aia
->ai_auid
!= new_aia
->ai_auid
||
820 bcmp(&aia
->ai_termid
, &new_aia
->ai_termid
,
821 sizeof(new_aia
->ai_termid
)) ||
822 aia
->ai_flags
!= new_aia
->ai_flags
);
825 bcopy(new_aia
, aia
, sizeof(*aia
));
832 * Return the next session ID. The range of kernel generated audit session IDs
833 * is ASSIGNED_ASID_MIN to ASSIGNED_ASID_MAX.
836 audit_session_nextid(void)
838 static uint32_t next_asid
= ASSIGNED_ASID_MIN
;
840 AUDIT_SENTRY_RWLOCK_ASSERT();
842 if (next_asid
> ASSIGNED_ASID_MAX
) {
843 next_asid
= ASSIGNED_ASID_MIN
;
850 * Allocated a new audit_session entry and add it to the hash table. If the
851 * given ASID is set to AU_ASSIGN_ASID then audit_session_new() will pick an
852 * audit session ID. Otherwise, it attempts use the one given. It creates a
853 * reference to the entry that must be unref'ed.
855 static auditinfo_addr_t
*
856 audit_session_new(auditinfo_addr_t
*new_aia_p
, auditinfo_addr_t
*old_aia_p
)
859 au_sentry_t
*se
= NULL
;
860 au_sentry_t
*found_se
= NULL
;
861 auditinfo_addr_t
*aia
= NULL
;
863 KASSERT(new_aia_p
!= NULL
, ("audit_session_new: new_aia_p == NULL"));
865 new_asid
= new_aia_p
->ai_asid
;
868 * Alloc a new session entry now so we don't wait holding the lock.
870 se
= malloc(sizeof(au_sentry_t
), M_AU_SESSION
, M_WAITOK
| M_ZERO
);
873 * Find an unique session ID, if desired.
875 AUDIT_SENTRY_WLOCK();
876 if (new_asid
== AU_ASSIGN_ASID
) {
878 new_asid
= (au_asid_t
)audit_session_nextid();
879 found_se
= audit_session_find(new_asid
);
882 * If the session ID is currently active then drop the
883 * reference and try again.
885 if (found_se
!= NULL
) {
886 audit_unref_session(found_se
);
893 * Check to see if the requested ASID is already in the
894 * hash table. If so, update it with the new auditinfo.
896 if ((found_se
= audit_session_find(new_asid
)) != NULL
) {
899 updated
= audit_update_sentry(found_se
, new_aia_p
);
901 AUDIT_SENTRY_WUNLOCK();
902 free(se
, M_AU_SESSION
);
904 /* If a different session then add this process in. */
905 if (new_aia_p
!= old_aia_p
) {
906 audit_inc_procount(found_se
);
910 * If the session information was updated then
911 * generate an audit event to notify userland.
914 audit_session_event(AUE_SESSION_UPDATE
,
915 &found_se
->se_auinfo
);
918 return &found_se
->se_auinfo
;
923 * Start the reference and proc count at 1 to account for the process
924 * that invoked this via setaudit_addr() (or friends).
926 se
->se_refcnt
= se
->se_procnt
= 1;
929 * Populate the new session entry. Note that process masks are stored
930 * in kauth ucred so just zero them here.
932 se
->se_port
= IPC_PORT_NULL
;
933 aia
= &se
->se_auinfo
;
934 aia
->ai_asid
= new_asid
;
935 aia
->ai_auid
= new_aia_p
->ai_auid
;
936 bzero(&new_aia_p
->ai_mask
, sizeof(new_aia_p
->ai_mask
));
937 bcopy(&new_aia_p
->ai_termid
, &aia
->ai_termid
, sizeof(aia
->ai_termid
));
938 aia
->ai_flags
= new_aia_p
->ai_flags
;
941 * Add it to the hash table.
943 LIST_INSERT_HEAD(&au_sentry_bucket
[HASH_ASID(new_asid
)], se
, se_link
);
944 AUDIT_SENTRY_WUNLOCK();
947 * Generate an audit event to notify userland of the new session.
949 audit_session_event(AUE_SESSION_START
, aia
);
950 au_history_record(se
, AU_HISTORY_EVENT_BIRTH
);
955 * Lookup an existing session. A copy of the audit session info for a given
956 * ASID is returned in ret_aia. Returns 0 on success.
959 audit_session_lookup(au_asid_t asid
, auditinfo_addr_t
*ret_aia
)
961 au_sentry_t
*se
= NULL
;
963 if ((uint32_t)asid
> ASSIGNED_ASID_MAX
) {
966 AUDIT_SENTRY_RLOCK();
967 if ((se
= audit_session_find(asid
)) == NULL
) {
968 AUDIT_SENTRY_RUNLOCK();
971 /* We have a reference on the session so it is safe to drop the lock. */
972 AUDIT_SENTRY_RUNLOCK();
973 if (ret_aia
!= NULL
) {
974 bcopy(&se
->se_auinfo
, ret_aia
, sizeof(*ret_aia
));
976 audit_unref_session(se
);
982 audit_session_aiaref(auditinfo_addr_t
*aia_p
)
984 audit_ref_session(AU_SENTRY_PTR(aia_p
));
988 * Add a reference to the session entry.
991 audit_session_ref(kauth_cred_t cred
)
993 auditinfo_addr_t
*aia_p
;
995 KASSERT(IS_VALID_CRED(cred
),
996 ("audit_session_ref: Invalid kauth_cred."));
998 aia_p
= cred
->cr_audit
.as_aia_p
;
999 audit_session_aiaref(aia_p
);
1003 audit_session_aiaunref(auditinfo_addr_t
*aia_p
)
1005 audit_unref_session(AU_SENTRY_PTR(aia_p
));
1009 * Remove a reference to the session entry.
1012 audit_session_unref(kauth_cred_t cred
)
1014 auditinfo_addr_t
*aia_p
;
1016 KASSERT(IS_VALID_CRED(cred
),
1017 ("audit_session_unref: Invalid kauth_cred."));
1019 aia_p
= cred
->cr_audit
.as_aia_p
;
1020 audit_session_aiaunref(aia_p
);
1024 * Increment the per audit session process count. Assumes that the caller has
1025 * a reference on the process' cred.
1028 audit_session_procnew(proc_t p
)
1030 kauth_cred_t cred
= p
->p_ucred
;
1031 auditinfo_addr_t
*aia_p
;
1033 KASSERT(IS_VALID_CRED(cred
),
1034 ("audit_session_procnew: Invalid kauth_cred."));
1036 aia_p
= cred
->cr_audit
.as_aia_p
;
1038 audit_inc_procount(AU_SENTRY_PTR(aia_p
));
1042 * Decrement the per audit session process count. Assumes that the caller has
1043 * a reference on the cred.
1046 audit_session_procexit(proc_t p
)
1048 kauth_cred_t cred
= p
->p_ucred
;
1049 auditinfo_addr_t
*aia_p
;
1051 KASSERT(IS_VALID_CRED(cred
),
1052 ("audit_session_procexit: Invalid kauth_cred."));
1054 aia_p
= cred
->cr_audit
.as_aia_p
;
1056 audit_dec_procount(AU_SENTRY_PTR(aia_p
));
1060 * Init the audit session code.
1063 audit_session_init(void)
1067 KASSERT((ASSIGNED_ASID_MAX
- ASSIGNED_ASID_MIN
) > PID_MAX
,
1068 ("audit_session_init: ASSIGNED_ASID_MAX is not large enough."));
1070 AUDIT_SENTRY_RWLOCK_INIT();
1072 au_sentry_bucket
= malloc( sizeof(struct au_sentry
) *
1073 HASH_TABLE_SIZE
, M_AU_SESSION
, M_WAITOK
| M_ZERO
);
1075 for (i
= 0; i
< HASH_TABLE_SIZE
; i
++) {
1076 LIST_INIT(&au_sentry_bucket
[i
]);
1079 (void)audit_sdev_init();
1080 #if AU_HISTORY_LOGGING
1081 au_history
= malloc(sizeof(struct au_history
) * au_history_size
,
1082 M_AU_SESSION
, M_WAITOK
| M_ZERO
);
1087 audit_session_update_check(kauth_cred_t cred
, auditinfo_addr_t
*old
,
1088 auditinfo_addr_t
*new)
1092 /* If the current audit ID is not the default then it is immutable. */
1093 if (old
->ai_auid
!= AU_DEFAUDITID
&& old
->ai_auid
!= new->ai_auid
) {
1097 /* If the current termid is not the default then it is immutable. */
1098 if ((old
->ai_termid
.at_type
!= AU_IPv4
||
1099 old
->ai_termid
.at_port
!= 0 ||
1100 old
->ai_termid
.at_addr
[0] != 0) &&
1101 (old
->ai_termid
.at_port
!= new->ai_termid
.at_port
||
1102 old
->ai_termid
.at_type
!= new->ai_termid
.at_type
||
1103 0 != bcmp(&old
->ai_termid
.at_addr
, &new->ai_termid
.at_addr
,
1104 sizeof(old
->ai_termid
.at_addr
)))) {
1108 /* The flags may be set only according to the
1109 * audit_session_*_set_sflags_masks.
1111 n
= ~old
->ai_flags
& new->ai_flags
;
1113 !((n
== (audit_session_superuser_set_sflags_mask
& n
) &&
1114 kauth_cred_issuser(cred
)) ||
1115 (n
== (audit_session_member_set_sflags_mask
& n
) &&
1116 old
->ai_asid
== new->ai_asid
))) {
1120 /* The flags may be cleared only according to the
1121 * audit_session_*_clear_sflags_masks.
1123 n
= ~new->ai_flags
& old
->ai_flags
;
1125 !((n
== (audit_session_superuser_clear_sflags_mask
& n
) &&
1126 kauth_cred_issuser(cred
)) ||
1127 (n
== (audit_session_member_clear_sflags_mask
& n
) &&
1128 old
->ai_asid
== new->ai_asid
))) {
1132 /* The audit masks are mutable. */
1137 * Safely update kauth cred of the given process with new the given audit info.
1140 audit_session_setaia(proc_t p
, auditinfo_addr_t
*new_aia_p
)
1142 kauth_cred_t my_cred
, my_new_cred
;
1143 struct au_session as
;
1144 struct au_session tmp_as
;
1145 auditinfo_addr_t caia
, *old_aia_p
;
1149 * If this is going to modify an existing session then do some
1152 if (audit_session_lookup(new_aia_p
->ai_asid
, &caia
) == 0) {
1153 my_cred
= kauth_cred_proc_ref(p
);
1154 ret
= audit_session_update_check(my_cred
, &caia
, new_aia_p
);
1155 kauth_cred_unref(&my_cred
);
1161 my_cred
= kauth_cred_proc_ref(p
);
1162 bcopy(&new_aia_p
->ai_mask
, &as
.as_mask
, sizeof(as
.as_mask
));
1163 old_aia_p
= my_cred
->cr_audit
.as_aia_p
;
1164 /* audit_session_new() adds a reference on the session */
1165 as
.as_aia_p
= audit_session_new(new_aia_p
, old_aia_p
);
1167 /* If the process left a session then update the process count. */
1168 if (old_aia_p
!= new_aia_p
) {
1169 audit_dec_procount(AU_SENTRY_PTR(old_aia_p
));
1174 * We are modifying the audit info in a credential so we need a new
1175 * credential (or take another reference on an existing credential that
1176 * matches our new one). We must do this because the audit info in the
1177 * credential is used as part of our hash key. Get current credential
1178 * in the target process and take a reference while we muck with it.
1182 * Set the credential with new info. If there is no change,
1183 * we get back the same credential we passed in; if there is
1184 * a change, we drop the reference on the credential we
1185 * passed in. The subsequent compare is safe, because it is
1186 * a pointer compare rather than a contents compare.
1188 bcopy(&as
, &tmp_as
, sizeof(tmp_as
));
1189 my_new_cred
= kauth_cred_setauditinfo(my_cred
, &tmp_as
);
1191 if (my_cred
!= my_new_cred
) {
1193 /* Need to protect for a race where another thread also
1194 * changed the credential after we took our reference.
1195 * If p_ucred has changed then we should restart this
1196 * again with the new cred.
1198 if (p
->p_ucred
!= my_cred
) {
1199 proc_ucred_unlock(p
);
1200 audit_session_unref(my_new_cred
);
1201 kauth_cred_unref(&my_new_cred
);
1203 my_cred
= kauth_cred_proc_ref(p
);
1206 p
->p_ucred
= my_new_cred
;
1207 /* update cred on proc */
1208 PROC_UPDATE_CREDS_ONPROC(p
);
1209 proc_ucred_unlock(p
);
1212 * Drop old proc reference or our extra reference.
1214 kauth_cred_unref(&my_cred
);
1218 /* Drop the reference taken by audit_session_new() above. */
1219 audit_unref_session(AU_SENTRY_PTR(as
.as_aia_p
));
1221 /* Propagate the change from the process to the Mach task. */
1222 set_security_token(p
);
1228 * audit_session_self (system call)
1230 * Description: Obtain a Mach send right for the current session.
1232 * Parameters: p Process calling audit_session_self().
1234 * Returns: *ret_port Named Mach send right, which may be
1235 * MACH_PORT_NULL in the failure case.
1238 * EINVAL The calling process' session has not be set.
1239 * ESRCH Bad process, can't get valid cred for process.
1240 * ENOMEM Port allocation failed due to no free memory.
1243 audit_session_self(proc_t p
, __unused
struct audit_session_self_args
*uap
,
1244 mach_port_name_t
*ret_port
)
1246 ipc_port_t sendport
= IPC_PORT_NULL
;
1247 kauth_cred_t cred
= NULL
;
1248 auditinfo_addr_t
*aia_p
;
1252 cred
= kauth_cred_proc_ref(p
);
1253 if (!IS_VALID_CRED(cred
)) {
1258 aia_p
= cred
->cr_audit
.as_aia_p
;
1259 if (!IS_VALID_SESSION(aia_p
)) {
1260 /* Can't join the default session. */
1265 se
= AU_SENTRY_PTR(aia_p
);
1268 * Processes that join using this mach port will inherit this process'
1269 * pre-selection masks.
1271 if (se
->se_port
== IPC_PORT_NULL
) {
1272 bcopy(&cred
->cr_audit
.as_mask
, &se
->se_mask
,
1273 sizeof(se
->se_mask
));
1277 * Get a send right to the session's Mach port and insert it in the
1278 * process' mach port namespace.
1280 sendport
= audit_session_mksend(aia_p
, &se
->se_port
);
1281 *ret_port
= ipc_port_copyout_send(sendport
, get_task_ipcspace(p
->task
));
1285 kauth_cred_unref(&cred
);
1288 *ret_port
= MACH_PORT_NULL
;
1294 * audit_session_port (system call)
1296 * Description: Obtain a Mach send right for the given session ID.
1298 * Parameters: p Process calling audit_session_port().
1299 * uap->asid The target audit session ID. The special
1300 * value -1 can be used to target the process's
1302 * uap->portnamep User address at which to place port name.
1304 * Returns: 0 Success
1305 * EINVAL The calling process' session has not be set.
1306 * EINVAL The given session ID could not be found.
1307 * EINVAL The Mach port right could not be copied out.
1308 * ESRCH Bad process, can't get valid cred for process.
1309 * EPERM Only the superuser can reference sessions other
1310 * than the process's own.
1311 * ENOMEM Port allocation failed due to no free memory.
1314 audit_session_port(proc_t p
, struct audit_session_port_args
*uap
,
1315 __unused
int *retval
)
1317 ipc_port_t sendport
= IPC_PORT_NULL
;
1318 mach_port_name_t portname
= MACH_PORT_NULL
;
1319 kauth_cred_t cred
= NULL
;
1320 auditinfo_addr_t
*aia_p
= NULL
;
1321 au_sentry_t
*se
= NULL
;
1324 /* Note: Currently this test will never be true, because
1325 * ASSIGNED_ASID_MAX is effectively (uint32_t)-2.
1327 if (uap
->asid
!= -1 && (uint32_t)uap
->asid
> ASSIGNED_ASID_MAX
) {
1331 cred
= kauth_cred_proc_ref(p
);
1332 if (!IS_VALID_CRED(cred
)) {
1336 aia_p
= cred
->cr_audit
.as_aia_p
;
1338 /* Find the session corresponding to the requested audit
1339 * session ID. If found, take a reference on it so that
1340 * the session is not dropped until the join is later done.
1342 if (uap
->asid
== (au_asid_t
)-1 ||
1343 uap
->asid
== aia_p
->ai_asid
) {
1344 if (!IS_VALID_SESSION(aia_p
)) {
1345 /* Can't join the default session. */
1350 /* No privilege is required to obtain a port for our
1353 se
= AU_SENTRY_PTR(aia_p
);
1354 audit_ref_session(se
);
1357 * Only privileged processes may obtain a port for
1358 * any existing session.
1360 err
= priv_check_cred(cred
, PRIV_AUDIT_SESSION_PORT
, 0);
1364 AUDIT_SENTRY_RLOCK();
1365 se
= audit_session_find(uap
->asid
);
1366 AUDIT_SENTRY_RUNLOCK();
1371 aia_p
= &se
->se_auinfo
;
1375 * Processes that join using this mach port will inherit this process'
1376 * pre-selection masks.
1378 if (se
->se_port
== IPC_PORT_NULL
) {
1379 bcopy(&cred
->cr_audit
.as_mask
, &se
->se_mask
,
1380 sizeof(se
->se_mask
));
1384 * Use the session reference to create a mach port reference for the
1385 * session (at which point we are free to drop the session reference)
1386 * and then copy out the mach port to the process' mach port namespace.
1388 sendport
= audit_session_mksend(aia_p
, &se
->se_port
);
1389 portname
= ipc_port_copyout_send(sendport
, get_task_ipcspace(p
->task
));
1390 if (!MACH_PORT_VALID(portname
)) {
1394 err
= copyout(&portname
, uap
->portnamep
, sizeof(mach_port_name_t
));
1397 kauth_cred_unref(&cred
);
1400 audit_unref_session(se
);
1402 if (MACH_PORT_VALID(portname
) && 0 != err
) {
1403 (void)mach_port_deallocate(get_task_ipcspace(p
->task
),
1411 audit_session_join_internal(proc_t p
, task_t task
, ipc_port_t port
, au_asid_t
*new_asid
)
1413 auditinfo_addr_t
*new_aia_p
, *old_aia_p
;
1414 kauth_cred_t my_cred
= NULL
;
1418 *new_asid
= AU_DEFAUDITSID
;
1420 if ((new_aia_p
= audit_session_porttoaia(port
)) == NULL
) {
1426 kauth_cred_ref(p
->p_ucred
);
1427 my_cred
= p
->p_ucred
;
1428 if (!IS_VALID_CRED(my_cred
)) {
1429 kauth_cred_unref(&my_cred
);
1430 proc_ucred_unlock(p
);
1434 old_aia_p
= my_cred
->cr_audit
.as_aia_p
;
1435 old_asid
= old_aia_p
->ai_asid
;
1436 *new_asid
= new_aia_p
->ai_asid
;
1439 * Add process in if not already in the session.
1441 if (*new_asid
!= old_asid
) {
1442 kauth_cred_t my_new_cred
;
1443 struct au_session new_as
;
1445 bcopy(&new_aia_p
->ai_mask
, &new_as
.as_mask
,
1446 sizeof(new_as
.as_mask
));
1447 new_as
.as_aia_p
= new_aia_p
;
1449 my_new_cred
= kauth_cred_setauditinfo(my_cred
, &new_as
);
1450 p
->p_ucred
= my_new_cred
;
1451 PROC_UPDATE_CREDS_ONPROC(p
);
1453 /* Increment the proc count of new session */
1454 audit_inc_procount(AU_SENTRY_PTR(new_aia_p
));
1456 proc_ucred_unlock(p
);
1458 /* Propagate the change from the process to the Mach task. */
1459 set_security_token_task_internal(p
, task
);
1461 /* Decrement the process count of the former session. */
1462 audit_dec_procount(AU_SENTRY_PTR(old_aia_p
));
1464 proc_ucred_unlock(p
);
1466 kauth_cred_unref(&my_cred
);
1469 if (port
!= IPC_PORT_NULL
) {
1470 ipc_port_release_send(port
);
1477 * audit_session_spawnjoin
1479 * Description: posix_spawn() interface to audit_session_join_internal().
1481 * Returns: 0 Success
1482 * EINVAL Invalid Mach port name.
1483 * ESRCH Invalid calling process/cred.
1486 audit_session_spawnjoin(proc_t p
, task_t task
, ipc_port_t port
)
1490 return audit_session_join_internal(p
, task
, port
, &new_asid
);
1494 * audit_session_join (system call)
1496 * Description: Join the session for a given Mach port send right.
1498 * Parameters: p Process calling session join.
1499 * uap->port A Mach send right.
1501 * Returns: *ret_asid Audit session ID of new session.
1502 * In the failure case the return value will be -1
1503 * and 'errno' will be set to a non-zero value
1507 * EINVAL Invalid Mach port name.
1508 * ESRCH Invalid calling process/cred.
1511 audit_session_join(proc_t p
, struct audit_session_join_args
*uap
,
1512 au_asid_t
*ret_asid
)
1514 ipc_port_t port
= IPC_PORT_NULL
;
1515 mach_port_name_t send
= uap
->port
;
1519 if (ipc_object_copyin(get_task_ipcspace(p
->task
), send
,
1520 MACH_MSG_TYPE_COPY_SEND
, &port
, 0, NULL
, IPC_OBJECT_COPYIN_FLAGS_ALLOW_IMMOVABLE_SEND
) != KERN_SUCCESS
) {
1521 *ret_asid
= AU_DEFAUDITSID
;
1524 err
= audit_session_join_internal(p
, p
->task
, port
, ret_asid
);
1531 * Audit session device.
1535 * Free an audit sdev entry.
1538 audit_sdev_entry_free(struct audit_sdev_entry
*ase
)
1540 free(ase
->ase_record
, M_AUDIT_SDEV_ENTRY
);
1541 free(ase
, M_AUDIT_SDEV_ENTRY
);
1545 * Append individual record to a queue. Allocate queue-local buffer and
1546 * add to the queue. If the queue is full or we can't allocate memory,
1547 * drop the newest record.
1550 audit_sdev_append(struct audit_sdev
*asdev
, void *record
, u_int record_len
)
1552 struct audit_sdev_entry
*ase
;
1554 AUDIT_SDEV_LOCK_ASSERT(asdev
);
1556 if (asdev
->asdev_qlen
>= asdev
->asdev_qlimit
) {
1557 asdev
->asdev_drops
++;
1562 ase
= malloc(sizeof(*ase
), M_AUDIT_SDEV_ENTRY
, M_NOWAIT
| M_ZERO
);
1564 asdev
->asdev_drops
++;
1569 ase
->ase_record
= malloc(record_len
, M_AUDIT_SDEV_ENTRY
, M_NOWAIT
);
1570 if (NULL
== ase
->ase_record
) {
1571 free(ase
, M_AUDIT_SDEV_ENTRY
);
1572 asdev
->asdev_drops
++;
1577 bcopy(record
, ase
->ase_record
, record_len
);
1578 ase
->ase_record_len
= record_len
;
1580 TAILQ_INSERT_TAIL(&asdev
->asdev_queue
, ase
, ase_queue
);
1581 asdev
->asdev_inserts
++;
1582 asdev
->asdev_qlen
++;
1583 asdev
->asdev_qbyteslen
+= ase
->ase_record_len
;
1584 selwakeup(&asdev
->asdev_selinfo
);
1585 if (asdev
->asdev_flags
& AUDIT_SDEV_ASYNC
) {
1586 pgsigio(asdev
->asdev_sigio
, SIGIO
);
1589 cv_broadcast(&asdev
->asdev_cv
);
1593 * Submit an audit record to be queued in the audit session device.
1596 audit_sdev_submit(__unused au_id_t auid
, __unused au_asid_t asid
, void *record
,
1599 struct audit_sdev
*asdev
;
1602 * Lockless read to avoid lock overhead if sessio devices are not in
1605 if (NULL
== TAILQ_FIRST(&audit_sdev_list
)) {
1609 AUDIT_SDEV_LIST_RLOCK();
1610 TAILQ_FOREACH(asdev
, &audit_sdev_list
, asdev_list
) {
1611 AUDIT_SDEV_LOCK(asdev
);
1614 * Only append to the sdev queue if the AUID and ASID match that
1615 * of the process that opened this session device or if the
1616 * ALLSESSIONS flag is set.
1618 if ((/* XXXss auid == asdev->asdev_auid && */
1619 asid
== asdev
->asdev_asid
) ||
1620 (asdev
->asdev_flags
& AUDIT_SDEV_ALLSESSIONS
) != 0) {
1621 audit_sdev_append(asdev
, record
, record_len
);
1623 AUDIT_SDEV_UNLOCK(asdev
);
1625 AUDIT_SDEV_LIST_RUNLOCK();
1627 /* Unlocked increment. */
1628 audit_sdev_records
++;
1632 * Allocate a new audit sdev. Connects the sdev, on succes, to the global
1633 * list and updates statistics.
1635 static struct audit_sdev
*
1636 audit_sdev_alloc(void)
1638 struct audit_sdev
*asdev
;
1640 AUDIT_SDEV_LIST_WLOCK_ASSERT();
1642 asdev
= malloc(sizeof(*asdev
), M_AUDIT_SDEV
, M_WAITOK
| M_ZERO
);
1643 if (NULL
== asdev
) {
1647 asdev
->asdev_qlimit
= AUDIT_SDEV_QLIMIT_DEFAULT
;
1648 TAILQ_INIT(&asdev
->asdev_queue
);
1649 AUDIT_SDEV_LOCK_INIT(asdev
);
1650 AUDIT_SDEV_SX_LOCK_INIT(asdev
);
1651 cv_init(&asdev
->asdev_cv
, "audit_sdev_cv");
1654 * Add to global list and update global statistics.
1656 TAILQ_INSERT_HEAD(&audit_sdev_list
, asdev
, asdev_list
);
1664 * Flush all records currently present in an audit sdev.
1667 audit_sdev_flush(struct audit_sdev
*asdev
)
1669 struct audit_sdev_entry
*ase
;
1671 AUDIT_SDEV_LOCK_ASSERT(asdev
);
1673 while ((ase
= TAILQ_FIRST(&asdev
->asdev_queue
)) != NULL
) {
1674 TAILQ_REMOVE(&asdev
->asdev_queue
, ase
, ase_queue
);
1675 asdev
->asdev_qbyteslen
-= ase
->ase_record_len
;
1676 audit_sdev_entry_free(ase
);
1677 asdev
->asdev_qlen
--;
1679 asdev
->asdev_qoffset
= 0;
1681 KASSERT(0 == asdev
->asdev_qlen
, ("audit_sdev_flush: asdev_qlen"));
1682 KASSERT(0 == asdev
->asdev_qbyteslen
,
1683 ("audit_sdev_flush: asdev_qbyteslen"));
1687 * Free an audit sdev.
1690 audit_sdev_free(struct audit_sdev
*asdev
)
1692 AUDIT_SDEV_LIST_WLOCK_ASSERT();
1693 AUDIT_SDEV_LOCK_ASSERT(asdev
);
1695 /* XXXss - preselect hook here */
1696 audit_sdev_flush(asdev
);
1697 cv_destroy(&asdev
->asdev_cv
);
1698 AUDIT_SDEV_SX_LOCK_DESTROY(asdev
);
1699 AUDIT_SDEV_UNLOCK(asdev
);
1700 AUDIT_SDEV_LOCK_DESTROY(asdev
);
1702 TAILQ_REMOVE(&audit_sdev_list
, asdev
, asdev_list
);
1703 free(asdev
, M_AUDIT_SDEV
);
1708 * Get the auditinfo_addr of the proc and check to see if suser. Will return
1709 * non-zero if not suser.
1712 audit_sdev_get_aia(proc_t p
, struct auditinfo_addr
*aia_p
)
1717 scred
= kauth_cred_proc_ref(p
);
1718 error
= suser(scred
, &p
->p_acflag
);
1720 if (NULL
!= aia_p
) {
1721 bcopy(scred
->cr_audit
.as_aia_p
, aia_p
, sizeof(*aia_p
));
1723 kauth_cred_unref(&scred
);
1729 * Audit session dev open method.
1732 audit_sdev_open(dev_t dev
, __unused
int flags
, __unused
int devtype
, proc_t p
)
1734 struct audit_sdev
*asdev
;
1735 struct auditinfo_addr aia
;
1739 if (u
< 0 || u
>= MAX_AUDIT_SDEVS
) {
1743 (void) audit_sdev_get_aia(p
, &aia
);
1745 AUDIT_SDEV_LIST_WLOCK();
1746 asdev
= audit_sdev_dtab
[u
];
1747 if (NULL
== asdev
) {
1748 asdev
= audit_sdev_alloc();
1749 if (NULL
== asdev
) {
1750 AUDIT_SDEV_LIST_WUNLOCK();
1753 audit_sdev_dtab
[u
] = asdev
;
1755 KASSERT(asdev
->asdev_open
, ("audit_sdev_open: Already open"));
1756 AUDIT_SDEV_LIST_WUNLOCK();
1759 asdev
->asdev_open
= 1;
1760 asdev
->asdev_auid
= aia
.ai_auid
;
1761 asdev
->asdev_asid
= aia
.ai_asid
;
1762 asdev
->asdev_flags
= 0;
1764 AUDIT_SDEV_LIST_WUNLOCK();
1770 * Audit session dev close method.
1773 audit_sdev_close(dev_t dev
, __unused
int flags
, __unused
int devtype
,
1776 struct audit_sdev
*asdev
;
1780 asdev
= audit_sdev_dtab
[u
];
1782 KASSERT(asdev
!= NULL
, ("audit_sdev_close: asdev == NULL"));
1783 KASSERT(asdev
->asdev_open
, ("audit_sdev_close: !asdev_open"));
1785 AUDIT_SDEV_LIST_WLOCK();
1786 AUDIT_SDEV_LOCK(asdev
);
1787 asdev
->asdev_open
= 0;
1788 audit_sdev_free(asdev
); /* sdev lock unlocked in audit_sdev_free() */
1789 audit_sdev_dtab
[u
] = NULL
;
1790 AUDIT_SDEV_LIST_WUNLOCK();
1796 * Audit session dev ioctl method.
1799 audit_sdev_ioctl(dev_t dev
, u_long cmd
, caddr_t data
,
1800 __unused
int flag
, proc_t p
)
1802 struct audit_sdev
*asdev
;
1805 asdev
= audit_sdev_dtab
[minor(dev
)];
1806 KASSERT(asdev
!= NULL
, ("audit_sdev_ioctl: asdev == NULL"));
1812 AUDIT_SDEV_LOCK(asdev
);
1814 asdev
->asdev_flags
|= AUDIT_SDEV_NBIO
;
1816 asdev
->asdev_flags
&= ~AUDIT_SDEV_NBIO
;
1818 AUDIT_SDEV_UNLOCK(asdev
);
1822 AUDIT_SDEV_LOCK(asdev
);
1823 *(int *)data
= asdev
->asdev_qbyteslen
- asdev
->asdev_qoffset
;
1824 AUDIT_SDEV_UNLOCK(asdev
);
1827 case AUDITSDEV_GET_QLEN
:
1828 *(u_int
*)data
= asdev
->asdev_qlen
;
1831 case AUDITSDEV_GET_QLIMIT
:
1832 *(u_int
*)data
= asdev
->asdev_qlimit
;
1835 case AUDITSDEV_SET_QLIMIT
:
1836 if (*(u_int
*)data
>= AUDIT_SDEV_QLIMIT_MIN
||
1837 *(u_int
*)data
<= AUDIT_SDEV_QLIMIT_MAX
) {
1838 asdev
->asdev_qlimit
= *(u_int
*)data
;
1844 case AUDITSDEV_GET_QLIMIT_MIN
:
1845 *(u_int
*)data
= AUDIT_SDEV_QLIMIT_MIN
;
1848 case AUDITSDEV_GET_QLIMIT_MAX
:
1849 *(u_int
*)data
= AUDIT_SDEV_QLIMIT_MAX
;
1852 case AUDITSDEV_FLUSH
:
1853 if (AUDIT_SDEV_SX_XLOCK_SIG(asdev
) != 0) {
1856 AUDIT_SDEV_LOCK(asdev
);
1857 audit_sdev_flush(asdev
);
1858 AUDIT_SDEV_UNLOCK(asdev
);
1859 AUDIT_SDEV_SX_XUNLOCK(asdev
);
1862 case AUDITSDEV_GET_MAXDATA
:
1863 *(u_int
*)data
= MAXAUDITDATA
;
1866 /* XXXss these should be 64 bit, maybe. */
1867 case AUDITSDEV_GET_INSERTS
:
1868 *(u_int
*)data
= asdev
->asdev_inserts
;
1871 case AUDITSDEV_GET_READS
:
1872 *(u_int
*)data
= asdev
->asdev_reads
;
1875 case AUDITSDEV_GET_DROPS
:
1876 *(u_int
*)data
= asdev
->asdev_drops
;
1879 case AUDITSDEV_GET_ALLSESSIONS
:
1880 error
= audit_sdev_get_aia(p
, NULL
);
1884 *(u_int
*)data
= (asdev
->asdev_flags
& AUDIT_SDEV_ALLSESSIONS
) ?
1888 case AUDITSDEV_SET_ALLSESSIONS
:
1889 error
= audit_sdev_get_aia(p
, NULL
);
1894 AUDIT_SDEV_LOCK(asdev
);
1896 asdev
->asdev_flags
|= AUDIT_SDEV_ALLSESSIONS
;
1898 asdev
->asdev_flags
&= ~AUDIT_SDEV_ALLSESSIONS
;
1900 AUDIT_SDEV_UNLOCK(asdev
);
1911 * Audit session dev read method.
1914 audit_sdev_read(dev_t dev
, struct uio
*uio
, __unused
int flag
)
1916 struct audit_sdev_entry
*ase
;
1917 struct audit_sdev
*asdev
;
1921 asdev
= audit_sdev_dtab
[minor(dev
)];
1922 KASSERT(NULL
!= asdev
, ("audit_sdev_read: asdev == NULL"));
1925 * We hold a sleep lock over read and flush because we rely on the
1926 * stability of a record in the queue during uiomove.
1928 if (0 != AUDIT_SDEV_SX_XLOCK_SIG(asdev
)) {
1931 AUDIT_SDEV_LOCK(asdev
);
1932 while (TAILQ_EMPTY(&asdev
->asdev_queue
)) {
1933 if (asdev
->asdev_flags
& AUDIT_SDEV_NBIO
) {
1934 AUDIT_SDEV_UNLOCK(asdev
);
1935 AUDIT_SDEV_SX_XUNLOCK(asdev
);
1938 error
= cv_wait_sig(&asdev
->asdev_cv
, AUDIT_SDEV_MTX(asdev
));
1940 AUDIT_SDEV_UNLOCK(asdev
);
1941 AUDIT_SDEV_SX_XUNLOCK(asdev
);
1947 * Copy as many remaining bytes from the current record to userspace
1948 * as we can. Keep processing records until we run out of records in
1949 * the queue or until the user buffer runs out of space.
1951 * We rely on the sleep lock to maintain ase's stability here.
1953 asdev
->asdev_reads
++;
1954 while ((ase
= TAILQ_FIRST(&asdev
->asdev_queue
)) != NULL
&&
1955 uio_resid(uio
) > 0) {
1956 AUDIT_SDEV_LOCK_ASSERT(asdev
);
1958 KASSERT(ase
->ase_record_len
> asdev
->asdev_qoffset
,
1959 ("audit_sdev_read: record_len > qoffset (1)"));
1960 toread
= MIN((int)(ase
->ase_record_len
- asdev
->asdev_qoffset
),
1962 AUDIT_SDEV_UNLOCK(asdev
);
1963 error
= uiomove((char *) ase
->ase_record
+ asdev
->asdev_qoffset
,
1966 AUDIT_SDEV_SX_XUNLOCK(asdev
);
1971 * If the copy succeeded then update book-keeping, and if no
1972 * bytes remain in the current record then free it.
1974 AUDIT_SDEV_LOCK(asdev
);
1975 KASSERT(TAILQ_FIRST(&asdev
->asdev_queue
) == ase
,
1976 ("audit_sdev_read: queue out of sync after uiomove"));
1977 asdev
->asdev_qoffset
+= toread
;
1978 KASSERT(ase
->ase_record_len
>= asdev
->asdev_qoffset
,
1979 ("audit_sdev_read: record_len >= qoffset (2)"));
1980 if (asdev
->asdev_qoffset
== ase
->ase_record_len
) {
1981 TAILQ_REMOVE(&asdev
->asdev_queue
, ase
, ase_queue
);
1982 asdev
->asdev_qbyteslen
-= ase
->ase_record_len
;
1983 audit_sdev_entry_free(ase
);
1984 asdev
->asdev_qlen
--;
1985 asdev
->asdev_qoffset
= 0;
1988 AUDIT_SDEV_UNLOCK(asdev
);
1989 AUDIT_SDEV_SX_XUNLOCK(asdev
);
1994 * Audit session device poll method.
1997 audit_sdev_poll(dev_t dev
, int events
, void *wql
, struct proc
*p
)
1999 struct audit_sdev
*asdev
;
2003 asdev
= audit_sdev_dtab
[minor(dev
)];
2004 KASSERT(NULL
!= asdev
, ("audit_sdev_poll: asdev == NULL"));
2006 if (events
& (POLLIN
| POLLRDNORM
)) {
2007 AUDIT_SDEV_LOCK(asdev
);
2008 if (NULL
!= TAILQ_FIRST(&asdev
->asdev_queue
)) {
2009 revents
|= events
& (POLLIN
| POLLRDNORM
);
2011 selrecord(p
, &asdev
->asdev_selinfo
, wql
);
2013 AUDIT_SDEV_UNLOCK(asdev
);
2019 * Audit sdev clone routine. Provides a new minor number or returns -1.
2020 * This called with DEVFS_LOCK held.
2023 audit_sdev_clone(__unused dev_t dev
, int action
)
2027 if (DEVFS_CLONE_ALLOC
== action
) {
2028 for (i
= 0; i
< MAX_AUDIT_SDEVS
; i
++) {
2029 if (NULL
== audit_sdev_dtab
[i
]) {
2035 * This really should return -1 here but that seems to
2036 * hang things in devfs. We instead return 0 and let
2037 * audit_sdev_open tell userland the bad news.
2046 audit_sdev_init(void)
2050 TAILQ_INIT(&audit_sdev_list
);
2051 AUDIT_SDEV_LIST_LOCK_INIT();
2053 audit_sdev_major
= cdevsw_add(-1, &audit_sdev_cdevsw
);
2054 if (audit_sdev_major
< 0) {
2055 return KERN_FAILURE
;
2058 dev
= makedev(audit_sdev_major
, 0);
2059 devnode
= devfs_make_node_clone(dev
, DEVFS_CHAR
, UID_ROOT
, GID_WHEEL
,
2060 0644, audit_sdev_clone
, AUDIT_SDEV_NAME
, 0);
2062 if (NULL
== devnode
) {
2063 return KERN_FAILURE
;
2066 return KERN_SUCCESS
;
2071 * audit_sdev_shutdown(void)
2074 * devfs_remove(devnode);
2075 * (void) cdevsw_remove(audit_sdev_major, &audit_sdev_cdevsw);
2077 * return (KERN_SUCCESS);
2084 audit_session_self(proc_t p
, struct audit_session_self_args
*uap
,
2085 mach_port_name_t
*ret_port
)
2087 #pragma unused(p, uap, ret_port)
2093 audit_session_join(proc_t p
, struct audit_session_join_args
*uap
,
2094 au_asid_t
*ret_asid
)
2096 #pragma unused(p, uap, ret_asid)
2102 audit_session_port(proc_t p
, struct audit_session_port_args
*uap
, int *retval
)
2104 #pragma unused(p, uap, retval)
2109 #endif /* CONFIG_AUDIT */