qemu_cgroup.c 37.8 KB
Newer Older
1 2 3
/*
 * qemu_cgroup.c: QEMU cgroup management
 *
4
 * Copyright (C) 2006-2015 Red Hat, Inc.
5 6 7 8 9 10 11 12 13 14 15 16 17
 * Copyright (C) 2006 Daniel P. Berrange
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
18
 * License along with this library.  If not, see
O
Osier Yang 已提交
19
 * <http://www.gnu.org/licenses/>.
20 21 22 23 24 25 26
 *
 * Author: Daniel P. Berrange <berrange@redhat.com>
 */

#include <config.h>

#include "qemu_cgroup.h"
27
#include "qemu_domain.h"
28
#include "qemu_process.h"
29
#include "vircgroup.h"
30
#include "virlog.h"
31
#include "viralloc.h"
32
#include "virerror.h"
33
#include "domain_audit.h"
34
#include "virscsi.h"
35
#include "virstring.h"
36
#include "virfile.h"
37
#include "virtypedparam.h"
38
#include "virnuma.h"
39 40 41

#define VIR_FROM_THIS VIR_FROM_QEMU

42 43
VIR_LOG_INIT("qemu.qemu_cgroup");

44 45 46 47
static const char *const defaultDeviceACL[] = {
    "/dev/null", "/dev/full", "/dev/zero",
    "/dev/random", "/dev/urandom",
    "/dev/ptmx", "/dev/kvm", "/dev/kqemu",
48
    "/dev/rtc", "/dev/hpet", "/dev/vfio/vfio",
49 50 51 52 53
    NULL,
};
#define DEVICE_PTY_MAJOR 136
#define DEVICE_SND_MAJOR 116

54 55 56 57 58
static int
qemuSetImageCgroupInternal(virDomainObjPtr vm,
                           virStorageSourcePtr src,
                           bool deny,
                           bool forceReadonly)
59
{
60
    qemuDomainObjPrivatePtr priv = vm->privateData;
61
    int perms = VIR_CGROUP_DEVICE_READ;
62
    int ret;
63

64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80
    if (!virCgroupHasController(priv->cgroup,
                                VIR_CGROUP_CONTROLLER_DEVICES))
        return 0;

    if (!src->path || !virStorageSourceIsLocalStorage(src)) {
        VIR_DEBUG("Not updating cgroups for disk path '%s', type: %s",
                  NULLSTR(src->path), virStorageTypeToString(src->type));
        return 0;
    }

    if (deny) {
        perms |= VIR_CGROUP_DEVICE_WRITE | VIR_CGROUP_DEVICE_MKNOD;

        VIR_DEBUG("Deny path %s", src->path);

        ret = virCgroupDenyDevicePath(priv->cgroup, src->path, perms);
    } else {
81
        if (!src->readonly && !forceReadonly)
82 83 84 85 86 87 88 89 90 91 92 93 94
            perms |= VIR_CGROUP_DEVICE_WRITE;

        VIR_DEBUG("Allow path %s, perms: %s",
                  src->path, virCgroupGetDevicePermsString(perms));

        ret = virCgroupAllowDevicePath(priv->cgroup, src->path, perms);
    }

    virDomainAuditCgroupPath(vm, priv->cgroup,
                             deny ? "deny" : "allow",
                             src->path,
                             virCgroupGetDevicePermsString(perms),
                             ret == 0);
95 96 97 98

    /* Get this for root squash NFS */
    if (ret < 0 &&
        virLastErrorIsSystemErrno(EACCES)) {
99
        VIR_DEBUG("Ignoring EACCES for %s", src->path);
100 101
        virResetLastError();
        ret = 0;
102
    }
103

104
    return ret;
105 106 107
}


108 109 110 111 112 113 114 115 116
int
qemuSetImageCgroup(virDomainObjPtr vm,
                   virStorageSourcePtr src,
                   bool deny)
{
    return qemuSetImageCgroupInternal(vm, src, deny, false);
}


117 118 119
int
qemuSetupDiskCgroup(virDomainObjPtr vm,
                    virDomainDiskDefPtr disk)
120
{
121
    virStorageSourcePtr next;
122
    bool forceReadonly = false;
123

124
    for (next = disk->src; next; next = next->backingStore) {
125
        if (qemuSetImageCgroupInternal(vm, next, false, forceReadonly) < 0)
126
            return -1;
127 128 129

        /* setup only the top level image for read-write */
        forceReadonly = true;
130
    }
131 132

    return 0;
133 134 135
}


136 137 138
int
qemuTeardownDiskCgroup(virDomainObjPtr vm,
                       virDomainDiskDefPtr disk)
139
{
140
    virStorageSourcePtr next;
141

142 143 144 145
    for (next = disk->src; next; next = next->backingStore) {
        if (qemuSetImageCgroup(vm, next, true) < 0)
            return -1;
    }
146

147
    return 0;
148 149
}

150

151
static int
152
qemuSetupChrSourceCgroup(virDomainDefPtr def ATTRIBUTE_UNUSED,
153
                         virDomainChrSourceDefPtr dev,
154
                         void *opaque)
155
{
156 157
    virDomainObjPtr vm = opaque;
    qemuDomainObjPrivatePtr priv = vm->privateData;
158
    int ret;
159

160
    if (dev->type != VIR_DOMAIN_CHR_TYPE_DEV)
161 162
        return 0;

163
    VIR_DEBUG("Process path '%s' for device", dev->data.file.path);
164

165 166
    ret = virCgroupAllowDevicePath(priv->cgroup, dev->data.file.path,
                                   VIR_CGROUP_DEVICE_RW);
167
    virDomainAuditCgroupPath(vm, priv->cgroup, "allow",
168
                             dev->data.file.path, "rw", ret == 0);
169

170
    return ret;
171 172
}

173 174 175 176 177
static int
qemuSetupChardevCgroup(virDomainDefPtr def,
                       virDomainChrDefPtr dev,
                       void *opaque)
{
178
    return qemuSetupChrSourceCgroup(def, &dev->source, opaque);
179 180 181 182 183 184
}


