17c478bd9Sstevel@tonic-gate /* 27c478bd9Sstevel@tonic-gate * CDDL HEADER START 37c478bd9Sstevel@tonic-gate * 47c478bd9Sstevel@tonic-gate * The contents of this file are subject to the terms of the 52e0c549eSJonathan Adams * Common Development and Distribution License (the "License"). 62e0c549eSJonathan Adams * You may not use this file except in compliance with the License. 77c478bd9Sstevel@tonic-gate * 87c478bd9Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 97c478bd9Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 107c478bd9Sstevel@tonic-gate * See the License for the specific language governing permissions 117c478bd9Sstevel@tonic-gate * and limitations under the License. 127c478bd9Sstevel@tonic-gate * 137c478bd9Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 147c478bd9Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 157c478bd9Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 167c478bd9Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 177c478bd9Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 187c478bd9Sstevel@tonic-gate * 197c478bd9Sstevel@tonic-gate * CDDL HEADER END 207c478bd9Sstevel@tonic-gate */ 217c478bd9Sstevel@tonic-gate /* 222e0c549eSJonathan Adams * Copyright 2009 Sun Microsystems, Inc. All rights reserved. 237c478bd9Sstevel@tonic-gate * Use is subject to license terms. 24b819cea2SGordon Ross * 25b819cea2SGordon Ross * Copyright 2013 Nexenta Systems, Inc. All rights reserved. 264c99ecc3STim Kordas * Copyright 2018, Joyent, Inc. 27*f8d363f3SGordon Ross * Copyright 2023 RackTop Systems, Inc. 287c478bd9Sstevel@tonic-gate */ 297c478bd9Sstevel@tonic-gate 307c478bd9Sstevel@tonic-gate #ifndef _SYS_TASKQ_H 317c478bd9Sstevel@tonic-gate #define _SYS_TASKQ_H 327c478bd9Sstevel@tonic-gate 337c478bd9Sstevel@tonic-gate #include <sys/types.h> 347c478bd9Sstevel@tonic-gate #include <sys/thread.h> 357c478bd9Sstevel@tonic-gate 367c478bd9Sstevel@tonic-gate #ifdef __cplusplus 377c478bd9Sstevel@tonic-gate extern "C" { 387c478bd9Sstevel@tonic-gate #endif 397c478bd9Sstevel@tonic-gate 407c478bd9Sstevel@tonic-gate #define TASKQ_NAMELEN 31 417c478bd9Sstevel@tonic-gate 427c478bd9Sstevel@tonic-gate typedef struct taskq taskq_t; 437c478bd9Sstevel@tonic-gate typedef uintptr_t taskqid_t; 447c478bd9Sstevel@tonic-gate typedef void (task_func_t)(void *); 457c478bd9Sstevel@tonic-gate 4635a5a358SJonathan Adams struct proc; 4735a5a358SJonathan Adams 487c478bd9Sstevel@tonic-gate /* 497c478bd9Sstevel@tonic-gate * Public flags for taskq_create(): bit range 0-15 507c478bd9Sstevel@tonic-gate */ 517c478bd9Sstevel@tonic-gate #define TASKQ_PREPOPULATE 0x0001 /* Prepopulate with threads and data */ 527c478bd9Sstevel@tonic-gate #define TASKQ_CPR_SAFE 0x0002 /* Use CPR safe protocol */ 537c478bd9Sstevel@tonic-gate #define TASKQ_DYNAMIC 0x0004 /* Use dynamic thread scheduling */ 542e0c549eSJonathan Adams #define TASKQ_THREADS_CPU_PCT 0x0008 /* number of threads as % of ncpu */ 5535a5a358SJonathan Adams #define TASKQ_DC_BATCH 0x0010 /* Taskq uses SDC in batch mode */ 56*f8d363f3SGordon Ross #define TASKQ_THREADS_LWP 0x0020 /* create LWP threads */ 577c478bd9Sstevel@tonic-gate 587c478bd9Sstevel@tonic-gate /* 597c478bd9Sstevel@tonic-gate * Flags for taskq_dispatch. TQ_SLEEP/TQ_NOSLEEP should be same as 607c478bd9Sstevel@tonic-gate * KM_SLEEP/KM_NOSLEEP. 617c478bd9Sstevel@tonic-gate */ 627c478bd9Sstevel@tonic-gate #define TQ_SLEEP 0x00 /* Can block for memory */ 637c478bd9Sstevel@tonic-gate #define TQ_NOSLEEP 0x01 /* cannot block for memory; may fail */ 647c478bd9Sstevel@tonic-gate #define TQ_NOQUEUE 0x02 /* Do not enqueue if can't dispatch */ 657c478bd9Sstevel@tonic-gate #define TQ_NOALLOC 0x04 /* cannot allocate memory; may fail */ 6635a5a358SJonathan Adams #define TQ_FRONT 0x08 /* Put task at the front of the queue */ 677c478bd9Sstevel@tonic-gate 68fc8ae2ecSToomas Soome #define TASKQID_INVALID ((taskqid_t)0) 69fc8ae2ecSToomas Soome 70b819cea2SGordon Ross #if defined(_KERNEL) || defined(_FAKE_KERNEL) 717c478bd9Sstevel@tonic-gate 727c478bd9Sstevel@tonic-gate extern taskq_t *system_taskq; 737c478bd9Sstevel@tonic-gate 747c478bd9Sstevel@tonic-gate extern void taskq_init(void); 752e0c549eSJonathan Adams extern void taskq_mp_init(void); 767c478bd9Sstevel@tonic-gate 777c478bd9Sstevel@tonic-gate extern taskq_t *taskq_create(const char *, int, pri_t, int, int, uint_t); 787c478bd9Sstevel@tonic-gate extern taskq_t *taskq_create_instance(const char *, int, int, pri_t, int, 797c478bd9Sstevel@tonic-gate int, uint_t); 8035a5a358SJonathan Adams extern taskq_t *taskq_create_proc(const char *, int, pri_t, int, int, 8135a5a358SJonathan Adams struct proc *, uint_t); 8235a5a358SJonathan Adams extern taskq_t *taskq_create_sysdc(const char *, int, int, int, 8335a5a358SJonathan Adams struct proc *, uint_t, uint_t); 847c478bd9Sstevel@tonic-gate extern taskqid_t taskq_dispatch(taskq_t *, task_func_t, void *, uint_t); 857c478bd9Sstevel@tonic-gate extern void nulltask(void *); 867c478bd9Sstevel@tonic-gate extern void taskq_destroy(taskq_t *); 877c478bd9Sstevel@tonic-gate extern void taskq_wait(taskq_t *); 88a3874b8bSToomas Soome void taskq_wait_id(taskq_t *, taskqid_t); 894c99ecc3STim Kordas extern boolean_t taskq_empty(taskq_t *); 907c478bd9Sstevel@tonic-gate extern void taskq_suspend(taskq_t *); 917c478bd9Sstevel@tonic-gate extern int taskq_suspended(taskq_t *); 927c478bd9Sstevel@tonic-gate extern void taskq_resume(taskq_t *); 937c478bd9Sstevel@tonic-gate extern int taskq_member(taskq_t *, kthread_t *); 947c478bd9Sstevel@tonic-gate 957c478bd9Sstevel@tonic-gate #endif /* _KERNEL */ 967c478bd9Sstevel@tonic-gate 977c478bd9Sstevel@tonic-gate #ifdef __cplusplus 987c478bd9Sstevel@tonic-gate } 997c478bd9Sstevel@tonic-gate #endif 1007c478bd9Sstevel@tonic-gate 1017c478bd9Sstevel@tonic-gate #endif /* _SYS_TASKQ_H */ 102