libguile/posix.c

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