static int
qemuSetupTPMCgroup(virDomainDefPtr def,
                   virDomainTPMDefPtr dev,
185
                   void *opaque)
186
{
187
    int ret = 0;
188 189 190

    switch (dev->type) {
    case VIR_DOMAIN_TPM_TYPE_PASSTHROUGH:
191 192
        ret = qemuSetupChrSourceCgroup(def, &dev->data.passthrough.source,
                                       opaque);
193 194 195 196 197
        break;
    case VIR_DOMAIN_TPM_TYPE_LAST:
        break;
    }

198
    return ret;
199 200
}

201

202
static int
203
qemuSetupHostUSBDeviceCgroup(virUSBDevicePtr dev ATTRIBUTE_UNUSED,
204 205
                             const char *path,
                             void *opaque)
206
{
207 208
    virDomainObjPtr vm = opaque;
    qemuDomainObjPrivatePtr priv = vm->privateData;
209
    int ret;
210 211

    VIR_DEBUG("Process path '%s' for USB device", path);
212 213 214
    ret = virCgroupAllowDevicePath(priv->cgroup, path,
                                   VIR_CGROUP_DEVICE_RW);
    virDomainAuditCgroupPath(vm, priv->cgroup, "allow", path, "rw", ret == 0);
215

216
    return ret;
217 218
}

219
static int
220
qemuSetupHostSCSIDeviceCgroup(virSCSIDevicePtr dev ATTRIBUTE_UNUSED,
221 222 223 224 225
                              const char *path,
                              void *opaque)
{
    virDomainObjPtr vm = opaque;
    qemuDomainObjPrivatePtr priv = vm->privateData;
226
    int ret;
227 228 229

    VIR_DEBUG("Process path '%s' for SCSI device", path);

230 231 232 233
    ret = virCgroupAllowDevicePath(priv->cgroup, path,
                                   virSCSIDeviceGetReadonly(dev) ?
                                   VIR_CGROUP_DEVICE_READ :
                                   VIR_CGROUP_DEVICE_RW);
234 235

    virDomainAuditCgroupPath(vm, priv->cgroup, "allow", path,
236
                             virSCSIDeviceGetReadonly(dev) ? "r" : "rw", ret == 0);
237

238
    return ret;
239
}
240

241 242 243 244 245 246
int
qemuSetupHostdevCGroup(virDomainObjPtr vm,
                       virDomainHostdevDefPtr dev)
{
    int ret = -1;
    qemuDomainObjPrivatePtr priv = vm->privateData;
247
    virDomainHostdevSubsysUSBPtr usbsrc = &dev->source.subsys.u.usb;
248
    virDomainHostdevSubsysPCIPtr pcisrc = &dev->source.subsys.u.pci;
249
    virDomainHostdevSubsysSCSIPtr scsisrc = &dev->source.subsys.u.scsi;
250
    virPCIDevicePtr pci = NULL;
251
    virUSBDevicePtr usb = NULL;
252
    virSCSIDevicePtr scsi = NULL;
253 254 255 256 257 258 259 260 261 262 263 264 265 266
    char *path = NULL;

    /* currently this only does something for PCI devices using vfio
     * for device assignment, but it is called for *all* hostdev
     * devices.
     */

    if (!virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_DEVICES))
        return 0;

    if (dev->mode == VIR_DOMAIN_HOSTDEV_MODE_SUBSYS) {

        switch (dev->source.subsys.type) {
        case VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_PCI:
267
            if (pcisrc->backend == VIR_DOMAIN_HOSTDEV_PCI_BACKEND_VFIO) {
268
                int rv;
269

270 271 272 273
                pci = virPCIDeviceNew(pcisrc->addr.domain,
                                      pcisrc->addr.bus,
                                      pcisrc->addr.slot,
                                      pcisrc->addr.function);
274 275 276
                if (!pci)
                    goto cleanup;

277
                if (!(path = virPCIDeviceGetIOMMUGroupDev(pci)))
278 279 280
                    goto cleanup;

                VIR_DEBUG("Cgroup allow %s for PCI device assignment", path);
281
                rv = virCgroupAllowDevicePath(priv->cgroup, path,
282 283
                                              VIR_CGROUP_DEVICE_RW);
                virDomainAuditCgroupPath(vm, priv->cgroup,
284 285
                                         "allow", path, "rw", rv == 0);
                if (rv < 0)
286 287 288
                    goto cleanup;
            }
            break;
289 290 291 292 293 294 295 296

        case VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_USB:
            /* NB: hostdev->missing wasn't previously checked in the
             * case of hotplug, only when starting a domain. Now it is
             * always checked, and the cgroup setup skipped if true.
             */
            if (dev->missing)
                break;
297
            if ((usb = virUSBDeviceNew(usbsrc->bus, usbsrc->device,
298 299 300 301
                                       NULL)) == NULL) {
                goto cleanup;
            }

302
            /* oddly, qemuSetupHostUSBDeviceCgroup doesn't ever
303 304
             * reference the usb object we just created
             */
305
            if (virUSBDeviceFileIterate(usb, qemuSetupHostUSBDeviceCgroup,
306 307 308 309
                                        vm) < 0) {
                goto cleanup;
            }
            break;
310

311
        case VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_SCSI: {
312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330
            if (scsisrc->protocol ==
                VIR_DOMAIN_HOSTDEV_SCSI_PROTOCOL_TYPE_ISCSI) {
                virDomainHostdevSubsysSCSIiSCSIPtr iscsisrc = &scsisrc->u.iscsi;
                /* Follow qemuSetupDiskCgroup() and qemuSetImageCgroupInternal()
                 * which does nothing for non local storage
                 */
                VIR_DEBUG("Not updating cgroups for hostdev iSCSI path '%s'",
                          iscsisrc->path);
            } else {
                virDomainHostdevSubsysSCSIHostPtr scsihostsrc =
                    &scsisrc->u.host;
                if ((scsi = virSCSIDeviceNew(NULL,
                                             scsihostsrc->adapter,
                                             scsihostsrc->bus,
                                             scsihostsrc->target,
                                             scsihostsrc->unit,
                                             dev->readonly,
                                             dev->shareable)) == NULL)
                    goto cleanup;
331

332 333 334 335 336
                if (virSCSIDeviceFileIterate(scsi,
                                             qemuSetupHostSCSIDeviceCgroup,
                                             vm) < 0)
                    goto cleanup;
            }
337 338
            break;
        }
339

340 341 342 343 344 345
        default:
            break;
        }
    }

    ret = 0;
