Errno(3perl)

Errno3perl

System errno constants

Usage

    use Errno qw(EINTR EIO :POSIX);

Overview

"Errno" defines and conditionally exports all the error constants defined in your system errno.h include file. It has a single export tag, ":POSIX", which will export all POSIX defined error numbers.

On Windows, "Errno" also defines and conditionally exports all the Winsock error constants defined in your system WinError.h include file. These are included in a second export tag, ":WINSOCK".

"Errno" also makes "%!" magic such that each element of "%!" has a non-zero value only if $! is set to that value. For example:

    my $fh;
    unless (open($fh, "<", "/fangorn/spouse")) {
        if ($!{ENOENT}) {
            warn "Get a wife!\n";
        } else {
            warn "This path is barred: $!";
        } 
    }

If a specified constant "EFOO" does not exist on the system, $!{EFOO} returns "". You may use "exists $!{EFOO}" to check whether the constant is available on the system.

Perl automatically loads "Errno" the first time you use "%!", so you don't need an explicit "use".

Caveats

Importing a particular constant may not be very portable, because the import will fail on platforms that do not have that constant. A more portable way to set $! to a valid value is to use:

    if (exists &Errno::EFOO) {
        $! = &Errno::EFOO;
    }

Releases

13 releases since Debian 3.0 (Woody); the text changed 12 times.

  1. 3.0
  2. 3.1
  3. 4.0
  4. 5.0
  5. 6.0
  6. 7
  7. 8
  8. 9
  9. 10
  10. 11
  11. 12
  12. 13
  13. Arch

Author

Graham Barr <[email protected]>

From perl 5.44.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.