summaryrefslogtreecommitdiff
path: root/docs/source/markdown/podman-completion.1.md
blob: 4ebe4e2e1e727e955f8a936c97de242d9ce36aba (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
% podman-completion(1)

## NAME
podman\-completion - Generate shell completion scripts

## SYNOPSIS
**podman completion** [*options*] *bash*|*zsh*|*fish*|*powershell*

## DESCRIPTION
The completion command generates shell completion scripts for a variety of shells. Supported shells are **bash**, **zsh**, **fish** and **powershell**.

These script are used by the shell to provide suggestions and complete commands when you are typing the command and press [TAB].

Usually these scripts are automatically installed via the package manager.

## OPTIONS
#### **--file**, **-f**

Write the generated output to file.

#### **--no-desc**

Do not provide description in the completions.

## Installation

### BASH
Make sure you have `bash-completion` installed on the system.

To load the completion script into the current session run:
`source <(podman completion bash)`

To make it available for all bash sessions run:
`podman completion bash -f /etc/bash_completion.d/podman`


### ZSH
If shell completion is not already enabled in the environment you will need to enable it. You can execute the following once:
`echo "autoload -U compinit; compinit" >> ~/.zshrc`

To make it available for all zsh sessions run:
`podman completion zsh -f "${fpath[1]}/_podman"`

Once you reload the shell the auto-completion should be working.


### FISH
To load the completion script into the current session run:
`podman completion fish | source`

To make it available for all fish sessions run:
`podman completion fish -f ~/.config/fish/completions/podman.fish`

### POWERSHELL
To load the completion script into the current session run:
`podman.exe completion powershell | Out-String | Invoke-Expression`

To make it available in all powershell sessions that a user has, write the
completion output to a file and source that to the user's powershell profile.
More information about profiles is available with `Get-Help about_Profiles`.

## SEE ALSO
[podman(1)](podman.1.md)