From ba1a8e3d1da08e05567ee6f83288cc5a993976f7 Mon Sep 17 00:00:00 2001 From: Kiyoshi Aman Date: Fri, 24 May 2019 22:53:53 -0500 Subject: bin: remove `kill` and `ps`; they are provided by procps --- bin/ps/ps.1 | 706 ------------------------------------------------------------ 1 file changed, 706 deletions(-) delete mode 100644 bin/ps/ps.1 (limited to 'bin/ps/ps.1') diff --git a/bin/ps/ps.1 b/bin/ps/ps.1 deleted file mode 100644 index 635ec3b..0000000 --- a/bin/ps/ps.1 +++ /dev/null @@ -1,706 +0,0 @@ -.\" $NetBSD: ps.1,v 1.109 2017/08/28 05:57:37 wiz Exp $ -.\" -.\" Copyright (c) 1980, 1990, 1991, 1993, 1994 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" 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 -.\" SUCH DAMAGE. -.\" -.\" @(#)ps.1 8.3 (Berkeley) 4/18/94 -.\" -.Dd August 28, 2017 -.Dt PS 1 -.Os -.Sh NAME -.Nm ps -.Nd process status -.Sh SYNOPSIS -.Nm -.Op Fl AaCcdehjlmrSsTuvwx -.Op Fl k Ar key -.Op Fl M Ar core -.Op Fl N Ar system -.Op Fl O Ar fmt -.Op Fl o Ar fmt -.Op Fl p Ar pid -.Op Fl t Ar tty -.Op Fl U Ar user -.Op Fl W Ar swap -.Nm -.Fl L -.Sh DESCRIPTION -.Nm -displays a header line followed by lines containing information about -running processes. -By default, the display includes only processes that have -controlling terminals and are owned by your uid. -The default sort order of controlling terminal and -(among processes with the same controlling terminal) process ID -may be changed using the -.Fl k , Fl m , -or -.Fl r -options. -.Pp -The information displayed for each process -is selected based on a set of keywords (see the -.Fl L , -.Fl O , -and -.Fl o -options). -The default output format includes, for each process, the process' ID, -controlling terminal, CPU time (including both user and system time), -state, and associated command. -.Pp -The options are as follows: -.Bl -tag -width XNXsystemXX -.It Fl A -Display information about all processes. -This is equivalent to -.Fl a Fl x . -.It Fl a -Display information about other users' processes as well as your own. -Note that this does not display information about processes -without controlling terminals. -.It Fl C -Change the way the CPU percentage is calculated by using a -.Dq raw -CPU calculation that ignores -.Dq resident -time (this normally has no effect). -.It Fl c -Do not display full command with arguments, but only the -executable name. -This may be somewhat confusing; for example, all -.Xr sh 1 -scripts will show as -.Dq sh . -.It Fl d -Arrange processes into descendancy order and prefix each command with -indentation text showing sibling and parent/child relationships. -If either of the -.Fl m -and -.Fl r -options are also used, they control how sibling processes are sorted -relative to each other. -.It Fl e -Display the environment as well. -The environment for other -users' processes can only be displayed by the super-user. -.It Fl h -Repeat the information header as often as necessary to guarantee one -header per page of information. -.It Fl j -Print information associated with the following keywords: -.Ar user , pid , ppid , pgid , sess , jobc , state , tt , time , -and -.Ar command . -.It Fl k Ar key -Sort the output using the space or comma separated list of keywords. -Multiple sort keys may be specified, using any of the -.Fl k , Fl m , -or -.Fl r -options. -The default sort order is equivalent to -.Fl k Ar tdev,pid . -.It Fl L -List the set of available keywords. -.It Fl l -Display information associated with the following keywords: -.Ar uid , pid , ppid , cpu , pri , nice , vsz , rss , wchan , state , -.Ar tt , time , -and -.Ar command . -.It Fl M Ar core -Extract values from the specified core file instead of the running system. -.It Fl m -Sort by memory usage. -This is equivalent to -.Fl k Ar vsz . -.It Fl N Ar system -Extract the name list from the specified system instead of the default, -.Dq Pa /netbsd . -Ignored unless -.Fl M -is specified. -.It Fl O Ar fmt -Display information associated with the space or comma separated list -of keywords specified. -The -.Fl O -option does not suppress the default display; -it inserts additional keywords just after the -.Ar pid -keyword in the default display, or after the -.Ar pid -keyword (if any) in a non-default display specified before the -first use of the -.Fl O -flag. -Keywords inserted by multiple -.Fl O -options will be adjacent. -.Pp -An equals sign -.Pq Dq \&= -followed by a customised header string may be appended to a keyword, -as described in more detail under the -.Fl o -option. -.It Fl o Ar fmt -Display information associated with the space or comma separated list -of keywords specified. -Use of the -.Fl o -option suppresses the set of keywords that would be displayed by default, -or appends to the set of keywords specified by other options. -.Pp -An equals sign -.Pq Dq \&= -followed by a customised header string may be appended to a keyword. -This causes the printed header to use the specified string instead of -the default header associated with the keyword. -.Pp -Everything after the first equals sign is part of the customised -header text, and this may include embedded spaces -.Pq Dq " " , -commas -.Pq Dq \&, , -or equals signs -.Pq Dq \&= . -To specify multiple keywords with customised headers, use multiple -.Fl o -or -.Fl O -options. -.Pp -If all the keywords to be displayed have customised headers, -and all the customised headers are entirely empty, -then the header line is not printed at all. -.It Fl p Ar pid -Display information associated with the specified process ID. -.It Fl r -Sort by current CPU usage. -This is equivalent to -.Fl k Ar %cpu . -.It Fl S -Change the way the process time is calculated by summing all exited -children to their parent process. -.It Fl s -Display one line for each LWP, rather than one line for each process, -and display information associated with the following keywords: -.Ar uid , pid , ppid , cpu , lid , nlwp , pri , nice , vsz , rss , -.Ar wchan , lstate , tt , time , -and -.Ar command . -.It Fl T -Display information about processes attached to the device associated -with the standard input. -.It Fl t Ar tty -Display information about processes attached to the specified terminal -device. -Use a question mark -.Pq Dq \&? -for processes not attached to a -terminal device and a minus sign -.Pq Dq - -for processes that have -been revoked from their terminal device. -.It Fl U Ar user -Display processes belonging to the specified user, -given either as a user name or a uid. -.It Fl u -Display information associated with the following keywords: -.Ar user , pid , %cpu , %mem , vsz , rss , tt , state , start , time , -and -.Ar command . -The -.Fl u -option implies the -.Fl r -option. -.It Fl v -Display information associated with the following keywords: -.Ar pid , state , time , sl , re , pagein , vsz , rss , lim , tsiz , -.Ar %cpu , %mem , -and -.Ar command . -The -.Fl v -option implies the -.Fl m -option. -.It Fl W Ar swap -Extract swap information from the specified file instead of the default, -.Dq Pa /dev/drum . -Ignored unless -.Fl M -is specified. -.It Fl w -Use 132 columns to display information instead of the default, which -is your window size. -If the -.Fl w -option is specified more than once, -.Nm -will use as many columns as necessary without regard to your window size. -.It Fl x -Also display information about processes without controlling terminals. -.El -.Pp -A complete list of the available keywords are listed below. -Some of these keywords are further specified as follows: -.Bl -tag -width indent -.It Ar %cpu -The CPU utilization of the process; this is a decaying average over up to -a minute of previous (real) time. -Since the time base over which this is computed varies (since processes may -be very young) it is possible for the sum of all %CPU fields to exceed 100%. -.It Ar %mem -The percentage of real memory used by this process. -.It Ar flags -The flags (in hexadecimal) associated with the process as in -the include file -.In sys/proc.h : -.Bl -column P_NOCLDSTOP P_NOCLDSTOP compact -.It Dv "P_ADVLOCK" Ta No "0x00000001 process may hold a POSIX advisory lock" -.It Dv "P_CONTROLT" Ta No "0x00000002 process has a controlling terminal" -.It Dv "P_NOCLDSTOP" Ta No "0x00000008 no" Dv SIGCHLD No when children stop -.It Dv "P_PPWAIT" Ta No "0x00000010 parent is waiting for child to exec/exit" -.It Dv "P_PROFIL" Ta No "0x00000020 process has started profiling" -.It Dv "P_SELECT" Ta No "0x00000040 selecting; wakeup/waiting danger" -.It Dv "P_SINTR" Ta No "0x00000080 sleep is interruptible" -.It Dv "P_SUGID" Ta No "0x00000100 process had set id privileges since last exec" -.It Dv "P_SYSTEM" Ta No "0x00000200 system process: no sigs or stats" -.It Dv "P_TIMEOUT" Ta No "0x00000400 timing out during sleep" -.It Dv "P_TRACED" Ta No "0x00000800 process is being traced" -.It Dv "P_WAITED" Ta No "0x00001000 debugging process has waited for child" -.It Dv "P_WEXIT" Ta No "0x00002000 working on exiting" -.It Dv "P_EXEC" Ta No "0x00004000 process called" Xr execve 2 -.It Dv "P_OWEUPC" Ta No "0x00008000 owe process an addupc() call at next ast" -.\" the routine addupc is not documented in the man pages -.It Dv "P_NOCLDWAIT" Ta No "0x00020000 no zombies when children die" -.It Dv "P_32" Ta No "0x00040000 32-bit process (used on 64-bit kernels)" -.It Dv "P_BIGLOCK" Ta No "0x00080000 process needs kernel ``big lock'' to run" -.It Dv "P_INEXEC" Ta No "0x00100000 process is exec'ing and cannot be traced" -.El -.It Ar lim -The soft limit on memory used, specified via a call to -.Xr setrlimit 2 . -.It Ar lstart -The exact time the command started, using the -.Dq \&%c -format described in -.Xr strftime 3 . -.It Ar nice -The process scheduling increment (see -.Xr setpriority 2 ) . -.It Ar rss -the real memory (resident set) size of the process (in 1024 byte units). -.It Ar start -The time the command started. -If the command started less than 24 hours ago, the start time is -displayed using the -.Dq %l:%M%p -format described in -.Xr strftime 3 . -If the command started less than 7 days ago, the start time is -displayed using the -.Dq %a%p -format. -Otherwise, the start time is displayed using the -.Dq %e%b%y -format. -.It Ar state -The state is given by a sequence of letters, for example, -.Dq RNs . -The first letter indicates the run state of the process: -.Pp -.Bl -tag -width indent -compact -.It D -Marks a process in device or other short term, uninterruptible wait. -.It I -Marks a process that is idle (sleeping interruptibly for longer than about -.Dv MAXSLP -(default 20) seconds). -.It O -Marks a process running on a processor. -.It R -Marks a runnable process, or one that is in the process of creation. -.It S -Marks a process that is sleeping interruptibly for less than about -.Dv MAXSLP -(default 20) seconds. -.It T -Marks a stopped process. -.It U -Marks a suspended process. -.It Z -Marks a dead process that has exited, but not been waited for (a -.Dq zombie ) . -.El -.Pp -Additional characters after these, if any, indicate additional state -information: -.Pp -.Bl -tag -width indent -compact -.It + -The process is in the foreground process group of its control terminal. -.It - -The LWP is detached (can't be waited for). -.It < -The process has raised CPU scheduling priority. -.It a -The process is using scheduler activations (deprecated). -.It E -The process is in the process of exiting. -.It K -The process is a kernel thread or system process. -.It l -The process has multiple LWPs. -.It N -The process is niced (has reduced CPU scheduling priority) (see -.Xr setpriority 2 ) . -.It s -The process is a session leader. -.It V -The process is suspended during a -.Xr vfork 2 . -.It X -The process is being traced or debugged. -.El -.It Ar tt -An abbreviation for the pathname of the controlling terminal, if any. -The abbreviation consists of the two letters following -.Dq Pa /dev/tty -or, for the console, -.Dq co . -This is followed by a -.Dq \&- -if the process can no longer reach that -controlling terminal (i.e., it has been revoked). -.It Ar wchan -The event (an address in the system) on which a process waits. -When printed numerically, the initial part of the address is -trimmed off and the result is printed in hex, for example, 0x80324000 prints -as 324000. -.El -.Pp -When printing using the -.Ar command -keyword, a process that has exited and has a parent that has not yet -waited for the process (in other words, a zombie) is listed as -.Dq Aq defunct , -and a process which is blocked while trying to exit is listed as -.Dq Aq exiting . -.Pp -.Nm -will try to locate the processes' argument vector from the user -area in order to print the command name and arguments. -This method is not reliable because a process is allowed to destroy this -information. -The -.Ar ucomm -(accounting) keyword will always contain the real command name as -contained in the process structure's -.Va p_comm -field. -.Pp -If the command vector cannot be located (usually because it has not -been set, as is the case of system processes and/or kernel threads) -the command name is printed within square brackets. -.Pp -To indicate that the argument vector has been tampered with, -.Nm -will append the real command name to the output within parentheses -if the basename of the first argument in the argument vector -does not match the contents of the real command name. -.Pp -In addition, -.Nm -checks for the following two situations and does not append the -real command name parenthesized: -.Bl -tag -width indent -.It -shellname -The login process traditionally adds a -.Sq - -in front of the shell name to indicate a login shell. -.Nm -will not append parenthesized the command name if it matches with -the name in the first argument of the argument vector, skipping -the leading -.Sq - . -.It daemonname: current-activity -Daemon processes frequently report their current activity by setting -their name to be like -.Dq daemonname: current-activity . -.Nm -will not append parenthesized the command name, if the string preceding the -.Sq \&: -in the first argument of the argument vector matches the command name. -.El -.Sh KEYWORDS -The following is a complete list of the available keywords and their -meanings. -Several of them have aliases (keywords which are synonyms). -.Pp -.Bl -tag -width groupnames -compact -.It Ar %cpu -percentage CPU usage (alias -.Ar pcpu ) -.It Ar %mem -percentage memory usage (alias -.Ar pmem ) -.It Ar acflag -accounting flag (alias -.Ar acflg ) -.It Ar comm -command (the argv[0] value) -.It Ar command -command and arguments (alias -.Ar args ) -.It Ar cpu -short-term CPU usage factor (for scheduling) -.It Ar cpuid -CPU number the current process or lwp is running on. -.It Ar ctime -accumulated CPU time of all children that have exited -.It Ar egid -effective group id -.It Ar egroup -group name (from egid) -.It Ar emul -emulation name -.It Ar etime -elapsed time since the process was started, in the form -.Li [[dd-]hh:]mm:ss -.It Ar euid -effective user id -.It Ar euser -user name (from euid) -.It Ar flags -the process flags, in hexadecimal (alias -.Ar f ) -.It Ar gid -effective group id -.It Ar group -group name (from gid) -.It Ar groupnames -group names (from group access list) -.It Ar groups -group access list -.It Ar inblk -total blocks read (alias -.Ar inblock ) -.It Ar jobc -job control count -.It Ar ktrace -tracing flags -.It Ar ktracep -tracing vnode -.It Ar laddr -kernel virtual address of the -.Ft "struct lwp" -belonging to the LWP. -.It Ar lid -ID of the LWP -.It Ar lim -memory use limit -.It Ar lname -descriptive name of the LWP -.It Ar logname -login name of user who started the process (alias -.Ar login ) -.It Ar lstart -time started -.It Ar lstate -symbolic LWP state -.It Ar ltime -CPU time of the LWP -.It Ar majflt -total page faults -.It Ar minflt -total page reclaims -.It Ar msgrcv -total messages received (reads from pipes/sockets) -.It Ar msgsnd -total messages sent (writes on pipes/sockets) -.It Ar nice -nice value (alias -.Ar ni ) -.It Ar nivcsw -total involuntary context switches -.It Ar nlwp -number of LWPs in the process -.It Ar nsigs -total signals taken (alias -.Ar nsignals ) -.It Ar nvcsw -total voluntary context switches -.It Ar nwchan -wait channel (as an address) -.It Ar oublk -total blocks written (alias -.Ar oublock ) -.It Ar p_ru -resource usage pointer (valid only for zombie) -.It Ar paddr -kernel virtual address of the -.Ft "struct proc" -belonging to the process. -.It Ar pagein -pageins (same as majflt) -.It Ar pgid -process group number -.It Ar pid -process ID -.It Ar ppid -parent process ID -.It Ar pri -scheduling priority -.It Ar re -core residency time (in seconds; 127 = infinity) -.It Ar rgid -real group ID -.It Ar rlink -reverse link on run queue, or 0 -.It Ar rlwp -number of LWPs on a processor or run queue -.It Ar rss -resident set size -.It Ar rsz -resident set size + (text size / text use count) (alias -.Ar rssize ) -.It Ar ruid -real user ID -.It Ar ruser -user name (from ruid) -.It Ar sess -session pointer -.It Ar sid -session ID -.It Ar sig -pending signals (alias -.Ar pending ) -.It Ar sigcatch -caught signals (alias -.Ar caught ) -.It Ar sigignore -ignored signals (alias -.Ar ignored ) -.It Ar sigmask -blocked signals (alias -.Ar blocked ) -.It Ar sl -sleep time (in seconds; 127 = infinity) -.It Ar start -time started -.It Ar state -symbolic process state (alias -.Ar stat ) -.It Ar stime -accumulated system CPU time -.It Ar svgid -saved gid from a setgid executable -.It Ar svgroup -group name (from svgid) -.It Ar svuid -saved uid from a setuid executable -.It Ar svuser -user name (from svuid) -.It Ar tdev -control terminal device number -.It Ar time -accumulated CPU time, user + system (alias -.Ar cputime ) -.It Ar tpgid -control terminal process group ID -.It Ar tsess -control terminal session pointer -.It Ar tsiz -text size (in Kbytes) -.It Ar tt -control terminal name (two letter abbreviation) -.It Ar tty -full name of control terminal -.It Ar uaddr -kernel virtual address of the -.Ft "struct user" -belonging to the LWP. -.It Ar ucomm -name to be used for accounting -.It Ar uid -effective user ID -.It Ar upr -scheduling priority on return from system call (alias -.Ar usrpri ) -.It Ar user -user name (from uid) -.It Ar utime -accumulated user CPU time -.It Ar vsz -virtual size in Kbytes (alias -.Ar vsize ) -.It Ar wchan -wait channel (as a symbolic name) -.It Ar xstat -exit or stop status (valid only for stopped or zombie process) -.El -.Sh FILES -.Bl -tag -width /var/run/kvm.db -compact -.It Pa /dev -special files and device names -.It Pa /dev/drum -default swap device -.It Pa /var/run/dev.cdb -/dev name database -.It Pa /var/db/kvm.db -system name list database -.It Pa /netbsd -default system name list -.El -.Sh SEE ALSO -.Xr kill 1 , -.Xr pgrep 1 , -.Xr pkill 1 , -.Xr sh 1 , -.Xr w 1 , -.Xr kvm 3 , -.Xr strftime 3 , -.Xr dev_mkdb 8 , -.Xr pstat 8 -.Sh HISTORY -A -.Nm -utility appeared in -.At v3 -in section 8 of the manual. -.Sh BUGS -Since -.Nm -cannot run faster than the system and is run as any other scheduled -process, the information it displays can never be exact. -- cgit v1.2.3-60-g2f50