From owner-freebsd-bugs@FreeBSD.ORG  Sun Jan  9 16:20:22 2005
Return-Path: <owner-freebsd-bugs@FreeBSD.ORG>
Delivered-To: freebsd-bugs@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 87A2D16A4CE
	for <freebsd-bugs@hub.freebsd.org>;
	Sun,  9 Jan 2005 16:20:22 +0000 (GMT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 50C1443D39
	for <freebsd-bugs@hub.freebsd.org>;
	Sun,  9 Jan 2005 16:20:22 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.13.1/8.13.1) with ESMTP id j09GKMFb099107
	for <freebsd-bugs@freefall.freebsd.org>; Sun, 9 Jan 2005 16:20:22 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.1/8.13.1/Submit) id j09GKM17099105;
	Sun, 9 Jan 2005 16:20:22 GMT
	(envelope-from gnats)
Resent-Date: Sun, 9 Jan 2005 16:20:22 GMT
Resent-Message-Id: <200501091620.j09GKM17099105@freefall.freebsd.org>
Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer)
Resent-To: freebsd-bugs@FreeBSD.org
Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org,
	Tarc <tarc@po.cs.msu.su>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 972F216A4CE
	for <freebsd-gnats-submit@FreeBSD.org>;
	Sun,  9 Jan 2005 16:10:30 +0000 (GMT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 851DF43D4C
	for <freebsd-gnats-submit@FreeBSD.org>;
	Sun,  9 Jan 2005 16:10:30 +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 j09GATXR080382
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 9 Jan 2005 16:10:29 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id j09GATSb080381;
	Sun, 9 Jan 2005 16:10:29 GMT
	(envelope-from nobody)
Message-Id: <200501091610.j09GATSb080381@www.freebsd.org>
Date: Sun, 9 Jan 2005 16:10:29 GMT
From: Tarc <tarc@po.cs.msu.su>
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-2.3
Subject: misc/75995: hcreate documentation(?) bug
X-BeenThere: freebsd-bugs@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Bug reports <freebsd-bugs.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-bugs>,
	<mailto:freebsd-bugs-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-bugs>
List-Post: <mailto:freebsd-bugs@freebsd.org>
List-Help: <mailto:freebsd-bugs-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-bugs>,
	<mailto:freebsd-bugs-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 09 Jan 2005 16:20:22 -0000


>Number:         75995
>Category:       misc
>Synopsis:       hcreate documentation(?) bug
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jan 09 16:20:21 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Tarc
>Release:        5.3
>Organization:
MSU
>Environment:
FreeBSD tarc.po.cs.msu.su 5.3-STABLE FreeBSD 5.3-STABLE #0: Wed Dec 29 18:08:32 MSK 2004     root@tarc.po.cs.msu.su:/usr/src/sys/i386/compile/Kernel  i386
>Description:
I read the man hcreate(3) and, for better understanding, how hash table addressed, /usr/src/lib/libc/stdlib/hcreate.c
Mam says, that if error occur, hcreate(3) returns 0, but if no memory, it will set errno to ENOMEM.
But I see, that if hachtable is already created, hcreate returns 0 AND SETS errno to EINVAL.
T think, it's true way, but undocumented
>How-To-Repeat:
up to date system sources & read:
cd /usr/src/lib/libc/stdlib
more hcreate.c
man 3 hcreate

>Fix:
Add description about EINVAL to man, or don't set errno.
>Release-Note:
>Audit-Trail:
>Unformatted: