- don't add own id to pull_list
[oweals/gnunet.git] / src / rps / rps.h
1 /*
2       This file is part of GNUnet
3       Copyright (C) 2012-2013 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 3, 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  * @file rps/rps.h
22  * @brief example IPC messages between RPS API and GNS service
23  * @author Julius Bünger
24  */
25
26 #include "gnunet_rps_service.h"
27
28 /**
29  * Mesh port used by RPS.
30  */
31 #define GNUNET_RPS_CADET_PORT 31337
32
33
34 GNUNET_NETWORK_STRUCT_BEGIN
35
36 /***********************************************************************
37  * P2P Messages
38 ***********************************************************************/
39
40 /**
41  * P2P Message to send PeerIDs to other peer.
42  */
43 struct GNUNET_RPS_P2P_PullReplyMessage
44 {
45   /**
46    * Header including size and type in NBO
47    */
48   struct GNUNET_MessageHeader header;
49
50   /**
51    * Number of PeerIDs sent
52    */
53   uint32_t num_peers GNUNET_PACKED;
54
55   /* Followed by num_peers * GNUNET_PeerIdentity */
56 };
57
58
59
60 /***********************************************************************
61  * Client-Service Messages
62 ***********************************************************************/
63
64 /**
65  * Message from client to RPS service to request random peer(s).
66  */
67 struct GNUNET_RPS_CS_RequestMessage
68 {
69   /**
70    * Header including size and type in NBO
71    */
72   struct GNUNET_MessageHeader header;
73
74   /**
75    * Number of random peer requested
76    */
77   uint32_t num_peers GNUNET_PACKED; 
78
79   /**
80    * Identifyer of the message.
81    */
82   uint64_t n GNUNET_PACKED;
83
84 };
85
86 /**
87  * Message from RPS service to client to reply with random peer(s).
88  */
89 struct GNUNET_RPS_CS_ReplyMessage
90 {
91   /**
92    * Type is #GNUNET_MESSAGE_TYPE_RPS_CS_REPLY.
93    */
94   struct GNUNET_MessageHeader header;
95
96   /**
97    * Identifyer of the message.
98    */
99   uint64_t n;
100
101   /**
102    * Number of random peer replied
103    */
104   uint64_t num_peers GNUNET_PACKED;
105
106   /* Followed by num_peers * GNUNET_PeerIdentity */
107 };
108
109 /**
110  * Message from client to service with seed of peers
111  */
112 struct GNUNET_RPS_CS_SeedMessage
113 {
114   /**
115    * Header including size and type in NBO
116    */
117   struct GNUNET_MessageHeader header;
118
119   /**
120    * Number of peers
121    */
122   uint64_t num_peers;
123
124   /* Followed by num_peers * GNUNET_PeerIdentity */
125 };
126
127 GNUNET_NETWORK_STRUCT_END