Man pages sections > man1 > datalad-uninstall


datalad-uninstall(1) General Commands Manual datalad-uninstall(1)


datalad-uninstall [--version] [-h] [-l LEVEL] [-p {condor}] [-d DATASET]
[--dont-remove-data] [--remove-handles] [-r]
[--remove-history] [--nocheck] [--kill]
[--if-dirty {fail,save-before,ignore}]
[PATH [PATH ...]]


Uninstall a dataset component or entire dataset(s)


PATH path/name of the component to be uninstalled.
Constraints: value must be a string [Default: None]

--version show the program's version and license information
-h, --help, --help-np
show this help message. --help-np forcefully disables
the use of a pager for displaying the help message
-l LEVEL, --log-level LEVEL
set logging verbosity level. Choose among critical,
error, warning, info, debug. Also you can specify an
integer <10 to provide even more debugging information
-p {condor}, --pbs-runner {condor}
execute command by scheduling it via available PBS.
For settings, config file will be consulted
-d DATASET, --dataset DATASET
specify the dataset to perform the uninstall operation
on. If no dataset is given, an attempt is made to
identify the dataset based on the current working
directory and/or the PATH given. Constraints: Value
must be a Dataset or a valid identifier of a Dataset
(e.g. a path) [Default: None]
whether to drop data associated with matching file
handles during uninstallation. This option prevents
data from being dropped. [Default: True]
if given, matching file handles are removed. This flag
is required for deleting entire datasets. [Default:
-r, --recursive
if set, recurse into potential subdataset. [Default:
whether to permit operations that remove recorded
dataset history, for example when removing entire
datasets completely. Such changes are not recoverable,
use with care. [Default: False]
--nocheck whether to perform checks to assure the configured
minimum number (remote) source for data to be
uninstalled. Give this option to skip checks.
[Default: True]
--kill **WARNING -- extremely dangerous**. It will simply
force remove, without consideration of being a
dataset, a file, or a directory or any other option
given to uninstall. To be used only with full
awareness of its consequences. [Default: False]
--if-dirty {fail,save-before,ignore}
desired behavior if a dataset with unsaved changes is
discovered: 'fail' will trigger an error and further
processing is aborted; 'save-before' will save all
changes prior any further action; 'ignore' let's
datalad proceed as if the dataset would not have
unsaved changes. [Default: 'save-before']


datalad is developed by The DataLad Team and Contributors <>.
2016-11-10 datalad-uninstall 0.4.1