| 1 |
.\" Hey, EMACS: -*- nroff -*- |
| 2 |
.TH GETPCAPS 8 "2025-03-19" |
| 3 |
.\" Please adjust this date whenever revising the manpage. |
| 4 |
.SH NAME |
| 5 |
getpcaps \- display process capabilities |
| 6 |
.SH SYNOPSIS |
| 7 |
.BR getpcaps " [optional args]" |
| 8 |
.IR pid ... |
| 9 |
.SH DESCRIPTION |
| 10 |
.B getpcaps |
| 11 |
displays the capabilities on the processes indicated by the |
| 12 |
.I pid |
| 13 |
value(s) given on the command line. |
| 14 |
A |
| 15 |
.I pid |
| 16 |
of 0 displays the capabilities of the process that is running |
| 17 |
.B getpcaps |
| 18 |
itself. |
| 19 |
.PP |
| 20 |
The capability Set of the process is displayed in |
| 21 |
the text represenation described here: |
| 22 |
.BR cap_text_formats (7). |
| 23 |
.PP |
| 24 |
Optional arguments: |
| 25 |
.TP |
| 26 |
.BR \-\-help " or " \-\-usage |
| 27 |
Displays usage information and exits. |
| 28 |
.TP |
| 29 |
.BR \-\-ugly " or " \-\-legacy |
| 30 |
Displays output in a somewhat ugly legacy format. |
| 31 |
.TP |
| 32 |
.B \-\-verbose |
| 33 |
Displays usage in a legacy-like format but not quite so ugly in modern |
| 34 |
default terminal fonts. |
| 35 |
.TP |
| 36 |
.B \-\-iab |
| 37 |
Displays IAB tuple capabilities from the process. The output format |
| 38 |
here is also described in |
| 39 |
.BR cap_text_formats (7). |
| 40 |
Double quotes encase the regular process capabilities and square |
| 41 |
brackets encase the IAB tuple. This format is also used by |
| 42 |
.BR captree (8). |
| 43 |
.SH "REPORTING BUGS" |
| 44 |
Please report bugs via: |
| 45 |
.TP |
| 46 |
https://bugzilla.kernel.org/buglist.cgi?component=libcap&list_id=1090757 |
| 47 |
.SH SEE ALSO |
| 48 |
.BR capsh (1), |
| 49 |
.BR cap_from_text (3), |
| 50 |
.BR cap_iab (3), |
| 51 |
.BR cap_text_format (7), |
| 52 |
.BR capabilities (7), |
| 53 |
.BR captree (8), |
| 54 |
.BR getcap (8), |
| 55 |
and |
| 56 |
.BR setcap (8). |
| 57 |
.SH AUTHOR |
| 58 |
This manual page was originally written by Robert Bihlmeyer |
| 59 |
<[email protected]>, for the Debian GNU/Linux system (but may be used |
| 60 |
by others). |
| 61 |
|