1 /* Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2003, 2006 Free Software Foundation, Inc.
3 * This library is free software; you can redistribute it and/or
4 * modify it under the terms of the GNU Lesser General Public
5 * License as published by the Free Software Foundation; either
6 * version 2.1 of the License, or (at your option) any later version.
8 * This library 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 GNU
11 * Lesser General Public License for more details.
13 * You should have received a copy of the GNU Lesser General Public
14 * License along with this library; if not, write to the Free Software
15 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
28 #include "libguile/_scm.h"
29 #include "libguile/ioext.h"
30 #include "libguile/fports.h"
31 #include "libguile/feature.h"
32 #include "libguile/ports.h"
33 #include "libguile/strings.h"
34 #include "libguile/validate.h"
35 #include "libguile/dynwind.h"
47 SCM_DEFINE (scm_ftell, "ftell", 1, 0, 0,
49 "Return an integer representing the current position of\n"
50 "@var{fd/port}, measured from the beginning. Equivalent to:\n"
53 "(seek port 0 SEEK_CUR)\n"
55 #define FUNC_NAME s_scm_ftell
57 return scm_seek (fd_port, SCM_INUM0, scm_from_int (SEEK_CUR));
61 SCM_DEFINE (scm_redirect_port, "redirect-port", 2, 0, 0,
63 "This procedure takes two ports and duplicates the underlying file\n"
64 "descriptor from @var{old-port} into @var{new-port}. The\n"
65 "current file descriptor in @var{new-port} will be closed.\n"
66 "After the redirection the two ports will share a file position\n"
67 "and file status flags.\n\n"
68 "The return value is unspecified.\n\n"
69 "Unexpected behaviour can result if both ports are subsequently used\n"
70 "and the original and/or duplicate ports are buffered.\n\n"
71 "This procedure does not have any side effects on other ports or\n"
73 #define FUNC_NAME s_scm_redirect_port
75 int ans, oldfd, newfd;
78 old = SCM_COERCE_OUTPORT (old);
79 new = SCM_COERCE_OUTPORT (new);
81 SCM_VALIDATE_OPFPORT (1, old);
82 SCM_VALIDATE_OPFPORT (2, new);
83 oldfd = SCM_FPORT_FDES (old);
84 fp = SCM_FSTREAM (new);
88 scm_t_port *pt = SCM_PTAB_ENTRY (new);
89 scm_t_port *old_pt = SCM_PTAB_ENTRY (old);
90 scm_t_ptob_descriptor *ptob = &scm_ptobs[SCM_PTOBNUM (new)];
92 /* must flush to old fdes. */
93 if (pt->rw_active == SCM_PORT_WRITE)
95 else if (pt->rw_active == SCM_PORT_READ)
97 ans = dup2 (oldfd, newfd);
100 pt->rw_random = old_pt->rw_random;
101 /* continue using existing buffers, even if inappropriate. */
103 return SCM_UNSPECIFIED;
107 SCM_DEFINE (scm_dup_to_fdes, "dup->fdes", 1, 1, 0,
108 (SCM fd_or_port, SCM fd),
109 "Return a new integer file descriptor referring to the open file\n"
110 "designated by @var{fd_or_port}, which must be either an open\n"
111 "file port or a file descriptor.")
112 #define FUNC_NAME s_scm_dup_to_fdes
114 int oldfd, newfd, rv;
116 fd_or_port = SCM_COERCE_OUTPORT (fd_or_port);
118 if (scm_is_integer (fd_or_port))
119 oldfd = scm_to_int (fd_or_port);
122 SCM_VALIDATE_OPFPORT (1, fd_or_port);
123 oldfd = SCM_FPORT_FDES (fd_or_port);
131 fd = scm_from_int (newfd);
135 newfd = scm_to_int (fd);
138 scm_evict_ports (newfd); /* see scsh manual. */
139 rv = dup2 (oldfd, newfd);
149 SCM_DEFINE (scm_dup2, "dup2", 2, 0, 0,
150 (SCM oldfd, SCM newfd),
151 "A simple wrapper for the @code{dup2} system call.\n"
152 "Copies the file descriptor @var{oldfd} to descriptor\n"
153 "number @var{newfd}, replacing the previous meaning\n"
154 "of @var{newfd}. Both @var{oldfd} and @var{newfd} must\n"
156 "Unlike for dup->fdes or primitive-move->fdes, no attempt\n"
157 "is made to move away ports which are using @var{newfd}.\n"
158 "The return value is unspecified.")
159 #define FUNC_NAME s_scm_dup2
165 c_oldfd = scm_to_int (oldfd);
166 c_newfd = scm_to_int (newfd);
167 rv = dup2 (c_oldfd, c_newfd);
170 return SCM_UNSPECIFIED;
174 SCM_DEFINE (scm_fileno, "fileno", 1, 0, 0,
176 "Return the integer file descriptor underlying @var{port}. Does\n"
177 "not change its revealed count.")
178 #define FUNC_NAME s_scm_fileno
180 port = SCM_COERCE_OUTPORT (port);
181 SCM_VALIDATE_OPFPORT (1, port);
182 return scm_from_int (SCM_FPORT_FDES (port));
186 /* GJB:FIXME:: why does this not throw
187 an error if the arg is not a port?
188 This proc as is would be better names isattyport?
189 if it is not going to assume that the arg is a port
191 [cmm] I don't see any problem with the above. why should a type
192 predicate assume _anything_ about its argument?
194 SCM_DEFINE (scm_isatty_p, "isatty?", 1, 0, 0,
196 "Return @code{#t} if @var{port} is using a serial non--file\n"
197 "device, otherwise @code{#f}.")
198 #define FUNC_NAME s_scm_isatty_p
202 port = SCM_COERCE_OUTPORT (port);
204 if (!SCM_OPFPORTP (port))
207 rv = isatty (SCM_FPORT_FDES (port));
208 return scm_from_bool(rv);
214 SCM_DEFINE (scm_fdopen, "fdopen", 2, 0, 0,
215 (SCM fdes, SCM modes),
216 "Return a new port based on the file descriptor @var{fdes}.\n"
217 "Modes are given by the string @var{modes}. The revealed count\n"
218 "of the port is initialized to zero. The modes string is the\n"
219 "same as that accepted by @ref{File Ports, open-file}.")
220 #define FUNC_NAME s_scm_fdopen
222 return scm_i_fdes_to_port (scm_to_int (fdes),
223 scm_i_mode_bits (modes), SCM_BOOL_F);
229 /* Move a port's underlying file descriptor to a given value.
230 * Returns #f if fdes is already the given value.
232 * MOVE->FDES is implemented in Scheme and calls this primitive.
234 SCM_DEFINE (scm_primitive_move_to_fdes, "primitive-move->fdes", 2, 0, 0,
236 "Moves the underlying file descriptor for @var{port} to the integer\n"
237 "value @var{fdes} without changing the revealed count of @var{port}.\n"
238 "Any other ports already using this descriptor will be automatically\n"
239 "shifted to new descriptors and their revealed counts reset to zero.\n"
240 "The return value is @code{#f} if the file descriptor already had the\n"
241 "required value or @code{#t} if it was moved.")
242 #define FUNC_NAME s_scm_primitive_move_to_fdes
249 port = SCM_COERCE_OUTPORT (port);
251 SCM_VALIDATE_OPFPORT (1, port);
252 stream = SCM_FSTREAM (port);
253 old_fd = stream->fdes;
254 new_fd = scm_to_int (fd);
255 if (old_fd == new_fd)
259 scm_evict_ports (new_fd);
260 rv = dup2 (old_fd, new_fd);
263 stream->fdes = new_fd;
264 SCM_SYSCALL (close (old_fd));
269 /* Return a list of ports using a given file descriptor. */
270 SCM_DEFINE (scm_fdes_to_ports, "fdes->ports", 1, 0, 0,
272 "Return a list of existing ports which have @var{fdes} as an\n"
273 "underlying file descriptor, without changing their revealed\n"
275 #define FUNC_NAME s_scm_fdes_to_ports
277 SCM result = SCM_EOL;
281 int_fd = scm_to_int (fd);
283 scm_i_scm_pthread_mutex_lock (&scm_i_port_table_mutex);
284 for (i = 0; i < scm_i_port_table_size; i++)
286 if (SCM_OPFPORTP (scm_i_port_table[i]->port)
287 && ((scm_t_fport *) scm_i_port_table[i]->stream)->fdes == int_fd)
288 result = scm_cons (scm_i_port_table[i]->port, result);
290 scm_i_pthread_mutex_unlock (&scm_i_port_table_mutex);
299 scm_add_feature ("i/o-extensions");
301 #include "libguile/ioext.x"