.TH "datalad ls" "1" "2021\-07\-23" "datalad ls 0.14.6"
.SH NAME
\fBdatalad ls\fR \- list summary information about URLs and dataset(s)
.SH SYNOPSIS
.nh
.HP
\fBdatalad ls\fR [-h] [-r] [-F] [-a] [-L] [--config-file\~CONFIG_FILE] [--list-content {None,first10,md5,full}] [--json {file,display,delete}] [PATH/URL ...]


.hy
.SH DESCRIPTION

ATM only s3:// URLs and datasets are supported
.PP
Examples:
.PP
$ datalad ls s3://openfmri/tarballs/ds202  # to list S3 bucket
$ datalad ls                               # to list current dataset
.SH OPTIONS
.TP
PATH/URL
URL or path to list, e.g. s3://... Constraints: value must be a string

.TP
\fB-h\fR, \fB--help\fR, \fB--help-np\fR
show this help message. --help-np forcefully disables the use of a pager for displaying the help message
.TP
\fB-r\fR, \fB--recursive\fR
recurse into subdirectories.
.TP
\fB-F\fR, \fB--fast\fR
only perform fast operations. Would be overridden by --all.
.TP
\fB-a\fR, \fB--all\fR
list all (versions of) entries, not e.g. only latest entries in case of S3.
.TP
\fB-L\fR, \fB--long\fR
list more information on entries (e.g. acl, urls in s3, annex sizes etc).
.TP
\fB--config-file\fR \fI\s-1CONFIG_FILE\s0\fR
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
.TP
\fB--list-content\fR {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]
.TP
\fB--json\fR {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.
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.