1 /*
2 * Main loop for the CUPS scheduler.
3 *
4 * Copyright © 2007-2019 by Apple Inc.
5 * Copyright © 1997-2007 by Easy Software Products, all rights reserved.
6 *
7 * Licensed under Apache License v2.0. See the file "LICENSE" for more
8 * information.
9 */
10
11 /*
12 * Include necessary headers...
13 */
14
15 #define _MAIN_C_
16 #include "cupsd.h"
17 #include <sys/resource.h>
18 #ifdef __APPLE__
19 # include <xpc/xpc.h>
20 # include <pthread/qos.h>
21 #endif /* __APPLE__ */
22 #ifdef HAVE_ASL_H
23 # include <asl.h>
24 #elif defined(HAVE_SYSTEMD_SD_JOURNAL_H)
25 # define SD_JOURNAL_SUPPRESS_LOCATION
26 # include <systemd/sd-journal.h>
27 #endif /* HAVE_ASL_H */
28 #include <syslog.h>
29 #include <grp.h>
30
31 #ifdef HAVE_LAUNCH_H
32 # include <launch.h>
33 #endif /* HAVE_LAUNCH_H */
34
35 #ifdef HAVE_SYSTEMD
36 # include <systemd/sd-daemon.h>
37 #endif /* HAVE_SYSTEMD */
38
39 #ifdef HAVE_ONDEMAND
40 # define CUPS_KEEPALIVE CUPS_CACHEDIR "/org.cups.cupsd"
41 /* Name of the KeepAlive file */
42 #endif /* HAVE_ONDEMAND */
43
44 #if defined(HAVE_MALLOC_H) && defined(HAVE_MALLINFO)
45 # include <malloc.h>
46 #endif /* HAVE_MALLOC_H && HAVE_MALLINFO */
47
48 #ifdef HAVE_NOTIFY_H
49 # include <notify.h>
50 #endif /* HAVE_NOTIFY_H */
51
52 #ifdef HAVE_DBUS
53 # include <dbus/dbus.h>
54 #endif /* HAVE_DBUS */
55
56 #ifdef HAVE_SYS_PARAM_H
57 # include <sys/param.h>
58 #endif /* HAVE_SYS_PARAM_H */
59
60
61 /*
62 * Local functions...
63 */
64
65 static void parent_handler(int sig);
66 static void process_children(void);
67 static void sigchld_handler(int sig);
68 static void sighup_handler(int sig);
69 static void sigterm_handler(int sig);
70 static long select_timeout(int fds);
71 static void service_checkin(void);
72 static void service_checkout(int shutdown);
73 static void usage(int status) _CUPS_NORETURN;
74
75
76 /*
77 * Local globals...
78 */
79
80 static int parent_signal = 0;
81 /* Set to signal number from child */
82 static int holdcount = 0; /* Number of times "hold" was called */
83 #if defined(HAVE_SIGACTION) && !defined(HAVE_SIGSET)
84 static sigset_t holdmask; /* Old POSIX signal mask */
85 #endif /* HAVE_SIGACTION && !HAVE_SIGSET */
86 static int dead_children = 0;
87 /* Dead children? */
88 static int stop_scheduler = 0;
89 /* Should the scheduler stop? */
90 static time_t local_timeout = 0;
91 /* Next local printer timeout */
92
93
94 /*
95 * 'main()' - Main entry for the CUPS scheduler.
96 */
97
98 int /* O - Exit status */
main(int argc,char * argv[])99 main(int argc, /* I - Number of command-line args */
100 char *argv[]) /* I - Command-line arguments */
101 {
102 int i; /* Looping var */
103 char *opt; /* Option character */
104 int close_all = 1, /* Close all file descriptors? */
105 disconnect = 1, /* Disconnect from controlling terminal? */
106 fg = 0, /* Run in foreground? */
107 run_as_child = 0,
108 /* Running as child process? */
109 print_profile = 0;
110 /* Print the sandbox profile to stdout? */
111 int fds; /* Number of ready descriptors */
112 cupsd_client_t *con; /* Current client */
113 cupsd_job_t *job; /* Current job */
114 cupsd_listener_t *lis; /* Current listener */
115 time_t current_time, /* Current time */
116 activity, /* Client activity timer */
117 senddoc_time, /* Send-Document time */
118 expire_time, /* Subscription expire time */
119 report_time, /* Malloc/client/job report time */
120 event_time; /* Last event notification time */
121 long timeout; /* Timeout for cupsdDoSelect() */
122 struct rlimit limit; /* Runtime limit */
123 #if defined(HAVE_SIGACTION) && !defined(HAVE_SIGSET)
124 struct sigaction action; /* Actions for POSIX signals */
125 #endif /* HAVE_SIGACTION && !HAVE_SIGSET */
126 #ifdef __APPLE__
127 int use_sysman = 1; /* Use system management functions? */
128 #else
129 time_t netif_time = 0; /* Time since last network update */
130 #endif /* __APPLE__ */
131 #if defined(HAVE_ONDEMAND)
132 int service_idle_exit = 0;
133 /* Idle exit on select timeout? */
134 #endif /* HAVE_ONDEMAND */
135
136
137 #ifdef HAVE_GETEUID
138 /*
139 * Check for setuid invocation, which we do not support!
140 */
141
142 if (getuid() != geteuid())
143 {
144 fputs("cupsd: Cannot run as a setuid program.\n", stderr);
145 return (1);
146 }
147 #endif /* HAVE_GETEUID */
148
149 /*
150 * Check for command-line arguments...
151 */
152
153 fg = 0;
154
155 for (i = 1; i < argc; i ++)
156 {
157 if (!strcmp(argv[i], "--help"))
158 usage(0);
159 else if (argv[i][0] == '-')
160 {
161 for (opt = argv[i] + 1; *opt != '\0'; opt ++)
162 {
163 switch (*opt)
164 {
165 case 'C' : /* Run as child with config file */
166 run_as_child = 1;
167 fg = 1;
168 close_all = 0;
169
170 case 'c' : /* Configuration file */
171 i ++;
172 if (i >= argc)
173 {
174 _cupsLangPuts(stderr, _("cupsd: Expected config filename "
175 "after \"-c\" option."));
176 usage(1);
177 }
178
179 if (argv[i][0] == '/')
180 {
181 /*
182 * Absolute directory...
183 */
184
185 cupsdSetString(&ConfigurationFile, argv[i]);
186 }
187 else
188 {
189 /*
190 * Relative directory...
191 */
192
193 char *current; /* Current directory */
194
195 /*
196 * Allocate a buffer for the current working directory to
197 * reduce run-time stack usage; this approximates the
198 * behavior of some implementations of getcwd() when they
199 * are passed a NULL pointer.
200 */
201
202 if ((current = malloc(1024)) == NULL)
203 {
204 _cupsLangPuts(stderr,
205 _("cupsd: Unable to get current directory."));
206 return (1);
207 }
208
209 if (!getcwd(current, 1024))
210 {
211 _cupsLangPuts(stderr,
212 _("cupsd: Unable to get current directory."));
213 free(current);
214 return (1);
215 }
216
217 cupsdSetStringf(&ConfigurationFile, "%s/%s", current, argv[i]);
218 free(current);
219 }
220 break;
221
222 case 'f' : /* Run in foreground... */
223 fg = 1;
224 disconnect = 0;
225 close_all = 0;
226 break;
227
228 case 'F' : /* Run in foreground, but disconnect from terminal... */
229 fg = 1;
230 close_all = 0;
231 break;
232
233 case 'h' : /* Show usage/help */
234 usage(0);
235 break;
236
237 case 'l' : /* Started by launchd/systemd/upstart... */
238 #ifdef HAVE_ONDEMAND
239 OnDemand = 1;
240 fg = 1;
241 close_all = 0;
242 disconnect = 0;
243 #else
244 _cupsLangPuts(stderr, _("cupsd: On-demand support not compiled "
245 "in, running in normal mode."));
246 fg = 0;
247 disconnect = 1;
248 close_all = 1;
249 #endif /* HAVE_ONDEMAND */
250 break;
251
252 case 'p' : /* Stop immediately for profiling */
253 fputs("cupsd: -p (startup profiling) is for internal testing "
254 "use only!\n", stderr);
255 stop_scheduler = 1;
256 fg = 1;
257 disconnect = 0;
258 close_all = 0;
259 break;
260
261 case 'P' : /* Disable security profiles */
262 fputs("cupsd: -P (disable sandboxing) is for internal testing use only.\n", stderr);
263 UseSandboxing = 0;
264 break;
265
266 case 's' : /* Set cups-files.conf location */
267 i ++;
268 if (i >= argc)
269 {
270 _cupsLangPuts(stderr, _("cupsd: Expected cups-files.conf "
271 "filename after \"-s\" option."));
272 usage(1);
273 }
274
275 if (argv[i][0] != '/')
276 {
277 /*
278 * Relative filename not allowed...
279 */
280
281 _cupsLangPuts(stderr, _("cupsd: Relative cups-files.conf "
282 "filename not allowed."));
283 usage(1);
284 }
285
286 cupsdSetString(&CupsFilesFile, argv[i]);
287 break;
288
289 #ifdef __APPLE__
290 case 'S' : /* Disable system management functions */
291 fputs("cupsd: -S (disable system management) for internal "
292 "testing use only!\n", stderr);
293 use_sysman = 0;
294 break;
295 #endif /* __APPLE__ */
296
297 case 't' : /* Test the cupsd.conf file... */
298 TestConfigFile = 1;
299 fg = 1;
300 disconnect = 0;
301 close_all = 0;
302 break;
303
304 case 'T' : /* Print security profile */
305 print_profile = 1;
306 fg = 1;
307 disconnect = 0;
308 close_all = 0;
309 break;
310
311 default : /* Unknown option */
312 _cupsLangPrintf(stderr, _("cupsd: Unknown option \"%c\" - "
313 "aborting."), *opt);
314 usage(1);
315 break;
316 }
317 }
318 }
319 else
320 {
321 _cupsLangPrintf(stderr, _("cupsd: Unknown argument \"%s\" - aborting."),
322 argv[i]);
323 usage(1);
324 }
325 }
326
327 if (!ConfigurationFile)
328 cupsdSetString(&ConfigurationFile, CUPS_SERVERROOT "/cupsd.conf");
329
330 if (!CupsFilesFile)
331 {
332 char *filename, /* Copy of cupsd.conf filename */
333 *slash; /* Final slash in cupsd.conf filename */
334 size_t len; /* Size of buffer */
335
336 len = strlen(ConfigurationFile) + 15;
337 if ((filename = malloc(len)) == NULL)
338 {
339 _cupsLangPrintf(stderr,
340 _("cupsd: Unable to get path to "
341 "cups-files.conf file."));
342 return (1);
343 }
344
345 strlcpy(filename, ConfigurationFile, len);
346 if ((slash = strrchr(filename, '/')) == NULL)
347 {
348 free(filename);
349 _cupsLangPrintf(stderr,
350 _("cupsd: Unable to get path to "
351 "cups-files.conf file."));
352 return (1);
353 }
354
355 strlcpy(slash, "/cups-files.conf", len - (size_t)(slash - filename));
356 cupsdSetString(&CupsFilesFile, filename);
357 free(filename);
358 }
359
360 if (disconnect)
361 {
362 /*
363 * Make sure we aren't tying up any filesystems...
364 */
365
366 chdir("/");
367
368 /*
369 * Disconnect from the controlling terminal...
370 */
371
372 setsid();
373 }
374
375 if (close_all)
376 {
377 /*
378 * Close all open files...
379 */
380
381 getrlimit(RLIMIT_NOFILE, &limit);
382
383 for (i = 0; i < (int)limit.rlim_cur && i < 1024; i ++)
384 close(i);
385
386 /*
387 * Redirect stdin/out/err to /dev/null...
388 */
389
390 if ((i = open("/dev/null", O_RDONLY)) != 0)
391 {
392 dup2(i, 0);
393 close(i);
394 }
395
396 if ((i = open("/dev/null", O_WRONLY)) != 1)
397 {
398 dup2(i, 1);
399 close(i);
400 }
401
402 if ((i = open("/dev/null", O_WRONLY)) != 2)
403 {
404 dup2(i, 2);
405 close(i);
406 }
407 }
408 else
409 LogStderr = cupsFileStderr();
410
411 /*
412 * Run in the background as needed...
413 */
414
415 if (!fg)
416 {
417 /*
418 * Setup signal handlers for the parent...
419 */
420
421 #ifdef HAVE_SIGSET /* Use System V signals over POSIX to avoid bugs */
422 sigset(SIGUSR1, parent_handler);
423 sigset(SIGCHLD, parent_handler);
424
425 sigset(SIGHUP, SIG_IGN);
426 #elif defined(HAVE_SIGACTION)
427 memset(&action, 0, sizeof(action));
428 sigemptyset(&action.sa_mask);
429 sigaddset(&action.sa_mask, SIGUSR1);
430 action.sa_handler = parent_handler;
431 sigaction(SIGUSR1, &action, NULL);
432 sigaction(SIGCHLD, &action, NULL);
433
434 sigemptyset(&action.sa_mask);
435 action.sa_handler = SIG_IGN;
436 sigaction(SIGHUP, &action, NULL);
437 #else
438 signal(SIGUSR1, parent_handler);
439 signal(SIGCLD, parent_handler);
440
441 signal(SIGHUP, SIG_IGN);
442 #endif /* HAVE_SIGSET */
443
444 if (fork() > 0)
445 {
446 /*
447 * OK, wait for the child to startup and send us SIGUSR1 or to crash
448 * and the OS send us SIGCHLD... We also need to ignore SIGHUP which
449 * might be sent by the init script to restart the scheduler...
450 */
451
452 for (; parent_signal == 0;)
453 sleep(1);
454
455 if (parent_signal == SIGUSR1)
456 return (0);
457
458 if (wait(&i) < 0)
459 {
460 perror("cupsd");
461 return (1);
462 }
463 else if (WIFEXITED(i))
464 {
465 fprintf(stderr, "cupsd: Child exited with status %d\n",
466 WEXITSTATUS(i));
467 return (2);
468 }
469 else
470 {
471 fprintf(stderr, "cupsd: Child exited on signal %d\n", WTERMSIG(i));
472 return (3);
473 }
474 }
475
476 #if defined(__OpenBSD__) && OpenBSD < 201211
477 /*
478 * Call _thread_sys_closefrom() so the child process doesn't reset the
479 * parent's file descriptors to be blocking. This is a workaround for a
480 * limitation of userland libpthread on older versions of OpenBSD.
481 */
482
483 _thread_sys_closefrom(0);
484 #endif /* __OpenBSD__ && OpenBSD < 201211 */
485
486 /*
487 * Since many system libraries create fork-unsafe data on execution of a
488 * program, we need to re-execute the background cupsd with the "-C" and "-s"
489 * options to avoid problems. Unfortunately, we also have to assume that
490 * argv[0] contains the name of the cupsd executable - there is no portable
491 * way to get the real pathname...
492 */
493
494 execlp(argv[0], argv[0], "-C", ConfigurationFile, "-s", CupsFilesFile, (char *)0);
495 exit(errno);
496 }
497
498 /*
499 * Let the system know we are busy while we bring up cupsd...
500 */
501
502 cupsdSetBusyState(1);
503
504 /*
505 * Set the timezone info...
506 */
507
508 tzset();
509
510 #ifdef LC_TIME
511 setlocale(LC_TIME, "");
512 #endif /* LC_TIME */
513
514 #ifdef HAVE_DBUS_THREADS_INIT
515 /*
516 * Enable threading support for D-BUS...
517 */
518
519 dbus_threads_init_default();
520 #endif /* HAVE_DBUS_THREADS_INIT */
521
522 /*
523 * Set the maximum number of files...
524 */
525
526 getrlimit(RLIMIT_NOFILE, &limit);
527
528 #if !defined(HAVE_POLL) && !defined(HAVE_EPOLL) && !defined(HAVE_KQUEUE)
529 if (limit.rlim_max > FD_SETSIZE)
530 MaxFDs = FD_SETSIZE;
531 else
532 #endif /* !HAVE_POLL && !HAVE_EPOLL && !HAVE_KQUEUE */
533 #ifdef RLIM_INFINITY
534 if (limit.rlim_max == RLIM_INFINITY)
535 MaxFDs = 16384;
536 else
537 #endif /* RLIM_INFINITY */
538 MaxFDs = limit.rlim_max;
539
540 limit.rlim_cur = (rlim_t)MaxFDs;
541
542 setrlimit(RLIMIT_NOFILE, &limit);
543
544 cupsdStartSelect();
545
546 /*
547 * Read configuration...
548 */
549
550 if (!cupsdReadConfiguration())
551 return (1);
552 else if (TestConfigFile)
553 {
554 printf("\"%s\" is OK.\n", CupsFilesFile);
555 printf("\"%s\" is OK.\n", ConfigurationFile);
556 return (0);
557 }
558 else if (print_profile)
559 {
560 cups_file_t *fp; /* File pointer */
561 const char *profile = cupsdCreateProfile(42, 0);
562 /* Profile */
563 char line[1024]; /* Line from file */
564
565
566 if ((fp = cupsFileOpen(profile, "r")) == NULL)
567 {
568 printf("Unable to open profile file \"%s\": %s\n", profile ? profile : "(null)", strerror(errno));
569 return (1);
570 }
571
572 while (cupsFileGets(fp, line, sizeof(line)))
573 puts(line);
574
575 cupsFileClose(fp);
576
577 return (0);
578 }
579
580 /*
581 * Clean out old temp files and printer cache data.
582 */
583
584 if (!strncmp(TempDir, RequestRoot, strlen(RequestRoot)))
585 cupsdCleanFiles(TempDir, NULL);
586
587 cupsdCleanFiles(CacheDir, "*.ipp");
588
589 /*
590 * If we were started on demand by launchd or systemd get the listen sockets
591 * file descriptors...
592 */
593
594 service_checkin();
595 service_checkout(0);
596
597 /*
598 * Startup the server...
599 */
600
601 httpInitialize();
602
603 cupsdStartServer();
604
605 /*
606 * Catch hangup and child signals and ignore broken pipes...
607 */
608
609 #ifdef HAVE_SIGSET /* Use System V signals over POSIX to avoid bugs */
610 sigset(SIGCHLD, sigchld_handler);
611 sigset(SIGHUP, sighup_handler);
612 sigset(SIGPIPE, SIG_IGN);
613 sigset(SIGTERM, sigterm_handler);
614 #elif defined(HAVE_SIGACTION)
615 memset(&action, 0, sizeof(action));
616
617 sigemptyset(&action.sa_mask);
618 sigaddset(&action.sa_mask, SIGTERM);
619 sigaddset(&action.sa_mask, SIGCHLD);
620 action.sa_handler = sigchld_handler;
621 sigaction(SIGCHLD, &action, NULL);
622
623 sigemptyset(&action.sa_mask);
624 sigaddset(&action.sa_mask, SIGHUP);
625 action.sa_handler = sighup_handler;
626 sigaction(SIGHUP, &action, NULL);
627
628 sigemptyset(&action.sa_mask);
629 action.sa_handler = SIG_IGN;
630 sigaction(SIGPIPE, &action, NULL);
631
632 sigemptyset(&action.sa_mask);
633 sigaddset(&action.sa_mask, SIGTERM);
634 sigaddset(&action.sa_mask, SIGCHLD);
635 action.sa_handler = sigterm_handler;
636 sigaction(SIGTERM, &action, NULL);
637 #else
638 signal(SIGCLD, sigchld_handler); /* No, SIGCLD isn't a typo... */
639 signal(SIGHUP, sighup_handler);
640 signal(SIGPIPE, SIG_IGN);
641 signal(SIGTERM, sigterm_handler);
642 #endif /* HAVE_SIGSET */
643
644 /*
645 * Initialize authentication certificates...
646 */
647
648 cupsdInitCerts();
649
650 /*
651 * If we are running in the background, signal the parent process that
652 * we are up and running...
653 */
654
655 if (!fg || run_as_child)
656 {
657 /*
658 * Send a signal to the parent process, but only if the parent is
659 * not PID 1 (init). This avoids accidentally shutting down the
660 * system on OpenBSD if you CTRL-C the server before it is up...
661 */
662
663 i = getppid(); /* Save parent PID to avoid race condition */
664
665 if (i != 1)
666 kill(i, SIGUSR1);
667 }
668
669 #ifdef __APPLE__
670 /*
671 * Start power management framework...
672 */
673
674 if (use_sysman)
675 cupsdStartSystemMonitor();
676 #endif /* __APPLE__ */
677
678 /*
679 * Send server-started event...
680 */
681
682 #ifdef HAVE_ONDEMAND
683 if (OnDemand)
684 cupsdAddEvent(CUPSD_EVENT_SERVER_STARTED, NULL, NULL, "Scheduler started on demand.");
685 else
686 #endif /* HAVE_ONDEMAND */
687 if (fg)
688 cupsdAddEvent(CUPSD_EVENT_SERVER_STARTED, NULL, NULL, "Scheduler started in foreground.");
689 else
690 cupsdAddEvent(CUPSD_EVENT_SERVER_STARTED, NULL, NULL, "Scheduler started in background.");
691
692 cupsdSetBusyState(0);
693
694 /*
695 * Start any pending print jobs...
696 */
697
698 cupsdCheckJobs();
699
700 /*
701 * Loop forever...
702 */
703
704 current_time = time(NULL);
705 event_time = current_time;
706 expire_time = current_time;
707 local_timeout = 0;
708 fds = 1;
709 report_time = 0;
710 senddoc_time = current_time;
711
712 while (!stop_scheduler)
713 {
714 /*
715 * Check if there are dead children to handle...
716 */
717
718 if (dead_children)
719 process_children();
720
721 /*
722 * Check if we need to load the server configuration file...
723 */
724
725 if (NeedReload)
726 {
727 /*
728 * Close any idle clients...
729 */
730
731 if (cupsArrayCount(Clients) > 0)
732 {
733 for (con = (cupsd_client_t *)cupsArrayFirst(Clients);
734 con;
735 con = (cupsd_client_t *)cupsArrayNext(Clients))
736 if (httpGetState(con->http) == HTTP_WAITING)
737 cupsdCloseClient(con);
738 else
739 con->http->keep_alive = HTTP_KEEPALIVE_OFF;
740
741 cupsdPauseListening();
742 }
743
744 /*
745 * Restart if all clients are closed and all jobs finished, or
746 * if the reload timeout has elapsed...
747 */
748
749 if ((cupsArrayCount(Clients) == 0 &&
750 (cupsArrayCount(PrintingJobs) == 0 || NeedReload != RELOAD_ALL)) ||
751 (time(NULL) - ReloadTime) >= ReloadTimeout)
752 {
753 /*
754 * Shutdown the server...
755 */
756
757 #ifdef HAVE_ONDEMAND
758 if (OnDemand)
759 {
760 # ifndef HAVE_SYSTEMD /* Issue #5640: systemd doesn't actually support launch-on-demand services, need to fake it */
761 stop_scheduler = 1;
762 # endif /* HAVE_SYSTEMD */
763 break;
764 }
765 #endif /* HAVE_ONDEMAND */
766
767 DoingShutdown = 1;
768
769 cupsdStopServer();
770
771 /*
772 * Read configuration...
773 */
774
775 if (!cupsdReadConfiguration())
776 {
777 #ifdef HAVE_SYSTEMD_SD_JOURNAL_H
778 sd_journal_print(LOG_ERR, "Unable to read configuration file \"%s\" - exiting.", ConfigurationFile);
779 #else
780 syslog(LOG_LPR, "Unable to read configuration file \'%s\' - exiting.", ConfigurationFile);
781 #endif /* HAVE_SYSTEMD_SD_JOURNAL_H */
782
783 break;
784 }
785
786 /*
787 * Startup the server...
788 */
789
790 DoingShutdown = 0;
791
792 cupsdStartServer();
793
794 /*
795 * Send a server-restarted event...
796 */
797
798 cupsdAddEvent(CUPSD_EVENT_SERVER_RESTARTED, NULL, NULL,
799 "Scheduler restarted.");
800 }
801 }
802
803 /*
804 * Check for available input or ready output. If cupsdDoSelect()
805 * returns 0 or -1, something bad happened and we should exit
806 * immediately.
807 *
808 * Note that we at least have one listening socket open at all
809 * times.
810 */
811
812 if ((timeout = select_timeout(fds)) > 1 && LastEvent)
813 timeout = 1;
814
815 #ifdef HAVE_ONDEMAND
816 /*
817 * If no other work is scheduled and we're being controlled by launchd,
818 * systemd, etc. then timeout after 'IdleExitTimeout' seconds of
819 * inactivity...
820 */
821
822 if (timeout == 86400 && OnDemand && IdleExitTimeout &&
823 # ifdef HAVE_SYSTEMD
824 !WebInterface &&
825 # endif /* HAVE_SYSTEMD */
826 !cupsArrayCount(ActiveJobs))
827 {
828 cupsd_printer_t *p = NULL; /* Current printer */
829
830 if (Browsing && BrowseLocalProtocols)
831 {
832 for (p = (cupsd_printer_t *)cupsArrayFirst(Printers); p; p = (cupsd_printer_t *)cupsArrayNext(Printers))
833 if (p->shared)
834 break;
835 }
836
837 if (!p)
838 {
839 timeout = IdleExitTimeout;
840 service_idle_exit = 1;
841 }
842 }
843 else
844 service_idle_exit = 0;
845 #endif /* HAVE_ONDEMAND */
846
847 if ((fds = cupsdDoSelect(timeout)) < 0)
848 {
849 /*
850 * Got an error from select!
851 */
852
853 #if defined(HAVE_DNSSD) || defined(HAVE_AVAHI)
854 cupsd_printer_t *p; /* Current printer */
855 #endif /* HAVE_DNSSD || HAVE_AVAHI */
856
857 if (errno == EINTR) /* Just interrupted by a signal */
858 continue;
859
860 /*
861 * Log all sorts of debug info to help track down the problem.
862 */
863
864 cupsdLogMessage(CUPSD_LOG_EMERG, "cupsdDoSelect() failed - %s!",
865 strerror(errno));
866
867 for (i = 0, con = (cupsd_client_t *)cupsArrayFirst(Clients);
868 con;
869 i ++, con = (cupsd_client_t *)cupsArrayNext(Clients))
870 cupsdLogMessage(CUPSD_LOG_EMERG,
871 "Clients[%d] = %d, file = %d, state = %d",
872 i, con->number, con->file, httpGetState(con->http));
873
874 for (i = 0, lis = (cupsd_listener_t *)cupsArrayFirst(Listeners);
875 lis;
876 i ++, lis = (cupsd_listener_t *)cupsArrayNext(Listeners))
877 cupsdLogMessage(CUPSD_LOG_EMERG, "Listeners[%d] = %d", i, lis->fd);
878
879 cupsdLogMessage(CUPSD_LOG_EMERG, "CGIPipes[0] = %d", CGIPipes[0]);
880
881 #ifdef __APPLE__
882 cupsdLogMessage(CUPSD_LOG_EMERG, "SysEventPipes[0] = %d",
883 SysEventPipes[0]);
884 #endif /* __APPLE__ */
885
886 for (job = (cupsd_job_t *)cupsArrayFirst(ActiveJobs);
887 job;
888 job = (cupsd_job_t *)cupsArrayNext(ActiveJobs))
889 cupsdLogMessage(CUPSD_LOG_EMERG, "Jobs[%d] = %d < [%d %d] > [%d %d]",
890 job->id,
891 job->status_buffer ? job->status_buffer->fd : -1,
892 job->print_pipes[0], job->print_pipes[1],
893 job->back_pipes[0], job->back_pipes[1]);
894
895 #if defined(HAVE_DNSSD) || defined(HAVE_AVAHI)
896 for (p = (cupsd_printer_t *)cupsArrayFirst(Printers);
897 p;
898 p = (cupsd_printer_t *)cupsArrayNext(Printers))
899 cupsdLogMessage(CUPSD_LOG_EMERG, "printer[%s] reg_name=\"%s\"", p->name,
900 p->reg_name ? p->reg_name : "(null)");
901 #endif /* HAVE_DNSSD || HAVE_AVAHI */
902
903 break;
904 }
905
906 current_time = time(NULL);
907
908 /*
909 * Write dirty config/state files...
910 */
911
912 if (DirtyCleanTime && current_time >= DirtyCleanTime)
913 cupsdCleanDirty();
914
915 #ifdef __APPLE__
916 /*
917 * If we are going to sleep and still have pending jobs, stop them after
918 * a period of time...
919 */
920
921 if (SleepJobs > 0 && current_time >= SleepJobs &&
922 cupsArrayCount(PrintingJobs) > 0)
923 {
924 SleepJobs = 0;
925 cupsdStopAllJobs(CUPSD_JOB_DEFAULT, 5);
926 }
927 #endif /* __APPLE__ */
928
929 #ifndef __APPLE__
930 /*
931 * Update the network interfaces once a minute...
932 */
933
934 if ((current_time - netif_time) >= 60)
935 {
936 netif_time = current_time;
937 NetIFUpdate = 1;
938 }
939 #endif /* !__APPLE__ */
940
941 #ifdef HAVE_ONDEMAND
942 /*
943 * If no other work was scheduled and we're being controlled by launchd,
944 * systemd, or upstart then timeout after 'LaunchdTimeout' seconds of
945 * inactivity...
946 */
947
948 if (!fds && service_idle_exit)
949 {
950 cupsdLogMessage(CUPSD_LOG_INFO,
951 "Printer sharing is off and there are no jobs pending, "
952 "will restart on demand.");
953 stop_scheduler = 1;
954 break;
955 }
956 #endif /* HAVE_ONDEMAND */
957
958 /*
959 * Resume listening for new connections as needed...
960 */
961
962 if (ListeningPaused && ListeningPaused <= current_time &&
963 cupsArrayCount(Clients) < MaxClients)
964 cupsdResumeListening();
965
966 /*
967 * Expire subscriptions and unload completed jobs as needed...
968 */
969
970 if (current_time > expire_time)
971 {
972 cupsdExpireSubscriptions(NULL, NULL);
973
974 cupsdUnloadCompletedJobs();
975
976 expire_time = current_time;
977 }
978
979 /*
980 * Delete stale local printers...
981 */
982
983 if (current_time >= local_timeout)
984 {
985 cupsdDeleteTemporaryPrinters(0);
986 local_timeout = 0;
987 }
988
989 #ifndef HAVE_AUTHORIZATION_H
990 /*
991 * Update the root certificate once every 5 minutes if we have client
992 * connections...
993 */
994
995 if ((current_time - RootCertTime) >= RootCertDuration && RootCertDuration &&
996 !RunUser && cupsArrayCount(Clients))
997 {
998 /*
999 * Update the root certificate...
1000 */
1001
1002 cupsdDeleteCert(0);
1003 cupsdAddCert(0, "root", cupsdDefaultAuthType());
1004 }
1005 #endif /* !HAVE_AUTHORIZATION_H */
1006
1007 /*
1008 * Clean job history...
1009 */
1010
1011 if (JobHistoryUpdate && current_time >= JobHistoryUpdate)
1012 cupsdCleanJobs();
1013
1014 /*
1015 * Update any pending multi-file documents...
1016 */
1017
1018 if ((current_time - senddoc_time) >= 10)
1019 {
1020 cupsdCheckJobs();
1021 senddoc_time = current_time;
1022 }
1023
1024 /*
1025 * Check for new data on the client sockets...
1026 */
1027
1028 for (con = (cupsd_client_t *)cupsArrayFirst(Clients);
1029 con;
1030 con = (cupsd_client_t *)cupsArrayNext(Clients))
1031 {
1032 /*
1033 * Process pending data in the input buffer...
1034 */
1035
1036 if (httpGetReady(con->http))
1037 {
1038 cupsdReadClient(con);
1039 continue;
1040 }
1041
1042 /*
1043 * Check the activity and close old clients...
1044 */
1045
1046 activity = current_time - Timeout;
1047 if (httpGetActivity(con->http) < activity && !con->pipe_pid)
1048 {
1049 cupsdLogMessage(CUPSD_LOG_DEBUG, "Closing client %d after %d seconds of inactivity.", con->number, Timeout);
1050
1051 cupsdCloseClient(con);
1052 continue;
1053 }
1054 }
1055
1056 /*
1057 * Log statistics at most once a minute when in debug mode...
1058 */
1059
1060 if ((current_time - report_time) >= 60 && LogLevel >= CUPSD_LOG_DEBUG)
1061 {
1062 size_t string_count, /* String count */
1063 alloc_bytes, /* Allocated string bytes */
1064 total_bytes; /* Total string bytes */
1065 #ifdef HAVE_MALLINFO
1066 struct mallinfo mem; /* Malloc information */
1067
1068
1069 mem = mallinfo();
1070 cupsdLogMessage(CUPSD_LOG_DEBUG, "Report: malloc-arena=%lu", mem.arena);
1071 cupsdLogMessage(CUPSD_LOG_DEBUG, "Report: malloc-used=%lu",
1072 mem.usmblks + mem.uordblks);
1073 cupsdLogMessage(CUPSD_LOG_DEBUG, "Report: malloc-free=%lu",
1074 mem.fsmblks + mem.fordblks);
1075 #endif /* HAVE_MALLINFO */
1076
1077 cupsdLogMessage(CUPSD_LOG_DEBUG, "Report: clients=%d",
1078 cupsArrayCount(Clients));
1079 cupsdLogMessage(CUPSD_LOG_DEBUG, "Report: jobs=%d",
1080 cupsArrayCount(Jobs));
1081 cupsdLogMessage(CUPSD_LOG_DEBUG, "Report: jobs-active=%d",
1082 cupsArrayCount(ActiveJobs));
1083 cupsdLogMessage(CUPSD_LOG_DEBUG, "Report: printers=%d",
1084 cupsArrayCount(Printers));
1085
1086 string_count = _cupsStrStatistics(&alloc_bytes, &total_bytes);
1087 cupsdLogMessage(CUPSD_LOG_DEBUG,
1088 "Report: stringpool-string-count=" CUPS_LLFMT,
1089 CUPS_LLCAST string_count);
1090 cupsdLogMessage(CUPSD_LOG_DEBUG,
1091 "Report: stringpool-alloc-bytes=" CUPS_LLFMT,
1092 CUPS_LLCAST alloc_bytes);
1093 cupsdLogMessage(CUPSD_LOG_DEBUG,
1094 "Report: stringpool-total-bytes=" CUPS_LLFMT,
1095 CUPS_LLCAST total_bytes);
1096
1097 report_time = current_time;
1098 }
1099
1100 /*
1101 * Handle OS-specific event notification for any events that have
1102 * accumulated. Don't send these more than once a second...
1103 */
1104
1105 if (LastEvent && (current_time - event_time) >= 1)
1106 {
1107 #ifdef HAVE_NOTIFY_POST
1108 if (LastEvent & (CUPSD_EVENT_PRINTER_ADDED |
1109 CUPSD_EVENT_PRINTER_DELETED |
1110 CUPSD_EVENT_PRINTER_MODIFIED))
1111 {
1112 cupsdLogMessage(CUPSD_LOG_DEBUG2,
1113 "notify_post(\"com.apple.printerListChange\")");
1114 notify_post("com.apple.printerListChange");
1115 }
1116
1117 if (LastEvent & CUPSD_EVENT_PRINTER_STATE_CHANGED)
1118 {
1119 cupsdLogMessage(CUPSD_LOG_DEBUG2,
1120 "notify_post(\"com.apple.printerHistoryChange\")");
1121 notify_post("com.apple.printerHistoryChange");
1122 }
1123
1124 if (LastEvent & (CUPSD_EVENT_JOB_STATE_CHANGED |
1125 CUPSD_EVENT_JOB_CONFIG_CHANGED |
1126 CUPSD_EVENT_JOB_PROGRESS))
1127 {
1128 cupsdLogMessage(CUPSD_LOG_DEBUG2,
1129 "notify_post(\"com.apple.jobChange\")");
1130 notify_post("com.apple.jobChange");
1131 }
1132 #endif /* HAVE_NOTIFY_POST */
1133
1134 /*
1135 * Reset the accumulated events...
1136 */
1137
1138 LastEvent = CUPSD_EVENT_NONE;
1139 event_time = current_time;
1140 }
1141 }
1142
1143 /*
1144 * Log a message based on what happened...
1145 */
1146
1147 if (stop_scheduler)
1148 {
1149 cupsdLogMessage(CUPSD_LOG_INFO, "Scheduler shutting down normally.");
1150 cupsdAddEvent(CUPSD_EVENT_SERVER_STOPPED, NULL, NULL,
1151 "Scheduler shutting down normally.");
1152 }
1153 else
1154 {
1155 cupsdLogMessage(CUPSD_LOG_ERROR,
1156 "Scheduler shutting down due to program error.");
1157 cupsdAddEvent(CUPSD_EVENT_SERVER_STOPPED, NULL, NULL,
1158 "Scheduler shutting down due to program error.");
1159 }
1160
1161 /*
1162 * Close all network clients...
1163 */
1164
1165 DoingShutdown = 1;
1166
1167 cupsdStopServer();
1168
1169 /*
1170 * Update the KeepAlive/PID file as needed...
1171 */
1172
1173 service_checkout(1);
1174
1175 /*
1176 * Stop all jobs...
1177 */
1178
1179 cupsdFreeAllJobs();
1180
1181 /*
1182 * Delete all temporary printers...
1183 */
1184
1185 cupsdDeleteTemporaryPrinters(1);
1186
1187 #ifdef __APPLE__
1188 /*
1189 * Stop monitoring system event monitoring...
1190 */
1191
1192 if (use_sysman)
1193 cupsdStopSystemMonitor();
1194 #endif /* __APPLE__ */
1195
1196 cupsdStopSelect();
1197
1198 return (!stop_scheduler);
1199 }
1200
1201
1202 /*
1203 * 'cupsdAddString()' - Copy and add a string to an array.
1204 */
1205
1206 int /* O - 1 on success, 0 on failure */
cupsdAddString(cups_array_t ** a,const char * s)1207 cupsdAddString(cups_array_t **a, /* IO - String array */
1208 const char *s) /* I - String to copy and add */
1209 {
1210 if (!*a)
1211 *a = cupsArrayNew3((cups_array_func_t)strcmp, NULL,
1212 (cups_ahash_func_t)NULL, 0,
1213 (cups_acopy_func_t)strdup,
1214 (cups_afree_func_t)free);
1215
1216 return (cupsArrayAdd(*a, (char *)s));
1217 }
1218
1219
1220 /*
1221 * 'cupsdCheckProcess()' - Tell the main loop to check for dead children.
1222 */
1223
1224 void
cupsdCheckProcess(void)1225 cupsdCheckProcess(void)
1226 {
1227 /*
1228 * Flag that we have dead children...
1229 */
1230
1231 dead_children = 1;
1232 }
1233
1234
1235 /*
1236 * 'cupsdClearString()' - Clear a string.
1237 */
1238
1239 void
cupsdClearString(char ** s)1240 cupsdClearString(char **s) /* O - String value */
1241 {
1242 if (s && *s)
1243 {
1244 free(*s);
1245 *s = NULL;
1246 }
1247 }
1248
1249
1250 /*
1251 * 'cupsdFreeStrings()' - Free an array of strings.
1252 */
1253
1254 void
cupsdFreeStrings(cups_array_t ** a)1255 cupsdFreeStrings(cups_array_t **a) /* IO - String array */
1256 {
1257 if (*a)
1258 {
1259 cupsArrayDelete(*a);
1260 *a = NULL;
1261 }
1262 }
1263
1264
1265 /*
1266 * 'cupsdHoldSignals()' - Hold child and termination signals.
1267 */
1268
1269 void
cupsdHoldSignals(void)1270 cupsdHoldSignals(void)
1271 {
1272 #if defined(HAVE_SIGACTION) && !defined(HAVE_SIGSET)
1273 sigset_t newmask; /* New POSIX signal mask */
1274 #endif /* HAVE_SIGACTION && !HAVE_SIGSET */
1275
1276
1277 holdcount ++;
1278 if (holdcount > 1)
1279 return;
1280
1281 #ifdef HAVE_SIGSET
1282 sighold(SIGTERM);
1283 sighold(SIGCHLD);
1284 #elif defined(HAVE_SIGACTION)
1285 sigemptyset(&newmask);
1286 sigaddset(&newmask, SIGTERM);
1287 sigaddset(&newmask, SIGCHLD);
1288 sigprocmask(SIG_BLOCK, &newmask, &holdmask);
1289 #endif /* HAVE_SIGSET */
1290 }
1291
1292
1293 /*
1294 * 'cupsdReleaseSignals()' - Release signals for delivery.
1295 */
1296
1297 void
cupsdReleaseSignals(void)1298 cupsdReleaseSignals(void)
1299 {
1300 holdcount --;
1301 if (holdcount > 0)
1302 return;
1303
1304 #ifdef HAVE_SIGSET
1305 sigrelse(SIGTERM);
1306 sigrelse(SIGCHLD);
1307 #elif defined(HAVE_SIGACTION)
1308 sigprocmask(SIG_SETMASK, &holdmask, NULL);
1309 #endif /* HAVE_SIGSET */
1310 }
1311
1312
1313 /*
1314 * 'cupsdSetString()' - Set a string value.
1315 */
1316
1317 void
cupsdSetString(char ** s,const char * v)1318 cupsdSetString(char **s, /* O - New string */
1319 const char *v) /* I - String value */
1320 {
1321 if (!s || *s == v)
1322 return;
1323
1324 if (*s)
1325 free(*s);
1326
1327 if (v)
1328 *s = strdup(v);
1329 else
1330 *s = NULL;
1331 }
1332
1333
1334 /*
1335 * 'cupsdSetStringf()' - Set a formatted string value.
1336 */
1337
1338 void
cupsdSetStringf(char ** s,const char * f,...)1339 cupsdSetStringf(char **s, /* O - New string */
1340 const char *f, /* I - Printf-style format string */
1341 ...) /* I - Additional args as needed */
1342 {
1343 char v[65536 + 64]; /* Formatting string value */
1344 va_list ap; /* Argument pointer */
1345 char *olds; /* Old string */
1346
1347
1348 if (!s)
1349 return;
1350
1351 olds = *s;
1352
1353 if (f)
1354 {
1355 va_start(ap, f);
1356 vsnprintf(v, sizeof(v), f, ap);
1357 va_end(ap);
1358
1359 *s = strdup(v);
1360 }
1361 else
1362 *s = NULL;
1363
1364 if (olds)
1365 free(olds);
1366 }
1367
1368
1369 /*
1370 * 'parent_handler()' - Catch USR1/CHLD signals...
1371 */
1372
1373 static void
parent_handler(int sig)1374 parent_handler(int sig) /* I - Signal */
1375 {
1376 /*
1377 * Store the signal we got from the OS and return...
1378 */
1379
1380 parent_signal = sig;
1381 }
1382
1383
1384 /*
1385 * 'process_children()' - Process all dead children...
1386 */
1387
1388 static void
process_children(void)1389 process_children(void)
1390 {
1391 int status; /* Exit status of child */
1392 int pid, /* Process ID of child */
1393 job_id; /* Job ID of child */
1394 cupsd_job_t *job; /* Current job */
1395 int i; /* Looping var */
1396 char name[1024]; /* Process name */
1397 const char *type; /* Type of program */
1398
1399
1400 cupsdLogMessage(CUPSD_LOG_DEBUG2, "process_children()");
1401
1402 /*
1403 * Reset the dead_children flag...
1404 */
1405
1406 dead_children = 0;
1407
1408 /*
1409 * Collect the exit status of some children...
1410 */
1411
1412 #ifdef HAVE_WAITPID
1413 while ((pid = waitpid(-1, &status, WNOHANG)) > 0)
1414 #elif defined(HAVE_WAIT3)
1415 while ((pid = wait3(&status, WNOHANG, NULL)) > 0)
1416 #else
1417 if ((pid = wait(&status)) > 0)
1418 #endif /* HAVE_WAITPID */
1419 {
1420 /*
1421 * Collect the name of the process that finished...
1422 */
1423
1424 cupsdFinishProcess(pid, name, sizeof(name), &job_id);
1425
1426 /*
1427 * Delete certificates for CGI processes...
1428 */
1429
1430 if (pid)
1431 cupsdDeleteCert(pid);
1432
1433 /*
1434 * Handle completed job filters...
1435 */
1436
1437 if (job_id > 0)
1438 job = cupsdFindJob(job_id);
1439 else
1440 job = NULL;
1441
1442 if (job)
1443 {
1444 for (i = 0; job->filters[i]; i ++)
1445 if (job->filters[i] == pid)
1446 break;
1447
1448 if (job->filters[i] || job->backend == pid)
1449 {
1450 /*
1451 * OK, this process has gone away; what's left?
1452 */
1453
1454 if (job->filters[i])
1455 {
1456 job->filters[i] = -pid;
1457 type = "Filter";
1458 }
1459 else
1460 {
1461 job->backend = -pid;
1462 type = "Backend";
1463 }
1464
1465 if (status && status != SIGTERM && status != SIGKILL &&
1466 status != SIGPIPE)
1467 {
1468 /*
1469 * An error occurred; save the exit status so we know to stop
1470 * the printer or cancel the job when all of the filters finish...
1471 *
1472 * A negative status indicates that the backend failed and the
1473 * printer needs to be stopped.
1474 *
1475 * In order to preserve the most serious status, we always log
1476 * when a process dies due to a signal (e.g. SIGABRT, SIGSEGV,
1477 * and SIGBUS) and prefer to log the backend exit status over a
1478 * filter's.
1479 */
1480
1481 int old_status = abs(job->status);
1482
1483 if (WIFSIGNALED(status) || /* This process crashed, or */
1484 !job->status || /* No process had a status, or */
1485 (!job->filters[i] && WIFEXITED(old_status)))
1486 { /* Backend and filter didn't crash */
1487 if (job->filters[i])
1488 {
1489 job->status = status; /* Filter failed */
1490 }
1491 else
1492 {
1493 job->status = -status; /* Backend failed */
1494
1495 if (job->current_file < job->num_files)
1496 cupsdSetJobState(job, IPP_JOB_ABORTED, CUPSD_JOB_FORCE, "Canceling multi-file job due to backend failure.");
1497 }
1498 }
1499
1500 if (job->state_value == IPP_JOB_PROCESSING &&
1501 job->status_level > CUPSD_LOG_ERROR &&
1502 (job->filters[i] || !WIFEXITED(status)))
1503 {
1504 char message[1024]; /* New printer-state-message */
1505
1506
1507 job->status_level = CUPSD_LOG_ERROR;
1508
1509 snprintf(message, sizeof(message), "%s failed", type);
1510
1511 if (job->printer)
1512 {
1513 strlcpy(job->printer->state_message, message,
1514 sizeof(job->printer->state_message));
1515 }
1516
1517 if (!job->attrs)
1518 cupsdLoadJob(job);
1519
1520 if (!job->printer_message && job->attrs)
1521 {
1522 if ((job->printer_message =
1523 ippFindAttribute(job->attrs, "job-printer-state-message",
1524 IPP_TAG_TEXT)) == NULL)
1525 job->printer_message = ippAddString(job->attrs, IPP_TAG_JOB,
1526 IPP_TAG_TEXT,
1527 "job-printer-state-message",
1528 NULL, NULL);
1529 }
1530
1531 if (job->printer_message)
1532 ippSetString(job->attrs, &job->printer_message, 0, message);
1533 }
1534 }
1535
1536 /*
1537 * If this is not the last file in a job, see if all of the
1538 * filters are done, and if so move to the next file.
1539 */
1540
1541 if (job->state_value >= IPP_JOB_CANCELED)
1542 {
1543 /*
1544 * Remove the job from the active list if there are no processes still
1545 * running for it...
1546 */
1547
1548 for (i = 0; job->filters[i] < 0; i++);
1549
1550 if (!job->filters[i] && job->backend <= 0)
1551 cupsArrayRemove(ActiveJobs, job);
1552 }
1553 else if (job->current_file < job->num_files && job->printer)
1554 {
1555 for (i = 0; job->filters[i] < 0; i ++);
1556
1557 if (!job->filters[i] &&
1558 (!job->printer->pc || !job->printer->pc->single_file ||
1559 job->backend <= 0))
1560 {
1561 /*
1562 * Process the next file...
1563 */
1564
1565 cupsdContinueJob(job);
1566 }
1567 }
1568 }
1569 }
1570
1571 /*
1572 * Show the exit status as needed, ignoring SIGTERM and SIGKILL errors
1573 * since they come when we kill/end a process...
1574 */
1575
1576 if (status == SIGTERM || status == SIGKILL)
1577 {
1578 cupsdLogJob(job, CUPSD_LOG_DEBUG,
1579 "PID %d (%s) was terminated normally with signal %d.", pid,
1580 name, status);
1581 }
1582 else if (status == SIGPIPE)
1583 {
1584 cupsdLogJob(job, CUPSD_LOG_DEBUG,
1585 "PID %d (%s) did not catch or ignore signal %d.", pid, name,
1586 status);
1587 }
1588 else if (status)
1589 {
1590 if (WIFEXITED(status))
1591 {
1592 int code = WEXITSTATUS(status); /* Exit code */
1593
1594 if (code > 100)
1595 cupsdLogJob(job, CUPSD_LOG_DEBUG,
1596 "PID %d (%s) stopped with status %d (%s)", pid, name,
1597 code, strerror(code - 100));
1598 else
1599 cupsdLogJob(job, CUPSD_LOG_DEBUG,
1600 "PID %d (%s) stopped with status %d.", pid, name, code);
1601 }
1602 else
1603 cupsdLogJob(job, CUPSD_LOG_DEBUG, "PID %d (%s) crashed on signal %d.",
1604 pid, name, WTERMSIG(status));
1605
1606 if (LogLevel < CUPSD_LOG_DEBUG)
1607 cupsdLogJob(job, CUPSD_LOG_INFO,
1608 "Hint: Try setting the LogLevel to \"debug\" to find out "
1609 "more.");
1610 }
1611 else
1612 cupsdLogJob(job, CUPSD_LOG_DEBUG, "PID %d (%s) exited with no errors.",
1613 pid, name);
1614 }
1615
1616 /*
1617 * If wait*() is interrupted by a signal, tell main() to call us again...
1618 */
1619
1620 if (pid < 0 && errno == EINTR)
1621 dead_children = 1;
1622 }
1623
1624
1625 /*
1626 * 'select_timeout()' - Calculate the select timeout value.
1627 *
1628 */
1629
1630 static long /* O - Number of seconds */
select_timeout(int fds)1631 select_timeout(int fds) /* I - Number of descriptors returned */
1632 {
1633 long timeout; /* Timeout for select */
1634 time_t now; /* Current time */
1635 cupsd_client_t *con; /* Client information */
1636 cupsd_job_t *job; /* Job information */
1637 const char *why; /* Debugging aid */
1638
1639
1640 cupsdLogMessage(CUPSD_LOG_DEBUG2, "select_timeout: JobHistoryUpdate=%ld",
1641 (long)JobHistoryUpdate);
1642
1643 /*
1644 * Check to see if any of the clients have pending data to be
1645 * processed; if so, the timeout should be 0...
1646 */
1647
1648 for (con = (cupsd_client_t *)cupsArrayFirst(Clients);
1649 con;
1650 con = (cupsd_client_t *)cupsArrayNext(Clients))
1651 if (httpGetReady(con->http))
1652 return (0);
1653
1654 /*
1655 * If select has been active in the last second (fds > 0) or we have
1656 * many resources in use then don't bother trying to optimize the
1657 * timeout, just make it 1 second.
1658 */
1659
1660 if (fds > 0 || cupsArrayCount(Clients) > 50)
1661 return (1);
1662
1663 /*
1664 * Otherwise, check all of the possible events that we need to wake for...
1665 */
1666
1667 now = time(NULL);
1668 timeout = now + 86400; /* 86400 == 1 day */
1669 why = "do nothing";
1670
1671 #ifdef __APPLE__
1672 /*
1673 * When going to sleep, wake up to abort jobs that don't complete in time.
1674 */
1675
1676 if (SleepJobs > 0 && SleepJobs < timeout)
1677 {
1678 timeout = SleepJobs;
1679 why = "abort jobs before sleeping";
1680 }
1681 #endif /* __APPLE__ */
1682
1683 /*
1684 * Check whether we are accepting new connections...
1685 */
1686
1687 if (ListeningPaused > 0 && cupsArrayCount(Clients) < MaxClients &&
1688 ListeningPaused < timeout)
1689 {
1690 if (ListeningPaused <= now)
1691 timeout = now;
1692 else
1693 timeout = ListeningPaused;
1694
1695 why = "resume listening";
1696 }
1697
1698 /*
1699 * Check the activity and close old clients...
1700 */
1701
1702 for (con = (cupsd_client_t *)cupsArrayFirst(Clients);
1703 con;
1704 con = (cupsd_client_t *)cupsArrayNext(Clients))
1705 if ((httpGetActivity(con->http) + Timeout) < timeout)
1706 {
1707 timeout = httpGetActivity(con->http) + Timeout;
1708 why = "timeout a client connection";
1709 }
1710
1711 /*
1712 * Write out changes to configuration and state files...
1713 */
1714
1715 if (DirtyCleanTime && timeout > DirtyCleanTime)
1716 {
1717 timeout = DirtyCleanTime;
1718 why = "write dirty config/state files";
1719 }
1720
1721 /*
1722 * Check for any job activity...
1723 */
1724
1725 for (job = (cupsd_job_t *)cupsArrayFirst(ActiveJobs);
1726 job;
1727 job = (cupsd_job_t *)cupsArrayNext(ActiveJobs))
1728 {
1729 if (job->cancel_time && job->cancel_time < timeout)
1730 {
1731 timeout = job->cancel_time;
1732 why = "cancel stuck jobs";
1733 }
1734
1735 if (job->kill_time && job->kill_time < timeout)
1736 {
1737 timeout = job->kill_time;
1738 why = "kill unresponsive jobs";
1739 }
1740
1741 if (job->state_value == IPP_JOB_HELD && job->hold_until < timeout)
1742 {
1743 timeout = job->hold_until;
1744 why = "release held jobs";
1745 }
1746
1747 if (job->state_value == IPP_JOB_PENDING && timeout > (now + 10))
1748 {
1749 timeout = now + 10;
1750 why = "start pending jobs";
1751 break;
1752 }
1753 }
1754
1755 /*
1756 * Adjust from absolute to relative time. We add 1 second to the timeout since
1757 * events occur after the timeout expires, and limit the timeout to 86400
1758 * seconds (1 day) to avoid select() timeout limits present on some operating
1759 * systems...
1760 */
1761
1762 timeout = timeout - now + 1;
1763
1764 if (timeout < 1)
1765 timeout = 1;
1766 else if (timeout > 86400)
1767 timeout = 86400;
1768
1769 /*
1770 * Log and return the timeout value...
1771 */
1772
1773 cupsdLogMessage(CUPSD_LOG_DEBUG2, "select_timeout(%d): %ld seconds to %s",
1774 fds, timeout, why);
1775
1776 return (timeout);
1777 }
1778
1779
1780 /*
1781 * 'sigchld_handler()' - Handle 'child' signals from old processes.
1782 */
1783
1784 static void
sigchld_handler(int sig)1785 sigchld_handler(int sig) /* I - Signal number */
1786 {
1787 (void)sig;
1788
1789 /*
1790 * Flag that we have dead children...
1791 */
1792
1793 dead_children = 1;
1794
1795 /*
1796 * Reset the signal handler as needed...
1797 */
1798
1799 #if !defined(HAVE_SIGSET) && !defined(HAVE_SIGACTION)
1800 signal(SIGCLD, sigchld_handler);
1801 #endif /* !HAVE_SIGSET && !HAVE_SIGACTION */
1802 }
1803
1804
1805 /*
1806 * 'sighup_handler()' - Handle 'hangup' signals to reconfigure the scheduler.
1807 */
1808
1809 static void
sighup_handler(int sig)1810 sighup_handler(int sig) /* I - Signal number */
1811 {
1812 (void)sig;
1813
1814 NeedReload = RELOAD_ALL;
1815 ReloadTime = time(NULL);
1816
1817 #if !defined(HAVE_SIGSET) && !defined(HAVE_SIGACTION)
1818 signal(SIGHUP, sighup_handler);
1819 #endif /* !HAVE_SIGSET && !HAVE_SIGACTION */
1820 }
1821
1822
1823 /*
1824 * 'sigterm_handler()' - Handle 'terminate' signals that stop the scheduler.
1825 */
1826
1827 static void
sigterm_handler(int sig)1828 sigterm_handler(int sig) /* I - Signal number */
1829 {
1830 (void)sig; /* remove compiler warnings... */
1831
1832 /*
1833 * Flag that we should stop and return...
1834 */
1835
1836 stop_scheduler = 1;
1837 }
1838
1839
1840 #ifdef HAVE_ONDEMAND
1841 /*
1842 * 'service_add_listener()' - Bind an open fd as a Listener.
1843 */
1844
1845 static void
service_add_listener(int fd,int idx)1846 service_add_listener(int fd, /* I - Socket file descriptor */
1847 int idx) /* I - Listener number, for logging */
1848 {
1849 cupsd_listener_t *lis; /* Listeners array */
1850 http_addr_t addr; /* Address variable */
1851 socklen_t addrlen; /* Length of address */
1852 char s[256]; /* String addresss */
1853
1854
1855 addrlen = sizeof(addr);
1856
1857 if (getsockname(fd, (struct sockaddr *)&addr, &addrlen))
1858 {
1859 cupsdLogMessage(CUPSD_LOG_ERROR, "service_add_listener: Unable to get local address for listener #%d: %s", idx + 1, strerror(errno));
1860 return;
1861 }
1862
1863 cupsdLogMessage(CUPSD_LOG_DEBUG, "service_add_listener: Listener #%d at fd %d, \"%s\".", idx + 1, fd, httpAddrString(&addr, s, sizeof(s)));
1864
1865 /*
1866 * Try to match the on-demand socket address to one of the listeners...
1867 */
1868
1869 for (lis = (cupsd_listener_t *)cupsArrayFirst(Listeners);
1870 lis;
1871 lis = (cupsd_listener_t *)cupsArrayNext(Listeners))
1872 if (httpAddrEqual(&lis->address, &addr))
1873 break;
1874
1875 /*
1876 * Add a new listener If there's no match...
1877 */
1878
1879 if (lis)
1880 {
1881 cupsdLogMessage(CUPSD_LOG_DEBUG, "service_add_listener: Matched existing listener #%d to %s.", idx + 1, httpAddrString(&(lis->address), s, sizeof(s)));
1882 }
1883 else
1884 {
1885 cupsdLogMessage(CUPSD_LOG_DEBUG, "service_add_listener: Adding new listener #%d for %s.", idx + 1, httpAddrString(&addr, s, sizeof(s)));
1886
1887 if ((lis = calloc(1, sizeof(cupsd_listener_t))) == NULL)
1888 {
1889 cupsdLogMessage(CUPSD_LOG_ERROR, "service_add_listener: Unable to allocate listener: %s.", strerror(errno));
1890 exit(EXIT_FAILURE);
1891 return;
1892 }
1893
1894 cupsArrayAdd(Listeners, lis);
1895
1896 memcpy(&lis->address, &addr, sizeof(lis->address));
1897 }
1898
1899 lis->fd = fd;
1900 lis->on_demand = 1;
1901
1902 # ifdef HAVE_SSL
1903 if (httpAddrPort(&(lis->address)) == 443)
1904 lis->encryption = HTTP_ENCRYPT_ALWAYS;
1905 # endif /* HAVE_SSL */
1906 }
1907 #endif /* HAVE_ONDEMAND */
1908
1909
1910 /*
1911 * 'service_checkin()' - Check-in with launchd and collect the listening fds.
1912 */
1913
1914 static void
service_checkin(void)1915 service_checkin(void)
1916 {
1917 cupsdLogMessage(CUPSD_LOG_DEBUG, "service_checkin: pid=%d", (int)getpid());
1918
1919 #ifdef HAVE_LAUNCHD
1920 if (OnDemand)
1921 {
1922 int error; /* Check-in error, if any */
1923 size_t i, /* Looping var */
1924 count; /* Number of listeners */
1925 int *ld_sockets; /* Listener sockets */
1926
1927 # ifdef __APPLE__
1928 /*
1929 * Force "user initiated" priority for the main thread...
1930 */
1931
1932 pthread_set_qos_class_self_np(QOS_CLASS_USER_INITIATED, 0);
1933 # endif /* __APPLE__ */
1934
1935 /*
1936 * Check-in with launchd...
1937 */
1938
1939 if ((error = launch_activate_socket("Listeners", &ld_sockets, &count)) != 0)
1940 {
1941 cupsdLogMessage(CUPSD_LOG_ERROR, "service_checkin: Unable to get listener sockets: %s", strerror(error));
1942 exit(EXIT_FAILURE);
1943 return; /* anti-compiler-warning */
1944 }
1945
1946 /*
1947 * Try to match the launchd sockets to the cupsd listeners...
1948 */
1949
1950 cupsdLogMessage(CUPSD_LOG_DEBUG, "service_checkin: %d listeners.", (int)count);
1951
1952 for (i = 0; i < count; i ++)
1953 service_add_listener(ld_sockets[i], (int)i);
1954
1955 free(ld_sockets);
1956
1957 # ifdef __APPLE__
1958 xpc_transaction_begin();
1959 # endif /* __APPLE__ */
1960 }
1961
1962 #elif defined(HAVE_SYSTEMD)
1963 if (OnDemand)
1964 {
1965 int i, /* Looping var */
1966 count; /* Number of listeners */
1967
1968 /*
1969 * Check-in with systemd...
1970 */
1971
1972 if ((count = sd_listen_fds(0)) < 0)
1973 {
1974 cupsdLogMessage(CUPSD_LOG_ERROR, "service_checkin: Unable to get listener sockets: %s", strerror(-count));
1975 exit(EXIT_FAILURE);
1976 return; /* anti-compiler-warning */
1977 }
1978
1979 /*
1980 * Try to match the systemd sockets to the cupsd listeners...
1981 */
1982
1983 cupsdLogMessage(CUPSD_LOG_DEBUG, "service_checkin: %d listeners.", count);
1984
1985 for (i = 0; i < count; i ++)
1986 service_add_listener(SD_LISTEN_FDS_START + i, i);
1987 }
1988
1989 #elif defined(HAVE_UPSTART)
1990 if (OnDemand)
1991 {
1992 const char *e; /* Environment var */
1993 int fd; /* File descriptor */
1994
1995
1996 if (!(e = getenv("UPSTART_EVENTS")))
1997 {
1998 cupsdLogMessage(CUPSD_LOG_ERROR, "service_checkin: We did not get started via Upstart.");
1999 exit(EXIT_FAILURE);
2000 return;
2001 }
2002
2003 if (strcasecmp(e, "socket"))
2004 {
2005 cupsdLogMessage(CUPSD_LOG_ERROR, "service_checkin: We did not get triggered via an Upstart socket event.");
2006 exit(EXIT_FAILURE);
2007 return;
2008 }
2009
2010 if ((e = getenv("UPSTART_FDS")) == NULL)
2011 {
2012 cupsdLogMessage(CUPSD_LOG_ERROR, "service_checkin: Unable to get listener sockets from UPSTART_FDS.");
2013 exit(EXIT_FAILURE);
2014 return;
2015 }
2016
2017 cupsdLogMessage(CUPSD_LOG_DEBUG, "service_checkin: UPSTART_FDS=%s", e);
2018
2019 fd = (int)strtol(e, NULL, 10);
2020 if (fd < 0)
2021 {
2022 cupsdLogMessage(CUPSD_LOG_ERROR, "service_checkin: Could not parse UPSTART_FDS: %s", strerror(errno));
2023 exit(EXIT_FAILURE);
2024 return;
2025 }
2026
2027 /*
2028 * Upstart only supportst a single on-demand socket file descriptor...
2029 */
2030
2031 service_add_listener(fd, 0);
2032 }
2033 #endif /* HAVE_LAUNCHD */
2034 }
2035
2036
2037 /*
2038 * 'service_checkout()' - Update the KeepAlive/PID file as needed.
2039 */
2040
2041 static void
service_checkout(int shutdown)2042 service_checkout(int shutdown) /* I - Shutting down? */
2043 {
2044 cups_file_t *fp; /* File */
2045 char pidfile[1024]; /* PID/KeepAlive file */
2046
2047
2048 /*
2049 * When running on-demand, use the KeepAlive file, otherwise write a PID file
2050 * to StateDir...
2051 */
2052
2053 #ifdef HAVE_ONDEMAND
2054 if (OnDemand)
2055 {
2056 int shared_printers = 0; /* Do we have shared printers? */
2057
2058 strlcpy(pidfile, CUPS_KEEPALIVE, sizeof(pidfile));
2059
2060 /*
2061 * If printer sharing is on see if there are any actual shared printers...
2062 */
2063
2064 if (Browsing && BrowseLocalProtocols)
2065 {
2066 cupsd_printer_t *p = NULL; /* Current printer */
2067
2068 for (p = (cupsd_printer_t *)cupsArrayFirst(Printers); p; p = (cupsd_printer_t *)cupsArrayNext(Printers))
2069 {
2070 if (p->shared)
2071 break;
2072 }
2073
2074 shared_printers = (p != NULL);
2075 }
2076
2077 if (cupsArrayCount(ActiveJobs) || /* Active jobs */
2078 WebInterface || /* Web interface enabled */
2079 NeedReload || /* Doing a reload */
2080 shared_printers) /* Printers being shared */
2081 {
2082 /*
2083 * Create or remove the "keep-alive" file based on whether there are active
2084 * jobs or shared printers to advertise...
2085 */
2086
2087 shutdown = 0;
2088 }
2089 }
2090 else
2091 #endif /* HAVE_ONDEMAND */
2092 snprintf(pidfile, sizeof(pidfile), "%s/cupsd.pid", StateDir);
2093
2094 if (shutdown)
2095 {
2096 cupsdLogMessage(CUPSD_LOG_DEBUG, "Removing KeepAlive/PID file \"%s\".", pidfile);
2097
2098 unlink(pidfile);
2099 }
2100 else
2101 {
2102 cupsdLogMessage(CUPSD_LOG_DEBUG, "Creating KeepAlive/PID file \"%s\".", pidfile);
2103
2104 if ((fp = cupsFileOpen(pidfile, "w")) != NULL)
2105 {
2106 /*
2107 * Save the PID in the file...
2108 */
2109
2110 cupsFilePrintf(fp, "%d\n", (int)getpid());
2111 cupsFileClose(fp);
2112 }
2113 else
2114 cupsdLogMessage(CUPSD_LOG_ERROR, "Unable to create KeepAlive/PID file \"%s\": %s", pidfile, strerror(errno));
2115 }
2116
2117 # ifdef __APPLE__
2118 if (OnDemand && shutdown)
2119 xpc_transaction_end();
2120 # endif /* __APPLE__ */
2121 }
2122
2123
2124 /*
2125 * 'usage()' - Show scheduler usage.
2126 */
2127
2128 static void
usage(int status)2129 usage(int status) /* O - Exit status */
2130 {
2131 FILE *fp = status ? stderr : stdout; /* Output file */
2132
2133
2134 _cupsLangPuts(fp, _("Usage: cupsd [options]"));
2135 _cupsLangPuts(fp, _("Options:"));
2136 _cupsLangPuts(fp, _("-c cupsd.conf Set cupsd.conf file to use."));
2137 _cupsLangPuts(fp, _("-f Run in the foreground."));
2138 _cupsLangPuts(fp, _("-F Run in the foreground but detach from console."));
2139 _cupsLangPuts(fp, _("-h Show this usage message."));
2140 #ifdef HAVE_ONDEMAND
2141 _cupsLangPuts(fp, _("-l Run cupsd on demand."));
2142 #endif /* HAVE_ONDEMAND */
2143 _cupsLangPuts(fp, _("-s cups-files.conf Set cups-files.conf file to use."));
2144 _cupsLangPuts(fp, _("-t Test the configuration file."));
2145
2146 exit(status);
2147 }
2148