Merge pull request #6773 from markstos/issue-6756-improve-inspect-docs

docs: recommend alternatives to podman inspect
This commit is contained in:
OpenShift Merge Robot 2020-06-30 12:35:32 -04:00 committed by GitHub
commit 6fbd1570f8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 24 additions and 8 deletions

View File

@ -8,12 +8,22 @@ import (
) )
var ( var (
inspectDescription = `Displays the low-level information on an object identified by name or ID.
For more inspection options, see:
podman container inspect
podman image inspect
podman network inspect
podman pod inspect
podman volume inspect`
// Command: podman _inspect_ Object_ID // Command: podman _inspect_ Object_ID
inspectCmd = &cobra.Command{ inspectCmd = &cobra.Command{
Use: "inspect [flags] {CONTAINER_ID | IMAGE_ID} [...]", Use: "inspect [flags] {CONTAINER_ID | IMAGE_ID} [...]",
Short: "Display the configuration of object denoted by ID", Short: "Display the configuration of object denoted by ID",
Long: "Displays the low-level information on an object identified by name or ID", RunE: inspectExec,
RunE: inspectExec, Long: inspectDescription,
TraverseChildren: true,
Example: `podman inspect fedora Example: `podman inspect fedora
podman inspect --type image fedora podman inspect --type image fedora
podman inspect CtrID ImgID podman inspect CtrID ImgID

View File

@ -6,15 +6,21 @@ podman\-inspect - Display a container or image's configuration
## SYNOPSIS ## SYNOPSIS
**podman inspect** [*options*] *name* [...] **podman inspect** [*options*] *name* [...]
**podman image inspect** [*options*] *image*
**podman container inspect** [*options*] *container*
## DESCRIPTION ## DESCRIPTION
This displays the low-level information on containers and images identified by name or ID. By default, this will render This displays the low-level information on containers and images identified by name or ID. By default, this will render
all results in a JSON array. If the container and image have the same name, this will return container JSON for all results in a JSON array. If the container and image have the same name, this will return container JSON for
unspecified type. If a format is specified, the given template will be executed for each result. unspecified type. If a format is specified, the given template will be executed for each result.
For more inspection options, see:
podman container inspect
podman image inspect
podman network inspect
podman pod inspect
podman volume inspect
## OPTIONS ## OPTIONS
**--type**, **-t**=*type* **--type**, **-t**=*type*