Re: svn commit: r333590 - head/share/man/man9

2018-06-25 Thread Matthew Macy 
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
>
___
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"

Re: svn commit: r333590 - head/share/man/man9

2018-06-25 Thread Andriy Gapon 
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.

> 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
___
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"

Re: svn commit: r333590 - head/share/man/man9

2018-06-25 Thread Ed Schouten 
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?

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

-- 
Ed Schouten 
Nuxi, 's-Hertogenbosch, the Netherlands
___
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"

Re: svn commit: r333590 - head/share/man/man9

2018-06-24 Thread Matthew Macy 
Sorry, I meant to respond.

http://concurrencykit.org/presentations/ebr.pdf

http://scalebsd.org/blog/2018/05/03/Why-is-munmap-single-threaded-and-what-can-we-do-about-it


http://scalebsd.org/blog/2018/06/16/UDP-and-epoch-for-liveness-guarantees


On Sun, Jun 24, 2018 at 13:56 Ed Schouten  wrote:

> Hi Matt,
>
> 2018-05-17 9:06 GMT+02:00 Ed Schouten :
> > Hi Matt,
> >
> > 2018-05-14 1:16 GMT+02:00 Matt Macy :
> >> +Epochs do not have any lock ordering issues. Entering and leaving
> >
> > It looks like the man page is missing some newlines between sentences.
> >
> > Quick question: How does this work relate to RCU
> > (https://en.wikipedia.org/wiki/Read-copy-update)? If there is any
> > relation, should we mention it in the documentation?
>
> I never got a response to this. Any thoughts?
>
> --
> Ed Schouten 
> Nuxi, 's-Hertogenbosch, the Netherlands
>
___
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"

Re: svn commit: r333590 - head/share/man/man9

2018-06-24 Thread Andriy Gapon 
On 24/06/2018 23:55, Ed Schouten wrote:
> Hi Matt,
> 
> 2018-05-17 9:06 GMT+02:00 Ed Schouten :
>> Hi Matt,
>>
>> 2018-05-14 1:16 GMT+02:00 Matt Macy :
>>> +Epochs do not have any lock ordering issues. Entering and leaving
>>
>> It looks like the man page is missing some newlines between sentences.
>>
>> Quick question: How does this work relate to RCU
>> (https://en.wikipedia.org/wiki/Read-copy-update)? If there is any
>> relation, should we mention it in the documentation?
> 
> I never got a response to this. Any thoughts?

Perhaps a little application of google can help.
[keywords: epoch based reclamation]

-- 
Andriy Gapon
___
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"

Re: svn commit: r333590 - head/share/man/man9

2018-06-24 Thread Ed Schouten 
Hi Matt,

2018-05-17 9:06 GMT+02:00 Ed Schouten :
> Hi Matt,
>
> 2018-05-14 1:16 GMT+02:00 Matt Macy :
>> +Epochs do not have any lock ordering issues. Entering and leaving
>
> It looks like the man page is missing some newlines between sentences.
>
> Quick question: How does this work relate to RCU
> (https://en.wikipedia.org/wiki/Read-copy-update)? If there is any
> relation, should we mention it in the documentation?

I never got a response to this. Any thoughts?

-- 
Ed Schouten 
Nuxi, 's-Hertogenbosch, the Netherlands
___
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"

Re: svn commit: r333590 - head/share/man/man9

2018-05-17 Thread Ed Schouten 
Hi Matt,

2018-05-14 1:16 GMT+02:00 Matt Macy :
> +Epochs do not have any lock ordering issues. Entering and leaving

It looks like the man page is missing some newlines between sentences.

Quick question: How does this work relate to RCU
(https://en.wikipedia.org/wiki/Read-copy-update)? If there is any
relation, should we mention it in the documentation?

-- 
Ed Schouten 
Nuxi, 's-Hertogenbosch, the Netherlands
___
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"