From nobody@FreeBSD.org  Sat May 20 12:39:00 2006
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 68B7516A428
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 20 May 2006 12:39:00 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 3800A43D46
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 20 May 2006 12:39:00 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id k4KCcxLZ021855
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 20 May 2006 12:38:59 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id k4KCcx7i021852;
	Sat, 20 May 2006 12:38:59 GMT
	(envelope-from nobody)
Message-Id: <200605201238.k4KCcx7i021852@www.freebsd.org>
Date: Sat, 20 May 2006 12:38:59 GMT
From: thierry herbelot <thierry@herbelot.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: inconsistency in tsleep(9) manpage
X-Send-Pr-Version: www-2.3

>Number:         97521
>Category:       docs
>Synopsis:       inconsistency in tsleep(9) manpage
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat May 20 12:40:10 GMT 2006
>Closed-Date:    Mon Jun 12 20:39:12 GMT 2006
>Last-Modified:  Mon Jun 12 20:39:12 GMT 2006
>Originator:     thierry herbelot
>Release:        FreeBSD 6.1-STABLE
>Organization:
>Environment:
FreeBSD XXX 6.1-STABLE FreeBSD 6.1-STABLE #166: Sat May 20 04:41:48 CEST 2006     YYY@XXX:/usr/obj/usr/src/sys/GENERIC  i386
>Description:
in the tsleep man page :

     The parameter wmesg is a string describing the sleep condition for tools
     like ps(1).  Due to the limited space of those programs to display arbi-
     trary strings, this message should not be longer than 6 characters.

but in one driver (ufm) there is a call :

     tsleep(sc, 0, "ufmwait", hz/4);

either the man page or the driver code is wrong

there is also :
                error = tsleep(&sc->sc_q, PZERO | PCATCH, "uhidrea", 0);
in /usr/src/sys/dev/usb/uhid.c

>How-To-Repeat:

>Fix:

>Release-Note:
>Audit-Trail:

From: Maxim Konovalov <maxim@macomnet.ru>
To: thierry herbelot <thierry@herbelot.com>
Cc: bug-followup@freebsd.org
Subject: docs/97521
Date: Mon, 12 Jun 2006 00:03:13 +0400 (MSD)

 Hi Thierry,
 
 This is just an advise not a strict rule (should vs must).  There is
 no such limitation in the kernel.  kvm(3) limits wmesg length by
 WMESGLEN (defined in sys/user.h) plus terminating NULL.
 
 If you don't object I'll close this PR.
 
 -- 
 Maxim Konovalov

From: Thierry Herbelot <thierry@herbelot.com>
To: Maxim Konovalov <maxim@macomnet.ru>
Cc: bug-followup@freebsd.org
Subject: Re: docs/97521
Date: Sun, 11 Jun 2006 22:50:03 +0200

 Le Sunday 11 June 2006 22:03, Maxim Konovalov a crit :
 > Hi Thierry,
 >
 > This is just an advise not a strict rule (should vs must).  There is
 > no such limitation in the kernel.  kvm(3) limits wmesg length by
 > WMESGLEN (defined in sys/user.h) plus terminating NULL.
 >
 > If you don't object I'll close this PR.
 
 Hello Maxim
 
 no problem for me : I just would have liked to have a more explicit wording to 
 define the length of authorized strings.
 
 	TfH
State-Changed-From-To: open->closed 
State-Changed-By: maxim 
State-Changed-When: Mon Jun 12 20:37:22 UTC 2006 
State-Changed-Why:  
The statement about wmesg length is just a convention not a strict 
rule.  Actually there is no such limit in the kernel land. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=97521 
>Unformatted:
