(scm_dirname, scm_basename): Added docstrings.
[bpt/guile.git] / libguile / filesys.c
CommitLineData
bd9e24b3 1/* Copyright (C) 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
0f2d19dd
JB
2 *
3 * This program is free software; you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License as published by
5 * the Free Software Foundation; either version 2, or (at your option)
6 * any later version.
7 *
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
12 *
13 * You should have received a copy of the GNU General Public License
14 * along with this software; see the file COPYING. If not, write to
82892bed
JB
15 * the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
16 * Boston, MA 02111-1307 USA
0f2d19dd
JB
17 *
18 * As a special exception, the Free Software Foundation gives permission
19 * for additional uses of the text contained in its release of GUILE.
20 *
21 * The exception is that, if you link the GUILE library with other files
22 * to produce an executable, this does not by itself cause the
23 * resulting executable to be covered by the GNU General Public License.
24 * Your use of that executable is in no way restricted on account of
25 * linking the GUILE library code into it.
26 *
27 * This exception does not however invalidate any other reasons why
28 * the executable file might be covered by the GNU General Public License.
29 *
30 * This exception applies only to the code released by the
31 * Free Software Foundation under the name GUILE. If you copy
32 * code from other Free Software Foundation releases into a copy of
33 * GUILE, as the General Public License permits, the exception does
34 * not apply to the code that you add in this way. To avoid misleading
35 * anyone as to the status of such modified files, you must delete
36 * this exception notice from them.
37 *
38 * If you write modifications of your own for GUILE, it is your choice
39 * whether to permit this exception to apply to your modifications.
82892bed 40 * If you do not wish that, delete this exception notice. */
1bbd0b84
GB
41
42/* Software engineering face-lift by Greg J. Badros, 11-Dec-1999,
43 gjb@cs.washington.edu, http://www.cs.washington.edu/homes/gjb */
44
0f2d19dd 45\f
3d8d56df 46#include <stdio.h>
a0599745
MD
47#include "libguile/_scm.h"
48#include "libguile/smob.h"
49#include "libguile/feature.h"
50#include "libguile/fports.h"
51#include "libguile/iselect.h"
52#include "libguile/strings.h"
53#include "libguile/vectors.h"
0f2d19dd 54
a0599745
MD
55#include "libguile/validate.h"
56#include "libguile/filesys.h"
def804a3 57
0f2d19dd 58\f
def804a3
JB
59#ifdef HAVE_IO_H
60#include <io.h>
61#endif
62
0f2d19dd
JB
63#ifdef TIME_WITH_SYS_TIME
64# include <sys/time.h>
65# include <time.h>
66#else
67# if HAVE_SYS_TIME_H
68# include <sys/time.h>
69# else
70# include <time.h>
71# endif
72#endif
73
74#ifdef HAVE_UNISTD_H
75#include <unistd.h>
76#endif
77
3594582b 78#ifdef LIBC_H_WITH_UNISTD_H
1f9e2226
JB
79#include <libc.h>
80#endif
81
0f2d19dd
JB
82#ifdef HAVE_SYS_SELECT_H
83#include <sys/select.h>
84#endif
85
1f9e2226
JB
86#ifdef HAVE_STRING_H
87#include <string.h>
88#endif
89
8cc71382 90#include <sys/types.h>
0f2d19dd
JB
91#include <sys/stat.h>
92#include <fcntl.h>
93
94#include <pwd.h>
95
96
0f2d19dd
JB
97#if HAVE_DIRENT_H
98# include <dirent.h>
99# define NAMLEN(dirent) strlen((dirent)->d_name)
100#else
101# define dirent direct
102# define NAMLEN(dirent) (dirent)->d_namlen
103# if HAVE_SYS_NDIR_H
104# include <sys/ndir.h>
105# endif
106# if HAVE_SYS_DIR_H
107# include <sys/dir.h>
108# endif
109# if HAVE_NDIR_H
110# include <ndir.h>
111# endif
112#endif
113
d7b8a21a
JB
114/* Ultrix has S_IFSOCK, but no S_ISSOCK. Ipe! */
115#if defined (S_IFSOCK) && ! defined (S_ISSOCK)
116#define S_ISSOCK(mode) (((mode) & S_IFMT) == S_IFSOCK)
117#endif
0f2d19dd
JB
118\f
119
0f2d19dd
JB
120
121\f
122
123/* {Permissions}
124 */
125
a1ec6916 126SCM_DEFINE (scm_chown, "chown", 3, 0, 0,
1bbd0b84 127 (SCM object, SCM owner, SCM group),
d831b039
GH
128 "Change the ownership and group of the file referred to by @var{object} to\n"
129 "the integer values @var{owner} and @var{group}. @var{object} can be\n"
130 "a string containing a file name or, if the platform\n"
131 "supports fchown, a port or integer file descriptor\n"
132 "which is open on the file. The return value\n"
d3818c29 133 "is unspecified.\n\n"
d831b039 134 "If @var{object} is a symbolic link, either the\n"
d3818c29
MD
135 "ownership of the link or the ownership of the referenced file will be\n"
136 "changed depending on the operating system (lchown is\n"
137 "unsupported at present). If @var{owner} or @var{group} is specified\n"
138 "as @code{-1}, then that ID is not changed.")
1bbd0b84 139#define FUNC_NAME s_scm_chown
0f2d19dd 140{
6afcd3b2 141 int rv;
02b754d3 142
78446828
MV
143 object = SCM_COERCE_OUTPORT (object);
144
3b3b36dd
GB
145 SCM_VALIDATE_INUM (2,owner);
146 SCM_VALIDATE_INUM (3,group);
d831b039 147#ifdef HAVE_FCHOWN
0c95b57d 148 if (SCM_INUMP (object) || (SCM_OPFPORTP (object)))
6afcd3b2 149 {
d831b039
GH
150 int fdes = SCM_INUMP (object) ? SCM_INUM (object)
151 : SCM_FPORT_FDES (object);
152
6afcd3b2
GH
153 SCM_SYSCALL (rv = fchown (fdes, SCM_INUM (owner), SCM_INUM (group)));
154 }
155 else
d831b039 156#endif
6afcd3b2 157 {
a6d9e5ab
DH
158 SCM_VALIDATE_STRING (1, object);
159 SCM_STRING_COERCE_0TERMINATION_X (object);
160 SCM_SYSCALL (rv = chown (SCM_STRING_CHARS (object),
6afcd3b2
GH
161 SCM_INUM (owner), SCM_INUM (group)));
162 }
163 if (rv == -1)
1bbd0b84 164 SCM_SYSERROR;
02b754d3 165 return SCM_UNSPECIFIED;
0f2d19dd 166}
1bbd0b84 167#undef FUNC_NAME
0f2d19dd
JB
168
169
a1ec6916 170SCM_DEFINE (scm_chmod, "chmod", 2, 0, 0,
1bbd0b84 171 (SCM object, SCM mode),
d3818c29
MD
172 "Changes the permissions of the file referred to by @var{obj}.\n"
173 "@var{obj} can be a string containing a file name or a port or integer file\n"
174 "descriptor which is open on a file (in which case @code{fchmod} is used\n"
175 "as the underlying system call).\n"
176 "@var{mode} specifies\n"
177 "the new permissions as a decimal number, e.g., @code{(chmod \"foo\" #o755)}.\n"
178 "The return value is unspecified.")
1bbd0b84 179#define FUNC_NAME s_scm_chmod
0f2d19dd
JB
180{
181 int rv;
6afcd3b2
GH
182 int fdes;
183
78446828
MV
184 object = SCM_COERCE_OUTPORT (object);
185
3b3b36dd 186 SCM_VALIDATE_INUM (2,mode);
0c95b57d 187 if (SCM_INUMP (object) || SCM_OPFPORTP (object))
89958ad0 188 {
6afcd3b2
GH
189 if (SCM_INUMP (object))
190 fdes = SCM_INUM (object);
191 else
77a76b64 192 fdes = SCM_FPORT_FDES (object);
6afcd3b2 193 SCM_SYSCALL (rv = fchmod (fdes, SCM_INUM (mode)));
89958ad0 194 }
0f2d19dd
JB
195 else
196 {
a6d9e5ab
DH
197 SCM_VALIDATE_STRING (1, object);
198 SCM_STRING_COERCE_0TERMINATION_X (object);
199 SCM_SYSCALL (rv = chmod (SCM_STRING_CHARS (object), SCM_INUM (mode)));
0f2d19dd 200 }
6afcd3b2 201 if (rv == -1)
1bbd0b84 202 SCM_SYSERROR;
02b754d3 203 return SCM_UNSPECIFIED;
0f2d19dd 204}
1bbd0b84 205#undef FUNC_NAME
0f2d19dd 206
a1ec6916 207SCM_DEFINE (scm_umask, "umask", 0, 1, 0,
1bbd0b84 208 (SCM mode),
d3818c29
MD
209 "If @var{mode} is omitted, retuns a decimal number representing the current\n"
210 "file creation mask. Otherwise the file creation mask is set to\n"
211 "@var{mode} and the previous value is returned.\n\n"
212 "E.g., @code{(umask #o022)} sets the mask to octal 22, decimal 18.")
1bbd0b84 213#define FUNC_NAME s_scm_umask
0f2d19dd
JB
214{
215 mode_t mask;
216 if (SCM_UNBNDP (mode))
217 {
218 mask = umask (0);
219 umask (mask);
220 }
221 else
222 {
3b3b36dd 223 SCM_VALIDATE_INUM (1,mode);
0f2d19dd
JB
224 mask = umask (SCM_INUM (mode));
225 }
226 return SCM_MAKINUM (mask);
227}
1bbd0b84 228#undef FUNC_NAME
0f2d19dd
JB
229
230\f
0f2d19dd 231
a1ec6916 232SCM_DEFINE (scm_open_fdes, "open-fdes", 2, 1, 0,
1bbd0b84 233 (SCM path, SCM flags, SCM mode),
d3818c29
MD
234 "Similar to @code{open} but returns a file descriptor instead of a\n"
235 "port.")
1bbd0b84 236#define FUNC_NAME s_scm_open_fdes
0f2d19dd
JB
237{
238 int fd;
3d8d56df 239 int iflags;
6afcd3b2 240 int imode;
0f2d19dd 241
a6d9e5ab
DH
242 SCM_VALIDATE_STRING (1, path);
243 SCM_STRING_COERCE_0TERMINATION_X (path);
c1bfcf60
GB
244 iflags = SCM_NUM2LONG(2,flags);
245 imode = SCM_NUM2LONG_DEF(3,mode,0666);
a6d9e5ab 246 SCM_SYSCALL (fd = open (SCM_STRING_CHARS (path), iflags, imode));
3d8d56df 247 if (fd == -1)
1bbd0b84 248 SCM_SYSERROR;
6afcd3b2
GH
249 return SCM_MAKINUM (fd);
250}
1bbd0b84 251#undef FUNC_NAME
6afcd3b2 252
a1ec6916 253SCM_DEFINE (scm_open, "open", 2, 1, 0,
1bbd0b84 254 (SCM path, SCM flags, SCM mode),
d3818c29
MD
255 "Open the file named by @var{path} for reading and/or writing.\n"
256 "@var{flags} is an integer specifying how the file should be opened.\n"
257 "@var{mode} is an integer specifying the permission bits of the file, if\n"
258 "it needs to be created, before the umask is applied. The default is 666\n"
259 "(Unix itself has no default).\n\n"
260 "@var{flags} can be constructed by combining variables using @code{logior}.\n"
261 "Basic flags are:\n\n"
262 "@defvar O_RDONLY\n"
263 "Open the file read-only.\n"
264 "@end defvar\n"
265 "@defvar O_WRONLY\n"
266 "Open the file write-only. \n"
267 "@end defvar\n"
268 "@defvar O_RDWR\n"
269 "Open the file read/write.\n"
270 "@end defvar\n"
271 "@defvar O_APPEND\n"
272 "Append to the file instead of truncating.\n"
273 "@end defvar\n"
274 "@defvar O_CREAT\n"
275 "Create the file if it does not already exist.\n"
276 "@end defvar\n\n"
277 "See the Unix documentation of the @code{open} system call\n"
278 "for additional flags.")
1bbd0b84 279#define FUNC_NAME s_scm_open
6afcd3b2
GH
280{
281 SCM newpt;
282 char *port_mode;
283 int fd;
6afcd3b2
GH
284 int iflags;
285
286 fd = SCM_INUM (scm_open_fdes (path, flags, mode));
c1bfcf60 287 iflags = SCM_NUM2LONG (2,flags);
3d8d56df 288 if (iflags & O_RDWR)
77a76b64
JB
289 {
290 if (iflags & O_APPEND)
291 port_mode = "a+";
292 else if (iflags & O_CREAT)
293 port_mode = "w+";
294 else
295 port_mode = "r+";
296 }
3d8d56df 297 else {
77a76b64
JB
298 if (iflags & O_APPEND)
299 port_mode = "a";
300 else if (iflags & O_WRONLY)
3d8d56df
GH
301 port_mode = "w";
302 else
303 port_mode = "r";
304 }
77a76b64 305 newpt = scm_fdes_to_port (fd, port_mode, path);
3d8d56df 306 return newpt;
0f2d19dd 307}
1bbd0b84 308#undef FUNC_NAME
0f2d19dd 309
a1ec6916 310SCM_DEFINE (scm_close, "close", 1, 0, 0,
1bbd0b84 311 (SCM fd_or_port),
d3818c29
MD
312 "Similar to close-port (@pxref{Generic Port Operations, close-port}),\n"
313 "but also works on file descriptors. A side\n"
314 "effect of closing a file descriptor is that any ports using that file\n"
315 "descriptor are moved to a different file descriptor and have\n"
316 "their revealed counts set to zero.")
1bbd0b84 317#define FUNC_NAME s_scm_close
eadd48de
GH
318{
319 int rv;
320 int fd;
321
78446828
MV
322 fd_or_port = SCM_COERCE_OUTPORT (fd_or_port);
323
0c95b57d 324 if (SCM_PORTP (fd_or_port))
eadd48de 325 return scm_close_port (fd_or_port);
3b3b36dd 326 SCM_VALIDATE_INUM (1,fd_or_port);
eadd48de 327 fd = SCM_INUM (fd_or_port);
eadd48de 328 scm_evict_ports (fd); /* see scsh manual. */
a9488d12 329 SCM_SYSCALL (rv = close (fd));
eadd48de
GH
330 /* following scsh, closing an already closed file descriptor is
331 not an error. */
332 if (rv < 0 && errno != EBADF)
1bbd0b84
GB
333 SCM_SYSERROR;
334 return SCM_NEGATE_BOOL(rv < 0);
eadd48de 335}
1bbd0b84 336#undef FUNC_NAME
eadd48de 337
c2ca4493
GH
338SCM_DEFINE (scm_close_fdes, "close-fdes", 1, 0, 0,
339 (SCM fd),
340 "A simple wrapper for the @code{close} system call.\n"
341 "Close file descriptor @var{fd}, which must be an integer.\n"
342 "Unlike close (@pxref{Ports and File Descriptors, close}),\n"
343 "the file descriptor will be closed even if a port is using it.\n"
344 "The return value is unspecified.")
345#define FUNC_NAME s_scm_close_fdes
346{
347 int c_fd;
348 int rv;
349
350 SCM_VALIDATE_INUM_COPY (1, fd, c_fd);
351 SCM_SYSCALL (rv = close (c_fd));
352 if (rv < 0)
353 SCM_SYSERROR;
354 return SCM_UNSPECIFIED;
355}
356#undef FUNC_NAME
357
0f2d19dd
JB
358\f
359/* {Files}
360 */
1cc91f1b 361
ae5253c5
GH
362SCM_SYMBOL (scm_sym_regular, "regular");
363SCM_SYMBOL (scm_sym_directory, "directory");
f326ecf3 364#ifdef HAVE_S_ISLNK
ae5253c5 365SCM_SYMBOL (scm_sym_symlink, "symlink");
f326ecf3 366#endif
ae5253c5
GH
367SCM_SYMBOL (scm_sym_block_special, "block-special");
368SCM_SYMBOL (scm_sym_char_special, "char-special");
369SCM_SYMBOL (scm_sym_fifo, "fifo");
370SCM_SYMBOL (scm_sym_sock, "socket");
371SCM_SYMBOL (scm_sym_unknown, "unknown");
372
0f2d19dd 373static SCM
1bbd0b84 374scm_stat2scm (struct stat *stat_temp)
0f2d19dd 375{
00ffa0e7 376 SCM ans = scm_c_make_vector (15, SCM_UNSPECIFIED);
0f2d19dd 377 SCM *ve = SCM_VELTS (ans);
ae5253c5 378
0f2d19dd
JB
379 ve[0] = scm_ulong2num ((unsigned long) stat_temp->st_dev);
380 ve[1] = scm_ulong2num ((unsigned long) stat_temp->st_ino);
381 ve[2] = scm_ulong2num ((unsigned long) stat_temp->st_mode);
382 ve[3] = scm_ulong2num ((unsigned long) stat_temp->st_nlink);
383 ve[4] = scm_ulong2num ((unsigned long) stat_temp->st_uid);
384 ve[5] = scm_ulong2num ((unsigned long) stat_temp->st_gid);
385#ifdef HAVE_ST_RDEV
386 ve[6] = scm_ulong2num ((unsigned long) stat_temp->st_rdev);
387#else
388 ve[6] = SCM_BOOL_F;
389#endif
390 ve[7] = scm_ulong2num ((unsigned long) stat_temp->st_size);
391 ve[8] = scm_ulong2num ((unsigned long) stat_temp->st_atime);
392 ve[9] = scm_ulong2num ((unsigned long) stat_temp->st_mtime);
393 ve[10] = scm_ulong2num ((unsigned long) stat_temp->st_ctime);
394#ifdef HAVE_ST_BLKSIZE
395 ve[11] = scm_ulong2num ((unsigned long) stat_temp->st_blksize);
396#else
397 ve[11] = scm_ulong2num (4096L);
398#endif
399#ifdef HAVE_ST_BLOCKS
400 ve[12] = scm_ulong2num ((unsigned long) stat_temp->st_blocks);
401#else
402 ve[12] = SCM_BOOL_F;
403#endif
ae5253c5
GH
404 {
405 int mode = stat_temp->st_mode;
406
407 if (S_ISREG (mode))
408 ve[13] = scm_sym_regular;
409 else if (S_ISDIR (mode))
410 ve[13] = scm_sym_directory;
f326ecf3 411#ifdef HAVE_S_ISLNK
ae5253c5
GH
412 else if (S_ISLNK (mode))
413 ve[13] = scm_sym_symlink;
f326ecf3 414#endif
ae5253c5
GH
415 else if (S_ISBLK (mode))
416 ve[13] = scm_sym_block_special;
417 else if (S_ISCHR (mode))
418 ve[13] = scm_sym_char_special;
419 else if (S_ISFIFO (mode))
420 ve[13] = scm_sym_fifo;
e655d034 421#ifdef S_ISSOCK
ae5253c5
GH
422 else if (S_ISSOCK (mode))
423 ve[13] = scm_sym_sock;
e655d034 424#endif
ae5253c5
GH
425 else
426 ve[13] = scm_sym_unknown;
427
428 ve[14] = SCM_MAKINUM ((~S_IFMT) & mode);
429
430 /* the layout of the bits in ve[14] is intended to be portable.
431 If there are systems that don't follow the usual convention,
432 the following could be used:
433
434 tmp = 0;
435 if (S_ISUID & mode) tmp += 1;
436 tmp <<= 1;
437 if (S_IRGRP & mode) tmp += 1;
438 tmp <<= 1;
439 if (S_ISVTX & mode) tmp += 1;
440 tmp <<= 1;
441 if (S_IRUSR & mode) tmp += 1;
442 tmp <<= 1;
443 if (S_IWUSR & mode) tmp += 1;
444 tmp <<= 1;
445 if (S_IXUSR & mode) tmp += 1;
446 tmp <<= 1;
447 if (S_IWGRP & mode) tmp += 1;
448 tmp <<= 1;
449 if (S_IXGRP & mode) tmp += 1;
450 tmp <<= 1;
451 if (S_IROTH & mode) tmp += 1;
452 tmp <<= 1;
453 if (S_IWOTH & mode) tmp += 1;
454 tmp <<= 1;
455 if (S_IXOTH & mode) tmp += 1;
456
457 ve[14] = SCM_MAKINUM (tmp);
458
459 */
460 }
0f2d19dd
JB
461
462 return ans;
463}
464
a1ec6916 465SCM_DEFINE (scm_stat, "stat", 1, 0, 0,
1bbd0b84 466 (SCM object),
d3818c29
MD
467 "Returns an object containing various information\n"
468 "about the file determined by @var{obj}.\n"
469 "@var{obj} can be a string containing a file name or a port or integer file\n"
470 "descriptor which is open on a file (in which case @code{fstat} is used\n"
471 "as the underlying system call).\n\n"
472 "The object returned by @code{stat} can be passed as a single parameter\n"
473 "to the following procedures, all of which return integers:\n\n"
474 "@table @code\n"
475 "@item stat:dev\n"
476 "The device containing the file.\n"
477 "@item stat:ino\n"
478 "The file serial number, which distinguishes this file from all other\n"
479 "files on the same device.\n"
480 "@item stat:mode\n"
481 "The mode of the file. This includes file type information\n"
482 "and the file permission bits. See @code{stat:type} and @code{stat:perms}\n"
483 "below.\n"
484 "@item stat:nlink\n"
485 "The number of hard links to the file.\n"
486 "@item stat:uid\n"
487 "The user ID of the file's owner.\n"
488 "@item stat:gid\n"
489 "The group ID of the file.\n"
490 "@item stat:rdev\n"
491 "Device ID; this entry is defined only for character or block\n"
492 "special files.\n"
493 "@item stat:size\n"
494 "The size of a regular file in bytes.\n"
495 "@item stat:atime\n"
496 "The last access time for the file.\n"
497 "@item stat:mtime\n"
498 "The last modification time for the file.\n"
499 "@item stat:ctime\n"
500 "The last modification time for the attributes of the file.\n"
501 "@item stat:blksize\n"
502 "The optimal block size for reading or writing the file, in bytes.\n"
503 "@item stat:blocks\n"
504 "The amount of disk space that the file occupies measured in units of\n"
505 "512 byte blocks.\n"
506 "@end table\n\n"
507 "In addition, the following procedures return the information\n"
508 "from stat:mode in a more convenient form:\n\n"
509 "@table @code\n"
510 "@item stat:type\n"
511 "A symbol representing the type of file. Possible values are\n"
512 "regular, directory, symlink, block-special, char-special,\n"
513 "fifo, socket and unknown\n"
514 "@item stat:perms\n"
515 "An integer representing the access permission bits.\n"
516 "@end table")
1bbd0b84 517#define FUNC_NAME s_scm_stat
0f2d19dd 518{
6afcd3b2
GH
519 int rv;
520 int fdes;
0f2d19dd
JB
521 struct stat stat_temp;
522
1ea47048
MD
523 if (SCM_INUMP (object))
524 SCM_SYSCALL (rv = fstat (SCM_INUM (object), &stat_temp));
525 else
0f2d19dd 526 {
6b5a304f 527 SCM_VALIDATE_NIM (1,object);
a6d9e5ab 528 if (SCM_STRINGP (object))
1ea47048 529 {
a6d9e5ab
DH
530 SCM_STRING_COERCE_0TERMINATION_X (object);
531 SCM_SYSCALL (rv = stat (SCM_STRING_CHARS (object), &stat_temp));
1ea47048 532 }
c0ebd8c5 533 else
0f2d19dd 534 {
1ea47048 535 object = SCM_COERCE_OUTPORT (object);
c1bfcf60 536 SCM_VALIDATE_OPFPORT(1,object);
77a76b64 537 fdes = SCM_FPORT_FDES (object);
1ea47048 538 SCM_SYSCALL (rv = fstat (fdes, &stat_temp));
0f2d19dd 539 }
6afcd3b2
GH
540 }
541 if (rv == -1)
3d8d56df
GH
542 {
543 int en = errno;
544
5d2d2ffc 545 SCM_SYSERROR_MSG ("~A: ~S",
3d8d56df 546 scm_listify (scm_makfrom0str (strerror (errno)),
6afcd3b2 547 object,
5d2d2ffc 548 SCM_UNDEFINED), en);
3d8d56df 549 }
02b754d3 550 return scm_stat2scm (&stat_temp);
0f2d19dd 551}
1bbd0b84 552#undef FUNC_NAME
0f2d19dd 553
0f2d19dd
JB
554\f
555/* {Modifying Directories}
556 */
557
a1ec6916 558SCM_DEFINE (scm_link, "link", 2, 0, 0,
1bbd0b84 559 (SCM oldpath, SCM newpath),
6d36532c
GH
560 "Creates a new name @var{newpath} in the file system for the\n"
561 "file named by @var{oldpath}. If @var{oldpath} is a symbolic\n"
562 "link, the link may or may not be followed depending on the\n"
563 "system.")
1bbd0b84 564#define FUNC_NAME s_scm_link
0f2d19dd
JB
565{
566 int val;
02b754d3 567
a6d9e5ab
DH
568 SCM_VALIDATE_STRING (1, oldpath);
569 SCM_STRING_COERCE_0TERMINATION_X (oldpath);
570 SCM_VALIDATE_STRING (2, newpath);
571 SCM_STRING_COERCE_0TERMINATION_X (newpath);
6d36532c
GH
572 SCM_SYSCALL (val = link (SCM_STRING_CHARS (oldpath),
573 SCM_STRING_CHARS (newpath)));
02b754d3 574 if (val != 0)
1bbd0b84 575 SCM_SYSERROR;
02b754d3 576 return SCM_UNSPECIFIED;
0f2d19dd 577}
1bbd0b84 578#undef FUNC_NAME
0f2d19dd
JB
579
580
581
a1ec6916 582SCM_DEFINE (scm_rename, "rename-file", 2, 0, 0,
1bbd0b84 583 (SCM oldname, SCM newname),
6d36532c 584 "Renames the file specified by @var{oldname} to @var{newname}.\n"
d3818c29 585 "The return value is unspecified.")
1bbd0b84 586#define FUNC_NAME s_scm_rename
0f2d19dd
JB
587{
588 int rv;
a6d9e5ab
DH
589 SCM_VALIDATE_STRING (1, oldname);
590 SCM_VALIDATE_STRING (2, newname);
591 SCM_STRING_COERCE_0TERMINATION_X (oldname);
592 SCM_STRING_COERCE_0TERMINATION_X (newname);
0f2d19dd 593#ifdef HAVE_RENAME
a6d9e5ab 594 SCM_SYSCALL (rv = rename (SCM_STRING_CHARS (oldname), SCM_STRING_CHARS (newname)));
0f2d19dd 595#else
a6d9e5ab 596 SCM_SYSCALL (rv = link (SCM_STRING_CHARS (oldname), SCM_STRING_CHARS (newname)));
02b754d3 597 if (rv == 0)
0f2d19dd 598 {
a6d9e5ab 599 SCM_SYSCALL (rv = unlink (SCM_STRING_CHARS (oldname)));;
02b754d3 600 if (rv != 0)
0f2d19dd 601 /* unlink failed. remove new name */
a6d9e5ab 602 SCM_SYSCALL (unlink (SCM_STRING_CHARS (newname)));
0f2d19dd 603 }
6afcd3b2 604#endif
02b754d3 605 if (rv != 0)
1bbd0b84 606 SCM_SYSERROR;
02b754d3 607 return SCM_UNSPECIFIED;
0f2d19dd 608}
1bbd0b84 609#undef FUNC_NAME
0f2d19dd
JB
610
611
3b3b36dd 612SCM_DEFINE (scm_delete_file, "delete-file", 1, 0, 0,
1bbd0b84 613 (SCM str),
d3818c29 614 "Deletes (or \"unlinks\") the file specified by @var{path}.")
1bbd0b84 615#define FUNC_NAME s_scm_delete_file
2f3ed1ba
JB
616{
617 int ans;
a6d9e5ab
DH
618 SCM_VALIDATE_STRING (1, str);
619 SCM_STRING_COERCE_0TERMINATION_X (str);
620 SCM_SYSCALL (ans = unlink (SCM_STRING_CHARS (str)));
2f3ed1ba 621 if (ans != 0)
1bbd0b84 622 SCM_SYSERROR;
2f3ed1ba
JB
623 return SCM_UNSPECIFIED;
624}
1bbd0b84 625#undef FUNC_NAME
2f3ed1ba 626
f25f761d 627#ifdef HAVE_MKDIR
a1ec6916 628SCM_DEFINE (scm_mkdir, "mkdir", 1, 1, 0,
1bbd0b84 629 (SCM path, SCM mode),
d3818c29
MD
630 "Create a new directory named by @var{path}. If @var{mode} is omitted\n"
631 "then the permissions of the directory file are set using the current\n"
632 "umask. Otherwise they are set to the decimal value specified with\n"
633 "@var{mode}. The return value is unspecified.")
1bbd0b84 634#define FUNC_NAME s_scm_mkdir
0f2d19dd 635{
0f2d19dd
JB
636 int rv;
637 mode_t mask;
a6d9e5ab
DH
638 SCM_VALIDATE_STRING (1, path);
639 SCM_STRING_COERCE_0TERMINATION_X (path);
0f2d19dd
JB
640 if (SCM_UNBNDP (mode))
641 {
642 mask = umask (0);
643 umask (mask);
a6d9e5ab 644 SCM_SYSCALL (rv = mkdir (SCM_STRING_CHARS (path), 0777 ^ mask));
0f2d19dd
JB
645 }
646 else
647 {
3b3b36dd 648 SCM_VALIDATE_INUM (2,mode);
a6d9e5ab 649 SCM_SYSCALL (rv = mkdir (SCM_STRING_CHARS (path), SCM_INUM (mode)));
0f2d19dd 650 }
02b754d3 651 if (rv != 0)
1bbd0b84 652 SCM_SYSERROR;
02b754d3 653 return SCM_UNSPECIFIED;
0f2d19dd 654}
1bbd0b84 655#undef FUNC_NAME
f25f761d 656#endif /* HAVE_MKDIR */
0f2d19dd 657
f25f761d 658#ifdef HAVE_RMDIR
a1ec6916 659SCM_DEFINE (scm_rmdir, "rmdir", 1, 0, 0,
1bbd0b84 660 (SCM path),
d3818c29
MD
661 "Remove the existing directory named by @var{path}. The directory must\n"
662 "be empty for this to succeed. The return value is unspecified.")
1bbd0b84 663#define FUNC_NAME s_scm_rmdir
0f2d19dd 664{
0f2d19dd 665 int val;
02b754d3 666
a6d9e5ab
DH
667 SCM_VALIDATE_STRING (1, path);
668 SCM_STRING_COERCE_0TERMINATION_X (path);
669 SCM_SYSCALL (val = rmdir (SCM_STRING_CHARS (path)));
02b754d3 670 if (val != 0)
1bbd0b84 671 SCM_SYSERROR;
02b754d3 672 return SCM_UNSPECIFIED;
0f2d19dd 673}
1bbd0b84 674#undef FUNC_NAME
f25f761d 675#endif
0f2d19dd
JB
676
677\f
30ea841d 678
0f2d19dd
JB
679/* {Examining Directories}
680 */
681
e841c3e0 682scm_bits_t scm_tc16_dir;
0f2d19dd 683
30ea841d 684
a1ec6916 685SCM_DEFINE (scm_directory_stream_p, "directory-stream?", 1, 0, 0,
1bbd0b84 686 (SCM obj),
d3818c29
MD
687 "Returns a boolean indicating whether @var{object} is a directory stream\n"
688 "as returned by @code{opendir}.")
1bbd0b84 689#define FUNC_NAME s_scm_directory_stream_p
77242ff9 690{
30ea841d 691 return SCM_BOOL (SCM_DIRP (obj));
77242ff9 692}
1bbd0b84 693#undef FUNC_NAME
77242ff9 694
30ea841d 695
a1ec6916 696SCM_DEFINE (scm_opendir, "opendir", 1, 0, 0,
1bbd0b84 697 (SCM dirname),
d3818c29
MD
698 "Open the directory specified by @var{path} and return a directory\n"
699 "stream.")
1bbd0b84 700#define FUNC_NAME s_scm_opendir
0f2d19dd
JB
701{
702 DIR *ds;
a6d9e5ab
DH
703 SCM_VALIDATE_STRING (1, dirname);
704 SCM_STRING_COERCE_0TERMINATION_X (dirname);
705 SCM_SYSCALL (ds = opendir (SCM_STRING_CHARS (dirname)));
02b754d3 706 if (ds == NULL)
1bbd0b84 707 SCM_SYSERROR;
30ea841d 708 SCM_RETURN_NEWSMOB (scm_tc16_dir | SCM_DIR_FLAG_OPEN, ds);
0f2d19dd 709}
1bbd0b84 710#undef FUNC_NAME
0f2d19dd
JB
711
712
a1ec6916 713SCM_DEFINE (scm_readdir, "readdir", 1, 0, 0,
1bbd0b84 714 (SCM port),
d3818c29
MD
715 "Return (as a string) the next directory entry from the directory stream\n"
716 "@var{stream}. If there is no remaining entry to be read then the\n"
717 "end of file object is returned.")
1bbd0b84 718#define FUNC_NAME s_scm_readdir
0f2d19dd
JB
719{
720 struct dirent *rdent;
30ea841d
DH
721
722 SCM_VALIDATE_DIR (1, port);
723 if (!SCM_DIR_OPEN_P (port))
724 SCM_MISC_ERROR ("Directory ~S is not open.", SCM_LIST1 (port));
725
0f2d19dd 726 errno = 0;
4260a7fc 727 SCM_SYSCALL (rdent = readdir ((DIR *) SCM_CELL_WORD_1 (port)));
02b754d3 728 if (errno != 0)
1bbd0b84 729 SCM_SYSERROR;
30ea841d 730
02b754d3
GH
731 return (rdent ? scm_makfromstr (rdent->d_name, NAMLEN (rdent), 0)
732 : SCM_EOF_VAL);
0f2d19dd 733}
1bbd0b84 734#undef FUNC_NAME
0f2d19dd
JB
735
736
a1ec6916 737SCM_DEFINE (scm_rewinddir, "rewinddir", 1, 0, 0,
1bbd0b84 738 (SCM port),
d3818c29
MD
739 "Reset the directory port @var{stream} so that the next call to\n"
740 "@code{readdir} will return the first directory entry.")
1bbd0b84 741#define FUNC_NAME s_scm_rewinddir
0f2d19dd 742{
30ea841d
DH
743 SCM_VALIDATE_DIR (1, port);
744 if (!SCM_DIR_OPEN_P (port))
745 SCM_MISC_ERROR ("Directory ~S is not open.", SCM_LIST1 (port));
746
4260a7fc 747 rewinddir ((DIR *) SCM_CELL_WORD_1 (port));
30ea841d 748
0f2d19dd
JB
749 return SCM_UNSPECIFIED;
750}
1bbd0b84 751#undef FUNC_NAME
0f2d19dd
JB
752
753
a1ec6916 754SCM_DEFINE (scm_closedir, "closedir", 1, 0, 0,
1bbd0b84 755 (SCM port),
d3818c29
MD
756 "Close the directory stream @var{stream}.\n"
757 "The return value is unspecified.")
1bbd0b84 758#define FUNC_NAME s_scm_closedir
0f2d19dd 759{
30ea841d 760 SCM_VALIDATE_DIR (1, port);
02b754d3 761
30ea841d 762 if (SCM_DIR_OPEN_P (port))
0f2d19dd 763 {
30ea841d
DH
764 int sts;
765
766 SCM_SYSCALL (sts = closedir ((DIR *) SCM_CELL_WORD_1 (port)));
767 if (sts != 0)
768 SCM_SYSERROR;
769
770 SCM_SET_CELL_WORD_0 (port, scm_tc16_dir);
0f2d19dd 771 }
30ea841d 772
02b754d3 773 return SCM_UNSPECIFIED;
0f2d19dd 774}
1bbd0b84 775#undef FUNC_NAME
0f2d19dd
JB
776
777
0f2d19dd 778static int
f8b16091 779scm_dir_print (SCM exp, SCM port, scm_print_state *pstate)
0f2d19dd 780{
f8b16091 781 scm_puts ("#<", port);
30ea841d 782 if (!SCM_DIR_OPEN_P (exp))
f8b16091 783 scm_puts ("closed: ", port);
0d03da62 784 scm_puts ("directory stream ", port);
4260a7fc 785 scm_intprint (SCM_CELL_WORD_1 (exp), 16, port);
f8b16091 786 scm_putc ('>', port);
0f2d19dd
JB
787 return 1;
788}
789
1cc91f1b 790
0f2d19dd 791static scm_sizet
1bbd0b84 792scm_dir_free (SCM p)
0f2d19dd 793{
30ea841d 794 if (SCM_DIR_OPEN_P (p))
4260a7fc 795 closedir ((DIR *) SCM_CELL_WORD_1 (p));
0f2d19dd
JB
796 return 0;
797}
798
0f2d19dd
JB
799\f
800/* {Navigating Directories}
801 */
802
803
a1ec6916 804SCM_DEFINE (scm_chdir, "chdir", 1, 0, 0,
1bbd0b84 805 (SCM str),
d3818c29
MD
806 "Change the current working directory to @var{path}.\n"
807 "The return value is unspecified.")
1bbd0b84 808#define FUNC_NAME s_scm_chdir
0f2d19dd
JB
809{
810 int ans;
02b754d3 811
a6d9e5ab
DH
812 SCM_VALIDATE_STRING (1, str);
813 SCM_STRING_COERCE_0TERMINATION_X (str);
814 SCM_SYSCALL (ans = chdir (SCM_STRING_CHARS (str)));
02b754d3 815 if (ans != 0)
1bbd0b84 816 SCM_SYSERROR;
02b754d3 817 return SCM_UNSPECIFIED;
0f2d19dd 818}
1bbd0b84 819#undef FUNC_NAME
0f2d19dd 820
f25f761d 821#ifdef HAVE_GETCWD
a1ec6916 822SCM_DEFINE (scm_getcwd, "getcwd", 0, 0, 0,
1bbd0b84 823 (),
d3818c29 824 "Returns the name of the current working directory.")
1bbd0b84 825#define FUNC_NAME s_scm_getcwd
0f2d19dd 826{
0f2d19dd 827 char *rv;
0f2d19dd
JB
828 scm_sizet size = 100;
829 char *wd;
830 SCM result;
831
1bbd0b84 832 wd = scm_must_malloc (size, FUNC_NAME);
0f2d19dd
JB
833 while ((rv = getcwd (wd, size)) == 0 && errno == ERANGE)
834 {
835 scm_must_free (wd);
836 size *= 2;
1bbd0b84 837 wd = scm_must_malloc (size, FUNC_NAME);
0f2d19dd 838 }
02b754d3 839 if (rv == 0)
1bbd0b84 840 SCM_SYSERROR;
02b754d3 841 result = scm_makfromstr (wd, strlen (wd), 0);
0f2d19dd 842 scm_must_free (wd);
0f2d19dd 843 return result;
0f2d19dd 844}
1bbd0b84 845#undef FUNC_NAME
f25f761d 846#endif /* HAVE_GETCWD */
0f2d19dd
JB
847
848\f
849
28d77376
GH
850#ifdef HAVE_SELECT
851
852/* check that element is a port or file descriptor. if it's a port
853 and its buffer is ready for use, add it to the ports_ready list.
854 otherwise add its file descriptor to *set. the type of list can be
855 determined from pos: SCM_ARG1 for reads, SCM_ARG2 for writes,
856 SCM_ARG3 for excepts. */
cafc12ff 857static int
28d77376 858set_element (SELECT_TYPE *set, SCM *ports_ready, SCM element, int pos)
a48a89bc 859{
cafc12ff 860 int fd;
d831b039 861
28d77376
GH
862 if (SCM_INUMP (element))
863 {
864 fd = SCM_INUM (element);
865 }
866 else
867 {
868 int use_buf = 0;
869
870 element = SCM_COERCE_OUTPORT (element);
871 SCM_ASSERT (SCM_OPFPORTP (element), element, pos, "select");
872 if (pos == SCM_ARG1)
873 {
874 /* check whether port has buffered input. */
875 scm_port *pt = SCM_PTAB_ENTRY (element);
876
877 if (pt->read_pos < pt->read_end)
878 use_buf = 1;
879 }
880 else if (pos == SCM_ARG2)
881 {
882 /* check whether port's output buffer has room. */
883 scm_port *pt = SCM_PTAB_ENTRY (element);
884
885 /* > 1 since writing the last byte in the buffer causes flush. */
886 if (pt->write_end - pt->write_pos > 1)
887 use_buf = 1;
888 }
889 fd = use_buf ? -1 : SCM_FPORT_FDES (element);
890 }
891 if (fd == -1)
892 *ports_ready = scm_cons (element, *ports_ready);
893 else
894 FD_SET (fd, set);
cafc12ff 895 return fd;
a48a89bc 896}
1cc91f1b 897
28d77376
GH
898/* check list_or_vec, a list or vector of ports or file descriptors,
899 adding each member to either the ports_ready list (if it's a port
900 with a usable buffer) or to *set. the kind of list_or_vec can be
901 determined from pos: SCM_ARG1 for reads, SCM_ARG2 for writes,
902 SCM_ARG3 for excepts. */
cafc12ff 903static int
28d77376 904fill_select_type (SELECT_TYPE *set, SCM *ports_ready, SCM list_or_vec, int pos)
0f2d19dd 905{
28d77376
GH
906 int max_fd = 0;
907
908 if (SCM_VECTORP (list_or_vec))
0f2d19dd 909 {
9fd38a3d 910 int i = SCM_VECTOR_LENGTH (list_or_vec);
28d77376 911 SCM *ve = SCM_VELTS (list_or_vec);
a48a89bc 912
28d77376 913 while (--i >= 0)
a48a89bc 914 {
28d77376
GH
915 int fd = set_element (set, ports_ready, ve[i], pos);
916
cafc12ff
MD
917 if (fd > max_fd)
918 max_fd = fd;
a48a89bc
GH
919 }
920 }
921 else
922 {
4260a7fc 923 while (!SCM_NULLP (list_or_vec))
a48a89bc 924 {
28d77376
GH
925 int fd = set_element (set, ports_ready, SCM_CAR (list_or_vec), pos);
926
cafc12ff
MD
927 if (fd > max_fd)
928 max_fd = fd;
28d77376 929 list_or_vec = SCM_CDR (list_or_vec);
a48a89bc 930 }
0f2d19dd 931 }
cafc12ff
MD
932
933 return max_fd;
0f2d19dd
JB
934}
935
28d77376
GH
936/* if element (a file descriptor or port) appears in *set, cons it to
937 list. return list. */
a48a89bc
GH
938static SCM
939get_element (SELECT_TYPE *set, SCM element, SCM list)
940{
28d77376
GH
941 int fd;
942
943 if (SCM_INUMP (element))
a48a89bc 944 {
28d77376 945 fd = SCM_INUM (element);
a48a89bc 946 }
28d77376 947 else
a48a89bc 948 {
28d77376 949 fd = SCM_FPORT_FDES (SCM_COERCE_OUTPORT (element));
a48a89bc 950 }
28d77376
GH
951 if (FD_ISSET (fd, set))
952 list = scm_cons (element, list);
a48a89bc
GH
953 return list;
954}
1cc91f1b 955
28d77376
GH
956/* construct component of scm_select return value.
957 set: pointer to set of file descriptors found by select to be ready
958 ports_ready: ports ready due to buffering
959 list_or_vec: original list/vector handed to scm_select.
960 the return value is a list/vector of ready ports/file descriptors.
961 works by finding the objects in list which correspond to members of
962 *set and appending them to ports_ready. result is converted to a
963 vector if list_or_vec is a vector. */
0f2d19dd 964static SCM
28d77376 965retrieve_select_type (SELECT_TYPE *set, SCM ports_ready, SCM list_or_vec)
0f2d19dd 966{
28d77376 967 SCM answer_list = ports_ready;
a48a89bc 968
28d77376 969 if (SCM_VECTORP (list_or_vec))
0f2d19dd 970 {
9fd38a3d 971 int i = SCM_VECTOR_LENGTH (list_or_vec);
28d77376 972 SCM *ve = SCM_VELTS (list_or_vec);
a48a89bc 973
28d77376 974 while (--i >= 0)
0f2d19dd 975 {
28d77376 976 answer_list = get_element (set, ve[i], answer_list);
0f2d19dd 977 }
a48a89bc
GH
978 return scm_vector (answer_list);
979 }
980 else
981 {
28d77376 982 /* list_or_vec must be a list. */
4260a7fc 983 while (!SCM_NULLP (list_or_vec))
0f2d19dd 984 {
28d77376
GH
985 answer_list = get_element (set, SCM_CAR (list_or_vec), answer_list);
986 list_or_vec = SCM_CDR (list_or_vec);
0f2d19dd 987 }
a48a89bc 988 return answer_list;
0f2d19dd 989 }
0f2d19dd
JB
990}
991
1bbd0b84 992/* Static helper functions above refer to s_scm_select directly as s_select */
a1ec6916 993SCM_DEFINE (scm_select, "select", 3, 2, 0,
1bbd0b84 994 (SCM reads, SCM writes, SCM excepts, SCM secs, SCM usecs),
28d77376
GH
995 "This procedure has a variety of uses: waiting for the ability\n"
996 "to provide input, accept output, or the existance of\n"
997 "exceptional conditions on a collection of ports or file\n"
998 "descriptors, or waiting for a timeout to occur.\n"
999 "It also returns if interrupted by a signal.\n\n"
1000 "@var{reads}, @var{writes} and @var{excepts} can be lists or\n"
1001 "vectors, with each member a port or a file descriptor.\n"
1002 "The value returned is a list of three corresponding\n"
1003 "lists or vectors containing only the members which meet the\n"
1004 "specified requirement. The ability of port buffers to\n"
1005 "provide input or accept output is taken into account.\n"
1006 "Ordering of the input lists or vectors is not preserved.\n\n"
1007 "The optional arguments @var{secs} and @var{usecs} specify the\n"
1008 "timeout. Either @var{secs} can be specified alone, as\n"
1009 "either an integer or a real number, or both @var{secs} and\n"
1010 "@var{usecs} can be specified as integers, in which case\n"
1011 "@var{usecs} is an additional timeout expressed in\n"
1012 "microseconds. If @var{secs} is omitted or is @code{#f} then\n"
1013 "select will wait for as long as it takes for one of the other\n"
1014 "conditions to be satisfied.\n\n"
1015 "The scsh version of @code{select} differs as follows:\n"
1016 "Only vectors are accepted for the first three arguments.\n"
1017 "The @var{usecs} argument is not supported.\n"
1018 "Multiple values are returned instead of a list.\n"
1019 "Duplicates in the input vectors appear only once in output.\n"
1020 "An additional @code{select!} interface is provided.\n"
1021 )
1bbd0b84 1022#define FUNC_NAME s_scm_select
0f2d19dd 1023{
0f2d19dd 1024 struct timeval timeout;
28d77376 1025 struct timeval * time_ptr;
0f2d19dd
JB
1026 SELECT_TYPE read_set;
1027 SELECT_TYPE write_set;
1028 SELECT_TYPE except_set;
28d77376
GH
1029 int read_count;
1030 int write_count;
1031 int except_count;
1032 /* these lists accumulate ports which are ready due to buffering.
1033 their file descriptors don't need to be added to the select sets. */
1034 SCM read_ports_ready = SCM_EOL;
1035 SCM write_ports_ready = SCM_EOL;
1036 int max_fd;
1037
1038 if (SCM_VECTORP (reads))
1039 {
9fd38a3d 1040 read_count = SCM_VECTOR_LENGTH (reads);
28d77376
GH
1041 }
1042 else
1043 {
1044 read_count = scm_ilength (reads);
1045 SCM_ASSERT (read_count >= 0, reads, SCM_ARG1, FUNC_NAME);
1046 }
1047 if (SCM_VECTORP (writes))
1048 {
9fd38a3d 1049 write_count = SCM_VECTOR_LENGTH (writes);
28d77376
GH
1050 }
1051 else
1052 {
1053 write_count = scm_ilength (writes);
1054 SCM_ASSERT (write_count >= 0, writes, SCM_ARG2, FUNC_NAME);
1055 }
1056 if (SCM_VECTORP (excepts))
1057 {
9fd38a3d 1058 except_count = SCM_VECTOR_LENGTH (excepts);
28d77376
GH
1059 }
1060 else
1061 {
1062 except_count = scm_ilength (excepts);
1063 SCM_ASSERT (except_count >= 0, excepts, SCM_ARG3, FUNC_NAME);
1064 }
0f2d19dd
JB
1065
1066 FD_ZERO (&read_set);
1067 FD_ZERO (&write_set);
1068 FD_ZERO (&except_set);
1069
28d77376
GH
1070 max_fd = fill_select_type (&read_set, &read_ports_ready, reads, SCM_ARG1);
1071
1072 {
1073 int write_max = fill_select_type (&write_set, &write_ports_ready,
1074 writes, SCM_ARG2);
1075 int except_max = fill_select_type (&except_set, NULL,
1076 excepts, SCM_ARG3);
1077
1078 if (write_max > max_fd)
1079 max_fd = write_max;
1080 if (except_max > max_fd)
1081 max_fd = except_max;
1082 }
0f2d19dd 1083
ae1b098b
GH
1084 /* if there's a port with a ready buffer, don't block, just
1085 check for ready file descriptors. */
4260a7fc 1086 if (!SCM_NULLP (read_ports_ready) || !SCM_NULLP (write_ports_ready))
ae1b098b
GH
1087 {
1088 timeout.tv_sec = 0;
1089 timeout.tv_usec = 0;
1090 time_ptr = &timeout;
1091 }
1092 else if (SCM_UNBNDP (secs) || SCM_FALSEP (secs))
28d77376 1093 time_ptr = 0;
0f2d19dd
JB
1094 else
1095 {
ae1b098b 1096 if (SCM_INUMP (secs))
a48a89bc
GH
1097 {
1098 timeout.tv_sec = SCM_INUM (secs);
1099 if (SCM_UNBNDP (usecs))
1100 timeout.tv_usec = 0;
1101 else
1102 {
3b3b36dd 1103 SCM_VALIDATE_INUM (5,usecs);
a48a89bc
GH
1104 timeout.tv_usec = SCM_INUM (usecs);
1105 }
1106 }
0f2d19dd 1107 else
a48a89bc 1108 {
1bbd0b84 1109 double fl = scm_num2dbl (secs, FUNC_NAME);
a48a89bc
GH
1110
1111 if (!SCM_UNBNDP (usecs))
c1bfcf60 1112 SCM_WRONG_TYPE_ARG (4, secs);
a48a89bc 1113 if (fl > LONG_MAX)
c1bfcf60 1114 SCM_OUT_OF_RANGE (4, secs);
a48a89bc
GH
1115 timeout.tv_sec = (long) fl;
1116 timeout.tv_usec = (long) ((fl - timeout.tv_sec) * 1000000);
1117 }
28d77376 1118 time_ptr = &timeout;
0f2d19dd
JB
1119 }
1120
28d77376 1121 {
44e8413c 1122#ifdef GUILE_ISELECT
28d77376
GH
1123 int rv = scm_internal_select (max_fd + 1,
1124 &read_set, &write_set, &except_set,
1125 time_ptr);
44e8413c 1126#else
28d77376
GH
1127 int rv = select (max_fd + 1,
1128 &read_set, &write_set, &except_set, time_ptr);
44e8413c 1129#endif
28d77376
GH
1130 if (rv < 0)
1131 SCM_SYSERROR;
1132 }
1133 return scm_listify (retrieve_select_type (&read_set, read_ports_ready,
1134 reads),
1135 retrieve_select_type (&write_set, write_ports_ready,
1136 writes),
1137 retrieve_select_type (&except_set, SCM_EOL, excepts),
02b754d3 1138 SCM_UNDEFINED);
0f2d19dd 1139}
1bbd0b84 1140#undef FUNC_NAME
f25f761d 1141#endif /* HAVE_SELECT */
0f2d19dd
JB
1142
1143\f
4c1feaa5 1144
af45e3b0 1145SCM_DEFINE (scm_fcntl, "fcntl", 2, 1, 0,
1bbd0b84 1146 (SCM object, SCM cmd, SCM value),
d3818c29
MD
1147 "Apply @var{command} to the specified file descriptor or the underlying\n"
1148 "file descriptor of the specified port. @var{value} is an optional\n"
1149 "integer argument.\n\n"
1150 "Values for @var{command} are:\n\n"
1151 "@table @code\n"
1152 "@item F_DUPFD\n"
1153 "Duplicate a file descriptor\n"
1154 "@item F_GETFD\n"
1155 "Get flags associated with the file descriptor.\n"
1156 "@item F_SETFD\n"
1157 "Set flags associated with the file descriptor to @var{value}.\n"
1158 "@item F_GETFL\n"
1159 "Get flags associated with the open file.\n"
1160 "@item F_SETFL\n"
1161 "Set flags associated with the open file to @var{value}\n"
1162 "@item F_GETOWN\n"
1163 "Get the process ID of a socket's owner, for @code{SIGIO} signals.\n"
1164 "@item F_SETOWN\n"
1165 "Set the process that owns a socket to @var{value}, for @code{SIGIO} signals.\n"
1166 "@item FD_CLOEXEC\n"
55892d87
NJ
1167 "The value used to indicate the \"close on exec\" flag with @code{F_GETFL} or\n"
1168 "@code{F_SETFL}.\n"
a3c8b9fc 1169 "@end table")
1bbd0b84 1170#define FUNC_NAME s_scm_fcntl
4c1feaa5
JB
1171{
1172 int rv;
6afcd3b2
GH
1173 int fdes;
1174 int ivalue;
4c1feaa5 1175
78446828
MV
1176 object = SCM_COERCE_OUTPORT (object);
1177
3b3b36dd 1178 SCM_VALIDATE_INUM (2,cmd);
0c95b57d 1179 if (SCM_OPFPORTP (object))
77a76b64 1180 fdes = SCM_FPORT_FDES (object);
6afcd3b2
GH
1181 else
1182 {
3b3b36dd 1183 SCM_VALIDATE_INUM (1,object);
6afcd3b2
GH
1184 fdes = SCM_INUM (object);
1185 }
af45e3b0
DH
1186
1187 if (SCM_UNBNDP (value)) {
6afcd3b2 1188 ivalue = 0;
af45e3b0
DH
1189 } else {
1190 SCM_VALIDATE_INUM_COPY (SCM_ARG3, value, ivalue);
1191 }
1192
77a76b64
JB
1193 SCM_SYSCALL (rv = fcntl (fdes, SCM_INUM (cmd), ivalue));
1194 if (rv == -1)
1bbd0b84 1195 SCM_SYSERROR;
4c1feaa5
JB
1196 return SCM_MAKINUM (rv);
1197}
1bbd0b84 1198#undef FUNC_NAME
6afcd3b2 1199
a1ec6916 1200SCM_DEFINE (scm_fsync, "fsync", 1, 0, 0,
1bbd0b84 1201 (SCM object),
d3818c29
MD
1202 "Copies any unwritten data for the specified output file descriptor to disk.\n"
1203 "If @var{port/fd} is a port, its buffer is flushed before the underlying\n"
1204 "file descriptor is fsync'd.\n"
1205 "The return value is unspecified.")
1bbd0b84 1206#define FUNC_NAME s_scm_fsync
6afcd3b2
GH
1207{
1208 int fdes;
1209
78446828
MV
1210 object = SCM_COERCE_OUTPORT (object);
1211
0c95b57d 1212 if (SCM_OPFPORTP (object))
6afcd3b2 1213 {
affc96b5 1214 scm_flush (object);
77a76b64 1215 fdes = SCM_FPORT_FDES (object);
6afcd3b2
GH
1216 }
1217 else
1218 {
3b3b36dd 1219 SCM_VALIDATE_INUM (1,object);
6afcd3b2
GH
1220 fdes = SCM_INUM (object);
1221 }
1222 if (fsync (fdes) == -1)
1bbd0b84 1223 SCM_SYSERROR;
6afcd3b2
GH
1224 return SCM_UNSPECIFIED;
1225}
1bbd0b84 1226#undef FUNC_NAME
0f2d19dd 1227
f25f761d 1228#ifdef HAVE_SYMLINK
a1ec6916 1229SCM_DEFINE (scm_symlink, "symlink", 2, 0, 0,
1bbd0b84 1230 (SCM oldpath, SCM newpath),
d3818c29
MD
1231 "Create a symbolic link named @var{path-to} with the value (i.e., pointing to)\n"
1232 "@var{path-from}. The return value is unspecified.")
1bbd0b84 1233#define FUNC_NAME s_scm_symlink
0f2d19dd 1234{
0f2d19dd 1235 int val;
02b754d3 1236
a6d9e5ab
DH
1237 SCM_VALIDATE_STRING (1, oldpath);
1238 SCM_VALIDATE_STRING (2, newpath);
1239 SCM_STRING_COERCE_0TERMINATION_X (oldpath);
1240 SCM_STRING_COERCE_0TERMINATION_X (newpath);
1241 SCM_SYSCALL (val = symlink (SCM_STRING_CHARS (oldpath), SCM_STRING_CHARS (newpath)));
02b754d3 1242 if (val != 0)
1bbd0b84 1243 SCM_SYSERROR;
02b754d3 1244 return SCM_UNSPECIFIED;
0f2d19dd 1245}
1bbd0b84 1246#undef FUNC_NAME
f25f761d 1247#endif /* HAVE_SYMLINK */
0f2d19dd 1248
f25f761d 1249#ifdef HAVE_READLINK
a1ec6916 1250SCM_DEFINE (scm_readlink, "readlink", 1, 0, 0,
1bbd0b84 1251 (SCM path),
d3818c29
MD
1252 "Returns the value of the symbolic link named by\n"
1253 "@var{path} (a string), i.e., the\n"
1254 "file that the link points to.")
1bbd0b84 1255#define FUNC_NAME s_scm_readlink
0f2d19dd 1256{
6a738a25
JB
1257 int rv;
1258 int size = 100;
0f2d19dd
JB
1259 char *buf;
1260 SCM result;
a6d9e5ab
DH
1261 SCM_VALIDATE_STRING (1, path);
1262 SCM_STRING_COERCE_0TERMINATION_X (path);
1bbd0b84 1263 buf = scm_must_malloc (size, FUNC_NAME);
a6d9e5ab 1264 while ((rv = readlink (SCM_STRING_CHARS (path), buf, size)) == size)
0f2d19dd
JB
1265 {
1266 scm_must_free (buf);
1267 size *= 2;
1bbd0b84 1268 buf = scm_must_malloc (size, FUNC_NAME);
0f2d19dd 1269 }
02b754d3 1270 if (rv == -1)
1bbd0b84 1271 SCM_SYSERROR;
02b754d3 1272 result = scm_makfromstr (buf, rv, 0);
0f2d19dd 1273 scm_must_free (buf);
0f2d19dd 1274 return result;
0f2d19dd 1275}
1bbd0b84 1276#undef FUNC_NAME
f25f761d 1277#endif /* HAVE_READLINK */
0f2d19dd 1278
f25f761d 1279#ifdef HAVE_LSTAT
a1ec6916 1280SCM_DEFINE (scm_lstat, "lstat", 1, 0, 0,
1bbd0b84 1281 (SCM str),
d3818c29
MD
1282 "Similar to @code{stat}, but does not follow symbolic links, i.e.,\n"
1283 "it will return information about a symbolic link itself, not the \n"
1284 "file it points to. @var{path} must be a string.")
1bbd0b84 1285#define FUNC_NAME s_scm_lstat
0f2d19dd 1286{
02b754d3 1287 int rv;
0f2d19dd 1288 struct stat stat_temp;
02b754d3 1289
a6d9e5ab
DH
1290 SCM_VALIDATE_STRING (1, str);
1291 SCM_STRING_COERCE_0TERMINATION_X (str);
1292 SCM_SYSCALL (rv = lstat (SCM_STRING_CHARS (str), &stat_temp));
02b754d3 1293 if (rv != 0)
3d8d56df
GH
1294 {
1295 int en = errno;
1296
5d2d2ffc 1297 SCM_SYSERROR_MSG ("~A: ~S",
3d8d56df
GH
1298 scm_listify (scm_makfrom0str (strerror (errno)),
1299 str,
5d2d2ffc 1300 SCM_UNDEFINED), en);
3d8d56df 1301 }
02b754d3 1302 return scm_stat2scm(&stat_temp);
0f2d19dd 1303}
1bbd0b84 1304#undef FUNC_NAME
f25f761d 1305#endif /* HAVE_LSTAT */
0f2d19dd 1306
a1ec6916 1307SCM_DEFINE (scm_copy_file, "copy-file", 2, 0, 0,
1bbd0b84 1308 (SCM oldfile, SCM newfile),
d3818c29
MD
1309 "Copy the file specified by @var{path-from} to @var{path-to}.\n"
1310 "The return value is unspecified.")
1bbd0b84 1311#define FUNC_NAME s_scm_copy_file
0f2d19dd
JB
1312{
1313 int oldfd, newfd;
1314 int n;
77a76b64 1315 char buf[BUFSIZ];
0f2d19dd
JB
1316 struct stat oldstat;
1317
a6d9e5ab
DH
1318 SCM_VALIDATE_STRING (1, oldfile);
1319 SCM_STRING_COERCE_0TERMINATION_X (oldfile);
1320 SCM_VALIDATE_STRING (2, newfile);
1321 SCM_STRING_COERCE_0TERMINATION_X (newfile);
1322 if (stat (SCM_STRING_CHARS (oldfile), &oldstat) == -1)
1bbd0b84 1323 SCM_SYSERROR;
a6d9e5ab 1324 oldfd = open (SCM_STRING_CHARS (oldfile), O_RDONLY);
0f2d19dd 1325 if (oldfd == -1)
1bbd0b84 1326 SCM_SYSERROR;
02b754d3
GH
1327
1328 /* use POSIX flags instead of 07777?. */
a6d9e5ab 1329 newfd = open (SCM_STRING_CHARS (newfile), O_WRONLY | O_CREAT | O_TRUNC,
0f2d19dd
JB
1330 oldstat.st_mode & 07777);
1331 if (newfd == -1)
1bbd0b84 1332 SCM_SYSERROR;
02b754d3 1333
0f2d19dd
JB
1334 while ((n = read (oldfd, buf, sizeof buf)) > 0)
1335 if (write (newfd, buf, n) != n)
1336 {
1337 close (oldfd);
1338 close (newfd);
1bbd0b84 1339 SCM_SYSERROR;
0f2d19dd
JB
1340 }
1341 close (oldfd);
1342 if (close (newfd) == -1)
1bbd0b84 1343 SCM_SYSERROR;
02b754d3 1344 return SCM_UNSPECIFIED;
0f2d19dd 1345}
1bbd0b84 1346#undef FUNC_NAME
0f2d19dd
JB
1347
1348\f
6a738a25
JB
1349/* Filename manipulation */
1350
1351SCM scm_dot_string;
1352
a1ec6916 1353SCM_DEFINE (scm_dirname, "dirname", 1, 0, 0,
1bbd0b84 1354 (SCM filename),
fa6a543f
MG
1355 "Return the directory name component of the file name\n"
1356 "@var{filename}. If @var{filename} does not contain a directory\n"
1357 "component, @code{.} is returned.")
1bbd0b84 1358#define FUNC_NAME s_scm_dirname
6a738a25
JB
1359{
1360 char *s;
9fd38a3d
DH
1361 long int i;
1362 unsigned long int len;
1363
1364 SCM_VALIDATE_STRING (1,filename);
1365
34f0f2b8 1366 s = SCM_STRING_CHARS (filename);
9fd38a3d
DH
1367 len = SCM_STRING_LENGTH (filename);
1368
6a738a25
JB
1369 i = len - 1;
1370 while (i >= 0 && s[i] == '/') --i;
1371 while (i >= 0 && s[i] != '/') --i;
1372 while (i >= 0 && s[i] == '/') --i;
1373 if (i < 0)
1374 {
1375 if (len > 0 && s[0] == '/')
d1ca2c64 1376 return scm_substring (filename, SCM_INUM0, SCM_MAKINUM (1));
6a738a25
JB
1377 else
1378 return scm_dot_string;
1379 }
1380 else
d1ca2c64 1381 return scm_substring (filename, SCM_INUM0, SCM_MAKINUM (i + 1));
6a738a25 1382}
1bbd0b84 1383#undef FUNC_NAME
6a738a25 1384
a1ec6916 1385SCM_DEFINE (scm_basename, "basename", 1, 1, 0,
1bbd0b84 1386 (SCM filename, SCM suffix),
fa6a543f
MG
1387 "Return the base name of the file name @var{filename}. The\n"
1388 "base name is the file name without any directory components.\n"
1389 "If @var{suffix} is privided, and is equal to the end of\n"
1390 "@var{basename}, it is removed also.")
1bbd0b84 1391#define FUNC_NAME s_scm_basename
6a738a25
JB
1392{
1393 char *f, *s = 0;
1394 int i, j, len, end;
9fd38a3d
DH
1395
1396 SCM_VALIDATE_STRING (1,filename);
34f0f2b8 1397 f = SCM_STRING_CHARS (filename);
9fd38a3d
DH
1398 len = SCM_STRING_LENGTH (filename);
1399
6a738a25
JB
1400 if (SCM_UNBNDP (suffix))
1401 j = -1;
1402 else
1403 {
9fd38a3d 1404 SCM_VALIDATE_STRING (2, suffix);
34f0f2b8 1405 s = SCM_STRING_CHARS (suffix);
9fd38a3d 1406 j = SCM_STRING_LENGTH (suffix) - 1;
6a738a25 1407 }
6a738a25
JB
1408 i = len - 1;
1409 while (i >= 0 && f[i] == '/') --i;
1410 end = i;
1411 while (i >= 0 && j >= 0 && f[i] == s[j]) --i, --j;
1412 if (j == -1)
1413 end = i;
1414 while (i >= 0 && f[i] != '/') --i;
1415 if (i == end)
1416 {
1417 if (len > 0 && f[0] == '/')
d1ca2c64 1418 return scm_substring (filename, SCM_INUM0, SCM_MAKINUM (1));
6a738a25
JB
1419 else
1420 return scm_dot_string;
1421 }
1422 else
d1ca2c64 1423 return scm_substring (filename, SCM_MAKINUM (i + 1), SCM_MAKINUM (end + 1));
6a738a25 1424}
1bbd0b84 1425#undef FUNC_NAME
6a738a25
JB
1426
1427
1428
1429\f
1cc91f1b 1430
0f2d19dd
JB
1431void
1432scm_init_filesys ()
0f2d19dd 1433{
e841c3e0
KN
1434 scm_tc16_dir = scm_make_smob_type ("directory", 0);
1435 scm_set_smob_free (scm_tc16_dir, scm_dir_free);
1436 scm_set_smob_print (scm_tc16_dir, scm_dir_print);
0f2d19dd 1437
a163dda9
MD
1438 scm_dot_string = scm_permanent_object (scm_makfrom0str ("."));
1439
3d8d56df
GH
1440#ifdef O_RDONLY
1441scm_sysintern ("O_RDONLY", scm_long2num (O_RDONLY));
1442#endif
1443#ifdef O_WRONLY
1444scm_sysintern ("O_WRONLY", scm_long2num (O_WRONLY));
1445#endif
1446#ifdef O_RDWR
1447scm_sysintern ("O_RDWR", scm_long2num (O_RDWR));
1448#endif
1449#ifdef O_CREAT
1450scm_sysintern ("O_CREAT", scm_long2num (O_CREAT));
1451#endif
1452#ifdef O_EXCL
1453scm_sysintern ("O_EXCL", scm_long2num (O_EXCL));
1454#endif
1455#ifdef O_NOCTTY
1456scm_sysintern ("O_NOCTTY", scm_long2num (O_NOCTTY));
1457#endif
1458#ifdef O_TRUNC
1459scm_sysintern ("O_TRUNC", scm_long2num (O_TRUNC));
1460#endif
1461#ifdef O_APPEND
1462scm_sysintern ("O_APPEND", scm_long2num (O_APPEND));
1463#endif
6afcd3b2 1464#ifdef O_NONBLOCK
3d8d56df
GH
1465scm_sysintern ("O_NONBLOCK", scm_long2num (O_NONBLOCK));
1466#endif
1467#ifdef O_NDELAY
1468scm_sysintern ("O_NDELAY", scm_long2num (O_NDELAY));
1469#endif
1470#ifdef O_SYNC
1471scm_sysintern ("O_SYNC", scm_long2num (O_SYNC));
1472#endif
1473
4c1feaa5
JB
1474#ifdef F_DUPFD
1475scm_sysintern ("F_DUPFD", scm_long2num (F_DUPFD));
1476#endif
1477#ifdef F_GETFD
1478scm_sysintern ("F_GETFD", scm_long2num (F_GETFD));
1479#endif
1480#ifdef F_SETFD
1481scm_sysintern ("F_SETFD", scm_long2num (F_SETFD));
1482#endif
1483#ifdef F_GETFL
1484scm_sysintern ("F_GETFL", scm_long2num (F_GETFL));
1485#endif
1486#ifdef F_SETFL
1487scm_sysintern ("F_SETFL", scm_long2num (F_SETFL));
1488#endif
1489#ifdef F_GETOWN
1490scm_sysintern ("F_GETOWN", scm_long2num (F_GETOWN));
1491#endif
1492#ifdef F_SETOWN
1493scm_sysintern ("F_SETOWN", scm_long2num (F_SETOWN));
1494#endif
1495#ifdef FD_CLOEXEC
1496scm_sysintern ("FD_CLOEXEC", scm_long2num (FD_CLOEXEC));
bd9e24b3 1497#endif
3d8d56df 1498
8dc9439f 1499#ifndef SCM_MAGIC_SNARFER
a0599745 1500#include "libguile/filesys.x"
8dc9439f 1501#endif
0f2d19dd 1502}
89e00824
ML
1503
1504/*
1505 Local Variables:
1506 c-file-style: "gnu"
1507 End:
1508*/