X-Git-Url: https://git.lttng.org/?p=urcu.git;a=blobdiff_plain;f=README;h=b3839e1a614a134c4960cc96824cefca83078d69;hp=ba9c16dbdd5f6dfb8f7b96ad719eafda11b8a02f;hb=fdf01eeda9f634a32db3fc90cd342da08d7a259d;hpb=9d7e3f89772f08cca26d727f47d44ecd47c94401 diff --git a/README b/README index ba9c16d..b3839e1 100644 --- a/README +++ b/README @@ -44,19 +44,11 @@ Usage of liburcu * #include * Link the application with "-lurcu". - * This is the preferred version of the library, both in terms of speed - and flexibility. Requires a signal, typically SIGUSR1. Can be - overridden with -DSIGRCU by modifying Makefile.build.inc. - -Usage of liburcu-mb - - * #include - * Compile any _LGPL_SOURCE code using this library with "-DRCU_MB". - * Link with "-lurcu-mb". - * This version of the urcu library does not need to - reserve a signal number. RCU_MB uses full memory barriers for - readers. This eliminates the need for signals but results in slower - reads. + * This is the preferred version of the library, in terms of + grace-period detection speed, read-side speed and flexibility. + Dynamically detects kernel support for sys_membarrier(). Falls back + on urcu-mb scheme if support is not present, which has slower + read-side. Usage of liburcu-qsbr @@ -68,6 +60,22 @@ Usage of liburcu-qsbr the threads are not active. It provides the fastest read-side at the expense of more intrusiveness in the application code. +Usage of liburcu-mb + + * #include + * Compile any _LGPL_SOURCE code using this library with "-DRCU_MB". + * Link with "-lurcu-mb". + * This version of the urcu library uses memory barriers on the writer + and reader sides. This results in faster grace-period detection, but + results in slower reads. + +Usage of liburcu-signal + + * #include + * Link the application with "-lurcu-signal". + * Version of the library that requires a signal, typically SIGUSR1. Can + be overridden with -DSIGRCU by modifying Makefile.build.inc. + Usage of liburcu-bp * #include