2 Unix SMB/Netbios implementation.
4 printing backend routines
5 Copyright (C) Andrew Tridgell 1992-2000
6 Copyright (C) Jeremy Allison 2002
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 #include "librpc/gen_ndr/messaging.h"
26 extern struct current_user current_user;
27 extern userdom_struct current_user_info;
29 /* Current printer interface */
30 static bool remove_from_jobs_changed(const char* sharename, uint32 jobid);
33 the printing backend revolves around a tdb database that stores the
34 SMB view of the print queue
36 The key for this database is a jobid - a internally generated number that
37 uniquely identifies a print job
39 reading the print queue involves two steps:
40 - possibly running lpq and updating the internal database from that
41 - reading entries from the database
43 jobids are assigned when a job starts spooling.
46 static TDB_CONTEXT *rap_tdb;
47 static uint16 next_rap_jobid;
48 struct rap_jobid_key {
53 /***************************************************************************
54 Nightmare. LANMAN jobid's are 16 bit numbers..... We must map them to 32
55 bit RPC jobids.... JRA.
56 ***************************************************************************/
58 uint16 pjobid_to_rap(const char* sharename, uint32 jobid)
62 struct rap_jobid_key jinfo;
65 DEBUG(10,("pjobid_to_rap: called.\n"));
68 /* Create the in-memory tdb. */
69 rap_tdb = tdb_open_log(NULL, 0, TDB_INTERNAL, (O_RDWR|O_CREAT), 0644);
75 fstrcpy( jinfo.sharename, sharename );
77 key.dptr = (uint8 *)&jinfo;
78 key.dsize = sizeof(jinfo);
80 data = tdb_fetch(rap_tdb, key);
81 if (data.dptr && data.dsize == sizeof(uint16)) {
82 rap_jobid = SVAL(data.dptr, 0);
84 DEBUG(10,("pjobid_to_rap: jobid %u maps to RAP jobid %u\n",
85 (unsigned int)jobid, (unsigned int)rap_jobid));
89 /* Not found - create and store mapping. */
90 rap_jobid = ++next_rap_jobid;
92 rap_jobid = ++next_rap_jobid;
93 SSVAL(buf,0,rap_jobid);
95 data.dsize = sizeof(rap_jobid);
96 tdb_store(rap_tdb, key, data, TDB_REPLACE);
97 tdb_store(rap_tdb, data, key, TDB_REPLACE);
99 DEBUG(10,("pjobid_to_rap: created jobid %u maps to RAP jobid %u\n",
100 (unsigned int)jobid, (unsigned int)rap_jobid));
104 bool rap_to_pjobid(uint16 rap_jobid, fstring sharename, uint32 *pjobid)
109 DEBUG(10,("rap_to_pjobid called.\n"));
114 SSVAL(buf,0,rap_jobid);
116 key.dsize = sizeof(rap_jobid);
117 data = tdb_fetch(rap_tdb, key);
118 if ( data.dptr && data.dsize == sizeof(struct rap_jobid_key) )
120 struct rap_jobid_key *jinfo = (struct rap_jobid_key*)data.dptr;
121 if (sharename != NULL) {
122 fstrcpy( sharename, jinfo->sharename );
124 *pjobid = jinfo->jobid;
125 DEBUG(10,("rap_to_pjobid: jobid %u maps to RAP jobid %u\n",
126 (unsigned int)*pjobid, (unsigned int)rap_jobid));
127 SAFE_FREE(data.dptr);
131 DEBUG(10,("rap_to_pjobid: Failed to lookup RAP jobid %u\n",
132 (unsigned int)rap_jobid));
133 SAFE_FREE(data.dptr);
137 static void rap_jobid_delete(const char* sharename, uint32 jobid)
141 struct rap_jobid_key jinfo;
144 DEBUG(10,("rap_jobid_delete: called.\n"));
149 ZERO_STRUCT( jinfo );
150 fstrcpy( jinfo.sharename, sharename );
152 key.dptr = (uint8 *)&jinfo;
153 key.dsize = sizeof(jinfo);
155 data = tdb_fetch(rap_tdb, key);
156 if (!data.dptr || (data.dsize != sizeof(uint16))) {
157 DEBUG(10,("rap_jobid_delete: cannot find jobid %u\n",
158 (unsigned int)jobid ));
159 SAFE_FREE(data.dptr);
163 DEBUG(10,("rap_jobid_delete: deleting jobid %u\n",
164 (unsigned int)jobid ));
166 rap_jobid = SVAL(data.dptr, 0);
167 SAFE_FREE(data.dptr);
168 SSVAL(buf,0,rap_jobid);
170 data.dsize = sizeof(rap_jobid);
171 tdb_delete(rap_tdb, key);
172 tdb_delete(rap_tdb, data);
175 static int get_queue_status(const char* sharename, print_status_struct *);
177 /****************************************************************************
178 Initialise the printing backend. Called once at startup before the fork().
179 ****************************************************************************/
181 bool print_backend_init(struct messaging_context *msg_ctx)
183 const char *sversion = "INFO/version";
184 int services = lp_numservices();
187 unlink(cache_path("printing.tdb"));
188 mkdir(cache_path("printing"),0755);
190 /* handle a Samba upgrade */
192 for (snum = 0; snum < services; snum++) {
193 struct tdb_print_db *pdb;
194 if (!lp_print_ok(snum))
197 pdb = get_print_db_byname(lp_const_servicename(snum));
200 if (tdb_lock_bystring(pdb->tdb, sversion) == -1) {
201 DEBUG(0,("print_backend_init: Failed to open printer %s database\n", lp_const_servicename(snum) ));
202 release_print_db(pdb);
205 if (tdb_fetch_int32(pdb->tdb, sversion) != PRINT_DATABASE_VERSION) {
206 tdb_wipe_all(pdb->tdb);
207 tdb_store_int32(pdb->tdb, sversion, PRINT_DATABASE_VERSION);
209 tdb_unlock_bystring(pdb->tdb, sversion);
210 release_print_db(pdb);
213 close_all_print_db(); /* Don't leave any open. */
215 /* do NT print initialization... */
216 return nt_printing_init(msg_ctx);
219 /****************************************************************************
220 Shut down printing backend. Called once at shutdown to close the tdb.
221 ****************************************************************************/
223 void printing_end(void)
225 close_all_print_db(); /* Don't leave any open. */
228 /****************************************************************************
229 Retrieve the set of printing functions for a given service. This allows
230 us to set the printer function table based on the value of the 'printing'
233 Use the generic interface as the default and only use cups interface only
234 when asked for (and only when supported)
235 ****************************************************************************/
237 static struct printif *get_printer_fns_from_type( enum printing_types type )
239 struct printif *printer_fns = &generic_printif;
242 if ( type == PRINT_CUPS ) {
243 printer_fns = &cups_printif;
245 #endif /* HAVE_CUPS */
248 if ( type == PRINT_IPRINT ) {
249 printer_fns = &iprint_printif;
251 #endif /* HAVE_IPRINT */
253 printer_fns->type = type;
258 static struct printif *get_printer_fns( int snum )
260 return get_printer_fns_from_type( (enum printing_types)lp_printing(snum) );
264 /****************************************************************************
265 Useful function to generate a tdb key.
266 ****************************************************************************/
268 static TDB_DATA print_key(uint32 jobid, uint32 *tmp)
272 SIVAL(tmp, 0, jobid);
273 ret.dptr = (uint8 *)tmp;
274 ret.dsize = sizeof(*tmp);
278 /***********************************************************************
279 unpack a pjob from a tdb buffer
280 ***********************************************************************/
282 int unpack_pjob( uint8 *buf, int buflen, struct printjob *pjob )
286 uint32 pjpid, pjsysjob, pjfd, pjstarttime, pjstatus;
287 uint32 pjsize, pjpage_count, pjspooled, pjsmbjob;
292 len += tdb_unpack(buf+len, buflen-len, "dddddddddffff",
310 if ( (used = unpack_devicemode(&pjob->nt_devmode, buf+len, buflen-len)) == -1 )
316 pjob->sysjob = pjsysjob;
318 pjob->starttime = pjstarttime;
319 pjob->status = pjstatus;
321 pjob->page_count = pjpage_count;
322 pjob->spooled = pjspooled;
323 pjob->smbjob = pjsmbjob;
329 /****************************************************************************
330 Useful function to find a print job in the database.
331 ****************************************************************************/
333 static struct printjob *print_job_find(const char *sharename, uint32 jobid)
335 static struct printjob pjob;
338 struct tdb_print_db *pdb = get_print_db_byname(sharename);
340 DEBUG(10,("print_job_find: looking up job %u for share %s\n",
341 (unsigned int)jobid, sharename ));
347 ret = tdb_fetch(pdb->tdb, print_key(jobid, &tmp));
348 release_print_db(pdb);
351 DEBUG(10,("print_job_find: failed to find jobid %u.\n", (unsigned int)jobid ));
355 if ( pjob.nt_devmode ) {
356 free_nt_devicemode( &pjob.nt_devmode );
361 if ( unpack_pjob( ret.dptr, ret.dsize, &pjob ) == -1 ) {
362 DEBUG(10,("print_job_find: failed to unpack jobid %u.\n", (unsigned int)jobid ));
369 DEBUG(10,("print_job_find: returning system job %d for jobid %u.\n",
370 (int)pjob.sysjob, (unsigned int)jobid ));
375 /* Convert a unix jobid to a smb jobid */
377 struct unixjob_traverse_state {
379 uint32 sysjob_to_jobid_value;
382 static int unixjob_traverse_fn(TDB_CONTEXT *the_tdb, TDB_DATA key,
383 TDB_DATA data, void *private_data)
385 struct printjob *pjob;
386 struct unixjob_traverse_state *state =
387 (struct unixjob_traverse_state *)private_data;
389 if (!data.dptr || data.dsize == 0)
392 pjob = (struct printjob *)data.dptr;
393 if (key.dsize != sizeof(uint32))
396 if (state->sysjob == pjob->sysjob) {
397 uint32 jobid = IVAL(key.dptr,0);
399 state->sysjob_to_jobid_value = jobid;
406 /****************************************************************************
407 This is a *horribly expensive call as we have to iterate through all the
408 current printer tdb's. Don't do this often ! JRA.
409 ****************************************************************************/
411 uint32 sysjob_to_jobid(int unix_jobid)
413 int services = lp_numservices();
415 struct unixjob_traverse_state state;
417 state.sysjob = unix_jobid;
418 state.sysjob_to_jobid_value = (uint32)-1;
420 for (snum = 0; snum < services; snum++) {
421 struct tdb_print_db *pdb;
422 if (!lp_print_ok(snum))
424 pdb = get_print_db_byname(lp_const_servicename(snum));
428 tdb_traverse(pdb->tdb, unixjob_traverse_fn, &state);
429 release_print_db(pdb);
430 if (state.sysjob_to_jobid_value != (uint32)-1)
431 return state.sysjob_to_jobid_value;
436 /****************************************************************************
437 Send notifications based on what has changed after a pjob_store.
438 ****************************************************************************/
440 static const struct {
442 uint32 spoolss_status;
443 } lpq_to_spoolss_status_map[] = {
444 { LPQ_QUEUED, JOB_STATUS_QUEUED },
445 { LPQ_PAUSED, JOB_STATUS_PAUSED },
446 { LPQ_SPOOLING, JOB_STATUS_SPOOLING },
447 { LPQ_PRINTING, JOB_STATUS_PRINTING },
448 { LPQ_DELETING, JOB_STATUS_DELETING },
449 { LPQ_OFFLINE, JOB_STATUS_OFFLINE },
450 { LPQ_PAPEROUT, JOB_STATUS_PAPEROUT },
451 { LPQ_PRINTED, JOB_STATUS_PRINTED },
452 { LPQ_DELETED, JOB_STATUS_DELETED },
453 { LPQ_BLOCKED, JOB_STATUS_BLOCKED_DEVQ },
454 { LPQ_USER_INTERVENTION, JOB_STATUS_USER_INTERVENTION },
458 /* Convert a lpq status value stored in printing.tdb into the
459 appropriate win32 API constant. */
461 static uint32 map_to_spoolss_status(uint32 lpq_status)
465 while (lpq_to_spoolss_status_map[i].lpq_status != -1) {
466 if (lpq_to_spoolss_status_map[i].lpq_status == lpq_status)
467 return lpq_to_spoolss_status_map[i].spoolss_status;
474 static void pjob_store_notify(const char* sharename, uint32 jobid, struct printjob *old_data,
475 struct printjob *new_data)
477 bool new_job = False;
482 /* Job attributes that can't be changed. We only send
483 notification for these on a new job. */
485 /* ACHTUNG! Due to a bug in Samba's spoolss parsing of the
486 NOTIFY_INFO_DATA buffer, we *have* to send the job submission
487 time first or else we'll end up with potential alignment
488 errors. I don't think the systemtime should be spooled as
489 a string, but this gets us around that error.
490 --jerry (i'll feel dirty for this) */
493 notify_job_submitted(sharename, jobid, new_data->starttime);
494 notify_job_username(sharename, jobid, new_data->user);
497 if (new_job || !strequal(old_data->jobname, new_data->jobname))
498 notify_job_name(sharename, jobid, new_data->jobname);
500 /* Job attributes of a new job or attributes that can be
503 if (new_job || !strequal(old_data->jobname, new_data->jobname))
504 notify_job_name(sharename, jobid, new_data->jobname);
506 if (new_job || old_data->status != new_data->status)
507 notify_job_status(sharename, jobid, map_to_spoolss_status(new_data->status));
509 if (new_job || old_data->size != new_data->size)
510 notify_job_total_bytes(sharename, jobid, new_data->size);
512 if (new_job || old_data->page_count != new_data->page_count)
513 notify_job_total_pages(sharename, jobid, new_data->page_count);
516 /****************************************************************************
517 Store a job structure back to the database.
518 ****************************************************************************/
520 static bool pjob_store(const char* sharename, uint32 jobid, struct printjob *pjob)
523 TDB_DATA old_data, new_data;
525 struct tdb_print_db *pdb = get_print_db_byname(sharename);
527 int len, newlen, buflen;
535 old_data = tdb_fetch(pdb->tdb, print_key(jobid, &tmp));
537 /* Doh! Now we have to pack/unpack data since the NT_DEVICEMODE was added */
544 len += tdb_pack(buf+len, buflen-len, "dddddddddffff",
546 (uint32)pjob->sysjob,
548 (uint32)pjob->starttime,
549 (uint32)pjob->status,
551 (uint32)pjob->page_count,
552 (uint32)pjob->spooled,
553 (uint32)pjob->smbjob,
559 len += pack_devicemode(pjob->nt_devmode, buf+len, buflen-len);
562 buf = (uint8 *)SMB_REALLOC(buf, len);
564 DEBUG(0,("pjob_store: failed to enlarge buffer!\n"));
569 } while ( buflen != len );
575 new_data.dsize = len;
576 ret = (tdb_store(pdb->tdb, print_key(jobid, &tmp), new_data,
579 release_print_db(pdb);
581 /* Send notify updates for what has changed */
584 struct printjob old_pjob;
586 if ( old_data.dsize )
588 if ( unpack_pjob( old_data.dptr, old_data.dsize, &old_pjob ) != -1 )
590 pjob_store_notify( sharename, jobid, &old_pjob , pjob );
591 free_nt_devicemode( &old_pjob.nt_devmode );
596 pjob_store_notify( sharename, jobid, NULL, pjob );
601 SAFE_FREE( old_data.dptr );
607 /****************************************************************************
608 Remove a job structure from the database.
609 ****************************************************************************/
611 void pjob_delete(const char* sharename, uint32 jobid)
614 struct printjob *pjob;
615 uint32 job_status = 0;
616 struct tdb_print_db *pdb;
618 pdb = get_print_db_byname( sharename );
623 pjob = print_job_find( sharename, jobid );
626 DEBUG(5, ("pjob_delete: we were asked to delete nonexistent job %u\n",
627 (unsigned int)jobid));
628 release_print_db(pdb);
632 /* We must cycle through JOB_STATUS_DELETING and
633 JOB_STATUS_DELETED for the port monitor to delete the job
636 job_status = JOB_STATUS_DELETING|JOB_STATUS_DELETED;
637 notify_job_status(sharename, jobid, job_status);
639 /* Remove from printing.tdb */
641 tdb_delete(pdb->tdb, print_key(jobid, &tmp));
642 remove_from_jobs_changed(sharename, jobid);
643 release_print_db( pdb );
644 rap_jobid_delete(sharename, jobid);
647 /****************************************************************************
648 List a unix job in the print database.
649 ****************************************************************************/
651 static void print_unix_job(const char *sharename, print_queue_struct *q, uint32 jobid)
653 struct printjob pj, *old_pj;
655 if (jobid == (uint32)-1)
656 jobid = q->job + UNIX_JOB_START;
658 /* Preserve the timestamp on an existing unix print job */
660 old_pj = print_job_find(sharename, jobid);
667 pj.starttime = old_pj ? old_pj->starttime : q->time;
668 pj.status = q->status;
671 fstrcpy(pj.filename, old_pj ? old_pj->filename : "");
672 if (jobid < UNIX_JOB_START) {
674 fstrcpy(pj.jobname, old_pj ? old_pj->jobname : "Remote Downlevel Document");
677 fstrcpy(pj.jobname, old_pj ? old_pj->jobname : q->fs_file);
679 fstrcpy(pj.user, old_pj ? old_pj->user : q->fs_user);
680 fstrcpy(pj.queuename, old_pj ? old_pj->queuename : sharename );
682 pjob_store(sharename, jobid, &pj);
686 struct traverse_struct {
687 print_queue_struct *queue;
688 int qcount, snum, maxcount, total_jobs;
689 const char *sharename;
691 const char *lprm_command;
692 struct printif *print_if;
695 /****************************************************************************
696 Utility fn to delete any jobs that are no longer active.
697 ****************************************************************************/
699 static int traverse_fn_delete(TDB_CONTEXT *t, TDB_DATA key, TDB_DATA data, void *state)
701 struct traverse_struct *ts = (struct traverse_struct *)state;
702 struct printjob pjob;
706 if ( key.dsize != sizeof(jobid) )
709 jobid = IVAL(key.dptr, 0);
710 if ( unpack_pjob( data.dptr, data.dsize, &pjob ) == -1 )
712 free_nt_devicemode( &pjob.nt_devmode );
716 /* remove a unix job if it isn't in the system queue any more */
718 for (i=0;i<ts->qcount;i++) {
719 uint32 u_jobid = (ts->queue[i].job + UNIX_JOB_START);
720 if (jobid == u_jobid)
723 if (i == ts->qcount) {
724 DEBUG(10,("traverse_fn_delete: pjob %u deleted due to !smbjob\n",
725 (unsigned int)jobid ));
726 pjob_delete(ts->sharename, jobid);
730 /* need to continue the the bottom of the function to
731 save the correct attributes */
734 /* maybe it hasn't been spooled yet */
736 /* if a job is not spooled and the process doesn't
737 exist then kill it. This cleans up after smbd
739 if (!process_exists_by_pid(pjob.pid)) {
740 DEBUG(10,("traverse_fn_delete: pjob %u deleted due to !process_exists (%u)\n",
741 (unsigned int)jobid, (unsigned int)pjob.pid ));
742 pjob_delete(ts->sharename, jobid);
748 /* this check only makes sense for jobs submitted from Windows clients */
751 for (i=0;i<ts->qcount;i++) {
754 if ( pjob.status == LPQ_DELETED )
757 curr_jobid = print_parse_jobid(ts->queue[i].fs_file);
759 if (jobid == curr_jobid) {
761 /* try to clean up any jobs that need to be deleted */
763 if ( pjob.status == LPQ_DELETING ) {
766 result = (*(ts->print_if->job_delete))(
767 ts->sharename, ts->lprm_command, &pjob );
770 /* if we can't delete, then reset the job status */
771 pjob.status = LPQ_QUEUED;
772 pjob_store(ts->sharename, jobid, &pjob);
775 /* if we deleted the job, the remove the tdb record */
776 pjob_delete(ts->sharename, jobid);
777 pjob.status = LPQ_DELETED;
787 /* The job isn't in the system queue - we have to assume it has
788 completed, so delete the database entry. */
790 if (i == ts->qcount) {
792 /* A race can occur between the time a job is spooled and
793 when it appears in the lpq output. This happens when
794 the job is added to printing.tdb when another smbd
795 running print_queue_update() has completed a lpq and
796 is currently traversing the printing tdb and deleting jobs.
797 Don't delete the job if it was submitted after the lpq_time. */
799 if (pjob.starttime < ts->lpq_time) {
800 DEBUG(10,("traverse_fn_delete: pjob %u deleted due to pjob.starttime (%u) < ts->lpq_time (%u)\n",
802 (unsigned int)pjob.starttime,
803 (unsigned int)ts->lpq_time ));
804 pjob_delete(ts->sharename, jobid);
810 /* Save the pjob attributes we will store.
811 FIXME!!! This is the only place where queue->job
812 represents the SMB jobid --jerry */
814 ts->queue[i].job = jobid;
815 ts->queue[i].size = pjob.size;
816 ts->queue[i].page_count = pjob.page_count;
817 ts->queue[i].status = pjob.status;
818 ts->queue[i].priority = 1;
819 ts->queue[i].time = pjob.starttime;
820 fstrcpy(ts->queue[i].fs_user, pjob.user);
821 fstrcpy(ts->queue[i].fs_file, pjob.jobname);
828 /****************************************************************************
829 Check if the print queue has been updated recently enough.
830 ****************************************************************************/
832 static void print_cache_flush(const char *sharename)
835 struct tdb_print_db *pdb = get_print_db_byname(sharename);
839 slprintf(key, sizeof(key)-1, "CACHE/%s", sharename);
840 tdb_store_int32(pdb->tdb, key, -1);
841 release_print_db(pdb);
844 /****************************************************************************
845 Check if someone already thinks they are doing the update.
846 ****************************************************************************/
848 static pid_t get_updating_pid(const char *sharename)
853 struct tdb_print_db *pdb = get_print_db_byname(sharename);
857 slprintf(keystr, sizeof(keystr)-1, "UPDATING/%s", sharename);
858 key = string_tdb_data(keystr);
860 data = tdb_fetch(pdb->tdb, key);
861 release_print_db(pdb);
862 if (!data.dptr || data.dsize != sizeof(pid_t)) {
863 SAFE_FREE(data.dptr);
867 updating_pid = IVAL(data.dptr, 0);
868 SAFE_FREE(data.dptr);
870 if (process_exists_by_pid(updating_pid))
876 /****************************************************************************
877 Set the fact that we're doing the update, or have finished doing the update
879 ****************************************************************************/
881 static void set_updating_pid(const fstring sharename, bool updating)
886 pid_t updating_pid = sys_getpid();
889 struct tdb_print_db *pdb = get_print_db_byname(sharename);
894 slprintf(keystr, sizeof(keystr)-1, "UPDATING/%s", sharename);
895 key = string_tdb_data(keystr);
897 DEBUG(5, ("set_updating_pid: %s updating lpq cache for print share %s\n",
898 updating ? "" : "not ",
902 tdb_delete(pdb->tdb, key);
903 release_print_db(pdb);
907 SIVAL( buffer, 0, updating_pid);
909 data.dsize = 4; /* we always assume this is a 4 byte value */
911 tdb_store(pdb->tdb, key, data, TDB_REPLACE);
912 release_print_db(pdb);
915 /****************************************************************************
916 Sort print jobs by submittal time.
917 ****************************************************************************/
919 static int printjob_comp(print_queue_struct *j1, print_queue_struct *j2)
930 /* Sort on job start time */
932 if (j1->time == j2->time)
934 return (j1->time > j2->time) ? 1 : -1;
937 /****************************************************************************
938 Store the sorted queue representation for later portmon retrieval.
940 ****************************************************************************/
942 static void store_queue_struct(struct tdb_print_db *pdb, struct traverse_struct *pts)
945 int max_reported_jobs = lp_max_reported_jobs(pts->snum);
946 print_queue_struct *queue = pts->queue;
951 if (max_reported_jobs && (max_reported_jobs < pts->qcount))
952 pts->qcount = max_reported_jobs;
955 /* Work out the size. */
957 data.dsize += tdb_pack(NULL, 0, "d", qcount);
959 for (i = 0; i < pts->qcount; i++) {
960 if ( queue[i].status == LPQ_DELETED )
964 data.dsize += tdb_pack(NULL, 0, "ddddddff",
965 (uint32)queue[i].job,
966 (uint32)queue[i].size,
967 (uint32)queue[i].page_count,
968 (uint32)queue[i].status,
969 (uint32)queue[i].priority,
970 (uint32)queue[i].time,
975 if ((data.dptr = (uint8 *)SMB_MALLOC(data.dsize)) == NULL)
979 len += tdb_pack(data.dptr + len, data.dsize - len, "d", qcount);
980 for (i = 0; i < pts->qcount; i++) {
981 if ( queue[i].status == LPQ_DELETED )
984 len += tdb_pack(data.dptr + len, data.dsize - len, "ddddddff",
985 (uint32)queue[i].job,
986 (uint32)queue[i].size,
987 (uint32)queue[i].page_count,
988 (uint32)queue[i].status,
989 (uint32)queue[i].priority,
990 (uint32)queue[i].time,
995 tdb_store(pdb->tdb, string_tdb_data("INFO/linear_queue_array"), data,
997 SAFE_FREE(data.dptr);
1001 static TDB_DATA get_jobs_changed_data(struct tdb_print_db *pdb)
1007 data = tdb_fetch(pdb->tdb, string_tdb_data("INFO/jobs_changed"));
1008 if (data.dptr == NULL || data.dsize == 0 || (data.dsize % 4 != 0)) {
1009 SAFE_FREE(data.dptr);
1016 static void check_job_changed(const char *sharename, TDB_DATA data, uint32 jobid)
1019 unsigned int job_count = data.dsize / 4;
1021 for (i = 0; i < job_count; i++) {
1024 ch_jobid = IVAL(data.dptr, i*4);
1025 if (ch_jobid == jobid)
1026 remove_from_jobs_changed(sharename, jobid);
1030 /****************************************************************************
1031 Check if the print queue has been updated recently enough.
1032 ****************************************************************************/
1034 static bool print_cache_expired(const char *sharename, bool check_pending)
1037 time_t last_qscan_time, time_now = time(NULL);
1038 struct tdb_print_db *pdb = get_print_db_byname(sharename);
1039 bool result = False;
1044 snprintf(key, sizeof(key), "CACHE/%s", sharename);
1045 last_qscan_time = (time_t)tdb_fetch_int32(pdb->tdb, key);
1048 * Invalidate the queue for 3 reasons.
1049 * (1). last queue scan time == -1.
1050 * (2). Current time - last queue scan time > allowed cache time.
1051 * (3). last queue scan time > current time + MAX_CACHE_VALID_TIME (1 hour by default).
1052 * This last test picks up machines for which the clock has been moved
1053 * forward, an lpq scan done and then the clock moved back. Otherwise
1054 * that last lpq scan would stay around for a loooong loooong time... :-). JRA.
1057 if (last_qscan_time == ((time_t)-1)
1058 || (time_now - last_qscan_time) >= lp_lpqcachetime()
1059 || last_qscan_time > (time_now + MAX_CACHE_VALID_TIME))
1062 time_t msg_pending_time;
1064 DEBUG(4, ("print_cache_expired: cache expired for queue %s "
1065 "(last_qscan_time = %d, time now = %d, qcachetime = %d)\n",
1066 sharename, (int)last_qscan_time, (int)time_now,
1067 (int)lp_lpqcachetime() ));
1069 /* check if another smbd has already sent a message to update the
1070 queue. Give the pending message one minute to clear and
1071 then send another message anyways. Make sure to check for
1072 clocks that have been run forward and then back again. */
1074 snprintf(key, sizeof(key), "MSG_PENDING/%s", sharename);
1077 && tdb_fetch_uint32( pdb->tdb, key, &u )
1078 && (msg_pending_time=u) > 0
1079 && msg_pending_time <= time_now
1080 && (time_now - msg_pending_time) < 60 )
1082 DEBUG(4,("print_cache_expired: message already pending for %s. Accepting cache\n",
1091 release_print_db(pdb);
1095 /****************************************************************************
1096 main work for updating the lpq cahe for a printer queue
1097 ****************************************************************************/
1099 static void print_queue_update_internal( const char *sharename,
1100 struct printif *current_printif,
1101 char *lpq_command, char *lprm_command )
1104 print_queue_struct *queue = NULL;
1105 print_status_struct status;
1106 print_status_struct old_status;
1107 struct printjob *pjob;
1108 struct traverse_struct tstruct;
1111 fstring keystr, cachestr;
1112 struct tdb_print_db *pdb = get_print_db_byname(sharename);
1118 DEBUG(5,("print_queue_update_internal: printer = %s, type = %d, lpq command = [%s]\n",
1119 sharename, current_printif->type, lpq_command));
1122 * Update the cache time FIRST ! Stops others even
1123 * attempting to get the lock and doing this
1124 * if the lpq takes a long time.
1127 slprintf(cachestr, sizeof(cachestr)-1, "CACHE/%s", sharename);
1128 tdb_store_int32(pdb->tdb, cachestr, (int)time(NULL));
1130 /* get the current queue using the appropriate interface */
1131 ZERO_STRUCT(status);
1133 qcount = (*(current_printif->queue_get))(sharename,
1134 current_printif->type,
1135 lpq_command, &queue, &status);
1137 DEBUG(3, ("print_queue_update_internal: %d job%s in queue for %s\n",
1138 qcount, (qcount != 1) ? "s" : "", sharename));
1140 /* Sort the queue by submission time otherwise they are displayed
1143 TYPESAFE_QSORT(queue, qcount, printjob_comp);
1146 any job in the internal database that is marked as spooled
1147 and doesn't exist in the system queue is considered finished
1148 and removed from the database
1150 any job in the system database but not in the internal database
1151 is added as a unix job
1153 fill in any system job numbers as we go
1156 jcdata = get_jobs_changed_data(pdb);
1158 for (i=0; i<qcount; i++) {
1159 uint32 jobid = print_parse_jobid(queue[i].fs_file);
1161 if (jobid == (uint32)-1) {
1162 /* assume its a unix print job */
1163 print_unix_job(sharename, &queue[i], jobid);
1167 /* we have an active SMB print job - update its status */
1168 pjob = print_job_find(sharename, jobid);
1170 /* err, somethings wrong. Probably smbd was restarted
1171 with jobs in the queue. All we can do is treat them
1172 like unix jobs. Pity. */
1173 print_unix_job(sharename, &queue[i], jobid);
1177 pjob->sysjob = queue[i].job;
1179 /* don't reset the status on jobs to be deleted */
1181 if ( pjob->status != LPQ_DELETING )
1182 pjob->status = queue[i].status;
1184 pjob_store(sharename, jobid, pjob);
1186 check_job_changed(sharename, jcdata, jobid);
1189 SAFE_FREE(jcdata.dptr);
1191 /* now delete any queued entries that don't appear in the
1193 tstruct.queue = queue;
1194 tstruct.qcount = qcount;
1196 tstruct.total_jobs = 0;
1197 tstruct.lpq_time = time(NULL);
1198 tstruct.sharename = sharename;
1199 tstruct.lprm_command = lprm_command;
1200 tstruct.print_if = current_printif;
1202 tdb_traverse(pdb->tdb, traverse_fn_delete, (void *)&tstruct);
1204 /* Store the linearised queue, max jobs only. */
1205 store_queue_struct(pdb, &tstruct);
1207 SAFE_FREE(tstruct.queue);
1209 DEBUG(10,("print_queue_update_internal: printer %s INFO/total_jobs = %d\n",
1210 sharename, tstruct.total_jobs ));
1212 tdb_store_int32(pdb->tdb, "INFO/total_jobs", tstruct.total_jobs);
1214 get_queue_status(sharename, &old_status);
1215 if (old_status.qcount != qcount)
1216 DEBUG(10,("print_queue_update_internal: queue status change %d jobs -> %d jobs for printer %s\n",
1217 old_status.qcount, qcount, sharename));
1219 /* store the new queue status structure */
1220 slprintf(keystr, sizeof(keystr)-1, "STATUS/%s", sharename);
1221 key = string_tdb_data(keystr);
1223 status.qcount = qcount;
1224 data.dptr = (uint8 *)&status;
1225 data.dsize = sizeof(status);
1226 tdb_store(pdb->tdb, key, data, TDB_REPLACE);
1229 * Update the cache time again. We want to do this call
1230 * as little as possible...
1233 slprintf(keystr, sizeof(keystr)-1, "CACHE/%s", sharename);
1234 tdb_store_int32(pdb->tdb, keystr, (int32)time(NULL));
1236 /* clear the msg pending record for this queue */
1238 snprintf(keystr, sizeof(keystr), "MSG_PENDING/%s", sharename);
1240 if ( !tdb_store_uint32( pdb->tdb, keystr, 0 ) ) {
1241 /* log a message but continue on */
1243 DEBUG(0,("print_queue_update: failed to store MSG_PENDING flag for [%s]!\n",
1247 release_print_db( pdb );
1252 /****************************************************************************
1253 Update the internal database from the system print queue for a queue.
1254 obtain a lock on the print queue before proceeding (needed when mutiple
1255 smbd processes maytry to update the lpq cache concurrently).
1256 ****************************************************************************/
1258 static void print_queue_update_with_lock( const char *sharename,
1259 struct printif *current_printif,
1260 char *lpq_command, char *lprm_command )
1263 struct tdb_print_db *pdb;
1265 DEBUG(5,("print_queue_update_with_lock: printer share = %s\n", sharename));
1266 pdb = get_print_db_byname(sharename);
1270 if ( !print_cache_expired(sharename, False) ) {
1271 DEBUG(5,("print_queue_update_with_lock: print cache for %s is still ok\n", sharename));
1272 release_print_db(pdb);
1277 * Check to see if someone else is doing this update.
1278 * This is essentially a mutex on the update.
1281 if (get_updating_pid(sharename) != -1) {
1282 release_print_db(pdb);
1286 /* Lock the queue for the database update */
1288 slprintf(keystr, sizeof(keystr) - 1, "LOCK/%s", sharename);
1289 /* Only wait 10 seconds for this. */
1290 if (tdb_lock_bystring_with_timeout(pdb->tdb, keystr, 10) == -1) {
1291 DEBUG(0,("print_queue_update_with_lock: Failed to lock printer %s database\n", sharename));
1292 release_print_db(pdb);
1297 * Ensure that no one else got in here.
1298 * If the updating pid is still -1 then we are
1302 if (get_updating_pid(sharename) != -1) {
1304 * Someone else is doing the update, exit.
1306 tdb_unlock_bystring(pdb->tdb, keystr);
1307 release_print_db(pdb);
1312 * We're going to do the update ourselves.
1315 /* Tell others we're doing the update. */
1316 set_updating_pid(sharename, True);
1319 * Allow others to enter and notice we're doing
1323 tdb_unlock_bystring(pdb->tdb, keystr);
1325 /* do the main work now */
1327 print_queue_update_internal( sharename, current_printif,
1328 lpq_command, lprm_command );
1330 /* Delete our pid from the db. */
1331 set_updating_pid(sharename, False);
1332 release_print_db(pdb);
1335 /****************************************************************************
1336 this is the receive function of the background lpq updater
1337 ****************************************************************************/
1338 static void print_queue_receive(struct messaging_context *msg,
1341 struct server_id server_id,
1345 char *lpqcommand = NULL, *lprmcommand = NULL;
1349 len = tdb_unpack( (uint8 *)data->data, data->length, "fdPP",
1356 SAFE_FREE(lpqcommand);
1357 SAFE_FREE(lprmcommand);
1358 DEBUG(0,("print_queue_receive: Got invalid print queue update message\n"));
1362 print_queue_update_with_lock(sharename,
1363 get_printer_fns_from_type((enum printing_types)printing_type),
1364 lpqcommand, lprmcommand );
1366 SAFE_FREE(lpqcommand);
1367 SAFE_FREE(lprmcommand);
1371 static void printing_pause_fd_handler(struct tevent_context *ev,
1372 struct tevent_fd *fde,
1377 * If pause_pipe[1] is closed it means the parent smbd
1378 * and children exited or aborted.
1380 exit_server_cleanly(NULL);
1383 static void add_child_pid(pid_t pid)
1385 extern struct child_pid *children;
1386 struct child_pid *child;
1387 extern int num_children;
1389 child = SMB_MALLOC_P(struct child_pid);
1390 if (child == NULL) {
1391 DEBUG(0, ("Could not add child struct -- malloc failed\n"));
1395 DLIST_ADD(children, child);
1399 static pid_t background_lpq_updater_pid = -1;
1401 /****************************************************************************
1402 main thread of the background lpq updater
1403 ****************************************************************************/
1404 void start_background_queue(void)
1406 /* Use local variables for this as we don't
1407 * need to save the parent side of this, just
1408 * ensure it closes when the process exits.
1412 DEBUG(3,("start_background_queue: Starting background LPQ thread\n"));
1414 if (pipe(pause_pipe) == -1) {
1415 DEBUG(5,("start_background_queue: cannot create pipe. %s\n", strerror(errno) ));
1419 background_lpq_updater_pid = sys_fork();
1421 if (background_lpq_updater_pid == -1) {
1422 DEBUG(5,("start_background_queue: background LPQ thread failed to start. %s\n", strerror(errno) ));
1426 /* Track the printing pid along with other smbd children */
1427 add_child_pid(background_lpq_updater_pid);
1429 if(background_lpq_updater_pid == 0) {
1430 struct tevent_fd *fde;
1434 DEBUG(5,("start_background_queue: background LPQ thread started\n"));
1436 close(pause_pipe[0]);
1439 if (!NT_STATUS_IS_OK(reinit_after_fork(server_messaging_context(),
1440 server_event_context(),
1442 DEBUG(0,("reinit_after_fork() failed\n"));
1443 smb_panic("reinit_after_fork() failed");
1446 smbd_setup_sig_term_handler();
1447 smbd_setup_sig_hup_handler();
1449 if (!serverid_register(procid_self(),
1450 FLAG_MSG_GENERAL|FLAG_MSG_SMBD
1451 |FLAG_MSG_PRINT_GENERAL)) {
1455 if (!locking_init()) {
1459 messaging_register(server_messaging_context(), NULL,
1460 MSG_PRINTER_UPDATE, print_queue_receive);
1462 fde = tevent_add_fd(server_event_context(),
1463 server_event_context(),
1464 pause_pipe[1], TEVENT_FD_READ,
1465 printing_pause_fd_handler,
1468 DEBUG(0,("tevent_add_fd() failed for pause_pipe\n"));
1469 smb_panic("tevent_add_fd() failed for pause_pipe");
1472 DEBUG(5,("start_background_queue: background LPQ thread waiting for messages\n"));
1473 ret = tevent_loop_wait(server_event_context());
1474 /* should not be reached */
1475 DEBUG(0,("background_queue: tevent_loop_wait() exited with %d - %s\n",
1476 ret, (ret == 0) ? "out of events" : strerror(errno)));
1480 close(pause_pipe[1]);
1483 /****************************************************************************
1484 update the internal database from the system print queue for a queue
1485 ****************************************************************************/
1487 static void print_queue_update(int snum, bool force)
1491 char *lpqcommand = NULL;
1492 char *lprmcommand = NULL;
1493 uint8 *buffer = NULL;
1496 struct tdb_print_db *pdb;
1498 struct printif *current_printif;
1499 TALLOC_CTX *ctx = talloc_tos();
1501 fstrcpy( sharename, lp_const_servicename(snum));
1503 /* don't strip out characters like '$' from the printername */
1505 lpqcommand = talloc_string_sub2(ctx,
1506 lp_lpqcommand(snum),
1508 lp_printername(snum),
1509 false, false, false);
1513 lpqcommand = talloc_sub_advanced(ctx,
1514 lp_servicename(snum),
1515 current_user_info.unix_name,
1517 current_user.ut.gid,
1518 get_current_username(),
1519 current_user_info.domain,
1525 lprmcommand = talloc_string_sub2(ctx,
1526 lp_lprmcommand(snum),
1528 lp_printername(snum),
1529 false, false, false);
1533 lprmcommand = talloc_sub_advanced(ctx,
1534 lp_servicename(snum),
1535 current_user_info.unix_name,
1537 current_user.ut.gid,
1538 get_current_username(),
1539 current_user_info.domain,
1546 * Make sure that the background queue process exists.
1547 * Otherwise just do the update ourselves
1550 if ( force || background_lpq_updater_pid == -1 ) {
1551 DEBUG(4,("print_queue_update: updating queue [%s] myself\n", sharename));
1552 current_printif = get_printer_fns( snum );
1553 print_queue_update_with_lock( sharename, current_printif, lpqcommand, lprmcommand );
1558 type = lp_printing(snum);
1560 /* get the length */
1562 len = tdb_pack( NULL, 0, "fdPP",
1568 buffer = SMB_XMALLOC_ARRAY( uint8, len );
1570 /* now pack the buffer */
1571 newlen = tdb_pack( buffer, len, "fdPP",
1577 SMB_ASSERT( newlen == len );
1579 DEBUG(10,("print_queue_update: Sending message -> printer = %s, "
1580 "type = %d, lpq command = [%s] lprm command = [%s]\n",
1581 sharename, type, lpqcommand, lprmcommand ));
1583 /* here we set a msg pending record for other smbd processes
1584 to throttle the number of duplicate print_queue_update msgs
1587 pdb = get_print_db_byname(sharename);
1593 snprintf(key, sizeof(key), "MSG_PENDING/%s", sharename);
1595 if ( !tdb_store_uint32( pdb->tdb, key, time(NULL) ) ) {
1596 /* log a message but continue on */
1598 DEBUG(0,("print_queue_update: failed to store MSG_PENDING flag for [%s]!\n",
1602 release_print_db( pdb );
1604 /* finally send the message */
1606 messaging_send_buf(server_messaging_context(),
1607 pid_to_procid(background_lpq_updater_pid),
1608 MSG_PRINTER_UPDATE, (uint8 *)buffer, len);
1610 SAFE_FREE( buffer );
1615 /****************************************************************************
1616 Create/Update an entry in the print tdb that will allow us to send notify
1617 updates only to interested smbd's.
1618 ****************************************************************************/
1620 bool print_notify_register_pid(int snum)
1623 struct tdb_print_db *pdb = NULL;
1624 TDB_CONTEXT *tdb = NULL;
1625 const char *printername;
1626 uint32 mypid = (uint32)sys_getpid();
1630 /* if (snum == -1), then the change notify request was
1631 on a print server handle and we need to register on
1636 int num_services = lp_numservices();
1639 for ( idx=0; idx<num_services; idx++ ) {
1640 if (lp_snum_ok(idx) && lp_print_ok(idx) )
1641 print_notify_register_pid(idx);
1646 else /* register for a specific printer */
1648 printername = lp_const_servicename(snum);
1649 pdb = get_print_db_byname(printername);
1655 if (tdb_lock_bystring_with_timeout(tdb, NOTIFY_PID_LIST_KEY, 10) == -1) {
1656 DEBUG(0,("print_notify_register_pid: Failed to lock printer %s\n",
1659 release_print_db(pdb);
1663 data = get_printer_notify_pid_list( tdb, printername, True );
1665 /* Add ourselves and increase the refcount. */
1667 for (i = 0; i < data.dsize; i += 8) {
1668 if (IVAL(data.dptr,i) == mypid) {
1669 uint32 new_refcount = IVAL(data.dptr, i+4) + 1;
1670 SIVAL(data.dptr, i+4, new_refcount);
1675 if (i == data.dsize) {
1676 /* We weren't in the list. Realloc. */
1677 data.dptr = (uint8 *)SMB_REALLOC(data.dptr, data.dsize + 8);
1679 DEBUG(0,("print_notify_register_pid: Relloc fail for printer %s\n",
1684 SIVAL(data.dptr,data.dsize - 8,mypid);
1685 SIVAL(data.dptr,data.dsize - 4,1); /* Refcount. */
1688 /* Store back the record. */
1689 if (tdb_store_bystring(tdb, NOTIFY_PID_LIST_KEY, data, TDB_REPLACE) == -1) {
1690 DEBUG(0,("print_notify_register_pid: Failed to update pid \
1691 list for printer %s\n", printername));
1699 tdb_unlock_bystring(tdb, NOTIFY_PID_LIST_KEY);
1701 release_print_db(pdb);
1702 SAFE_FREE(data.dptr);
1706 /****************************************************************************
1707 Update an entry in the print tdb that will allow us to send notify
1708 updates only to interested smbd's.
1709 ****************************************************************************/
1711 bool print_notify_deregister_pid(int snum)
1714 struct tdb_print_db *pdb = NULL;
1715 TDB_CONTEXT *tdb = NULL;
1716 const char *printername;
1717 uint32 mypid = (uint32)sys_getpid();
1721 /* if ( snum == -1 ), we are deregister a print server handle
1722 which means to deregister on all print queues */
1726 int num_services = lp_numservices();
1729 for ( idx=0; idx<num_services; idx++ ) {
1730 if ( lp_snum_ok(idx) && lp_print_ok(idx) )
1731 print_notify_deregister_pid(idx);
1736 else /* deregister a specific printer */
1738 printername = lp_const_servicename(snum);
1739 pdb = get_print_db_byname(printername);
1745 if (tdb_lock_bystring_with_timeout(tdb, NOTIFY_PID_LIST_KEY, 10) == -1) {
1746 DEBUG(0,("print_notify_register_pid: Failed to lock \
1747 printer %s database\n", printername));
1749 release_print_db(pdb);
1753 data = get_printer_notify_pid_list( tdb, printername, True );
1755 /* Reduce refcount. Remove ourselves if zero. */
1757 for (i = 0; i < data.dsize; ) {
1758 if (IVAL(data.dptr,i) == mypid) {
1759 uint32 refcount = IVAL(data.dptr, i+4);
1763 if (refcount == 0) {
1764 if (data.dsize - i > 8)
1765 memmove( &data.dptr[i], &data.dptr[i+8], data.dsize - i - 8);
1769 SIVAL(data.dptr, i+4, refcount);
1775 if (data.dsize == 0)
1776 SAFE_FREE(data.dptr);
1778 /* Store back the record. */
1779 if (tdb_store_bystring(tdb, NOTIFY_PID_LIST_KEY, data, TDB_REPLACE) == -1) {
1780 DEBUG(0,("print_notify_register_pid: Failed to update pid \
1781 list for printer %s\n", printername));
1789 tdb_unlock_bystring(tdb, NOTIFY_PID_LIST_KEY);
1791 release_print_db(pdb);
1792 SAFE_FREE(data.dptr);
1796 /****************************************************************************
1797 Check if a jobid is valid. It is valid if it exists in the database.
1798 ****************************************************************************/
1800 bool print_job_exists(const char* sharename, uint32 jobid)
1802 struct tdb_print_db *pdb = get_print_db_byname(sharename);
1808 ret = tdb_exists(pdb->tdb, print_key(jobid, &tmp));
1809 release_print_db(pdb);
1813 /****************************************************************************
1814 Give the fd used for a jobid.
1815 ****************************************************************************/
1817 int print_job_fd(const char* sharename, uint32 jobid)
1819 struct printjob *pjob = print_job_find(sharename, jobid);
1822 /* don't allow another process to get this info - it is meaningless */
1823 if (pjob->pid != sys_getpid())
1828 /****************************************************************************
1829 Give the filename used for a jobid.
1830 Only valid for the process doing the spooling and when the job
1831 has not been spooled.
1832 ****************************************************************************/
1834 char *print_job_fname(const char* sharename, uint32 jobid)
1836 struct printjob *pjob = print_job_find(sharename, jobid);
1837 if (!pjob || pjob->spooled || pjob->pid != sys_getpid())
1839 return pjob->filename;
1843 /****************************************************************************
1844 Give the filename used for a jobid.
1845 Only valid for the process doing the spooling and when the job
1846 has not been spooled.
1847 ****************************************************************************/
1849 NT_DEVICEMODE *print_job_devmode(const char* sharename, uint32 jobid)
1851 struct printjob *pjob = print_job_find(sharename, jobid);
1856 return pjob->nt_devmode;
1859 /****************************************************************************
1860 Set the name of a job. Only possible for owner.
1861 ****************************************************************************/
1863 bool print_job_set_name(const char *sharename, uint32 jobid, const char *name)
1865 struct printjob *pjob;
1867 pjob = print_job_find(sharename, jobid);
1868 if (!pjob || pjob->pid != sys_getpid())
1871 fstrcpy(pjob->jobname, name);
1872 return pjob_store(sharename, jobid, pjob);
1875 /****************************************************************************
1876 Get the name of a job. Only possible for owner.
1877 ****************************************************************************/
1879 bool print_job_get_name(TALLOC_CTX *mem_ctx, const char *sharename, uint32_t jobid, char **name)
1881 struct printjob *pjob;
1883 pjob = print_job_find(sharename, jobid);
1884 if (!pjob || pjob->pid != sys_getpid()) {
1888 *name = talloc_strdup(mem_ctx, pjob->jobname);
1897 /***************************************************************************
1898 Remove a jobid from the 'jobs changed' list.
1899 ***************************************************************************/
1901 static bool remove_from_jobs_changed(const char* sharename, uint32 jobid)
1903 struct tdb_print_db *pdb = get_print_db_byname(sharename);
1905 size_t job_count, i;
1907 bool gotlock = False;
1915 key = string_tdb_data("INFO/jobs_changed");
1917 if (tdb_chainlock_with_timeout(pdb->tdb, key, 5) == -1)
1922 data = tdb_fetch(pdb->tdb, key);
1924 if (data.dptr == NULL || data.dsize == 0 || (data.dsize % 4 != 0))
1927 job_count = data.dsize / 4;
1928 for (i = 0; i < job_count; i++) {
1931 ch_jobid = IVAL(data.dptr, i*4);
1932 if (ch_jobid == jobid) {
1933 if (i < job_count -1 )
1934 memmove(data.dptr + (i*4), data.dptr + (i*4) + 4, (job_count - i - 1)*4 );
1936 if (tdb_store(pdb->tdb, key, data, TDB_REPLACE) == -1)
1946 tdb_chainunlock(pdb->tdb, key);
1947 SAFE_FREE(data.dptr);
1948 release_print_db(pdb);
1950 DEBUG(10,("remove_from_jobs_changed: removed jobid %u\n", (unsigned int)jobid ));
1952 DEBUG(10,("remove_from_jobs_changed: Failed to remove jobid %u\n", (unsigned int)jobid ));
1956 /****************************************************************************
1957 Delete a print job - don't update queue.
1958 ****************************************************************************/
1960 static bool print_job_delete1(int snum, uint32 jobid)
1962 const char* sharename = lp_const_servicename(snum);
1963 struct printjob *pjob = print_job_find(sharename, jobid);
1965 struct printif *current_printif = get_printer_fns( snum );
1971 * If already deleting just return.
1974 if (pjob->status == LPQ_DELETING)
1977 /* Hrm - we need to be able to cope with deleting a job before it
1978 has reached the spooler. Just mark it as LPQ_DELETING and
1979 let the print_queue_update() code rmeove the record */
1982 if (pjob->sysjob == -1) {
1983 DEBUG(5, ("attempt to delete job %u not seen by lpr\n", (unsigned int)jobid));
1986 /* Set the tdb entry to be deleting. */
1988 pjob->status = LPQ_DELETING;
1989 pjob_store(sharename, jobid, pjob);
1991 if (pjob->spooled && pjob->sysjob != -1)
1993 result = (*(current_printif->job_delete))(
1994 lp_printername(snum),
1995 lp_lprmcommand(snum),
1998 /* Delete the tdb entry if the delete succeeded or the job hasn't
2002 struct tdb_print_db *pdb = get_print_db_byname(sharename);
2007 pjob_delete(sharename, jobid);
2008 /* Ensure we keep a rough count of the number of total jobs... */
2009 tdb_change_int32_atomic(pdb->tdb, "INFO/total_jobs", &njobs, -1);
2010 release_print_db(pdb);
2014 remove_from_jobs_changed( sharename, jobid );
2016 return (result == 0);
2019 /****************************************************************************
2020 Return true if the current user owns the print job.
2021 ****************************************************************************/
2023 static bool is_owner(struct auth_serversupplied_info *server_info,
2024 const char *servicename,
2027 struct printjob *pjob = print_job_find(servicename, jobid);
2029 if (!pjob || !server_info)
2032 return strequal(pjob->user, server_info->sanitized_username);
2035 /****************************************************************************
2037 ****************************************************************************/
2039 bool print_job_delete(struct auth_serversupplied_info *server_info, int snum,
2040 uint32 jobid, WERROR *errcode)
2042 const char* sharename = lp_const_servicename( snum );
2043 struct printjob *pjob;
2049 owner = is_owner(server_info, lp_const_servicename(snum), jobid);
2051 /* Check access against security descriptor or whether the user
2055 !print_access_check(server_info, snum, JOB_ACCESS_ADMINISTER)) {
2056 DEBUG(3, ("delete denied by security descriptor\n"));
2057 *errcode = WERR_ACCESS_DENIED;
2059 /* BEGIN_ADMIN_LOG */
2060 sys_adminlog( LOG_ERR,
2061 "Permission denied-- user not allowed to delete, \
2062 pause, or resume print job. User name: %s. Printer name: %s.",
2063 uidtoname(server_info->utok.uid),
2064 lp_printername(snum) );
2071 * get the spooled filename of the print job
2072 * if this works, then the file has not been spooled
2073 * to the underlying print system. Just delete the
2074 * spool file & return.
2077 if ( (fname = print_job_fname( sharename, jobid )) != NULL )
2079 /* remove the spool file */
2080 DEBUG(10,("print_job_delete: Removing spool file [%s]\n", fname ));
2081 if ( unlink( fname ) == -1 ) {
2082 *errcode = map_werror_from_unix(errno);
2087 if (!print_job_delete1(snum, jobid)) {
2088 *errcode = WERR_ACCESS_DENIED;
2092 /* force update the database and say the delete failed if the
2095 print_queue_update(snum, True);
2097 pjob = print_job_find(sharename, jobid);
2098 if ( pjob && (pjob->status != LPQ_DELETING) )
2099 *errcode = WERR_ACCESS_DENIED;
2101 return (pjob == NULL );
2104 /****************************************************************************
2106 ****************************************************************************/
2108 bool print_job_pause(struct auth_serversupplied_info *server_info, int snum,
2109 uint32 jobid, WERROR *errcode)
2111 const char* sharename = lp_const_servicename(snum);
2112 struct printjob *pjob;
2114 struct printif *current_printif = get_printer_fns( snum );
2116 pjob = print_job_find(sharename, jobid);
2118 if (!pjob || !server_info) {
2119 DEBUG(10, ("print_job_pause: no pjob or user for jobid %u\n",
2120 (unsigned int)jobid ));
2124 if (!pjob->spooled || pjob->sysjob == -1) {
2125 DEBUG(10, ("print_job_pause: not spooled or bad sysjob = %d for jobid %u\n",
2126 (int)pjob->sysjob, (unsigned int)jobid ));
2130 if (!is_owner(server_info, lp_const_servicename(snum), jobid) &&
2131 !print_access_check(server_info, snum, JOB_ACCESS_ADMINISTER)) {
2132 DEBUG(3, ("pause denied by security descriptor\n"));
2134 /* BEGIN_ADMIN_LOG */
2135 sys_adminlog( LOG_ERR,
2136 "Permission denied-- user not allowed to delete, \
2137 pause, or resume print job. User name: %s. Printer name: %s.",
2138 uidtoname(server_info->utok.uid),
2139 lp_printername(snum) );
2142 *errcode = WERR_ACCESS_DENIED;
2146 /* need to pause the spooled entry */
2147 ret = (*(current_printif->job_pause))(snum, pjob);
2150 *errcode = WERR_INVALID_PARAM;
2154 /* force update the database */
2155 print_cache_flush(lp_const_servicename(snum));
2157 /* Send a printer notify message */
2159 notify_job_status(sharename, jobid, JOB_STATUS_PAUSED);
2161 /* how do we tell if this succeeded? */
2166 /****************************************************************************
2168 ****************************************************************************/
2170 bool print_job_resume(struct auth_serversupplied_info *server_info, int snum,
2171 uint32 jobid, WERROR *errcode)
2173 const char *sharename = lp_const_servicename(snum);
2174 struct printjob *pjob;
2176 struct printif *current_printif = get_printer_fns( snum );
2178 pjob = print_job_find(sharename, jobid);
2180 if (!pjob || !server_info) {
2181 DEBUG(10, ("print_job_resume: no pjob or user for jobid %u\n",
2182 (unsigned int)jobid ));
2186 if (!pjob->spooled || pjob->sysjob == -1) {
2187 DEBUG(10, ("print_job_resume: not spooled or bad sysjob = %d for jobid %u\n",
2188 (int)pjob->sysjob, (unsigned int)jobid ));
2192 if (!is_owner(server_info, lp_const_servicename(snum), jobid) &&
2193 !print_access_check(server_info, snum, JOB_ACCESS_ADMINISTER)) {
2194 DEBUG(3, ("resume denied by security descriptor\n"));
2195 *errcode = WERR_ACCESS_DENIED;
2197 /* BEGIN_ADMIN_LOG */
2198 sys_adminlog( LOG_ERR,
2199 "Permission denied-- user not allowed to delete, \
2200 pause, or resume print job. User name: %s. Printer name: %s.",
2201 uidtoname(server_info->utok.uid),
2202 lp_printername(snum) );
2207 ret = (*(current_printif->job_resume))(snum, pjob);
2210 *errcode = WERR_INVALID_PARAM;
2214 /* force update the database */
2215 print_cache_flush(lp_const_servicename(snum));
2217 /* Send a printer notify message */
2219 notify_job_status(sharename, jobid, JOB_STATUS_QUEUED);
2224 /****************************************************************************
2225 Write to a print file.
2226 ****************************************************************************/
2228 ssize_t print_job_write(int snum, uint32 jobid, const char *buf, SMB_OFF_T pos, size_t size)
2230 const char* sharename = lp_const_servicename(snum);
2231 ssize_t return_code;
2232 struct printjob *pjob;
2234 pjob = print_job_find(sharename, jobid);
2238 /* don't allow another process to get this info - it is meaningless */
2239 if (pjob->pid != sys_getpid())
2242 return_code = write_data_at_offset(pjob->fd, buf, size, pos);
2244 if (return_code>0) {
2246 pjob_store(sharename, jobid, pjob);
2251 /****************************************************************************
2252 Get the queue status - do not update if db is out of date.
2253 ****************************************************************************/
2255 static int get_queue_status(const char* sharename, print_status_struct *status)
2259 struct tdb_print_db *pdb = get_print_db_byname(sharename);
2263 ZERO_STRUCTP(status);
2270 fstr_sprintf(keystr, "STATUS/%s", sharename);
2271 data = tdb_fetch(pdb->tdb, string_tdb_data(keystr));
2273 if (data.dsize == sizeof(print_status_struct))
2274 /* this memcpy is ok since the status struct was
2275 not packed before storing it in the tdb */
2276 memcpy(status, data.dptr, sizeof(print_status_struct));
2277 SAFE_FREE(data.dptr);
2280 len = tdb_fetch_int32(pdb->tdb, "INFO/total_jobs");
2281 release_print_db(pdb);
2282 return (len == -1 ? 0 : len);
2285 /****************************************************************************
2286 Determine the number of jobs in a queue.
2287 ****************************************************************************/
2289 int print_queue_length(int snum, print_status_struct *pstatus)
2291 const char* sharename = lp_const_servicename( snum );
2292 print_status_struct status;
2295 ZERO_STRUCT( status );
2297 /* make sure the database is up to date */
2298 if (print_cache_expired(lp_const_servicename(snum), True))
2299 print_queue_update(snum, False);
2301 /* also fetch the queue status */
2302 memset(&status, 0, sizeof(status));
2303 len = get_queue_status(sharename, &status);
2311 /***************************************************************************
2312 Allocate a jobid. Hold the lock for as short a time as possible.
2313 ***************************************************************************/
2315 static bool allocate_print_jobid(struct tdb_print_db *pdb, int snum, const char *sharename, uint32 *pjobid)
2320 *pjobid = (uint32)-1;
2322 for (i = 0; i < 3; i++) {
2323 /* Lock the database - only wait 20 seconds. */
2324 if (tdb_lock_bystring_with_timeout(pdb->tdb, "INFO/nextjob", 20) == -1) {
2325 DEBUG(0,("allocate_print_jobid: failed to lock printing database %s\n", sharename));
2329 if (!tdb_fetch_uint32(pdb->tdb, "INFO/nextjob", &jobid)) {
2330 if (tdb_error(pdb->tdb) != TDB_ERR_NOEXIST) {
2331 DEBUG(0, ("allocate_print_jobid: failed to fetch INFO/nextjob for print queue %s\n",
2333 tdb_unlock_bystring(pdb->tdb, "INFO/nextjob");
2336 DEBUG(10,("allocate_print_jobid: no existing jobid in %s\n", sharename));
2340 DEBUG(10,("allocate_print_jobid: read jobid %u from %s\n", jobid, sharename));
2342 jobid = NEXT_JOBID(jobid);
2344 if (tdb_store_int32(pdb->tdb, "INFO/nextjob", jobid)==-1) {
2345 DEBUG(3, ("allocate_print_jobid: failed to store INFO/nextjob.\n"));
2346 tdb_unlock_bystring(pdb->tdb, "INFO/nextjob");
2350 /* We've finished with the INFO/nextjob lock. */
2351 tdb_unlock_bystring(pdb->tdb, "INFO/nextjob");
2353 if (!print_job_exists(sharename, jobid)) {
2356 DEBUG(10,("allocate_print_jobid: found jobid %u in %s\n", jobid, sharename));
2360 DEBUG(0, ("allocate_print_jobid: failed to allocate a print job for queue %s\n",
2362 /* Probably full... */
2367 /* Store a dummy placeholder. */
2373 if (tdb_store(pdb->tdb, print_key(jobid, &tmp), dum,
2374 TDB_INSERT) == -1) {
2375 DEBUG(3, ("allocate_print_jobid: jobid (%d) failed to store placeholder.\n",
2385 /***************************************************************************
2386 Append a jobid to the 'jobs changed' list.
2387 ***************************************************************************/
2389 static bool add_to_jobs_changed(struct tdb_print_db *pdb, uint32 jobid)
2394 SIVAL(&store_jobid, 0, jobid);
2395 data.dptr = (uint8 *)&store_jobid;
2398 DEBUG(10,("add_to_jobs_changed: Added jobid %u\n", (unsigned int)jobid ));
2400 return (tdb_append(pdb->tdb, string_tdb_data("INFO/jobs_changed"),
2404 /***************************************************************************
2405 Start spooling a job - return the jobid.
2406 ***************************************************************************/
2408 uint32 print_job_start(struct auth_serversupplied_info *server_info, int snum,
2409 const char *jobname, NT_DEVICEMODE *nt_devmode )
2413 struct printjob pjob;
2414 const char *sharename = lp_const_servicename(snum);
2415 struct tdb_print_db *pdb = get_print_db_byname(sharename);
2423 if (!print_access_check(server_info, snum, PRINTER_ACCESS_USE)) {
2424 DEBUG(3, ("print_job_start: job start denied by security descriptor\n"));
2425 release_print_db(pdb);
2429 if (!print_time_access_check(lp_servicename(snum))) {
2430 DEBUG(3, ("print_job_start: job start denied by time check\n"));
2431 release_print_db(pdb);
2435 path = lp_pathname(snum);
2437 /* see if we have sufficient disk space */
2438 if (lp_minprintspace(snum)) {
2439 uint64_t dspace, dsize;
2440 if (sys_fsusage(path, &dspace, &dsize) == 0 &&
2441 dspace < 2*(uint64_t)lp_minprintspace(snum)) {
2442 DEBUG(3, ("print_job_start: disk space check failed.\n"));
2443 release_print_db(pdb);
2449 /* for autoloaded printers, check that the printcap entry still exists */
2450 if (lp_autoloaded(snum) && !pcap_printername_ok(lp_const_servicename(snum))) {
2451 DEBUG(3, ("print_job_start: printer name %s check failed.\n", lp_const_servicename(snum) ));
2452 release_print_db(pdb);
2457 /* Insure the maximum queue size is not violated */
2458 if ((njobs = print_queue_length(snum,NULL)) > lp_maxprintjobs(snum)) {
2459 DEBUG(3, ("print_job_start: Queue %s number of jobs (%d) larger than max printjobs per queue (%d).\n",
2460 sharename, njobs, lp_maxprintjobs(snum) ));
2461 release_print_db(pdb);
2466 DEBUG(10,("print_job_start: Queue %s number of jobs (%d), max printjobs = %d\n",
2467 sharename, njobs, lp_maxprintjobs(snum) ));
2469 if (!allocate_print_jobid(pdb, snum, sharename, &jobid))
2472 /* create the database entry */
2476 pjob.pid = sys_getpid();
2479 pjob.starttime = time(NULL);
2480 pjob.status = LPQ_SPOOLING;
2482 pjob.spooled = False;
2484 pjob.nt_devmode = nt_devmode;
2486 fstrcpy(pjob.jobname, jobname);
2488 fstrcpy(pjob.user, lp_printjob_username(snum));
2489 standard_sub_advanced(sharename, server_info->sanitized_username,
2490 path, server_info->utok.gid,
2491 server_info->sanitized_username,
2492 server_info->info3->base.domain.string,
2493 pjob.user, sizeof(pjob.user)-1);
2494 /* ensure NULL termination */
2495 pjob.user[sizeof(pjob.user)-1] = '\0';
2497 fstrcpy(pjob.queuename, lp_const_servicename(snum));
2499 /* we have a job entry - now create the spool file */
2500 slprintf(pjob.filename, sizeof(pjob.filename)-1, "%s/%s%.8u.XXXXXX",
2501 path, PRINT_SPOOL_PREFIX, (unsigned int)jobid);
2502 pjob.fd = mkstemp(pjob.filename);
2504 if (pjob.fd == -1) {
2505 if (errno == EACCES) {
2506 /* Common setup error, force a report. */
2507 DEBUG(0, ("print_job_start: insufficient permissions \
2508 to open spool file %s.\n", pjob.filename));
2510 /* Normal case, report at level 3 and above. */
2511 DEBUG(3, ("print_job_start: can't open spool file %s,\n", pjob.filename));
2512 DEBUGADD(3, ("errno = %d (%s).\n", errno, strerror(errno)));
2517 pjob_store(sharename, jobid, &pjob);
2519 /* Update the 'jobs changed' entry used by print_queue_status. */
2520 add_to_jobs_changed(pdb, jobid);
2522 /* Ensure we keep a rough count of the number of total jobs... */
2523 tdb_change_int32_atomic(pdb->tdb, "INFO/total_jobs", &njobs, 1);
2525 release_print_db(pdb);
2531 pjob_delete(sharename, jobid);
2533 release_print_db(pdb);
2535 DEBUG(3, ("print_job_start: returning fail. Error = %s\n", strerror(errno) ));
2539 /****************************************************************************
2540 Update the number of pages spooled to jobid
2541 ****************************************************************************/
2543 void print_job_endpage(int snum, uint32 jobid)
2545 const char* sharename = lp_const_servicename(snum);
2546 struct printjob *pjob;
2548 pjob = print_job_find(sharename, jobid);
2551 /* don't allow another process to get this info - it is meaningless */
2552 if (pjob->pid != sys_getpid())
2556 pjob_store(sharename, jobid, pjob);
2559 /****************************************************************************
2560 Print a file - called on closing the file. This spools the job.
2561 If normal close is false then we're tearing down the jobs - treat as an
2563 ****************************************************************************/
2565 bool print_job_end(int snum, uint32 jobid, enum file_close_type close_type)
2567 const char* sharename = lp_const_servicename(snum);
2568 struct printjob *pjob;
2570 SMB_STRUCT_STAT sbuf;
2571 struct printif *current_printif = get_printer_fns( snum );
2573 pjob = print_job_find(sharename, jobid);
2578 if (pjob->spooled || pjob->pid != sys_getpid())
2581 if ((close_type == NORMAL_CLOSE || close_type == SHUTDOWN_CLOSE) &&
2582 (sys_fstat(pjob->fd, &sbuf, false) == 0)) {
2583 pjob->size = sbuf.st_ex_size;
2589 * Not a normal close or we couldn't stat the job file,
2590 * so something has gone wrong. Cleanup.
2594 DEBUG(3,("print_job_end: failed to stat file for jobid %d\n", jobid ));
2598 /* Technically, this is not quite right. If the printer has a separator
2599 * page turned on, the NT spooler prints the separator page even if the
2600 * print job is 0 bytes. 010215 JRR */
2601 if (pjob->size == 0 || pjob->status == LPQ_DELETING) {
2602 /* don't bother spooling empty files or something being deleted. */
2603 DEBUG(5,("print_job_end: canceling spool of %s (%s)\n",
2604 pjob->filename, pjob->size ? "deleted" : "zero length" ));
2605 unlink(pjob->filename);
2606 pjob_delete(sharename, jobid);
2610 ret = (*(current_printif->job_submit))(snum, pjob);
2615 /* The print job has been successfully handed over to the back-end */
2617 pjob->spooled = True;
2618 pjob->status = LPQ_QUEUED;
2619 pjob_store(sharename, jobid, pjob);
2621 /* make sure the database is up to date */
2622 if (print_cache_expired(lp_const_servicename(snum), True))
2623 print_queue_update(snum, False);
2629 /* The print job was not successfully started. Cleanup */
2630 /* Still need to add proper error return propagation! 010122:JRR */
2631 unlink(pjob->filename);
2632 pjob_delete(sharename, jobid);
2636 /****************************************************************************
2637 Get a snapshot of jobs in the system without traversing.
2638 ****************************************************************************/
2640 static bool get_stored_queue_info(struct tdb_print_db *pdb, int snum, int *pcount, print_queue_struct **ppqueue)
2642 TDB_DATA data, cgdata;
2643 print_queue_struct *queue = NULL;
2645 uint32 extra_count = 0;
2646 int total_count = 0;
2649 int max_reported_jobs = lp_max_reported_jobs(snum);
2651 const char* sharename = lp_servicename(snum);
2653 /* make sure the database is up to date */
2654 if (print_cache_expired(lp_const_servicename(snum), True))
2655 print_queue_update(snum, False);
2661 ZERO_STRUCT(cgdata);
2663 /* Get the stored queue data. */
2664 data = tdb_fetch(pdb->tdb, string_tdb_data("INFO/linear_queue_array"));
2666 if (data.dptr && data.dsize >= sizeof(qcount))
2667 len += tdb_unpack(data.dptr + len, data.dsize - len, "d", &qcount);
2669 /* Get the changed jobs list. */
2670 cgdata = tdb_fetch(pdb->tdb, string_tdb_data("INFO/jobs_changed"));
2671 if (cgdata.dptr != NULL && (cgdata.dsize % 4 == 0))
2672 extra_count = cgdata.dsize/4;
2674 DEBUG(5,("get_stored_queue_info: qcount = %u, extra_count = %u\n", (unsigned int)qcount, (unsigned int)extra_count));
2676 /* Allocate the queue size. */
2677 if (qcount == 0 && extra_count == 0)
2680 if ((queue = SMB_MALLOC_ARRAY(print_queue_struct, qcount + extra_count)) == NULL)
2683 /* Retrieve the linearised queue data. */
2685 for( i = 0; i < qcount; i++) {
2686 uint32 qjob, qsize, qpage_count, qstatus, qpriority, qtime;
2687 len += tdb_unpack(data.dptr + len, data.dsize - len, "ddddddff",
2696 queue[i].job = qjob;
2697 queue[i].size = qsize;
2698 queue[i].page_count = qpage_count;
2699 queue[i].status = qstatus;
2700 queue[i].priority = qpriority;
2701 queue[i].time = qtime;
2704 total_count = qcount;
2706 /* Add in the changed jobids. */
2707 for( i = 0; i < extra_count; i++) {
2709 struct printjob *pjob;
2711 jobid = IVAL(cgdata.dptr, i*4);
2712 DEBUG(5,("get_stored_queue_info: changed job = %u\n", (unsigned int)jobid));
2713 pjob = print_job_find(lp_const_servicename(snum), jobid);
2715 DEBUG(5,("get_stored_queue_info: failed to find changed job = %u\n", (unsigned int)jobid));
2716 remove_from_jobs_changed(sharename, jobid);
2720 queue[total_count].job = jobid;
2721 queue[total_count].size = pjob->size;
2722 queue[total_count].page_count = pjob->page_count;
2723 queue[total_count].status = pjob->status;
2724 queue[total_count].priority = 1;
2725 queue[total_count].time = pjob->starttime;
2726 fstrcpy(queue[total_count].fs_user, pjob->user);
2727 fstrcpy(queue[total_count].fs_file, pjob->jobname);
2731 /* Sort the queue by submission time otherwise they are displayed
2734 TYPESAFE_QSORT(queue, total_count, printjob_comp);
2736 DEBUG(5,("get_stored_queue_info: total_count = %u\n", (unsigned int)total_count));
2738 if (max_reported_jobs && total_count > max_reported_jobs)
2739 total_count = max_reported_jobs;
2742 *pcount = total_count;
2748 SAFE_FREE(data.dptr);
2749 SAFE_FREE(cgdata.dptr);
2753 /****************************************************************************
2754 Get a printer queue listing.
2755 set queue = NULL and status = NULL if you just want to update the cache
2756 ****************************************************************************/
2758 int print_queue_status(int snum,
2759 print_queue_struct **ppqueue,
2760 print_status_struct *status)
2764 const char *sharename;
2765 struct tdb_print_db *pdb;
2768 /* make sure the database is up to date */
2770 if (print_cache_expired(lp_const_servicename(snum), True))
2771 print_queue_update(snum, False);
2773 /* return if we are done */
2774 if ( !ppqueue || !status )
2778 sharename = lp_const_servicename(snum);
2779 pdb = get_print_db_byname(sharename);
2785 * Fetch the queue status. We must do this first, as there may
2786 * be no jobs in the queue.
2789 ZERO_STRUCTP(status);
2790 slprintf(keystr, sizeof(keystr)-1, "STATUS/%s", sharename);
2791 key = string_tdb_data(keystr);
2793 data = tdb_fetch(pdb->tdb, key);
2795 if (data.dsize == sizeof(*status)) {
2796 /* this memcpy is ok since the status struct was
2797 not packed before storing it in the tdb */
2798 memcpy(status, data.dptr, sizeof(*status));
2800 SAFE_FREE(data.dptr);
2804 * Now, fetch the print queue information. We first count the number
2805 * of entries, and then only retrieve the queue if necessary.
2808 if (!get_stored_queue_info(pdb, snum, &count, ppqueue)) {
2809 release_print_db(pdb);
2813 release_print_db(pdb);
2817 /****************************************************************************
2819 ****************************************************************************/
2821 WERROR print_queue_pause(struct auth_serversupplied_info *server_info, int snum)
2824 struct printif *current_printif = get_printer_fns( snum );
2826 if (!print_access_check(server_info, snum,
2827 PRINTER_ACCESS_ADMINISTER)) {
2828 return WERR_ACCESS_DENIED;
2834 ret = (*(current_printif->queue_pause))(snum);
2839 return WERR_INVALID_PARAM;
2842 /* force update the database */
2843 print_cache_flush(lp_const_servicename(snum));
2845 /* Send a printer notify message */
2847 notify_printer_status(snum, PRINTER_STATUS_PAUSED);
2852 /****************************************************************************
2854 ****************************************************************************/
2856 WERROR print_queue_resume(struct auth_serversupplied_info *server_info, int snum)
2859 struct printif *current_printif = get_printer_fns( snum );
2861 if (!print_access_check(server_info, snum,
2862 PRINTER_ACCESS_ADMINISTER)) {
2863 return WERR_ACCESS_DENIED;
2868 ret = (*(current_printif->queue_resume))(snum);
2873 return WERR_INVALID_PARAM;
2876 /* make sure the database is up to date */
2877 if (print_cache_expired(lp_const_servicename(snum), True))
2878 print_queue_update(snum, True);
2880 /* Send a printer notify message */
2882 notify_printer_status(snum, PRINTER_STATUS_OK);
2887 /****************************************************************************
2888 Purge a queue - implemented by deleting all jobs that we can delete.
2889 ****************************************************************************/
2891 WERROR print_queue_purge(struct auth_serversupplied_info *server_info, int snum)
2893 print_queue_struct *queue;
2894 print_status_struct status;
2898 /* Force and update so the count is accurate (i.e. not a cached count) */
2899 print_queue_update(snum, True);
2901 can_job_admin = print_access_check(server_info, snum,
2902 JOB_ACCESS_ADMINISTER);
2903 njobs = print_queue_status(snum, &queue, &status);
2905 if ( can_job_admin )
2908 for (i=0;i<njobs;i++) {
2909 bool owner = is_owner(server_info, lp_const_servicename(snum),
2912 if (owner || can_job_admin) {
2913 print_job_delete1(snum, queue[i].job);
2917 if ( can_job_admin )
2920 /* update the cache */
2921 print_queue_update( snum, True );