mirror of
https://github.com/containers/podman.git
synced 2025-07-17 17:43:23 +08:00
f0e8640755
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>
56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
% podman-logout(1)
|
|
|
|
## NAME
|
|
podman\-logout - Logout of a container registry
|
|
|
|
## SYNOPSIS
|
|
**podman logout** [*options*] *registry*
|
|
|
|
## DESCRIPTION
|
|
**podman logout** logs out of a specified registry server by deleting the cached credentials
|
|
stored in the **auth.json** file. If the registry is not specified, the first registry under [registries.search]
|
|
from registries.conf will be used. The path of the authentication file can be overridden by the user by setting the **authfile** flag.
|
|
The default path used is **${XDG\_RUNTIME\_DIR}/containers/auth.json**. For more details about format and configurations of the auth,json file, please refer to containers-auth.json(5)
|
|
All the cached credentials can be removed by setting the **all** flag.
|
|
|
|
**podman [GLOBAL OPTIONS]**
|
|
|
|
**podman logout [GLOBAL OPTIONS]**
|
|
|
|
**podman logout [OPTIONS] REGISTRY [GLOBAL OPTIONS]**
|
|
|
|
## OPTIONS
|
|
|
|
#### **--all**, **-a**
|
|
|
|
Remove the cached credentials for all registries in the auth file
|
|
|
|
@@option authfile
|
|
|
|
#### **--help**, **-h**
|
|
|
|
Print usage statement
|
|
|
|
## EXAMPLES
|
|
|
|
```
|
|
$ podman logout docker.io
|
|
Remove login credentials for https://registry-1.docker.io/v2/
|
|
```
|
|
|
|
```
|
|
$ podman logout --authfile authdir/myauths.json docker.io
|
|
Remove login credentials for https://registry-1.docker.io/v2/
|
|
```
|
|
|
|
```
|
|
$ podman logout --all
|
|
Remove login credentials for all registries
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-login(1)](podman-login.1.md)**, **[containers-auth.json(5)](https://github.com/containers/image/blob/main/docs/containers-auth.json.5.md)**
|
|
|
|
## HISTORY
|
|
August 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>
|