Changes in taskqueue.9

fa9896e0 - Remove $FreeBSD$: two-line nroff pattern

Wed, 16 Aug 2023 17:55:10 +0000

Remove $FreeBSD$: two-line nroff patternRemove /^\.\\"\n\.\\"\s*\$FreeBSD\$$\n/ List of files: /freebsd-14.2/share/man/man9/taskqueue.9

b6f87b78 - LinuxKPI: Implement kthread_worker related functions

Tue, 17 May 2022 12:10:20 +0000

LinuxKPI: Implement kthread_worker related functionsKthread worker is a single thread workqueue which can be used in caseswhere specific kthread association is necessary, for example, when itshould have RT priority or be assigned to certain cgroup.This change implements Linux v4.9 interface which mostly hides kthreadinternals from users thus allowing to use ordinary taskqueue(9) KPI.As kthread worker prohibits enqueueing of already pending or cancelingtasks some minimal changes to taskqueue(9) were done.taskqueue_enqueue_flags() was added to taskqueue KPI which accepts extraflags parameter. It contains one or more of the following flags:TASKQUEUE_FAIL_IF_PENDING - taskqueue_enqueue_flags() fails if the task is already scheduled to execution. EEXIST is returned and the ta_pending counter value remains unchanged.TASKQUEUE_FAIL_IF_CANCELING - taskqueue_enqueue_flags() fails if the task is in the canceling state and ECANCELED is returned.Required by: drm-kmod 5.10MFC after: 1 weekReviewed by: hselasky, Pau Amma (docs)Differential Revision: https://reviews.freebsd.org/D35051 List of files: /freebsd-14.2/share/man/man9/taskqueue.9

4730a897 - 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 List of files: /freebsd-14.2/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-14.2/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-14.2/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-14.2/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-14.2/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-14.2/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-14.2/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-14.2/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-14.2/share/man/man9/taskqueue.9

cf28e39c - Remove EOL whitespace.

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

Remove EOL whitespace. List of files: /freebsd-14.2/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-14.2/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-14.2/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-14.2/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-14.2/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-14.2/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-14.2/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-14.2/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-14.2/share/man/man9/taskqueue.9