incubator-nuttx/sched/wqueue/Make.defs

############################################################################
# sched/wqueue/Make.defs
#
# SPDX-License-Identifier: Apache-2.0
#
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements.  See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.  The
# ASF licenses this file to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance with the
# License.  You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
# License for the specific language governing permissions and limitations
# under the License.
#
############################################################################

# Add work queue files

ifeq ($(CONFIG_SCHED_WORKQUEUE),y)

CSRCS += kwork_queue.c kwork_thread.c kwork_cancel.c

ifeq ($(CONFIG_PRIORITY_INHERITANCE),y)
CSRCS += kwork_inherit.c
endif # CONFIG_PRIORITY_INHERITANCE

# Add work queue notifier support

ifeq ($(CONFIG_WQUEUE_NOTIFIER),y)
CSRCS += kwork_notifier.c
endif

# Include wqueue build support

DEPPATH += --dep-path wqueue
VPATH += :wqueue

endif # CONFIG_SCHED_WORKQUEUE
Add support for priority inheritance on the low priority worker queue 2014-10-07 21:41:52 +08:00			`############################################################################`
			`# sched/wqueue/Make.defs`
			`#`
sched: migrate to SPDX identifier Most tools used for compliance and SBOM generation use SPDX identifiers This change brings us a step closer to an easy SBOM generation. Signed-off-by: Alin Jerpelea <alin.jerpelea@sony.com> 2024-09-11 19:45:11 +08:00			`# SPDX-License-Identifier: Apache-2.0`
			`#`
sched/wqueue: Update to Apache 2.0 headers. Also run files through nxstyle to assurand coding standard compliance. 2020-03-12 04:23:38 +08:00			`# Licensed to the Apache Software Foundation (ASF) under one or more`
			`# contributor license agreements. See the NOTICE file distributed with`
			`# this work for additional information regarding copyright ownership. The`
			`# ASF licenses this file to you under the Apache License, Version 2.0 (the`
			`# "License"); you may not use this file except in compliance with the`
			`# License. You may obtain a copy of the License at`
Add support for priority inheritance on the low priority worker queue 2014-10-07 21:41:52 +08:00			`#`
sched/wqueue: Update to Apache 2.0 headers. Also run files through nxstyle to assurand coding standard compliance. 2020-03-12 04:23:38 +08:00			`# http://www.apache.org/licenses/LICENSE-2.0`
Add support for priority inheritance on the low priority worker queue 2014-10-07 21:41:52 +08:00			`#`
sched/wqueue: Update to Apache 2.0 headers. Also run files through nxstyle to assurand coding standard compliance. 2020-03-12 04:23:38 +08:00			`# Unless required by applicable law or agreed to in writing, software`
			`# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT`
			`# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the`
			`# License for the specific language governing permissions and limitations`
			`# under the License.`
Add support for priority inheritance on the low priority worker queue 2014-10-07 21:41:52 +08:00			`#`
			`############################################################################`

			`# Add work queue files`

			`ifeq ($(CONFIG_SCHED_WORKQUEUE),y)`

work_queue: schedule the work queue using the timer mechanism Signed-off-by: Jiuzhu Dong <dongjiuzhu1@xiaomi.com> 2021-06-19 17:29:30 +08:00			`CSRCS += kwork_queue.c kwork_thread.c kwork_cancel.c`
Decoupling work queue data structures. This is part of the preparation to support multiple low-priority worker threads 2014-10-10 22:35:58 +08:00
Add support for priority inheritance on the low priority worker queue 2014-10-07 21:41:52 +08:00			`ifeq ($(CONFIG_PRIORITY_INHERITANCE),y)`
Decoupling work queue data structures. This is part of the preparation to support multiple low-priority worker threads 2014-10-10 22:35:58 +08:00			`CSRCS += kwork_inherit.c`
Repartition work queue code. Move kernel-specific parts from libc/wqueue to sched/wqueue 2014-10-10 20:22:51 +08:00			`endif # CONFIG_PRIORITY_INHERITANCE`
Add support for priority inheritance on the low priority worker queue 2014-10-07 21:41:52 +08:00
Signals were not a good choice of IPC to implement the poll function for several reasons: In order to handle the asynchrnous poll-related event, a substantial amount of state information is needed. Signals are only capable of passing minimal amounts of data. There are also complexities with performing kernel space signal handlers in kernel space code that is better to avoid. So, instead of signals, the equivalent logic was converted to run via a callback that executes on the high-priority work queue. Squashed commit of the following: Fix up some final compile isses. net/netdev: Convert the network down notification logic to use the new wqueue-based notification factility. net/udp: Convert the UDP readahead notification logic to use the new wqueue-based notification factility. net/tcp: Convert the TCP readahead notification logic to use the new wqueue-based notification factility. mm/iob: Convert the IOB notification logic to use the new wqueue-based notification factility. sched/wqueue: Signals are not good IPCs to support the target poll functionality for several reasons including the amount of data that can be passed with a signal and in the fact that in protected and kernel modes, user threads executing signal handlers in protected, kernel memory is problematic. Instead, convert the same logic to perform the notifications via function callback on the high priority work queue. 2018-09-10 05:01:44 +08:00			`# Add work queue notifier support`

			`ifeq ($(CONFIG_WQUEUE_NOTIFIER),y)`
			`CSRCS += kwork_notifier.c`
			`endif`

Add support for priority inheritance on the low priority worker queue 2014-10-07 21:41:52 +08:00			`# Include wqueue build support`

			`DEPPATH += --dep-path wqueue`
			`VPATH += :wqueue`

			`endif # CONFIG_SCHED_WORKQUEUE`