summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndrew Bartlett <abartlet@samba.org>2005-10-31 05:45:19 +0000
committerGerald (Jerry) Carter <jerry@samba.org>2007-10-10 13:45:34 -0500
commitceff9881e4c3f8c48c41228a542ee23438b8e28f (patch)
treeb3def0614c10931315ee88139fbe580131c0e948
parent0f44011f6f6e49611ec4a65f6d1dc3b5e8983584 (diff)
downloadsamba-ceff9881e4c3f8c48c41228a542ee23438b8e28f.tar.gz
samba-ceff9881e4c3f8c48c41228a542ee23438b8e28f.tar.bz2
samba-ceff9881e4c3f8c48c41228a542ee23438b8e28f.zip
r11412: These comments may not be much, but my eyes scan code with even
minimal comments much better (much like volker scans code of less than 80 cols better ;-) Andrew Bartlett (This used to be commit 8800e9b5b06701ed1cdf9da0a37291a84eb36f7f)
-rw-r--r--source4/winbind/wb_samba3_cmd.c61
1 files changed, 61 insertions, 0 deletions
diff --git a/source4/winbind/wb_samba3_cmd.c b/source4/winbind/wb_samba3_cmd.c
index 9f4adbdcd0..fd3ce1bf31 100644
--- a/source4/winbind/wb_samba3_cmd.c
+++ b/source4/winbind/wb_samba3_cmd.c
@@ -36,6 +36,10 @@
#include "lib/events/events.h"
#include "librpc/gen_ndr/ndr_netlogon.h"
+/*
+ Send off the reply to an async Samba3 query, handling filling in the PAM, NTSTATUS and string errors.
+*/
+
static void wbsrv_samba3_async_auth_epilogue(NTSTATUS status,
struct wbsrv_samba3_call *s3call)
{
@@ -60,6 +64,10 @@ static void wbsrv_samba3_async_auth_epilogue(NTSTATUS status,
}
}
+/*
+ Send of a generic reply to a Samba3 query
+*/
+
static void wbsrv_samba3_async_epilogue(NTSTATUS status,
struct wbsrv_samba3_call *s3call)
{
@@ -77,6 +85,10 @@ static void wbsrv_samba3_async_epilogue(NTSTATUS status,
}
}
+/*
+ Boilerplate commands, simple queries without network traffic
+*/
+
NTSTATUS wbsrv_samba3_interface_version(struct wbsrv_samba3_call *s3call)
{
s3call->response.result = WINBINDD_OK;
@@ -124,6 +136,11 @@ NTSTATUS wbsrv_samba3_ping(struct wbsrv_samba3_call *s3call)
return NT_STATUS_OK;
}
+/*
+ Validate that we have a working pipe to the domain controller.
+ Return any NT error found in the process
+*/
+
static void checkmachacc_recv_creds(struct composite_context *ctx);
NTSTATUS wbsrv_samba3_check_machacc(struct wbsrv_samba3_call *s3call)
@@ -153,6 +170,11 @@ static void checkmachacc_recv_creds(struct composite_context *ctx)
wbsrv_samba3_async_auth_epilogue(status, s3call);
}
+/*
+ Find the name of a suitable domain controller, by query on the
+ netlogon pipe to the DC.
+*/
+
static void getdcname_recv_dc(struct composite_context *ctx);
NTSTATUS wbsrv_samba3_getdcname(struct wbsrv_samba3_call *s3call)
@@ -191,6 +213,10 @@ static void getdcname_recv_dc(struct composite_context *ctx)
wbsrv_samba3_async_epilogue(status, s3call);
}
+/*
+ Lookup a user's domain groups
+*/
+
static void userdomgroups_recv_groups(struct composite_context *ctx);
NTSTATUS wbsrv_samba3_userdomgroups(struct wbsrv_samba3_call *s3call)
@@ -255,6 +281,9 @@ static void userdomgroups_recv_groups(struct composite_context *ctx)
wbsrv_samba3_async_epilogue(status, s3call);
}
+/*
+ Lookup the list of SIDs for a user
+*/
static void usersids_recv_sids(struct composite_context *ctx);
NTSTATUS wbsrv_samba3_usersids(struct wbsrv_samba3_call *s3call)
@@ -328,6 +357,10 @@ static void usersids_recv_sids(struct composite_context *ctx)
wbsrv_samba3_async_epilogue(status, s3call);
}
+/*
+ Lookup a DOMAIN\\user style name, and return a SID
+*/
+
static void lookupname_recv_sid(struct composite_context *ctx);
NTSTATUS wbsrv_samba3_lookupname(struct wbsrv_samba3_call *s3call)
@@ -370,6 +403,10 @@ static void lookupname_recv_sid(struct composite_context *ctx)
wbsrv_samba3_async_epilogue(status, s3call);
}
+/*
+ Lookup a SID, and return a DOMAIN\\user style name
+*/
+
static void lookupsid_recv_name(struct composite_context *ctx);
NTSTATUS wbsrv_samba3_lookupsid(struct wbsrv_samba3_call *s3call)
@@ -419,6 +456,16 @@ static void lookupsid_recv_name(struct composite_context *ctx)
wbsrv_samba3_async_epilogue(status, s3call);
}
+/*
+ Challenge-response authentication. This interface is used by
+ ntlm_auth and the smbd auth subsystem to pass NTLM authentication
+ requests along a common pipe to the domain controller.
+
+ The return value (in the async reply) may include the 'info3'
+ (effectivly most things you would want to know about the user), or
+ the NT and LM session keys seperated.
+*/
+
static void pam_auth_crap_recv(struct composite_context *ctx);
NTSTATUS wbsrv_samba3_pam_auth_crap(struct wbsrv_samba3_call *s3call)
@@ -491,6 +538,9 @@ static void pam_auth_crap_recv(struct composite_context *ctx)
wbsrv_samba3_async_auth_epilogue(status, s3call);
}
+/* Helper function: Split a domain\\user string into it's parts,
+ * because the client supplies it as one string */
+
static BOOL samba3_parse_domuser(TALLOC_CTX *mem_ctx, const char *domuser,
char **domain, char **user)
{
@@ -509,6 +559,13 @@ static BOOL samba3_parse_domuser(TALLOC_CTX *mem_ctx, const char *domuser,
return ((*domain != NULL) && (*user != NULL));
}
+/* Plaintext authentication
+
+ This interface is used by ntlm_auth in it's 'basic' authentication
+ mode, as well as by pam_winbind to authenticate users where we are
+ given a plaintext password.
+*/
+
static void pam_auth_recv(struct composite_context *ctx);
NTSTATUS wbsrv_samba3_pam_auth(struct wbsrv_samba3_call *s3call)
@@ -547,6 +604,10 @@ static void pam_auth_recv(struct composite_context *ctx)
wbsrv_samba3_async_auth_epilogue(status, s3call);
}
+/*
+ List trusted domains
+*/
+
static void list_trustdom_recv_doms(struct composite_context *ctx);
NTSTATUS wbsrv_samba3_list_trustdom(struct wbsrv_samba3_call *s3call)