rwlock.h revision b819cea2f73f98c5662230cc9affc8cc84f77fcf
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross/*
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * CDDL HEADER START
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross *
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * The contents of this file are subject to the terms of the
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * Common Development and Distribution License (the "License").
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * You may not use this file except in compliance with the License.
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross *
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * or http://www.opensolaris.org/os/licensing.
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * See the License for the specific language governing permissions
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * and limitations under the License.
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross *
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * When distributing Covered Code, include this CDDL HEADER in each
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * If applicable, add the following below this CDDL HEADER, with the
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * fields enclosed by brackets "[]" replaced with your own identifying
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * information: Portions Copyright [yyyy] [name of copyright owner]
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross *
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * CDDL HEADER END
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross */
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross/*
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * Use is subject to license terms.
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross *
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * Copyright 2013 Nexenta Systems, Inc. All rights reserved.
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross */
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#ifndef _SYS_RWLOCK_H
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#define _SYS_RWLOCK_H
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross/*
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross * Public interface to readers/writer locks. See rwlock(9F) for details.
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross */
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#include <sys/synch.h> /* lwp_rwlock_t */
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#ifdef __cplusplus
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern "C" {
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#endif
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rosstypedef enum {
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross RW_DRIVER = 2, /* driver (DDI) rwlock */
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross RW_DEFAULT = 4 /* kernel default rwlock */
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross} krw_type_t;
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rosstypedef enum {
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross RW_WRITER,
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross RW_READER
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross} krw_t;
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossstruct _krwlock {
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross lwp_rwlock_t rw_lock;
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross void *rw_owner;
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross};
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rosstypedef struct _krwlock krwlock_t;
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#if defined(_KERNEL) || defined(_FAKE_KERNEL)
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#define RW_READ_HELD(x) (rw_read_held((x)))
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#define RW_WRITE_HELD(x) (rw_write_held((x)))
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#define RW_LOCK_HELD(x) (rw_lock_held((x)))
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#define RW_ISWRITER(x) (rw_iswriter(x))
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern void rw_init(krwlock_t *, char *, krw_type_t, void *);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern void rw_destroy(krwlock_t *);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern void rw_enter(krwlock_t *, krw_t);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern int rw_tryenter(krwlock_t *, krw_t);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern void rw_exit(krwlock_t *);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern void rw_downgrade(krwlock_t *);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern int rw_tryupgrade(krwlock_t *);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern int rw_read_held(krwlock_t *);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern int rw_write_held(krwlock_t *);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern int rw_lock_held(krwlock_t *);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern int rw_read_locked(krwlock_t *);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern int rw_iswriter(krwlock_t *);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Rossextern void *rw_owner(krwlock_t *);
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#endif /* defined(_KERNEL) */
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#ifdef __cplusplus
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross}
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#endif
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross
b819cea2f73f98c5662230cc9affc8cc84f77fcfGordon Ross#endif /* _SYS_RWLOCK_H */