NeoMutt  2022-04-29-215-gc12b98
Teaching an old dog new tricks
DOXYGEN
system.c File Reference

Execute external programs. More...

#include "config.h"
#include <signal.h>
#include <stdbool.h>
#include <stdlib.h>
#include <sys/wait.h>
#include <unistd.h>
#include "mutt/lib.h"
#include "protos.h"
#include "imap/lib.h"
+ Include dependency graph for system.c:

Go to the source code of this file.

Functions

int mutt_system (const char *cmd)
 Run an external command. More...
 

Detailed Description

Execute external programs.

Authors
  • Michael R. Elkins

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file system.c.

Function Documentation

◆ mutt_system()

int mutt_system ( const char *  cmd)

Run an external command.

Parameters
cmdCommand and arguments
Return values
-1Error
>=0Success (command's return code)

Fork and run an external command with arguments.

Note
This function won't return until the command finishes.

Definition at line 51 of file system.c.

52{
53 int rc = -1;
54 struct sigaction act;
55 struct sigaction oldtstp;
56 struct sigaction oldcont;
57 pid_t pid;
58
59 if (!cmd || (*cmd == '\0'))
60 return 0;
61
62 /* must ignore SIGINT and SIGQUIT */
63
65
66 act.sa_handler = SIG_DFL;
67/* we want to restart the waitpid() below */
68#ifdef SA_RESTART
69 act.sa_flags = SA_RESTART;
70#endif
71 sigemptyset(&act.sa_mask);
72 sigaction(SIGTSTP, &act, &oldtstp);
73 sigaction(SIGCONT, &act, &oldcont);
74
75 pid = fork();
76 if (pid == 0)
77 {
78 act.sa_flags = 0;
79
80 /* reset signals for the child; not really needed, but... */
82 act.sa_handler = SIG_DFL;
83 act.sa_flags = 0;
84 sigemptyset(&act.sa_mask);
85 sigaction(SIGTERM, &act, NULL);
86 sigaction(SIGTSTP, &act, NULL);
87 sigaction(SIGCONT, &act, NULL);
88
89 execle(EXEC_SHELL, "sh", "-c", cmd, NULL, mutt_envlist_getlist());
90 _exit(127); /* execl error */
91 }
92 else if (pid != -1)
93 {
94#ifdef USE_IMAP
95 rc = imap_wait_keepalive(pid);
96#endif
97 }
98
99 sigaction(SIGCONT, &oldcont, NULL);
100 sigaction(SIGTSTP, &oldtstp, NULL);
101
102 /* reset SIGINT, SIGQUIT and SIGCHLD */
104
105 rc = (pid != -1) ? (WIFEXITED(rc) ? WEXITSTATUS(rc) : -1) : -1;
106
107 return rc;
108}
char ** mutt_envlist_getlist(void)
Get the private environment.
Definition: envlist.c:169
#define EXEC_SHELL
Definition: filter.h:27
int imap_wait_keepalive(pid_t pid)
Wait for a process to change state.
Definition: util.c:969
void mutt_sig_block_system(void)
Block signals before calling exec()
Definition: signal.c:183
void mutt_sig_unblock_system(bool restore)
Restore previously blocked signals.
Definition: signal.c:207
+ Here is the call graph for this function:
+ Here is the caller graph for this function: