1 /* Copyright (C) 1996,1997,1998,1999,2000,2001 Free Software Foundation, Inc.
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)
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.
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
15 * the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
16 * Boston, MA 02111-1307 USA
18 * As a special exception, the Free Software Foundation gives permission
19 * for additional uses of the text contained in its release of GUILE.
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.
27 * This exception does not however invalidate any other reasons why
28 * the executable file might be covered by the GNU General Public License.
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.
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.
40 * If you do not wish that, delete this exception notice. */
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"
54 #include "libguile/lang.h"
56 #include "libguile/validate.h"
57 #include "libguile/filesys.h"
68 #ifdef TIME_WITH_SYS_TIME
69 # include <sys/time.h>
73 # include <sys/time.h>
83 #ifdef LIBC_H_WITH_UNISTD_H
87 #ifdef HAVE_SYS_SELECT_H
88 #include <sys/select.h>
95 #include <sys/types.h>
104 #if defined (__MINGW32__) || defined (_MSC_VER) || defined (__BORLANDC__)
105 # include "win32-dirent.h"
106 # define NAMLEN(dirent) strlen((dirent)->d_name)
109 # define NAMLEN(dirent) strlen((dirent)->d_name)
111 # define dirent direct
112 # define NAMLEN(dirent) (dirent)->d_namlen
114 # include <sys/ndir.h>
117 # include <sys/dir.h>
124 /* Ultrix has S_IFSOCK, but no S_ISSOCK. Ipe! */
125 #if defined (S_IFSOCK) && ! defined (S_ISSOCK)
126 #define S_ISSOCK(mode) (((mode) & S_IFMT) == S_IFSOCK)
129 /* The MinGW gcc does not define the S_ISSOCK macro. Any other native Windows
130 compiler like BorlandC or MSVC has none of these macros defined. */
152 # define _S_IFIFO 0x1000 /* FIFO */
153 # define _S_IFCHR 0x2000 /* Character */
154 # define _S_IFBLK 0x3000 /* Block */
155 # define _S_IFDIR 0x4000 /* Directory */
156 # define _S_IFREG 0x8000 /* Regular */
157 # define _S_IFSOCK 0xC000 /* Socket */
178 # define S_ISBLK(mode) (((mode) & _S_IFMT) == _S_IFBLK)
179 # define S_ISFIFO(mode) (((mode) & _S_IFMT) == _S_IFIFO)
180 # define S_ISCHR(mode) (((mode) & _S_IFMT) == _S_IFCHR)
181 # define S_ISDIR(mode) (((mode) & _S_IFMT) == _S_IFDIR)
182 # define S_ISREG(mode) (((mode) & _S_IFMT) == _S_IFREG)
183 # define S_ISSOCK(mode) (((mode) & _S_IFMT) == _S_IFSOCK)
185 #endif /* __MINGW32__ */
187 /* Some more definitions for the native Windows port. */
189 # define mkdir(path, mode) mkdir (path)
190 # define fsync(fd) _commit (fd)
191 # define fchmod(fd, mode) (-1)
192 #endif /* __MINGW32__ */
202 SCM_DEFINE (scm_chown
, "chown", 3, 0, 0,
203 (SCM object
, SCM owner
, SCM group
),
204 "Change the ownership and group of the file referred to by @var{object} to\n"
205 "the integer values @var{owner} and @var{group}. @var{object} can be\n"
206 "a string containing a file name or, if the platform\n"
207 "supports fchown, a port or integer file descriptor\n"
208 "which is open on the file. The return value\n"
209 "is unspecified.\n\n"
210 "If @var{object} is a symbolic link, either the\n"
211 "ownership of the link or the ownership of the referenced file will be\n"
212 "changed depending on the operating system (lchown is\n"
213 "unsupported at present). If @var{owner} or @var{group} is specified\n"
214 "as @code{-1}, then that ID is not changed.")
215 #define FUNC_NAME s_scm_chown
219 object
= SCM_COERCE_OUTPORT (object
);
221 SCM_VALIDATE_INUM (2, owner
);
222 SCM_VALIDATE_INUM (3, group
);
224 if (SCM_INUMP (object
) || (SCM_OPFPORTP (object
)))
226 int fdes
= SCM_INUMP (object
) ? SCM_INUM (object
)
227 : SCM_FPORT_FDES (object
);
229 SCM_SYSCALL (rv
= fchown (fdes
, SCM_INUM (owner
), SCM_INUM (group
)));
234 SCM_VALIDATE_STRING (1, object
);
235 SCM_SYSCALL (rv
= chown (SCM_STRING_CHARS (object
),
236 SCM_INUM (owner
), SCM_INUM (group
)));
240 return SCM_UNSPECIFIED
;
243 #endif /* HAVE_CHOWN */
246 SCM_DEFINE (scm_chmod
, "chmod", 2, 0, 0,
247 (SCM object
, SCM mode
),
248 "Changes the permissions of the file referred to by @var{obj}.\n"
249 "@var{obj} can be a string containing a file name or a port or integer file\n"
250 "descriptor which is open on a file (in which case @code{fchmod} is used\n"
251 "as the underlying system call).\n"
252 "@var{mode} specifies\n"
253 "the new permissions as a decimal number, e.g., @code{(chmod \"foo\" #o755)}.\n"
254 "The return value is unspecified.")
255 #define FUNC_NAME s_scm_chmod
260 object
= SCM_COERCE_OUTPORT (object
);
262 SCM_VALIDATE_INUM (2, mode
);
263 if (SCM_INUMP (object
) || SCM_OPFPORTP (object
))
265 if (SCM_INUMP (object
))
266 fdes
= SCM_INUM (object
);
268 fdes
= SCM_FPORT_FDES (object
);
269 SCM_SYSCALL (rv
= fchmod (fdes
, SCM_INUM (mode
)));
273 SCM_VALIDATE_STRING (1, object
);
274 SCM_SYSCALL (rv
= chmod (SCM_STRING_CHARS (object
), SCM_INUM (mode
)));
278 return SCM_UNSPECIFIED
;
282 SCM_DEFINE (scm_umask
, "umask", 0, 1, 0,
284 "If @var{mode} is omitted, returns a decimal number representing the current\n"
285 "file creation mask. Otherwise the file creation mask is set to\n"
286 "@var{mode} and the previous value is returned.\n\n"
287 "E.g., @code{(umask #o022)} sets the mask to octal 22, decimal 18.")
288 #define FUNC_NAME s_scm_umask
291 if (SCM_UNBNDP (mode
))
298 SCM_VALIDATE_INUM (1, mode
);
299 mask
= umask (SCM_INUM (mode
));
301 return SCM_MAKINUM (mask
);
307 SCM_DEFINE (scm_open_fdes
, "open-fdes", 2, 1, 0,
308 (SCM path
, SCM flags
, SCM mode
),
309 "Similar to @code{open} but return a file descriptor instead of\n"
311 #define FUNC_NAME s_scm_open_fdes
317 SCM_VALIDATE_STRING (1, path
);
318 iflags
= SCM_NUM2INT (2, flags
);
319 imode
= SCM_NUM2INT_DEF (3, mode
, 0666);
320 SCM_SYSCALL (fd
= open (SCM_STRING_CHARS (path
), iflags
, imode
));
323 return SCM_MAKINUM (fd
);
327 SCM_DEFINE (scm_open
, "open", 2, 1, 0,
328 (SCM path
, SCM flags
, SCM mode
),
329 "Open the file named by @var{path} for reading and/or writing.\n"
330 "@var{flags} is an integer specifying how the file should be opened.\n"
331 "@var{mode} is an integer specifying the permission bits of the file, if\n"
332 "it needs to be created, before the umask is applied. The default is 666\n"
333 "(Unix itself has no default).\n\n"
334 "@var{flags} can be constructed by combining variables using @code{logior}.\n"
335 "Basic flags are:\n\n"
337 "Open the file read-only.\n"
340 "Open the file write-only.\n"
343 "Open the file read/write.\n"
346 "Append to the file instead of truncating.\n"
349 "Create the file if it does not already exist.\n"
351 "See the Unix documentation of the @code{open} system call\n"
352 "for additional flags.")
353 #define FUNC_NAME s_scm_open
360 fd
= SCM_INUM (scm_open_fdes (path
, flags
, mode
));
361 iflags
= SCM_NUM2INT (2, flags
);
364 if (iflags
& O_APPEND
)
366 else if (iflags
& O_CREAT
)
372 if (iflags
& O_APPEND
)
374 else if (iflags
& O_WRONLY
)
379 newpt
= scm_fdes_to_port (fd
, port_mode
, path
);
384 SCM_DEFINE (scm_close
, "close", 1, 0, 0,
386 "Similar to close-port (@pxref{Closing, close-port}),\n"
387 "but also works on file descriptors. A side\n"
388 "effect of closing a file descriptor is that any ports using that file\n"
389 "descriptor are moved to a different file descriptor and have\n"
390 "their revealed counts set to zero.")
391 #define FUNC_NAME s_scm_close
396 fd_or_port
= SCM_COERCE_OUTPORT (fd_or_port
);
398 if (SCM_PORTP (fd_or_port
))
399 return scm_close_port (fd_or_port
);
400 SCM_VALIDATE_INUM (1, fd_or_port
);
401 fd
= SCM_INUM (fd_or_port
);
402 scm_evict_ports (fd
); /* see scsh manual. */
403 SCM_SYSCALL (rv
= close (fd
));
404 /* following scsh, closing an already closed file descriptor is
406 if (rv
< 0 && errno
!= EBADF
)
408 return SCM_BOOL (rv
>= 0);
412 SCM_DEFINE (scm_close_fdes
, "close-fdes", 1, 0, 0,
414 "A simple wrapper for the @code{close} system call.\n"
415 "Close file descriptor @var{fd}, which must be an integer.\n"
416 "Unlike close (@pxref{Ports and File Descriptors, close}),\n"
417 "the file descriptor will be closed even if a port is using it.\n"
418 "The return value is unspecified.")
419 #define FUNC_NAME s_scm_close_fdes
424 SCM_VALIDATE_INUM_COPY (1, fd
, c_fd
);
425 SCM_SYSCALL (rv
= close (c_fd
));
428 return SCM_UNSPECIFIED
;
436 SCM_SYMBOL (scm_sym_regular
, "regular");
437 SCM_SYMBOL (scm_sym_directory
, "directory");
439 SCM_SYMBOL (scm_sym_symlink
, "symlink");
441 SCM_SYMBOL (scm_sym_block_special
, "block-special");
442 SCM_SYMBOL (scm_sym_char_special
, "char-special");
443 SCM_SYMBOL (scm_sym_fifo
, "fifo");
444 SCM_SYMBOL (scm_sym_sock
, "socket");
445 SCM_SYMBOL (scm_sym_unknown
, "unknown");
448 scm_stat2scm (struct stat
*stat_temp
)
450 SCM ans
= scm_c_make_vector (15, SCM_UNSPECIFIED
);
452 SCM_VECTOR_SET(ans
, 0, scm_ulong2num ((unsigned long) stat_temp
->st_dev
));
453 SCM_VECTOR_SET(ans
, 1, scm_ulong2num ((unsigned long) stat_temp
->st_ino
));
454 SCM_VECTOR_SET(ans
, 2, scm_ulong2num ((unsigned long) stat_temp
->st_mode
));
455 SCM_VECTOR_SET(ans
, 3, scm_ulong2num ((unsigned long) stat_temp
->st_nlink
));
456 SCM_VECTOR_SET(ans
, 4, scm_ulong2num ((unsigned long) stat_temp
->st_uid
));
457 SCM_VECTOR_SET(ans
, 5, scm_ulong2num ((unsigned long) stat_temp
->st_gid
));
458 #ifdef HAVE_STRUCT_STAT_ST_RDEV
459 SCM_VECTOR_SET(ans
, 6, scm_ulong2num ((unsigned long) stat_temp
->st_rdev
));
461 SCM_VECTOR_SET(ans
, 6, SCM_BOOL_F
);
463 SCM_VECTOR_SET(ans
, 7, scm_ulong2num ((unsigned long) stat_temp
->st_size
));
464 SCM_VECTOR_SET(ans
, 8, scm_ulong2num ((unsigned long) stat_temp
->st_atime
));
465 SCM_VECTOR_SET(ans
, 9, scm_ulong2num ((unsigned long) stat_temp
->st_mtime
));
466 SCM_VECTOR_SET(ans
, 10, scm_ulong2num ((unsigned long) stat_temp
->st_ctime
));
467 #ifdef HAVE_STRUCT_STAT_ST_BLKSIZE
468 SCM_VECTOR_SET(ans
, 11, scm_ulong2num ((unsigned long) stat_temp
->st_blksize
));
470 SCM_VECTOR_SET(ans
, 11, scm_ulong2num (4096L));
472 #ifdef HAVE_STRUCT_STAT_ST_BLOCKS
473 SCM_VECTOR_SET(ans
, 12, scm_ulong2num ((unsigned long) stat_temp
->st_blocks
));
475 SCM_VECTOR_SET(ans
, 12, SCM_BOOL_F
);
478 int mode
= stat_temp
->st_mode
;
481 SCM_VECTOR_SET(ans
, 13, scm_sym_regular
);
482 else if (S_ISDIR (mode
))
483 SCM_VECTOR_SET(ans
, 13, scm_sym_directory
);
485 else if (S_ISLNK (mode
))
486 SCM_VECTOR_SET(ans
, 13, scm_sym_symlink
);
488 else if (S_ISBLK (mode
))
489 SCM_VECTOR_SET(ans
, 13, scm_sym_block_special
);
490 else if (S_ISCHR (mode
))
491 SCM_VECTOR_SET(ans
, 13, scm_sym_char_special
);
492 else if (S_ISFIFO (mode
))
493 SCM_VECTOR_SET(ans
, 13, scm_sym_fifo
);
495 else if (S_ISSOCK (mode
))
496 SCM_VECTOR_SET(ans
, 13, scm_sym_sock
);
499 SCM_VECTOR_SET(ans
, 13, scm_sym_unknown
);
501 SCM_VECTOR_SET(ans
, 14, SCM_MAKINUM ((~S_IFMT
) & mode
));
503 /* the layout of the bits in ve[14] is intended to be portable.
504 If there are systems that don't follow the usual convention,
505 the following could be used:
508 if (S_ISUID & mode) tmp += 1;
510 if (S_IRGRP & mode) tmp += 1;
512 if (S_ISVTX & mode) tmp += 1;
514 if (S_IRUSR & mode) tmp += 1;
516 if (S_IWUSR & mode) tmp += 1;
518 if (S_IXUSR & mode) tmp += 1;
520 if (S_IWGRP & mode) tmp += 1;
522 if (S_IXGRP & mode) tmp += 1;
524 if (S_IROTH & mode) tmp += 1;
526 if (S_IWOTH & mode) tmp += 1;
528 if (S_IXOTH & mode) tmp += 1;
530 SCM_VECTOR_SET(ans, 14, SCM_MAKINUM (tmp));
540 * Try getting the appropiate stat buffer for a given file descriptor
541 * under Windows. It differentiates between file, pipe and socket
544 static int fstat_Win32 (int fdes
, struct stat
*buf
)
546 int error
, optlen
= sizeof (int);
548 memset (buf
, 0, sizeof (struct stat
));
550 /* Is this a socket ? */
551 if (getsockopt (fdes
, SOL_SOCKET
, SO_ERROR
, (void *) &error
, &optlen
) >= 0)
553 buf
->st_mode
= _S_IFSOCK
| _S_IREAD
| _S_IWRITE
| _S_IEXEC
;
555 buf
->st_atime
= buf
->st_ctime
= buf
->st_mtime
= time (NULL
);
558 /* Maybe a regular file or pipe ? */
559 return fstat (fdes
, buf
);
561 #endif /* __MINGW32__ */
563 SCM_DEFINE (scm_stat
, "stat", 1, 0, 0,
565 "Return an object containing various information about the file\n"
566 "determined by @var{obj}. @var{obj} can be a string containing\n"
567 "a file name or a port or integer file descriptor which is open\n"
568 "on a file (in which case @code{fstat} is used as the underlying\n"
571 "The object returned by @code{stat} can be passed as a single\n"
572 "parameter to the following procedures, all of which return\n"
577 "The device containing the file.\n"
579 "The file serial number, which distinguishes this file from all\n"
580 "other files on the same device.\n"
582 "The mode of the file. This includes file type information and\n"
583 "the file permission bits. See @code{stat:type} and\n"
584 "@code{stat:perms} below.\n"
586 "The number of hard links to the file.\n"
588 "The user ID of the file's owner.\n"
590 "The group ID of the file.\n"
592 "Device ID; this entry is defined only for character or block\n"
595 "The size of a regular file in bytes.\n"
597 "The last access time for the file.\n"
599 "The last modification time for the file.\n"
601 "The last modification time for the attributes of the file.\n"
602 "@item stat:blksize\n"
603 "The optimal block size for reading or writing the file, in\n"
605 "@item stat:blocks\n"
606 "The amount of disk space that the file occupies measured in\n"
607 "units of 512 byte blocks.\n"
610 "In addition, the following procedures return the information\n"
611 "from stat:mode in a more convenient form:\n"
615 "A symbol representing the type of file. Possible values are\n"
616 "regular, directory, symlink, block-special, char-special, fifo,\n"
617 "socket and unknown\n"
619 "An integer representing the access permission bits.\n"
621 #define FUNC_NAME s_scm_stat
625 struct stat stat_temp
;
627 if (SCM_INUMP (object
))
630 SCM_SYSCALL (rv
= fstat_Win32 (SCM_INUM (object
), &stat_temp
));
632 SCM_SYSCALL (rv
= fstat (SCM_INUM (object
), &stat_temp
));
635 else if (SCM_STRINGP (object
))
638 char *p
, *file
= strdup (SCM_STRING_CHARS (object
));
639 p
= file
+ strlen (file
) - 1;
640 while (p
> file
&& (*p
== '/' || *p
== '\\'))
642 SCM_SYSCALL (rv
= stat (file
, &stat_temp
));
645 SCM_SYSCALL (rv
= stat (SCM_STRING_CHARS (object
), &stat_temp
));
650 object
= SCM_COERCE_OUTPORT (object
);
651 SCM_VALIDATE_OPFPORT (1, object
);
652 fdes
= SCM_FPORT_FDES (object
);
654 SCM_SYSCALL (rv
= fstat_Win32 (fdes
, &stat_temp
));
656 SCM_SYSCALL (rv
= fstat (fdes
, &stat_temp
));
664 SCM_SYSERROR_MSG ("~A: ~S",
665 scm_list_2 (scm_makfrom0str (strerror (errno
)),
669 return scm_stat2scm (&stat_temp
);
674 /* {Modifying Directories}
678 SCM_DEFINE (scm_link
, "link", 2, 0, 0,
679 (SCM oldpath
, SCM newpath
),
680 "Creates a new name @var{newpath} in the file system for the\n"
681 "file named by @var{oldpath}. If @var{oldpath} is a symbolic\n"
682 "link, the link may or may not be followed depending on the\n"
684 #define FUNC_NAME s_scm_link
688 SCM_VALIDATE_STRING (1, oldpath
);
689 SCM_VALIDATE_STRING (2, newpath
);
690 SCM_SYSCALL (val
= link (SCM_STRING_CHARS (oldpath
),
691 SCM_STRING_CHARS (newpath
)));
694 return SCM_UNSPECIFIED
;
697 #endif /* HAVE_LINK */
701 SCM_DEFINE (scm_rename
, "rename-file", 2, 0, 0,
702 (SCM oldname
, SCM newname
),
703 "Renames the file specified by @var{oldname} to @var{newname}.\n"
704 "The return value is unspecified.")
705 #define FUNC_NAME s_scm_rename
708 SCM_VALIDATE_STRING (1, oldname
);
709 SCM_VALIDATE_STRING (2, newname
);
711 SCM_SYSCALL (rv
= rename (SCM_STRING_CHARS (oldname
), SCM_STRING_CHARS (newname
)));
713 SCM_SYSCALL (rv
= link (SCM_STRING_CHARS (oldname
), SCM_STRING_CHARS (newname
)));
716 SCM_SYSCALL (rv
= unlink (SCM_STRING_CHARS (oldname
)));;
718 /* unlink failed. remove new name */
719 SCM_SYSCALL (unlink (SCM_STRING_CHARS (newname
)));
724 return SCM_UNSPECIFIED
;
729 SCM_DEFINE (scm_delete_file
, "delete-file", 1, 0, 0,
731 "Deletes (or \"unlinks\") the file specified by @var{path}.")
732 #define FUNC_NAME s_scm_delete_file
735 SCM_VALIDATE_STRING (1, str
);
736 SCM_SYSCALL (ans
= unlink (SCM_STRING_CHARS (str
)));
739 return SCM_UNSPECIFIED
;
744 SCM_DEFINE (scm_mkdir
, "mkdir", 1, 1, 0,
745 (SCM path
, SCM mode
),
746 "Create a new directory named by @var{path}. If @var{mode} is omitted\n"
747 "then the permissions of the directory file are set using the current\n"
748 "umask. Otherwise they are set to the decimal value specified with\n"
749 "@var{mode}. The return value is unspecified.")
750 #define FUNC_NAME s_scm_mkdir
754 SCM_VALIDATE_STRING (1, path
);
755 if (SCM_UNBNDP (mode
))
759 SCM_SYSCALL (rv
= mkdir (SCM_STRING_CHARS (path
), 0777 ^ mask
));
763 SCM_VALIDATE_INUM (2, mode
);
764 SCM_SYSCALL (rv
= mkdir (SCM_STRING_CHARS (path
), SCM_INUM (mode
)));
768 return SCM_UNSPECIFIED
;
771 #endif /* HAVE_MKDIR */
774 SCM_DEFINE (scm_rmdir
, "rmdir", 1, 0, 0,
776 "Remove the existing directory named by @var{path}. The directory must\n"
777 "be empty for this to succeed. The return value is unspecified.")
778 #define FUNC_NAME s_scm_rmdir
782 SCM_VALIDATE_STRING (1, path
);
783 SCM_SYSCALL (val
= rmdir (SCM_STRING_CHARS (path
)));
786 return SCM_UNSPECIFIED
;
793 /* {Examining Directories}
796 scm_t_bits scm_tc16_dir
;
799 SCM_DEFINE (scm_directory_stream_p
, "directory-stream?", 1, 0, 0,
801 "Return a boolean indicating whether @var{object} is a directory\n"
802 "stream as returned by @code{opendir}.")
803 #define FUNC_NAME s_scm_directory_stream_p
805 return SCM_BOOL (SCM_DIRP (obj
));
810 SCM_DEFINE (scm_opendir
, "opendir", 1, 0, 0,
812 "Open the directory specified by @var{path} and return a directory\n"
814 #define FUNC_NAME s_scm_opendir
817 SCM_VALIDATE_STRING (1, dirname
);
818 SCM_SYSCALL (ds
= opendir (SCM_STRING_CHARS (dirname
)));
821 SCM_RETURN_NEWSMOB (scm_tc16_dir
| SCM_DIR_FLAG_OPEN
, ds
);
826 SCM_DEFINE (scm_readdir
, "readdir", 1, 0, 0,
828 "Return (as a string) the next directory entry from the directory stream\n"
829 "@var{stream}. If there is no remaining entry to be read then the\n"
830 "end of file object is returned.")
831 #define FUNC_NAME s_scm_readdir
833 struct dirent
*rdent
;
835 SCM_VALIDATE_DIR (1, port
);
836 if (!SCM_DIR_OPEN_P (port
))
837 SCM_MISC_ERROR ("Directory ~S is not open.", scm_list_1 (port
));
840 SCM_SYSCALL (rdent
= readdir ((DIR *) SCM_CELL_WORD_1 (port
)));
844 return (rdent
? scm_mem2string (rdent
->d_name
, NAMLEN (rdent
))
850 SCM_DEFINE (scm_rewinddir
, "rewinddir", 1, 0, 0,
852 "Reset the directory port @var{stream} so that the next call to\n"
853 "@code{readdir} will return the first directory entry.")
854 #define FUNC_NAME s_scm_rewinddir
856 SCM_VALIDATE_DIR (1, port
);
857 if (!SCM_DIR_OPEN_P (port
))
858 SCM_MISC_ERROR ("Directory ~S is not open.", scm_list_1 (port
));
860 rewinddir ((DIR *) SCM_CELL_WORD_1 (port
));
862 return SCM_UNSPECIFIED
;
867 SCM_DEFINE (scm_closedir
, "closedir", 1, 0, 0,
869 "Close the directory stream @var{stream}.\n"
870 "The return value is unspecified.")
871 #define FUNC_NAME s_scm_closedir
873 SCM_VALIDATE_DIR (1, port
);
875 if (SCM_DIR_OPEN_P (port
))
879 SCM_SYSCALL (sts
= closedir ((DIR *) SCM_CELL_WORD_1 (port
)));
883 SCM_SET_CELL_WORD_0 (port
, scm_tc16_dir
);
886 return SCM_UNSPECIFIED
;
892 scm_dir_print (SCM exp
, SCM port
, scm_print_state
*pstate SCM_UNUSED
)
894 scm_puts ("#<", port
);
895 if (!SCM_DIR_OPEN_P (exp
))
896 scm_puts ("closed: ", port
);
897 scm_puts ("directory stream ", port
);
898 scm_intprint (SCM_CELL_WORD_1 (exp
), 16, port
);
899 scm_putc ('>', port
);
907 if (SCM_DIR_OPEN_P (p
))
908 closedir ((DIR *) SCM_CELL_WORD_1 (p
));
913 /* {Navigating Directories}
917 SCM_DEFINE (scm_chdir
, "chdir", 1, 0, 0,
919 "Change the current working directory to @var{path}.\n"
920 "The return value is unspecified.")
921 #define FUNC_NAME s_scm_chdir
925 SCM_VALIDATE_STRING (1, str
);
926 SCM_SYSCALL (ans
= chdir (SCM_STRING_CHARS (str
)));
929 return SCM_UNSPECIFIED
;
934 SCM_DEFINE (scm_getcwd
, "getcwd", 0, 0, 0,
936 "Return the name of the current working directory.")
937 #define FUNC_NAME s_scm_getcwd
944 wd
= scm_malloc (size
);
945 while ((rv
= getcwd (wd
, size
)) == 0 && errno
== ERANGE
)
949 wd
= scm_malloc (size
);
953 result
= scm_mem2string (wd
, strlen (wd
));
958 #endif /* HAVE_GETCWD */
964 /* check that element is a port or file descriptor. if it's a port
965 and its buffer is ready for use, add it to the ports_ready list.
966 otherwise add its file descriptor to *set. the type of list can be
967 determined from pos: SCM_ARG1 for reads, SCM_ARG2 for writes,
968 SCM_ARG3 for excepts. */
970 set_element (SELECT_TYPE
*set
, SCM
*ports_ready
, SCM element
, int pos
)
974 if (SCM_INUMP (element
))
976 fd
= SCM_INUM (element
);
982 element
= SCM_COERCE_OUTPORT (element
);
983 SCM_ASSERT (SCM_OPFPORTP (element
), element
, pos
, "select");
986 /* check whether port has buffered input. */
987 scm_t_port
*pt
= SCM_PTAB_ENTRY (element
);
989 if (pt
->read_pos
< pt
->read_end
)
992 else if (pos
== SCM_ARG2
)
994 /* check whether port's output buffer has room. */
995 scm_t_port
*pt
= SCM_PTAB_ENTRY (element
);
997 /* > 1 since writing the last byte in the buffer causes flush. */
998 if (pt
->write_end
- pt
->write_pos
> 1)
1001 fd
= use_buf
? -1 : SCM_FPORT_FDES (element
);
1004 *ports_ready
= scm_cons (element
, *ports_ready
);
1010 /* check list_or_vec, a list or vector of ports or file descriptors,
1011 adding each member to either the ports_ready list (if it's a port
1012 with a usable buffer) or to *set. the kind of list_or_vec can be
1013 determined from pos: SCM_ARG1 for reads, SCM_ARG2 for writes,
1014 SCM_ARG3 for excepts. */
1016 fill_select_type (SELECT_TYPE
*set
, SCM
*ports_ready
, SCM list_or_vec
, int pos
)
1020 if (SCM_VECTORP (list_or_vec
))
1022 int i
= SCM_VECTOR_LENGTH (list_or_vec
);
1023 SCM
const *ve
= SCM_VELTS (list_or_vec
);
1027 int fd
= set_element (set
, ports_ready
, ve
[i
], pos
);
1035 while (!SCM_NULL_OR_NIL_P (list_or_vec
))
1037 int fd
= set_element (set
, ports_ready
, SCM_CAR (list_or_vec
), pos
);
1041 list_or_vec
= SCM_CDR (list_or_vec
);
1048 /* if element (a file descriptor or port) appears in *set, cons it to
1049 list. return list. */
1051 get_element (SELECT_TYPE
*set
, SCM element
, SCM list
)
1055 if (SCM_INUMP (element
))
1057 fd
= SCM_INUM (element
);
1061 fd
= SCM_FPORT_FDES (SCM_COERCE_OUTPORT (element
));
1063 if (FD_ISSET (fd
, set
))
1064 list
= scm_cons (element
, list
);
1068 /* construct component of scm_select return value.
1069 set: pointer to set of file descriptors found by select to be ready
1070 ports_ready: ports ready due to buffering
1071 list_or_vec: original list/vector handed to scm_select.
1072 the return value is a list/vector of ready ports/file descriptors.
1073 works by finding the objects in list which correspond to members of
1074 *set and appending them to ports_ready. result is converted to a
1075 vector if list_or_vec is a vector. */
1077 retrieve_select_type (SELECT_TYPE
*set
, SCM ports_ready
, SCM list_or_vec
)
1079 SCM answer_list
= ports_ready
;
1081 if (SCM_VECTORP (list_or_vec
))
1083 int i
= SCM_VECTOR_LENGTH (list_or_vec
);
1084 SCM
const *ve
= SCM_VELTS (list_or_vec
);
1088 answer_list
= get_element (set
, ve
[i
], answer_list
);
1090 return scm_vector (answer_list
);
1094 /* list_or_vec must be a list. */
1095 while (!SCM_NULL_OR_NIL_P (list_or_vec
))
1097 answer_list
= get_element (set
, SCM_CAR (list_or_vec
), answer_list
);
1098 list_or_vec
= SCM_CDR (list_or_vec
);
1104 /* Static helper functions above refer to s_scm_select directly as s_select */
1105 SCM_DEFINE (scm_select
, "select", 3, 2, 0,
1106 (SCM reads
, SCM writes
, SCM excepts
, SCM secs
, SCM usecs
),
1107 "This procedure has a variety of uses: waiting for the ability\n"
1108 "to provide input, accept output, or the existence of\n"
1109 "exceptional conditions on a collection of ports or file\n"
1110 "descriptors, or waiting for a timeout to occur.\n"
1111 "It also returns if interrupted by a signal.\n\n"
1112 "@var{reads}, @var{writes} and @var{excepts} can be lists or\n"
1113 "vectors, with each member a port or a file descriptor.\n"
1114 "The value returned is a list of three corresponding\n"
1115 "lists or vectors containing only the members which meet the\n"
1116 "specified requirement. The ability of port buffers to\n"
1117 "provide input or accept output is taken into account.\n"
1118 "Ordering of the input lists or vectors is not preserved.\n\n"
1119 "The optional arguments @var{secs} and @var{usecs} specify the\n"
1120 "timeout. Either @var{secs} can be specified alone, as\n"
1121 "either an integer or a real number, or both @var{secs} and\n"
1122 "@var{usecs} can be specified as integers, in which case\n"
1123 "@var{usecs} is an additional timeout expressed in\n"
1124 "microseconds. If @var{secs} is omitted or is @code{#f} then\n"
1125 "select will wait for as long as it takes for one of the other\n"
1126 "conditions to be satisfied.\n\n"
1127 "The scsh version of @code{select} differs as follows:\n"
1128 "Only vectors are accepted for the first three arguments.\n"
1129 "The @var{usecs} argument is not supported.\n"
1130 "Multiple values are returned instead of a list.\n"
1131 "Duplicates in the input vectors appear only once in output.\n"
1132 "An additional @code{select!} interface is provided.")
1133 #define FUNC_NAME s_scm_select
1135 struct timeval timeout
;
1136 struct timeval
* time_ptr
;
1137 SELECT_TYPE read_set
;
1138 SELECT_TYPE write_set
;
1139 SELECT_TYPE except_set
;
1143 /* these lists accumulate ports which are ready due to buffering.
1144 their file descriptors don't need to be added to the select sets. */
1145 SCM read_ports_ready
= SCM_EOL
;
1146 SCM write_ports_ready
= SCM_EOL
;
1149 if (SCM_VECTORP (reads
))
1151 read_count
= SCM_VECTOR_LENGTH (reads
);
1155 read_count
= scm_ilength (reads
);
1156 SCM_ASSERT (read_count
>= 0, reads
, SCM_ARG1
, FUNC_NAME
);
1158 if (SCM_VECTORP (writes
))
1160 write_count
= SCM_VECTOR_LENGTH (writes
);
1164 write_count
= scm_ilength (writes
);
1165 SCM_ASSERT (write_count
>= 0, writes
, SCM_ARG2
, FUNC_NAME
);
1167 if (SCM_VECTORP (excepts
))
1169 except_count
= SCM_VECTOR_LENGTH (excepts
);
1173 except_count
= scm_ilength (excepts
);
1174 SCM_ASSERT (except_count
>= 0, excepts
, SCM_ARG3
, FUNC_NAME
);
1177 FD_ZERO (&read_set
);
1178 FD_ZERO (&write_set
);
1179 FD_ZERO (&except_set
);
1181 max_fd
= fill_select_type (&read_set
, &read_ports_ready
, reads
, SCM_ARG1
);
1184 int write_max
= fill_select_type (&write_set
, &write_ports_ready
,
1186 int except_max
= fill_select_type (&except_set
, NULL
,
1189 if (write_max
> max_fd
)
1191 if (except_max
> max_fd
)
1192 max_fd
= except_max
;
1195 /* if there's a port with a ready buffer, don't block, just
1196 check for ready file descriptors. */
1197 if (!SCM_NULLP (read_ports_ready
) || !SCM_NULLP (write_ports_ready
))
1200 timeout
.tv_usec
= 0;
1201 time_ptr
= &timeout
;
1203 else if (SCM_UNBNDP (secs
) || SCM_FALSEP (secs
))
1207 if (SCM_INUMP (secs
))
1209 timeout
.tv_sec
= SCM_INUM (secs
);
1210 if (SCM_UNBNDP (usecs
))
1211 timeout
.tv_usec
= 0;
1214 SCM_VALIDATE_INUM (5, usecs
);
1215 timeout
.tv_usec
= SCM_INUM (usecs
);
1220 double fl
= scm_num2dbl (secs
, FUNC_NAME
);
1222 if (!SCM_UNBNDP (usecs
))
1223 SCM_WRONG_TYPE_ARG (4, secs
);
1225 SCM_OUT_OF_RANGE (4, secs
);
1226 timeout
.tv_sec
= (long) fl
;
1227 timeout
.tv_usec
= (long) ((fl
- timeout
.tv_sec
) * 1000000);
1229 time_ptr
= &timeout
;
1233 #ifdef GUILE_ISELECT
1234 int rv
= scm_internal_select (max_fd
+ 1,
1235 &read_set
, &write_set
, &except_set
,
1238 int rv
= select (max_fd
+ 1,
1239 &read_set
, &write_set
, &except_set
, time_ptr
);
1244 return scm_list_3 (retrieve_select_type (&read_set
, read_ports_ready
, reads
),
1245 retrieve_select_type (&write_set
, write_ports_ready
, writes
),
1246 retrieve_select_type (&except_set
, SCM_EOL
, excepts
));
1249 #endif /* HAVE_SELECT */
1254 SCM_DEFINE (scm_fcntl
, "fcntl", 2, 1, 0,
1255 (SCM object
, SCM cmd
, SCM value
),
1256 "Apply @var{command} to the specified file descriptor or the underlying\n"
1257 "file descriptor of the specified port. @var{value} is an optional\n"
1258 "integer argument.\n\n"
1259 "Values for @var{command} are:\n\n"
1262 "Duplicate a file descriptor\n"
1264 "Get flags associated with the file descriptor.\n"
1266 "Set flags associated with the file descriptor to @var{value}.\n"
1268 "Get flags associated with the open file.\n"
1270 "Set flags associated with the open file to @var{value}\n"
1272 "Get the process ID of a socket's owner, for @code{SIGIO} signals.\n"
1274 "Set the process that owns a socket to @var{value}, for @code{SIGIO} signals.\n"
1275 "@item FD_CLOEXEC\n"
1276 "The value used to indicate the \"close on exec\" flag with @code{F_GETFL} or\n"
1279 #define FUNC_NAME s_scm_fcntl
1285 object
= SCM_COERCE_OUTPORT (object
);
1287 SCM_VALIDATE_INUM (2, cmd
);
1288 if (SCM_OPFPORTP (object
))
1289 fdes
= SCM_FPORT_FDES (object
);
1292 SCM_VALIDATE_INUM (1, object
);
1293 fdes
= SCM_INUM (object
);
1296 if (SCM_UNBNDP (value
)) {
1299 SCM_VALIDATE_INUM_COPY (SCM_ARG3
, value
, ivalue
);
1302 SCM_SYSCALL (rv
= fcntl (fdes
, SCM_INUM (cmd
), ivalue
));
1305 return SCM_MAKINUM (rv
);
1308 #endif /* HAVE_FCNTL */
1310 SCM_DEFINE (scm_fsync
, "fsync", 1, 0, 0,
1312 "Copies any unwritten data for the specified output file descriptor to disk.\n"
1313 "If @var{port/fd} is a port, its buffer is flushed before the underlying\n"
1314 "file descriptor is fsync'd.\n"
1315 "The return value is unspecified.")
1316 #define FUNC_NAME s_scm_fsync
1320 object
= SCM_COERCE_OUTPORT (object
);
1322 if (SCM_OPFPORTP (object
))
1325 fdes
= SCM_FPORT_FDES (object
);
1329 SCM_VALIDATE_INUM (1, object
);
1330 fdes
= SCM_INUM (object
);
1332 if (fsync (fdes
) == -1)
1334 return SCM_UNSPECIFIED
;
1339 SCM_DEFINE (scm_symlink
, "symlink", 2, 0, 0,
1340 (SCM oldpath
, SCM newpath
),
1341 "Create a symbolic link named @var{path-to} with the value (i.e., pointing to)\n"
1342 "@var{path-from}. The return value is unspecified.")
1343 #define FUNC_NAME s_scm_symlink
1347 SCM_VALIDATE_STRING (1, oldpath
);
1348 SCM_VALIDATE_STRING (2, newpath
);
1349 SCM_SYSCALL (val
= symlink (SCM_STRING_CHARS (oldpath
), SCM_STRING_CHARS (newpath
)));
1352 return SCM_UNSPECIFIED
;
1355 #endif /* HAVE_SYMLINK */
1357 #ifdef HAVE_READLINK
1358 SCM_DEFINE (scm_readlink
, "readlink", 1, 0, 0,
1360 "Return the value of the symbolic link named by @var{path} (a\n"
1361 "string), i.e., the file that the link points to.")
1362 #define FUNC_NAME s_scm_readlink
1368 SCM_VALIDATE_STRING (1, path
);
1369 buf
= scm_malloc (size
);
1370 while ((rv
= readlink (SCM_STRING_CHARS (path
), buf
, size
)) == size
)
1374 buf
= scm_malloc (size
);
1378 result
= scm_mem2string (buf
, rv
);
1383 #endif /* HAVE_READLINK */
1386 SCM_DEFINE (scm_lstat
, "lstat", 1, 0, 0,
1388 "Similar to @code{stat}, but does not follow symbolic links, i.e.,\n"
1389 "it will return information about a symbolic link itself, not the\n"
1390 "file it points to. @var{path} must be a string.")
1391 #define FUNC_NAME s_scm_lstat
1394 struct stat stat_temp
;
1396 SCM_VALIDATE_STRING (1, str
);
1397 SCM_SYSCALL (rv
= lstat (SCM_STRING_CHARS (str
), &stat_temp
));
1402 SCM_SYSERROR_MSG ("~A: ~S",
1403 scm_list_2 (scm_makfrom0str (strerror (errno
)), str
),
1406 return scm_stat2scm(&stat_temp
);
1409 #endif /* HAVE_LSTAT */
1411 SCM_DEFINE (scm_copy_file
, "copy-file", 2, 0, 0,
1412 (SCM oldfile
, SCM newfile
),
1413 "Copy the file specified by @var{path-from} to @var{path-to}.\n"
1414 "The return value is unspecified.")
1415 #define FUNC_NAME s_scm_copy_file
1420 struct stat oldstat
;
1422 SCM_VALIDATE_STRING (1, oldfile
);
1423 SCM_VALIDATE_STRING (2, newfile
);
1424 if (stat (SCM_STRING_CHARS (oldfile
), &oldstat
) == -1)
1426 oldfd
= open (SCM_STRING_CHARS (oldfile
), O_RDONLY
);
1430 /* use POSIX flags instead of 07777?. */
1431 newfd
= open (SCM_STRING_CHARS (newfile
), O_WRONLY
| O_CREAT
| O_TRUNC
,
1432 oldstat
.st_mode
& 07777);
1436 while ((n
= read (oldfd
, buf
, sizeof buf
)) > 0)
1437 if (write (newfd
, buf
, n
) != n
)
1444 if (close (newfd
) == -1)
1446 return SCM_UNSPECIFIED
;
1451 /* Filename manipulation */
1455 SCM_DEFINE (scm_dirname
, "dirname", 1, 0, 0,
1457 "Return the directory name component of the file name\n"
1458 "@var{filename}. If @var{filename} does not contain a directory\n"
1459 "component, @code{.} is returned.")
1460 #define FUNC_NAME s_scm_dirname
1464 unsigned long int len
;
1466 SCM_VALIDATE_STRING (1, filename
);
1468 s
= SCM_STRING_CHARS (filename
);
1469 len
= SCM_STRING_LENGTH (filename
);
1473 while (i
>= 0 && (s
[i
] == '/' || s
[i
] == '\\')) --i
;
1474 while (i
>= 0 && (s
[i
] != '/' && s
[i
] != '\\')) --i
;
1475 while (i
>= 0 && (s
[i
] == '/' || s
[i
] == '\\')) --i
;
1477 while (i
>= 0 && s
[i
] == '/') --i
;
1478 while (i
>= 0 && s
[i
] != '/') --i
;
1479 while (i
>= 0 && s
[i
] == '/') --i
;
1480 #endif /* ndef __MINGW32__ */
1484 if (len
> 0 && (s
[0] == '/' || s
[0] == '\\'))
1486 if (len
> 0 && s
[0] == '/')
1487 #endif /* ndef __MINGW32__ */
1488 return scm_substring (filename
, SCM_INUM0
, SCM_MAKINUM (1));
1490 return scm_dot_string
;
1493 return scm_substring (filename
, SCM_INUM0
, SCM_MAKINUM (i
+ 1));
1497 SCM_DEFINE (scm_basename
, "basename", 1, 1, 0,
1498 (SCM filename
, SCM suffix
),
1499 "Return the base name of the file name @var{filename}. The\n"
1500 "base name is the file name without any directory components.\n"
1501 "If @var{suffix} is provided, and is equal to the end of\n"
1502 "@var{basename}, it is removed also.")
1503 #define FUNC_NAME s_scm_basename
1508 SCM_VALIDATE_STRING (1, filename
);
1509 f
= SCM_STRING_CHARS (filename
);
1510 len
= SCM_STRING_LENGTH (filename
);
1512 if (SCM_UNBNDP (suffix
))
1516 SCM_VALIDATE_STRING (2, suffix
);
1517 s
= SCM_STRING_CHARS (suffix
);
1518 j
= SCM_STRING_LENGTH (suffix
) - 1;
1522 while (i
>= 0 && (f
[i
] == '/' || f
[i
] == '\\')) --i
;
1524 while (i
>= 0 && f
[i
] == '/') --i
;
1525 #endif /* ndef __MINGW32__ */
1527 while (i
>= 0 && j
>= 0 && f
[i
] == s
[j
]) --i
, --j
;
1531 while (i
>= 0 && (f
[i
] != '/' || f
[i
] != '\\')) --i
;
1533 while (i
>= 0 && f
[i
] != '/') --i
;
1534 #endif /* ndef __MINGW32__ */
1538 if (len
> 0 && (f
[0] == '/' || f
[i
] == '\\'))
1540 if (len
> 0 && f
[0] == '/')
1541 #endif /* ndef __MINGW32__ */
1542 return scm_substring (filename
, SCM_INUM0
, SCM_MAKINUM (1));
1544 return scm_dot_string
;
1547 return scm_substring (filename
, SCM_MAKINUM (i
+ 1), SCM_MAKINUM (end
+ 1));
1558 scm_tc16_dir
= scm_make_smob_type ("directory", 0);
1559 scm_set_smob_free (scm_tc16_dir
, scm_dir_free
);
1560 scm_set_smob_print (scm_tc16_dir
, scm_dir_print
);
1562 scm_dot_string
= scm_permanent_object (scm_makfrom0str ("."));
1565 scm_c_define ("O_RDONLY", scm_long2num (O_RDONLY
));
1568 scm_c_define ("O_WRONLY", scm_long2num (O_WRONLY
));
1571 scm_c_define ("O_RDWR", scm_long2num (O_RDWR
));
1574 scm_c_define ("O_CREAT", scm_long2num (O_CREAT
));
1577 scm_c_define ("O_EXCL", scm_long2num (O_EXCL
));
1580 scm_c_define ("O_NOCTTY", scm_long2num (O_NOCTTY
));
1583 scm_c_define ("O_TRUNC", scm_long2num (O_TRUNC
));
1586 scm_c_define ("O_APPEND", scm_long2num (O_APPEND
));
1589 scm_c_define ("O_NONBLOCK", scm_long2num (O_NONBLOCK
));
1592 scm_c_define ("O_NDELAY", scm_long2num (O_NDELAY
));
1595 scm_c_define ("O_SYNC", scm_long2num (O_SYNC
));
1599 scm_c_define ("F_DUPFD", scm_long2num (F_DUPFD
));
1602 scm_c_define ("F_GETFD", scm_long2num (F_GETFD
));
1605 scm_c_define ("F_SETFD", scm_long2num (F_SETFD
));
1608 scm_c_define ("F_GETFL", scm_long2num (F_GETFL
));
1611 scm_c_define ("F_SETFL", scm_long2num (F_SETFL
));
1614 scm_c_define ("F_GETOWN", scm_long2num (F_GETOWN
));
1617 scm_c_define ("F_SETOWN", scm_long2num (F_SETOWN
));
1620 scm_c_define ("FD_CLOEXEC", scm_long2num (FD_CLOEXEC
));
1623 #include "libguile/filesys.x"