author | Jesse Butler <jesse.butler@oracle.com> |
Wed, 20 Jul 2016 17:19:20 -0700 | |
changeset 6468 | af5d82385cd7 |
permissions | -rw-r--r-- |
6468
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
1 |
.TH "DOCKER" "1" " Docker User Manuals" "Docker Community" "JUNE 2014" "" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
2 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
3 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
4 |
.SH NAME |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
5 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
6 |
docker\-cp \- Copy files/folders between a container and the local filesystem. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
7 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
8 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
9 |
.SH SYNOPSIS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
10 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
11 |
\fBdocker cp\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
12 |
[\fB\-\-help\fP] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
13 |
CONTAINER:SRC\_PATH DEST\_PATH|\- |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
14 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
15 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
16 |
\fBdocker cp\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
17 |
[\fB\-\-help\fP] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
18 |
SRC\_PATH|\- CONTAINER:DEST\_PATH |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
19 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
20 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
21 |
.SH DESCRIPTION |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
22 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
23 |
The \fB\fCdocker cp\fR utility copies the contents of \fB\fCSRC\_PATH\fR to the \fB\fCDEST\_PATH\fR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
24 |
You can copy from the container's file system to the local machine or the |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
25 |
reverse, from the local filesystem to the container. If \fB\fC\-\fR is specified for |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
26 |
either the \fB\fCSRC\_PATH\fR or \fB\fCDEST\_PATH\fR, you can also stream a tar archive from |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
27 |
\fB\fCSTDIN\fR or to \fB\fCSTDOUT\fR. The \fB\fCCONTAINER\fR can be a running or stopped container. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
28 |
The \fB\fCSRC\_PATH\fR or \fB\fCDEST\_PATH\fR be a file or directory. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
29 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
30 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
31 |
The \fB\fCdocker cp\fR command assumes container paths are relative to the container's |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
32 |
\fB\fC/\fR (root) directory. This means supplying the initial forward slash is optional; |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
33 |
The command sees \fB\fCcompassionate\_darwin:/tmp/foo/myfile.txt\fR and |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
34 |
\fB\fCcompassionate\_darwin:tmp/foo/myfile.txt\fR as identical. Local machine paths can |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
35 |
be an absolute or relative value. The command interprets a local machine's |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
36 |
relative paths as relative to the current working directory where \fB\fCdocker cp\fR is |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
37 |
run. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
38 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
39 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
40 |
The \fB\fCcp\fR command behaves like the Unix \fB\fCcp \-a\fR command in that directories are |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
41 |
copied recursively with permissions preserved if possible. Ownership is set to |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
42 |
the user and primary group at the destination. For example, files copied to a |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
43 |
container are created with \fB\fCUID:GID\fR of the root user. Files copied to the local |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
44 |
machine are created with the \fB\fCUID:GID\fR of the user which invoked the \fB\fCdocker cp\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
45 |
command. If you specify the \fB\fC\-L\fR option, \fB\fCdocker cp\fR follows any symbolic link |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
46 |
in the \fB\fCSRC\_PATH\fR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
47 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
48 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
49 |
Assuming a path separator of \fB\fC/\fR, a first argument of \fB\fCSRC\_PATH\fR and second |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
50 |
argument of \fB\fCDEST\_PATH\fR, the behavior is as follows: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
51 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
52 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
53 |
\item \fB\fCSRC\_PATH\fR specifies a file |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
54 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
55 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
56 |
\item \fB\fCDEST\_PATH\fR does not exist |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
57 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
58 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
59 |
\item the file is saved to a file created at \fB\fCDEST\_PATH\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
60 |
\item \fB\fCDEST\_PATH\fR does not exist and ends with \fB\fC/\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
61 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
62 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
63 |
\item Error condition: the destination directory must exist. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
64 |
\item \fB\fCDEST\_PATH\fR exists and is a file |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
65 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
66 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
67 |
\item the destination is overwritten with the source file's contents |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
68 |
\item \fB\fCDEST\_PATH\fR exists and is a directory |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
69 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
70 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
71 |
\item the file is copied into this directory using the basename from |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
72 |
\fB\fCSRC\_PATH\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
73 |
\item \fB\fCSRC\_PATH\fR specifies a directory |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
74 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
75 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
76 |
\item \fB\fCDEST\_PATH\fR does not exist |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
77 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
78 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
79 |
\item \fB\fCDEST\_PATH\fR is created as a directory and the \fIcontents\fP of the source |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
80 |
directory are copied into this directory |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
81 |
\item \fB\fCDEST\_PATH\fR exists and is a file |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
82 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
83 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
84 |
\item Error condition: cannot copy a directory to a file |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
85 |
\item \fB\fCDEST\_PATH\fR exists and is a directory |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
86 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
87 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
88 |
\item \fB\fCSRC\_PATH\fR does not end with \fB\fC/.\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
89 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
90 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
91 |
\item the source directory is copied into this directory |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
92 |
\item \fB\fCSRC\_PATH\fR does end with \fB\fC/.\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
93 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
94 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
95 |
\item the \fIcontent\fP of the source directory is copied into this |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
96 |
directory |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
97 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
98 |
The command requires \fB\fCSRC\_PATH\fR and \fB\fCDEST\_PATH\fR to exist according to the above |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
99 |
rules. If \fB\fCSRC\_PATH\fR is local and is a symbolic link, the symbolic link, not |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
100 |
the target, is copied by default. To copy the link target and not the link, |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
101 |
specify the \fB\fC\-L\fR option. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
102 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
103 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
104 |
A colon (\fB\fC:\fR) is used as a delimiter between \fB\fCCONTAINER\fR and its path. You can |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
105 |
also use \fB\fC:\fR when specifying paths to a \fB\fCSRC\_PATH\fR or \fB\fCDEST\_PATH\fR on a local |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
106 |
machine, for example \fB\fCfile:name.txt\fR. If you use a \fB\fC:\fR in a local machine path, |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
107 |
you must be explicit with a relative or absolute path, for example: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
108 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
109 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
110 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
111 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
112 |
.nf |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
113 |
`/path/to/file:name.txt` or `./file:name.txt` |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
114 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
115 |
.fi |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
116 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
117 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
118 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
119 |
It is not possible to copy certain system files such as resources under |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
120 |
\fB\fC/proc\fR, \fB\fC/sys\fR, \fB\fC/dev\fR, and mounts created by the user in the container. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
121 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
122 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
123 |
Using \fB\fC\-\fR as the \fB\fCSRC\_PATH\fR streams the contents of \fB\fCSTDIN\fR as a tar archive. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
124 |
The command extracts the content of the tar to the \fB\fCDEST\_PATH\fR in container's |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
125 |
filesystem. In this case, \fB\fCDEST\_PATH\fR must specify a directory. Using \fB\fC\-\fR as |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
126 |
\fB\fCDEST\_PATH\fR streams the contents of the resource as a tar archive to \fB\fCSTDOUT\fR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
127 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
128 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
129 |
.SH OPTIONS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
130 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
131 |
\fB\-L\fP, \fB\-\-follow\-link\fP=\fItrue\fP|\fIfalse\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
132 |
Follow symbol link in SRC\_PATH |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
133 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
134 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
135 |
\fB\-\-help\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
136 |
Print usage statement |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
137 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
138 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
139 |
.SH EXAMPLES |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
140 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
141 |
Suppose a container has finished producing some output as a file it saves |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
142 |
to somewhere in its filesystem. This could be the output of a build job or |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
143 |
some other computation. You can copy these outputs from the container to a |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
144 |
location on your local host. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
145 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
146 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
147 |
If you want to copy the \fB\fC/tmp/foo\fR directory from a container to the |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
148 |
existing \fB\fC/tmp\fR directory on your host. If you run \fB\fCdocker cp\fR in your \fB\fC\~\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
149 |
(home) directory on the local host: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
150 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
151 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
152 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
153 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
154 |
.nf |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
155 |
$ docker cp compassionate\_darwin:tmp/foo /tmp |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
156 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
157 |
.fi |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
158 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
159 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
160 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
161 |
Docker creates a \fB\fC/tmp/foo\fR directory on your host. Alternatively, you can omit |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
162 |
the leading slash in the command. If you execute this command from your home |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
163 |
directory: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
164 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
165 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
166 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
167 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
168 |
.nf |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
169 |
$ docker cp compassionate\_darwin:tmp/foo tmp |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
170 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
171 |
.fi |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
172 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
173 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
174 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
175 |
If \fB\fC\~/tmp\fR does not exist, Docker will create it and copy the contents of |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
176 |
\fB\fC/tmp/foo\fR from the container into this new directory. If \fB\fC\~/tmp\fR already |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
177 |
exists as a directory, then Docker will copy the contents of \fB\fC/tmp/foo\fR from |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
178 |
the container into a directory at \fB\fC\~/tmp/foo\fR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
179 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
180 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
181 |
When copying a single file to an existing \fB\fCLOCALPATH\fR, the \fB\fCdocker cp\fR command |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
182 |
will either overwrite the contents of \fB\fCLOCALPATH\fR if it is a file or place it |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
183 |
into \fB\fCLOCALPATH\fR if it is a directory, overwriting an existing file of the same |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
184 |
name if one exists. For example, this command: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
185 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
186 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
187 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
188 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
189 |
.nf |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
190 |
$ docker cp sharp\_ptolemy:/tmp/foo/myfile.txt /test |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
191 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
192 |
.fi |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
193 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
194 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
195 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
196 |
If \fB\fC/test\fR does not exist on the local machine, it will be created as a file |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
197 |
with the contents of \fB\fC/tmp/foo/myfile.txt\fR from the container. If \fB\fC/test\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
198 |
exists as a file, it will be overwritten. Lastly, if \fB\fC/test\fR exists as a |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
199 |
directory, the file will be copied to \fB\fC/test/myfile.txt\fR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
200 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
201 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
202 |
Next, suppose you want to copy a file or folder into a container. For example, |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
203 |
this could be a configuration file or some other input to a long running |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
204 |
computation that you would like to place into a created container before it |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
205 |
starts. This is useful because it does not require the configuration file or |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
206 |
other input to exist in the container image. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
207 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
208 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
209 |
If you have a file, \fB\fCconfig.yml\fR, in the current directory on your local host |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
210 |
and wish to copy it to an existing directory at \fB\fC/etc/my\-app.d\fR in a container, |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
211 |
this command can be used: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
212 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
213 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
214 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
215 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
216 |
.nf |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
217 |
$ docker cp config.yml myappcontainer:/etc/my\-app.d |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
218 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
219 |
.fi |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
220 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
221 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
222 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
223 |
If you have several files in a local directory \fB\fC/config\fR which you need to copy |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
224 |
to a directory \fB\fC/etc/my\-app.d\fR in a container: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
225 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
226 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
227 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
228 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
229 |
.nf |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
230 |
$ docker cp /config/. myappcontainer:/etc/my\-app.d |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
231 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
232 |
.fi |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
233 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
234 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
235 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
236 |
The above command will copy the contents of the local \fB\fC/config\fR directory into |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
237 |
the directory \fB\fC/etc/my\-app.d\fR in the container. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
238 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
239 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
240 |
Finally, if you want to copy a symbolic link into a container, you typically |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
241 |
want to copy the linked target and not the link itself. To copy the target, use |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
242 |
the \fB\fC\-L\fR option, for example: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
243 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
244 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
245 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
246 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
247 |
.nf |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
248 |
$ ln \-s /tmp/somefile /tmp/somefile.ln |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
249 |
$ docker cp \-L /tmp/somefile.ln myappcontainer:/tmp/ |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
250 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
251 |
.fi |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
252 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
253 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
254 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
255 |
This command copies content of the local \fB\fC/tmp/somefile\fR into the file |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
256 |
\fB\fC/tmp/somefile.ln\fR in the container. Without \fB\fC\-L\fR option, the \fB\fC/tmp/somefile.ln\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
257 |
preserves its symbolic link but not its content. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
258 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
259 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
260 |
.SH HISTORY |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
261 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
262 |
April 2014, Originally compiled by William Henry (whenry at redhat dot com) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
263 |
based on docker.com source material and internal work. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
264 |
June 2014, updated by Sven Dowideit |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
265 |
\[la][email protected]\[ra] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
266 |
May 2015, updated by Josh Hawn |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
267 |
\[la][email protected]\[ra] |