From 41a5e0e4dfb650688ca71a819669611be4159b5e Mon Sep 17 00:00:00 2001 From: Nicolas De Loof Date: Wed, 9 Mar 2022 11:14:58 +0100 Subject: [PATCH] improve cp documentation with some illustration examples Signed-off-by: Nicolas De Loof --- docs/reference/commandline/cp.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/reference/commandline/cp.md b/docs/reference/commandline/cp.md index 397d6eadc2..f94fe5ef14 100644 --- a/docs/reference/commandline/cp.md +++ b/docs/reference/commandline/cp.md @@ -89,6 +89,28 @@ you must be explicit with a relative or absolute path, for example: `/path/to/file:name.txt` or `./file:name.txt` +## Examples + +Copy a local file into container + +```console +$ docker cp ./some_file CONTAINER:/work +``` + +Copy files from container to local path + +```console +$ docker cp CONTAINER:/var/logs/ /tmp/app_logs +``` + +Copy a file from container to stdout. Please note `cp` command produces a tar stream + +```console +$ docker cp CONTAINER:/var/logs/app.log - | tar x -O | grep "ERROR" +``` + +### Corner cases + It is not possible to copy certain system files such as resources under `/proc`, `/sys`, `/dev`, [tmpfs](run.md#mount-tmpfs---tmpfs), and mounts created by the user in the container. However, you can still copy such files by manually