hc
2024-02-20 102a0743326a03cd1a1202ceda21e175b7d3575c
kernel/drivers/cpuidle/coupled.c
....@@ -1,19 +1,10 @@
1
+// SPDX-License-Identifier: GPL-2.0-or-later
12 /*
23 * coupled.c - helper functions to enter the same idle state on multiple cpus
34 *
45 * Copyright (c) 2011 Google, Inc.
56 *
67 * Author: Colin Cross <ccross@android.com>
7
- *
8
- * This program is free software; you can redistribute it and/or modify
9
- * it under the terms of the GNU General Public License as published by
10
- * the Free Software Foundation; either version 2 of the License, or
11
- * (at your option) any later version.
12
- *
13
- * This program is distributed in the hope that it will be useful, but WITHOUT
14
- * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15
- * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16
- * more details.
178 */
189
1910 #include <linux/kernel.h>
....@@ -98,6 +89,7 @@
9889 * @coupled_cpus: mask of cpus that are part of the coupled set
9990 * @requested_state: array of requested states for cpus in the coupled set
10091 * @ready_waiting_counts: combined count of cpus in ready or waiting loops
92
+ * @abort_barrier: synchronisation point for abort cases
10193 * @online_count: count of cpus that are online
10294 * @refcnt: reference count of cpuidle devices that are using this struct
10395 * @prevent: flag to prevent coupled idle while a cpu is hotplugging
....@@ -347,7 +339,7 @@
347339
348340 /**
349341 * cpuidle_coupled_poke_others - wake up all other cpus that may be waiting
350
- * @dev: struct cpuidle_device for this cpu
342
+ * @this_cpu: target cpu
351343 * @coupled: the struct coupled that contains the current cpu
352344 *
353345 * Calls cpuidle_coupled_poke on all other online cpus.
....@@ -364,7 +356,7 @@
364356
365357 /**
366358 * cpuidle_coupled_set_waiting - mark this cpu as in the wait loop
367
- * @dev: struct cpuidle_device for this cpu
359
+ * @cpu: target cpu
368360 * @coupled: the struct coupled that contains the current cpu
369361 * @next_state: the index in drv->states of the requested state for this cpu
370362 *
....@@ -385,7 +377,7 @@
385377
386378 /**
387379 * cpuidle_coupled_set_not_waiting - mark this cpu as leaving the wait loop
388
- * @dev: struct cpuidle_device for this cpu
380
+ * @cpu: target cpu
389381 * @coupled: the struct coupled that contains the current cpu
390382 *
391383 * Removes the requested idle state for the specified cpuidle device.
....@@ -421,7 +413,7 @@
421413
422414 /**
423415 * cpuidle_coupled_clear_pokes - spin until the poke interrupt is processed
424
- * @cpu - this cpu
416
+ * @cpu: this cpu
425417 *
426418 * Turns on interrupts and spins until any outstanding poke interrupts have
427419 * been processed and the poke bit has been cleared.