346
 cleanup:
347
    virPCIDeviceFree(pci);
348
    virUSBDeviceFree(usb);
349
    virSCSIDeviceFree(scsi);
350 351 352 353 354 355 356 357 358 359
    VIR_FREE(path);
    return ret;
}

int
qemuTeardownHostdevCgroup(virDomainObjPtr vm,
                       virDomainHostdevDefPtr dev)
{
    int ret = -1;
    qemuDomainObjPrivatePtr priv = vm->privateData;
360
    virDomainHostdevSubsysPCIPtr pcisrc = &dev->source.subsys.u.pci;
361 362 363 364 365 366 367 368 369 370 371 372 373 374 375
    virPCIDevicePtr pci = NULL;
    char *path = NULL;

    /* currently this only does something for PCI devices using vfio
     * for device assignment, but it is called for *all* hostdev
     * devices.
     */

    if (!virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_DEVICES))
        return 0;

    if (dev->mode == VIR_DOMAIN_HOSTDEV_MODE_SUBSYS) {

        switch (dev->source.subsys.type) {
        case VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_PCI:
376
            if (pcisrc->backend == VIR_DOMAIN_HOSTDEV_PCI_BACKEND_VFIO) {
377
                int rv;
378

379 380 381 382
                pci = virPCIDeviceNew(pcisrc->addr.domain,
                                      pcisrc->addr.bus,
                                      pcisrc->addr.slot,
                                      pcisrc->addr.function);
383 384 385
                if (!pci)
                    goto cleanup;

386
                if (!(path = virPCIDeviceGetIOMMUGroupDev(pci)))
387 388 389
                    goto cleanup;

                VIR_DEBUG("Cgroup deny %s for PCI device assignment", path);
390
                rv = virCgroupDenyDevicePath(priv->cgroup, path,
391 392
                                             VIR_CGROUP_DEVICE_RWM);
                virDomainAuditCgroupPath(vm, priv->cgroup,
393 394
                                         "deny", path, "rwm", rv == 0);
                if (rv < 0)
395 396 397
                    goto cleanup;
            }
            break;
398 399 400
        case VIR_DOMAIN_HOSTDEV_SUBSYS_TYPE_USB:
            /* nothing to tear down for USB */
            break;
401 402 403 404 405 406
        default:
            break;
        }
    }

    ret = 0;
407
 cleanup:
408 409 410 411 412
    virPCIDeviceFree(pci);
    VIR_FREE(path);
    return ret;
}

413 414 415 416
static int
qemuSetupBlkioCgroup(virDomainObjPtr vm)
{
    qemuDomainObjPrivatePtr priv = vm->privateData;
417
    size_t i;
418 419 420 421 422 423 424 425 426 427 428 429

    if (!virCgroupHasController(priv->cgroup,
                                VIR_CGROUP_CONTROLLER_BLKIO)) {
        if (vm->def->blkio.weight || vm->def->blkio.ndevices) {
            virReportError(VIR_ERR_CONFIG_UNSUPPORTED, "%s",
                           _("Block I/O tuning is not available on this host"));
            return -1;
        } else {
            return 0;
        }
    }

430 431 432
    if (vm->def->blkio.weight != 0 &&
        virCgroupSetBlkioWeight(priv->cgroup, vm->def->blkio.weight) < 0)
        return -1;
433 434 435

    if (vm->def->blkio.ndevices) {
        for (i = 0; i < vm->def->blkio.ndevices; i++) {
436
            virBlkioDevicePtr dev = &vm->def->blkio.devices[i];
437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459
            if (dev->weight &&
                (virCgroupSetBlkioDeviceWeight(priv->cgroup, dev->path,
                                               dev->weight) < 0))
                return -1;

            if (dev->riops &&
                (virCgroupSetBlkioDeviceReadIops(priv->cgroup, dev->path,
                                                 dev->riops) < 0))
                return -1;

            if (dev->wiops &&
                (virCgroupSetBlkioDeviceWriteIops(priv->cgroup, dev->path,
                                                  dev->wiops) < 0))
                return -1;

            if (dev->rbps &&
                (virCgroupSetBlkioDeviceReadBps(priv->cgroup, dev->path,
                                                dev->rbps) < 0))
                return -1;

            if (dev->wbps &&
                (virCgroupSetBlkioDeviceWriteBps(priv->cgroup, dev->path,
                                                 dev->wbps) < 0))
460 461 462 463 464 465 466
                return -1;
        }
    }

    return 0;
}

467

468 469 470 471 472
static int
qemuSetupMemoryCgroup(virDomainObjPtr vm)
{
    qemuDomainObjPrivatePtr priv = vm->privateData;

E
Eric Blake 已提交
473
    if (!virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_MEMORY)) {
474 475 476
        if (virMemoryLimitIsSet(vm->def->mem.hard_limit) ||
            virMemoryLimitIsSet(vm->def->mem.soft_limit) ||
            virMemoryLimitIsSet(vm->def->mem.swap_hard_limit)) {
477 478 479
            virReportError(VIR_ERR_CONFIG_UNSUPPORTED, "%s",
                           _("Memory cgroup is not available on this host"));
            return -1;
O
Osier Yang 已提交
480 481
        } else {
            return 0;
482 483 484
        }
    }

485 486 487
    if (virMemoryLimitIsSet(vm->def->mem.hard_limit))
        if (virCgroupSetMemoryHardLimit(priv->cgroup, vm->def->mem.hard_limit) < 0)
            return -1;
488

