From owner-svn-src-head@freebsd.org Sun Mar 4 00:13:49 2018 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 2D23FF48D6F; Sun, 4 Mar 2018 00:13:49 +0000 (UTC) (envelope-from kostikbel@gmail.com) Received: from kib.kiev.ua (kib.kiev.ua [IPv6:2001:470:d5e7:1::1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 901037E9E8; Sun, 4 Mar 2018 00:13:48 +0000 (UTC) (envelope-from kostikbel@gmail.com) Received: from tom.home (kib@localhost [127.0.0.1]) by kib.kiev.ua (8.15.2/8.15.2) with ESMTPS id w240DXbT040295 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Sun, 4 Mar 2018 02:13:36 +0200 (EET) (envelope-from kostikbel@gmail.com) DKIM-Filter: OpenDKIM Filter v2.10.3 kib.kiev.ua w240DXbT040295 Received: (from kostik@localhost) by tom.home (8.15.2/8.15.2/Submit) id w240DXp6040294; Sun, 4 Mar 2018 02:13:33 +0200 (EET) (envelope-from kostikbel@gmail.com) X-Authentication-Warning: tom.home: kostik set sender to kostikbel@gmail.com using -f Date: Sun, 4 Mar 2018 02:13:33 +0200 From: Konstantin Belousov To: Hans Petter Selasky Cc: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r330362 - head/share/man/man9 Message-ID: <20180304001333.GJ3194@kib.kiev.ua> References: <201803032308.w23N8nAV013138@repo.freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <201803032308.w23N8nAV013138@repo.freebsd.org> User-Agent: Mutt/1.9.3 (2018-01-21) X-Spam-Status: No, score=-2.0 required=5.0 tests=ALL_TRUSTED,BAYES_00, DKIM_ADSP_CUSTOM_MED,FREEMAIL_FROM,NML_ADSP_CUSTOM_MED autolearn=no autolearn_force=no version=3.4.1 X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on tom.home X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 04 Mar 2018 00:13:49 -0000 On Sat, Mar 03, 2018 at 11:08:49PM +0000, Hans Petter Selasky wrote: > Author: hselasky > Date: Sat Mar 3 23:08:49 2018 > New Revision: 330362 > URL: https://svnweb.freebsd.org/changeset/base/330362 > > Log: > Document pause_sig(9) and update prototypes for existing pause(9) and > pause_sbt(9) functions. > > MFC after: 1 week > Suggested by: cem@ > Sponsored by: Mellanox Technologies > > Modified: > head/share/man/man9/Makefile > head/share/man/man9/sleep.9 > > Modified: head/share/man/man9/Makefile > ============================================================================== > --- head/share/man/man9/Makefile Sat Mar 3 22:28:20 2018 (r330361) > +++ head/share/man/man9/Makefile Sat Mar 3 23:08:49 2018 (r330362) > @@ -1830,6 +1830,7 @@ MLINKS+=sleep.9 msleep.9 \ > sleep.9 msleep_spin.9 \ > sleep.9 msleep_spin_sbt.9 \ > sleep.9 pause.9 \ > + sleep.9 pause_sig.9 \ > sleep.9 pause_sbt.9 \ > sleep.9 tsleep.9 \ > sleep.9 tsleep_sbt.9 \ > > Modified: head/share/man/man9/sleep.9 > ============================================================================== > --- head/share/man/man9/sleep.9 Sat Mar 3 22:28:20 2018 (r330361) > +++ head/share/man/man9/sleep.9 Sat Mar 3 23:08:49 2018 (r330362) > @@ -25,7 +25,7 @@ > .\" > .\" $FreeBSD$ > .\" > -.Dd May 24, 2015 > +.Dd March 4, 2018 > .Dt SLEEP 9 > .Os > .Sh NAME > @@ -34,6 +34,7 @@ > .Nm msleep_spin , > .Nm msleep_spin_sbt , > .Nm pause , > +.Nm pause_sig , > .Nm pause_sbt , pause_sbt is before pause_sig alphabetically. This note is applicable for all insertions of the pause_sig name in the man page. > .Nm tsleep , > .Nm tsleep_sbt , > @@ -53,9 +54,11 @@ > .Ft int > .Fn msleep_spin_sbt "void *chan" "struct mtx *mtx" "const char *wmesg" \ > "sbintime_t sbt" "sbintime_t pr" "int flags" > -.Ft void > +.Ft int > .Fn pause "const char *wmesg" "int timo" > -.Ft void > +.Ft int > +.Fn pause_sig "const char *wmesg" "int timo" > +.Ft int > .Fn pause_sbt "const char *wmesg" "sbintime_t sbt" "sbintime_t pr" \ > "int flags" > .Ft int > @@ -73,6 +76,8 @@ The functions > .Fn msleep , > .Fn msleep_spin , > .Fn pause , > +.Fn pause_sig , > +.Fn pause_sbt , > .Fn wakeup , > and > .Fn wakeup_one > @@ -82,8 +87,10 @@ external event, it is put to sleep by > .Fn tsleep , > .Fn msleep , > .Fn msleep_spin , > +.Fn pause , > +.Fn pause_sig , > or > -.Fn pause . > +.Fn pause_sbt . > Threads may also wait using one of the locking primitive sleep routines > .Xr mtx_sleep 9 , > .Xr rw_sleep 9 , > @@ -248,6 +255,11 @@ The thread can not be awakened early by signals or cal > .Fn wakeup > or > .Fn wakeup_one . > +The > +.Fn pause_sig > +function is a variant of > +.Fn pause > +which can be awakened early by signals. It would be useful to mention that pause_sbt(9) provides the same feature by using a flag. > .Pp > The > .Fn wakeup_one > @@ -385,6 +397,10 @@ The > .Fn pause > function appeared in > .Fx 7.0 . > +The > +.Fn pause_sig > +function appeared in > +.Fx 12.0 . > .Sh AUTHORS > .An -nosplit > This manual page was written by