/* * CDDL HEADER START * * The contents of this file are subject to the terms of the * Common Development and Distribution License (the "License"). * You may not use this file except in compliance with the License. * * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE * or http://www.opensolaris.org/os/licensing. * See the License for the specific language governing permissions * and limitations under the License. * * When distributing Covered Code, include this CDDL HEADER in each * file and include the License file at usr/src/OPENSOLARIS.LICENSE. * If applicable, add the following below this CDDL HEADER, with the * fields enclosed by brackets "[]" replaced with your own identifying * information: Portions Copyright [yyyy] [name of copyright owner] * * CDDL HEADER END */ /* * Copyright 2005 Sun Microsystems, Inc. All rights reserved. * Use is subject to license terms. */ #ifndef _LIBSPL_ATOMIC_H #define _LIBSPL_ATOMIC_H #include #include #ifdef __cplusplus extern "C" { #endif #if defined(_KERNEL) && defined(__GNUC__) && defined(_ASM_INLINES) && \ (defined(__i386) || defined(__amd64)) #include #endif #if defined(_KERNEL) || defined(__STDC__) /* * Increment target. */ extern void atomic_inc_8(volatile uint8_t *); extern void atomic_inc_uchar(volatile uchar_t *); extern void atomic_inc_16(volatile uint16_t *); extern void atomic_inc_ushort(volatile ushort_t *); extern void atomic_inc_32(volatile uint32_t *); extern void atomic_inc_uint(volatile uint_t *); extern void atomic_inc_ulong(volatile ulong_t *); #if defined(_KERNEL) || defined(_INT64_TYPE) extern void atomic_inc_64(volatile uint64_t *); #endif /* * Decrement target */ extern void atomic_dec_8(volatile uint8_t *); extern void atomic_dec_uchar(volatile uchar_t *); extern void atomic_dec_16(volatile uint16_t *); extern void atomic_dec_ushort(volatile ushort_t *); extern void atomic_dec_32(volatile uint32_t *); extern void atomic_dec_uint(volatile uint_t *); extern void atomic_dec_ulong(volatile ulong_t *); #if defined(_KERNEL) || defined(_INT64_TYPE) extern void atomic_dec_64(volatile uint64_t *); #endif /* * Add delta to target */ extern void atomic_add_8(volatile uint8_t *, int8_t); extern void atomic_add_char(volatile uchar_t *, signed char); extern void atomic_add_16(volatile uint16_t *, int16_t); extern void atomic_add_short(volatile ushort_t *, short); extern void atomic_add_32(volatile uint32_t *, int32_t); extern void atomic_add_int(volatile uint_t *, int); extern void atomic_add_ptr(volatile void *, ssize_t); extern void atomic_add_long(volatile ulong_t *, long); #if defined(_KERNEL) || defined(_INT64_TYPE) extern void atomic_add_64(volatile uint64_t *, int64_t); #endif /* * logical OR bits with target */ extern void atomic_or_8(volatile uint8_t *, uint8_t); extern void atomic_or_uchar(volatile uchar_t *, uchar_t); extern void atomic_or_16(volatile uint16_t *, uint16_t); extern void atomic_or_ushort(volatile ushort_t *, ushort_t); extern void atomic_or_32(volatile uint32_t *, uint32_t); extern void atomic_or_uint(volatile uint_t *, uint_t); extern void atomic_or_ulong(volatile ulong_t *, ulong_t); #if defined(_KERNEL) || defined(_INT64_TYPE) extern void atomic_or_64(volatile uint64_t *, uint64_t); #endif /* * logical AND bits with target */ extern void atomic_and_8(volatile uint8_t *, uint8_t); extern void atomic_and_uchar(volatile uchar_t *, uchar_t); extern void atomic_and_16(volatile uint16_t *, uint16_t); extern void atomic_and_ushort(volatile ushort_t *, ushort_t); extern void atomic_and_32(volatile uint32_t *, uint32_t); extern void atomic_and_uint(volatile uint_t *, uint_t); extern void atomic_and_ulong(volatile ulong_t *, ulong_t); #if defined(_KERNEL) || defined(_INT64_TYPE) extern void atomic_and_64(volatile uint64_t *, uint64_t); #endif /* * As above, but return the new value. Note that these _nv() variants are * substantially more expensive on some platforms than the no-return-value * versions above, so don't use them unless you really need to know the * new value *atomically* (e.g. when decrementing a reference count and * checking whether it went to zero). */ /* * Increment target and return new value. */ extern uint8_t atomic_inc_8_nv(volatile uint8_t *); extern uchar_t atomic_inc_uchar_nv(volatile uchar_t *); extern uint16_t atomic_inc_16_nv(volatile uint16_t *); extern ushort_t atomic_inc_ushort_nv(volatile ushort_t *); extern uint32_t atomic_inc_32_nv(volatile uint32_t *); extern uint_t atomic_inc_uint_nv(volatile uint_t *); extern ulong_t atomic_inc_ulong_nv(volatile ulong_t *); #if defined(_KERNEL) || defined(_INT64_TYPE) extern uint64_t atomic_inc_64_nv(volatile uint64_t *); #endif /* * Decrement target and return new value. */ extern uint8_t atomic_dec_8_nv(volatile uint8_t *); extern uchar_t atomic_dec_uchar_nv(volatile uchar_t *); extern uint16_t atomic_dec_16_nv(volatile uint16_t *); extern ushort_t atomic_dec_ushort_nv(volatile ushort_t *); extern uint32_t atomic_dec_32_nv(volatile uint32_t *); extern uint_t atomic_dec_uint_nv(volatile uint_t *); extern ulong_t atomic_dec_ulong_nv(volatile ulong_t *); #if defined(_KERNEL) || defined(_INT64_TYPE) extern uint64_t atomic_dec_64_nv(volatile uint64_t *); #endif /* * Add delta to target */ extern uint8_t atomic_add_8_nv(volatile uint8_t *, int8_t); extern uchar_t atomic_add_char_nv(volatile uchar_t *, signed char); extern uint16_t atomic_add_16_nv(volatile uint16_t *, int16_t); extern ushort_t atomic_add_short_nv(volatile ushort_t *, short); extern uint32_t atomic_add_32_nv(volatile uint32_t *, int32_t); extern uint_t atomic_add_int_nv(volatile uint_t *, int); extern void *atomic_add_ptr_nv(volatile void *, ssize_t); extern ulong_t atomic_add_long_nv(volatile ulong_t *, long); #if defined(_KERNEL) || defined(_INT64_TYPE) extern uint64_t atomic_add_64_nv(volatile uint64_t *, int64_t); #endif /* * logical OR bits with target and return new value. */ extern uint8_t atomic_or_8_nv(volatile uint8_t *, uint8_t); extern uchar_t atomic_or_uchar_nv(volatile uchar_t *, uchar_t); extern uint16_t atomic_or_16_nv(volatile uint16_t *, uint16_t); extern ushort_t atomic_or_ushort_nv(volatile ushort_t *, ushort_t); extern uint32_t atomic_or_32_nv(volatile uint32_t *, uint32_t); extern uint_t atomic_or_uint_nv(volatile uint_t *, uint_t); extern ulong_t atomic_or_ulong_nv(volatile ulong_t *, ulong_t); #if defined(_KERNEL) || defined(_INT64_TYPE) extern uint64_t atomic_or_64_nv(volatile uint64_t *, uint64_t); #endif /* * logical AND bits with target and return new value. */ extern uint8_t atomic_and_8_nv(volatile uint8_t *, uint8_t); extern uchar_t atomic_and_uchar_nv(volatile uchar_t *, uchar_t); extern uint16_t atomic_and_16_nv(volatile uint16_t *, uint16_t); extern ushort_t atomic_and_ushort_nv(volatile ushort_t *, ushort_t); extern uint32_t atomic_and_32_nv(volatile uint32_t *, uint32_t); extern uint_t atomic_and_uint_nv(volatile uint_t *, uint_t); extern ulong_t atomic_and_ulong_nv(volatile ulong_t *, ulong_t); #if defined(_KERNEL) || defined(_INT64_TYPE) extern uint64_t atomic_and_64_nv(volatile uint64_t *, uint64_t); #endif /* * If *arg1 == arg2, set *arg1 = arg3; return old value */ extern uint8_t atomic_cas_8(volatile uint8_t *, uint8_t, uint8_t); extern uchar_t atomic_cas_uchar(volatile uchar_t *, uchar_t, uchar_t); extern uint16_t atomic_cas_16(volatile uint16_t *, uint16_t, uint16_t); extern ushort_t atomic_cas_ushort(volatile ushort_t *, ushort_t, ushort_t); extern uint32_t atomic_cas_32(volatile uint32_t *, uint32_t, uint32_t); extern uint_t atomic_cas_uint(volatile uint_t *, uint_t, uint_t); extern void *atomic_cas_ptr(volatile void *, void *, void *); extern ulong_t atomic_cas_ulong(volatile ulong_t *, ulong_t, ulong_t); #if defined(_KERNEL) || defined(_INT64_TYPE) extern uint64_t atomic_cas_64(volatile uint64_t *, uint64_t, uint64_t); #endif /* * Swap target and return old value */ extern uint8_t atomic_swap_8(volatile uint8_t *, uint8_t); extern uchar_t atomic_swap_uchar(volatile uchar_t *, uchar_t); extern uint16_t atomic_swap_16(volatile uint16_t *, uint16_t); extern ushort_t atomic_swap_ushort(volatile ushort_t *, ushort_t); extern uint32_t atomic_swap_32(volatile uint32_t *, uint32_t); extern uint_t atomic_swap_uint(volatile uint_t *, uint_t); extern void *atomic_swap_ptr(volatile void *, void *); extern ulong_t atomic_swap_ulong(volatile ulong_t *, ulong_t); #if defined(_KERNEL) || defined(_INT64_TYPE) extern uint64_t atomic_swap_64(volatile uint64_t *, uint64_t); #endif /* * Perform an exclusive atomic bit set/clear on a target. * Returns 0 if bit was sucessfully set/cleared, or -1 * if the bit was already set/cleared. */ extern int atomic_set_long_excl(volatile ulong_t *, uint_t); extern int atomic_clear_long_excl(volatile ulong_t *, uint_t); /* * Generic memory barrier used during lock entry, placed after the * memory operation that acquires the lock to guarantee that the lock * protects its data. No stores from after the memory barrier will * reach visibility, and no loads from after the barrier will be * resolved, before the lock acquisition reaches global visibility. */ extern void membar_enter(void); /* * Generic memory barrier used during lock exit, placed before the * memory operation that releases the lock to guarantee that the lock * protects its data. All loads and stores issued before the barrier * will be resolved before the subsequent lock update reaches visibility. */ extern void membar_exit(void); /* * Arrange that all stores issued before this point in the code reach * global visibility before any stores that follow; useful in producer * modules that update a data item, then set a flag that it is available. * The memory barrier guarantees that the available flag is not visible * earlier than the updated data, i.e. it imposes store ordering. */ extern void membar_producer(void); /* * Arrange that all loads issued before this point in the code are * completed before any subsequent loads; useful in consumer modules * that check to see if data is available and read the data. * The memory barrier guarantees that the data is not sampled until * after the available flag has been seen, i.e. it imposes load ordering. */ extern void membar_consumer(void); #endif #if !defined(_KERNEL) && !defined(__STDC__) extern void atomic_inc_8(); extern void atomic_inc_uchar(); extern void atomic_inc_16(); extern void atomic_inc_ushort(); extern void atomic_inc_32(); extern void atomic_inc_uint(); extern void atomic_inc_ulong(); #if defined(_INT64_TYPE) extern void atomic_inc_64(); #endif /* defined(_INT64_TYPE) */ extern void atomic_dec_8(); extern void atomic_dec_uchar(); extern void atomic_dec_16(); extern void atomic_dec_ushort(); extern void atomic_dec_32(); extern void atomic_dec_uint(); extern void atomic_dec_ulong(); #if defined(_INT64_TYPE) extern void atomic_dec_64(); #endif /* defined(_INT64_TYPE) */ extern void atomic_add_8(); extern void atomic_add_char(); extern void atomic_add_16(); extern void atomic_add_short(); extern void atomic_add_32(); extern void atomic_add_int(); extern void atomic_add_ptr(); extern void atomic_add_long(); #if defined(_INT64_TYPE) extern void atomic_add_64(); #endif /* defined(_INT64_TYPE) */ extern void atomic_or_8(); extern void atomic_or_uchar(); extern void atomic_or_16(); extern void atomic_or_ushort(); extern void atomic_or_32(); extern void atomic_or_uint(); extern void atomic_or_ulong(); #if defined(_INT64_TYPE) extern void atomic_or_64(); #endif /* defined(_INT64_TYPE) */ extern void atomic_and_8(); extern void atomic_and_uchar(); extern void atomic_and_16(); extern void atomic_and_ushort(); extern void atomic_and_32(); extern void atomic_and_uint(); extern void atomic_and_ulong(); #if defined(_INT64_TYPE) extern void atomic_and_64(); #endif /* defined(_INT64_TYPE) */ extern uint8_t atomic_inc_8_nv(); extern uchar_t atomic_inc_uchar_nv(); extern uint16_t atomic_inc_16_nv(); extern ushort_t atomic_inc_ushort_nv(); extern uint32_t atomic_inc_32_nv(); extern uint_t atomic_inc_uint_nv(); extern ulong_t atomic_inc_ulong_nv(); #if defined(_INT64_TYPE) extern uint64_t atomic_inc_64_nv(); #endif /* defined(_INT64_TYPE) */ extern uint8_t atomic_dec_8_nv(); extern uchar_t atomic_dec_uchar_nv(); extern uint16_t atomic_dec_16_nv(); extern ushort_t atomic_dec_ushort_nv(); extern uint32_t atomic_dec_32_nv(); extern uint_t atomic_dec_uint_nv(); extern ulong_t atomic_dec_ulong_nv(); #if defined(_INT64_TYPE) extern uint64_t atomic_dec_64_nv(); #endif /* defined(_INT64_TYPE) */ extern uint8_t atomic_add_8_nv(); extern uchar_t atomic_add_char_nv(); extern uint16_t atomic_add_16_nv(); extern ushort_t atomic_add_short_nv(); extern uint32_t atomic_add_32_nv(); extern uint_t atomic_add_int_nv(); extern void *atomic_add_ptr_nv(); extern ulong_t atomic_add_long_nv(); #if defined(_INT64_TYPE) extern uint64_t atomic_add_64_nv(); #endif /* defined(_INT64_TYPE) */ extern uint8_t atomic_or_8_nv(); extern uchar_t atomic_or_uchar_nv(); extern uint16_t atomic_or_16_nv(); extern ushort_t atomic_or_ushort_nv(); extern uint32_t atomic_or_32_nv(); extern uint_t atomic_or_uint_nv(); extern ulong_t atomic_or_ulong_nv(); #if defined(_INT64_TYPE) extern uint64_t atomic_or_64_nv(); #endif /* defined(_INT64_TYPE) */ extern uint8_t atomic_and_8_nv(); extern uchar_t atomic_and_uchar_nv(); extern uint16_t atomic_and_16_nv(); extern ushort_t atomic_and_ushort_nv(); extern uint32_t atomic_and_32_nv(); extern uint_t atomic_and_uint_nv(); extern ulong_t atomic_and_ulong_nv(); #if defined(_INT64_TYPE) extern uint64_t atomic_and_64_nv(); #endif /* defined(_INT64_TYPE) */ extern uint8_t atomic_cas_8(); extern uchar_t atomic_cas_uchar(); extern uint16_t atomic_cas_16(); extern ushort_t atomic_cas_ushort(); extern uint32_t atomic_cas_32(); extern uint_t atomic_cas_uint(); extern void *atomic_cas_ptr(); extern ulong_t atomic_cas_ulong(); #if defined(_INT64_TYPE) extern uint64_t atomic_cas_64(); #endif /* defined(_INT64_TYPE) */ extern uint8_t atomic_swap_8(); extern uchar_t atomic_swap_uchar(); extern uint16_t atomic_swap_16(); extern ushort_t atomic_swap_ushort(); extern uint32_t atomic_swap_32(); extern uint_t atomic_swap_uint(); extern void *atomic_swap_ptr(); extern ulong_t atomic_swap_ulong(); #if defined(_INT64_TYPE) extern uint64_t atomic_swap_64(); #endif /* defined(_INT64_TYPE) */ extern int atomic_set_long_excl(); extern int atomic_clear_long_excl(); extern void membar_enter(); extern void membar_exit(); extern void membar_producer(); extern void membar_consumer(); #endif #if defined(_KERNEL) #if defined(_LP64) || defined(_ILP32) #define atomic_add_ip atomic_add_long #define atomic_add_ip_nv atomic_add_long_nv #define casip atomic_cas_ulong #endif #if defined(__sparc) extern uint8_t ldstub(uint8_t *); #endif /* * Legacy kernel interfaces; they will go away (eventually). */ extern uint8_t cas8(uint8_t *, uint8_t, uint8_t); extern uint32_t cas32(uint32_t *, uint32_t, uint32_t); extern uint64_t cas64(uint64_t *, uint64_t, uint64_t); extern ulong_t caslong(ulong_t *, ulong_t, ulong_t); extern void *casptr(void *, void *, void *); extern void atomic_and_long(ulong_t *, ulong_t); extern void atomic_or_long(ulong_t *, ulong_t); #if defined(__sparc) extern uint32_t swapl(uint32_t *, uint32_t); #endif #endif /* _KERNEL */ #ifdef __cplusplus } #endif #endif /* _LIBSPL_ATOMIC_H */