sys/dev/drm/include/linux/kref.h

   1 /*-
   2  * Copyright (c) 2010 Isilon Systems, Inc.
   3  * Copyright (c) 2010 iX Systems, Inc.
   4  * Copyright (c) 2010 Panasas, Inc.
   5  * Copyright (c) 2013 François Tigeot
   6  * All rights reserved.
   7  *
   8  * Redistribution and use in source and binary forms, with or without
   9  * modification, are permitted provided that the following conditions
  10  * are met:
  11  * 1. Redistributions of source code must retain the above copyright
  12  *    notice unmodified, this list of conditions, and the following
  13  *    disclaimer.
  14  * 2. Redistributions in binary form must reproduce the above copyright
  15  *    notice, this list of conditions and the following disclaimer in the
  16  *    documentation and/or other materials provided with the distribution.
  17  *
  18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  19  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  20  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  21  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  22  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  23  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  24  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  25  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  26  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  27  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  28  */
  29 #ifndef _LINUX_KREF_H_
  30 #define _LINUX_KREF_H_
  31
  32 #include <sys/refcount.h>
  33
  34 struct kref {
  35         atomic_t refcount;
  36 };
  37
  38 static inline void
  39 kref_init(struct kref *kref)
  40 {
  41
  42         refcount_init(&kref->refcount.counter, 1);
  43 }
  44
  45 static inline void
  46 kref_get(struct kref *kref)
  47 {
  48
  49         refcount_acquire(&kref->refcount.counter);
  50 }
  51
  52 static inline int
  53 kref_put(struct kref *kref, void (*rel)(struct kref *kref))
  54 {
  55
  56         if (refcount_release(&kref->refcount.counter)) {
  57                 rel(kref);
  58                 return 1;
  59         }
  60         return 0;
  61 }
  62
  63 static inline int
  64 kref_sub(struct kref *kref, unsigned int count,
  65              void (*rel)(struct kref *kref))
  66 {
  67         if (refcount_release_n(&kref->refcount.counter, count)) {
  68                 rel(kref);
  69                 return 1;
  70         }
  71         return 0;
  72 }
  73
  74 /*
  75  * kref_get_unless_zero: Increment refcount for object unless it is zero.
  76  */
  77 static inline int __must_check kref_get_unless_zero(struct kref *kref)
  78 {
  79         return atomic_add_unless(&kref->refcount, 1, 0);
  80 }
  81
  82 #endif /* _LINUX_KREF_H_ */