From Schweikhardt@RUS.Uni-Stuttgart.DE  Mon Aug 12 02:02:00 1996
Received: from noc.belwue.de (root@noc.BelWue.DE [129.143.2.1])
          by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id CAA09883
          for <FreeBSD-gnats-submit@freebsd.org>; Mon, 12 Aug 1996 02:01:48 -0700 (PDT)
Received: from rubin.noc.dfn.de (rubin.noc.dfn.de [193.174.247.201]) by noc.belwue.de with SMTP id LAA26229
  (8.6.13/IDA-1.6 for <FreeBSD-gnats-submit@freebsd.org>); Mon, 12 Aug 1996 11:01:40 +0200
Received: from diamant.noc.dfn.de by rubin.noc.dfn.de (4.1/BelWue-2.0SUN)
	id AA18849; Mon, 12 Aug 96 11:01:38 +0200
Received: by diamant.noc.dfn.de (SMI-8.6/SVR4/BelWue-1.0.3)
	id LAA03991; Mon, 12 Aug 1996 11:01:28 +0200
Message-Id: <199608120901.LAA03991@diamant.noc.dfn.de>
Date: Mon, 12 Aug 1996 11:01:27 +0200 (MET DST)
From: Schweikhardt@RUS.Uni-Stuttgart.DE (Jens Schweikhardt)
To: FreeBSD-gnats-submit@freebsd.org
Subject: incomplete prototypes in man pages for mmap function

>Number:         1493
>Category:       docs
>Synopsis:       incomplete prototypes in man pages for mmap functions
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    dyson
>State:          closed
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 12 02:10:01 PDT 1996
>Closed-Date:    Sat Jan 11 15:34:56 PST 1997
>Last-Modified:  Sat Jan 11 15:35:31 PST 1997
>Originator:     Jens Schweikhardt
>Release:        FreeBSD 2.1-STABLE i386
>Organization:
U o Stuttgart
>Environment:

	Any

>Description:

	Many of the mmap related functions have an incomplete prototype
	in their man page: the type of the return value is missing.
	Only some of them have a section on the RETURN VALUE:

SYNOPSIS
     madvise(caddr_t addr, int len, int behav)
     (No RETURN VALUE section)

SYNOPSIS
     mprotect(caddr_t addr, int len, int prot)
     (No RETURN VALUE section)

SYNOPSIS
     munmap(caddr_t addr, size_t len)

SYNOPSIS
     msync(caddr_t addr, int len, int flags)

SYNOPSIS
     mincore(caddr_t addr, int len, char *vec)
     (No RETURN VALUE section)

And while I'm at it:
man 2 intro says:

a)
     7 E2BIG Arg list too long. The number of bytes used for the argument and
             environment list of the new process exceeded the current limit of
             20480 bytes (NCARGS in <sys/param.h>).

If you look for NCARGS in <sys/param.h>, the limit is 65536, not 20480.

b)
     File Name
             Names consisting of up to 255 (MAXNAMELEN) characters may be used
             to name an ordinary file, special file, or directory.

             These characters may be selected from the set of all ASCII char-
             acter excluding 0 (NUL) and the ASCII code for `/' (slash).  (The
             parity bit, bit 7, must be 0.)

Is this really true or just some historical leftovers from days of yore
when the path name functions weren't 8 bit clean? I can't believe it's
true with all the locale/foreign language support on the system.
If bit 7 may be used, the man page should be updated.


>How-To-Repeat:

	man 2 madvise
	etc.
>Fix:
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->dyson 
Responsible-Changed-By: wosch 
Responsible-Changed-When: Thu Sep 26 16:47:39 PDT 1996 
Responsible-Changed-Why:  
Mr. VM/mmap 
State-Changed-From-To: open->closed 
State-Changed-By: mpp 
State-Changed-When: Sat Jan 11 15:34:56 PST 1997 
State-Changed-Why:  
The man pages were updated to include the  
missing information. 
>Unformatted:
To: FreeBSD-gnats-submit@freebsd.org
Subject:  incomplete prototypes in man pages for mmap functions
From: schweikhardt@rus.uni-stuttgart.de
Reply-To: schweikhardt@rus.uni-stuttgart.de
X-send-pr-version: 3.2


