sys/dev/drm/drm_drv.c

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