From 3e8c665465f0fa650f5f5193206e109200ea7795 Mon Sep 17 00:00:00 2001 From: Andreas Schneider Date: Mon, 5 Sep 2011 14:35:55 +0200 Subject: s3-smbd: Rename reload_printers() and add documentation. Autobuild-User: Andreas Schneider Autobuild-Date: Mon Sep 5 17:59:47 CEST 2011 on sn-devel-104 --- source3/smbd/server_reload.c | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) (limited to 'source3/smbd/server_reload.c') 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; -- cgit