]>
git.ipfire.org Git - thirdparty/cups.git/blob - scheduler/process.c
2 * "$Id: process.c 7256 2008-01-25 00:48:54Z mike $"
4 * Process management routines for the Common UNIX Printing System (CUPS).
6 * Copyright 2007 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/".
17 * cupsdCreateProfile() - Create an execution profile for a subprocess.
18 * cupsdDestroyProfile() - Delete an execution profile.
19 * cupsdEndProcess() - End a process.
20 * cupsdFinishProcess() - Finish a process and get its name.
21 * cupsdStartProcess() - Start a process.
22 * compare_procs() - Compare two processes.
23 * cupsd_requote() - Make a regular-expression version of a string.
27 * Include necessary headers...
34 #endif /* __APPLE__ */
36 # define __APPLE_API_PRIVATE
38 #endif /* HAVE_SANDBOX_H */
42 * Process structure...
47 int pid
; /* Process ID */
48 char name
[1]; /* Name of process */
56 static cups_array_t
*process_array
= NULL
;
63 static int compare_procs(cupsd_proc_t
*a
, cupsd_proc_t
*b
);
65 static char *cupsd_requote(char *dst
, const char *src
, size_t dstsize
);
66 #endif /* HAVE_SANDBOX_H */
70 * 'cupsdCreateProfile()' - Create an execution profile for a subprocess.
73 void * /* O - Profile or NULL on error */
74 cupsdCreateProfile(int job_id
) /* I - Job ID or 0 for none */
77 cups_file_t
*fp
; /* File pointer */
78 char profile
[1024], /* File containing the profile */
79 cache
[1024], /* Quoted CacheDir */
80 request
[1024], /* Quoted RequestRoot */
81 root
[1024], /* Quoted ServerRoot */
82 temp
[1024]; /* Quoted TempDir */
85 if ((fp
= cupsTempFile2(profile
, sizeof(profile
))) == NULL
)
87 cupsdLogMessage(CUPSD_LOG_ERROR
, "Unable to create security profile: %s",
92 cupsd_requote(cache
, CacheDir
, sizeof(cache
));
93 cupsd_requote(request
, RequestRoot
, sizeof(request
));
94 cupsd_requote(root
, ServerRoot
, sizeof(root
));
95 cupsd_requote(temp
, TempDir
, sizeof(temp
));
97 cupsFilePuts(fp
, "(version 1)\n");
98 cupsFilePuts(fp
, "(debug deny)\n");
99 cupsFilePuts(fp
, "(allow default)\n");
101 "(deny file-write* file-read-data file-read-metadata\n"
102 " (regex #\"^%s/\"))\n", request
);
104 "(deny file-write*\n"
105 " (regex #\"^%s\" #\"^/private/etc\" #\"^/usr/local/etc\" "
106 "#\"^/Library\" #\"^/System\" #\"^/Users\"))\n", root
);
108 "(allow file-write* file-read-data file-read-metadata\n"
109 " (regex #\"^%s$\" #\"^%s/\" #\"^%s$\" #\"^%s/\" "
110 "#\"^/Library/Caches/\"))\n",
111 temp
, temp
, cache
, cache
);
114 "(allow file-read-data file-read-metadata\n"
115 " (regex #\"^%s/([ac]%05d|d%05d-[0-9][0-9][0-9])$\"))\n",
116 request
, job_id
, job_id
);
120 cupsdLogMessage(CUPSD_LOG_DEBUG2
, "cupsdCreateProfile(job_id=%d) = \"%s\"",
122 return ((void *)strdup(profile
));
126 #endif /* HAVE_SANDBOX_H */
131 * 'cupsdDestroyProfile()' - Delete an execution profile.
135 cupsdDestroyProfile(void *profile
) /* I - Profile */
137 #ifdef HAVE_SANDBOX_H
140 cupsdLogMessage(CUPSD_LOG_DEBUG2
, "cupsdDeleteProfile(profile=\"%s\")",
142 unlink((char *)profile
);
145 #endif /* HAVE_SANDBOX_H */
150 * 'cupsdEndProcess()' - End a process.
153 int /* O - 0 on success, -1 on failure */
154 cupsdEndProcess(int pid
, /* I - Process ID */
155 int force
) /* I - Force child to die */
158 return (kill(pid
, SIGKILL
));
160 return (kill(pid
, SIGTERM
));
165 * 'cupsdFinishProcess()' - Finish a process and get its name.
168 const char * /* O - Process name */
169 cupsdFinishProcess(int pid
, /* I - Process ID */
170 char *name
, /* I - Name buffer */
171 int namelen
) /* I - Size of name buffer */
173 cupsd_proc_t key
, /* Search key */
174 *proc
; /* Matching process */
179 if ((proc
= (cupsd_proc_t
*)cupsArrayFind(process_array
, &key
)) != NULL
)
181 strlcpy(name
, proc
->name
, namelen
);
182 cupsArrayRemove(process_array
, proc
);
193 * 'cupsdStartProcess()' - Start a process.
196 int /* O - Process ID or 0 */
198 const char *command
, /* I - Full path to command */
199 char *argv
[], /* I - Command-line arguments */
200 char *envp
[], /* I - Environment */
201 int infd
, /* I - Standard input file descriptor */
202 int outfd
, /* I - Standard output file descriptor */
203 int errfd
, /* I - Standard error file descriptor */
204 int backfd
, /* I - Backchannel file descriptor */
205 int sidefd
, /* I - Sidechannel file descriptor */
206 int root
, /* I - Run as root? */
207 void *profile
, /* I - Security profile to use */
208 int *pid
) /* O - Process ID */
210 cupsd_proc_t
*proc
; /* New process record */
211 #if defined(HAVE_SIGACTION) && !defined(HAVE_SIGSET)
212 struct sigaction action
; /* POSIX signal handler */
213 #endif /* HAVE_SIGACTION && !HAVE_SIGSET */
214 #if defined(__APPLE__)
215 char processPath
[1024], /* CFProcessPath environment variable */
216 linkpath
[1024]; /* Link path for symlinks... */
217 int linkbytes
; /* Bytes for link path */
218 #endif /* __APPLE__ */
221 cupsdLogMessage(CUPSD_LOG_DEBUG2
,
222 "cupsdStartProcess(\"%s\", %p, %p, %d, %d, %d)",
223 command
, argv
, envp
, infd
, outfd
, errfd
);
225 if (access(command
, X_OK
))
227 cupsdLogMessage(CUPSD_LOG_ERROR
, "Unable to execute %s: %s", command
,
233 #if defined(__APPLE__)
237 * Add special voodoo magic for MacOS X - this allows MacOS X
238 * programs to access their bundle resources properly...
241 if ((linkbytes
= readlink(command
, linkpath
, sizeof(linkpath
) - 1)) > 0)
244 * Yes, this is a symlink to the actual program, nul-terminate and
248 linkpath
[linkbytes
] = '\0';
250 if (linkpath
[0] == '/')
251 snprintf(processPath
, sizeof(processPath
), "CFProcessPath=%s",
254 snprintf(processPath
, sizeof(processPath
), "CFProcessPath=%s/%s",
255 dirname((char *)command
), linkpath
);
258 snprintf(processPath
, sizeof(processPath
), "CFProcessPath=%s", command
);
260 envp
[0] = processPath
; /* Replace <CFProcessPath> string */
262 #endif /* __APPLE__ */
265 * Block signals before forking...
270 if ((*pid
= fork()) == 0)
273 * Child process goes here...
275 * Update stdin/stdout/stderr as needed...
284 open("/dev/null", O_RDONLY
);
292 open("/dev/null", O_WRONLY
);
300 open("/dev/null", O_WRONLY
);
308 open("/dev/null", O_RDWR
);
309 fcntl(3, F_SETFL
, O_NDELAY
);
311 if (sidefd
!= 4 && sidefd
> 0)
315 fcntl(4, F_SETFL
, O_NDELAY
);
319 * Change the priority of the process based on the FilterNice setting.
320 * (this is not done for root processes...)
326 #ifdef HAVE_SANDBOX_H
328 * Run in a separate security profile...
333 char *error
= NULL
; /* Sandbox error, if any */
335 if (sandbox_init((char *)profile
, SANDBOX_NAMED_EXTERNAL
, &error
))
337 fprintf(stderr
, "ERROR: sandbox_init failed: %s (%s)\n", error
,
339 sandbox_free_error(error
);
342 #endif /* HAVE_SANDBOX_H */
345 * Change user to something "safe"...
348 if (!root
&& !RunUser
)
351 * Running as root, so change to non-priviledged user...
357 if (setgroups(1, &Group
))
366 * Reset group membership to just the main one we belong to.
370 setgroups(1, &Group
);
374 * Change umask to restrict permissions on created files...
380 * Unblock signals before doing the exec...
384 sigset(SIGTERM
, SIG_DFL
);
385 sigset(SIGCHLD
, SIG_DFL
);
386 #elif defined(HAVE_SIGACTION)
387 memset(&action
, 0, sizeof(action
));
389 sigemptyset(&action
.sa_mask
);
390 action
.sa_handler
= SIG_DFL
;
392 sigaction(SIGTERM
, &action
, NULL
);
393 sigaction(SIGCHLD
, &action
, NULL
);
395 signal(SIGTERM
, SIG_DFL
);
396 signal(SIGCHLD
, SIG_DFL
);
397 #endif /* HAVE_SIGSET */
399 cupsdReleaseSignals();
402 * Execute the command; if for some reason this doesn't work,
403 * return the error code...
407 execve(command
, argv
, envp
);
409 execv(command
, argv
);
418 * Error - couldn't fork a new process!
421 cupsdLogMessage(CUPSD_LOG_ERROR
, "Unable to fork %s - %s.", command
,
429 process_array
= cupsArrayNew((cups_array_func_t
)compare_procs
, NULL
);
433 if ((proc
= calloc(1, sizeof(cupsd_proc_t
) + strlen(command
))) != NULL
)
436 strcpy(proc
->name
, command
);
438 cupsArrayAdd(process_array
, proc
);
443 cupsdReleaseSignals();
450 * 'compare_procs()' - Compare two processes.
453 static int /* O - Result of comparison */
454 compare_procs(cupsd_proc_t
*a
, /* I - First process */
455 cupsd_proc_t
*b
) /* I - Second process */
457 return (a
->pid
- b
->pid
);
461 #ifdef HAVE_SANDBOX_H
463 * 'cupsd_requote()' - Make a regular-expression version of a string.
466 static char * /* O - Quoted string */
467 cupsd_requote(char *dst
, /* I - Destination buffer */
468 const char *src
, /* I - Source string */
469 size_t dstsize
) /* I - Size of destination buffer */
471 int ch
; /* Current character */
472 char *dstptr
, /* Current position in buffer */
473 *dstend
; /* End of destination buffer */
477 dstend
= dst
+ dstsize
- 2;
479 while (*src
&& dstptr
< dstend
)
483 if (strchr(".?*()[]^$\\", ch
))
493 #endif /* HAVE_SANDBOX_H */
497 * End of "$Id: process.c 7256 2008-01-25 00:48:54Z mike $".