Debian Codegraph @

doc/getpcaps.8

raw
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