Date: Wed, 24 Nov 2021 16:11:25 GMT From: Mateusz Piotrowski <0mp@FreeBSD.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org Subject: git: cf1f1f91e914 - stable/12 - top.1: Use the Dq macros instead of \*lq and \*rq Message-ID: <202111241611.1AOGBPoV002030@gitrepo.freebsd.org>
next in thread | raw e-mail | index | archive | help
The branch stable/12 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=cf1f1f91e91425c8796b1af4263e98d280ee7e0a commit cf1f1f91e91425c8796b1af4263e98d280ee7e0a Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-11-18 14:55:27 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-11-24 16:10:24 +0000 top.1: Use the Dq macros instead of \*lq and \*rq MFC after: 3 days (cherry picked from commit 01e3140571bab1a7283e33669de171865cdb8028) --- usr.bin/top/top.1 | 144 ++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 107 insertions(+), 37 deletions(-) diff --git a/usr.bin/top/top.1 b/usr.bin/top/top.1 index deda87a973f0..4a587877dba6 100644 --- a/usr.bin/top/top.1 +++ b/usr.bin/top/top.1 @@ -35,9 +35,13 @@ processes will be displayed instead of the default. makes a distinction between terminals that support advanced capabilities and those that do not. This distinction affects the choice of defaults for certain options. -In the remainder of this document, an \*(lqintelligent\*(rq terminal is one that +In the remainder of this document, an +.Dq intelligent +terminal is one that supports cursor addressing, clear screen, and clear to end of line. -Conversely, a \*(lqdumb\*(rq terminal is one that does not support such +Conversely, a +.Dq dumb +terminal is one that does not support such features. If the output of .Nm @@ -54,7 +58,9 @@ puts their status information there. If the real name differs from argv[0], it will be displayed in parenthesis. .It Fl b -Use \*(lqbatch\*(rq mode. +Use +.Dq batch +mode. In this mode, all input from the terminal is ignored. Interrupt characters (such as ^C and ^\e) still have an effect. @@ -67,9 +73,15 @@ By default top displays the weighted CPU percentage in the WCPU column displays as CPU). Each time .Fl C -flag is passed it toggles between \*(lqraw cpu\*(rq mode -and \*(lqweighted cpu\*(rq mode, showing the \*(lqCPU\*(rq or -the \*(lqWCPU\*(rq column respectively. +flag is passed it toggles between +.Dq raw cpu +mode and +.Dq weighted cpu +mode, showing the +.Dq CPU +or the +.Dq WCPU +column respectively. .It Fl d Ar count Show only .Ar count @@ -88,10 +100,13 @@ By default a single summary line is displayed for each process. Do not display idle processes. By default, top displays both active and idle processes. .It Fl i -Use \*(lqinteractive\*(rq mode. +Use +.Dq interactive +mode. In this mode, any input is immediately read for processing. -See the section on \*(lqInteractive Mode\*(rq +See the section on +.Dq Interactive Mode for an explanation of which keys perform what functions. After the command is processed, the @@ -126,17 +141,32 @@ and Default is .Cm cpu . .It Fl n -Use \*(lqnon-interactive\*(rq mode. -This is identical to \*(lqbatch\*(rq +Use +.Dq non-interactive +mode. +This is identical to +.Dq batch mode. .It Fl o Ar field Sort the process display area on the specified field. The field name is the name of the column as seen in the output, but in lower case: -\*(lqcpu\*(lq, \*(rqsize\*(lq, \*(rqres\*(lq, \*(rqtime\*(lq, -\*(rqpri\*(lq, \*(rqthreads\*(lq, \*(lqtotal\*(lq, \*(rqread\*(lq, -\*(rqwrite\*(lq, \*(rqfault\*(lq, \*(rqvcsw\*(lq, \*(rqivcsw\*(lq, -\*(lqjid\*(lq, \*(rqswap\*(lq or \*(rqpid\*(lq. +.Dq cpu , +.Dq size , +.Dq res , +.Dq time , +.Dq pri , +.Dq threads , +.Dq total , +.Dq read , +.Dq write , +.Dq fault , +.Dq vcsw , +.Dq ivcsw , +.Dq jid , +.Dq swap , +or +.Dq pid . .It Fl P Display per-cpu CPU usage statistics. .It Fl p Ar pid @@ -173,7 +203,9 @@ uid numbers. Do not map uid numbers to usernames. Normally, .Nm -will read as much of the file \*(lq/etc/passwd\*(rq as is necessary to map +will read as much of the file +.Pa /etc/passwd +as is necessary to map all the user id numbers it encounters into login names. This option disables all that, while possibly decreasing execution time. The uid numbers are displayed instead of the names. @@ -189,23 +221,29 @@ Both .Ar count and .Ar number -fields can be specified as \*(lqinfinite\*(rq, indicating that they can +fields can be specified as +.Dq infinite , +indicating that they can stretch as far as possible. This is accomplished by using any proper prefix of the keywords -\*(lqinfinity\*(rq, -\*(lqmaximum\*(rq, +.Dq infinity , +.Dq maximum , or -\*(lqall\*(rq. +.Dq all . Boolean flags are toggles. A second specification of any of these options will negate the first. .Sh "INTERACTIVE MODE" When .Nm -is running in \*(lqinteractive mode\*(rq, it reads commands from the +is running in +.Dq interactive mode , +it reads commands from the terminal and acts upon them accordingly. In this mode, the terminal is -put in \*(lqCBREAK\*(rq, so that a character will be +put in +.Dq CBREAK , +so that a character will be processed as soon as it is typed. Almost always, a key will be pressed when @@ -262,30 +300,45 @@ Toggle the display of system processes. .It a Toggle the display of process titles. .It k -Send a signal (\*(lqkill\*(rq by default) to a list of processes. +Send a signal +.Pq SIGKILL by default +to a list of processes. This acts similarly to the command .Xr kill 1 . .It r -Change the priority (the \*(lqnice\*(rq) of a list of processes. +Change the priority +.Pq the Dq nice +of a list of processes. This acts similarly to .Xr renice 8 . .It u Display only processes owned by a specific set of usernames (prompt for username). -If the username specified is simply \*(lq+\*(rq or \*(lq-\*(rq, +If the username specified is simply +.Dq + +or +.Dq - , then processes belonging to all users will be displayed. Usernames can be added -to and removed from the set by prepending them with \*(lq+\*(rq and -\*(lq-\*(rq, respectively. +to and removed from the set by prepending them with +.Dq + +and +.Dq - , +respectively. .It o Change the order in which the display is sorted. The sort key names include -\*(lqcpu\*(rq, \*(lqres\*(rq, \*(lqsize\*(rq, -\*(lqtime\*(rq. +.Dq cpu , +.Dq res , +.Dq size , +and +.Dq time. The default is cpu. .It p Display a specific process (prompt for pid). -If the pid specified is simply \*(lq+\*(rq, then show all processes. +If the pid specified is simply +.Dq + , +then show all processes. .It e Display a list of system errors (if any) generated by the last command. @@ -299,7 +352,9 @@ Toggle the display of ID. .It J Display only processes owned by a specific jail (prompt for jail). -If the jail specified is simply \*(lq+\*(rq, then processes belonging +If the jail specified is simply +.Dq + , +then processes belonging to all jails and the host will be displayed. This will also enable the display of JID. .It P @@ -348,10 +403,18 @@ SIZE is the total size of the process (text, data, and stack), RES is the current amount of resident memory, SWAP is the approximate amount of swap, if enabled (SIZE, RES and SWAP are given in kilobytes), -STATE is the current state (one of \*(lqSTART\*(rq, \*(lqRUN\*(rq -(shown as \*(lqCPUn\*(rq on SMP systems), \*(lqSLEEP\*(rq, \*(lqSTOP\*(rq, -\*(lqZOMB\*(rq, \*(lqWAIT\*(rq, \*(lqLOCK\*(rq or the event on which the -process waits), +STATE is the current state (one of +.Dq START , +.Dq RUN +(shown as +.Dq CPUn +on SMP systems), +.Dq SLEEP , +.Dq STOP , +.Dq ZOMB , +.Dq WAIT , +.Dq LOCK , +or the event on which the process waits), C is the processor number on which the process is executing (visible only on SMP systems), TIME is the number of system and user cpu seconds that the process has used, @@ -362,12 +425,19 @@ displays as CPU), CPU is the raw percentage and is the field that is sorted to determine the order of the processes, and COMMAND is the name of the command that the process is currently running -(if the process is swapped out, this column is marked \*(lq<swapped>\*(rq). +(if the process is swapped out, this column is marked +.Dq <swapped> ) . .Pp -If a process is in the \*(lqSLEEP\*(rq or \*(lqLOCK\*(rq state, +If a process is in the +.Dq SLEEP +or +.Dq LOCK +state, the state column will report the name of the event or lock on which the process is waiting. -Lock names are prefixed with an asterisk \*(lq*\*(rq while sleep events +Lock names are prefixed with an asterisk +.Dq * +while sleep events are not. .Sh DESCRIPTION OF MEMORY .Bd -literal
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202111241611.1AOGBPoV002030>