From de67b5b7848021783625ac79709a11e98e467f5b Mon Sep 17 00:00:00 2001 From: Benedict Reuschling Date: Thu, 5 Sep 2019 17:28:51 +0000 Subject: [PATCH] Fix errors reported by textproc/igor: - wrap long line - use tabs istead of spaces - straggling closing tags (like ) - add blank line after on previous line Event: vBSDcon FreeBSD Hackathon --- .../books/arch-handbook/locking/chapter.xml | 220 +++++++++++------- 1 file changed, 136 insertions(+), 84 deletions(-) diff --git a/en_US.ISO8859-1/books/arch-handbook/locking/chapter.xml b/en_US.ISO8859-1/books/arch-handbook/locking/chapter.xml index 47ec5236ba..e45f45ecf8 100644 --- a/en_US.ISO8859-1/books/arch-handbook/locking/chapter.xml +++ b/en_US.ISO8859-1/books/arch-handbook/locking/chapter.xml @@ -5,12 +5,17 @@ $FreeBSD$ --> - + Locking Notes - SMP Next Generation Project + + SMP Next Generation Project + + This chapter is maintained by the FreeBSD SMP Next - Generation Project. + Generation Project. locking multi-processing @@ -41,7 +46,7 @@ Each mutex has several properties of interest: - + Variable Name The name of the struct mtx variable in @@ -97,8 +102,9 @@ A list of data structures or data structure members that this entry protects. For data structure members, the - name will be in the form of - structure name.member name. + name will be in the form of structure name.member name. @@ -114,17 +120,25 @@ Mutex List - locks - sched_lock + + locks + sched_lock + - locks - vm86pcb_lock + + locks + vm86pcb_lock + - locks - Giant + + locks + Giant + - locks - callout_lock + + locks + callout_lock + @@ -141,48 +155,80 @@ sched_lock - sched lock + + sched lock MTX_SPIN | - MTX_RECURSE - + MTX_RECURSE _gmonparam, cnt.v_swtch, cp_time, curpriority, - mtx.mtx_blocked, - mtx.mtx_contested, - proc.p_procq, - proc.p_slpq, - proc.p_sflag, - proc.p_stat, - proc.p_estcpu, - proc.p_cpticks - proc.p_pctcpu, - proc.p_wchan, - proc.p_wmesg, - proc.p_swtime, - proc.p_slptime, - proc.p_runtime, - proc.p_uu, - proc.p_su, - proc.p_iu, - proc.p_uticks, - proc.p_sticks, - proc.p_iticks, - proc.p_oncpu, - proc.p_lastcpu, - proc.p_rqindex, - proc.p_heldmtx, - proc.p_blocked, - proc.p_mtxname, - proc.p_contested, - proc.p_priority, - proc.p_usrpri, - proc.p_nativepri, - proc.p_nice, - proc.p_rtprio, + mtx.mtx_blocked, + mtx.mtx_contested, + proc.p_procq, + proc.p_slpq, + proc.p_sflag, + proc.p_stat, + proc.p_estcpu, + proc.p_cpticks + proc.p_pctcpu, + proc.p_wchan, + proc.p_wmesg, + proc.p_swtime, + proc.p_slptime, + proc.p_runtime, + proc.p_uu, + proc.p_su, + proc.p_iu, + proc.p_uticks, + proc.p_sticks, + proc.p_iticks, + proc.p_oncpu, + proc.p_lastcpu, + proc.p_rqindex, + proc.p_heldmtx, + proc.p_blocked, + proc.p_mtxname, + proc.p_contested, + proc.p_priority, + proc.p_usrpri, + proc.p_nativepri, + proc.p_nice, + proc.p_rtprio, pscnt, slpque, itqueuebits, @@ -194,8 +240,7 @@ idqueuebits, idqueues, switchtime, - switchticks - + switchticks setrunqueue, remrunqueue, @@ -214,8 +259,7 @@ astoff, astpending, calcru, - proc_compare - + proc_compare @@ -223,14 +267,11 @@ vm86pcb_lockvm86pcb lock - MTX_DEF - + MTX_DEF - vm86pcb - + vm86pcb - vm86_bioscall - + vm86_bioscall @@ -239,8 +280,7 @@ Giant MTX_DEF | - MTX_RECURSE - + MTX_RECURSEnearly everythinglots @@ -251,19 +291,18 @@ callout lock MTX_SPIN | - MTX_RECURSE - + MTX_RECURSE callfree, callwheel, nextsoftcheck, - proc.p_itcallout, - proc.p_slpcallout, + proc.p_itcallout, + proc.p_slpcallout, softticks, - ticks - - - + ticks + @@ -276,15 +315,22 @@ These locks provide basic reader-writer type functionality and may be held by a sleeping process. Currently they are backed by &man.lockmgr.9;. - locks - shared exclusive + + locks + shared exclusive +
Shared Exclusive Lock List - locks - allproc_lock - locks - proctree_lock + + + locks + allproc_lock + + + locks + proctree_lock + @@ -300,17 +346,20 @@ allproczombprocpidhashtbl - proc.p_list - proc.p_hash - nextpid - + proc.p_list + proc.p_hash + nextpid + proctree_lock - proc.p_children - proc.p_sibling - + proc.p_children + proc.p_sibling @@ -320,7 +369,9 @@ Atomically Protected Variables - atomically protected variables + + atomically protected variables + An atomically protected variable is a special variable that is not protected by an explicit lock. Instead, all data @@ -332,7 +383,8 @@ - mtx.mtx_lock + mtx.mtx_lock