docs/src/list.md

Sun, 17 Dec 2023 14:25:34 +0100

author
Mike Becker <universe@uap-core.de>
date
Sun, 17 Dec 2023 14:25:34 +0100
changeset 797
edbb20b1438d
parent 320
12ed560c926c
permissions
-rw-r--r--

[Makefile] fix missing rules preventing dry-runs

We have to support dry-runs, because many IDEs are using
dry-runs to collect build information.

Some rules have dependencies that expect certain files or
directories to be just present. We added respective build
rules which invoke the test program. This way, the behavior
when running make normally is exactly the same, but dry-runs
are also not failing now.

---
title: 'dav list'
---

**`dav list [-altdepcR] [-u <date>] <url>`**

Lists child resources of the specified collection. Without any option it
shows only the direct children and hides files beginning with a dot.
The behavior is quite similar to that of the unix tool `ls`.

Options
-------

**`-a`** don't hide files whose names begin with a dot `.`

**`-l`** show additional information for resources

Example:

	--     4.2 KiB  Oct 11  2015  somefile

The first column contains to fields for flags.

1. Field: `d-` indicates a collection
2. Field: `-c` indicates an encrypted resource

Encrypted collections are also possible, but only the collection name is encrypted, the content may be unencrypted.

The second column in the `list -l` output is the resource size. The number has always a suffix (bytes, KiB, MiB, GiB, TiB). To get the exact content-length in bytes you can use the [dav info][1] command.

[1]: ./info.html

The third column is the date of the last modification. The `strftime` format is `%b %d %H:%M` if the year is the current year. Otherwise the format is `%b %d  %Y`.

The last column is the resource name. If the `-R` option is specified, the resource path is shown.

**`-t`** this options only works in combination with `-l` and it adds the resource content type to the output (after the flags)

**`-d`** order resources by their lastmodified date

**`-e`** similar to `-l`, but with 6 flag fields. Currently only the first 4 fields are used. The last two are reserved for future use.

1. Field: `d---` indicates a collection
2. Field: `-c--` indicates an encrypted resource
3. Field: `--l-` indicates a locked resource
4. Field: `---x` indicates an executable resource (executable property with http://apache.org/dav/props/ namespace)

All combinations of these four flags are possible.

**`-p`** disable file name and path decryption if enabled

**`-c`** enable file name and path decryption

**`-R`** recursively show all resources in the collection and all child collections

**`-u <date>`** show only resources with a `lastmodified` date after the specified
  date. Uses the HTTP date format.

**Command alias:** ls

mercurial