root/net/switchdev/switchdev.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. switchdev_deferred_dequeue
  2. switchdev_deferred_process
  3. switchdev_deferred_process_work
  4. switchdev_deferred_enqueue
  5. switchdev_port_attr_notify
  6. switchdev_port_attr_set_now
  7. switchdev_port_attr_set_deferred
  8. switchdev_port_attr_set_defer
  9. switchdev_port_attr_set
  10. switchdev_obj_size
  11. switchdev_port_obj_notify
  12. switchdev_port_obj_add_now
  13. switchdev_port_obj_add_deferred
  14. switchdev_port_obj_add_defer
  15. switchdev_port_obj_add
  16. switchdev_port_obj_del_now
  17. switchdev_port_obj_del_deferred
  18. switchdev_port_obj_del_defer
  19. switchdev_port_obj_del
  20. register_switchdev_notifier
  21. unregister_switchdev_notifier
  22. call_switchdev_notifiers
  23. register_switchdev_blocking_notifier
  24. unregister_switchdev_blocking_notifier
  25. call_switchdev_blocking_notifiers
  26. __switchdev_handle_port_obj_add
  27. switchdev_handle_port_obj_add
  28. __switchdev_handle_port_obj_del
  29. switchdev_handle_port_obj_del
  30. __switchdev_handle_port_attr_set
  31. switchdev_handle_port_attr_set

   1 // SPDX-License-Identifier: GPL-2.0-or-later
   2 /*
   3  * net/switchdev/switchdev.c - Switch device API
   4  * Copyright (c) 2014-2015 Jiri Pirko <jiri@resnulli.us>
   5  * Copyright (c) 2014-2015 Scott Feldman <sfeldma@gmail.com>
   6  */
   7 
   8 #include <linux/kernel.h>
   9 #include <linux/types.h>
  10 #include <linux/init.h>
  11 #include <linux/mutex.h>
  12 #include <linux/notifier.h>
  13 #include <linux/netdevice.h>
  14 #include <linux/etherdevice.h>
  15 #include <linux/if_bridge.h>
  16 #include <linux/list.h>
  17 #include <linux/workqueue.h>
  18 #include <linux/if_vlan.h>
  19 #include <linux/rtnetlink.h>
  20 #include <net/switchdev.h>
  21 
  22 static LIST_HEAD(deferred);
  23 static DEFINE_SPINLOCK(deferred_lock);
  24 
  25 typedef void switchdev_deferred_func_t(struct net_device *dev,
  26                                        const void *data);
  27 
  28 struct switchdev_deferred_item {
  29         struct list_head list;
  30         struct net_device *dev;
  31         switchdev_deferred_func_t *func;
  32         unsigned long data[0];
  33 };
  34 
  35 static struct switchdev_deferred_item *switchdev_deferred_dequeue(void)
  36 {
  37         struct switchdev_deferred_item *dfitem;
  38 
  39         spin_lock_bh(&deferred_lock);
  40         if (list_empty(&deferred)) {
  41                 dfitem = NULL;
  42                 goto unlock;
  43         }
  44         dfitem = list_first_entry(&deferred,
  45                                   struct switchdev_deferred_item, list);
  46         list_del(&dfitem->list);
  47 unlock:
  48         spin_unlock_bh(&deferred_lock);
  49         return dfitem;
  50 }
  51 
  52 /**
  53  *      switchdev_deferred_process - Process ops in deferred queue
  54  *
  55  *      Called to flush the ops currently queued in deferred ops queue.
  56  *      rtnl_lock must be held.
  57  */
  58 void switchdev_deferred_process(void)
  59 {
  60         struct switchdev_deferred_item *dfitem;
  61 
  62         ASSERT_RTNL();
  63 
  64         while ((dfitem = switchdev_deferred_dequeue())) {
  65                 dfitem->func(dfitem->dev, dfitem->data);
  66                 dev_put(dfitem->dev);
  67                 kfree(dfitem);
  68         }
  69 }
  70 EXPORT_SYMBOL_GPL(switchdev_deferred_process);
  71 
  72 static void switchdev_deferred_process_work(struct work_struct *work)
  73 {
  74         rtnl_lock();
  75         switchdev_deferred_process();
  76         rtnl_unlock();
  77 }
  78 
  79 static DECLARE_WORK(deferred_process_work, switchdev_deferred_process_work);
  80 
  81 static int switchdev_deferred_enqueue(struct net_device *dev,
  82                                       const void *data, size_t data_len,
  83                                       switchdev_deferred_func_t *func)
  84 {
  85         struct switchdev_deferred_item *dfitem;
  86 
  87         dfitem = kmalloc(sizeof(*dfitem) + data_len, GFP_ATOMIC);
  88         if (!dfitem)
  89                 return -ENOMEM;
  90         dfitem->dev = dev;
  91         dfitem->func = func;
  92         memcpy(dfitem->data, data, data_len);
  93         dev_hold(dev);
  94         spin_lock_bh(&deferred_lock);
  95         list_add_tail(&dfitem->list, &deferred);
  96         spin_unlock_bh(&deferred_lock);
  97         schedule_work(&deferred_process_work);
  98         return 0;
  99 }
 100 
 101 static int switchdev_port_attr_notify(enum switchdev_notifier_type nt,
 102                                       struct net_device *dev,
 103                                       const struct switchdev_attr *attr,
 104                                       struct switchdev_trans *trans)
 105 {
 106         int err;
 107         int rc;
 108 
 109         struct switchdev_notifier_port_attr_info attr_info = {
 110                 .attr = attr,
 111                 .trans = trans,
 112                 .handled = false,
 113         };
 114 
 115         rc = call_switchdev_blocking_notifiers(nt, dev,
 116                                                &attr_info.info, NULL);
 117         err = notifier_to_errno(rc);
 118         if (err) {
 119                 WARN_ON(!attr_info.handled);
 120                 return err;
 121         }
 122 
 123         if (!attr_info.handled)
 124                 return -EOPNOTSUPP;
 125 
 126         return 0;
 127 }
 128 
 129 static int switchdev_port_attr_set_now(struct net_device *dev,
 130                                        const struct switchdev_attr *attr)
 131 {
 132         struct switchdev_trans trans;
 133         int err;
 134 
 135         /* Phase I: prepare for attr set. Driver/device should fail
 136          * here if there are going to be issues in the commit phase,
 137          * such as lack of resources or support.  The driver/device
 138          * should reserve resources needed for the commit phase here,
 139          * but should not commit the attr.
 140          */
 141 
 142         trans.ph_prepare = true;
 143         err = switchdev_port_attr_notify(SWITCHDEV_PORT_ATTR_SET, dev, attr,
 144                                          &trans);
 145         if (err)
 146                 return err;
 147 
 148         /* Phase II: commit attr set.  This cannot fail as a fault
 149          * of driver/device.  If it does, it's a bug in the driver/device
 150          * because the driver said everythings was OK in phase I.
 151          */
 152 
 153         trans.ph_prepare = false;
 154         err = switchdev_port_attr_notify(SWITCHDEV_PORT_ATTR_SET, dev, attr,
 155                                          &trans);
 156         WARN(err, "%s: Commit of attribute (id=%d) failed.\n",
 157              dev->name, attr->id);
 158 
 159         return err;
 160 }
 161 
 162 static void switchdev_port_attr_set_deferred(struct net_device *dev,
 163                                              const void *data)
 164 {
 165         const struct switchdev_attr *attr = data;
 166         int err;
 167 
 168         err = switchdev_port_attr_set_now(dev, attr);
 169         if (err && err != -EOPNOTSUPP)
 170                 netdev_err(dev, "failed (err=%d) to set attribute (id=%d)\n",
 171                            err, attr->id);
 172         if (attr->complete)
 173                 attr->complete(dev, err, attr->complete_priv);
 174 }
 175 
 176 static int switchdev_port_attr_set_defer(struct net_device *dev,
 177                                          const struct switchdev_attr *attr)
 178 {
 179         return switchdev_deferred_enqueue(dev, attr, sizeof(*attr),
 180                                           switchdev_port_attr_set_deferred);
 181 }
 182 
 183 /**
 184  *      switchdev_port_attr_set - Set port attribute
 185  *
 186  *      @dev: port device
 187  *      @attr: attribute to set
 188  *
 189  *      Use a 2-phase prepare-commit transaction model to ensure
 190  *      system is not left in a partially updated state due to
 191  *      failure from driver/device.
 192  *
 193  *      rtnl_lock must be held and must not be in atomic section,
 194  *      in case SWITCHDEV_F_DEFER flag is not set.
 195  */
 196 int switchdev_port_attr_set(struct net_device *dev,
 197                             const struct switchdev_attr *attr)
 198 {
 199         if (attr->flags & SWITCHDEV_F_DEFER)
 200                 return switchdev_port_attr_set_defer(dev, attr);
 201         ASSERT_RTNL();
 202         return switchdev_port_attr_set_now(dev, attr);
 203 }
 204 EXPORT_SYMBOL_GPL(switchdev_port_attr_set);
 205 
 206 static size_t switchdev_obj_size(const struct switchdev_obj *obj)
 207 {
 208         switch (obj->id) {
 209         case SWITCHDEV_OBJ_ID_PORT_VLAN:
 210                 return sizeof(struct switchdev_obj_port_vlan);
 211         case SWITCHDEV_OBJ_ID_PORT_MDB:
 212                 return sizeof(struct switchdev_obj_port_mdb);
 213         case SWITCHDEV_OBJ_ID_HOST_MDB:
 214                 return sizeof(struct switchdev_obj_port_mdb);
 215         default:
 216                 BUG();
 217         }
 218         return 0;
 219 }
 220 
 221 static int switchdev_port_obj_notify(enum switchdev_notifier_type nt,
 222                                      struct net_device *dev,
 223                                      const struct switchdev_obj *obj,
 224                                      struct switchdev_trans *trans,
 225                                      struct netlink_ext_ack *extack)
 226 {
 227         int rc;
 228         int err;
 229 
 230         struct switchdev_notifier_port_obj_info obj_info = {
 231                 .obj = obj,
 232                 .trans = trans,
 233                 .handled = false,
 234         };
 235 
 236         rc = call_switchdev_blocking_notifiers(nt, dev, &obj_info.info, extack);
 237         err = notifier_to_errno(rc);
 238         if (err) {
 239                 WARN_ON(!obj_info.handled);
 240                 return err;
 241         }
 242         if (!obj_info.handled)
 243                 return -EOPNOTSUPP;
 244         return 0;
 245 }
 246 
 247 static int switchdev_port_obj_add_now(struct net_device *dev,
 248                                       const struct switchdev_obj *obj,
 249                                       struct netlink_ext_ack *extack)
 250 {
 251         struct switchdev_trans trans;
 252         int err;
 253 
 254         ASSERT_RTNL();
 255 
 256         /* Phase I: prepare for obj add. Driver/device should fail
 257          * here if there are going to be issues in the commit phase,
 258          * such as lack of resources or support.  The driver/device
 259          * should reserve resources needed for the commit phase here,
 260          * but should not commit the obj.
 261          */
 262 
 263         trans.ph_prepare = true;
 264         err = switchdev_port_obj_notify(SWITCHDEV_PORT_OBJ_ADD,
 265                                         dev, obj, &trans, extack);
 266         if (err)
 267                 return err;
 268 
 269         /* Phase II: commit obj add.  This cannot fail as a fault
 270          * of driver/device.  If it does, it's a bug in the driver/device
 271          * because the driver said everythings was OK in phase I.
 272          */
 273 
 274         trans.ph_prepare = false;
 275         err = switchdev_port_obj_notify(SWITCHDEV_PORT_OBJ_ADD,
 276                                         dev, obj, &trans, extack);
 277         WARN(err, "%s: Commit of object (id=%d) failed.\n", dev->name, obj->id);
 278 
 279         return err;
 280 }
 281 
 282 static void switchdev_port_obj_add_deferred(struct net_device *dev,
 283                                             const void *data)
 284 {
 285         const struct switchdev_obj *obj = data;
 286         int err;
 287 
 288         err = switchdev_port_obj_add_now(dev, obj, NULL);
 289         if (err && err != -EOPNOTSUPP)
 290                 netdev_err(dev, "failed (err=%d) to add object (id=%d)\n",
 291                            err, obj->id);
 292         if (obj->complete)
 293                 obj->complete(dev, err, obj->complete_priv);
 294 }
 295 
 296 static int switchdev_port_obj_add_defer(struct net_device *dev,
 297                                         const struct switchdev_obj *obj)
 298 {
 299         return switchdev_deferred_enqueue(dev, obj, switchdev_obj_size(obj),
 300                                           switchdev_port_obj_add_deferred);
 301 }
 302 
 303 /**
 304  *      switchdev_port_obj_add - Add port object
 305  *
 306  *      @dev: port device
 307  *      @id: object ID
 308  *      @obj: object to add
 309  *
 310  *      Use a 2-phase prepare-commit transaction model to ensure
 311  *      system is not left in a partially updated state due to
 312  *      failure from driver/device.
 313  *
 314  *      rtnl_lock must be held and must not be in atomic section,
 315  *      in case SWITCHDEV_F_DEFER flag is not set.
 316  */
 317 int switchdev_port_obj_add(struct net_device *dev,
 318                            const struct switchdev_obj *obj,
 319                            struct netlink_ext_ack *extack)
 320 {
 321         if (obj->flags & SWITCHDEV_F_DEFER)
 322                 return switchdev_port_obj_add_defer(dev, obj);
 323         ASSERT_RTNL();
 324         return switchdev_port_obj_add_now(dev, obj, extack);
 325 }
 326 EXPORT_SYMBOL_GPL(switchdev_port_obj_add);
 327 
 328 static int switchdev_port_obj_del_now(struct net_device *dev,
 329                                       const struct switchdev_obj *obj)
 330 {
 331         return switchdev_port_obj_notify(SWITCHDEV_PORT_OBJ_DEL,
 332                                          dev, obj, NULL, NULL);
 333 }
 334 
 335 static void switchdev_port_obj_del_deferred(struct net_device *dev,
 336                                             const void *data)
 337 {
 338         const struct switchdev_obj *obj = data;
 339         int err;
 340 
 341         err = switchdev_port_obj_del_now(dev, obj);
 342         if (err && err != -EOPNOTSUPP)
 343                 netdev_err(dev, "failed (err=%d) to del object (id=%d)\n",
 344                            err, obj->id);
 345         if (obj->complete)
 346                 obj->complete(dev, err, obj->complete_priv);
 347 }
 348 
 349 static int switchdev_port_obj_del_defer(struct net_device *dev,
 350                                         const struct switchdev_obj *obj)
 351 {
 352         return switchdev_deferred_enqueue(dev, obj, switchdev_obj_size(obj),
 353                                           switchdev_port_obj_del_deferred);
 354 }
 355 
 356 /**
 357  *      switchdev_port_obj_del - Delete port object
 358  *
 359  *      @dev: port device
 360  *      @id: object ID
 361  *      @obj: object to delete
 362  *
 363  *      rtnl_lock must be held and must not be in atomic section,
 364  *      in case SWITCHDEV_F_DEFER flag is not set.
 365  */
 366 int switchdev_port_obj_del(struct net_device *dev,
 367                            const struct switchdev_obj *obj)
 368 {
 369         if (obj->flags & SWITCHDEV_F_DEFER)
 370                 return switchdev_port_obj_del_defer(dev, obj);
 371         ASSERT_RTNL();
 372         return switchdev_port_obj_del_now(dev, obj);
 373 }
 374 EXPORT_SYMBOL_GPL(switchdev_port_obj_del);
 375 
 376 static ATOMIC_NOTIFIER_HEAD(switchdev_notif_chain);
 377 static BLOCKING_NOTIFIER_HEAD(switchdev_blocking_notif_chain);
 378 
 379 /**
 380  *      register_switchdev_notifier - Register notifier
 381  *      @nb: notifier_block
 382  *
 383  *      Register switch device notifier.
 384  */
 385 int register_switchdev_notifier(struct notifier_block *nb)
 386 {
 387         return atomic_notifier_chain_register(&switchdev_notif_chain, nb);
 388 }
 389 EXPORT_SYMBOL_GPL(register_switchdev_notifier);
 390 
 391 /**
 392  *      unregister_switchdev_notifier - Unregister notifier
 393  *      @nb: notifier_block
 394  *
 395  *      Unregister switch device notifier.
 396  */
 397 int unregister_switchdev_notifier(struct notifier_block *nb)
 398 {
 399         return atomic_notifier_chain_unregister(&switchdev_notif_chain, nb);
 400 }
 401 EXPORT_SYMBOL_GPL(unregister_switchdev_notifier);
 402 
 403 /**
 404  *      call_switchdev_notifiers - Call notifiers
 405  *      @val: value passed unmodified to notifier function
 406  *      @dev: port device
 407  *      @info: notifier information data
 408  *
 409  *      Call all network notifier blocks.
 410  */
 411 int call_switchdev_notifiers(unsigned long val, struct net_device *dev,
 412                              struct switchdev_notifier_info *info,
 413                              struct netlink_ext_ack *extack)
 414 {
 415         info->dev = dev;
 416         info->extack = extack;
 417         return atomic_notifier_call_chain(&switchdev_notif_chain, val, info);
 418 }
 419 EXPORT_SYMBOL_GPL(call_switchdev_notifiers);
 420 
 421 int register_switchdev_blocking_notifier(struct notifier_block *nb)
 422 {
 423         struct blocking_notifier_head *chain = &switchdev_blocking_notif_chain;
 424 
 425         return blocking_notifier_chain_register(chain, nb);
 426 }
 427 EXPORT_SYMBOL_GPL(register_switchdev_blocking_notifier);
 428 
 429 int unregister_switchdev_blocking_notifier(struct notifier_block *nb)
 430 {
 431         struct blocking_notifier_head *chain = &switchdev_blocking_notif_chain;
 432 
 433         return blocking_notifier_chain_unregister(chain, nb);
 434 }
 435 EXPORT_SYMBOL_GPL(unregister_switchdev_blocking_notifier);
 436 
 437 int call_switchdev_blocking_notifiers(unsigned long val, struct net_device *dev,
 438                                       struct switchdev_notifier_info *info,
 439                                       struct netlink_ext_ack *extack)
 440 {
 441         info->dev = dev;
 442         info->extack = extack;
 443         return blocking_notifier_call_chain(&switchdev_blocking_notif_chain,
 444                                             val, info);
 445 }
 446 EXPORT_SYMBOL_GPL(call_switchdev_blocking_notifiers);
 447 
 448 static int __switchdev_handle_port_obj_add(struct net_device *dev,
 449                         struct switchdev_notifier_port_obj_info *port_obj_info,
 450                         bool (*check_cb)(const struct net_device *dev),
 451                         int (*add_cb)(struct net_device *dev,
 452                                       const struct switchdev_obj *obj,
 453                                       struct switchdev_trans *trans,
 454                                       struct netlink_ext_ack *extack))
 455 {
 456         struct netlink_ext_ack *extack;
 457         struct net_device *lower_dev;
 458         struct list_head *iter;
 459         int err = -EOPNOTSUPP;
 460 
 461         extack = switchdev_notifier_info_to_extack(&port_obj_info->info);
 462 
 463         if (check_cb(dev)) {
 464                 /* This flag is only checked if the return value is success. */
 465                 port_obj_info->handled = true;
 466                 return add_cb(dev, port_obj_info->obj, port_obj_info->trans,
 467                               extack);
 468         }
 469 
 470         /* Switch ports might be stacked under e.g. a LAG. Ignore the
 471          * unsupported devices, another driver might be able to handle them. But
 472          * propagate to the callers any hard errors.
 473          *
 474          * If the driver does its own bookkeeping of stacked ports, it's not
 475          * necessary to go through this helper.
 476          */
 477         netdev_for_each_lower_dev(dev, lower_dev, iter) {
 478                 err = __switchdev_handle_port_obj_add(lower_dev, port_obj_info,
 479                                                       check_cb, add_cb);
 480                 if (err && err != -EOPNOTSUPP)
 481                         return err;
 482         }
 483 
 484         return err;
 485 }
 486 
 487 int switchdev_handle_port_obj_add(struct net_device *dev,
 488                         struct switchdev_notifier_port_obj_info *port_obj_info,
 489                         bool (*check_cb)(const struct net_device *dev),
 490                         int (*add_cb)(struct net_device *dev,
 491                                       const struct switchdev_obj *obj,
 492                                       struct switchdev_trans *trans,
 493                                       struct netlink_ext_ack *extack))
 494 {
 495         int err;
 496 
 497         err = __switchdev_handle_port_obj_add(dev, port_obj_info, check_cb,
 498                                               add_cb);
 499         if (err == -EOPNOTSUPP)
 500                 err = 0;
 501         return err;
 502 }
 503 EXPORT_SYMBOL_GPL(switchdev_handle_port_obj_add);
 504 
 505 static int __switchdev_handle_port_obj_del(struct net_device *dev,
 506                         struct switchdev_notifier_port_obj_info *port_obj_info,
 507                         bool (*check_cb)(const struct net_device *dev),
 508                         int (*del_cb)(struct net_device *dev,
 509                                       const struct switchdev_obj *obj))
 510 {
 511         struct net_device *lower_dev;
 512         struct list_head *iter;
 513         int err = -EOPNOTSUPP;
 514 
 515         if (check_cb(dev)) {
 516                 /* This flag is only checked if the return value is success. */
 517                 port_obj_info->handled = true;
 518                 return del_cb(dev, port_obj_info->obj);
 519         }
 520 
 521         /* Switch ports might be stacked under e.g. a LAG. Ignore the
 522          * unsupported devices, another driver might be able to handle them. But
 523          * propagate to the callers any hard errors.
 524          *
 525          * If the driver does its own bookkeeping of stacked ports, it's not
 526          * necessary to go through this helper.
 527          */
 528         netdev_for_each_lower_dev(dev, lower_dev, iter) {
 529                 err = __switchdev_handle_port_obj_del(lower_dev, port_obj_info,
 530                                                       check_cb, del_cb);
 531                 if (err && err != -EOPNOTSUPP)
 532                         return err;
 533         }
 534 
 535         return err;
 536 }
 537 
 538 int switchdev_handle_port_obj_del(struct net_device *dev,
 539                         struct switchdev_notifier_port_obj_info *port_obj_info,
 540                         bool (*check_cb)(const struct net_device *dev),
 541                         int (*del_cb)(struct net_device *dev,
 542                                       const struct switchdev_obj *obj))
 543 {
 544         int err;
 545 
 546         err = __switchdev_handle_port_obj_del(dev, port_obj_info, check_cb,
 547                                               del_cb);
 548         if (err == -EOPNOTSUPP)
 549                 err = 0;
 550         return err;
 551 }
 552 EXPORT_SYMBOL_GPL(switchdev_handle_port_obj_del);
 553 
 554 static int __switchdev_handle_port_attr_set(struct net_device *dev,
 555                         struct switchdev_notifier_port_attr_info *port_attr_info,
 556                         bool (*check_cb)(const struct net_device *dev),
 557                         int (*set_cb)(struct net_device *dev,
 558                                       const struct switchdev_attr *attr,
 559                                       struct switchdev_trans *trans))
 560 {
 561         struct net_device *lower_dev;
 562         struct list_head *iter;
 563         int err = -EOPNOTSUPP;
 564 
 565         if (check_cb(dev)) {
 566                 port_attr_info->handled = true;
 567                 return set_cb(dev, port_attr_info->attr,
 568                               port_attr_info->trans);
 569         }
 570 
 571         /* Switch ports might be stacked under e.g. a LAG. Ignore the
 572          * unsupported devices, another driver might be able to handle them. But
 573          * propagate to the callers any hard errors.
 574          *
 575          * If the driver does its own bookkeeping of stacked ports, it's not
 576          * necessary to go through this helper.
 577          */
 578         netdev_for_each_lower_dev(dev, lower_dev, iter) {
 579                 err = __switchdev_handle_port_attr_set(lower_dev, port_attr_info,
 580                                                        check_cb, set_cb);
 581                 if (err && err != -EOPNOTSUPP)
 582                         return err;
 583         }
 584 
 585         return err;
 586 }
 587 
 588 int switchdev_handle_port_attr_set(struct net_device *dev,
 589                         struct switchdev_notifier_port_attr_info *port_attr_info,
 590                         bool (*check_cb)(const struct net_device *dev),
 591                         int (*set_cb)(struct net_device *dev,
 592                                       const struct switchdev_attr *attr,
 593                                       struct switchdev_trans *trans))
 594 {
 595         int err;
 596 
 597         err = __switchdev_handle_port_attr_set(dev, port_attr_info, check_cb,
 598                                                set_cb);
 599         if (err == -EOPNOTSUPP)
 600                 err = 0;
 601         return err;
 602 }
 603 EXPORT_SYMBOL_GPL(switchdev_handle_port_attr_set);

/* [<][>][^][v][top][bottom][index][help] */