From owner-freebsd-doc  Tue Jan  2 21:10: 5 2001
From owner-freebsd-doc@FreeBSD.ORG  Tue Jan  2 21:10:01 2001
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 3460C37B402
	for <freebsd-doc@freebsd.org>; Tue,  2 Jan 2001 21:10:01 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.1/8.11.1) id f035A1U76007;
	Tue, 2 Jan 2001 21:10:01 -0800 (PST)
	(envelope-from gnats)
Resent-Date: Tue, 2 Jan 2001 21:10:01 -0800 (PST)
Resent-Message-Id: <200101030510.f035A1U76007@freefall.freebsd.org>
Resent-From: gnats-admin@FreeBSD.org (GNATS Management)
Resent-To: freebsd-doc@freebsd.org
Resent-Reply-To: gnats-admin@FreeBSD.org, bnjf@optushome.com.au
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 662E737B400
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  2 Jan 2001 21:05:29 -0800 (PST)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.1/8.11.1) id f0355T675218;
	Tue, 2 Jan 2001 21:05:29 -0800 (PST)
	(envelope-from nobody)
Message-Id: <200101030505.f0355T675218@freefall.freebsd.org>
Date: Tue, 2 Jan 2001 21:05:29 -0800 (PST)
From: bnjf@optushome.com.au
Sender: nobody@freebsd.org
To: freebsd-gnats-submit@freebsd.org
X-Send-Pr-Version: www-1.0
Subject: docs/24035: ptrace(2) PT_STEP incorrect documentation
Resent-Sender: gnats@FreeBSD.org
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         24035
>Category:       docs
>Synopsis:       ptrace(2) PT_STEP incorrect documentation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jan 02 21:10:00 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Brad Forschinger
>Release:        4.2-STABLE
>Organization:
>Environment:
FreeBSD betwixt.uliginous.dyndns.org 4.2-STABLE FreeBSD 4.2-STABLE #9: Fri Dec  1 17:05:12 EST 2000     root@betwixt.uliginous.dyndns.org:/usr/src/sys/compile/BETWIXT  i386

>Description:

in the man pge
     PT_STEP       The traced process is single stepped one instruction.  The
                   addr and data fields are not used.

this is a lie. you must feed ptrace() a valid value for addr, just like PT_CONTINUE


>How-To-Repeat:

try and ptrace(PT_STEP, pid, 0, 0) something ;)
>Fix:

let users know that the addr is required

>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message