diff options
| author | Rafal Szczesniak <mimir@samba.org> | 2005-02-06 23:06:27 +0000 |
|---|---|---|
| committer | Gerald (Jerry) Carter <jerry@samba.org> | 2007-10-10 13:09:35 -0500 |
| commit | f0b403f27a59306b0b463e48f02a5d705fe37d26 (patch) | |
| tree | d6c0e02e69ff2b5b73cfee174b964e24bd80f80d | |
| parent | dfe907313b911b94dce2a3b0f7c77746d5c04870 (diff) | |
| download | samba-f0b403f27a59306b0b463e48f02a5d705fe37d26.tar.gz samba-f0b403f27a59306b0b463e48f02a5d705fe37d26.tar.bz2 samba-f0b403f27a59306b0b463e48f02a5d705fe37d26.zip | |
r5256: More verbose description of functions (as I learn the code).
rafal
(This used to be commit 38ac6b8d570fa02bc32899521d42ba7237f77024)
| -rw-r--r-- | source4/libnet/libnet_rpc.c | 54 |
1 files changed, 49 insertions, 5 deletions
diff --git a/source4/libnet/libnet_rpc.c b/source4/libnet/libnet_rpc.c index 1f546d89a4..48f5e345f4 100644 --- a/source4/libnet/libnet_rpc.c +++ b/source4/libnet/libnet_rpc.c @@ -22,7 +22,15 @@ #include "libcli/nbt/libnbt.h" #include "libnet/libnet.h" -/* find a domain pdc generic */ +/** + * Finds a domain pdc (generic part) + * + * @param ctx initialised libnet context + * @param mem_ctx memory context of this call + * @param r data structure containing necessary parameters and return values + * @return nt status of the call + **/ + static NTSTATUS libnet_find_pdc_generic(struct libnet_context *ctx, TALLOC_CTX *mem_ctx, union libnet_find_pdc *r) { @@ -51,7 +59,16 @@ static NTSTATUS libnet_find_pdc_generic(struct libnet_context *ctx, TALLOC_CTX * return NT_STATUS_OK; } -/* find a domain pdc */ + +/** + * Finds a domain pdc function + * + * @param ctx initialised libnet context + * @param mem_ctx memory context of this call + * @param r data structure containing necessary parameters and return values + * @return nt status of the call + **/ + NTSTATUS libnet_find_pdc(struct libnet_context *ctx, TALLOC_CTX *mem_ctx, union libnet_find_pdc *r) { switch (r->generic.level) { @@ -62,7 +79,16 @@ NTSTATUS libnet_find_pdc(struct libnet_context *ctx, TALLOC_CTX *mem_ctx, union return NT_STATUS_INVALID_LEVEL; } -/* connect to a dcerpc interface of a server */ + +/** + * Connects rpc pipe on remote server + * + * @param ctx initialised libnet context + * @param mem_ctx memory context of this call + * @param r data structure containing necessary parameters and return values + * @return nt status of the call + **/ + static NTSTATUS libnet_rpc_connect_standard(struct libnet_context *ctx, TALLOC_CTX *mem_ctx, union libnet_rpc_connect *r) { NTSTATUS status; @@ -90,7 +116,16 @@ static NTSTATUS libnet_rpc_connect_standard(struct libnet_context *ctx, TALLOC_C return status; } -/* connect to a dcerpc interface of a time server */ + +/** + * Connects rpc pipe on domain pdc + * + * @param ctx initialised libnet context + * @param mem_ctx memory context of this call + * @param r data structure containing necessary parameters and return values + * @return nt status of the call + **/ + static NTSTATUS libnet_rpc_connect_pdc(struct libnet_context *ctx, TALLOC_CTX *mem_ctx, union libnet_rpc_connect *r) { NTSTATUS status; @@ -119,7 +154,16 @@ static NTSTATUS libnet_rpc_connect_pdc(struct libnet_context *ctx, TALLOC_CTX *m return status; } -/* connect to a dcerpc interface */ + +/** + * Connects to rpc pipe on remote server or pdc + * + * @param ctx initialised libnet context + * @param mem_ctx memory context of this call + * @param r data structure containing necessary parameters and return values + * @return nt status of the call + **/ + NTSTATUS libnet_rpc_connect(struct libnet_context *ctx, TALLOC_CTX *mem_ctx, union libnet_rpc_connect *r) { switch (r->standard.level) { |