Changeset View
Changeset View
Standalone View
Standalone View
usr.bin/procstat/procstat.1
| Show All 19 Lines | |||||
| .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
| .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
| .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
| .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
| .\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
| .\" | .\" | ||||
| .\" $FreeBSD$ | .\" $FreeBSD$ | ||||
| .\" | .\" | ||||
| .Dd May 18, 2015 | .Dd August 29, 2015 | ||||
| .Dt PROCSTAT 1 | .Dt PROCSTAT 1 | ||||
| .Os | .Os | ||||
| .Sh NAME | .Sh NAME | ||||
| .Nm procstat | .Nm procstat | ||||
| .Nd get detailed process information | .Nd get detailed process information | ||||
| .Sh SYNOPSIS | .Sh SYNOPSIS | ||||
| .Nm | .Nm | ||||
| .Op Fl -libxo | |||||
| .Op Fl CHhn | .Op Fl CHhn | ||||
| .Op Fl w Ar interval | .Op Fl w Ar interval | ||||
| .Op Fl b | c | e | f | i | j | k | l | r | s | S | t | v | x | .Op Fl b | c | e | f | i | j | k | l | r | s | S | t | v | x | ||||
| .Op Fl a | Ar pid | Ar core ... | .Op Fl a | Ar pid | Ar core ... | ||||
| .Sh DESCRIPTION | .Sh DESCRIPTION | ||||
| The | The | ||||
| .Nm | .Nm | ||||
| utility displays detailed information about the processes identified by the | utility displays detailed information about the processes identified by the | ||||
| .Ar pid | .Ar pid | ||||
| arguments, or if the | arguments, or if the | ||||
| .Fl a | .Fl a | ||||
| flag is used, all processes. | flag is used, all processes. | ||||
| It can also display information extracted from a process core file, if | It can also display information extracted from a process core file, if | ||||
| the core file is specified as the argument. | the core file is specified as the argument. | ||||
| .Pp | .Pp | ||||
| By default, basic process statistics are printed; one of the following | By default, basic process statistics are printed; one of the following | ||||
| options may be specified in order to select more detailed process information | options may be specified in order to select more detailed process information | ||||
| for printing: | for printing: | ||||
| .Bl -tag -width indent | .Bl -tag -width indent | ||||
| .It Fl -libxo | |||||
| Generate output via | |||||
| .Xr libxo 3 | |||||
| in a selection of different human and machine readable formats. | |||||
| See | |||||
| .Xr xo_parse_args 3 | |||||
| for details on command line arguments. | |||||
| .It Fl b | .It Fl b | ||||
| Display binary information for the process. | Display binary information for the process. | ||||
| .It Fl c | .It Fl c | ||||
| Display command line arguments for the process. | Display command line arguments for the process. | ||||
| .It Fl e | .It Fl e | ||||
| Display environment variables for the process. | Display environment variables for the process. | ||||
| .It Fl f | .It Fl f | ||||
| Display file descriptor information for the process. | Display file descriptor information for the process. | ||||
| ▲ Show 20 Lines • Show All 463 Lines • ▼ Show 20 Lines | |||||
| .Ex -std | .Ex -std | ||||
| .Sh SEE ALSO | .Sh SEE ALSO | ||||
| .Xr fstat 1 , | .Xr fstat 1 , | ||||
| .Xr ps 1 , | .Xr ps 1 , | ||||
| .Xr sockstat 1 , | .Xr sockstat 1 , | ||||
| .Xr cap_enter 2 , | .Xr cap_enter 2 , | ||||
| .Xr cap_rights_limit 2 , | .Xr cap_rights_limit 2 , | ||||
| .Xr libprocstat 3 , | .Xr libprocstat 3 , | ||||
| .Xr libxo 3 , | |||||
| .Xr xo_parse_args 3 , | |||||
| .Xr ddb 4 , | .Xr ddb 4 , | ||||
| .Xr stack 9 | .Xr stack 9 | ||||
| .Sh AUTHORS | .Sh AUTHORS | ||||
| .An Robert N M Watson | .An Robert N M Watson Aq Mt rwatson@FreeBSD.org . | ||||
| .br | |||||
| .Xr libxo 3 | |||||
| support was added by | |||||
| .An -nosplit | |||||
| Allan Jude | |||||
| .Aq Mt allanjude@FreeBSD.org . | |||||
| .Sh BUGS | .Sh BUGS | ||||
| Some field values may include spaces, which limits the extent to which the | |||||
| output of | |||||
| .Nm | |||||
| may be mechanically parsed. | |||||
| .Pp | |||||
| The display of open file or memory mapping pathnames is implemented using the | The display of open file or memory mapping pathnames is implemented using the | ||||
| kernel's name cache. | kernel's name cache. | ||||
| If a file system does not use the name cache, or the path to a file is not in | If a file system does not use the name cache, or the path to a file is not in | ||||
| the cache, a path will not be displayed. | the cache, a path will not be displayed. | ||||
| .Pp | .Pp | ||||
| .Nm | .Nm | ||||
| currently supports extracting data only from a live kernel, and not from | currently supports extracting data only from a live kernel, and not from | ||||
| kernel crash dumps. | kernel crash dumps. | ||||