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