s3-printing: Initiate pcap reload from parent smbd
authorDavid Disseldorp <ddiss@suse.de>
Thu, 23 Dec 2010 11:14:21 +0000 (12:14 +0100)
committerJeremy Allison <jra@samba.org>
Fri, 7 Jan 2011 23:37:39 +0000 (15:37 -0800)
commit0b188e7784a3f58810f871bf63d10d8a691ecbae
tree997ccf3bb3962549f814d82af4e54692880bcaee
parent04248c2cfaa5a1728ef58fc8ca231fd1309ca694
s3-printing: Initiate pcap reload from parent smbd

Since commit 7022554, smbds share a printcap cache (printer_list.tdb),
therefore ordering of events between smbd processes is important when
updating printcap cache information. Consider the following two process
example:
1) smbd1 receives HUP or printcap cache time expiry
2) smbd1 checks whether pcap needs refresh, it does
3) smbd1 marks pcap as refreshed
4) smbd1 forks child1 to obtain cups printer info
5) smbd2 receives HUP or printcap cache time expiry
6) smbd2 checks whether pcap needs refresh, it does not (due to step 3)
7) smbd2 reloads printer shares prior to child1 completion (stale pcap)
8) child1 completion, pcap cache (printer_list.tdb) is updated by smbd1
9) smbd1 reloads printer shares based on new pcap information

In this case both smbd1 and smbd2 are reliant on the pcap update
performed on child1 completion.
The prior commit "reload shares after pcap cache fill" ensures that
smbd1 only reloads printer shares following pcap update, however smbd2
continues to present shares based on stale pcap data.

This commit addresses the above problem by driving pcap cache and
printer share updates from the parent smbd process.
1) smbd0 (parent) receives a HUP or printcap cache time expiry
2) smbd0 forks child0 to obtain cups printer info
3) child0 completion, pcap cache (printer_list.tdb) is updated by smbd0
4) smbd0 reloads printer shares
5) smbd0 notifies child smbds of pcap update via message_send_all()
6) child smbds read fresh pcap data and reload printer shares

This architecture has the additional advantage that only a single
process (the parent smbd) requests printer information from the printcap
backend.

Use time_mono in housekeeping functions As suggested by Björn Jacke.
docs-xml/smbdotconf/printing/printcapcachetime.xml
source3/include/local.h
source3/include/proto.h
source3/librpc/idl/messaging.idl
source3/smbd/globals.c
source3/smbd/globals.h
source3/smbd/process.c
source3/smbd/server.c
source3/smbd/server_reload.c
source3/web/swat.c