]>
git.ipfire.org Git - thirdparty/cups.git/blob - scheduler/job.h
2 * "$Id: job.h 7883 2008-08-28 20:38:13Z mike $"
4 * Print job definitions for the Common UNIX Printing System (CUPS) scheduler.
6 * Copyright 2007-2009 by Apple Inc.
7 * Copyright 1997-2007 by Easy Software Products, all rights reserved.
9 * These coded instructions, statements, and computer programs are the
10 * property of Apple Inc. and are protected by Federal copyright
11 * law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 * which should have been included with this file. If this file is
13 * file is missing or damaged, see the license at "http://www.cups.org/".
20 typedef enum cupsd_jobaction_e
/**** Actions for state changes ****/
22 CUPSD_JOB_DEFAULT
, /* Use default action */
23 CUPSD_JOB_FORCE
, /* Force the change */
24 CUPSD_JOB_PURGE
/* Force the change and purge */
29 * Job request structure...
35 priority
, /* Job priority */
36 dirty
; /* Do we need to write the "c" file? */
37 ipp_jstate_t state_value
; /* Cached job-state */
38 int pending_timeout
;/* Non-zero if the job was created and
40 char *username
; /* Printing user */
41 char *dest
; /* Destination printer or class */
42 cups_ptype_t dtype
; /* Destination type */
43 int num_files
; /* Number of files in job */
44 mime_type_t
**filetypes
; /* File types */
45 int *compressions
; /* Compression status of each file */
46 ipp_attribute_t
*sheets
; /* job-media-sheets-completed */
47 time_t access_time
, /* Last access time */
48 kill_time
, /* When to send SIGKILL */
49 hold_until
; /* Hold expiration date/time */
50 ipp_attribute_t
*state
; /* Job state */
51 ipp_attribute_t
*job_sheets
; /* Job sheets (NULL if none) */
52 ipp_attribute_t
*printer_message
,
53 /* job-printer-state-message */
55 /* job-printer-state-reasons */
56 int current_file
; /* Current file in job */
57 ipp_t
*attrs
; /* Job attributes */
58 int print_pipes
[2], /* Print data pipes */
59 back_pipes
[2], /* Backchannel pipes */
60 side_pipes
[2], /* Sidechannel pipes */
61 status_pipes
[2];/* Status pipes */
62 cupsd_statbuf_t
*status_buffer
; /* Status buffer for this job */
63 int status_level
; /* Highest log level in a status
65 int cost
; /* Filtering cost */
66 int pending_cost
; /* Waiting for FilterLimit */
67 int filters
[MAX_FILTERS
+ 1];
68 /* Filter process IDs, 0 terminated */
69 int backend
; /* Backend process ID */
70 int status
; /* Status code from filters */
71 cupsd_printer_t
*printer
; /* Printer this job is assigned to */
72 int tries
; /* Number of tries for this job */
73 char *auth_username
, /* AUTH_USERNAME environment variable,
75 *auth_domain
, /* AUTH_DOMAIN environment variable,
77 *auth_password
; /* AUTH_PASSWORD environment variable,
79 void *profile
; /* Security profile */
80 int progress
; /* Printing progress */
82 krb5_ccache ccache
; /* Kerberos credential cache */
83 char *ccname
; /* KRB5CCNAME environment variable */
84 #endif /* HAVE_GSSAPI */
92 VAR
int JobHistory
VALUE(1);
93 /* Preserve job history? */
94 VAR
int JobFiles
VALUE(0);
95 /* Preserve job files? */
96 VAR
int MaxJobs
VALUE(0),
97 /* Max number of jobs */
98 MaxActiveJobs
VALUE(0),
99 /* Max number of active jobs */
100 MaxJobsPerUser
VALUE(0),
101 /* Max jobs per user */
102 MaxJobsPerPrinter
VALUE(0);
103 /* Max jobs per printer */
104 VAR
int JobAutoPurge
VALUE(0);
105 /* Automatically purge jobs */
106 VAR cups_array_t
*Jobs
VALUE(NULL
),
107 /* List of current jobs */
108 *ActiveJobs
VALUE(NULL
),
109 /* List of active jobs */
110 *PrintingJobs
VALUE(NULL
);
111 /* List of jobs that are printing */
112 VAR
int NextJobId
VALUE(1);
113 /* Next job ID to use */
114 VAR
int JobKillDelay
VALUE(DEFAULT_TIMEOUT
),
115 /* Delay before killing jobs */
116 JobRetryLimit
VALUE(5),
117 /* Max number of tries */
118 JobRetryInterval
VALUE(300);
119 /* Seconds between retries */
126 extern cupsd_job_t
*cupsdAddJob(int priority
, const char *dest
);
127 extern void cupsdCancelJobs(const char *dest
, const char *username
,
129 extern void cupsdCheckJobs(void);
130 extern void cupsdCleanJobs(void);
131 extern void cupsdContinueJob(cupsd_job_t
*job
);
132 extern void cupsdDeleteJob(cupsd_job_t
*job
,
133 cupsd_jobaction_t action
);
134 extern cupsd_job_t
*cupsdFindJob(int id
);
135 extern void cupsdFreeAllJobs(void);
136 extern int cupsdGetPrinterJobCount(const char *dest
);
137 extern int cupsdGetUserJobCount(const char *username
);
138 extern void cupsdLoadAllJobs(void);
139 extern int cupsdLoadJob(cupsd_job_t
*job
);
140 extern void cupsdMoveJob(cupsd_job_t
*job
, cupsd_printer_t
*p
);
141 extern void cupsdReleaseJob(cupsd_job_t
*job
);
142 extern void cupsdRestartJob(cupsd_job_t
*job
);
143 extern void cupsdSaveAllJobs(void);
144 extern void cupsdSaveJob(cupsd_job_t
*job
);
145 extern void cupsdSetJobHoldUntil(cupsd_job_t
*job
,
146 const char *when
, int update
);
147 extern void cupsdSetJobPriority(cupsd_job_t
*job
, int priority
);
148 extern void cupsdSetJobState(cupsd_job_t
*job
,
149 ipp_jstate_t newstate
,
150 cupsd_jobaction_t action
,
151 const char *message
, ...)
153 __attribute__ ((__format__ (__printf__
, 4, 5)))
154 #endif /* __GNUC__ */
156 extern void cupsdStopAllJobs(cupsd_jobaction_t action
,
158 extern int cupsdTimeoutJob(cupsd_job_t
*job
);
159 extern void cupsdUnloadCompletedJobs(void);
163 * End of "$Id: job.h 7883 2008-08-28 20:38:13Z mike $".