5 Copyright (C) 1996-2020
6 Free Software Foundation, Inc.
11 This file is part of the Midnight Commander.
13 The Midnight Commander is free software: you can redistribute it
14 and/or modify it under the terms of the GNU General Public License as
15 published by the Free Software Foundation, either version 3 of the License,
16 or (at your option) any later version.
18 The Midnight Commander is distributed in the hope that it will be useful,
19 but WITHOUT ANY WARRANTY; without even the implied warranty of
20 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 GNU General Public License for more details.
23 You should have received a copy of the GNU General Public License
24 along with this program. If not, see <http://www.gnu.org/licenses/>.
29 /** \file background.c
30 * \brief Source: Background support
42 #include <sys/types.h>
44 #include <sys/wait.h> /* waitpid() */
46 #include "lib/global.h"
48 #include "lib/unixcompat.h"
49 #include "lib/tty/key.h" /* add_select_channel(), delete_select_channel() */
50 #include "lib/widget.h" /* message() */
51 #include "lib/event-types.h"
53 #include "filemanager/fileopctx.h" /* file_op_context_t */
55 #include "background.h"
57 /*** global variables ****************************************************************************/
59 #define MAXCALLARGS 4 /* Number of arguments supported */
61 /*** file scope macro definitions ****************************************************************/
63 /*** file scope type declarations ****************************************************************/
71 /*** file scope variables ************************************************************************/
73 /* File descriptor for talking to our parent */
76 /* File descriptor for messages from our parent */
77 static int from_parent_fd
;
79 TaskList
*task_list
= NULL
;
81 static int background_attention (int fd
, void *closure
);
83 /*** file scope functions ************************************************************************/
84 /* --------------------------------------------------------------------------------------------- */
87 register_task_running (file_op_context_t
* ctx
, pid_t pid
, int fd
, int to_child
, char *info
)
91 new = g_new (TaskList
, 1);
94 new->state
= Task_Running
;
95 new->next
= task_list
;
97 new->to_child_fd
= to_child
;
100 add_select_channel (fd
, background_attention
, ctx
);
103 /* --------------------------------------------------------------------------------------------- */
106 destroy_task (pid_t pid
)
108 TaskList
*p
= task_list
;
109 TaskList
*prev
= NULL
;
118 prev
->next
= p
->next
;
133 /* --------------------------------------------------------------------------------------------- */
134 /* {{{ Parent handlers */
136 /* Parent/child protocol
138 * the child (the background) process send the following:
139 * void *routine -- routine to be invoked in the parent
140 * int nargc -- number of arguments
141 * int type -- Return argument type.
143 * If the routine is zero, then it is a way to tell the parent
144 * that the process is dying.
146 * nargc arguments in the following format:
147 * int size of the coming block
148 * size bytes with the block
150 * Now, the parent loads all those and then invokes
151 * the routine with pointers to the information passed
152 * (we just support pointers).
154 * If the return type is integer:
156 * the parent then writes an int to the child with
157 * the return value from the routine and the values
158 * of any global variable that is modified in the parent
159 * currently: do_append and recursive_result.
161 * If the return type is a string:
163 * the parent writes the resulting string length
164 * if the result string was NULL or the empty string,
165 * then the length is zero.
166 * The parent then writes the string length and frees
170 * Receive requests from background process and invoke the
175 reading_failed (int i
, char **data
)
179 message (D_ERROR
, _("Background protocol error"), "%s", _("Reading failed"));
183 /* --------------------------------------------------------------------------------------------- */
186 background_attention (int fd
, void *closure
)
188 file_op_context_t
*ctx
;
192 int (*have_ctx0
) (int);
193 int (*have_ctx1
) (int, char *);
194 int (*have_ctx2
) (int, char *, char *);
195 int (*have_ctx3
) (int, char *, char *, char *);
196 int (*have_ctx4
) (int, char *, char *, char *, char *);
198 int (*non_have_ctx0
) (file_op_context_t
*, int);
199 int (*non_have_ctx1
) (file_op_context_t
*, int, char *);
200 int (*non_have_ctx2
) (file_op_context_t
*, int, char *, char *);
201 int (*non_have_ctx3
) (file_op_context_t
*, int, char *, char *, char *);
202 int (*non_have_ctx4
) (file_op_context_t
*, int, char *, char *, char *, char *);
204 char *(*ret_str0
) (void);
205 char *(*ret_str1
) (char *);
206 char *(*ret_str2
) (char *, char *);
207 char *(*ret_str3
) (char *, char *, char *);
208 char *(*ret_str4
) (char *, char *, char *, char *);
214 char *data
[MAXCALLARGS
];
217 int to_child_fd
= -1;
218 enum ReturnType type
;
219 const char *background_process_error
= _("Background process error");
223 bytes
= read (fd
, &routine
.pointer
, sizeof (routine
));
224 if (bytes
== -1 || (size_t) bytes
< (sizeof (routine
)))
226 unregister_task_running (ctx
->pid
, fd
);
228 if (waitpid (ctx
->pid
, &status
, WNOHANG
) == 0)
230 /* the process is still running, but it misbehaves - kill it */
231 kill (ctx
->pid
, SIGTERM
);
232 message (D_ERROR
, background_process_error
, "%s", _("Unknown error in child"));
236 /* 0 means happy end */
237 if (WIFEXITED (status
) && (WEXITSTATUS (status
) == 0))
240 message (D_ERROR
, background_process_error
, "%s", _("Child died unexpectedly"));
245 if (read (fd
, &argc
, sizeof (argc
)) != sizeof (argc
) ||
246 read (fd
, &type
, sizeof (type
)) != sizeof (type
) ||
247 read (fd
, &have_ctx
, sizeof (have_ctx
)) != sizeof (have_ctx
))
248 return reading_failed (-1, data
);
250 if (argc
> MAXCALLARGS
)
251 message (D_ERROR
, _("Background protocol error"), "%s",
252 _("Background process sent us a request for more arguments\n"
253 "than we can handle."));
255 if (have_ctx
!= 0 && read (fd
, ctx
, sizeof (*ctx
)) != sizeof (*ctx
))
256 return reading_failed (-1, data
);
258 for (i
= 0; i
< argc
; i
++)
262 if (read (fd
, &size
, sizeof (size
)) != sizeof (size
))
263 return reading_failed (i
- 1, data
);
265 data
[i
] = g_malloc (size
+ 1);
267 if (read (fd
, data
[i
], size
) != size
)
268 return reading_failed (i
, data
);
270 data
[i
][size
] = '\0'; /* NULL terminate the blocks (they could be strings) */
273 /* Find child task info by descriptor */
274 /* Find before call, because process can destroy self after */
275 for (p
= task_list
; p
!= NULL
; p
= p
->next
)
280 to_child_fd
= p
->to_child_fd
;
282 if (to_child_fd
== -1)
283 message (D_ERROR
, background_process_error
, "%s", _("Unknown error in child"));
285 /* Handle the call */
286 if (type
== Return_Integer
)
294 result
= routine
.have_ctx0 (Background
);
297 result
= routine
.have_ctx1 (Background
, data
[0]);
300 result
= routine
.have_ctx2 (Background
, data
[0], data
[1]);
303 result
= routine
.have_ctx3 (Background
, data
[0], data
[1], data
[2]);
306 result
= routine
.have_ctx4 (Background
, data
[0], data
[1], data
[2], data
[3]);
315 result
= routine
.non_have_ctx0 (ctx
, Background
);
318 result
= routine
.non_have_ctx1 (ctx
, Background
, data
[0]);
321 result
= routine
.non_have_ctx2 (ctx
, Background
, data
[0], data
[1]);
324 result
= routine
.non_have_ctx3 (ctx
, Background
, data
[0], data
[1], data
[2]);
328 routine
.non_have_ctx4 (ctx
, Background
, data
[0], data
[1], data
[2], data
[3]);
334 /* Send the result code and the value for shared variables */
335 ret
= write (to_child_fd
, &result
, sizeof (result
));
336 if (have_ctx
!= 0 && to_child_fd
!= -1)
337 ret
= write (to_child_fd
, ctx
, sizeof (*ctx
));
339 else if (type
== Return_String
)
344 /* FIXME: string routines should also use the Foreground/Background
345 * parameter. Currently, this is not used here
350 resstr
= routine
.ret_str0 ();
353 resstr
= routine
.ret_str1 (data
[0]);
356 resstr
= routine
.ret_str2 (data
[0], data
[1]);
359 resstr
= routine
.ret_str3 (data
[0], data
[1], data
[2]);
362 resstr
= routine
.ret_str4 (data
[0], data
[1], data
[2], data
[3]);
365 g_assert_not_reached ();
370 len
= strlen (resstr
);
371 ret
= write (to_child_fd
, &len
, sizeof (len
));
373 ret
= write (to_child_fd
, resstr
, len
);
379 ret
= write (to_child_fd
, &len
, sizeof (len
));
383 for (i
= 0; i
< argc
; i
++)
393 /* --------------------------------------------------------------------------------------------- */
396 /* {{{ client RPC routines */
398 /* Sends the header for a call to a routine in the parent process. If the file
399 * operation context is not NULL, then it requests that the first parameter of
400 * the call be a file operation context.
404 parent_call_header (void *routine
, int argc
, enum ReturnType type
, file_op_context_t
* ctx
)
409 have_ctx
= ctx
!= NULL
? 1 : 0;
411 ret
= write (parent_fd
, &routine
, sizeof (routine
));
412 ret
= write (parent_fd
, &argc
, sizeof (argc
));
413 ret
= write (parent_fd
, &type
, sizeof (type
));
414 ret
= write (parent_fd
, &have_ctx
, sizeof (have_ctx
));
416 ret
= write (parent_fd
, ctx
, sizeof (*ctx
));
421 /* --------------------------------------------------------------------------------------------- */
424 parent_va_call (void *routine
, gpointer data
, int argc
, va_list ap
)
428 file_op_context_t
*ctx
= (file_op_context_t
*) data
;
430 parent_call_header (routine
, argc
, Return_Integer
, ctx
);
431 for (i
= 0; i
< argc
; i
++)
436 len
= va_arg (ap
, int);
437 value
= va_arg (ap
, void *);
438 ret
= write (parent_fd
, &len
, sizeof (len
));
439 ret
= write (parent_fd
, value
, len
);
442 ret
= read (from_parent_fd
, &i
, sizeof (i
));
444 ret
= read (from_parent_fd
, ctx
, sizeof (*ctx
));
451 /* --------------------------------------------------------------------------------------------- */
454 parent_va_call_string (void *routine
, int argc
, va_list ap
)
459 parent_call_header (routine
, argc
, Return_String
, NULL
);
460 for (i
= 0; i
< argc
; i
++)
465 len
= va_arg (ap
, int);
466 value
= va_arg (ap
, void *);
467 if (write (parent_fd
, &len
, sizeof (len
)) != sizeof (len
) ||
468 write (parent_fd
, value
, len
) != len
)
472 if (read (from_parent_fd
, &i
, sizeof (i
)) != sizeof (i
) || i
== 0)
475 str
= g_malloc (i
+ 1);
476 if (read (from_parent_fd
, str
, i
) != i
)
485 /* --------------------------------------------------------------------------------------------- */
486 /*** public functions ****************************************************************************/
487 /* --------------------------------------------------------------------------------------------- */
490 unregister_task_running (pid_t pid
, int fd
)
493 delete_select_channel (fd
);
496 /* --------------------------------------------------------------------------------------------- */
499 unregister_task_with_pid (pid_t pid
)
503 fd
= destroy_task (pid
);
505 delete_select_channel (fd
);
508 /* --------------------------------------------------------------------------------------------- */
510 * Try to make the Midnight Commander a background job
518 do_background (file_op_context_t
* ctx
, char *info
)
520 int comm
[2]; /* control connection stream */
521 int back_comm
[2]; /* back connection */
524 if (pipe (comm
) == -1)
527 if (pipe (back_comm
) == -1)
533 int saved_errno
= errno
;
535 (void) close (comm
[0]);
536 (void) close (comm
[1]);
537 (void) close (back_comm
[0]);
538 (void) close (back_comm
[1]);
549 from_parent_fd
= back_comm
[0];
551 mc_global
.we_are_background
= TRUE
;
554 /* Make stdin/stdout/stderr point somewhere */
555 close (STDIN_FILENO
);
556 close (STDOUT_FILENO
);
557 close (STDERR_FILENO
);
559 nullfd
= open ("/dev/null", O_RDWR
);
562 while (dup2 (nullfd
, STDIN_FILENO
) == -1 && errno
== EINTR
)
564 while (dup2 (nullfd
, STDOUT_FILENO
) == -1 && errno
== EINTR
)
566 while (dup2 (nullfd
, STDERR_FILENO
) == -1 && errno
== EINTR
)
575 register_task_running (ctx
, pid
, comm
[0], back_comm
[1], info
);
580 /* --------------------------------------------------------------------------------------------- */
583 parent_call (void *routine
, file_op_context_t
* ctx
, int argc
, ...)
589 ret
= parent_va_call (routine
, (gpointer
) ctx
, argc
, ap
);
595 /* --------------------------------------------------------------------------------------------- */
598 parent_call_string (void *routine
, int argc
, ...)
604 str
= parent_va_call_string (routine
, argc
, ap
);
610 /* --------------------------------------------------------------------------------------------- */
614 background_parent_call (const gchar
* event_group_name
, const gchar
* event_name
,
615 gpointer init_data
, gpointer data
)
617 ev_background_parent_call_t
*event_data
= (ev_background_parent_call_t
*) data
;
619 (void) event_group_name
;
624 parent_va_call (event_data
->routine
, event_data
->ctx
, event_data
->argc
, event_data
->ap
);
629 /* --------------------------------------------------------------------------------------------- */
633 background_parent_call_string (const gchar
* event_group_name
, const gchar
* event_name
,
634 gpointer init_data
, gpointer data
)
636 ev_background_parent_call_t
*event_data
= (ev_background_parent_call_t
*) data
;
638 (void) event_group_name
;
643 parent_va_call_string (event_data
->routine
, event_data
->argc
, event_data
->ap
);
648 /* --------------------------------------------------------------------------------------------- */