sys/dev/drm2/drm_drv.c

   1 /*-
   2  * Copyright 1999, 2000 Precision Insight, Inc., Cedar Park, Texas.
   3  * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
   4  * All Rights Reserved.
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a
   7  * copy of this software and associated documentation files (the "Software"),
   8  * to deal in the Software without restriction, including without limitation
   9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  10  * and/or sell copies of the Software, and to permit persons to whom the
  11  * Software is furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice (including the next
  14  * paragraph) shall be included in all copies or substantial portions of the
  15  * Software.
  16  *
  17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  18  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  20  * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  21  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  22  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  23  * OTHER DEALINGS IN THE SOFTWARE.
  24  *
  25  * Authors:
  26  *    Rickard E. (Rik) Faith <faith@valinux.com>
  27  *    Gareth Hughes <gareth@valinux.com>
  28  *
  29  * $FreeBSD: src/sys/dev/drm2/drm_drv.c,v 1.1 2012/05/22 11:07:44 kib Exp $
  30  */
  31
  32 /** @file drm_drv.c
  33  * The catch-all file for DRM device support, including module setup/teardown,
  34  * open/close, and ioctl dispatch.
  35  */
  36
  37
  38 #include <sys/limits.h>
  39 #include <dev/drm2/drmP.h>
  40 #include <dev/drm2/drm.h>
  41 #include <dev/drm2/drm_sarea.h>
  42 #include <dev/drm2/drm_mode.h>
  43
  44 #ifdef DRM_DEBUG_DEFAULT_ON
  45 int drm_debug_flag = 1;
  46 #else
  47 int drm_debug_flag = 2;
  48 #endif
  49 int drm_notyet_flag = 0;
  50
  51 unsigned int drm_vblank_offdelay = 5000;    /* Default to 5000 msecs. */
  52 unsigned int drm_timestamp_precision = 20;  /* Default to 20 usecs. */
  53
  54 static int drm_load(struct drm_device *dev);
  55 static void drm_unload(struct drm_device *dev);
  56 static drm_pci_id_list_t *drm_find_description(int vendor, int device,
  57     drm_pci_id_list_t *idlist);
  58
  59 static int
  60 drm_modevent(module_t mod, int type, void *data)
  61 {
  62
  63         switch (type) {
  64         case MOD_LOAD:
  65                 TUNABLE_INT_FETCH("drm.debug", &drm_debug_flag);
  66                 TUNABLE_INT_FETCH("drm.notyet", &drm_notyet_flag);
  67                 break;
  68         }
  69         return (0);
  70 }
  71
  72 static moduledata_t drm_mod = {
  73         "drmn",
  74         drm_modevent,
  75         0
  76 };
  77 DECLARE_MODULE(drmn, drm_mod, SI_SUB_DRIVERS, SI_ORDER_FIRST);
  78 MODULE_VERSION(drmn, 1);
  79 MODULE_DEPEND(drmn, agp, 1, 1, 1);
  80 MODULE_DEPEND(drmn, pci, 1, 1, 1);
  81 MODULE_DEPEND(drmn, mem, 1, 1, 1);
  82 MODULE_DEPEND(drmn, iicbus, 1, 1, 1);
  83
  84 static drm_ioctl_desc_t           drm_ioctls[256] = {
  85         DRM_IOCTL_DEF(DRM_IOCTL_VERSION, drm_version, 0),
  86         DRM_IOCTL_DEF(DRM_IOCTL_GET_UNIQUE, drm_getunique, 0),
  87         DRM_IOCTL_DEF(DRM_IOCTL_GET_MAGIC, drm_getmagic, 0),
  88         DRM_IOCTL_DEF(DRM_IOCTL_IRQ_BUSID, drm_irq_by_busid, DRM_MASTER|DRM_ROOT_ONLY),
  89         DRM_IOCTL_DEF(DRM_IOCTL_GET_MAP, drm_getmap, 0),
  90         DRM_IOCTL_DEF(DRM_IOCTL_GET_CLIENT, drm_getclient, 0),
  91         DRM_IOCTL_DEF(DRM_IOCTL_GET_STATS, drm_getstats, 0),
  92         DRM_IOCTL_DEF(DRM_IOCTL_GET_CAP, drm_getcap, DRM_UNLOCKED),
  93         DRM_IOCTL_DEF(DRM_IOCTL_SET_VERSION, drm_setversion, DRM_MASTER|DRM_ROOT_ONLY),
  94
  95         DRM_IOCTL_DEF(DRM_IOCTL_SET_UNIQUE, drm_setunique, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
  96         DRM_IOCTL_DEF(DRM_IOCTL_BLOCK, drm_noop, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
  97         DRM_IOCTL_DEF(DRM_IOCTL_UNBLOCK, drm_noop, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
  98         DRM_IOCTL_DEF(DRM_IOCTL_AUTH_MAGIC, drm_authmagic, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
  99
 100         DRM_IOCTL_DEF(DRM_IOCTL_ADD_MAP, drm_addmap_ioctl, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 101         DRM_IOCTL_DEF(DRM_IOCTL_RM_MAP, drm_rmmap_ioctl, DRM_AUTH),
 102
 103         DRM_IOCTL_DEF(DRM_IOCTL_SET_SAREA_CTX, drm_setsareactx, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 104         DRM_IOCTL_DEF(DRM_IOCTL_GET_SAREA_CTX, drm_getsareactx, DRM_AUTH),
 105
 106         DRM_IOCTL_DEF(DRM_IOCTL_SET_MASTER, drm_setmaster_ioctl, DRM_ROOT_ONLY),
 107         DRM_IOCTL_DEF(DRM_IOCTL_DROP_MASTER, drm_dropmaster_ioctl, DRM_ROOT_ONLY),
 108
 109         DRM_IOCTL_DEF(DRM_IOCTL_ADD_CTX, drm_addctx, DRM_AUTH|DRM_ROOT_ONLY),
 110         DRM_IOCTL_DEF(DRM_IOCTL_RM_CTX, drm_rmctx, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 111         DRM_IOCTL_DEF(DRM_IOCTL_MOD_CTX, drm_modctx, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 112         DRM_IOCTL_DEF(DRM_IOCTL_GET_CTX, drm_getctx, DRM_AUTH),
 113         DRM_IOCTL_DEF(DRM_IOCTL_SWITCH_CTX, drm_switchctx, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 114         DRM_IOCTL_DEF(DRM_IOCTL_NEW_CTX, drm_newctx, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 115         DRM_IOCTL_DEF(DRM_IOCTL_RES_CTX, drm_resctx, DRM_AUTH),
 116
 117         DRM_IOCTL_DEF(DRM_IOCTL_ADD_DRAW, drm_adddraw, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 118         DRM_IOCTL_DEF(DRM_IOCTL_RM_DRAW, drm_rmdraw, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 119
 120         DRM_IOCTL_DEF(DRM_IOCTL_LOCK, drm_lock, DRM_AUTH),
 121         DRM_IOCTL_DEF(DRM_IOCTL_UNLOCK, drm_unlock, DRM_AUTH),
 122
 123         DRM_IOCTL_DEF(DRM_IOCTL_FINISH, drm_noop, DRM_AUTH),
 124
 125         DRM_IOCTL_DEF(DRM_IOCTL_ADD_BUFS, drm_addbufs, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 126         DRM_IOCTL_DEF(DRM_IOCTL_MARK_BUFS, drm_markbufs, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 127         DRM_IOCTL_DEF(DRM_IOCTL_INFO_BUFS, drm_infobufs, DRM_AUTH),
 128         DRM_IOCTL_DEF(DRM_IOCTL_MAP_BUFS, drm_mapbufs, DRM_AUTH),
 129         DRM_IOCTL_DEF(DRM_IOCTL_FREE_BUFS, drm_freebufs, DRM_AUTH),
 130         DRM_IOCTL_DEF(DRM_IOCTL_DMA, drm_dma, DRM_AUTH),
 131
 132         DRM_IOCTL_DEF(DRM_IOCTL_CONTROL, drm_control, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 133
 134         DRM_IOCTL_DEF(DRM_IOCTL_AGP_ACQUIRE, drm_agp_acquire_ioctl, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 135         DRM_IOCTL_DEF(DRM_IOCTL_AGP_RELEASE, drm_agp_release_ioctl, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 136         DRM_IOCTL_DEF(DRM_IOCTL_AGP_ENABLE, drm_agp_enable_ioctl, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 137         DRM_IOCTL_DEF(DRM_IOCTL_AGP_INFO, drm_agp_info_ioctl, DRM_AUTH),
 138         DRM_IOCTL_DEF(DRM_IOCTL_AGP_ALLOC, drm_agp_alloc_ioctl, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 139         DRM_IOCTL_DEF(DRM_IOCTL_AGP_FREE, drm_agp_free_ioctl, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 140         DRM_IOCTL_DEF(DRM_IOCTL_AGP_BIND, drm_agp_bind_ioctl, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 141         DRM_IOCTL_DEF(DRM_IOCTL_AGP_UNBIND, drm_agp_unbind_ioctl, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 142
 143         DRM_IOCTL_DEF(DRM_IOCTL_SG_ALLOC, drm_sg_alloc_ioctl, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 144         DRM_IOCTL_DEF(DRM_IOCTL_SG_FREE, drm_sg_free, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 145         DRM_IOCTL_DEF(DRM_IOCTL_WAIT_VBLANK, drm_wait_vblank, DRM_UNLOCKED),
 146         DRM_IOCTL_DEF(DRM_IOCTL_MODESET_CTL, drm_modeset_ctl, 0),
 147         DRM_IOCTL_DEF(DRM_IOCTL_UPDATE_DRAW, drm_update_draw, DRM_AUTH|DRM_MASTER|DRM_ROOT_ONLY),
 148
 149         DRM_IOCTL_DEF(DRM_IOCTL_GEM_CLOSE, drm_gem_close_ioctl, DRM_UNLOCKED),
 150         DRM_IOCTL_DEF(DRM_IOCTL_GEM_FLINK, drm_gem_flink_ioctl, DRM_AUTH|DRM_UNLOCKED),
 151         DRM_IOCTL_DEF(DRM_IOCTL_GEM_OPEN, drm_gem_open_ioctl, DRM_AUTH|DRM_UNLOCKED),
 152
 153         DRM_IOCTL_DEF(DRM_IOCTL_MODE_GETRESOURCES, drm_mode_getresources, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 154         DRM_IOCTL_DEF(DRM_IOCTL_MODE_GETPLANERESOURCES, drm_mode_getplane_res, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 155         DRM_IOCTL_DEF(DRM_IOCTL_MODE_GETCRTC, drm_mode_getcrtc, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 156         DRM_IOCTL_DEF(DRM_IOCTL_MODE_SETCRTC, drm_mode_setcrtc, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 157         DRM_IOCTL_DEF(DRM_IOCTL_MODE_GETPLANE, drm_mode_getplane, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 158         DRM_IOCTL_DEF(DRM_IOCTL_MODE_SETPLANE, drm_mode_setplane, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 159         DRM_IOCTL_DEF(DRM_IOCTL_MODE_CURSOR, drm_mode_cursor_ioctl, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 160         DRM_IOCTL_DEF(DRM_IOCTL_MODE_GETGAMMA, drm_mode_gamma_get_ioctl, DRM_MASTER|DRM_UNLOCKED),
 161         DRM_IOCTL_DEF(DRM_IOCTL_MODE_SETGAMMA, drm_mode_gamma_set_ioctl, DRM_MASTER|DRM_UNLOCKED),
 162         DRM_IOCTL_DEF(DRM_IOCTL_MODE_GETENCODER, drm_mode_getencoder, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 163         DRM_IOCTL_DEF(DRM_IOCTL_MODE_GETCONNECTOR, drm_mode_getconnector, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 164         DRM_IOCTL_DEF(DRM_IOCTL_MODE_ATTACHMODE, drm_mode_attachmode_ioctl, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 165         DRM_IOCTL_DEF(DRM_IOCTL_MODE_DETACHMODE, drm_mode_detachmode_ioctl, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 166         DRM_IOCTL_DEF(DRM_IOCTL_MODE_GETPROPERTY, drm_mode_getproperty_ioctl, DRM_MASTER | DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 167         DRM_IOCTL_DEF(DRM_IOCTL_MODE_SETPROPERTY, drm_mode_connector_property_set_ioctl, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 168         DRM_IOCTL_DEF(DRM_IOCTL_MODE_GETPROPBLOB, drm_mode_getblob_ioctl, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 169         DRM_IOCTL_DEF(DRM_IOCTL_MODE_GETFB, drm_mode_getfb, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 170         DRM_IOCTL_DEF(DRM_IOCTL_MODE_ADDFB, drm_mode_addfb, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 171         DRM_IOCTL_DEF(DRM_IOCTL_MODE_ADDFB2, drm_mode_addfb2, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 172         DRM_IOCTL_DEF(DRM_IOCTL_MODE_RMFB, drm_mode_rmfb, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 173         DRM_IOCTL_DEF(DRM_IOCTL_MODE_PAGE_FLIP, drm_mode_page_flip_ioctl, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 174         DRM_IOCTL_DEF(DRM_IOCTL_MODE_DIRTYFB, drm_mode_dirtyfb_ioctl, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 175         DRM_IOCTL_DEF(DRM_IOCTL_MODE_CREATE_DUMB, drm_mode_create_dumb_ioctl, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 176         DRM_IOCTL_DEF(DRM_IOCTL_MODE_MAP_DUMB, drm_mode_mmap_dumb_ioctl, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 177         DRM_IOCTL_DEF(DRM_IOCTL_MODE_DESTROY_DUMB, drm_mode_destroy_dumb_ioctl, DRM_MASTER|DRM_CONTROL_ALLOW|DRM_UNLOCKED),
 178 };
 179
 180 static struct cdevsw drm_cdevsw = {
 181         .d_version =    D_VERSION,
 182         .d_open =       drm_open,
 183         .d_read =       drm_read,
 184         .d_ioctl =      drm_ioctl,
 185         .d_poll =       drm_poll,
 186         .d_mmap =       drm_mmap,
 187         .d_mmap_single = drm_gem_mmap_single,
 188         .d_name =       "drm",
 189         .d_flags =      D_TRACKCLOSE
 190 };
 191
 192 static int drm_msi = 1; /* Enable by default. */
 193 TUNABLE_INT("hw.drm.msi", &drm_msi);
 194 SYSCTL_NODE(_hw, OID_AUTO, drm, CTLFLAG_RW, NULL, "DRM device");
 195 SYSCTL_INT(_hw_drm, OID_AUTO, msi, CTLFLAG_RDTUN, &drm_msi, 1,
 196     "Enable MSI interrupts for drm devices");
 197
 198 static struct drm_msi_blacklist_entry drm_msi_blacklist[] = {
 199         {0x8086, 0x2772}, /* Intel i945G        */ \
 200         {0x8086, 0x27A2}, /* Intel i945GM       */ \
 201         {0x8086, 0x27AE}, /* Intel i945GME      */ \
 202         {0, 0}
 203 };
 204
 205 static int drm_msi_is_blacklisted(int vendor, int device)
 206 {
 207         int i = 0;
 208
 209         for (i = 0; drm_msi_blacklist[i].vendor != 0; i++) {
 210                 if ((drm_msi_blacklist[i].vendor == vendor) &&
 211                     (drm_msi_blacklist[i].device == device)) {
 212                         return 1;
 213                 }
 214         }
 215
 216         return 0;
 217 }
 218
 219 int drm_probe(device_t kdev, drm_pci_id_list_t *idlist)
 220 {
 221         drm_pci_id_list_t *id_entry;
 222         int vendor, device;
 223
 224         vendor = pci_get_vendor(kdev);
 225         device = pci_get_device(kdev);
 226
 227         if (pci_get_class(kdev) != PCIC_DISPLAY
 228             || pci_get_subclass(kdev) != PCIS_DISPLAY_VGA)
 229                 return ENXIO;
 230
 231         id_entry = drm_find_description(vendor, device, idlist);
 232         if (id_entry != NULL) {
 233                 if (!device_get_desc(kdev)) {
 234                         DRM_DEBUG("desc : %s\n", device_get_desc(kdev));
 235                         device_set_desc(kdev, id_entry->name);
 236                 }
 237                 return 0;
 238         }
 239
 240         return ENXIO;
 241 }
 242
 243 int drm_attach(device_t kdev, drm_pci_id_list_t *idlist)
 244 {
 245         struct drm_device *dev;
 246         drm_pci_id_list_t *id_entry;
 247         int error, msicount;
 248
 249         dev = device_get_softc(kdev);
 250
 251         dev->device = kdev;
 252
 253         dev->pci_domain = pci_get_domain(dev->device);
 254         dev->pci_bus = pci_get_bus(dev->device);
 255         dev->pci_slot = pci_get_slot(dev->device);
 256         dev->pci_func = pci_get_function(dev->device);
 257
 258         dev->pci_vendor = pci_get_vendor(dev->device);
 259         dev->pci_device = pci_get_device(dev->device);
 260
 261         if (drm_core_check_feature(dev, DRIVER_HAVE_IRQ)) {
 262                 if (drm_msi &&
 263                     !drm_msi_is_blacklisted(dev->pci_vendor, dev->pci_device)) {
 264                         msicount = pci_msi_count(dev->device);
 265                         DRM_DEBUG("MSI count = %d\n", msicount);
 266                         if (msicount > 1)
 267                                 msicount = 1;
 268
 269                         if (pci_alloc_msi(dev->device, &msicount) == 0) {
 270                                 DRM_INFO("MSI enabled %d message(s)\n",
 271                                     msicount);
 272                                 dev->msi_enabled = 1;
 273                                 dev->irqrid = 1;
 274                         }
 275                 }
 276
 277                 dev->irqr = bus_alloc_resource_any(dev->device, SYS_RES_IRQ,
 278                     &dev->irqrid, RF_SHAREABLE);
 279                 if (!dev->irqr) {
 280                         return (ENOENT);
 281                 }
 282
 283                 dev->irq = (int) rman_get_start(dev->irqr);
 284         }
 285
 286         lockinit(&dev->dev_lock, "drmdev", 0, LK_CANRECURSE);
 287         lwkt_serialize_init(&dev->irq_lock);
 288         lockinit(&dev->vbl_lock, "drmvbl", 0, LK_CANRECURSE);
 289         DRM_SPININIT(&dev->drw_lock, "drmdrw");
 290         lockinit(&dev->event_lock, "drmev", 0, LK_CANRECURSE);
 291         lockinit(&dev->dev_struct_lock, "drmslk", 0, LK_CANRECURSE);
 292
 293         id_entry = drm_find_description(dev->pci_vendor,
 294             dev->pci_device, idlist);
 295         dev->id_entry = id_entry;
 296
 297         error = drm_load(dev);
 298         if (error == 0)
 299                 error = drm_create_cdevs(kdev);
 300         return (error);
 301 }
 302
 303 int
 304 drm_create_cdevs(device_t kdev)
 305 {
 306         struct drm_device *dev;
 307         int error, unit;
 308
 309         unit = device_get_unit(kdev);
 310         dev = device_get_softc(kdev);
 311
 312         error = make_dev_p(MAKEDEV_WAITOK | MAKEDEV_CHECKNAME, &dev->devnode,
 313             &drm_cdevsw, 0, DRM_DEV_UID, DRM_DEV_GID,
 314             DRM_DEV_MODE, "dri/card%d", unit);
 315         if (error == 0)
 316                 dev->devnode->si_drv1 = dev;
 317         return (error);
 318 }
 319
 320 int drm_detach(device_t kdev)
 321 {
 322         struct drm_device *dev;
 323
 324         dev = device_get_softc(kdev);
 325         drm_unload(dev);
 326         if (dev->irqr) {
 327                 bus_release_resource(dev->device, SYS_RES_IRQ, dev->irqrid,
 328                     dev->irqr);
 329                 if (dev->msi_enabled) {
 330                         pci_release_msi(dev->device);
 331                         DRM_INFO("MSI released\n");
 332                 }
 333         }
 334         return (0);
 335 }
 336
 337 #ifndef DRM_DEV_NAME
 338 #define DRM_DEV_NAME "drm"
 339 #endif
 340
 341 devclass_t drm_devclass;
 342
 343 drm_pci_id_list_t *drm_find_description(int vendor, int device,
 344     drm_pci_id_list_t *idlist)
 345 {
 346         int i = 0;
 347
 348         for (i = 0; idlist[i].vendor != 0; i++) {
 349                 if ((idlist[i].vendor == vendor) &&
 350                     ((idlist[i].device == device) ||
 351                     (idlist[i].device == 0))) {
 352                         return &idlist[i];
 353                 }
 354         }
 355         return NULL;
 356 }
 357
 358 static int drm_firstopen(struct drm_device *dev)
 359 {
 360         drm_local_map_t *map;
 361         int i;
 362
 363         DRM_LOCK_ASSERT(dev);
 364
 365         /* prebuild the SAREA */
 366         i = drm_addmap(dev, 0, SAREA_MAX, _DRM_SHM,
 367             _DRM_CONTAINS_LOCK, &map);
 368         if (i != 0)
 369                 return i;
 370
 371         if (dev->driver->firstopen)
 372                 dev->driver->firstopen(dev);
 373
 374         dev->buf_use = 0;
 375
 376         if (drm_core_check_feature(dev, DRIVER_HAVE_DMA)) {
 377                 i = drm_dma_setup(dev);
 378                 if (i != 0)
 379                         return i;
 380         }
 381
 382         for (i = 0; i < DRM_HASH_SIZE; i++) {
 383                 dev->magiclist[i].head = NULL;
 384                 dev->magiclist[i].tail = NULL;
 385         }
 386
 387         dev->lock.lock_queue = 0;
 388         if (!drm_core_check_feature(dev, DRIVER_MODESET))
 389                 dev->irq_enabled = 0;
 390         dev->context_flag = 0;
 391         dev->last_context = 0;
 392         dev->if_version = 0;
 393
 394         dev->buf_sigio = NULL;
 395
 396         DRM_DEBUG("\n");
 397
 398         return 0;
 399 }
 400
 401 static int drm_lastclose(struct drm_device *dev)
 402 {
 403         drm_magic_entry_t *pt, *next;
 404         drm_local_map_t *map, *mapsave;
 405         int i;
 406
 407         DRM_LOCK_ASSERT(dev);
 408
 409         DRM_DEBUG("\n");
 410
 411         if (dev->driver->lastclose != NULL)
 412                 dev->driver->lastclose(dev);
 413
 414         if (!drm_core_check_feature(dev, DRIVER_MODESET) && dev->irq_enabled)
 415                 drm_irq_uninstall(dev);
 416
 417         if (dev->unique) {
 418                 kfree(dev->unique, DRM_MEM_DRIVER);
 419                 dev->unique = NULL;
 420                 dev->unique_len = 0;
 421         }
 422         /* Clear pid list */
 423         for (i = 0; i < DRM_HASH_SIZE; i++) {
 424                 for (pt = dev->magiclist[i].head; pt; pt = next) {
 425                         next = pt->next;
 426                         kfree(pt, DRM_MEM_MAGIC);
 427                 }
 428                 dev->magiclist[i].head = dev->magiclist[i].tail = NULL;
 429         }
 430
 431         DRM_UNLOCK(dev);
 432         drm_drawable_free_all(dev);
 433         DRM_LOCK(dev);
 434
 435         /* Clear AGP information */
 436         if (dev->agp) {
 437                 drm_agp_mem_t *entry;
 438                 drm_agp_mem_t *nexte;
 439
 440                 /* Remove AGP resources, but leave dev->agp intact until
 441                  * drm_unload is called.
 442                  */
 443                 for (entry = dev->agp->memory; entry; entry = nexte) {
 444                         nexte = entry->next;
 445                         if (entry->bound)
 446                                 drm_agp_unbind_memory(entry->handle);
 447                         drm_agp_free_memory(entry->handle);
 448                         kfree(entry, DRM_MEM_AGPLISTS);
 449                 }
 450                 dev->agp->memory = NULL;
 451
 452                 if (dev->agp->acquired)
 453                         drm_agp_release(dev);
 454
 455                 dev->agp->acquired = 0;
 456                 dev->agp->enabled  = 0;
 457         }
 458         if (dev->sg != NULL) {
 459                 drm_sg_cleanup(dev->sg);
 460                 dev->sg = NULL;
 461         }
 462
 463         TAILQ_FOREACH_SAFE(map, &dev->maplist, link, mapsave) {
 464                 if (!(map->flags & _DRM_DRIVER))
 465                         drm_rmmap(dev, map);
 466         }
 467
 468         drm_dma_takedown(dev);
 469         if (dev->lock.hw_lock) {
 470                 dev->lock.hw_lock = NULL; /* SHM removed */
 471                 dev->lock.file_priv = NULL;
 472                 DRM_WAKEUP_INT((void *)&dev->lock.lock_queue);
 473         }
 474
 475         return 0;
 476 }
 477
 478 static int drm_load(struct drm_device *dev)
 479 {
 480         int i, retcode;
 481
 482         DRM_DEBUG("\n");
 483
 484         TAILQ_INIT(&dev->maplist);
 485         dev->map_unrhdr = new_unrhdr(1, ((1 << DRM_MAP_HANDLE_BITS) - 1), NULL);
 486         if (dev->map_unrhdr == NULL) {
 487                 DRM_ERROR("Couldn't allocate map number allocator\n");
 488                 return EINVAL;
 489         }
 490
 491
 492         drm_mem_init();
 493         drm_sysctl_init(dev);
 494         TAILQ_INIT(&dev->files);
 495
 496         dev->counters  = 6;
 497         dev->types[0]  = _DRM_STAT_LOCK;
 498         dev->types[1]  = _DRM_STAT_OPENS;
 499         dev->types[2]  = _DRM_STAT_CLOSES;
 500         dev->types[3]  = _DRM_STAT_IOCTLS;
 501         dev->types[4]  = _DRM_STAT_LOCKS;
 502         dev->types[5]  = _DRM_STAT_UNLOCKS;
 503
 504         for (i = 0; i < DRM_ARRAY_SIZE(dev->counts); i++)
 505                 atomic_set(&dev->counts[i], 0);
 506
 507         INIT_LIST_HEAD(&dev->vblank_event_list);
 508
 509         if (drm_core_has_AGP(dev)) {
 510                 if (drm_device_is_agp(dev))
 511                         dev->agp = drm_agp_init();
 512                 if (drm_core_check_feature(dev, DRIVER_REQUIRE_AGP) &&
 513                     dev->agp == NULL) {
 514                         DRM_ERROR("Card isn't AGP, or couldn't initialize "
 515                             "AGP.\n");
 516                         retcode = ENOMEM;
 517                         goto error;
 518                 }
 519                 if (dev->agp != NULL && dev->agp->info.ai_aperture_base != 0) {
 520                         if (drm_mtrr_add(dev->agp->info.ai_aperture_base,
 521                             dev->agp->info.ai_aperture_size, DRM_MTRR_WC) == 0)
 522                                 dev->agp->mtrr = 1;
 523                 }
 524         }
 525
 526         retcode = drm_ctxbitmap_init(dev);
 527         if (retcode != 0) {
 528                 DRM_ERROR("Cannot allocate memory for context bitmap.\n");
 529                 goto error;
 530         }
 531
 532         dev->drw_unrhdr = new_unrhdr(1, INT_MAX, NULL);
 533         if (dev->drw_unrhdr == NULL) {
 534                 DRM_ERROR("Couldn't allocate drawable number allocator\n");
 535                 retcode = ENOMEM;
 536                 goto error;
 537         }
 538
 539         if (dev->driver->driver_features & DRIVER_GEM) {
 540                 retcode = drm_gem_init(dev);
 541                 if (retcode != 0) {
 542                         DRM_ERROR("Cannot initialize graphics execution "
 543                                   "manager (GEM)\n");
 544                         goto error1;
 545                 }
 546         }
 547
 548         if (dev->driver->load != NULL) {
 549                 DRM_LOCK(dev);
 550                 /* Shared code returns -errno. */
 551                 retcode = -dev->driver->load(dev,
 552                     dev->id_entry->driver_private);
 553                 if (pci_enable_busmaster(dev->device))
 554                         DRM_ERROR("Request to enable bus-master failed.\n");
 555                 DRM_UNLOCK(dev);
 556                 if (retcode != 0)
 557                         goto error;
 558         }
 559
 560         DRM_INFO("Initialized %s %d.%d.%d %s\n",
 561             dev->driver->name,
 562             dev->driver->major,
 563             dev->driver->minor,
 564             dev->driver->patchlevel,
 565             dev->driver->date);
 566
 567         return 0;
 568
 569 error1:
 570         delete_unrhdr(dev->drw_unrhdr);
 571 error:
 572         drm_sysctl_cleanup(dev);
 573         DRM_LOCK(dev);
 574         drm_lastclose(dev);
 575         DRM_UNLOCK(dev);
 576         if (dev->devnode != NULL)
 577                 destroy_dev(dev->devnode);
 578
 579         DRM_SPINUNINIT(&dev->drw_lock);
 580         lockuninit(&dev->vbl_lock);
 581         lockuninit(&dev->dev_lock);
 582         lockuninit(&dev->event_lock);
 583         lockuninit(&dev->dev_struct_lock);
 584
 585         return retcode;
 586 }
 587
 588 static void drm_unload(struct drm_device *dev)
 589 {
 590         int i;
 591
 592         DRM_DEBUG("\n");
 593
 594         drm_sysctl_cleanup(dev);
 595         if (dev->devnode != NULL)
 596                 destroy_dev(dev->devnode);
 597
 598         drm_ctxbitmap_cleanup(dev);
 599
 600         if (dev->driver->driver_features & DRIVER_GEM)
 601                 drm_gem_destroy(dev);
 602
 603         if (dev->agp && dev->agp->mtrr) {
 604                 int __unused retcode;
 605
 606                 retcode = drm_mtrr_del(0, dev->agp->info.ai_aperture_base,
 607                     dev->agp->info.ai_aperture_size, DRM_MTRR_WC);
 608                 DRM_DEBUG("mtrr_del = %d", retcode);
 609         }
 610
 611         drm_vblank_cleanup(dev);
 612
 613         DRM_LOCK(dev);
 614         drm_lastclose(dev);
 615         DRM_UNLOCK(dev);
 616
 617         /* Clean up PCI resources allocated by drm_bufs.c.  We're not really
 618          * worried about resource consumption while the DRM is inactive (between
 619          * lastclose and firstopen or unload) because these aren't actually
 620          * taking up KVA, just keeping the PCI resource allocated.
 621          */
 622         for (i = 0; i < DRM_MAX_PCI_RESOURCE; i++) {
 623                 if (dev->pcir[i] == NULL)
 624                         continue;
 625                 bus_release_resource(dev->device, SYS_RES_MEMORY,
 626                     dev->pcirid[i], dev->pcir[i]);
 627                 dev->pcir[i] = NULL;
 628         }
 629
 630         if (dev->agp) {
 631                 kfree(dev->agp, DRM_MEM_AGPLISTS);
 632                 dev->agp = NULL;
 633         }
 634
 635         if (dev->driver->unload != NULL) {
 636                 DRM_LOCK(dev);
 637                 dev->driver->unload(dev);
 638                 DRM_UNLOCK(dev);
 639         }
 640
 641         delete_unrhdr(dev->drw_unrhdr);
 642         delete_unrhdr(dev->map_unrhdr);
 643
 644         drm_mem_uninit();
 645
 646         if (pci_disable_busmaster(dev->device))
 647                 DRM_ERROR("Request to disable bus-master failed.\n");
 648
 649         DRM_SPINUNINIT(&dev->drw_lock);
 650         lockuninit(&dev->vbl_lock);
 651         lockuninit(&dev->dev_lock);
 652         lockuninit(&dev->event_lock);
 653         lockuninit(&dev->dev_struct_lock);
 654 }
 655
 656 int drm_version(struct drm_device *dev, void *data, struct drm_file *file_priv)
 657 {
 658         struct drm_version *version = data;
 659         int len;
 660
 661 #define DRM_COPY( name, value )                                         \
 662         len = strlen( value );                                          \
 663         if ( len > name##_len ) len = name##_len;                       \
 664         name##_len = strlen( value );                                   \
 665         if ( len && name ) {                                            \
 666                 if ( DRM_COPY_TO_USER( name, value, len ) )             \
 667                         return EFAULT;                          \
 668         }
 669
 670         version->version_major          = dev->driver->major;
 671         version->version_minor          = dev->driver->minor;
 672         version->version_patchlevel     = dev->driver->patchlevel;
 673
 674         DRM_COPY(version->name, dev->driver->name);
 675         DRM_COPY(version->date, dev->driver->date);
 676         DRM_COPY(version->desc, dev->driver->desc);
 677
 678         return 0;
 679 }
 680
 681 int
 682 drm_open(struct cdev *kdev, int flags, int fmt, DRM_STRUCTPROC *p)
 683 {
 684         struct drm_device *dev;
 685         int retcode;
 686
 687         dev = kdev->si_drv1;
 688         if (dev == NULL)
 689                 return (ENXIO);
 690
 691         DRM_DEBUG("open_count = %d\n", dev->open_count);
 692
 693         retcode = drm_open_helper(kdev, flags, fmt, p, dev);
 694
 695         if (retcode == 0) {
 696                 atomic_inc(&dev->counts[_DRM_STAT_OPENS]);
 697                 DRM_LOCK(dev);
 698                 device_busy(dev->device);
 699                 if (!dev->open_count++)
 700                         retcode = drm_firstopen(dev);
 701                 DRM_UNLOCK(dev);
 702         }
 703
 704         return (retcode);
 705 }
 706
 707 void drm_close(void *data)
 708 {
 709         struct drm_file *file_priv = data;
 710         struct drm_device *dev = file_priv->dev;
 711         int retcode = 0;
 712
 713         DRM_DEBUG("open_count = %d\n", dev->open_count);
 714
 715         DRM_LOCK(dev);
 716
 717         if (dev->driver->preclose != NULL)
 718                 dev->driver->preclose(dev, file_priv);
 719
 720         /* ========================================================
 721          * Begin inline drm_release
 722          */
 723
 724         DRM_DEBUG("pid = %d, device = 0x%lx, open_count = %d\n",
 725             DRM_CURRENTPID, (long)dev->device, dev->open_count);
 726
 727         if (dev->driver->driver_features & DRIVER_GEM)
 728                 drm_gem_release(dev, file_priv);
 729
 730         if (dev->lock.hw_lock && _DRM_LOCK_IS_HELD(dev->lock.hw_lock->lock)
 731             && dev->lock.file_priv == file_priv) {
 732                 DRM_DEBUG("Process %d dead, freeing lock for context %d\n",
 733                           DRM_CURRENTPID,
 734                           _DRM_LOCKING_CONTEXT(dev->lock.hw_lock->lock));
 735                 if (dev->driver->reclaim_buffers_locked != NULL)
 736                         dev->driver->reclaim_buffers_locked(dev, file_priv);
 737
 738                 drm_lock_free(&dev->lock,
 739                     _DRM_LOCKING_CONTEXT(dev->lock.hw_lock->lock));
 740
 741                                 /* FIXME: may require heavy-handed reset of
 742                                    hardware at this point, possibly
 743                                    processed via a callback to the X
 744                                    server. */
 745         } else if (dev->driver->reclaim_buffers_locked != NULL &&
 746             dev->lock.hw_lock != NULL) {
 747                 /* The lock is required to reclaim buffers */
 748                 for (;;) {
 749                         if (!dev->lock.hw_lock) {
 750                                 /* Device has been unregistered */
 751                                 retcode = EINTR;
 752                                 break;
 753                         }
 754                         if (drm_lock_take(&dev->lock, DRM_KERNEL_CONTEXT)) {
 755                                 dev->lock.file_priv = file_priv;
 756                                 dev->lock.lock_time = jiffies;
 757                                 atomic_inc(&dev->counts[_DRM_STAT_LOCKS]);
 758                                 break;  /* Got lock */
 759                         }
 760                         /* Contention */
 761                         retcode = DRM_LOCK_SLEEP(dev, &dev->lock.lock_queue,
 762                             PCATCH, "drmlk2", 0);
 763                         if (retcode)
 764                                 break;
 765                 }
 766                 if (retcode == 0) {
 767                         dev->driver->reclaim_buffers_locked(dev, file_priv);
 768                         drm_lock_free(&dev->lock, DRM_KERNEL_CONTEXT);
 769                 }
 770         }
 771
 772         if (drm_core_check_feature(dev, DRIVER_HAVE_DMA) &&
 773             !dev->driver->reclaim_buffers_locked)
 774                 drm_reclaim_buffers(dev, file_priv);
 775
 776         funsetown(&dev->buf_sigio);
 777         seldrain(&file_priv->event_poll);
 778
 779         if (dev->driver->postclose != NULL)
 780                 dev->driver->postclose(dev, file_priv);
 781         TAILQ_REMOVE(&dev->files, file_priv, link);
 782         kfree(file_priv, DRM_MEM_FILES);
 783
 784         /* ========================================================
 785          * End inline drm_release
 786          */
 787
 788         atomic_inc(&dev->counts[_DRM_STAT_CLOSES]);
 789         device_unbusy(dev->device);
 790         if (--dev->open_count == 0) {
 791                 retcode = drm_lastclose(dev);
 792         }
 793
 794         DRM_UNLOCK(dev);
 795 }
 796
 797 /* drm_ioctl is called whenever a process performs an ioctl on /dev/drm.
 798  */
 799 int drm_ioctl(struct cdev *kdev, u_long cmd, caddr_t data, int flags,
 800     DRM_STRUCTPROC *p)
 801 {
 802         struct drm_device *dev = drm_get_device_from_kdev(kdev);
 803         int retcode = 0;
 804         drm_ioctl_desc_t *ioctl;
 805         int (*func)(struct drm_device *dev, void *data, struct drm_file *file_priv);
 806         int nr = DRM_IOCTL_NR(cmd);
 807         int is_driver_ioctl = 0;
 808         struct drm_file *file_priv;
 809
 810         retcode = devfs_get_cdevpriv((void **)&file_priv);
 811         if (retcode != 0) {
 812                 DRM_ERROR("can't find authenticator\n");
 813                 return EINVAL;
 814         }
 815
 816         atomic_inc(&dev->counts[_DRM_STAT_IOCTLS]);
 817         ++file_priv->ioctl_count;
 818
 819         DRM_DEBUG("pid=%d, cmd=0x%02lx, nr=0x%02x, dev 0x%lx, auth=%d\n",
 820             DRM_CURRENTPID, cmd, nr, (long)dev->device,
 821             file_priv->authenticated);
 822
 823         switch (cmd) {
 824         case FIONBIO:
 825         case FIOASYNC:
 826                 return 0;
 827
 828         case FIOSETOWN:
 829                 return fsetown(*(int *)data, &dev->buf_sigio);
 830
 831         case FIOGETOWN:
 832                 *(int *) data = fgetown(&dev->buf_sigio);
 833                 return 0;
 834         }
 835
 836         if (IOCGROUP(cmd) != DRM_IOCTL_BASE) {
 837                 DRM_DEBUG("Bad ioctl group 0x%x\n", (int)IOCGROUP(cmd));
 838                 return EINVAL;
 839         }
 840
 841         ioctl = &drm_ioctls[nr];
 842         /* It's not a core DRM ioctl, try driver-specific. */
 843         if (ioctl->func == NULL && nr >= DRM_COMMAND_BASE) {
 844                 /* The array entries begin at DRM_COMMAND_BASE ioctl nr */
 845                 nr -= DRM_COMMAND_BASE;
 846                 if (nr > dev->driver->max_ioctl) {
 847                         DRM_DEBUG("Bad driver ioctl number, 0x%x (of 0x%x)\n",
 848                             nr, dev->driver->max_ioctl);
 849                         return EINVAL;
 850                 }
 851                 ioctl = &dev->driver->ioctls[nr];
 852                 is_driver_ioctl = 1;
 853         }
 854         func = ioctl->func;
 855
 856         if (func == NULL) {
 857                 DRM_DEBUG("no function\n");
 858                 return EINVAL;
 859         }
 860
 861         if (((ioctl->flags & DRM_ROOT_ONLY) && !DRM_SUSER(p)) ||
 862             ((ioctl->flags & DRM_AUTH) && !file_priv->authenticated) ||
 863             ((ioctl->flags & DRM_MASTER) && !file_priv->master))
 864                 return EACCES;
 865
 866         if (is_driver_ioctl) {
 867                 if ((ioctl->flags & DRM_UNLOCKED) == 0)
 868                         DRM_LOCK(dev);
 869                 /* shared code returns -errno */
 870                 retcode = -func(dev, data, file_priv);
 871                 if ((ioctl->flags & DRM_UNLOCKED) == 0)
 872                         DRM_UNLOCK(dev);
 873         } else {
 874                 retcode = func(dev, data, file_priv);
 875         }
 876
 877         if (retcode != 0)
 878                 DRM_DEBUG("    returning %d\n", retcode);
 879         if (retcode != 0 &&
 880             (drm_debug_flag & DRM_DEBUGBITS_FAILED_IOCTL) != 0) {
 881                 kprintf(
 882 "pid %d, cmd 0x%02lx, nr 0x%02x/%1d, dev 0x%lx, auth %d, res %d\n",
 883                     DRM_CURRENTPID, cmd, nr, is_driver_ioctl, (long)dev->device,
 884                     file_priv->authenticated, retcode);
 885         }
 886
 887         return retcode;
 888 }
 889
 890 drm_local_map_t *drm_getsarea(struct drm_device *dev)
 891 {
 892         drm_local_map_t *map;
 893
 894         DRM_LOCK_ASSERT(dev);
 895         TAILQ_FOREACH(map, &dev->maplist, link) {
 896                 if (map->type == _DRM_SHM && (map->flags & _DRM_CONTAINS_LOCK))
 897                         return map;
 898         }
 899
 900         return NULL;
 901 }
 902
 903 int
 904 drm_add_busid_modesetting(struct drm_device *dev, struct sysctl_ctx_list *ctx,
 905     struct sysctl_oid *top)
 906 {
 907         struct sysctl_oid *oid;
 908
 909         ksnprintf(dev->busid_str, sizeof(dev->busid_str),
 910              "pci:%04x:%02x:%02x.%d", dev->pci_domain, dev->pci_bus,
 911              dev->pci_slot, dev->pci_func);
 912         oid = SYSCTL_ADD_STRING(ctx, SYSCTL_CHILDREN(top), OID_AUTO, "busid",
 913             CTLFLAG_RD, dev->busid_str, 0, NULL);
 914         if (oid == NULL)
 915                 return (ENOMEM);
 916         dev->modesetting = (dev->driver->driver_features & DRIVER_MODESET) != 0;
 917         oid = SYSCTL_ADD_INT(ctx, SYSCTL_CHILDREN(top), OID_AUTO,
 918             "modesetting", CTLFLAG_RD, &dev->modesetting, 0, NULL);
 919         if (oid == NULL)
 920                 return (ENOMEM);
 921
 922         return (0);
 923 }
 924
 925 #if DRM_LINUX
 926
 927 #include <sys/sysproto.h>
 928
 929 MODULE_DEPEND(DRIVER_NAME, linux, 1, 1, 1);
 930
 931 #define LINUX_IOCTL_DRM_MIN             0x6400
 932 #define LINUX_IOCTL_DRM_MAX             0x64ff
 933
 934 static linux_ioctl_function_t drm_linux_ioctl;
 935 static struct linux_ioctl_handler drm_handler = {drm_linux_ioctl,
 936     LINUX_IOCTL_DRM_MIN, LINUX_IOCTL_DRM_MAX};
 937
 938 SYSINIT(drm_register, SI_SUB_KLD, SI_ORDER_MIDDLE,
 939     linux_ioctl_register_handler, &drm_handler);
 940 SYSUNINIT(drm_unregister, SI_SUB_KLD, SI_ORDER_MIDDLE,
 941     linux_ioctl_unregister_handler, &drm_handler);
 942
 943 /* The bits for in/out are switched on Linux */
 944 #define LINUX_IOC_IN    IOC_OUT
 945 #define LINUX_IOC_OUT   IOC_IN
 946
 947 static int
 948 drm_linux_ioctl(DRM_STRUCTPROC *p, struct linux_ioctl_args* args)
 949 {
 950         int error;
 951         int cmd = args->cmd;
 952
 953         args->cmd &= ~(LINUX_IOC_IN | LINUX_IOC_OUT);
 954         if (cmd & LINUX_IOC_IN)
 955                 args->cmd |= IOC_IN;
 956         if (cmd & LINUX_IOC_OUT)
 957                 args->cmd |= IOC_OUT;
 958
 959         error = ioctl(p, (struct ioctl_args *)args);
 960
 961         return error;
 962 }
 963 #endif /* DRM_LINUX */
 964
 965 bool
 966 dmi_check_system(const struct dmi_system_id *sysid)
 967 {
 968
 969         /* XXXKIB */
 970         return (false);
 971 }
 972