[src/trunk]: src/lib/libc/sys add utrace(2)

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

details:   https://anonhg.NetBSD.org/src/rev/5f3db1714907
branches:  trunk
changeset: 501696:5f3db1714907
user:      jdolecek <jdolecek%NetBSD.org@localhost>
date:      Fri Jan 05 21:49:47 2001 +0000

description:
add utrace(2)

diffstat:

 lib/libc/sys/Makefile.inc |   6 +-
 lib/libc/sys/utrace.2     |  91 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 94 insertions(+), 3 deletions(-)

diffs (122 lines):

diff -r 91ad5280d093 -r 5f3db1714907 lib/libc/sys/Makefile.inc
--- a/lib/libc/sys/Makefile.inc Fri Jan 05 21:42:08 2001 +0000
+++ b/lib/libc/sys/Makefile.inc Fri Jan 05 21:49:47 2001 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile.inc,v 1.110 2000/12/13 07:42:47 matt Exp $
+#      $NetBSD: Makefile.inc,v 1.111 2001/01/05 21:49:47 jdolecek Exp $
 #      @(#)Makefile.inc        8.3 (Berkeley) 10/24/94
 
 # sys sources
@@ -66,7 +66,7 @@
        __sigaltstack14.o __sigpending14.o __sigprocmask14.o __sigsuspend14.o \
        socket.o socketpair.o __stat13.o statfs.o \
        swapctl.o symlink.o sysarch.o umask.o undelete.o unlink.o \
-       unmount.o utimes.o vadvise.o wait4.o write.o writev.o \
+       unmount.o utimes.o utrace.o vadvise.o wait4.o write.o writev.o \
        __sysctl.o \
        __posix_chown.o __posix_fchown.o __posix_lchown.o __posix_rename.o
 
@@ -208,7 +208,7 @@
        sigprocmask.2 sigreturn.2 sigstack.2 sigsuspend.2 socket.2 \
        socketpair.2 stat.2 statfs.2 swapctl.2 swapon.3 symlink.2 \
        sync.2 sysarch.2 syscall.2 truncate.2 umask.2 undelete.2 \
-       unlink.2 utimes.2 vfork.2 wait.2 write.2
+       unlink.2 utimes.2 utrace.2 vfork.2 wait.2 write.2
 
 MLINKS+=brk.2 sbrk.2
 MLINKS+=dup.2 dup2.2
diff -r 91ad5280d093 -r 5f3db1714907 lib/libc/sys/utrace.2
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/lib/libc/sys/utrace.2     Fri Jan 05 21:49:47 2001 +0000
@@ -0,0 +1,91 @@
+.\"    $NetBSD: utrace.2,v 1.1 2001/01/05 21:49:48 jdolecek Exp $
+.\"
+.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Gregory McGarry <g.mcgarry%ieee.org@localhost>.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"      This product includes software developed by the NetBSD  
+.\"      Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\" 
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd December 28, 2000
+.Dt UTRACE 2
+.Os
+.Sh NAME
+.Nm utrace
+.Nd insert user record to ktrace records
+.Sh LIBRARY
+.Lb libc
+.Sh SYNOPSIS
+.Fd #include <sys/types.h>
+.Fd #include <sys/param.h>
+.Fd #include <sys/time.h>
+.Fd #include <sys/uio.h>
+.Fd #include <sys/ktrace.h>
+.Ft int
+.Fn utrace "const char *label" "void *addr" "size_t len"
+.Sh DESCRIPTION
+Adds a record to process trace with information supplied by user.
+The record is identified by
+.Fa label
+and contains
+.Fa len
+bytes from memory pointed to by
+.Fa addr.
+This call has only effect if the caller process is being traced.
+.Sh RETURN VALUES
+Upon successful completion, a value of 0 is returned.
+Otherwise, a value of -1 is returned and
+.Va errno
+is set to indicate the error.
+.Sh ERRORS
+.Bl -tag -width Er
+.It Bq Er ENOSYS
+Currently running kernel was compiled without
+.Xr ktrace 2
+support (option KTRACE).
+.El
+.Sh SEE ALSO
+.Xr kdump 1 ,
+.Xr ktrace 1 ,
+.Xr ktruss 1 ,
+.Xr fktrace 2 ,
+.Xr ktrace 2 ,
+.Xr options 4
+.Sh HISTORY
+The
+.Fn utrace
+system call first appeared in
+.Fx 4.0 .
+It was added to
+.Nx
+in
+.Nx 1.6 .
+The
+.Fa label
+argument is NetBSD extension.