drivers/gpu/drm/vmwgfx/vmwgfx_ldu.c

   1 /**************************************************************************
   2  *
   3  * Copyright © 2009 VMware, Inc., Palo Alto, CA., USA
   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
   8  * "Software"), to deal in the Software without restriction, including
   9  * without limitation the rights to use, copy, modify, merge, publish,
  10  * distribute, sub license, and/or sell copies of the Software, and to
  11  * permit persons to whom the Software is furnished to do so, subject to
  12  * the following conditions:
  13  *
  14  * The above copyright notice and this permission notice (including the
  15  * next paragraph) shall be included in all copies or substantial portions
  16  * of the Software.
  17  *
  18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
  21  * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
  22  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  23  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  24  * USE OR OTHER DEALINGS IN THE SOFTWARE.
  25  *
  26  **************************************************************************/
  27
  28 #include "vmwgfx_kms.h"
  29
  30 #define vmw_crtc_to_ldu(x) \
  31         container_of(x, struct vmw_legacy_display_unit, base.crtc)
  32 #define vmw_encoder_to_ldu(x) \
  33         container_of(x, struct vmw_legacy_display_unit, base.encoder)
  34 #define vmw_connector_to_ldu(x) \
  35         container_of(x, struct vmw_legacy_display_unit, base.connector)
  36
  37 struct vmw_legacy_display {
  38         struct list_head active;
  39
  40         unsigned num_active;
  41         unsigned last_num_active;
  42
  43         struct vmw_framebuffer *fb;
  44 };
  45
  46 /**
  47  * Display unit using the legacy register interface.
  48  */
  49 struct vmw_legacy_display_unit {
  50         struct vmw_display_unit base;
  51
  52         struct list_head active;
  53 };
  54
  55 static void vmw_ldu_destroy(struct vmw_legacy_display_unit *ldu)
  56 {
  57         list_del_init(&ldu->active);
  58         vmw_display_unit_cleanup(&ldu->base);
  59         kfree(ldu);
  60 }
  61
  62
  63 /*
  64  * Legacy Display Unit CRTC functions
  65  */
  66
  67 static void vmw_ldu_crtc_save(struct drm_crtc *crtc)
  68 {
  69 }
  70
  71 static void vmw_ldu_crtc_restore(struct drm_crtc *crtc)
  72 {
  73 }
  74
  75 static void vmw_ldu_crtc_gamma_set(struct drm_crtc *crtc,
  76                                    u16 *r, u16 *g, u16 *b,
  77                                    uint32_t size)
  78 {
  79 }
  80
  81 static void vmw_ldu_crtc_destroy(struct drm_crtc *crtc)
  82 {
  83         vmw_ldu_destroy(vmw_crtc_to_ldu(crtc));
  84 }
  85
  86 static int vmw_ldu_commit_list(struct vmw_private *dev_priv)
  87 {
  88         struct vmw_legacy_display *lds = dev_priv->ldu_priv;
  89         struct vmw_legacy_display_unit *entry;
  90         struct drm_framebuffer *fb = NULL;
  91         struct drm_crtc *crtc = NULL;
  92         int i = 0;
  93
  94         /* If there is no display topology the host just assumes
  95          * that the guest will set the same layout as the host.
  96          */
  97         if (!(dev_priv->capabilities & SVGA_CAP_DISPLAY_TOPOLOGY)) {
  98                 int w = 0, h = 0;
  99                 list_for_each_entry(entry, &lds->active, active) {
 100                         crtc = &entry->base.crtc;
 101                         w = max(w, crtc->x + crtc->mode.hdisplay);
 102                         h = max(h, crtc->y + crtc->mode.vdisplay);
 103                         i++;
 104                 }
 105
 106                 if (crtc == NULL)
 107                         return 0;
 108                 fb = entry->base.crtc.fb;
 109
 110                 vmw_kms_write_svga(dev_priv, w, h, fb->pitch,
 111                                    fb->bits_per_pixel, fb->depth);
 112
 113                 return 0;
 114         }
 115
 116         if (!list_empty(&lds->active)) {
 117                 entry = list_entry(lds->active.next, typeof(*entry), active);
 118                 fb = entry->base.crtc.fb;
 119
 120                 vmw_kms_write_svga(dev_priv, fb->width, fb->height, fb->pitch,
 121                                    fb->bits_per_pixel, fb->depth);
 122         }
 123
 124         /* Make sure we always show something. */
 125         vmw_write(dev_priv, SVGA_REG_NUM_GUEST_DISPLAYS,
 126                   lds->num_active ? lds->num_active : 1);
 127
 128         i = 0;
 129         list_for_each_entry(entry, &lds->active, active) {
 130                 crtc = &entry->base.crtc;
 131
 132                 vmw_write(dev_priv, SVGA_REG_DISPLAY_ID, i);
 133                 vmw_write(dev_priv, SVGA_REG_DISPLAY_IS_PRIMARY, !i);
 134                 vmw_write(dev_priv, SVGA_REG_DISPLAY_POSITION_X, crtc->x);
 135                 vmw_write(dev_priv, SVGA_REG_DISPLAY_POSITION_Y, crtc->y);
 136                 vmw_write(dev_priv, SVGA_REG_DISPLAY_WIDTH, crtc->mode.hdisplay);
 137                 vmw_write(dev_priv, SVGA_REG_DISPLAY_HEIGHT, crtc->mode.vdisplay);
 138                 vmw_write(dev_priv, SVGA_REG_DISPLAY_ID, SVGA_ID_INVALID);
 139
 140                 i++;
 141         }
 142
 143         BUG_ON(i != lds->num_active);
 144
 145         lds->last_num_active = lds->num_active;
 146
 147         return 0;
 148 }
 149
 150 static int vmw_ldu_del_active(struct vmw_private *vmw_priv,
 151                               struct vmw_legacy_display_unit *ldu)
 152 {
 153         struct vmw_legacy_display *ld = vmw_priv->ldu_priv;
 154         if (list_empty(&ldu->active))
 155                 return 0;
 156
 157         /* Must init otherwise list_empty(&ldu->active) will not work. */
 158         list_del_init(&ldu->active);
 159         if (--(ld->num_active) == 0) {
 160                 BUG_ON(!ld->fb);
 161                 if (ld->fb->unpin)
 162                         ld->fb->unpin(ld->fb);
 163                 ld->fb = NULL;
 164         }
 165
 166         return 0;
 167 }
 168
 169 static int vmw_ldu_add_active(struct vmw_private *vmw_priv,
 170                               struct vmw_legacy_display_unit *ldu,
 171                               struct vmw_framebuffer *vfb)
 172 {
 173         struct vmw_legacy_display *ld = vmw_priv->ldu_priv;
 174         struct vmw_legacy_display_unit *entry;
 175         struct list_head *at;
 176
 177         BUG_ON(!ld->num_active && ld->fb);
 178         if (vfb != ld->fb) {
 179                 if (ld->fb && ld->fb->unpin)
 180                         ld->fb->unpin(ld->fb);
 181                 if (vfb->pin)
 182                         vfb->pin(vfb);
 183                 ld->fb = vfb;
 184         }
 185
 186         if (!list_empty(&ldu->active))
 187                 return 0;
 188
 189         at = &ld->active;
 190         list_for_each_entry(entry, &ld->active, active) {
 191                 if (entry->base.unit > ldu->base.unit)
 192                         break;
 193
 194                 at = &entry->active;
 195         }
 196
 197         list_add(&ldu->active, at);
 198
 199         ld->num_active++;
 200
 201         return 0;
 202 }
 203
 204 static int vmw_ldu_crtc_set_config(struct drm_mode_set *set)
 205 {
 206         struct vmw_private *dev_priv;
 207         struct vmw_legacy_display_unit *ldu;
 208         struct drm_connector *connector;
 209         struct drm_display_mode *mode;
 210         struct drm_encoder *encoder;
 211         struct vmw_framebuffer *vfb;
 212         struct drm_framebuffer *fb;
 213         struct drm_crtc *crtc;
 214
 215         if (!set)
 216                 return -EINVAL;
 217
 218         if (!set->crtc)
 219                 return -EINVAL;
 220
 221         /* get the ldu */
 222         crtc = set->crtc;
 223         ldu = vmw_crtc_to_ldu(crtc);
 224         vfb = set->fb ? vmw_framebuffer_to_vfb(set->fb) : NULL;
 225         dev_priv = vmw_priv(crtc->dev);
 226
 227         if (set->num_connectors > 1) {
 228                 DRM_ERROR("to many connectors\n");
 229                 return -EINVAL;
 230         }
 231
 232         if (set->num_connectors == 1 &&
 233             set->connectors[0] != &ldu->base.connector) {
 234                 DRM_ERROR("connector doesn't match %p %p\n",
 235                         set->connectors[0], &ldu->base.connector);
 236                 return -EINVAL;
 237         }
 238
 239         /* ldu only supports one fb active at the time */
 240         if (dev_priv->ldu_priv->fb && vfb &&
 241             !(dev_priv->ldu_priv->num_active == 1 &&
 242               !list_empty(&ldu->active)) &&
 243             dev_priv->ldu_priv->fb != vfb) {
 244                 DRM_ERROR("Multiple framebuffers not supported\n");
 245                 return -EINVAL;
 246         }
 247
 248         /* since they always map one to one these are safe */
 249         connector = &ldu->base.connector;
 250         encoder = &ldu->base.encoder;
 251
 252         /* should we turn the crtc off? */
 253         if (set->num_connectors == 0 || !set->mode || !set->fb) {
 254
 255                 connector->encoder = NULL;
 256                 encoder->crtc = NULL;
 257                 crtc->fb = NULL;
 258
 259                 vmw_ldu_del_active(dev_priv, ldu);
 260
 261                 vmw_ldu_commit_list(dev_priv);
 262
 263                 return 0;
 264         }
 265
 266
 267         /* we now know we want to set a mode */
 268         mode = set->mode;
 269         fb = set->fb;
 270
 271         if (set->x + mode->hdisplay > fb->width ||
 272             set->y + mode->vdisplay > fb->height) {
 273                 DRM_ERROR("set outside of framebuffer\n");
 274                 return -EINVAL;
 275         }
 276
 277         vmw_fb_off(dev_priv);
 278
 279         crtc->fb = fb;
 280         encoder->crtc = crtc;
 281         connector->encoder = encoder;
 282         crtc->x = set->x;
 283         crtc->y = set->y;
 284         crtc->mode = *mode;
 285
 286         vmw_ldu_add_active(dev_priv, ldu, vfb);
 287
 288         vmw_ldu_commit_list(dev_priv);
 289
 290         return 0;
 291 }
 292
 293 static struct drm_crtc_funcs vmw_legacy_crtc_funcs = {
 294         .save = vmw_ldu_crtc_save,
 295         .restore = vmw_ldu_crtc_restore,
 296         .cursor_set = vmw_du_crtc_cursor_set,
 297         .cursor_move = vmw_du_crtc_cursor_move,
 298         .gamma_set = vmw_ldu_crtc_gamma_set,
 299         .destroy = vmw_ldu_crtc_destroy,
 300         .set_config = vmw_ldu_crtc_set_config,
 301 };
 302
 303 /*
 304  * Legacy Display Unit encoder functions
 305  */
 306
 307 static void vmw_ldu_encoder_destroy(struct drm_encoder *encoder)
 308 {
 309         vmw_ldu_destroy(vmw_encoder_to_ldu(encoder));
 310 }
 311
 312 static struct drm_encoder_funcs vmw_legacy_encoder_funcs = {
 313         .destroy = vmw_ldu_encoder_destroy,
 314 };
 315
 316 /*
 317  * Legacy Display Unit connector functions
 318  */
 319
 320 static void vmw_ldu_connector_dpms(struct drm_connector *connector, int mode)
 321 {
 322 }
 323
 324 static void vmw_ldu_connector_save(struct drm_connector *connector)
 325 {
 326 }
 327
 328 static void vmw_ldu_connector_restore(struct drm_connector *connector)
 329 {
 330 }
 331
 332 static enum drm_connector_status
 333         vmw_ldu_connector_detect(struct drm_connector *connector)
 334 {
 335         /* XXX vmwctrl should control connection status */
 336         if (vmw_connector_to_ldu(connector)->base.unit == 0)
 337                 return connector_status_connected;
 338         return connector_status_disconnected;
 339 }
 340
 341 static struct drm_display_mode vmw_ldu_connector_builtin[] = {
 342         /* 640x480@60Hz */
 343         { DRM_MODE("640x480", DRM_MODE_TYPE_DRIVER, 25175, 640, 656,
 344                    752, 800, 0, 480, 489, 492, 525, 0,
 345                    DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_NVSYNC) },
 346         /* 800x600@60Hz */
 347         { DRM_MODE("800x600",
 348                    DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED,
 349                    40000, 800, 840, 968, 1056, 0, 600, 601, 605, 628,
 350                    0, DRM_MODE_FLAG_PHSYNC | DRM_MODE_FLAG_PVSYNC) },
 351         /* 1024x768@60Hz */
 352         { DRM_MODE("1024x768", DRM_MODE_TYPE_DRIVER, 65000, 1024, 1048,
 353                    1184, 1344, 0, 768, 771, 777, 806, 0,
 354                    DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_NVSYNC) },
 355         /* 1152x864@75Hz */
 356         { DRM_MODE("1152x864", DRM_MODE_TYPE_DRIVER, 108000, 1152, 1216,
 357                    1344, 1600, 0, 864, 865, 868, 900, 0,
 358                    DRM_MODE_FLAG_PHSYNC | DRM_MODE_FLAG_PVSYNC) },
 359         /* 1280x768@60Hz */
 360         { DRM_MODE("1280x768", DRM_MODE_TYPE_DRIVER, 79500, 1280, 1344,
 361                    1472, 1664, 0, 768, 771, 778, 798, 0,
 362                    DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_PVSYNC) },
 363         /* 1280x800@60Hz */
 364         { DRM_MODE("1280x800", DRM_MODE_TYPE_DRIVER, 83500, 1280, 1352,
 365                    1480, 1680, 0, 800, 803, 809, 831, 0,
 366                    DRM_MODE_FLAG_PHSYNC | DRM_MODE_FLAG_NVSYNC) },
 367         /* 1280x960@60Hz */
 368         { DRM_MODE("1280x960", DRM_MODE_TYPE_DRIVER, 108000, 1280, 1376,
 369                    1488, 1800, 0, 960, 961, 964, 1000, 0,
 370                    DRM_MODE_FLAG_PHSYNC | DRM_MODE_FLAG_PVSYNC) },
 371         /* 1280x1024@60Hz */
 372         { DRM_MODE("1280x1024", DRM_MODE_TYPE_DRIVER, 108000, 1280, 1328,
 373                    1440, 1688, 0, 1024, 1025, 1028, 1066, 0,
 374                    DRM_MODE_FLAG_PHSYNC | DRM_MODE_FLAG_PVSYNC) },
 375         /* 1360x768@60Hz */
 376         { DRM_MODE("1360x768", DRM_MODE_TYPE_DRIVER, 85500, 1360, 1424,
 377                    1536, 1792, 0, 768, 771, 777, 795, 0,
 378                    DRM_MODE_FLAG_PHSYNC | DRM_MODE_FLAG_PVSYNC) },
 379         /* 1440x1050@60Hz */
 380         { DRM_MODE("1400x1050", DRM_MODE_TYPE_DRIVER, 121750, 1400, 1488,
 381                    1632, 1864, 0, 1050, 1053, 1057, 1089, 0,
 382                    DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_PVSYNC) },
 383         /* 1440x900@60Hz */
 384         { DRM_MODE("1440x900", DRM_MODE_TYPE_DRIVER, 106500, 1440, 1520,
 385                    1672, 1904, 0, 900, 903, 909, 934, 0,
 386                    DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_PVSYNC) },
 387         /* 1600x1200@60Hz */
 388         { DRM_MODE("1600x1200", DRM_MODE_TYPE_DRIVER, 162000, 1600, 1664,
 389                    1856, 2160, 0, 1200, 1201, 1204, 1250, 0,
 390                    DRM_MODE_FLAG_PHSYNC | DRM_MODE_FLAG_PVSYNC) },
 391         /* 1680x1050@60Hz */
 392         { DRM_MODE("1680x1050", DRM_MODE_TYPE_DRIVER, 146250, 1680, 1784,
 393                    1960, 2240, 0, 1050, 1053, 1059, 1089, 0,
 394                    DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_PVSYNC) },
 395         /* 1792x1344@60Hz */
 396         { DRM_MODE("1792x1344", DRM_MODE_TYPE_DRIVER, 204750, 1792, 1920,
 397                    2120, 2448, 0, 1344, 1345, 1348, 1394, 0,
 398                    DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_PVSYNC) },
 399         /* 1853x1392@60Hz */
 400         { DRM_MODE("1856x1392", DRM_MODE_TYPE_DRIVER, 218250, 1856, 1952,
 401                    2176, 2528, 0, 1392, 1393, 1396, 1439, 0,
 402                    DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_PVSYNC) },
 403         /* 1920x1200@60Hz */
 404         { DRM_MODE("1920x1200", DRM_MODE_TYPE_DRIVER, 193250, 1920, 2056,
 405                    2256, 2592, 0, 1200, 1203, 1209, 1245, 0,
 406                    DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_PVSYNC) },
 407         /* 1920x1440@60Hz */
 408         { DRM_MODE("1920x1440", DRM_MODE_TYPE_DRIVER, 234000, 1920, 2048,
 409                    2256, 2600, 0, 1440, 1441, 1444, 1500, 0,
 410                    DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_PVSYNC) },
 411         /* 2560x1600@60Hz */
 412         { DRM_MODE("2560x1600", DRM_MODE_TYPE_DRIVER, 348500, 2560, 2752,
 413                    3032, 3504, 0, 1600, 1603, 1609, 1658, 0,
 414                    DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_PVSYNC) },
 415         /* Terminate */
 416         { DRM_MODE("", 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) },
 417 };
 418
 419 static int vmw_ldu_connector_fill_modes(struct drm_connector *connector,
 420                                         uint32_t max_width, uint32_t max_height)
 421 {
 422         struct drm_device *dev = connector->dev;
 423         struct drm_display_mode *mode = NULL;
 424         int i;
 425
 426         for (i = 0; vmw_ldu_connector_builtin[i].type != 0; i++) {
 427                 if (vmw_ldu_connector_builtin[i].hdisplay > max_width ||
 428                     vmw_ldu_connector_builtin[i].vdisplay > max_height)
 429                         continue;
 430
 431                 mode = drm_mode_duplicate(dev, &vmw_ldu_connector_builtin[i]);
 432                 if (!mode)
 433                         return 0;
 434                 mode->vrefresh = drm_mode_vrefresh(mode);
 435
 436                 drm_mode_probed_add(connector, mode);
 437         }
 438
 439         drm_mode_connector_list_update(connector);
 440
 441         return 1;
 442 }
 443
 444 static int vmw_ldu_connector_set_property(struct drm_connector *connector,
 445                                           struct drm_property *property,
 446                                           uint64_t val)
 447 {
 448         return 0;
 449 }
 450
 451 static void vmw_ldu_connector_destroy(struct drm_connector *connector)
 452 {
 453         vmw_ldu_destroy(vmw_connector_to_ldu(connector));
 454 }
 455
 456 static struct drm_connector_funcs vmw_legacy_connector_funcs = {
 457         .dpms = vmw_ldu_connector_dpms,
 458         .save = vmw_ldu_connector_save,
 459         .restore = vmw_ldu_connector_restore,
 460         .detect = vmw_ldu_connector_detect,
 461         .fill_modes = vmw_ldu_connector_fill_modes,
 462         .set_property = vmw_ldu_connector_set_property,
 463         .destroy = vmw_ldu_connector_destroy,
 464 };
 465
 466 static int vmw_ldu_init(struct vmw_private *dev_priv, unsigned unit)
 467 {
 468         struct vmw_legacy_display_unit *ldu;
 469         struct drm_device *dev = dev_priv->dev;
 470         struct drm_connector *connector;
 471         struct drm_encoder *encoder;
 472         struct drm_crtc *crtc;
 473
 474         ldu = kzalloc(sizeof(*ldu), GFP_KERNEL);
 475         if (!ldu)
 476                 return -ENOMEM;
 477
 478         ldu->base.unit = unit;
 479         crtc = &ldu->base.crtc;
 480         encoder = &ldu->base.encoder;
 481         connector = &ldu->base.connector;
 482
 483         INIT_LIST_HEAD(&ldu->active);
 484
 485         drm_connector_init(dev, connector, &vmw_legacy_connector_funcs,
 486                            DRM_MODE_CONNECTOR_LVDS);
 487         connector->status = vmw_ldu_connector_detect(connector);
 488
 489         drm_encoder_init(dev, encoder, &vmw_legacy_encoder_funcs,
 490                          DRM_MODE_ENCODER_LVDS);
 491         drm_mode_connector_attach_encoder(connector, encoder);
 492         encoder->possible_crtcs = (1 << unit);
 493         encoder->possible_clones = 0;
 494
 495         drm_crtc_init(dev, crtc, &vmw_legacy_crtc_funcs);
 496
 497         drm_connector_attach_property(connector,
 498                                       dev->mode_config.dirty_info_property,
 499                                       1);
 500
 501         return 0;
 502 }
 503
 504 int vmw_kms_init_legacy_display_system(struct vmw_private *dev_priv)
 505 {
 506         if (dev_priv->ldu_priv) {
 507                 DRM_INFO("ldu system already on\n");
 508                 return -EINVAL;
 509         }
 510
 511         dev_priv->ldu_priv = kmalloc(GFP_KERNEL, sizeof(*dev_priv->ldu_priv));
 512
 513         if (!dev_priv->ldu_priv)
 514                 return -ENOMEM;
 515
 516         INIT_LIST_HEAD(&dev_priv->ldu_priv->active);
 517         dev_priv->ldu_priv->num_active = 0;
 518         dev_priv->ldu_priv->last_num_active = 0;
 519         dev_priv->ldu_priv->fb = NULL;
 520
 521         drm_mode_create_dirty_info_property(dev_priv->dev);
 522
 523         vmw_ldu_init(dev_priv, 0);
 524         /* for old hardware without multimon only enable one display */
 525         if (dev_priv->capabilities & SVGA_CAP_MULTIMON) {
 526                 vmw_ldu_init(dev_priv, 1);
 527                 vmw_ldu_init(dev_priv, 2);
 528                 vmw_ldu_init(dev_priv, 3);
 529                 vmw_ldu_init(dev_priv, 4);
 530                 vmw_ldu_init(dev_priv, 5);
 531                 vmw_ldu_init(dev_priv, 6);
 532                 vmw_ldu_init(dev_priv, 7);
 533         }
 534
 535         return 0;
 536 }
 537
 538 int vmw_kms_close_legacy_display_system(struct vmw_private *dev_priv)
 539 {
 540         if (!dev_priv->ldu_priv)
 541                 return -ENOSYS;
 542
 543         BUG_ON(!list_empty(&dev_priv->ldu_priv->active));
 544
 545         kfree(dev_priv->ldu_priv);
 546
 547         return 0;
 548 }