Changes in taskqueue.9

b4194a43 - callout(9): Allow spin locks use with callout_init_mtx().

Fri, 03 Sep 2021 01:16:46 +0000

callout(9): Allow spin locks use with callout_init_mtx().Implement lock_spin()/unlock_spin() lock class methods, moving theassertion to _sleep() instead. Change assertions in callout(9) toallow spin locks for both regular and C_DIRECT_EXEC cases. In case ofC_DIRECT_EXEC callouts spin locks are the only locks allowed actually.As the first use case allow taskqueue_enqueue_timeout() use on fasttask queues. It actually becomes more efficient due to avoided extracontext switches in callout(9) thanks to C_DIRECT_EXEC.MFC after: 2 weeksReviewed by: hselaskyDifferential Revision: https://reviews.freebsd.org/D31778(cherry picked from commit 4730a8972b1f4b67bf9ffde8e63ca906ef4c9563) List of files: /freebsd-13.1/share/man/man9/taskqueue.9

2faadf10 - taskqueue(9): reference callout(9) instead of timeout(9)

Sun, 07 Jun 2020 09:17:57 +0000

taskqueue(9): reference callout(9) instead of timeout(9)As timeout(9) was removed and all consumers were converted tocallout(9), reference it instead for the description of sbt, pr,and flags arguments.Reviewed by: traszDifferential Revision: https://reviews.freebsd.org/D25165 List of files: /freebsd-13.1/share/man/man9/taskqueue.9

337f6465 - document taskqueue_start_threads_in_proc

Thu, 17 Oct 2019 06:58:07 +0000

document taskqueue_start_threads_in_procWhile here, fix taskqueue_start_threads_cpuset that was documented underold name of taskqueue_start_threads_pinned.MFC after: 4 weeks List of files: /freebsd-13.1/share/man/man9/taskqueue.9

bb58b5d6 - Add a taskqueue_quiesce(9) KPI.

Wed, 21 Nov 2018 17:18:27 +0000

Add a taskqueue_quiesce(9) KPI.This is similar to taskqueue_drain_all(9) but will wait for the queueto become idle before returning instead of only waiting foralready-enqueued tasks to finish. This will be used in the opensolariscompat layer.PR: 227784Reviewed by: cemMFC after: 1 weekSponsored by: The FreeBSD FoundationDifferential Revision: https://reviews.freebsd.org/D17975 List of files: /freebsd-13.1/share/man/man9/taskqueue.9

f37b7fc2 - Add taskqueue_enqueue_timeout_sbt(), because sometimes you want more control

Mon, 31 Jul 2017 00:54:50 +0000

Add taskqueue_enqueue_timeout_sbt(), because sometimes you want more controlover the scheduling precision than 'ticks' can offer, and because sometimesyou're already working with sbintime_t units and it's dumb to convert themto ticks just so they can get converted back to sbintime_t under the hood. List of files: /freebsd-13.1/share/man/man9/taskqueue.9

2e17a50f - Tidy up mdoc formatting for "etc.)" at end of line

Sun, 19 Mar 2017 01:24:18 +0000

Tidy up mdoc formatting for "etc.)" at end of lineman(1) has some logic to use two spaces after a full stop, which isuseful for spotting sentence breaks in monospace fonts. However,this logic is very simple, treating almost all '.' characters asend-of-sentence markers, unless followed by certain othercharacters. For example, '.,' is not end-of-sentence, and neitheris ".) ", but ".)" at the end of a line triggers the sentence-enddetection.Apply a zero-width space to a few instances of this in share/man,and also supply a missing full stop for an instance that occurred atthe end of a sentence.Leave untouched several instances that are at the end of a sentenceor list element.Reported by: 0mp (ieee80211.9) List of files: /freebsd-13.1/share/man/man9/taskqueue.9

6a3536aa - Change from passive to active english. Correctly specify that the task

Mon, 03 Oct 2016 12:48:55 +0000

Change from passive to active english. Correctly specify that the taskis being drained and not the queue.Submitted by: wblock @MFC after: 3 days List of files: /freebsd-13.1/share/man/man9/taskqueue.9

99eca1b2 - While draining a timeout task prevent the taskqueue_enqueue_timeout()

Thu, 29 Sep 2016 10:38:20 +0000

While draining a timeout task prevent the taskqueue_enqueue_timeout()function from restarting the timer.Commonly taskqueue_enqueue_timeout() is called from within the taskfunction itself without any checks for teardown. Then it can happenthe timer stays active after the return of taskqueue_drain_timeout(),because the timeout and task is drained separately.This patch factors out the teardown flag into the timeout task itself,allowing existing code to stay as-is instead of applying a teardownflag to each and every of the timeout task consumers.Add assert to taskqueue_drain_timeout() which prevents parallelexecution on the same timeout task.Update manual page documenting the return value oftaskqueue_enqueue_timeout().Differential Revision: https://reviews.freebsd.org/D8012Reviewed by: kib, traszMFC after: 1 week List of files: /freebsd-13.1/share/man/man9/taskqueue.9

cbc4d2db - Remove taskqueue_enqueue_fast().

Tue, 01 Mar 2016 17:47:32 +0000

Remove taskqueue_enqueue_fast().taskqueue_enqueue() was changed to support both fast and non-fasttaskqueues 10 years ago in r154167. It has been a compat shim eversince. It's time for the compat shim to go.Submitted by: Howard Su Reviewed by: sepheDifferential Revision: https://reviews.freebsd.org/D5131 List of files: /freebsd-13.1/share/man/man9/taskqueue.9

cf28e39c - Remove EOL whitespace.

