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. */
42 /* Software engineering face-lift by Greg J. Badros, 11-Dec-1999,
43 gjb@cs.washington.edu, http://www.cs.washington.edu/homes/gjb */
49 #include "libguile/_scm.h"
50 #include "libguile/smob.h"
51 #include "libguile/feature.h"
52 #include "libguile/fports.h"
53 #include "libguile/iselect.h"
54 #include "libguile/strings.h"
55 #include "libguile/vectors.h"
57 #include "libguile/validate.h"
58 #include "libguile/filesys.h"
65 #ifdef TIME_WITH_SYS_TIME
66 # include <sys/time.h>
70 # include <sys/time.h>
80 #ifdef LIBC_H_WITH_UNISTD_H
84 #ifdef HAVE_SYS_SELECT_H
85 #include <sys/select.h>
92 #include <sys/types.h>
101 # define NAMLEN(dirent) strlen((dirent)->d_name)
103 # define dirent direct
104 # define NAMLEN(dirent) (dirent)->d_namlen
106 # include <sys/ndir.h>
109 # include <sys/dir.h>
116 /* Ultrix has S_IFSOCK, but no S_ISSOCK. Ipe! */
117 #if defined (S_IFSOCK) && ! defined (S_ISSOCK)
118 #define S_ISSOCK(mode) (((mode) & S_IFMT) == S_IFSOCK)
128 SCM_DEFINE (scm_chown
, "chown", 3, 0, 0,
129 (SCM object
, SCM owner
, SCM group
),
130 "Change the ownership and group of the file referred to by @var{object} to\n"
131 "the integer values @var{owner} and @var{group}. @var{object} can be\n"
132 "a string containing a file name or, if the platform\n"
133 "supports fchown, a port or integer file descriptor\n"
134 "which is open on the file. The return value\n"
135 "is unspecified.\n\n"
136 "If @var{object} is a symbolic link, either the\n"
137 "ownership of the link or the ownership of the referenced file will be\n"
138 "changed depending on the operating system (lchown is\n"
139 "unsupported at present). If @var{owner} or @var{group} is specified\n"
140 "as @code{-1}, then that ID is not changed.")
141 #define FUNC_NAME s_scm_chown
145 object
= SCM_COERCE_OUTPORT (object
);
147 SCM_VALIDATE_INUM (2,owner
);
148 SCM_VALIDATE_INUM (3,group
);
150 if (SCM_INUMP (object
) || (SCM_OPFPORTP (object
)))
152 int fdes
= SCM_INUMP (object
) ? SCM_INUM (object
)
153 : SCM_FPORT_FDES (object
);
155 SCM_SYSCALL (rv
= fchown (fdes
, SCM_INUM (owner
), SCM_INUM (group
)));
160 SCM_VALIDATE_STRING (1, object
);
161 SCM_STRING_COERCE_0TERMINATION_X (object
);
162 SCM_SYSCALL (rv
= chown (SCM_STRING_CHARS (object
),
163 SCM_INUM (owner
), SCM_INUM (group
)));
167 return SCM_UNSPECIFIED
;
172 SCM_DEFINE (scm_chmod
, "chmod", 2, 0, 0,
173 (SCM object
, SCM mode
),
174 "Changes the permissions of the file referred to by @var{obj}.\n"
175 "@var{obj} can be a string containing a file name or a port or integer file\n"
176 "descriptor which is open on a file (in which case @code{fchmod} is used\n"
177 "as the underlying system call).\n"
178 "@var{mode} specifies\n"
179 "the new permissions as a decimal number, e.g., @code{(chmod \"foo\" #o755)}.\n"
180 "The return value is unspecified.")
181 #define FUNC_NAME s_scm_chmod
186 object
= SCM_COERCE_OUTPORT (object
);
188 SCM_VALIDATE_INUM (2,mode
);
189 if (SCM_INUMP (object
) || SCM_OPFPORTP (object
))
191 if (SCM_INUMP (object
))
192 fdes
= SCM_INUM (object
);
194 fdes
= SCM_FPORT_FDES (object
);
195 SCM_SYSCALL (rv
= fchmod (fdes
, SCM_INUM (mode
)));
199 SCM_VALIDATE_STRING (1, object
);
200 SCM_STRING_COERCE_0TERMINATION_X (object
);
201 SCM_SYSCALL (rv
= chmod (SCM_STRING_CHARS (object
), SCM_INUM (mode
)));
205 return SCM_UNSPECIFIED
;
209 SCM_DEFINE (scm_umask
, "umask", 0, 1, 0,
211 "If @var{mode} is omitted, retuns a decimal number representing the current\n"
212 "file creation mask. Otherwise the file creation mask is set to\n"
213 "@var{mode} and the previous value is returned.\n\n"
214 "E.g., @code{(umask #o022)} sets the mask to octal 22, decimal 18.")
215 #define FUNC_NAME s_scm_umask
218 if (SCM_UNBNDP (mode
))
225 SCM_VALIDATE_INUM (1,mode
);
226 mask
= umask (SCM_INUM (mode
));
228 return SCM_MAKINUM (mask
);
234 SCM_DEFINE (scm_open_fdes
, "open-fdes", 2, 1, 0,
235 (SCM path
, SCM flags
, SCM mode
),
236 "Similar to @code{open} but return a file descriptor instead of\n"
238 #define FUNC_NAME s_scm_open_fdes
244 SCM_VALIDATE_STRING (1, path
);
245 SCM_STRING_COERCE_0TERMINATION_X (path
);
246 iflags
= SCM_NUM2LONG (2, flags
);
247 imode
= SCM_NUM2LONG_DEF (3, mode
, 0666);
248 SCM_SYSCALL (fd
= open (SCM_STRING_CHARS (path
), iflags
, imode
));
251 return SCM_MAKINUM (fd
);
255 SCM_DEFINE (scm_open
, "open", 2, 1, 0,
256 (SCM path
, SCM flags
, SCM mode
),
257 "Open the file named by @var{path} for reading and/or writing.\n"
258 "@var{flags} is an integer specifying how the file should be opened.\n"
259 "@var{mode} is an integer specifying the permission bits of the file, if\n"
260 "it needs to be created, before the umask is applied. The default is 666\n"
261 "(Unix itself has no default).\n\n"
262 "@var{flags} can be constructed by combining variables using @code{logior}.\n"
263 "Basic flags are:\n\n"
265 "Open the file read-only.\n"
268 "Open the file write-only. \n"
271 "Open the file read/write.\n"
274 "Append to the file instead of truncating.\n"
277 "Create the file if it does not already exist.\n"
279 "See the Unix documentation of the @code{open} system call\n"
280 "for additional flags.")
281 #define FUNC_NAME s_scm_open
288 fd
= SCM_INUM (scm_open_fdes (path
, flags
, mode
));
289 iflags
= SCM_NUM2LONG (2, flags
);
292 if (iflags
& O_APPEND
)
294 else if (iflags
& O_CREAT
)
300 if (iflags
& O_APPEND
)
302 else if (iflags
& O_WRONLY
)
307 newpt
= scm_fdes_to_port (fd
, port_mode
, path
);
312 SCM_DEFINE (scm_close
, "close", 1, 0, 0,
314 "Similar to close-port (@pxref{Generic Port Operations, close-port}),\n"
315 "but also works on file descriptors. A side\n"
316 "effect of closing a file descriptor is that any ports using that file\n"
317 "descriptor are moved to a different file descriptor and have\n"
318 "their revealed counts set to zero.")
319 #define FUNC_NAME s_scm_close
324 fd_or_port
= SCM_COERCE_OUTPORT (fd_or_port
);
326 if (SCM_PORTP (fd_or_port
))
327 return scm_close_port (fd_or_port
);
328 SCM_VALIDATE_INUM (1,fd_or_port
);
329 fd
= SCM_INUM (fd_or_port
);
330 scm_evict_ports (fd
); /* see scsh manual. */
331 SCM_SYSCALL (rv
= close (fd
));
332 /* following scsh, closing an already closed file descriptor is
334 if (rv
< 0 && errno
!= EBADF
)
336 return SCM_NEGATE_BOOL(rv
< 0);
340 SCM_DEFINE (scm_close_fdes
, "close-fdes", 1, 0, 0,
342 "A simple wrapper for the @code{close} system call.\n"
343 "Close file descriptor @var{fd}, which must be an integer.\n"
344 "Unlike close (@pxref{Ports and File Descriptors, close}),\n"
345 "the file descriptor will be closed even if a port is using it.\n"
346 "The return value is unspecified.")
347 #define FUNC_NAME s_scm_close_fdes
352 SCM_VALIDATE_INUM_COPY (1, fd
, c_fd
);
353 SCM_SYSCALL (rv
= close (c_fd
));
356 return SCM_UNSPECIFIED
;
364 SCM_SYMBOL (scm_sym_regular
, "regular");
365 SCM_SYMBOL (scm_sym_directory
, "directory");
367 SCM_SYMBOL (scm_sym_symlink
, "symlink");
369 SCM_SYMBOL (scm_sym_block_special
, "block-special");
370 SCM_SYMBOL (scm_sym_char_special
, "char-special");
371 SCM_SYMBOL (scm_sym_fifo
, "fifo");
372 SCM_SYMBOL (scm_sym_sock
, "socket");
373 SCM_SYMBOL (scm_sym_unknown
, "unknown");
376 scm_stat2scm (struct stat
*stat_temp
)
378 SCM ans
= scm_c_make_vector (15, SCM_UNSPECIFIED
);
379 SCM
*ve
= SCM_VELTS (ans
);
381 ve
[0] = scm_ulong2num ((unsigned long) stat_temp
->st_dev
);
382 ve
[1] = scm_ulong2num ((unsigned long) stat_temp
->st_ino
);
383 ve
[2] = scm_ulong2num ((unsigned long) stat_temp
->st_mode
);
384 ve
[3] = scm_ulong2num ((unsigned long) stat_temp
->st_nlink
);
385 ve
[4] = scm_ulong2num ((unsigned long) stat_temp
->st_uid
);
386 ve
[5] = scm_ulong2num ((unsigned long) stat_temp
->st_gid
);
388 ve
[6] = scm_ulong2num ((unsigned long) stat_temp
->st_rdev
);
392 ve
[7] = scm_ulong2num ((unsigned long) stat_temp
->st_size
);
393 ve
[8] = scm_ulong2num ((unsigned long) stat_temp
->st_atime
);
394 ve
[9] = scm_ulong2num ((unsigned long) stat_temp
->st_mtime
);
395 ve
[10] = scm_ulong2num ((unsigned long) stat_temp
->st_ctime
);
396 #ifdef HAVE_ST_BLKSIZE
397 ve
[11] = scm_ulong2num ((unsigned long) stat_temp
->st_blksize
);
399 ve
[11] = scm_ulong2num (4096L);
401 #ifdef HAVE_ST_BLOCKS
402 ve
[12] = scm_ulong2num ((unsigned long) stat_temp
->st_blocks
);
407 int mode
= stat_temp
->st_mode
;
410 ve
[13] = scm_sym_regular
;
411 else if (S_ISDIR (mode
))
412 ve
[13] = scm_sym_directory
;
414 else if (S_ISLNK (mode
))
415 ve
[13] = scm_sym_symlink
;
417 else if (S_ISBLK (mode
))
418 ve
[13] = scm_sym_block_special
;
419 else if (S_ISCHR (mode
))
420 ve
[13] = scm_sym_char_special
;
421 else if (S_ISFIFO (mode
))
422 ve
[13] = scm_sym_fifo
;
424 else if (S_ISSOCK (mode
))
425 ve
[13] = scm_sym_sock
;
428 ve
[13] = scm_sym_unknown
;
430 ve
[14] = SCM_MAKINUM ((~S_IFMT
) & mode
);
432 /* the layout of the bits in ve[14] is intended to be portable.
433 If there are systems that don't follow the usual convention,
434 the following could be used:
437 if (S_ISUID & mode) tmp += 1;
439 if (S_IRGRP & mode) tmp += 1;
441 if (S_ISVTX & mode) tmp += 1;
443 if (S_IRUSR & mode) tmp += 1;
445 if (S_IWUSR & mode) tmp += 1;
447 if (S_IXUSR & mode) tmp += 1;
449 if (S_IWGRP & mode) tmp += 1;
451 if (S_IXGRP & mode) tmp += 1;
453 if (S_IROTH & mode) tmp += 1;
455 if (S_IWOTH & mode) tmp += 1;
457 if (S_IXOTH & mode) tmp += 1;
459 ve[14] = SCM_MAKINUM (tmp);
467 SCM_DEFINE (scm_stat
, "stat", 1, 0, 0,
469 "Return an object containing various information about the file\n"
470 "determined by @var{obj}. @var{obj} can be a string containing\n"
471 "a file name or a port or integer file descriptor which is open\n"
472 "on a file (in which case @code{fstat} is used as the underlying\n"
475 "The object returned by @code{stat} can be passed as a single\n"
476 "parameter to the following procedures, all of which return\n"
481 "The device containing the file.\n"
483 "The file serial number, which distinguishes this file from all\n"
484 "other files on the same device.\n"
486 "The mode of the file. This includes file type information and\n"
487 "the file permission bits. See @code{stat:type} and\n"
488 "@code{stat:perms} below.\n"
490 "The number of hard links to the file.\n"
492 "The user ID of the file's owner.\n"
494 "The group ID of the file.\n"
496 "Device ID; this entry is defined only for character or block\n"
499 "The size of a regular file in bytes.\n"
501 "The last access time for the file.\n"
503 "The last modification time for the file.\n"
505 "The last modification time for the attributes of the file.\n"
506 "@item stat:blksize\n"
507 "The optimal block size for reading or writing the file, in\n"
509 "@item stat:blocks\n"
510 "The amount of disk space that the file occupies measured in\n"
511 "units of 512 byte blocks.\n"
514 "In addition, the following procedures return the information\n"
515 "from stat:mode in a more convenient form:\n"
519 "A symbol representing the type of file. Possible values are\n"
520 "regular, directory, symlink, block-special, char-special, fifo,\n"
521 "socket and unknown\n"
523 "An integer representing the access permission bits.\n"
525 #define FUNC_NAME s_scm_stat
529 struct stat stat_temp
;
531 if (SCM_INUMP (object
))
532 SCM_SYSCALL (rv
= fstat (SCM_INUM (object
), &stat_temp
));
535 SCM_VALIDATE_NIM (1,object
);
536 if (SCM_STRINGP (object
))
538 SCM_STRING_COERCE_0TERMINATION_X (object
);
539 SCM_SYSCALL (rv
= stat (SCM_STRING_CHARS (object
), &stat_temp
));
543 object
= SCM_COERCE_OUTPORT (object
);
544 SCM_VALIDATE_OPFPORT(1,object
);
545 fdes
= SCM_FPORT_FDES (object
);
546 SCM_SYSCALL (rv
= fstat (fdes
, &stat_temp
));
553 SCM_SYSERROR_MSG ("~A: ~S",
554 SCM_LIST2 (scm_makfrom0str (strerror (errno
)), object
),
557 return scm_stat2scm (&stat_temp
);
562 /* {Modifying Directories}
565 SCM_DEFINE (scm_link
, "link", 2, 0, 0,
566 (SCM oldpath
, SCM newpath
),
567 "Creates a new name @var{newpath} in the file system for the\n"
568 "file named by @var{oldpath}. If @var{oldpath} is a symbolic\n"
569 "link, the link may or may not be followed depending on the\n"
571 #define FUNC_NAME s_scm_link
575 SCM_VALIDATE_STRING (1, oldpath
);
576 SCM_STRING_COERCE_0TERMINATION_X (oldpath
);
577 SCM_VALIDATE_STRING (2, newpath
);
578 SCM_STRING_COERCE_0TERMINATION_X (newpath
);
579 SCM_SYSCALL (val
= link (SCM_STRING_CHARS (oldpath
),
580 SCM_STRING_CHARS (newpath
)));
583 return SCM_UNSPECIFIED
;
589 SCM_DEFINE (scm_rename
, "rename-file", 2, 0, 0,
590 (SCM oldname
, SCM newname
),
591 "Renames the file specified by @var{oldname} to @var{newname}.\n"
592 "The return value is unspecified.")
593 #define FUNC_NAME s_scm_rename
596 SCM_VALIDATE_STRING (1, oldname
);
597 SCM_VALIDATE_STRING (2, newname
);
598 SCM_STRING_COERCE_0TERMINATION_X (oldname
);
599 SCM_STRING_COERCE_0TERMINATION_X (newname
);
601 SCM_SYSCALL (rv
= rename (SCM_STRING_CHARS (oldname
), SCM_STRING_CHARS (newname
)));
603 SCM_SYSCALL (rv
= link (SCM_STRING_CHARS (oldname
), SCM_STRING_CHARS (newname
)));
606 SCM_SYSCALL (rv
= unlink (SCM_STRING_CHARS (oldname
)));;
608 /* unlink failed. remove new name */
609 SCM_SYSCALL (unlink (SCM_STRING_CHARS (newname
)));
614 return SCM_UNSPECIFIED
;
619 SCM_DEFINE (scm_delete_file
, "delete-file", 1, 0, 0,
621 "Deletes (or \"unlinks\") the file specified by @var{path}.")
622 #define FUNC_NAME s_scm_delete_file
625 SCM_VALIDATE_STRING (1, str
);
626 SCM_STRING_COERCE_0TERMINATION_X (str
);
627 SCM_SYSCALL (ans
= unlink (SCM_STRING_CHARS (str
)));
630 return SCM_UNSPECIFIED
;
635 SCM_DEFINE (scm_mkdir
, "mkdir", 1, 1, 0,
636 (SCM path
, SCM mode
),
637 "Create a new directory named by @var{path}. If @var{mode} is omitted\n"
638 "then the permissions of the directory file are set using the current\n"
639 "umask. Otherwise they are set to the decimal value specified with\n"
640 "@var{mode}. The return value is unspecified.")
641 #define FUNC_NAME s_scm_mkdir
645 SCM_VALIDATE_STRING (1, path
);
646 SCM_STRING_COERCE_0TERMINATION_X (path
);
647 if (SCM_UNBNDP (mode
))
651 SCM_SYSCALL (rv
= mkdir (SCM_STRING_CHARS (path
), 0777 ^ mask
));
655 SCM_VALIDATE_INUM (2,mode
);
656 SCM_SYSCALL (rv
= mkdir (SCM_STRING_CHARS (path
), SCM_INUM (mode
)));
660 return SCM_UNSPECIFIED
;
663 #endif /* HAVE_MKDIR */
666 SCM_DEFINE (scm_rmdir
, "rmdir", 1, 0, 0,
668 "Remove the existing directory named by @var{path}. The directory must\n"
669 "be empty for this to succeed. The return value is unspecified.")
670 #define FUNC_NAME s_scm_rmdir
674 SCM_VALIDATE_STRING (1, path
);
675 SCM_STRING_COERCE_0TERMINATION_X (path
);
676 SCM_SYSCALL (val
= rmdir (SCM_STRING_CHARS (path
)));
679 return SCM_UNSPECIFIED
;
686 /* {Examining Directories}
689 scm_bits_t scm_tc16_dir
;
692 SCM_DEFINE (scm_directory_stream_p
, "directory-stream?", 1, 0, 0,
694 "Return a boolean indicating whether @var{object} is a directory\n"
695 "stream as returned by @code{opendir}.")
696 #define FUNC_NAME s_scm_directory_stream_p
698 return SCM_BOOL (SCM_DIRP (obj
));
703 SCM_DEFINE (scm_opendir
, "opendir", 1, 0, 0,
705 "Open the directory specified by @var{path} and return a directory\n"
707 #define FUNC_NAME s_scm_opendir
710 SCM_VALIDATE_STRING (1, dirname
);
711 SCM_STRING_COERCE_0TERMINATION_X (dirname
);
712 SCM_SYSCALL (ds
= opendir (SCM_STRING_CHARS (dirname
)));
715 SCM_RETURN_NEWSMOB (scm_tc16_dir
| SCM_DIR_FLAG_OPEN
, ds
);
720 SCM_DEFINE (scm_readdir
, "readdir", 1, 0, 0,
722 "Return (as a string) the next directory entry from the directory stream\n"
723 "@var{stream}. If there is no remaining entry to be read then the\n"
724 "end of file object is returned.")
725 #define FUNC_NAME s_scm_readdir
727 struct dirent
*rdent
;
729 SCM_VALIDATE_DIR (1, port
);
730 if (!SCM_DIR_OPEN_P (port
))
731 SCM_MISC_ERROR ("Directory ~S is not open.", SCM_LIST1 (port
));
734 SCM_SYSCALL (rdent
= readdir ((DIR *) SCM_CELL_WORD_1 (port
)));
738 return (rdent
? scm_makfromstr (rdent
->d_name
, NAMLEN (rdent
), 0)
744 SCM_DEFINE (scm_rewinddir
, "rewinddir", 1, 0, 0,
746 "Reset the directory port @var{stream} so that the next call to\n"
747 "@code{readdir} will return the first directory entry.")
748 #define FUNC_NAME s_scm_rewinddir
750 SCM_VALIDATE_DIR (1, port
);
751 if (!SCM_DIR_OPEN_P (port
))
752 SCM_MISC_ERROR ("Directory ~S is not open.", SCM_LIST1 (port
));
754 rewinddir ((DIR *) SCM_CELL_WORD_1 (port
));
756 return SCM_UNSPECIFIED
;
761 SCM_DEFINE (scm_closedir
, "closedir", 1, 0, 0,
763 "Close the directory stream @var{stream}.\n"
764 "The return value is unspecified.")
765 #define FUNC_NAME s_scm_closedir
767 SCM_VALIDATE_DIR (1, port
);
769 if (SCM_DIR_OPEN_P (port
))
773 SCM_SYSCALL (sts
= closedir ((DIR *) SCM_CELL_WORD_1 (port
)));
777 SCM_SET_CELL_WORD_0 (port
, scm_tc16_dir
);
780 return SCM_UNSPECIFIED
;
786 scm_dir_print (SCM exp
, SCM port
, scm_print_state
*pstate
)
788 scm_puts ("#<", port
);
789 if (!SCM_DIR_OPEN_P (exp
))
790 scm_puts ("closed: ", port
);
791 scm_puts ("directory stream ", port
);
792 scm_intprint (SCM_CELL_WORD_1 (exp
), 16, port
);
793 scm_putc ('>', port
);
801 if (SCM_DIR_OPEN_P (p
))
802 closedir ((DIR *) SCM_CELL_WORD_1 (p
));
807 /* {Navigating Directories}
811 SCM_DEFINE (scm_chdir
, "chdir", 1, 0, 0,
813 "Change the current working directory to @var{path}.\n"
814 "The return value is unspecified.")
815 #define FUNC_NAME s_scm_chdir
819 SCM_VALIDATE_STRING (1, str
);
820 SCM_STRING_COERCE_0TERMINATION_X (str
);
821 SCM_SYSCALL (ans
= chdir (SCM_STRING_CHARS (str
)));
824 return SCM_UNSPECIFIED
;
829 SCM_DEFINE (scm_getcwd
, "getcwd", 0, 0, 0,
831 "Return the name of the current working directory.")
832 #define FUNC_NAME s_scm_getcwd
835 scm_sizet size
= 100;
839 wd
= scm_must_malloc (size
, FUNC_NAME
);
840 while ((rv
= getcwd (wd
, size
)) == 0 && errno
== ERANGE
)
844 wd
= scm_must_malloc (size
, FUNC_NAME
);
848 result
= scm_makfromstr (wd
, strlen (wd
), 0);
853 #endif /* HAVE_GETCWD */
859 /* check that element is a port or file descriptor. if it's a port
860 and its buffer is ready for use, add it to the ports_ready list.
861 otherwise add its file descriptor to *set. the type of list can be
862 determined from pos: SCM_ARG1 for reads, SCM_ARG2 for writes,
863 SCM_ARG3 for excepts. */
865 set_element (SELECT_TYPE
*set
, SCM
*ports_ready
, SCM element
, int pos
)
869 if (SCM_INUMP (element
))
871 fd
= SCM_INUM (element
);
877 element
= SCM_COERCE_OUTPORT (element
);
878 SCM_ASSERT (SCM_OPFPORTP (element
), element
, pos
, "select");
881 /* check whether port has buffered input. */
882 scm_port
*pt
= SCM_PTAB_ENTRY (element
);
884 if (pt
->read_pos
< pt
->read_end
)
887 else if (pos
== SCM_ARG2
)
889 /* check whether port's output buffer has room. */
890 scm_port
*pt
= SCM_PTAB_ENTRY (element
);
892 /* > 1 since writing the last byte in the buffer causes flush. */
893 if (pt
->write_end
- pt
->write_pos
> 1)
896 fd
= use_buf
? -1 : SCM_FPORT_FDES (element
);
899 *ports_ready
= scm_cons (element
, *ports_ready
);
905 /* check list_or_vec, a list or vector of ports or file descriptors,
906 adding each member to either the ports_ready list (if it's a port
907 with a usable buffer) or to *set. the kind of list_or_vec can be
908 determined from pos: SCM_ARG1 for reads, SCM_ARG2 for writes,
909 SCM_ARG3 for excepts. */
911 fill_select_type (SELECT_TYPE
*set
, SCM
*ports_ready
, SCM list_or_vec
, int pos
)
915 if (SCM_VECTORP (list_or_vec
))
917 int i
= SCM_VECTOR_LENGTH (list_or_vec
);
918 SCM
*ve
= SCM_VELTS (list_or_vec
);
922 int fd
= set_element (set
, ports_ready
, ve
[i
], pos
);
930 while (!SCM_NULLP (list_or_vec
))
932 int fd
= set_element (set
, ports_ready
, SCM_CAR (list_or_vec
), pos
);
936 list_or_vec
= SCM_CDR (list_or_vec
);
943 /* if element (a file descriptor or port) appears in *set, cons it to
944 list. return list. */
946 get_element (SELECT_TYPE
*set
, SCM element
, SCM list
)
950 if (SCM_INUMP (element
))
952 fd
= SCM_INUM (element
);
956 fd
= SCM_FPORT_FDES (SCM_COERCE_OUTPORT (element
));
958 if (FD_ISSET (fd
, set
))
959 list
= scm_cons (element
, list
);
963 /* construct component of scm_select return value.
964 set: pointer to set of file descriptors found by select to be ready
965 ports_ready: ports ready due to buffering
966 list_or_vec: original list/vector handed to scm_select.
967 the return value is a list/vector of ready ports/file descriptors.
968 works by finding the objects in list which correspond to members of
969 *set and appending them to ports_ready. result is converted to a
970 vector if list_or_vec is a vector. */
972 retrieve_select_type (SELECT_TYPE
*set
, SCM ports_ready
, SCM list_or_vec
)
974 SCM answer_list
= ports_ready
;
976 if (SCM_VECTORP (list_or_vec
))
978 int i
= SCM_VECTOR_LENGTH (list_or_vec
);
979 SCM
*ve
= SCM_VELTS (list_or_vec
);
983 answer_list
= get_element (set
, ve
[i
], answer_list
);
985 return scm_vector (answer_list
);
989 /* list_or_vec must be a list. */
990 while (!SCM_NULLP (list_or_vec
))
992 answer_list
= get_element (set
, SCM_CAR (list_or_vec
), answer_list
);
993 list_or_vec
= SCM_CDR (list_or_vec
);
999 /* Static helper functions above refer to s_scm_select directly as s_select */
1000 SCM_DEFINE (scm_select
, "select", 3, 2, 0,
1001 (SCM reads
, SCM writes
, SCM excepts
, SCM secs
, SCM usecs
),
1002 "This procedure has a variety of uses: waiting for the ability\n"
1003 "to provide input, accept output, or the existance of\n"
1004 "exceptional conditions on a collection of ports or file\n"
1005 "descriptors, or waiting for a timeout to occur.\n"
1006 "It also returns if interrupted by a signal.\n\n"
1007 "@var{reads}, @var{writes} and @var{excepts} can be lists or\n"
1008 "vectors, with each member a port or a file descriptor.\n"
1009 "The value returned is a list of three corresponding\n"
1010 "lists or vectors containing only the members which meet the\n"
1011 "specified requirement. The ability of port buffers to\n"
1012 "provide input or accept output is taken into account.\n"
1013 "Ordering of the input lists or vectors is not preserved.\n\n"
1014 "The optional arguments @var{secs} and @var{usecs} specify the\n"
1015 "timeout. Either @var{secs} can be specified alone, as\n"
1016 "either an integer or a real number, or both @var{secs} and\n"
1017 "@var{usecs} can be specified as integers, in which case\n"
1018 "@var{usecs} is an additional timeout expressed in\n"
1019 "microseconds. If @var{secs} is omitted or is @code{#f} then\n"
1020 "select will wait for as long as it takes for one of the other\n"
1021 "conditions to be satisfied.\n\n"
1022 "The scsh version of @code{select} differs as follows:\n"
1023 "Only vectors are accepted for the first three arguments.\n"
1024 "The @var{usecs} argument is not supported.\n"
1025 "Multiple values are returned instead of a list.\n"
1026 "Duplicates in the input vectors appear only once in output.\n"
1027 "An additional @code{select!} interface is provided.\n"
1029 #define FUNC_NAME s_scm_select
1031 struct timeval timeout
;
1032 struct timeval
* time_ptr
;
1033 SELECT_TYPE read_set
;
1034 SELECT_TYPE write_set
;
1035 SELECT_TYPE except_set
;
1039 /* these lists accumulate ports which are ready due to buffering.
1040 their file descriptors don't need to be added to the select sets. */
1041 SCM read_ports_ready
= SCM_EOL
;
1042 SCM write_ports_ready
= SCM_EOL
;
1045 if (SCM_VECTORP (reads
))
1047 read_count
= SCM_VECTOR_LENGTH (reads
);
1051 read_count
= scm_ilength (reads
);
1052 SCM_ASSERT (read_count
>= 0, reads
, SCM_ARG1
, FUNC_NAME
);
1054 if (SCM_VECTORP (writes
))
1056 write_count
= SCM_VECTOR_LENGTH (writes
);
1060 write_count
= scm_ilength (writes
);
1061 SCM_ASSERT (write_count
>= 0, writes
, SCM_ARG2
, FUNC_NAME
);
1063 if (SCM_VECTORP (excepts
))
1065 except_count
= SCM_VECTOR_LENGTH (excepts
);
1069 except_count
= scm_ilength (excepts
);
1070 SCM_ASSERT (except_count
>= 0, excepts
, SCM_ARG3
, FUNC_NAME
);
1073 FD_ZERO (&read_set
);
1074 FD_ZERO (&write_set
);
1075 FD_ZERO (&except_set
);
1077 max_fd
= fill_select_type (&read_set
, &read_ports_ready
, reads
, SCM_ARG1
);
1080 int write_max
= fill_select_type (&write_set
, &write_ports_ready
,
1082 int except_max
= fill_select_type (&except_set
, NULL
,
1085 if (write_max
> max_fd
)
1087 if (except_max
> max_fd
)
1088 max_fd
= except_max
;
1091 /* if there's a port with a ready buffer, don't block, just
1092 check for ready file descriptors. */
1093 if (!SCM_NULLP (read_ports_ready
) || !SCM_NULLP (write_ports_ready
))
1096 timeout
.tv_usec
= 0;
1097 time_ptr
= &timeout
;
1099 else if (SCM_UNBNDP (secs
) || SCM_FALSEP (secs
))
1103 if (SCM_INUMP (secs
))
1105 timeout
.tv_sec
= SCM_INUM (secs
);
1106 if (SCM_UNBNDP (usecs
))
1107 timeout
.tv_usec
= 0;
1110 SCM_VALIDATE_INUM (5,usecs
);
1111 timeout
.tv_usec
= SCM_INUM (usecs
);
1116 double fl
= scm_num2dbl (secs
, FUNC_NAME
);
1118 if (!SCM_UNBNDP (usecs
))
1119 SCM_WRONG_TYPE_ARG (4, secs
);
1121 SCM_OUT_OF_RANGE (4, secs
);
1122 timeout
.tv_sec
= (long) fl
;
1123 timeout
.tv_usec
= (long) ((fl
- timeout
.tv_sec
) * 1000000);
1125 time_ptr
= &timeout
;
1129 #ifdef GUILE_ISELECT
1130 int rv
= scm_internal_select (max_fd
+ 1,
1131 &read_set
, &write_set
, &except_set
,
1134 int rv
= select (max_fd
+ 1,
1135 &read_set
, &write_set
, &except_set
, time_ptr
);
1140 return SCM_LIST3 (retrieve_select_type (&read_set
, read_ports_ready
, reads
),
1141 retrieve_select_type (&write_set
, write_ports_ready
, writes
),
1142 retrieve_select_type (&except_set
, SCM_EOL
, excepts
));
1145 #endif /* HAVE_SELECT */
1149 SCM_DEFINE (scm_fcntl
, "fcntl", 2, 1, 0,
1150 (SCM object
, SCM cmd
, SCM value
),
1151 "Apply @var{command} to the specified file descriptor or the underlying\n"
1152 "file descriptor of the specified port. @var{value} is an optional\n"
1153 "integer argument.\n\n"
1154 "Values for @var{command} are:\n\n"
1157 "Duplicate a file descriptor\n"
1159 "Get flags associated with the file descriptor.\n"
1161 "Set flags associated with the file descriptor to @var{value}.\n"
1163 "Get flags associated with the open file.\n"
1165 "Set flags associated with the open file to @var{value}\n"
1167 "Get the process ID of a socket's owner, for @code{SIGIO} signals.\n"
1169 "Set the process that owns a socket to @var{value}, for @code{SIGIO} signals.\n"
1170 "@item FD_CLOEXEC\n"
1171 "The value used to indicate the \"close on exec\" flag with @code{F_GETFL} or\n"
1174 #define FUNC_NAME s_scm_fcntl
1180 object
= SCM_COERCE_OUTPORT (object
);
1182 SCM_VALIDATE_INUM (2,cmd
);
1183 if (SCM_OPFPORTP (object
))
1184 fdes
= SCM_FPORT_FDES (object
);
1187 SCM_VALIDATE_INUM (1,object
);
1188 fdes
= SCM_INUM (object
);
1191 if (SCM_UNBNDP (value
)) {
1194 SCM_VALIDATE_INUM_COPY (SCM_ARG3
, value
, ivalue
);
1197 SCM_SYSCALL (rv
= fcntl (fdes
, SCM_INUM (cmd
), ivalue
));
1200 return SCM_MAKINUM (rv
);
1204 SCM_DEFINE (scm_fsync
, "fsync", 1, 0, 0,
1206 "Copies any unwritten data for the specified output file descriptor to disk.\n"
1207 "If @var{port/fd} is a port, its buffer is flushed before the underlying\n"
1208 "file descriptor is fsync'd.\n"
1209 "The return value is unspecified.")
1210 #define FUNC_NAME s_scm_fsync
1214 object
= SCM_COERCE_OUTPORT (object
);
1216 if (SCM_OPFPORTP (object
))
1219 fdes
= SCM_FPORT_FDES (object
);
1223 SCM_VALIDATE_INUM (1,object
);
1224 fdes
= SCM_INUM (object
);
1226 if (fsync (fdes
) == -1)
1228 return SCM_UNSPECIFIED
;
1233 SCM_DEFINE (scm_symlink
, "symlink", 2, 0, 0,
1234 (SCM oldpath
, SCM newpath
),
1235 "Create a symbolic link named @var{path-to} with the value (i.e., pointing to)\n"
1236 "@var{path-from}. The return value is unspecified.")
1237 #define FUNC_NAME s_scm_symlink
1241 SCM_VALIDATE_STRING (1, oldpath
);
1242 SCM_VALIDATE_STRING (2, newpath
);
1243 SCM_STRING_COERCE_0TERMINATION_X (oldpath
);
1244 SCM_STRING_COERCE_0TERMINATION_X (newpath
);
1245 SCM_SYSCALL (val
= symlink (SCM_STRING_CHARS (oldpath
), SCM_STRING_CHARS (newpath
)));
1248 return SCM_UNSPECIFIED
;
1251 #endif /* HAVE_SYMLINK */
1253 #ifdef HAVE_READLINK
1254 SCM_DEFINE (scm_readlink
, "readlink", 1, 0, 0,
1256 "Return the value of the symbolic link named by @var{path} (a\n"
1257 "string), i.e., the file that the link points to.")
1258 #define FUNC_NAME s_scm_readlink
1264 SCM_VALIDATE_STRING (1, path
);
1265 SCM_STRING_COERCE_0TERMINATION_X (path
);
1266 buf
= scm_must_malloc (size
, FUNC_NAME
);
1267 while ((rv
= readlink (SCM_STRING_CHARS (path
), buf
, size
)) == size
)
1269 scm_must_free (buf
);
1271 buf
= scm_must_malloc (size
, FUNC_NAME
);
1275 result
= scm_makfromstr (buf
, rv
, 0);
1276 scm_must_free (buf
);
1280 #endif /* HAVE_READLINK */
1283 SCM_DEFINE (scm_lstat
, "lstat", 1, 0, 0,
1285 "Similar to @code{stat}, but does not follow symbolic links, i.e.,\n"
1286 "it will return information about a symbolic link itself, not the \n"
1287 "file it points to. @var{path} must be a string.")
1288 #define FUNC_NAME s_scm_lstat
1291 struct stat stat_temp
;
1293 SCM_VALIDATE_STRING (1, str
);
1294 SCM_STRING_COERCE_0TERMINATION_X (str
);
1295 SCM_SYSCALL (rv
= lstat (SCM_STRING_CHARS (str
), &stat_temp
));
1300 SCM_SYSERROR_MSG ("~A: ~S",
1301 SCM_LIST2 (scm_makfrom0str (strerror (errno
)), str
),
1304 return scm_stat2scm(&stat_temp
);
1307 #endif /* HAVE_LSTAT */
1309 SCM_DEFINE (scm_copy_file
, "copy-file", 2, 0, 0,
1310 (SCM oldfile
, SCM newfile
),
1311 "Copy the file specified by @var{path-from} to @var{path-to}.\n"
1312 "The return value is unspecified.")
1313 #define FUNC_NAME s_scm_copy_file
1318 struct stat oldstat
;
1320 SCM_VALIDATE_STRING (1, oldfile
);
1321 SCM_STRING_COERCE_0TERMINATION_X (oldfile
);
1322 SCM_VALIDATE_STRING (2, newfile
);
1323 SCM_STRING_COERCE_0TERMINATION_X (newfile
);
1324 if (stat (SCM_STRING_CHARS (oldfile
), &oldstat
) == -1)
1326 oldfd
= open (SCM_STRING_CHARS (oldfile
), O_RDONLY
);
1330 /* use POSIX flags instead of 07777?. */
1331 newfd
= open (SCM_STRING_CHARS (newfile
), O_WRONLY
| O_CREAT
| O_TRUNC
,
1332 oldstat
.st_mode
& 07777);
1336 while ((n
= read (oldfd
, buf
, sizeof buf
)) > 0)
1337 if (write (newfd
, buf
, n
) != n
)
1344 if (close (newfd
) == -1)
1346 return SCM_UNSPECIFIED
;
1351 /* Filename manipulation */
1355 SCM_DEFINE (scm_dirname
, "dirname", 1, 0, 0,
1357 "Return the directory name component of the file name\n"
1358 "@var{filename}. If @var{filename} does not contain a directory\n"
1359 "component, @code{.} is returned.")
1360 #define FUNC_NAME s_scm_dirname
1364 unsigned long int len
;
1366 SCM_VALIDATE_STRING (1,filename
);
1368 s
= SCM_STRING_CHARS (filename
);
1369 len
= SCM_STRING_LENGTH (filename
);
1372 while (i
>= 0 && s
[i
] == '/') --i
;
1373 while (i
>= 0 && s
[i
] != '/') --i
;
1374 while (i
>= 0 && s
[i
] == '/') --i
;
1377 if (len
> 0 && s
[0] == '/')
1378 return scm_substring (filename
, SCM_INUM0
, SCM_MAKINUM (1));
1380 return scm_dot_string
;
1383 return scm_substring (filename
, SCM_INUM0
, SCM_MAKINUM (i
+ 1));
1387 SCM_DEFINE (scm_basename
, "basename", 1, 1, 0,
1388 (SCM filename
, SCM suffix
),
1389 "Return the base name of the file name @var{filename}. The\n"
1390 "base name is the file name without any directory components.\n"
1391 "If @var{suffix} is privided, and is equal to the end of\n"
1392 "@var{basename}, it is removed also.")
1393 #define FUNC_NAME s_scm_basename
1398 SCM_VALIDATE_STRING (1,filename
);
1399 f
= SCM_STRING_CHARS (filename
);
1400 len
= SCM_STRING_LENGTH (filename
);
1402 if (SCM_UNBNDP (suffix
))
1406 SCM_VALIDATE_STRING (2, suffix
);
1407 s
= SCM_STRING_CHARS (suffix
);
1408 j
= SCM_STRING_LENGTH (suffix
) - 1;
1411 while (i
>= 0 && f
[i
] == '/') --i
;
1413 while (i
>= 0 && j
>= 0 && f
[i
] == s
[j
]) --i
, --j
;
1416 while (i
>= 0 && f
[i
] != '/') --i
;
1419 if (len
> 0 && f
[0] == '/')
1420 return scm_substring (filename
, SCM_INUM0
, SCM_MAKINUM (1));
1422 return scm_dot_string
;
1425 return scm_substring (filename
, SCM_MAKINUM (i
+ 1), SCM_MAKINUM (end
+ 1));
1436 scm_tc16_dir
= scm_make_smob_type ("directory", 0);
1437 scm_set_smob_free (scm_tc16_dir
, scm_dir_free
);
1438 scm_set_smob_print (scm_tc16_dir
, scm_dir_print
);
1440 scm_dot_string
= scm_permanent_object (scm_makfrom0str ("."));
1443 scm_sysintern ("O_RDONLY", scm_long2num (O_RDONLY
));
1446 scm_sysintern ("O_WRONLY", scm_long2num (O_WRONLY
));
1449 scm_sysintern ("O_RDWR", scm_long2num (O_RDWR
));
1452 scm_sysintern ("O_CREAT", scm_long2num (O_CREAT
));
1455 scm_sysintern ("O_EXCL", scm_long2num (O_EXCL
));
1458 scm_sysintern ("O_NOCTTY", scm_long2num (O_NOCTTY
));
1461 scm_sysintern ("O_TRUNC", scm_long2num (O_TRUNC
));
1464 scm_sysintern ("O_APPEND", scm_long2num (O_APPEND
));
1467 scm_sysintern ("O_NONBLOCK", scm_long2num (O_NONBLOCK
));
1470 scm_sysintern ("O_NDELAY", scm_long2num (O_NDELAY
));
1473 scm_sysintern ("O_SYNC", scm_long2num (O_SYNC
));
1477 scm_sysintern ("F_DUPFD", scm_long2num (F_DUPFD
));
1480 scm_sysintern ("F_GETFD", scm_long2num (F_GETFD
));
1483 scm_sysintern ("F_SETFD", scm_long2num (F_SETFD
));
1486 scm_sysintern ("F_GETFL", scm_long2num (F_GETFL
));
1489 scm_sysintern ("F_SETFL", scm_long2num (F_SETFL
));
1492 scm_sysintern ("F_GETOWN", scm_long2num (F_GETOWN
));
1495 scm_sysintern ("F_SETOWN", scm_long2num (F_SETOWN
));
1498 scm_sysintern ("FD_CLOEXEC", scm_long2num (FD_CLOEXEC
));
1501 #ifndef SCM_MAGIC_SNARFER
1502 #include "libguile/filesys.x"