diff options
author | Ed Santiago <santiago@redhat.com> | 2022-08-16 07:35:18 -0600 |
---|---|---|
committer | Ed Santiago <santiago@redhat.com> | 2022-08-16 09:13:38 -0600 |
commit | f0e8640755569ba7da803f7c8f4589953939fad0 (patch) | |
tree | 30d31d6280c42c304184fb8224028e59be001361 /docs/source/markdown/options | |
parent | 3dace12777e27a7732acb25ae78f86ced8ae04da (diff) | |
download | podman-f0e8640755569ba7da803f7c8f4589953939fad0.tar.gz podman-f0e8640755569ba7da803f7c8f4589953939fad0.tar.bz2 podman-f0e8640755569ba7da803f7c8f4589953939fad0.zip |
Man pages: refactor common options: authfile
Refactor the --authfile option.
My suggestion for review:
1) run hack/markdown-preprocess-review and immediately Ctrl-Q to
quit out of diffuse, which is completely unusable for this
many files; then
2) cd /tmp/markdown-preprocess-review.diffs/authfile
- this is the directory created by the review script
3) rm podman-image-sign* podman-log* podman-search.1.md.in
- because they're essentially identical to podman-create
4) rm podman-manifest-* podman-push.*
- because they're 100% identical to podman-kube-play
5) rm podman-kube-play*
- because it's apart-from-whitespace identical to podman-build
(use "wdiff" to confirm)
6) rm podman-auto-update*
- because that's the one I chose (hence == zzz-chosen.md)
(You should obviously run your own diff/cmp before rm, to confirm
my assertions about which files are identical).
After all that, you have a manageable number of files which
you can scan, read, diff against zzz-chosen.md, even run diffuse.
This option is IMHO the poster child for why we need this kind
of man page refactoring.
Signed-off-by: Ed Santiago <santiago@redhat.com>
Diffstat (limited to 'docs/source/markdown/options')
-rw-r--r-- | docs/source/markdown/options/authfile.md | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/source/markdown/options/authfile.md b/docs/source/markdown/options/authfile.md new file mode 100644 index 000000000..d6198aa24 --- /dev/null +++ b/docs/source/markdown/options/authfile.md @@ -0,0 +1,6 @@ +#### **--authfile**=*path* + +Path of the authentication file. Default is `${XDG_RUNTIME_DIR}/containers/auth.json`, which is set using **[podman login](podman-login.1.md)**. +If the authorization state is not found there, `$HOME/.docker/config.json` is checked, which is set using **docker login**. + +Note: There is also the option to override the default path of the authentication file by setting the `REGISTRY_AUTH_FILE` environment variable. This can be done with **export REGISTRY_AUTH_FILE=_path_**. |