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: docs/1493: incomplete prototypes in man pages for mmap function Message-ID: <199608120901.LAA03991@diamant.noc.dfn.de> Resent-Message-ID: <199608120910.CAA10096@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 1493
>Category: docs
>Synopsis: incomplete prototypes in man pages for mmap functions
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-bugs
>State: open
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Mon Aug 12 02:10:01 PDT 1996
>Last-Modified:
>Originator: Jens Schweikhardt
>Organization:
U o Stuttgart
>Release: FreeBSD 2.1-STABLE i386
>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:
>Audit-Trail:
>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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199608120901.LAA03991>