summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndrew Bartlett <abartlet@samba.org>2008-04-24 13:30:36 +0100
committerAndrew Bartlett <abartlet@samba.org>2008-04-24 13:30:36 +0100
commited5ddabc43c484fe6eca3bd4b0cc22eb5aa9a33a (patch)
tree539091ac49d6282d5018212a3a568d9e21e71073
parent9b65a7c38fd78ff71d5382af9a445d712f5d7a59 (diff)
downloadsamba-ed5ddabc43c484fe6eca3bd4b0cc22eb5aa9a33a.tar.gz
samba-ed5ddabc43c484fe6eca3bd4b0cc22eb5aa9a33a.tar.bz2
samba-ed5ddabc43c484fe6eca3bd4b0cc22eb5aa9a33a.zip
Add documentation to session token functions.
(This used to be commit ec4a108d1d35cd4bb2170f1bb122546266b9b745)
-rw-r--r--source4/auth/session.h14
-rw-r--r--source4/auth/system_session.c7
2 files changed, 16 insertions, 5 deletions
diff --git a/source4/auth/session.h b/source4/auth/session.h
index 9b5fba7f39..933b14a1b4 100644
--- a/source4/auth/session.h
+++ b/source4/auth/session.h
@@ -1,6 +1,6 @@
/*
Unix SMB/CIFS implementation.
- Auth session handling
+ Process and provide the logged on user's authorization token
Copyright (C) Andrew Bartlett 2001
Copyright (C) Stefan Metzmacher 2005
@@ -30,8 +30,18 @@ struct auth_session_info {
#include "librpc/gen_ndr/netlogon.h"
-struct auth_session_info *system_session_anon(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx);
+/* Create a security token for a session SYSTEM (the most
+ * trusted/prvilaged account), including the local machine account as
+ * the off-host credentials */
struct auth_session_info *system_session(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx) ;
+
+/*
+ * Create a system session, but with anonymous credentials (so we do
+ * not need to open secrets.ldb)
+ */
+struct auth_session_info *system_session_anon(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx);
+
+
NTSTATUS auth_anonymous_server_info(TALLOC_CTX *mem_ctx,
const char *netbios_name,
struct auth_serversupplied_info **_server_info) ;
diff --git a/source4/auth/system_session.c b/source4/auth/system_session.c
index e99bbbb1ab..1d227fe468 100644
--- a/source4/auth/system_session.c
+++ b/source4/auth/system_session.c
@@ -147,9 +147,10 @@ static NTSTATUS generate_session_info(TALLOC_CTX *mem_ctx,
-/**
- Create a system session, with machine account credentials
-*/
+/* Create a security token for a session SYSTEM (the most
+ * trusted/prvilaged account), including the local machine account as
+ * the off-host credentials
+ */
_PUBLIC_ struct auth_session_info *system_session(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx)
{
NTSTATUS nt_status;