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_ROSTRING(1,object
);
159 SCM_COERCE_SUBSTR (object
);
160 SCM_SYSCALL (rv
= chown (SCM_ROCHARS (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_ROSTRING (1,object
);
198 SCM_COERCE_SUBSTR (object
);
199 SCM_SYSCALL (rv
= chmod (SCM_ROCHARS (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_ROSTRING (1,path
);
243 SCM_COERCE_SUBSTR (path
);
244 iflags
= SCM_NUM2LONG(2,flags
);
245 imode
= SCM_NUM2LONG_DEF(3,mode
,0666);
246 SCM_SYSCALL (fd
= open (SCM_ROCHARS (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);
342 SCM_SYMBOL (scm_sym_regular
, "regular");
343 SCM_SYMBOL (scm_sym_directory
, "directory");
345 SCM_SYMBOL (scm_sym_symlink
, "symlink");
347 SCM_SYMBOL (scm_sym_block_special
, "block-special");
348 SCM_SYMBOL (scm_sym_char_special
, "char-special");
349 SCM_SYMBOL (scm_sym_fifo
, "fifo");
350 SCM_SYMBOL (scm_sym_sock
, "socket");
351 SCM_SYMBOL (scm_sym_unknown
, "unknown");
354 scm_stat2scm (struct stat
*stat_temp
)
356 SCM ans
= scm_make_vector (SCM_MAKINUM (15), SCM_UNSPECIFIED
);
357 SCM
*ve
= SCM_VELTS (ans
);
359 ve
[0] = scm_ulong2num ((unsigned long) stat_temp
->st_dev
);
360 ve
[1] = scm_ulong2num ((unsigned long) stat_temp
->st_ino
);
361 ve
[2] = scm_ulong2num ((unsigned long) stat_temp
->st_mode
);
362 ve
[3] = scm_ulong2num ((unsigned long) stat_temp
->st_nlink
);
363 ve
[4] = scm_ulong2num ((unsigned long) stat_temp
->st_uid
);
364 ve
[5] = scm_ulong2num ((unsigned long) stat_temp
->st_gid
);
366 ve
[6] = scm_ulong2num ((unsigned long) stat_temp
->st_rdev
);
370 ve
[7] = scm_ulong2num ((unsigned long) stat_temp
->st_size
);
371 ve
[8] = scm_ulong2num ((unsigned long) stat_temp
->st_atime
);
372 ve
[9] = scm_ulong2num ((unsigned long) stat_temp
->st_mtime
);
373 ve
[10] = scm_ulong2num ((unsigned long) stat_temp
->st_ctime
);
374 #ifdef HAVE_ST_BLKSIZE
375 ve
[11] = scm_ulong2num ((unsigned long) stat_temp
->st_blksize
);
377 ve
[11] = scm_ulong2num (4096L);
379 #ifdef HAVE_ST_BLOCKS
380 ve
[12] = scm_ulong2num ((unsigned long) stat_temp
->st_blocks
);
385 int mode
= stat_temp
->st_mode
;
388 ve
[13] = scm_sym_regular
;
389 else if (S_ISDIR (mode
))
390 ve
[13] = scm_sym_directory
;
392 else if (S_ISLNK (mode
))
393 ve
[13] = scm_sym_symlink
;
395 else if (S_ISBLK (mode
))
396 ve
[13] = scm_sym_block_special
;
397 else if (S_ISCHR (mode
))
398 ve
[13] = scm_sym_char_special
;
399 else if (S_ISFIFO (mode
))
400 ve
[13] = scm_sym_fifo
;
401 else if (S_ISSOCK (mode
))
402 ve
[13] = scm_sym_sock
;
404 ve
[13] = scm_sym_unknown
;
406 ve
[14] = SCM_MAKINUM ((~S_IFMT
) & mode
);
408 /* the layout of the bits in ve[14] is intended to be portable.
409 If there are systems that don't follow the usual convention,
410 the following could be used:
413 if (S_ISUID & mode) tmp += 1;
415 if (S_IRGRP & mode) tmp += 1;
417 if (S_ISVTX & mode) tmp += 1;
419 if (S_IRUSR & mode) tmp += 1;
421 if (S_IWUSR & mode) tmp += 1;
423 if (S_IXUSR & mode) tmp += 1;
425 if (S_IWGRP & mode) tmp += 1;
427 if (S_IXGRP & mode) tmp += 1;
429 if (S_IROTH & mode) tmp += 1;
431 if (S_IWOTH & mode) tmp += 1;
433 if (S_IXOTH & mode) tmp += 1;
435 ve[14] = SCM_MAKINUM (tmp);
443 SCM_DEFINE (scm_stat
, "stat", 1, 0, 0,
445 "Returns an object containing various information\n"
446 "about the file determined by @var{obj}.\n"
447 "@var{obj} can be a string containing a file name or a port or integer file\n"
448 "descriptor which is open on a file (in which case @code{fstat} is used\n"
449 "as the underlying system call).\n\n"
450 "The object returned by @code{stat} can be passed as a single parameter\n"
451 "to the following procedures, all of which return integers:\n\n"
454 "The device containing the file.\n"
456 "The file serial number, which distinguishes this file from all other\n"
457 "files on the same device.\n"
459 "The mode of the file. This includes file type information\n"
460 "and the file permission bits. See @code{stat:type} and @code{stat:perms}\n"
463 "The number of hard links to the file.\n"
465 "The user ID of the file's owner.\n"
467 "The group ID of the file.\n"
469 "Device ID; this entry is defined only for character or block\n"
472 "The size of a regular file in bytes.\n"
474 "The last access time for the file.\n"
476 "The last modification time for the file.\n"
478 "The last modification time for the attributes of the file.\n"
479 "@item stat:blksize\n"
480 "The optimal block size for reading or writing the file, in bytes.\n"
481 "@item stat:blocks\n"
482 "The amount of disk space that the file occupies measured in units of\n"
485 "In addition, the following procedures return the information\n"
486 "from stat:mode in a more convenient form:\n\n"
489 "A symbol representing the type of file. Possible values are\n"
490 "regular, directory, symlink, block-special, char-special,\n"
491 "fifo, socket and unknown\n"
493 "An integer representing the access permission bits.\n"
495 #define FUNC_NAME s_scm_stat
499 struct stat stat_temp
;
501 if (SCM_INUMP (object
))
502 SCM_SYSCALL (rv
= fstat (SCM_INUM (object
), &stat_temp
));
505 SCM_VALIDATE_NIM (1,object
);
506 if (SCM_ROSTRINGP (object
))
508 SCM_COERCE_SUBSTR (object
);
509 SCM_SYSCALL (rv
= stat (SCM_ROCHARS (object
), &stat_temp
));
513 object
= SCM_COERCE_OUTPORT (object
);
514 SCM_VALIDATE_OPFPORT(1,object
);
515 fdes
= SCM_FPORT_FDES (object
);
516 SCM_SYSCALL (rv
= fstat (fdes
, &stat_temp
));
523 SCM_SYSERROR_MSG ("~A: ~S",
524 scm_listify (scm_makfrom0str (strerror (errno
)),
528 return scm_stat2scm (&stat_temp
);
533 /* {Modifying Directories}
536 SCM_DEFINE (scm_link
, "link", 2, 0, 0,
537 (SCM oldpath
, SCM newpath
),
538 "Creates a new name @var{path-to} in the file system for the file\n"
539 "named by @var{path-from}. If @var{path-from} is a symbolic link, the\n"
540 "link may or may not be followed depending on the system.")
541 #define FUNC_NAME s_scm_link
545 SCM_VALIDATE_ROSTRING (1,oldpath
);
546 if (SCM_SUBSTRP (oldpath
))
547 oldpath
= scm_makfromstr (SCM_ROCHARS (oldpath
),
548 SCM_ROLENGTH (oldpath
), 0);
549 SCM_VALIDATE_ROSTRING (2,newpath
);
550 if (SCM_SUBSTRP (newpath
))
551 newpath
= scm_makfromstr (SCM_ROCHARS (newpath
),
552 SCM_ROLENGTH (newpath
), 0);
553 SCM_SYSCALL (val
= link (SCM_ROCHARS (oldpath
), SCM_ROCHARS (newpath
)));
556 return SCM_UNSPECIFIED
;
562 SCM_DEFINE (scm_rename
, "rename-file", 2, 0, 0,
563 (SCM oldname
, SCM newname
),
564 "Renames the file specified by @var{path-from} to @var{path-to}.\n"
565 "The return value is unspecified.")
566 #define FUNC_NAME s_scm_rename
569 SCM_VALIDATE_ROSTRING (1,oldname
);
570 SCM_VALIDATE_ROSTRING (2,newname
);
571 SCM_COERCE_SUBSTR (oldname
);
572 SCM_COERCE_SUBSTR (newname
);
574 SCM_SYSCALL (rv
= rename (SCM_ROCHARS (oldname
), SCM_ROCHARS (newname
)));
576 SCM_SYSCALL (rv
= link (SCM_ROCHARS (oldname
), SCM_ROCHARS (newname
)));
579 SCM_SYSCALL (rv
= unlink (SCM_ROCHARS (oldname
)));;
581 /* unlink failed. remove new name */
582 SCM_SYSCALL (unlink (SCM_ROCHARS (newname
)));
587 return SCM_UNSPECIFIED
;
592 SCM_DEFINE (scm_delete_file
, "delete-file", 1, 0, 0,
594 "Deletes (or \"unlinks\") the file specified by @var{path}.")
595 #define FUNC_NAME s_scm_delete_file
598 SCM_VALIDATE_ROSTRING (1,str
);
599 SCM_COERCE_SUBSTR (str
);
600 SCM_SYSCALL (ans
= unlink (SCM_ROCHARS (str
)));
603 return SCM_UNSPECIFIED
;
608 SCM_DEFINE (scm_mkdir
, "mkdir", 1, 1, 0,
609 (SCM path
, SCM mode
),
610 "Create a new directory named by @var{path}. If @var{mode} is omitted\n"
611 "then the permissions of the directory file are set using the current\n"
612 "umask. Otherwise they are set to the decimal value specified with\n"
613 "@var{mode}. The return value is unspecified.")
614 #define FUNC_NAME s_scm_mkdir
618 SCM_VALIDATE_ROSTRING (1,path
);
619 SCM_COERCE_SUBSTR (path
);
620 if (SCM_UNBNDP (mode
))
624 SCM_SYSCALL (rv
= mkdir (SCM_ROCHARS (path
), 0777 ^ mask
));
628 SCM_VALIDATE_INUM (2,mode
);
629 SCM_SYSCALL (rv
= mkdir (SCM_ROCHARS (path
), SCM_INUM (mode
)));
633 return SCM_UNSPECIFIED
;
636 #endif /* HAVE_MKDIR */
639 SCM_DEFINE (scm_rmdir
, "rmdir", 1, 0, 0,
641 "Remove the existing directory named by @var{path}. The directory must\n"
642 "be empty for this to succeed. The return value is unspecified.")
643 #define FUNC_NAME s_scm_rmdir
647 SCM_VALIDATE_ROSTRING (1,path
);
648 SCM_COERCE_SUBSTR (path
);
649 SCM_SYSCALL (val
= rmdir (SCM_ROCHARS (path
)));
652 return SCM_UNSPECIFIED
;
658 /* {Examining Directories}
663 SCM_DEFINE (scm_directory_stream_p
, "directory-stream?", 1, 0, 0,
665 "Returns a boolean indicating whether @var{object} is a directory stream\n"
666 "as returned by @code{opendir}.")
667 #define FUNC_NAME s_scm_directory_stream_p
669 return SCM_BOOL(SCM_DIRP (obj
));
673 SCM_DEFINE (scm_opendir
, "opendir", 1, 0, 0,
675 "Open the directory specified by @var{path} and return a directory\n"
677 #define FUNC_NAME s_scm_opendir
680 SCM_VALIDATE_ROSTRING (1,dirname
);
681 SCM_COERCE_SUBSTR (dirname
);
682 SCM_SYSCALL (ds
= opendir (SCM_ROCHARS (dirname
)));
685 SCM_RETURN_NEWSMOB (scm_tc16_dir
| SCM_OPN
, ds
);
690 SCM_DEFINE (scm_readdir
, "readdir", 1, 0, 0,
692 "Return (as a string) the next directory entry from the directory stream\n"
693 "@var{stream}. If there is no remaining entry to be read then the\n"
694 "end of file object is returned.")
695 #define FUNC_NAME s_scm_readdir
697 struct dirent
*rdent
;
698 SCM_VALIDATE_OPDIR (1,port
);
700 SCM_SYSCALL (rdent
= readdir ((DIR *) SCM_CELL_WORD_1 (port
)));
703 return (rdent
? scm_makfromstr (rdent
->d_name
, NAMLEN (rdent
), 0)
710 SCM_DEFINE (scm_rewinddir
, "rewinddir", 1, 0, 0,
712 "Reset the directory port @var{stream} so that the next call to\n"
713 "@code{readdir} will return the first directory entry.")
714 #define FUNC_NAME s_scm_rewinddir
716 SCM_VALIDATE_OPDIR (1,port
);
717 rewinddir ((DIR *) SCM_CELL_WORD_1 (port
));
718 return SCM_UNSPECIFIED
;
724 SCM_DEFINE (scm_closedir
, "closedir", 1, 0, 0,
726 "Close the directory stream @var{stream}.\n"
727 "The return value is unspecified.")
728 #define FUNC_NAME s_scm_closedir
732 SCM_VALIDATE_DIR (1,port
);
733 if (SCM_CLOSEDP (port
))
735 return SCM_UNSPECIFIED
;
737 SCM_SYSCALL (sts
= closedir ((DIR *) SCM_CELL_WORD_1 (port
)));
740 SCM_SET_CELL_WORD_0 (port
, scm_tc16_dir
);
741 return SCM_UNSPECIFIED
;
749 scm_dir_print (SCM exp
, SCM port
, scm_print_state
*pstate
)
751 scm_puts ("#<", port
);
752 if (SCM_CLOSEDP (exp
))
753 scm_puts ("closed: ", port
);
754 scm_puts ("directory stream ", port
);
755 scm_intprint (SCM_CELL_WORD_1 (exp
), 16, port
);
756 scm_putc ('>', port
);
765 closedir ((DIR *) SCM_CELL_WORD_1 (p
));
770 /* {Navigating Directories}
774 SCM_DEFINE (scm_chdir
, "chdir", 1, 0, 0,
776 "Change the current working directory to @var{path}.\n"
777 "The return value is unspecified.")
778 #define FUNC_NAME s_scm_chdir
782 SCM_VALIDATE_ROSTRING (1,str
);
783 SCM_COERCE_SUBSTR (str
);
784 SCM_SYSCALL (ans
= chdir (SCM_ROCHARS (str
)));
787 return SCM_UNSPECIFIED
;
792 SCM_DEFINE (scm_getcwd
, "getcwd", 0, 0, 0,
794 "Returns the name of the current working directory.")
795 #define FUNC_NAME s_scm_getcwd
798 scm_sizet size
= 100;
802 wd
= scm_must_malloc (size
, FUNC_NAME
);
803 while ((rv
= getcwd (wd
, size
)) == 0 && errno
== ERANGE
)
807 wd
= scm_must_malloc (size
, FUNC_NAME
);
811 result
= scm_makfromstr (wd
, strlen (wd
), 0);
816 #endif /* HAVE_GETCWD */
822 /* check that element is a port or file descriptor. if it's a port
823 and its buffer is ready for use, add it to the ports_ready list.
824 otherwise add its file descriptor to *set. the type of list can be
825 determined from pos: SCM_ARG1 for reads, SCM_ARG2 for writes,
826 SCM_ARG3 for excepts. */
828 set_element (SELECT_TYPE
*set
, SCM
*ports_ready
, SCM element
, int pos
)
832 if (SCM_INUMP (element
))
834 fd
= SCM_INUM (element
);
840 element
= SCM_COERCE_OUTPORT (element
);
841 SCM_ASSERT (SCM_OPFPORTP (element
), element
, pos
, "select");
844 /* check whether port has buffered input. */
845 scm_port
*pt
= SCM_PTAB_ENTRY (element
);
847 if (pt
->read_pos
< pt
->read_end
)
850 else if (pos
== SCM_ARG2
)
852 /* check whether port's output buffer has room. */
853 scm_port
*pt
= SCM_PTAB_ENTRY (element
);
855 /* > 1 since writing the last byte in the buffer causes flush. */
856 if (pt
->write_end
- pt
->write_pos
> 1)
859 fd
= use_buf
? -1 : SCM_FPORT_FDES (element
);
862 *ports_ready
= scm_cons (element
, *ports_ready
);
868 /* check list_or_vec, a list or vector of ports or file descriptors,
869 adding each member to either the ports_ready list (if it's a port
870 with a usable buffer) or to *set. the kind of list_or_vec can be
871 determined from pos: SCM_ARG1 for reads, SCM_ARG2 for writes,
872 SCM_ARG3 for excepts. */
874 fill_select_type (SELECT_TYPE
*set
, SCM
*ports_ready
, SCM list_or_vec
, int pos
)
878 if (SCM_VECTORP (list_or_vec
))
880 int i
= SCM_LENGTH (list_or_vec
);
881 SCM
*ve
= SCM_VELTS (list_or_vec
);
885 int fd
= set_element (set
, ports_ready
, ve
[i
], pos
);
893 while (!SCM_NULLP (list_or_vec
))
895 int fd
= set_element (set
, ports_ready
, SCM_CAR (list_or_vec
), pos
);
899 list_or_vec
= SCM_CDR (list_or_vec
);
906 /* if element (a file descriptor or port) appears in *set, cons it to
907 list. return list. */
909 get_element (SELECT_TYPE
*set
, SCM element
, SCM list
)
913 if (SCM_INUMP (element
))
915 fd
= SCM_INUM (element
);
919 fd
= SCM_FPORT_FDES (SCM_COERCE_OUTPORT (element
));
921 if (FD_ISSET (fd
, set
))
922 list
= scm_cons (element
, list
);
926 /* construct component of scm_select return value.
927 set: pointer to set of file descriptors found by select to be ready
928 ports_ready: ports ready due to buffering
929 list_or_vec: original list/vector handed to scm_select.
930 the return value is a list/vector of ready ports/file descriptors.
931 works by finding the objects in list which correspond to members of
932 *set and appending them to ports_ready. result is converted to a
933 vector if list_or_vec is a vector. */
935 retrieve_select_type (SELECT_TYPE
*set
, SCM ports_ready
, SCM list_or_vec
)
937 SCM answer_list
= ports_ready
;
939 if (SCM_VECTORP (list_or_vec
))
941 int i
= SCM_LENGTH (list_or_vec
);
942 SCM
*ve
= SCM_VELTS (list_or_vec
);
946 answer_list
= get_element (set
, ve
[i
], answer_list
);
948 return scm_vector (answer_list
);
952 /* list_or_vec must be a list. */
953 while (!SCM_NULLP (list_or_vec
))
955 answer_list
= get_element (set
, SCM_CAR (list_or_vec
), answer_list
);
956 list_or_vec
= SCM_CDR (list_or_vec
);
962 /* Static helper functions above refer to s_scm_select directly as s_select */
963 SCM_DEFINE (scm_select
, "select", 3, 2, 0,
964 (SCM reads
, SCM writes
, SCM excepts
, SCM secs
, SCM usecs
),
965 "This procedure has a variety of uses: waiting for the ability\n"
966 "to provide input, accept output, or the existance of\n"
967 "exceptional conditions on a collection of ports or file\n"
968 "descriptors, or waiting for a timeout to occur.\n"
969 "It also returns if interrupted by a signal.\n\n"
970 "@var{reads}, @var{writes} and @var{excepts} can be lists or\n"
971 "vectors, with each member a port or a file descriptor.\n"
972 "The value returned is a list of three corresponding\n"
973 "lists or vectors containing only the members which meet the\n"
974 "specified requirement. The ability of port buffers to\n"
975 "provide input or accept output is taken into account.\n"
976 "Ordering of the input lists or vectors is not preserved.\n\n"
977 "The optional arguments @var{secs} and @var{usecs} specify the\n"
978 "timeout. Either @var{secs} can be specified alone, as\n"
979 "either an integer or a real number, or both @var{secs} and\n"
980 "@var{usecs} can be specified as integers, in which case\n"
981 "@var{usecs} is an additional timeout expressed in\n"
982 "microseconds. If @var{secs} is omitted or is @code{#f} then\n"
983 "select will wait for as long as it takes for one of the other\n"
984 "conditions to be satisfied.\n\n"
985 "The scsh version of @code{select} differs as follows:\n"
986 "Only vectors are accepted for the first three arguments.\n"
987 "The @var{usecs} argument is not supported.\n"
988 "Multiple values are returned instead of a list.\n"
989 "Duplicates in the input vectors appear only once in output.\n"
990 "An additional @code{select!} interface is provided.\n"
992 #define FUNC_NAME s_scm_select
994 struct timeval timeout
;
995 struct timeval
* time_ptr
;
996 SELECT_TYPE read_set
;
997 SELECT_TYPE write_set
;
998 SELECT_TYPE except_set
;
1002 /* these lists accumulate ports which are ready due to buffering.
1003 their file descriptors don't need to be added to the select sets. */
1004 SCM read_ports_ready
= SCM_EOL
;
1005 SCM write_ports_ready
= SCM_EOL
;
1008 if (SCM_VECTORP (reads
))
1010 read_count
= SCM_LENGTH (reads
);
1014 read_count
= scm_ilength (reads
);
1015 SCM_ASSERT (read_count
>= 0, reads
, SCM_ARG1
, FUNC_NAME
);
1017 if (SCM_VECTORP (writes
))
1019 write_count
= SCM_LENGTH (writes
);
1023 write_count
= scm_ilength (writes
);
1024 SCM_ASSERT (write_count
>= 0, writes
, SCM_ARG2
, FUNC_NAME
);
1026 if (SCM_VECTORP (excepts
))
1028 except_count
= SCM_LENGTH (excepts
);
1032 except_count
= scm_ilength (excepts
);
1033 SCM_ASSERT (except_count
>= 0, excepts
, SCM_ARG3
, FUNC_NAME
);
1036 FD_ZERO (&read_set
);
1037 FD_ZERO (&write_set
);
1038 FD_ZERO (&except_set
);
1040 max_fd
= fill_select_type (&read_set
, &read_ports_ready
, reads
, SCM_ARG1
);
1043 int write_max
= fill_select_type (&write_set
, &write_ports_ready
,
1045 int except_max
= fill_select_type (&except_set
, NULL
,
1048 if (write_max
> max_fd
)
1050 if (except_max
> max_fd
)
1051 max_fd
= except_max
;
1054 /* if there's a port with a ready buffer, don't block, just
1055 check for ready file descriptors. */
1056 if (!SCM_NULLP (read_ports_ready
) || !SCM_NULLP (write_ports_ready
))
1059 timeout
.tv_usec
= 0;
1060 time_ptr
= &timeout
;
1062 else if (SCM_UNBNDP (secs
) || SCM_FALSEP (secs
))
1066 if (SCM_INUMP (secs
))
1068 timeout
.tv_sec
= SCM_INUM (secs
);
1069 if (SCM_UNBNDP (usecs
))
1070 timeout
.tv_usec
= 0;
1073 SCM_VALIDATE_INUM (5,usecs
);
1074 timeout
.tv_usec
= SCM_INUM (usecs
);
1079 double fl
= scm_num2dbl (secs
, FUNC_NAME
);
1081 if (!SCM_UNBNDP (usecs
))
1082 SCM_WRONG_TYPE_ARG (4, secs
);
1084 SCM_OUT_OF_RANGE (4, secs
);
1085 timeout
.tv_sec
= (long) fl
;
1086 timeout
.tv_usec
= (long) ((fl
- timeout
.tv_sec
) * 1000000);
1088 time_ptr
= &timeout
;
1092 #ifdef GUILE_ISELECT
1093 int rv
= scm_internal_select (max_fd
+ 1,
1094 &read_set
, &write_set
, &except_set
,
1097 int rv
= select (max_fd
+ 1,
1098 &read_set
, &write_set
, &except_set
, time_ptr
);
1103 return scm_listify (retrieve_select_type (&read_set
, read_ports_ready
,
1105 retrieve_select_type (&write_set
, write_ports_ready
,
1107 retrieve_select_type (&except_set
, SCM_EOL
, excepts
),
1111 #endif /* HAVE_SELECT */
1115 SCM_DEFINE (scm_fcntl
, "fcntl", 2, 0, 1,
1116 (SCM object
, SCM cmd
, SCM value
),
1117 "Apply @var{command} to the specified file descriptor or the underlying\n"
1118 "file descriptor of the specified port. @var{value} is an optional\n"
1119 "integer argument.\n\n"
1120 "Values for @var{command} are:\n\n"
1123 "Duplicate a file descriptor\n"
1125 "Get flags associated with the file descriptor.\n"
1127 "Set flags associated with the file descriptor to @var{value}.\n"
1129 "Get flags associated with the open file.\n"
1131 "Set flags associated with the open file to @var{value}\n"
1133 "Get the process ID of a socket's owner, for @code{SIGIO} signals.\n"
1135 "Set the process that owns a socket to @var{value}, for @code{SIGIO} signals.\n"
1136 "@item FD_CLOEXEC\n"
1137 "The value used to indicate the \"close on exec\" flag with @code{F_GETFL} or"
1140 #define FUNC_NAME s_scm_fcntl
1146 object
= SCM_COERCE_OUTPORT (object
);
1148 SCM_VALIDATE_INUM (2,cmd
);
1149 if (SCM_OPFPORTP (object
))
1150 fdes
= SCM_FPORT_FDES (object
);
1153 SCM_VALIDATE_INUM (1,object
);
1154 fdes
= SCM_INUM (object
);
1156 if (SCM_NULLP (value
))
1160 SCM_ASSERT (SCM_INUMP (SCM_CAR (value
)), value
, SCM_ARG3
, FUNC_NAME
);
1161 ivalue
= SCM_INUM (SCM_CAR (value
));
1163 SCM_SYSCALL (rv
= fcntl (fdes
, SCM_INUM (cmd
), ivalue
));
1166 return SCM_MAKINUM (rv
);
1170 SCM_DEFINE (scm_fsync
, "fsync", 1, 0, 0,
1172 "Copies any unwritten data for the specified output file descriptor to disk.\n"
1173 "If @var{port/fd} is a port, its buffer is flushed before the underlying\n"
1174 "file descriptor is fsync'd.\n"
1175 "The return value is unspecified.")
1176 #define FUNC_NAME s_scm_fsync
1180 object
= SCM_COERCE_OUTPORT (object
);
1182 if (SCM_OPFPORTP (object
))
1185 fdes
= SCM_FPORT_FDES (object
);
1189 SCM_VALIDATE_INUM (1,object
);
1190 fdes
= SCM_INUM (object
);
1192 if (fsync (fdes
) == -1)
1194 return SCM_UNSPECIFIED
;
1199 SCM_DEFINE (scm_symlink
, "symlink", 2, 0, 0,
1200 (SCM oldpath
, SCM newpath
),
1201 "Create a symbolic link named @var{path-to} with the value (i.e., pointing to)\n"
1202 "@var{path-from}. The return value is unspecified.")
1203 #define FUNC_NAME s_scm_symlink
1207 SCM_VALIDATE_ROSTRING (1,oldpath
);
1208 SCM_VALIDATE_ROSTRING (2,newpath
);
1209 SCM_COERCE_SUBSTR (oldpath
);
1210 SCM_COERCE_SUBSTR (newpath
);
1211 SCM_SYSCALL (val
= symlink(SCM_ROCHARS(oldpath
), SCM_ROCHARS(newpath
)));
1214 return SCM_UNSPECIFIED
;
1217 #endif /* HAVE_SYMLINK */
1219 #ifdef HAVE_READLINK
1220 SCM_DEFINE (scm_readlink
, "readlink", 1, 0, 0,
1222 "Returns the value of the symbolic link named by\n"
1223 "@var{path} (a string), i.e., the\n"
1224 "file that the link points to.")
1225 #define FUNC_NAME s_scm_readlink
1231 SCM_VALIDATE_ROSTRING (1,path
);
1232 SCM_COERCE_SUBSTR (path
);
1233 buf
= scm_must_malloc (size
, FUNC_NAME
);
1234 while ((rv
= readlink (SCM_ROCHARS (path
), buf
, size
)) == size
)
1236 scm_must_free (buf
);
1238 buf
= scm_must_malloc (size
, FUNC_NAME
);
1242 result
= scm_makfromstr (buf
, rv
, 0);
1243 scm_must_free (buf
);
1247 #endif /* HAVE_READLINK */
1250 SCM_DEFINE (scm_lstat
, "lstat", 1, 0, 0,
1252 "Similar to @code{stat}, but does not follow symbolic links, i.e.,\n"
1253 "it will return information about a symbolic link itself, not the \n"
1254 "file it points to. @var{path} must be a string.")
1255 #define FUNC_NAME s_scm_lstat
1258 struct stat stat_temp
;
1260 SCM_VALIDATE_ROSTRING (1,str
);
1261 SCM_COERCE_SUBSTR (str
);
1262 SCM_SYSCALL(rv
= lstat(SCM_ROCHARS(str
), &stat_temp
));
1267 SCM_SYSERROR_MSG ("~A: ~S",
1268 scm_listify (scm_makfrom0str (strerror (errno
)),
1270 SCM_UNDEFINED
), en
);
1272 return scm_stat2scm(&stat_temp
);
1275 #endif /* HAVE_LSTAT */
1277 SCM_DEFINE (scm_copy_file
, "copy-file", 2, 0, 0,
1278 (SCM oldfile
, SCM newfile
),
1279 "Copy the file specified by @var{path-from} to @var{path-to}.\n"
1280 "The return value is unspecified.")
1281 #define FUNC_NAME s_scm_copy_file
1286 struct stat oldstat
;
1288 SCM_VALIDATE_ROSTRING (1,oldfile
);
1289 if (SCM_SUBSTRP (oldfile
))
1290 oldfile
= scm_makfromstr (SCM_ROCHARS (oldfile
), SCM_ROLENGTH (oldfile
), 0);
1291 SCM_VALIDATE_ROSTRING (2,newfile
);
1292 if (SCM_SUBSTRP (newfile
))
1293 newfile
= scm_makfromstr (SCM_ROCHARS (newfile
), SCM_ROLENGTH (newfile
), 0);
1294 if (stat (SCM_ROCHARS (oldfile
), &oldstat
) == -1)
1296 oldfd
= open (SCM_ROCHARS (oldfile
), O_RDONLY
);
1300 /* use POSIX flags instead of 07777?. */
1301 newfd
= open (SCM_ROCHARS (newfile
), O_WRONLY
| O_CREAT
| O_TRUNC
,
1302 oldstat
.st_mode
& 07777);
1306 while ((n
= read (oldfd
, buf
, sizeof buf
)) > 0)
1307 if (write (newfd
, buf
, n
) != n
)
1314 if (close (newfd
) == -1)
1316 return SCM_UNSPECIFIED
;
1321 /* Filename manipulation */
1325 SCM_DEFINE (scm_dirname
, "dirname", 1, 0, 0,
1328 #define FUNC_NAME s_scm_dirname
1332 SCM_VALIDATE_ROSTRING (1,filename
);
1333 s
= SCM_ROCHARS (filename
);
1334 len
= SCM_LENGTH (filename
);
1336 while (i
>= 0 && s
[i
] == '/') --i
;
1337 while (i
>= 0 && s
[i
] != '/') --i
;
1338 while (i
>= 0 && s
[i
] == '/') --i
;
1341 if (len
> 0 && s
[0] == '/')
1342 return scm_make_shared_substring (filename
, SCM_INUM0
, SCM_MAKINUM (1));
1344 return scm_dot_string
;
1347 return scm_make_shared_substring (filename
, SCM_INUM0
, SCM_MAKINUM (i
+ 1));
1351 SCM_DEFINE (scm_basename
, "basename", 1, 1, 0,
1352 (SCM filename
, SCM suffix
),
1354 #define FUNC_NAME s_scm_basename
1358 SCM_VALIDATE_ROSTRING (1,filename
);
1359 SCM_ASSERT (SCM_UNBNDP (suffix
)
1360 || (SCM_ROSTRINGP (suffix
)),
1364 f
= SCM_ROCHARS (filename
);
1365 if (SCM_UNBNDP (suffix
))
1369 s
= SCM_ROCHARS (suffix
);
1370 j
= SCM_LENGTH (suffix
) - 1;
1372 len
= SCM_LENGTH (filename
);
1374 while (i
>= 0 && f
[i
] == '/') --i
;
1376 while (i
>= 0 && j
>= 0 && f
[i
] == s
[j
]) --i
, --j
;
1379 while (i
>= 0 && f
[i
] != '/') --i
;
1382 if (len
> 0 && f
[0] == '/')
1383 return scm_make_shared_substring (filename
, SCM_INUM0
, SCM_MAKINUM (1));
1385 return scm_dot_string
;
1388 return scm_make_shared_substring (filename
,
1389 SCM_MAKINUM (i
+ 1),
1390 SCM_MAKINUM (end
+ 1));
1401 scm_tc16_dir
= scm_make_smob_type_mfpe ("directory", 0,
1402 NULL
, scm_dir_free
,scm_dir_print
, NULL
);
1404 scm_dot_string
= scm_permanent_object (scm_makfrom0str ("."));
1407 scm_sysintern ("O_RDONLY", scm_long2num (O_RDONLY
));
1410 scm_sysintern ("O_WRONLY", scm_long2num (O_WRONLY
));
1413 scm_sysintern ("O_RDWR", scm_long2num (O_RDWR
));
1416 scm_sysintern ("O_CREAT", scm_long2num (O_CREAT
));
1419 scm_sysintern ("O_EXCL", scm_long2num (O_EXCL
));
1422 scm_sysintern ("O_NOCTTY", scm_long2num (O_NOCTTY
));
1425 scm_sysintern ("O_TRUNC", scm_long2num (O_TRUNC
));
1428 scm_sysintern ("O_APPEND", scm_long2num (O_APPEND
));
1431 scm_sysintern ("O_NONBLOCK", scm_long2num (O_NONBLOCK
));
1434 scm_sysintern ("O_NDELAY", scm_long2num (O_NDELAY
));
1437 scm_sysintern ("O_SYNC", scm_long2num (O_SYNC
));
1441 scm_sysintern ("F_DUPFD", scm_long2num (F_DUPFD
));
1444 scm_sysintern ("F_GETFD", scm_long2num (F_GETFD
));
1447 scm_sysintern ("F_SETFD", scm_long2num (F_SETFD
));
1450 scm_sysintern ("F_GETFL", scm_long2num (F_GETFL
));
1453 scm_sysintern ("F_SETFL", scm_long2num (F_SETFL
));
1456 scm_sysintern ("F_GETOWN", scm_long2num (F_GETOWN
));
1459 scm_sysintern ("F_SETOWN", scm_long2num (F_SETOWN
));
1462 scm_sysintern ("FD_CLOEXEC", scm_long2num (FD_CLOEXEC
));
1465 #include "libguile/filesys.x"