History log of /freebsd-11.0-release/usr.bin/procstat/procstat.1
Revision Date Author Comments
(<<< Hide modified files)
(Show modified files >>>)
# 303975 11-Aug-2016 gjb

Copy stable/11@r303970 to releng/11.0 as part of the 11.0-RELEASE
cycle.

Prune svn:mergeinfo from the new branch, and rename it to RC1.

Update __FreeBSD_version.

Use the quarterly branch for the default FreeBSD.conf pkg(8) repo and
the dvd1.iso packages population.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

# 302408 08-Jul-2016 gjb

Copy head@r302406 to stable/11 as part of the 11.0-RELEASE cycle.
Prune svn:mergeinfo from the new branch, as nothing has been merged
here.

Additional commits post-branch will follow.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation


# 287486 05-Sep-2015 allanjude

Introduce libxo to procstat(1)

Reviewed by: rodrigc, bapt
Approved by: marcel (mentor)
Relnotes: yes
Sponsored by: ScaleEngine Inc.
Differential Revision: https://reviews.freebsd.org/D2446


# 283167 21-May-2015 allanjude

Create links to the libprocstat man pages for all of the libprocstat 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.


# 279875 11-Mar-2015 scottl

Fix a typo and update the date in the man page.

Submitted by: emax
Obtained from: Netflix, Inc.
MFC after: 3 days


# 279842 10-Mar-2015 scottl

Implement basic cpuset reporting in procstat via the -S flag.

Obtained from: Netflix, Inc.
MFC after: 3 days


# 268925 20-Jul-2014 rwatson

In "procstat -v" (VM), spell out 'FL' to 'FLAG' since there are two extra
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


# 266323 17-May-2014 jhb

Add descriptions of the display formats for -e, -l, -r, and -x. Fix a few
typos in indent settings while here.


# 266296 17-May-2014 jhb

Correct some minor nits in the per-thread signal format description such
as missing posessives and misordering of fields.

MFC after: 1 week


# 266293 17-May-2014 jhb

- Add support for dumping current resource usage for processes via a new -r
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


# 261780 11-Feb-2014 jhb

Expose OBJT_MGTDEVICE VM objects used for GEM/TTM with drm2 as an
explicit object type.

Reviewed by: kib
MFC after: 1 week


# 257234 28-Oct-2013 markj

With r247602, the "c" flag is no longer printed as a file descriptor flag.

Reviewed by: pjd
MFC after: 3 days


# 255699 19-Sep-2013 bdrewery

cap_new(2) and cap_getrights2) were replaced with cap_rights_limit(2)
and cap_rights_get(2) in r247602

Reviewed by: pjd
Approved by: gjb
Approved by: re (rodrigc)


# 249686 20-Apr-2013 trociny

Make use of newly added libprocstat(3) ability to extract procstat
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


# 241117 02-Oct-2012 eadler

add SG state type

PR: bin/171664
Submitted by: Jan Beich jbeich@tormail.org
Approved by: cperciva
MFC after: 1 week


# 238527 16-Jul-2012 pgj

- Add support for displaying process stack memory regions.

Approved by: rwatson
MFC after: 3 days


# 233648 29-Mar-2012 eadler

Remove trailing whitespace per mdoc lint warning

Disussed with: gavin
No objection from: doc
Approved by: joel
MFC after: 3 days


# 233390 23-Mar-2012 trociny

When displaying binary information show also osreldate.

Suggested by: kib
MFC after: 2 weeks


# 232300 29-Feb-2012 pluknet

Update the description for -s flag after r232182.
When displaying security credential information show also process umask.

X-MFC-with: r232182


# 228090 28-Nov-2011 trociny

Update SYNOPSIS to include the flags added recently.

Spotted by: jhb


# 227956 24-Nov-2011 trociny

usr.bin/procstat

Add -l flag to display resource limits.

PR: bin/161257
Reviewed by: kib
MFC after: 2 weeks


# 227838 22-Nov-2011 trociny

Add new options, -e and -x, to display process environment variables
and ELF auxiliary vectors.

MFC after: 2 weeks


# 227355 08-Nov-2011 trociny

Bumb date after r227317.

Reminded by: pluknet


# 227317 07-Nov-2011 trociny

When displaying process virtual memory mappings print superpage
mapping flag.

Submitted by: Mel Flynn <mel.flynn+fbsd.hackers@mailing.thruhere.net>
Reviewed by: alc, rwatson


# 224859 14-Aug-2011 rwatson

Updates to libprocstat(3) and procstat(1) to allow monitoring Capsicum
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


# 204879 08-Mar-2010 kib

Teach procstat(1) to display some information about signal disposition
and pending/blocked status for signals.

Reviewed by: rwatson
MFC after: 2 weeks


# 203541 06-Feb-2010 antoine

Document one more file descriptor type and two more vnode types.

MFC after: 2 weeks


# 196120 12-Aug-2009 rwatson

Update procstat(1) for the fact that devfs paths are no longer unsupported.

Approved by: re (kib)


# 186330 19-Dec-2008 wxs

Fix a typo.

Approved by: rwatson


# 181905 20-Aug-2008 ed

Integrate the new MPSAFE TTY layer to the FreeBSD operating system.

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


# 180875 28-Jul-2008 ed

Fix a small typo in the procstat(1) manpage: messsage queue.

Approved by: philip (mentor)
MFC after: 3 days


# 178379 21-Apr-2008 rwatson

Use ddb(4), not DDB(4) for man page cross-references.

MFC after: 3 days
Reported by: novel


# 178317 19-Apr-2008 rwatson

Provide more detailed information about each procstat(1) display mode,
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


# 178316 19-Apr-2008 rwatson

It is a bug that procstat(8) works only on live kernels and not crashdumps;
document in case anyone wants to work on fixing this.

MFC after: 3 days


# 174199 02-Dec-2007 rwatson

Add procstat(1), a process inspection utility. This provides both some
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>