NAME    [Toc]    [Back]

     utrace - insert user record to ktrace records

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>
     #include <sys/param.h>
     #include <sys/time.h>
     #include <sys/uio.h>
     #include <sys/ktrace.h>

     int
     utrace(const char *label, void *addr, size_t len);

DESCRIPTION    [Toc]    [Back]

     Adds a record to process trace with information supplied by user.  The
     record is identified by label and contains len bytes from memory pointed
     to by addr.  This call has only effect if the caller process is being
     traced.

RETURN VALUES    [Toc]    [Back]

     Upon successful completion, a value of 0 is returned.  Otherwise, a value
     of -1 is returned and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

     [ENOSYS]           Currently running kernel was compiled without
                        ktrace(2) support (option KTRACE).

     [EINVAL]           Specified data length len was bigger than
                        KTR_USER_MAXLEN.

SEE ALSO    [Toc]    [Back]

     kdump(1), ktrace(1), ktruss(1), fktrace(2), ktrace(2), options(4)

HISTORY    [Toc]    [Back]

     The utrace() system call first appeared in FreeBSD 2.2.  It was added to
     NetBSD in NetBSD 1.6.  The label argument is NetBSD extension.

BSD                            December 28, 2000                           BSD