1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
/*
This file is part of GNUnet
(C) 2009 Christian Grothoff (and other contributing authors)
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
by the Free Software Foundation; either version 3, or (at your
option) any later version.
GNUnet is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNUnet; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
/**
* @file include/gnunet_arm_service.h
* @brief API to access gnunet-arm
* @author Christian Grothoff
*/
#ifndef GNUNET_ARM_SERVICE_H
#define GNUNET_ARM_SERVICE_H
#ifdef __cplusplus
extern "C"
{
#if 0 /* keep Emacsens' auto-indent happy */
}
#endif
#endif
#include "gnunet_configuration_lib.h"
#include "gnunet_scheduler_lib.h"
#include "gnunet_time_lib.h"
/**
* Version of the arm API.
*/
#define GNUNET_ARM_VERSION 0x00000000
/**
* Callback function invoked when operation is complete.
*
* @param cls closure
* @param success GNUNET_YES if we think the service is running
* GNUNET_NO if we think the service is stopped
* GNUNET_SYSERR if we think ARM was not running or
* if the service status is unknown
*/
typedef void (*GNUNET_ARM_Callback) (void *cls, int success);
/**
* Handle for interacting with ARM.
*/
struct GNUNET_ARM_Handle;
/**
* Setup a context for communicating with ARM. Note that this
* can be done even if the ARM service is not yet running.
*
* @param cfg configuration to use (needed to contact ARM;
* the ARM service may internally use a different
* configuration to determine how to start the service).
* @param service service that *this* process is implementing/providing, can be NULL
* @return context to use for further ARM operations, NULL on error
*/
struct GNUNET_ARM_Handle *GNUNET_ARM_connect (const struct
GNUNET_CONFIGURATION_Handle *cfg,
const char *service);
/**
* Disconnect from the ARM service.
*
* @param h the handle that was being used
*/
void GNUNET_ARM_disconnect (struct GNUNET_ARM_Handle *h);
/**
* Start a service. Note that this function merely asks ARM to start
* the service and that ARM merely confirms that it forked the
* respective process. The specified callback may thus return before
* the service has started to listen on the server socket and it may
* also be that the service has crashed in the meantime. Clients
* should repeatedly try to connect to the service at the respective
* port (with some delays in between) before assuming that the service
* actually failed to start. Note that if an error is returned to the
* callback, clients obviously should not bother with trying to
* contact the service.
*
* @param h handle to ARM
* @param service_name name of the service
* @param timeout how long to wait before failing for good
* @param cb callback to invoke when service is ready
* @param cb_cls closure for callback
*/
void
GNUNET_ARM_start_service (struct GNUNET_ARM_Handle *h,
const char *service_name,
struct GNUNET_TIME_Relative timeout,
GNUNET_ARM_Callback cb, void *cb_cls);
/**
* Stop a service. Note that the callback is invoked as soon
* as ARM confirms that it will ask the service to terminate.
* The actual termination may still take some time.
*
* @param h handle to ARM
* @param service_name name of the service
* @param timeout how long to wait before failing for good
* @param cb callback to invoke when service is ready
* @param cb_cls closure for callback
*/
void
GNUNET_ARM_stop_service (struct GNUNET_ARM_Handle *h,
const char *service_name,
struct GNUNET_TIME_Relative timeout,
GNUNET_ARM_Callback cb, void *cb_cls);
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif
#endif
|