489 490 491
    if (virMemoryLimitIsSet(vm->def->mem.soft_limit))
        if (virCgroupSetMemorySoftLimit(priv->cgroup, vm->def->mem.soft_limit) < 0)
            return -1;
492

493 494 495
    if (virMemoryLimitIsSet(vm->def->mem.swap_hard_limit))
        if (virCgroupSetMemSwapHardLimit(priv->cgroup, vm->def->mem.swap_hard_limit) < 0)
            return -1;
496 497 498 499 500

    return 0;
}


501 502 503 504 505 506 507
static int
qemuSetupDevicesCgroup(virQEMUDriverPtr driver,
                       virDomainObjPtr vm)
{
    qemuDomainObjPrivatePtr priv = vm->privateData;
    virQEMUDriverConfigPtr cfg = NULL;
    const char *const *deviceACL = NULL;
508
    int rv = -1;
509
    int ret = -1;
510
    size_t i;
511 512 513 514

    if (!virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_DEVICES))
        return 0;

515 516 517 518 519
    rv = virCgroupDenyAllDevices(priv->cgroup);
    virDomainAuditCgroup(vm, priv->cgroup, "deny", "all", rv == 0);
    if (rv < 0) {
        if (virLastErrorIsSystemErrno(EPERM)) {
            virResetLastError();
520 521 522 523 524 525 526
            VIR_WARN("Group devices ACL is not accessible, disabling whitelisting");
            return 0;
        }

        goto cleanup;
    }

527
    for (i = 0; i < vm->def->ndisks; i++) {
528 529 530 531
        if (qemuSetupDiskCgroup(vm, vm->def->disks[i]) < 0)
            goto cleanup;
    }

532
    rv = virCgroupAllowDeviceMajor(priv->cgroup, 'c', DEVICE_PTY_MAJOR,
533 534
                                   VIR_CGROUP_DEVICE_RW);
    virDomainAuditCgroupMajor(vm, priv->cgroup, "allow", DEVICE_PTY_MAJOR,
535 536
                              "pty", "rw", rv == 0);
    if (rv < 0)
537 538 539 540 541 542 543 544
        goto cleanup;

    cfg = virQEMUDriverGetConfig(driver);
    deviceACL = cfg->cgroupDeviceACL ?
                (const char *const *)cfg->cgroupDeviceACL :
                defaultDeviceACL;

    if (vm->def->nsounds &&
545
        ((!vm->def->ngraphics && cfg->nogfxAllowHostAudio) ||
546 547
         (vm->def->graphics &&
          ((vm->def->graphics[0]->type == VIR_DOMAIN_GRAPHICS_TYPE_VNC &&
548
           cfg->vncAllowHostAudio) ||
549
           (vm->def->graphics[0]->type == VIR_DOMAIN_GRAPHICS_TYPE_SDL))))) {
550
        rv = virCgroupAllowDeviceMajor(priv->cgroup, 'c', DEVICE_SND_MAJOR,
551 552
                                       VIR_CGROUP_DEVICE_RW);
        virDomainAuditCgroupMajor(vm, priv->cgroup, "allow", DEVICE_SND_MAJOR,
553 554
                                  "sound", "rw", rv == 0);
        if (rv < 0)
555 556 557
            goto cleanup;
    }

558
    for (i = 0; deviceACL[i] != NULL; i++) {
559
        if (!virFileExists(deviceACL[i])) {
N
Nehal J Wani 已提交
560
            VIR_DEBUG("Ignoring non-existent device %s", deviceACL[i]);
561 562 563
            continue;
        }

564
        rv = virCgroupAllowDevicePath(priv->cgroup, deviceACL[i],
565
                                      VIR_CGROUP_DEVICE_RW);
566 567 568
        virDomainAuditCgroupPath(vm, priv->cgroup, "allow", deviceACL[i], "rw", rv == 0);
        if (rv < 0 &&
            !virLastErrorIsSystemErrno(ENOENT))
569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588
            goto cleanup;
    }

    if (virDomainChrDefForeach(vm->def,
                               true,
                               qemuSetupChardevCgroup,
                               vm) < 0)
        goto cleanup;

    if (vm->def->tpm &&
        (qemuSetupTPMCgroup(vm->def,
                            vm->def->tpm,
                            vm) < 0))
        goto cleanup;

    for (i = 0; i < vm->def->nhostdevs; i++) {
        if (qemuSetupHostdevCGroup(vm, vm->def->hostdevs[i]) < 0)
            goto cleanup;
    }

589 590 591
    for (i = 0; i < vm->def->nrngs; i++) {
        if (vm->def->rngs[i]->backend == VIR_DOMAIN_RNG_BACKEND_RANDOM) {
            VIR_DEBUG("Setting Cgroup ACL for RNG device");
592 593
            rv = virCgroupAllowDevicePath(priv->cgroup,
                                          vm->def->rngs[i]->source.file,
594 595
                                          VIR_CGROUP_DEVICE_RW);
            virDomainAuditCgroupPath(vm, priv->cgroup, "allow",
596 597
                                     vm->def->rngs[i]->source.file,
                                     "rw", rv == 0);
598 599 600 601
            if (rv < 0 &&
                !virLastErrorIsSystemErrno(ENOENT))
                goto cleanup;
        }
602 603
    }

604
    ret = 0;
605
 cleanup:
606 607 608 609 610
    virObjectUnref(cfg);
    return ret;
}


611
int
612
qemuSetupCpusetMems(virDomainObjPtr vm)
613
{
614
    virCgroupPtr cgroup_temp = NULL;
615
    qemuDomainObjPrivatePtr priv = vm->privateData;
616
    char *mem_mask = NULL;
617 618 619 620 621
    int ret = -1;

    if (!virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPUSET))
        return 0;

622
    if (virDomainNumatuneGetMode(vm->def->numa, -1) !=
623 624 625
        VIR_DOMAIN_NUMATUNE_MEM_STRICT)
        return 0;

626
    if (virDomainNumatuneMaybeFormatNodeset(vm->def->numa,
627
                                            priv->autoNodeset,
628
                                            &mem_mask, -1) < 0)
