File: globus_gridftp_server_embed.h

package info (click to toggle)
globus-gridftp-server 7.11-1~bpo70%2B1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy-backports
  • size: 3,724 kB
  • sloc: ansic: 38,428; sh: 11,604; xml: 509; makefile: 202; perl: 82
file content (124 lines) | stat: -rw-r--r-- 3,708 bytes parent folder | download | duplicates (8)
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