utrace (2)

Leading comments

	$NetBSD: utrace.2,v 1.11 2003/04/24 12:17:49 wiz 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>.

 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 comments found at the beginning of the groff file "man2/utrace.2freebsd".)

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 .