ActiveState Home Page       Win32 FAQ


NAME

perlwin32faq5 - Implementation Quirks



DESCRIPTION

Issues specific to the Win32 port of Perl.



Certain functions don't seem to work on Perl for Win32.

There are several functions that are unimplemented in the Perl for Win32 system. Primary among these are alarm() and fork(), which are used in a few Perl modules. Because they're missing in Perl for Win32, you can't use those modules. Here is a complete list of unimplemented functions:

Functions for processes and process groups

alarm(), fork(), getpgrp(), getppid(), getpriority(), setpgrp(), setpriority()

Fetching user and group info

endgrent(), endpwent(), getgrent(), getgrgid(), getgrnam(), getpwent(), getpwnam(), getpwuid(), setgrent(), setpwent()

System V interprocess communication functions

msgctl(), msgget(), msgrcv(), msgsnd(), semctl(), semget(), semop(), shmctl(), shmget(), shmread(), shmwrite()

Functions for filehandles, files, or directories

link(), symlink(), chroot()

Input and output functions

syscall()

Fetching network info

getnetbyname(), getnetbyaddr(), getnetent(), getprotoent(), getservent(), sethostent(), setnetent(), setprotoent(), setservent(), endhostent(), endnetent(), endprotoent(), endservent(), socketpair()

See the perlport and perlwin32 documentation pages for more information on the portability of builtin functions in Perl for Win32.



The exec function doesn't seem to work under Perl for ISAPI, Perl for WebSite, or PerlScript. Why not?

Perl for ISAPI, Perl for WebSite, and PerlScript share a process space with the web server and any number of other extensions. As a result, the exec() function is unimplemented, because it would cause the web server to terminate (the exec() function executes a system command and never returns).



What's the difference between Perl for Win32 and the old 3xx builds?

At one time, Perl on the Win32 platform was found in two versions, Gurusamy Sarathy's port, and the ActiveState port. The ActiveState port of Perl included such tools as Perl for ISAPI and PerlScript, at the expense of exposing Perl's internals in a slightly different fashion than standard Perl. Sarathy's port featured a high degree of compatibility with standard Perl, which enabled users of Sarathy's port to use many modules that were not compatible with ActiveState Perl.

The oneperl effort brought both ports of Perl together, and Perl for Win32 is the standard perl distribution for the Win32 system. All modules that can be used on Win32 can be used with this port. You no longer have to worry about whose perl the module is for. Just grab it, compile it (if needed), and use it.



What's the difference between running Perl for Win32 on Windows NT versus running it on Windows 95?

There should be little difference between running Perl on the two operating systems. You should watch for the following, though:

If you're worried about using a feature from one or the other, check the result of the function Win32::IsWinNT() to see what OS you're running on. See What modules come with the Perl for Win32 distribution?.



Why don't the examples from the Camel book work?

The Camel book (aka Programming Perl, Wall et.al., O'Reilly & Associates 1996) was written by UNIX people for, in general, UNIX people.

Some of the examples in the Camel book will work. Some will not. If they fail, it's because either the functions used are not available, the external tools used are not available, or the modules used are not available. Usually, for small scripts, it's not to hard to fiddle with them until they come out correct (see How do I make a UNIX-based script work?).

The Camel and Llama books are good learning tools. However, one of the things you learn as a Perl for Win32 programmer is how to port UNIX-targeted scripts and modules to Perl for Win32.

For better examples of using Perl for Win32, you may want to look at the Gecko book, ``Learning Perl on Win32 Systems,'' published by O'Reilly.



Why don't certain standard library modules work?

With Perl for Win32, almost all modules will work with Perl for Win32 as long as they can be built to run on Win32. The problems that existed with the 3xx versions of Perl for Win32 no longer exist: modules work on Win32, not just this port or that port of Perl for the Win32 platform!

If a module doesn't work, it may be because the functions it uses are specific to UNIX and won't work on Win32, or specific to NT and won't work on Windows 95 or Windows 98.



How do I make a UNIX-based script work?

First, make extra-super sure that you are using the script or module in the way it was intended. Many of us are quick to blame the module, the operating system, or the interpreter when, in reality, it is our own code that isn't working right.

If you're sure that it's not a problem in your code, the best way to make a UNIX-based script work is to desk-check it before running it. Look for some of the following things:

Of course, it should go without saying that for everything you take out you'll have to put in a work-around.

Once you've worked around UNIX dependencies in the script or module, try running it through the debugger to see if what you did helps. If the script or module comes with a .t test file, try using that to test your changed version.

If you do make a change to a UNIX-based script or module, please let the author know. Sometimes the author will be gracious enough to make changes that will let the program run on Perl for Win32. If the author won't change the program, ask if you can make the altered version available to other users.



How does the chmod function work on Win32 platforms?

chmod() is supported in Perl for Win32. However, it can only be used for setting "owner" read/write access. (The "group" and "other" bits are ignored.)

UNIX-style security for files is not applicable to files on Win32 systems. Win32 systems inherit from DOS four possible file attributes: archived (A), read-only (R), hidden (H), and system (S). These can be checked and set with the Win32::File::Get/SetAttributes().

Windows NT systems using NTFS can also have more specific permissions granted on individual files to users and groups. For builds 300 and above, and the Perl Resource Kit for Win32, you can use the Win32::FileSecurity module to maintain file permissions.



4DOS doesn't recognize \" on the command line.

4DOS doesn't recognize the escaped quote on the command line, because all double-quote characters are seen as delimiters for command line parameters. This is one of the few points (if not the only one) where 4DOS doesn't quite match up to COMMAND.COM.

To get around this, you can enter


    perl -e "print \"Hello, World\n\""

as


    perl -e "print qq(Hello, World\n)"

using Perl's alternative quoting mechanism. The alternative quotes are qq() for double quotes, q() for single quotes, qx() for backquotes, and qw() for list quotes. The parentheses can be substituted for just about anything (like + or | or {} or <> or #), but that looks weird.



STDIN and STDOUT, and Piping don't always work on NT.

You may get unexpected results when you try to redirect the output of files that use Windows NT's file association feature. You can use pl2exe or pl2bat to convert a Perl script to an executable or a batch file. This should solve any problems you may have with redirection.



Why doesn't signal handling work on Windows?

Signals are unsupported by the Win32 API. The C Runtime provides crude support for signals, but there are serious caveats, such as inability to die() or exit() from a signal handler. Perl itself does not guarantee that signal handlers will not interrupt critical operations such as memory allocation, which means signal invocation may throw perl internals into disarray. For these reasons, signals are unsupported at this time.



AUTHOR AND COPYRIGHT

This FAQ was originally assembled and maintained by Evangelo Prodromou. evangelo@endcontsw.com. It has been revised and updated by Brian Jepson of O'Reilly and Associates, and David Grove and David Dmytryshyn of ActiveState.

This FAQ is in the public domain. If you use it, however, please ensure that you give credit to the original authors.

ActiveState Home Page       Win32 FAQ