sync HEAD with recent changes in 3.0
[obnox/samba/samba-obnox.git] / source3 / include / printing.h
1 #ifndef PRINTING_H_
2 #define PRINTING_H_
3
4 /* 
5    Unix SMB/CIFS implementation.
6    printing definitions
7    Copyright (C) Andrew Tridgell 1992-2000
8    
9    This program is free software; you can redistribute it and/or modify
10    it under the terms of the GNU General Public License as published by
11    the Free Software Foundation; either version 2 of the License, or
12    (at your option) any later version.
13    
14    This program is distributed in the hope that it will be useful,
15    but WITHOUT ANY WARRANTY; without even the implied warranty of
16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17    GNU General Public License for more details.
18    
19    You should have received a copy of the GNU General Public License
20    along with this program; if not, write to the Free Software
21    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
22 */
23
24 /*
25    This file defines the low-level printing system interfaces used by the
26    SAMBA printing subsystem.
27 */
28
29 /* Information for print jobs */
30 struct printjob {
31         pid_t pid; /* which process launched the job */
32         int sysjob; /* the system (lp) job number */
33         int fd; /* file descriptor of open file if open */
34         time_t starttime; /* when the job started spooling */
35         int status; /* the status of this job */
36         size_t size; /* the size of the job so far */
37         int page_count; /* then number of pages so far */
38         BOOL spooled; /* has it been sent to the spooler yet? */
39         BOOL smbjob; /* set if the job is a SMB job */
40         fstring filename; /* the filename used to spool the file */
41         fstring jobname; /* the job name given to us by the client */
42         fstring user; /* the user who started the job */
43         fstring queuename; /* service number of printer for this job */
44         NT_DEVICEMODE *nt_devmode;
45 };
46
47 /* Information for print interfaces */
48 struct printif
49 {
50   int (*queue_get)(int snum, print_queue_struct **q,
51                    print_status_struct *status);
52   int (*queue_pause)(int snum);
53   int (*queue_resume)(int snum);
54   int (*job_delete)(int snum, struct printjob *pjob);
55   int (*job_pause)(int snum, struct printjob *pjob);
56   int (*job_resume)(int snum, struct printjob *pjob);
57   int (*job_submit)(int snum, struct printjob *pjob);
58 };
59
60 extern struct printif   generic_printif;
61
62 #ifdef HAVE_CUPS
63 extern struct printif   cups_printif;
64 #endif /* HAVE_CUPS */
65
66 /* PRINT_MAX_JOBID is now defined in local.h */
67 #define UNIX_JOB_START PRINT_MAX_JOBID
68 #define NEXT_JOBID(j) ((j+1) % PRINT_MAX_JOBID > 0 ? (j+1) % PRINT_MAX_JOBID : 1)
69
70 #define MAX_CACHE_VALID_TIME 3600
71
72 #define PRINT_SPOOL_PREFIX "smbprn."
73 #define PRINT_DATABASE_VERSION 5
74
75 /* There can be this many printing tdb's open, plus any locked ones. */
76 #define MAX_PRINT_DBS_OPEN 1
77
78 struct tdb_print_db {
79         struct tdb_print_db *next, *prev;
80         TDB_CONTEXT *tdb;
81         int ref_count;
82         fstring printer_name;
83 };
84
85 /* 
86  * Used for print notify
87  */
88
89 #define NOTIFY_PID_LIST_KEY "NOTIFY_PID_LIST"
90
91 #endif /* PRINTING_H_ */