Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 25 Jun 2018 11:22:28 +0300
From:      Andriy Gapon <avg@FreeBSD.org>
To:        Ed Schouten <ed@nuxi.nl>
Cc:        Matt Macy <mmacy@freebsd.org>, src-committers <src-committers@freebsd.org>, svn-src-all@freebsd.org, svn-src-head@freebsd.org
Subject:   Re: svn commit: r333590 - head/share/man/man9
Message-ID:  <92f8270c-f726-7610-c209-3c35d2ad5b2c@FreeBSD.org>
In-Reply-To: <CABh_MK=tpVVqxpF2BN%2BqXW2i2VqjjAJUWHqnoNgwurGx2dJ_0w@mail.gmail.com>
References:  <201805132316.w4DNG4oh092482@repo.freebsd.org> <CABh_MKnuL8t-EVA=K1uc58ozcryu-Kj6paWp3YYeo7DRQQZscg@mail.gmail.com> <CABh_MKk=sGPSTc2TRE38fQXrJRd3gyGAhDZ16iLYVRHgdvhtCg@mail.gmail.com> <99d1722c-8085-6a70-64df-2fdb2c20b574@FreeBSD.org> <CABh_MK=tpVVqxpF2BN%2BqXW2i2VqjjAJUWHqnoNgwurGx2dJ_0w@mail.gmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On 25/06/2018 10:25, Ed Schouten wrote:
> Hi Andriy, Matthew,
> 
> 2018-06-24 23:36 GMT+02:00 Andriy Gapon <avg@freebsd.org>:
>> Perhaps a little application of google can help.
>> [keywords: epoch based reclamation]
> 
> Based on the man page, it wasn't clear that this refers to a generally
> accepted construct or something that is specific to FreeBSD. Any
> objections if I were to extend the man page as follows?

Certainly not from me.
Also, given that epoch(9) is a wrapper around (or based on) the implementation
provided by Concurrency Kit, maybe we should have some kind of a gateway manual
page for the latter.  That page would provide an introduction to Concurrency Kit
and links to its resources.  Then epoch.9 could reference it.

> Index: epoch.9
> ===================================================================
> --- epoch.9     (revision 335613)
> +++ epoch.9     (working copy)
> @@ -39,7 +39,7 @@
>  .Nm epoch_wait ,
>  .Nm epoch_call ,
>  .Nm in_epoch ,
> -.Nd kernel epoch based reclamation
> +.Nd kernel Epoch Based Reclamation (EBR)
>  .Sh SYNOPSIS
>  .In sys/param.h
>  .In sys/proc.h
> @@ -191,3 +191,10 @@
>  .Xr sleep 9 ,
>  .Xr sx 9 ,
>  .Xr timeout 9
> +.Rs
> +.%A K. Fraser
> +.%T Practical lock-freedom
> +.%D February 2004
> +.%P 79-81
> +.%U https://www.cl.cam.ac.uk/techreports/UCAM-CL-TR-579.pdf
> +.Re
> 


-- 
Andriy Gapon



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?92f8270c-f726-7610-c209-3c35d2ad5b2c>