Thu, 18 Jun 2015 16:29:11 +0000

Remove EOL whitespace. List of files: /freebsd-13.1/share/man/man9/taskqueue.9

5b326a32 - Prevent live-lock and access of destroyed data in taskqueue_drain_all().

Sun, 04 Jan 2015 19:55:44 +0000

Prevent live-lock and access of destroyed data in taskqueue_drain_all().Phabric: https://reviews.freebsd.org/D1247Reviewed by: jhb, avgSponsored by: Spectra Logic Corporationsys/kern_subr_taskqueue.c: Modify taskqueue_drain_all() processing to use a temporary "barrier task", rather than rely on a user task that may be destroyed during taskqueue_drain_all()'s execution. The barrier task is queued behind all previously queued tasks and then has its priority elevated so that future tasks cannot pass it in the queue. Use a similar barrier scheme to drain threads processing current tasks. This requires taskqueue_run_locked() to insert and remove the taskqueue_busy object for the running thread for every task processed.share/man/man9/taskqueue.9: Remove warning about live-lock issues with taskqueue_drain_all() and indicate that it does not wait for tasks queued after it begins processing. List of files: /freebsd-13.1/share/man/man9/taskqueue.9

ec5d37f4 - Document taskqueue_start_threads_pinned

Sun, 25 May 2014 02:45:26 +0000

Document taskqueue_start_threads_pinnedRequested by: adrianReviewed by: adrianApproved by: hrs (mentor)X-MFC-with: r266629 List of files: /freebsd-13.1/share/man/man9/taskqueue.9

cb03508f - update taskqueue(9) manual page

Fri, 14 Feb 2014 15:03:55 +0000

update taskqueue(9) manual pageMany thanks to bjk, gjb and pluknet for improvements and suggestions.MFC after: 5 daysSponsored by: HybridCluster List of files: /freebsd-13.1/share/man/man9/taskqueue.9

fdbc7174 - Extend taskqueue(9) to enable per-taskqueue callbacks.

Sat, 23 Mar 2013 15:11:53 +0000

Extend taskqueue(9) to enable per-taskqueue callbacks.The scope of these callbacks is primarily to support actions that affect thetaskqueue's thread environments. They are entirely optional, andconsequently are introduced as a new API: taskqueue_set_callback().This interface allows the caller to specify that a taskqueue requires acallback and optional context pointer for a given callback type.The callback types included in this commit can be used to register aconstructor and destructor for thread-local storage using osd(9). Thisallows a particular taskqueue to define that its threads require a specifictype of TLS, without the need for a specially-orchestrated task-basedmechanism for startup and shutdown in order to accomplish it.Two callback types are supported at this point:- TASKQUEUE_CALLBACK_TYPE_INIT, called by every thread when it starts, prior to processing any tasks.- TASKQUEUE_CALLBACK_TYPE_SHUTDOWN, called by every thread when it exits, after it has processed its last task but before the taskqueue is reclaimed.While I'm here:- Add two new macros, TQ_ASSERT_LOCKED and TQ_ASSERT_UNLOCKED, and use them in appropriate locations.- Fix taskqueue.9 to mention taskqueue_start_threads(), which is a required interface for all consumers of taskqueue(9).Reviewed by: kib (all), eadler (taskqueue.9), brd (taskqueue.9)Approved by: ken (mentor)Sponsored by: Spectra LogicMFC after: 1 month List of files: /freebsd-13.1/share/man/man9/taskqueue.9

c1e231bc - Fix typo.

Tue, 04 Dec 2012 14:07:17 +0000

Fix typo.Submitted by: bjkMFC after: 3 days List of files: /freebsd-13.1/share/man/man9/taskqueue.9

471af3a8 - Document the interpretation of the negative value of ticks for

Tue, 04 Dec 2012 00:32:12 +0000

Document the interpretation of the negative value of ticks fortaskqueue_enqueue_timeout(9).MFC after: 3 days List of files: /freebsd-13.1/share/man/man9/taskqueue.9

73bbeaa5 - Typo and mdoc(7) style fixes.

Sun, 20 May 2012 16:43:47 +0000

Typo and mdoc(7) style fixes.PR: 168117Submitted by: Nobuyuki Koganemaru (kogane&jp!freebsd!org)MFC after: 3 days List of files: /freebsd-13.1/share/man/man9/taskqueue.9

50d675f7 - Remove trailing whitespace per mdoc lint warning

Thu, 29 Mar 2012 05:02:12 +0000

Remove trailing whitespace per mdoc lint warningDisussed with: gavinNo objection from: docApproved by: joelMFC after: 3 days List of files: /freebsd-13.1/share/man/man9/taskqueue.9

a7f5f794 - Add a TASK_INITIALIZER() macro that can be used to statically

Mon, 19 Dec 2011 18:55:13 +0000

Add a TASK_INITIALIZER() macro that can be used to staticallyinitialize a task structure.Reviewed by: gjMFC after: 2 weeks List of files: /freebsd-13.1/share/man/man9/taskqueue.9

d2849f27 - Ensure that ta_pending doesn't overflow u_short by capping its value at USHRT_MAX.

Thu, 15 Sep 2011 08:42:06 +0000

Ensure that ta_pending doesn't overflow u_short by capping its value at USHRT_MAX.If it overflows before the taskqueue can run, the task will bere-added to the taskqueue and cause a loop in the task list.Reported by: Arnaud Lacombe Submitted by: Ryan Stone Reviewed by: jhbApproved by: re (kib)MFC after: 1 day List of files: /freebsd-13.1/share/man/man9/taskqueue.9