This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
175b6b065a8cfbaf207546fd09900efefa2fe229
[perl5.git] / doio.c
1 /*    doio.c
2  *
3  *    Copyright (c) 1991-1994, Larry Wall
4  *
5  *    You may distribute under the terms of either the GNU General Public
6  *    License or the Artistic License, as specified in the README file.
7  *
8  */
9
10 /*
11  * "Far below them they saw the white waters pour into a foaming bowl, and
12  * then swirl darkly about a deep oval basin in the rocks, until they found
13  * their way out again through a narrow gate, and flowed away, fuming and
14  * chattering, into calmer and more level reaches."
15  */
16
17 #include "EXTERN.h"
18 #include "perl.h"
19
20 #if defined(HAS_MSG) || defined(HAS_SEM) || defined(HAS_SHM)
21 #include <sys/ipc.h>
22 #ifdef HAS_MSG
23 #include <sys/msg.h>
24 #endif
25 #ifdef HAS_SEM
26 #include <sys/sem.h>
27 #endif
28 #ifdef HAS_SHM
29 #include <sys/shm.h>
30 # ifndef HAS_SHMAT_PROTOTYPE
31     extern Shmat_t shmat _((int, char *, int));
32 # endif
33 #endif
34 #endif
35
36 #ifdef I_UTIME
37 #include <utime.h>
38 #endif
39 #ifdef I_FCNTL
40 #include <fcntl.h>
41 #endif
42 #ifdef I_SYS_FILE
43 #include <sys/file.h>
44 #endif
45
46 #if !defined(NSIG) || defined(M_UNIX) || defined(M_XENIX)
47 #include <signal.h>
48 #endif
49
50 /* XXX If this causes problems, set i_unistd=undef in the hint file.  */
51 #ifdef I_UNISTD
52 #  include <unistd.h>
53 #endif
54
55 #if defined(HAS_SOCKET) && !defined(VMS) /* VMS handles sockets via vmsish.h */
56 # include <sys/socket.h>
57 # include <netdb.h>
58 # ifndef ENOTSOCK
59 #  ifdef I_NET_ERRNO
60 #   include <net/errno.h>
61 #  endif
62 # endif
63 #endif
64
65 bool
66 do_open(gv,name,len,as_raw,rawmode,rawperm,supplied_fp)
67 GV *gv;
68 register char *name;
69 I32 len;
70 int as_raw;
71 int rawmode, rawperm;
72 PerlIO *supplied_fp;
73 {
74     register IO *io = GvIOn(gv);
75     PerlIO *saveifp = Nullfp;
76     PerlIO *saveofp = Nullfp;
77     char savetype = ' ';
78     int writing = 0;
79     PerlIO *fp;
80     int fd;
81     int result;
82
83     forkprocess = 1;            /* assume true if no fork */
84
85     if (IoIFP(io)) {
86         fd = PerlIO_fileno(IoIFP(io));
87         if (IoTYPE(io) == '-')
88             result = 0;
89         else if (fd <= maxsysfd) {
90             saveifp = IoIFP(io);
91             saveofp = IoOFP(io);
92             savetype = IoTYPE(io);
93             result = 0;
94         }
95         else if (IoTYPE(io) == '|')
96             result = my_pclose(IoIFP(io));
97         else if (IoIFP(io) != IoOFP(io)) {
98             if (IoOFP(io)) {
99                 result = PerlIO_close(IoOFP(io));
100                 PerlIO_close(IoIFP(io));        /* clear stdio, fd already closed */
101             }
102             else
103                 result = PerlIO_close(IoIFP(io));
104         }
105         else
106             result = PerlIO_close(IoIFP(io));
107         if (result == EOF && fd > maxsysfd)
108             PerlIO_printf(PerlIO_stderr(), "Warning: unable to close filehandle %s properly.\n",
109               GvENAME(gv));
110         IoOFP(io) = IoIFP(io) = Nullfp;
111     }
112
113     if (as_raw) {
114         result = rawmode & 3;
115         IoTYPE(io) = "<>++"[result];
116         writing = (result > 0);
117         fd = open(name, rawmode, rawperm);
118         if (fd == -1)
119             fp = NULL;
120         else {
121             fp = PerlIO_fdopen(fd, ((result == 0) ? "r"
122                              : (result == 1) ? "w"
123                              : "r+"));
124             if (!fp)
125                 close(fd);
126         }
127     }
128     else {
129         char *myname;
130         char mode[3];           /* stdio file mode ("r\0" or "r+\0") */
131         int dodup;
132
133         myname = savepvn(name, len);
134         SAVEFREEPV(myname);
135         name = myname;
136         while (len && isSPACE(name[len-1]))
137             name[--len] = '\0';
138
139         mode[0] = mode[1] = mode[2] = '\0';
140         IoTYPE(io) = *name;
141         if (*name == '+' && len > 1 && name[len-1] != '|') { /* scary */
142             mode[1] = *name++;
143             --len;
144             writing = 1;
145         }
146
147         if (*name == '|') {
148             /*SUPPRESS 530*/
149             for (name++; isSPACE(*name); name++) ;
150             if (strNE(name,"-"))
151                 TAINT_ENV();
152             TAINT_PROPER("piped open");
153             if (dowarn && name[strlen(name)-1] == '|')
154                 warn("Can't do bidirectional pipe");
155             fp = my_popen(name,"w");
156             writing = 1;
157         }
158         else if (*name == '>') {
159             TAINT_PROPER("open");
160             name++;
161             if (*name == '>') {
162                 mode[0] = IoTYPE(io) = 'a';
163                 name++;
164             }
165             else
166                 mode[0] = 'w';
167             writing = 1;
168
169             if (*name == '&') {
170               duplicity:
171                 dodup = 1;
172                 name++;
173                 if (*name == '=') {
174                     dodup = 0;
175                     name++;
176                 }
177                 if (!*name && supplied_fp)
178                     fp = supplied_fp;
179                 else {
180                     /*SUPPRESS 530*/
181                     for (; isSPACE(*name); name++) ;
182                     if (isDIGIT(*name))
183                         fd = atoi(name);
184                     else {
185                         IO* thatio;
186                         gv = gv_fetchpv(name,FALSE,SVt_PVIO);
187                         thatio = GvIO(gv);
188                         if (!thatio) {
189 #ifdef EINVAL
190                             SETERRNO(EINVAL,SS$_IVCHAN);
191 #endif
192                             goto say_false;
193                         }
194                         if (IoIFP(thatio)) {
195                             fd = PerlIO_fileno(IoIFP(thatio));
196                             if (IoTYPE(thatio) == 's')
197                                 IoTYPE(io) = 's';
198                         }
199                         else
200                             fd = -1;
201                     }
202                     if (dodup)
203                         fd = dup(fd);
204                     if (!(fp = PerlIO_fdopen(fd,mode))) {
205                         if (dodup)
206                             close(fd);
207                         }
208                 }
209             }
210             else {
211                 /*SUPPRESS 530*/
212                 for (; isSPACE(*name); name++) ;
213                 if (strEQ(name,"-")) {
214                     fp = PerlIO_stdout();
215                     IoTYPE(io) = '-';
216                 }
217                 else  {
218                     fp = PerlIO_open(name,mode);
219                 }
220             }
221         }
222         else if (*name == '<') {
223             /*SUPPRESS 530*/
224             for (name++; isSPACE(*name); name++) ;
225             mode[0] = 'r';
226             if (*name == '&')
227                 goto duplicity;
228             if (strEQ(name,"-")) {
229                 fp = PerlIO_stdin();
230                 IoTYPE(io) = '-';
231             }
232             else
233                 fp = PerlIO_open(name,mode);
234         }
235         else if (name[len-1] == '|') {
236             name[--len] = '\0';
237             while (len && isSPACE(name[len-1]))
238                 name[--len] = '\0';
239             /*SUPPRESS 530*/
240             for (; isSPACE(*name); name++) ;
241             if (strNE(name,"-"))
242                 TAINT_ENV();
243             TAINT_PROPER("piped open");
244             fp = my_popen(name,"r");
245             IoTYPE(io) = '|';
246         }
247         else {
248             IoTYPE(io) = '<';
249             /*SUPPRESS 530*/
250             for (; isSPACE(*name); name++) ;
251             if (strEQ(name,"-")) {
252                 fp = PerlIO_stdin();
253                 IoTYPE(io) = '-';
254             }
255             else
256                 fp = PerlIO_open(name,"r");
257         }
258     }
259     if (!fp) {
260         if (dowarn && IoTYPE(io) == '<' && strchr(name, '\n'))
261             warn(warn_nl, "open");
262         goto say_false;
263     }
264     if (IoTYPE(io) &&
265       IoTYPE(io) != '|' && IoTYPE(io) != '-') {
266         if (Fstat(PerlIO_fileno(fp),&statbuf) < 0) {
267             (void)PerlIO_close(fp);
268             goto say_false;
269         }
270         if (S_ISSOCK(statbuf.st_mode))
271             IoTYPE(io) = 's';   /* in case a socket was passed in to us */
272 #ifdef HAS_SOCKET
273         else if (
274 #ifdef S_IFMT
275             !(statbuf.st_mode & S_IFMT)
276 #else
277             !statbuf.st_mode
278 #endif
279         ) {
280             int buflen = sizeof tokenbuf;
281             if (getsockname(PerlIO_fileno(fp), (struct sockaddr *)tokenbuf, &buflen) >= 0
282                 || errno != ENOTSOCK)
283                 IoTYPE(io) = 's'; /* some OS's return 0 on fstat()ed socket */
284                                 /* but some return 0 for streams too, sigh */
285         }
286 #endif
287     }
288     if (saveifp) {              /* must use old fp? */
289         fd = PerlIO_fileno(saveifp);
290         if (saveofp) {
291             PerlIO_flush(saveofp);              /* emulate PerlIO_close() */
292             if (saveofp != saveifp) {   /* was a socket? */
293                 PerlIO_close(saveofp);
294                 if (fd > 2)
295                     Safefree(saveofp);
296             }
297         }
298         if (fd != PerlIO_fileno(fp)) {
299             int pid;
300             SV *sv;
301
302             dup2(PerlIO_fileno(fp), fd);
303             sv = *av_fetch(fdpid,PerlIO_fileno(fp),TRUE);
304             (void)SvUPGRADE(sv, SVt_IV);
305             pid = SvIVX(sv);
306             SvIVX(sv) = 0;
307             sv = *av_fetch(fdpid,fd,TRUE);
308             (void)SvUPGRADE(sv, SVt_IV);
309             SvIVX(sv) = pid;
310             PerlIO_close(fp);
311
312         }
313         fp = saveifp;
314         PerlIO_clearerr(fp);
315     }
316 #if defined(HAS_FCNTL) && defined(F_SETFD)
317     fd = PerlIO_fileno(fp);
318     fcntl(fd,F_SETFD,fd > maxsysfd);
319 #endif
320     IoIFP(io) = fp;
321     if (writing) {
322         if (IoTYPE(io) == 's'
323           || (IoTYPE(io) == '>' && S_ISCHR(statbuf.st_mode)) ) {
324             if (!(IoOFP(io) = PerlIO_fdopen(PerlIO_fileno(fp),"w"))) {
325                 PerlIO_close(fp);
326                 IoIFP(io) = Nullfp;
327                 goto say_false;
328             }
329         }
330         else
331             IoOFP(io) = fp;
332     }
333     return TRUE;
334
335 say_false:
336     IoIFP(io) = saveifp;
337     IoOFP(io) = saveofp;
338     IoTYPE(io) = savetype;
339     return FALSE;
340 }
341
342 PerlIO *
343 nextargv(gv)
344 register GV *gv;
345 {
346     register SV *sv;
347 #ifndef FLEXFILENAMES
348     int filedev;
349     int fileino;
350 #endif
351     int fileuid;
352     int filegid;
353
354     if (!argvoutgv)
355         argvoutgv = gv_fetchpv("ARGVOUT",TRUE,SVt_PVIO);
356     if (filemode & (S_ISUID|S_ISGID)) {
357         PerlIO_flush(IoIFP(GvIOn(argvoutgv)));  /* chmod must follow last write */
358 #ifdef HAS_FCHMOD
359         (void)fchmod(lastfd,filemode);
360 #else
361         (void)chmod(oldname,filemode);
362 #endif
363     }
364     filemode = 0;
365     while (av_len(GvAV(gv)) >= 0) {
366         STRLEN len;
367         sv = av_shift(GvAV(gv));
368         SAVEFREESV(sv);
369         sv_setsv(GvSV(gv),sv);
370         SvSETMAGIC(GvSV(gv));
371         oldname = SvPVx(GvSV(gv), len);
372         if (do_open(gv,oldname,len,FALSE,0,0,Nullfp)) {
373             if (inplace) {
374                 TAINT_PROPER("inplace open");
375                 if (strEQ(oldname,"-")) {
376                     setdefout(gv_fetchpv("STDOUT",TRUE,SVt_PVIO));
377                     return IoIFP(GvIOp(gv));
378                 }
379 #ifndef FLEXFILENAMES
380                 filedev = statbuf.st_dev;
381                 fileino = statbuf.st_ino;
382 #endif
383                 filemode = statbuf.st_mode;
384                 fileuid = statbuf.st_uid;
385                 filegid = statbuf.st_gid;
386                 if (!S_ISREG(filemode)) {
387                     warn("Can't do inplace edit: %s is not a regular file",
388                       oldname );
389                     do_close(gv,FALSE);
390                     continue;
391                 }
392                 if (*inplace) {
393 #ifdef SUFFIX
394                     add_suffix(sv,inplace);
395 #else
396                     sv_catpv(sv,inplace);
397 #endif
398 #ifndef FLEXFILENAMES
399                     if (Stat(SvPVX(sv),&statbuf) >= 0
400                       && statbuf.st_dev == filedev
401                       && statbuf.st_ino == fileino ) {
402                         warn("Can't do inplace edit: %s > 14 characters",
403                           SvPVX(sv) );
404                         do_close(gv,FALSE);
405                         continue;
406                     }
407 #endif
408 #ifdef HAS_RENAME
409 #ifndef DOSISH
410                     if (rename(oldname,SvPVX(sv)) < 0) {
411                         warn("Can't rename %s to %s: %s, skipping file",
412                           oldname, SvPVX(sv), Strerror(errno) );
413                         do_close(gv,FALSE);
414                         continue;
415                     }
416 #else
417                     do_close(gv,FALSE);
418                     (void)unlink(SvPVX(sv));
419                     (void)rename(oldname,SvPVX(sv));
420                     do_open(gv,SvPVX(sv),SvCUR(sv),FALSE,0,0,Nullfp);
421 #endif /* DOSISH */
422 #else
423                     (void)UNLINK(SvPVX(sv));
424                     if (link(oldname,SvPVX(sv)) < 0) {
425                         warn("Can't rename %s to %s: %s, skipping file",
426                           oldname, SvPVX(sv), Strerror(errno) );
427                         do_close(gv,FALSE);
428                         continue;
429                     }
430                     (void)UNLINK(oldname);
431 #endif
432                 }
433                 else {
434 #if !defined(DOSISH) && !defined(AMIGAOS)
435 #  ifndef VMS  /* Don't delete; use automatic file versioning */
436                     if (UNLINK(oldname) < 0) {
437                         warn("Can't rename %s to %s: %s, skipping file",
438                           oldname, SvPVX(sv), Strerror(errno) );
439                         do_close(gv,FALSE);
440                         continue;
441                     }
442 #  endif
443 #else
444                     croak("Can't do inplace edit without backup");
445 #endif
446                 }
447
448                 sv_setpvn(sv,">",1);
449                 sv_catpv(sv,oldname);
450                 SETERRNO(0,0);          /* in case sprintf set errno */
451                 if (!do_open(argvoutgv,SvPVX(sv),SvCUR(sv),FALSE,0,0,Nullfp)) {
452                     warn("Can't do inplace edit on %s: %s",
453                       oldname, Strerror(errno) );
454                     do_close(gv,FALSE);
455                     continue;
456                 }
457                 setdefout(argvoutgv);
458                 lastfd = PerlIO_fileno(IoIFP(GvIOp(argvoutgv)));
459                 (void)Fstat(lastfd,&statbuf);
460 #ifdef HAS_FCHMOD
461                 (void)fchmod(lastfd,filemode);
462 #else
463                 (void)chmod(oldname,filemode);
464 #endif
465                 if (fileuid != statbuf.st_uid || filegid != statbuf.st_gid) {
466 #ifdef HAS_FCHOWN
467                     (void)fchown(lastfd,fileuid,filegid);
468 #else
469 #ifdef HAS_CHOWN
470                     (void)chown(oldname,fileuid,filegid);
471 #endif
472 #endif
473                 }
474             }
475             return IoIFP(GvIOp(gv));
476         }
477         else
478             PerlIO_printf(PerlIO_stderr(), "Can't open %s: %s\n",SvPV(sv, na), Strerror(errno));
479     }
480     if (inplace) {
481         (void)do_close(argvoutgv,FALSE);
482         setdefout(gv_fetchpv("STDOUT",TRUE,SVt_PVIO));
483     }
484     return Nullfp;
485 }
486
487 #ifdef HAS_PIPE
488 void
489 do_pipe(sv, rgv, wgv)
490 SV *sv;
491 GV *rgv;
492 GV *wgv;
493 {
494     register IO *rstio;
495     register IO *wstio;
496     int fd[2];
497
498     if (!rgv)
499         goto badexit;
500     if (!wgv)
501         goto badexit;
502
503     rstio = GvIOn(rgv);
504     wstio = GvIOn(wgv);
505
506     if (IoIFP(rstio))
507         do_close(rgv,FALSE);
508     if (IoIFP(wstio))
509         do_close(wgv,FALSE);
510
511     if (pipe(fd) < 0)
512         goto badexit;
513     IoIFP(rstio) = PerlIO_fdopen(fd[0], "r");
514     IoOFP(wstio) = PerlIO_fdopen(fd[1], "w");
515     IoIFP(wstio) = IoOFP(wstio);
516     IoTYPE(rstio) = '<';
517     IoTYPE(wstio) = '>';
518     if (!IoIFP(rstio) || !IoOFP(wstio)) {
519         if (IoIFP(rstio)) PerlIO_close(IoIFP(rstio));
520         else close(fd[0]);
521         if (IoOFP(wstio)) PerlIO_close(IoOFP(wstio));
522         else close(fd[1]);
523         goto badexit;
524     }
525
526     sv_setsv(sv,&sv_yes);
527     return;
528
529 badexit:
530     sv_setsv(sv,&sv_undef);
531     return;
532 }
533 #endif
534
535 /* explicit renamed to avoid C++ conflict    -- kja */
536 bool
537 #ifndef CAN_PROTOTYPE
538 do_close(gv,not_implicit)
539 GV *gv;
540 bool not_implicit;
541 #else
542 do_close(GV *gv, bool not_implicit)
543 #endif /* CAN_PROTOTYPE */
544 {
545     bool retval;
546     IO *io;
547
548     if (!gv)
549         gv = argvgv;
550     if (!gv || SvTYPE(gv) != SVt_PVGV) {
551         SETERRNO(EBADF,SS$_IVCHAN);
552         return FALSE;
553     }
554     io = GvIO(gv);
555     if (!io) {          /* never opened */
556         if (dowarn && not_implicit)
557             warn("Close on unopened file <%s>",GvENAME(gv));
558         return FALSE;
559     }
560     retval = io_close(io);
561     if (not_implicit) {
562         IoLINES(io) = 0;
563         IoPAGE(io) = 0;
564         IoLINES_LEFT(io) = IoPAGE_LEN(io);
565     }
566     IoTYPE(io) = ' ';
567     return retval;
568 }
569
570 bool
571 io_close(io)
572 IO* io;
573 {
574     bool retval = FALSE;
575     int status;
576
577     if (IoIFP(io)) {
578         if (IoTYPE(io) == '|') {
579             status = my_pclose(IoIFP(io));
580             retval = (status == 0);
581             statusvalue = FIXSTATUS(status);
582         }
583         else if (IoTYPE(io) == '-')
584             retval = TRUE;
585         else {
586             if (IoOFP(io) && IoOFP(io) != IoIFP(io)) {          /* a socket */
587                 retval = (PerlIO_close(IoOFP(io)) != EOF);
588                 PerlIO_close(IoIFP(io));        /* clear stdio, fd already closed */
589             }
590             else
591                 retval = (PerlIO_close(IoIFP(io)) != EOF);
592         }
593         IoOFP(io) = IoIFP(io) = Nullfp;
594     }
595
596     return retval;
597 }
598
599 bool
600 do_eof(gv)
601 GV *gv;
602 {
603     register IO *io;
604     int ch;
605
606     io = GvIO(gv);
607
608     if (!io)
609         return TRUE;
610
611     while (IoIFP(io)) {
612
613         if (PerlIO_has_cntptr(IoIFP(io))) {     /* (the code works without this) */
614             if (PerlIO_get_cnt(IoIFP(io)) > 0)  /* cheat a little, since */
615                 return FALSE;                   /* this is the most usual case */
616         }
617
618         ch = PerlIO_getc(IoIFP(io));
619         if (ch != EOF) {
620             (void)PerlIO_ungetc(IoIFP(io),ch);
621             return FALSE;
622         }
623         if (PerlIO_has_cntptr(IoIFP(io)) && PerlIO_canset_cnt(IoIFP(io))) {
624             if (PerlIO_get_cnt(IoIFP(io)) < -1)
625                 PerlIO_set_cnt(IoIFP(io),-1);
626         }
627         if (op->op_flags & OPf_SPECIAL) { /* not necessarily a real EOF yet? */
628             if (!nextargv(argvgv))      /* get another fp handy */
629                 return TRUE;
630         }
631         else
632             return TRUE;                /* normal fp, definitely end of file */
633     }
634     return TRUE;
635 }
636
637 long
638 do_tell(gv)
639 GV *gv;
640 {
641     register IO *io;
642
643     if (!gv)
644         goto phooey;
645
646     io = GvIO(gv);
647     if (!io || !IoIFP(io))
648         goto phooey;
649
650 #ifdef ULTRIX_STDIO_BOTCH
651     if (PerlIO_eof(IoIFP(io)))
652         (void)PerlIO_seek (IoIFP(io), 0L, 2);           /* ultrix 1.2 workaround */
653 #endif
654
655     return PerlIO_tell(IoIFP(io));
656
657 phooey:
658     if (dowarn)
659         warn("tell() on unopened file");
660     SETERRNO(EBADF,RMS$_IFI);
661     return -1L;
662 }
663
664 bool
665 do_seek(gv, pos, whence)
666 GV *gv;
667 long pos;
668 int whence;
669 {
670     register IO *io;
671
672     if (!gv)
673         goto nuts;
674
675     io = GvIO(gv);
676     if (!io || !IoIFP(io))
677         goto nuts;
678
679 #ifdef ULTRIX_STDIO_BOTCH
680     if (PerlIO_eof(IoIFP(io)))
681         (void)PerlIO_seek (IoIFP(io), 0L, 2);           /* ultrix 1.2 workaround */
682 #endif
683
684     return PerlIO_seek(IoIFP(io), pos, whence) >= 0;
685
686 nuts:
687     if (dowarn)
688         warn("seek() on unopened file");
689     SETERRNO(EBADF,RMS$_IFI);
690     return FALSE;
691 }
692
693 #if !defined(HAS_TRUNCATE) && !defined(HAS_CHSIZE) && defined(F_FREESP)
694         /* code courtesy of William Kucharski */
695 #define HAS_CHSIZE
696
697 I32 my_chsize(fd, length)
698 I32 fd;                 /* file descriptor */
699 Off_t length;           /* length to set file to */
700 {
701     extern long lseek();
702     struct flock fl;
703     struct stat filebuf;
704
705     if (Fstat(fd, &filebuf) < 0)
706         return -1;
707
708     if (filebuf.st_size < length) {
709
710         /* extend file length */
711
712         if ((lseek(fd, (length - 1), 0)) < 0)
713             return -1;
714
715         /* write a "0" byte */
716
717         if ((write(fd, "", 1)) != 1)
718             return -1;
719     }
720     else {
721         /* truncate length */
722
723         fl.l_whence = 0;
724         fl.l_len = 0;
725         fl.l_start = length;
726         fl.l_type = F_WRLCK;    /* write lock on file space */
727
728         /*
729         * This relies on the UNDOCUMENTED F_FREESP argument to
730         * fcntl(2), which truncates the file so that it ends at the
731         * position indicated by fl.l_start.
732         *
733         * Will minor miracles never cease?
734         */
735
736         if (fcntl(fd, F_FREESP, &fl) < 0)
737             return -1;
738
739     }
740
741     return 0;
742 }
743 #endif /* F_FREESP */
744
745 bool
746 do_print(sv,fp)
747 register SV *sv;
748 PerlIO *fp;
749 {
750     register char *tmps;
751     STRLEN len;
752
753     /* assuming fp is checked earlier */
754     if (!sv)
755         return TRUE;
756     if (ofmt) {
757         if (SvGMAGICAL(sv))
758             mg_get(sv);
759         if (SvIOK(sv) && SvIVX(sv) != 0) {
760             PerlIO_printf(fp, ofmt, (double)SvIVX(sv));
761             return !PerlIO_error(fp);
762         }
763         if (  (SvNOK(sv) && SvNVX(sv) != 0.0)
764            || (looks_like_number(sv) && sv_2nv(sv) != 0.0) ) {
765             PerlIO_printf(fp, ofmt, SvNVX(sv));
766             return !PerlIO_error(fp);
767         }
768     }
769     switch (SvTYPE(sv)) {
770     case SVt_NULL:
771         if (dowarn)
772             warn(warn_uninit);
773         return TRUE;
774     case SVt_IV:
775         if (SvIOK(sv)) {
776             if (SvGMAGICAL(sv))
777                 mg_get(sv);
778             PerlIO_printf(fp, "%ld", (long)SvIVX(sv));
779             return !PerlIO_error(fp);
780         }
781         /* FALL THROUGH */
782     default:
783         tmps = SvPV(sv, len);
784         break;
785     }
786     if (len && (PerlIO_write(fp,tmps,len) == 0 || PerlIO_error(fp)))
787         return FALSE;
788     return !PerlIO_error(fp);
789 }
790
791 I32
792 my_stat(ARGS)
793 dARGS
794 {
795     dSP;
796     IO *io;
797     GV* tmpgv;
798
799     if (op->op_flags & OPf_REF) {
800         EXTEND(sp,1);
801         tmpgv = cGVOP->op_gv;
802       do_fstat:
803         io = GvIO(tmpgv);
804         if (io && IoIFP(io)) {
805             statgv = tmpgv;
806             sv_setpv(statname,"");
807             laststype = OP_STAT;
808             return (laststatval = Fstat(PerlIO_fileno(IoIFP(io)), &statcache));
809         }
810         else {
811             if (tmpgv == defgv)
812                 return laststatval;
813             if (dowarn)
814                 warn("Stat on unopened file <%s>",
815                   GvENAME(tmpgv));
816             statgv = Nullgv;
817             sv_setpv(statname,"");
818             return (laststatval = -1);
819         }
820     }
821     else {
822         SV* sv = POPs;
823         PUTBACK;
824         if (SvTYPE(sv) == SVt_PVGV) {
825             tmpgv = (GV*)sv;
826             goto do_fstat;
827         }
828         else if (SvROK(sv) && SvTYPE(SvRV(sv)) == SVt_PVGV) {
829             tmpgv = (GV*)SvRV(sv);
830             goto do_fstat;
831         }
832
833         statgv = Nullgv;
834         sv_setpv(statname,SvPV(sv, na));
835         laststype = OP_STAT;
836         laststatval = Stat(SvPV(sv, na),&statcache);
837         if (laststatval < 0 && dowarn && strchr(SvPV(sv, na), '\n'))
838             warn(warn_nl, "stat");
839         return laststatval;
840     }
841 }
842
843 I32
844 my_lstat(ARGS)
845 dARGS
846 {
847     dSP;
848     SV *sv;
849     if (op->op_flags & OPf_REF) {
850         EXTEND(sp,1);
851         if (cGVOP->op_gv == defgv) {
852             if (laststype != OP_LSTAT)
853                 croak("The stat preceding -l _ wasn't an lstat");
854             return laststatval;
855         }
856         croak("You can't use -l on a filehandle");
857     }
858
859     laststype = OP_LSTAT;
860     statgv = Nullgv;
861     sv = POPs;
862     PUTBACK;
863     sv_setpv(statname,SvPV(sv, na));
864 #ifdef HAS_LSTAT
865     laststatval = lstat(SvPV(sv, na),&statcache);
866 #else
867     laststatval = Stat(SvPV(sv, na),&statcache);
868 #endif
869     if (laststatval < 0 && dowarn && strchr(SvPV(sv, na), '\n'))
870         warn(warn_nl, "lstat");
871     return laststatval;
872 }
873
874 bool
875 do_aexec(really,mark,sp)
876 SV *really;
877 register SV **mark;
878 register SV **sp;
879 {
880     register char **a;
881     char *tmps;
882
883     if (sp > mark) {
884         New(401,Argv, sp - mark + 1, char*);
885         a = Argv;
886         while (++mark <= sp) {
887             if (*mark)
888                 *a++ = SvPVx(*mark, na);
889             else
890                 *a++ = "";
891         }
892         *a = Nullch;
893         if (*Argv[0] != '/')    /* will execvp use PATH? */
894             TAINT_ENV();                /* testing IFS here is overkill, probably */
895         if (really && *(tmps = SvPV(really, na)))
896             execvp(tmps,Argv);
897         else
898             execvp(Argv[0],Argv);
899         if (dowarn)
900             warn("Can't exec \"%s\": %s", Argv[0], Strerror(errno));
901     }
902     do_execfree();
903     return FALSE;
904 }
905
906 void
907 do_execfree()
908 {
909     if (Argv) {
910         Safefree(Argv);
911         Argv = Null(char **);
912     }
913     if (Cmd) {
914         Safefree(Cmd);
915         Cmd = Nullch;
916     }
917 }
918
919 #ifndef OS2
920
921 bool
922 do_exec(cmd)
923 char *cmd;
924 {
925     register char **a;
926     register char *s;
927     char flags[10];
928
929     while (*cmd && isSPACE(*cmd))
930         cmd++;
931
932     /* save an extra exec if possible */
933
934 #ifdef CSH
935     if (strnEQ(cmd,cshname,cshlen) && strnEQ(cmd+cshlen," -c",3)) {
936         strcpy(flags,"-c");
937         s = cmd+cshlen+3;
938         if (*s == 'f') {
939             s++;
940             strcat(flags,"f");
941         }
942         if (*s == ' ')
943             s++;
944         if (*s++ == '\'') {
945             char *ncmd = s;
946
947             while (*s)
948                 s++;
949             if (s[-1] == '\n')
950                 *--s = '\0';
951             if (s[-1] == '\'') {
952                 *--s = '\0';
953                 execl(cshname,"csh", flags,ncmd,(char*)0);
954                 *s = '\'';
955                 return FALSE;
956             }
957         }
958     }
959 #endif /* CSH */
960
961     /* see if there are shell metacharacters in it */
962
963     if (*cmd == '.' && isSPACE(cmd[1]))
964         goto doshell;
965
966     if (strnEQ(cmd,"exec",4) && isSPACE(cmd[4]))
967         goto doshell;
968
969     for (s = cmd; *s && isALPHA(*s); s++) ;     /* catch VAR=val gizmo */
970     if (*s == '=')
971         goto doshell;
972
973     for (s = cmd; *s; s++) {
974         if (*s != ' ' && !isALPHA(*s) && strchr("$&*(){}[]'\";\\|?<>~`\n",*s)) {
975             if (*s == '\n' && !s[1]) {
976                 *s = '\0';
977                 break;
978             }
979           doshell:
980             execl(sh_path, "sh", "-c", cmd, (char*)0);
981             return FALSE;
982         }
983     }
984
985     New(402,Argv, (s - cmd) / 2 + 2, char*);
986     Cmd = savepvn(cmd, s-cmd);
987     a = Argv;
988     for (s = Cmd; *s;) {
989         while (*s && isSPACE(*s)) s++;
990         if (*s)
991             *(a++) = s;
992         while (*s && !isSPACE(*s)) s++;
993         if (*s)
994             *s++ = '\0';
995     }
996     *a = Nullch;
997     if (Argv[0]) {
998         execvp(Argv[0],Argv);
999         if (errno == ENOEXEC) {         /* for system V NIH syndrome */
1000             do_execfree();
1001             goto doshell;
1002         }
1003         if (dowarn)
1004             warn("Can't exec \"%s\": %s", Argv[0], Strerror(errno));
1005     }
1006     do_execfree();
1007     return FALSE;
1008 }
1009
1010 #endif /* OS2 */
1011
1012 I32
1013 apply(type,mark,sp)
1014 I32 type;
1015 register SV **mark;
1016 register SV **sp;
1017 {
1018     register I32 val;
1019     register I32 val2;
1020     register I32 tot = 0;
1021     char *s;
1022     SV **oldmark = mark;
1023
1024     if (tainting) {
1025         while (++mark <= sp) {
1026             if (SvTAINTED(*mark)) {
1027                 TAINT;
1028                 break;
1029             }
1030         }
1031         mark = oldmark;
1032     }
1033     switch (type) {
1034     case OP_CHMOD:
1035         TAINT_PROPER("chmod");
1036         if (++mark <= sp) {
1037             tot = sp - mark;
1038             val = SvIVx(*mark);
1039             while (++mark <= sp) {
1040                 if (chmod(SvPVx(*mark, na),val))
1041                     tot--;
1042             }
1043         }
1044         break;
1045 #ifdef HAS_CHOWN
1046     case OP_CHOWN:
1047         TAINT_PROPER("chown");
1048         if (sp - mark > 2) {
1049             val = SvIVx(*++mark);
1050             val2 = SvIVx(*++mark);
1051             tot = sp - mark;
1052             while (++mark <= sp) {
1053                 if (chown(SvPVx(*mark, na),val,val2))
1054                     tot--;
1055             }
1056         }
1057         break;
1058 #endif
1059 #ifdef HAS_KILL
1060     case OP_KILL:
1061         TAINT_PROPER("kill");
1062         if (mark == sp)
1063             break;
1064         s = SvPVx(*++mark, na);
1065         tot = sp - mark;
1066         if (isUPPER(*s)) {
1067             if (*s == 'S' && s[1] == 'I' && s[2] == 'G')
1068                 s += 3;
1069             if (!(val = whichsig(s)))
1070                 croak("Unrecognized signal name \"%s\"",s);
1071         }
1072         else
1073             val = SvIVx(*mark);
1074 #ifdef VMS
1075         /* kill() doesn't do process groups (job trees?) under VMS */
1076         if (val < 0) val = -val;
1077         if (val == SIGKILL) {
1078 #           include <starlet.h>
1079             /* Use native sys$delprc() to insure that target process is
1080              * deleted; supervisor-mode images don't pay attention to
1081              * CRTL's emulation of Unix-style signals and kill()
1082              */
1083             while (++mark <= sp) {
1084                 I32 proc = SvIVx(*mark);
1085                 register unsigned long int __vmssts;
1086                 if (!((__vmssts = sys$delprc(&proc,0)) & 1)) {
1087                     tot--;
1088                     switch (__vmssts) {
1089                         case SS$_NONEXPR:
1090                         case SS$_NOSUCHNODE:
1091                             SETERRNO(ESRCH,__vmssts);
1092                             break;
1093                         case SS$_NOPRIV:
1094                             SETERRNO(EPERM,__vmssts);
1095                             break;
1096                         default:
1097                             SETERRNO(EVMSERR,__vmssts);
1098                     }
1099                 }
1100             }
1101             break;
1102         }
1103 #endif
1104         if (val < 0) {
1105             val = -val;
1106             while (++mark <= sp) {
1107                 I32 proc = SvIVx(*mark);
1108 #ifdef HAS_KILLPG
1109                 if (killpg(proc,val))   /* BSD */
1110 #else
1111                 if (kill(-proc,val))    /* SYSV */
1112 #endif
1113                     tot--;
1114             }
1115         }
1116         else {
1117             while (++mark <= sp) {
1118                 if (kill(SvIVx(*mark),val))
1119                     tot--;
1120             }
1121         }
1122         break;
1123 #endif
1124     case OP_UNLINK:
1125         TAINT_PROPER("unlink");
1126         tot = sp - mark;
1127         while (++mark <= sp) {
1128             s = SvPVx(*mark, na);
1129             if (euid || unsafe) {
1130                 if (UNLINK(s))
1131                     tot--;
1132             }
1133             else {      /* don't let root wipe out directories without -U */
1134 #ifdef HAS_LSTAT
1135                 if (lstat(s,&statbuf) < 0 || S_ISDIR(statbuf.st_mode))
1136 #else
1137                 if (Stat(s,&statbuf) < 0 || S_ISDIR(statbuf.st_mode))
1138 #endif
1139                     tot--;
1140                 else {
1141                     if (UNLINK(s))
1142                         tot--;
1143                 }
1144             }
1145         }
1146         break;
1147 #ifdef HAS_UTIME
1148     case OP_UTIME:
1149         TAINT_PROPER("utime");
1150         if (sp - mark > 2) {
1151 #if defined(I_UTIME) || defined(VMS)
1152             struct utimbuf utbuf;
1153 #else
1154             struct {
1155                 long    actime;
1156                 long    modtime;
1157             } utbuf;
1158 #endif
1159
1160             Zero(&utbuf, sizeof utbuf, char);
1161 #ifdef BIG_TIME
1162             utbuf.actime = (Time_t)SvNVx(*++mark);    /* time accessed */
1163             utbuf.modtime = (Time_t)SvNVx(*++mark);    /* time modified */
1164 #else
1165             utbuf.actime = SvIVx(*++mark);    /* time accessed */
1166             utbuf.modtime = SvIVx(*++mark);    /* time modified */
1167 #endif
1168             tot = sp - mark;
1169             while (++mark <= sp) {
1170                 if (utime(SvPVx(*mark, na),&utbuf))
1171                     tot--;
1172             }
1173         }
1174         else
1175             tot = 0;
1176         break;
1177 #endif
1178     }
1179     return tot;
1180 }
1181
1182 /* Do the permissions allow some operation?  Assumes statcache already set. */
1183 #ifndef VMS /* VMS' cando is in vms.c */
1184 I32
1185 cando(bit, effective, statbufp)
1186 I32 bit;
1187 I32 effective;
1188 register struct stat *statbufp;
1189 {
1190 #ifdef DOSISH
1191     /* [Comments and code from Len Reed]
1192      * MS-DOS "user" is similar to UNIX's "superuser," but can't write
1193      * to write-protected files.  The execute permission bit is set
1194      * by the Miscrosoft C library stat() function for the following:
1195      *          .exe files
1196      *          .com files
1197      *          .bat files
1198      *          directories
1199      * All files and directories are readable.
1200      * Directories and special files, e.g. "CON", cannot be
1201      * write-protected.
1202      * [Comment by Tom Dinger -- a directory can have the write-protect
1203      *          bit set in the file system, but DOS permits changes to
1204      *          the directory anyway.  In addition, all bets are off
1205      *          here for networked software, such as Novell and
1206      *          Sun's PC-NFS.]
1207      */
1208
1209      /* Atari stat() does pretty much the same thing. we set x_bit_set_in_stat
1210       * too so it will actually look into the files for magic numbers
1211       */
1212      return (bit & statbufp->st_mode) ? TRUE : FALSE;
1213
1214 #else /* ! DOSISH */
1215     if ((effective ? euid : uid) == 0) {        /* root is special */
1216         if (bit == S_IXUSR) {
1217             if (statbufp->st_mode & 0111 || S_ISDIR(statbufp->st_mode))
1218                 return TRUE;
1219         }
1220         else
1221             return TRUE;                /* root reads and writes anything */
1222         return FALSE;
1223     }
1224     if (statbufp->st_uid == (effective ? euid : uid) ) {
1225         if (statbufp->st_mode & bit)
1226             return TRUE;        /* ok as "user" */
1227     }
1228     else if (ingroup((I32)statbufp->st_gid,effective)) {
1229         if (statbufp->st_mode & bit >> 3)
1230             return TRUE;        /* ok as "group" */
1231     }
1232     else if (statbufp->st_mode & bit >> 6)
1233         return TRUE;    /* ok as "other" */
1234     return FALSE;
1235 #endif /* ! DOSISH */
1236 }
1237 #endif /* ! VMS */
1238
1239 I32
1240 ingroup(testgid,effective)
1241 I32 testgid;
1242 I32 effective;
1243 {
1244     if (testgid == (effective ? egid : gid))
1245         return TRUE;
1246 #ifdef HAS_GETGROUPS
1247 #ifndef NGROUPS
1248 #define NGROUPS 32
1249 #endif
1250     {
1251         Groups_t gary[NGROUPS];
1252         I32 anum;
1253
1254         anum = getgroups(NGROUPS,gary);
1255         while (--anum >= 0)
1256             if (gary[anum] == testgid)
1257                 return TRUE;
1258     }
1259 #endif
1260     return FALSE;
1261 }
1262
1263 #if defined(HAS_MSG) || defined(HAS_SEM) || defined(HAS_SHM)
1264
1265 I32
1266 do_ipcget(optype, mark, sp)
1267 I32 optype;
1268 SV **mark;
1269 SV **sp;
1270 {
1271     key_t key;
1272     I32 n, flags;
1273
1274     key = (key_t)SvNVx(*++mark);
1275     n = (optype == OP_MSGGET) ? 0 : SvIVx(*++mark);
1276     flags = SvIVx(*++mark);
1277     SETERRNO(0,0);
1278     switch (optype)
1279     {
1280 #ifdef HAS_MSG
1281     case OP_MSGGET:
1282         return msgget(key, flags);
1283 #endif
1284 #ifdef HAS_SEM
1285     case OP_SEMGET:
1286         return semget(key, n, flags);
1287 #endif
1288 #ifdef HAS_SHM
1289     case OP_SHMGET:
1290         return shmget(key, n, flags);
1291 #endif
1292 #if !defined(HAS_MSG) || !defined(HAS_SEM) || !defined(HAS_SHM)
1293     default:
1294         croak("%s not implemented", op_desc[optype]);
1295 #endif
1296     }
1297     return -1;                  /* should never happen */
1298 }
1299
1300 I32
1301 do_ipcctl(optype, mark, sp)
1302 I32 optype;
1303 SV **mark;
1304 SV **sp;
1305 {
1306     SV *astr;
1307     char *a;
1308     I32 id, n, cmd, infosize, getinfo;
1309     I32 ret = -1;
1310
1311     id = SvIVx(*++mark);
1312     n = (optype == OP_SEMCTL) ? SvIVx(*++mark) : 0;
1313     cmd = SvIVx(*++mark);
1314     astr = *++mark;
1315     infosize = 0;
1316     getinfo = (cmd == IPC_STAT);
1317
1318     switch (optype)
1319     {
1320 #ifdef HAS_MSG
1321     case OP_MSGCTL:
1322         if (cmd == IPC_STAT || cmd == IPC_SET)
1323             infosize = sizeof(struct msqid_ds);
1324         break;
1325 #endif
1326 #ifdef HAS_SHM
1327     case OP_SHMCTL:
1328         if (cmd == IPC_STAT || cmd == IPC_SET)
1329             infosize = sizeof(struct shmid_ds);
1330         break;
1331 #endif
1332 #ifdef HAS_SEM
1333     case OP_SEMCTL:
1334         if (cmd == IPC_STAT || cmd == IPC_SET)
1335             infosize = sizeof(struct semid_ds);
1336         else if (cmd == GETALL || cmd == SETALL)
1337         {
1338             struct semid_ds semds;
1339             if (semctl(id, 0, IPC_STAT, &semds) == -1)
1340                 return -1;
1341             getinfo = (cmd == GETALL);
1342             infosize = semds.sem_nsems * sizeof(short);
1343                 /* "short" is technically wrong but much more portable
1344                    than guessing about u_?short(_t)? */
1345         }
1346         break;
1347 #endif
1348 #if !defined(HAS_MSG) || !defined(HAS_SEM) || !defined(HAS_SHM)
1349     default:
1350         croak("%s not implemented", op_desc[optype]);
1351 #endif
1352     }
1353
1354     if (infosize)
1355     {
1356         STRLEN len;
1357         if (getinfo)
1358         {
1359             SvPV_force(astr, len);
1360             a = SvGROW(astr, infosize+1);
1361         }
1362         else
1363         {
1364             a = SvPV(astr, len);
1365             if (len != infosize)
1366                 croak("Bad arg length for %s, is %d, should be %d",
1367                         op_desc[optype], len, infosize);
1368         }
1369     }
1370     else
1371     {
1372         I32 i = SvIV(astr);
1373         a = (char *)i;          /* ouch */
1374     }
1375     SETERRNO(0,0);
1376     switch (optype)
1377     {
1378 #ifdef HAS_MSG
1379     case OP_MSGCTL:
1380         ret = msgctl(id, cmd, (struct msqid_ds *)a);
1381         break;
1382 #endif
1383 #ifdef HAS_SEM
1384     case OP_SEMCTL:
1385         ret = semctl(id, n, cmd, (struct semid_ds *)a);
1386         break;
1387 #endif
1388 #ifdef HAS_SHM
1389     case OP_SHMCTL:
1390         ret = shmctl(id, cmd, (struct shmid_ds *)a);
1391         break;
1392 #endif
1393     }
1394     if (getinfo && ret >= 0) {
1395         SvCUR_set(astr, infosize);
1396         *SvEND(astr) = '\0';
1397         SvSETMAGIC(astr);
1398     }
1399     return ret;
1400 }
1401
1402 I32
1403 do_msgsnd(mark, sp)
1404 SV **mark;
1405 SV **sp;
1406 {
1407 #ifdef HAS_MSG
1408     SV *mstr;
1409     char *mbuf;
1410     I32 id, msize, flags;
1411     STRLEN len;
1412
1413     id = SvIVx(*++mark);
1414     mstr = *++mark;
1415     flags = SvIVx(*++mark);
1416     mbuf = SvPV(mstr, len);
1417     if ((msize = len - sizeof(long)) < 0)
1418         croak("Arg too short for msgsnd");
1419     SETERRNO(0,0);
1420     return msgsnd(id, (struct msgbuf *)mbuf, msize, flags);
1421 #else
1422     croak("msgsnd not implemented");
1423 #endif
1424 }
1425
1426 I32
1427 do_msgrcv(mark, sp)
1428 SV **mark;
1429 SV **sp;
1430 {
1431 #ifdef HAS_MSG
1432     SV *mstr;
1433     char *mbuf;
1434     long mtype;
1435     I32 id, msize, flags, ret;
1436     STRLEN len;
1437
1438     id = SvIVx(*++mark);
1439     mstr = *++mark;
1440     msize = SvIVx(*++mark);
1441     mtype = (long)SvIVx(*++mark);
1442     flags = SvIVx(*++mark);
1443     if (SvTHINKFIRST(mstr)) {
1444         if (SvREADONLY(mstr))
1445             croak("Can't msgrcv to readonly var");
1446         if (SvROK(mstr))
1447             sv_unref(mstr);
1448     }
1449     SvPV_force(mstr, len);
1450     mbuf = SvGROW(mstr, sizeof(long)+msize+1);
1451     
1452     SETERRNO(0,0);
1453     ret = msgrcv(id, (struct msgbuf *)mbuf, msize, mtype, flags);
1454     if (ret >= 0) {
1455         SvCUR_set(mstr, sizeof(long)+ret);
1456         *SvEND(mstr) = '\0';
1457     }
1458     return ret;
1459 #else
1460     croak("msgrcv not implemented");
1461 #endif
1462 }
1463
1464 I32
1465 do_semop(mark, sp)
1466 SV **mark;
1467 SV **sp;
1468 {
1469 #ifdef HAS_SEM
1470     SV *opstr;
1471     char *opbuf;
1472     I32 id;
1473     STRLEN opsize;
1474
1475     id = SvIVx(*++mark);
1476     opstr = *++mark;
1477     opbuf = SvPV(opstr, opsize);
1478     if (opsize < sizeof(struct sembuf)
1479         || (opsize % sizeof(struct sembuf)) != 0) {
1480         SETERRNO(EINVAL,LIB$_INVARG);
1481         return -1;
1482     }
1483     SETERRNO(0,0);
1484     return semop(id, (struct sembuf *)opbuf, opsize/sizeof(struct sembuf));
1485 #else
1486     croak("semop not implemented");
1487 #endif
1488 }
1489
1490 I32
1491 do_shmio(optype, mark, sp)
1492 I32 optype;
1493 SV **mark;
1494 SV **sp;
1495 {
1496 #ifdef HAS_SHM
1497     SV *mstr;
1498     char *mbuf, *shm;
1499     I32 id, mpos, msize;
1500     STRLEN len;
1501     struct shmid_ds shmds;
1502
1503     id = SvIVx(*++mark);
1504     mstr = *++mark;
1505     mpos = SvIVx(*++mark);
1506     msize = SvIVx(*++mark);
1507     SETERRNO(0,0);
1508     if (shmctl(id, IPC_STAT, &shmds) == -1)
1509         return -1;
1510     if (mpos < 0 || msize < 0 || mpos + msize > shmds.shm_segsz) {
1511         SETERRNO(EFAULT,SS$_ACCVIO);            /* can't do as caller requested */
1512         return -1;
1513     }
1514     shm = (Shmat_t)shmat(id, (char*)NULL, (optype == OP_SHMREAD) ? SHM_RDONLY : 0);
1515     if (shm == (char *)-1)      /* I hate System V IPC, I really do */
1516         return -1;
1517     if (optype == OP_SHMREAD) {
1518         SvPV_force(mstr, len);
1519         mbuf = SvGROW(mstr, msize+1);
1520
1521         Copy(shm + mpos, mbuf, msize, char);
1522         SvCUR_set(mstr, msize);
1523         *SvEND(mstr) = '\0';
1524         SvSETMAGIC(mstr);
1525     }
1526     else {
1527         I32 n;
1528
1529         mbuf = SvPV(mstr, len);
1530         if ((n = len) > msize)
1531             n = msize;
1532         Copy(mbuf, shm + mpos, n, char);
1533         if (n < msize)
1534             memzero(shm + mpos + n, msize - n);
1535     }
1536     return shmdt(shm);
1537 #else
1538     croak("shm I/O not implemented");
1539 #endif
1540 }
1541
1542 #endif /* SYSV IPC */