Merge commit '1cd63115be7a25d0ea18aaa0e1eff5658d8db77a'
[bpt/guile.git] / libguile / posix.c
1 /* Copyright (C) 1995,1996,1997,1998,1999,2000,2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc.
2 *
3 * This library is free software; you can redistribute it and/or
4 * modify it under the terms of the GNU Lesser General Public License
5 * as published by the Free Software Foundation; either version 3 of
6 * the License, or (at your option) any later version.
7 *
8 * This library is distributed in the hope that it will be useful, but
9 * WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * Lesser General Public License for more details.
12 *
13 * You should have received a copy of the GNU Lesser General Public
14 * License along with this library; if not, write to the Free Software
15 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
16 * 02110-1301 USA
17 */
18
19
20 \f
21 #ifdef HAVE_CONFIG_H
22 # include <config.h>
23 #endif
24
25 #include <stdlib.h>
26 #include <stdio.h>
27 #include <errno.h>
28 #include <uniconv.h>
29
30 #ifdef HAVE_SCHED_H
31 # include <sched.h>
32 #endif
33
34 #include "libguile/_scm.h"
35 #include "libguile/dynwind.h"
36 #include "libguile/fports.h"
37 #include "libguile/scmsigs.h"
38 #include "libguile/feature.h"
39 #include "libguile/strings.h"
40 #include "libguile/srfi-13.h"
41 #include "libguile/srfi-14.h"
42 #include "libguile/vectors.h"
43 #include "libguile/values.h"
44
45 #include "libguile/validate.h"
46 #include "libguile/posix.h"
47 #include "libguile/gettext.h"
48 #include "libguile/threads.h"
49 \f
50
51 #ifdef HAVE_STRING_H
52 #include <string.h>
53 #endif
54 #ifdef TIME_WITH_SYS_TIME
55 # include <sys/time.h>
56 # include <time.h>
57 #else
58 # if HAVE_SYS_TIME_H
59 # include <sys/time.h>
60 # else
61 # include <time.h>
62 # endif
63 #endif
64
65 #ifdef HAVE_UNISTD_H
66 #include <unistd.h>
67 #else
68 #ifndef ttyname
69 extern char *ttyname();
70 #endif
71 #endif
72
73 #ifdef LIBC_H_WITH_UNISTD_H
74 #include <libc.h>
75 #endif
76
77 #include <sys/types.h>
78 #include <sys/stat.h>
79 #include <fcntl.h>
80
81 #ifdef HAVE_PWD_H
82 #include <pwd.h>
83 #endif
84 #ifdef HAVE_IO_H
85 #include <io.h>
86 #endif
87 #ifdef HAVE_WINSOCK2_H
88 #include <winsock2.h>
89 #endif
90
91 #ifdef __MINGW32__
92 /* Some defines for Windows here. */
93 # include <process.h>
94 # define pipe(fd) _pipe (fd, 256, O_BINARY)
95 #endif /* __MINGW32__ */
96
97 #if HAVE_SYS_WAIT_H
98 # include <sys/wait.h>
99 #endif
100 #ifndef WEXITSTATUS
101 # define WEXITSTATUS(stat_val) ((unsigned)(stat_val) >> 8)
102 #endif
103 #ifndef WIFEXITED
104 # define WIFEXITED(stat_val) (((stat_val) & 255) == 0)
105 #endif
106
107 #include <signal.h>
108
109 #ifdef HAVE_GRP_H
110 #include <grp.h>
111 #endif
112 #ifdef HAVE_SYS_UTSNAME_H
113 #include <sys/utsname.h>
114 #endif
115
116 #ifdef HAVE_SETLOCALE
117 #include <locale.h>
118 #endif
119
120 #if (defined HAVE_NEWLOCALE) && (defined HAVE_STRCOLL_L)
121 # define USE_GNU_LOCALE_API
122 #endif
123
124 #if (defined USE_GNU_LOCALE_API) && (defined HAVE_XLOCALE_H)
125 # include <xlocale.h>
126 #endif
127
128 #ifdef HAVE_CRYPT_H
129 # include <crypt.h>
130 #endif
131
132 #ifdef HAVE_NETDB_H
133 #include <netdb.h> /* for MAXHOSTNAMELEN on Solaris */
134 #endif
135
136 #ifdef HAVE_SYS_PARAM_H
137 #include <sys/param.h> /* for MAXHOSTNAMELEN */
138 #endif
139
140 #if HAVE_SYS_RESOURCE_H
141 # include <sys/resource.h>
142 #endif
143
144 #include <sys/file.h> /* from Gnulib */
145
146 /* Some Unix systems don't define these. CPP hair is dangerous, but
147 this seems safe enough... */
148 #ifndef R_OK
149 #define R_OK 4
150 #endif
151
152 #ifndef W_OK
153 #define W_OK 2
154 #endif
155
156 #ifndef X_OK
157 #define X_OK 1
158 #endif
159
160 #ifndef F_OK
161 #define F_OK 0
162 #endif
163
164 /* No prototype for this on Solaris 10. The man page says it's in
165 <unistd.h> ... but it lies. */
166 #if ! HAVE_DECL_SETHOSTNAME
167 int sethostname (char *name, size_t namelen);
168 #endif
169
170 /* On NextStep, <utime.h> doesn't define struct utime, unless we
171 #define _POSIX_SOURCE before #including it. I think this is less
172 of a kludge than defining struct utimbuf ourselves. */
173 #ifdef UTIMBUF_NEEDS_POSIX
174 #define _POSIX_SOURCE
175 #endif
176
177 #ifdef HAVE_SYS_UTIME_H
178 #include <sys/utime.h>
179 #endif
180
181 #ifdef HAVE_UTIME_H
182 #include <utime.h>
183 #endif
184
185 /* Please don't add any more #includes or #defines here. The hack
186 above means that _POSIX_SOURCE may be #defined, which will
187 encourage header files to do strange things.
188
189 FIXME: Maybe should undef _POSIX_SOURCE after it's done its job.
190
191 FIXME: Probably should do all the includes first, then all the fallback
192 declarations and defines, in case things are not in the header we
193 imagine. */
194
195
196
197
198 \f
199
200 /* Two often used patterns
201 */
202
203 #define WITH_STRING(str,cstr,code) \
204 do { \
205 char *cstr = scm_to_locale_string (str); \
206 code; \
207 free (cstr); \
208 } while (0)
209
210 #define STRING_SYSCALL(str,cstr,code) \
211 do { \
212 int eno; \
213 char *cstr = scm_to_locale_string (str); \
214 SCM_SYSCALL (code); \
215 eno = errno; free (cstr); errno = eno; \
216 } while (0)
217
218
219 \f
220 SCM_SYMBOL (sym_read_pipe, "read pipe");
221 SCM_SYMBOL (sym_write_pipe, "write pipe");
222
223 SCM_DEFINE (scm_pipe, "pipe", 0, 0, 0,
224 (),
225 "Return a newly created pipe: a pair of ports which are linked\n"
226 "together on the local machine. The @emph{car} is the input\n"
227 "port and the @emph{cdr} is the output port. Data written (and\n"
228 "flushed) to the output port can be read from the input port.\n"
229 "Pipes are commonly used for communication with a newly forked\n"
230 "child process. The need to flush the output port can be\n"
231 "avoided by making it unbuffered using @code{setvbuf}.\n"
232 "\n"
233 "Writes occur atomically provided the size of the data in bytes\n"
234 "is not greater than the value of @code{PIPE_BUF}. Note that\n"
235 "the output port is likely to block if too much data (typically\n"
236 "equal to @code{PIPE_BUF}) has been written but not yet read\n"
237 "from the input port.")
238 #define FUNC_NAME s_scm_pipe
239 {
240 int fd[2], rv;
241 SCM p_rd, p_wt;
242
243 rv = pipe (fd);
244 if (rv)
245 SCM_SYSERROR;
246
247 p_rd = scm_fdes_to_port (fd[0], "r", sym_read_pipe);
248 p_wt = scm_fdes_to_port (fd[1], "w", sym_write_pipe);
249 return scm_cons (p_rd, p_wt);
250 }
251 #undef FUNC_NAME
252
253
254 #ifdef HAVE_GETGROUPS
255 SCM_DEFINE (scm_getgroups, "getgroups", 0, 0, 0,
256 (),
257 "Return a vector of integers representing the current\n"
258 "supplementary group IDs.")
259 #define FUNC_NAME s_scm_getgroups
260 {
261 SCM result;
262 int ngroups;
263 size_t size;
264 GETGROUPS_T *groups;
265
266 ngroups = getgroups (0, NULL);
267 if (ngroups <= 0)
268 SCM_SYSERROR;
269
270 size = ngroups * sizeof (GETGROUPS_T);
271 groups = scm_malloc (size);
272 ngroups = getgroups (ngroups, groups);
273
274 result = scm_c_make_vector (ngroups, SCM_BOOL_F);
275 while (--ngroups >= 0)
276 SCM_SIMPLE_VECTOR_SET (result, ngroups, scm_from_ulong (groups[ngroups]));
277
278 free (groups);
279 return result;
280 }
281 #undef FUNC_NAME
282 #endif
283
284 #ifdef HAVE_SETGROUPS
285 SCM_DEFINE (scm_setgroups, "setgroups", 1, 0, 0,
286 (SCM group_vec),
287 "Set the current set of supplementary group IDs to the integers\n"
288 "in the given vector @var{group_vec}. The return value is\n"
289 "unspecified.\n"
290 "\n"
291 "Generally only the superuser can set the process group IDs.")
292 #define FUNC_NAME s_scm_setgroups
293 {
294 size_t ngroups;
295 size_t size;
296 size_t i;
297 int result;
298 int save_errno;
299 GETGROUPS_T *groups;
300
301 SCM_VALIDATE_VECTOR (SCM_ARG1, group_vec);
302
303 ngroups = SCM_SIMPLE_VECTOR_LENGTH (group_vec);
304
305 /* validate before allocating, so we don't have to worry about leaks */
306 for (i = 0; i < ngroups; i++)
307 {
308 unsigned long ulong_gid;
309 GETGROUPS_T gid;
310 SCM_VALIDATE_ULONG_COPY (1, SCM_SIMPLE_VECTOR_REF (group_vec, i),
311 ulong_gid);
312 gid = ulong_gid;
313 if (gid != ulong_gid)
314 SCM_OUT_OF_RANGE (1, SCM_SIMPLE_VECTOR_REF (group_vec, i));
315 }
316
317 size = ngroups * sizeof (GETGROUPS_T);
318 if (size / sizeof (GETGROUPS_T) != ngroups)
319 SCM_OUT_OF_RANGE (SCM_ARG1, scm_from_int (ngroups));
320 groups = scm_malloc (size);
321 for(i = 0; i < ngroups; i++)
322 groups [i] = SCM_NUM2ULONG (1, SCM_SIMPLE_VECTOR_REF (group_vec, i));
323
324 result = setgroups (ngroups, groups);
325 save_errno = errno; /* don't let free() touch errno */
326 free (groups);
327 errno = save_errno;
328 if (result < 0)
329 SCM_SYSERROR;
330 return SCM_UNSPECIFIED;
331 }
332 #undef FUNC_NAME
333 #endif
334
335 #ifdef HAVE_GETPWENT
336 SCM_DEFINE (scm_getpwuid, "getpw", 0, 1, 0,
337 (SCM user),
338 "Look up an entry in the user database. @var{user} can be an\n"
339 "integer, a string, or omitted, giving the behaviour of\n"
340 "@code{getpwuid}, @code{getpwnam} or @code{getpwent}\n"
341 "respectively.")
342 #define FUNC_NAME s_scm_getpwuid
343 {
344 struct passwd *entry;
345
346 SCM result = scm_c_make_vector (7, SCM_UNSPECIFIED);
347 if (SCM_UNBNDP (user) || scm_is_false (user))
348 {
349 SCM_SYSCALL (entry = getpwent ());
350 if (! entry)
351 {
352 return SCM_BOOL_F;
353 }
354 }
355 else if (scm_is_integer (user))
356 {
357 entry = getpwuid (scm_to_int (user));
358 }
359 else
360 {
361 WITH_STRING (user, c_user,
362 entry = getpwnam (c_user));
363 }
364 if (!entry)
365 SCM_MISC_ERROR ("entry not found", SCM_EOL);
366
367 SCM_SIMPLE_VECTOR_SET(result, 0, scm_from_locale_string (entry->pw_name));
368 SCM_SIMPLE_VECTOR_SET(result, 1, scm_from_locale_string (entry->pw_passwd));
369 SCM_SIMPLE_VECTOR_SET(result, 2, scm_from_ulong (entry->pw_uid));
370 SCM_SIMPLE_VECTOR_SET(result, 3, scm_from_ulong (entry->pw_gid));
371 SCM_SIMPLE_VECTOR_SET(result, 4, scm_from_locale_string (entry->pw_gecos));
372 if (!entry->pw_dir)
373 SCM_SIMPLE_VECTOR_SET(result, 5, scm_from_locale_string (""));
374 else
375 SCM_SIMPLE_VECTOR_SET(result, 5, scm_from_locale_string (entry->pw_dir));
376 if (!entry->pw_shell)
377 SCM_SIMPLE_VECTOR_SET(result, 6, scm_from_locale_string (""));
378 else
379 SCM_SIMPLE_VECTOR_SET(result, 6, scm_from_locale_string (entry->pw_shell));
380 return result;
381 }
382 #undef FUNC_NAME
383 #endif /* HAVE_GETPWENT */
384
385
386 #ifdef HAVE_SETPWENT
387 SCM_DEFINE (scm_setpwent, "setpw", 0, 1, 0,
388 (SCM arg),
389 "If called with a true argument, initialize or reset the password data\n"
390 "stream. Otherwise, close the stream. The @code{setpwent} and\n"
391 "@code{endpwent} procedures are implemented on top of this.")
392 #define FUNC_NAME s_scm_setpwent
393 {
394 if (SCM_UNBNDP (arg) || scm_is_false (arg))
395 endpwent ();
396 else
397 setpwent ();
398 return SCM_UNSPECIFIED;
399 }
400 #undef FUNC_NAME
401 #endif
402
403
404 #ifdef HAVE_GETGRENT
405 /* Combines getgrgid and getgrnam. */
406 SCM_DEFINE (scm_getgrgid, "getgr", 0, 1, 0,
407 (SCM name),
408 "Look up an entry in the group database. @var{name} can be an\n"
409 "integer, a string, or omitted, giving the behaviour of\n"
410 "@code{getgrgid}, @code{getgrnam} or @code{getgrent}\n"
411 "respectively.")
412 #define FUNC_NAME s_scm_getgrgid
413 {
414 struct group *entry;
415 SCM result = scm_c_make_vector (4, SCM_UNSPECIFIED);
416
417 if (SCM_UNBNDP (name) || scm_is_false (name))
418 {
419 SCM_SYSCALL (entry = getgrent ());
420 if (! entry)
421 {
422 return SCM_BOOL_F;
423 }
424 }
425 else if (scm_is_integer (name))
426 SCM_SYSCALL (entry = getgrgid (scm_to_int (name)));
427 else
428 STRING_SYSCALL (name, c_name,
429 entry = getgrnam (c_name));
430 if (!entry)
431 SCM_SYSERROR;
432
433 SCM_SIMPLE_VECTOR_SET(result, 0, scm_from_locale_string (entry->gr_name));
434 SCM_SIMPLE_VECTOR_SET(result, 1, scm_from_locale_string (entry->gr_passwd));
435 SCM_SIMPLE_VECTOR_SET(result, 2, scm_from_ulong (entry->gr_gid));
436 SCM_SIMPLE_VECTOR_SET(result, 3, scm_makfromstrs (-1, entry->gr_mem));
437 return result;
438 }
439 #undef FUNC_NAME
440
441
442
443 SCM_DEFINE (scm_setgrent, "setgr", 0, 1, 0,
444 (SCM arg),
445 "If called with a true argument, initialize or reset the group data\n"
446 "stream. Otherwise, close the stream. The @code{setgrent} and\n"
447 "@code{endgrent} procedures are implemented on top of this.")
448 #define FUNC_NAME s_scm_setgrent
449 {
450 if (SCM_UNBNDP (arg) || scm_is_false (arg))
451 endgrent ();
452 else
453 setgrent ();
454 return SCM_UNSPECIFIED;
455 }
456 #undef FUNC_NAME
457 #endif /* HAVE_GETGRENT */
458
459
460 #ifdef HAVE_GETRLIMIT
461 #ifdef RLIMIT_AS
462 SCM_SYMBOL (sym_as, "as");
463 #endif
464 #ifdef RLIMIT_CORE
465 SCM_SYMBOL (sym_core, "core");
466 #endif
467 #ifdef RLIMIT_CPU
468 SCM_SYMBOL (sym_cpu, "cpu");
469 #endif
470 #ifdef RLIMIT_DATA
471 SCM_SYMBOL (sym_data, "data");
472 #endif
473 #ifdef RLIMIT_FSIZE
474 SCM_SYMBOL (sym_fsize, "fsize");
475 #endif
476 #ifdef RLIMIT_MEMLOCK
477 SCM_SYMBOL (sym_memlock, "memlock");
478 #endif
479 #ifdef RLIMIT_MSGQUEUE
480 SCM_SYMBOL (sym_msgqueue, "msgqueue");
481 #endif
482 #ifdef RLIMIT_NICE
483 SCM_SYMBOL (sym_nice, "nice");
484 #endif
485 #ifdef RLIMIT_NOFILE
486 SCM_SYMBOL (sym_nofile, "nofile");
487 #endif
488 #ifdef RLIMIT_NPROC
489 SCM_SYMBOL (sym_nproc, "nproc");
490 #endif
491 #ifdef RLIMIT_RSS
492 SCM_SYMBOL (sym_rss, "rss");
493 #endif
494 #ifdef RLIMIT_RTPRIO
495 SCM_SYMBOL (sym_rtprio, "rtprio");
496 #endif
497 #ifdef RLIMIT_RTPRIO
498 SCM_SYMBOL (sym_rttime, "rttime");
499 #endif
500 #ifdef RLIMIT_SIGPENDING
501 SCM_SYMBOL (sym_sigpending, "sigpending");
502 #endif
503 #ifdef RLIMIT_STACK
504 SCM_SYMBOL (sym_stack, "stack");
505 #endif
506
507 static int
508 scm_to_resource (SCM s, const char *func, int pos)
509 {
510 if (scm_is_number (s))
511 return scm_to_int (s);
512
513 SCM_ASSERT_TYPE (scm_is_symbol (s), s, pos, func, "symbol");
514
515 #ifdef RLIMIT_AS
516 if (scm_is_eq (s, sym_as))
517 return RLIMIT_AS;
518 #endif
519 #ifdef RLIMIT_CORE
520 if (scm_is_eq (s, sym_core))
521 return RLIMIT_CORE;
522 #endif
523 #ifdef RLIMIT_CPU
524 if (scm_is_eq (s, sym_cpu))
525 return RLIMIT_CPU;
526 #endif
527 #ifdef RLIMIT_DATA
528 if (scm_is_eq (s, sym_data))
529 return RLIMIT_DATA;
530 #endif
531 #ifdef RLIMIT_FSIZE
532 if (scm_is_eq (s, sym_fsize))
533 return RLIMIT_FSIZE;
534 #endif
535 #ifdef RLIMIT_MEMLOCK
536 if (scm_is_eq (s, sym_memlock))
537 return RLIMIT_MEMLOCK;
538 #endif
539 #ifdef RLIMIT_MSGQUEUE
540 if (scm_is_eq (s, sym_msgqueue))
541 return RLIMIT_MSGQUEUE;
542 #endif
543 #ifdef RLIMIT_NICE
544 if (scm_is_eq (s, sym_nice))
545 return RLIMIT_NICE;
546 #endif
547 #ifdef RLIMIT_NOFILE
548 if (scm_is_eq (s, sym_nofile))
549 return RLIMIT_NOFILE;
550 #endif
551 #ifdef RLIMIT_NPROC
552 if (scm_is_eq (s, sym_nproc))
553 return RLIMIT_NPROC;
554 #endif
555 #ifdef RLIMIT_RSS
556 if (scm_is_eq (s, sym_rss))
557 return RLIMIT_RSS;
558 #endif
559 #ifdef RLIMIT_RTPRIO
560 if (scm_is_eq (s, sym_rtprio))
561 return RLIMIT_RTPRIO;
562 #endif
563 #ifdef RLIMIT_RTPRIO
564 if (scm_is_eq (s, sym_rttime))
565 return RLIMIT_RTPRIO;
566 #endif
567 #ifdef RLIMIT_SIGPENDING
568 if (scm_is_eq (s, sym_sigpending))
569 return RLIMIT_SIGPENDING;
570 #endif
571 #ifdef RLIMIT_STACK
572 if (scm_is_eq (s, sym_stack))
573 return RLIMIT_STACK;
574 #endif
575
576 scm_misc_error (func, "invalid rlimit resource ~A", scm_list_1 (s));
577 return 0;
578 }
579
580 SCM_DEFINE (scm_getrlimit, "getrlimit", 1, 0, 0,
581 (SCM resource),
582 "Get a resource limit for this process. @var{resource} identifies the resource,\n"
583 "either as an integer or as a symbol. For example, @code{(getrlimit 'stack)}\n"
584 "gets the limits associated with @code{RLIMIT_STACK}.\n\n"
585 "@code{getrlimit} returns two values, the soft and the hard limit. If no\n"
586 "limit is set for the resource in question, the returned limit will be @code{#f}.")
587 #define FUNC_NAME s_scm_getrlimit
588 {
589 int iresource;
590 struct rlimit lim = { 0, 0 };
591
592 iresource = scm_to_resource (resource, FUNC_NAME, 1);
593
594 if (getrlimit (iresource, &lim) != 0)
595 scm_syserror (FUNC_NAME);
596
597 return scm_values (scm_list_2 ((lim.rlim_cur == RLIM_INFINITY) ? SCM_BOOL_F
598 : scm_from_long (lim.rlim_cur),
599 (lim.rlim_max == RLIM_INFINITY) ? SCM_BOOL_F
600 : scm_from_long (lim.rlim_max)));
601 }
602 #undef FUNC_NAME
603
604
605 #ifdef HAVE_SETRLIMIT
606 SCM_DEFINE (scm_setrlimit, "setrlimit", 3, 0, 0,
607 (SCM resource, SCM soft, SCM hard),
608 "Set a resource limit for this process. @var{resource} identifies the resource,\n"
609 "either as an integer or as a symbol. @var{soft} and @var{hard} should be integers,\n"
610 "or @code{#f} to indicate no limit (i.e., @code{RLIM_INFINITY}).\n\n"
611 "For example, @code{(setrlimit 'stack 150000 300000)} sets the @code{RLIMIT_STACK}\n"
612 "limit to 150 kilobytes, with a hard limit of 300 kB.")
613 #define FUNC_NAME s_scm_setrlimit
614 {
615 int iresource;
616 struct rlimit lim = { 0, 0 };
617
618 iresource = scm_to_resource (resource, FUNC_NAME, 1);
619
620 lim.rlim_cur = scm_is_false (soft) ? RLIM_INFINITY : scm_to_long (soft);
621 lim.rlim_max = scm_is_false (hard) ? RLIM_INFINITY : scm_to_long (hard);
622
623 if (setrlimit (iresource, &lim) != 0)
624 scm_syserror (FUNC_NAME);
625
626 return SCM_UNSPECIFIED;
627 }
628 #undef FUNC_NAME
629 #endif /* HAVE_SETRLIMIT */
630 #endif /* HAVE_GETRLIMIT */
631
632
633 SCM_DEFINE (scm_kill, "kill", 2, 0, 0,
634 (SCM pid, SCM sig),
635 "Sends a signal to the specified process or group of processes.\n\n"
636 "@var{pid} specifies the processes to which the signal is sent:\n\n"
637 "@table @r\n"
638 "@item @var{pid} greater than 0\n"
639 "The process whose identifier is @var{pid}.\n"
640 "@item @var{pid} equal to 0\n"
641 "All processes in the current process group.\n"
642 "@item @var{pid} less than -1\n"
643 "The process group whose identifier is -@var{pid}\n"
644 "@item @var{pid} equal to -1\n"
645 "If the process is privileged, all processes except for some special\n"
646 "system processes. Otherwise, all processes with the current effective\n"
647 "user ID.\n"
648 "@end table\n\n"
649 "@var{sig} should be specified using a variable corresponding to\n"
650 "the Unix symbolic name, e.g.,\n\n"
651 "@defvar SIGHUP\n"
652 "Hang-up signal.\n"
653 "@end defvar\n\n"
654 "@defvar SIGINT\n"
655 "Interrupt signal.\n"
656 "@end defvar")
657 #define FUNC_NAME s_scm_kill
658 {
659 /* Signal values are interned in scm_init_posix(). */
660 #ifdef HAVE_KILL
661 if (kill (scm_to_int (pid), scm_to_int (sig)) != 0)
662 SCM_SYSERROR;
663 #else
664 /* Mingw has raise(), but not kill(). (Other raw DOS environments might
665 be similar.) Use raise() when the requested pid is our own process,
666 otherwise bomb. */
667 if (scm_to_int (pid) == getpid ())
668 {
669 if (raise (scm_to_int (sig)) != 0)
670 {
671 err:
672 SCM_SYSERROR;
673 }
674 else
675 {
676 errno = ENOSYS;
677 goto err;
678 }
679 }
680 #endif
681 return SCM_UNSPECIFIED;
682 }
683 #undef FUNC_NAME
684
685 #ifdef HAVE_WAITPID
686 SCM_DEFINE (scm_waitpid, "waitpid", 1, 1, 0,
687 (SCM pid, SCM options),
688 "This procedure collects status information from a child process which\n"
689 "has terminated or (optionally) stopped. Normally it will\n"
690 "suspend the calling process until this can be done. If more than one\n"
691 "child process is eligible then one will be chosen by the operating system.\n\n"
692 "The value of @var{pid} determines the behaviour:\n\n"
693 "@table @r\n"
694 "@item @var{pid} greater than 0\n"
695 "Request status information from the specified child process.\n"
696 "@item @var{pid} equal to -1 or WAIT_ANY\n"
697 "Request status information for any child process.\n"
698 "@item @var{pid} equal to 0 or WAIT_MYPGRP\n"
699 "Request status information for any child process in the current process\n"
700 "group.\n"
701 "@item @var{pid} less than -1\n"
702 "Request status information for any child process whose process group ID\n"
703 "is -@var{pid}.\n"
704 "@end table\n\n"
705 "The @var{options} argument, if supplied, should be the bitwise OR of the\n"
706 "values of zero or more of the following variables:\n\n"
707 "@defvar WNOHANG\n"
708 "Return immediately even if there are no child processes to be collected.\n"
709 "@end defvar\n\n"
710 "@defvar WUNTRACED\n"
711 "Report status information for stopped processes as well as terminated\n"
712 "processes.\n"
713 "@end defvar\n\n"
714 "The return value is a pair containing:\n\n"
715 "@enumerate\n"
716 "@item\n"
717 "The process ID of the child process, or 0 if @code{WNOHANG} was\n"
718 "specified and no process was collected.\n"
719 "@item\n"
720 "The integer status value.\n"
721 "@end enumerate")
722 #define FUNC_NAME s_scm_waitpid
723 {
724 int i;
725 int status;
726 int ioptions;
727 if (SCM_UNBNDP (options))
728 ioptions = 0;
729 else
730 {
731 /* Flags are interned in scm_init_posix. */
732 ioptions = scm_to_int (options);
733 }
734 SCM_SYSCALL (i = waitpid (scm_to_int (pid), &status, ioptions));
735 if (i == -1)
736 SCM_SYSERROR;
737 return scm_cons (scm_from_int (i), scm_from_int (status));
738 }
739 #undef FUNC_NAME
740 #endif /* HAVE_WAITPID */
741
742 #ifndef __MINGW32__
743 SCM_DEFINE (scm_status_exit_val, "status:exit-val", 1, 0, 0,
744 (SCM status),
745 "Return the exit status value, as would be set if a process\n"
746 "ended normally through a call to @code{exit} or @code{_exit},\n"
747 "if any, otherwise @code{#f}.")
748 #define FUNC_NAME s_scm_status_exit_val
749 {
750 int lstatus;
751
752 /* On Ultrix, the WIF... macros assume their argument is an lvalue;
753 go figure. */
754 lstatus = scm_to_int (status);
755 if (WIFEXITED (lstatus))
756 return (scm_from_int (WEXITSTATUS (lstatus)));
757 else
758 return SCM_BOOL_F;
759 }
760 #undef FUNC_NAME
761
762 SCM_DEFINE (scm_status_term_sig, "status:term-sig", 1, 0, 0,
763 (SCM status),
764 "Return the signal number which terminated the process, if any,\n"
765 "otherwise @code{#f}.")
766 #define FUNC_NAME s_scm_status_term_sig
767 {
768 int lstatus;
769
770 lstatus = scm_to_int (status);
771 if (WIFSIGNALED (lstatus))
772 return scm_from_int (WTERMSIG (lstatus));
773 else
774 return SCM_BOOL_F;
775 }
776 #undef FUNC_NAME
777
778 SCM_DEFINE (scm_status_stop_sig, "status:stop-sig", 1, 0, 0,
779 (SCM status),
780 "Return the signal number which stopped the process, if any,\n"
781 "otherwise @code{#f}.")
782 #define FUNC_NAME s_scm_status_stop_sig
783 {
784 int lstatus;
785
786 lstatus = scm_to_int (status);
787 if (WIFSTOPPED (lstatus))
788 return scm_from_int (WSTOPSIG (lstatus));
789 else
790 return SCM_BOOL_F;
791 }
792 #undef FUNC_NAME
793 #endif /* __MINGW32__ */
794
795 #ifdef HAVE_GETPPID
796 SCM_DEFINE (scm_getppid, "getppid", 0, 0, 0,
797 (),
798 "Return an integer representing the process ID of the parent\n"
799 "process.")
800 #define FUNC_NAME s_scm_getppid
801 {
802 return scm_from_int (getppid ());
803 }
804 #undef FUNC_NAME
805 #endif /* HAVE_GETPPID */
806
807
808 #ifndef __MINGW32__
809 SCM_DEFINE (scm_getuid, "getuid", 0, 0, 0,
810 (),
811 "Return an integer representing the current real user ID.")
812 #define FUNC_NAME s_scm_getuid
813 {
814 return scm_from_int (getuid ());
815 }
816 #undef FUNC_NAME
817
818
819
820 SCM_DEFINE (scm_getgid, "getgid", 0, 0, 0,
821 (),
822 "Return an integer representing the current real group ID.")
823 #define FUNC_NAME s_scm_getgid
824 {
825 return scm_from_int (getgid ());
826 }
827 #undef FUNC_NAME
828
829
830
831 SCM_DEFINE (scm_geteuid, "geteuid", 0, 0, 0,
832 (),
833 "Return an integer representing the current effective user ID.\n"
834 "If the system does not support effective IDs, then the real ID\n"
835 "is returned. @code{(provided? 'EIDs)} reports whether the\n"
836 "system supports effective IDs.")
837 #define FUNC_NAME s_scm_geteuid
838 {
839 #ifdef HAVE_GETEUID
840 return scm_from_int (geteuid ());
841 #else
842 return scm_from_int (getuid ());
843 #endif
844 }
845 #undef FUNC_NAME
846
847
848 SCM_DEFINE (scm_getegid, "getegid", 0, 0, 0,
849 (),
850 "Return an integer representing the current effective group ID.\n"
851 "If the system does not support effective IDs, then the real ID\n"
852 "is returned. @code{(provided? 'EIDs)} reports whether the\n"
853 "system supports effective IDs.")
854 #define FUNC_NAME s_scm_getegid
855 {
856 #ifdef HAVE_GETEUID
857 return scm_from_int (getegid ());
858 #else
859 return scm_from_int (getgid ());
860 #endif
861 }
862 #undef FUNC_NAME
863
864
865 SCM_DEFINE (scm_setuid, "setuid", 1, 0, 0,
866 (SCM id),
867 "Sets both the real and effective user IDs to the integer @var{id}, provided\n"
868 "the process has appropriate privileges.\n"
869 "The return value is unspecified.")
870 #define FUNC_NAME s_scm_setuid
871 {
872 if (setuid (scm_to_int (id)) != 0)
873 SCM_SYSERROR;
874 return SCM_UNSPECIFIED;
875 }
876 #undef FUNC_NAME
877
878 SCM_DEFINE (scm_setgid, "setgid", 1, 0, 0,
879 (SCM id),
880 "Sets both the real and effective group IDs to the integer @var{id}, provided\n"
881 "the process has appropriate privileges.\n"
882 "The return value is unspecified.")
883 #define FUNC_NAME s_scm_setgid
884 {
885 if (setgid (scm_to_int (id)) != 0)
886 SCM_SYSERROR;
887 return SCM_UNSPECIFIED;
888 }
889 #undef FUNC_NAME
890
891 SCM_DEFINE (scm_seteuid, "seteuid", 1, 0, 0,
892 (SCM id),
893 "Sets the effective user ID to the integer @var{id}, provided the process\n"
894 "has appropriate privileges. If effective IDs are not supported, the\n"
895 "real ID is set instead -- @code{(provided? 'EIDs)} reports whether the\n"
896 "system supports effective IDs.\n"
897 "The return value is unspecified.")
898 #define FUNC_NAME s_scm_seteuid
899 {
900 int rv;
901
902 #ifdef HAVE_SETEUID
903 rv = seteuid (scm_to_int (id));
904 #else
905 rv = setuid (scm_to_int (id));
906 #endif
907 if (rv != 0)
908 SCM_SYSERROR;
909 return SCM_UNSPECIFIED;
910 }
911 #undef FUNC_NAME
912 #endif /* __MINGW32__ */
913
914
915 #ifdef HAVE_SETEGID
916 SCM_DEFINE (scm_setegid, "setegid", 1, 0, 0,
917 (SCM id),
918 "Sets the effective group ID to the integer @var{id}, provided the process\n"
919 "has appropriate privileges. If effective IDs are not supported, the\n"
920 "real ID is set instead -- @code{(provided? 'EIDs)} reports whether the\n"
921 "system supports effective IDs.\n"
922 "The return value is unspecified.")
923 #define FUNC_NAME s_scm_setegid
924 {
925 int rv;
926
927 #ifdef HAVE_SETEUID
928 rv = setegid (scm_to_int (id));
929 #else
930 rv = setgid (scm_to_int (id));
931 #endif
932 if (rv != 0)
933 SCM_SYSERROR;
934 return SCM_UNSPECIFIED;
935
936 }
937 #undef FUNC_NAME
938 #endif
939
940
941 #ifdef HAVE_GETPGRP
942 SCM_DEFINE (scm_getpgrp, "getpgrp", 0, 0, 0,
943 (),
944 "Return an integer representing the current process group ID.\n"
945 "This is the POSIX definition, not BSD.")
946 #define FUNC_NAME s_scm_getpgrp
947 {
948 int (*fn)();
949 fn = (int (*) ()) getpgrp;
950 return scm_from_int (fn (0));
951 }
952 #undef FUNC_NAME
953 #endif /* HAVE_GETPGRP */
954
955
956 #ifdef HAVE_SETPGID
957 SCM_DEFINE (scm_setpgid, "setpgid", 2, 0, 0,
958 (SCM pid, SCM pgid),
959 "Move the process @var{pid} into the process group @var{pgid}. @var{pid} or\n"
960 "@var{pgid} must be integers: they can be zero to indicate the ID of the\n"
961 "current process.\n"
962 "Fails on systems that do not support job control.\n"
963 "The return value is unspecified.")
964 #define FUNC_NAME s_scm_setpgid
965 {
966 /* FIXME(?): may be known as setpgrp. */
967 if (setpgid (scm_to_int (pid), scm_to_int (pgid)) != 0)
968 SCM_SYSERROR;
969 return SCM_UNSPECIFIED;
970 }
971 #undef FUNC_NAME
972 #endif /* HAVE_SETPGID */
973
974 #ifdef HAVE_SETSID
975 SCM_DEFINE (scm_setsid, "setsid", 0, 0, 0,
976 (),
977 "Creates a new session. The current process becomes the session leader\n"
978 "and is put in a new process group. The process will be detached\n"
979 "from its controlling terminal if it has one.\n"
980 "The return value is an integer representing the new process group ID.")
981 #define FUNC_NAME s_scm_setsid
982 {
983 pid_t sid = setsid ();
984 if (sid == -1)
985 SCM_SYSERROR;
986 return SCM_UNSPECIFIED;
987 }
988 #undef FUNC_NAME
989 #endif /* HAVE_SETSID */
990
991 #ifdef HAVE_GETSID
992 SCM_DEFINE (scm_getsid, "getsid", 1, 0, 0,
993 (SCM pid),
994 "Returns the session ID of process @var{pid}. (The session\n"
995 "ID of a process is the process group ID of its session leader.)")
996 #define FUNC_NAME s_scm_getsid
997 {
998 return scm_from_int (getsid (scm_to_int (pid)));
999 }
1000 #undef FUNC_NAME
1001 #endif /* HAVE_GETSID */
1002
1003
1004 /* ttyname returns its result in a single static buffer, hence
1005 scm_i_misc_mutex for thread safety. In glibc 2.3.2 two threads
1006 continuously calling ttyname will otherwise get an overwrite quite
1007 easily.
1008
1009 ttyname_r (when available) could be used instead of scm_i_misc_mutex, but
1010 there's probably little to be gained in either speed or parallelism. */
1011
1012 #ifdef HAVE_TTYNAME
1013 SCM_DEFINE (scm_ttyname, "ttyname", 1, 0, 0,
1014 (SCM port),
1015 "Return a string with the name of the serial terminal device\n"
1016 "underlying @var{port}.")
1017 #define FUNC_NAME s_scm_ttyname
1018 {
1019 char *result;
1020 int fd, err;
1021 SCM ret = SCM_BOOL_F;
1022
1023 port = SCM_COERCE_OUTPORT (port);
1024 SCM_VALIDATE_OPPORT (1, port);
1025 if (!SCM_FPORTP (port))
1026 return SCM_BOOL_F;
1027 fd = SCM_FPORT_FDES (port);
1028
1029 scm_i_scm_pthread_mutex_lock (&scm_i_misc_mutex);
1030
1031 SCM_SYSCALL (result = ttyname (fd));
1032 err = errno;
1033 if (result != NULL)
1034 result = strdup (result);
1035
1036 scm_i_pthread_mutex_unlock (&scm_i_misc_mutex);
1037
1038 if (!result)
1039 {
1040 errno = err;
1041 SCM_SYSERROR;
1042 }
1043 else
1044 ret = scm_take_locale_string (result);
1045
1046 return ret;
1047 }
1048 #undef FUNC_NAME
1049 #endif /* HAVE_TTYNAME */
1050
1051
1052 /* For thread safety "buf" is used instead of NULL for the ctermid static
1053 buffer. Actually it's unlikely the controlling terminal will change
1054 during program execution, and indeed on glibc (2.3.2) it's always just
1055 "/dev/tty", but L_ctermid on the stack is easy and fast and guarantees
1056 safety everywhere. */
1057 #ifdef HAVE_CTERMID
1058 SCM_DEFINE (scm_ctermid, "ctermid", 0, 0, 0,
1059 (),
1060 "Return a string containing the file name of the controlling\n"
1061 "terminal for the current process.")
1062 #define FUNC_NAME s_scm_ctermid
1063 {
1064 char buf[L_ctermid];
1065 char *result = ctermid (buf);
1066 if (*result == '\0')
1067 SCM_SYSERROR;
1068 return scm_from_locale_string (result);
1069 }
1070 #undef FUNC_NAME
1071 #endif /* HAVE_CTERMID */
1072
1073 #ifdef HAVE_TCGETPGRP
1074 SCM_DEFINE (scm_tcgetpgrp, "tcgetpgrp", 1, 0, 0,
1075 (SCM port),
1076 "Return the process group ID of the foreground process group\n"
1077 "associated with the terminal open on the file descriptor\n"
1078 "underlying @var{port}.\n"
1079 "\n"
1080 "If there is no foreground process group, the return value is a\n"
1081 "number greater than 1 that does not match the process group ID\n"
1082 "of any existing process group. This can happen if all of the\n"
1083 "processes in the job that was formerly the foreground job have\n"
1084 "terminated, and no other job has yet been moved into the\n"
1085 "foreground.")
1086 #define FUNC_NAME s_scm_tcgetpgrp
1087 {
1088 int fd;
1089 pid_t pgid;
1090
1091 port = SCM_COERCE_OUTPORT (port);
1092
1093 SCM_VALIDATE_OPFPORT (1, port);
1094 fd = SCM_FPORT_FDES (port);
1095 if ((pgid = tcgetpgrp (fd)) == -1)
1096 SCM_SYSERROR;
1097 return scm_from_int (pgid);
1098 }
1099 #undef FUNC_NAME
1100 #endif /* HAVE_TCGETPGRP */
1101
1102 #ifdef HAVE_TCSETPGRP
1103 SCM_DEFINE (scm_tcsetpgrp, "tcsetpgrp", 2, 0, 0,
1104 (SCM port, SCM pgid),
1105 "Set the foreground process group ID for the terminal used by the file\n"
1106 "descriptor underlying @var{port} to the integer @var{pgid}.\n"
1107 "The calling process\n"
1108 "must be a member of the same session as @var{pgid} and must have the same\n"
1109 "controlling terminal. The return value is unspecified.")
1110 #define FUNC_NAME s_scm_tcsetpgrp
1111 {
1112 int fd;
1113
1114 port = SCM_COERCE_OUTPORT (port);
1115
1116 SCM_VALIDATE_OPFPORT (1, port);
1117 fd = SCM_FPORT_FDES (port);
1118 if (tcsetpgrp (fd, scm_to_int (pgid)) == -1)
1119 SCM_SYSERROR;
1120 return SCM_UNSPECIFIED;
1121 }
1122 #undef FUNC_NAME
1123 #endif /* HAVE_TCSETPGRP */
1124
1125 SCM_DEFINE (scm_execl, "execl", 1, 0, 1,
1126 (SCM filename, SCM args),
1127 "Executes the file named by @var{filename} as a new process image.\n"
1128 "The remaining arguments are supplied to the process; from a C program\n"
1129 "they are accessible as the @code{argv} argument to @code{main}.\n"
1130 "Conventionally the first @var{arg} is the same as @var{filename}.\n"
1131 "All arguments must be strings.\n\n"
1132 "If @var{arg} is missing, @var{path} is executed with a null\n"
1133 "argument list, which may have system-dependent side-effects.\n\n"
1134 "This procedure is currently implemented using the @code{execv} system\n"
1135 "call, but we call it @code{execl} because of its Scheme calling interface.")
1136 #define FUNC_NAME s_scm_execl
1137 {
1138 char *exec_file;
1139 char **exec_argv;
1140
1141 scm_dynwind_begin (0);
1142
1143 exec_file = scm_to_locale_string (filename);
1144 scm_dynwind_free (exec_file);
1145
1146 exec_argv = scm_i_allocate_string_pointers (args);
1147
1148 execv (exec_file,
1149 #ifdef __MINGW32__
1150 /* extra "const" in mingw formals, provokes warning from gcc */
1151 (const char * const *)
1152 #endif
1153 exec_argv);
1154 SCM_SYSERROR;
1155
1156 /* not reached. */
1157 scm_dynwind_end ();
1158 return SCM_BOOL_F;
1159 }
1160 #undef FUNC_NAME
1161
1162 SCM_DEFINE (scm_execlp, "execlp", 1, 0, 1,
1163 (SCM filename, SCM args),
1164 "Similar to @code{execl}, however if\n"
1165 "@var{filename} does not contain a slash\n"
1166 "then the file to execute will be located by searching the\n"
1167 "directories listed in the @code{PATH} environment variable.\n\n"
1168 "This procedure is currently implemented using the @code{execvp} system\n"
1169 "call, but we call it @code{execlp} because of its Scheme calling interface.")
1170 #define FUNC_NAME s_scm_execlp
1171 {
1172 char *exec_file;
1173 char **exec_argv;
1174
1175 scm_dynwind_begin (0);
1176
1177 exec_file = scm_to_locale_string (filename);
1178 scm_dynwind_free (exec_file);
1179
1180 exec_argv = scm_i_allocate_string_pointers (args);
1181
1182 execvp (exec_file,
1183 #ifdef __MINGW32__
1184 /* extra "const" in mingw formals, provokes warning from gcc */
1185 (const char * const *)
1186 #endif
1187 exec_argv);
1188 SCM_SYSERROR;
1189
1190 /* not reached. */
1191 scm_dynwind_end ();
1192 return SCM_BOOL_F;
1193 }
1194 #undef FUNC_NAME
1195
1196
1197 /* OPTIMIZE-ME: scm_execle doesn't need malloced copies of the environment
1198 list strings the way environ_list_to_c gives. */
1199
1200 SCM_DEFINE (scm_execle, "execle", 2, 0, 1,
1201 (SCM filename, SCM env, SCM args),
1202 "Similar to @code{execl}, but the environment of the new process is\n"
1203 "specified by @var{env}, which must be a list of strings as returned by the\n"
1204 "@code{environ} procedure.\n\n"
1205 "This procedure is currently implemented using the @code{execve} system\n"
1206 "call, but we call it @code{execle} because of its Scheme calling interface.")
1207 #define FUNC_NAME s_scm_execle
1208 {
1209 char **exec_argv;
1210 char **exec_env;
1211 char *exec_file;
1212
1213 scm_dynwind_begin (0);
1214
1215 exec_file = scm_to_locale_string (filename);
1216 scm_dynwind_free (exec_file);
1217
1218 exec_argv = scm_i_allocate_string_pointers (args);
1219 exec_env = scm_i_allocate_string_pointers (env);
1220
1221 execve (exec_file,
1222 #ifdef __MINGW32__
1223 /* extra "const" in mingw formals, provokes warning from gcc */
1224 (const char * const *)
1225 #endif
1226 exec_argv,
1227 #ifdef __MINGW32__
1228 /* extra "const" in mingw formals, provokes warning from gcc */
1229 (const char * const *)
1230 #endif
1231 exec_env);
1232 SCM_SYSERROR;
1233
1234 /* not reached. */
1235 scm_dynwind_end ();
1236 return SCM_BOOL_F;
1237 }
1238 #undef FUNC_NAME
1239
1240 #ifdef HAVE_FORK
1241 SCM_DEFINE (scm_fork, "primitive-fork", 0, 0, 0,
1242 (),
1243 "Creates a new \"child\" process by duplicating the current \"parent\" process.\n"
1244 "In the child the return value is 0. In the parent the return value is\n"
1245 "the integer process ID of the child.\n\n"
1246 "This procedure has been renamed from @code{fork} to avoid a naming conflict\n"
1247 "with the scsh fork.")
1248 #define FUNC_NAME s_scm_fork
1249 {
1250 int pid;
1251 scm_i_finalizer_pre_fork ();
1252 if (scm_ilength (scm_all_threads ()) != 1)
1253 /* Other threads may be holding on to resources that Guile needs --
1254 it is not safe to permit one thread to fork while others are
1255 running.
1256
1257 In addition, POSIX clearly specifies that if a multi-threaded
1258 program forks, the child must only call functions that are
1259 async-signal-safe. We can't guarantee that in general. The best
1260 we can do is to allow forking only very early, before any call to
1261 sigaction spawns the signal-handling thread. */
1262 SCM_MISC_ERROR ("attempt to fork while multiple threads are running",
1263 SCM_EOL);
1264 pid = fork ();
1265 if (pid == -1)
1266 SCM_SYSERROR;
1267 return scm_from_int (pid);
1268 }
1269 #undef FUNC_NAME
1270
1271 /* Since Guile uses threads, we have to be very careful to avoid calling
1272 functions that are not async-signal-safe in the child. That's why
1273 this function is implemented in C. */
1274 static SCM
1275 scm_open_process (SCM mode, SCM prog, SCM args)
1276 #define FUNC_NAME "open-process"
1277 {
1278 long mode_bits;
1279 int reading, writing;
1280 int c2p[2]; /* Child to parent. */
1281 int p2c[2]; /* Parent to child. */
1282 int in = -1, out = -1, err = -1;
1283 int pid;
1284 char *exec_file;
1285 char **exec_argv;
1286 int max_fd = 1024;
1287
1288 exec_file = scm_to_locale_string (prog);
1289 exec_argv = scm_i_allocate_string_pointers (scm_cons (prog, args));
1290
1291 mode_bits = scm_i_mode_bits (mode);
1292 reading = mode_bits & SCM_RDNG;
1293 writing = mode_bits & SCM_WRTNG;
1294
1295 if (reading)
1296 {
1297 if (pipe (c2p))
1298 {
1299 int errno_save = errno;
1300 free (exec_file);
1301 errno = errno_save;
1302 SCM_SYSERROR;
1303 }
1304 out = c2p[1];
1305 }
1306
1307 if (writing)
1308 {
1309 if (pipe (p2c))
1310 {
1311 int errno_save = errno;
1312 free (exec_file);
1313 if (reading)
1314 {
1315 close (c2p[0]);
1316 close (c2p[1]);
1317 }
1318 errno = errno_save;
1319 SCM_SYSERROR;
1320 }
1321 in = p2c[0];
1322 }
1323
1324 {
1325 SCM port;
1326
1327 if (SCM_OPOUTFPORTP ((port = scm_current_error_port ())))
1328 err = SCM_FPORT_FDES (port);
1329 if (out == -1 && SCM_OPOUTFPORTP ((port = scm_current_output_port ())))
1330 out = SCM_FPORT_FDES (port);
1331 if (in == -1 && SCM_OPINFPORTP ((port = scm_current_input_port ())))
1332 in = SCM_FPORT_FDES (port);
1333 }
1334
1335 #if defined (HAVE_GETRLIMIT) && defined (RLIMIT_NOFILE)
1336 {
1337 struct rlimit lim = { 0, 0 };
1338 if (getrlimit (RLIMIT_NOFILE, &lim) == 0)
1339 max_fd = lim.rlim_cur;
1340 }
1341 #endif
1342
1343 pid = fork ();
1344
1345 if (pid == -1)
1346 {
1347 int errno_save = errno;
1348 free (exec_file);
1349 if (reading)
1350 {
1351 close (c2p[0]);
1352 close (c2p[1]);
1353 }
1354 if (writing)
1355 {
1356 close (p2c[0]);
1357 close (p2c[1]);
1358 }
1359 errno = errno_save;
1360 SCM_SYSERROR;
1361 }
1362
1363 if (pid)
1364 /* Parent. */
1365 {
1366 SCM read_port = SCM_BOOL_F, write_port = SCM_BOOL_F, port;
1367
1368 /* There is no sense in catching errors on close(). */
1369 if (reading)
1370 {
1371 close (c2p[1]);
1372 read_port = scm_fdes_to_port (c2p[0], "r", sym_read_pipe);
1373 scm_setvbuf (read_port, scm_from_int (_IONBF), SCM_UNDEFINED);
1374 }
1375 if (writing)
1376 {
1377 close (p2c[0]);
1378 write_port = scm_fdes_to_port (p2c[1], "w", sym_write_pipe);
1379 scm_setvbuf (write_port, scm_from_int (_IONBF), SCM_UNDEFINED);
1380 }
1381
1382 if (reading && writing)
1383 {
1384 static SCM make_rw_port = SCM_BOOL_F;
1385
1386 if (scm_is_false (make_rw_port))
1387 make_rw_port = scm_c_private_variable ("ice-9 popen",
1388 "make-rw-port");
1389
1390 port = scm_call_2 (scm_variable_ref (make_rw_port),
1391 read_port, write_port);
1392 }
1393 else if (reading)
1394 port = read_port;
1395 else if (writing)
1396 port = write_port;
1397 else
1398 port = scm_sys_make_void_port (mode);
1399
1400 return scm_cons (port, scm_from_int (pid));
1401 }
1402
1403 /* The child. */
1404 if (reading)
1405 close (c2p[0]);
1406 if (writing)
1407 close (p2c[1]);
1408
1409 /* Close all file descriptors in ports inherited from the parent
1410 except for in, out, and err. Heavy-handed, but robust. */
1411 while (max_fd--)
1412 if (max_fd != in && max_fd != out && max_fd != err)
1413 close (max_fd);
1414
1415 /* Ignore errors on these open() calls. */
1416 if (in == -1)
1417 in = open ("/dev/null", O_RDONLY);
1418 if (out == -1)
1419 out = open ("/dev/null", O_WRONLY);
1420 if (err == -1)
1421 err = open ("/dev/null", O_WRONLY);
1422
1423 if (in > 0)
1424 {
1425 if (out == 0)
1426 do out = dup (out); while (errno == EINTR);
1427 if (err == 0)
1428 do err = dup (err); while (errno == EINTR);
1429 do dup2 (in, 0); while (errno == EINTR);
1430 close (in);
1431 }
1432 if (out > 1)
1433 {
1434 if (err == 1)
1435 do err = dup (err); while (errno == EINTR);
1436 do dup2 (out, 1); while (errno == EINTR);
1437 close (out);
1438 }
1439 if (err > 2)
1440 {
1441 do dup2 (err, 2); while (errno == EINTR);
1442 close (err);
1443 }
1444
1445 execvp (exec_file,
1446 #ifdef __MINGW32__
1447 /* extra "const" in mingw formals, provokes warning from gcc */
1448 (const char * const *)
1449 #endif
1450 exec_argv);
1451
1452 /* The exec failed! There is nothing sensible to do. */
1453 if (err > 0)
1454 {
1455 char *msg = strerror (errno);
1456 fprintf (fdopen (err, "a"), "In execlp of %s: %s\n",
1457 exec_file, msg);
1458 }
1459
1460 _exit (EXIT_FAILURE);
1461 /* Not reached. */
1462 return SCM_BOOL_F;
1463 }
1464 #undef FUNC_NAME
1465 #endif /* HAVE_FORK */
1466
1467 #ifdef __MINGW32__
1468 # include "win32-uname.h"
1469 #endif
1470
1471 #if defined (HAVE_UNAME) || defined (__MINGW32__)
1472 SCM_DEFINE (scm_uname, "uname", 0, 0, 0,
1473 (),
1474 "Return an object with some information about the computer\n"
1475 "system the program is running on.")
1476 #define FUNC_NAME s_scm_uname
1477 {
1478 struct utsname buf;
1479 SCM result = scm_c_make_vector (5, SCM_UNSPECIFIED);
1480 if (uname (&buf) < 0)
1481 SCM_SYSERROR;
1482 SCM_SIMPLE_VECTOR_SET(result, 0, scm_from_locale_string (buf.sysname));
1483 SCM_SIMPLE_VECTOR_SET(result, 1, scm_from_locale_string (buf.nodename));
1484 SCM_SIMPLE_VECTOR_SET(result, 2, scm_from_locale_string (buf.release));
1485 SCM_SIMPLE_VECTOR_SET(result, 3, scm_from_locale_string (buf.version));
1486 SCM_SIMPLE_VECTOR_SET(result, 4, scm_from_locale_string (buf.machine));
1487 /*
1488 a linux special?
1489 SCM_SIMPLE_VECTOR_SET(result, 5, scm_from_locale_string (buf.domainname));
1490 */
1491 return result;
1492 }
1493 #undef FUNC_NAME
1494 #endif /* HAVE_UNAME */
1495
1496 SCM_DEFINE (scm_environ, "environ", 0, 1, 0,
1497 (SCM env),
1498 "If @var{env} is omitted, return the current environment (in the\n"
1499 "Unix sense) as a list of strings. Otherwise set the current\n"
1500 "environment, which is also the default environment for child\n"
1501 "processes, to the supplied list of strings. Each member of\n"
1502 "@var{env} should be of the form @code{NAME=VALUE} and values of\n"
1503 "@code{NAME} should not be duplicated. If @var{env} is supplied\n"
1504 "then the return value is unspecified.")
1505 #define FUNC_NAME s_scm_environ
1506 {
1507 if (SCM_UNBNDP (env))
1508 return scm_makfromstrs (-1, environ);
1509 else
1510 {
1511 environ = scm_i_allocate_string_pointers (env);
1512 return SCM_UNSPECIFIED;
1513 }
1514 }
1515 #undef FUNC_NAME
1516
1517 #ifdef L_tmpnam
1518
1519 SCM_DEFINE (scm_tmpnam, "tmpnam", 0, 0, 0,
1520 (),
1521 "Return a name in the file system that does not match any\n"
1522 "existing file. However there is no guarantee that another\n"
1523 "process will not create the file after @code{tmpnam} is called.\n"
1524 "Care should be taken if opening the file, e.g., use the\n"
1525 "@code{O_EXCL} open flag or use @code{mkstemp!} instead.")
1526 #define FUNC_NAME s_scm_tmpnam
1527 {
1528 char name[L_tmpnam];
1529 char *rv;
1530
1531 SCM_SYSCALL (rv = tmpnam (name));
1532 if (rv == NULL)
1533 /* not SCM_SYSERROR since errno probably not set. */
1534 SCM_MISC_ERROR ("tmpnam failed", SCM_EOL);
1535 return scm_from_locale_string (name);
1536 }
1537 #undef FUNC_NAME
1538
1539 #endif
1540
1541 SCM_DEFINE (scm_tmpfile, "tmpfile", 0, 0, 0,
1542 (void),
1543 "Return an input/output port to a unique temporary file\n"
1544 "named using the path prefix @code{P_tmpdir} defined in\n"
1545 "@file{stdio.h}.\n"
1546 "The file is automatically deleted when the port is closed\n"
1547 "or the program terminates.")
1548 #define FUNC_NAME s_scm_tmpfile
1549 {
1550 FILE *rv;
1551 int fd;
1552
1553 if (! (rv = tmpfile ()))
1554 SCM_SYSERROR;
1555
1556 #ifndef __MINGW32__
1557 fd = dup (fileno (rv));
1558 fclose (rv);
1559 #else
1560 fd = fileno (rv);
1561 /* FIXME: leaking the file, it will never be closed! */
1562 #endif
1563
1564 return scm_fdes_to_port (fd, "w+", SCM_BOOL_F);
1565 }
1566 #undef FUNC_NAME
1567
1568 SCM_DEFINE (scm_utime, "utime", 1, 5, 0,
1569 (SCM pathname, SCM actime, SCM modtime, SCM actimens, SCM modtimens,
1570 SCM flags),
1571 "@code{utime} sets the access and modification times for the\n"
1572 "file named by @var{pathname}. If @var{actime} or @var{modtime} is\n"
1573 "not supplied, then the current time is used. @var{actime} and\n"
1574 "@var{modtime} must be integer time values as returned by the\n"
1575 "@code{current-time} procedure.\n\n"
1576 "The optional @var{actimens} and @var{modtimens} are nanoseconds\n"
1577 "to add @var{actime} and @var{modtime}. Nanosecond precision is\n"
1578 "only supported on some combinations of file systems and operating\n"
1579 "systems.\n"
1580 "@lisp\n"
1581 "(utime \"foo\" (- (current-time) 3600))\n"
1582 "@end lisp\n"
1583 "will set the access time to one hour in the past and the\n"
1584 "modification time to the current time.")
1585 #define FUNC_NAME s_scm_utime
1586 {
1587 int rv;
1588 time_t atim_sec, mtim_sec;
1589 long atim_nsec, mtim_nsec;
1590 int f;
1591
1592 if (SCM_UNBNDP (actime))
1593 {
1594 #ifdef HAVE_UTIMENSAT
1595 atim_sec = 0;
1596 atim_nsec = UTIME_NOW;
1597 #else
1598 SCM_SYSCALL (time (&atim_sec));
1599 atim_nsec = 0;
1600 #endif
1601 }
1602 else
1603 {
1604 atim_sec = SCM_NUM2ULONG (2, actime);
1605 if (SCM_UNBNDP (actimens))
1606 atim_nsec = 0;
1607 else
1608 atim_nsec = SCM_NUM2LONG (4, actimens);
1609 }
1610
1611 if (SCM_UNBNDP (modtime))
1612 {
1613 #ifdef HAVE_UTIMENSAT
1614 mtim_sec = 0;
1615 mtim_nsec = UTIME_NOW;
1616 #else
1617 SCM_SYSCALL (time (&mtim_sec));
1618 mtim_nsec = 0;
1619 #endif
1620 }
1621 else
1622 {
1623 mtim_sec = SCM_NUM2ULONG (3, modtime);
1624 if (SCM_UNBNDP (modtimens))
1625 mtim_nsec = 0;
1626 else
1627 mtim_nsec = SCM_NUM2LONG (5, modtimens);
1628 }
1629
1630 if (SCM_UNBNDP (flags))
1631 f = 0;
1632 else
1633 f = SCM_NUM2INT (6, flags);
1634
1635 #ifdef HAVE_UTIMENSAT
1636 {
1637 struct timespec times[2];
1638 times[0].tv_sec = atim_sec;
1639 times[0].tv_nsec = atim_nsec;
1640 times[1].tv_sec = mtim_sec;
1641 times[1].tv_nsec = mtim_nsec;
1642
1643 STRING_SYSCALL (pathname, c_pathname,
1644 rv = utimensat (AT_FDCWD, c_pathname, times, f));
1645 }
1646 #else
1647 {
1648 struct utimbuf utm;
1649 utm.actime = atim_sec;
1650 utm.modtime = mtim_sec;
1651
1652 STRING_SYSCALL (pathname, c_pathname,
1653 rv = utime (c_pathname, &utm));
1654 }
1655 #endif
1656
1657 if (rv != 0)
1658 SCM_SYSERROR;
1659 return SCM_UNSPECIFIED;
1660 }
1661 #undef FUNC_NAME
1662
1663 SCM_DEFINE (scm_getpid, "getpid", 0, 0, 0,
1664 (),
1665 "Return an integer representing the current process ID.")
1666 #define FUNC_NAME s_scm_getpid
1667 {
1668 return scm_from_ulong (getpid ());
1669 }
1670 #undef FUNC_NAME
1671
1672 SCM_DEFINE (scm_putenv, "putenv", 1, 0, 0,
1673 (SCM str),
1674 "Modifies the environment of the current process, which is also\n"
1675 "the default environment inherited by child processes. If\n"
1676 "@var{str} is of the form @code{NAME=VALUE} then it will be\n"
1677 "written directly into the environment, replacing any existing\n"
1678 "environment string with name matching @code{NAME}. If\n"
1679 "@var{str} does not contain an equal sign, then any existing\n"
1680 "string with name matching @var{str} will be removed.\n"
1681 "\n"
1682 "The return value is unspecified.")
1683 #define FUNC_NAME s_scm_putenv
1684 {
1685 int rv;
1686 char *c_str = scm_to_locale_string (str);
1687
1688 /* Leave C_STR in the environment. */
1689
1690 /* Gnulib's `putenv' module honors the semantics described above. */
1691 rv = putenv (c_str);
1692 if (rv < 0)
1693 SCM_SYSERROR;
1694
1695 return SCM_UNSPECIFIED;
1696 }
1697 #undef FUNC_NAME
1698
1699 /* This mutex is used to serialize invocations of `setlocale ()' on non-GNU
1700 systems (i.e., systems where a reentrant locale API is not available). It
1701 is also acquired before calls to `nl_langinfo ()'. See `i18n.c' for
1702 details. */
1703 scm_i_pthread_mutex_t scm_i_locale_mutex = SCM_I_PTHREAD_MUTEX_INITIALIZER;
1704
1705 #ifdef HAVE_SETLOCALE
1706
1707 SCM_DEFINE (scm_setlocale, "setlocale", 1, 1, 0,
1708 (SCM category, SCM locale),
1709 "If @var{locale} is omitted, return the current value of the\n"
1710 "specified locale category as a system-dependent string.\n"
1711 "@var{category} should be specified using the values\n"
1712 "@code{LC_COLLATE}, @code{LC_ALL} etc.\n"
1713 "\n"
1714 "Otherwise the specified locale category is set to the string\n"
1715 "@var{locale} and the new value is returned as a\n"
1716 "system-dependent string. If @var{locale} is an empty string,\n"
1717 "the locale will be set using environment variables.\n"
1718 "\n"
1719 "When the locale is changed, the character encoding of the new\n"
1720 "locale (UTF-8, ISO-8859-1, etc.) is used for the current\n"
1721 "input, output, and error ports\n")
1722 #define FUNC_NAME s_scm_setlocale
1723 {
1724 int c_category;
1725 char *clocale;
1726 char *rv;
1727 const char *enc;
1728
1729 scm_dynwind_begin (0);
1730
1731 if (SCM_UNBNDP (locale))
1732 {
1733 clocale = NULL;
1734 }
1735 else
1736 {
1737 clocale = scm_to_locale_string (locale);
1738 scm_dynwind_free (clocale);
1739 }
1740
1741 c_category = scm_i_to_lc_category (category, 1);
1742
1743 scm_i_pthread_mutex_lock (&scm_i_locale_mutex);
1744 rv = setlocale (c_category, clocale);
1745 scm_i_pthread_mutex_unlock (&scm_i_locale_mutex);
1746
1747 if (rv == NULL)
1748 {
1749 /* POSIX and C99 don't say anything about setlocale setting errno, so
1750 force a sensible value here. glibc leaves ENOENT, which would be
1751 fine, but it's not a documented feature. */
1752 errno = EINVAL;
1753 SCM_SYSERROR;
1754 }
1755
1756 enc = locale_charset ();
1757
1758 /* Set the default encoding for new ports. */
1759 scm_i_set_default_port_encoding (enc);
1760
1761 /* Set the encoding for the stdio ports. */
1762 scm_i_set_port_encoding_x (scm_current_input_port (), enc);
1763 scm_i_set_port_encoding_x (scm_current_output_port (), enc);
1764 scm_i_set_port_encoding_x (scm_current_error_port (), enc);
1765
1766 scm_dynwind_end ();
1767 return scm_from_locale_string (rv);
1768 }
1769 #undef FUNC_NAME
1770 #endif /* HAVE_SETLOCALE */
1771
1772 #ifdef HAVE_MKNOD
1773 SCM_DEFINE (scm_mknod, "mknod", 4, 0, 0,
1774 (SCM path, SCM type, SCM perms, SCM dev),
1775 "Creates a new special file, such as a file corresponding to a device.\n"
1776 "@var{path} specifies the name of the file. @var{type} should\n"
1777 "be one of the following symbols:\n"
1778 "regular, directory, symlink, block-special, char-special,\n"
1779 "fifo, or socket. @var{perms} (an integer) specifies the file permissions.\n"
1780 "@var{dev} (an integer) specifies which device the special file refers\n"
1781 "to. Its exact interpretation depends on the kind of special file\n"
1782 "being created.\n\n"
1783 "E.g.,\n"
1784 "@lisp\n"
1785 "(mknod \"/dev/fd0\" 'block-special #o660 (+ (* 2 256) 2))\n"
1786 "@end lisp\n\n"
1787 "The return value is unspecified.")
1788 #define FUNC_NAME s_scm_mknod
1789 {
1790 int val;
1791 const char *p;
1792 int ctype = 0;
1793
1794 SCM_VALIDATE_STRING (1, path);
1795 SCM_VALIDATE_SYMBOL (2, type);
1796
1797 p = scm_i_symbol_chars (type);
1798 if (strcmp (p, "regular") == 0)
1799 ctype = S_IFREG;
1800 else if (strcmp (p, "directory") == 0)
1801 ctype = S_IFDIR;
1802 #ifdef S_IFLNK
1803 /* systems without symlinks probably don't have S_IFLNK defined */
1804 else if (strcmp (p, "symlink") == 0)
1805 ctype = S_IFLNK;
1806 #endif
1807 else if (strcmp (p, "block-special") == 0)
1808 ctype = S_IFBLK;
1809 else if (strcmp (p, "char-special") == 0)
1810 ctype = S_IFCHR;
1811 else if (strcmp (p, "fifo") == 0)
1812 ctype = S_IFIFO;
1813 #ifdef S_IFSOCK
1814 else if (strcmp (p, "socket") == 0)
1815 ctype = S_IFSOCK;
1816 #endif
1817 else
1818 SCM_OUT_OF_RANGE (2, type);
1819
1820 STRING_SYSCALL (path, c_path,
1821 val = mknod (c_path,
1822 ctype | scm_to_int (perms),
1823 scm_to_int (dev)));
1824 if (val != 0)
1825 SCM_SYSERROR;
1826 return SCM_UNSPECIFIED;
1827 }
1828 #undef FUNC_NAME
1829 #endif /* HAVE_MKNOD */
1830
1831 #ifdef HAVE_NICE
1832 SCM_DEFINE (scm_nice, "nice", 1, 0, 0,
1833 (SCM incr),
1834 "Increment the priority of the current process by @var{incr}. A higher\n"
1835 "priority value means that the process runs less often.\n"
1836 "The return value is unspecified.")
1837 #define FUNC_NAME s_scm_nice
1838 {
1839 /* nice() returns "prio-NZERO" on success or -1 on error, but -1 can arise
1840 from "prio-NZERO", so an error must be detected from errno changed */
1841 errno = 0;
1842 nice (scm_to_int (incr));
1843 if (errno != 0)
1844 SCM_SYSERROR;
1845
1846 return SCM_UNSPECIFIED;
1847 }
1848 #undef FUNC_NAME
1849 #endif /* HAVE_NICE */
1850
1851 #ifdef HAVE_SYNC
1852 SCM_DEFINE (scm_sync, "sync", 0, 0, 0,
1853 (),
1854 "Flush the operating system disk buffers.\n"
1855 "The return value is unspecified.")
1856 #define FUNC_NAME s_scm_sync
1857 {
1858 sync();
1859 return SCM_UNSPECIFIED;
1860 }
1861 #undef FUNC_NAME
1862 #endif /* HAVE_SYNC */
1863
1864
1865 /* crypt() returns a pointer to a static buffer, so we use scm_i_misc_mutex
1866 to avoid another thread overwriting it. A test program running crypt
1867 continuously in two threads can be quickly seen tripping this problem.
1868 crypt() is pretty slow normally, so a mutex shouldn't add much overhead.
1869
1870 glibc has a thread-safe crypt_r, but (in version 2.3.2) it runs a lot
1871 slower (about 5x) than plain crypt if you pass an uninitialized data
1872 block each time. Presumably there's some one-time setups. The best way
1873 to use crypt_r for parallel execution in multiple threads would probably
1874 be to maintain a little pool of initialized crypt_data structures, take
1875 one and use it, then return it to the pool. That pool could be garbage
1876 collected so it didn't add permanently to memory use if only a few crypt
1877 calls are made. But we expect crypt will be used rarely, and even more
1878 rarely will there be any desire for lots of parallel execution on
1879 multiple cpus. So for now we don't bother with anything fancy, just
1880 ensure it works. */
1881
1882 #ifdef HAVE_CRYPT
1883 SCM_DEFINE (scm_crypt, "crypt", 2, 0, 0,
1884 (SCM key, SCM salt),
1885 "Encrypt @var{key} using @var{salt} as the salt value to the\n"
1886 "crypt(3) library call.")
1887 #define FUNC_NAME s_scm_crypt
1888 {
1889 SCM ret;
1890 char *c_key, *c_salt, *c_ret;
1891
1892 scm_dynwind_begin (0);
1893 scm_i_dynwind_pthread_mutex_lock (&scm_i_misc_mutex);
1894
1895 c_key = scm_to_locale_string (key);
1896 scm_dynwind_free (c_key);
1897 c_salt = scm_to_locale_string (salt);
1898 scm_dynwind_free (c_salt);
1899
1900 /* The Linux crypt(3) man page says crypt will return NULL and set errno
1901 on error. (Eg. ENOSYS if legal restrictions mean it cannot be
1902 implemented). */
1903 c_ret = crypt (c_key, c_salt);
1904 if (c_ret == NULL)
1905 SCM_SYSERROR;
1906
1907 ret = scm_from_locale_string (c_ret);
1908 scm_dynwind_end ();
1909 return ret;
1910 }
1911 #undef FUNC_NAME
1912 #endif /* HAVE_CRYPT */
1913
1914 #if HAVE_CHROOT
1915 SCM_DEFINE (scm_chroot, "chroot", 1, 0, 0,
1916 (SCM path),
1917 "Change the root directory to that specified in @var{path}.\n"
1918 "This directory will be used for path names beginning with\n"
1919 "@file{/}. The root directory is inherited by all children\n"
1920 "of the current process. Only the superuser may change the\n"
1921 "root directory.")
1922 #define FUNC_NAME s_scm_chroot
1923 {
1924 int rv;
1925
1926 WITH_STRING (path, c_path,
1927 rv = chroot (c_path));
1928 if (rv == -1)
1929 SCM_SYSERROR;
1930 return SCM_UNSPECIFIED;
1931 }
1932 #undef FUNC_NAME
1933 #endif /* HAVE_CHROOT */
1934
1935
1936 #ifdef __MINGW32__
1937 /* Wrapper function to supplying `getlogin()' under Windows. */
1938 static char * getlogin (void)
1939 {
1940 static char user[256];
1941 static unsigned long len = 256;
1942
1943 if (!GetUserName (user, &len))
1944 return NULL;
1945 return user;
1946 }
1947 #endif /* __MINGW32__ */
1948
1949
1950 #if defined (HAVE_GETLOGIN) || defined (__MINGW32__)
1951 SCM_DEFINE (scm_getlogin, "getlogin", 0, 0, 0,
1952 (void),
1953 "Return a string containing the name of the user logged in on\n"
1954 "the controlling terminal of the process, or @code{#f} if this\n"
1955 "information cannot be obtained.")
1956 #define FUNC_NAME s_scm_getlogin
1957 {
1958 char * p;
1959
1960 p = getlogin ();
1961 if (!p || !*p)
1962 return SCM_BOOL_F;
1963 return scm_from_locale_string (p);
1964 }
1965 #undef FUNC_NAME
1966 #endif /* HAVE_GETLOGIN */
1967
1968 #if HAVE_GETPRIORITY
1969 SCM_DEFINE (scm_getpriority, "getpriority", 2, 0, 0,
1970 (SCM which, SCM who),
1971 "Return the scheduling priority of the process, process group\n"
1972 "or user, as indicated by @var{which} and @var{who}. @var{which}\n"
1973 "is one of the variables @code{PRIO_PROCESS}, @code{PRIO_PGRP}\n"
1974 "or @code{PRIO_USER}, and @var{who} is interpreted relative to\n"
1975 "@var{which} (a process identifier for @code{PRIO_PROCESS},\n"
1976 "process group identifier for @code{PRIO_PGRP}, and a user\n"
1977 "identifier for @code{PRIO_USER}. A zero value of @var{who}\n"
1978 "denotes the current process, process group, or user. Return\n"
1979 "the highest priority (lowest numerical value) of any of the\n"
1980 "specified processes.")
1981 #define FUNC_NAME s_scm_getpriority
1982 {
1983 int cwhich, cwho, ret;
1984
1985 cwhich = scm_to_int (which);
1986 cwho = scm_to_int (who);
1987
1988 /* We have to clear errno and examine it later, because -1 is a
1989 legal return value for getpriority(). */
1990 errno = 0;
1991 ret = getpriority (cwhich, cwho);
1992 if (errno != 0)
1993 SCM_SYSERROR;
1994 return scm_from_int (ret);
1995 }
1996 #undef FUNC_NAME
1997 #endif /* HAVE_GETPRIORITY */
1998
1999 #if HAVE_SETPRIORITY
2000 SCM_DEFINE (scm_setpriority, "setpriority", 3, 0, 0,
2001 (SCM which, SCM who, SCM prio),
2002 "Set the scheduling priority of the process, process group\n"
2003 "or user, as indicated by @var{which} and @var{who}. @var{which}\n"
2004 "is one of the variables @code{PRIO_PROCESS}, @code{PRIO_PGRP}\n"
2005 "or @code{PRIO_USER}, and @var{who} is interpreted relative to\n"
2006 "@var{which} (a process identifier for @code{PRIO_PROCESS},\n"
2007 "process group identifier for @code{PRIO_PGRP}, and a user\n"
2008 "identifier for @code{PRIO_USER}. A zero value of @var{who}\n"
2009 "denotes the current process, process group, or user.\n"
2010 "@var{prio} is a value in the range -20 and 20, the default\n"
2011 "priority is 0; lower priorities cause more favorable\n"
2012 "scheduling. Sets the priority of all of the specified\n"
2013 "processes. Only the super-user may lower priorities.\n"
2014 "The return value is not specified.")
2015 #define FUNC_NAME s_scm_setpriority
2016 {
2017 int cwhich, cwho, cprio;
2018
2019 cwhich = scm_to_int (which);
2020 cwho = scm_to_int (who);
2021 cprio = scm_to_int (prio);
2022
2023 if (setpriority (cwhich, cwho, cprio) == -1)
2024 SCM_SYSERROR;
2025 return SCM_UNSPECIFIED;
2026 }
2027 #undef FUNC_NAME
2028 #endif /* HAVE_SETPRIORITY */
2029
2030 #ifdef HAVE_SCHED_GETAFFINITY
2031
2032 static SCM
2033 cpu_set_to_bitvector (const cpu_set_t *cs)
2034 {
2035 SCM bv;
2036 size_t cpu;
2037
2038 bv = scm_c_make_bitvector (sizeof (*cs), SCM_BOOL_F);
2039
2040 for (cpu = 0; cpu < sizeof (*cs); cpu++)
2041 {
2042 if (CPU_ISSET (cpu, cs))
2043 /* XXX: This is inefficient but avoids code duplication. */
2044 scm_c_bitvector_set_x (bv, cpu, SCM_BOOL_T);
2045 }
2046
2047 return bv;
2048 }
2049
2050 SCM_DEFINE (scm_getaffinity, "getaffinity", 1, 0, 0,
2051 (SCM pid),
2052 "Return a bitvector representing the CPU affinity mask for\n"
2053 "process @var{pid}. Each CPU the process has affinity with\n"
2054 "has its corresponding bit set in the returned bitvector.\n"
2055 "The number of bits set is a good estimate of how many CPUs\n"
2056 "Guile can use without stepping on other processes' toes.\n\n"
2057 "Currently this procedure is only defined on GNU variants\n"
2058 "(@pxref{CPU Affinity, @code{sched_getaffinity},, libc, The\n"
2059 "GNU C Library Reference Manual}).\n")
2060 #define FUNC_NAME s_scm_getaffinity
2061 {
2062 int err;
2063 cpu_set_t cs;
2064
2065 CPU_ZERO (&cs);
2066 err = sched_getaffinity (scm_to_int (pid), sizeof (cs), &cs);
2067 if (err)
2068 SCM_SYSERROR;
2069
2070 return cpu_set_to_bitvector (&cs);
2071 }
2072 #undef FUNC_NAME
2073
2074 #endif /* HAVE_SCHED_GETAFFINITY */
2075
2076 #ifdef HAVE_SCHED_SETAFFINITY
2077
2078 SCM_DEFINE (scm_setaffinity, "setaffinity", 2, 0, 0,
2079 (SCM pid, SCM mask),
2080 "Install the CPU affinity mask @var{mask}, a bitvector, for\n"
2081 "the process or thread with ID @var{pid}. The return value\n"
2082 "is unspecified.\n\n"
2083 "Currently this procedure is only defined on GNU variants\n"
2084 "(@pxref{CPU Affinity, @code{sched_setaffinity},, libc, The\n"
2085 "GNU C Library Reference Manual}).\n")
2086 #define FUNC_NAME s_scm_setaffinity
2087 {
2088 cpu_set_t cs;
2089 scm_t_array_handle handle;
2090 const scm_t_uint32 *c_mask;
2091 size_t len, off, cpu;
2092 ssize_t inc;
2093 int err;
2094
2095 c_mask = scm_bitvector_elements (mask, &handle, &off, &len, &inc);
2096
2097 CPU_ZERO (&cs);
2098 for (cpu = 0; cpu < len; cpu++)
2099 {
2100 size_t idx;
2101
2102 idx = cpu * inc + off;
2103 if (c_mask[idx / 32] & (1UL << (idx % 32)))
2104 CPU_SET (cpu, &cs);
2105 }
2106
2107 err = sched_setaffinity (scm_to_int (pid), sizeof (cs), &cs);
2108 if (err)
2109 SCM_SYSERROR;
2110
2111 return SCM_UNSPECIFIED;
2112 }
2113 #undef FUNC_NAME
2114
2115 #endif /* HAVE_SCHED_SETAFFINITY */
2116
2117 \f
2118 #if HAVE_GETPASS
2119 SCM_DEFINE (scm_getpass, "getpass", 1, 0, 0,
2120 (SCM prompt),
2121 "Display @var{prompt} to the standard error output and read\n"
2122 "a password from @file{/dev/tty}. If this file is not\n"
2123 "accessible, it reads from standard input. The password may be\n"
2124 "up to 127 characters in length. Additional characters and the\n"
2125 "terminating newline character are discarded. While reading\n"
2126 "the password, echoing and the generation of signals by special\n"
2127 "characters is disabled.")
2128 #define FUNC_NAME s_scm_getpass
2129 {
2130 char * p;
2131 SCM passwd;
2132
2133 SCM_VALIDATE_STRING (1, prompt);
2134
2135 WITH_STRING (prompt, c_prompt,
2136 p = getpass(c_prompt));
2137 passwd = scm_from_locale_string (p);
2138
2139 /* Clear out the password in the static buffer. */
2140 memset (p, 0, strlen (p));
2141
2142 return passwd;
2143 }
2144 #undef FUNC_NAME
2145 #endif /* HAVE_GETPASS */
2146
2147 SCM_DEFINE (scm_flock, "flock", 2, 0, 0,
2148 (SCM file, SCM operation),
2149 "Apply or remove an advisory lock on an open file.\n"
2150 "@var{operation} specifies the action to be done:\n"
2151 "\n"
2152 "@defvar LOCK_SH\n"
2153 "Shared lock. More than one process may hold a shared lock\n"
2154 "for a given file at a given time.\n"
2155 "@end defvar\n"
2156 "@defvar LOCK_EX\n"
2157 "Exclusive lock. Only one process may hold an exclusive lock\n"
2158 "for a given file at a given time.\n"
2159 "@end defvar\n"
2160 "@defvar LOCK_UN\n"
2161 "Unlock the file.\n"
2162 "@end defvar\n"
2163 "@defvar LOCK_NB\n"
2164 "Don't block when locking. This is combined with one of the\n"
2165 "other operations using @code{logior}. If @code{flock} would\n"
2166 "block an @code{EWOULDBLOCK} error is thrown.\n"
2167 "@end defvar\n"
2168 "\n"
2169 "The return value is not specified. @var{file} may be an open\n"
2170 "file descriptor or an open file descriptor port.\n"
2171 "\n"
2172 "Note that @code{flock} does not lock files across NFS.")
2173 #define FUNC_NAME s_scm_flock
2174 {
2175 int fdes;
2176
2177 if (scm_is_integer (file))
2178 fdes = scm_to_int (file);
2179 else
2180 {
2181 SCM_VALIDATE_OPFPORT (2, file);
2182
2183 fdes = SCM_FPORT_FDES (file);
2184 }
2185 if (flock (fdes, scm_to_int (operation)) == -1)
2186 SCM_SYSERROR;
2187 return SCM_UNSPECIFIED;
2188 }
2189 #undef FUNC_NAME
2190
2191 #if HAVE_SETHOSTNAME
2192 SCM_DEFINE (scm_sethostname, "sethostname", 1, 0, 0,
2193 (SCM name),
2194 "Set the host name of the current processor to @var{name}. May\n"
2195 "only be used by the superuser. The return value is not\n"
2196 "specified.")
2197 #define FUNC_NAME s_scm_sethostname
2198 {
2199 int rv;
2200
2201 WITH_STRING (name, c_name,
2202 rv = sethostname (c_name, strlen(c_name)));
2203 if (rv == -1)
2204 SCM_SYSERROR;
2205 return SCM_UNSPECIFIED;
2206 }
2207 #undef FUNC_NAME
2208 #endif /* HAVE_SETHOSTNAME */
2209
2210
2211 #if HAVE_GETHOSTNAME
2212 SCM_DEFINE (scm_gethostname, "gethostname", 0, 0, 0,
2213 (void),
2214 "Return the host name of the current processor.")
2215 #define FUNC_NAME s_scm_gethostname
2216 {
2217 #ifdef MAXHOSTNAMELEN
2218
2219 /* Various systems define MAXHOSTNAMELEN (including Solaris in fact).
2220 * On GNU/Linux this doesn't include the terminating '\0', hence "+ 1". */
2221 const int len = MAXHOSTNAMELEN + 1;
2222 char *const p = scm_malloc (len);
2223 const int res = gethostname (p, len);
2224
2225 scm_dynwind_begin (0);
2226 scm_dynwind_unwind_handler (free, p, 0);
2227
2228 #else
2229
2230 /* Default 256 is for Solaris, under Linux ENAMETOOLONG is returned if not
2231 * large enough. SUSv2 specifies 255 maximum too, apparently. */
2232 int len = 256;
2233 int res;
2234 char *p;
2235
2236 # if HAVE_SYSCONF && defined (_SC_HOST_NAME_MAX)
2237
2238 /* POSIX specifies the HOST_NAME_MAX system parameter for the max size,
2239 * which may reflect a particular kernel configuration.
2240 * Must watch out for this existing but giving -1, as happens for instance
2241 * in gnu/linux glibc 2.3.2. */
2242 {
2243 const long int n = sysconf (_SC_HOST_NAME_MAX);
2244 if (n != -1L)
2245 len = n;
2246 }
2247
2248 # endif
2249
2250 p = scm_malloc (len);
2251
2252 scm_dynwind_begin (0);
2253 scm_dynwind_unwind_handler (free, p, 0);
2254
2255 res = gethostname (p, len);
2256 while (res == -1 && errno == ENAMETOOLONG)
2257 {
2258 len *= 2;
2259
2260 /* scm_realloc may throw an exception. */
2261 p = scm_realloc (p, len);
2262 res = gethostname (p, len);
2263 }
2264
2265 #endif
2266
2267 if (res == -1)
2268 {
2269 const int save_errno = errno;
2270
2271 /* No guile exceptions can occur before we have freed p's memory. */
2272 scm_dynwind_end ();
2273 free (p);
2274
2275 errno = save_errno;
2276 SCM_SYSERROR;
2277 }
2278 else
2279 {
2280 /* scm_from_locale_string may throw an exception. */
2281 const SCM name = scm_from_locale_string (p);
2282
2283 /* No guile exceptions can occur before we have freed p's memory. */
2284 scm_dynwind_end ();
2285 free (p);
2286
2287 return name;
2288 }
2289 }
2290 #undef FUNC_NAME
2291 #endif /* HAVE_GETHOSTNAME */
2292
2293 \f
2294 #ifdef HAVE_FORK
2295 static void
2296 scm_init_popen (void)
2297 {
2298 scm_c_define_gsubr ("open-process", 2, 0, 1, scm_open_process);
2299 }
2300 #endif
2301
2302 void
2303 scm_init_posix ()
2304 {
2305 scm_add_feature ("posix");
2306 #ifdef HAVE_GETEUID
2307 scm_add_feature ("EIDs");
2308 #endif
2309 #ifdef WAIT_ANY
2310 scm_c_define ("WAIT_ANY", scm_from_int (WAIT_ANY));
2311 #endif
2312 #ifdef WAIT_MYPGRP
2313 scm_c_define ("WAIT_MYPGRP", scm_from_int (WAIT_MYPGRP));
2314 #endif
2315 #ifdef WNOHANG
2316 scm_c_define ("WNOHANG", scm_from_int (WNOHANG));
2317 #endif
2318 #ifdef WUNTRACED
2319 scm_c_define ("WUNTRACED", scm_from_int (WUNTRACED));
2320 #endif
2321
2322 #ifdef LC_COLLATE
2323 scm_c_define ("LC_COLLATE", scm_from_int (LC_COLLATE));
2324 #endif
2325 #ifdef LC_CTYPE
2326 scm_c_define ("LC_CTYPE", scm_from_int (LC_CTYPE));
2327 #endif
2328 #ifdef LC_MONETARY
2329 scm_c_define ("LC_MONETARY", scm_from_int (LC_MONETARY));
2330 #endif
2331 #ifdef LC_NUMERIC
2332 scm_c_define ("LC_NUMERIC", scm_from_int (LC_NUMERIC));
2333 #endif
2334 #ifdef LC_TIME
2335 scm_c_define ("LC_TIME", scm_from_int (LC_TIME));
2336 #endif
2337 #ifdef LC_MESSAGES
2338 scm_c_define ("LC_MESSAGES", scm_from_int (LC_MESSAGES));
2339 #endif
2340 #ifdef LC_ALL
2341 scm_c_define ("LC_ALL", scm_from_int (LC_ALL));
2342 #endif
2343 #ifdef LC_PAPER
2344 scm_c_define ("LC_PAPER", scm_from_int (LC_PAPER));
2345 #endif
2346 #ifdef LC_NAME
2347 scm_c_define ("LC_NAME", scm_from_int (LC_NAME));
2348 #endif
2349 #ifdef LC_ADDRESS
2350 scm_c_define ("LC_ADDRESS", scm_from_int (LC_ADDRESS));
2351 #endif
2352 #ifdef LC_TELEPHONE
2353 scm_c_define ("LC_TELEPHONE", scm_from_int (LC_TELEPHONE));
2354 #endif
2355 #ifdef LC_MEASUREMENT
2356 scm_c_define ("LC_MEASUREMENT", scm_from_int (LC_MEASUREMENT));
2357 #endif
2358 #ifdef LC_IDENTIFICATION
2359 scm_c_define ("LC_IDENTIFICATION", scm_from_int (LC_IDENTIFICATION));
2360 #endif
2361 #ifdef PIPE_BUF
2362 scm_c_define ("PIPE_BUF", scm_from_long (PIPE_BUF));
2363 #endif
2364
2365 #ifdef PRIO_PROCESS
2366 scm_c_define ("PRIO_PROCESS", scm_from_int (PRIO_PROCESS));
2367 #endif
2368 #ifdef PRIO_PGRP
2369 scm_c_define ("PRIO_PGRP", scm_from_int (PRIO_PGRP));
2370 #endif
2371 #ifdef PRIO_USER
2372 scm_c_define ("PRIO_USER", scm_from_int (PRIO_USER));
2373 #endif
2374
2375 #ifdef LOCK_SH
2376 scm_c_define ("LOCK_SH", scm_from_int (LOCK_SH));
2377 #endif
2378 #ifdef LOCK_EX
2379 scm_c_define ("LOCK_EX", scm_from_int (LOCK_EX));
2380 #endif
2381 #ifdef LOCK_UN
2382 scm_c_define ("LOCK_UN", scm_from_int (LOCK_UN));
2383 #endif
2384 #ifdef LOCK_NB
2385 scm_c_define ("LOCK_NB", scm_from_int (LOCK_NB));
2386 #endif
2387
2388 #include "libguile/cpp-SIG.c"
2389 #include "libguile/posix.x"
2390
2391 scm_c_register_extension ("libguile-" SCM_EFFECTIVE_VERSION,
2392 "scm_init_popen",
2393 (scm_t_extension_init_func) scm_init_popen,
2394 NULL);
2395 }
2396
2397 /*
2398 Local Variables:
2399 c-file-style: "gnu"
2400 End:
2401 */