summaryrefslogtreecommitdiff
path: root/docs/podman-build.1.md
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2018-12-31 08:23:29 -0800
committerGitHub <noreply@github.com>2018-12-31 08:23:29 -0800
commit7438b7bd3afb9e5a0fc761fdc8532cd697f2187b (patch)
treee87a117fa185f8d7402cbecc06dfbeb75320c7b9 /docs/podman-build.1.md
parent1aa55edda50df507c7fa8a2a50b67d7fd65a4ef5 (diff)
parentad36345fde0913a098b64d0c628f562134d1675b (diff)
downloadpodman-7438b7bd3afb9e5a0fc761fdc8532cd697f2187b.tar.gz
podman-7438b7bd3afb9e5a0fc761fdc8532cd697f2187b.tar.bz2
podman-7438b7bd3afb9e5a0fc761fdc8532cd697f2187b.zip
Merge pull request #2052 from rhatdan/sparse
Add troubleshooting for sparse files
Diffstat (limited to 'docs/podman-build.1.md')
-rw-r--r--docs/podman-build.1.md10
1 files changed, 9 insertions, 1 deletions
diff --git a/docs/podman-build.1.md b/docs/podman-build.1.md
index f887d68cd..76e16b42c 100644
--- a/docs/podman-build.1.md
+++ b/docs/podman-build.1.md
@@ -614,8 +614,16 @@ $ podman build -f dev/Dockerfile https://10.10.10.1/podman/context.tar.gz
registries.conf is the configuration file which specifies which container registries should be consulted when completing image names which do not include a registry or domain portion.
+## Troubleshooting
+
+If you are using a useradd command within a Dockerfile with a large UID/GID, it will create a large sparse file `/var/log/lastlog`. This can cause the build to hang forever. Go language does not support sparse files correctly, which can lead to some huge files being created in your container image.
+
+### Solution
+
+If you are using `useradd` within your build script, you should pass the `--no-log-init or -l` option to the `useradd` command. This option tells useradd to stop creating the lastlog file.
+
## SEE ALSO
-podman(1), buildah(1), containers-registries.conf(5)
+podman(1), buildah(1), containers-registries.conf(5), useradd(8)
## HISTORY
May 2018, Minor revisions added by Joe Doss <joe@solidadmin.com>