Man pages sections > man1 > datalad-uninstall

datalad-uninstall

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

SYNOPSIS


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 ...]]
 
 

DESCRIPTION

Uninstall a dataset component or entire dataset(s)

OPTIONS


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]
--dont-remove-data
whether to drop data associated with matching file
handles during uninstallation. This option prevents
data from being dropped. [Default: True]
--remove-handles
if given, matching file handles are removed. This flag
is required for deleting entire datasets. [Default:
False]
-r, --recursive
if set, recurse into potential subdataset. [Default:
False]
--remove-history
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']

AUTHORS


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