629
        goto cleanup;
630

631 632
    if (mem_mask)
        if (virCgroupNewEmulator(priv->cgroup, false, &cgroup_temp) < 0 ||
633
            virCgroupSetCpusetMems(cgroup_temp, mem_mask) < 0)
634
            goto cleanup;
635

636 637 638
    ret = 0;
 cleanup:
    VIR_FREE(mem_mask);
639
    virCgroupFree(&cgroup_temp);
640 641 642 643 644
    return ret;
}


static int
645
qemuSetupCpusetCgroup(virDomainObjPtr vm)
646 647 648 649 650 651
{
    qemuDomainObjPrivatePtr priv = vm->privateData;

    if (!virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPUSET))
        return 0;

652 653 654
    if (virCgroupSetCpusetMemoryMigrate(priv->cgroup, true) < 0)
        return -1;

655
    return 0;
656 657 658
}


659
static int
660 661
qemuSetupCpuCgroup(virQEMUDriverPtr driver,
                   virDomainObjPtr vm)
662 663
{
    qemuDomainObjPrivatePtr priv = vm->privateData;
664 665 666 667
    virObjectEventPtr event = NULL;
    virTypedParameterPtr eventParams = NULL;
    int eventNparams = 0;
    int eventMaxparams = 0;
668 669

    if (!virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPU)) {
670
       if (vm->def->cputune.sharesSpecified) {
671 672 673 674 675 676 677 678
           virReportError(VIR_ERR_CONFIG_UNSUPPORTED, "%s",
                          _("CPU tuning is not available on this host"));
           return -1;
       } else {
           return 0;
       }
    }

679 680 681 682 683 684 685
    if (vm->def->cputune.sharesSpecified) {
        unsigned long long val;
        if (virCgroupSetCpuShares(priv->cgroup, vm->def->cputune.shares) < 0)
            return -1;

        if (virCgroupGetCpuShares(priv->cgroup, &val) < 0)
            return -1;
686 687 688 689
        if (vm->def->cputune.shares != val) {
            vm->def->cputune.shares = val;
            if (virTypedParamsAddULLong(&eventParams, &eventNparams,
                                        &eventMaxparams,
690
                                        VIR_DOMAIN_TUNABLE_CPU_CPU_SHARES,
691 692 693 694 695 696 697
                                        val) < 0)
                return -1;

            event = virDomainEventTunableNewFromObj(vm, eventParams, eventNparams);
        }

        if (event)
698
            qemuDomainEventQueue(driver, event);
699
    }
700 701 702 703 704

    return 0;
}


705
static int
706
qemuInitCgroup(virQEMUDriverPtr driver,
707 708 709
               virDomainObjPtr vm,
               size_t nnicindexes,
               int *nicindexes)
710
{
711
    int ret = -1;
712 713 714
    qemuDomainObjPrivatePtr priv = vm->privateData;
    virQEMUDriverConfigPtr cfg = virQEMUDriverGetConfig(driver);

715 716 717
    if (!cfg->privileged)
        goto done;

718 719 720
    if (!virCgroupAvailable())
        goto done;

721 722
    virCgroupFree(&priv->cgroup);

723
    if (!vm->def->resource) {
724 725
        virDomainResourceDefPtr res;

726
        if (VIR_ALLOC(res) < 0)
727
            goto cleanup;
728

729
        if (VIR_STRDUP(res->partition, "/machine") < 0) {
730 731 732 733 734
            VIR_FREE(res);
            goto cleanup;
        }

        vm->def->resource = res;
735 736
    }

737 738 739 740 741 742
    if (vm->def->resource->partition[0] != '/') {
        virReportError(VIR_ERR_CONFIG_UNSUPPORTED,
                       _("Resource partition '%s' must start with '/'"),
                       vm->def->resource->partition);
        goto cleanup;
    }
743 744 745 746 747 748 749 750

    if (virCgroupNewMachine(vm->def->name,
                            "qemu",
                            cfg->privileged,
                            vm->def->uuid,
                            NULL,
                            vm->pid,
                            false,
751
                            nnicindexes, nicindexes,
752 753 754
                            vm->def->resource->partition,
                            cfg->cgroupControllers,
                            &priv->cgroup) < 0) {
755 756
        if (virCgroupNewIgnoreError())
            goto done;
757

758 759
        goto cleanup;
    }
760

761
 done:
762
    ret = 0;
763
 cleanup:
764 765 766
    virObjectUnref(cfg);
    return ret;
}
767

768 769 770
static void
qemuRestoreCgroupState(virDomainObjPtr vm)
{
771
    char *mem_mask = NULL;
772
    char *nodeset = NULL;
773 774
    int empty = -1;
    qemuDomainObjPrivatePtr priv = vm->privateData;
775
    size_t i = 0;
776
    virBitmapPtr all_nodes;
777
    virCgroupPtr cgroup_temp = NULL;
778 779 780 781 782 783 784 785

    if (!(all_nodes = virNumaGetHostNodeset()))
        goto error;

    if (!(mem_mask = virBitmapFormat(all_nodes)))
        goto error;

    if ((empty = virCgroupHasEmptyTasks(priv->cgroup,
786
                                        VIR_CGROUP_CONTROLLER_CPUSET)) <= 0)
787 788 789 790 791
        goto error;

    if (virCgroupSetCpusetMems(priv->cgroup, mem_mask) < 0)
        goto error;

792 793 794 795 796 797 798
    for (i = 0; i < priv->nvcpupids; i++) {
        if (virCgroupNewVcpu(priv->cgroup, i, false, &cgroup_temp) < 0 ||
            virCgroupSetCpusetMemoryMigrate(cgroup_temp, true) < 0 ||
            virCgroupGetCpusetMems(cgroup_temp, &nodeset) < 0 ||
            virCgroupSetCpusetMems(cgroup_temp, nodeset) < 0)
            goto cleanup;

799
        VIR_FREE(nodeset);
800 801 802 803 804 805 806 807 808 809
        virCgroupFree(&cgroup_temp);
    }

    for (i = 0; i < priv->niothreadpids; i++) {
        if (virCgroupNewIOThread(priv->cgroup, i + 1, false, &cgroup_temp) < 0 ||
            virCgroupSetCpusetMemoryMigrate(cgroup_temp, true) < 0 ||
            virCgroupGetCpusetMems(cgroup_temp, &nodeset) < 0 ||
            virCgroupSetCpusetMems(cgroup_temp, nodeset) < 0)
            goto cleanup;

810
        VIR_FREE(nodeset);
811 812 813 814 815 816 817 818 819
        virCgroupFree(&cgroup_temp);
    }

    if (virCgroupNewEmulator(priv->cgroup, false, &cgroup_temp) < 0 ||
        virCgroupSetCpusetMemoryMigrate(cgroup_temp, true) < 0 ||
        virCgroupGetCpusetMems(cgroup_temp, &nodeset) < 0 ||
        virCgroupSetCpusetMems(cgroup_temp, nodeset) < 0)
        goto cleanup;

820 821
 cleanup:
    VIR_FREE(mem_mask);
822
    VIR_FREE(nodeset);
823
    virBitmapFree(all_nodes);
824
    virCgroupFree(&cgroup_temp);
825 826 827 828 829 830 831
    return;

 error:
    virResetLastError();
    VIR_DEBUG("Couldn't restore cgroups to meaningful state");
    goto cleanup;
}
832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848

