/build/globus-connect-gridftp-server-17.0~b1/globus_i_gfs_acl.h

/*
 * Copyright The University of Chicago
 *
 * All Rights Reserved.
 */
 
#ifndef GLOBUS_I_GFS_ACL_H
#define GLOBUS_I_GFS_ACL_H
 
struct globus_i_gfs_acl_handle_s;
 
typedef enum globus_l_gfs_acl_type_e
{
    GLOBUS_L_GFS_ACL_TYPE_INIT,
    GLOBUS_L_GFS_ACL_TYPE_AUTHORIZE
} globus_i_gfs_acl_type_t;
 
/* keep some legacy actions internal only; no current use case */
enum globus_i_gfs_acl_action_internal_e 
{
    /* internal use only */
    GFS_ACL_ACTION_INIT = 100,
    /* speficy an authorization assertion.  client may submit data to 
     * influence future authorization decisions.  data is in an unspecified
     * format. */
    GFS_ACL_ACTION_AUTHZ_ASSERT,
    /* report data safely written to disk.  failure means data written has
     * overrun acceptable limits. */
    GFS_ACL_ACTION_COMMIT,
    /* increase previously requested write limits for an object */
    GFS_ACL_ACTION_GROW
    /* the named object. will be deleted. */
};
 
/* object descriptor.  this provides various info about the object of the
 * action attempt. */
typedef struct globus_i_gfs_acl_object_desc_s
{
    /* ALL: name of the object.  commonly a filename.
     * value is NULL when not known or not used. */
    char *                              name;
 
    /* WRITE/CREATE: size being requested to write.
     * COMMIT: amount of data already written safely.
     * GROW: new full size being requested to write.
     * value is 0 when not known or not used. */
    globus_off_t                        size;
 
    /* AUTHZ_ASSERT: assertion data from the client.
     * value is NULL when not known or not used. */
    char *                              data;
 
    /* COMMIT: all data has been safely written
     * value is FALSE when not known or not used. */
    globus_bool_t                       final;
 
    globus_gfs_op_info_t                op_info;
} globus_i_gfs_acl_object_desc_t;
 
typedef void
(*globus_gfs_acl_cb_t)(
    globus_i_gfs_acl_object_desc_t *    object,
    int                                 action,
    void *                              user_arg,
    globus_result_t                     result);
 
typedef globus_result_t
(*globus_gfs_acl_info_cb_t)(
    void *                              info_arg,
    int                                 info,
    va_list                             ap);
 
void
globus_i_gfs_acl_add_module(
    globus_gfs_acl_module_t *           module);
 
int
globus_i_gfs_acl_authorize(
    struct globus_i_gfs_acl_handle_s *  acl_handle,
    int                                 action,
    globus_i_gfs_acl_object_desc_t *    object,
    globus_result_t *                   out_res,
    globus_gfs_acl_cb_t                 cb,
    void *                              user_arg);
 
int
globus_i_gfs_acl_init(
    struct globus_i_gfs_acl_handle_s *  acl_handle,
    globus_result_t *                   out_res,
    globus_gfs_acl_cb_t                 cb,
    void *                              user_arg,
    globus_gfs_acl_info_cb_t            info_cb,
    void *                              info_arg);
 
void
globus_i_gfs_acl_destroy(
    struct globus_i_gfs_acl_handle_s *  acl_handle);
 
typedef struct globus_i_gfs_acl_handle_s
{
    char *                              password;
    char *                              ipaddr;
    globus_i_gfs_acl_type_t             type;
    char *                              subject;
    char *                              username;
    char *                              hostname;
    globus_gfs_acl_cb_t                 cb;
    void *                              user_arg;
    globus_gfs_acl_info_cb_t            info_cb;
    void *                              info_arg;
    globus_list_t *                     module_list;
    globus_list_t *                     current_list;
    globus_result_t                     cached_res;
    gss_ctx_id_t                        context;
    int                                 auth_action;
    globus_i_gfs_acl_object_desc_t      auth_object;
} globus_i_gfs_acl_handle_t;
 
 
 
#endif