diff options
author | Stefan Metzmacher <metze@samba.org> | 2009-11-05 09:55:12 +0100 |
---|---|---|
committer | Stefan Metzmacher <metze@samba.org> | 2010-01-08 14:36:43 +0100 |
commit | bbaec01b3720fafada13a7143d698f8cd7c0af37 (patch) | |
tree | 6933c2babf7ddf051f695fef76b8ef08396b1efe /libcli/util/tstream.h | |
parent | 1bc953088f2fa2772b1aababb2f3819f5c6de536 (diff) | |
download | samba-bbaec01b3720fafada13a7143d698f8cd7c0af37.tar.gz samba-bbaec01b3720fafada13a7143d698f8cd7c0af37.tar.bz2 samba-bbaec01b3720fafada13a7143d698f8cd7c0af37.zip |
libcli/util: add tstream_read_pdu_blob_send/recv
This will take the some full_request callback function
as the Samba4 packet code.
metze
Diffstat (limited to 'libcli/util/tstream.h')
-rw-r--r-- | libcli/util/tstream.h | 79 |
1 files changed, 79 insertions, 0 deletions
diff --git a/libcli/util/tstream.h b/libcli/util/tstream.h new file mode 100644 index 0000000000..a945287985 --- /dev/null +++ b/libcli/util/tstream.h @@ -0,0 +1,79 @@ +/* + * Unix SMB/CIFS implementation. + * + * Copyright (C) Stefan Metzmacher 2009 + * + * 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/>. + */ + +#ifndef _LIBCLI_UTIL_TSTREAM_H_ +#define _LIBCLI_UTIL_TSTREAM_H_ + +/** + * @brief A helper function to read a full PDU from a stream + * + * This function is designed for simple PDUs and as compat layer + * for the Samba4 packet interface. + * + * tstream_readv_pdu_send() is a more powerful interface, + * which is part of the main (non samba specific) tsocket code. + * + * @param[in] mem_ctx The memory context for the result. + * + * @param[in] ev The event context the operation should work on. + * + * @param[in] stream The stream to read data from. + * + * @param[in] inital_read_size The initial byte count that is needed to workout + * the full pdu size. + * + * @param[in] full_fn The callback function that will report the size + * of the full pdu. + * + * @param[in] full_private The private data for the callback function. + * + * @return The async request handle. NULL on fatal error. + * + * @see tstream_read_pdu_blob_recv() + * @see tstream_readv_pdu_send() + * @see tstream_readv_pdu_queue_send() + * + */ +struct tevent_req *tstream_read_pdu_blob_send(TALLOC_CTX *mem_ctx, + struct tevent_context *ev, + struct tstream_context *stream, + size_t inital_read_size, + NTSTATUS (*full_fn)(void *private_data, + DATA_BLOB blob, + size_t *packet_size), + void *full_private); +/** + * @brief Receive the result of the tstream_read_pdu_blob_send() call. + * + * @param[in] req The tevent request from tstream_read_pdu_blob_send(). + * + * @param[in] mem_ctx The memory context for returned pdu DATA_BLOB. + * + * @param[in] pdu_blob The DATA_BLOB with the full pdu. + * + * @return The NTSTATUS result, NT_STATUS_OK on success + * and others on failure. + * + * @see tstream_read_pdu_blob_send() + */ +NTSTATUS tstream_read_pdu_blob_recv(struct tevent_req *req, + TALLOC_CTX *mem_ctx, + DATA_BLOB *pdu_blob); + +#endif /* _LIBCLI_UTIL_TSTREAM_H_ */ |