int
qemuConnectCgroup(virQEMUDriverPtr driver,
                  virDomainObjPtr vm)
{
    virQEMUDriverConfigPtr cfg = virQEMUDriverGetConfig(driver);
    qemuDomainObjPrivatePtr priv = vm->privateData;
    int ret = -1;

    if (!cfg->privileged)
        goto done;

    if (!virCgroupAvailable())
        goto done;

    virCgroupFree(&priv->cgroup);

849 850 851
    if (virCgroupNewDetectMachine(vm->def->name,
                                  "qemu",
                                  vm->pid,
852 853 854
                                  vm->def->resource ?
                                  vm->def->resource->partition :
                                  NULL,
855
                                  cfg->cgroupControllers,
856
                                  &priv->cgroup) < 0)
857
        goto cleanup;
858

859 860
    qemuRestoreCgroupState(vm);

861
 done:
862
    ret = 0;
863
 cleanup:
864
    virObjectUnref(cfg);
865
    return ret;
866 867
}

868 869
int
qemuSetupCgroup(virQEMUDriverPtr driver,
870 871 872
                virDomainObjPtr vm,
                size_t nnicindexes,
                int *nicindexes)
873
{
874
    qemuDomainObjPrivatePtr priv = vm->privateData;
875
    int ret = -1;
876

877 878 879 880 881 882
    if (!vm->pid) {
        virReportError(VIR_ERR_INTERNAL_ERROR, "%s",
                       _("Cannot setup cgroups until process is started"));
        return -1;
    }

883
    if (qemuInitCgroup(driver, vm, nnicindexes, nicindexes) < 0)
884
        return -1;
885

886
    if (!priv->cgroup)
887
        return 0;
888

889 890
    if (qemuSetupDevicesCgroup(driver, vm) < 0)
        goto cleanup;
891

892 893
    if (qemuSetupBlkioCgroup(vm) < 0)
        goto cleanup;
894

895 896
    if (qemuSetupMemoryCgroup(vm) < 0)
        goto cleanup;
897

898
    if (qemuSetupCpuCgroup(driver, vm) < 0)
899
        goto cleanup;
900

901
    if (qemuSetupCpusetCgroup(vm) < 0)
902
        goto cleanup;
903

904
    ret = 0;
905
 cleanup:
906
    return ret;
907 908
}

909 910 911 912
int
qemuSetupCgroupVcpuBW(virCgroupPtr cgroup,
                      unsigned long long period,
                      long long quota)
913 914 915 916 917 918 919 920
{
    unsigned long long old_period;

    if (period == 0 && quota == 0)
        return 0;

    if (period) {
        /* get old period, and we can rollback if set quota failed */
921
        if (virCgroupGetCpuCfsPeriod(cgroup, &old_period) < 0)
922 923
            return -1;

924
        if (virCgroupSetCpuCfsPeriod(cgroup, period) < 0)
925 926 927
            return -1;
    }

928 929 930
    if (quota &&
        virCgroupSetCpuCfsQuota(cgroup, quota) < 0)
        goto error;
931 932 933

    return 0;

934
 error:
935
    if (period) {
936 937 938 939 940 941
        virErrorPtr saved = virSaveLastError();
        ignore_value(virCgroupSetCpuCfsPeriod(cgroup, old_period));
        if (saved) {
            virSetError(saved);
            virFreeError(saved);
        }
942 943 944 945 946
    }

    return -1;
}

947

948
int
949 950
qemuSetupCgroupCpusetCpus(virCgroupPtr cgroup,
                          virBitmapPtr cpumask)
951
{
952
    int ret = -1;
953 954
    char *new_cpus = NULL;

955
    if (!(new_cpus = virBitmapFormat(cpumask)))
956 957
        goto cleanup;

958
    if (virCgroupSetCpusetCpus(cgroup, new_cpus) < 0)
959 960
        goto cleanup;

961
    ret = 0;
962
 cleanup:
963
    VIR_FREE(new_cpus);
964
    return ret;
965 966
}

967 968
int
qemuSetupCgroupForVcpu(virDomainObjPtr vm)
969 970 971
{
    virCgroupPtr cgroup_vcpu = NULL;
    qemuDomainObjPrivatePtr priv = vm->privateData;
972
    virDomainDefPtr def = vm->def;
973
    size_t i, j;
974 975
    unsigned long long period = vm->def->cputune.period;
    long long quota = vm->def->cputune.quota;
976
    char *mem_mask = NULL;
977

978
    if ((period || quota) &&
979
        !virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPU)) {
980 981
        virReportError(VIR_ERR_CONFIG_UNSUPPORTED, "%s",
                       _("cgroup cpu is required for scheduler tuning"));
H
Hu Tao 已提交
982 983 984
        return -1;
    }

