[src/trunk]: src/sys/kern add comments for trace_enter()/trace_exit(); partic...

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

details:   https://anonhg.NetBSD.org/src/rev/129ac22d9f8a
branches:  trunk
changeset: 539211:129ac22d9f8a
user:      jdolecek <jdolecek%NetBSD.org@localhost>
date:      Mon Nov 11 10:43:54 2002 +0000

description:
add comments for trace_enter()/trace_exit(); particularily comment
expected value of 'code'

diffstat:

 sys/kern/kern_subr.c |  18 ++++++++++++++++--
 1 files changed, 16 insertions(+), 2 deletions(-)

diffs (46 lines):

diff -r fdeda63159d2 -r 129ac22d9f8a sys/kern/kern_subr.c
--- a/sys/kern/kern_subr.c      Mon Nov 11 10:15:46 2002 +0000
+++ b/sys/kern/kern_subr.c      Mon Nov 11 10:43:54 2002 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: kern_subr.c,v 1.91 2002/09/27 18:37:43 drochner Exp $  */
+/*     $NetBSD: kern_subr.c,v 1.92 2002/11/11 10:43:54 jdolecek Exp $  */
 
 /*-
  * Copyright (c) 1997, 1998, 1999, 2002 The NetBSD Foundation, Inc.
@@ -90,7 +90,7 @@
  */
 
 #include <sys/cdefs.h>
-__KERNEL_RCSID(0, "$NetBSD: kern_subr.c,v 1.91 2002/09/27 18:37:43 drochner Exp $");
+__KERNEL_RCSID(0, "$NetBSD: kern_subr.c,v 1.92 2002/11/11 10:43:54 jdolecek Exp $");
 
 #include "opt_ddb.h"
 #include "opt_md.h"
@@ -1227,6 +1227,13 @@
        return (rv);
 }
 
+/*
+ * Start trace of particular system call. If process is being traced,
+ * this routine is called by MD syscall dispatch code just before
+ * a system call is actually executed.
+ * MD caller guarantees the passed 'code' is within the supported
+ * system call number range for emulation the process runs under.
+ */
 int
 trace_enter(struct proc *p, register_t code, void *args, register_t rval[])
 {
@@ -1246,6 +1253,13 @@
        return 0;
 }
 
+/*
+ * End trace of particular system call. If process is being traced,
+ * this routine is called by MD syscall dispatch code just after
+ * a system call finishes.
+ * MD caller guarantees the passed 'code' is within the supported
+ * system call number range for emulation the process runs under.
+ */
 void
 trace_exit(struct proc *p, register_t code, void *args, register_t rval[],
     int error)