View | Details | Raw Unified | Return to bug 73618
Collapse All | Expand All

(-)src/bin/ps/ps.1 (-10 / +22 lines)
Lines 187-192 Link Here
187
sign and a string.
187
sign and a string.
188
This causes the printed header to use the specified string instead of
188
This causes the printed header to use the specified string instead of
189
the standard header.
189
the standard header.
190
If all keywords have empty header texts, no header line is written.
190
.It Fl p
191
.It Fl p
191
Display information about processes which match the specified process IDs.
192
Display information about processes which match the specified process IDs.
192
.It Fl r
193
.It Fl r
Lines 310-315 Link Here
310
If the name is invalid or unknown, then
311
If the name is invalid or unknown, then
311
.Dq ???\&
312
.Dq ???\&
312
is displayed.
313
is displayed.
314
.It Cm logname
315
The login name associated with the session the process is in (see
316
.Xr getlogin 2 ) .
313
.It Cm mwchan
317
.It Cm mwchan
314
The event name if the process is blocked normally, or the lock name if
318
The event name if the process is blocked normally, or the lock name if
315
the process is blocked on a lock.
319
the process is blocked on a lock.
Lines 414-431 Link Here
414
and a process which is blocked while trying
418
and a process which is blocked while trying
415
to exit is listed as
419
to exit is listed as
416
.Dq Li <exiting> .
420
.Dq Li <exiting> .
417
If the command vector cannot be located (usually because it has not
421
If the arguments cannot be located (usually because it has not been set, as is
418
been set, as is the case of system processes and/or kernel threads)
422
the case of system processes and/or kernel threads) the command name is printed
419
the command name is printed within square brackets.
423
within square brackets.
420
The
424
The
421
.Nm
425
.Nm
422
utility
426
utility first tries to obtain the arguments cached by the kernel (if they were
427
shorter than the value of the
428
.Va kern.ps_arg_cache_limit
429
sysctl).
430
The process can change the arguments shown with
431
.Xr setproctitle 3 .
432
Otherwise,
433
.Nm
423
makes an educated guess as to the file name and arguments given when the
434
makes an educated guess as to the file name and arguments given when the
424
process was created by examining memory or the swap area.
435
process was created by examining memory or the swap area.
425
The method is inherently somewhat unreliable and in any event a process
436
The method is inherently somewhat unreliable and in any event a process
426
is entitled to destroy this information, so the names cannot be depended
437
is entitled to destroy this information.
427
on too much.
428
The ucomm (accounting) keyword can, however, be depended on.
438
The ucomm (accounting) keyword can, however, be depended on.
439
If the arguments are unavailable or do not agree with the ucomm keyword,
440
the value for the ucomm keyword is appended to the arguments in parentheses.
429
.Sh KEYWORDS
441
.Sh KEYWORDS
430
The following is a complete list of the available keywords and their
442
The following is a complete list of the available keywords and their
431
meanings.
443
meanings.
Lines 465-472 Link Here
465
MAC label
477
MAC label
466
.It Cm lim
478
.It Cm lim
467
memoryuse limit
479
memoryuse limit
480
.It Cm lockname
481
lock currently blocked on (as a symbolic name)
468
.It Cm logname
482
.It Cm logname
469
login name of user who started the process
483
login name of user who started the session
470
.It Cm lstart
484
.It Cm lstart
471
time started
485
time started
472
.It Cm majflt
486
.It Cm majflt
Lines 477-484 Link Here
477
total messages received (reads from pipes/sockets)
491
total messages received (reads from pipes/sockets)
478
.It Cm msgsnd
492
.It Cm msgsnd
479
total messages sent (writes on pipes/sockets)
493
total messages sent (writes on pipes/sockets)
480
.It Cm lockname
481
lock currently blocked on (as a symbolic name)
482
.It Cm mwchan
494
.It Cm mwchan
483
wait channel or lock currently blocked on
495
wait channel or lock currently blocked on
484
.It Cm nice
496
.It Cm nice
Lines 624-630 Link Here
624
.Xr sysctl 8 ,
636
.Xr sysctl 8 ,
625
.Xr mutex 9
637
.Xr mutex 9
626
.Sh STANDARDS
638
.Sh STANDARDS
627
For historical reasons,
639
For historical reasons, the
628
.Nm
640
.Nm
629
utility under
641
utility under
630
.Fx
642
.Fx

Return to bug 73618