wmi-1.3.16 from opsview.com
This commit is contained in:
@@ -0,0 +1,202 @@
|
||||
/*
|
||||
Unix SMB/CIFS implementation.
|
||||
|
||||
Copyright (C) Andrew Tridgell 2005
|
||||
|
||||
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 2 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, write to the Free Software
|
||||
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||||
*/
|
||||
/*
|
||||
composite API helper functions
|
||||
*/
|
||||
|
||||
#include "includes.h"
|
||||
#include "lib/events/events.h"
|
||||
#include "libcli/raw/libcliraw.h"
|
||||
#include "libcli/smb2/smb2.h"
|
||||
#include "libcli/composite/composite.h"
|
||||
#include "lib/messaging/irpc.h"
|
||||
#include "librpc/rpc/dcerpc.h"
|
||||
#include "libcli/nbt/libnbt.h"
|
||||
|
||||
/*
|
||||
create a new composite_context structure
|
||||
and initialize it
|
||||
*/
|
||||
_PUBLIC_ struct composite_context *composite_create(TALLOC_CTX *mem_ctx,
|
||||
struct event_context *ev)
|
||||
{
|
||||
struct composite_context *c;
|
||||
|
||||
c = talloc_zero(mem_ctx, struct composite_context);
|
||||
if (!c) return NULL;
|
||||
c->state = COMPOSITE_STATE_IN_PROGRESS;
|
||||
c->event_ctx = ev;
|
||||
|
||||
return c;
|
||||
}
|
||||
|
||||
/*
|
||||
block until a composite function has completed, then return the status
|
||||
*/
|
||||
_PUBLIC_ NTSTATUS composite_wait(struct composite_context *c)
|
||||
{
|
||||
if (c == NULL) return NT_STATUS_NO_MEMORY;
|
||||
|
||||
c->used_wait = True;
|
||||
|
||||
while (c->state < COMPOSITE_STATE_DONE) {
|
||||
if (event_loop_once(c->event_ctx) != 0) {
|
||||
return NT_STATUS_UNSUCCESSFUL;
|
||||
}
|
||||
}
|
||||
|
||||
return c->status;
|
||||
}
|
||||
|
||||
|
||||
/*
|
||||
* Some composite helpers that are handy if you write larger composite
|
||||
* functions.
|
||||
*/
|
||||
_PUBLIC_ BOOL composite_is_ok(struct composite_context *ctx)
|
||||
{
|
||||
if (NT_STATUS_IS_OK(ctx->status)) {
|
||||
return True;
|
||||
}
|
||||
ctx->state = COMPOSITE_STATE_ERROR;
|
||||
if (ctx->async.fn != NULL) {
|
||||
ctx->async.fn(ctx);
|
||||
}
|
||||
return False;
|
||||
}
|
||||
|
||||
/*
|
||||
callback from composite_done() and composite_error()
|
||||
|
||||
this is used to allow for a composite function to complete without
|
||||
going through any state transitions. When that happens the caller
|
||||
has had no opportunity to fill in the async callback fields
|
||||
(ctx->async.fn and ctx->async.private) which means the usual way of
|
||||
dealing with composite functions doesn't work. To cope with this,
|
||||
we trigger a timer event that will happen then the event loop is
|
||||
re-entered. This gives the caller a chance to setup the callback,
|
||||
and allows the caller to ignore the fact that the composite
|
||||
function completed early
|
||||
*/
|
||||
static void composite_trigger(struct event_context *ev, struct timed_event *te,
|
||||
struct timeval t, void *ptr)
|
||||
{
|
||||
struct composite_context *c = talloc_get_type(ptr, struct composite_context);
|
||||
if (c->async.fn) {
|
||||
c->async.fn(c);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
_PUBLIC_ void composite_error(struct composite_context *ctx, NTSTATUS status)
|
||||
{
|
||||
if (!ctx->used_wait && !ctx->async.fn) {
|
||||
event_add_timed(ctx->event_ctx, ctx, timeval_zero(), composite_trigger, ctx);
|
||||
}
|
||||
ctx->status = status;
|
||||
SMB_ASSERT(!composite_is_ok(ctx));
|
||||
}
|
||||
|
||||
_PUBLIC_ BOOL composite_nomem(const void *p, struct composite_context *ctx)
|
||||
{
|
||||
if (p != NULL) {
|
||||
return False;
|
||||
}
|
||||
composite_error(ctx, NT_STATUS_NO_MEMORY);
|
||||
return True;
|
||||
}
|
||||
|
||||
_PUBLIC_ void composite_done(struct composite_context *ctx)
|
||||
{
|
||||
if (!ctx->used_wait && !ctx->async.fn) {
|
||||
event_add_timed(ctx->event_ctx, ctx, timeval_zero(), composite_trigger, ctx);
|
||||
}
|
||||
ctx->state = COMPOSITE_STATE_DONE;
|
||||
if (ctx->async.fn != NULL) {
|
||||
ctx->async.fn(ctx);
|
||||
}
|
||||
}
|
||||
|
||||
_PUBLIC_ void composite_continue(struct composite_context *ctx,
|
||||
struct composite_context *new_ctx,
|
||||
void (*continuation)(struct composite_context *),
|
||||
void *private_data)
|
||||
{
|
||||
if (composite_nomem(new_ctx, ctx)) return;
|
||||
new_ctx->async.fn = continuation;
|
||||
new_ctx->async.private_data = private_data;
|
||||
|
||||
/* if we are setting up a continuation, and the context has
|
||||
already finished, then we should run the callback with an
|
||||
immediate event, otherwise we can be stuck forever */
|
||||
if (new_ctx->state >= COMPOSITE_STATE_DONE && continuation) {
|
||||
event_add_timed(new_ctx->event_ctx, new_ctx, timeval_zero(), composite_trigger, new_ctx);
|
||||
}
|
||||
}
|
||||
|
||||
_PUBLIC_ void composite_continue_rpc(struct composite_context *ctx,
|
||||
struct rpc_request *new_req,
|
||||
void (*continuation)(struct rpc_request *),
|
||||
void *private_data)
|
||||
{
|
||||
if (composite_nomem(new_req, ctx)) return;
|
||||
new_req->async.callback = continuation;
|
||||
new_req->async.private = private_data;
|
||||
}
|
||||
|
||||
_PUBLIC_ void composite_continue_irpc(struct composite_context *ctx,
|
||||
struct irpc_request *new_req,
|
||||
void (*continuation)(struct irpc_request *),
|
||||
void *private_data)
|
||||
{
|
||||
if (composite_nomem(new_req, ctx)) return;
|
||||
new_req->async.fn = continuation;
|
||||
new_req->async.private = private_data;
|
||||
}
|
||||
|
||||
_PUBLIC_ void composite_continue_smb(struct composite_context *ctx,
|
||||
struct smbcli_request *new_req,
|
||||
void (*continuation)(struct smbcli_request *),
|
||||
void *private_data)
|
||||
{
|
||||
if (composite_nomem(new_req, ctx)) return;
|
||||
new_req->async.fn = continuation;
|
||||
new_req->async.private = private_data;
|
||||
}
|
||||
|
||||
_PUBLIC_ void composite_continue_smb2(struct composite_context *ctx,
|
||||
struct smb2_request *new_req,
|
||||
void (*continuation)(struct smb2_request *),
|
||||
void *private_data)
|
||||
{
|
||||
if (composite_nomem(new_req, ctx)) return;
|
||||
new_req->async.fn = continuation;
|
||||
new_req->async.private = private_data;
|
||||
}
|
||||
|
||||
_PUBLIC_ void composite_continue_nbt(struct composite_context *ctx,
|
||||
struct nbt_name_request *new_req,
|
||||
void (*continuation)(struct nbt_name_request *),
|
||||
void *private_data)
|
||||
{
|
||||
if (composite_nomem(new_req, ctx)) return;
|
||||
new_req->async.fn = continuation;
|
||||
new_req->async.private = private_data;
|
||||
}
|
||||
@@ -0,0 +1,72 @@
|
||||
/*
|
||||
Unix SMB/CIFS implementation.
|
||||
|
||||
composite request interfaces
|
||||
|
||||
Copyright (C) Andrew Tridgell 2005
|
||||
|
||||
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 2 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, write to the Free Software
|
||||
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||||
*/
|
||||
|
||||
#include "libcli/raw/interfaces.h"
|
||||
|
||||
/*
|
||||
this defines the structures associated with "composite"
|
||||
requests. Composite requests are libcli requests that are internally
|
||||
implemented as multiple async calls, but can be treated as a
|
||||
single call via these composite calls. The composite calls are
|
||||
particularly designed to be used in async applications.
|
||||
you can also stack multiple level of composite call
|
||||
*/
|
||||
|
||||
/*
|
||||
a composite call moves between the following 3 states.
|
||||
*/
|
||||
enum composite_state { COMPOSITE_STATE_INIT, /* we are creating the request */
|
||||
COMPOSITE_STATE_IN_PROGRESS, /* the request is in the outgoing socket Q */
|
||||
COMPOSITE_STATE_DONE, /* the request is received by the caller finished */
|
||||
COMPOSITE_STATE_ERROR }; /* a packet or transport level error has occurred */
|
||||
|
||||
/* the context of one "composite" call */
|
||||
struct composite_context {
|
||||
/* the external state - will be queried by the caller */
|
||||
enum composite_state state;
|
||||
|
||||
/* a private pointer for use by the composite function
|
||||
implementation */
|
||||
void *private_data;
|
||||
|
||||
/* status code when finished */
|
||||
NTSTATUS status;
|
||||
|
||||
/* the event context we are using */
|
||||
struct event_context *event_ctx;
|
||||
|
||||
/* information on what to do on completion */
|
||||
struct {
|
||||
void (*fn)(struct composite_context *);
|
||||
void *private_data;
|
||||
} async;
|
||||
|
||||
BOOL used_wait;
|
||||
};
|
||||
|
||||
struct irpc_request;
|
||||
struct smbcli_request;
|
||||
struct smb2_request;
|
||||
struct rpc_request;
|
||||
struct nbt_name_request;
|
||||
|
||||
#include "libcli/composite/proto.h"
|
||||
Reference in New Issue
Block a user