diff options
| author | Luke Shumaker <lukeshu@lukeshu.com> | 2017-05-16 04:38:08 +0000 |
|---|---|---|
| committer | Luke Shumaker <lukeshu@lukeshu.com> | 2017-05-20 17:39:14 -0400 |
| commit | 2a5f08828bcd7175dc0483f8d8ff81e75360fad8 (patch) | |
| tree | 3b4fa848250977f68286481bfe5ddf555c30a298 | |
| parent | 6e93cd92fa878d001f33c906ace1ba21b5df76c9 (diff) | |
basic: barrier.c: add some newlines in the documentation
| -rw-r--r-- | src/libsystemd-basic/src/barrier.c | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/src/libsystemd-basic/src/barrier.c b/src/libsystemd-basic/src/barrier.c index 903cbd56e2..5e2f607e72 100644 --- a/src/libsystemd-basic/src/barrier.c +++ b/src/libsystemd-basic/src/barrier.c @@ -33,11 +33,13 @@ /** * Barriers + * * This barrier implementation provides a simple synchronization method based * on file-descriptors that can safely be used between threads and processes. A * barrier object contains 2 shared counters based on eventfd. Both processes * can now place barriers and wait for the other end to reach a random or * specific barrier. + * * Barriers are numbered, so you can either wait for the other end to reach any * barrier or the last barrier that you placed. This way, you can use barriers * for one-way *and* full synchronization. Note that even-though barriers are @@ -56,6 +58,7 @@ * barriers that are linked to a barrier we already placed. If the other side * already placed more barriers than we did, barrier_sync_next() returns * immediately. + * * barrier_sync() extends barrier_sync_next() and waits until the other end * placed as many barriers via barrier_place() as we did. If they already placed * as many as we did (or more), it returns immediately. @@ -67,6 +70,7 @@ * return false on both sides (otherwise, they always return true). * barrier_abort() can be called multiple times on both ends and will be a * no-op if already called on this side. + * * barrier_wait_abortion() can be used to wait for the other side to call * barrier_abort() and is the only wait/sync call that does not return * immediately if we aborted outself. It only returns once the other side |