summaryrefslogtreecommitdiffstats
path: root/bin/ps/ps.1
Commit message (Collapse)AuthorAgeFilesLines
* MFC r303423:kib2016-08-151-0/+1
| | | | Force SIGSTOP to be the first signal reported after the attach.
* MFC 302900,302902,302921,303461,304009:jhb2016-08-151-2/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a mask of optional ptrace() events. 302900: Add a test for user signal delivery. This test verifies we get the correct ptrace event details when a signal is posted to a traced process from userland. 302902: Add a mask of optional ptrace() events. ptrace() now stores a mask of optional events in p_ptevents. Currently this mask is a single integer, but it can be expanded into an array of integers in the future. Two new ptrace requests can be used to manipulate the event mask: PT_GET_EVENT_MASK fetches the current event mask and PT_SET_EVENT_MASK sets the current event mask. The current set of events include: - PTRACE_EXEC: trace calls to execve(). - PTRACE_SCE: trace system call entries. - PTRACE_SCX: trace syscam call exits. - PTRACE_FORK: trace forks and auto-attach to new child processes. - PTRACE_LWP: trace LWP events. The S_PT_SCX and S_PT_SCE events in the procfs p_stops flags have been replaced by PTRACE_SCE and PTRACE_SCX. PTRACE_FORK replaces P_FOLLOW_FORK and PTRACE_LWP replaces P2_LWP_EVENTS. The PT_FOLLOW_FORK and PT_LWP_EVENTS ptrace requests remain for compatibility but now simply toggle corresponding flags in the event mask. While here, document that PT_SYSCALL, PT_TO_SCE, and PT_TO_SCX both modify the event mask and continue the traced process. 302921: Rename PTRACE_SYSCALL to LINUX_PTRACE_SYSCALL. 303461: Note that not all optional ptrace events use SIGTRAP. New child processes attached due to PTRACE_FORK use SIGSTOP instead of SIGTRAP. All other ptrace events use SIGTRAP. 304009: Remove description of P_FOLLOWFORK as this flag was removed.
* Rename P_KTHREAD struct proc p_flag to P_KPROC.kib2016-02-091-1/+1
| | | | | | | | I left as is an apparent bug in ntoskrnl_var.h:AT_PASSIVE_LEVEL() definition. Suggested by: jhb Sponsored by: The FreeBSD Foundation
* Fix spelling, as recommended by igor tool.rodrigc2015-12-011-1/+1
|
* Add more text to explain --libxo flag.rodrigc2015-12-011-1/+8
|
* mdoc: minor Xr fixesjoel2015-07-141-2/+2
|
* Document recent p_flag2 additions.pluknet2015-05-271-1/+4
|
* Convert to use libxo. Document use of libxo as well.marcel2015-05-221-1/+5
| | | | | Obtained from: Phil Shafer <phil@juniper.net> Sponsored by: Juniper Networks, Inc.
* Use 24h timestamps in the ps(1) STARTED columnfeld2015-03-171-2/+2
| | | | | | | | | | | | | | | | | | | | | The previous 12h AM/PM format was perplexing as it didn't follow the locale of the user and was a minor annoyance to FreeBSD users coming from Linux. Additionally, the man page was incorrect about the strftime format. There are three time formats that may be displayed in the STARTED column depending on the age of the process. Below is an example. For a process started at 14:30 on Monday 16 March 2015, the following formats may be used: 14:30 for process < 24h old (24h Timestamp) Mon14 for process > 24h, < 1 week old (Weekday Hour) 16Mar15 for process > 1 week old (Day Month Year) Differential Revision: https://reviews.freebsd.org/D1620 Reviewed by: brd Approved by: trasz
* Add facility to stop all userspace processes. The supposed use of thekib2014-12-131-1/+2
| | | | | | | | | | | | | | | | | | | | | feature is to quisce the system before suspend. Stop is implemented by reusing the thread_single(9) with the special mode SINGLE_ALLPROC. SINGLE_ALLPROC differs from the existing single-threading modes by allowing (requiring) caller to operate on other process. Interruptible sleeps for !TDF_SBDRY threads are suspended like SIGSTOP does it, instead of aborting the sleep, like SINGLE_NO_EXIT, to avoid spurious EINTRs on resume. Provide debugging sysctl debug.stop_all_proc, which causes total stop and suspends syncer, while waiting for variable reset for resume. It is used for debugging; should be removed after the real use of the interface is added. In collaboration with: pho Discussed with: avg Sponsored by: The FreeBSD Foundation MFC after: 2 weeks
* Return real parent pid in kinfo (used by e.g. ps)mjg2014-08-281-1/+3
| | | | | | | | | | | Add a separate field which exports tracer pid and add a new keyword ("tracer") for ps to display it. This is a follow up to r270444. Reviewed by: kib MFC after: 1 week Relnotes: yes
* Correct the problems with the ptrace(2) making the debuggee an orphan.kib2014-08-071-2/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | One problem is inferior(9) looping due to the process tree becoming a graph instead of tree if the parent is traced by child. Another issue is due to the use of p_oppid to restore the original parent/child relationship, because real parent could already exited and its pid reused (noted by mjg). Add the function proc_realparent(9), which calculates the parent for given process. It uses the flag P_TREE_FIRST_ORPHAN to detect the head element of the p_orphan list and than stepping back to its container to find the parent process. If the parent has already exited, the init(8) is returned. Move the P_ORPHAN and the new helper flag from the p_flag* to new p_treeflag field of struct proc, which is protected by proctree lock instead of proc lock, since the orphans relationship is managed under the proctree_lock already. The remaining uses of p_oppid in ptrace(PT_DETACH) and process reapping are replaced by proc_realparent(9). Phabric: D417 Reviewed by: jhb Tested by: pho Sponsored by: The FreeBSD Foundation MFC after: 2 weeks
* Add support for inspecting process flags set in p_flag2.pluknet2014-06-061-1/+13
| | | | | Reviewed by: jhb MFC after: 1 week
* Add -J to filter by matching jail IDs and names.bdrewery2014-05-021-2/+17
| | | | | | | | | | -J 0 can be used to show only host processes. Patch partially based on work by bz@ PR: bin/78763 MFC after: 2 weeks Relnotes: yes
* Correct the description of the V state, which indicates that the process'markj2013-12-281-3/+4
| | | | | | parent is suspended, not the process itself. MFC after: 3 days
* Add the ability to display the default FIB number for a process to thewill2013-08-261-0/+3
| | | | | | | | | | | | | | | | | | ps(1) utility, e.g. "ps -O fib". bin/ps/keyword.c: Add the "fib" keyword and default its column name to "FIB". bin/ps/ps.1: Add "fib" as a supported keyword. sys/compat/freebsd32/freebsd32.h: sys/kern/kern_proc.c: sys/sys/user.h: Add the default fib number for a process (p->p_fibnum) to the user land accessible process data of struct kinfo_proc. Submitted by: Oliver Fromme <olli@fromme.com>, gibbs
* Add a few examples.joel2013-03-151-1/+5
| | | | Obtained from: OpenBSD
* Document P_PPTRACE.kib2013-02-071-1/+2
| | | | MFC after: 2 weeks
* - Bump date.zont2012-09-181-1/+1
| | | | | | Submitted by: pluknet Approved by: kib (mentor) X-MFC-With: r240645
* - Add 'dsiz' and 'ssiz' keywords to show data and stack size respectively.zont2012-09-181-0/+4
| | | | | Approved by: kib (mentor) MFC after: 1 week
* Add 'cow' keyword to show per-process cow count.kib2012-05-231-1/+3
| | | | | Submitted by: Andrey Zonov <andrey zonov org> MFC after: 1 week
* mandoc complains loudly when <TAB>s are misused in columnated lists. Fixjoel2012-03-291-31/+31
| | | | | this syntax violation and while I'm here also convert <TAB> to Ta and adjust quotation marks in order to prevent this problem in the future.
* Document P_ORPHAN.kib2012-03-081-1/+2
| | | | MFC after: 3 days
* Remove yet another outdated note about procfs(5) being required.trociny2011-11-221-6/+0
| | | | Spotted by: arundel
* No need in procfs(5).trociny2011-11-221-4/+1
| | | | MFC after: 2 weeks
* For processes with no controlling terminal, display "-" in the TTY columntrasz2011-10-301-1/+5
| | | | | | instead of "?". Submitted by: arundel
* Correct a typo that was introduced in 225912gjb2011-10-021-1/+1
| | | | | | Submitted by: Valentin Nechayev (netch % netch!kiev!ua), arundel MFC after: 1 week With-MFC: 225908
* Tweaks to ps(1):gjb2011-10-011-9/+16
| | | | | | | | | | | | | | | | - there's no reason the semantics of the -x flag are being explained in the -a flag description - be more precise regarding the relation between the -a flag and the security.bsd.see_other_uids sysctl - describe the format of the -t flag's argument - 'con' no longer is a possible entry in the 'TT' column - explain that the 'TT' column refers to pseudo-terminals via mere numbers - add a hint in the 'tt' keyword description that a keyword 'tty' exists, which will give the full terminal pathname Submitted by: arundel (via docs@) (original) MFC after: 1 week With-MFC: 225908
* Reorder default ps(1) output according to reality.gjb2011-10-011-2/+2
| | | | | Submitted by: arundel (via docs@) MFC after: 1 week
* Bump date after the previous commit.pluknet2011-07-011-1/+1
|
* Update and sort the list of the available keywords.pluknet2011-07-011-6/+8
|
* Add "gid" and "group" keywords to display the effective group IDtrasz2011-06-141-2/+9
| | | | | | | and effective group name. Also, add "egid", "egroup" and "euid" aliases. PR: bin/146331 Submitted by: Jeremie Le Hen <jeremie at le-hen dot org>
* Spelling in P_HADTHREADS.pluknet2011-05-201-1/+1
| | | | MFC after: 1 week
* Fix the description of the "paddr" keyword. It shows a processpluknet2011-05-201-1/+1
| | | | | | pointer just like a dublicating "uprocp". MFC after: 1 week
* Document problems with -d/-w and the fact that -X is the default.trasz2011-04-181-2/+9
| | | | | Suggested by: arundel@ Reviewed by: arundel@
* Implement the usertime and systime keywords for ps, printing thekib2011-03-171-3/+7
| | | | | | | corresponding times reported by getrusage(). Submitted by: Dan Nelson <dnelson allantgroup com> MFC after: 1 week
* Export login class information via kinfo and make it possible to viewtrasz2011-03-051-1/+5
| | | | it using "ps -o class".
* Document P_FOLLOWFORK.kib2011-01-251-0/+1
| | | | MFC after: 2 weeks
* Make a thread's address available via the kern proc sysctl, just like theemaste2010-10-081-0/+2
| | | | | | | | process address. Add "tdaddr" keyword to ps(1) to display this thread address. Distilled from Sandvine's patch set by Mark Johnston.
* Add P_HASTHREADS flag description.trasz2010-07-241-1/+2
|
* Update the list of the process flags for P_WKILLED.kib2010-04-131-1/+2
| | | | MFC after: 4 weeks
* o) Add a keyword to displaying elapsed time in integer seconds, "etimes".jmallett2010-03-171-2/+7
| | | | | | o) Give slightly better (i.e. any) documentation of the format of "etime". Reviewed by: jilles
* Update the list of the process flags. Note that the lists of pendingkib2010-03-051-3/+15
| | | | | | | signals for process and its threads are distinct. Reviewed by: jilles MFC after: 2 weeks
* Add manual page links to advertise procstat(1) a little better.trasz2009-07-091-1/+2
| | | | Approved by: re (kib)
* Add a -d option to ps to display descendant info with the output.brian2009-05-171-2/+11
| | | | | | This is similar to linux's -H (or -f) switch. MFC after: 3 weeks
* - P_SA has been removed.jeff2008-03-121-1/+0
|
* Markup fixes.ru2006-09-171-1/+1
|
* For the sake of clarity, explicitly tell that comma and spaceyar2006-08-211-2/+3
| | | | | | characters can be included in a custom column title string -- that's why it may appear at the end of a keyword list argument only.
* Document a detail in the present syntax of "ps -o foo=bar". Nowyar2006-08-181-6/+7
| | | | | | | | the header title string "bar" extends to the end of the argument even if it contains commas or spaces, unlike in RELENG_4 or earlier. The modern syntax agrees with SUSv3. MFC after: 3 days
* o Typo: s/teminal/terminal/.maxim2005-04-291-1/+1
| | | | Submitted by: Michal Varga
OpenPOWER on IntegriCloud