The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/geom/geom_ctl.c

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 /*-
    2  * Copyright (c) 2002 Poul-Henning Kamp
    3  * Copyright (c) 2002 Networks Associates Technology, Inc.
    4  * All rights reserved.
    5  *
    6  * This software was developed for the FreeBSD Project by Poul-Henning Kamp
    7  * and NAI Labs, the Security Research Division of Network Associates, Inc.
    8  * under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the
    9  * DARPA CHATS research program.
   10  *
   11  * Redistribution and use in source and binary forms, with or without
   12  * modification, are permitted provided that the following conditions
   13  * are met:
   14  * 1. Redistributions of source code must retain the above copyright
   15  *    notice, this list of conditions and the following disclaimer.
   16  * 2. Redistributions in binary form must reproduce the above copyright
   17  *    notice, this list of conditions and the following disclaimer in the
   18  *    documentation and/or other materials provided with the distribution.
   19  * 3. The names of the authors may not be used to endorse or promote
   20  *    products derived from this software without specific prior written
   21  *    permission.
   22  *
   23  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
   24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   26  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
   27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
   29  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
   32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   33  * SUCH DAMAGE.
   34  */
   35 
   36 #include <sys/cdefs.h>
   37 __FBSDID("$FreeBSD: releng/10.0/sys/geom/geom_ctl.c 216952 2011-01-04 10:59:38Z kib $");
   38 
   39 #include "opt_geom.h"
   40 
   41 #include <sys/param.h>
   42 #include <sys/systm.h>
   43 #include <sys/kernel.h>
   44 #include <sys/sysctl.h>
   45 #include <sys/bio.h>
   46 #include <sys/conf.h>
   47 #include <sys/disk.h>
   48 #include <sys/malloc.h>
   49 #include <sys/sysctl.h>
   50 #include <sys/sbuf.h>
   51 
   52 #include <sys/lock.h>
   53 #include <sys/mutex.h>
   54 
   55 #include <vm/vm.h>
   56 #include <vm/vm_extern.h>
   57 
   58 #include <geom/geom.h>
   59 #include <geom/geom_int.h>
   60 #define GCTL_TABLE 1
   61 #include <geom/geom_ctl.h>
   62 
   63 #include <machine/stdarg.h>
   64 
   65 static d_ioctl_t g_ctl_ioctl;
   66 
   67 static struct cdevsw g_ctl_cdevsw = {
   68         .d_version =    D_VERSION,
   69         .d_flags =      D_NEEDGIANT,
   70         .d_ioctl =      g_ctl_ioctl,
   71         .d_name =       "g_ctl",
   72 };
   73 
   74 void
   75 g_ctl_init(void)
   76 {
   77 
   78         make_dev_credf(MAKEDEV_ETERNAL, &g_ctl_cdevsw, 0, NULL,
   79             UID_ROOT, GID_OPERATOR, 0640, PATH_GEOM_CTL);
   80         KASSERT(GCTL_PARAM_RD == VM_PROT_READ,
   81                 ("GCTL_PARAM_RD != VM_PROT_READ"));
   82         KASSERT(GCTL_PARAM_WR == VM_PROT_WRITE,
   83                 ("GCTL_PARAM_WR != VM_PROT_WRITE"));
   84 }
   85 
   86 /*
   87  * Report an error back to the user in ascii format.  Return whatever copyout
   88  * returned, or EINVAL if it succeeded.
   89  */
   90 int
   91 gctl_error(struct gctl_req *req, const char *fmt, ...)
   92 {
   93         va_list ap;
   94 
   95         if (req == NULL)
   96                 return (EINVAL);
   97 
   98         /* We only record the first error */
   99         if (sbuf_done(req->serror)) {
  100                 if (!req->nerror)
  101                         req->nerror = EEXIST;
  102         }
  103         if (req->nerror)
  104                 return (req->nerror);
  105 
  106         va_start(ap, fmt);
  107         sbuf_vprintf(req->serror, fmt, ap);
  108         va_end(ap);
  109         sbuf_finish(req->serror);
  110         if (g_debugflags & G_F_CTLDUMP)
  111                 printf("gctl %p error \"%s\"\n", req, sbuf_data(req->serror));
  112         return (0);
  113 }
  114 
  115 /*
  116  * Allocate space and copyin() something.
  117  * XXX: this should really be a standard function in the kernel.
  118  */
  119 static void *
  120 geom_alloc_copyin(struct gctl_req *req, void *uaddr, size_t len)
  121 {
  122         void *ptr;
  123 
  124         ptr = g_malloc(len, M_WAITOK);
  125         if (ptr == NULL)
  126                 req->nerror = ENOMEM;
  127         else
  128                 req->nerror = copyin(uaddr, ptr, len);
  129         if (!req->nerror)
  130                 return (ptr);
  131         if (ptr != NULL)
  132                 g_free(ptr);
  133         return (NULL);
  134 }
  135 
  136 static void
  137 gctl_copyin(struct gctl_req *req)
  138 {
  139         int error, i;
  140         struct gctl_req_arg *ap;
  141         char *p;
  142 
  143         ap = geom_alloc_copyin(req, req->arg, req->narg * sizeof(*ap));
  144         if (ap == NULL) {
  145                 req->nerror = ENOMEM;
  146                 req->arg = NULL;
  147                 return;
  148         }
  149 
  150         /* Nothing have been copyin()'ed yet */
  151         for (i = 0; i < req->narg; i++) {
  152                 ap[i].flag &= ~(GCTL_PARAM_NAMEKERNEL|GCTL_PARAM_VALUEKERNEL);
  153                 ap[i].flag &= ~GCTL_PARAM_CHANGED;
  154                 ap[i].kvalue = NULL;
  155         }
  156 
  157         error = 0;
  158         for (i = 0; i < req->narg; i++) {
  159                 if (ap[i].nlen < 1 || ap[i].nlen > SPECNAMELEN) {
  160                         error = gctl_error(req,
  161                             "wrong param name length %d: %d", i, ap[i].nlen);
  162                         break;
  163                 }
  164                 p = geom_alloc_copyin(req, ap[i].name, ap[i].nlen);
  165                 if (p == NULL)
  166                         break;
  167                 if (p[ap[i].nlen - 1] != '\0') {
  168                         error = gctl_error(req, "unterminated param name");
  169                         g_free(p);
  170                         break;
  171                 }
  172                 ap[i].name = p;
  173                 ap[i].flag |= GCTL_PARAM_NAMEKERNEL;
  174                 if (ap[i].len <= 0) {
  175                         error = gctl_error(req, "negative param length");
  176                         break;
  177                 }
  178                 p = geom_alloc_copyin(req, ap[i].value, ap[i].len);
  179                 if (p == NULL)
  180                         break;
  181                 if ((ap[i].flag & GCTL_PARAM_ASCII) &&
  182                     p[ap[i].len - 1] != '\0') {
  183                         error = gctl_error(req, "unterminated param value");
  184                         g_free(p);
  185                         break;
  186                 }
  187                 ap[i].kvalue = p;
  188                 ap[i].flag |= GCTL_PARAM_VALUEKERNEL;
  189         }
  190         req->arg = ap;
  191         return;
  192 }
  193 
  194 static void
  195 gctl_copyout(struct gctl_req *req)
  196 {
  197         int error, i;
  198         struct gctl_req_arg *ap;
  199 
  200         if (req->nerror)
  201                 return;
  202         error = 0;
  203         ap = req->arg;
  204         for (i = 0; i < req->narg; i++, ap++) {
  205                 if (!(ap->flag & GCTL_PARAM_CHANGED))
  206                         continue;
  207                 error = copyout(ap->kvalue, ap->value, ap->len);
  208                 if (!error)
  209                         continue;
  210                 req->nerror = error;
  211                 return;
  212         }
  213         return;
  214 }
  215 
  216 static void
  217 gctl_free(struct gctl_req *req)
  218 {
  219         int i;
  220 
  221         if (req->arg == NULL)
  222                 return;
  223         for (i = 0; i < req->narg; i++) {
  224                 if (req->arg[i].flag & GCTL_PARAM_NAMEKERNEL)
  225                         g_free(req->arg[i].name);
  226                 if ((req->arg[i].flag & GCTL_PARAM_VALUEKERNEL) &&
  227                     req->arg[i].len > 0)
  228                         g_free(req->arg[i].kvalue);
  229         }
  230         g_free(req->arg);
  231         sbuf_delete(req->serror);
  232 }
  233 
  234 static void
  235 gctl_dump(struct gctl_req *req)
  236 {
  237         u_int i;
  238         int j;
  239         struct gctl_req_arg *ap;
  240 
  241         printf("Dump of gctl request at %p:\n", req);
  242         if (req->nerror > 0) {
  243                 printf("  nerror:\t%d\n", req->nerror);
  244                 if (sbuf_len(req->serror) > 0)
  245                         printf("  error:\t\"%s\"\n", sbuf_data(req->serror));
  246         }
  247         for (i = 0; i < req->narg; i++) {
  248                 ap = &req->arg[i];
  249                 if (!(ap->flag & GCTL_PARAM_NAMEKERNEL))
  250                         printf("  param:\t%d@%p", ap->nlen, ap->name);
  251                 else
  252                         printf("  param:\t\"%s\"", ap->name);
  253                 printf(" [%s%s%d] = ",
  254                     ap->flag & GCTL_PARAM_RD ? "R" : "",
  255                     ap->flag & GCTL_PARAM_WR ? "W" : "",
  256                     ap->len);
  257                 if (!(ap->flag & GCTL_PARAM_VALUEKERNEL)) {
  258                         printf(" =@ %p", ap->value);
  259                 } else if (ap->flag & GCTL_PARAM_ASCII) {
  260                         printf("\"%s\"", (char *)ap->kvalue);
  261                 } else if (ap->len > 0) {
  262                         for (j = 0; j < ap->len && j < 512; j++)
  263                                 printf(" %02x", ((u_char *)ap->kvalue)[j]);
  264                 } else {
  265                         printf(" = %p", ap->kvalue);
  266                 }
  267                 printf("\n");
  268         }
  269 }
  270 
  271 int
  272 gctl_set_param(struct gctl_req *req, const char *param, void const *ptr,
  273     int len)
  274 {
  275         int i;
  276         struct gctl_req_arg *ap;
  277 
  278         for (i = 0; i < req->narg; i++) {
  279                 ap = &req->arg[i];
  280                 if (strcmp(param, ap->name))
  281                         continue;
  282                 if (!(ap->flag & GCTL_PARAM_WR))
  283                         return (EPERM);
  284                 ap->flag |= GCTL_PARAM_CHANGED;
  285                 if (ap->len < len) {
  286                         bcopy(ptr, ap->kvalue, ap->len);
  287                         return (ENOSPC);
  288                 }
  289                 bcopy(ptr, ap->kvalue, len);
  290                 return (0);
  291         }
  292         return (EINVAL);
  293 }
  294 
  295 void
  296 gctl_set_param_err(struct gctl_req *req, const char *param, void const *ptr,
  297     int len)
  298 {
  299 
  300         switch (gctl_set_param(req, param, ptr, len)) {
  301         case EPERM:
  302                 gctl_error(req, "No write access %s argument", param);
  303                 break;
  304         case ENOSPC:
  305                 gctl_error(req, "Wrong length %s argument", param);
  306                 break;
  307         case EINVAL:
  308                 gctl_error(req, "Missing %s argument", param);
  309                 break;
  310         }
  311 }
  312 
  313 void *
  314 gctl_get_param(struct gctl_req *req, const char *param, int *len)
  315 {
  316         int i;
  317         void *p;
  318         struct gctl_req_arg *ap;
  319 
  320         for (i = 0; i < req->narg; i++) {
  321                 ap = &req->arg[i];
  322                 if (strcmp(param, ap->name))
  323                         continue;
  324                 if (!(ap->flag & GCTL_PARAM_RD))
  325                         continue;
  326                 p = ap->kvalue;
  327                 if (len != NULL)
  328                         *len = ap->len;
  329                 return (p);
  330         }
  331         return (NULL);
  332 }
  333 
  334 char const *
  335 gctl_get_asciiparam(struct gctl_req *req, const char *param)
  336 {
  337         int i;
  338         char const *p;
  339         struct gctl_req_arg *ap;
  340 
  341         for (i = 0; i < req->narg; i++) {
  342                 ap = &req->arg[i];
  343                 if (strcmp(param, ap->name))
  344                         continue;
  345                 if (!(ap->flag & GCTL_PARAM_RD))
  346                         continue;
  347                 p = ap->kvalue;
  348                 if (ap->len < 1) {
  349                         gctl_error(req, "No length argument (%s)", param);
  350                         return (NULL);
  351                 }
  352                 if (p[ap->len - 1] != '\0') {
  353                         gctl_error(req, "Unterminated argument (%s)", param);
  354                         return (NULL);
  355                 }
  356                 return (p);
  357         }
  358         return (NULL);
  359 }
  360 
  361 void *
  362 gctl_get_paraml(struct gctl_req *req, const char *param, int len)
  363 {
  364         int i;
  365         void *p;
  366 
  367         p = gctl_get_param(req, param, &i);
  368         if (p == NULL)
  369                 gctl_error(req, "Missing %s argument", param);
  370         else if (i != len) {
  371                 p = NULL;
  372                 gctl_error(req, "Wrong length %s argument", param);
  373         }
  374         return (p);
  375 }
  376 
  377 struct g_class *
  378 gctl_get_class(struct gctl_req *req, char const *arg)
  379 {
  380         char const *p;
  381         struct g_class *cp;
  382 
  383         p = gctl_get_asciiparam(req, arg);
  384         if (p == NULL)
  385                 return (NULL);
  386         LIST_FOREACH(cp, &g_classes, class) {
  387                 if (!strcmp(p, cp->name))
  388                         return (cp);
  389         }
  390         return (NULL);
  391 }
  392 
  393 struct g_geom *
  394 gctl_get_geom(struct gctl_req *req, struct g_class *mpr, char const *arg)
  395 {
  396         char const *p;
  397         struct g_class *mp;
  398         struct g_geom *gp;
  399 
  400         p = gctl_get_asciiparam(req, arg);
  401         if (p == NULL)
  402                 return (NULL);
  403         LIST_FOREACH(mp, &g_classes, class) {
  404                 if (mpr != NULL && mpr != mp)
  405                         continue;
  406                 LIST_FOREACH(gp, &mp->geom, geom) {
  407                         if (!strcmp(p, gp->name))
  408                                 return (gp);
  409                 }
  410         }
  411         gctl_error(req, "Geom not found: \"%s\"", p);
  412         return (NULL);
  413 }
  414 
  415 struct g_provider *
  416 gctl_get_provider(struct gctl_req *req, char const *arg)
  417 {
  418         char const *p;
  419         struct g_provider *pp;
  420 
  421         p = gctl_get_asciiparam(req, arg);
  422         if (p == NULL)
  423                 return (NULL);
  424         pp = g_provider_by_name(p);
  425         if (pp != NULL)
  426                 return (pp);
  427         gctl_error(req, "Provider not found: \"%s\"", p);
  428         return (NULL);
  429 }
  430 
  431 static void
  432 g_ctl_req(void *arg, int flag __unused)
  433 {
  434         struct g_class *mp;
  435         struct gctl_req *req;
  436         char const *verb;
  437 
  438         g_topology_assert();
  439         req = arg;
  440         mp = gctl_get_class(req, "class");
  441         if (mp == NULL) {
  442                 gctl_error(req, "Class not found");
  443                 return;
  444         }
  445         if (mp->ctlreq == NULL) {
  446                 gctl_error(req, "Class takes no requests");
  447                 return;
  448         }
  449         verb = gctl_get_param(req, "verb", NULL);
  450         if (verb == NULL) {
  451                 gctl_error(req, "Verb missing");
  452                 return;
  453         }
  454         mp->ctlreq(req, mp, verb);
  455         g_topology_assert();
  456 }
  457 
  458 
  459 static int
  460 g_ctl_ioctl_ctl(struct cdev *dev, u_long cmd, caddr_t data, int fflag, struct thread *td)
  461 {
  462         struct gctl_req *req;
  463         int nerror;
  464 
  465         req = (void *)data;
  466         req->nerror = 0;
  467         req->serror = sbuf_new_auto();
  468         /* It is an error if we cannot return an error text */
  469         if (req->lerror < 2)
  470                 return (EINVAL);
  471         if (!useracc(req->error, req->lerror, VM_PROT_WRITE))
  472                 return (EINVAL);
  473 
  474         /* Check the version */
  475         if (req->version != GCTL_VERSION)
  476                 return (gctl_error(req,
  477                     "kernel and libgeom version mismatch."));
  478         
  479         /* Get things on board */
  480         gctl_copyin(req);
  481 
  482         if (g_debugflags & G_F_CTLDUMP)
  483                 gctl_dump(req);
  484 
  485         if (!req->nerror) {
  486                 g_waitfor_event(g_ctl_req, req, M_WAITOK, NULL);
  487                 gctl_copyout(req);
  488         }
  489         if (sbuf_done(req->serror)) {
  490                 req->nerror = copyout(sbuf_data(req->serror), req->error,
  491                     imin(req->lerror, sbuf_len(req->serror) + 1));
  492         }
  493 
  494         nerror = req->nerror;
  495         gctl_free(req);
  496         return (nerror);
  497 }
  498 
  499 static int
  500 g_ctl_ioctl(struct cdev *dev, u_long cmd, caddr_t data, int fflag, struct thread *td)
  501 {
  502         int error;
  503 
  504         switch(cmd) {
  505         case GEOM_CTL:
  506                 error = g_ctl_ioctl_ctl(dev, cmd, data, fflag, td);
  507                 break;
  508         default:
  509                 error = ENOIOCTL;
  510                 break;
  511         }
  512         return (error);
  513 
  514 }

Cache object: 37b14787ba2633a85162b9bb2dc3bf81


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.