utrace.2freebsd

Langue: en

Version: 266446 (debian - 07/07/09)

Section: 2 (Appels système)


BSD mandoc

NAME

utrace - insert user record in ktrace log

LIBRARY

Lb libc

SYNOPSIS

In sys/types.h In sys/param.h In sys/time.h In sys/uio.h In sys/ktrace.h Ft int Fn utrace const void *addr size_t len

DESCRIPTION

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

RETURN VALUES

Rv -std

ERRORS

Bq Er EINVAL
Specified data length Fa len was bigger than KTR_USER_MAXLEN
Bq Er ENOMEM
Insufficient memory to honor the request.
Bq Er ENOSYS
Currently running kernel was compiled without ktrace(2) support (options KTRACE )

SEE ALSO

kdump(1), ktrace(1), ktrace(2)

HISTORY

The Fn utrace system call first appeared in Fx 2.2 .