*
* Scheduler main loop for the Common UNIX Printing System (CUPS).
*
- * Copyright 2007-2008 by Apple Inc.
+ * Copyright 2007-2009 by Apple Inc.
* Copyright 1997-2007 by Easy Software Products, all rights reserved.
*
* These coded instructions, statements, and computer programs are the
* launchd_checkout() - Check-out with launchd.
* parent_handler() - Catch USR1/CHLD signals...
* process_children() - Process all dead children...
+ * select_timeout() - Calculate the select timeout value.
* sigchld_handler() - Handle 'child' signals from old processes.
* sighup_handler() - Handle 'hangup' signals to reconfigure the
* scheduler.
* sigterm_handler() - Handle 'terminate' signals that stop the
* scheduler.
- * select_timeout() - Calculate the select timeout value.
* usage() - Show scheduler usage.
*/
senddoc_time, /* Send-Document time */
expire_time, /* Subscription expire time */
report_time, /* Malloc/client/job report time */
- event_time; /* Last time an event notification was done */
+ event_time; /* Last event notification time */
long timeout; /* Timeout for cupsdDoSelect() */
struct rlimit limit; /* Runtime limit */
#if defined(HAVE_SIGACTION) && !defined(HAVE_SIGSET)
cups_file_t *fp; /* Fake lpsched lock file */
struct stat statbuf; /* Needed for checking lpsched FIFO */
#endif /* __sgi */
-#ifdef __APPLE__
int run_as_child = 0;
- /* Needed for Mac OS X fork/exec */
+ /* Needed for background fork/exec */
+#ifdef __APPLE__
+ int use_sysman = !getuid();
+ /* Use system management functions? */
#else
time_t netif_time = 0; /* Time since last network update */
#endif /* __APPLE__ */
if (getuid() != geteuid())
{
- fputs("cupsd: Cannot run as a setuid program!\n", stderr);
+ fputs("cupsd: Cannot run as a setuid program\n", stderr);
return (1);
}
#endif /* HAVE_GETEUID */
for (opt = argv[i] + 1; *opt != '\0'; opt ++)
switch (*opt)
{
-#ifdef __APPLE__
case 'C' : /* Run as child with config file */
run_as_child = 1;
fg = -1;
-#endif /* __APPLE__ */
case 'c' : /* Configuration file */
i ++;
if (i >= argc)
{
_cupsLangPuts(stderr, _("cupsd: Expected config filename "
- "after \"-c\" option!\n"));
+ "after \"-c\" option\n"));
usage(1);
}
if ((current = malloc(1024)) == NULL)
{
_cupsLangPuts(stderr,
- _("cupsd: Unable to get current directory!\n"));
+ _("cupsd: Unable to get current directory\n"));
return (1);
}
if (!getcwd(current, 1024))
{
_cupsLangPuts(stderr,
- _("cupsd: Unable to get current directory!\n"));
+ _("cupsd: Unable to get current directory\n"));
free(current);
return (1);
}
break;
case 'p' : /* Stop immediately for profiling */
- puts("Warning: -p option is for internal testing use only!");
+ fputs("cupsd: -p (startup profiling) is for internal testing "
+ "use only!\n", stderr);
stop_scheduler = 1;
fg = 1;
break;
+ case 'P' : /* Disable security profiles */
+ fputs("cupsd: -P (disable security profiles) is for internal "
+ "testing use only!\n", stderr);
+ UseProfiles = 0;
+ break;
+
+#ifdef __APPLE__
+ case 'S' : /* Disable system management functions */
+ fputs("cupsd: -S (disable system management) for internal "
+ "testing use only!\n", stderr);
+ use_sysman = 0;
+ break;
+#endif /* __APPLE__ */
+
case 't' : /* Test the cupsd.conf file... */
TestConfigFile = 1;
fg = 1;
default : /* Unknown option */
_cupsLangPrintf(stderr, _("cupsd: Unknown option \"%c\" - "
- "aborting!\n"), *opt);
+ "aborting\n"), *opt);
usage(1);
break;
}
else
{
- _cupsLangPrintf(stderr, _("cupsd: Unknown argument \"%s\" - aborting!\n"),
+ _cupsLangPrintf(stderr, _("cupsd: Unknown argument \"%s\" - aborting\n"),
argv[i]);
usage(1);
}
}
else if (WIFEXITED(i))
{
- fprintf(stderr, "cupsd: Child exited with status %d!\n",
+ fprintf(stderr, "cupsd: Child exited with status %d\n",
WEXITSTATUS(i));
return (2);
}
else
{
- fprintf(stderr, "cupsd: Child exited on signal %d!\n", WTERMSIG(i));
+ fprintf(stderr, "cupsd: Child exited on signal %d\n", WTERMSIG(i));
return (3);
}
}
-#ifdef __APPLE__
+#ifdef __OpenBSD__
/*
- * Since CoreFoundation has an overly-agressive check for whether a
- * process has forked but not exec'd (whether CF has been called or
- * not...), we now have to exec ourselves with the "-f" option to
- * eliminate their bogus warning messages.
+ * Call _thread_sys_closefrom() so the child process doesn't reset the
+ * parent's file descriptors to be blocking. This is a workaround for a
+ * limitation of userland libpthread on OpenBSD.
+ */
+
+ _thread_sys_closefrom(0);
+#endif /* __OpenBSD__ */
+
+ /*
+ * Since CoreFoundation and DBUS both create fork-unsafe data on execution of
+ * a program, and since this kind of really unfriendly behavior seems to be
+ * more common these days in system libraries, we need to re-execute the
+ * background cupsd with the "-C" option to avoid problems. Unfortunately,
+ * we also have to assume that argv[0] contains the name of the cupsd
+ * executable - there is no portable way to get the real pathname...
*/
execlp(argv[0], argv[0], "-C", ConfigurationFile, (char *)0);
exit(errno);
-#endif /* __APPLE__ */
}
if (fg < 1)
* Redirect stdin/out/err to /dev/null...
*/
- open("/dev/null", O_RDONLY);
- open("/dev/null", O_WRONLY);
- open("/dev/null", O_WRONLY);
+ if ((i = open("/dev/null", O_RDONLY)) != 0)
+ {
+ dup2(i, 0);
+ close(i);
+ }
+
+ if ((i = open("/dev/null", O_WRONLY)) != 1)
+ {
+ dup2(i, 1);
+ close(i);
+ }
+
+ if ((i = open("/dev/null", O_WRONLY)) != 2)
+ {
+ dup2(i, 2);
+ close(i);
+ }
#endif /* DEBUG */
}
* we are up and running...
*/
-#ifdef __APPLE__
if (!fg || run_as_child)
-#else
- if (!fg)
-#endif /* __APPLE__ */
{
/*
* Send a signal to the parent process, but only if the parent is
* Start power management framework...
*/
- cupsdStartSystemMonitor();
+ if (use_sysman)
+ cupsdStartSystemMonitor();
#endif /* __APPLE__ */
/*
while (!stop_scheduler)
{
-#ifdef DEBUG
- cupsdLogMessage(CUPSD_LOG_DEBUG2,
- "main: Top of loop, dead_children=%d, NeedReload=%d",
- dead_children, NeedReload);
-#endif /* DEBUG */
-
/*
* Check if there are dead children to handle...
*/
cupsdPauseListening();
}
- /*
- * Check for any active jobs...
- */
-
- for (job = (cupsd_job_t *)cupsArrayFirst(ActiveJobs);
- job;
- job = (cupsd_job_t *)cupsArrayNext(ActiveJobs))
- if (job->state_value == IPP_JOB_PROCESSING)
- break;
-
/*
* Restart if all clients are closed and all jobs finished, or
* if the reload timeout has elapsed...
*/
if ((cupsArrayCount(Clients) == 0 &&
- (!job || NeedReload != RELOAD_ALL)) ||
+ (cupsArrayCount(PrintingJobs) == 0 || NeedReload != RELOAD_ALL)) ||
(time(NULL) - ReloadTime) >= ReloadTimeout)
{
/*
if (Launchd)
{
/*
- * If we were started by launchd get the listen sockets file descriptors...
+ * If we were started by launchd, get the listen socket file
+ * descriptors...
*/
launchd_checkin();
if (timeout == 86400 && Launchd && LaunchdTimeout && !NumPolled &&
!cupsArrayCount(ActiveJobs) &&
- (!Browsing ||
- (!BrowseRemoteProtocols &&
+ (!Browsing ||
+ (!BrowseRemoteProtocols &&
(!NumBrowsers || !BrowseLocalProtocols ||
cupsArrayCount(Printers) == 0))))
{
if (DirtyCleanTime && current_time >= DirtyCleanTime)
cupsdCleanDirty();
+#ifdef __APPLE__
+ /*
+ * If we are going to sleep and still have pending jobs, stop them after
+ * a period of time...
+ */
+
+ if (SleepJobs > 0 && current_time >= SleepJobs &&
+ cupsArrayCount(PrintingJobs) > 0)
+ {
+ SleepJobs = 0;
+ cupsdStopAllJobs(CUPSD_JOB_DEFAULT, 10);
+ }
+#endif /* __APPLE__ */
+
#ifndef __APPLE__
/*
* Update the network interfaces once a minute...
if ((current_time - senddoc_time) >= 10)
{
cupsdCheckJobs();
+ cupsdCleanJobs();
senddoc_time = current_time;
}
* Stop monitoring system event monitoring...
*/
- cupsdStopSystemMonitor();
+ if (use_sysman)
+ cupsdStopSystemMonitor();
#endif /* __APPLE__ */
#ifdef HAVE_GSSAPI
krb5_free_context(KerberosContext);
#endif /* HAVE_GSSAPI */
-#ifdef __APPLE__
-#ifdef HAVE_DLFCN_H
- /*
- * Unload Print Service quota enforcement library (X Server only)
+#if defined(__APPLE__) && defined(HAVE_DLFCN_H)
+ /*
+ * Unload Print Service quota enforcement library (X Server only)
*/
PSQUpdateQuotaProc = NULL;
dlclose(PSQLibRef);
PSQLibRef = NULL;
}
-#endif /* HAVE_DLFCN_H */
-#endif /* __APPLE__ */
+#endif /* __APPLE__ && HAVE_DLFCN_H */
#ifdef __sgi
/*
}
+/*
+ * 'cupsdCheckProcess()' - Tell the main loop to check for dead children.
+ */
+
+void
+cupsdCheckProcess(void)
+{
+ /*
+ * Flag that we have dead children...
+ */
+
+ dead_children = 1;
+}
+
+
/*
* 'cupsdClosePipe()' - Close a pipe as necessary.
*/
launchd_checkin(void)
{
size_t i, /* Looping var */
- count; /* Numebr of listeners */
+ count; /* Number of listeners */
int portnum; /* Port number */
launch_data_t ld_msg, /* Launch data message */
ld_resp, /* Launch data response */
if (lis)
{
- cupsdLogMessage(CUPSD_LOG_DEBUG,
+ cupsdLogMessage(CUPSD_LOG_DEBUG,
"launchd_checkin: Matched existing listener %s with fd %d...",
httpAddrString(&(lis->address), s, sizeof(s)), fd);
}
else
{
- cupsdLogMessage(CUPSD_LOG_DEBUG,
+ cupsdLogMessage(CUPSD_LOG_DEBUG,
"launchd_checkin: Adding new listener %s with fd %d...",
httpAddrString(&addr, s, sizeof(s)), fd);
if ((lis = calloc(1, sizeof(cupsd_listener_t))) == NULL)
{
cupsdLogMessage(CUPSD_LOG_ERROR,
- "launchd_checkin: Unable to allocate listener - %s.",
- strerror(errno));
+ "launchd_checkin: Unable to allocate listener - "
+ "%s.", strerror(errno));
exit(EXIT_FAILURE);
}
/*
* Create or remove the launchd KeepAlive file based on whether
- * there are active jobs, polling, browsing for remote printers or
+ * there are active jobs, polling, browsing for remote printers or
* shared printers to advertise...
*/
- if ((cupsArrayCount(ActiveJobs) || NumPolled ||
- (Browsing &&
+ if ((cupsArrayCount(ActiveJobs) || NumPolled ||
+ (Browsing &&
(BrowseRemoteProtocols ||
(BrowseLocalProtocols && NumBrowsers && cupsArrayCount(Printers))))))
{
cupsdLogMessage(CUPSD_LOG_DEBUG,
- "Creating launchd keepalive file \"" CUPS_KEEPALIVE "\"...");
+ "Creating launchd keepalive file \"" CUPS_KEEPALIVE
+ "\"...");
if ((fd = open(CUPS_KEEPALIVE, O_RDONLY | O_CREAT | O_EXCL, S_IRUSR)) >= 0)
close(fd);
else
{
cupsdLogMessage(CUPSD_LOG_DEBUG,
- "Removing launchd keepalive file \"" CUPS_KEEPALIVE "\"...");
+ "Removing launchd keepalive file \"" CUPS_KEEPALIVE
+ "\"...");
unlink(CUPS_KEEPALIVE);
}
process_children(void)
{
int status; /* Exit status of child */
- int pid; /* Process ID of child */
+ int pid, /* Process ID of child */
+ job_id; /* Job ID of child */
cupsd_job_t *job; /* Current job */
int i; /* Looping var */
char name[1024]; /* Process name */
#endif /* HAVE_WAITPID */
{
/*
- * Ignore SIGTERM errors - that comes when a job is canceled...
+ * Collect the name of the process that finished...
*/
- cupsdFinishProcess(pid, name, sizeof(name));
+ cupsdFinishProcess(pid, name, sizeof(name), &job_id);
/*
* Delete certificates for CGI processes...
cupsdDeleteCert(pid);
/*
- * Lookup the PID in the jobs list...
+ * Handle completed job filters...
*/
- for (job = (cupsd_job_t *)cupsArrayFirst(ActiveJobs);
- job;
- job = (cupsd_job_t *)cupsArrayNext(ActiveJobs))
- if (job->state_value >= IPP_JOB_HELD && (job->filters[0] || job->backend))
+ if (job_id > 0 && (job = cupsdFindJob(job_id)) != NULL)
+ {
+ for (i = 0; job->filters[i]; i ++)
+ if (job->filters[i] == pid)
+ break;
+
+ if (job->filters[i] || job->backend == pid)
{
- for (i = 0; job->filters[i]; i ++)
- if (job->filters[i] == pid)
- break;
+ /*
+ * OK, this process has gone away; what's left?
+ */
+
+ if (job->filters[i])
+ job->filters[i] = -pid;
+ else
+ job->backend = -pid;
- if (job->filters[i] || job->backend == pid)
+ if (status && status != SIGTERM && status != SIGKILL &&
+ status != SIGPIPE && job->status >= 0)
{
/*
- * OK, this process has gone away; what's left?
+ * An error occurred; save the exit status so we know to stop
+ * the printer or cancel the job when all of the filters finish...
+ *
+ * A negative status indicates that the backend failed and the
+ * printer needs to be stopped.
*/
- if (job->filters[i])
- job->filters[i] = -pid;
+ if (job->filters[i])
+ job->status = status; /* Filter failed */
else
- job->backend = -pid;
+ job->status = -status; /* Backend failed */
- if (status && job->status >= 0)
+ if (job->state_value == IPP_JOB_PROCESSING &&
+ job->status_level > CUPSD_LOG_ERROR)
{
- /*
- * An error occurred; save the exit status so we know to stop
- * the printer or cancel the job when all of the filters finish...
- *
- * A negative status indicates that the backend failed and the
- * printer needs to be stopped.
- */
+ char message[1024]; /* New printer-state-message */
+
- if (job->filters[i])
- job->status = status; /* Filter failed */
- else
- job->status = -status; /* Backend failed */
+ job->status_level = CUPSD_LOG_ERROR;
- if (job->printer && !(job->printer->type & CUPS_PRINTER_FAX) &&
- job->status_level > CUPSD_LOG_ERROR)
+ snprintf(message, sizeof(message), "%s failed", name);
+
+ if (job->printer)
{
- job->status_level = CUPSD_LOG_ERROR;
+ strlcpy(job->printer->state_message, message,
+ sizeof(job->printer->state_message));
+ cupsdAddPrinterHistory(job->printer);
+ }
- snprintf(job->printer->state_message,
- sizeof(job->printer->state_message), "%s failed", name);
- cupsdAddPrinterHistory(job->printer);
+ if (!job->attrs)
+ cupsdLoadJob(job);
+
+ if (!job->printer_message && job->attrs)
+ {
+ if ((job->printer_message =
+ ippFindAttribute(job->attrs, "job-printer-state-message",
+ IPP_TAG_TEXT)) == NULL)
+ job->printer_message = ippAddString(job->attrs, IPP_TAG_JOB,
+ IPP_TAG_TEXT,
+ "job-printer-state-message",
+ NULL, NULL);
}
+
+ if (job->printer_message)
+ cupsdSetString(&(job->printer_message->values[0].string.text),
+ message);
}
+ }
- /*
- * If this is not the last file in a job, see if all of the
- * filters are done, and if so move to the next file.
- */
+ /*
+ * If this is not the last file in a job, see if all of the
+ * filters are done, and if so move to the next file.
+ */
- if (job->current_file < job->num_files)
- {
- for (i = 0; job->filters[i] < 0; i ++);
+ if (job->current_file < job->num_files && job->printer)
+ {
+ for (i = 0; job->filters[i] < 0; i ++);
- if (!job->filters[i])
- {
- /*
- * Process the next file...
- */
+ if (!job->filters[i])
+ {
+ /*
+ * Process the next file...
+ */
- cupsdFinishJob(job);
- }
+ cupsdContinueJob(job);
}
- break;
+ }
+ else if (job->state_value >= IPP_JOB_CANCELED)
+ {
+ /*
+ * Remove the job from the active list if there are no processes still
+ * running for it...
+ */
+
+ for (i = 0; job->filters[i] < 0; i++);
+
+ if (!job->filters[i] && job->backend <= 0)
+ cupsArrayRemove(ActiveJobs, job);
}
}
+ }
/*
- * Show the exit status as needed...
+ * Show the exit status as needed, ignoring SIGTERM and SIGKILL errors
+ * since they come when we kill/end a process...
*/
- if (status == SIGTERM)
- status = 0;
-
- if (status)
+ if (status == SIGTERM || status == SIGKILL)
+ {
+ cupsdLogMessage(CUPSD_LOG_DEBUG,
+ "PID %d (%s) was terminated normally with signal %d.",
+ pid, name, status);
+ }
+ else if (status == SIGPIPE)
+ {
+ cupsdLogMessage(CUPSD_LOG_DEBUG,
+ "PID %d (%s) did not catch or ignore signal %d.",
+ pid, name, status);
+ }
+ else if (status)
{
if (WIFEXITED(status))
cupsdLogMessage(CUPSD_LOG_DEBUG, "PID %d (%s) stopped with status %d!",
cupsdLogMessage(CUPSD_LOG_DEBUG, "PID %d (%s) exited with no errors.",
pid, name);
}
-}
-
-
-/*
- * 'sigchld_handler()' - Handle 'child' signals from old processes.
- */
-
-static void
-sigchld_handler(int sig) /* I - Signal number */
-{
- (void)sig;
/*
- * Flag that we have dead children...
+ * If wait*() is interrupted by a signal, tell main() to call us again...
*/
- dead_children = 1;
-
- /*
- * Reset the signal handler as needed...
- */
-
-#if !defined(HAVE_SIGSET) && !defined(HAVE_SIGACTION)
- signal(SIGCLD, sigchld_handler);
-#endif /* !HAVE_SIGSET && !HAVE_SIGACTION */
-}
-
-
-/*
- * 'sighup_handler()' - Handle 'hangup' signals to reconfigure the scheduler.
- */
-
-static void
-sighup_handler(int sig) /* I - Signal number */
-{
- (void)sig;
-
- NeedReload = RELOAD_ALL;
- ReloadTime = time(NULL);
-
-#if !defined(HAVE_SIGSET) && !defined(HAVE_SIGACTION)
- signal(SIGHUP, sighup_handler);
-#endif /* !HAVE_SIGSET && !HAVE_SIGACTION */
-}
-
-
-/*
- * 'sigterm_handler()' - Handle 'terminate' signals that stop the scheduler.
- */
-
-static void
-sigterm_handler(int sig) /* I - Signal number */
-{
- (void)sig; /* remove compiler warnings... */
-
- /*
- * Flag that we should stop and return...
- */
-
- stop_scheduler = 1;
+ if (pid < 0 && errno == EINTR)
+ dead_children = 1;
}
timeout = now + 86400; /* 86400 == 1 day */
why = "do nothing";
+#ifdef __APPLE__
+ /*
+ * When going to sleep, wake up to cancel jobs that don't complete in time.
+ */
+
+ if (SleepJobs > 0 && SleepJobs < timeout)
+ {
+ timeout = SleepJobs;
+ why = "cancel jobs before sleeping";
+ }
+#endif /* __APPLE__ */
+
/*
* Check whether we are accepting new connections...
*/
}
/*
- * Check for any active jobs...
+ * Write out changes to configuration and state files...
*/
if (DirtyCleanTime && timeout > DirtyCleanTime)
* Check for any active jobs...
*/
- if (timeout > (now + 10) && ActiveJobs)
+ for (job = (cupsd_job_t *)cupsArrayFirst(ActiveJobs);
+ job;
+ job = (cupsd_job_t *)cupsArrayNext(ActiveJobs))
{
- for (job = (cupsd_job_t *)cupsArrayFirst(ActiveJobs);
- job;
- job = (cupsd_job_t *)cupsArrayNext(ActiveJobs))
- if (job->state_value <= IPP_JOB_PROCESSING)
- {
- timeout = now + 10;
- why = "process active jobs";
- break;
- }
+ if (job->kill_time && job->kill_time < timeout)
+ {
+ timeout = job->kill_time;
+ why = "kill unresponsive jobs";
+ }
+
+ if (job->state_value == IPP_JOB_HELD && job->hold_until < timeout)
+ {
+ timeout = job->hold_until;
+ why = "release held jobs";
+ }
+ else if (job->state_value == IPP_JOB_PENDING && timeout > (now + 10))
+ {
+ timeout = now + 10;
+ why = "start pending jobs";
+ break;
+ }
}
#ifdef HAVE_MALLINFO
}
+/*
+ * 'sigchld_handler()' - Handle 'child' signals from old processes.
+ */
+
+static void
+sigchld_handler(int sig) /* I - Signal number */
+{
+ (void)sig;
+
+ /*
+ * Flag that we have dead children...
+ */
+
+ dead_children = 1;
+
+ /*
+ * Reset the signal handler as needed...
+ */
+
+#if !defined(HAVE_SIGSET) && !defined(HAVE_SIGACTION)
+ signal(SIGCLD, sigchld_handler);
+#endif /* !HAVE_SIGSET && !HAVE_SIGACTION */
+}
+
+
+/*
+ * 'sighup_handler()' - Handle 'hangup' signals to reconfigure the scheduler.
+ */
+
+static void
+sighup_handler(int sig) /* I - Signal number */
+{
+ (void)sig;
+
+ NeedReload = RELOAD_ALL;
+ ReloadTime = time(NULL);
+
+#if !defined(HAVE_SIGSET) && !defined(HAVE_SIGACTION)
+ signal(SIGHUP, sighup_handler);
+#endif /* !HAVE_SIGSET && !HAVE_SIGACTION */
+}
+
+
+/*
+ * 'sigterm_handler()' - Handle 'terminate' signals that stop the scheduler.
+ */
+
+static void
+sigterm_handler(int sig) /* I - Signal number */
+{
+ (void)sig; /* remove compiler warnings... */
+
+ /*
+ * Flag that we should stop and return...
+ */
+
+ stop_scheduler = 1;
+}
+
+
/*
* 'usage()' - Show scheduler usage.
*/