1 /* Copyright (C) 1995, 1996, 1997, 1998, 2000, 2001, 2003, 2004, 2009,
2 * 2010, 2012, 2014 Free Software Foundation, Inc.
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public License
6 * as published by the Free Software Foundation; either version 3 of
7 * the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful, but
10 * WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
27 #include <signal.h> /* for SIG constants */
28 #include <stdlib.h> /* for getenv */
31 #include "libguile/_scm.h"
33 #include "libguile/scmsigs.h"
34 #include "libguile/strings.h"
36 #include "libguile/validate.h"
37 #include "libguile/simpos.h"
38 #include "libguile/dynwind.h"
45 # include <sys/wait.h>
55 SCM_DEFINE (scm_system
, "system", 0, 1, 0,
57 "Execute @var{cmd} using the operating system's \"command\n"
58 "processor\". Under Unix this is usually the default shell\n"
59 "@code{sh}. The value returned is @var{cmd}'s exit status as\n"
60 "returned by @code{waitpid}, which can be interpreted using\n"
61 "@code{status:exit-val} and friends.\n"
63 "If @code{system} is called without arguments, return a boolean\n"
64 "indicating whether the command processor is available.")
65 #define FUNC_NAME s_scm_system
73 return scm_from_bool(rv
);
75 SCM_VALIDATE_STRING (1, cmd
);
77 c_cmd
= scm_to_locale_string (cmd
);
79 eno
= errno
; free (c_cmd
); errno
= eno
;
80 if (rv
== -1 || (rv
== 127 && errno
!= 0))
82 return scm_from_int (rv
);
85 #endif /* HAVE_SYSTEM */
92 SCM_DEFINE (scm_system_star
, "system*", 0, 0, 1,
94 "Execute the command indicated by @var{args}. The first element must\n"
95 "be a string indicating the command to be executed, and the remaining\n"
96 "items must be strings representing each of the arguments to that\n"
99 "This function returns the exit status of the command as provided by\n"
100 "@code{waitpid}. This value can be handled with @code{status:exit-val}\n"
101 "and the related functions.\n"
103 "@code{system*} is similar to @code{system}, but accepts only one\n"
104 "string per-argument, and performs no shell interpretation. The\n"
105 "command is executed using fork and execlp. Accordingly this function\n"
106 "may be safer than @code{system} in situations where shell\n"
107 "interpretation is not required.\n"
109 "Example: (system* \"echo\" \"foo\" \"bar\")")
110 #define FUNC_NAME s_scm_system_star
112 if (scm_is_null (args
))
113 SCM_WRONG_NUM_ARGS ();
115 if (scm_is_pair (args
))
125 /* allocate before fork */
126 execargv
= scm_i_allocate_string_pointers (args
);
128 /* make sure the child can't kill us (as per normal system call) */
129 sig_ign
= scm_from_ulong ((unsigned long) SIG_IGN
);
130 sigint
= scm_from_int (SIGINT
);
131 sigquit
= scm_from_int (SIGQUIT
);
132 oldint
= scm_sigaction (sigint
, sig_ign
, SCM_UNDEFINED
);
133 oldquit
= scm_sigaction (sigquit
, sig_ign
, SCM_UNDEFINED
);
139 execvp (execargv
[0], execargv
);
141 /* Something went wrong. */
142 fprintf (stderr
, "In execvp of %s: %s\n",
143 execargv
[0], strerror (errno
));
145 /* Exit directly instead of throwing, because otherwise this
146 process may keep on running. Use exit status 127, like
147 shells in this case, as per POSIX
148 <http://pubs.opengroup.org/onlinepubs/007904875/utilities/xcu_chap02.html#tag_02_09_01_01>. */
154 int wait_result
, status
;
159 SCM_SYSCALL (wait_result
= waitpid (pid
, &status
, 0));
160 if (wait_result
== -1)
162 scm_sigaction (sigint
, SCM_CAR (oldint
), SCM_CDR (oldint
));
163 scm_sigaction (sigquit
, SCM_CAR (oldquit
), SCM_CDR (oldquit
));
165 return scm_from_int (status
);
169 SCM_WRONG_TYPE_ARG (1, args
);
172 #endif /* HAVE_WAITPID */
173 #endif /* HAVE_SYSTEM */
176 SCM_DEFINE (scm_getenv
, "getenv", 1, 0, 0,
178 "Looks up the string @var{nam} in the current environment. The return\n"
179 "value is @code{#f} unless a string of the form @code{NAME=VALUE} is\n"
180 "found, in which case the string @code{VALUE} is returned.")
181 #define FUNC_NAME s_scm_getenv
184 char *var
= scm_to_locale_string (nam
);
187 return val
? scm_from_locale_string (val
) : SCM_BOOL_F
;
191 /* simple exit, without unwinding the scheme stack or flushing ports. */
192 SCM_DEFINE (scm_primitive_exit
, "primitive-exit", 0, 1, 0,
194 "Terminate the current process without unwinding the Scheme\n"
195 "stack. The exit status is @var{status} if supplied, otherwise\n"
197 #define FUNC_NAME s_scm_primitive_exit
200 if (!SCM_UNBNDP (status
))
201 cstatus
= scm_to_int (status
);
206 SCM_DEFINE (scm_primitive__exit
, "primitive-_exit", 0, 1, 0,
208 "Terminate the current process using the _exit() system call and\n"
209 "without unwinding the Scheme stack. The exit status is\n"
210 "@var{status} if supplied, otherwise zero.\n"
212 "This function is typically useful after a fork, to ensure no\n"
213 "Scheme cleanups or @code{atexit} handlers are run (those\n"
214 "usually belonging in the parent rather than the child).")
215 #define FUNC_NAME s_scm_primitive__exit
218 if (!SCM_UNBNDP (status
))
219 cstatus
= scm_to_int (status
);
229 #include "libguile/simpos.x"