985 986 987 988 989 990 991 992 993
    /*
     * If CPU cgroup controller is not initialized here, then we need
     * neither period nor quota settings.  And if CPUSET controller is
     * not initialized either, then there's nothing to do anyway.
     */
    if (!virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPU) &&
        !virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPUSET))
        return 0;

994
    /* We are trying to setup cgroups for CPU pinning, which can also be done
995
     * with virProcessSetAffinity, thus the lack of cgroups is not fatal here.
996
     */
997
    if (priv->cgroup == NULL)
998 999
        return 0;

1000
    if (priv->nvcpupids == 0 || priv->vcpupids[0] == vm->pid) {
1001
        /* If we don't know VCPU<->PID mapping or all vcpu runs in the same
W
Wen Congyang 已提交
1002
         * thread, we cannot control each vcpu.
1003
         */
1004
        return 0;
1005 1006
    }

1007
    if (virDomainNumatuneGetMode(vm->def->numa, -1) ==
1008
        VIR_DOMAIN_NUMATUNE_MEM_STRICT &&
1009
        virDomainNumatuneMaybeFormatNodeset(vm->def->numa,
1010 1011 1012 1013
                                            priv->autoNodeset,
                                            &mem_mask, -1) < 0)
        goto cleanup;

1014
    for (i = 0; i < priv->nvcpupids; i++) {
1015
        virCgroupFree(&cgroup_vcpu);
1016
        if (virCgroupNewVcpu(priv->cgroup, i, true, &cgroup_vcpu) < 0)
1017 1018 1019
            goto cleanup;

        /* move the thread for vcpu to sub dir */
1020
        if (virCgroupAddTask(cgroup_vcpu, priv->vcpupids[i]) < 0)
1021 1022
            goto cleanup;

1023 1024 1025 1026
        if (mem_mask &&
            virCgroupSetCpusetMems(cgroup_vcpu, mem_mask) < 0)
            goto cleanup;

1027
        if (period || quota) {
H
Hu Tao 已提交
1028 1029
            if (qemuSetupCgroupVcpuBW(cgroup_vcpu, period, quota) < 0)
                goto cleanup;
1030 1031
        }

1032
        /* Set vcpupin in cgroup if vcpupin xml is provided */
1033
        if (virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPUSET)) {
1034
            virBitmapPtr cpumap = NULL;
M
Martin Kletzander 已提交
1035

1036 1037 1038 1039 1040
            /* try to use the default cpu maps */
            if (vm->def->placement_mode == VIR_DOMAIN_CPU_PLACEMENT_MODE_AUTO)
                cpumap = priv->autoCpuset;
            else
                cpumap = vm->def->cpumask;
M
Martin Kletzander 已提交
1041

1042 1043 1044 1045 1046 1047
            /* lookup a more specific pinning info */
            for (j = 0; j < def->cputune.nvcpupin; j++) {
                if (def->cputune.vcpupin[j]->id == i) {
                    cpumap = def->cputune.vcpupin[j]->cpumask;
                    break;
                }
M
Martin Kletzander 已提交
1048
            }
1049 1050 1051 1052

            if (!cpumap)
                continue;

1053
            if (qemuSetupCgroupCpusetCpus(cgroup_vcpu, cpumap) < 0)
1054
                goto cleanup;
M
Martin Kletzander 已提交
1055
        }
1056
    }
1057
    virCgroupFree(&cgroup_vcpu);
1058
    VIR_FREE(mem_mask);
1059 1060 1061

    return 0;

1062
 cleanup:
1063 1064 1065 1066
    if (cgroup_vcpu) {
        virCgroupRemove(cgroup_vcpu);
        virCgroupFree(&cgroup_vcpu);
    }
1067
    VIR_FREE(mem_mask);
1068

1069 1070 1071
    return -1;
}

1072
int
1073
qemuSetupCgroupForEmulator(virDomainObjPtr vm)
1074
{
1075
    virBitmapPtr cpumask = NULL;
1076
    virCgroupPtr cgroup_emulator = NULL;
1077
    virDomainDefPtr def = vm->def;
1078
    qemuDomainObjPrivatePtr priv = vm->privateData;
1079 1080
    unsigned long long period = vm->def->cputune.emulator_period;
    long long quota = vm->def->cputune.emulator_quota;
1081

1082
    if ((period || quota) &&
1083
        !virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPU)) {
1084 1085 1086 1087 1088
        virReportError(VIR_ERR_CONFIG_UNSUPPORTED, "%s",
                       _("cgroup cpu is required for scheduler tuning"));
        return -1;
    }

1089 1090 1091 1092 1093 1094 1095 1096 1097
    /*
     * If CPU cgroup controller is not initialized here, then we need
     * neither period nor quota settings.  And if CPUSET controller is
     * not initialized either, then there's nothing to do anyway.
     */
    if (!virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPU) &&
        !virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPUSET))
        return 0;

1098
    if (priv->cgroup == NULL)
1099 1100
        return 0; /* Not supported, so claim success */

1101
    if (virCgroupNewEmulator(priv->cgroup, true, &cgroup_emulator) < 0)
1102 1103
        goto cleanup;

1104
    if (virCgroupMoveTask(priv->cgroup, cgroup_emulator) < 0)
1105
        goto cleanup;
1106

1107 1108 1109
    if (def->placement_mode == VIR_DOMAIN_CPU_PLACEMENT_MODE_AUTO)
        cpumask = priv->autoCpuset;
    else if (def->cputune.emulatorpin)
1110
        cpumask = def->cputune.emulatorpin->cpumask;
1111
    else if (def->cpumask)
1112 1113 1114
        cpumask = def->cpumask;

    if (cpumask) {
1115
        if (virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPUSET) &&
1116
            qemuSetupCgroupCpusetCpus(cgroup_emulator, cpumask) < 0)
1117
            goto cleanup;
H
Hu Tao 已提交
1118
    }
1119

