NAME
utrace
- insert user record in ktrace log
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
int
utrace(
const char *label
, void *addr
, size_t len
)
DESCRIPTION
Adds a record to the 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 only has an effect if the calling process is being traced.
RETURN VALUES
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
- [
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
kdump(1),
ktrace(1),
ktruss(1),
fktrace(2),
ktrace(2),
options(4)
HISTORY
The
utrace(
)
system call first appeared in
FreeBSD2.2.
It was added to
NetBSD
in
NetBSD1.6.
The
label
argument is a
NetBSD
extension.