xref: /freebsd-src/sys/compat/linuxkpi/common/src/linux_kthread.c (revision 685dc743dc3b5645e34836464128e1c0558b404b)
11e3db1deSHans Petter Selasky /*-
21e3db1deSHans Petter Selasky  * Copyright (c) 2017 Hans Petter Selasky
31e3db1deSHans Petter Selasky  * All rights reserved.
41e3db1deSHans Petter Selasky  *
51e3db1deSHans Petter Selasky  * Redistribution and use in source and binary forms, with or without
61e3db1deSHans Petter Selasky  * modification, are permitted provided that the following conditions
71e3db1deSHans Petter Selasky  * are met:
81e3db1deSHans Petter Selasky  * 1. Redistributions of source code must retain the above copyright
91e3db1deSHans Petter Selasky  *    notice unmodified, this list of conditions, and the following
101e3db1deSHans Petter Selasky  *    disclaimer.
111e3db1deSHans Petter Selasky  * 2. Redistributions in binary form must reproduce the above copyright
121e3db1deSHans Petter Selasky  *    notice, this list of conditions and the following disclaimer in the
131e3db1deSHans Petter Selasky  *    documentation and/or other materials provided with the distribution.
141e3db1deSHans Petter Selasky  *
151e3db1deSHans Petter Selasky  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
161e3db1deSHans Petter Selasky  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
171e3db1deSHans Petter Selasky  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
181e3db1deSHans Petter Selasky  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
191e3db1deSHans Petter Selasky  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
201e3db1deSHans Petter Selasky  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
211e3db1deSHans Petter Selasky  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
221e3db1deSHans Petter Selasky  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
231e3db1deSHans Petter Selasky  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
241e3db1deSHans Petter Selasky  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
251e3db1deSHans Petter Selasky  */
261e3db1deSHans Petter Selasky 
271e3db1deSHans Petter Selasky #include <sys/cdefs.h>
2846565964SMark Johnston #include <linux/compat.h>
291e3db1deSHans Petter Selasky #include <linux/kthread.h>
301e3db1deSHans Petter Selasky #include <linux/sched.h>
3146565964SMark Johnston #include <linux/wait.h>
321e3db1deSHans Petter Selasky 
331e3db1deSHans Petter Selasky #include <sys/bus.h>
341e3db1deSHans Petter Selasky #include <sys/interrupt.h>
351e3db1deSHans Petter Selasky #include <sys/priority.h>
361e3db1deSHans Petter Selasky 
371e3db1deSHans Petter Selasky enum {
381e3db1deSHans Petter Selasky 	KTHREAD_SHOULD_STOP_MASK = (1 << 0),
391e3db1deSHans Petter Selasky 	KTHREAD_SHOULD_PARK_MASK = (1 << 1),
401e3db1deSHans Petter Selasky 	KTHREAD_IS_PARKED_MASK = (1 << 2),
411e3db1deSHans Petter Selasky };
421e3db1deSHans Petter Selasky 
431e3db1deSHans Petter Selasky bool
linux_kthread_should_stop_task(struct task_struct * task)448504aa98SMark Johnston linux_kthread_should_stop_task(struct task_struct *task)
451e3db1deSHans Petter Selasky {
461e3db1deSHans Petter Selasky 
471e3db1deSHans Petter Selasky 	return (atomic_read(&task->kthread_flags) & KTHREAD_SHOULD_STOP_MASK);
481e3db1deSHans Petter Selasky }
491e3db1deSHans Petter Selasky 
501e3db1deSHans Petter Selasky bool
linux_kthread_should_stop(void)518504aa98SMark Johnston linux_kthread_should_stop(void)
521e3db1deSHans Petter Selasky {
531e3db1deSHans Petter Selasky 
541e3db1deSHans Petter Selasky 	return (atomic_read(&current->kthread_flags) & KTHREAD_SHOULD_STOP_MASK);
551e3db1deSHans Petter Selasky }
561e3db1deSHans Petter Selasky 
571e3db1deSHans Petter Selasky int
linux_kthread_stop(struct task_struct * task)588504aa98SMark Johnston linux_kthread_stop(struct task_struct *task)
591e3db1deSHans Petter Selasky {
601e3db1deSHans Petter Selasky 	int retval;
611e3db1deSHans Petter Selasky 
621e3db1deSHans Petter Selasky 	/*
631e3db1deSHans Petter Selasky 	 * Assume task is still alive else caller should not call
641e3db1deSHans Petter Selasky 	 * kthread_stop():
651e3db1deSHans Petter Selasky 	 */
661e3db1deSHans Petter Selasky 	atomic_or(KTHREAD_SHOULD_STOP_MASK, &task->kthread_flags);
678504aa98SMark Johnston 	kthread_unpark(task);
681e3db1deSHans Petter Selasky 	wake_up_process(task);
691e3db1deSHans Petter Selasky 	wait_for_completion(&task->exited);
701e3db1deSHans Petter Selasky 
711e3db1deSHans Petter Selasky 	/*
721e3db1deSHans Petter Selasky 	 * Get return code and free task structure:
731e3db1deSHans Petter Selasky 	 */
741e3db1deSHans Petter Selasky 	retval = task->task_ret;
75a0699ebfSHans Petter Selasky 	put_task_struct(task);
761e3db1deSHans Petter Selasky 
771e3db1deSHans Petter Selasky 	return (retval);
781e3db1deSHans Petter Selasky }
791e3db1deSHans Petter Selasky 
808504aa98SMark Johnston int
linux_kthread_park(struct task_struct * task)818504aa98SMark Johnston linux_kthread_park(struct task_struct *task)
828504aa98SMark Johnston {
838504aa98SMark Johnston 
848504aa98SMark Johnston 	atomic_or(KTHREAD_SHOULD_PARK_MASK, &task->kthread_flags);
858504aa98SMark Johnston 	wake_up_process(task);
868504aa98SMark Johnston 	wait_for_completion(&task->parked);
878504aa98SMark Johnston 	return (0);
888504aa98SMark Johnston }
898504aa98SMark Johnston 
908504aa98SMark Johnston void
linux_kthread_parkme(void)918504aa98SMark Johnston linux_kthread_parkme(void)
928504aa98SMark Johnston {
938504aa98SMark Johnston 	struct task_struct *task;
948504aa98SMark Johnston 
958504aa98SMark Johnston 	task = current;
968504aa98SMark Johnston 	set_task_state(task, TASK_PARKED | TASK_UNINTERRUPTIBLE);
978504aa98SMark Johnston 	while (linux_kthread_should_park()) {
988504aa98SMark Johnston 		while ((atomic_fetch_or(KTHREAD_IS_PARKED_MASK,
998504aa98SMark Johnston 		    &task->kthread_flags) & KTHREAD_IS_PARKED_MASK) == 0)
1008504aa98SMark Johnston 			complete(&task->parked);
1018504aa98SMark Johnston 		schedule();
1028504aa98SMark Johnston 		set_task_state(task, TASK_PARKED | TASK_UNINTERRUPTIBLE);
1038504aa98SMark Johnston 	}
1048504aa98SMark Johnston 	atomic_andnot(KTHREAD_IS_PARKED_MASK, &task->kthread_flags);
1058504aa98SMark Johnston 	set_task_state(task, TASK_RUNNING);
1068504aa98SMark Johnston }
1078504aa98SMark Johnston 
1088504aa98SMark Johnston bool
linux_kthread_should_park(void)1098504aa98SMark Johnston linux_kthread_should_park(void)
1108504aa98SMark Johnston {
1118504aa98SMark Johnston 	struct task_struct *task;
1128504aa98SMark Johnston 
1138504aa98SMark Johnston 	task = current;
1148504aa98SMark Johnston 	return (atomic_read(&task->kthread_flags) & KTHREAD_SHOULD_PARK_MASK);
1158504aa98SMark Johnston }
1168504aa98SMark Johnston 
1178504aa98SMark Johnston void
linux_kthread_unpark(struct task_struct * task)1188504aa98SMark Johnston linux_kthread_unpark(struct task_struct *task)
1198504aa98SMark Johnston {
1208504aa98SMark Johnston 
1218504aa98SMark Johnston 	atomic_andnot(KTHREAD_SHOULD_PARK_MASK, &task->kthread_flags);
1228504aa98SMark Johnston 	if ((atomic_fetch_andnot(KTHREAD_IS_PARKED_MASK, &task->kthread_flags) &
1238504aa98SMark Johnston 	    KTHREAD_IS_PARKED_MASK) != 0)
1248504aa98SMark Johnston 		wake_up_state(task, TASK_PARKED);
1258504aa98SMark Johnston }
1268504aa98SMark Johnston 
1271e3db1deSHans Petter Selasky struct task_struct *
linux_kthread_setup_and_run(struct thread * td,linux_task_fn_t * task_fn,void * arg)1281e3db1deSHans Petter Selasky linux_kthread_setup_and_run(struct thread *td, linux_task_fn_t *task_fn, void *arg)
1291e3db1deSHans Petter Selasky {
1301e3db1deSHans Petter Selasky 	struct task_struct *task;
1311e3db1deSHans Petter Selasky 
1321e3db1deSHans Petter Selasky 	linux_set_current(td);
1331e3db1deSHans Petter Selasky 
1341e3db1deSHans Petter Selasky 	task = td->td_lkpi_task;
1351e3db1deSHans Petter Selasky 	task->task_fn = task_fn;
1361e3db1deSHans Petter Selasky 	task->task_data = arg;
1371e3db1deSHans Petter Selasky 
1381e3db1deSHans Petter Selasky 	thread_lock(td);
1391e3db1deSHans Petter Selasky 	/* make sure the scheduler priority is raised */
1401e3db1deSHans Petter Selasky 	sched_prio(td, PI_SWI(SWI_NET));
1411e3db1deSHans Petter Selasky 	/* put thread into run-queue */
1421e3db1deSHans Petter Selasky 	sched_add(td, SRQ_BORING);
1431e3db1deSHans Petter Selasky 
1441e3db1deSHans Petter Selasky 	return (task);
1451e3db1deSHans Petter Selasky }
1461e3db1deSHans Petter Selasky 
1471e3db1deSHans Petter Selasky void
linux_kthread_fn(void * arg __unused)1481e3db1deSHans Petter Selasky linux_kthread_fn(void *arg __unused)
1491e3db1deSHans Petter Selasky {
1501e3db1deSHans Petter Selasky 	struct task_struct *task = current;
1511e3db1deSHans Petter Selasky 
1528504aa98SMark Johnston 	if (linux_kthread_should_stop_task(task) == 0)
1531e3db1deSHans Petter Selasky 		task->task_ret = task->task_fn(task->task_data);
1541e3db1deSHans Petter Selasky 
1558504aa98SMark Johnston 	if (linux_kthread_should_stop_task(task) != 0) {
1561e3db1deSHans Petter Selasky 		struct thread *td = curthread;
1571e3db1deSHans Petter Selasky 
1581e3db1deSHans Petter Selasky 		/* let kthread_stop() free data */
1591e3db1deSHans Petter Selasky 		td->td_lkpi_task = NULL;
1601e3db1deSHans Petter Selasky 
1611e3db1deSHans Petter Selasky 		/* wakeup kthread_stop() */
1621e3db1deSHans Petter Selasky 		complete(&task->exited);
1631e3db1deSHans Petter Selasky 	}
1641e3db1deSHans Petter Selasky 	kthread_exit();
1651e3db1deSHans Petter Selasky }
166*b6f87b78SVladimir Kondratyev 
167*b6f87b78SVladimir Kondratyev void
lkpi_kthread_work_fn(void * context,int pending __unused)168*b6f87b78SVladimir Kondratyev lkpi_kthread_work_fn(void *context, int pending __unused)
169*b6f87b78SVladimir Kondratyev {
170*b6f87b78SVladimir Kondratyev 	struct kthread_work *work = context;
171*b6f87b78SVladimir Kondratyev 
172*b6f87b78SVladimir Kondratyev 	work->func(work);
173*b6f87b78SVladimir Kondratyev }
174*b6f87b78SVladimir Kondratyev 
175*b6f87b78SVladimir Kondratyev void
lkpi_kthread_worker_init_fn(void * context,int pending __unused)176*b6f87b78SVladimir Kondratyev lkpi_kthread_worker_init_fn(void *context, int pending __unused)
177*b6f87b78SVladimir Kondratyev {
178*b6f87b78SVladimir Kondratyev 	struct kthread_worker *worker = context;
179*b6f87b78SVladimir Kondratyev 
180*b6f87b78SVladimir Kondratyev 	worker->task = current;
181*b6f87b78SVladimir Kondratyev }
182