From owner-svn-src-head@freebsd.org Mon Jun 25 14:54:43 2018 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 36543101229D; Mon, 25 Jun 2018 14:54:43 +0000 (UTC) (envelope-from mmacy@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "smtp.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id D30FE80030; Mon, 25 Jun 2018 14:54:42 +0000 (UTC) (envelope-from mmacy@freebsd.org) Received: from mail-it0-f52.google.com (mail-it0-f52.google.com [209.85.214.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) (Authenticated sender: mmacy) by smtp.freebsd.org (Postfix) with ESMTPSA id 9AD77BE14; Mon, 25 Jun 2018 14:54:42 +0000 (UTC) (envelope-from mmacy@freebsd.org) Received: by mail-it0-f52.google.com with SMTP id j129-v6so5512672ita.2; Mon, 25 Jun 2018 07:54:42 -0700 (PDT) X-Gm-Message-State: APt69E3mWfsKZaQ+LOv9OU58Y7PHFr7svBUjJFxcRt4vAt3gl32v3tbx SSCWBu6YFqA3mxP50cnCfdYH2D4wF/wnE3EFKMU= X-Google-Smtp-Source: AAOMgpdtDJ3qFyqtadDmc9ugX6WC7PS6TS+Czg3g8rLXSB8/Wmds878VswcfuP/JTcynEY5i5dghqtyKpdCzP+gBbBY= X-Received: by 2002:a24:6c8a:: with SMTP id w132-v6mr1178333itb.4.1529938482181; Mon, 25 Jun 2018 07:54:42 -0700 (PDT) MIME-Version: 1.0 References: <201805132316.w4DNG4oh092482@repo.freebsd.org> <99d1722c-8085-6a70-64df-2fdb2c20b574@FreeBSD.org> <92f8270c-f726-7610-c209-3c35d2ad5b2c@FreeBSD.org> In-Reply-To: <92f8270c-f726-7610-c209-3c35d2ad5b2c@FreeBSD.org> From: Matthew Macy Date: Mon, 25 Jun 2018 07:54:31 -0700 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: svn commit: r333590 - head/share/man/man9 To: Andriy Gapon Cc: Ed Schouten , src-committers , svn-src-all@freebsd.org, svn-src-head@freebsd.org Content-Type: text/plain; charset="UTF-8" X-Content-Filtered-By: Mailman/MimeDel 2.1.26 X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 25 Jun 2018 14:54:43 -0000 On Mon, Jun 25, 2018 at 01:30 Andriy Gapon wrote: > On 25/06/2018 10:25, Ed Schouten wrote: > > Hi Andriy, Matthew, > > > > 2018-06-24 23:36 GMT+02:00 Andriy Gapon : > >> 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. > There are man pages included with CK. Certain ports install them. For reasons that he no longer recalls cognet chose to not install them. You'll need to discuss it with him. -M > > 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 >