lib/xcap/xcap_client.h

/* 
 * Copyright (C) 2005 iptelorg GmbH
 *
 * This file is part of ser, a free SIP server.
 *
 * ser 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 2 of the License, or
 * (at your option) any later version
 *
 * For a license to use the ser software under conditions
 * other than those described here, or to purchase support for this
 * software, please contact iptel.org by e-mail at the following addresses:
 *    info@iptel.org
 *
 * ser 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 this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

#ifndef __XCAP_CLIENT_H
#define __XCAP_CLIENT_H

#include <cds/sstr.h>
#include <xcap/xcap_result_codes.h>

typedef struct {
        /* "prefix" for XCAP query */
        str_t xcap_root;
        str_t auth_user;
        str_t auth_pass;
        int enable_unverified_ssl_peer;
} xcap_query_params_t;

typedef enum {
        xcap_doc_pres_rules,
        xcap_doc_im_rules,
        xcap_doc_rls_services,
        xcap_doc_resource_lists
} xcap_document_type_t;

char *xcap_uri_for_users_document(xcap_document_type_t doc_type,
                const str_t *username, 
                const str_t*filename,
                xcap_query_params_t *params);

char *xcap_uri_for_global_document(xcap_document_type_t doc_type,
                const str_t *filename,
                xcap_query_params_t *params);

/* URI is absolute HTTP/HTTPS uri for the query  */
int xcap_query(const char *uri, xcap_query_params_t *params, 
                char **buf, int *bsize);

typedef int (*xcap_query_func)(const char *uri, 
                xcap_query_params_t *params, 
                char **buf, int *bsize);

void free_xcap_params_content(xcap_query_params_t *params);
int dup_xcap_params(xcap_query_params_t *dst, xcap_query_params_t *src);

/* counts the length for data buffer storing values of
 * xcap parameter members */
int get_inline_xcap_buf_len(xcap_query_params_t *params);

/* copies structure into existing buffer */
int dup_xcap_params_inline(xcap_query_params_t *dst, xcap_query_params_t *src, char *data_buffer);

int str2xcap_params(xcap_query_params_t *dst, const str_t *src);
int xcap_params2str(str_t *dst, xcap_query_params_t *src);

#endif