1120
    if (period || quota) {
1121 1122 1123 1124
        if (virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPU) &&
            qemuSetupCgroupVcpuBW(cgroup_emulator, period,
                                  quota) < 0)
            goto cleanup;
1125 1126
    }

1127 1128 1129
    virCgroupFree(&cgroup_emulator);
    return 0;

1130
 cleanup:
1131 1132 1133 1134 1135
    if (cgroup_emulator) {
        virCgroupRemove(cgroup_emulator);
        virCgroupFree(&cgroup_emulator);
    }

1136
    return -1;
1137
}
1138

1139 1140 1141 1142 1143 1144 1145 1146 1147
int
qemuSetupCgroupForIOThreads(virDomainObjPtr vm)
{
    virCgroupPtr cgroup_iothread = NULL;
    qemuDomainObjPrivatePtr priv = vm->privateData;
    virDomainDefPtr def = vm->def;
    size_t i, j;
    unsigned long long period = vm->def->cputune.period;
    long long quota = vm->def->cputune.quota;
1148
    char *mem_mask = NULL;
1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171

    if ((period || quota) &&
        !virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPU)) {
        virReportError(VIR_ERR_CONFIG_UNSUPPORTED, "%s",
                       _("cgroup cpu is required for scheduler tuning"));
        return -1;
    }

    /*
     * If CPU cgroup controller is not initialized here, then we need
     * neither period nor quota settings.  And if CPUSET controller is
     * not initialized either, then there's nothing to do anyway.
     */
    if (!virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPU) &&
        !virCgroupHasController(priv->cgroup, VIR_CGROUP_CONTROLLER_CPUSET))
        return 0;

    /* We are trying to setup cgroups for CPU pinning, which can also be done
     * with virProcessSetAffinity, thus the lack of cgroups is not fatal here.
     */
    if (priv->cgroup == NULL)
        return 0;

J
Ján Tomko 已提交
1172
    if (def->iothreads && priv->niothreadpids == 0) {
1173 1174 1175 1176
        VIR_WARN("Unable to get iothreads' pids.");
        return 0;
    }

1177
    if (virDomainNumatuneGetMode(vm->def->numa, -1) ==
1178
        VIR_DOMAIN_NUMATUNE_MEM_STRICT &&
1179
        virDomainNumatuneMaybeFormatNodeset(vm->def->numa,
1180 1181 1182 1183
                                            priv->autoNodeset,
                                            &mem_mask, -1) < 0)
        goto cleanup;

1184 1185 1186 1187
    for (i = 0; i < priv->niothreadpids; i++) {
        /* IOThreads are numbered 1..n, although the array is 0..n-1,
         * so we will account for that here
         */
1188 1189
        if (virCgroupNewIOThread(priv->cgroup, i + 1, true,
                                 &cgroup_iothread) < 0)
1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200
            goto cleanup;

        /* move the thread for iothread to sub dir */
        if (virCgroupAddTask(cgroup_iothread, priv->iothreadpids[i]) < 0)
            goto cleanup;

        if (period || quota) {
            if (qemuSetupCgroupVcpuBW(cgroup_iothread, period, quota) < 0)
                goto cleanup;
        }

1201 1202 1203 1204
        if (mem_mask &&
            virCgroupSetCpusetMems(cgroup_iothread, mem_mask) < 0)
            goto cleanup;

1205 1206 1207
        /* Set iothreadpin in cgroup if iothreadpin xml is provided */
        if (virCgroupHasController(priv->cgroup,
                                   VIR_CGROUP_CONTROLLER_CPUSET)) {
1208
            virBitmapPtr cpumask = NULL;
1209

1210 1211 1212 1213 1214
            /* default cpu masks */
            if (def->placement_mode == VIR_DOMAIN_CPU_PLACEMENT_MODE_AUTO)
                cpumask = priv->autoCpuset;
            else
                cpumask = def->cpumask;
1215

1216 1217 1218 1219 1220 1221 1222
            /* specific cpu mask */
            for (j = 0; j < def->cputune.niothreadspin; j++) {
                /* IOThreads are numbered/named 1..n */
                if (def->cputune.iothreadspin[j]->id == i + 1) {
                    cpumask = def->cputune.iothreadspin[j]->cpumask;
                    break;
                }
1223
            }
1224 1225

            if (cpumask &&
1226
                qemuSetupCgroupCpusetCpus(cgroup_iothread, cpumask) < 0)
1227
                goto cleanup;
1228 1229 1230 1231
        }

        virCgroupFree(&cgroup_iothread);
    }
1232
    VIR_FREE(mem_mask);
1233 1234 1235 1236 1237 1238 1239 1240

    return 0;

 cleanup:
    if (cgroup_iothread) {
        virCgroupRemove(cgroup_iothread);
        virCgroupFree(&cgroup_iothread);
    }
1241
    VIR_FREE(mem_mask);
1242 1243 1244 1245

    return -1;
}

1246
int
1247 1248
qemuRemoveCgroup(virQEMUDriverPtr driver,
                 virDomainObjPtr vm)
1249
{
1250
    qemuDomainObjPrivatePtr priv = vm->privateData;
1251
    virQEMUDriverConfigPtr cfg;
1252

1253
    if (priv->cgroup == NULL)
1254 1255
        return 0; /* Not supported, so claim success */

1256 1257
    cfg = virQEMUDriverGetConfig(driver);

1258 1259 1260 1261 1262 1263 1264
    if (virCgroupTerminateMachine(vm->def->name,
                                  "qemu",
                                  cfg->privileged) < 0) {
        if (!virCgroupNewIgnoreError())
            VIR_DEBUG("Failed to terminate cgroup for %s", vm->def->name);
    }

1265 1266
    virObjectUnref(cfg);

1267
    return virCgroupRemove(priv->cgroup);
1268 1269
}

1270 1271
int
qemuAddToCgroup(virDomainObjPtr vm)
1272
{
1273
    qemuDomainObjPrivatePtr priv = vm->privateData;
1274

1275
    if (priv->cgroup == NULL)
1276 1277
        return 0; /* Not supported, so claim success */

1278
    return 0;
1279
}