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 "globals.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.

Detailed Description

Execute external programs.

Authors

• Michael R. Elkins

Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

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

cmd	Command and arguments

Return values

-1	Error
>=0	Success (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 52 of file system.c.

{
  int rc = -1;
  struct sigaction act = { 0 };
  struct sigaction oldtstp = { 0 };
  struct sigaction oldcont = { 0 };
  pid_t pid;
 
  if (!cmd || (*cmd == '\0'))
    return 0;
 
  /* must ignore SIGINT and SIGQUIT */
 
  mutt_sig_block_system();
 
  act.sa_handler = SIG_DFL;
/* we want to restart the waitpid() below */
#ifdef SA_RESTART
  act.sa_flags = SA_RESTART;
#endif
  sigemptyset(&act.sa_mask);
  sigaction(SIGTSTP, &act, &oldtstp);
  sigaction(SIGCONT, &act, &oldcont);
 
  pid = fork();
  if (pid == 0)
  {
    act.sa_flags = 0;
 
    /* reset signals for the child; not really needed, but... */
    mutt_sig_unblock_system(false);
    act.sa_handler = SIG_DFL;
    act.sa_flags = 0;
    sigemptyset(&act.sa_mask);
    sigaction(SIGTERM, &act, NULL);
    sigaction(SIGTSTP, &act, NULL);
    sigaction(SIGCONT, &act, NULL);
 
    execle(EXEC_SHELL, "sh", "-c", cmd, NULL, EnvList);
    _exit(127); /* execl error */
  }
  else if (pid != -1)
  {
#ifdef USE_IMAP
    rc = imap_wait_keep_alive(pid);
#endif
  }
 
  sigaction(SIGCONT, &oldcont, NULL);
  sigaction(SIGTSTP, &oldtstp, NULL);
 
  /* reset SIGINT, SIGQUIT and SIGCHLD */
  mutt_sig_unblock_system(true);
 
  rc = (pid != -1) ? (WIFEXITED(rc) ? WEXITSTATUS(rc) : -1) : -1;
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function: