summaryrefslogtreecommitdiff
path: root/source3/smbd/server_reload.c
diff options
context:
space:
mode:
authorAndreas Schneider <asn@samba.org>2011-09-05 14:35:55 +0200
committerAndreas Schneider <asn@cryptomilk.org>2011-09-05 17:59:47 +0200
commit3e8c665465f0fa650f5f5193206e109200ea7795 (patch)
treea677f811ddb2ad9c41e09e3e7c926b05cd6cb2da /source3/smbd/server_reload.c
parent303962e3708266810996cde496a6f87b7b4c4bc6 (diff)
downloadsamba-3e8c665465f0fa650f5f5193206e109200ea7795.tar.gz
samba-3e8c665465f0fa650f5f5193206e109200ea7795.tar.bz2
samba-3e8c665465f0fa650f5f5193206e109200ea7795.zip
s3-smbd: Rename reload_printers() and add documentation.
Autobuild-User: Andreas Schneider <asn@cryptomilk.org> Autobuild-Date: Mon Sep 5 17:59:47 CEST 2011 on sn-devel-104
Diffstat (limited to 'source3/smbd/server_reload.c')
-rw-r--r--source3/smbd/server_reload.c21
1 files changed, 16 insertions, 5 deletions
diff --git a/source3/smbd/server_reload.c b/source3/smbd/server_reload.c
index 6639c4a8f6..0c2ea2c5b1 100644
--- a/source3/smbd/server_reload.c
+++ b/source3/smbd/server_reload.c
@@ -31,11 +31,22 @@
#include "messages.h"
#include "lib/param/loadparm.h"
-/****************************************************************************
- purge stale printers and reload from pre-populated pcap cache
-**************************************************************************/
-void reload_printers(struct tevent_context *ev,
- struct messaging_context *msg_ctx)
+/**
+ * @brief Purge stale printers and reload from pre-populated pcap cache.
+ *
+ * This function should normally only be called as a callback on a successful
+ * pcap_cache_reload() or after a MSG_PRINTER_CAP message is received.
+ *
+ * This function can cause DELETION of printers and drivers from our registry,
+ * so calling it on a failed pcap reload may REMOVE permanently all printers
+ * and drivers.
+ *
+ * @param[in] ev The event context.
+ *
+ * @param[in] msg_ctx The messaging context.
+ */
+void delete_and_reload_printers(struct tevent_context *ev,
+ struct messaging_context *msg_ctx)
{
struct auth_session_info *session_info = NULL;
struct spoolss_PrinterInfo2 *pinfo2 = NULL;