aboutsummaryrefslogtreecommitdiff
path: root/usr.bin/procstat/procstat.1
Commit message (Collapse)AuthorAgeFilesLines
* 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
* Document one more file descriptor type and two more vnode types.Antoine Brodin2010-02-061-0/+6
| | | | | | | MFC after: 2 weeks Notes: svn path=/head/; revision=203541
* Update procstat(1) for the fact that devfs paths are no longer unsupported.Robert Watson2009-08-121-4/+2
| | | | | | | Approved by: re (kib) Notes: svn path=/head/; revision=196120
* Fix a typo.Wesley Shields2008-12-191-1/+1
| | | | | | | Approved by: rwatson Notes: svn path=/head/; revision=186330
* Integrate the new MPSAFE TTY layer to the FreeBSD operating system.Ed Schouten2008-08-201-1/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The last half year I've been working on a replacement TTY layer for the FreeBSD kernel. The new TTY layer was designed to improve the following: - Improved driver model: The old TTY layer has a driver model that is not abstract enough to make it friendly to use. A good example is the output path, where the device drivers directly access the output buffers. This means that an in-kernel PPP implementation must always convert network buffers into TTY buffers. If a PPP implementation would be built on top of the new TTY layer (still needs a hooks layer, though), it would allow the PPP implementation to directly hand the data to the TTY driver. - Improved hotplugging: With the old TTY layer, it isn't entirely safe to destroy TTY's from the system. This implementation has a two-step destructing design, where the driver first abandons the TTY. After all threads have left the TTY, the TTY layer calls a routine in the driver, which can be used to free resources (unit numbers, etc). The pts(4) driver also implements this feature, which means posix_openpt() will now return PTY's that are created on the fly. - Improved performance: One of the major improvements is the per-TTY mutex, which is expected to improve scalability when compared to the old Giant locking. Another change is the unbuffered copying to userspace, which is both used on TTY device nodes and PTY masters. Upgrading should be quite straightforward. Unlike previous versions, existing kernel configuration files do not need to be changed, except when they reference device drivers that are listed in UPDATING. Obtained from: //depot/projects/mpsafetty/... Approved by: philip (ex-mentor) Discussed: on the lists, at BSDCan, at the DevSummit Sponsored by: Snow B.V., the Netherlands dcons(4) fixed by: kan Notes: svn path=/head/; revision=181905
* Fix a small typo in the procstat(1) manpage: messsage queue.Ed Schouten2008-07-281-1/+1
| | | | | | | | Approved by: philip (mentor) MFC after: 3 days Notes: svn path=/head/; revision=180875
* Use ddb(4), not DDB(4) for man page cross-references.Robert Watson2008-04-211-1/+1
| | | | | | | | MFC after: 3 days Reported by: novel Notes: svn path=/head/; revision=178379
* Provide more detailed information about each procstat(1) display mode,Robert Watson2008-04-191-7/+248
| | | | | | | | | | including a key to fields in each mode and flag abbreviations. MFC after: 3 days X-MFC-note: POSIX shared memory memory objects aren't in 7-STABLE yet Notes: svn path=/head/; revision=178317
* It is a bug that procstat(8) works only on live kernels and not crashdumps;Robert Watson2008-04-191-0/+4
| | | | | | | | | document in case anyone wants to work on fixing this. MFC after: 3 days Notes: svn path=/head/; revision=178316
* Add procstat(1), a process inspection utility. This provides both someRobert Watson2007-12-021-0/+114
of the missing functionality from procfs(4) and new functionality for monitoring and debugging specific processes. procstat(1) operates in the following modes: -b Display binary information for the process. -c Display command line arguments for the process. -f Display file descriptor information for the process. -k Display the stacks of kernel threads in the process. -s Display security credential information for the process. -t Display thread information for the process. -v Display virtual memory mappings for the process. Further revision and modes are expected. Testing, ideas, etc: cognet, sam, Skip Ford <skip at menantico dot com> Wesley Shields <wxs at atarininja dot org> Notes: svn path=/head/; revision=174199
generated by cgit v1.3 (git 2.53.0) at 2026-09-06 02:15:00 +0000