src/provider.c

   1 /*
   2  *
   3  *  Connection Manager
   4  *
   5  *  Copyright (C) 2007-2012  Intel Corporation. All rights reserved.
   6  *
   7  *  This program is free software; you can redistribute it and/or modify
   8  *  it under the terms of the GNU General Public License version 2 as
   9  *  published by the Free Software Foundation.
  10  *
  11  *  This program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *  GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this program; if not, write to the Free Software
  18  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  19  *
  20  */
  21
  22 #ifdef HAVE_CONFIG_H
  23 #include <config.h>
  24 #endif
  25
  26 #include <errno.h>
  27 #include <stdio.h>
  28 #include <string.h>
  29 #include <stdlib.h>
  30 #include <gdbus.h>
  31 #include <gweb/gresolv.h>
  32
  33 #include "connman.h"
  34
  35 static DBusConnection *connection = NULL;
  36
  37 static GHashTable *provider_hash = NULL;
  38
  39 static GSList *driver_list = NULL;
  40
  41 struct connman_provider {
  42         int refcount;
  43         struct connman_service *vpn_service;
  44         int index;
  45         char *identifier;
  46         int family;
  47         struct connman_provider_driver *driver;
  48         void *driver_data;
  49 };
  50
  51 void __connman_provider_append_properties(struct connman_provider *provider,
  52                                                         DBusMessageIter *iter)
  53 {
  54         const char *host, *domain, *type;
  55
  56         if (provider->driver == NULL || provider->driver->get_property == NULL)
  57                 return;
  58
  59         host = provider->driver->get_property(provider, "Host");
  60         domain = provider->driver->get_property(provider, "Domain");
  61         type = provider->driver->get_property(provider, "Type");
  62
  63         if (host != NULL)
  64                 connman_dbus_dict_append_basic(iter, "Host",
  65                                         DBUS_TYPE_STRING, &host);
  66
  67         if (domain != NULL)
  68                 connman_dbus_dict_append_basic(iter, "Domain",
  69                                         DBUS_TYPE_STRING, &domain);
  70
  71         if (type != NULL)
  72                 connman_dbus_dict_append_basic(iter, "Type", DBUS_TYPE_STRING,
  73                                                  &type);
  74 }
  75
  76 struct connman_provider *
  77 connman_provider_ref_debug(struct connman_provider *provider,
  78                         const char *file, int line, const char *caller)
  79 {
  80         DBG("%p ref %d by %s:%d:%s()", provider, provider->refcount + 1,
  81                 file, line, caller);
  82
  83         __sync_fetch_and_add(&provider->refcount, 1);
  84
  85         return provider;
  86 }
  87
  88 static void provider_remove(struct connman_provider *provider)
  89 {
  90         if (provider->driver != NULL) {
  91                 provider->driver->remove(provider);
  92                 provider->driver = NULL;
  93         }
  94 }
  95
  96 static void provider_destruct(struct connman_provider *provider)
  97 {
  98         DBG("provider %p", provider);
  99
 100         g_free(provider->identifier);
 101         g_free(provider);
 102 }
 103
 104 void connman_provider_unref_debug(struct connman_provider *provider,
 105                                 const char *file, int line, const char *caller)
 106 {
 107         DBG("%p ref %d by %s:%d:%s()", provider, provider->refcount - 1,
 108                 file, line, caller);
 109
 110         if (__sync_fetch_and_sub(&provider->refcount, 1) != 1)
 111                 return;
 112
 113         provider_remove(provider);
 114
 115         provider_destruct(provider);
 116 }
 117
 118 static int provider_indicate_state(struct connman_provider *provider,
 119                                         enum connman_service_state state)
 120 {
 121         DBG("state %d", state);
 122
 123         __connman_service_ipconfig_indicate_state(provider->vpn_service, state,
 124                                         CONNMAN_IPCONFIG_TYPE_IPV4);
 125
 126         return __connman_service_ipconfig_indicate_state(provider->vpn_service,
 127                                         state, CONNMAN_IPCONFIG_TYPE_IPV6);
 128 }
 129
 130 int connman_provider_disconnect(struct connman_provider *provider)
 131 {
 132         int err;
 133
 134         DBG("provider %p", provider);
 135
 136         if (provider->driver != NULL && provider->driver->disconnect != NULL)
 137                 err = provider->driver->disconnect(provider);
 138         else
 139                 return -EOPNOTSUPP;
 140
 141         if (provider->vpn_service != NULL)
 142                 provider_indicate_state(provider,
 143                                         CONNMAN_SERVICE_STATE_DISCONNECT);
 144
 145         if (err < 0) {
 146                 if (err != -EINPROGRESS)
 147                         return err;
 148
 149                 return -EINPROGRESS;
 150         }
 151
 152         return 0;
 153 }
 154
 155 int __connman_provider_connect(struct connman_provider *provider)
 156 {
 157         int err;
 158
 159         DBG("provider %p", provider);
 160
 161         if (provider->driver != NULL && provider->driver->connect != NULL) {
 162                 err = provider->driver->connect(provider);
 163         } else
 164                 return -EOPNOTSUPP;
 165
 166         if (err < 0) {
 167                 if (err != -EINPROGRESS)
 168                         return err;
 169
 170                 provider_indicate_state(provider,
 171                                         CONNMAN_SERVICE_STATE_ASSOCIATION);
 172
 173                 return -EINPROGRESS;
 174         }
 175
 176         return 0;
 177 }
 178
 179 int __connman_provider_remove(const char *path)
 180 {
 181         struct connman_provider *provider;
 182         GHashTableIter iter;
 183         gpointer value, key;
 184
 185         DBG("path %s", path);
 186
 187         g_hash_table_iter_init(&iter, provider_hash);
 188         while (g_hash_table_iter_next(&iter, &key, &value) == TRUE) {
 189                 const char *srv_path;
 190                 provider = value;
 191
 192                 if (provider->vpn_service == NULL)
 193                         continue;
 194
 195                 srv_path = __connman_service_get_path(provider->vpn_service);
 196
 197                 if (g_strcmp0(srv_path, path) == 0) {
 198                         DBG("Removing VPN %s", provider->identifier);
 199
 200                         if (provider->driver != NULL &&
 201                                                 provider->driver->remove)
 202                                 provider->driver->remove(provider);
 203
 204                         g_hash_table_remove(provider_hash,
 205                                                 provider->identifier);
 206                         return 0;
 207                 }
 208         }
 209
 210         return -ENXIO;
 211 }
 212
 213 static int set_connected(struct connman_provider *provider,
 214                                         connman_bool_t connected)
 215 {
 216         struct connman_service *service = provider->vpn_service;
 217         struct connman_ipconfig *ipconfig;
 218
 219         if (service == NULL)
 220                 return -ENODEV;
 221
 222         ipconfig = __connman_service_get_ipconfig(service, provider->family);
 223
 224         if (connected == TRUE) {
 225                 if (ipconfig == NULL) {
 226                         provider_indicate_state(provider,
 227                                                 CONNMAN_SERVICE_STATE_FAILURE);
 228                         return -EIO;
 229                 }
 230
 231                 __connman_ipconfig_address_add(ipconfig);
 232                 __connman_ipconfig_gateway_add(ipconfig);
 233
 234                 provider_indicate_state(provider,
 235                                         CONNMAN_SERVICE_STATE_READY);
 236
 237                 if (provider->driver != NULL && provider->driver->set_routes)
 238                         provider->driver->set_routes(provider,
 239                                                 CONNMAN_PROVIDER_ROUTE_ALL);
 240
 241         } else {
 242                 if (ipconfig != NULL) {
 243                         provider_indicate_state(provider,
 244                                         CONNMAN_SERVICE_STATE_DISCONNECT);
 245                         __connman_ipconfig_gateway_remove(ipconfig);
 246                 }
 247
 248                 provider_indicate_state(provider,
 249                                         CONNMAN_SERVICE_STATE_IDLE);
 250         }
 251
 252         return 0;
 253 }
 254
 255 int connman_provider_set_state(struct connman_provider *provider,
 256                                         enum connman_provider_state state)
 257 {
 258         if (provider == NULL || provider->vpn_service == NULL)
 259                 return -EINVAL;
 260
 261         switch (state) {
 262         case CONNMAN_PROVIDER_STATE_UNKNOWN:
 263                 return -EINVAL;
 264         case CONNMAN_PROVIDER_STATE_IDLE:
 265                 return set_connected(provider, FALSE);
 266         case CONNMAN_PROVIDER_STATE_CONNECT:
 267                 return provider_indicate_state(provider,
 268                                         CONNMAN_SERVICE_STATE_ASSOCIATION);
 269         case CONNMAN_PROVIDER_STATE_READY:
 270                 return set_connected(provider, TRUE);
 271         case CONNMAN_PROVIDER_STATE_DISCONNECT:
 272                 return provider_indicate_state(provider,
 273                                         CONNMAN_SERVICE_STATE_DISCONNECT);
 274         case CONNMAN_PROVIDER_STATE_FAILURE:
 275                 return provider_indicate_state(provider,
 276                                         CONNMAN_SERVICE_STATE_FAILURE);
 277         }
 278
 279         return -EINVAL;
 280 }
 281
 282 int connman_provider_indicate_error(struct connman_provider *provider,
 283                                         enum connman_provider_error error)
 284 {
 285         enum connman_service_error service_error;
 286
 287         switch (error) {
 288         case CONNMAN_PROVIDER_ERROR_LOGIN_FAILED:
 289                 service_error = CONNMAN_SERVICE_ERROR_LOGIN_FAILED;
 290                 break;
 291         case CONNMAN_PROVIDER_ERROR_AUTH_FAILED:
 292                 service_error = CONNMAN_SERVICE_ERROR_AUTH_FAILED;
 293                 break;
 294         case CONNMAN_PROVIDER_ERROR_CONNECT_FAILED:
 295                 service_error = CONNMAN_SERVICE_ERROR_CONNECT_FAILED;
 296                 break;
 297         default:
 298                 service_error = CONNMAN_SERVICE_ERROR_UNKNOWN;
 299                 break;
 300         }
 301
 302         return __connman_service_indicate_error(provider->vpn_service,
 303                                                         service_error);
 304 }
 305
 306 int connman_provider_create_service(struct connman_provider *provider)
 307 {
 308         if (provider->vpn_service != NULL) {
 309                 connman_bool_t connected;
 310
 311                 connected = __connman_service_is_connected_state(
 312                         provider->vpn_service, CONNMAN_IPCONFIG_TYPE_IPV4);
 313                 if (connected == TRUE)
 314                         return -EALREADY;
 315
 316                 connected = __connman_service_is_connected_state(
 317                         provider->vpn_service, CONNMAN_IPCONFIG_TYPE_IPV6);
 318                 if (connected == TRUE)
 319                         return -EALREADY;
 320
 321                 return 0;
 322         }
 323
 324         provider->vpn_service =
 325                 __connman_service_create_from_provider(provider);
 326
 327         if (provider->vpn_service == NULL) {
 328                 connman_warn("service creation failed for provider %s",
 329                         provider->identifier);
 330
 331                 g_hash_table_remove(provider_hash, provider->identifier);
 332                 return -EOPNOTSUPP;
 333         }
 334
 335         return 0;
 336 }
 337
 338 static struct connman_provider *provider_lookup(const char *identifier)
 339 {
 340         return g_hash_table_lookup(provider_hash, identifier);
 341 }
 342
 343 static void connection_ready(DBusMessage *msg, int error_code, void *user_data)
 344 {
 345         DBusMessage *reply;
 346         const char *identifier = user_data;
 347
 348         DBG("msg %p error %d", msg, error_code);
 349
 350         if (error_code != 0) {
 351                 reply = __connman_error_failed(msg, -error_code);
 352                 if (g_dbus_send_message(connection, reply) == FALSE)
 353                         DBG("reply %p send failed", reply);
 354         } else {
 355                 const char *path;
 356                 struct connman_provider *provider;
 357
 358                 provider = provider_lookup(identifier);
 359                 if (provider == NULL) {
 360                         reply = __connman_error_failed(msg, -EINVAL);
 361                         g_dbus_send_message(connection, reply);
 362                         return;
 363                 }
 364
 365                 path = __connman_service_get_path(provider->vpn_service);
 366
 367                 g_dbus_send_reply(connection, msg,
 368                                 DBUS_TYPE_OBJECT_PATH, &path,
 369                                 DBUS_TYPE_INVALID);
 370         }
 371 }
 372
 373 int __connman_provider_create_and_connect(DBusMessage *msg)
 374 {
 375         struct connman_provider_driver *driver;
 376
 377         if (driver_list == NULL)
 378                 return -EINVAL;
 379
 380         driver = driver_list->data;
 381         if (driver == NULL || driver->create == NULL)
 382                 return -EINVAL;
 383
 384         DBG("msg %p", msg);
 385
 386         return driver->create(msg, connection_ready);
 387 }
 388
 389 const char * __connman_provider_get_ident(struct connman_provider *provider)
 390 {
 391         if (provider == NULL)
 392                 return NULL;
 393
 394         return provider->identifier;
 395 }
 396
 397 int connman_provider_set_string(struct connman_provider *provider,
 398                                         const char *key, const char *value)
 399 {
 400         if (provider->driver != NULL && provider->driver->set_property)
 401                 return provider->driver->set_property(provider, key, value);
 402
 403         return 0;
 404 }
 405
 406 const char *connman_provider_get_string(struct connman_provider *provider,
 407                                                         const char *key)
 408 {
 409         if (provider->driver != NULL && provider->driver->get_property)
 410                 return provider->driver->get_property(provider, key);
 411
 412         return NULL;
 413 }
 414
 415 connman_bool_t
 416 __connman_provider_check_routes(struct connman_provider *provider)
 417 {
 418         if (provider == NULL)
 419                 return FALSE;
 420
 421         if (provider->driver != NULL && provider->driver->check_routes)
 422                 return provider->driver->check_routes(provider);
 423
 424         return FALSE;
 425 }
 426
 427 void *connman_provider_get_data(struct connman_provider *provider)
 428 {
 429         return provider->driver_data;
 430 }
 431
 432 void connman_provider_set_data(struct connman_provider *provider, void *data)
 433 {
 434         provider->driver_data = data;
 435 }
 436
 437 void connman_provider_set_index(struct connman_provider *provider, int index)
 438 {
 439         struct connman_service *service = provider->vpn_service;
 440         struct connman_ipconfig *ipconfig;
 441
 442         DBG("");
 443
 444         if (service == NULL)
 445                 return;
 446
 447         ipconfig = __connman_service_get_ip4config(service);
 448
 449         if (ipconfig == NULL) {
 450                 connman_service_create_ip4config(service, index);
 451
 452                 ipconfig = __connman_service_get_ip4config(service);
 453                 if (ipconfig == NULL) {
 454                         DBG("Couldnt create ipconfig");
 455                         goto done;
 456                 }
 457         }
 458
 459         __connman_ipconfig_set_method(ipconfig, CONNMAN_IPCONFIG_METHOD_OFF);
 460         __connman_ipconfig_set_index(ipconfig, index);
 461
 462         ipconfig = __connman_service_get_ip6config(service);
 463
 464         if (ipconfig == NULL) {
 465                 connman_service_create_ip6config(service, index);
 466
 467                 ipconfig = __connman_service_get_ip6config(service);
 468                 if (ipconfig == NULL) {
 469                         DBG("Couldnt create ipconfig for IPv6");
 470                         goto done;
 471                 }
 472         }
 473
 474         __connman_ipconfig_set_method(ipconfig, CONNMAN_IPCONFIG_METHOD_OFF);
 475         __connman_ipconfig_set_index(ipconfig, index);
 476
 477 done:
 478         provider->index = index;
 479 }
 480
 481 int connman_provider_get_index(struct connman_provider *provider)
 482 {
 483         return provider->index;
 484 }
 485
 486 int connman_provider_set_ipaddress(struct connman_provider *provider,
 487                                         struct connman_ipaddress *ipaddress)
 488 {
 489         struct connman_ipconfig *ipconfig = NULL;
 490
 491         ipconfig = __connman_service_get_ipconfig(provider->vpn_service,
 492                                                         ipaddress->family);
 493         if (ipconfig == NULL)
 494                 return -EINVAL;
 495
 496         provider->family = ipaddress->family;
 497
 498         __connman_ipconfig_set_method(ipconfig, CONNMAN_IPCONFIG_METHOD_FIXED);
 499
 500         __connman_ipconfig_set_local(ipconfig, ipaddress->local);
 501         __connman_ipconfig_set_peer(ipconfig, ipaddress->peer);
 502         __connman_ipconfig_set_broadcast(ipconfig, ipaddress->broadcast);
 503         __connman_ipconfig_set_gateway(ipconfig, ipaddress->gateway);
 504         __connman_ipconfig_set_prefixlen(ipconfig, ipaddress->prefixlen);
 505
 506         return 0;
 507 }
 508
 509 int connman_provider_set_pac(struct connman_provider *provider, const char *pac)
 510 {
 511         DBG("provider %p pac %s", provider, pac);
 512
 513         __connman_service_set_pac(provider->vpn_service, pac);
 514
 515         return 0;
 516 }
 517
 518
 519 int connman_provider_set_domain(struct connman_provider *provider,
 520                                         const char *domain)
 521 {
 522         DBG("provider %p domain %s", provider, domain);
 523
 524         __connman_service_set_domainname(provider->vpn_service, domain);
 525
 526         return 0;
 527 }
 528
 529 int connman_provider_set_nameservers(struct connman_provider *provider,
 530                                         const char *nameservers)
 531 {
 532         int i;
 533         char **nameservers_array = NULL;
 534
 535         DBG("provider %p nameservers %s", provider, nameservers);
 536
 537         __connman_service_nameserver_clear(provider->vpn_service);
 538
 539         if (nameservers == NULL)
 540                 return 0;
 541
 542         nameservers_array = g_strsplit(nameservers, " ", 0);
 543
 544         for (i = 0; nameservers_array[i] != NULL; i++) {
 545                 __connman_service_nameserver_append(provider->vpn_service,
 546                                                 nameservers_array[i], FALSE);
 547         }
 548
 549         g_strfreev(nameservers_array);
 550
 551         return 0;
 552 }
 553
 554 static void unregister_provider(gpointer data)
 555 {
 556         struct connman_provider *provider = data;
 557
 558         DBG("provider %p service %p", provider, provider->vpn_service);
 559
 560         if (provider->vpn_service != NULL) {
 561                 connman_service_unref(provider->vpn_service);
 562                 provider->vpn_service = NULL;
 563         }
 564
 565         connman_provider_unref(provider);
 566 }
 567
 568 static void clean_provider(gpointer key, gpointer value, gpointer user_data)
 569 {
 570         struct connman_provider *provider = value;
 571
 572         if (provider->driver != NULL && provider->driver->remove)
 573                 provider->driver->remove(provider);
 574 }
 575
 576 static gint compare_priority(gconstpointer a, gconstpointer b)
 577 {
 578         return 0;
 579 }
 580
 581 int connman_provider_driver_register(struct connman_provider_driver *driver)
 582 {
 583         DBG("driver %p name %s", driver, driver->name);
 584
 585         driver_list = g_slist_insert_sorted(driver_list, driver,
 586                                                         compare_priority);
 587         return 0;
 588 }
 589
 590 void connman_provider_driver_unregister(struct connman_provider_driver *driver)
 591 {
 592         DBG("driver %p name %s", driver, driver->name);
 593
 594         driver_list = g_slist_remove(driver_list, driver);
 595 }
 596
 597 void connman_provider_set_driver(struct connman_provider *provider,
 598                                 struct connman_provider_driver *driver)
 599 {
 600         provider->driver = driver;
 601 }
 602
 603 static void provider_disconnect_all(gpointer key, gpointer value,
 604                                                 gpointer user_data)
 605 {
 606         struct connman_provider *provider = value;
 607
 608         connman_provider_disconnect(provider);
 609 }
 610
 611 static void provider_offline_mode(connman_bool_t enabled)
 612 {
 613         DBG("enabled %d", enabled);
 614
 615         if (enabled == TRUE)
 616                 g_hash_table_foreach(provider_hash, provider_disconnect_all,
 617                                                                         NULL);
 618
 619 }
 620
 621 static void provider_initialize(struct connman_provider *provider)
 622 {
 623         DBG("provider %p", provider);
 624
 625         provider->index = 0;
 626         provider->identifier = NULL;
 627 }
 628
 629 static struct connman_provider *provider_new(void)
 630 {
 631         struct connman_provider *provider;
 632
 633         provider = g_try_new0(struct connman_provider, 1);
 634         if (provider == NULL)
 635                 return NULL;
 636
 637         provider->refcount = 1;
 638
 639         DBG("provider %p", provider);
 640         provider_initialize(provider);
 641
 642         return provider;
 643 }
 644
 645 struct connman_provider *connman_provider_get(const char *identifier)
 646 {
 647         struct connman_provider *provider;
 648
 649         provider = g_hash_table_lookup(provider_hash, identifier);
 650         if (provider != NULL)
 651                 return provider;
 652
 653         provider = provider_new();
 654         if (provider == NULL)
 655                 return NULL;
 656
 657         DBG("provider %p", provider);
 658
 659         provider->identifier = g_strdup(identifier);
 660
 661         g_hash_table_insert(provider_hash, provider->identifier, provider);
 662
 663         return provider;
 664 }
 665
 666 void connman_provider_put(struct connman_provider *provider)
 667 {
 668         g_hash_table_remove(provider_hash, provider->identifier);
 669 }
 670
 671 static struct connman_provider *provider_get(int index)
 672 {
 673         GHashTableIter iter;
 674         gpointer value, key;
 675
 676         g_hash_table_iter_init(&iter, provider_hash);
 677
 678         while (g_hash_table_iter_next(&iter, &key, &value) == TRUE) {
 679                 struct connman_provider *provider = value;
 680
 681                 if (provider->index == index)
 682                         return provider;
 683         }
 684
 685         return NULL;
 686 }
 687
 688 static void provider_service_changed(struct connman_service *service,
 689                                 enum connman_service_state state)
 690 {
 691         struct connman_provider *provider;
 692         int vpn_index, service_index;
 693
 694         if (service == NULL)
 695                 return;
 696
 697         switch (state) {
 698         case CONNMAN_SERVICE_STATE_UNKNOWN:
 699         case CONNMAN_SERVICE_STATE_IDLE:
 700         case CONNMAN_SERVICE_STATE_ASSOCIATION:
 701         case CONNMAN_SERVICE_STATE_CONFIGURATION:
 702         case CONNMAN_SERVICE_STATE_READY:
 703         case CONNMAN_SERVICE_STATE_ONLINE:
 704                 return;
 705         case CONNMAN_SERVICE_STATE_DISCONNECT:
 706         case CONNMAN_SERVICE_STATE_FAILURE:
 707                 break;
 708         }
 709
 710         service_index = __connman_service_get_index(service);
 711
 712         vpn_index = __connman_connection_get_vpn_index(service_index);
 713
 714         DBG("service %p %s state %d index %d/%d", service,
 715                 __connman_service_get_ident(service),
 716                 state, service_index, vpn_index);
 717
 718         if (vpn_index < 0)
 719                 return;
 720
 721         provider = provider_get(vpn_index);
 722         if (provider == NULL)
 723                 return;
 724
 725         DBG("disconnect %p index %d", provider, vpn_index);
 726
 727         connman_provider_disconnect(provider);
 728
 729         return;
 730 }
 731
 732 static struct connman_notifier provider_notifier = {
 733         .name                   = "provider",
 734         .offline_mode           = provider_offline_mode,
 735         .service_state_changed  = provider_service_changed,
 736 };
 737
 738 int __connman_provider_init(void)
 739 {
 740         int err;
 741
 742         DBG("");
 743
 744         connection = connman_dbus_get_connection();
 745
 746         provider_hash = g_hash_table_new_full(g_str_hash, g_str_equal,
 747                                                 NULL, unregister_provider);
 748
 749         err = connman_notifier_register(&provider_notifier);
 750         if (err < 0) {
 751                 g_hash_table_destroy(provider_hash);
 752                 dbus_connection_unref(connection);
 753         }
 754
 755         return err;
 756 }
 757
 758 void __connman_provider_cleanup(void)
 759 {
 760         DBG("");
 761
 762         connman_notifier_unregister(&provider_notifier);
 763
 764         g_hash_table_foreach(provider_hash, clean_provider, NULL);
 765
 766         g_hash_table_destroy(provider_hash);
 767         provider_hash = NULL;
 768
 769         dbus_connection_unref(connection);
 770 }