OODCMD command reference
Syntax:
OODCMD <command> [drive ...] [options]
Commands and method names are case-insensitive. The tables use the canonical names; OODCMD help is the authoritative help for your installed build.
Commands
| Command | Meaning |
|---|---|
analyze <drive ...> | Analyze selected drives without reorganizing files. |
defrag <drive ...> | Optimize using SOLID/Quick, or the method selected with --method. |
<method> <drive ...> | Run one of the methods below. |
list | List the drives known to the agent. |
status [drive ...] | Show drive state and fragmentation; omit drives for the available set. |
status [drive ...] --follow | Continue reporting running actions until they finish. |
stop <drive ...> | Stop the selected running actions. |
pause <drive ...> | Toggle between paused and running. |
resume <drive ...> | Alias of pause; also toggles the state. |
license | Show the license state; no license entry. |
version | Show the version. |
help [topic] | General help, methods, exitcodes, examples, or a method name. |
Pause is a toggle. Check status before using either pause or resume. Repeating resume is not an idempotent way to ensure an operation is running.
Methods
| Command name | Method |
|---|---|
solid-quick | SOLID/Quick; default for defrag. |
solid | SOLID/Complete. |
stealth | STEALTH. |
space | SPACE. |
complete-name | COMPLETE/Name. |
complete-modified | COMPLETE/Modified. |
complete-access | COMPLETE/Access. |
optimize | OPTIMIZE; zones required. |
optimize-quick | OPTIMIZE/Quick; zones required. |
optimize-complete | OPTIMIZE/Complete; zones required. |
Common method aliases include quick for solid-quick and solid-complete for solid. Prefer canonical names in scripts. Use help methods for aliases supported by your build.
Options
| Option | Meaning |
|---|---|
-m, --method <name> | Method for defrag. |
-n, --no-wait | Return once the agent accepts the action. |
-f, --follow | Follow running actions with status. |
-i, --interval <seconds> | Progress interval, default 2 seconds. |
-t, --timeout <seconds> | Agent connection timeout, default 30 seconds. |
-v, --verbose | Include current-file, load, and drive detail where available. |
-q, --quiet | Suppress routine progress; keep warnings, errors, and final result. |
Interval and connection timeout accept whole seconds from 1 to 3600. Timeout is for connecting to the agent, not a maximum optimization runtime.
Without --no-wait, analysis and method commands wait for completion. With --no-wait, success means acceptance, not completion.
Interrupting a waiting command
Ctrl+C while waiting requests a stop for actions started by that invocation. A second Ctrl+C exits immediately and can leave those actions running in the agent. Inspect status afterward.
A separate status --follow observes existing work. Do not assume closing that observer stops work it did not start.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Success; completed, or accepted when using --no-wait. |
| 1 | Invalid command line. |
| 2 | Trial, missing, expired, or invalid license. |
| 3 | Agent unavailable. |
| 4 | Drive unknown or not selectable. |
| 5 | Action not started, for example busy drive, disabled zones, or missing acknowledgement. |
| 6 | Action incomplete, including unconfirmed stop/pause. |
| 7 | Interrupted with Ctrl+C. |
| 8 | Connection lost while waiting. |
| 9 | Unexpected error. |
Read %ERRORLEVEL% in Command Prompt or $LASTEXITCODE in PowerShell immediately after OODCMD exits.