www.project-moonshot.org Git - mech_eap.orig/blob - libeap/src/p2p/p2p_i.h

   1 /*
   2  * P2P - Internal definitions for P2P module
   3  * Copyright (c) 2009-2010, Atheros Communications
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License version 2 as
   7  * published by the Free Software Foundation.
   8  *
   9  * Alternatively, this software may be distributed under the terms of BSD
  10  * license.
  11  *
  12  * See README and COPYING for more details.
  13  */
  14
  15 #ifndef P2P_I_H
  16 #define P2P_I_H
  17
  18 #include "utils/list.h"
  19 #include "p2p.h"
  20
  21 /* TODO: add removal of expired P2P device entries */
  22
  23 enum p2p_go_state {
  24         UNKNOWN_GO,
  25         LOCAL_GO,
  26         REMOTE_GO
  27 };
  28
  29 /**
  30  * struct p2p_device - P2P Device data (internal to P2P module)
  31  */
  32 struct p2p_device {
  33         struct dl_list list;
  34         struct os_time last_seen;
  35         int listen_freq;
  36         int level;
  37         enum p2p_wps_method wps_method;
  38
  39         u8 p2p_device_addr[ETH_ALEN]; /* P2P Device Address of the peer */
  40         u8 pri_dev_type[8];
  41         char device_name[33];
  42         u16 config_methods;
  43         u8 dev_capab;
  44         u8 group_capab;
  45
  46         /*
  47          * If the peer was discovered based on an interface address (e.g., GO
  48          * from Beacon/Probe Response), the interface address is stored here.
  49          * p2p_device_addr must still be set in such a case to the unique
  50          * identifier for the P2P Device.
  51          */
  52         u8 interface_addr[ETH_ALEN];
  53
  54         /*
  55          * P2P Device Address of the GO in whose group this P2P Device is a
  56          * client.
  57          */
  58         u8 member_in_go_dev[ETH_ALEN];
  59
  60         /*
  61          * P2P Interface Address of the GO in whose group this P2P Device is a
  62          * client.
  63          */
  64         u8 member_in_go_iface[ETH_ALEN];
  65
  66         int go_neg_req_sent;
  67         enum p2p_go_state go_state;
  68         u8 dialog_token;
  69         u8 intended_addr[ETH_ALEN];
  70
  71         char country[3];
  72         struct p2p_channels channels;
  73         int oper_freq;
  74         u8 oper_ssid[32];
  75         size_t oper_ssid_len;
  76
  77         /**
  78          * req_config_methods - Pending provisioning discovery methods
  79          */
  80         u16 req_config_methods;
  81
  82 #define P2P_DEV_PROBE_REQ_ONLY BIT(0)
  83 #define P2P_DEV_REPORTED BIT(1)
  84 #define P2P_DEV_NOT_YET_READY BIT(2)
  85 #define P2P_DEV_SD_INFO BIT(3)
  86 #define P2P_DEV_SD_SCHEDULE BIT(4)
  87 #define P2P_DEV_PD_PEER_DISPLAY BIT(5)
  88 #define P2P_DEV_PD_PEER_KEYPAD BIT(6)
  89 #define P2P_DEV_USER_REJECTED BIT(7)
  90 #define P2P_DEV_PEER_WAITING_RESPONSE BIT(8)
  91 #define P2P_DEV_PREFER_PERSISTENT_GROUP BIT(9)
  92 #define P2P_DEV_WAIT_GO_NEG_RESPONSE BIT(10)
  93 #define P2P_DEV_WAIT_GO_NEG_CONFIRM BIT(11)
  94 #define P2P_DEV_GROUP_CLIENT_ONLY BIT(12)
  95 #define P2P_DEV_FORCE_FREQ BIT(13)
  96         unsigned int flags;
  97
  98         int status; /* enum p2p_status_code */
  99         unsigned int wait_count;
 100         unsigned int invitation_reqs;
 101
 102         u16 ext_listen_period;
 103         u16 ext_listen_interval;
 104
 105         u8 go_timeout;
 106         u8 client_timeout;
 107 };
 108
 109 struct p2p_sd_query {
 110         struct p2p_sd_query *next;
 111         u8 peer[ETH_ALEN];
 112         int for_all_peers;
 113         struct wpabuf *tlvs;
 114 };
 115
 116 /**
 117  * struct p2p_data - P2P module data (internal to P2P module)
 118  */
 119 struct p2p_data {
 120         /**
 121          * cfg - P2P module configuration
 122          *
 123          * This is included in the same memory allocation with the
 124          * struct p2p_data and as such, must not be freed separately.
 125          */
 126         struct p2p_config *cfg;
 127
 128         /**
 129          * state - The current P2P state
 130          */
 131         enum p2p_state {
 132                 /**
 133                  * P2P_IDLE - Idle
 134                  */
 135                 P2P_IDLE,
 136
 137                 /**
 138                  * P2P_SEARCH - Search (Device Discovery)
 139                  */
 140                 P2P_SEARCH,
 141
 142                 /**
 143                  * P2P_CONNECT - Trying to start GO Negotiation
 144                  */
 145                 P2P_CONNECT,
 146
 147                 /**
 148                  * P2P_CONNECT_LISTEN - Listen during GO Negotiation start
 149                  */
 150                 P2P_CONNECT_LISTEN,
 151
 152                 /**
 153                  * P2P_GO_NEG - In GO Negotiation
 154                  */
 155                 P2P_GO_NEG,
 156
 157                 /**
 158                  * P2P_LISTEN_ONLY - Listen only
 159                  */
 160                 P2P_LISTEN_ONLY,
 161
 162                 /**
 163                  * P2P_WAIT_PEER_CONNECT - Waiting peer in List for GO Neg
 164                  */
 165                 P2P_WAIT_PEER_CONNECT,
 166
 167                 /**
 168                  * P2P_WAIT_PEER_IDLE - Waiting peer idle for GO Neg
 169                  */
 170                 P2P_WAIT_PEER_IDLE,
 171
 172                 /**
 173                  * P2P_SD_DURING_FIND - Service Discovery during find
 174                  */
 175                 P2P_SD_DURING_FIND,
 176
 177                 /**
 178                  * P2P_PROVISIONING - Provisioning (during group formation)
 179                  */
 180                 P2P_PROVISIONING,
 181
 182                 /**
 183                  * P2P_PD_DURING_FIND - Provision Discovery during find
 184                  */
 185                 P2P_PD_DURING_FIND,
 186
 187                 /**
 188                  * P2P_INVITE - Trying to start Invite
 189                  */
 190                 P2P_INVITE,
 191
 192                 /**
 193                  * P2P_INVITE_LISTEN - Listen during Invite
 194                  */
 195                 P2P_INVITE_LISTEN,
 196         } state;
 197
 198         /**
 199          * min_disc_int - minDiscoverableInterval
 200          */
 201         int min_disc_int;
 202
 203         /**
 204          * max_disc_int - maxDiscoverableInterval
 205          */
 206         int max_disc_int;
 207
 208         /**
 209          * devices - List of known P2P Device peers
 210          */
 211         struct dl_list devices;
 212
 213         /**
 214          * go_neg_peer - Pointer to GO Negotiation peer
 215          */
 216         struct p2p_device *go_neg_peer;
 217
 218         /**
 219          * invite_peer - Pointer to Invite peer
 220          */
 221         struct p2p_device *invite_peer;
 222
 223         const u8 *invite_go_dev_addr;
 224         u8 invite_go_dev_addr_buf[ETH_ALEN];
 225
 226         /**
 227          * sd_peer - Pointer to Service Discovery peer
 228          */
 229         struct p2p_device *sd_peer;
 230
 231         /**
 232          * sd_query - Pointer to Service Discovery query
 233          */
 234         struct p2p_sd_query *sd_query;
 235
 236         /* GO Negotiation data */
 237
 238         /**
 239          * intended_addr - Local Intended P2P Interface Address
 240          *
 241          * This address is used during group owner negotiation as the Intended
 242          * P2P Interface Address and the group interface will be created with
 243          * address as the local address in case of successfully completed
 244          * negotiation.
 245          */
 246         u8 intended_addr[ETH_ALEN];
 247
 248         /**
 249          * go_intent - Local GO Intent to be used during GO Negotiation
 250          */
 251         u8 go_intent;
 252
 253         /**
 254          * next_tie_breaker - Next tie-breaker value to use in GO Negotiation
 255          */
 256         u8 next_tie_breaker;
 257
 258         /**
 259          * ssid - Selected SSID for GO Negotiation (if local end will be GO)
 260          */
 261         u8 ssid[32];
 262
 263         /**
 264          * ssid_len - ssid length in octets
 265          */
 266         size_t ssid_len;
 267
 268         /**
 269          * Regulatory class for own operational channel
 270          */
 271         u8 op_reg_class;
 272
 273         /**
 274          * op_channel - Own operational channel
 275          */
 276         u8 op_channel;
 277
 278         /**
 279          * channels - Own supported regulatory classes and channels
 280          *
 281          * List of supposerted channels per regulatory class. The regulatory
 282          * classes are defined in IEEE Std 802.11-2007 Annex J and the
 283          * numbering of the clases depends on the configured country code.
 284          */
 285         struct p2p_channels channels;
 286
 287         enum p2p_pending_action_state {
 288                 P2P_NO_PENDING_ACTION,
 289                 P2P_PENDING_GO_NEG_REQUEST,
 290                 P2P_PENDING_GO_NEG_RESPONSE,
 291                 P2P_PENDING_GO_NEG_RESPONSE_FAILURE,
 292                 P2P_PENDING_GO_NEG_CONFIRM,
 293                 P2P_PENDING_SD,
 294                 P2P_PENDING_PD,
 295                 P2P_PENDING_INVITATION_REQUEST,
 296                 P2P_PENDING_INVITATION_RESPONSE,
 297                 P2P_PENDING_DEV_DISC_REQUEST,
 298                 P2P_PENDING_DEV_DISC_RESPONSE,
 299                 P2P_PENDING_GO_DISC_REQ
 300         } pending_action_state;
 301
 302         unsigned int pending_listen_freq;
 303         unsigned int pending_listen_sec;
 304         unsigned int pending_listen_usec;
 305
 306         u8 dev_capab;
 307
 308         int in_listen;
 309         int drv_in_listen;
 310
 311         /**
 312          * sd_queries - Pending service discovery queries
 313          */
 314         struct p2p_sd_query *sd_queries;
 315
 316         /**
 317          * srv_update_indic - Service Update Indicator for local services
 318          */
 319         u16 srv_update_indic;
 320
 321         struct wpabuf *sd_resp; /* Fragmented SD response */
 322         u8 sd_resp_addr[ETH_ALEN];
 323         u8 sd_resp_dialog_token;
 324         size_t sd_resp_pos; /* Offset in sd_resp */
 325         u8 sd_frag_id;
 326
 327         struct wpabuf *sd_rx_resp; /* Reassembled SD response */
 328         u16 sd_rx_update_indic;
 329
 330         /* P2P Invitation data */
 331         enum p2p_invite_role inv_role;
 332         u8 inv_bssid[ETH_ALEN];
 333         int inv_bssid_set;
 334         u8 inv_ssid[32];
 335         size_t inv_ssid_len;
 336         u8 inv_sa[ETH_ALEN];
 337         u8 inv_group_bssid[ETH_ALEN];
 338         u8 *inv_group_bssid_ptr;
 339         u8 inv_go_dev_addr[ETH_ALEN];
 340         u8 inv_status;
 341         int inv_op_freq;
 342         int inv_persistent;
 343
 344         enum p2p_discovery_type find_type;
 345         u8 last_prog_scan_class;
 346         u8 last_prog_scan_chan;
 347         int p2p_scan_running;
 348         enum p2p_after_scan {
 349                 P2P_AFTER_SCAN_NOTHING,
 350                 P2P_AFTER_SCAN_LISTEN,
 351                 P2P_AFTER_SCAN_CONNECT
 352         } start_after_scan;
 353         u8 after_scan_peer[ETH_ALEN];
 354
 355         struct p2p_group **groups;
 356         size_t num_groups;
 357
 358         struct p2p_device *pending_client_disc_go;
 359         u8 pending_client_disc_addr[ETH_ALEN];
 360         u8 pending_dev_disc_dialog_token;
 361         u8 pending_dev_disc_addr[ETH_ALEN];
 362         int pending_dev_disc_freq;
 363         unsigned int pending_client_disc_freq;
 364
 365         int ext_listen_only;
 366         unsigned int ext_listen_period;
 367         unsigned int ext_listen_interval;
 368         unsigned int ext_listen_interval_sec;
 369         unsigned int ext_listen_interval_usec;
 370
 371         u8 peer_filter[ETH_ALEN];
 372
 373         int cross_connect;
 374 };
 375
 376 /**
 377  * struct p2p_message - Parsed P2P message (or P2P IE)
 378  */
 379 struct p2p_message {
 380         struct wpabuf *p2p_attributes;
 381         struct wpabuf *wps_attributes;
 382
 383         u8 dialog_token;
 384
 385         const u8 *capability;
 386         const u8 *go_intent;
 387         const u8 *status;
 388         const u8 *listen_channel;
 389         const u8 *operating_channel;
 390         const u8 *channel_list;
 391         u8 channel_list_len;
 392         const u8 *config_timeout;
 393         const u8 *intended_addr;
 394         const u8 *group_bssid;
 395         const u8 *invitation_flags;
 396
 397         const u8 *group_info;
 398         size_t group_info_len;
 399
 400         const u8 *group_id;
 401         size_t group_id_len;
 402
 403         const u8 *device_id;
 404
 405         const u8 *manageability;
 406
 407         const u8 *noa;
 408         size_t noa_len;
 409
 410         const u8 *ext_listen_timing;
 411
 412         const u8 *minor_reason_code;
 413
 414         /* P2P Device Info */
 415         const u8 *p2p_device_info;
 416         size_t p2p_device_info_len;
 417         const u8 *p2p_device_addr;
 418         const u8 *pri_dev_type;
 419         u8 num_sec_dev_types;
 420         char device_name[33];
 421         u16 config_methods;
 422
 423         /* WPS IE */
 424         u16 dev_password_id;
 425         u16 wps_config_methods;
 426         const u8 *wps_pri_dev_type;
 427
 428         /* DS Parameter Set IE */
 429         const u8 *ds_params;
 430
 431         /* SSID IE */
 432         const u8 *ssid;
 433 };
 434
 435
 436 #define P2P_MAX_GROUP_ENTRIES 50
 437
 438 struct p2p_group_info {
 439         unsigned int num_clients;
 440         struct p2p_client_info {
 441                 const u8 *p2p_device_addr;
 442                 const u8 *p2p_interface_addr;
 443                 u8 dev_capab;
 444                 u16 config_methods;
 445                 const u8 *pri_dev_type;
 446                 u8 num_sec_dev_types;
 447                 const u8 *sec_dev_types;
 448                 const char *dev_name;
 449                 size_t dev_name_len;
 450         } client[P2P_MAX_GROUP_ENTRIES];
 451 };
 452
 453
 454 /* p2p_utils.c */
 455 int p2p_random(char *buf, size_t len);
 456 int p2p_channel_to_freq(const char *country, int reg_class, int channel);
 457 int p2p_freq_to_channel(const char *country, unsigned int freq, u8 *reg_class,
 458                         u8 *channel);
 459 void p2p_channels_intersect(const struct p2p_channels *a,
 460                             const struct p2p_channels *b,
 461                             struct p2p_channels *res);
 462 int p2p_channels_includes(const struct p2p_channels *channels, u8 reg_class,
 463                           u8 channel);
 464
 465 /* p2p_parse.c */
 466 int p2p_parse_p2p_ie(const struct wpabuf *buf, struct p2p_message *msg);
 467 int p2p_parse_ies(const u8 *data, size_t len, struct p2p_message *msg);
 468 int p2p_parse(const u8 *data, size_t len, struct p2p_message *msg);
 469 void p2p_parse_free(struct p2p_message *msg);
 470 int p2p_attr_text(struct wpabuf *data, char *buf, char *end);
 471 int p2p_group_info_parse(const u8 *gi, size_t gi_len,
 472                          struct p2p_group_info *info);
 473
 474 /* p2p_build.c */
 475
 476 struct p2p_noa_desc {
 477         u8 count_type;
 478         u32 duration;
 479         u32 interval;
 480         u32 start_time;
 481 };
 482
 483 /* p2p_group.c */
 484 const u8 * p2p_group_get_interface_addr(struct p2p_group *group);
 485 u8 p2p_group_presence_req(struct p2p_group *group,
 486                           const u8 *client_interface_addr,
 487                           const u8 *noa, size_t noa_len);
 488
 489
 490 void p2p_buf_add_action_hdr(struct wpabuf *buf, u8 subtype, u8 dialog_token);
 491 void p2p_buf_add_public_action_hdr(struct wpabuf *buf, u8 subtype,
 492                                    u8 dialog_token);
 493 u8 * p2p_buf_add_ie_hdr(struct wpabuf *buf);
 494 void p2p_buf_add_status(struct wpabuf *buf, u8 status);
 495 void p2p_buf_add_device_info(struct wpabuf *buf, struct p2p_data *p2p,
 496                              struct p2p_device *peer);
 497 void p2p_buf_add_device_id(struct wpabuf *buf, const u8 *dev_addr);
 498 void p2p_buf_update_ie_hdr(struct wpabuf *buf, u8 *len);
 499 void p2p_buf_add_capability(struct wpabuf *buf, u8 dev_capab, u8 group_capab);
 500 void p2p_buf_add_go_intent(struct wpabuf *buf, u8 go_intent);
 501 void p2p_buf_add_listen_channel(struct wpabuf *buf, const char *country,
 502                                 u8 reg_class, u8 channel);
 503 void p2p_buf_add_operating_channel(struct wpabuf *buf, const char *country,
 504                                    u8 reg_class, u8 channel);
 505 void p2p_buf_add_channel_list(struct wpabuf *buf, const char *country,
 506                               struct p2p_channels *chan);
 507 void p2p_buf_add_config_timeout(struct wpabuf *buf, u8 go_timeout,
 508                                 u8 client_timeout);
 509 void p2p_buf_add_intended_addr(struct wpabuf *buf, const u8 *interface_addr);
 510 void p2p_buf_add_group_bssid(struct wpabuf *buf, const u8 *bssid);
 511 void p2p_buf_add_group_id(struct wpabuf *buf, const u8 *dev_addr,
 512                           const u8 *ssid, size_t ssid_len);
 513 void p2p_buf_add_invitation_flags(struct wpabuf *buf, u8 flags);
 514 void p2p_buf_add_noa(struct wpabuf *buf, u8 noa_index, u8 opp_ps, u8 ctwindow,
 515                      struct p2p_noa_desc *desc1, struct p2p_noa_desc *desc2);
 516 void p2p_buf_add_ext_listen_timing(struct wpabuf *buf, u16 period,
 517                                    u16 interval);
 518 void p2p_buf_add_p2p_interface(struct wpabuf *buf, struct p2p_data *p2p);
 519 void p2p_build_wps_ie(struct p2p_data *p2p, struct wpabuf *buf, u16 pw_id,
 520                       int all_attr);
 521
 522 /* p2p_sd.c */
 523 struct p2p_sd_query * p2p_pending_sd_req(struct p2p_data *p2p,
 524                                          struct p2p_device *dev);
 525 void p2p_free_sd_queries(struct p2p_data *p2p);
 526 void p2p_rx_gas_initial_req(struct p2p_data *p2p, const u8 *sa,
 527                             const u8 *data, size_t len, int rx_freq);
 528 void p2p_rx_gas_initial_resp(struct p2p_data *p2p, const u8 *sa,
 529                              const u8 *data, size_t len, int rx_freq);
 530 void p2p_rx_gas_comeback_req(struct p2p_data *p2p, const u8 *sa,
 531                              const u8 *data, size_t len, int rx_freq);
 532 void p2p_rx_gas_comeback_resp(struct p2p_data *p2p, const u8 *sa,
 533                               const u8 *data, size_t len, int rx_freq);
 534 int p2p_start_sd(struct p2p_data *p2p, struct p2p_device *dev);
 535
 536 /* p2p_go_neg.c */
 537 int p2p_peer_channels_check(struct p2p_data *p2p, struct p2p_channels *own,
 538                             struct p2p_device *dev,
 539                             const u8 *channel_list, size_t channel_list_len);
 540 void p2p_process_go_neg_req(struct p2p_data *p2p, const u8 *sa,
 541                             const u8 *data, size_t len, int rx_freq);
 542 void p2p_process_go_neg_resp(struct p2p_data *p2p, const u8 *sa,
 543                              const u8 *data, size_t len, int rx_freq);
 544 void p2p_process_go_neg_conf(struct p2p_data *p2p, const u8 *sa,
 545                              const u8 *data, size_t len);
 546 int p2p_connect_send(struct p2p_data *p2p, struct p2p_device *dev);
 547
 548 /* p2p_pd.c */
 549 void p2p_process_prov_disc_req(struct p2p_data *p2p, const u8 *sa,
 550                                const u8 *data, size_t len, int rx_freq);
 551 void p2p_process_prov_disc_resp(struct p2p_data *p2p, const u8 *sa,
 552                                 const u8 *data, size_t len);
 553 int p2p_send_prov_disc_req(struct p2p_data *p2p, struct p2p_device *dev,
 554                            int join);
 555
 556 /* p2p_invitation.c */
 557 void p2p_process_invitation_req(struct p2p_data *p2p, const u8 *sa,
 558                                 const u8 *data, size_t len, int rx_freq);
 559 void p2p_process_invitation_resp(struct p2p_data *p2p, const u8 *sa,
 560                                  const u8 *data, size_t len);
 561 int p2p_invite_send(struct p2p_data *p2p, struct p2p_device *dev,
 562                     const u8 *go_dev_addr);
 563 void p2p_invitation_req_cb(struct p2p_data *p2p, int success);
 564 void p2p_invitation_resp_cb(struct p2p_data *p2p, int success);
 565
 566 /* p2p_dev_disc.c */
 567 void p2p_process_dev_disc_req(struct p2p_data *p2p, const u8 *sa,
 568                               const u8 *data, size_t len, int rx_freq);
 569 void p2p_dev_disc_req_cb(struct p2p_data *p2p, int success);
 570 int p2p_send_dev_disc_req(struct p2p_data *p2p, struct p2p_device *dev);
 571 void p2p_dev_disc_resp_cb(struct p2p_data *p2p, int success);
 572 void p2p_process_dev_disc_resp(struct p2p_data *p2p, const u8 *sa,
 573                                const u8 *data, size_t len);
 574 void p2p_go_disc_req_cb(struct p2p_data *p2p, int success);
 575 void p2p_process_go_disc_req(struct p2p_data *p2p, const u8 *da, const u8 *sa,
 576                              const u8 *data, size_t len, int rx_freq);
 577
 578 /* p2p.c */
 579 void p2p_set_state(struct p2p_data *p2p, int new_state);
 580 void p2p_set_timeout(struct p2p_data *p2p, unsigned int sec,
 581                      unsigned int usec);
 582 void p2p_clear_timeout(struct p2p_data *p2p);
 583 void p2p_continue_find(struct p2p_data *p2p);
 584 struct p2p_device * p2p_add_dev_from_go_neg_req(struct p2p_data *p2p,
 585                                                 const u8 *addr,
 586                                                 struct p2p_message *msg);
 587 void p2p_add_dev_info(struct p2p_data *p2p, const u8 *addr,
 588                       struct p2p_device *dev, struct p2p_message *msg);
 589 struct p2p_device * p2p_get_device(struct p2p_data *p2p, const u8 *addr);
 590 struct p2p_device * p2p_get_device_interface(struct p2p_data *p2p,
 591                                              const u8 *addr);
 592 void p2p_go_neg_failed(struct p2p_data *p2p, struct p2p_device *peer,
 593                        int status);
 594 void p2p_go_complete(struct p2p_data *p2p, struct p2p_device *peer);
 595 int p2p_match_dev_type(struct p2p_data *p2p, struct wpabuf *wps);
 596 int dev_type_list_match(const u8 *dev_type, const u8 *req_dev_type[],
 597                         size_t num_req_dev_type);
 598 struct wpabuf * p2p_build_probe_resp_ies(struct p2p_data *p2p);
 599 void p2p_build_ssid(struct p2p_data *p2p, u8 *ssid, size_t *ssid_len);
 600
 601 #endif /* P2P_I_H */