1 /* Copyright (C) 1996, 1997, 1998, 1999, 2000 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. */
42 /* Software engineering face-lift by Greg J. Badros, 11-Dec-1999,
43 gjb@cs.washington.edu, http://www.cs.washington.edu/homes/gjb */
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"
55 #include "libguile/validate.h"
56 #include "libguile/filesys.h"
63 #ifdef TIME_WITH_SYS_TIME
64 # include <sys/time.h>
68 # include <sys/time.h>
78 #ifdef LIBC_H_WITH_UNISTD_H
82 #ifdef HAVE_SYS_SELECT_H
83 #include <sys/select.h>
90 #include <sys/types.h>
99 # define NAMLEN(dirent) strlen((dirent)->d_name)
101 # define dirent direct
102 # define NAMLEN(dirent) (dirent)->d_namlen
104 # include <sys/ndir.h>
107 # include <sys/dir.h>
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)
126 SCM_DEFINE (scm_chown
, "chown", 3, 0, 0,
127 (SCM object
, SCM owner
, SCM group
),
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"
133 "is unspecified.\n\n"
134 "If @var{object} is a symbolic link, either the\n"
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.")
139 #define FUNC_NAME s_scm_chown
143 object
= SCM_COERCE_OUTPORT (object
);
145 SCM_VALIDATE_INUM (2,owner
);
146 SCM_VALIDATE_INUM (3,group
);
148 if (SCM_INUMP (object
) || (SCM_OPFPORTP (object
)))
150 int fdes
= SCM_INUMP (object
) ? SCM_INUM (object
)
151 : SCM_FPORT_FDES (object
);
153 SCM_SYSCALL (rv
= fchown (fdes
, SCM_INUM (owner
), SCM_INUM (group
)));
158 SCM_VALIDATE_STRING (1, object
);
159 SCM_STRING_COERCE_0TERMINATION_X (object
);
160 SCM_SYSCALL (rv
= chown (SCM_STRING_CHARS (object
),
161 SCM_INUM (owner
), SCM_INUM (group
)));
165 return SCM_UNSPECIFIED
;
170 SCM_DEFINE (scm_chmod
, "chmod", 2, 0, 0,
171 (SCM object
, SCM mode
),
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.")
179 #define FUNC_NAME s_scm_chmod
184 object
= SCM_COERCE_OUTPORT (object
);
186 SCM_VALIDATE_INUM (2,mode
);
187 if (SCM_INUMP (object
) || SCM_OPFPORTP (object
))
189 if (SCM_INUMP (object
))
190 fdes
= SCM_INUM (object
);
192 fdes
= SCM_FPORT_FDES (object
);
193 SCM_SYSCALL (rv
= fchmod (fdes
, SCM_INUM (mode
)));
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
)));
203 return SCM_UNSPECIFIED
;
207 SCM_DEFINE (scm_umask
, "umask", 0, 1, 0,
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.")
213 #define FUNC_NAME s_scm_umask
216 if (SCM_UNBNDP (mode
))
223 SCM_VALIDATE_INUM (1,mode
);
224 mask
= umask (SCM_INUM (mode
));
226 return SCM_MAKINUM (mask
);
232 SCM_DEFINE (scm_open_fdes
, "open-fdes", 2, 1, 0,
233 (SCM path
, SCM flags
, SCM mode
),
234 "Similar to @code{open} but returns a file descriptor instead of a\n"
236 #define FUNC_NAME s_scm_open_fdes
242 SCM_VALIDATE_STRING (1, path
);
243 SCM_STRING_COERCE_0TERMINATION_X (path
);
244 iflags
= SCM_NUM2LONG(2,flags
);
245 imode
= SCM_NUM2LONG_DEF(3,mode
,0666);
246 SCM_SYSCALL (fd
= open (SCM_STRING_CHARS (path
), iflags
, imode
));
249 return SCM_MAKINUM (fd
);
253 SCM_DEFINE (scm_open
, "open", 2, 1, 0,
254 (SCM path
, SCM flags
, SCM mode
),
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"
263 "Open the file read-only.\n"
266 "Open the file write-only. \n"
269 "Open the file read/write.\n"
272 "Append to the file instead of truncating.\n"
275 "Create the file if it does not already exist.\n"
277 "See the Unix documentation of the @code{open} system call\n"
278 "for additional flags.")
279 #define FUNC_NAME s_scm_open
286 fd
= SCM_INUM (scm_open_fdes (path
, flags
, mode
));
287 iflags
= SCM_NUM2LONG (2,flags
);
290 if (iflags
& O_APPEND
)
292 else if (iflags
& O_CREAT
)
298 if (iflags
& O_APPEND
)
300 else if (iflags
& O_WRONLY
)
305 newpt
= scm_fdes_to_port (fd
, port_mode
, path
);
310 SCM_DEFINE (scm_close
, "close", 1, 0, 0,
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.")
317 #define FUNC_NAME s_scm_close
322 fd_or_port
= SCM_COERCE_OUTPORT (fd_or_port
);
324 if (SCM_PORTP (fd_or_port
))
325 return scm_close_port (fd_or_port
);
326 SCM_VALIDATE_INUM (1,fd_or_port
);
327 fd
= SCM_INUM (fd_or_port
);
328 scm_evict_ports (fd
); /* see scsh manual. */
329 SCM_SYSCALL (rv
= close (fd
));
330 /* following scsh, closing an already closed file descriptor is
332 if (rv
< 0 && errno
!= EBADF
)
334 return SCM_NEGATE_BOOL(rv
< 0);
338 SCM_DEFINE (scm_close_fdes
, "close-fdes", 1, 0, 0,
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
350 SCM_VALIDATE_INUM_COPY (1, fd
, c_fd
);
351 SCM_SYSCALL (rv
= close (c_fd
));
354 return SCM_UNSPECIFIED
;
362 SCM_SYMBOL (scm_sym_regular
, "regular");
363 SCM_SYMBOL (scm_sym_directory
, "directory");
365 SCM_SYMBOL (scm_sym_symlink
, "symlink");
367 SCM_SYMBOL (scm_sym_block_special
, "block-special");
368 SCM_SYMBOL (scm_sym_char_special
, "char-special");
369 SCM_SYMBOL (scm_sym_fifo
, "fifo");
370 SCM_SYMBOL (scm_sym_sock
, "socket");
371 SCM_SYMBOL (scm_sym_unknown
, "unknown");
374 scm_stat2scm (struct stat
*stat_temp
)
376 SCM ans
= scm_c_make_vector (15, SCM_UNSPECIFIED
);
377 SCM
*ve
= SCM_VELTS (ans
);
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
);
386 ve
[6] = scm_ulong2num ((unsigned long) stat_temp
->st_rdev
);
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
);
397 ve
[11] = scm_ulong2num (4096L);
399 #ifdef HAVE_ST_BLOCKS
400 ve
[12] = scm_ulong2num ((unsigned long) stat_temp
->st_blocks
);
405 int mode
= stat_temp
->st_mode
;
408 ve
[13] = scm_sym_regular
;
409 else if (S_ISDIR (mode
))
410 ve
[13] = scm_sym_directory
;
412 else if (S_ISLNK (mode
))
413 ve
[13] = scm_sym_symlink
;
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
;
422 else if (S_ISSOCK (mode
))
423 ve
[13] = scm_sym_sock
;
426 ve
[13] = scm_sym_unknown
;
428 ve
[14] = SCM_MAKINUM ((~S_IFMT
) & mode
);
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:
435 if (S_ISUID & mode) tmp += 1;
437 if (S_IRGRP & mode) tmp += 1;
439 if (S_ISVTX & mode) tmp += 1;
441 if (S_IRUSR & mode) tmp += 1;
443 if (S_IWUSR & mode) tmp += 1;
445 if (S_IXUSR & mode) tmp += 1;
447 if (S_IWGRP & mode) tmp += 1;
449 if (S_IXGRP & mode) tmp += 1;
451 if (S_IROTH & mode) tmp += 1;
453 if (S_IWOTH & mode) tmp += 1;
455 if (S_IXOTH & mode) tmp += 1;
457 ve[14] = SCM_MAKINUM (tmp);
465 SCM_DEFINE (scm_stat
, "stat", 1, 0, 0,
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"
476 "The device containing the file.\n"
478 "The file serial number, which distinguishes this file from all other\n"
479 "files on the same device.\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"
485 "The number of hard links to the file.\n"
487 "The user ID of the file's owner.\n"
489 "The group ID of the file.\n"
491 "Device ID; this entry is defined only for character or block\n"
494 "The size of a regular file in bytes.\n"
496 "The last access time for the file.\n"
498 "The last modification time for the file.\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"
507 "In addition, the following procedures return the information\n"
508 "from stat:mode in a more convenient form:\n\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"
515 "An integer representing the access permission bits.\n"
517 #define FUNC_NAME s_scm_stat
521 struct stat stat_temp
;
523 if (SCM_INUMP (object
))
524 SCM_SYSCALL (rv
= fstat (SCM_INUM (object
), &stat_temp
));
527 SCM_VALIDATE_NIM (1,object
);
528 if (SCM_STRINGP (object
))
530 SCM_STRING_COERCE_0TERMINATION_X (object
);
531 SCM_SYSCALL (rv
= stat (SCM_STRING_CHARS (object
), &stat_temp
));
535 object
= SCM_COERCE_OUTPORT (object
);
536 SCM_VALIDATE_OPFPORT(1,object
);
537 fdes
= SCM_FPORT_FDES (object
);
538 SCM_SYSCALL (rv
= fstat (fdes
, &stat_temp
));
545 SCM_SYSERROR_MSG ("~A: ~S",
546 scm_listify (scm_makfrom0str (strerror (errno
)),
550 return scm_stat2scm (&stat_temp
);
555 /* {Modifying Directories}
558 SCM_DEFINE (scm_link
, "link", 2, 0, 0,
559 (SCM oldpath
, SCM newpath
),
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"
564 #define FUNC_NAME s_scm_link
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
);
572 SCM_SYSCALL (val
= link (SCM_STRING_CHARS (oldpath
),
573 SCM_STRING_CHARS (newpath
)));
576 return SCM_UNSPECIFIED
;
582 SCM_DEFINE (scm_rename
, "rename-file", 2, 0, 0,
583 (SCM oldname
, SCM newname
),
584 "Renames the file specified by @var{oldname} to @var{newname}.\n"
585 "The return value is unspecified.")
586 #define FUNC_NAME s_scm_rename
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
);
594 SCM_SYSCALL (rv
= rename (SCM_STRING_CHARS (oldname
), SCM_STRING_CHARS (newname
)));
596 SCM_SYSCALL (rv
= link (SCM_STRING_CHARS (oldname
), SCM_STRING_CHARS (newname
)));
599 SCM_SYSCALL (rv
= unlink (SCM_STRING_CHARS (oldname
)));;
601 /* unlink failed. remove new name */
602 SCM_SYSCALL (unlink (SCM_STRING_CHARS (newname
)));
607 return SCM_UNSPECIFIED
;
612 SCM_DEFINE (scm_delete_file
, "delete-file", 1, 0, 0,
614 "Deletes (or \"unlinks\") the file specified by @var{path}.")
615 #define FUNC_NAME s_scm_delete_file
618 SCM_VALIDATE_STRING (1, str
);
619 SCM_STRING_COERCE_0TERMINATION_X (str
);
620 SCM_SYSCALL (ans
= unlink (SCM_STRING_CHARS (str
)));
623 return SCM_UNSPECIFIED
;
628 SCM_DEFINE (scm_mkdir
, "mkdir", 1, 1, 0,
629 (SCM path
, SCM mode
),
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.")
634 #define FUNC_NAME s_scm_mkdir
638 SCM_VALIDATE_STRING (1, path
);
639 SCM_STRING_COERCE_0TERMINATION_X (path
);
640 if (SCM_UNBNDP (mode
))
644 SCM_SYSCALL (rv
= mkdir (SCM_STRING_CHARS (path
), 0777 ^ mask
));
648 SCM_VALIDATE_INUM (2,mode
);
649 SCM_SYSCALL (rv
= mkdir (SCM_STRING_CHARS (path
), SCM_INUM (mode
)));
653 return SCM_UNSPECIFIED
;
656 #endif /* HAVE_MKDIR */
659 SCM_DEFINE (scm_rmdir
, "rmdir", 1, 0, 0,
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.")
663 #define FUNC_NAME s_scm_rmdir
667 SCM_VALIDATE_STRING (1, path
);
668 SCM_STRING_COERCE_0TERMINATION_X (path
);
669 SCM_SYSCALL (val
= rmdir (SCM_STRING_CHARS (path
)));
672 return SCM_UNSPECIFIED
;
679 /* {Examining Directories}
682 scm_bits_t scm_tc16_dir
;
685 SCM_DEFINE (scm_directory_stream_p
, "directory-stream?", 1, 0, 0,
687 "Returns a boolean indicating whether @var{object} is a directory stream\n"
688 "as returned by @code{opendir}.")
689 #define FUNC_NAME s_scm_directory_stream_p
691 return SCM_BOOL (SCM_DIRP (obj
));
696 SCM_DEFINE (scm_opendir
, "opendir", 1, 0, 0,
698 "Open the directory specified by @var{path} and return a directory\n"
700 #define FUNC_NAME s_scm_opendir
703 SCM_VALIDATE_STRING (1, dirname
);
704 SCM_STRING_COERCE_0TERMINATION_X (dirname
);
705 SCM_SYSCALL (ds
= opendir (SCM_STRING_CHARS (dirname
)));
708 SCM_RETURN_NEWSMOB (scm_tc16_dir
| SCM_DIR_FLAG_OPEN
, ds
);
713 SCM_DEFINE (scm_readdir
, "readdir", 1, 0, 0,
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.")
718 #define FUNC_NAME s_scm_readdir
720 struct dirent
*rdent
;
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
));
727 SCM_SYSCALL (rdent
= readdir ((DIR *) SCM_CELL_WORD_1 (port
)));
731 return (rdent
? scm_makfromstr (rdent
->d_name
, NAMLEN (rdent
), 0)
737 SCM_DEFINE (scm_rewinddir
, "rewinddir", 1, 0, 0,
739 "Reset the directory port @var{stream} so that the next call to\n"
740 "@code{readdir} will return the first directory entry.")
741 #define FUNC_NAME s_scm_rewinddir
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
));
747 rewinddir ((DIR *) SCM_CELL_WORD_1 (port
));
749 return SCM_UNSPECIFIED
;
754 SCM_DEFINE (scm_closedir
, "closedir", 1, 0, 0,
756 "Close the directory stream @var{stream}.\n"
757 "The return value is unspecified.")
758 #define FUNC_NAME s_scm_closedir
760 SCM_VALIDATE_DIR (1, port
);
762 if (SCM_DIR_OPEN_P (port
))
766 SCM_SYSCALL (sts
= closedir ((DIR *) SCM_CELL_WORD_1 (port
)));
770 SCM_SET_CELL_WORD_0 (port
, scm_tc16_dir
);
773 return SCM_UNSPECIFIED
;
779 scm_dir_print (SCM exp
, SCM port
, scm_print_state
*pstate
)
781 scm_puts ("#<", port
);
782 if (!SCM_DIR_OPEN_P (exp
))
783 scm_puts ("closed: ", port
);
784 scm_puts ("directory stream ", port
);
785 scm_intprint (SCM_CELL_WORD_1 (exp
), 16, port
);
786 scm_putc ('>', port
);
794 if (SCM_DIR_OPEN_P (p
))
795 closedir ((DIR *) SCM_CELL_WORD_1 (p
));
800 /* {Navigating Directories}
804 SCM_DEFINE (scm_chdir
, "chdir", 1, 0, 0,
806 "Change the current working directory to @var{path}.\n"
807 "The return value is unspecified.")
808 #define FUNC_NAME s_scm_chdir
812 SCM_VALIDATE_STRING (1, str
);
813 SCM_STRING_COERCE_0TERMINATION_X (str
);
814 SCM_SYSCALL (ans
= chdir (SCM_STRING_CHARS (str
)));
817 return SCM_UNSPECIFIED
;
822 SCM_DEFINE (scm_getcwd
, "getcwd", 0, 0, 0,
824 "Returns the name of the current working directory.")
825 #define FUNC_NAME s_scm_getcwd
828 scm_sizet size
= 100;
832 wd
= scm_must_malloc (size
, FUNC_NAME
);
833 while ((rv
= getcwd (wd
, size
)) == 0 && errno
== ERANGE
)
837 wd
= scm_must_malloc (size
, FUNC_NAME
);
841 result
= scm_makfromstr (wd
, strlen (wd
), 0);
846 #endif /* HAVE_GETCWD */
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. */
858 set_element (SELECT_TYPE
*set
, SCM
*ports_ready
, SCM element
, int pos
)
862 if (SCM_INUMP (element
))
864 fd
= SCM_INUM (element
);
870 element
= SCM_COERCE_OUTPORT (element
);
871 SCM_ASSERT (SCM_OPFPORTP (element
), element
, pos
, "select");
874 /* check whether port has buffered input. */
875 scm_port
*pt
= SCM_PTAB_ENTRY (element
);
877 if (pt
->read_pos
< pt
->read_end
)
880 else if (pos
== SCM_ARG2
)
882 /* check whether port's output buffer has room. */
883 scm_port
*pt
= SCM_PTAB_ENTRY (element
);
885 /* > 1 since writing the last byte in the buffer causes flush. */
886 if (pt
->write_end
- pt
->write_pos
> 1)
889 fd
= use_buf
? -1 : SCM_FPORT_FDES (element
);
892 *ports_ready
= scm_cons (element
, *ports_ready
);
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. */
904 fill_select_type (SELECT_TYPE
*set
, SCM
*ports_ready
, SCM list_or_vec
, int pos
)
908 if (SCM_VECTORP (list_or_vec
))
910 int i
= SCM_VECTOR_LENGTH (list_or_vec
);
911 SCM
*ve
= SCM_VELTS (list_or_vec
);
915 int fd
= set_element (set
, ports_ready
, ve
[i
], pos
);
923 while (!SCM_NULLP (list_or_vec
))
925 int fd
= set_element (set
, ports_ready
, SCM_CAR (list_or_vec
), pos
);
929 list_or_vec
= SCM_CDR (list_or_vec
);
936 /* if element (a file descriptor or port) appears in *set, cons it to
937 list. return list. */
939 get_element (SELECT_TYPE
*set
, SCM element
, SCM list
)
943 if (SCM_INUMP (element
))
945 fd
= SCM_INUM (element
);
949 fd
= SCM_FPORT_FDES (SCM_COERCE_OUTPORT (element
));
951 if (FD_ISSET (fd
, set
))
952 list
= scm_cons (element
, list
);
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. */
965 retrieve_select_type (SELECT_TYPE
*set
, SCM ports_ready
, SCM list_or_vec
)
967 SCM answer_list
= ports_ready
;
969 if (SCM_VECTORP (list_or_vec
))
971 int i
= SCM_VECTOR_LENGTH (list_or_vec
);
972 SCM
*ve
= SCM_VELTS (list_or_vec
);
976 answer_list
= get_element (set
, ve
[i
], answer_list
);
978 return scm_vector (answer_list
);
982 /* list_or_vec must be a list. */
983 while (!SCM_NULLP (list_or_vec
))
985 answer_list
= get_element (set
, SCM_CAR (list_or_vec
), answer_list
);
986 list_or_vec
= SCM_CDR (list_or_vec
);
992 /* Static helper functions above refer to s_scm_select directly as s_select */
993 SCM_DEFINE (scm_select
, "select", 3, 2, 0,
994 (SCM reads
, SCM writes
, SCM excepts
, SCM secs
, SCM usecs
),
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"
1022 #define FUNC_NAME s_scm_select
1024 struct timeval timeout
;
1025 struct timeval
* time_ptr
;
1026 SELECT_TYPE read_set
;
1027 SELECT_TYPE write_set
;
1028 SELECT_TYPE except_set
;
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
;
1038 if (SCM_VECTORP (reads
))
1040 read_count
= SCM_VECTOR_LENGTH (reads
);
1044 read_count
= scm_ilength (reads
);
1045 SCM_ASSERT (read_count
>= 0, reads
, SCM_ARG1
, FUNC_NAME
);
1047 if (SCM_VECTORP (writes
))
1049 write_count
= SCM_VECTOR_LENGTH (writes
);
1053 write_count
= scm_ilength (writes
);
1054 SCM_ASSERT (write_count
>= 0, writes
, SCM_ARG2
, FUNC_NAME
);
1056 if (SCM_VECTORP (excepts
))
1058 except_count
= SCM_VECTOR_LENGTH (excepts
);
1062 except_count
= scm_ilength (excepts
);
1063 SCM_ASSERT (except_count
>= 0, excepts
, SCM_ARG3
, FUNC_NAME
);
1066 FD_ZERO (&read_set
);
1067 FD_ZERO (&write_set
);
1068 FD_ZERO (&except_set
);
1070 max_fd
= fill_select_type (&read_set
, &read_ports_ready
, reads
, SCM_ARG1
);
1073 int write_max
= fill_select_type (&write_set
, &write_ports_ready
,
1075 int except_max
= fill_select_type (&except_set
, NULL
,
1078 if (write_max
> max_fd
)
1080 if (except_max
> max_fd
)
1081 max_fd
= except_max
;
1084 /* if there's a port with a ready buffer, don't block, just
1085 check for ready file descriptors. */
1086 if (!SCM_NULLP (read_ports_ready
) || !SCM_NULLP (write_ports_ready
))
1089 timeout
.tv_usec
= 0;
1090 time_ptr
= &timeout
;
1092 else if (SCM_UNBNDP (secs
) || SCM_FALSEP (secs
))
1096 if (SCM_INUMP (secs
))
1098 timeout
.tv_sec
= SCM_INUM (secs
);
1099 if (SCM_UNBNDP (usecs
))
1100 timeout
.tv_usec
= 0;
1103 SCM_VALIDATE_INUM (5,usecs
);
1104 timeout
.tv_usec
= SCM_INUM (usecs
);
1109 double fl
= scm_num2dbl (secs
, FUNC_NAME
);
1111 if (!SCM_UNBNDP (usecs
))
1112 SCM_WRONG_TYPE_ARG (4, secs
);
1114 SCM_OUT_OF_RANGE (4, secs
);
1115 timeout
.tv_sec
= (long) fl
;
1116 timeout
.tv_usec
= (long) ((fl
- timeout
.tv_sec
) * 1000000);
1118 time_ptr
= &timeout
;
1122 #ifdef GUILE_ISELECT
1123 int rv
= scm_internal_select (max_fd
+ 1,
1124 &read_set
, &write_set
, &except_set
,
1127 int rv
= select (max_fd
+ 1,
1128 &read_set
, &write_set
, &except_set
, time_ptr
);
1133 return scm_listify (retrieve_select_type (&read_set
, read_ports_ready
,
1135 retrieve_select_type (&write_set
, write_ports_ready
,
1137 retrieve_select_type (&except_set
, SCM_EOL
, excepts
),
1141 #endif /* HAVE_SELECT */
1145 SCM_DEFINE (scm_fcntl
, "fcntl", 2, 1, 0,
1146 (SCM object
, SCM cmd
, SCM value
),
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"
1153 "Duplicate a file descriptor\n"
1155 "Get flags associated with the file descriptor.\n"
1157 "Set flags associated with the file descriptor to @var{value}.\n"
1159 "Get flags associated with the open file.\n"
1161 "Set flags associated with the open file to @var{value}\n"
1163 "Get the process ID of a socket's owner, for @code{SIGIO} signals.\n"
1165 "Set the process that owns a socket to @var{value}, for @code{SIGIO} signals.\n"
1166 "@item FD_CLOEXEC\n"
1167 "The value used to indicate the \"close on exec\" flag with @code{F_GETFL} or\n"
1170 #define FUNC_NAME s_scm_fcntl
1176 object
= SCM_COERCE_OUTPORT (object
);
1178 SCM_VALIDATE_INUM (2,cmd
);
1179 if (SCM_OPFPORTP (object
))
1180 fdes
= SCM_FPORT_FDES (object
);
1183 SCM_VALIDATE_INUM (1,object
);
1184 fdes
= SCM_INUM (object
);
1187 if (SCM_UNBNDP (value
)) {
1190 SCM_VALIDATE_INUM_COPY (SCM_ARG3
, value
, ivalue
);
1193 SCM_SYSCALL (rv
= fcntl (fdes
, SCM_INUM (cmd
), ivalue
));
1196 return SCM_MAKINUM (rv
);
1200 SCM_DEFINE (scm_fsync
, "fsync", 1, 0, 0,
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.")
1206 #define FUNC_NAME s_scm_fsync
1210 object
= SCM_COERCE_OUTPORT (object
);
1212 if (SCM_OPFPORTP (object
))
1215 fdes
= SCM_FPORT_FDES (object
);
1219 SCM_VALIDATE_INUM (1,object
);
1220 fdes
= SCM_INUM (object
);
1222 if (fsync (fdes
) == -1)
1224 return SCM_UNSPECIFIED
;
1229 SCM_DEFINE (scm_symlink
, "symlink", 2, 0, 0,
1230 (SCM oldpath
, SCM newpath
),
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.")
1233 #define FUNC_NAME s_scm_symlink
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
)));
1244 return SCM_UNSPECIFIED
;
1247 #endif /* HAVE_SYMLINK */
1249 #ifdef HAVE_READLINK
1250 SCM_DEFINE (scm_readlink
, "readlink", 1, 0, 0,
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.")
1255 #define FUNC_NAME s_scm_readlink
1261 SCM_VALIDATE_STRING (1, path
);
1262 SCM_STRING_COERCE_0TERMINATION_X (path
);
1263 buf
= scm_must_malloc (size
, FUNC_NAME
);
1264 while ((rv
= readlink (SCM_STRING_CHARS (path
), buf
, size
)) == size
)
1266 scm_must_free (buf
);
1268 buf
= scm_must_malloc (size
, FUNC_NAME
);
1272 result
= scm_makfromstr (buf
, rv
, 0);
1273 scm_must_free (buf
);
1277 #endif /* HAVE_READLINK */
1280 SCM_DEFINE (scm_lstat
, "lstat", 1, 0, 0,
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.")
1285 #define FUNC_NAME s_scm_lstat
1288 struct stat stat_temp
;
1290 SCM_VALIDATE_STRING (1, str
);
1291 SCM_STRING_COERCE_0TERMINATION_X (str
);
1292 SCM_SYSCALL (rv
= lstat (SCM_STRING_CHARS (str
), &stat_temp
));
1297 SCM_SYSERROR_MSG ("~A: ~S",
1298 scm_listify (scm_makfrom0str (strerror (errno
)),
1300 SCM_UNDEFINED
), en
);
1302 return scm_stat2scm(&stat_temp
);
1305 #endif /* HAVE_LSTAT */
1307 SCM_DEFINE (scm_copy_file
, "copy-file", 2, 0, 0,
1308 (SCM oldfile
, SCM newfile
),
1309 "Copy the file specified by @var{path-from} to @var{path-to}.\n"
1310 "The return value is unspecified.")
1311 #define FUNC_NAME s_scm_copy_file
1316 struct stat oldstat
;
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)
1324 oldfd
= open (SCM_STRING_CHARS (oldfile
), O_RDONLY
);
1328 /* use POSIX flags instead of 07777?. */
1329 newfd
= open (SCM_STRING_CHARS (newfile
), O_WRONLY
| O_CREAT
| O_TRUNC
,
1330 oldstat
.st_mode
& 07777);
1334 while ((n
= read (oldfd
, buf
, sizeof buf
)) > 0)
1335 if (write (newfd
, buf
, n
) != n
)
1342 if (close (newfd
) == -1)
1344 return SCM_UNSPECIFIED
;
1349 /* Filename manipulation */
1353 SCM_DEFINE (scm_dirname
, "dirname", 1, 0, 0,
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.")
1358 #define FUNC_NAME s_scm_dirname
1362 unsigned long int len
;
1364 SCM_VALIDATE_STRING (1,filename
);
1366 s
= SCM_STRING_CHARS (filename
);
1367 len
= SCM_STRING_LENGTH (filename
);
1370 while (i
>= 0 && s
[i
] == '/') --i
;
1371 while (i
>= 0 && s
[i
] != '/') --i
;
1372 while (i
>= 0 && s
[i
] == '/') --i
;
1375 if (len
> 0 && s
[0] == '/')
1376 return scm_substring (filename
, SCM_INUM0
, SCM_MAKINUM (1));
1378 return scm_dot_string
;
1381 return scm_substring (filename
, SCM_INUM0
, SCM_MAKINUM (i
+ 1));
1385 SCM_DEFINE (scm_basename
, "basename", 1, 1, 0,
1386 (SCM filename
, SCM suffix
),
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.")
1391 #define FUNC_NAME s_scm_basename
1396 SCM_VALIDATE_STRING (1,filename
);
1397 f
= SCM_STRING_CHARS (filename
);
1398 len
= SCM_STRING_LENGTH (filename
);
1400 if (SCM_UNBNDP (suffix
))
1404 SCM_VALIDATE_STRING (2, suffix
);
1405 s
= SCM_STRING_CHARS (suffix
);
1406 j
= SCM_STRING_LENGTH (suffix
) - 1;
1409 while (i
>= 0 && f
[i
] == '/') --i
;
1411 while (i
>= 0 && j
>= 0 && f
[i
] == s
[j
]) --i
, --j
;
1414 while (i
>= 0 && f
[i
] != '/') --i
;
1417 if (len
> 0 && f
[0] == '/')
1418 return scm_substring (filename
, SCM_INUM0
, SCM_MAKINUM (1));
1420 return scm_dot_string
;
1423 return scm_substring (filename
, SCM_MAKINUM (i
+ 1), SCM_MAKINUM (end
+ 1));
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
);
1438 scm_dot_string
= scm_permanent_object (scm_makfrom0str ("."));
1441 scm_sysintern ("O_RDONLY", scm_long2num (O_RDONLY
));
1444 scm_sysintern ("O_WRONLY", scm_long2num (O_WRONLY
));
1447 scm_sysintern ("O_RDWR", scm_long2num (O_RDWR
));
1450 scm_sysintern ("O_CREAT", scm_long2num (O_CREAT
));
1453 scm_sysintern ("O_EXCL", scm_long2num (O_EXCL
));
1456 scm_sysintern ("O_NOCTTY", scm_long2num (O_NOCTTY
));
1459 scm_sysintern ("O_TRUNC", scm_long2num (O_TRUNC
));
1462 scm_sysintern ("O_APPEND", scm_long2num (O_APPEND
));
1465 scm_sysintern ("O_NONBLOCK", scm_long2num (O_NONBLOCK
));
1468 scm_sysintern ("O_NDELAY", scm_long2num (O_NDELAY
));
1471 scm_sysintern ("O_SYNC", scm_long2num (O_SYNC
));
1475 scm_sysintern ("F_DUPFD", scm_long2num (F_DUPFD
));
1478 scm_sysintern ("F_GETFD", scm_long2num (F_GETFD
));
1481 scm_sysintern ("F_SETFD", scm_long2num (F_SETFD
));
1484 scm_sysintern ("F_GETFL", scm_long2num (F_GETFL
));
1487 scm_sysintern ("F_SETFL", scm_long2num (F_SETFL
));
1490 scm_sysintern ("F_GETOWN", scm_long2num (F_GETOWN
));
1493 scm_sysintern ("F_SETOWN", scm_long2num (F_SETOWN
));
1496 scm_sysintern ("FD_CLOEXEC", scm_long2num (FD_CLOEXEC
));
1499 #ifndef SCM_MAGIC_SNARFER
1500 #include "libguile/filesys.x"