src/include/gnunet_protocols.h

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009, 2010 Christian Grothoff (and other contributing authors)
   4
   5      GNUnet is free software; you can redistribute it and/or modify
   6      it under the terms of the GNU General Public License as published
   7      by the Free Software Foundation; either version 2, or (at your
   8      option) any later version.
   9
  10      GNUnet is distributed in the hope that it will be useful, but
  11      WITHOUT ANY WARRANTY; without even the implied warranty of
  12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13      General Public License for more details.
  14
  15      You should have received a copy of the GNU General Public License
  16      along with GNUnet; see the file COPYING.  If not, write to the
  17      Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18      Boston, MA 02111-1307, USA.
  19 */
  20
  21 /**
  22  * @file include/gnunet_protocols.h
  23  * @brief constants for network protocols
  24  * @author Christian Grothoff
  25  */
  26
  27 #ifndef GNUNET_PROTOCOLS_H
  28 #define GNUNET_PROTOCOLS_H
  29
  30 #ifdef __cplusplus
  31 extern "C"
  32 {
  33 #if 0                           /* keep Emacsens' auto-indent happy */
  34 }
  35 #endif
  36 #endif
  37
  38 /**
  39  * Test if service is online.
  40  */
  41 #define GNUNET_MESSAGE_TYPE_TEST 0
  42
  43 /**
  44  * Request service shutdown.
  45  */
  46 #define GNUNET_MESSAGE_TYPE_SHUTDOWN 1
  47
  48
  49 /**
  50  * Request DNS resolution.
  51  */
  52 #define GNUNET_MESSAGE_TYPE_RESOLVER_REQUEST 2
  53
  54 /**
  55  * Response to a DNS resolution request.
  56  */
  57 #define GNUNET_MESSAGE_TYPE_RESOLVER_RESPONSE 3
  58
  59
  60 /**
  61  * Set a statistical value.
  62  */
  63 #define GNUNET_MESSAGE_TYPE_STATISTICS_SET 4
  64
  65 /**
  66  * Get a statistical value(s).
  67  */
  68 #define GNUNET_MESSAGE_TYPE_STATISTICS_GET 5
  69
  70 /**
  71  * Response to a STATISTICS_GET message (with value).
  72  */
  73 #define GNUNET_MESSAGE_TYPE_STATISTICS_VALUE 6
  74
  75 /**
  76  * Response to a STATISTICS_GET message (end of value stream).
  77  */
  78 #define GNUNET_MESSAGE_TYPE_STATISTICS_END 7
  79
  80
  81 /**
  82  * Request to ARM to start a service.
  83  */
  84 #define GNUNET_MESSAGE_TYPE_ARM_START 8
  85
  86 /**
  87  * Request to ARM to stop a service.
  88  */
  89 #define GNUNET_MESSAGE_TYPE_ARM_STOP 9
  90
  91 /**
  92  * Response from ARM: service is now up.
  93  */
  94 #define GNUNET_MESSAGE_TYPE_ARM_IS_UP 10
  95
  96 /**
  97  * Response from ARM: service is now down.
  98  * (failed to start it or shut it down).
  99  */
 100 #define GNUNET_MESSAGE_TYPE_ARM_IS_DOWN 11
 101
 102 /**
 103  * Response from ARM: service status is unknown.
 104  */
 105 #define GNUNET_MESSAGE_TYPE_ARM_IS_UNKNOWN 12
 106
 107
 108 /**
 109  * HELLO message used for communicating peer addresses.
 110  * Managed by libgnunethello.
 111  */
 112 #define GNUNET_MESSAGE_TYPE_HELLO 16
 113
 114 /**
 115  * FRAGMENT of a larger message.
 116  * Managed by libgnunetfragment.
 117  */
 118 #define GNUNET_MESSAGE_TYPE_FRAGMENT 18
 119
 120
 121 /**
 122  * Message from the core saying that the transport
 123  * server should start giving it messages.  This
 124  * should automatically trigger the transmission of
 125  * a HELLO message.
 126  */
 127 #define GNUNET_MESSAGE_TYPE_TRANSPORT_START 20
 128
 129 /**
 130  * Message from TRANSPORT notifying about a
 131  * client that connected to us.
 132  */
 133 #define GNUNET_MESSAGE_TYPE_TRANSPORT_CONNECT 21
 134
 135 /**
 136  * Message from TRANSPORT notifying about a
 137  * client that disconnected from us.
 138  */
 139 #define GNUNET_MESSAGE_TYPE_TRANSPORT_DISCONNECT 22
 140
 141 /**
 142  * Request to TRANSPORT to transmit a message.
 143  */
 144 #define GNUNET_MESSAGE_TYPE_TRANSPORT_SEND 23
 145
 146 /**
 147  * Confirmation from TRANSPORT that message for
 148  * transmission has been queued (and that the next
 149  * message to this peer can now be passed to the
 150  * service).  Note that this confirmation does NOT
 151  * imply that the message was fully transmitted.
 152  */
 153 #define GNUNET_MESSAGE_TYPE_TRANSPORT_SEND_OK 24
 154
 155 /**
 156  * Message from TRANSPORT notifying about a
 157  * message that was received.
 158  */
 159 #define GNUNET_MESSAGE_TYPE_TRANSPORT_RECV 25
 160
 161 /**
 162  * Message telling transport to limit its receive rate.
 163  */
 164 #define GNUNET_MESSAGE_TYPE_TRANSPORT_SET_QUOTA 26
 165
 166 /**
 167  * Request to look addresses of peers in server.
 168  */
 169 #define GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_LOOKUP 27
 170
 171 /**
 172  * Response to the address lookup request.
 173  */
 174 #define GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_REPLY 28
 175
 176 /**
 177  * Register a client that wants to do blacklisting.
 178  */
 179 #define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_INIT 29
 180
 181 /**
 182  * Query to a blacklisting client (is this peer blacklisted)?
 183  */
 184 #define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_QUERY 30
 185
 186 /**
 187  * Reply from blacklisting client (answer to blacklist query).
 188  */
 189 #define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_REPLY 31
 190
 191 /**
 192  * Transport PING message
 193  */
 194 #define GNUNET_MESSAGE_TYPE_TRANSPORT_PING 32
 195
 196 /**
 197  * Transport PONG message
 198  */
 199 #define GNUNET_MESSAGE_TYPE_TRANSPORT_PONG 33
 200
 201 /**
 202  * Request addition of a HELLO
 203  */
 204 #define GNUNET_MESSAGE_TYPE_PEERINFO_ADD 36
 205
 206 /**
 207  * Request update and listing of a peer.
 208  */
 209 #define GNUNET_MESSAGE_TYPE_PEERINFO_GET 37
 210
 211 /**
 212  * Request update and listing of all peers.
 213  */
 214 #define GNUNET_MESSAGE_TYPE_PEERINFO_GET_ALL 38
 215
 216 /**
 217  * Information about one of the peers.
 218  */
 219 #define GNUNET_MESSAGE_TYPE_PEERINFO_INFO 39
 220
 221 /**
 222  * End of information about other peers.
 223  */
 224 #define GNUNET_MESSAGE_TYPE_PEERINFO_INFO_END 40
 225
 226 /**
 227  * Start notifying this client about all changes to
 228  * the known peers until it disconnects.
 229  */
 230 #define GNUNET_MESSAGE_TYPE_PEERINFO_NOTIFY 41
 231
 232 /**
 233  * DV service to DV Plugin message, when a message is
 234  * unwrapped by the DV service and handed to the plugin
 235  * for processing
 236  */
 237 #define GNUNET_MESSAGE_TYPE_TRANSPORT_DV_RECEIVE 44
 238
 239 /**
 240  * DV Plugin to DV service message, indicating a message
 241  * should be sent out.
 242  */
 243 #define GNUNET_MESSAGE_TYPE_TRANSPORT_DV_SEND 45
 244
 245 /**
 246  * P2P DV message encapsulating some real message
 247  */
 248 #define GNUNET_MESSAGE_TYPE_DV_DATA 46
 249
 250 /**
 251  * P2P DV message gossipping peer information
 252  */
 253 #define GNUNET_MESSAGE_TYPE_DV_GOSSIP 47
 254
 255 /**
 256  * DV Plugin to DV service message, indicating
 257  * startup.
 258  */
 259 #define GNUNET_MESSAGE_TYPE_DV_START 48
 260
 261 /**
 262  * UDP NAT probe message, send from NAT'd peer to
 263  * other peer to negotiate punched address/port
 264  */
 265 #define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_NAT_PROBE 55
 266
 267 /**
 268  * UDP NAT probe reply, sent from a non-NAT'd peer to
 269  * a NAT'd one to inform it we got the probe and of the
 270  * address/port seen
 271  */
 272 #define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_NAT_PROBE_REPLY 56
 273
 274 /**
 275  * UDP NAT probe confirmation, sent from a NAT'd peer to
 276  * a non-NAT'd one to inform it which port to send to us
 277  * on
 278  */
 279 #define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_NAT_PROBE_CONFIRM 57
 280
 281 /**
 282  * UDP NAT probe keepalive, once a hole is punched the NAT'd peer
 283  * needs to keep the hole alive
 284  */
 285 #define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_NAT_PROBE_KEEPALIVE 58
 286
 287 /**
 288  * Welcome message between TCP transports.
 289  */
 290 #define GNUNET_MESSAGE_TYPE_TRANSPORT_TCP_WELCOME 60
 291
 292 /**
 293  * Initial setup message from core client to core.
 294  */
 295 #define GNUNET_MESSAGE_TYPE_CORE_INIT 64
 296
 297 /**
 298  * Response from core to core client to INIT message.
 299  */
 300 #define GNUNET_MESSAGE_TYPE_CORE_INIT_REPLY 65
 301
 302 /**
 303  * Notify clients about new peer-to-peer connections (before
 304  * key exchange and authentication).
 305  */
 306 #define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_PRE_CONNECT 66
 307
 308 /**
 309  * Notify clients about new peer-to-peer connections (triggered
 310  * after key exchange).
 311  */
 312 #define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_CONNECT 67
 313
 314 /**
 315  * Notify clients about peer disconnecting.
 316  */
 317 #define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_DISCONNECT 68
 318
 319 /**
 320  * Notify clients about incoming P2P messages.
 321  */
 322 #define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_INBOUND 69
 323
 324 /**
 325  * Notify clients about outgoing P2P transmissions.
 326  */
 327 #define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_OUTBOUND 70
 328
 329 /**
 330  * Request from client to "configure" P2P connection.
 331  */
 332 #define GNUNET_MESSAGE_TYPE_CORE_REQUEST_INFO 71
 333
 334 /**
 335  * Response from server about (possibly updated) P2P
 336  * connection configuration.
 337  */
 338 #define GNUNET_MESSAGE_TYPE_CORE_CONFIGURATION_INFO 72
 339
 340 /**
 341  * Request from client with message to transmit.
 342  */
 343 #define GNUNET_MESSAGE_TYPE_CORE_SEND 73
 344
 345 /**
 346  * Request from client asking to connect to a peer.
 347  */
 348 #define GNUNET_MESSAGE_TYPE_CORE_REQUEST_CONNECT 74
 349
 350
 351 /**
 352  * Session key exchange between peers.
 353  */
 354 #define GNUNET_MESSAGE_TYPE_CORE_SET_KEY 80
 355
 356 /**
 357  * Encapsulation for an encrypted message between peers.
 358  */
 359 #define GNUNET_MESSAGE_TYPE_CORE_ENCRYPTED_MESSAGE 81
 360
 361 /**
 362  * Check that other peer is alive (challenge).
 363  */
 364 #define GNUNET_MESSAGE_TYPE_CORE_PING 82
 365
 366 /**
 367  * Confirmation that other peer is alive.
 368  */
 369 #define GNUNET_MESSAGE_TYPE_CORE_PONG 83
 370
 371 /**
 372  * Request by the other peer to terminate the connection.
 373  */
 374 #define GNUNET_MESSAGE_TYPE_CORE_HANGUP 84
 375
 376 /**
 377  * Message sent by datastore client on join.
 378  */
 379 #define GNUNET_MESSAGE_TYPE_DATASTORE_RESERVE 92
 380
 381 /**
 382  * Message sent by datastore client on join.
 383  */
 384 #define GNUNET_MESSAGE_TYPE_DATASTORE_RELEASE_RESERVE 93
 385
 386 /**
 387  * Message sent by datastore to client informing about status
 388  * processing a request
 389  * (in response to RESERVE, RELEASE_RESERVE, PUT, UPDATE and REMOVE requests).
 390  */
 391 #define GNUNET_MESSAGE_TYPE_DATASTORE_STATUS 94
 392
 393 /**
 394  * Message sent by datastore client to store data.
 395  */
 396 #define GNUNET_MESSAGE_TYPE_DATASTORE_PUT 95
 397
 398 /**
 399  * Message sent by datastore client to update data.
 400  */
 401 #define GNUNET_MESSAGE_TYPE_DATASTORE_UPDATE 96
 402
 403 /**
 404  * Message sent by datastore client to get data.
 405  */
 406 #define GNUNET_MESSAGE_TYPE_DATASTORE_GET 97
 407
 408 /**
 409  * Message sent by datastore client to get random data.
 410  */
 411 #define GNUNET_MESSAGE_TYPE_DATASTORE_GET_RANDOM 98
 412
 413 /**
 414  * Message sent by datastore to client providing requested data
 415  * (in response to GET or GET_RANDOM request).
 416  */
 417 #define GNUNET_MESSAGE_TYPE_DATASTORE_DATA 99
 418
 419 /**
 420  * Message sent by datastore to client signaling end of matching data.
 421  * This message will also be sent for "GET_RANDOM", even though
 422  * "GET_RANDOM" returns at most one data item.
 423  */
 424 #define GNUNET_MESSAGE_TYPE_DATASTORE_DATA_END 100
 425
 426 /**
 427  * Message sent by datastore client to remove data.
 428  */
 429 #define GNUNET_MESSAGE_TYPE_DATASTORE_REMOVE 101
 430
 431 /**
 432  * Message sent by datastore client to drop the database.
 433  */
 434 #define GNUNET_MESSAGE_TYPE_DATASTORE_DROP 102
 435
 436
 437 /**
 438  * Message sent by fs client to start indexing.
 439  */
 440 #define GNUNET_MESSAGE_TYPE_FS_INDEX_START 128
 441
 442 /**
 443  * Affirmative response to a request for start indexing.
 444  */
 445 #define GNUNET_MESSAGE_TYPE_FS_INDEX_START_OK 129
 446
 447 /**
 448  * Response to a request for start indexing that
 449  * refuses.
 450  */
 451 #define GNUNET_MESSAGE_TYPE_FS_INDEX_START_FAILED 130
 452
 453 /**
 454  * Request from client for list of indexed files.
 455  */
 456 #define GNUNET_MESSAGE_TYPE_FS_INDEX_LIST_GET 131
 457
 458 /**
 459  * Reply to client with an indexed file name.
 460  */
 461 #define GNUNET_MESSAGE_TYPE_FS_INDEX_LIST_ENTRY 132
 462
 463 /**
 464  * Reply to client indicating end of list.
 465  */
 466 #define GNUNET_MESSAGE_TYPE_FS_INDEX_LIST_END 133
 467
 468 /**
 469  * Request from client to unindex a file.
 470  */
 471 #define GNUNET_MESSAGE_TYPE_FS_UNINDEX 134
 472
 473 /**
 474  * Reply to client indicating unindex receipt.
 475  */
 476 #define GNUNET_MESSAGE_TYPE_FS_UNINDEX_OK 135
 477
 478 /**
 479  * Client asks FS service to start a (keyword) search.
 480  */
 481 #define GNUNET_MESSAGE_TYPE_FS_START_SEARCH 136
 482
 483 /**
 484  * P2P request for content (one FS to another).
 485  */
 486 #define GNUNET_MESSAGE_TYPE_FS_GET 137
 487
 488 /**
 489  * P2P response with content or active migration of content.  Also
 490  * used between the service and clients (in response to START_SEARCH).
 491  */
 492 #define GNUNET_MESSAGE_TYPE_FS_PUT 138
 493
 494
 495 /**
 496  * DHT Message Types
 497  */
 498
 499 /**
 500  * Local and P2P generic DHT message start type
 501  */
 502 #define GNUNET_MESSAGE_TYPE_DHT 142
 503
 504 /**
 505  * Local and P2P generic DHT message stop type
 506  */
 507 #define GNUNET_MESSAGE_TYPE_DHT_STOP 143
 508
 509 /**
 510  * Local and message acknowledgment
 511  */
 512 #define GNUNET_MESSAGE_TYPE_DHT_ACK 144
 513
 514 /**
 515  * Local DHT Put message, from API to service
 516  */
 517 #define GNUNET_MESSAGE_TYPE_DHT_PUT 145
 518
 519 /**
 520  * Local DHT Get message, from API to service
 521  */
 522 #define GNUNET_MESSAGE_TYPE_DHT_GET 146
 523
 524 /**
 525  * Local DHT Get stop message, from API to service
 526  */
 527 #define GNUNET_MESSAGE_TYPE_DHT_GET_STOP 147
 528
 529 /**
 530  * Local DHT Get result message, from service to API
 531  */
 532 #define GNUNET_MESSAGE_TYPE_DHT_GET_RESULT 148
 533
 534 /**
 535  * Local DHT Get message, from API to service
 536  */
 537 #define GNUNET_MESSAGE_TYPE_DHT_FIND_PEER 150
 538
 539 /**
 540  * Local DHT Get stop message, from API to service
 541  */
 542 #define GNUNET_MESSAGE_TYPE_DHT_FIND_PEER_STOP 151
 543
 544 /**
 545  * Local DHT find peer result message, from service to API
 546  */
 547 #define GNUNET_MESSAGE_TYPE_DHT_FIND_PEER_RESULT 152
 548
 549 /**
 550  * Hostlist advertisement message
 551  */
 552 #define GNUNET_MESSAGE_TYPE_HOSTLIST_ADVERTISEMENT 160
 553
 554 /**
 555  * Type used to match 'all' message types.
 556  */
 557 #define GNUNET_MESSAGE_TYPE_ALL 65535
 558
 559 /*
 560   TODO:
 561   - DV
 562   - DHT
 563   - applications (FS, VPN, CHAT, TRACEKIT, TBENCH)
 564 */
 565
 566
 567 #if 0                           /* keep Emacsens' auto-indent happy */
 568 {
 569 #endif
 570 #ifdef __cplusplus
 571 }
 572 #endif
 573
 574 /* ifndef GNUNET_PROTOCOLS_H */
 575 #endif
 576 /* end of gnunet_protocols.h */