From nobody@FreeBSD.org  Tue Jan 22 00:47:30 2002
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 61C8137B41C
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 22 Jan 2002 00:47:29 -0800 (PST)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g0M8lTB78809;
	Tue, 22 Jan 2002 00:47:29 -0800 (PST)
	(envelope-from nobody)
Message-Id: <200201220847.g0M8lTB78809@freefall.freebsd.org>
Date: Tue, 22 Jan 2002 00:47:29 -0800 (PST)
From: Marian Cerny <cerny@spnv.sk>
To: freebsd-gnats-submit@FreeBSD.org
Subject: mistake in Handbook Section 3.5 Processes
X-Send-Pr-Version: www-1.0

>Number:         34155
>Category:       docs
>Synopsis:       mistake in Handbook Section 3.5 Processes
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    mwlucas
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jan 22 00:50:00 PST 2002
>Closed-Date:    Tue Jan 22 05:22:15 PST 2002
>Last-Modified:  Tue Jan 22 05:23:04 PST 2002
>Originator:     Marian Cerny
>Release:        FreeBSD 4.4-RELEASE
>Organization:
private
>Environment:
FreeBSD ivetka 4.4-RELEASE FreeBSD 4.4-RELEASE #0: Tue Sep 18 11:57:08 PDT 2001
    murray@builder.FreeBSD.org:/usr/src/sys/compile/GENERIC  i386
>Description:
In Handbook, Section 3.5 - Processes:

>    As you can see in this example, the output from [12]ps(1) is organized
>    in to a number of columns. PID is the process ID discussed earlier.
>    PIDs are assigned starting from 1, go up to 65536, and wrap around
                                                 ^^^^^
>    back to the beginning when you run out. TT shows the tty the program
>    is running on, and can safely be ignored for the moment. STAT shows

This is confusing. In the example above (output from ps) is
"72210  p0  R+     0:00.00 ps",
 ^^^^^
and in the example below (outpout from top) is
"last pid: 72257;  load averages:  0.13,  0.09,  0.03    up 0+13:38:33  22:39:10"
           ^^^^^

So after a while of investigation I found out that on my computer there
also are processes with PID higher than 65536. The highest value I have
seen was 99651. After a while, new processes got numbers around 500.

So I think that "65536" should be changed to "99999", if 99999 is the
right value.
>How-To-Repeat:
Have a look at Hanbook Section 3.5, then look for "65536".
>Fix:

>Release-Note:
>Audit-Trail:

From: Peter Pentchev <roam@ringlet.net>
To: Marian Cerny <cerny@spnv.sk>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/34155: mistake in Handbook Section 3.5 Processes
Date: Tue, 22 Jan 2002 14:13:23 +0200

 On Tue, Jan 22, 2002 at 12:47:29AM -0800, Marian Cerny wrote:
 > 
 > >Number:         34155
 > >Category:       docs
 > >Synopsis:       mistake in Handbook Section 3.5 Processes
 > >Originator:     Marian Cerny
 > >Release:        FreeBSD 4.4-RELEASE
 > >Organization:
 > private
 > >Environment:
 > FreeBSD ivetka 4.4-RELEASE FreeBSD 4.4-RELEASE #0: Tue Sep 18 11:57:08 PDT 2001
 >     murray@builder.FreeBSD.org:/usr/src/sys/compile/GENERIC  i386
 > >Description:
 > In Handbook, Section 3.5 - Processes:
 > 
 > >    As you can see in this example, the output from [12]ps(1) is organized
 > >    in to a number of columns. PID is the process ID discussed earlier.
 > >    PIDs are assigned starting from 1, go up to 65536, and wrap around
 >                                                  ^^^^^
 > >    back to the beginning when you run out. TT shows the tty the program
 > >    is running on, and can safely be ignored for the moment. STAT shows
 > 
 > This is confusing. In the example above (output from ps) is
 > "72210  p0  R+     0:00.00 ps",
 >  ^^^^^
 > and in the example below (outpout from top) is
 > "last pid: 72257;  load averages:  0.13,  0.09,  0.03    up 0+13:38:33  22:39:10"
 >            ^^^^^
 > 
 > So after a while of investigation I found out that on my computer there
 > also are processes with PID higher than 65536. The highest value I have
 > seen was 99651. After a while, new processes got numbers around 500.
 > 
 > So I think that "65536" should be changed to "99999", if 99999 is the
 > right value.
 
 Yep, 99999 is the correct value, as witnessed by the PID_MAX constant
 in <sys/proc.h>.
 
 Patch attached for the convenience of doc committers.
 
 G'luck,
 Peter
 
 -- 
 I am not the subject of this sentence.
 
 Index: doc/en_US.ISO8859-1/books/handbook/basics/chapter.sgml
 ===================================================================
 RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/basics/chapter.sgml,v
 retrieving revision 1.55
 diff -u -r1.55 chapter.sgml
 --- doc/en_US.ISO8859-1/books/handbook/basics/chapter.sgml	11 Jan 2002 02:50:21 -0000	1.55
 +++ doc/en_US.ISO8859-1/books/handbook/basics/chapter.sgml	22 Jan 2002 12:11:18 -0000
 @@ -780,7 +780,7 @@
      <para>As you can see in this example, the output from &man.ps.1; is
        organized in to a number of columns.  <literal>PID</literal> is the
        process ID discussed earlier.  PIDs are assigned starting from 1, go up
 -      to 65536, and wrap around back to the beginning when you run out.
 +      to 99999, and wrap around back to the beginning when you run out.
        <literal>TT</literal> shows the tty the program is running on, and can
        safely be ignored for the moment.  <literal>STAT</literal> shows the
        program's state, and again, can be safely ignored.
Responsible-Changed-From-To: freebsd-doc->mwlucas 
Responsible-Changed-By: mwlucas 
Responsible-Changed-When: Tue Jan 22 05:14:22 PST 2002 
Responsible-Changed-Why:  
Mmmm... easy fix, I'll take it. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=34155 
State-Changed-From-To: open->closed 
State-Changed-By: mwlucas 
State-Changed-When: Tue Jan 22 05:22:15 PST 2002 
State-Changed-Why:  
Fixed, thank you!  It may take up to 24 hours for the on-line Handbook 
to be regenerated. 


http://www.FreeBSD.org/cgi/query-pr.cgi?pr=34155 
>Unformatted:
