aboutsummaryrefslogtreecommitdiff
path: root/usr.bin/procstat/procstat.1
Commit message (Collapse)AuthorAgeFilesLines
* manpages: prefer linking to xo_options.7 over xo_parse_args.3Alan Somers2025-07-161-3/+3
| | | | | | | | | | | | | | | Most libxo-enabled utilities link to xo_parse_args.3. But that man page doesn't actually describe how to format command-line arguments. Rather, xo_options.7 does. I suspect that these utilities link to the former because the latter man page did not exist until libxo-0.7.2 (8a6eceff3ce). And newer utilities have probably been copy/pasting the same text from older ones. But the superior man page does exist now, so we should link to it instead. MFC after: 2 weeks Sponsored by: ConnectWise Reviewed by: emaste Differential Revision: https://reviews.freebsd.org/D51354
* procstat: Add handling for inotify descriptorsMark Johnston2025-07-041-0/+3
| | | | | MFC after: 3 months Sponsored by: Klara, Inc.
* procstat.1: document local SOCK_SEQPACKET socket displayKonstantin Belousov2025-03-271-0/+2
| | | | | | | Reviewed by: markj Sponsored by: The FreeBSD Foundation MFC after: 1 week Differential revision: https://reviews.freebsd.org/D49525
* procstat.1: correct local socket types descriptions.Konstantin Belousov2025-03-271-6/+2
| | | | | | | | | Datagram/Stream sockets are similar to, but are not TCP/UDP sockets. Reviewed by: markj Sponsored by: The FreeBSD Foundation MFC after: 1 week Differential revision: https://reviews.freebsd.org/D49525
* procstat.1: correct description of the kstack subcommand after removal of ↵Konstantin Belousov2025-03-131-1/+1
| | | | | | | | swapping Reviewed by: markj Sponsored by: The FreeBSD Foundation Differential revision: https://reviews.freebsd.org/D49163
* procstat.1: document kqueuesKonstantin Belousov2025-03-131-0/+41
| | | | | | | Reviewed by: markj Sponsored by: The FreeBSD Foundation MFC after: 1 week Differential revision: https://reviews.freebsd.org/D49163
* procstat.1: document rlimitusageKonstantin Belousov2025-03-131-0/+2
| | | | | | | Reviewed by: markj Sponsored by: The FreeBSD Foundation MFC after: 1 week Differential revision: https://reviews.freebsd.org/D49163
* procstat.1: sort subcommandsKonstantin Belousov2025-03-131-34/+34
| | | | | | | Reviewed by: markj Sponsored by: The FreeBSD Foundation MFC after: 1 week Differential revision: https://reviews.freebsd.org/D49163
* Remove $FreeBSD$: two-line nroff patternWarner Losh2023-08-161-2/+0
| | | | Remove /^\.\\"\n\.\\"\s*\$FreeBSD\$$\n/
* procstat: fix printing divert(4) socketsGleb Smirnoff2022-08-301-4/+8
|
* Document procstat(1) advlock commandKonstantin Belousov2022-04-091-1/+57
| | | | | | | Reviewed by: markj Sponsored by: The FreeBSD Foundation MFC after: 1 week Differential revision: https://reviews.freebsd.org/D34834
* procstat: distinguish vm map guards in procstat vm output.Konstantin Belousov2021-02-141-1/+3
| | | | | | | Requested and reviewed by: rwatson (previous version) Sponsored by: The FreeBSD Foundation MFC after: 1 week Differential Revision: https://reviews.freebsd.org/D28658
* Decode and report native eventfd descriptors from libprocstat and procstat.Konstantin Belousov2020-12-271-0/+2
| | | | | | | Submitted by: greg@unrelenting.technology Reviewed by: markj (previous version) MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D26668
* Remove the cloned file descriptors for /dev/crypto.John Baldwin2020-11-251-3/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | Crypto file descriptors were added in the original OCF import as a way to provide per-open data (specifically the list of symmetric sessions). However, this gives a bit of a confusing API where one has to open /dev/crypto and then invoke an ioctl to obtain a second file descriptor. This also does not match the API used with /dev/crypto on other BSDs or with Linux's /dev/crypto driver. Character devices have gained support for per-open data via cdevpriv since OCF was imported, so use cdevpriv to simplify the userland API by permitting ioctls directly on /dev/crypto descriptors. To provide backwards compatibility, CRIOGET now opens another /dev/crypto descriptor via kern_openat() rather than dup'ing the existing file descriptor. This preserves prior semantics in case CRIOGET is invoked multiple times on a single file descriptor. Reviewed by: markj Relnotes: yes Sponsored by: Chelsio Communications Differential Revision: https://reviews.freebsd.org/D27302 Notes: svn path=/head/; revision=368005
* procstat(1): Add EXAMPLES sectionFernando Apesteguía2020-10-051-1/+46
| | | | | | | | | | | | | * Add some examples showing binary, arguments and file info from living processes. * Show information from core dumps including an attempt using an old core file. * While here, fix warning 'no blank before trailing delimiter' reported by igor. Approved by: manpages (0mp@) Differential Revision: https://reviews.freebsd.org/D25467 Notes: svn path=/head/; revision=366449
* Add pargs, penv, pwdx commands and aliases to procstat(1).Konstantin Belousov2020-09-181-3/+34
| | | | | | | | | | | Intent is to mimic Solaris commands with the same names. Submitted by: Juraj Lutter <juraj@lutter.sk> MFC after: 1 week Differential revision: https://reviews.freebsd.org/D26310 Notes: svn path=/head/; revision=365880
* Show wiring state of map entries in procstat -v.Mark Johnston2019-03-051-1/+8
| | | | | | | | | | | | | Note that only entries wired by userspace are shown as such. In particular, entries transiently wired by sysctl_wire_old_buffer() are not flagged as wired in procstat -v output. Reviewed by: kib (previous version) MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D19461 Notes: svn path=/head/; revision=344823
* Don't escape '?'s in protocol output.Brooks Davis2018-01-231-3/+3
| | | | | | | | | | | | This isn't required by mandoc and is nonfunctional in groff. PR: 224632 Reported by: w.schwarzenfeld@utanet.at MFC after: 3 days Differential Revision: https://reviews.freebsd.org/D13779 Notes: svn path=/head/; revision=328297
* Switch procstat from subcommand flags to verbsBrooks Davis2017-10-141-45/+129
| | | | | | | | | | | | | - Use an enumerated value instead of separate flags for commands - Look for a verb if no command flag is set - Lookup the "xocontainer" value based on the command - Document the new command verbs in the man-page Submitted by: kdrakehp@zoho.com Differential Revision: https://reviews.freebsd.org/D10916 Notes: svn path=/head/; revision=324619
* Make procstat(1) recognize process descriptors, so that it showsEdward Tomasz Napierala2017-10-031-1/+3
| | | | | | | | | | | | | "P" instead of "?" in "procstat -af" output. Note that there are still a few more DTYPE_* kinds we don't decode yet. Reported by: rwatson MFC after: 2 weeks Sponsored by: DARPA, AFRL Differential Revision: https://reviews.freebsd.org/D12426 Notes: svn path=/head/; revision=324237
* Add missing usage and getopt(3) optionsBrooks Davis2017-05-261-1/+3
| | | | | | | | | | | | | - Add the missing option 'n' to the getopt(3) string - Add the missing options 'libxo' and 'N' to the usage message - Add the missing options 'M' and 'N' to the man-page Submitted by: Keegan Drake H.P. <kdrakehp@zoho.com> MFC after: 1 week Differential Revision: https://reviews.freebsd.org/D10915 Notes: svn path=/head/; revision=318968
* procstat(1): also reference icmp(4) and sctp(4)Enji Cooper2017-05-111-0/+2
| | | | | | | | | | | This was missed in the previous commit by accident. MFC after: 3 weeks MFC with: r318178 Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=318179
* procstat(1): document all possible `PRO` (network protocol) valuesEnji Cooper2017-05-111-1/+59
| | | | | | | | | | | Reference the appropriate section 4 manpages for networking protocols. MFC after: 3 weeks Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=318178
* procstat(1): clarify the Signal Disposition sectionEnji Cooper2017-05-111-3/+6
| | | | | | | | | | | | | | | | - Fix a typo (SIGIGN -> SIG_IGN). Use .Dv when referencing SIG_IGN. - Use semi-colons as soft breaks when separating sentences for the FLAGS section. - Tweak wording for C slightly to flow better and to be a bit more technically correct (signals with handlers installed will be caught by the target program). - Reference signal(3) in the SEE ALSO section. MFC after: 3 weeks Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=318175
* procstat(1): fix a typo (it's -> its)Enji Cooper2017-05-111-2/+2
| | | | | | | | MFC after: 3 weeks Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=318174
* Add support for capturing 'struct ptrace_lwpinfo' for signalsTycho Nightingale2017-03-301-1/+3
| | | | | | | | | | | | resulting in a process dumping core in the corefile. Also extend procstat to view select members of 'struct ptrace_lwpinfo' from the contents of the note. Sponsored by: Dell EMC Isilon Notes: svn path=/head/; revision=316286
* Introduce libxo to procstat(1)Allan Jude2015-09-051-7/+18
| | | | | | | | | | | Reviewed by: rodrigc, bapt Approved by: marcel (mentor) Relnotes: yes Sponsored by: ScaleEngine Inc. Differential Revision: https://reviews.freebsd.org/D2446 Notes: svn path=/head/; revision=287486
* Create links to the libprocstat man pages for all of the libprocstat ↵Allan Jude2015-05-211-1/+2
| | | | | | | | | | | | | | | | functions so they can be looked up by name Add a cross refrence to libprocstat in the procstat.1 man page Differential Revision: https://reviews.freebsd.org/D2578 Suggested by: jmg Reviewed by: brueffer Approved by: wblock (mentor) MFC after: 1 week Sponsored by: ScaleEngine Inc. Notes: svn path=/head/; revision=283167
* Fix a typo and update the date in the man page.Scott Long2015-03-111-1/+1
| | | | | | | | | Submitted by: emax Obtained from: Netflix, Inc. MFC after: 3 days Notes: svn path=/head/; revision=279875
* Implement basic cpuset reporting in procstat via the -S flag.Scott Long2015-03-101-2/+11
| | | | | | | | Obtained from: Netflix, Inc. MFC after: 3 days Notes: svn path=/head/; revision=279842
* In "procstat -v" (VM), spell out 'FL' to 'FLAG' since there are two extraRobert Watson2014-07-201-1/+1
| | | | | | | | | | | | columns available anyway. Also left align as we tend to do for flags fields, although you can't see that currently as the string fully fills that available columns. MFC after: 3 days Sponsored by: DARPA, AFRL Notes: svn path=/head/; revision=268925
* Add descriptions of the display formats for -e, -l, -r, and -x. Fix a fewJohn Baldwin2014-05-171-2/+65
| | | | | | | typos in indent settings while here. Notes: svn path=/head/; revision=266323
* Correct some minor nits in the per-thread signal format description suchJohn Baldwin2014-05-171-5/+5
| | | | | | | | | as missing posessives and misordering of fields. MFC after: 1 week Notes: svn path=/head/; revision=266296
* - Add support for dumping current resource usage for processes via a new -rJohn Baldwin2014-05-171-5/+12
| | | | | | | | | | | | | flag to procstat. - Add an -H flag to request information about threads rather than processes when dumping statistics. Currently it is only used for -r to display resource usage for individual threads instead of the entire process. Reviewed by: kib (older version without -H) MFC after: 1 month Notes: svn path=/head/; revision=266293
* Expose OBJT_MGTDEVICE VM objects used for GEM/TTM with drm2 as anJohn Baldwin2014-02-111-1/+4
| | | | | | | | | | explicit object type. Reviewed by: kib MFC after: 1 week Notes: svn path=/head/; revision=261780
* With r247602, the "c" flag is no longer printed as a file descriptor flag.Mark Johnston2013-10-281-3/+1
| | | | | | | | Reviewed by: pjd MFC after: 3 days Notes: svn path=/head/; revision=257234
* cap_new(2) and cap_getrights2) were replaced with cap_rights_limit(2)Bryan Drewery2013-09-191-3/+3
| | | | | | | | | | | and cap_rights_get(2) in r247602 Reviewed by: pjd Approved by: gjb Approved by: re (rodrigc) Notes: svn path=/head/; revision=255699
* Make use of newly added libprocstat(3) ability to extract procstatMikolaj Golub2013-04-201-2/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | info from a process core file. So now one can run procstat(1) on a process core e.g. to get a list of files opened by a process when it crashed: root@lisa:/ # procstat -f /root/vi.core PID COMM FD T V FLAGS REF OFFSET PRO NAME 658 vi text v r r-------- - - - /usr/bin/vi 658 vi ctty v c rw------- - - - /dev/pts/0 658 vi cwd v d r-------- - - - /root 658 vi root v d r-------- - - - / 658 vi 0 v c rw------- 11 3208 - /dev/pts/0 658 vi 1 v c rw------- 11 3208 - /dev/pts/0 658 vi 2 v c rw------- 11 3208 - /dev/pts/0 658 vi 3 v r r----n-l- 1 0 - /tmp/vi.0AYKz3Lps7 658 vi 4 v r rw------- 1 0 - /var/tmp/vi.recover/vi.GaGYsz 658 vi 5 v r rw------- 1 0 - - PR: kern/173723 Suggested by: jhb MFC after: 1 month Notes: svn path=/head/; revision=249686
* add SG state typeEitan Adler2012-10-021-0/+2
| | | | | | | | | | PR: bin/171664 Submitted by: Jan Beich jbeich@tormail.org Approved by: cperciva MFC after: 1 week Notes: svn path=/head/; revision=241117
* - Add support for displaying process stack memory regions.Gabor Pali2012-07-161-1/+5
| | | | | | | | Approved by: rwatson MFC after: 3 days Notes: svn path=/head/; revision=238527
* Remove trailing whitespace per mdoc lint warningEitan Adler2012-03-291-1/+1
| | | | | | | | | | Disussed with: gavin No objection from: doc Approved by: joel MFC after: 3 days Notes: svn path=/head/; revision=233648
* When displaying binary information show also osreldate.Mikolaj Golub2012-03-231-1/+3
| | | | | | | | Suggested by: kib MFC after: 2 weeks Notes: svn path=/head/; revision=233390
* Update the description for -s flag after r232182.Sergey Kandaurov2012-02-291-1/+3
| | | | | | | | | When displaying security credential information show also process umask. X-MFC-with: r232182 Notes: svn path=/head/; revision=232300
* Update SYNOPSIS to include the flags added recently.Mikolaj Golub2011-11-281-2/+2
| | | | | | | Spotted by: jhb Notes: svn path=/head/; revision=228090
* usr.bin/procstatMikolaj Golub2011-11-241-1/+3
| | | | | | | | | | | Add -l flag to display resource limits. PR: bin/161257 Reviewed by: kib MFC after: 2 weeks Notes: svn path=/head/; revision=227956
* Add new options, -e and -x, to display process environment variablesMikolaj Golub2011-11-221-1/+5
| | | | | | | | | and ELF auxiliary vectors. MFC after: 2 weeks Notes: svn path=/head/; revision=227838
* Bumb date after r227317.Mikolaj Golub2011-11-081-1/+1
| | | | | | | Reminded by: pluknet Notes: svn path=/head/; revision=227355
* When displaying process virtual memory mappings print superpageMikolaj Golub2011-11-071-0/+2
| | | | | | | | | | mapping flag. Submitted by: Mel Flynn <mel.flynn+fbsd.hackers@mailing.thruhere.net> Reviewed by: alc, rwatson Notes: svn path=/head/; revision=227317
* Updates to libprocstat(3) and procstat(1) to allow monitoring CapsicumRobert Watson2011-08-141-3/+31
| | | | | | | | | | | | | capability mode and capabilities. Right now no attempt is made to unwrap capabilities when operating on a crashdump, so further refinement is required. Approved by: re (bz) Sponsored by: Google Inc Notes: svn path=/head/; revision=224859
* Teach procstat(1) to display some information about signal dispositionKonstantin Belousov2010-03-081-2/+59
| | | | | | | | | | and pending/blocked status for signals. Reviewed by: rwatson MFC after: 2 weeks Notes: svn path=/head/; revision=204879
generated by cgit v1.3 (git 2.53.0) at 2026-04-07 19:59:04 +0000