libguile/posix.c

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