/* 

   Unix SMB/CIFS implementation.

   DATA BLOB

   This program 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.

   This program 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, see <http://www.gnu.org/licenses/>.

*/

/* This is a public header file that is installed as part of Samba. 

 * If you remove any functions or change their signature, update 

 * the so version number. */

#ifndef _SAMBA_DATABLOB_H_

#define _SAMBA_DATABLOB_H_

#include <talloc.h>

#include <stdint.h>

/* used to hold an arbitrary blob of data */

typedef struct datablob {

	uint8_t *data;

	size_t length;

} DATA_BLOB;

struct data_blob_list_item {

	struct data_blob_list_item *prev,*next;

	DATA_BLOB blob;

};

/* by making struct ldb_val and DATA_BLOB the same, we can simplify

   a fair bit of code */

#define ldb_val datablob

#define data_blob(ptr, size) data_blob_named(ptr, size, "DATA_BLOB: "__location__)

#define data_blob_talloc(ctx, ptr, size) data_blob_talloc_named(ctx, ptr, size, "DATA_BLOB: "__location__)

#define data_blob_dup_talloc(ctx, blob) data_blob_talloc_named(ctx, (blob)->data, (blob)->length, "DATA_BLOB: "__location__)

/**

 construct a data blob, must be freed with data_blob_free()

 you can pass NULL for p and get a blank data blob

**/

DATA_BLOB data_blob_named(const void *p, size_t length, const char *name);

/**

 construct a data blob, using supplied TALLOC_CTX

**/

DATA_BLOB data_blob_talloc_named(TALLOC_CTX *mem_ctx, const void *p, size_t length, const char *name);

/**

free a data blob

**/

void data_blob_free(DATA_BLOB *d);

extern const DATA_BLOB data_blob_null;

#endif /* _SAMBA_DATABLOB_H_ */