sys/ofed/include/linux/sysfs.h

   1 /*-
   2  * Copyright (c) 2010 Isilon Systems, Inc.
   3  * Copyright (c) 2010 iX Systems, Inc.
   4  * Copyright (c) 2010 Panasas, Inc.
   5  * All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  * 1. Redistributions of source code must retain the above copyright
  11  *    notice unmodified, this list of conditions, and the following
  12  *    disclaimer.
  13  * 2. Redistributions in binary form must reproduce the above copyright
  14  *    notice, this list of conditions and the following disclaimer in the
  15  *    documentation and/or other materials provided with the distribution.
  16  *
  17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27  */
  28
  29 #ifndef _LINUX_SYSFS_H_
  30 #define _LINUX_SYSFS_H_
  31
  32 #include <sys/sysctl.h>
  33
  34 struct attribute {
  35         const char      *name;
  36         struct module   *owner;
  37         mode_t          mode;
  38 };
  39
  40 struct sysfs_ops {
  41         ssize_t (*show)(struct kobject *, struct attribute *, char *);
  42         ssize_t (*store)(struct kobject *, struct attribute *, const char *,
  43             size_t);
  44 };
  45
  46 struct attribute_group {
  47         const char              *name;
  48         mode_t                  (*is_visible)(struct kobject *,
  49                                     struct attribute *, int);
  50         struct attribute        **attrs;
  51 };
  52
  53 #define __ATTR(_name, _mode, _show, _store) {                           \
  54         .attr = { .name = __stringify(_name), .mode = _mode },          \
  55         .show = _show, .store  = _store,                                \
  56 }
  57
  58 #define __ATTR_RO(_name) {                                              \
  59         .attr = { .name = __stringify(_name), .mode = 0444 },           \
  60         .show   = _name##_show,                                         \
  61 }
  62
  63 #define __ATTR_NULL     { .attr = { .name = NULL } }
  64
  65 /*
  66  * Handle our generic '\0' terminated 'C' string.
  67  * Two cases:
  68  *      a variable string:  point arg1 at it, arg2 is max length.
  69  *      a constant string:  point arg1 at it, arg2 is zero.
  70  */
  71
  72 static inline int
  73 sysctl_handle_attr(SYSCTL_HANDLER_ARGS)
  74 {
  75         struct kobject *kobj;
  76         struct attribute *attr;
  77         const struct sysfs_ops *ops;
  78         void *buf;
  79         int error;
  80         ssize_t len;
  81
  82         kobj = arg1;
  83         attr = (struct attribute *)arg2;
  84         buf = (void *)get_zeroed_page(GFP_KERNEL);
  85         len = 1;        /* Copy out a NULL byte at least. */
  86         if (kobj->ktype == NULL || kobj->ktype->sysfs_ops == NULL)
  87                 return (ENODEV);
  88         ops = kobj->ktype->sysfs_ops;
  89         if (buf == NULL)
  90                 return (ENOMEM);
  91         if (ops->show) {
  92                 len = ops->show(kobj, attr, buf);
  93                 /*
  94                  * It's valid not to have a 'show' so we just return 1 byte
  95                  * of NULL.
  96                  */
  97                 if (len < 0) {
  98                         error = -len;
  99                         len = 1;
 100                         if (error != EIO)
 101                                 goto out;
 102                 }
 103         }
 104         error = SYSCTL_OUT(req, buf, len);
 105         if (error || !req->newptr || ops->store == NULL)
 106                 goto out;
 107         error = SYSCTL_IN(req, buf, PAGE_SIZE);
 108         if (error)
 109                 goto out;
 110         len = ops->store(kobj, attr, buf, req->newlen);
 111         if (len < 0)
 112                 error = -len;
 113 out:
 114         free_page((unsigned long)buf);
 115
 116         return (error);
 117 }
 118
 119 static inline int
 120 sysfs_create_file(struct kobject *kobj, const struct attribute *attr)
 121 {
 122
 123         sysctl_add_oid(NULL, SYSCTL_CHILDREN(kobj->oidp), OID_AUTO,
 124             attr->name, CTLTYPE_STRING|CTLFLAG_RW|CTLFLAG_MPSAFE, kobj,
 125             (uintptr_t)attr, sysctl_handle_attr, "A", "");
 126
 127         return (0);
 128 }
 129
 130 static inline void
 131 sysfs_remove_file(struct kobject *kobj, const struct attribute *attr)
 132 {
 133
 134         if (kobj->oidp)
 135                 sysctl_remove_name(kobj->oidp, attr->name, 1, 1);
 136 }
 137
 138 static inline void
 139 sysfs_remove_group(struct kobject *kobj, const struct attribute_group *grp)
 140 {
 141
 142         if (kobj->oidp)
 143                 sysctl_remove_name(kobj->oidp, grp->name, 1, 1);
 144 }
 145
 146 static inline int
 147 sysfs_create_group(struct kobject *kobj, const struct attribute_group *grp)
 148 {
 149         struct attribute **attr;
 150         struct sysctl_oid *oidp;
 151
 152         oidp = SYSCTL_ADD_NODE(NULL, SYSCTL_CHILDREN(kobj->oidp),
 153             OID_AUTO, grp->name, CTLFLAG_RD|CTLFLAG_MPSAFE, NULL, grp->name);
 154         for (attr = grp->attrs; *attr != NULL; attr++) {
 155                 sysctl_add_oid(NULL, SYSCTL_CHILDREN(oidp), OID_AUTO,
 156                     (*attr)->name, CTLTYPE_STRING|CTLFLAG_RW|CTLFLAG_MPSAFE,
 157                     kobj, (uintptr_t)*attr, sysctl_handle_attr, "A", "");
 158         }
 159
 160         return (0);
 161 }
 162
 163 static inline int
 164 sysfs_create_dir(struct kobject *kobj)
 165 {
 166
 167         kobj->oidp = SYSCTL_ADD_NODE(NULL, SYSCTL_CHILDREN(kobj->parent->oidp),
 168             OID_AUTO, kobj->name, CTLFLAG_RD|CTLFLAG_MPSAFE, NULL, kobj->name);
 169
 170         return (0);
 171 }
 172
 173 static inline void
 174 sysfs_remove_dir(struct kobject *kobj)
 175 {
 176
 177         if (kobj->oidp == NULL)
 178                 return;
 179         sysctl_remove_oid(kobj->oidp, 1, 1);
 180 }
 181
 182 #endif  /* _LINUX_SYSFS_H_ */