Articles in this section

See more

--orphans (One)

Avatar
Warren Post
  • Updated

The command line option --orphans is used to find or delete data blocks which are no longer associated with any file or directory and can be safely removed. It has four modes:

  • --orphans=help: Prints a terse help message and exits.
  • --orphans=find: Finds and reports on orphans but does not delete them.
  • --orphans=free: Finds and queues for deletion ("frees") all orphan files. This is the most useful mode.
  • --orphans=freeXX: Finds and queues for deletion only those orphans matching the specified age in days.

This option is intended to be run immediately after running --repair. Then immediately after running --orphans=free, run SpiderOak One (either the GUI, or the command line options --headless or --batchmode). What --orphans=free does is create an orphan freeing transaction, which will be uploaded the next time that One is run.

Example

The most common uses of --orphans are to correct a space reporting discrepancy or to free up wasted storage space not associated with any backed up file. To do that, completely shut down SpiderOak One by right clicking on its icon and selecting Quit. Then:

On Windows

Open a command prompt window. At the prompt enter the following command, followed by "Enter":

"C:\Program Files\SpiderOakONE\SpiderOakONE.exe" --repair --verbose

Let this process run; it may take a few minutes to generate text, so please be patient. When it completes, give the command:

"C:\Program Files\SpiderOakONE\SpiderOakONE.exe" --orphans=free

Again, let this process run.

On Mac

From Launchpad, open Terminal. At the prompt enter the following command, followed by "Enter":

/Applications/SpiderOakONE.app/Contents/MacOS/SpiderOakONE --repair --verbose

Let this process run; it may take a few minutes to generate text, so please be patient. When it completes, give the command:

/Applications/SpiderOakONE.app/Contents/MacOS/SpiderOakONE --orphans=free

Again, let this process run.

On Linux

Open a terminal. At the prompt enter the following command, followed by "Enter":

SpiderOakONE --repair --verbose

Let this process run; it may take a few minutes to generate text, so please be patient. When it completes, give the command:

SpiderOakONE --orphans=free

Again, let this process run.

On any operating system - to finish

Once you have let all of the above processes run, relaunch One. There will be a deletion action to finish clearing those orphaned data blocks. After that action finishes processing, the application should report a correct and reduced total for your space usage.

Related articles