| // SPDX-License-Identifier: GPL-2.0 |
| |
| ndctl-wait-scrub(1) |
| ==================== |
| |
| NAME |
| ---- |
| ndctl-wait-scrub - wait for an Address Range Scrub (ARS) operation to complete |
| |
| SYNOPSIS |
| -------- |
| [verse] |
| 'ndctl wait-scrub' [<bus-id> <bus-id2> ... <bus-idN>] [<options>] |
| |
| include::ars-description.txt[] |
| |
| The kernel provides a POLL(2) capable sysfs file ('scrub') to indicate |
| the state of ARS. The 'scrub' file maintains a running count of ARS runs |
| that have taken place. While a current run is in progress a '+' |
| character is emitted along with the current count. The 'ndctl |
| wait-scrub' operation waits for 'scrub', across all specified buses, to |
| indicate not in-progress at least once. |
| |
| EXAMPLE |
| ------- |
| Wait for scrub on all nvdimm buses in the system. The json listing |
| report at the end only includes the buses that support ARS operations. |
| [verse] |
| # ndctl wait-scrub |
| [ |
| { |
| "provider":"nfit_test.1", |
| "dev":"ndbus3", |
| "scrub_state":"idle" |
| }, |
| { |
| "provider":"nfit_test.0", |
| "dev":"ndbus2", |
| "scrub_state":"idle" |
| } |
| ] |
| |
| When specifying an individual bus, or if there is only one bus in the |
| system, the command reports whether ARS support is available. |
| [verse] |
| # ndctl wait-scrub e820 |
| error waiting for scrub completion: Operation not supported |
| |
| OPTIONS |
| ------- |
| -v:: |
| --verbose:: |
| Emit debug messages for the ARS wait process |
| |
| include::../copyright.txt[] |
| |
| SEE ALSO |
| -------- |
| linkndctl:ndctl-start-scrub[1], |
| http://www.uefi.org/sites/default/files/resources/ACPI%206_2_A_Sept29.pdf[ACPI |
| 6.2 Specification Section 9.20.7.2 Address Range Scrubbing (ARS) Overview] |