From owner-svn-doc-head@freebsd.org Thu Sep 5 17:28:51 2019 Return-Path: Delivered-To: svn-doc-head@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 9DE48EE212; Thu, 5 Sep 2019 17:28:51 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 46PSN347rkz48Bm; Thu, 5 Sep 2019 17:28:51 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 713317A09; Thu, 5 Sep 2019 17:28:51 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id x85HSpYg019120; Thu, 5 Sep 2019 17:28:51 GMT (envelope-from bcr@FreeBSD.org) Received: (from bcr@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id x85HSpG1019119; Thu, 5 Sep 2019 17:28:51 GMT (envelope-from bcr@FreeBSD.org) Message-Id: <201909051728.x85HSpG1019119@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bcr set sender to bcr@FreeBSD.org using -f From: Benedict Reuschling Date: Thu, 5 Sep 2019 17:28:51 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r53371 - head/en_US.ISO8859-1/books/arch-handbook/locking X-SVN-Group: doc-head X-SVN-Commit-Author: bcr X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/arch-handbook/locking X-SVN-Commit-Revision: 53371 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 05 Sep 2019 17:28:51 -0000 Author: bcr Date: Thu Sep 5 17:28:51 2019 New Revision: 53371 URL: https://svnweb.freebsd.org/changeset/doc/53371 Log: 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 Modified: head/en_US.ISO8859-1/books/arch-handbook/locking/chapter.xml Modified: head/en_US.ISO8859-1/books/arch-handbook/locking/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/arch-handbook/locking/chapter.xml Thu Sep 5 16:59:08 2019 (r53370) +++ head/en_US.ISO8859-1/books/arch-handbook/locking/chapter.xml Thu Sep 5 17:28:51 2019 (r53371) @@ -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,16 +315,23 @@ 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 @@ allproc zombproc pidhashtbl - 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