NetBSD Problem Report #49461

From ryo_on@yk.rim.or.jp  Wed Dec 10 03:23:18 2014
Return-Path: <ryo_on@yk.rim.or.jp>
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 CD11CA5B2E
	for <gnats-bugs@gnats.NetBSD.org>; Wed, 10 Dec 2014 03:23:17 +0000 (UTC)
Message-Id: <20141210032314.DA1E130015463@mail.SiriusCloud.jp>
Date: Wed, 10 Dec 2014 12:23:14 +0900 (JST)
From: ryoon@NetBSD.org
Reply-To: ryoon@NetBSD.org
To: gnats-bugs@gnats.NetBSD.org
Subject: splusb is not included in spl(9) man page
X-Send-Pr-Version: 3.95

>Number:         49461
>Category:       misc
>Synopsis:       splusb is not included in spl(9) man page
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    misc-bug-people
>State:          closed
>Class:          sw-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Dec 10 03:25:00 +0000 2014
>Closed-Date:    Fri Aug 23 07:30:11 +0000 2019
>Last-Modified:  Fri Aug 23 07:30:11 +0000 2019
>Originator:     Ryo ONODERA
>Release:        NetBSD 7.99.2
>Organization:

>Environment:


System: NetBSD angelcake.elements.tetera.org 7.99.2 NetBSD 7.99.2 (DTRACE5) #0: Wed Dec 10 06:19:43 JST 2014 ryo_on@angelcake.elements.tetera.org:/usr/world/7.99/amd64/obj/sys/arch/amd64/compile/DTRACE5 amd64
Architecture: x86_64
Machine: amd64
>Description:
Some device drivers uses splusb function.
But it is not mentioned in spl(9) man page.
I feel that splusb should be explained in spl(9) man page.

>How-To-Repeat:
$ grep -r splusb /usr/src/sys
and
$ man 9 spl

>Fix:

Please fix this.

>Release-Note:

>Audit-Trail:
From: matthew green <mrg@eterna.com.au>
To: gnats-bugs@NetBSD.org
Cc: misc-bug-people@netbsd.org, gnats-admin@netbsd.org,
    netbsd-bugs@netbsd.org
Subject: re: misc/49461: splusb is not included in spl(9) man page
Date: Wed, 10 Dec 2014 14:40:38 +1100

 ryoon@NetBSD.org writes:
 > >Number:         49461
 > >Category:       misc
 > >Synopsis:       splusb is not included in spl(9) man page

 that's really the right thing.

 all calls to splusb(9) indicate old drivers that need to be updated.
 if anything, this info should be added to usbdi(9).


 .mrg.

From: Ryo ONODERA <ryo_on@yk.rim.or.jp>
To: gnats-bugs@NetBSD.org
Cc: 
Subject: Re: misc/49461: splusb is not included in spl(9) man page
Date: Wed, 10 Dec 2014 12:48:48 +0900 (JST)

 From: matthew green <mrg@eterna.com.au>, Date: Wed, 10 Dec 2014 14:40:38 +1100

 > 
 > ryoon@NetBSD.org writes:
 >> >Number:         49461
 >> >Category:       misc
 >> >Synopsis:       splusb is not included in spl(9) man page
 > 
 > that's really the right thing.
 > 
 > all calls to splusb(9) indicate old drivers that need to be updated.
 > if anything, this info should be added to usbdi(9).

 Thanks for your information.
 Newer device drivers, for example, athn and axen still use splusb(9).
 Please add appropriate explanation in usbdi(9).
 And please note "do not use splusb" like sentence in spl(9) too.

 --
 Ryo ONODERA // ryo_on@yk.rim.or.jp
 PGP fingerprint = 82A2 DC91 76E0 A10A 8ABB  FD1B F404 27FA C7D1 15F3

From: matthew green <mrg@eterna.com.au>
To: gnats-bugs@NetBSD.org
Cc: misc-bug-people@netbsd.org, gnats-admin@netbsd.org,
    netbsd-bugs@netbsd.org, ryoon@NetBSD.org
Subject: re: misc/49461: splusb is not included in spl(9) man page
Date: Wed, 10 Dec 2014 15:01:44 +1100

 splusb does not belong in spl(9) as it's USB specific.
 it's just an alias.

State-Changed-From-To: open->closed
State-Changed-By: mrg@NetBSD.org
State-Changed-When: Fri, 23 Aug 2019 07:30:11 +0000
State-Changed-Why:
splusb(9) is a deprecated interface.  that it's to be removed is
documented in sys/dev/usb/TODO.usbmp, and i just clarified that.

i think that's sufficient.


>Unformatted:

NetBSD Home
NetBSD PR Database Search

(Contact us) $NetBSD: query-full-pr,v 1.43 2018/01/16 07:36:43 maya Exp $
$NetBSD: gnats_config.sh,v 1.9 2014/08/02 14:16:04 spz Exp $
Copyright © 1994-2017 The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.