This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Clarify docs
[perl5.git] / doio.c
1 /*    doio.c
2  *
3  *    Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
4  *    2000, 2001, 2002, 2003, 2004, 2005, by Larry Wall and others
5  *
6  *    You may distribute under the terms of either the GNU General Public
7  *    License or the Artistic License, as specified in the README file.
8  *
9  */
10
11 /*
12  * "Far below them they saw the white waters pour into a foaming bowl, and
13  * then swirl darkly about a deep oval basin in the rocks, until they found
14  * their way out again through a narrow gate, and flowed away, fuming and
15  * chattering, into calmer and more level reaches."
16  */
17
18 /* This file contains functions that do the actual I/O on behalf of ops.
19  * For example, pp_print() calls the do_print() function in this file for
20  * each argument needing printing.
21  */
22
23 #include "EXTERN.h"
24 #define PERL_IN_DOIO_C
25 #include "perl.h"
26
27 #if defined(HAS_MSG) || defined(HAS_SEM) || defined(HAS_SHM)
28 #ifndef HAS_SEM
29 #include <sys/ipc.h>
30 #endif
31 #ifdef HAS_MSG
32 #include <sys/msg.h>
33 #endif
34 #ifdef HAS_SHM
35 #include <sys/shm.h>
36 # ifndef HAS_SHMAT_PROTOTYPE
37     extern Shmat_t shmat (int, char *, int);
38 # endif
39 #endif
40 #endif
41
42 #ifdef I_UTIME
43 #  if defined(_MSC_VER) || defined(__MINGW32__)
44 #    include <sys/utime.h>
45 #  else
46 #    include <utime.h>
47 #  endif
48 #endif
49
50 #ifdef O_EXCL
51 #  define OPEN_EXCL O_EXCL
52 #else
53 #  define OPEN_EXCL 0
54 #endif
55
56 #define PERL_MODE_MAX 8
57 #define PERL_FLAGS_MAX 10
58
59 #include <signal.h>
60
61 bool
62 Perl_do_open(pTHX_ GV *gv, register char *name, I32 len, int as_raw,
63              int rawmode, int rawperm, PerlIO *supplied_fp)
64 {
65     return do_openn(gv, name, len, as_raw, rawmode, rawperm,
66                     supplied_fp, (SV **) NULL, 0);
67 }
68
69 bool
70 Perl_do_open9(pTHX_ GV *gv, register char *name, I32 len, int as_raw,
71               int rawmode, int rawperm, PerlIO *supplied_fp, SV *svs,
72               I32 num_svs)
73 {
74     PERL_UNUSED_ARG(num_svs);
75     return do_openn(gv, name, len, as_raw, rawmode, rawperm,
76                     supplied_fp, &svs, 1);
77 }
78
79 bool
80 Perl_do_openn(pTHX_ GV *gv, register char *name, I32 len, int as_raw,
81               int rawmode, int rawperm, PerlIO *supplied_fp, SV **svp,
82               I32 num_svs)
83 {
84     dVAR;
85     register IO * const io = GvIOn(gv);
86     PerlIO *saveifp = Nullfp;
87     PerlIO *saveofp = Nullfp;
88     int savefd = -1;
89     char savetype = IoTYPE_CLOSED;
90     int writing = 0;
91     PerlIO *fp;
92     int fd;
93     int result;
94     bool was_fdopen = FALSE;
95     bool in_raw = 0, in_crlf = 0, out_raw = 0, out_crlf = 0;
96     char *type  = NULL;
97     char mode[PERL_MODE_MAX];   /* stdio file mode ("r\0", "rb\0", "r+b\0" etc.) */
98     SV *namesv;
99
100     Zero(mode,sizeof(mode),char);
101     PL_forkprocess = 1;         /* assume true if no fork */
102
103     /* Collect default raw/crlf info from the op */
104     if (PL_op && PL_op->op_type == OP_OPEN) {
105         /* set up IO layers */
106         const U8 flags = PL_op->op_private;
107         in_raw = (flags & OPpOPEN_IN_RAW);
108         in_crlf = (flags & OPpOPEN_IN_CRLF);
109         out_raw = (flags & OPpOPEN_OUT_RAW);
110         out_crlf = (flags & OPpOPEN_OUT_CRLF);
111     }
112
113     /* If currently open - close before we re-open */
114     if (IoIFP(io)) {
115         fd = PerlIO_fileno(IoIFP(io));
116         if (IoTYPE(io) == IoTYPE_STD) {
117             /* This is a clone of one of STD* handles */
118             result = 0;
119         }
120         else if (fd >= 0 && fd <= PL_maxsysfd) {
121             /* This is one of the original STD* handles */
122             saveifp  = IoIFP(io);
123             saveofp  = IoOFP(io);
124             savetype = IoTYPE(io);
125             savefd   = fd;
126             result   = 0;
127         }
128         else if (IoTYPE(io) == IoTYPE_PIPE)
129             result = PerlProc_pclose(IoIFP(io));
130         else if (IoIFP(io) != IoOFP(io)) {
131             if (IoOFP(io)) {
132                 result = PerlIO_close(IoOFP(io));
133                 PerlIO_close(IoIFP(io)); /* clear stdio, fd already closed */
134             }
135             else
136                 result = PerlIO_close(IoIFP(io));
137         }
138         else
139             result = PerlIO_close(IoIFP(io));
140         if (result == EOF && fd > PL_maxsysfd) {
141             /* Why is this not Perl_warn*() call ? */
142             PerlIO_printf(Perl_error_log,
143                           "Warning: unable to close filehandle %s properly.\n",
144                           GvENAME(gv));
145         }
146         IoOFP(io) = IoIFP(io) = Nullfp;
147     }
148
149     if (as_raw) {
150         /* sysopen style args, i.e. integer mode and permissions */
151         STRLEN ix = 0;
152         const int appendtrunc =
153              0
154 #ifdef O_APPEND /* Not fully portable. */
155              |O_APPEND
156 #endif
157 #ifdef O_TRUNC  /* Not fully portable. */
158              |O_TRUNC
159 #endif
160              ;
161         const int modifyingmode = O_WRONLY|O_RDWR|O_CREAT|appendtrunc;
162         int ismodifying;
163
164         if (num_svs != 0) {
165              Perl_croak(aTHX_ "panic: sysopen with multiple args");
166         }
167         /* It's not always
168
169            O_RDONLY 0
170            O_WRONLY 1
171            O_RDWR   2
172
173            It might be (in OS/390 and Mac OS Classic it is)
174
175            O_WRONLY 1
176            O_RDONLY 2
177            O_RDWR   3
178
179            This means that simple & with O_RDWR would look
180            like O_RDONLY is present.  Therefore we have to
181            be more careful.
182         */
183         if ((ismodifying = (rawmode & modifyingmode))) {
184              if ((ismodifying & O_WRONLY) == O_WRONLY ||
185                  (ismodifying & O_RDWR)   == O_RDWR   ||
186                  (ismodifying & (O_CREAT|appendtrunc)))
187                   TAINT_PROPER("sysopen");
188         }
189         mode[ix++] = IoTYPE_NUMERIC; /* Marker to openn to use numeric "sysopen" */
190
191 #if defined(USE_64_BIT_RAWIO) && defined(O_LARGEFILE)
192         rawmode |= O_LARGEFILE; /* Transparently largefiley. */
193 #endif
194
195         IoTYPE(io) = PerlIO_intmode2str(rawmode, &mode[ix], &writing);
196
197         namesv = sv_2mortal(newSVpvn(name,strlen(name)));
198         num_svs = 1;
199         svp = &namesv;
200         type = Nullch;
201         fp = PerlIO_openn(aTHX_ type, mode, -1, rawmode, rawperm, NULL, num_svs, svp);
202     }
203     else {
204         /* Regular (non-sys) open */
205         char *oname = name;
206         STRLEN olen = len;
207         char *tend;
208         int dodup = 0;
209         PerlIO *that_fp = NULL;
210
211         type = savepvn(name, len);
212         tend = type+len;
213         SAVEFREEPV(type);
214
215         /* Lose leading and trailing white space */
216         for (; isSPACE(*type); type++) ;
217         while (tend > type && isSPACE(tend[-1]))
218             *--tend = '\0';
219
220         if (num_svs) {
221             /* New style explicit name, type is just mode and layer info */
222 #ifdef USE_STDIO
223             if (SvROK(*svp) && !strchr(name,'&')) {
224                 if (ckWARN(WARN_IO))
225                     Perl_warner(aTHX_ packWARN(WARN_IO),
226                             "Can't open a reference");
227                 SETERRNO(EINVAL, LIB_INVARG);
228                 goto say_false;
229             }
230 #endif /* USE_STDIO */
231             name = SvOK(*svp) ? savesvpv (*svp) : savepvn ("", 0);
232             SAVEFREEPV(name);
233         }
234         else {
235             name = type;
236             len  = tend-type;
237         }
238         IoTYPE(io) = *type;
239         if ((*type == IoTYPE_RDWR) && /* scary */
240            (*(type+1) == IoTYPE_RDONLY || *(type+1) == IoTYPE_WRONLY) &&
241             ((!num_svs || (tend > type+1 && tend[-1] != IoTYPE_PIPE)))) {
242             TAINT_PROPER("open");
243             mode[1] = *type++;
244             writing = 1;
245         }
246
247         if (*type == IoTYPE_PIPE) {
248             if (num_svs) {
249                 if (type[1] != IoTYPE_STD) {
250                   unknown_open_mode:
251                     Perl_croak(aTHX_ "Unknown open() mode '%.*s'", (int)olen, oname);
252                 }
253                 type++;
254             }
255             for (type++; isSPACE(*type); type++) ;
256             if (!num_svs) {
257                 name = type;
258                 len = tend-type;
259             }
260             if (*name == '\0') {
261                 /* command is missing 19990114 */
262                 if (ckWARN(WARN_PIPE))
263                     Perl_warner(aTHX_ packWARN(WARN_PIPE), "Missing command in piped open");
264                 errno = EPIPE;
265                 goto say_false;
266             }
267             if ((*name == '-' && name[1] == '\0') || num_svs)
268                 TAINT_ENV();
269             TAINT_PROPER("piped open");
270             if (!num_svs && name[len-1] == '|') {
271                 name[--len] = '\0' ;
272                 if (ckWARN(WARN_PIPE))
273                     Perl_warner(aTHX_ packWARN(WARN_PIPE), "Can't open bidirectional pipe");
274             }
275             mode[0] = 'w';
276             writing = 1;
277 #ifdef HAS_STRLCAT
278             if (out_raw)
279                 strlcat(mode, "b", PERL_MODE_MAX);
280             else if (out_crlf)
281                 strlcat(mode, "t", PERL_MODE_MAX); 
282 #else
283             if (out_raw)
284                 strcat(mode, "b");
285             else if (out_crlf)
286                 strcat(mode, "t");
287 #endif
288             if (num_svs > 1) {
289                 fp = PerlProc_popen_list(mode, num_svs, svp);
290             }
291             else {
292                 fp = PerlProc_popen(name,mode);
293             }
294             if (num_svs) {
295                 if (*type) {
296                     if (PerlIO_apply_layers(aTHX_ fp, mode, type) != 0) {
297                         goto say_false;
298                     }
299                 }
300             }
301         } /* IoTYPE_PIPE */
302         else if (*type == IoTYPE_WRONLY) {
303             TAINT_PROPER("open");
304             type++;
305             if (*type == IoTYPE_WRONLY) {
306                 /* Two IoTYPE_WRONLYs in a row make for an IoTYPE_APPEND. */
307                 mode[0] = IoTYPE(io) = IoTYPE_APPEND;
308                 type++;
309             }
310             else {
311                 mode[0] = 'w';
312             }
313             writing = 1;
314
315 #ifdef HAS_STRLCAT
316             if (out_raw)
317                 strlcat(mode, "b", PERL_MODE_MAX);
318             else if (out_crlf)
319                 strlcat(mode, "t", PERL_MODE_MAX);
320 #else
321             if (out_raw)
322                 strcat(mode, "b");
323             else if (out_crlf)
324                 strcat(mode, "t");
325 #endif
326             if (*type == '&') {
327               duplicity:
328                 dodup = PERLIO_DUP_FD;
329                 type++;
330                 if (*type == '=') {
331                     dodup = 0;
332                     type++;
333                 }
334                 if (!num_svs && !*type && supplied_fp) {
335                     /* "<+&" etc. is used by typemaps */
336                     fp = supplied_fp;
337                 }
338                 else {
339                     if (num_svs > 1) {
340                         Perl_croak(aTHX_ "More than one argument to '%c&' open",IoTYPE(io));
341                     }
342                     for (; isSPACE(*type); type++) ;
343                     if (num_svs && (SvIOK(*svp) || (SvPOK(*svp) && looks_like_number(*svp)))) {
344                         fd = SvUV(*svp);
345                         num_svs = 0;
346                     }
347                     else if (isDIGIT(*type)) {
348                         fd = atoi(type);
349                     }
350                     else {
351                         const IO* thatio;
352                         if (num_svs) {
353                             thatio = sv_2io(*svp);
354                         }
355                         else {
356                             GV *thatgv;
357                             thatgv = gv_fetchpv(type,FALSE,SVt_PVIO);
358                             thatio = GvIO(thatgv);
359                         }
360                         if (!thatio) {
361 #ifdef EINVAL
362                             SETERRNO(EINVAL,SS_IVCHAN);
363 #endif
364                             goto say_false;
365                         }
366                         if ((that_fp = IoIFP(thatio))) {
367                             /* Flush stdio buffer before dup. --mjd
368                              * Unfortunately SEEK_CURing 0 seems to
369                              * be optimized away on most platforms;
370                              * only Solaris and Linux seem to flush
371                              * on that. --jhi */
372 #ifdef USE_SFIO
373                             /* sfio fails to clear error on next
374                                sfwrite, contrary to documentation.
375                                -- Nick Clark */
376                             if (PerlIO_seek(that_fp, 0, SEEK_CUR) == -1)
377                                 PerlIO_clearerr(that_fp);
378 #endif
379                             /* On the other hand, do all platforms
380                              * take gracefully to flushing a read-only
381                              * filehandle?  Perhaps we should do
382                              * fsetpos(src)+fgetpos(dst)?  --nik */
383                             PerlIO_flush(that_fp);
384                             fd = PerlIO_fileno(that_fp);
385                             /* When dup()ing STDIN, STDOUT or STDERR
386                              * explicitly set appropriate access mode */
387                             if (that_fp == PerlIO_stdout()
388                                 || that_fp == PerlIO_stderr())
389                                 IoTYPE(io) = IoTYPE_WRONLY;
390                             else if (that_fp == PerlIO_stdin())
391                                 IoTYPE(io) = IoTYPE_RDONLY;
392                             /* When dup()ing a socket, say result is
393                              * one as well */
394                             else if (IoTYPE(thatio) == IoTYPE_SOCKET)
395                                 IoTYPE(io) = IoTYPE_SOCKET;
396                         }
397                         else
398                             fd = -1;
399                     }
400                     if (!num_svs)
401                         type = Nullch;
402                     if (that_fp) {
403                         fp = PerlIO_fdupopen(aTHX_ that_fp, NULL, dodup);
404                     }
405                     else {
406                         if (dodup)
407                             fd = PerlLIO_dup(fd);
408                         else
409                             was_fdopen = TRUE;
410                         if (!(fp = PerlIO_openn(aTHX_ type,mode,fd,0,0,NULL,num_svs,svp))) {
411                             if (dodup)
412                                 PerlLIO_close(fd);
413                         }
414                     }
415                 }
416             } /* & */
417             else {
418                 for (; isSPACE(*type); type++) ;
419                 if (*type == IoTYPE_STD && (!type[1] || isSPACE(type[1]) || type[1] == ':')) {
420                     type++;
421                     fp = PerlIO_stdout();
422                     IoTYPE(io) = IoTYPE_STD;
423                     if (num_svs > 1) {
424                         Perl_croak(aTHX_ "More than one argument to '>%c' open",IoTYPE_STD);
425                     }
426                 }
427                 else  {
428                     if (!num_svs) {
429                         namesv = sv_2mortal(newSVpvn(type,strlen(type)));
430                         num_svs = 1;
431                         svp = &namesv;
432                         type = Nullch;
433                     }
434                     fp = PerlIO_openn(aTHX_ type,mode,-1,0,0,NULL,num_svs,svp);
435                 }
436             } /* !& */
437             if (!fp && type && *type && *type != ':' && !isIDFIRST(*type))
438                goto unknown_open_mode;
439         } /* IoTYPE_WRONLY */
440         else if (*type == IoTYPE_RDONLY) {
441             for (type++; isSPACE(*type); type++) ;
442             mode[0] = 'r';
443 #ifdef HAS_STRLCAT
444             if (in_raw)
445                 strlcat(mode, "b", PERL_MODE_MAX);
446             else if (in_crlf)
447                 strlcat(mode, "t", PERL_MODE_MAX);
448 #else
449             if (in_raw)
450                 strcat(mode, "b");
451             else if (in_crlf)
452                 strcat(mode, "t");
453 #endif
454             if (*type == '&') {
455                 goto duplicity;
456             }
457             if (*type == IoTYPE_STD && (!type[1] || isSPACE(type[1]) || type[1] == ':')) {
458                 type++;
459                 fp = PerlIO_stdin();
460                 IoTYPE(io) = IoTYPE_STD;
461                 if (num_svs > 1) {
462                     Perl_croak(aTHX_ "More than one argument to '<%c' open",IoTYPE_STD);
463                 }
464             }
465             else {
466                 if (!num_svs) {
467                     namesv = sv_2mortal(newSVpvn(type,strlen(type)));
468                     num_svs = 1;
469                     svp = &namesv;
470                     type = Nullch;
471                 }
472                 fp = PerlIO_openn(aTHX_ type,mode,-1,0,0,NULL,num_svs,svp);
473             }
474             if (!fp && type && *type && *type != ':' && !isIDFIRST(*type))
475                goto unknown_open_mode;
476         } /* IoTYPE_RDONLY */
477         else if ((num_svs && /* '-|...' or '...|' */
478                   type[0] == IoTYPE_STD && type[1] == IoTYPE_PIPE) ||
479                  (!num_svs && tend > type+1 && tend[-1] == IoTYPE_PIPE)) {
480             if (num_svs) {
481                 type += 2;   /* skip over '-|' */
482             }
483             else {
484                 *--tend = '\0';
485                 while (tend > type && isSPACE(tend[-1]))
486                     *--tend = '\0';
487                 for (; isSPACE(*type); type++)
488                     ;
489                 name = type;
490                 len  = tend-type;
491             }
492             if (*name == '\0') {
493                 /* command is missing 19990114 */
494                 if (ckWARN(WARN_PIPE))
495                     Perl_warner(aTHX_ packWARN(WARN_PIPE), "Missing command in piped open");
496                 errno = EPIPE;
497                 goto say_false;
498             }
499             if (!(*name == '-' && name[1] == '\0') || num_svs)
500                 TAINT_ENV();
501             TAINT_PROPER("piped open");
502             mode[0] = 'r';
503
504 #ifdef HAS_STRLCAT
505             if (in_raw)
506                 strlcat(mode, "b", PERL_MODE_MAX);
507             else if (in_crlf)
508                 strlcat(mode, "t", PERL_MODE_MAX);
509 #else
510             if (in_raw)
511                 strcat(mode, "b");
512             else if (in_crlf)
513                 strcat(mode, "t");
514 #endif
515
516             if (num_svs > 1) {
517                 fp = PerlProc_popen_list(mode,num_svs,svp);
518             }
519             else {
520                 fp = PerlProc_popen(name,mode);
521             }
522             IoTYPE(io) = IoTYPE_PIPE;
523             if (num_svs) {
524                 for (; isSPACE(*type); type++) ;
525                 if (*type) {
526                     if (PerlIO_apply_layers(aTHX_ fp, mode, type) != 0) {
527                         goto say_false;
528                     }
529                 }
530             }
531         }
532         else { /* layer(Args) */
533             if (num_svs)
534                 goto unknown_open_mode;
535             name = type;
536             IoTYPE(io) = IoTYPE_RDONLY;
537             for (; isSPACE(*name); name++)
538                 ;
539             mode[0] = 'r';
540
541 #ifdef HAS_STRLCAT
542             if (in_raw)
543                 strlcat(mode, "b", PERL_MODE_MAX);
544             else if (in_crlf)
545                 strlcat(mode, "t", PERL_MODE_MAX);
546 #else
547             if (in_raw)
548                 strcat(mode, "b");
549             else if (in_crlf)
550                 strcat(mode, "t");
551 #endif
552
553             if (*name == '-' && name[1] == '\0') {
554                 fp = PerlIO_stdin();
555                 IoTYPE(io) = IoTYPE_STD;
556             }
557             else {
558                 if (!num_svs) {
559                     namesv = sv_2mortal(newSVpvn(type,strlen(type)));
560                     num_svs = 1;
561                     svp = &namesv;
562                     type = Nullch;
563                 }
564                 fp = PerlIO_openn(aTHX_ type,mode,-1,0,0,NULL,num_svs,svp);
565             }
566         }
567     }
568     if (!fp) {
569         if (IoTYPE(io) == IoTYPE_RDONLY && ckWARN(WARN_NEWLINE)
570             && strchr(name, '\n')
571             
572         )
573             Perl_warner(aTHX_ packWARN(WARN_NEWLINE), PL_warn_nl, "open");
574         goto say_false;
575     }
576
577     if (ckWARN(WARN_IO)) {
578         if ((IoTYPE(io) == IoTYPE_RDONLY) &&
579             (fp == PerlIO_stdout() || fp == PerlIO_stderr())) {
580                 Perl_warner(aTHX_ packWARN(WARN_IO),
581                             "Filehandle STD%s reopened as %s only for input",
582                             ((fp == PerlIO_stdout()) ? "OUT" : "ERR"),
583                             GvENAME(gv));
584         }
585         else if ((IoTYPE(io) == IoTYPE_WRONLY) && fp == PerlIO_stdin()) {
586                 Perl_warner(aTHX_ packWARN(WARN_IO),
587                             "Filehandle STDIN reopened as %s only for output",
588                             GvENAME(gv));
589         }
590     }
591
592     fd = PerlIO_fileno(fp);
593     /* If there is no fd (e.g. PerlIO::scalar) assume it isn't a
594      * socket - this covers PerlIO::scalar - otherwise unless we "know" the
595      * type probe for socket-ness.
596      */
597     if (IoTYPE(io) && IoTYPE(io) != IoTYPE_PIPE && IoTYPE(io) != IoTYPE_STD && fd >= 0) {
598         if (PerlLIO_fstat(fd,&PL_statbuf) < 0) {
599             /* If PerlIO claims to have fd we had better be able to fstat() it. */
600             (void) PerlIO_close(fp);
601             goto say_false;
602         }
603 #ifndef PERL_MICRO
604         if (S_ISSOCK(PL_statbuf.st_mode))
605             IoTYPE(io) = IoTYPE_SOCKET; /* in case a socket was passed in to us */
606 #ifdef HAS_SOCKET
607         else if (
608 #ifdef S_IFMT
609             !(PL_statbuf.st_mode & S_IFMT)
610 #else
611             !PL_statbuf.st_mode
612 #endif
613             && IoTYPE(io) != IoTYPE_WRONLY  /* Dups of STD* filehandles already have */
614             && IoTYPE(io) != IoTYPE_RDONLY  /* type so they aren't marked as sockets */
615         ) {                                 /* on OS's that return 0 on fstat()ed pipe */
616              char tmpbuf[256];
617              Sock_size_t buflen = sizeof tmpbuf;
618              if (PerlSock_getsockname(fd, (struct sockaddr *)tmpbuf, &buflen) >= 0
619                       || errno != ENOTSOCK)
620                     IoTYPE(io) = IoTYPE_SOCKET; /* some OS's return 0 on fstat()ed socket */
621                                                 /* but some return 0 for streams too, sigh */
622         }
623 #endif /* HAS_SOCKET */
624 #endif /* !PERL_MICRO */
625     }
626
627     /* Eeek - FIXME !!!
628      * If this is a standard handle we discard all the layer stuff
629      * and just dup the fd into whatever was on the handle before !
630      */
631
632     if (saveifp) {              /* must use old fp? */
633         /* If fd is less that PL_maxsysfd i.e. STDIN..STDERR
634            then dup the new fileno down
635          */
636         if (saveofp) {
637             PerlIO_flush(saveofp);      /* emulate PerlIO_close() */
638             if (saveofp != saveifp) {   /* was a socket? */
639                 PerlIO_close(saveofp);
640             }
641         }
642         if (savefd != fd) {
643             /* Still a small can-of-worms here if (say) PerlIO::scalar
644                is assigned to (say) STDOUT - for now let dup2() fail
645                and provide the error
646              */
647             if (PerlLIO_dup2(fd, savefd) < 0) {
648                 (void)PerlIO_close(fp);
649                 goto say_false;
650             }
651 #ifdef VMS
652             if (savefd != PerlIO_fileno(PerlIO_stdin())) {
653                 char newname[FILENAME_MAX+1];
654                 if (PerlIO_getname(fp, newname)) {
655                     if (fd == PerlIO_fileno(PerlIO_stdout()))
656                         Perl_vmssetuserlnm(aTHX_ "SYS$OUTPUT", newname);
657                     if (fd == PerlIO_fileno(PerlIO_stderr()))
658                         Perl_vmssetuserlnm(aTHX_ "SYS$ERROR",  newname);
659                 }
660             }
661 #endif
662
663 #if !defined(WIN32)
664            /* PL_fdpid isn't used on Windows, so avoid this useless work.
665             * XXX Probably the same for a lot of other places. */
666             {
667                 Pid_t pid;
668                 SV *sv;
669
670                 LOCK_FDPID_MUTEX;
671                 sv = *av_fetch(PL_fdpid,fd,TRUE);
672                 SvUPGRADE(sv, SVt_IV);
673                 pid = SvIVX(sv);
674                 SvIV_set(sv, 0);
675                 sv = *av_fetch(PL_fdpid,savefd,TRUE);
676                 SvUPGRADE(sv, SVt_IV);
677                 SvIV_set(sv, pid);
678                 UNLOCK_FDPID_MUTEX;
679             }
680 #endif
681
682             if (was_fdopen) {
683                 /* need to close fp without closing underlying fd */
684                 int ofd = PerlIO_fileno(fp);
685                 int dupfd = PerlLIO_dup(ofd);
686 #if defined(HAS_FCNTL) && defined(F_SETFD)
687                 /* Assume if we have F_SETFD we have F_GETFD */
688                 int coe = fcntl(ofd,F_GETFD);
689 #endif
690                 PerlIO_close(fp);
691                 PerlLIO_dup2(dupfd,ofd);
692 #if defined(HAS_FCNTL) && defined(F_SETFD)
693                 /* The dup trick has lost close-on-exec on ofd */
694                 fcntl(ofd,F_SETFD, coe);
695 #endif
696                 PerlLIO_close(dupfd);
697             }
698             else
699                 PerlIO_close(fp);
700         }
701         fp = saveifp;
702         PerlIO_clearerr(fp);
703         fd = PerlIO_fileno(fp);
704     }
705 #if defined(HAS_FCNTL) && defined(F_SETFD)
706     if (fd >= 0) {
707         int save_errno = errno;
708         fcntl(fd,F_SETFD,fd > PL_maxsysfd); /* can change errno */
709         errno = save_errno;
710     }
711 #endif
712     IoIFP(io) = fp;
713
714     IoFLAGS(io) &= ~IOf_NOLINE;
715     if (writing) {
716         if (IoTYPE(io) == IoTYPE_SOCKET
717             || (IoTYPE(io) == IoTYPE_WRONLY && fd >= 0 && S_ISCHR(PL_statbuf.st_mode)) ) {
718             char *s = mode;
719             if (*s == IoTYPE_IMPLICIT || *s == IoTYPE_NUMERIC)
720               s++;
721             *s = 'w';
722             if (!(IoOFP(io) = PerlIO_openn(aTHX_ type,s,fd,0,0,NULL,0,svp))) {
723                 PerlIO_close(fp);
724                 IoIFP(io) = Nullfp;
725                 goto say_false;
726             }
727         }
728         else
729             IoOFP(io) = fp;
730     }
731     return TRUE;
732
733 say_false:
734     IoIFP(io) = saveifp;
735     IoOFP(io) = saveofp;
736     IoTYPE(io) = savetype;
737     return FALSE;
738 }
739
740 PerlIO *
741 Perl_nextargv(pTHX_ register GV *gv)
742 {
743     register SV *sv;
744 #ifndef FLEXFILENAMES
745     int filedev;
746     int fileino;
747 #endif
748     Uid_t fileuid;
749     Gid_t filegid;
750     IO * const io = GvIOp(gv);
751
752     if (!PL_argvoutgv)
753         PL_argvoutgv = gv_fetchpv("ARGVOUT",TRUE,SVt_PVIO);
754     if (io && (IoFLAGS(io) & IOf_ARGV) && (IoFLAGS(io) & IOf_START)) {
755         IoFLAGS(io) &= ~IOf_START;
756         if (PL_inplace) {
757             if (!PL_argvout_stack)
758                 PL_argvout_stack = newAV();
759             av_push(PL_argvout_stack, SvREFCNT_inc(PL_defoutgv));
760         }
761     }
762     if (PL_filemode & (S_ISUID|S_ISGID)) {
763         PerlIO_flush(IoIFP(GvIOn(PL_argvoutgv)));  /* chmod must follow last write */
764 #ifdef HAS_FCHMOD
765         if (PL_lastfd != -1)
766             (void)fchmod(PL_lastfd,PL_filemode);
767 #else
768         (void)PerlLIO_chmod(PL_oldname,PL_filemode);
769 #endif
770     }
771     PL_lastfd = -1;
772     PL_filemode = 0;
773     if (!GvAV(gv))
774         return Nullfp;
775     while (av_len(GvAV(gv)) >= 0) {
776         STRLEN oldlen;
777         sv = av_shift(GvAV(gv));
778         SAVEFREESV(sv);
779         sv_setsv(GvSVn(gv),sv);
780         SvSETMAGIC(GvSV(gv));
781         PL_oldname = SvPVx(GvSV(gv), oldlen);
782         if (do_open(gv,PL_oldname,oldlen,PL_inplace!=0,O_RDONLY,0,Nullfp)) {
783             if (PL_inplace) {
784                 TAINT_PROPER("inplace open");
785                 if (oldlen == 1 && *PL_oldname == '-') {
786                     setdefout(gv_fetchpv("STDOUT",TRUE,SVt_PVIO));
787                     return IoIFP(GvIOp(gv));
788                 }
789 #ifndef FLEXFILENAMES
790                 filedev = PL_statbuf.st_dev;
791                 fileino = PL_statbuf.st_ino;
792 #endif
793                 PL_filemode = PL_statbuf.st_mode;
794                 fileuid = PL_statbuf.st_uid;
795                 filegid = PL_statbuf.st_gid;
796                 if (!S_ISREG(PL_filemode)) {
797                     if (ckWARN_d(WARN_INPLACE)) 
798                         Perl_warner(aTHX_ packWARN(WARN_INPLACE),
799                             "Can't do inplace edit: %s is not a regular file",
800                             PL_oldname );
801                     do_close(gv,FALSE);
802                     continue;
803                 }
804                 if (*PL_inplace) {
805                     const char *star = strchr(PL_inplace, '*');
806                     if (star) {
807                         const char *begin = PL_inplace;
808                         sv_setpvn(sv, "", 0);
809                         do {
810                             sv_catpvn(sv, begin, star - begin);
811                             sv_catpvn(sv, PL_oldname, oldlen);
812                             begin = ++star;
813                         } while ((star = strchr(begin, '*')));
814                         if (*begin)
815                             sv_catpv(sv,begin);
816                     }
817                     else {
818                         sv_catpv(sv,PL_inplace);
819                     }
820 #ifndef FLEXFILENAMES
821                     if ((PerlLIO_stat(SvPVX_const(sv),&PL_statbuf) >= 0
822                          && PL_statbuf.st_dev == filedev
823                          && PL_statbuf.st_ino == fileino)
824 #ifdef DJGPP
825                         || ((_djstat_fail_bits & _STFAIL_TRUENAME)!=0)
826 #endif
827                       )
828                     {
829                         if (ckWARN_d(WARN_INPLACE))     
830                             Perl_warner(aTHX_ packWARN(WARN_INPLACE),
831                               "Can't do inplace edit: %"SVf" would not be unique",
832                               sv);
833                         do_close(gv,FALSE);
834                         continue;
835                     }
836 #endif
837 #ifdef HAS_RENAME
838 #if !defined(DOSISH) && !defined(__CYGWIN__) && !defined(EPOC)
839                     if (PerlLIO_rename(PL_oldname,SvPVX_const(sv)) < 0) {
840                         if (ckWARN_d(WARN_INPLACE))     
841                             Perl_warner(aTHX_ packWARN(WARN_INPLACE),
842                               "Can't rename %s to %"SVf": %s, skipping file",
843                               PL_oldname, sv, Strerror(errno) );
844                         do_close(gv,FALSE);
845                         continue;
846                     }
847 #else
848                     do_close(gv,FALSE);
849                     (void)PerlLIO_unlink(SvPVX_const(sv));
850                     (void)PerlLIO_rename(PL_oldname,SvPVX_const(sv));
851                     do_open(gv,(char*)SvPVX_const(sv),SvCUR(sv),PL_inplace!=0,
852                             O_RDONLY,0,Nullfp);
853 #endif /* DOSISH */
854 #else
855                     (void)UNLINK(SvPVX_const(sv));
856                     if (link(PL_oldname,SvPVX_const(sv)) < 0) {
857                         if (ckWARN_d(WARN_INPLACE))     
858                             Perl_warner(aTHX_ packWARN(WARN_INPLACE),
859                               "Can't rename %s to %"SVf": %s, skipping file",
860                               PL_oldname, sv, Strerror(errno) );
861                         do_close(gv,FALSE);
862                         continue;
863                     }
864                     (void)UNLINK(PL_oldname);
865 #endif
866                 }
867                 else {
868 #if !defined(DOSISH) && !defined(AMIGAOS)
869 #  ifndef VMS  /* Don't delete; use automatic file versioning */
870                     if (UNLINK(PL_oldname) < 0) {
871                         if (ckWARN_d(WARN_INPLACE))     
872                             Perl_warner(aTHX_ packWARN(WARN_INPLACE),
873                               "Can't remove %s: %s, skipping file",
874                               PL_oldname, Strerror(errno) );
875                         do_close(gv,FALSE);
876                         continue;
877                     }
878 #  endif
879 #else
880                     Perl_croak(aTHX_ "Can't do inplace edit without backup");
881 #endif
882                 }
883
884                 sv_setpvn(sv,">",!PL_inplace);
885                 sv_catpvn(sv,PL_oldname,oldlen);
886                 SETERRNO(0,0);          /* in case sprintf set errno */
887 #ifdef VMS
888                 if (!do_open(PL_argvoutgv,(char*)SvPVX_const(sv),SvCUR(sv),
889                              PL_inplace!=0,O_WRONLY|O_CREAT|O_TRUNC,0,Nullfp))
890 #else
891                     if (!do_open(PL_argvoutgv,(char*)SvPVX_const(sv),SvCUR(sv),
892                              PL_inplace!=0,O_WRONLY|O_CREAT|OPEN_EXCL,0666,
893                              Nullfp))
894 #endif
895                 {
896                     if (ckWARN_d(WARN_INPLACE)) 
897                         Perl_warner(aTHX_ packWARN(WARN_INPLACE), "Can't do inplace edit on %s: %s",
898                           PL_oldname, Strerror(errno) );
899                     do_close(gv,FALSE);
900                     continue;
901                 }
902                 setdefout(PL_argvoutgv);
903                 PL_lastfd = PerlIO_fileno(IoIFP(GvIOp(PL_argvoutgv)));
904                 (void)PerlLIO_fstat(PL_lastfd,&PL_statbuf);
905 #ifdef HAS_FCHMOD
906                 (void)fchmod(PL_lastfd,PL_filemode);
907 #else
908 #  if !(defined(WIN32) && defined(__BORLANDC__))
909                 /* Borland runtime creates a readonly file! */
910                 (void)PerlLIO_chmod(PL_oldname,PL_filemode);
911 #  endif
912 #endif
913                 if (fileuid != PL_statbuf.st_uid || filegid != PL_statbuf.st_gid) {
914 #ifdef HAS_FCHOWN
915                     (void)fchown(PL_lastfd,fileuid,filegid);
916 #else
917 #ifdef HAS_CHOWN
918                     (void)PerlLIO_chown(PL_oldname,fileuid,filegid);
919 #endif
920 #endif
921                 }
922             }
923             return IoIFP(GvIOp(gv));
924         }
925         else {
926             if (ckWARN_d(WARN_INPLACE)) {
927                 const int eno = errno;
928                 if (PerlLIO_stat(PL_oldname, &PL_statbuf) >= 0
929                     && !S_ISREG(PL_statbuf.st_mode))    
930                 {
931                     Perl_warner(aTHX_ packWARN(WARN_INPLACE),
932                                 "Can't do inplace edit: %s is not a regular file",
933                                 PL_oldname);
934                 }
935                 else
936                     Perl_warner(aTHX_ packWARN(WARN_INPLACE), "Can't open %s: %s",
937                                 PL_oldname, Strerror(eno));
938             }
939         }
940     }
941     if (io && (IoFLAGS(io) & IOf_ARGV))
942         IoFLAGS(io) |= IOf_START;
943     if (PL_inplace) {
944         (void)do_close(PL_argvoutgv,FALSE);
945         if (io && (IoFLAGS(io) & IOf_ARGV)
946             && PL_argvout_stack && AvFILLp(PL_argvout_stack) >= 0)
947         {
948             GV *oldout = (GV*)av_pop(PL_argvout_stack);
949             setdefout(oldout);
950             SvREFCNT_dec(oldout);
951             return Nullfp;
952         }
953         setdefout(gv_fetchpv("STDOUT",TRUE,SVt_PVIO));
954     }
955     return Nullfp;
956 }
957
958 #ifdef HAS_PIPE
959 void
960 Perl_do_pipe(pTHX_ SV *sv, GV *rgv, GV *wgv)
961 {
962     register IO *rstio;
963     register IO *wstio;
964     int fd[2];
965
966     if (!rgv)
967         goto badexit;
968     if (!wgv)
969         goto badexit;
970
971     rstio = GvIOn(rgv);
972     wstio = GvIOn(wgv);
973
974     if (IoIFP(rstio))
975         do_close(rgv,FALSE);
976     if (IoIFP(wstio))
977         do_close(wgv,FALSE);
978
979     if (PerlProc_pipe(fd) < 0)
980         goto badexit;
981     IoIFP(rstio) = PerlIO_fdopen(fd[0], "r"PIPE_OPEN_MODE);
982     IoOFP(wstio) = PerlIO_fdopen(fd[1], "w"PIPE_OPEN_MODE);
983     IoOFP(rstio) = IoIFP(rstio);
984     IoIFP(wstio) = IoOFP(wstio);
985     IoTYPE(rstio) = IoTYPE_RDONLY;
986     IoTYPE(wstio) = IoTYPE_WRONLY;
987     if (!IoIFP(rstio) || !IoOFP(wstio)) {
988         if (IoIFP(rstio)) PerlIO_close(IoIFP(rstio));
989         else PerlLIO_close(fd[0]);
990         if (IoOFP(wstio)) PerlIO_close(IoOFP(wstio));
991         else PerlLIO_close(fd[1]);
992         goto badexit;
993     }
994
995     sv_setsv(sv,&PL_sv_yes);
996     return;
997
998 badexit:
999     sv_setsv(sv,&PL_sv_undef);
1000     return;
1001 }
1002 #endif
1003
1004 /* explicit renamed to avoid C++ conflict    -- kja */
1005 bool
1006 Perl_do_close(pTHX_ GV *gv, bool not_implicit)
1007 {
1008     bool retval;
1009     IO *io;
1010
1011     if (!gv)
1012         gv = PL_argvgv;
1013     if (!gv || SvTYPE(gv) != SVt_PVGV) {
1014         if (not_implicit)
1015             SETERRNO(EBADF,SS_IVCHAN);
1016         return FALSE;
1017     }
1018     io = GvIO(gv);
1019     if (!io) {          /* never opened */
1020         if (not_implicit) {
1021             if (ckWARN(WARN_UNOPENED)) /* no check for closed here */
1022                 report_evil_fh(gv, io, PL_op->op_type);
1023             SETERRNO(EBADF,SS_IVCHAN);
1024         }
1025         return FALSE;
1026     }
1027     retval = io_close(io, not_implicit);
1028     if (not_implicit) {
1029         IoLINES(io) = 0;
1030         IoPAGE(io) = 0;
1031         IoLINES_LEFT(io) = IoPAGE_LEN(io);
1032     }
1033     IoTYPE(io) = IoTYPE_CLOSED;
1034     return retval;
1035 }
1036
1037 bool
1038 Perl_io_close(pTHX_ IO *io, bool not_implicit)
1039 {
1040     bool retval = FALSE;
1041
1042     if (IoIFP(io)) {
1043         if (IoTYPE(io) == IoTYPE_PIPE) {
1044             const int status = PerlProc_pclose(IoIFP(io));
1045             if (not_implicit) {
1046                 STATUS_NATIVE_SET(status);
1047                 retval = (STATUS_UNIX == 0);
1048             }
1049             else {
1050                 retval = (status != -1);
1051             }
1052         }
1053         else if (IoTYPE(io) == IoTYPE_STD)
1054             retval = TRUE;
1055         else {
1056             if (IoOFP(io) && IoOFP(io) != IoIFP(io)) {          /* a socket */
1057                 bool prev_err = PerlIO_error(IoOFP(io));
1058                 retval = (PerlIO_close(IoOFP(io)) != EOF && !prev_err);
1059                 PerlIO_close(IoIFP(io));        /* clear stdio, fd already closed */
1060             }
1061             else {
1062                 bool prev_err = PerlIO_error(IoIFP(io));
1063                 retval = (PerlIO_close(IoIFP(io)) != EOF && !prev_err);
1064             }
1065         }
1066         IoOFP(io) = IoIFP(io) = Nullfp;
1067     }
1068     else if (not_implicit) {
1069         SETERRNO(EBADF,SS_IVCHAN);
1070     }
1071
1072     return retval;
1073 }
1074
1075 bool
1076 Perl_do_eof(pTHX_ GV *gv)
1077 {
1078     register IO *io;
1079     int ch;
1080
1081     io = GvIO(gv);
1082
1083     if (!io)
1084         return TRUE;
1085     else if ((IoTYPE(io) == IoTYPE_WRONLY) && ckWARN(WARN_IO))
1086         report_evil_fh(gv, io, OP_phoney_OUTPUT_ONLY);
1087
1088     while (IoIFP(io)) {
1089         int saverrno;
1090
1091         if (PerlIO_has_cntptr(IoIFP(io))) {     /* (the code works without this) */
1092             if (PerlIO_get_cnt(IoIFP(io)) > 0)  /* cheat a little, since */
1093                 return FALSE;                   /* this is the most usual case */
1094         }
1095
1096         saverrno = errno; /* getc and ungetc can stomp on errno */
1097         ch = PerlIO_getc(IoIFP(io));
1098         if (ch != EOF) {
1099             (void)PerlIO_ungetc(IoIFP(io),ch);
1100             errno = saverrno;
1101             return FALSE;
1102         }
1103         errno = saverrno;
1104
1105         if (PerlIO_has_cntptr(IoIFP(io)) && PerlIO_canset_cnt(IoIFP(io))) {
1106             if (PerlIO_get_cnt(IoIFP(io)) < -1)
1107                 PerlIO_set_cnt(IoIFP(io),-1);
1108         }
1109         if (PL_op->op_flags & OPf_SPECIAL) { /* not necessarily a real EOF yet? */
1110             if (gv != PL_argvgv || !nextargv(gv))       /* get another fp handy */
1111                 return TRUE;
1112         }
1113         else
1114             return TRUE;                /* normal fp, definitely end of file */
1115     }
1116     return TRUE;
1117 }
1118
1119 Off_t
1120 Perl_do_tell(pTHX_ GV *gv)
1121 {
1122     register IO *io = 0;
1123     register PerlIO *fp;
1124
1125     if (gv && (io = GvIO(gv)) && (fp = IoIFP(io))) {
1126 #ifdef ULTRIX_STDIO_BOTCH
1127         if (PerlIO_eof(fp))
1128             (void)PerlIO_seek(fp, 0L, 2);       /* ultrix 1.2 workaround */
1129 #endif
1130         return PerlIO_tell(fp);
1131     }
1132     if (ckWARN2(WARN_UNOPENED,WARN_CLOSED))
1133         report_evil_fh(gv, io, PL_op->op_type);
1134     SETERRNO(EBADF,RMS_IFI);
1135     return (Off_t)-1;
1136 }
1137
1138 bool
1139 Perl_do_seek(pTHX_ GV *gv, Off_t pos, int whence)
1140 {
1141     register IO *io = 0;
1142     register PerlIO *fp;
1143
1144     if (gv && (io = GvIO(gv)) && (fp = IoIFP(io))) {
1145 #ifdef ULTRIX_STDIO_BOTCH
1146         if (PerlIO_eof(fp))
1147             (void)PerlIO_seek(fp, 0L, 2);       /* ultrix 1.2 workaround */
1148 #endif
1149         return PerlIO_seek(fp, pos, whence) >= 0;
1150     }
1151     if (ckWARN2(WARN_UNOPENED,WARN_CLOSED))
1152         report_evil_fh(gv, io, PL_op->op_type);
1153     SETERRNO(EBADF,RMS_IFI);
1154     return FALSE;
1155 }
1156
1157 Off_t
1158 Perl_do_sysseek(pTHX_ GV *gv, Off_t pos, int whence)
1159 {
1160     register IO *io = 0;
1161     register PerlIO *fp;
1162
1163     if (gv && (io = GvIO(gv)) && (fp = IoIFP(io)))
1164         return PerlLIO_lseek(PerlIO_fileno(fp), pos, whence);
1165     if (ckWARN2(WARN_UNOPENED,WARN_CLOSED))
1166         report_evil_fh(gv, io, PL_op->op_type);
1167     SETERRNO(EBADF,RMS_IFI);
1168     return (Off_t)-1;
1169 }
1170
1171 int
1172 Perl_mode_from_discipline(pTHX_ SV *discp)
1173 {
1174     int mode = O_BINARY;
1175     if (discp) {
1176         STRLEN len;
1177         const char *s = SvPV_const(discp,len);
1178         while (*s) {
1179             if (*s == ':') {
1180                 switch (s[1]) {
1181                 case 'r':
1182                     if (s[2] == 'a' && s[3] == 'w'
1183                         && (!s[4] || s[4] == ':' || isSPACE(s[4])))
1184                     {
1185                         mode = O_BINARY;
1186                         s += 4;
1187                         len -= 4;
1188                         break;
1189                     }
1190                     /* FALL THROUGH */
1191                 case 'c':
1192                     if (s[2] == 'r' && s[3] == 'l' && s[4] == 'f'
1193                         && (!s[5] || s[5] == ':' || isSPACE(s[5])))
1194                     {
1195                         mode = O_TEXT;
1196                         s += 5;
1197                         len -= 5;
1198                         break;
1199                     }
1200                     /* FALL THROUGH */
1201                 default:
1202                     goto fail_discipline;
1203                 }
1204             }
1205             else if (isSPACE(*s)) {
1206                 ++s;
1207                 --len;
1208             }
1209             else {
1210                 const char *end;
1211 fail_discipline:
1212                 end = strchr(s+1, ':');
1213                 if (!end)
1214                     end = s+len;
1215 #ifndef PERLIO_LAYERS
1216                 Perl_croak(aTHX_ "IO layers (like '%.*s') unavailable", end-s, s);
1217 #else
1218                 len -= end-s;
1219                 s = end;
1220 #endif
1221             }
1222         }
1223     }
1224     return mode;
1225 }
1226
1227 int
1228 Perl_do_binmode(pTHX_ PerlIO *fp, int iotype, int mode)
1229 {
1230  /* The old body of this is now in non-LAYER part of perlio.c
1231   * This is a stub for any XS code which might have been calling it.
1232   */
1233  const char *name = ":raw";
1234 #ifdef PERLIO_USING_CRLF
1235  if (!(mode & O_BINARY))
1236      name = ":crlf";
1237 #endif
1238  return PerlIO_binmode(aTHX_ fp, iotype, mode, name);
1239 }
1240
1241 #if !defined(HAS_TRUNCATE) && !defined(HAS_CHSIZE)
1242 I32
1243 my_chsize(int fd, Off_t length)
1244 {
1245 #ifdef F_FREESP
1246         /* code courtesy of William Kucharski */
1247 #define HAS_CHSIZE
1248
1249     struct flock fl;
1250     Stat_t filebuf;
1251
1252     if (PerlLIO_fstat(fd, &filebuf) < 0)
1253         return -1;
1254
1255     if (filebuf.st_size < length) {
1256
1257         /* extend file length */
1258
1259         if ((PerlLIO_lseek(fd, (length - 1), 0)) < 0)
1260             return -1;
1261
1262         /* write a "0" byte */
1263
1264         if ((PerlLIO_write(fd, "", 1)) != 1)
1265             return -1;
1266     }
1267     else {
1268         /* truncate length */
1269
1270         fl.l_whence = 0;
1271         fl.l_len = 0;
1272         fl.l_start = length;
1273         fl.l_type = F_WRLCK;    /* write lock on file space */
1274
1275         /*
1276         * This relies on the UNDOCUMENTED F_FREESP argument to
1277         * fcntl(2), which truncates the file so that it ends at the
1278         * position indicated by fl.l_start.
1279         *
1280         * Will minor miracles never cease?
1281         */
1282
1283         if (fcntl(fd, F_FREESP, &fl) < 0)
1284             return -1;
1285
1286     }
1287     return 0;
1288 #else
1289     Perl_croak_nocontext("truncate not implemented");
1290 #endif /* F_FREESP */
1291     return -1;
1292 }
1293 #endif /* !HAS_TRUNCATE && !HAS_CHSIZE */
1294
1295 bool
1296 Perl_do_print(pTHX_ register SV *sv, PerlIO *fp)
1297 {
1298     register const char *tmps;
1299     STRLEN len;
1300
1301     /* assuming fp is checked earlier */
1302     if (!sv)
1303         return TRUE;
1304     switch (SvTYPE(sv)) {
1305     case SVt_NULL:
1306         if (ckWARN(WARN_UNINITIALIZED))
1307             report_uninit(sv);
1308         return TRUE;
1309     case SVt_IV:
1310         if (SvIOK(sv)) {
1311             if (SvGMAGICAL(sv))
1312                 mg_get(sv);
1313             if (SvIsUV(sv))
1314                 PerlIO_printf(fp, "%"UVuf, (UV)SvUVX(sv));
1315             else
1316                 PerlIO_printf(fp, "%"IVdf, (IV)SvIVX(sv));
1317             return !PerlIO_error(fp);
1318         }
1319         /* FALL THROUGH */
1320     default:
1321         if (PerlIO_isutf8(fp)) {
1322             if (!SvUTF8(sv))
1323                 sv_utf8_upgrade_flags(sv = sv_mortalcopy(sv),
1324                                       SV_GMAGIC|SV_UTF8_NO_ENCODING);
1325         }
1326         else if (DO_UTF8(sv)) {
1327             if (!sv_utf8_downgrade((sv = sv_mortalcopy(sv)), TRUE)
1328                 && ckWARN_d(WARN_UTF8))
1329             {
1330                 Perl_warner(aTHX_ packWARN(WARN_UTF8), "Wide character in print");
1331             }
1332         }
1333         tmps = SvPV_const(sv, len);
1334         break;
1335     }
1336     /* To detect whether the process is about to overstep its
1337      * filesize limit we would need getrlimit().  We could then
1338      * also transparently raise the limit with setrlimit() --
1339      * but only until the system hard limit/the filesystem limit,
1340      * at which we would get EPERM.  Note that when using buffered
1341      * io the write failure can be delayed until the flush/close. --jhi */
1342     if (len && (PerlIO_write(fp,tmps,len) == 0))
1343         return FALSE;
1344     return !PerlIO_error(fp);
1345 }
1346
1347 I32
1348 Perl_my_stat(pTHX)
1349 {
1350     dSP;
1351     IO *io;
1352     GV* gv;
1353
1354     if (PL_op->op_flags & OPf_REF) {
1355         EXTEND(SP,1);
1356         gv = cGVOP_gv;
1357       do_fstat:
1358         io = GvIO(gv);
1359         if (io && IoIFP(io)) {
1360             PL_statgv = gv;
1361             sv_setpvn(PL_statname,"", 0);
1362             PL_laststype = OP_STAT;
1363             return (PL_laststatval = PerlLIO_fstat(PerlIO_fileno(IoIFP(io)), &PL_statcache));
1364         }
1365         else {
1366             if (gv == PL_defgv)
1367                 return PL_laststatval;
1368             if (ckWARN2(WARN_UNOPENED,WARN_CLOSED))
1369                 report_evil_fh(gv, io, PL_op->op_type);
1370             PL_statgv = Nullgv;
1371             sv_setpvn(PL_statname,"", 0);
1372             return (PL_laststatval = -1);
1373         }
1374     }
1375     else if (PL_op->op_private & OPpFT_STACKED) {
1376         return PL_laststatval;
1377     }
1378     else {
1379         SV* sv = POPs;
1380         const char *s;
1381         STRLEN len;
1382         PUTBACK;
1383         if (SvTYPE(sv) == SVt_PVGV) {
1384             gv = (GV*)sv;
1385             goto do_fstat;
1386         }
1387         else if (SvROK(sv) && SvTYPE(SvRV(sv)) == SVt_PVGV) {
1388             gv = (GV*)SvRV(sv);
1389             goto do_fstat;
1390         }
1391
1392         s = SvPV_const(sv, len);
1393         PL_statgv = Nullgv;
1394         sv_setpvn(PL_statname, s, len);
1395         s = SvPVX_const(PL_statname);           /* s now NUL-terminated */
1396         PL_laststype = OP_STAT;
1397         PL_laststatval = PerlLIO_stat(s, &PL_statcache);
1398         if (PL_laststatval < 0 && ckWARN(WARN_NEWLINE) && strchr(s, '\n'))
1399             Perl_warner(aTHX_ packWARN(WARN_NEWLINE), PL_warn_nl, "stat");
1400         return PL_laststatval;
1401     }
1402 }
1403
1404 static const char no_prev_lstat[] = "The stat preceding -l _ wasn't an lstat";
1405
1406 I32
1407 Perl_my_lstat(pTHX)
1408 {
1409     dSP;
1410     SV *sv;
1411     if (PL_op->op_flags & OPf_REF) {
1412         EXTEND(SP,1);
1413         if (cGVOP_gv == PL_defgv) {
1414             if (PL_laststype != OP_LSTAT)
1415                 Perl_croak(aTHX_ no_prev_lstat);
1416             return PL_laststatval;
1417         }
1418         if (ckWARN(WARN_IO)) {
1419             Perl_warner(aTHX_ packWARN(WARN_IO), "Use of -l on filehandle %s",
1420                     GvENAME(cGVOP_gv));
1421             return (PL_laststatval = -1);
1422         }
1423     }
1424     else if (PL_laststype != OP_LSTAT
1425             && (PL_op->op_private & OPpFT_STACKED) && ckWARN(WARN_IO))
1426         Perl_croak(aTHX_ no_prev_lstat);
1427
1428     PL_laststype = OP_LSTAT;
1429     PL_statgv = Nullgv;
1430     sv = POPs;
1431     PUTBACK;
1432     if (SvROK(sv) && SvTYPE(SvRV(sv)) == SVt_PVGV && ckWARN(WARN_IO)) {
1433         Perl_warner(aTHX_ packWARN(WARN_IO), "Use of -l on filehandle %s",
1434                 GvENAME((GV*) SvRV(sv)));
1435         return (PL_laststatval = -1);
1436     }
1437     /* XXX Do really need to be calling SvPV() all these times? */
1438     sv_setpv(PL_statname,SvPV_nolen_const(sv));
1439     PL_laststatval = PerlLIO_lstat(SvPV_nolen_const(sv),&PL_statcache);
1440     if (PL_laststatval < 0 && ckWARN(WARN_NEWLINE) && strchr(SvPV_nolen_const(sv), '\n'))
1441         Perl_warner(aTHX_ packWARN(WARN_NEWLINE), PL_warn_nl, "lstat");
1442     return PL_laststatval;
1443 }
1444
1445 #ifndef OS2
1446 bool
1447 Perl_do_aexec(pTHX_ SV *really, register SV **mark, register SV **sp)
1448 {
1449     return do_aexec5(really, mark, sp, 0, 0);
1450 }
1451 #endif
1452
1453 bool
1454 Perl_do_aexec5(pTHX_ SV *really, register SV **mark, register SV **sp,
1455                int fd, int do_report)
1456 {
1457     dVAR;
1458 #if defined(MACOS_TRADITIONAL) || defined(SYMBIAN)
1459     Perl_croak(aTHX_ "exec? I'm not *that* kind of operating system");
1460 #else
1461     if (sp > mark) {
1462         char **a;
1463         const char *tmps = Nullch;
1464         Newx(PL_Argv, sp - mark + 1, char*);
1465         a = PL_Argv;
1466
1467         while (++mark <= sp) {
1468             if (*mark)
1469                 *a++ = (char*)SvPV_nolen_const(*mark);
1470             else
1471                 *a++ = "";
1472         }
1473         *a = Nullch;
1474         if (really)
1475             tmps = SvPV_nolen_const(really);
1476         if ((!really && *PL_Argv[0] != '/') ||
1477             (really && *tmps != '/'))           /* will execvp use PATH? */
1478             TAINT_ENV();                /* testing IFS here is overkill, probably */
1479         PERL_FPU_PRE_EXEC
1480         if (really && *tmps)
1481             PerlProc_execvp(tmps,EXEC_ARGV_CAST(PL_Argv));
1482         else
1483             PerlProc_execvp(PL_Argv[0],EXEC_ARGV_CAST(PL_Argv));
1484         PERL_FPU_POST_EXEC
1485         if (ckWARN(WARN_EXEC))
1486             Perl_warner(aTHX_ packWARN(WARN_EXEC), "Can't exec \"%s\": %s",
1487                 (really ? tmps : PL_Argv[0]), Strerror(errno));
1488         if (do_report) {
1489             int e = errno;
1490
1491             PerlLIO_write(fd, (void*)&e, sizeof(int));
1492             PerlLIO_close(fd);
1493         }
1494     }
1495     do_execfree();
1496 #endif
1497     return FALSE;
1498 }
1499
1500 void
1501 Perl_do_execfree(pTHX)
1502 {
1503     Safefree(PL_Argv);
1504     PL_Argv = Null(char **);
1505     Safefree(PL_Cmd);
1506     PL_Cmd = Nullch;
1507 }
1508
1509 #if !defined(OS2) && !defined(WIN32) && !defined(DJGPP) && !defined(EPOC) && !defined(SYMBIAN) && !defined(MACOS_TRADITIONAL)
1510
1511 bool
1512 Perl_do_exec(pTHX_ char *cmd)
1513 {
1514     return do_exec3(cmd,0,0);
1515 }
1516
1517 bool
1518 Perl_do_exec3(pTHX_ char *cmd, int fd, int do_report)
1519 {
1520     dVAR;
1521     register char **a;
1522     register char *s;
1523
1524     while (*cmd && isSPACE(*cmd))
1525         cmd++;
1526
1527     /* save an extra exec if possible */
1528
1529 #ifdef CSH
1530     {
1531         char flags[PERL_FLAGS_MAX];
1532         if (strnEQ(cmd,PL_cshname,PL_cshlen) &&
1533             strnEQ(cmd+PL_cshlen," -c",3)) {
1534 #ifdef HAS_STRLCPY
1535           strlcpy(flags, "-c", PERL_FLAGS_MAX);
1536 #else
1537           strcpy(flags,"-c");
1538 #endif
1539           s = cmd+PL_cshlen+3;
1540           if (*s == 'f') {
1541               s++;
1542 #ifdef HAS_STRLCPY
1543               strlcat(flags, "f", PERL_FLAGS_MAX);
1544 #else
1545               strcat(flags,"f");
1546 #endif
1547           }
1548           if (*s == ' ')
1549               s++;
1550           if (*s++ == '\'') {
1551               char *ncmd = s;
1552
1553               while (*s)
1554                   s++;
1555               if (s[-1] == '\n')
1556                   *--s = '\0';
1557               if (s[-1] == '\'') {
1558                   *--s = '\0';
1559                   PERL_FPU_PRE_EXEC
1560                   PerlProc_execl(PL_cshname,"csh", flags, ncmd, (char*)0);
1561                   PERL_FPU_POST_EXEC
1562                   *s = '\'';
1563                   return FALSE;
1564               }
1565           }
1566         }
1567     }
1568 #endif /* CSH */
1569
1570     /* see if there are shell metacharacters in it */
1571
1572     if (*cmd == '.' && isSPACE(cmd[1]))
1573         goto doshell;
1574
1575     if (strnEQ(cmd,"exec",4) && isSPACE(cmd[4]))
1576         goto doshell;
1577
1578     for (s = cmd; *s && isALNUM(*s); s++) ;     /* catch VAR=val gizmo */
1579     if (*s == '=')
1580         goto doshell;
1581
1582     for (s = cmd; *s; s++) {
1583         if (*s != ' ' && !isALPHA(*s) &&
1584             strchr("$&*(){}[]'\";\\|?<>~`\n",*s)) {
1585             if (*s == '\n' && !s[1]) {
1586                 *s = '\0';
1587                 break;
1588             }
1589             /* handle the 2>&1 construct at the end */
1590             if (*s == '>' && s[1] == '&' && s[2] == '1'
1591                 && s > cmd + 1 && s[-1] == '2' && isSPACE(s[-2])
1592                 && (!s[3] || isSPACE(s[3])))
1593             {
1594                 const char *t = s + 3;
1595
1596                 while (*t && isSPACE(*t))
1597                     ++t;
1598                 if (!*t && (PerlLIO_dup2(1,2) != -1)) {
1599                     s[-2] = '\0';
1600                     break;
1601                 }
1602             }
1603           doshell:
1604             PERL_FPU_PRE_EXEC
1605             PerlProc_execl(PL_sh_path, "sh", "-c", cmd, (char*)0);
1606             PERL_FPU_POST_EXEC
1607             return FALSE;
1608         }
1609     }
1610
1611     Newx(PL_Argv, (s - cmd) / 2 + 2, char*);
1612     PL_Cmd = savepvn(cmd, s-cmd);
1613     a = PL_Argv;
1614     for (s = PL_Cmd; *s;) {
1615         while (*s && isSPACE(*s)) s++;
1616         if (*s)
1617             *(a++) = s;
1618         while (*s && !isSPACE(*s)) s++;
1619         if (*s)
1620             *s++ = '\0';
1621     }
1622     *a = Nullch;
1623     if (PL_Argv[0]) {
1624         PERL_FPU_PRE_EXEC
1625         PerlProc_execvp(PL_Argv[0],PL_Argv);
1626         PERL_FPU_POST_EXEC
1627         if (errno == ENOEXEC) {         /* for system V NIH syndrome */
1628             do_execfree();
1629             goto doshell;
1630         }
1631         {
1632             if (ckWARN(WARN_EXEC))
1633                 Perl_warner(aTHX_ packWARN(WARN_EXEC), "Can't exec \"%s\": %s",
1634                     PL_Argv[0], Strerror(errno));
1635             if (do_report) {
1636                 int e = errno;
1637                 PerlLIO_write(fd, (void*)&e, sizeof(int));
1638                 PerlLIO_close(fd);
1639             }
1640         }
1641     }
1642     do_execfree();
1643     return FALSE;
1644 }
1645
1646 #endif /* OS2 || WIN32 */
1647
1648 I32
1649 Perl_apply(pTHX_ I32 type, register SV **mark, register SV **sp)
1650 {
1651     register I32 val;
1652     register I32 tot = 0;
1653     const char *what;
1654     const char *s;
1655     SV ** const oldmark = mark;
1656
1657 #define APPLY_TAINT_PROPER() \
1658     STMT_START {                                                        \
1659         if (PL_tainted) { TAINT_PROPER(what); }                         \
1660     } STMT_END
1661
1662     /* This is a first heuristic; it doesn't catch tainting magic. */
1663     if (PL_tainting) {
1664         while (++mark <= sp) {
1665             if (SvTAINTED(*mark)) {
1666                 TAINT;
1667                 break;
1668             }
1669         }
1670         mark = oldmark;
1671     }
1672     switch (type) {
1673     case OP_CHMOD:
1674         what = "chmod";
1675         APPLY_TAINT_PROPER();
1676         if (++mark <= sp) {
1677             val = SvIVx(*mark);
1678             APPLY_TAINT_PROPER();
1679             tot = sp - mark;
1680             while (++mark <= sp) {
1681                 GV* gv;
1682                 if (SvTYPE(*mark) == SVt_PVGV) {
1683                     gv = (GV*)*mark;
1684                 do_fchmod:
1685                     if (GvIO(gv) && IoIFP(GvIOp(gv))) {
1686 #ifdef HAS_FCHMOD
1687                         APPLY_TAINT_PROPER();
1688                         if (fchmod(PerlIO_fileno(IoIFP(GvIOn(gv))), val))
1689                             tot--;
1690 #else
1691                         Perl_die(aTHX_ PL_no_func, "fchmod");
1692 #endif
1693                     }
1694                     else {
1695                         tot--;
1696                     }
1697                 }
1698                 else if (SvROK(*mark) && SvTYPE(SvRV(*mark)) == SVt_PVGV) {
1699                     gv = (GV*)SvRV(*mark);
1700                     goto do_fchmod;
1701                 }
1702                 else {
1703                     const char *name = SvPV_nolen_const(*mark);
1704                     APPLY_TAINT_PROPER();
1705                     if (PerlLIO_chmod(name, val))
1706                         tot--;
1707                 }
1708             }
1709         }
1710         break;
1711 #ifdef HAS_CHOWN
1712     case OP_CHOWN:
1713         what = "chown";
1714         APPLY_TAINT_PROPER();
1715         if (sp - mark > 2) {
1716             register I32 val2;
1717             val = SvIVx(*++mark);
1718             val2 = SvIVx(*++mark);
1719             APPLY_TAINT_PROPER();
1720             tot = sp - mark;
1721             while (++mark <= sp) {
1722                 GV* gv;
1723                 if (SvTYPE(*mark) == SVt_PVGV) {
1724                     gv = (GV*)*mark;
1725                 do_fchown:
1726                     if (GvIO(gv) && IoIFP(GvIOp(gv))) {
1727 #ifdef HAS_FCHOWN
1728                         APPLY_TAINT_PROPER();
1729                         if (fchown(PerlIO_fileno(IoIFP(GvIOn(gv))), val, val2))
1730                             tot--;
1731 #else
1732                         Perl_die(aTHX_ PL_no_func, "fchown");
1733 #endif
1734                     }
1735                     else {
1736                         tot--;
1737                     }
1738                 }
1739                 else if (SvROK(*mark) && SvTYPE(SvRV(*mark)) == SVt_PVGV) {
1740                     gv = (GV*)SvRV(*mark);
1741                     goto do_fchown;
1742                 }
1743                 else {
1744                     const char *name = SvPV_nolen_const(*mark);
1745                     APPLY_TAINT_PROPER();
1746                     if (PerlLIO_chown(name, val, val2))
1747                         tot--;
1748                 }
1749             }
1750         }
1751         break;
1752 #endif
1753 /*
1754 XXX Should we make lchown() directly available from perl?
1755 For now, we'll let Configure test for HAS_LCHOWN, but do
1756 nothing in the core.
1757     --AD  5/1998
1758 */
1759 #ifdef HAS_KILL
1760     case OP_KILL:
1761         what = "kill";
1762         APPLY_TAINT_PROPER();
1763         if (mark == sp)
1764             break;
1765         s = SvPVx_nolen_const(*++mark);
1766         if (isALPHA(*s)) {
1767             if (*s == 'S' && s[1] == 'I' && s[2] == 'G')
1768                 s += 3;
1769             if ((val = whichsig(s)) < 0)
1770                 Perl_croak(aTHX_ "Unrecognized signal name \"%s\"",s);
1771         }
1772         else
1773             val = SvIVx(*mark);
1774         APPLY_TAINT_PROPER();
1775         tot = sp - mark;
1776 #ifdef VMS
1777         /* kill() doesn't do process groups (job trees?) under VMS */
1778         if (val < 0) val = -val;
1779         if (val == SIGKILL) {
1780 #           include <starlet.h>
1781             /* Use native sys$delprc() to insure that target process is
1782              * deleted; supervisor-mode images don't pay attention to
1783              * CRTL's emulation of Unix-style signals and kill()
1784              */
1785             while (++mark <= sp) {
1786                 I32 proc = SvIVx(*mark);
1787                 register unsigned long int __vmssts;
1788                 APPLY_TAINT_PROPER();
1789                 if (!((__vmssts = sys$delprc(&proc,0)) & 1)) {
1790                     tot--;
1791                     switch (__vmssts) {
1792                         case SS$_NONEXPR:
1793                         case SS$_NOSUCHNODE:
1794                             SETERRNO(ESRCH,__vmssts);
1795                             break;
1796                         case SS$_NOPRIV:
1797                             SETERRNO(EPERM,__vmssts);
1798                             break;
1799                         default:
1800                             SETERRNO(EVMSERR,__vmssts);
1801                     }
1802                 }
1803             }
1804             break;
1805         }
1806 #endif
1807         if (val < 0) {
1808             val = -val;
1809             while (++mark <= sp) {
1810                 I32 proc = SvIVx(*mark);
1811                 APPLY_TAINT_PROPER();
1812 #ifdef HAS_KILLPG
1813                 if (PerlProc_killpg(proc,val))  /* BSD */
1814 #else
1815                 if (PerlProc_kill(-proc,val))   /* SYSV */
1816 #endif
1817                     tot--;
1818             }
1819         }
1820         else {
1821             while (++mark <= sp) {
1822                 I32 proc = SvIVx(*mark);
1823                 APPLY_TAINT_PROPER();
1824                 if (PerlProc_kill(proc, val))
1825                     tot--;
1826             }
1827         }
1828         break;
1829 #endif
1830     case OP_UNLINK:
1831         what = "unlink";
1832         APPLY_TAINT_PROPER();
1833         tot = sp - mark;
1834         while (++mark <= sp) {
1835             s = SvPV_nolen_const(*mark);
1836             APPLY_TAINT_PROPER();
1837             if (PL_euid || PL_unsafe) {
1838                 if (UNLINK(s))
1839                     tot--;
1840             }
1841             else {      /* don't let root wipe out directories without -U */
1842                 if (PerlLIO_lstat(s,&PL_statbuf) < 0 || S_ISDIR(PL_statbuf.st_mode))
1843                     tot--;
1844                 else {
1845                     if (UNLINK(s))
1846                         tot--;
1847                 }
1848             }
1849         }
1850         break;
1851 #ifdef HAS_UTIME
1852     case OP_UTIME:
1853         what = "utime";
1854         APPLY_TAINT_PROPER();
1855         if (sp - mark > 2) {
1856 #if defined(I_UTIME) || defined(VMS)
1857             struct utimbuf utbuf;
1858             struct utimbuf *utbufp = &utbuf;
1859 #else
1860             struct {
1861                 Time_t  actime;
1862                 Time_t  modtime;
1863             } utbuf;
1864             void *utbufp = &utbuf;
1865 #endif
1866
1867            SV* accessed = *++mark;
1868            SV* modified = *++mark;
1869
1870            /* Be like C, and if both times are undefined, let the C
1871             * library figure out what to do.  This usually means
1872             * "current time". */
1873
1874            if ( accessed == &PL_sv_undef && modified == &PL_sv_undef )
1875                 utbufp = NULL;
1876            else {
1877                 Zero(&utbuf, sizeof utbuf, char);
1878 #ifdef BIG_TIME
1879                 utbuf.actime = (Time_t)SvNVx(accessed);  /* time accessed */
1880                 utbuf.modtime = (Time_t)SvNVx(modified); /* time modified */
1881 #else
1882                 utbuf.actime = (Time_t)SvIVx(accessed);  /* time accessed */
1883                 utbuf.modtime = (Time_t)SvIVx(modified); /* time modified */
1884 #endif
1885             }
1886             APPLY_TAINT_PROPER();
1887             tot = sp - mark;
1888             while (++mark <= sp) {
1889                 char *name = SvPV_nolen(*mark);
1890                 APPLY_TAINT_PROPER();
1891                 if (PerlLIO_utime(name, utbufp))
1892                     tot--;
1893             }
1894         }
1895         else
1896             tot = 0;
1897         break;
1898 #endif
1899     }
1900     return tot;
1901
1902 #undef APPLY_TAINT_PROPER
1903 }
1904
1905 /* Do the permissions allow some operation?  Assumes statcache already set. */
1906 #ifndef VMS /* VMS' cando is in vms.c */
1907 bool
1908 Perl_cando(pTHX_ Mode_t mode, Uid_t effective, register const Stat_t *statbufp)
1909 /* Note: we use "effective" both for uids and gids.
1910  * Here we are betting on Uid_t being equal or wider than Gid_t.  */
1911 {
1912 #ifdef DOSISH
1913     /* [Comments and code from Len Reed]
1914      * MS-DOS "user" is similar to UNIX's "superuser," but can't write
1915      * to write-protected files.  The execute permission bit is set
1916      * by the Miscrosoft C library stat() function for the following:
1917      *          .exe files
1918      *          .com files
1919      *          .bat files
1920      *          directories
1921      * All files and directories are readable.
1922      * Directories and special files, e.g. "CON", cannot be
1923      * write-protected.
1924      * [Comment by Tom Dinger -- a directory can have the write-protect
1925      *          bit set in the file system, but DOS permits changes to
1926      *          the directory anyway.  In addition, all bets are off
1927      *          here for networked software, such as Novell and
1928      *          Sun's PC-NFS.]
1929      */
1930
1931      /* Atari stat() does pretty much the same thing. we set x_bit_set_in_stat
1932       * too so it will actually look into the files for magic numbers
1933       */
1934      return (mode & statbufp->st_mode) ? TRUE : FALSE;
1935
1936 #else /* ! DOSISH */
1937     if ((effective ? PL_euid : PL_uid) == 0) {  /* root is special */
1938         if (mode == S_IXUSR) {
1939             if (statbufp->st_mode & 0111 || S_ISDIR(statbufp->st_mode))
1940                 return TRUE;
1941         }
1942         else
1943             return TRUE;                /* root reads and writes anything */
1944         return FALSE;
1945     }
1946     if (statbufp->st_uid == (effective ? PL_euid : PL_uid) ) {
1947         if (statbufp->st_mode & mode)
1948             return TRUE;        /* ok as "user" */
1949     }
1950     else if (ingroup(statbufp->st_gid,effective)) {
1951         if (statbufp->st_mode & mode >> 3)
1952             return TRUE;        /* ok as "group" */
1953     }
1954     else if (statbufp->st_mode & mode >> 6)
1955         return TRUE;    /* ok as "other" */
1956     return FALSE;
1957 #endif /* ! DOSISH */
1958 }
1959 #endif /* ! VMS */
1960
1961 bool
1962 Perl_ingroup(pTHX_ Gid_t testgid, Uid_t effective)
1963 {
1964 #ifdef MACOS_TRADITIONAL
1965     /* This is simply not correct for AppleShare, but fix it yerself. */
1966     return TRUE;
1967 #else
1968     if (testgid == (effective ? PL_egid : PL_gid))
1969         return TRUE;
1970 #ifdef HAS_GETGROUPS
1971 #ifndef NGROUPS
1972 #define NGROUPS 32
1973 #endif
1974     {
1975         Groups_t gary[NGROUPS];
1976         I32 anum;
1977
1978         anum = getgroups(NGROUPS,gary);
1979         while (--anum >= 0)
1980             if (gary[anum] == testgid)
1981                 return TRUE;
1982     }
1983 #endif
1984     return FALSE;
1985 #endif
1986 }
1987
1988 #if defined(HAS_MSG) || defined(HAS_SEM) || defined(HAS_SHM)
1989
1990 I32
1991 Perl_do_ipcget(pTHX_ I32 optype, SV **mark, SV **sp)
1992 {
1993     key_t key = (key_t)SvNVx(*++mark);
1994     const I32 n = (optype == OP_MSGGET) ? 0 : SvIVx(*++mark);
1995     const I32 flags = SvIVx(*++mark);
1996     (void)sp;
1997
1998     SETERRNO(0,0);
1999     switch (optype)
2000     {
2001 #ifdef HAS_MSG
2002     case OP_MSGGET:
2003         return msgget(key, flags);
2004 #endif
2005 #ifdef HAS_SEM
2006     case OP_SEMGET:
2007         return semget(key, n, flags);
2008 #endif
2009 #ifdef HAS_SHM
2010     case OP_SHMGET:
2011         return shmget(key, n, flags);
2012 #endif
2013 #if !defined(HAS_MSG) || !defined(HAS_SEM) || !defined(HAS_SHM)
2014     default:
2015         Perl_croak(aTHX_ "%s not implemented", PL_op_desc[optype]);
2016 #endif
2017     }
2018     return -1;                  /* should never happen */
2019 }
2020
2021 I32
2022 Perl_do_ipcctl(pTHX_ I32 optype, SV **mark, SV **sp)
2023 {
2024     SV *astr;
2025     char *a;
2026     STRLEN infosize;
2027     I32 getinfo;
2028     I32 ret = -1;
2029     const I32 id  = SvIVx(*++mark);
2030     const I32 n   = (optype == OP_SEMCTL) ? SvIVx(*++mark) : 0;
2031     const I32 cmd = SvIVx(*++mark);
2032     PERL_UNUSED_ARG(sp);
2033
2034     astr = *++mark;
2035     infosize = 0;
2036     getinfo = (cmd == IPC_STAT);
2037
2038     switch (optype)
2039     {
2040 #ifdef HAS_MSG
2041     case OP_MSGCTL:
2042         if (cmd == IPC_STAT || cmd == IPC_SET)
2043             infosize = sizeof(struct msqid_ds);
2044         break;
2045 #endif
2046 #ifdef HAS_SHM
2047     case OP_SHMCTL:
2048         if (cmd == IPC_STAT || cmd == IPC_SET)
2049             infosize = sizeof(struct shmid_ds);
2050         break;
2051 #endif
2052 #ifdef HAS_SEM
2053     case OP_SEMCTL:
2054 #ifdef Semctl
2055         if (cmd == IPC_STAT || cmd == IPC_SET)
2056             infosize = sizeof(struct semid_ds);
2057         else if (cmd == GETALL || cmd == SETALL)
2058         {
2059             struct semid_ds semds;
2060             union semun semun;
2061 #ifdef EXTRA_F_IN_SEMUN_BUF
2062             semun.buff = &semds;
2063 #else
2064             semun.buf = &semds;
2065 #endif
2066             getinfo = (cmd == GETALL);
2067             if (Semctl(id, 0, IPC_STAT, semun) == -1)
2068                 return -1;
2069             infosize = semds.sem_nsems * sizeof(short);
2070                 /* "short" is technically wrong but much more portable
2071                    than guessing about u_?short(_t)? */
2072         }
2073 #else
2074         Perl_croak(aTHX_ "%s not implemented", PL_op_desc[optype]);
2075 #endif
2076         break;
2077 #endif
2078 #if !defined(HAS_MSG) || !defined(HAS_SEM) || !defined(HAS_SHM)
2079     default:
2080         Perl_croak(aTHX_ "%s not implemented", PL_op_desc[optype]);
2081 #endif
2082     }
2083
2084     if (infosize)
2085     {
2086         if (getinfo)
2087         {
2088             SvPV_force_nolen(astr);
2089             a = SvGROW(astr, infosize+1);
2090         }
2091         else
2092         {
2093             STRLEN len;
2094             a = SvPV(astr, len);
2095             if (len != infosize)
2096                 Perl_croak(aTHX_ "Bad arg length for %s, is %lu, should be %ld",
2097                       PL_op_desc[optype],
2098                       (unsigned long)len,
2099                       (long)infosize);
2100         }
2101     }
2102     else
2103     {
2104         IV i = SvIV(astr);
2105         a = INT2PTR(char *,i);          /* ouch */
2106     }
2107     SETERRNO(0,0);
2108     switch (optype)
2109     {
2110 #ifdef HAS_MSG
2111     case OP_MSGCTL:
2112         ret = msgctl(id, cmd, (struct msqid_ds *)a);
2113         break;
2114 #endif
2115 #ifdef HAS_SEM
2116     case OP_SEMCTL: {
2117 #ifdef Semctl
2118             union semun unsemds;
2119
2120 #ifdef EXTRA_F_IN_SEMUN_BUF
2121             unsemds.buff = (struct semid_ds *)a;
2122 #else
2123             unsemds.buf = (struct semid_ds *)a;
2124 #endif
2125             ret = Semctl(id, n, cmd, unsemds);
2126 #else
2127             Perl_croak(aTHX_ "%s not implemented", PL_op_desc[optype]);
2128 #endif
2129         }
2130         break;
2131 #endif
2132 #ifdef HAS_SHM
2133     case OP_SHMCTL:
2134         ret = shmctl(id, cmd, (struct shmid_ds *)a);
2135         break;
2136 #endif
2137     }
2138     if (getinfo && ret >= 0) {
2139         SvCUR_set(astr, infosize);
2140         *SvEND(astr) = '\0';
2141         SvSETMAGIC(astr);
2142     }
2143     return ret;
2144 }
2145
2146 I32
2147 Perl_do_msgsnd(pTHX_ SV **mark, SV **sp)
2148 {
2149 #ifdef HAS_MSG
2150     SV *mstr;
2151     const char *mbuf;
2152     I32 msize, flags;
2153     STRLEN len;
2154     const I32 id = SvIVx(*++mark);
2155     PERL_UNUSED_ARG(sp);
2156
2157     mstr = *++mark;
2158     flags = SvIVx(*++mark);
2159     mbuf = SvPV_const(mstr, len);
2160     if ((msize = len - sizeof(long)) < 0)
2161         Perl_croak(aTHX_ "Arg too short for msgsnd");
2162     SETERRNO(0,0);
2163     return msgsnd(id, (struct msgbuf *)mbuf, msize, flags);
2164 #else
2165     Perl_croak(aTHX_ "msgsnd not implemented");
2166 #endif
2167 }
2168
2169 I32
2170 Perl_do_msgrcv(pTHX_ SV **mark, SV **sp)
2171 {
2172 #ifdef HAS_MSG
2173     SV *mstr;
2174     char *mbuf;
2175     long mtype;
2176     I32 msize, flags, ret;
2177     const I32 id = SvIVx(*++mark);
2178     PERL_UNUSED_ARG(sp);
2179
2180     mstr = *++mark;
2181     /* suppress warning when reading into undef var --jhi */
2182     if (! SvOK(mstr))
2183         sv_setpvn(mstr, "", 0);
2184     msize = SvIVx(*++mark);
2185     mtype = (long)SvIVx(*++mark);
2186     flags = SvIVx(*++mark);
2187     SvPV_force_nolen(mstr);
2188     mbuf = SvGROW(mstr, sizeof(long)+msize+1);
2189
2190     SETERRNO(0,0);
2191     ret = msgrcv(id, (struct msgbuf *)mbuf, msize, mtype, flags);
2192     if (ret >= 0) {
2193         SvCUR_set(mstr, sizeof(long)+ret);
2194         *SvEND(mstr) = '\0';
2195 #ifndef INCOMPLETE_TAINTS
2196         /* who knows who has been playing with this message? */
2197         SvTAINTED_on(mstr);
2198 #endif
2199     }
2200     return ret;
2201 #else
2202     Perl_croak(aTHX_ "msgrcv not implemented");
2203 #endif
2204 }
2205
2206 I32
2207 Perl_do_semop(pTHX_ SV **mark, SV **sp)
2208 {
2209 #ifdef HAS_SEM
2210     SV *opstr;
2211     const char *opbuf;
2212     STRLEN opsize;
2213     const I32 id = SvIVx(*++mark);
2214     PERL_UNUSED_ARG(sp);
2215
2216     opstr = *++mark;
2217     opbuf = SvPV_const(opstr, opsize);
2218     if (opsize < 3 * SHORTSIZE
2219         || (opsize % (3 * SHORTSIZE))) {
2220         SETERRNO(EINVAL,LIB_INVARG);
2221         return -1;
2222     }
2223     SETERRNO(0,0);
2224     /* We can't assume that sizeof(struct sembuf) == 3 * sizeof(short). */
2225     {
2226         const int nsops  = opsize / (3 * sizeof (short));
2227         int i      = nsops;
2228         short *ops = (short *) opbuf;
2229         short *o   = ops;
2230         struct sembuf *temps, *t;
2231         I32 result;
2232
2233         Newx (temps, nsops, struct sembuf);
2234         t = temps;
2235         while (i--) {
2236             t->sem_num = *o++;
2237             t->sem_op  = *o++;
2238             t->sem_flg = *o++;
2239             t++;
2240         }
2241         result = semop(id, temps, nsops);
2242         t = temps;
2243         o = ops;
2244         i = nsops;
2245         while (i--) {
2246             *o++ = t->sem_num;
2247             *o++ = t->sem_op;
2248             *o++ = t->sem_flg;
2249             t++;
2250         }
2251         Safefree(temps);
2252         return result;
2253     }
2254 #else
2255     Perl_croak(aTHX_ "semop not implemented");
2256 #endif
2257 }
2258
2259 I32
2260 Perl_do_shmio(pTHX_ I32 optype, SV **mark, SV **sp)
2261 {
2262 #ifdef HAS_SHM
2263     SV *mstr;
2264     char *shm;
2265     I32 mpos, msize;
2266     struct shmid_ds shmds;
2267     const I32 id = SvIVx(*++mark);
2268     PERL_UNUSED_ARG(sp);
2269
2270     mstr = *++mark;
2271     mpos = SvIVx(*++mark);
2272     msize = SvIVx(*++mark);
2273     SETERRNO(0,0);
2274     if (shmctl(id, IPC_STAT, &shmds) == -1)
2275         return -1;
2276     if (mpos < 0 || msize < 0 || mpos + msize > shmds.shm_segsz) {
2277         SETERRNO(EFAULT,SS_ACCVIO);             /* can't do as caller requested */
2278         return -1;
2279     }
2280     shm = (char *)shmat(id, (char*)NULL, (optype == OP_SHMREAD) ? SHM_RDONLY : 0);
2281     if (shm == (char *)-1)      /* I hate System V IPC, I really do */
2282         return -1;
2283     if (optype == OP_SHMREAD) {
2284         const char *mbuf;
2285         /* suppress warning when reading into undef var (tchrist 3/Mar/00) */
2286         if (! SvOK(mstr))
2287             sv_setpvn(mstr, "", 0);
2288         SvPV_force_nolen(mstr);
2289         mbuf = SvGROW(mstr, msize+1);
2290
2291         Copy(shm + mpos, mbuf, msize, char);
2292         SvCUR_set(mstr, msize);
2293         *SvEND(mstr) = '\0';
2294         SvSETMAGIC(mstr);
2295 #ifndef INCOMPLETE_TAINTS
2296         /* who knows who has been playing with this shared memory? */
2297         SvTAINTED_on(mstr);
2298 #endif
2299     }
2300     else {
2301         I32 n;
2302         STRLEN len;
2303
2304         const char *mbuf = SvPV_const(mstr, len);
2305         if ((n = len) > msize)
2306             n = msize;
2307         Copy(mbuf, shm + mpos, n, char);
2308         if (n < msize)
2309             memzero(shm + mpos + n, msize - n);
2310     }
2311     return shmdt(shm);
2312 #else
2313     Perl_croak(aTHX_ "shm I/O not implemented");
2314 #endif
2315 }
2316
2317 #endif /* SYSV IPC */
2318
2319 /*
2320 =head1 IO Functions
2321
2322 =for apidoc start_glob
2323
2324 Function called by C<do_readline> to spawn a glob (or do the glob inside
2325 perl on VMS). This code used to be inline, but now perl uses C<File::Glob>
2326 this glob starter is only used by miniperl during the build process.
2327 Moving it away shrinks pp_hot.c; shrinking pp_hot.c helps speed perl up.
2328
2329 =cut
2330 */
2331
2332 PerlIO *
2333 Perl_start_glob (pTHX_ SV *tmpglob, IO *io)
2334 {
2335     dVAR;
2336     SV * const tmpcmd = NEWSV(55, 0);
2337     PerlIO *fp;
2338     ENTER;
2339     SAVEFREESV(tmpcmd);
2340 #ifdef VMS /* expand the wildcards right here, rather than opening a pipe, */
2341            /* since spawning off a process is a real performance hit */
2342     {
2343 #include <descrip.h>
2344 #include <lib$routines.h>
2345 #include <nam.h>
2346 #include <rmsdef.h>
2347         char rslt[NAM$C_MAXRSS+1+sizeof(unsigned short int)] = {'\0','\0'};
2348         char vmsspec[NAM$C_MAXRSS+1];
2349         char * const rstr = rslt + sizeof(unsigned short int);
2350         char *begin, *end, *cp;
2351         $DESCRIPTOR(dfltdsc,"SYS$DISK:[]*.*;");
2352         PerlIO *tmpfp;
2353         STRLEN i;
2354         struct dsc$descriptor_s wilddsc
2355             = {0, DSC$K_DTYPE_T, DSC$K_CLASS_S, 0};
2356         struct dsc$descriptor_vs rsdsc
2357             = {sizeof rslt, DSC$K_DTYPE_VT, DSC$K_CLASS_VS, rslt};
2358         unsigned long int cxt = 0, sts = 0, ok = 1, hasdir = 0, hasver = 0, isunix = 0;
2359
2360         /* We could find out if there's an explicit dev/dir or version
2361            by peeking into lib$find_file's internal context at
2362            ((struct NAM *)((struct FAB *)cxt)->fab$l_nam)->nam$l_fnb
2363            but that's unsupported, so I don't want to do it now and
2364            have it bite someone in the future. */
2365         cp = SvPV(tmpglob,i);
2366         for (; i; i--) {
2367             if (cp[i] == ';') hasver = 1;
2368             if (cp[i] == '.') {
2369                 if (sts) hasver = 1;
2370                 else sts = 1;
2371             }
2372             if (cp[i] == '/') {
2373                 hasdir = isunix = 1;
2374                 break;
2375             }
2376             if (cp[i] == ']' || cp[i] == '>' || cp[i] == ':') {
2377                 hasdir = 1;
2378                 break;
2379             }
2380         }
2381        if ((tmpfp = PerlIO_tmpfile()) != NULL) {
2382             Stat_t st;
2383             if (!PerlLIO_stat(SvPVX_const(tmpglob),&st) && S_ISDIR(st.st_mode))
2384                 ok = ((wilddsc.dsc$a_pointer = tovmspath(SvPVX(tmpglob),vmsspec)) != NULL);
2385             else ok = ((wilddsc.dsc$a_pointer = tovmsspec(SvPVX(tmpglob),vmsspec)) != NULL);
2386             if (ok) wilddsc.dsc$w_length = (unsigned short int) strlen(wilddsc.dsc$a_pointer);
2387             for (cp=wilddsc.dsc$a_pointer; ok && cp && *cp; cp++)
2388                 if (*cp == '?') *cp = '%';  /* VMS style single-char wildcard */
2389             while (ok && ((sts = lib$find_file(&wilddsc,&rsdsc,&cxt,
2390                                                &dfltdsc,NULL,NULL,NULL))&1)) {
2391                 /* with varying string, 1st word of buffer contains result length */
2392                 end = rstr + *((unsigned short int*)rslt);
2393                 if (!hasver) while (*end != ';' && end > rstr) end--;
2394                 *(end++) = '\n';  *end = '\0';
2395                 for (cp = rstr; *cp; cp++) *cp = _tolower(*cp);
2396                 if (hasdir) {
2397                     if (isunix) trim_unixpath(rstr,SvPVX(tmpglob),1);
2398                     begin = rstr;
2399                 }
2400                 else {
2401                     begin = end;
2402                     while (*(--begin) != ']' && *begin != '>') ;
2403                     ++begin;
2404                 }
2405                 ok = (PerlIO_puts(tmpfp,begin) != EOF);
2406             }
2407             if (cxt) (void)lib$find_file_end(&cxt);
2408             if (ok && sts != RMS$_NMF &&
2409                 sts != RMS$_DNF && sts != RMS_FNF) ok = 0;
2410             if (!ok) {
2411                 if (!(sts & 1)) {
2412                     SETERRNO((sts == RMS$_SYN ? EINVAL : EVMSERR),sts);
2413                 }
2414                 PerlIO_close(tmpfp);
2415                 fp = NULL;
2416             }
2417             else {
2418                 PerlIO_rewind(tmpfp);
2419                 IoTYPE(io) = IoTYPE_RDONLY;
2420                 IoIFP(io) = fp = tmpfp;
2421                 IoFLAGS(io) &= ~IOf_UNTAINT;  /* maybe redundant */
2422             }
2423         }
2424     }
2425 #else /* !VMS */
2426 #ifdef MACOS_TRADITIONAL
2427     sv_setpv(tmpcmd, "glob ");
2428     sv_catsv(tmpcmd, tmpglob);
2429     sv_catpv(tmpcmd, " |");
2430 #else
2431 #ifdef DOSISH
2432 #ifdef OS2
2433     sv_setpv(tmpcmd, "for a in ");
2434     sv_catsv(tmpcmd, tmpglob);
2435     sv_catpv(tmpcmd, "; do echo \"$a\\0\\c\"; done |");
2436 #else
2437 #ifdef DJGPP
2438     sv_setpv(tmpcmd, "/dev/dosglob/"); /* File System Extension */
2439     sv_catsv(tmpcmd, tmpglob);
2440 #else
2441     sv_setpv(tmpcmd, "perlglob ");
2442     sv_catsv(tmpcmd, tmpglob);
2443     sv_catpv(tmpcmd, " |");
2444 #endif /* !DJGPP */
2445 #endif /* !OS2 */
2446 #else /* !DOSISH */
2447 #if defined(CSH)
2448     sv_setpvn(tmpcmd, PL_cshname, PL_cshlen);
2449     sv_catpv(tmpcmd, " -cf 'set nonomatch; glob ");
2450     sv_catsv(tmpcmd, tmpglob);
2451     sv_catpv(tmpcmd, "' 2>/dev/null |");
2452 #else
2453     sv_setpv(tmpcmd, "echo ");
2454     sv_catsv(tmpcmd, tmpglob);
2455 #if 'z' - 'a' == 25
2456     sv_catpv(tmpcmd, "|tr -s ' \t\f\r' '\\012\\012\\012\\012'|");
2457 #else
2458     sv_catpv(tmpcmd, "|tr -s ' \t\f\r' '\\n\\n\\n\\n'|");
2459 #endif
2460 #endif /* !CSH */
2461 #endif /* !DOSISH */
2462 #endif /* MACOS_TRADITIONAL */
2463     (void)do_open(PL_last_in_gv, (char*)SvPVX_const(tmpcmd), SvCUR(tmpcmd),
2464                   FALSE, O_RDONLY, 0, Nullfp);
2465     fp = IoIFP(io);
2466 #endif /* !VMS */
2467     LEAVE;
2468     return fp;
2469 }
2470
2471 /*
2472  * Local variables:
2473  * c-indentation-style: bsd
2474  * c-basic-offset: 4
2475  * indent-tabs-mode: t
2476  * End:
2477  *
2478  * ex: set ts=8 sts=4 sw=4 noet:
2479  */