Man pages sections > man1 > datalad-ls


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


datalad-ls [--version] [-h] [-l LEVEL] [-p {condor}] [-r] [-F] [-a] [-L]
[--config-file CONFIG_FILE]
[--list-content {None,first10,md5,full}]
[--json {file,display,delete}]


List summary information about URLs and dataset(s)
ATM only s3:// URLs and datasets are supported

$ datalad ls s3://openfmri/tarballs/ds202 # to list S3 bucket

$ datalad ls # to list current dataset


PATH/URL URL or path to list, e.g. s3://... Constraints: value
must be a string

--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
-r, --recursive
recurse into subdirectories. [Default: False]
-F, --fast
only perform fast operations. Would be overridden by
--all. [Default: False]
-a, --all
list all (versions of) entries, not e.g. only latest
entries in case of S3. [Default: False]
-L, --long
list more information on entries (e.g. acl, urls in
s3, annex sizes etc). [Default: False]
--config-file CONFIG_FILE
path to config file which could help the 'ls'. E.g.
for s3:// URLs could be some ~/.s3cfg file which would
provide credentials. Constraints: value must be a
string [Default: None]
--list-content {None,first10,md5,full}
list also the content or only first 10 bytes
(first10), or md5 checksum of an entry. Might require
expensive transfer and dump binary output to your
screen. Do not enable unless you know what you are
after. [Default: False]
--json {file,display,delete}
metadata json of dataset for creating web user
interface. display: prints jsons to stdout or file:
writes each subdir metadata to json file in subdir of
dataset or delete: deletes all metadata json files in
dataset. [Default: None]


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