Add crane recipe for listing files, add note about symlinks (#1072)

google · Jul 9, 2021 · b448aba · b448aba
1 parent 628a2ff
commit b448aba
Showing 1 changed file with 7 additions and 1 deletion.
diff --git a/cmd/crane/recipes.md b/cmd/crane/recipes.md
@@ -2,13 +2,19 @@
 
 Useful tips and things you can do with `crane` and other standard tools.
 
+### List files in an image
+
+```
+crane export ubuntu - | tar -tvf - | less
+```
+
 ### Extract a single file from an image
 
 ```
 crane export ubuntu - | tar -Oxf - etc/passwd
 ```
 
-Note: Be sure to remove the leading `/` from the path (not `/etc/passwd`)
+Note: Be sure to remove the leading `/` from the path (not `/etc/passwd`). This behavior will not follow symlinks.
 
 ### Bundle directory contents into an image