doubango/trunk/tinyHTTP/include/tinyHTTP/headers/thttp_header_WWW_Authentica...

91 lines
3.1 KiB
C

/*
* Copyright (C) 2009 Mamadou Diop.
*
* Contact: Mamadou Diop <diopmamadou@yahoo.fr>
*
* This file is part of Open Source Doubango Framework.
*
* DOUBANGO 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 3 of the License, or
* (at your option) any later version.
*
* DOUBANGO 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 DOUBANGO.
*
*/
/**@file thttp_header_WWW_Authenticate.h
* @brief HTTP header 'WWW-Authenticate'.
*
* @author Mamadou Diop <diopmamadou(at)yahoo.fr>
*
* @date Created: Sat Nov 8 16:54:58 2009 mdiop
*/
#ifndef _THTTP_HEADER_WWW_Authenticate_H_
#define _THTTP_HEADER_WWW_Authenticate_H_
#include "tinyhttp_config.h"
#include "tinyhttp/headers/thttp_header.h"
THTTP_BEGIN_DECLS
/**@def THTTP_HEADER_WWW_AUTHENTICATE_CREATE
* Creates new http 'WWW-AUTHENTICATE' header. You must call @ref TSK_OBJECT_SAFE_FREE to free the header.
* @sa TSK_OBJECT_SAFE_FREE.
*/
#define THTTP_HEADER_WWW_AUTHENTICATE_CREATE() tsk_object_new(thttp_header_WWW_Authenticate_def_t)
////////////////////////////////////////////////////////////////////////////////////////////////////
/// @struct
///
/// @brief HTTP header 'WWW-Authenticate'.
/// @author Mamadou
/// @date 12/3/2009
///
/// @par ABNF = WWW-Authenticate = "WWW-Authenticate" HCOLON challenge
/// challenge = ("Digest" LWS digest-cln *(COMMA digest-cln)) / other-challenge
/// other-challenge = auth-scheme / auth-param *(COMMA auth-param)
/// digest-cln = realm / domain / nonce / opaque / stale / algorithm / qop-options / auth-param
/// realm = "realm" EQUAL realm-value
/// realm-value = quoted-string
/// domain = "domain" EQUAL LDQUOT URI *( 1*SP URI ) RDQUOT
/// URI = absoluteURI / abs-path
/// opaque = "opaque" EQUAL quoted-string
/// stale = "stale" EQUAL ( "true" / "false" )
/// qop-options = "qop" EQUAL LDQUOT qop-value *("," qop-value) RDQUOT
/// qop-value = "auth" / "auth-int" / token
///
////////////////////////////////////////////////////////////////////////////////////////////////////
typedef struct thttp_header_WWW_Authenticate_s
{
THTTP_DECLARE_HEADER;
char* scheme;
char* realm;
char* domain;
char* nonce;
char* opaque;
unsigned stale:1;
char* algorithm;
char* qop;
}
thttp_header_WWW_Authenticate_t;
typedef thttp_header_WWW_Authenticate_t thttp_header_Proxy_Authenticate_t;
TINYHTTP_API thttp_header_WWW_Authenticate_t *thttp_header_WWW_Authenticate_parse(const char *data, size_t size);
TINYHTTP_API thttp_header_Proxy_Authenticate_t *thttp_header_Proxy_Authenticate_parse(const char *data, size_t size);
TINYHTTP_GEXTERN const void *thttp_header_WWW_Authenticate_def_t;
THTTP_END_DECLS
#endif /* _THTTP_HEADER_WWW_Authenticate_H_ */