NetBSD Problem Report #50474
From dholland@netbsd.org Thu Nov 26 01:50:36 2015
Return-Path: <dholland@netbsd.org>
Received: from mail.netbsd.org (mail.netbsd.org [149.20.53.66])
(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
(Client CN "mail.netbsd.org", Issuer "Postmaster NetBSD.org" (verified OK))
by mollari.NetBSD.org (Postfix) with ESMTPS id 7C079A64EF
for <gnats-bugs@gnats.NetBSD.org>; Thu, 26 Nov 2015 01:50:36 +0000 (UTC)
Message-Id: <20151126015036.4255114A227@mail.netbsd.org>
Date: Thu, 26 Nov 2015 01:50:36 +0000 (UTC)
From: dholland@netbsd.org
Reply-To: dholland@netbsd.org
To: gnats-bugs@gnats.NetBSD.org
Subject: the internal mutex(9) types are undocumented
X-Send-Pr-Version: 3.95
>Number: 50474
>Category: kern
>Synopsis: the internal mutex(9) types are undocumented
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: kern-bug-people
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Thu Nov 26 01:55:00 +0000 2015
>Originator: David A. Holland
>Release: NetBSD 7.99.21 (20151125)
>Organization:
>Environment:
System: NetBSD valkyrie 7.99.1 NetBSD 7.99.1 (VALKYRIE) #17: Wed Oct 14 03:21:03 EDT 2015 dholland@valkyrie:/usr/src/sys/arch/amd64/compile/VALKYRIE amd64
Architecture: x86_64
Machine: amd64
>Description:
mutex(9) says under mutex_init():
The type argument must be given as MUTEX_DEFAULT. Other constants
are defined but are for low-level system use and are not an
endorsed, stable part of the interface.
This is all very well but not much use if one is trying to work on or
understand the implementation internals. Private material should be
labeled as such, but should also still be documented.
>How-To-Repeat:
>Fix:
(Contact us)
$NetBSD: query-full-pr,v 1.39 2013/11/01 18:47:49 spz Exp $
$NetBSD: gnats_config.sh,v 1.8 2006/05/07 09:23:38 tsutsui Exp $
Copyright © 1994-2014
The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.