Ahmed S. Darwish 0d24f65e93
Documentation: locking: Describe seqlock design and usage ...
Proper documentation for the design and usage of sequence counters and
sequential locks does not exist. Complete the seqlock.h documentation as
follows:
- Divide all documentation on a seqcount_t vs. seqlock_t basis. The
description for both mechanisms was intermingled, which is incorrect
since the usage constrains for each type are vastly different.
- Add an introductory paragraph describing the internal design of, and
rationale for, sequence counters.
- Document seqcount_t writer non-preemptibility requirement, which was
not previously documented anywhere, and provide a clear rationale.
- Provide template code for seqcount_t and seqlock_t initialization
and reader/writer critical sections.
- Recommend using seqlock_t by default. It implicitly handles the
serialization and non-preemptibility requirements of writers.
At seqlock.h:
- Remove references to brlocks as they've long been removed from the
kernel.
- Remove references to gcc-3.x since the kernel's minimum supported
gcc version is 4.9.
References: 0f6ed63b176ec4476ac8a.darwish@linutronix.de >
Signed-off-by: Peter Zijlstra (Intel) <peterz@infradead.org >
Link: https://lkml.kernel.org/r/20200720155530.1173732-2-a.darwish@linutronix.de
2020-07-29 16:14:22 +02:00
2020-04-28 17:44:34 +02:00
2020-05-22 20:47:21 -07:00
2020-06-15 23:08:31 -05:00
2020-06-16 16:01:53 +02:00
2020-05-12 22:48:42 +02:00
2020-06-01 13:22:53 +02:00
2020-05-12 13:08:08 -07:00
2020-06-07 10:59:32 -07:00
2020-06-04 19:56:20 -07:00
2020-06-03 10:48:37 +02:00
2020-05-13 13:59:13 +02:00
2020-05-15 16:03:28 +02:00
2020-07-08 22:31:51 -07:00
2020-06-04 20:11:25 -07:00
2020-06-05 14:05:57 -07:00
2020-07-09 19:27:07 -07:00
2020-05-29 12:37:59 +02:00
2020-06-03 09:21:52 +02:00
2020-05-27 13:39:08 +02:00
2020-06-25 00:50:31 +02:00
2020-06-25 00:50:31 +02:00
2020-05-18 19:30:56 +05:30
2020-06-13 13:12:38 -07:00
2020-06-23 15:01:16 -07:00
2020-05-29 14:36:03 +01:00
2020-05-07 11:04:38 -07:00
2020-06-30 12:18:08 -06:00
2020-05-20 17:22:30 +05:30
2020-06-07 16:13:43 -07:00
2020-06-11 12:22:41 -07:00
2020-05-26 10:27:14 +02:00
2020-05-21 14:07:37 +01:00
2020-06-11 08:03:24 +02:00
2020-06-25 08:23:22 -07:00
2020-06-11 08:03:24 +02:00
2020-05-07 22:49:28 -04:00
2020-05-09 16:15:13 -06:00
2020-05-09 16:15:13 -06:00
2020-05-11 07:39:16 +01:00
2020-05-24 20:48:11 +02:00
2020-06-04 19:18:29 -07:00
2020-06-02 19:59:25 -07:00
2020-06-04 19:06:25 -07:00
2020-07-08 10:48:35 -07:00
2020-05-16 14:23:54 -06:00
2020-04-30 15:54:45 -06:00
2020-05-14 09:48:03 -06:00
2020-05-29 10:23:25 -06:00
2020-06-29 07:45:09 -06:00
2020-06-01 15:21:03 -07:00
2020-06-01 14:38:22 -07:00
2020-05-19 11:32:04 -07:00
2020-06-30 10:46:38 -07:00
2020-06-30 10:46:39 -07:00
2020-05-15 10:56:31 -07:00
2020-06-11 15:14:53 +02:00
2020-06-25 16:17:05 +02:00
2020-06-02 10:59:08 -07:00
2020-05-19 09:40:29 -06:00
2020-06-09 09:39:16 -07:00
2020-05-15 17:29:41 +02:00
2020-06-15 23:08:31 -05:00
2020-05-04 10:13:42 -06:00
2020-07-09 16:28:44 -07:00
2020-07-07 13:34:11 -07:00
2020-06-03 20:24:15 -07:00
2020-05-05 16:46:09 -04:00
2020-06-16 15:35:02 +02:00
2020-07-08 10:48:35 -07:00
2020-06-15 14:10:09 +02:00
2020-07-08 10:48:35 -07:00
2020-06-25 08:24:32 -07:00
2020-05-05 09:23:25 -06:00
2020-06-01 10:15:16 +02:00
2020-06-11 15:14:36 +02:00
2020-06-11 15:14:36 +02:00
2020-04-27 02:06:53 -04:00
2020-05-19 16:31:16 +02:00
2020-05-14 11:11:20 +02:00
2020-05-19 12:55:29 +02:00
2020-05-07 15:18:41 +02:00
2020-06-05 14:20:02 +02:00
2020-06-11 12:55:20 -07:00
2020-06-09 09:39:13 -07:00
2020-05-21 08:22:20 -06:00
2020-06-09 09:39:13 -07:00
2020-05-13 08:44:35 -07:00
2020-06-11 15:15:28 +02:00
2020-05-06 17:03:34 -07:00
2020-06-08 11:05:56 -07:00
2020-06-01 16:44:06 -07:00
2020-05-20 17:09:45 -04:00
2020-07-10 15:20:38 +02:00
2020-06-05 14:59:41 -04:00
2020-07-10 15:39:29 +05:30
2020-07-14 15:42:24 +02:00
2020-06-30 15:44:03 +02:00
2020-06-09 09:39:13 -07:00
2020-06-15 23:08:30 -05:00
2020-06-08 11:05:56 -07:00
2020-06-17 15:29:11 +02:00
2020-05-29 10:23:24 -06:00
2020-06-04 19:06:25 -07:00
2020-05-04 11:19:58 -07:00
2020-06-05 13:17:05 -07:00
2020-05-27 18:55:54 +02:00
2020-06-03 23:16:55 -04:00
2020-04-27 02:06:53 -04:00
2020-07-08 16:01:21 -07:00
2020-04-30 20:14:33 +02:00
2020-07-14 14:45:41 +02:00
2020-07-10 09:45:15 -07:00
2020-06-15 23:08:31 -05:00
2020-05-05 09:22:20 -06:00
2020-05-18 20:21:48 -07:00
2020-05-12 16:44:00 -07:00
2020-05-19 15:51:18 +02:00
2020-06-10 16:05:54 -07:00
2020-05-15 16:34:52 +02:00
2020-06-02 15:37:03 -07:00
2020-06-03 20:09:45 -07:00
2020-07-10 12:00:01 +02:00
2020-05-14 13:50:43 +03:00
2020-06-04 19:06:22 -07:00
2020-06-09 09:39:13 -07:00
2020-06-16 18:59:45 +02:00
2020-06-09 09:39:14 -07:00
2020-06-09 09:39:13 -07:00
2020-06-02 20:58:55 +10:00
2020-05-28 07:59:45 -07:00
2020-05-23 09:07:00 +00:00
2020-05-15 11:23:49 +02:00
2020-05-29 12:53:04 +02:00
2020-06-19 09:20:28 +02:00
2020-05-19 12:54:05 +02:00
2020-05-28 10:31:09 +02:00
2020-06-25 10:46:24 +02:00
2020-04-27 11:40:25 -07:00
2020-05-11 13:19:00 -07:00
2020-07-07 15:48:38 -07:00
2020-05-20 20:31:27 -04:00
2020-05-22 14:41:04 -04:00
2020-04-30 12:54:01 -07:00
2020-06-23 10:08:31 +02:00
2020-05-18 15:37:25 +02:00
2020-06-10 14:04:39 -07:00
2020-06-11 15:15:29 +02:00
2020-06-09 09:39:13 -07:00
2020-06-05 16:19:28 -07:00
2020-06-08 11:42:23 -07:00
2020-05-06 11:29:25 +03:00
2020-06-07 10:59:32 -07:00
2020-06-08 11:05:56 -07:00
2020-05-18 10:30:21 +01:00
2020-06-28 17:01:20 +02:00
2020-05-18 10:29:26 +01:00
2020-07-10 12:00:02 +02:00
2020-06-12 14:51:41 -04:00
2020-07-08 15:59:57 -07:00
2020-06-09 09:39:13 -07:00
2020-05-12 13:28:33 +09:00
2020-05-06 10:58:46 -07:00
2020-06-02 15:15:46 +01:00
2020-06-08 11:05:56 -07:00
2020-06-15 23:08:31 -05:00
2020-05-19 15:42:22 +01:00
2020-05-14 09:46:54 -06:00
2020-07-09 20:12:19 -07:00
2020-05-30 10:34:03 -07:00
2020-06-10 11:28:35 -07:00
2020-06-20 13:17:47 -07:00
2020-06-11 13:25:53 -07:00
2020-06-15 23:08:31 -05:00
2020-04-27 02:07:40 -04:00
2020-06-27 15:20:03 -07:00
2020-05-08 18:18:11 +01:00
2020-05-08 00:12:42 +02:00
2020-05-28 10:31:09 +02:00
2020-05-28 10:31:09 +02:00
2020-07-28 10:45:46 +02:00
2020-07-28 10:45:46 +02:00
2020-05-19 15:47:38 +01:00
2020-06-23 16:39:23 -07:00
2020-06-14 11:39:31 -07:00
2020-05-26 15:31:45 -07:00
2020-06-03 20:09:49 -07:00
2020-06-03 20:09:49 -07:00
2020-06-10 13:42:09 -07:00
2020-06-09 09:39:14 -07:00
2020-05-28 11:22:13 +02:00
2020-05-22 09:35:43 +02:00
2020-06-09 09:39:14 -07:00
2020-06-09 09:39:14 -07:00
2020-06-09 09:39:14 -07:00
2020-06-10 19:14:18 -07:00
2020-06-09 09:39:14 -07:00
2020-06-26 00:27:37 -07:00
2020-05-13 11:41:22 +02:00
2020-07-13 18:31:15 -07:00
2020-06-04 11:13:03 -07:00
2020-05-19 11:42:16 +01:00
2020-06-09 15:40:50 -07:00
2020-06-02 10:59:07 -07:00
2020-06-08 11:05:56 -07:00
2020-04-30 12:56:36 -07:00
2020-06-18 20:12:33 -07:00
2020-05-07 18:11:07 -07:00
2020-05-27 10:10:12 -04:00
2020-06-11 13:33:48 -04:00
2020-05-27 10:10:12 -04:00
2020-04-27 02:07:40 -04:00
2020-05-09 13:57:12 +02:00
2020-06-05 20:02:08 -04:00
2020-05-09 16:18:33 -06:00
2020-05-09 16:18:33 -06:00
2020-05-27 07:12:40 +02:00
2020-04-22 19:41:26 -07:00
2020-05-12 22:45:39 +02:00
2020-06-16 20:45:08 -07:00
2020-06-03 20:09:45 -07:00
2020-06-02 10:59:09 -07:00
2020-06-04 15:36:52 -04:00
2020-06-09 09:39:14 -07:00
2020-04-23 17:05:39 +02:00
2020-05-15 13:51:28 -07:00
2020-05-27 05:21:23 -06:00
2020-06-11 15:17:57 +02:00
2020-06-04 12:59:16 -05:00
2020-05-27 14:35:41 +02:00
2020-05-07 09:29:43 +01:00
2020-05-22 12:35:07 +01:00
2020-06-30 16:58:27 -05:00
2020-06-03 16:27:18 -07:00
2020-06-20 22:14:53 +10:00
2020-06-24 14:52:49 -07:00
2020-04-24 16:45:37 -07:00
2020-04-22 10:51:21 -05:00
2020-06-04 13:54:34 -07:00
2020-06-13 09:56:21 -07:00
2020-04-28 17:44:33 +02:00
2020-05-29 10:15:08 +05:30
2020-05-29 18:03:12 +02:00
2020-04-24 21:35:11 +02:00
2020-04-22 11:36:11 +02:00
2020-05-28 19:25:31 +02:00
2020-05-19 15:51:17 +02:00
2020-06-08 11:05:56 -07:00
2020-06-04 13:54:34 -07:00
2020-05-09 13:57:12 +02:00
2020-06-07 10:53:36 -07:00
2020-05-20 19:10:37 +01:00
2020-06-15 17:38:53 +10:00
2020-05-31 19:49:00 -07:00
2020-05-30 10:34:03 -07:00
2020-05-31 19:49:00 -07:00
2020-05-30 10:34:03 -07:00
2020-06-02 10:59:10 -07:00
2020-05-15 13:48:59 -07:00
2020-05-28 10:31:09 +02:00
2020-04-21 10:29:19 -06:00
2020-04-21 10:29:19 -06:00
2020-06-04 13:54:34 -07:00
2020-04-27 11:03:52 -07:00
2020-04-27 11:03:51 -07:00
2020-04-27 11:03:52 -07:00
2020-05-26 19:05:11 +02:00
2020-05-26 19:05:11 +02:00
2020-05-20 03:39:40 -04:00
2020-06-01 11:35:18 -07:00
2020-06-03 16:59:31 -04:00
2020-05-12 15:00:37 -07:00
2020-06-09 09:39:14 -07:00
2020-05-22 09:38:13 +02:00
2020-07-16 23:19:51 +02:00
2020-07-06 16:07:25 +02:00
2020-07-25 21:49:36 +02:00
2020-05-18 17:47:48 +01:00
2020-06-15 23:08:32 -05:00
2020-06-14 11:39:31 -07:00
2020-06-04 19:06:26 -07:00
2020-07-29 16:14:22 +02:00
2020-06-27 16:16:37 +02:00
2020-06-11 15:19:17 +02:00
2020-05-05 16:46:10 -04:00
2020-06-02 11:50:23 -07:00
2020-06-30 10:46:39 -07:00
2020-06-28 17:01:20 +02:00
2020-06-28 17:01:20 +02:00
2020-05-11 16:59:16 -07:00
2020-06-17 18:33:13 +02:00
2020-06-17 18:33:13 +02:00
2020-05-17 14:10:07 -06:00
2020-06-10 19:14:18 -07:00
2020-05-14 16:44:24 +02:00
2020-04-21 15:54:45 -07:00
2020-06-03 20:09:42 -07:00
2020-05-27 17:55:59 +02:00
2020-04-30 20:14:41 +02:00
2020-06-26 00:27:37 -07:00
2020-06-15 11:16:27 +02:00
2020-06-08 11:05:56 -07:00
2020-05-15 14:53:19 +02:00
2020-06-30 12:18:08 -06:00
2020-04-28 11:05:44 +02:00
2020-05-28 11:11:45 -07:00
2020-05-25 23:15:03 +02:00
2020-05-11 13:29:30 +03:00
2020-06-15 23:08:32 -05:00
2020-06-18 11:37:03 +02:00
2020-04-27 02:07:40 -04:00
2020-04-27 11:05:13 -07:00
2020-06-15 14:37:02 +02:00
2020-04-22 22:06:35 -04:00
2020-05-04 09:16:37 -07:00
2020-07-29 16:14:18 +02:00
2020-06-04 15:50:42 -07:00
2020-05-29 14:52:53 +02:00
2020-06-18 12:10:37 -07:00
2020-06-04 15:36:51 -04:00
2020-04-25 20:18:53 -07:00
2020-05-13 12:42:46 -05:00
2020-05-28 15:53:29 -06:00
2020-05-28 16:31:30 -07:00
2020-04-27 10:18:01 -07:00
2020-06-03 20:09:48 -07:00
2020-06-26 00:27:38 -07:00
2020-06-03 20:24:15 -07:00
2020-06-02 02:45:13 -04:00
2020-04-27 11:03:50 -07:00
2020-05-19 15:08:24 +01:00
2020-04-20 17:11:36 -06:00
2020-06-01 11:02:28 -04:00
2020-06-05 16:19:28 -07:00
2020-06-08 11:05:56 -07:00
2020-06-02 10:59:10 -07:00
0d24f65e93