set_dvs_threads()

set_dvs_threads() sets how many threads dvs uses for parallel file operations (dvs_add(), dvs_get(), dvs_status()). The value is stored as the dvs.num_threads option and synced to the dvs core before each operation. It is process-wide; there is no per-call thread argument in R.

set_dvs_threads(threads)

🔗Parameters

Returns the previous value invisibly.

🔗Setup

options(width = 1000)
library(dvs)

🔗Set a fixed thread count

Set a fixed number of threads. It takes effect on the next add, get, or status.

set_dvs_threads(2)
getOption("dvs.num_threads")

[1] 2

🔗Reset to automatic

Pass NULL to revert to automatic detection. The automatic default is min(parallelism * 4, 16).

set_dvs_threads(NULL)
getOption("dvs.num_threads")

NULL

🔗Differences from the CLI

The CLI sets threads per call with --threads <N>; the R setting is process-wide. Threads set directly on either surface win. The DVS_NUM_THREADS environment variable applies only when neither the CLI flag nor set_dvs_threads() has set a count. See the --threads flag on any CLI command.

🔗See also

• set_dvs_log_level(), dvs_version()
• dvs_add(), dvs_get(), dvs_status()