X-Git-Url: https://git.lttng.org/?p=urcu.git;a=blobdiff_plain;f=README;h=b3839e1a614a134c4960cc96824cefca83078d69;hp=ca23d43fe3bee6b5e62d5cfcd0489bb93c7ffc2b;hb=fdf01eeda9f634a32db3fc90cd342da08d7a259d;hpb=795d506a10a06e05380ff275f31c588ca1e2cee8 diff --git a/README b/README index ca23d43..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 -DSIGURCU by modifying Makefile.build.inc. - -Usage of liburcu-mb - - * #include - * Compile any _LGPL_SOURCE code using this library with "-DURCU_MB". - * Link with "-lurcu-mb". - * This version of the urcu library does not need to - reserve a signal number. URCU_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,13 +60,29 @@ 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 * Link with "-lurcu-bp". * The BP library flavor stands for "bulletproof". It is specifically designed to help tracing library to hook on applications without - requiring to modify these applications. urcu_init(), + requiring to modify these applications. rcu_init(), rcu_register_thread() and rcu_unregister_thread() all become nops. The state is dealt with by the library internally at the expense of read-side and write-side performance.