[src/trunk]: src/sys/kern add a comment explaining what this does.

[christos <christos%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/894c3af28568
branches:  trunk
changeset: 999941:894c3af28568
user:      christos <christos%NetBSD.org@localhost>
date:      Tue Jun 25 18:06:29 2019 +0000

description:
add a comment explaining what this does.

diffstat:

 sys/kern/kern_exec.c |  10 ++++++++--
 1 files changed, 8 insertions(+), 2 deletions(-)

diffs (31 lines):

diff -r 46978405edf7 -r 894c3af28568 sys/kern/kern_exec.c
--- a/sys/kern/kern_exec.c      Tue Jun 25 16:58:02 2019 +0000
+++ b/sys/kern/kern_exec.c      Tue Jun 25 18:06:29 2019 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: kern_exec.c,v 1.469 2019/06/25 16:58:02 maxv Exp $     */
+/*     $NetBSD: kern_exec.c,v 1.470 2019/06/25 18:06:29 christos Exp $ */
 
 /*-
  * Copyright (c) 2008 The NetBSD Foundation, Inc.
@@ -59,7 +59,7 @@
  */
 
 #include <sys/cdefs.h>
-__KERNEL_RCSID(0, "$NetBSD: kern_exec.c,v 1.469 2019/06/25 16:58:02 maxv Exp $");
+__KERNEL_RCSID(0, "$NetBSD: kern_exec.c,v 1.470 2019/06/25 18:06:29 christos Exp $");
 
 #include "opt_exec.h"
 #include "opt_execfmt.h"
@@ -608,6 +608,12 @@
 #endif
 }
 
+/*
+ * Copy the user or kernel supplied upath to the allocated pathbuffer pbp
+ * making it absolute in the process, by prepending the current working
+ * direct if it is not. If offs is supplied it will contain the offset
+ * where the original supplied copy of upath starts.
+ */
 int
 exec_makepathbuf(struct lwp *l, const char *upath, enum uio_seg seg,
     struct pathbuf **pbp, size_t *offs)