usr.sbin/memcontrol/memcontrol.c

   1 /*-
   2  * Copyright (c) 1999 Michael Smith <msmith@freebsd.org>
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24  * SUCH DAMAGE.
  25  *
  26  * $FreeBSD: src/usr.sbin/memcontrol/memcontrol.c,v 1.3.4.5 2002/09/16 21:58:41 dwmalone Exp $
  27  */
  28
  29 #include <sys/types.h>
  30 #include <sys/ioctl.h>
  31 #include <sys/memrange.h>
  32
  33 #include <err.h>
  34 #include <fcntl.h>
  35 #include <paths.h>
  36 #include <stdio.h>
  37 #include <stdlib.h>
  38 #include <string.h>
  39 #include <unistd.h>
  40
  41 struct
  42 {
  43     const char  *name;
  44     int         val;
  45     int         kind;
  46 #define MDF_SETTABLE    (1<<0)
  47 } attrnames[] = {
  48     {"uncacheable",     MDF_UNCACHEABLE,        MDF_SETTABLE},
  49     {"write-combine",   MDF_WRITECOMBINE,       MDF_SETTABLE},
  50     {"write-through",   MDF_WRITETHROUGH,       MDF_SETTABLE},
  51     {"write-back",      MDF_WRITEBACK,          MDF_SETTABLE},
  52     {"write-protect",   MDF_WRITEPROTECT,       MDF_SETTABLE},
  53     {"force",           MDF_FORCE,              MDF_SETTABLE},
  54     {"unknown",         MDF_UNKNOWN,            0},
  55     {"fixed-base",      MDF_FIXBASE,            0},
  56     {"fixed-length",    MDF_FIXLEN,             0},
  57     {"set-by-firmware", MDF_FIRMWARE,           0},
  58     {"active",          MDF_ACTIVE,             MDF_SETTABLE},
  59     {"bogus",           MDF_BOGUS,              0},
  60     {NULL,              0,                      0}
  61 };
  62
  63 static void     listfunc(int memfd, int argc, char *argv[]);
  64 static void     setfunc(int memfd, int argc, char *argv[]);
  65 static void     clearfunc(int memfd, int argc, char *argv[]);
  66 static void     helpfunc(int memfd, int argc, char *argv[]);
  67 static void     help(const char *what);
  68
  69 struct
  70 {
  71     const char  *cmd;
  72     const char  *desc;
  73     void        (*func)(int memfd, int argc, char *argv[]);
  74 } functions[] = {
  75     {"list",
  76      "List current memory range attributes\n"
  77      "    list [-a]\n"
  78      "        -a    list all range slots, even those that are inactive",
  79      listfunc},
  80     {"set",
  81      "Set memory range attributes\n"
  82      "    set -b <base> -l <length> -o <owner> <attribute>\n"
  83      "        <base>      memory range base address\n"
  84      "        <length>    length of memory range in bytes, power of 2\n"
  85      "        <owner>     text identifier for this setting (7 char max)\n"
  86      "        <attribute> attribute(s) to be applied to this range:\n"
  87      "                        uncacheable\n"
  88      "                        write-combine\n"
  89      "                        write-through\n"
  90      "                        write-back\n"
  91      "                        write-protect",
  92      setfunc},
  93     {"clear",
  94      "Clear memory range attributes\n"
  95      "    clear -o <owner>\n"
  96      "        <owner>     all ranges with this owner will be cleared\n"
  97      "    clear -b <base> -l <length>\n"
  98      "        <base>      memory range base address\n"
  99      "        <length>    length of memory range in bytes, power of 2\n"
 100      "                    Base and length must exactly match an existing range",
 101      clearfunc},
 102     {NULL,      NULL,                                   helpfunc}
 103 };
 104
 105 int
 106 main(int argc, char *argv[])
 107 {
 108     int         i, memfd;
 109
 110     if (argc < 2) {
 111         help(NULL);
 112     } else {
 113         if ((memfd = open(_PATH_MEM, O_RDONLY)) == -1)
 114             err(1, "can't open %s", _PATH_MEM);
 115
 116         for (i = 0; functions[i].cmd != NULL; i++)
 117             if (!strcmp(argv[1], functions[i].cmd))
 118                 break;
 119         functions[i].func(memfd, argc - 1, argv + 1);
 120         close(memfd);
 121     }
 122     return(0);
 123 }
 124
 125 static struct mem_range_desc *
 126 mrgetall(int memfd, int *nmr)
 127 {
 128     struct mem_range_desc       *mrd;
 129     struct mem_range_op         mro;
 130
 131     mro.mo_arg[0] = 0;
 132     if (ioctl(memfd, MEMRANGE_GET, &mro))
 133         err(1, "can't size range descriptor array");
 134
 135     *nmr = mro.mo_arg[0];
 136     mrd = malloc(*nmr * sizeof(struct mem_range_desc));
 137     if (mrd == NULL)
 138         errx(1, "can't allocate %zu bytes for %d range descriptors",
 139              *nmr * sizeof(struct mem_range_desc), *nmr);
 140
 141     mro.mo_arg[0] = *nmr;
 142     mro.mo_desc = mrd;
 143     if (ioctl(memfd, MEMRANGE_GET, &mro))
 144         err(1, "can't fetch range descriptor array");
 145
 146     return(mrd);
 147 }
 148
 149
 150 static void
 151 listfunc(int memfd, int argc, char *argv[])
 152 {
 153     struct mem_range_desc       *mrd;
 154     int                         nd, i, j;
 155     int                         ch;
 156     int                         showall = 0;
 157     char                        *owner;
 158
 159     owner = NULL;
 160     while ((ch = getopt(argc, argv, "ao:")) != -1)
 161         switch(ch) {
 162         case 'a':
 163             showall = 1;
 164             break;
 165         case 'o':
 166             owner = strdup(optarg);
 167             break;
 168         case '?':
 169         default:
 170             help("list");
 171         }
 172
 173     mrd = mrgetall(memfd, &nd);
 174
 175     for (i = 0; i < nd; i++) {
 176         if (!showall && !(mrd[i].mr_flags & MDF_ACTIVE))
 177             continue;
 178         if (owner && strcmp(mrd[i].mr_owner, owner))
 179             continue;
 180         printf("%jx/%jx %.8s ",
 181                (uintmax_t)mrd[i].mr_base, (uintmax_t)mrd[i].mr_len,
 182                mrd[i].mr_owner[0] ? mrd[i].mr_owner : "-");
 183         for (j = 0; attrnames[j].name != NULL; j++)
 184             if (mrd[i].mr_flags & attrnames[j].val)
 185                 printf("%s ", attrnames[j].name);
 186         printf("\n");
 187     }
 188     free(mrd);
 189     if (owner)
 190         free(owner);
 191 }
 192
 193 static void
 194 setfunc(int memfd, int argc, char *argv[])
 195 {
 196     struct mem_range_desc       mrd;
 197     struct mem_range_op         mro;
 198     int                         i;
 199     int                         ch;
 200     char                        *ep;
 201
 202     mrd.mr_base = 0;
 203     mrd.mr_len = 0;
 204     mrd.mr_flags = 0;
 205     strcpy(mrd.mr_owner, "user");
 206     while ((ch = getopt(argc, argv, "b:l:o:")) != -1)
 207         switch(ch) {
 208         case 'b':
 209             mrd.mr_base = strtouq(optarg, &ep, 0);
 210             if ((ep == optarg) || (*ep != 0))
 211                 help("set");
 212             break;
 213         case 'l':
 214             mrd.mr_len = strtouq(optarg, &ep, 0);
 215             if ((ep == optarg) || (*ep != 0))
 216                 help("set");
 217             break;
 218         case 'o':
 219             if ((*optarg == 0) || (strlen(optarg) > 7))
 220                 help("set");
 221             strcpy(mrd.mr_owner, optarg);
 222             break;
 223
 224         case '?':
 225         default:
 226             help("set");
 227         }
 228
 229     if (mrd.mr_len == 0)
 230         help("set");
 231
 232     argc -= optind;
 233     argv += optind;
 234
 235     while(argc--) {
 236         for (i = 0; attrnames[i].name != NULL; i++) {
 237             if (!strcmp(attrnames[i].name, argv[0])) {
 238                 if (!(attrnames[i].kind & MDF_SETTABLE))
 239                     help("flags");
 240                 mrd.mr_flags |= attrnames[i].val;
 241                 break;
 242             }
 243         }
 244         if (attrnames[i].name == NULL)
 245             help("flags");
 246         argv++;
 247     }
 248
 249     mro.mo_desc = &mrd;
 250     mro.mo_arg[0] = 0;
 251     if (ioctl(memfd, MEMRANGE_SET, &mro))
 252         err(1, "can't set range");
 253 }
 254
 255 static void
 256 clearfunc(int memfd, int argc, char *argv[])
 257 {
 258     struct mem_range_desc       mrd, *mrdp;
 259     struct mem_range_op         mro;
 260     int                         i, nd;
 261     int                         ch;
 262     char                        *ep, *owner;
 263
 264     mrd.mr_base = 0;
 265     mrd.mr_len = 0;
 266     owner = NULL;
 267     while ((ch = getopt(argc, argv, "b:l:o:")) != -1)
 268         switch(ch) {
 269         case 'b':
 270             mrd.mr_base = strtouq(optarg, &ep, 0);
 271             if ((ep == optarg) || (*ep != 0))
 272                 help("clear");
 273             break;
 274         case 'l':
 275             mrd.mr_len = strtouq(optarg, &ep, 0);
 276             if ((ep == optarg) || (*ep != 0))
 277                 help("clear");
 278             break;
 279         case 'o':
 280             if ((*optarg == 0) || (strlen(optarg) > 7))
 281                 help("clear");
 282             owner = strdup(optarg);
 283             break;
 284
 285         case '?':
 286         default:
 287             help("clear");
 288         }
 289
 290     if (owner != NULL) {
 291         /* clear-by-owner */
 292         if ((mrd.mr_base != 0) || (mrd.mr_len != 0))
 293             help("clear");
 294
 295         mrdp = mrgetall(memfd, &nd);
 296         mro.mo_arg[0] = MEMRANGE_SET_REMOVE;
 297         for (i = 0; i < nd; i++) {
 298             if (!strcmp(owner, mrdp[i].mr_owner) &&
 299                 (mrdp[i].mr_flags & MDF_ACTIVE) &&
 300                 !(mrdp[i].mr_flags & MDF_FIXACTIVE)) {
 301
 302                 mro.mo_desc = mrdp + i;
 303                 if (ioctl(memfd, MEMRANGE_SET, &mro))
 304                     warn("couldn't clear range owned by '%s'", owner);
 305             }
 306         }
 307     } else if (mrd.mr_len != 0) {
 308         /* clear-by-base/len */
 309         mro.mo_arg[0] = MEMRANGE_SET_REMOVE;
 310         mro.mo_desc = &mrd;
 311         if (ioctl(memfd, MEMRANGE_SET, &mro))
 312             err(1, "couldn't clear range");
 313     } else {
 314         help("clear");
 315     }
 316 }
 317
 318 static void
 319 helpfunc(int memfd __unused, int argc __unused, char *argv[])
 320 {
 321     help(argv[1]);
 322 }
 323
 324 static void
 325 help(const char *what)
 326 {
 327     int         i;
 328
 329     if (what != NULL) {
 330         /* find a function that matches */
 331         for (i = 0; functions[i].cmd != NULL; i++)
 332             if (!strcmp(what, functions[i].cmd)) {
 333                 fprintf(stderr, "%s\n", functions[i].desc);
 334                 return;
 335             }
 336         fprintf(stderr, "Unknown command '%s'\n", what);
 337     }
 338
 339     /* print general help */
 340     fprintf(stderr, "Valid commands are :\n");
 341     for (i = 0; functions[i].cmd != NULL; i++)
 342         fprintf(stderr, "    %s\n", functions[i].cmd);
 343     fprintf(stderr, "Use help <command> for command-specific help\n");
 344 }