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
|
/*
* Copyright 1999-2014 University of Chicago
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#if !defined(GLOBUS_GRIDFTP_SERVER_EMBED_H)
#define GLOBUS_GRIDFTP_SERVER_EMBED_H 1
#include "globus_gridftp_server.h"
typedef struct globus_l_gfs_embed_handle_s * globus_gfs_embed_handle_t;
/* events.
* XXX should possibly add some generic way to get useful info for
* for an event.
*/
typedef enum
{
GLOBUS_GFS_EMBED_EVENT_CONNECTION_CLOSED = 1,
GLOBUS_GFS_EMBED_EVENT_CONNECTION_OPENED,
GLOBUS_GFS_EMBED_EVENT_STOPPED
} globus_gfs_embed_event_t;
typedef globus_bool_t
(*globus_gfs_embed_event_cb_t)(
globus_gfs_embed_handle_t handle,
globus_result_t result,
globus_gfs_embed_event_t event,
void * user_arg);
/*
* init the handle. args[] is a NULL terminated argv-type array filled with
* command line parameters, may be NULL. Start at args[1].
* eg: args = {"not used", "-p", "5000", NULL}
*/
globus_result_t
globus_gridftp_server_embed_init(
globus_gfs_embed_handle_t * handle,
char * args[]);
/*
* destroy the handle. if server has been started, should only be called
* after the STOPPED event has been triggered.
*/
void
globus_gridftp_server_embed_destroy(
globus_gfs_embed_handle_t handle);
/*
* set a config parameter. use _int or _ptr as appropriate for
* the parameter.
*/
void
globus_gridftp_server_embed_config_set_int(
globus_gfs_embed_handle_t handle,
char * option_name,
int int_value);
void
globus_gridftp_server_embed_config_set_ptr(
globus_gfs_embed_handle_t handle,
char * option_name,
void * ptr_value);
/*
* config query functions.
*/
#define globus_gridftp_server_embed_config_get_list \
(globus_list_t *) globus_gridftp_server_embed_config_get_ptr
#define globus_gridftp_server_embed_config_get_string \
(char *) globus_gridftp_server_embed_config_get_ptr
#define globus_gridftp_server_embed_config_get_bool \
(globus_bool_t) globus_gridftp_server_embed_config_get_int
void *
globus_gridftp_server_embed_config_get_ptr(
globus_gfs_embed_handle_t handle,
const char * option_name);
int
globus_gridftp_server_embed_config_get_int(
globus_gfs_embed_handle_t handle,
const char * option_name);
/*
* start up an embedded gridftp server
*
*/
globus_result_t
globus_gridftp_server_embed_start(
globus_gfs_embed_handle_t handle,
globus_gfs_embed_event_cb_t event_cb,
void * user_arg);
/*
* stop the running embedded server. calling this function will start
* the processes of shutting down the embedded server. When it is
* completely shut down the event callback will be called with
* the GLOBUS_GRIDFTP_SERVER_EMEB_EVENT_STOPPED event.
*/
void
globus_gridftp_server_embed_stop(
globus_gfs_embed_handle_t handle);
#endif
|