xref: /freebsd/sys/security/audit/audit_arg.c (revision f6d4a8a77bbb032448b9331f308b4466d4e3b1cd)
1 /*-
2  * Copyright (c) 1999-2005 Apple Inc.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
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.
16  *
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.
28  */
29 
30 #include <sys/cdefs.h>
31 __FBSDID("$FreeBSD$");
32 
33 #include <sys/param.h>
34 #include <sys/filedesc.h>
35 #include <sys/ipc.h>
36 #include <sys/mount.h>
37 #include <sys/proc.h>
38 #include <sys/socket.h>
39 #include <sys/socketvar.h>
40 #include <sys/protosw.h>
41 #include <sys/domain.h>
42 #include <sys/sbuf.h>
43 #include <sys/systm.h>
44 #include <sys/un.h>
45 #include <sys/vnode.h>
46 
47 #include <netinet/in.h>
48 #include <netinet/in_pcb.h>
49 
50 #include <security/audit/audit.h>
51 #include <security/audit/audit_private.h>
52 
53 /*
54  * Calls to manipulate elements of the audit record structure from system
55  * call code.  Macro wrappers will prevent this functions from being entered
56  * if auditing is disabled, avoiding the function call cost.  We check the
57  * thread audit record pointer anyway, as the audit condition could change,
58  * and pre-selection may not have allocated an audit record for this event.
59  *
60  * XXXAUDIT: Should we assert, in each case, that this field of the record
61  * hasn't already been filled in?
62  */
63 void
64 audit_arg_addr(void *addr)
65 {
66 	struct kaudit_record *ar;
67 
68 	ar = currecord();
69 	if (ar == NULL)
70 		return;
71 
72 	ar->k_ar.ar_arg_addr = addr;
73 	ARG_SET_VALID(ar, ARG_ADDR);
74 }
75 
76 void
77 audit_arg_exit(int status, int retval)
78 {
79 	struct kaudit_record *ar;
80 
81 	ar = currecord();
82 	if (ar == NULL)
83 		return;
84 
85 	ar->k_ar.ar_arg_exitstatus = status;
86 	ar->k_ar.ar_arg_exitretval = retval;
87 	ARG_SET_VALID(ar, ARG_EXIT);
88 }
89 
90 void
91 audit_arg_len(int len)
92 {
93 	struct kaudit_record *ar;
94 
95 	ar = currecord();
96 	if (ar == NULL)
97 		return;
98 
99 	ar->k_ar.ar_arg_len = len;
100 	ARG_SET_VALID(ar, ARG_LEN);
101 }
102 
103 void
104 audit_arg_fd(int fd)
105 {
106 	struct kaudit_record *ar;
107 
108 	ar = currecord();
109 	if (ar == NULL)
110 		return;
111 
112 	ar->k_ar.ar_arg_fd = fd;
113 	ARG_SET_VALID(ar, ARG_FD);
114 }
115 
116 void
117 audit_arg_fflags(int fflags)
118 {
119 	struct kaudit_record *ar;
120 
121 	ar = currecord();
122 	if (ar == NULL)
123 		return;
124 
125 	ar->k_ar.ar_arg_fflags = fflags;
126 	ARG_SET_VALID(ar, ARG_FFLAGS);
127 }
128 
129 void
130 audit_arg_gid(gid_t gid)
131 {
132 	struct kaudit_record *ar;
133 
134 	ar = currecord();
135 	if (ar == NULL)
136 		return;
137 
138 	ar->k_ar.ar_arg_gid = gid;
139 	ARG_SET_VALID(ar, ARG_GID);
140 }
141 
142 void
143 audit_arg_uid(uid_t uid)
144 {
145 	struct kaudit_record *ar;
146 
147 	ar = currecord();
148 	if (ar == NULL)
149 		return;
150 
151 	ar->k_ar.ar_arg_uid = uid;
152 	ARG_SET_VALID(ar, ARG_UID);
153 }
154 
155 void
156 audit_arg_egid(gid_t egid)
157 {
158 	struct kaudit_record *ar;
159 
160 	ar = currecord();
161 	if (ar == NULL)
162 		return;
163 
164 	ar->k_ar.ar_arg_egid = egid;
165 	ARG_SET_VALID(ar, ARG_EGID);
166 }
167 
168 void
169 audit_arg_euid(uid_t euid)
170 {
171 	struct kaudit_record *ar;
172 
173 	ar = currecord();
174 	if (ar == NULL)
175 		return;
176 
177 	ar->k_ar.ar_arg_euid = euid;
178 	ARG_SET_VALID(ar, ARG_EUID);
179 }
180 
181 void
182 audit_arg_rgid(gid_t rgid)
183 {
184 	struct kaudit_record *ar;
185 
186 	ar = currecord();
187 	if (ar == NULL)
188 		return;
189 
190 	ar->k_ar.ar_arg_rgid = rgid;
191 	ARG_SET_VALID(ar, ARG_RGID);
192 }
193 
194 void
195 audit_arg_ruid(uid_t ruid)
196 {
197 	struct kaudit_record *ar;
198 
199 	ar = currecord();
200 	if (ar == NULL)
201 		return;
202 
203 	ar->k_ar.ar_arg_ruid = ruid;
204 	ARG_SET_VALID(ar, ARG_RUID);
205 }
206 
207 void
208 audit_arg_sgid(gid_t sgid)
209 {
210 	struct kaudit_record *ar;
211 
212 	ar = currecord();
213 	if (ar == NULL)
214 		return;
215 
216 	ar->k_ar.ar_arg_sgid = sgid;
217 	ARG_SET_VALID(ar, ARG_SGID);
218 }
219 
220 void
221 audit_arg_suid(uid_t suid)
222 {
223 	struct kaudit_record *ar;
224 
225 	ar = currecord();
226 	if (ar == NULL)
227 		return;
228 
229 	ar->k_ar.ar_arg_suid = suid;
230 	ARG_SET_VALID(ar, ARG_SUID);
231 }
232 
233 void
234 audit_arg_groupset(gid_t *gidset, u_int gidset_size)
235 {
236 	u_int i;
237 	struct kaudit_record *ar;
238 
239 	ar = currecord();
240 	if (ar == NULL)
241 		return;
242 
243 	for (i = 0; i < gidset_size; i++)
244 		ar->k_ar.ar_arg_groups.gidset[i] = gidset[i];
245 	ar->k_ar.ar_arg_groups.gidset_size = gidset_size;
246 	ARG_SET_VALID(ar, ARG_GROUPSET);
247 }
248 
249 void
250 audit_arg_login(char *login)
251 {
252 	struct kaudit_record *ar;
253 
254 	ar = currecord();
255 	if (ar == NULL)
256 		return;
257 
258 	strlcpy(ar->k_ar.ar_arg_login, login, MAXLOGNAME);
259 	ARG_SET_VALID(ar, ARG_LOGIN);
260 }
261 
262 void
263 audit_arg_ctlname(int *name, int namelen)
264 {
265 	struct kaudit_record *ar;
266 
267 	ar = currecord();
268 	if (ar == NULL)
269 		return;
270 
271 	bcopy(name, &ar->k_ar.ar_arg_ctlname, namelen * sizeof(int));
272 	ar->k_ar.ar_arg_len = namelen;
273 	ARG_SET_VALID(ar, ARG_CTLNAME | ARG_LEN);
274 }
275 
276 void
277 audit_arg_mask(int mask)
278 {
279 	struct kaudit_record *ar;
280 
281 	ar = currecord();
282 	if (ar == NULL)
283 		return;
284 
285 	ar->k_ar.ar_arg_mask = mask;
286 	ARG_SET_VALID(ar, ARG_MASK);
287 }
288 
289 void
290 audit_arg_mode(mode_t mode)
291 {
292 	struct kaudit_record *ar;
293 
294 	ar = currecord();
295 	if (ar == NULL)
296 		return;
297 
298 	ar->k_ar.ar_arg_mode = mode;
299 	ARG_SET_VALID(ar, ARG_MODE);
300 }
301 
302 void
303 audit_arg_dev(int dev)
304 {
305 	struct kaudit_record *ar;
306 
307 	ar = currecord();
308 	if (ar == NULL)
309 		return;
310 
311 	ar->k_ar.ar_arg_dev = dev;
312 	ARG_SET_VALID(ar, ARG_DEV);
313 }
314 
315 void
316 audit_arg_value(long value)
317 {
318 	struct kaudit_record *ar;
319 
320 	ar = currecord();
321 	if (ar == NULL)
322 		return;
323 
324 	ar->k_ar.ar_arg_value = value;
325 	ARG_SET_VALID(ar, ARG_VALUE);
326 }
327 
328 void
329 audit_arg_owner(uid_t uid, gid_t gid)
330 {
331 	struct kaudit_record *ar;
332 
333 	ar = currecord();
334 	if (ar == NULL)
335 		return;
336 
337 	ar->k_ar.ar_arg_uid = uid;
338 	ar->k_ar.ar_arg_gid = gid;
339 	ARG_SET_VALID(ar, ARG_UID | ARG_GID);
340 }
341 
342 void
343 audit_arg_pid(pid_t pid)
344 {
345 	struct kaudit_record *ar;
346 
347 	ar = currecord();
348 	if (ar == NULL)
349 		return;
350 
351 	ar->k_ar.ar_arg_pid = pid;
352 	ARG_SET_VALID(ar, ARG_PID);
353 }
354 
355 void
356 audit_arg_process(struct proc *p)
357 {
358 	struct kaudit_record *ar;
359 
360 	KASSERT(p != NULL, ("audit_arg_process: p == NULL"));
361 
362 	PROC_LOCK_ASSERT(p, MA_OWNED);
363 
364 	ar = currecord();
365 	if (ar == NULL)
366 		return;
367 
368 	ar->k_ar.ar_arg_auid = p->p_ucred->cr_audit.ai_auid;
369 	ar->k_ar.ar_arg_euid = p->p_ucred->cr_uid;
370 	ar->k_ar.ar_arg_egid = p->p_ucred->cr_groups[0];
371 	ar->k_ar.ar_arg_ruid = p->p_ucred->cr_ruid;
372 	ar->k_ar.ar_arg_rgid = p->p_ucred->cr_rgid;
373 	ar->k_ar.ar_arg_asid = p->p_ucred->cr_audit.ai_asid;
374 	ar->k_ar.ar_arg_termid_addr = p->p_ucred->cr_audit.ai_termid;
375 	ar->k_ar.ar_arg_pid = p->p_pid;
376 	ARG_SET_VALID(ar, ARG_AUID | ARG_EUID | ARG_EGID | ARG_RUID |
377 	    ARG_RGID | ARG_ASID | ARG_TERMID_ADDR | ARG_PID | ARG_PROCESS);
378 }
379 
380 void
381 audit_arg_signum(u_int signum)
382 {
383 	struct kaudit_record *ar;
384 
385 	ar = currecord();
386 	if (ar == NULL)
387 		return;
388 
389 	ar->k_ar.ar_arg_signum = signum;
390 	ARG_SET_VALID(ar, ARG_SIGNUM);
391 }
392 
393 void
394 audit_arg_socket(int sodomain, int sotype, int soprotocol)
395 {
396 	struct kaudit_record *ar;
397 
398 	ar = currecord();
399 	if (ar == NULL)
400 		return;
401 
402 	ar->k_ar.ar_arg_sockinfo.so_domain = sodomain;
403 	ar->k_ar.ar_arg_sockinfo.so_type = sotype;
404 	ar->k_ar.ar_arg_sockinfo.so_protocol = soprotocol;
405 	ARG_SET_VALID(ar, ARG_SOCKINFO);
406 }
407 
408 void
409 audit_arg_sockaddr(struct thread *td, struct sockaddr *sa)
410 {
411 	struct kaudit_record *ar;
412 
413 	KASSERT(td != NULL, ("audit_arg_sockaddr: td == NULL"));
414 	KASSERT(sa != NULL, ("audit_arg_sockaddr: sa == NULL"));
415 
416 	ar = currecord();
417 	if (ar == NULL)
418 		return;
419 
420 	bcopy(sa, &ar->k_ar.ar_arg_sockaddr, sa->sa_len);
421 	switch (sa->sa_family) {
422 	case AF_INET:
423 		ARG_SET_VALID(ar, ARG_SADDRINET);
424 		break;
425 
426 	case AF_INET6:
427 		ARG_SET_VALID(ar, ARG_SADDRINET6);
428 		break;
429 
430 	case AF_UNIX:
431 		audit_arg_upath(td, ((struct sockaddr_un *)sa)->sun_path,
432 		    ARG_UPATH1);
433 		ARG_SET_VALID(ar, ARG_SADDRUNIX);
434 		break;
435 	/* XXXAUDIT: default:? */
436 	}
437 }
438 
439 void
440 audit_arg_auid(uid_t auid)
441 {
442 	struct kaudit_record *ar;
443 
444 	ar = currecord();
445 	if (ar == NULL)
446 		return;
447 
448 	ar->k_ar.ar_arg_auid = auid;
449 	ARG_SET_VALID(ar, ARG_AUID);
450 }
451 
452 void
453 audit_arg_auditinfo(struct auditinfo *au_info)
454 {
455 	struct kaudit_record *ar;
456 
457 	ar = currecord();
458 	if (ar == NULL)
459 		return;
460 
461 	ar->k_ar.ar_arg_auid = au_info->ai_auid;
462 	ar->k_ar.ar_arg_asid = au_info->ai_asid;
463 	ar->k_ar.ar_arg_amask.am_success = au_info->ai_mask.am_success;
464 	ar->k_ar.ar_arg_amask.am_failure = au_info->ai_mask.am_failure;
465 	ar->k_ar.ar_arg_termid.port = au_info->ai_termid.port;
466 	ar->k_ar.ar_arg_termid.machine = au_info->ai_termid.machine;
467 	ARG_SET_VALID(ar, ARG_AUID | ARG_ASID | ARG_AMASK | ARG_TERMID);
468 }
469 
470 void
471 audit_arg_auditinfo_addr(struct auditinfo_addr *au_info)
472 {
473 	struct kaudit_record *ar;
474 
475 	ar = currecord();
476 	if (ar == NULL)
477 		return;
478 
479 	ar->k_ar.ar_arg_auid = au_info->ai_auid;
480 	ar->k_ar.ar_arg_asid = au_info->ai_asid;
481 	ar->k_ar.ar_arg_amask.am_success = au_info->ai_mask.am_success;
482 	ar->k_ar.ar_arg_amask.am_failure = au_info->ai_mask.am_failure;
483 	ar->k_ar.ar_arg_termid_addr.at_type = au_info->ai_termid.at_type;
484 	ar->k_ar.ar_arg_termid_addr.at_port = au_info->ai_termid.at_port;
485 	ar->k_ar.ar_arg_termid_addr.at_addr[0] = au_info->ai_termid.at_addr[0];
486 	ar->k_ar.ar_arg_termid_addr.at_addr[1] = au_info->ai_termid.at_addr[1];
487 	ar->k_ar.ar_arg_termid_addr.at_addr[2] = au_info->ai_termid.at_addr[2];
488 	ar->k_ar.ar_arg_termid_addr.at_addr[3] = au_info->ai_termid.at_addr[3];
489 	ARG_SET_VALID(ar, ARG_AUID | ARG_ASID | ARG_AMASK | ARG_TERMID_ADDR);
490 }
491 
492 void
493 audit_arg_text(char *text)
494 {
495 	struct kaudit_record *ar;
496 
497 	KASSERT(text != NULL, ("audit_arg_text: text == NULL"));
498 
499 	ar = currecord();
500 	if (ar == NULL)
501 		return;
502 
503 	/* Invalidate the text string */
504 	ar->k_ar.ar_valid_arg &= (ARG_ALL ^ ARG_TEXT);
505 
506 	if (ar->k_ar.ar_arg_text == NULL)
507 		ar->k_ar.ar_arg_text = malloc(MAXPATHLEN, M_AUDITTEXT,
508 		    M_WAITOK);
509 
510 	strncpy(ar->k_ar.ar_arg_text, text, MAXPATHLEN);
511 	ARG_SET_VALID(ar, ARG_TEXT);
512 }
513 
514 void
515 audit_arg_cmd(int cmd)
516 {
517 	struct kaudit_record *ar;
518 
519 	ar = currecord();
520 	if (ar == NULL)
521 		return;
522 
523 	ar->k_ar.ar_arg_cmd = cmd;
524 	ARG_SET_VALID(ar, ARG_CMD);
525 }
526 
527 void
528 audit_arg_svipc_cmd(int cmd)
529 {
530 	struct kaudit_record *ar;
531 
532 	ar = currecord();
533 	if (ar == NULL)
534 		return;
535 
536 	ar->k_ar.ar_arg_svipc_cmd = cmd;
537 	ARG_SET_VALID(ar, ARG_SVIPC_CMD);
538 }
539 
540 void
541 audit_arg_svipc_perm(struct ipc_perm *perm)
542 {
543 	struct kaudit_record *ar;
544 
545 	ar = currecord();
546 	if (ar == NULL)
547 		return;
548 
549 	bcopy(perm, &ar->k_ar.ar_arg_svipc_perm,
550 	    sizeof(ar->k_ar.ar_arg_svipc_perm));
551 	ARG_SET_VALID(ar, ARG_SVIPC_PERM);
552 }
553 
554 void
555 audit_arg_svipc_id(int id)
556 {
557 	struct kaudit_record *ar;
558 
559 	ar = currecord();
560 	if (ar == NULL)
561 		return;
562 
563 	ar->k_ar.ar_arg_svipc_id = id;
564 	ARG_SET_VALID(ar, ARG_SVIPC_ID);
565 }
566 
567 void
568 audit_arg_svipc_addr(void * addr)
569 {
570 	struct kaudit_record *ar;
571 
572 	ar = currecord();
573 	if (ar == NULL)
574 		return;
575 
576 	ar->k_ar.ar_arg_svipc_addr = addr;
577 	ARG_SET_VALID(ar, ARG_SVIPC_ADDR);
578 }
579 
580 void
581 audit_arg_posix_ipc_perm(uid_t uid, gid_t gid, mode_t mode)
582 {
583 	struct kaudit_record *ar;
584 
585 	ar = currecord();
586 	if (ar == NULL)
587 		return;
588 
589 	ar->k_ar.ar_arg_pipc_perm.pipc_uid = uid;
590 	ar->k_ar.ar_arg_pipc_perm.pipc_gid = gid;
591 	ar->k_ar.ar_arg_pipc_perm.pipc_mode = mode;
592 	ARG_SET_VALID(ar, ARG_POSIX_IPC_PERM);
593 }
594 
595 void
596 audit_arg_auditon(union auditon_udata *udata)
597 {
598 	struct kaudit_record *ar;
599 
600 	ar = currecord();
601 	if (ar == NULL)
602 		return;
603 
604 	bcopy((void *)udata, &ar->k_ar.ar_arg_auditon,
605 	    sizeof(ar->k_ar.ar_arg_auditon));
606 	ARG_SET_VALID(ar, ARG_AUDITON);
607 }
608 
609 /*
610  * Audit information about a file, either the file's vnode info, or its
611  * socket address info.
612  */
613 void
614 audit_arg_file(struct proc *p, struct file *fp)
615 {
616 	struct kaudit_record *ar;
617 	struct socket *so;
618 	struct inpcb *pcb;
619 	struct vnode *vp;
620 	int vfslocked;
621 
622 	ar = currecord();
623 	if (ar == NULL)
624 		return;
625 
626 	switch (fp->f_type) {
627 	case DTYPE_VNODE:
628 	case DTYPE_FIFO:
629 		/*
630 		 * XXXAUDIT: Only possibly to record as first vnode?
631 		 */
632 		vp = fp->f_vnode;
633 		vfslocked = VFS_LOCK_GIANT(vp->v_mount);
634 		vn_lock(vp, LK_EXCLUSIVE | LK_RETRY);
635 		audit_arg_vnode(vp, ARG_VNODE1);
636 		VOP_UNLOCK(vp, 0);
637 		VFS_UNLOCK_GIANT(vfslocked);
638 		break;
639 
640 	case DTYPE_SOCKET:
641 		so = (struct socket *)fp->f_data;
642 		if (INP_CHECK_SOCKAF(so, PF_INET)) {
643 			SOCK_LOCK(so);
644 			ar->k_ar.ar_arg_sockinfo.so_type =
645 			    so->so_type;
646 			ar->k_ar.ar_arg_sockinfo.so_domain =
647 			    INP_SOCKAF(so);
648 			ar->k_ar.ar_arg_sockinfo.so_protocol =
649 			    so->so_proto->pr_protocol;
650 			SOCK_UNLOCK(so);
651 			pcb = (struct inpcb *)so->so_pcb;
652 			INP_RLOCK(pcb);
653 			ar->k_ar.ar_arg_sockinfo.so_raddr =
654 			    pcb->inp_faddr.s_addr;
655 			ar->k_ar.ar_arg_sockinfo.so_laddr =
656 			    pcb->inp_laddr.s_addr;
657 			ar->k_ar.ar_arg_sockinfo.so_rport =
658 			    pcb->inp_fport;
659 			ar->k_ar.ar_arg_sockinfo.so_lport =
660 			    pcb->inp_lport;
661 			INP_RUNLOCK(pcb);
662 			ARG_SET_VALID(ar, ARG_SOCKINFO);
663 		}
664 		break;
665 
666 	default:
667 		/* XXXAUDIT: else? */
668 		break;
669 	}
670 }
671 
672 /*
673  * Store a path as given by the user process for auditing into the audit
674  * record stored on the user thread.  This function will allocate the memory
675  * to store the path info if not already available.  This memory will be
676  * freed when the audit record is freed.
677  *
678  * XXXAUDIT: Possibly assert that the memory isn't already allocated?
679  */
680 void
681 audit_arg_upath(struct thread *td, char *upath, u_int64_t flag)
682 {
683 	struct kaudit_record *ar;
684 	char **pathp;
685 
686 	KASSERT(td != NULL, ("audit_arg_upath: td == NULL"));
687 	KASSERT(upath != NULL, ("audit_arg_upath: upath == NULL"));
688 
689 	ar = currecord();
690 	if (ar == NULL)
691 		return;
692 
693 	KASSERT((flag == ARG_UPATH1) || (flag == ARG_UPATH2),
694 	    ("audit_arg_upath: flag %llu", (unsigned long long)flag));
695 	KASSERT((flag != ARG_UPATH1) || (flag != ARG_UPATH2),
696 	    ("audit_arg_upath: flag %llu", (unsigned long long)flag));
697 
698 	if (flag == ARG_UPATH1)
699 		pathp = &ar->k_ar.ar_arg_upath1;
700 	else
701 		pathp = &ar->k_ar.ar_arg_upath2;
702 
703 	if (*pathp == NULL)
704 		*pathp = malloc(MAXPATHLEN, M_AUDITPATH, M_WAITOK);
705 
706 	audit_canon_path(td, upath, *pathp);
707 
708 	ARG_SET_VALID(ar, flag);
709 }
710 
711 /*
712  * Function to save the path and vnode attr information into the audit
713  * record.
714  *
715  * It is assumed that the caller will hold any vnode locks necessary to
716  * perform a VOP_GETATTR() on the passed vnode.
717  *
718  * XXX: The attr code is very similar to vfs_vnops.c:vn_stat(), but always
719  * provides access to the generation number as we need that to construct the
720  * BSM file ID.
721  *
722  * XXX: We should accept the process argument from the caller, since it's
723  * very likely they already have a reference.
724  *
725  * XXX: Error handling in this function is poor.
726  *
727  * XXXAUDIT: Possibly KASSERT the path pointer is NULL?
728  */
729 void
730 audit_arg_vnode(struct vnode *vp, u_int64_t flags)
731 {
732 	struct kaudit_record *ar;
733 	struct vattr vattr;
734 	int error;
735 	struct vnode_au_info *vnp;
736 
737 	KASSERT(vp != NULL, ("audit_arg_vnode: vp == NULL"));
738 	KASSERT((flags == ARG_VNODE1) || (flags == ARG_VNODE2),
739 	    ("audit_arg_vnode: flags %jd", (intmax_t)flags));
740 
741 	/*
742 	 * Assume that if the caller is calling audit_arg_vnode() on a
743 	 * non-MPSAFE vnode, then it will have acquired Giant.
744 	 */
745 	VFS_ASSERT_GIANT(vp->v_mount);
746 	ASSERT_VOP_LOCKED(vp, "audit_arg_vnode");
747 
748 	ar = currecord();
749 	if (ar == NULL)
750 		return;
751 
752 	/*
753 	 * XXXAUDIT: The below clears, and then resets the flags for valid
754 	 * arguments.  Ideally, either the new vnode is used, or the old one
755 	 * would be.
756 	 */
757 	if (flags & ARG_VNODE1) {
758 		ar->k_ar.ar_valid_arg &= (ARG_ALL ^ ARG_VNODE1);
759 		vnp = &ar->k_ar.ar_arg_vnode1;
760 	} else {
761 		ar->k_ar.ar_valid_arg &= (ARG_ALL ^ ARG_VNODE2);
762 		vnp = &ar->k_ar.ar_arg_vnode2;
763 	}
764 
765 	error = VOP_GETATTR(vp, &vattr, curthread->td_ucred, curthread);
766 	if (error) {
767 		/* XXX: How to handle this case? */
768 		return;
769 	}
770 
771 	vnp->vn_mode = vattr.va_mode;
772 	vnp->vn_uid = vattr.va_uid;
773 	vnp->vn_gid = vattr.va_gid;
774 	vnp->vn_dev = vattr.va_rdev;
775 	vnp->vn_fsid = vattr.va_fsid;
776 	vnp->vn_fileid = vattr.va_fileid;
777 	vnp->vn_gen = vattr.va_gen;
778 	if (flags & ARG_VNODE1)
779 		ARG_SET_VALID(ar, ARG_VNODE1);
780 	else
781 		ARG_SET_VALID(ar, ARG_VNODE2);
782 }
783 
784 /*
785  * Audit the argument strings passed to exec.
786  */
787 void
788 audit_arg_argv(char *argv, int argc, int length)
789 {
790 	struct kaudit_record *ar;
791 
792 	if (audit_argv == 0)
793 		return;
794 
795 	ar = currecord();
796 	if (ar == NULL)
797 		return;
798 
799 	ar->k_ar.ar_arg_argv = malloc(length, M_AUDITTEXT, M_WAITOK);
800 	bcopy(argv, ar->k_ar.ar_arg_argv, length);
801 	ar->k_ar.ar_arg_argc = argc;
802 	ARG_SET_VALID(ar, ARG_ARGV);
803 }
804 
805 /*
806  * Audit the environment strings passed to exec.
807  */
808 void
809 audit_arg_envv(char *envv, int envc, int length)
810 {
811 	struct kaudit_record *ar;
812 
813 	if (audit_arge == 0)
814 		return;
815 
816 	ar = currecord();
817 	if (ar == NULL)
818 		return;
819 
820 	ar->k_ar.ar_arg_envv = malloc(length, M_AUDITTEXT, M_WAITOK);
821 	bcopy(envv, ar->k_ar.ar_arg_envv, length);
822 	ar->k_ar.ar_arg_envc = envc;
823 	ARG_SET_VALID(ar, ARG_ENVV);
824 }
825 
826 /*
827  * The close() system call uses it's own audit call to capture the path/vnode
828  * information because those pieces are not easily obtained within the system
829  * call itself.
830  */
831 void
832 audit_sysclose(struct thread *td, int fd)
833 {
834 	struct kaudit_record *ar;
835 	struct vnode *vp;
836 	struct file *fp;
837 	int vfslocked;
838 
839 	KASSERT(td != NULL, ("audit_sysclose: td == NULL"));
840 
841 	ar = currecord();
842 	if (ar == NULL)
843 		return;
844 
845 	audit_arg_fd(fd);
846 
847 	if (getvnode(td->td_proc->p_fd, fd, &fp) != 0)
848 		return;
849 
850 	vp = fp->f_vnode;
851 	vfslocked = VFS_LOCK_GIANT(vp->v_mount);
852 	vn_lock(vp, LK_EXCLUSIVE | LK_RETRY);
853 	audit_arg_vnode(vp, ARG_VNODE1);
854 	VOP_UNLOCK(vp, 0);
855 	VFS_UNLOCK_GIANT(vfslocked);
856 	fdrop(fp, td);
857 }
858