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
*audit_default_aia_p
= &audit_default_se
.se_auinfo
;
104 /* Copied from <ipc/ipc_object.h> */
105 #define IPC_KMSG_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 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
*)kalloc_noblock(entry_cnt
*
530 sizeof(au_sentry_debug_t
));
531 if (sed_tab
== NULL
) {
532 AUDIT_SENTRY_RUNLOCK();
535 bzero(sed_tab
, entry_cnt
* sizeof(au_sentry_debug_t
));
538 * Walk the audit session hash table and build the record array.
542 /* add the first entry for processes not tracked in sessions. */
543 bcopy(audit_default_aia_p
, &next_sed
->se_auinfo
, sizeof(au_sentry_t
));
544 next_sed
->se_refcnt
= (int64_t)audit_default_se
.se_refcnt
;
545 next_sed
->se_procnt
= (int64_t)audit_default_se
.se_procnt
;
547 sz
+= sizeof(au_sentry_debug_t
);
548 for (i
= 0; i
< HASH_TABLE_SIZE
; i
++) {
549 LIST_FOREACH(se
, &au_sentry_bucket
[i
], se_link
) {
551 next_sed
->se_auinfo
= se
->se_auinfo
;
552 next_sed
->se_refcnt
= (int64_t)se
->se_refcnt
;
553 next_sed
->se_procnt
= (int64_t)se
->se_procnt
;
555 sz
+= sizeof(au_sentry_debug_t
);
559 AUDIT_SENTRY_RUNLOCK();
561 /* Reconcile with the process table. */
562 proc_iterate(PROC_ALLPROCLIST
| PROC_ZOMBPROCLIST
,
563 audit_session_debug_callout
, NULL
,
564 audit_session_debug_filterfn
, (void *)&sed_tab
[0]);
568 err
= SYSCTL_OUT(req
, sed_tab
, sz
);
569 kfree(sed_tab
, entry_cnt
* sizeof(au_sentry_debug_t
));
574 #endif /* AUDIT_SESSION_DEBUG */
577 * Create and commit a session audit event. The proc and se arguments needs to
578 * be that of the subject and not necessarily the current process.
581 audit_session_event(int event
, auditinfo_addr_t
*aia_p
)
583 struct kaudit_record
*ar
;
585 KASSERT(AUE_SESSION_START
== event
|| AUE_SESSION_UPDATE
== event
||
586 AUE_SESSION_END
== event
|| AUE_SESSION_CLOSE
== event
,
587 ("audit_session_event: invalid event: %d", event
));
594 * Create a new audit record. The record will contain the subject
595 * ruid, rgid, egid, pid, auid, asid, amask, and term_addr
596 * (implicitly added by audit_new).
598 ar
= audit_new(event
, PROC_NULL
, /* Not used */ NULL
);
604 * Audit session events are always generated because they are used
605 * by some userland consumers so just set the preselect flag.
607 ar
->k_ar_commit
|= AR_PRESELECT_FILTER
;
610 * Populate the subject information. Note that the ruid, rgid,
611 * egid, and pid values are incorrect. We only need the auditinfo_addr
614 ar
->k_ar
.ar_subj_ruid
= 0;
615 ar
->k_ar
.ar_subj_rgid
= 0;
616 ar
->k_ar
.ar_subj_egid
= 0;
617 ar
->k_ar
.ar_subj_pid
= 0;
618 ar
->k_ar
.ar_subj_auid
= aia_p
->ai_auid
;
619 ar
->k_ar
.ar_subj_asid
= aia_p
->ai_asid
;
620 bcopy(&aia_p
->ai_termid
, &ar
->k_ar
.ar_subj_term_addr
,
621 sizeof(struct au_tid_addr
));
623 /* Add the audit masks to the record. */
624 ar
->k_ar
.ar_arg_amask
.am_success
= aia_p
->ai_mask
.am_success
;
625 ar
->k_ar
.ar_arg_amask
.am_failure
= aia_p
->ai_mask
.am_failure
;
626 ARG_SET_VALID(ar
, ARG_AMASK
);
628 /* Add the audit session flags to the record. */
629 ar
->k_ar
.ar_arg_value64
= aia_p
->ai_flags
;
630 ARG_SET_VALID(ar
, ARG_VALUE64
);
633 /* Commit the record to the queue. */
634 audit_commit(ar
, 0, 0);
638 * Hash the audit session ID using a simple 32-bit mix.
640 static inline uint32_t
641 audit_session_hash(au_asid_t asid
)
643 uint32_t a
= (uint32_t) asid
;
645 a
= (a
- (a
<< 6)) ^ (a
>> 17);
646 a
= (a
- (a
<< 9)) ^ (a
<< 4);
647 a
= (a
- (a
<< 3)) ^ (a
<< 10);
654 * Do an hash lookup and find the session entry for a given ASID. Return NULL
655 * if not found. If the session is found then audit_session_find takes a
659 audit_session_find(au_asid_t asid
)
662 au_sentry_t
*found_se
;
664 AUDIT_SENTRY_RWLOCK_ASSERT();
666 hkey
= HASH_ASID(asid
);
668 LIST_FOREACH(found_se
, &au_sentry_bucket
[hkey
], se_link
)
669 if (found_se
->se_asid
== asid
) {
670 au_history_record(found_se
, AU_HISTORY_EVENT_FIND
);
671 audit_ref_session(found_se
);
678 * Remove the given audit_session entry from the hash table.
681 audit_session_remove(au_sentry_t
*se
)
684 au_sentry_t
*found_se
, *tmp_se
;
686 au_history_record(se
, AU_HISTORY_EVENT_DEATH
);
687 KASSERT(se
->se_refcnt
== 0, ("audit_session_remove: ref count != 0"));
688 KASSERT(se
!= &audit_default_se
,
689 ("audit_session_remove: removing default session"));
691 hkey
= HASH_ASID(se
->se_asid
);
693 AUDIT_SENTRY_WLOCK();
695 * Check and see if someone got a reference before we got the lock.
697 if (se
->se_refcnt
!= 0) {
698 AUDIT_SENTRY_WUNLOCK();
702 audit_session_portdestroy(&se
->se_port
);
703 LIST_FOREACH_SAFE(found_se
, &au_sentry_bucket
[hkey
], se_link
, tmp_se
) {
704 if (found_se
== se
) {
706 * Generate an audit event to notify userland of the
709 audit_session_event(AUE_SESSION_CLOSE
,
710 &found_se
->se_auinfo
);
712 LIST_REMOVE(found_se
, se_link
);
713 AUDIT_SENTRY_WUNLOCK();
714 free(found_se
, M_AU_SESSION
);
719 AUDIT_SENTRY_WUNLOCK();
723 * Reference the session by incrementing the sentry ref count.
726 audit_ref_session(au_sentry_t
*se
)
730 if (se
== NULL
|| se
== &audit_default_se
) {
734 au_history_record(se
, AU_HISTORY_EVENT_REF
);
736 old_val
= OSAddAtomicLong(1, &se
->se_refcnt
);
737 KASSERT(old_val
< 100000,
738 ("audit_ref_session: Too many references on session."));
742 * Decrement the sentry ref count and remove the session entry if last one.
745 audit_unref_session(au_sentry_t
*se
)
749 if (se
== NULL
|| se
== &audit_default_se
) {
753 au_history_record(se
, AU_HISTORY_EVENT_UNREF
);
755 old_val
= OSAddAtomicLong(-1, &se
->se_refcnt
);
757 audit_session_remove(se
);
760 ("audit_unref_session: Too few references on session."));
764 * Increment the process count in the session.
767 audit_inc_procount(au_sentry_t
*se
)
771 if (se
== NULL
|| se
== &audit_default_se
) {
775 old_val
= OSAddAtomicLong(1, &se
->se_procnt
);
776 KASSERT(old_val
<= PID_MAX
,
777 ("audit_inc_procount: proc count > PID_MAX"));
781 * Decrement the process count and add a knote if it is the last process
782 * to exit the session.
785 audit_dec_procount(au_sentry_t
*se
)
789 if (se
== NULL
|| se
== &audit_default_se
) {
793 old_val
= OSAddAtomicLong(-1, &se
->se_procnt
);
795 * If this was the last process generate an audit event to notify
796 * userland of the session ending.
799 audit_session_event(AUE_SESSION_END
, &se
->se_auinfo
);
801 KASSERT(old_val
>= 1,
802 ("audit_dec_procount: proc count < 0"));
806 * Update the session entry and check to see if anything was updated.
808 * 0 Nothing was updated (We don't care about process preselection masks)
809 * 1 Something was updated.
812 audit_update_sentry(au_sentry_t
*se
, auditinfo_addr_t
*new_aia
)
814 auditinfo_addr_t
*aia
= &se
->se_auinfo
;
817 KASSERT(new_aia
!= audit_default_aia_p
,
818 ("audit_update_sentry: Trying to update the default aia."));
820 update
= (aia
->ai_auid
!= new_aia
->ai_auid
||
821 bcmp(&aia
->ai_termid
, &new_aia
->ai_termid
,
822 sizeof(new_aia
->ai_termid
)) ||
823 aia
->ai_flags
!= new_aia
->ai_flags
);
826 bcopy(new_aia
, aia
, sizeof(*aia
));
833 * Return the next session ID. The range of kernel generated audit session IDs
834 * is ASSIGNED_ASID_MIN to ASSIGNED_ASID_MAX.
837 audit_session_nextid(void)
839 static uint32_t next_asid
= ASSIGNED_ASID_MIN
;
841 AUDIT_SENTRY_RWLOCK_ASSERT();
843 if (next_asid
> ASSIGNED_ASID_MAX
) {
844 next_asid
= ASSIGNED_ASID_MIN
;
851 * Allocated a new audit_session entry and add it to the hash table. If the
852 * given ASID is set to AU_ASSIGN_ASID then audit_session_new() will pick an
853 * audit session ID. Otherwise, it attempts use the one given. It creates a
854 * reference to the entry that must be unref'ed.
856 static auditinfo_addr_t
*
857 audit_session_new(auditinfo_addr_t
*new_aia_p
, auditinfo_addr_t
*old_aia_p
)
860 au_sentry_t
*se
= NULL
;
861 au_sentry_t
*found_se
= NULL
;
862 auditinfo_addr_t
*aia
= NULL
;
864 KASSERT(new_aia_p
!= NULL
, ("audit_session_new: new_aia_p == NULL"));
866 new_asid
= new_aia_p
->ai_asid
;
869 * Alloc a new session entry now so we don't wait holding the lock.
871 se
= malloc(sizeof(au_sentry_t
), M_AU_SESSION
, M_WAITOK
| M_ZERO
);
874 * Find an unique session ID, if desired.
876 AUDIT_SENTRY_WLOCK();
877 if (new_asid
== AU_ASSIGN_ASID
) {
879 new_asid
= (au_asid_t
)audit_session_nextid();
880 found_se
= audit_session_find(new_asid
);
883 * If the session ID is currently active then drop the
884 * reference and try again.
886 if (found_se
!= NULL
) {
887 audit_unref_session(found_se
);
894 * Check to see if the requested ASID is already in the
895 * hash table. If so, update it with the new auditinfo.
897 if ((found_se
= audit_session_find(new_asid
)) != NULL
) {
900 updated
= audit_update_sentry(found_se
, new_aia_p
);
902 AUDIT_SENTRY_WUNLOCK();
903 free(se
, M_AU_SESSION
);
905 /* If a different session then add this process in. */
906 if (new_aia_p
!= old_aia_p
) {
907 audit_inc_procount(found_se
);
911 * If the session information was updated then
912 * generate an audit event to notify userland.
915 audit_session_event(AUE_SESSION_UPDATE
,
916 &found_se
->se_auinfo
);
919 return &found_se
->se_auinfo
;
924 * Start the reference and proc count at 1 to account for the process
925 * that invoked this via setaudit_addr() (or friends).
927 se
->se_refcnt
= se
->se_procnt
= 1;
930 * Populate the new session entry. Note that process masks are stored
931 * in kauth ucred so just zero them here.
933 se
->se_port
= IPC_PORT_NULL
;
934 aia
= &se
->se_auinfo
;
935 aia
->ai_asid
= new_asid
;
936 aia
->ai_auid
= new_aia_p
->ai_auid
;
937 bzero(&new_aia_p
->ai_mask
, sizeof(new_aia_p
->ai_mask
));
938 bcopy(&new_aia_p
->ai_termid
, &aia
->ai_termid
, sizeof(aia
->ai_termid
));
939 aia
->ai_flags
= new_aia_p
->ai_flags
;
942 * Add it to the hash table.
944 LIST_INSERT_HEAD(&au_sentry_bucket
[HASH_ASID(new_asid
)], se
, se_link
);
945 AUDIT_SENTRY_WUNLOCK();
948 * Generate an audit event to notify userland of the new session.
950 audit_session_event(AUE_SESSION_START
, aia
);
951 au_history_record(se
, AU_HISTORY_EVENT_BIRTH
);
956 * Lookup an existing session. A copy of the audit session info for a given
957 * ASID is returned in ret_aia. Returns 0 on success.
960 audit_session_lookup(au_asid_t asid
, auditinfo_addr_t
*ret_aia
)
962 au_sentry_t
*se
= NULL
;
964 if ((uint32_t)asid
> ASSIGNED_ASID_MAX
) {
967 AUDIT_SENTRY_RLOCK();
968 if ((se
= audit_session_find(asid
)) == NULL
) {
969 AUDIT_SENTRY_RUNLOCK();
972 /* We have a reference on the session so it is safe to drop the lock. */
973 AUDIT_SENTRY_RUNLOCK();
974 if (ret_aia
!= NULL
) {
975 bcopy(&se
->se_auinfo
, ret_aia
, sizeof(*ret_aia
));
977 audit_unref_session(se
);
983 audit_session_aiaref(auditinfo_addr_t
*aia_p
)
985 audit_ref_session(AU_SENTRY_PTR(aia_p
));
989 * Add a reference to the session entry.
992 audit_session_ref(kauth_cred_t cred
)
994 auditinfo_addr_t
*aia_p
;
996 KASSERT(IS_VALID_CRED(cred
),
997 ("audit_session_ref: Invalid kauth_cred."));
999 aia_p
= cred
->cr_audit
.as_aia_p
;
1000 audit_session_aiaref(aia_p
);
1004 audit_session_aiaunref(auditinfo_addr_t
*aia_p
)
1006 audit_unref_session(AU_SENTRY_PTR(aia_p
));
1010 * Remove a reference to the session entry.
1013 audit_session_unref(kauth_cred_t cred
)
1015 auditinfo_addr_t
*aia_p
;
1017 KASSERT(IS_VALID_CRED(cred
),
1018 ("audit_session_unref: Invalid kauth_cred."));
1020 aia_p
= cred
->cr_audit
.as_aia_p
;
1021 audit_session_aiaunref(aia_p
);
1025 * Increment the per audit session process count. Assumes that the caller has
1026 * a reference on the process' cred.
1029 audit_session_procnew(proc_t p
)
1031 kauth_cred_t cred
= p
->p_ucred
;
1032 auditinfo_addr_t
*aia_p
;
1034 KASSERT(IS_VALID_CRED(cred
),
1035 ("audit_session_procnew: Invalid kauth_cred."));
1037 aia_p
= cred
->cr_audit
.as_aia_p
;
1039 audit_inc_procount(AU_SENTRY_PTR(aia_p
));
1043 * Decrement the per audit session process count. Assumes that the caller has
1044 * a reference on the cred.
1047 audit_session_procexit(proc_t p
)
1049 kauth_cred_t cred
= p
->p_ucred
;
1050 auditinfo_addr_t
*aia_p
;
1052 KASSERT(IS_VALID_CRED(cred
),
1053 ("audit_session_procexit: Invalid kauth_cred."));
1055 aia_p
= cred
->cr_audit
.as_aia_p
;
1057 audit_dec_procount(AU_SENTRY_PTR(aia_p
));
1061 * Init the audit session code.
1064 audit_session_init(void)
1068 KASSERT((ASSIGNED_ASID_MAX
- ASSIGNED_ASID_MIN
) > PID_MAX
,
1069 ("audit_session_init: ASSIGNED_ASID_MAX is not large enough."));
1071 AUDIT_SENTRY_RWLOCK_INIT();
1073 au_sentry_bucket
= malloc( sizeof(struct au_sentry
) *
1074 HASH_TABLE_SIZE
, M_AU_SESSION
, M_WAITOK
| M_ZERO
);
1076 for (i
= 0; i
< HASH_TABLE_SIZE
; i
++) {
1077 LIST_INIT(&au_sentry_bucket
[i
]);
1080 (void)audit_sdev_init();
1081 #if AU_HISTORY_LOGGING
1082 au_history
= malloc(sizeof(struct au_history
) * au_history_size
,
1083 M_AU_SESSION
, M_WAITOK
| M_ZERO
);
1088 audit_session_update_check(kauth_cred_t cred
, auditinfo_addr_t
*old
,
1089 auditinfo_addr_t
*new)
1093 /* If the current audit ID is not the default then it is immutable. */
1094 if (old
->ai_auid
!= AU_DEFAUDITID
&& old
->ai_auid
!= new->ai_auid
) {
1098 /* If the current termid is not the default then it is immutable. */
1099 if ((old
->ai_termid
.at_type
!= AU_IPv4
||
1100 old
->ai_termid
.at_port
!= 0 ||
1101 old
->ai_termid
.at_addr
[0] != 0) &&
1102 (old
->ai_termid
.at_port
!= new->ai_termid
.at_port
||
1103 old
->ai_termid
.at_type
!= new->ai_termid
.at_type
||
1104 0 != bcmp(&old
->ai_termid
.at_addr
, &new->ai_termid
.at_addr
,
1105 sizeof(old
->ai_termid
.at_addr
)))) {
1109 /* The flags may be set only according to the
1110 * audit_session_*_set_sflags_masks.
1112 n
= ~old
->ai_flags
& new->ai_flags
;
1114 !((n
== (audit_session_superuser_set_sflags_mask
& n
) &&
1115 kauth_cred_issuser(cred
)) ||
1116 (n
== (audit_session_member_set_sflags_mask
& n
) &&
1117 old
->ai_asid
== new->ai_asid
))) {
1121 /* The flags may be cleared only according to the
1122 * audit_session_*_clear_sflags_masks.
1124 n
= ~new->ai_flags
& old
->ai_flags
;
1126 !((n
== (audit_session_superuser_clear_sflags_mask
& n
) &&
1127 kauth_cred_issuser(cred
)) ||
1128 (n
== (audit_session_member_clear_sflags_mask
& n
) &&
1129 old
->ai_asid
== new->ai_asid
))) {
1133 /* The audit masks are mutable. */
1138 * Safely update kauth cred of the given process with new the given audit info.
1141 audit_session_setaia(proc_t p
, auditinfo_addr_t
*new_aia_p
)
1143 kauth_cred_t my_cred
, my_new_cred
;
1144 struct au_session as
;
1145 struct au_session tmp_as
;
1146 auditinfo_addr_t caia
, *old_aia_p
;
1150 * If this is going to modify an existing session then do some
1153 if (audit_session_lookup(new_aia_p
->ai_asid
, &caia
) == 0) {
1154 my_cred
= kauth_cred_proc_ref(p
);
1155 ret
= audit_session_update_check(my_cred
, &caia
, new_aia_p
);
1156 kauth_cred_unref(&my_cred
);
1162 my_cred
= kauth_cred_proc_ref(p
);
1163 bcopy(&new_aia_p
->ai_mask
, &as
.as_mask
, sizeof(as
.as_mask
));
1164 old_aia_p
= my_cred
->cr_audit
.as_aia_p
;
1165 /* audit_session_new() adds a reference on the session */
1166 as
.as_aia_p
= audit_session_new(new_aia_p
, old_aia_p
);
1168 /* If the process left a session then update the process count. */
1169 if (old_aia_p
!= new_aia_p
) {
1170 audit_dec_procount(AU_SENTRY_PTR(old_aia_p
));
1175 * We are modifying the audit info in a credential so we need a new
1176 * credential (or take another reference on an existing credential that
1177 * matches our new one). We must do this because the audit info in the
1178 * credential is used as part of our hash key. Get current credential
1179 * in the target process and take a reference while we muck with it.
1183 * Set the credential with new info. If there is no change,
1184 * we get back the same credential we passed in; if there is
1185 * a change, we drop the reference on the credential we
1186 * passed in. The subsequent compare is safe, because it is
1187 * a pointer compare rather than a contents compare.
1189 bcopy(&as
, &tmp_as
, sizeof(tmp_as
));
1190 my_new_cred
= kauth_cred_setauditinfo(my_cred
, &tmp_as
);
1192 if (my_cred
!= my_new_cred
) {
1194 /* Need to protect for a race where another thread also
1195 * changed the credential after we took our reference.
1196 * If p_ucred has changed then we should restart this
1197 * again with the new cred.
1199 if (p
->p_ucred
!= my_cred
) {
1200 proc_ucred_unlock(p
);
1201 audit_session_unref(my_new_cred
);
1202 kauth_cred_unref(&my_new_cred
);
1204 my_cred
= kauth_cred_proc_ref(p
);
1207 p
->p_ucred
= my_new_cred
;
1208 /* update cred on proc */
1209 PROC_UPDATE_CREDS_ONPROC(p
);
1210 proc_ucred_unlock(p
);
1213 * Drop old proc reference or our extra reference.
1215 kauth_cred_unref(&my_cred
);
1219 /* Drop the reference taken by audit_session_new() above. */
1220 audit_unref_session(AU_SENTRY_PTR(as
.as_aia_p
));
1222 /* Propagate the change from the process to the Mach task. */
1223 set_security_token(p
);
1229 * audit_session_self (system call)
1231 * Description: Obtain a Mach send right for the current session.
1233 * Parameters: p Process calling audit_session_self().
1235 * Returns: *ret_port Named Mach send right, which may be
1236 * MACH_PORT_NULL in the failure case.
1239 * EINVAL The calling process' session has not be set.
1240 * ESRCH Bad process, can't get valid cred for process.
1241 * ENOMEM Port allocation failed due to no free memory.
1244 audit_session_self(proc_t p
, __unused
struct audit_session_self_args
*uap
,
1245 mach_port_name_t
*ret_port
)
1247 ipc_port_t sendport
= IPC_PORT_NULL
;
1248 kauth_cred_t cred
= NULL
;
1249 auditinfo_addr_t
*aia_p
;
1253 cred
= kauth_cred_proc_ref(p
);
1254 if (!IS_VALID_CRED(cred
)) {
1259 aia_p
= cred
->cr_audit
.as_aia_p
;
1260 if (!IS_VALID_SESSION(aia_p
)) {
1261 /* Can't join the default session. */
1266 se
= AU_SENTRY_PTR(aia_p
);
1269 * Processes that join using this mach port will inherit this process'
1270 * pre-selection masks.
1272 if (se
->se_port
== IPC_PORT_NULL
) {
1273 bcopy(&cred
->cr_audit
.as_mask
, &se
->se_mask
,
1274 sizeof(se
->se_mask
));
1278 * Get a send right to the session's Mach port and insert it in the
1279 * process' mach port namespace.
1281 sendport
= audit_session_mksend(aia_p
, &se
->se_port
);
1282 *ret_port
= ipc_port_copyout_send(sendport
, get_task_ipcspace(p
->task
));
1286 kauth_cred_unref(&cred
);
1289 *ret_port
= MACH_PORT_NULL
;
1295 * audit_session_port (system call)
1297 * Description: Obtain a Mach send right for the given session ID.
1299 * Parameters: p Process calling audit_session_port().
1300 * uap->asid The target audit session ID. The special
1301 * value -1 can be used to target the process's
1303 * uap->portnamep User address at which to place port name.
1305 * Returns: 0 Success
1306 * EINVAL The calling process' session has not be set.
1307 * EINVAL The given session ID could not be found.
1308 * EINVAL The Mach port right could not be copied out.
1309 * ESRCH Bad process, can't get valid cred for process.
1310 * EPERM Only the superuser can reference sessions other
1311 * than the process's own.
1312 * ENOMEM Port allocation failed due to no free memory.
1315 audit_session_port(proc_t p
, struct audit_session_port_args
*uap
,
1316 __unused
int *retval
)
1318 ipc_port_t sendport
= IPC_PORT_NULL
;
1319 mach_port_name_t portname
= MACH_PORT_NULL
;
1320 kauth_cred_t cred
= NULL
;
1321 auditinfo_addr_t
*aia_p
= NULL
;
1322 au_sentry_t
*se
= NULL
;
1325 /* Note: Currently this test will never be true, because
1326 * ASSIGNED_ASID_MAX is effectively (uint32_t)-2.
1328 if (uap
->asid
!= -1 && (uint32_t)uap
->asid
> ASSIGNED_ASID_MAX
) {
1332 cred
= kauth_cred_proc_ref(p
);
1333 if (!IS_VALID_CRED(cred
)) {
1337 aia_p
= cred
->cr_audit
.as_aia_p
;
1339 /* Find the session corresponding to the requested audit
1340 * session ID. If found, take a reference on it so that
1341 * the session is not dropped until the join is later done.
1343 if (uap
->asid
== (au_asid_t
)-1 ||
1344 uap
->asid
== aia_p
->ai_asid
) {
1345 if (!IS_VALID_SESSION(aia_p
)) {
1346 /* Can't join the default session. */
1351 /* No privilege is required to obtain a port for our
1354 se
= AU_SENTRY_PTR(aia_p
);
1355 audit_ref_session(se
);
1358 * Only privileged processes may obtain a port for
1359 * any existing session.
1361 err
= priv_check_cred(cred
, PRIV_AUDIT_SESSION_PORT
, 0);
1365 AUDIT_SENTRY_RLOCK();
1366 se
= audit_session_find(uap
->asid
);
1367 AUDIT_SENTRY_RUNLOCK();
1372 aia_p
= &se
->se_auinfo
;
1376 * Processes that join using this mach port will inherit this process'
1377 * pre-selection masks.
1379 if (se
->se_port
== IPC_PORT_NULL
) {
1380 bcopy(&cred
->cr_audit
.as_mask
, &se
->se_mask
,
1381 sizeof(se
->se_mask
));
1385 * Use the session reference to create a mach port reference for the
1386 * session (at which point we are free to drop the session reference)
1387 * and then copy out the mach port to the process' mach port namespace.
1389 sendport
= audit_session_mksend(aia_p
, &se
->se_port
);
1390 portname
= ipc_port_copyout_send(sendport
, get_task_ipcspace(p
->task
));
1391 if (!MACH_PORT_VALID(portname
)) {
1395 err
= copyout(&portname
, uap
->portnamep
, sizeof(mach_port_name_t
));
1398 kauth_cred_unref(&cred
);
1401 audit_unref_session(se
);
1403 if (MACH_PORT_VALID(portname
) && 0 != err
) {
1404 (void)mach_port_deallocate(get_task_ipcspace(p
->task
),
1412 audit_session_join_internal(proc_t p
, task_t task
, ipc_port_t port
, au_asid_t
*new_asid
)
1414 auditinfo_addr_t
*new_aia_p
, *old_aia_p
;
1415 kauth_cred_t my_cred
= NULL
;
1419 *new_asid
= AU_DEFAUDITSID
;
1421 if ((new_aia_p
= audit_session_porttoaia(port
)) == NULL
) {
1427 kauth_cred_ref(p
->p_ucred
);
1428 my_cred
= p
->p_ucred
;
1429 if (!IS_VALID_CRED(my_cred
)) {
1430 kauth_cred_unref(&my_cred
);
1431 proc_ucred_unlock(p
);
1435 old_aia_p
= my_cred
->cr_audit
.as_aia_p
;
1436 old_asid
= old_aia_p
->ai_asid
;
1437 *new_asid
= new_aia_p
->ai_asid
;
1440 * Add process in if not already in the session.
1442 if (*new_asid
!= old_asid
) {
1443 kauth_cred_t my_new_cred
;
1444 struct au_session new_as
;
1446 bcopy(&new_aia_p
->ai_mask
, &new_as
.as_mask
,
1447 sizeof(new_as
.as_mask
));
1448 new_as
.as_aia_p
= new_aia_p
;
1450 my_new_cred
= kauth_cred_setauditinfo(my_cred
, &new_as
);
1451 p
->p_ucred
= my_new_cred
;
1452 PROC_UPDATE_CREDS_ONPROC(p
);
1454 /* Increment the proc count of new session */
1455 audit_inc_procount(AU_SENTRY_PTR(new_aia_p
));
1457 proc_ucred_unlock(p
);
1459 /* Propagate the change from the process to the Mach task. */
1460 set_security_token_task_internal(p
, task
);
1462 /* Decrement the process count of the former session. */
1463 audit_dec_procount(AU_SENTRY_PTR(old_aia_p
));
1465 proc_ucred_unlock(p
);
1467 kauth_cred_unref(&my_cred
);
1470 if (port
!= IPC_PORT_NULL
) {
1471 ipc_port_release_send(port
);
1478 * audit_session_spawnjoin
1480 * Description: posix_spawn() interface to audit_session_join_internal().
1482 * Returns: 0 Success
1483 * EINVAL Invalid Mach port name.
1484 * ESRCH Invalid calling process/cred.
1487 audit_session_spawnjoin(proc_t p
, task_t task
, ipc_port_t port
)
1491 return audit_session_join_internal(p
, task
, port
, &new_asid
);
1495 * audit_session_join (system call)
1497 * Description: Join the session for a given Mach port send right.
1499 * Parameters: p Process calling session join.
1500 * uap->port A Mach send right.
1502 * Returns: *ret_asid Audit session ID of new session.
1503 * In the failure case the return value will be -1
1504 * and 'errno' will be set to a non-zero value
1508 * EINVAL Invalid Mach port name.
1509 * ESRCH Invalid calling process/cred.
1512 audit_session_join(proc_t p
, struct audit_session_join_args
*uap
,
1513 au_asid_t
*ret_asid
)
1515 ipc_port_t port
= IPC_PORT_NULL
;
1516 mach_port_name_t send
= uap
->port
;
1520 if (ipc_object_copyin(get_task_ipcspace(p
->task
), send
,
1521 MACH_MSG_TYPE_COPY_SEND
, &port
, 0, NULL
, IPC_KMSG_FLAGS_ALLOW_IMMOVABLE_SEND
) != KERN_SUCCESS
) {
1522 *ret_asid
= AU_DEFAUDITSID
;
1525 err
= audit_session_join_internal(p
, p
->task
, port
, ret_asid
);
1532 * Audit session device.
1536 * Free an audit sdev entry.
1539 audit_sdev_entry_free(struct audit_sdev_entry
*ase
)
1541 free(ase
->ase_record
, M_AUDIT_SDEV_ENTRY
);
1542 free(ase
, M_AUDIT_SDEV_ENTRY
);
1546 * Append individual record to a queue. Allocate queue-local buffer and
1547 * add to the queue. If the queue is full or we can't allocate memory,
1548 * drop the newest record.
1551 audit_sdev_append(struct audit_sdev
*asdev
, void *record
, u_int record_len
)
1553 struct audit_sdev_entry
*ase
;
1555 AUDIT_SDEV_LOCK_ASSERT(asdev
);
1557 if (asdev
->asdev_qlen
>= asdev
->asdev_qlimit
) {
1558 asdev
->asdev_drops
++;
1563 ase
= malloc(sizeof(*ase
), M_AUDIT_SDEV_ENTRY
, M_NOWAIT
| M_ZERO
);
1565 asdev
->asdev_drops
++;
1570 ase
->ase_record
= malloc(record_len
, M_AUDIT_SDEV_ENTRY
, M_NOWAIT
);
1571 if (NULL
== ase
->ase_record
) {
1572 free(ase
, M_AUDIT_SDEV_ENTRY
);
1573 asdev
->asdev_drops
++;
1578 bcopy(record
, ase
->ase_record
, record_len
);
1579 ase
->ase_record_len
= record_len
;
1581 TAILQ_INSERT_TAIL(&asdev
->asdev_queue
, ase
, ase_queue
);
1582 asdev
->asdev_inserts
++;
1583 asdev
->asdev_qlen
++;
1584 asdev
->asdev_qbyteslen
+= ase
->ase_record_len
;
1585 selwakeup(&asdev
->asdev_selinfo
);
1586 if (asdev
->asdev_flags
& AUDIT_SDEV_ASYNC
) {
1587 pgsigio(asdev
->asdev_sigio
, SIGIO
);
1590 cv_broadcast(&asdev
->asdev_cv
);
1594 * Submit an audit record to be queued in the audit session device.
1597 audit_sdev_submit(__unused au_id_t auid
, __unused au_asid_t asid
, void *record
,
1600 struct audit_sdev
*asdev
;
1603 * Lockless read to avoid lock overhead if sessio devices are not in
1606 if (NULL
== TAILQ_FIRST(&audit_sdev_list
)) {
1610 AUDIT_SDEV_LIST_RLOCK();
1611 TAILQ_FOREACH(asdev
, &audit_sdev_list
, asdev_list
) {
1612 AUDIT_SDEV_LOCK(asdev
);
1615 * Only append to the sdev queue if the AUID and ASID match that
1616 * of the process that opened this session device or if the
1617 * ALLSESSIONS flag is set.
1619 if ((/* XXXss auid == asdev->asdev_auid && */
1620 asid
== asdev
->asdev_asid
) ||
1621 (asdev
->asdev_flags
& AUDIT_SDEV_ALLSESSIONS
) != 0) {
1622 audit_sdev_append(asdev
, record
, record_len
);
1624 AUDIT_SDEV_UNLOCK(asdev
);
1626 AUDIT_SDEV_LIST_RUNLOCK();
1628 /* Unlocked increment. */
1629 audit_sdev_records
++;
1633 * Allocate a new audit sdev. Connects the sdev, on succes, to the global
1634 * list and updates statistics.
1636 static struct audit_sdev
*
1637 audit_sdev_alloc(void)
1639 struct audit_sdev
*asdev
;
1641 AUDIT_SDEV_LIST_WLOCK_ASSERT();
1643 asdev
= malloc(sizeof(*asdev
), M_AUDIT_SDEV
, M_WAITOK
| M_ZERO
);
1644 if (NULL
== asdev
) {
1648 asdev
->asdev_qlimit
= AUDIT_SDEV_QLIMIT_DEFAULT
;
1649 TAILQ_INIT(&asdev
->asdev_queue
);
1650 AUDIT_SDEV_LOCK_INIT(asdev
);
1651 AUDIT_SDEV_SX_LOCK_INIT(asdev
);
1652 cv_init(&asdev
->asdev_cv
, "audit_sdev_cv");
1655 * Add to global list and update global statistics.
1657 TAILQ_INSERT_HEAD(&audit_sdev_list
, asdev
, asdev_list
);
1665 * Flush all records currently present in an audit sdev.
1668 audit_sdev_flush(struct audit_sdev
*asdev
)
1670 struct audit_sdev_entry
*ase
;
1672 AUDIT_SDEV_LOCK_ASSERT(asdev
);
1674 while ((ase
= TAILQ_FIRST(&asdev
->asdev_queue
)) != NULL
) {
1675 TAILQ_REMOVE(&asdev
->asdev_queue
, ase
, ase_queue
);
1676 asdev
->asdev_qbyteslen
-= ase
->ase_record_len
;
1677 audit_sdev_entry_free(ase
);
1678 asdev
->asdev_qlen
--;
1680 asdev
->asdev_qoffset
= 0;
1682 KASSERT(0 == asdev
->asdev_qlen
, ("audit_sdev_flush: asdev_qlen"));
1683 KASSERT(0 == asdev
->asdev_qbyteslen
,
1684 ("audit_sdev_flush: asdev_qbyteslen"));
1688 * Free an audit sdev.
1691 audit_sdev_free(struct audit_sdev
*asdev
)
1693 AUDIT_SDEV_LIST_WLOCK_ASSERT();
1694 AUDIT_SDEV_LOCK_ASSERT(asdev
);
1696 /* XXXss - preselect hook here */
1697 audit_sdev_flush(asdev
);
1698 cv_destroy(&asdev
->asdev_cv
);
1699 AUDIT_SDEV_SX_LOCK_DESTROY(asdev
);
1700 AUDIT_SDEV_UNLOCK(asdev
);
1701 AUDIT_SDEV_LOCK_DESTROY(asdev
);
1703 TAILQ_REMOVE(&audit_sdev_list
, asdev
, asdev_list
);
1704 free(asdev
, M_AUDIT_SDEV
);
1709 * Get the auditinfo_addr of the proc and check to see if suser. Will return
1710 * non-zero if not suser.
1713 audit_sdev_get_aia(proc_t p
, struct auditinfo_addr
*aia_p
)
1718 scred
= kauth_cred_proc_ref(p
);
1719 error
= suser(scred
, &p
->p_acflag
);
1721 if (NULL
!= aia_p
) {
1722 bcopy(scred
->cr_audit
.as_aia_p
, aia_p
, sizeof(*aia_p
));
1724 kauth_cred_unref(&scred
);
1730 * Audit session dev open method.
1733 audit_sdev_open(dev_t dev
, __unused
int flags
, __unused
int devtype
, proc_t p
)
1735 struct audit_sdev
*asdev
;
1736 struct auditinfo_addr aia
;
1740 if (u
< 0 || u
>= MAX_AUDIT_SDEVS
) {
1744 (void) audit_sdev_get_aia(p
, &aia
);
1746 AUDIT_SDEV_LIST_WLOCK();
1747 asdev
= audit_sdev_dtab
[u
];
1748 if (NULL
== asdev
) {
1749 asdev
= audit_sdev_alloc();
1750 if (NULL
== asdev
) {
1751 AUDIT_SDEV_LIST_WUNLOCK();
1754 audit_sdev_dtab
[u
] = asdev
;
1756 KASSERT(asdev
->asdev_open
, ("audit_sdev_open: Already open"));
1757 AUDIT_SDEV_LIST_WUNLOCK();
1760 asdev
->asdev_open
= 1;
1761 asdev
->asdev_auid
= aia
.ai_auid
;
1762 asdev
->asdev_asid
= aia
.ai_asid
;
1763 asdev
->asdev_flags
= 0;
1765 AUDIT_SDEV_LIST_WUNLOCK();
1771 * Audit session dev close method.
1774 audit_sdev_close(dev_t dev
, __unused
int flags
, __unused
int devtype
,
1777 struct audit_sdev
*asdev
;
1781 asdev
= audit_sdev_dtab
[u
];
1783 KASSERT(asdev
!= NULL
, ("audit_sdev_close: asdev == NULL"));
1784 KASSERT(asdev
->asdev_open
, ("audit_sdev_close: !asdev_open"));
1786 AUDIT_SDEV_LIST_WLOCK();
1787 AUDIT_SDEV_LOCK(asdev
);
1788 asdev
->asdev_open
= 0;
1789 audit_sdev_free(asdev
); /* sdev lock unlocked in audit_sdev_free() */
1790 audit_sdev_dtab
[u
] = NULL
;
1791 AUDIT_SDEV_LIST_WUNLOCK();
1797 * Audit session dev ioctl method.
1800 audit_sdev_ioctl(dev_t dev
, u_long cmd
, caddr_t data
,
1801 __unused
int flag
, proc_t p
)
1803 struct audit_sdev
*asdev
;
1806 asdev
= audit_sdev_dtab
[minor(dev
)];
1807 KASSERT(asdev
!= NULL
, ("audit_sdev_ioctl: asdev == NULL"));
1813 AUDIT_SDEV_LOCK(asdev
);
1815 asdev
->asdev_flags
|= AUDIT_SDEV_NBIO
;
1817 asdev
->asdev_flags
&= ~AUDIT_SDEV_NBIO
;
1819 AUDIT_SDEV_UNLOCK(asdev
);
1823 AUDIT_SDEV_LOCK(asdev
);
1824 *(int *)data
= asdev
->asdev_qbyteslen
- asdev
->asdev_qoffset
;
1825 AUDIT_SDEV_UNLOCK(asdev
);
1828 case AUDITSDEV_GET_QLEN
:
1829 *(u_int
*)data
= asdev
->asdev_qlen
;
1832 case AUDITSDEV_GET_QLIMIT
:
1833 *(u_int
*)data
= asdev
->asdev_qlimit
;
1836 case AUDITSDEV_SET_QLIMIT
:
1837 if (*(u_int
*)data
>= AUDIT_SDEV_QLIMIT_MIN
||
1838 *(u_int
*)data
<= AUDIT_SDEV_QLIMIT_MAX
) {
1839 asdev
->asdev_qlimit
= *(u_int
*)data
;
1845 case AUDITSDEV_GET_QLIMIT_MIN
:
1846 *(u_int
*)data
= AUDIT_SDEV_QLIMIT_MIN
;
1849 case AUDITSDEV_GET_QLIMIT_MAX
:
1850 *(u_int
*)data
= AUDIT_SDEV_QLIMIT_MAX
;
1853 case AUDITSDEV_FLUSH
:
1854 if (AUDIT_SDEV_SX_XLOCK_SIG(asdev
) != 0) {
1857 AUDIT_SDEV_LOCK(asdev
);
1858 audit_sdev_flush(asdev
);
1859 AUDIT_SDEV_UNLOCK(asdev
);
1860 AUDIT_SDEV_SX_XUNLOCK(asdev
);
1863 case AUDITSDEV_GET_MAXDATA
:
1864 *(u_int
*)data
= MAXAUDITDATA
;
1867 /* XXXss these should be 64 bit, maybe. */
1868 case AUDITSDEV_GET_INSERTS
:
1869 *(u_int
*)data
= asdev
->asdev_inserts
;
1872 case AUDITSDEV_GET_READS
:
1873 *(u_int
*)data
= asdev
->asdev_reads
;
1876 case AUDITSDEV_GET_DROPS
:
1877 *(u_int
*)data
= asdev
->asdev_drops
;
1880 case AUDITSDEV_GET_ALLSESSIONS
:
1881 error
= audit_sdev_get_aia(p
, NULL
);
1885 *(u_int
*)data
= (asdev
->asdev_flags
& AUDIT_SDEV_ALLSESSIONS
) ?
1889 case AUDITSDEV_SET_ALLSESSIONS
:
1890 error
= audit_sdev_get_aia(p
, NULL
);
1895 AUDIT_SDEV_LOCK(asdev
);
1897 asdev
->asdev_flags
|= AUDIT_SDEV_ALLSESSIONS
;
1899 asdev
->asdev_flags
&= ~AUDIT_SDEV_ALLSESSIONS
;
1901 AUDIT_SDEV_UNLOCK(asdev
);
1912 * Audit session dev read method.
1915 audit_sdev_read(dev_t dev
, struct uio
*uio
, __unused
int flag
)
1917 struct audit_sdev_entry
*ase
;
1918 struct audit_sdev
*asdev
;
1922 asdev
= audit_sdev_dtab
[minor(dev
)];
1923 KASSERT(NULL
!= asdev
, ("audit_sdev_read: asdev == NULL"));
1926 * We hold a sleep lock over read and flush because we rely on the
1927 * stability of a record in the queue during uiomove.
1929 if (0 != AUDIT_SDEV_SX_XLOCK_SIG(asdev
)) {
1932 AUDIT_SDEV_LOCK(asdev
);
1933 while (TAILQ_EMPTY(&asdev
->asdev_queue
)) {
1934 if (asdev
->asdev_flags
& AUDIT_SDEV_NBIO
) {
1935 AUDIT_SDEV_UNLOCK(asdev
);
1936 AUDIT_SDEV_SX_XUNLOCK(asdev
);
1939 error
= cv_wait_sig(&asdev
->asdev_cv
, AUDIT_SDEV_MTX(asdev
));
1941 AUDIT_SDEV_UNLOCK(asdev
);
1942 AUDIT_SDEV_SX_XUNLOCK(asdev
);
1948 * Copy as many remaining bytes from the current record to userspace
1949 * as we can. Keep processing records until we run out of records in
1950 * the queue or until the user buffer runs out of space.
1952 * We rely on the sleep lock to maintain ase's stability here.
1954 asdev
->asdev_reads
++;
1955 while ((ase
= TAILQ_FIRST(&asdev
->asdev_queue
)) != NULL
&&
1956 uio_resid(uio
) > 0) {
1957 AUDIT_SDEV_LOCK_ASSERT(asdev
);
1959 KASSERT(ase
->ase_record_len
> asdev
->asdev_qoffset
,
1960 ("audit_sdev_read: record_len > qoffset (1)"));
1961 toread
= MIN((int)(ase
->ase_record_len
- asdev
->asdev_qoffset
),
1963 AUDIT_SDEV_UNLOCK(asdev
);
1964 error
= uiomove((char *) ase
->ase_record
+ asdev
->asdev_qoffset
,
1967 AUDIT_SDEV_SX_XUNLOCK(asdev
);
1972 * If the copy succeeded then update book-keeping, and if no
1973 * bytes remain in the current record then free it.
1975 AUDIT_SDEV_LOCK(asdev
);
1976 KASSERT(TAILQ_FIRST(&asdev
->asdev_queue
) == ase
,
1977 ("audit_sdev_read: queue out of sync after uiomove"));
1978 asdev
->asdev_qoffset
+= toread
;
1979 KASSERT(ase
->ase_record_len
>= asdev
->asdev_qoffset
,
1980 ("audit_sdev_read: record_len >= qoffset (2)"));
1981 if (asdev
->asdev_qoffset
== ase
->ase_record_len
) {
1982 TAILQ_REMOVE(&asdev
->asdev_queue
, ase
, ase_queue
);
1983 asdev
->asdev_qbyteslen
-= ase
->ase_record_len
;
1984 audit_sdev_entry_free(ase
);
1985 asdev
->asdev_qlen
--;
1986 asdev
->asdev_qoffset
= 0;
1989 AUDIT_SDEV_UNLOCK(asdev
);
1990 AUDIT_SDEV_SX_XUNLOCK(asdev
);
1995 * Audit session device poll method.
1998 audit_sdev_poll(dev_t dev
, int events
, void *wql
, struct proc
*p
)
2000 struct audit_sdev
*asdev
;
2004 asdev
= audit_sdev_dtab
[minor(dev
)];
2005 KASSERT(NULL
!= asdev
, ("audit_sdev_poll: asdev == NULL"));
2007 if (events
& (POLLIN
| POLLRDNORM
)) {
2008 AUDIT_SDEV_LOCK(asdev
);
2009 if (NULL
!= TAILQ_FIRST(&asdev
->asdev_queue
)) {
2010 revents
|= events
& (POLLIN
| POLLRDNORM
);
2012 selrecord(p
, &asdev
->asdev_selinfo
, wql
);
2014 AUDIT_SDEV_UNLOCK(asdev
);
2020 * Audit sdev clone routine. Provides a new minor number or returns -1.
2021 * This called with DEVFS_LOCK held.
2024 audit_sdev_clone(__unused dev_t dev
, int action
)
2028 if (DEVFS_CLONE_ALLOC
== action
) {
2029 for (i
= 0; i
< MAX_AUDIT_SDEVS
; i
++) {
2030 if (NULL
== audit_sdev_dtab
[i
]) {
2036 * This really should return -1 here but that seems to
2037 * hang things in devfs. We instead return 0 and let
2038 * audit_sdev_open tell userland the bad news.
2047 audit_sdev_init(void)
2051 TAILQ_INIT(&audit_sdev_list
);
2052 AUDIT_SDEV_LIST_LOCK_INIT();
2054 audit_sdev_major
= cdevsw_add(-1, &audit_sdev_cdevsw
);
2055 if (audit_sdev_major
< 0) {
2056 return KERN_FAILURE
;
2059 dev
= makedev(audit_sdev_major
, 0);
2060 devnode
= devfs_make_node_clone(dev
, DEVFS_CHAR
, UID_ROOT
, GID_WHEEL
,
2061 0644, audit_sdev_clone
, AUDIT_SDEV_NAME
, 0);
2063 if (NULL
== devnode
) {
2064 return KERN_FAILURE
;
2067 return KERN_SUCCESS
;
2072 * audit_sdev_shutdown(void)
2075 * devfs_remove(devnode);
2076 * (void) cdevsw_remove(audit_sdev_major, &audit_sdev_cdevsw);
2078 * return (KERN_SUCCESS);
2085 audit_session_self(proc_t p
, struct audit_session_self_args
*uap
,
2086 mach_port_name_t
*ret_port
)
2088 #pragma unused(p, uap, ret_port)
2094 audit_session_join(proc_t p
, struct audit_session_join_args
*uap
,
2095 au_asid_t
*ret_asid
)
2097 #pragma unused(p, uap, ret_asid)
2103 audit_session_port(proc_t p
, struct audit_session_port_args
*uap
, int *retval
)
2105 #pragma unused(p, uap, retval)
2110 #endif /* CONFIG_AUDIT */