man7.org > Linux > man-pages

Linux/UNIX system programming training

getpcaps(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | REPORTING BUGS | SEE ALSO | AUTHOR | COLOPHON 

GETPCAPS(8)              System Manager's Manual              GETPCAPS(8)

NAME         top

       getpcaps - display process capabilities

SYNOPSIS         top

       getpcaps [optional args] pid...

DESCRIPTION         top

       getpcaps displays the capabilities on the processes indicated by
       the pid value(s) given on the command line.  A pid of 0 displays
       the capabilities of the process that is running getpcaps itself.

       The capability Set of the process is displayed in the text
       represenation described here: cap_text_formats(7).

       Optional arguments:

       --help or --usage
              Displays usage information and exits.

       --ugly or --legacy
              Displays output in a somewhat ugly legacy format.

       --verbose
              Displays usage in a legacy-like format but not quite so
              ugly in modern default terminal fonts.

       --iab  Displays IAB tuple capabilities from the process. The
              output format here is also described in
              cap_text_formats(7).  Double quotes encase the regular
              process capabilities and square brackets encase the IAB
              tuple. This format is also used by captree(8).

REPORTING BUGS         top

       Please report bugs via:

       https://bugzilla.kernel.org/buglist.cgi?component=libcap&list_id=1090757

SEE ALSO         top

       capsh(1), cap_from_text(3), cap_iab(3), cap_text_format(7),
       capabilities(7), captree(8), getcap(8), and setcap(8).

AUTHOR         top

       This manual page was originally written by Robert Bihlmeyer
       <robbe@debian.org>, for the Debian GNU/Linux system (but may be
       used by others).

COLOPHON         top

       This page is part of the libcap (capabilities commands and
       library) project.  Information about the project can be found at
       ⟨https://git.kernel.org/pub/scm/libs/libcap/libcap.git/⟩.  If you
       have a bug report for this manual page, send it to
       morgan@kernel.org (please put "libcap" in the Subject line).  This
       page was obtained from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/libs/libcap/libcap.git/⟩ on
       2025-08-11.  (At that time, the date of the most recent commit
       that was found in the repository was 2025-08-10.)  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

                                2025-03-19                    GETPCAPS(8)

Pages that refer to this page: capsh(1),  libcap(3),  capabilities(7),  getcap(8),  setcap(8)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI