aboutsummaryrefslogtreecommitdiff
path: root/src/util/helper.c
diff options
context:
space:
mode:
authorWillow Liquorice <willow@howhill.com>2022-08-31 22:50:00 +0100
committerWillow Liquorice <willow@howhill.com>2022-10-03 00:44:23 +0100
commit4d68c9fedf65188fec95205f39dad447e9b1ae44 (patch)
treed2d0492023380ed67065989bd66ed4dc52f81e2e /src/util/helper.c
parent7b4d69a64e7390e57439c04e1e43e3ca78fc7bbe (diff)
downloadgnunet-4d68c9fedf65188fec95205f39dad447e9b1ae44.tar.gz
gnunet-4d68c9fedf65188fec95205f39dad447e9b1ae44.zip
-DOC: Pass through UTIL libraries (HELPER, MST, NETWORK, OS, PEER)
Diffstat (limited to 'src/util/helper.c')
-rw-r--r--src/util/helper.c46
1 files changed, 0 insertions, 46 deletions
diff --git a/src/util/helper.c b/src/util/helper.c
index 0809c1f17..09d3fffab 100644
--- a/src/util/helper.c
+++ b/src/util/helper.c
@@ -164,15 +164,6 @@ struct GNUNET_HELPER_Handle
164}; 164};
165 165
166 166
167/**
168 * Sends termination signal to the helper process. The helper process is not
169 * reaped; call GNUNET_HELPER_wait() for reaping the dead helper process.
170 *
171 * @param h the helper handle
172 * @param soft_kill if GNUNET_YES, signals termination by closing the helper's
173 * stdin; GNUNET_NO to signal termination by sending SIGTERM to helper
174 * @return #GNUNET_OK on success; #GNUNET_SYSERR on error
175 */
176int 167int
177GNUNET_HELPER_kill (struct GNUNET_HELPER_Handle *h, int soft_kill) 168GNUNET_HELPER_kill (struct GNUNET_HELPER_Handle *h, int soft_kill)
178{ 169{
@@ -213,14 +204,6 @@ GNUNET_HELPER_kill (struct GNUNET_HELPER_Handle *h, int soft_kill)
213} 204}
214 205
215 206
216/**
217 * Reap the helper process. This call is blocking(!). The helper process
218 * should either be sent a termination signal before or should be dead before
219 * calling this function
220 *
221 * @param h the helper handle
222 * @return #GNUNET_OK on success; #GNUNET_SYSERR on error
223 */
224int 207int
225GNUNET_HELPER_wait (struct GNUNET_HELPER_Handle *h) 208GNUNET_HELPER_wait (struct GNUNET_HELPER_Handle *h)
226{ 209{
@@ -475,22 +458,6 @@ restart_task (void *cls)
475} 458}
476 459
477 460
478/**
479 * Starts a helper and begins reading from it. The helper process is
480 * restarted when it dies except when it is stopped using GNUNET_HELPER_stop()
481 * or when the exp_cb callback is not NULL.
482 *
483 * @param with_control_pipe does the helper support the use of a control pipe for signalling?
484 * @param binary_name name of the binary to run
485 * @param binary_argv NULL-terminated list of arguments to give when starting the binary (this
486 * argument must not be modified by the client for
487 * the lifetime of the helper handle)
488 * @param cb function to call if we get messages from the helper
489 * @param exp_cb the exception callback to call. Set this to NULL if the helper
490 * process has to be restarted automatically when it dies/crashes
491 * @param cb_cls closure for the above callback
492 * @return the new Handle, NULL on error
493 */
494struct GNUNET_HELPER_Handle * 461struct GNUNET_HELPER_Handle *
495GNUNET_HELPER_start (int with_control_pipe, 462GNUNET_HELPER_start (int with_control_pipe,
496 const char *binary_name, 463 const char *binary_name,
@@ -644,19 +611,6 @@ helper_write (void *cls)
644} 611}
645 612
646 613
647/**
648 * Send an message to the helper.
649 *
650 * @param h helper to send message to
651 * @param msg message to send
652 * @param can_drop can the message be dropped if there is already one in the queue?
653 * @param cont continuation to run once the message is out (#GNUNET_OK on success, #GNUNET_NO
654 * if the helper process died, #GNUNET_SYSERR during #GNUNET_HELPER_destroy).
655 * @param cont_cls closure for @a cont
656 * @return NULL if the message was dropped,
657 * otherwise handle to cancel *cont* (actual transmission may
658 * not be abortable)
659 */
660struct GNUNET_HELPER_SendHandle * 614struct GNUNET_HELPER_SendHandle *
661GNUNET_HELPER_send (struct GNUNET_HELPER_Handle *h, 615GNUNET_HELPER_send (struct GNUNET_HELPER_Handle *h,
662 const struct GNUNET_MessageHeader *msg, 616 const struct GNUNET_MessageHeader *msg,