podman-pod-top(1)

💅 podman-pod-top(1) — General Commands Manual, bestie edition 🎀

okay so you found the podman-pod-top page in the General Commands Manual and honestly? it's giving "who is running what inside my pod" and I'm obsessed. let's get into it 🫶

---

✨ NAME ✨

podman-pod-top — Display the running processes of containers in a pod

like literally it shows you the processes chugging along inside the containers of a pod. main character surveillance energy 👑

---

🌸 SYNOPSIS 🌸

podman pod top [options] pod [format-descriptors]

---

💖 DESCRIPTION 💖

Display the running processes of containers in a pod. that's the whole vibe 💅

now, the format-descriptors? they're ps(1)-compatible AIX format descriptors, but lowkey extended so they can also print extra info — like the seccomp mode or the effective capabilities of a given process. fancy fr fr ✨

and here's the cute part: you can pass those descriptors either as separate arguments or as a single comma-separated argument. dealer's choice, bestie 🎀

---

✨ OPTIONS ✨

• --help, -h — Print usage statement. the classic "help me pls" move 🙈
• --latest, -l — Instead of providing the pod name or ID, use the last created pod. note that the last started pod can be from other users of Podman on the host machine 👀 (and heads up: this option is not available with the remote Podman client, including Mac and Windows machines — excluding WSL2 💀)

---

🦋 FORMAT DESCRIPTORS 🦋

For a full list of available descriptors, see podman-top(1). yeah go read that one, it's the source of truth 💜

---

🌈 EXAMPLES 🌈

Print top data for the specified pod 🍓

By default, podman-pod-top prints data similar to ps -ef:

$ podman pod top b031293491cc
USER   PID   PPID   %CPU    ELAPSED             TTY   TIME   COMMAND
root   1     0      0.000   2h5m38.737137571s   ?     0s     top
root   8     0      0.000   2h5m15.737228361s   ?     0s     top

and the output can be controlled by specifying format descriptors as arguments after the pod. you're the director of this movie, bestie 🎬

Print specific fields on the latest pod 💫

Print the pod top data fields pid, seccomp, args and %C on the latest pod created. (This -l option is not available with the remote Podman client, including Mac and Windows machines — excluding WSL2)

$ podman pod top -l pid seccomp args %C
PID   SECCOMP   COMMAND   %CPU
1     filter    top       0.000
1     filter    /bin/sh   0.000

ate. no crumbs. 🔥

---

👑 SEE ALSO 👑

podman(1), podman-pod(1), ps(1), seccomp(2), proc(5), capabilities(7)

go read those too, they're the friend group 🫶

---

📜 HISTORY 📜

August 2018, Originally compiled by Peter Hunt pehunt@redhat.com ⟨mailto:pehunt@redhat.com⟩ — thank you Peter, iconic behavior 💖

---

and that's the whole page, bestie!! this was podman-pod-top(1) from the General Commands Manual, footer says podman-pod-top(1) — so like, go peek at your pods' processes and slay 💅✨🌈