https://github.com/jftuga/dls
Docker ls - list files within a container
https://github.com/jftuga/dls
Last synced: 8 months ago
JSON representation
Docker ls - list files within a container
- Host: GitHub
- URL: https://github.com/jftuga/dls
- Owner: jftuga
- License: mit
- Created: 2020-04-16T19:18:50.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-04-20T13:00:25.000Z (about 6 years ago)
- Last Synced: 2025-03-24T18:50:44.144Z (about 1 year ago)
- Language: Go
- Size: 25.4 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dls
docker ls - list files within a container
## Description
This program is used to view what files and directories reside inside a running docker container. This program is most useful when using the
[Scratch](https://hub.docker.com/_/scratch) docker image or when `ls` is not provided.
It is also helpful when using an image / container that you are not familiar with.
In your `Dockerfile`,
you will need to `ADD` or `COPY` a **statically linked** `dls` binary *(see below)*.
## Usage
```
dls: Get file info for a directory
usage: dls [directory]
-a show all files, including .git, dev, proc, and sys
-b show in bare format, eg: no tables
-e show file/directory errors
-t show total file size of all files
-v show version and then exit
Current directory is the default if no other directory is given on cmd-line
```
## Example
* dls.exe -t
```
+-----------+---------------------+------+------------------------+
| SIZE | MOD TIME | TYPE | NAME (FILES:11 DIRS:2) |
+-----------+---------------------+------+------------------------+
| 1086 | 2020-04-16 15:21:34 | F | LICENSE |
| 50 | 2020-04-16 15:21:34 | F | README.md |
| 4525 | 2020-04-16 23:12:31 | F | cmd.go |
| 3209728 | 2020-04-16 23:12:39 | F | dls.exe |
| 81 | 2020-04-16 23:09:12 | F | osver_darwin.go |
| 82 | 2020-04-16 23:10:13 | F | osver_freebsd.go |
| 80 | 2020-04-16 23:09:47 | F | osver_linux.go |
| 964 | 2020-04-16 23:05:04 | F | osver_windows.go |
| 0 | 2020-04-16 23:15:46 | D | test1\ |
| 351 | 2020-04-16 23:15:41 | F | test1\file1.txt |
| 856 | 2020-04-16 23:15:46 | F | test1\file2.txt |
| 0 | 2020-04-16 23:16:03 | D | test2\ |
| 581 | 2020-04-16 23:16:04 | F | test2\file3.txt |
| --------- | ------------------- | - | --------------- |
| | 3218384 | | (total size) |
| | 3.07 | | (MB total size) |
+-----------+---------------------+------+------------------------+
```
* dls.exe -b
```
LICENSE
README.md
cmd.go
dls.exe
osver_darwin.go
osver_freebsd.go
osver_linux.go
osver_windows.go
test1\
test1\file1.txt
test1\file2.txt
test2\
test2\file3.txt
```
## Docker
### Static Binary Complication
| Platform | Command
----------|-----
| windows | go build -tags netgo -ldflags "-extldflags -static"
| linux/bsd | go build -tags netgo -ldflags '-extldflags "-static" -s -w'
| macos | go build -ldflags '-s -extldflags "-sectcreate __TEXT __info_plist Info.plist"'
| android | go build -ldflags -s
**NOTE:** *I have not been able to test all of these*
### Windows
* You will need to use `nanoserver` with a matching OS version: [Docker Image List](https://hub.docker.com/_/microsoft-windows-nanoserver)
* * Running `dls -v` will return your specific `OS build`
* Example for Windows 10 LTSC Build 1809:
* * `docker pull mcr.microsoft.com/windows/nanoserver:10.0.17763.1158`
### Linux
* Remember to create a static version of the binary
* `dls` can be started from the [Docker Scratch Image](https://hub.docker.com/_/scratch)
### References
* [Building Minimal Docker Containers for Go Applications](https://rollout.io/blog/building-minimal-docker-containers-for-go-applications/)
* ["Distroless" Docker Images](https://github.com/GoogleContainerTools/distroless)
* [Statically compiling Go programs](https://www.arp242.net/static-go.html)