1/8/2015

UbuntuManpageRepository

name
syntax
description
commandlineoptions
interactivecommands
authors
lucid(1)htop.1.gz
Providedby:htop_0.8.31ubuntu1_i386
NAME
htopinteractiveprocessviewer

SYNTAX
htop

DESCRIPTION
Thisprogramisafree(GPL)ncursesbasedprocessviewer.
Itissimilartotop,butallowstoscrollthelistverticallyand
horizontallytoseeallprocessesandtheirfullcommandlines.
Tasksrelatedtoprocesses(killing,renicing)canbedonewithout
enteringtheirPIDs.

COMMANDLINEOPTIONS
Thefollowingflagsaresupported:
dDELAY
Delaybetweenupdates,intenthsofseconds
uUSERNAME
Showonlyprocessesofagivenuser
sortkeyCOLUMN
Sortbythiscolumn(usesortkeyhelpforacolumnlist)

INTERACTIVECOMMANDS
Thefollowingcommandsaresupported:
Arrows,PgUP,PgDn,Home,End
Scrollprocesslist.
http://manpages.ubuntu.com/manpages/lucid/man1/htop.1.html

1/3

1/8/2015

UbuntuManpageRepository

Space
"Tag":markaprocess.Commandsthatcanoperateonmultiple
processes,like"kill",willthenapplyoverthelistoftagged
processes,insteadofthecurrentlyhighlightedone.
U"Untag"allprocesses(removealltagsaddedwiththeSpacekey).
sTraceprocesssystemcalls:ifstrace(1)isinstalled,pressing
thiskeywillattachittothecurrentlyselectedprocess,
presentingaliveupdateofsystemcallsissuedbytheprocess.
lDisplayopenfilesforaprocess:iflsof(1)isinstalled,
pressingthiskeywilldisplaythelistoffiledescriptorsopened
bytheprocess.
F1,h
Helpscreen
F2,S
Setupscreen.Thereyoucanconfiguremetersdisplayedonthetop
sideofthescreen,aswellassetvariousdisplayoptions,choose
amongcolorschemesandselectthelayoutofthedisplayed
columns.
F3,/
Incrementalprocesssearch:typeinpartofaprocesscommandline
andtheselectionhighlightwillbemovedtoit.Whileinsearch
mode,pressingthiskeywillcyclethroughmatchingoccurrences.
F4,I
Invertsortorder:ifsortorderisincreasing,switchto
decreasing,andviceversa.
F5,t
Treeview:organizeprocessesbyparenthood,andlayoutthe
relationsbetweenthemasatree.Togglingthekeywillswitch
betweentreeandyourpreviouslyselectedsortview.Selectinga
sortviewwillexittreeview.
F6,>
Selectfieldforsorting.Thesortfieldisindicatedbya
highlightintheheader.
F7,],
Increaseselectedprocesspriority(subtractfromnicevalue).
Thiscanbedonebythesuperuseronly.
F8,[,+
Decreaseselectedprocesspriority(addtonicevalue)
F9,k
"Kill"process:sendsasignalwhichisselectedinamenu,toone
oragroupofprocesses.Ifprocessesweretagged,sendsthe
signaltoalltaggedprocesses.Ifnoneistagged,sendstothe
currentlyselectedprocess.
F10,q
Quit
a(onmultiprocessormachines)
SetCPUaffinity:markwhichCPUsaprocessisallowedtouse.
http://manpages.ubuntu.com/manpages/lucid/man1/htop.1.html

2/3

1/8/2015

UbuntuManpageRepository

uShowonlyprocessesownedbyaspecifieduser.
MSortbymemoryusage(topcompatibilitykey).
PSortbyprocessorusage(topcompatibilitykey).
TSortbytime(topcompatibilitykey).
F"Follow"process:ifthesortordercausesthecurrentlyselected
processtomoveinthelist,maketheselectionbarfollowit.
Thisisusefulformonitoringaprocess:thisway,youcankeepa
processalwaysvisibleonscreen.Whenamovementkeyisused,
"follow"loseseffect.
KHidekernelthreads:preventthethreadsbelongingthekernelto
bedisplayedintheprocesslist.(Thisisatogglekey.)
HHideuserthreads:onsystemsthatrepresentthemdifferentlythan
ordinaryprocesses(suchasrecentNPTLbasedsystems),thiscan
hidethreadsfromuserspaceprocessesintheprocesslist.(This
isatogglekey.)
CtrlL
Refresh:redrawscreenandrecalculatevalues.
Numbers
PIDsearch:typeinprocessIDandtheselectionhighlightwillbe
movedtoit.

AUTHORS
htopisdevelopedbyHishamMuhammad
<loderunner@users.sourceforge.net>.
ThismanpagewaswrittenbyBartoszFenski<fenio@o2.pl>forthe
DebianGNU/Linuxdistribution(butitmaybeusedbyothers),and
updatedbyHishamMuhammad.

http://manpages.ubuntu.com/manpages/lucid/man1/htop.1.html

3/3