flatpak-ps(1) — Linux manual page

FLATPAK PS(1)                  flatpak ps                  FLATPAK PS(1)

NAME

       flatpak-ps - Enumerate running instances

SYNOPSIS

       flatpak ps [OPTION...]

DESCRIPTION

       Lists useful information about running Flatpak instances.

       To see full details of a running instance, you can open the file
       /run/user/$UID/.flatpak/$INSTANCE/info, where $INSTANCE is the
       instance ID reported by flatpak ps.

OPTIONS

       The following options are understood:

       -h, --help
           Show help options and exit.

       -v, --verbose
           Print debug information during command processing.

       --ostree-verbose
           Print OSTree debug information during command processing.

       --columns=FIELD,...
           Specify what information to show about each instance. You can
           list multiple fields, or use this option multiple times.

           Append :s[tart], :m[iddle], :e[nd] or :f[ull] to column names
           to change ellipsization.

FIELDS

       The following fields are understood by the --columns option:

       instance
           Show the instance ID

       application
           Show the application ID

       arch
           Show the architecture

       branch
           Show the application branch

       commit
           Show the application commit

       runtime
           Show the runtime ID

       runtime-branch
           Show the runtime branch

       runtime-commit
           Show the runtime commit

       pid
           Show the PID of the wrapper process

       child-pid
           Show the PID of the sandbox process

       active
           Show whether the app is active (i.e. has an active window)

       background
           Show whether the app is in the background (with no open
           windows)

       all
           Show all columns

       help
           Show the list of available columns

       Note that field names can be abbreviated to a unique prefix.

EXAMPLES

       $ flatpak ps --columns=application,pid,runtime,runtime-branch

SEE ALSO

       flatpak(1), flatpak-run(1)

COLOPHON

       This page is part of the flatpak (a tool for building and
       distributing desktop applications on Linux) project.  Information
       about the project can be found at ⟨http://flatpak.org/⟩.  It is
       not known how to report bugs for this man page; if you know,
       please send a mail to man-pages@man7.org.  This page was obtained
       from the project's upstream Git repository
       ⟨https://github.com/flatpak/flatpak⟩ on 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-06-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

flatpak                                                    FLATPAK PS(1)

Pages that refer to this page: flatpak-enter(1), flatpak-kill(1)

---