NetBSD Problem Report #50895

From www@NetBSD.org  Sat Mar  5 09:42:08 2016
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(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 478B07A13F
	for <gnats-bugs@gnats.NetBSD.org>; Sat,  5 Mar 2016 09:42:08 +0000 (UTC)
Message-Id: <20160305094207.162427ACC7@mollari.NetBSD.org>
Date: Sat,  5 Mar 2016 09:42:07 +0000 (UTC)
From: ryan@freqlabs.com
Reply-To: ryan@freqlabs.com
To: gnats-bugs@NetBSD.org
Subject: /usr/share/doc/papers needs more papers.
X-Send-Pr-Version: www-1.0

>Number:         50895
>Category:       misc
>Synopsis:       /usr/share/doc/papers needs more papers.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Mar 05 09:45:00 +0000 2016
>Last-Modified:  Tue Mar 08 23:35:01 +0000 2016
>Originator:     Ryan Moeller
>Release:        NetBSD 7.99.26
>Organization:
>Environment:
NetBSD netbsd-bhyve.hsd1.tx.comcast.net 7.99.26 NetBSD 7.99.26 (GENERIC) #0: Thu Feb 11 06:05:11 UTC 2016  ryan@netbsd-bhyve.hsd1.tx.comcast.net:/usr/obj/sys/arch/amd64/compile/GENERIC amd64
>Description:
There are currently only three papers in /usr/share/doc/papers, the most recent of which is from 1985. I know of at least two more papers which should be in there: the UVM paper (Cranor 99) and the Rumpkernel paper (Kantee 12) are directly regarding NetBSD internals, and hopefully more work is out there, too. Another paper that could be a candidate is the Magazines/Vmem paper (Bonwick 01) which, while not specifically discussing NetBSD, is referenced  as the inspiration for our vmem implementation.

I suspect the authors of these papers would readily grant permission for NetBSD to distribute their work as part of the documentation tree.

Expanding the collection of detailed design documents is critical for preserving the history and motivations behind NetBSD's technologies. Furthermore, enriching our repository of knowledge ensures the appeal of this work to newcomers in the future. These wonderful documents, and others like them, already have been written; the hard part is already done. We need simply to include them.
>How-To-Repeat:
ls /usr/share/doc/papers/
>Fix:
Obtain permission from authors to distribute academic papers describing NetBSD's technologies.

Include these papers in the project.

(Optional) Convert documents to more universal formats (i.e. .ps, .txt).

>Audit-Trail:
From: Ryan Moeller <ryan@freqlabs.com>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: misc/50895
Date: Tue, 8 Mar 2016 16:15:04 -0600

 Here are a few more papers I've come across that could live there:


 Crooks 2009, "A Role-Based Access Control Kernel for NetBSD"
 https://www.netbsd.org/~agc/20090901-RBAC-paper.pdf

 Williams (year?), "An Implementation of Scheduler Activations on the 
 NetBSD Operating System"
 http://www.mit.edu/people/nathanw/usenix/freenix-sa/freenix-sa.html


 And links for the previous ones I mentioned:


 Cranor 1999, "The UVM Virtual Memory System"
 https://www.usenix.org/legacy/publications/library/proceedings/usenix99/full_papers/cranor/cranor.pdf

 Kantee 2012, "Flexible Operating System Internals: The Design and 
 Implementation of the Anykernel and Rump Kernels"
 http://lib.tkk.fi/Diss/2012/isbn9789526049175/isbn9789526049175.pdf


 Bonwick 2001, "Magazines and Vmem: Extending the Slab Allocator to Many 
 CPUs and Arbitrary Resources"
 https://www.usenix.org/legacy/event/usenix01/full_papers/bonwick/bonwick.pdf

NetBSD Home
NetBSD PR Database Search

(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.