UTRACE(2) | System Calls Manual | UTRACE(2) |
utrace
— insert
user record in ktrace log
#include
<sys/types.h>
#include <sys/time.h>
#include <sys/uio.h>
#include <sys/ktrace.h>
int
utrace
(const
char *label, void
*addr, size_t
len);
Adds a record to the process trace with information supplied by the 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.
Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.
ENOSYS
]ENAMETOOLONG
]KTR_USER_MAXIDLEN-1
.EINVAL
]KTR_USER_MAXLEN
.The utrace
() system call first appeared in
FreeBSD 2.2. It was added to
OpenBSD in OpenBSD 5.4. The
label argument is an extension.
February 22, 2022 | OpenBSD-current |