From: Scott Rifenbark <scott.m.rifenbark@...>

Part of the fix for Bug 628 is to add a note that bitbake requires
python 2.6. I added this note before the example bitbake command
that builds an image. I also added a linked reference to the Poky
Reference Manual and mentioned the FAQ appendix. There will be more
information about the python requirement in the FAQ.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@...>
---
.../yocto-project-qs/yocto-project-qs.xml | 6 ++++++
1 files changed, 6 insertions(+), 0 deletions(-)

diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index 56dafe5..452282f 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -278,6 +278,12 @@
$ bitbake poky-image-sato
</literallayout>
</para></note>
+ <note><para>
+ BitBake requires Python 2.6. For more information on this requirement,
+ see the FAQ appendix in the
+ <ulink url='http://www.yoctoproject.org/docs/poky-ref-manual/poky-ref-manual.html'>
+ Poky Reference Manual</ulink>.
+ </para></note>
The final command runs the image:
<literallayout class='monospaced'>
$ poky-qemu qemux86
--
1.6.6.1

From: Scott Rifenbark <scott.m.rifenbark@...>

As part of the fix for #628 I added a new question to the FAQ for use
of Poky when you do not have Python 2.6.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@...>
---
documentation/poky-ref-manual/faq.xml | 41 +++++++++++++++++++++++++++++++++
1 files changed, 41 insertions(+), 0 deletions(-)

diff --git a/documentation/poky-ref-manual/faq.xml b/documentation/poky-ref-manual/faq.xml
index b209fff..7a891b0 100644
--- a/documentation/poky-ref-manual/faq.xml
+++ b/documentation/poky-ref-manual/faq.xml
@@ -20,6 +20,47 @@
</para>
</answer>
</qandaentry>
+
+
+
+
+
+ <qandaentry>
+ <question>
+ <para>
+ I only have Python 2.4 or 2.5 but BitBake requires Python 2.6.
+ Can I still use Poky?
+ </para>
+ </question>
+ <answer>
+ <para>
+ You can use a stand-alone tarball to provide Python 2.6.
+ You can find pre-built 32 and 64-bit versions of Python 2.6 at the following locations:
+ <itemizedlist>
+ <listitem><para><ulink url='http://autobuilder.yoctoproject.org/downloads/miscsupport/python-nativesdk-standalone-i586.tar.bz2'></ulink></para></listitem>
+ <listitem><para><ulink url='http://autobuilder.yoctoproject.org/downloads/miscsupport/python-nativesdk-standalone-x86_64.tar.bz2'></ulink></para></listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ These tarballs are self-contained with all required libraries and should work
+ on most Linux systems.
+ To use the tarballs extract them into the root
+ directory and run the appropriate command:
+ <literallayout class='monospaced'>
+ $ export PATH=/opt/poky/sysroots/i586-pokysdk-linux/usr/bin/:$PATH
+ $ export PATH=/opt/poky/sysroots/x86_64-pokysdk-linux/usr/bin/:$PATH
+ </literallayout>
+ </para>
+ <para>
+ Once you run the command, BitBake uses Python 2.6.
+ </para>
+ </answer>
+ </qandaentry>
+
+
+
+
+
<qandaentry>
<question>
<para>
--
1.6.6.1

From: Yu Ke <ke.yu@...>

- add global config option ROOTLESS_X to control if enable
rootless X for the machine. ROOTLESS_X requires graphics
driver supporting KMS (kernel mode setting), so far, only
atom_pc support this. so enable ROOTLESS_X for atom_pc machine

- add config options for xf86-video-intel to support rootless X

Signed-off-by: Yu Ke <ke.yu@...>
---
meta/conf/machine/atom-pc.conf | 2 ++
.../xorg-driver/xf86-video-intel_2.14.0.bb | 5 +++++
2 files changed, 7 insertions(+), 0 deletions(-)

diff --git a/meta/conf/machine/atom-pc.conf b/meta/conf/machine/atom-pc.conf
index 58c9b0d..b94deb2 100644
--- a/meta/conf/machine/atom-pc.conf
+++ b/meta/conf/machine/atom-pc.conf
@@ -42,3 +42,5 @@ GLIBC_ADDONS = "nptl"
GLIBC_EXTRA_OECONF = "--with-tls"

EXTRA_OECONF_append_pn-matchbox-panel-2 = " --with-battery=acpi"
+
+ROOTLESS_X = "1"
diff --git a/meta/recipes-graphics/xorg-driver/xf86-video-intel_2.14.0.bb b/meta/recipes-graphics/xorg-driver/xf86-video-intel_2.14.0.bb
index 017a2e0..099cf9d 100644
--- a/meta/recipes-graphics/xorg-driver/xf86-video-intel_2.14.0.bb
+++ b/meta/recipes-graphics/xorg-driver/xf86-video-intel_2.14.0.bb
@@ -9,8 +9,13 @@ Infrastructure (DRI)."

LIC_FILES_CHKSUM = "file://COPYING;md5=8730ad58d11c7bbad9a7066d69f7808e"

+PR = "r1"
+
EXTRA_OECONF += "--disable-xvmc"

+# --enable-kms-only option is required by ROOTLESS_X
+EXTRA_OECONF += '${@base_conditional( "ROOTLESS_X", "1", " --enable-kms-only", "", d )}'
+
DEPENDS += "virtual/libx11 libxvmc drm xf86driproto glproto \
virtual/libgl xineramaproto xf86driproto libpciaccess"

--
1.6.6.1

From: Yu Ke <ke.yu@...>

most rootless X work are already done in the kernel, xserver and
graphics driver, this patches add the the remaining userspace setting:

- create /etc/X11/Xusername to set rootless X user
- add rootless X user to group video, tty to access /dev/tty[0-4]
and /dev/dri/card0
- grant rootless X user access right to /dev/input/*, /var/log

Signed-off-by: Yu Ke <ke.yu@...>
---
.../x11-common/xserver-nodm-init.bb | 22 +++++++++++++++++++-
.../x11-common/xserver-nodm-init/Xusername | 1 +
.../x11-common/xserver-nodm-init/xserver-nodm | 4 +++
3 files changed, 26 insertions(+), 1 deletions(-)
create mode 100644 meta/recipes-graphics/x11-common/xserver-nodm-init/Xusername

diff --git a/meta/recipes-graphics/x11-common/xserver-nodm-init.bb b/meta/recipes-graphics/x11-common/xserver-nodm-init.bb
index 03a6ca3..a93acc9 100644
--- a/meta/recipes-graphics/x11-common/xserver-nodm-init.bb
+++ b/meta/recipes-graphics/x11-common/xserver-nodm-init.bb
@@ -3,10 +3,11 @@ LICENSE = "GPLv2"
LIC_FILES_CHKSUM = "file://COPYING;md5=751419260aa954499f7abaabaa882bbe"
SECTION = "x11"
PRIORITY = "optional"
-PR = "r23"
+PR = "r24"
RDEPENDS_${PN} = "dbus-wait sudo"

SRC_URI = "file://xserver-nodm \
+ file://Xusername \
file://gplv2-license.patch"

S = ${WORKDIR}
@@ -17,6 +18,25 @@ do_install() {
install -d ${D}/etc
install -d ${D}/etc/init.d
install xserver-nodm ${D}/etc/init.d
+ if [ "${ROOTLESS_X}" = "1" ] ; then
+ install -d ${D}/etc/X11
+ install Xusername ${D}/etc/X11
+ fi
+}
+
+pkg_postinst_${PN} () {
+ if [ "x$D" != "x" ] ; then
+ exit 1
+ fi
+
+ if [ -f /etc/X11/Xusername ]; then
+ # create the rootless X user, and add user to group tty, video
+ username=`cat /etc/X11/Xusername`
+ adduser --disabled-password $username
+ # FIXME: use addgroup if busybox addgroup is ready
+ sed -i -e "s/^video:.*/&${username}/g" /etc/group
+ sed -i -e "s/^tty:.*/&${username}/g" /etc/group
+ fi
}

inherit update-rc.d
diff --git a/meta/recipes-graphics/x11-common/xserver-nodm-init/Xusername b/meta/recipes-graphics/x11-common/xserver-nodm-init/Xusername
new file mode 100644
index 0000000..7060e5e
--- /dev/null
+++ b/meta/recipes-graphics/x11-common/xserver-nodm-init/Xusername
@@ -0,0 +1 @@
+xuser
diff --git a/meta/recipes-graphics/x11-common/xserver-nodm-init/xserver-nodm b/meta/recipes-graphics/x11-common/xserver-nodm-init/xserver-nodm
index 69ea949..d8c4ba0 100755
--- a/meta/recipes-graphics/x11-common/xserver-nodm-init/xserver-nodm
+++ b/meta/recipes-graphics/x11-common/xserver-nodm-init/xserver-nodm
@@ -30,6 +30,10 @@ case "$1" in
echo "Starting Xserver"
if [ -f /etc/X11/Xusername ]; then
username=`cat /etc/X11/Xusername`
+ # setting for rootless X
+ chmod o+w /var/log
+ chmod g+r /dev/tty[0-3]
+ chmod o+rw /dev/input/*
fi
# Using sudo -i here has the nice side effect of making sire
# HOME, USER and other previously problematic variables
--
1.6.6.1

From: Saul Wold <sgw@...>

Signed-off-by: Saul Wold <sgw@...>
---
meta/conf/bitbake.conf | 3 ++-
1 files changed, 2 insertions(+), 1 deletions(-)

diff --git a/meta/conf/bitbake.conf b/meta/conf/bitbake.conf
index 162c792..cba918e 100644
--- a/meta/conf/bitbake.conf
+++ b/meta/conf/bitbake.conf
@@ -649,7 +649,8 @@ AUTO_LIBNAME_PKGS = "${PACKAGES}"
#
# This works for functions as well, they are really just environment variables.
# Default OVERRIDES to make compilation fail fast in case of build system misconfiguration.
-OVERRIDES = "local:${MACHINE}:${DISTRO}:${TARGET_OS}:${TARGET_ARCH}:build-${BUILD_OS}:fail-fast:pn-${PN}:forcevariable"
+OVERRIDES = "local:${MACHINE}:${DISTROOVERRIDES}:${TARGET_OS}:${TARGET_ARCH}:build-${BUILD_OS}:fail-fast:pn-${PN}:forcevariable"
+DISTROOVERRIDES ?= "${DISTRO}"

CPU_FEATURES ?= ""
CPU_FEATURES_arm ?= "vfp"
--
1.6.6.1

From: Saul Wold <sgw@...>

Signed-off-by: Saul Wold <sgw@...>
---
meta/conf/distro/poky-lsb.conf | 4 ++++
1 files changed, 4 insertions(+), 0 deletions(-)

diff --git a/meta/conf/distro/poky-lsb.conf b/meta/conf/distro/poky-lsb.conf
index 86514d3..9a34a15 100644
--- a/meta/conf/distro/poky-lsb.conf
+++ b/meta/conf/distro/poky-lsb.conf
@@ -1,6 +1,10 @@
require conf/distro/poky.conf

DISTRO = "poky-lsb"
+DISTROOVERIDES = "poky:poky-lsb"

DISTRO_FEATURES += "pam"
PREFERRED_PROVIDER_virtual/libx11 = "libx11"
+
+OVERRIDES = "local:${MACHINE}:poky:${DISTRO}:${TARGET_OS}:${TARGET_ARCH}:build-${BUILD_OS}:fail-fast:pn-${PN}:forcevariable"
+
--
1.6.6.1

From: Richard Purdie <richard.purdie@...>

We should only weakly set PREMIRRORS as users often want to override this.

[BUGID #753]

Signed-off-by: Richard Purdie <richard.purdie@...>
---
meta/conf/distro/poky.conf | 2 +-
1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/meta/conf/distro/poky.conf b/meta/conf/distro/poky.conf
index 400b8c2..71e40de 100644
--- a/meta/conf/distro/poky.conf
+++ b/meta/conf/distro/poky.conf
@@ -150,7 +150,7 @@ BB_GENERATE_MIRROR_TARBALLS ??= "0"

require conf/distro/include/world-broken.inc

-PREMIRRORS =+ "\
+PREMIRRORS ?= "\
bzr://.*/.* http://autobuilder.yoctoproject.org/sources/ \n \
cvs://.*/.* http://autobuilder.yoctoproject.org/sources/ \n \
git://.*/.* http://autobuilder.yoctoproject.org/sources/ \n \
--
1.6.6.1

From: Richard Purdie <richard.purdie@...>

[BUGID #752]

Signed-off-by: Richard Purdie <richard.purdie@...>
---
meta/recipes-devtools/mtd/mtd-utils_1.4.1.bb | 2 +-
1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/meta/recipes-devtools/mtd/mtd-utils_1.4.1.bb b/meta/recipes-devtools/mtd/mtd-utils_1.4.1.bb
index 5e6db0e..f2de74d 100644
--- a/meta/recipes-devtools/mtd/mtd-utils_1.4.1.bb
+++ b/meta/recipes-devtools/mtd/mtd-utils_1.4.1.bb
@@ -6,7 +6,7 @@ LICENSE = "GPLv2+"
LIC_FILES_CHKSUM = "file://COPYING;md5=0636e73ff0215e8d672dc4c32c317bb3 \
file://include/common.h;beginline=1;endline=17;md5=ba05b07912a44ea2bf81ce409380049c"

-SRC_URI = "git://git.infradead.org/mtd-utils.git;protocol=git;tag=v${PV} \
+SRC_URI = "git://git.infradead.org/mtd-utils.git;protocol=git;tag=3c3674a6e1d3f59554b0ff68ca59be2fd4134e0c \
file://add-exclusion-to-mkfs-jffs2-git-2.patch;patch=1"

S = "${WORKDIR}/git/"
--
1.6.6.1

From: Saul Wold <sgw@...>

Signed-off-by: Saul Wold <sgw@...>
---
meta/conf/distro/poky-lsb.conf | 3 +--
1 files changed, 1 insertions(+), 2 deletions(-)

diff --git a/meta/conf/distro/poky-lsb.conf b/meta/conf/distro/poky-lsb.conf
index 9a34a15..749c858 100644
--- a/meta/conf/distro/poky-lsb.conf
+++ b/meta/conf/distro/poky-lsb.conf
@@ -1,10 +1,9 @@
require conf/distro/poky.conf

DISTRO = "poky-lsb"
-DISTROOVERIDES = "poky:poky-lsb"
+DISTROOVERRIDES = "poky:poky-lsb"

DISTRO_FEATURES += "pam"
PREFERRED_PROVIDER_virtual/libx11 = "libx11"

-OVERRIDES = "local:${MACHINE}:poky:${DISTRO}:${TARGET_OS}:${TARGET_ARCH}:build-${BUILD_OS}:fail-fast:pn-${PN}:forcevariable"

--
1.6.6.1

From: Joshua Lock <josh@...>

We rely on Bashisms when spawning a terminal so ensure that bash is used
when using devshell and menuconfig.

Fixes [BUGID #119]

Signed-off-by: Joshua Lock <josh@...>
---
meta/classes/devshell.bbclass | 4 ++--
meta/classes/kernel.bbclass | 2 +-
2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/meta/classes/devshell.bbclass b/meta/classes/devshell.bbclass
index 4fb3e63..5f262f4 100644
--- a/meta/classes/devshell.bbclass
+++ b/meta/classes/devshell.bbclass
@@ -9,7 +9,8 @@ devshell_do_devshell() {
export XAUTHORITY='${XAUTHORITY}'
export TERMWINDOWTITLE="Bitbake Developer Shell"
export EXTRA_OEMAKE='${EXTRA_OEMAKE}'
- ${TERMCMD}
+ export SHELLCMDS="bash"
+ ${TERMCMDRUN}
if [ $? -ne 0 ]; then
echo "Fatal: '${TERMCMD}' not found. Check TERMCMD variable."
exit 1
@@ -17,6 +18,5 @@ devshell_do_devshell() {
}
addtask devshell after do_patch

-
EXPORT_FUNCTIONS do_devshell

diff --git a/meta/classes/kernel.bbclass b/meta/classes/kernel.bbclass
index a1b1354..5d9b86a 100644
--- a/meta/classes/kernel.bbclass
+++ b/meta/classes/kernel.bbclass
@@ -202,7 +202,7 @@ do_menuconfig() {
export DBUS_SESSION_BUS_ADDRESS='${DBUS_SESSION_BUS_ADDRESS}'
export XAUTHORITY='${XAUTHORITY}'
export TERMWINDOWTITLE="${PN} Kernel Configuration"
- export SHELLCMDS="make menuconfig"
+ export SHELLCMDS="bash make menuconfig"
${TERMCMDRUN}
if [ $? -ne 0 ]; then
echo "Fatal: '${TERMCMD}' not found. Check TERMCMD variable."
--
1.6.6.1

From: Richard Purdie <richard.purdie@...>

Signed-off-by: Richard Purdie <richard.purdie@...>
---
scripts/poky-setup-builddir | 8 ++++----
1 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/scripts/poky-setup-builddir b/scripts/poky-setup-builddir
index 7a1452f..7a49a8f 100755
--- a/scripts/poky-setup-builddir
+++ b/scripts/poky-setup-builddir
@@ -66,8 +66,8 @@ you with some default values. You may wish to edit it to use a different MACHINE
cores for example. See the file for more information as common configuration
options are commented.

-Also, for more information see the Poky handbook:
-http://pokylinux.org/doc/poky-handbook.html
+Also, for more information see the Poky Reference Manual:
+ http://yoctoproject.org/community/documentation

EOM
cp -f $POKYLOCALCONF $BUILDDIR/conf/local.conf
@@ -82,8 +82,8 @@ You had no conf/bblayers.conf file. Poky has created this configuration file for
you with some default values. To add additional metadata layers into your
configuration please add entries to this file.

-For more information see the Poky handbook:
- http://pokylinux.org/doc/poky-handbook.html
+For more information see the Poky Reference Manual:
+ http://yoctoproject.org/community/documentation

EOM

--
1.6.6.1

From: Saul Wold <sgw@...>

Signed-off-by: Saul Wold <sgw@...>
---
scripts/poky-qemu | 10 +++++-----
1 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/scripts/poky-qemu b/scripts/poky-qemu
index cb08f27..1086c3d 100755
--- a/scripts/poky-qemu
+++ b/scripts/poky-qemu
@@ -228,23 +228,23 @@ machine2=`echo $MACHINE | tr 'a-z' 'A-Z' | sed 's/-/_/'`
# Defaults used when these vars need to be inferred
QEMUX86_DEFAULT_KERNEL=bzImage-qemux86.bin
QEMUX86_DEFAULT_FSTYPE=ext3
-QEMUX86_DEFAULT_ROOTFS="poky-image-sdk poky-image-sato poky-image-lsb poky-image-basic poky-image-minimal"
+QEMUX86_DEFAULT_ROOTFS="poky-image-sato-sdk poky-image-sato poky-image-lsb poky-image-basic poky-image-minimal"

QEMUX86_64_DEFAULT_KERNEL=bzImage-qemux86-64.bin
QEMUX86_64_DEFAULT_FSTYPE=ext3
-QEMUX86_64_DEFAULT_ROOTFS="poky-image-sdk poky-image-sato poky-image-lsb poky-image-basic poky-image-minimal"
+QEMUX86_64_DEFAULT_ROOTFS="poky-image-sato-sdk poky-image-sato poky-image-lsb poky-image-basic poky-image-minimal"

QEMUARM_DEFAULT_KERNEL=zImage-qemuarm.bin
QEMUARM_DEFAULT_FSTYPE=ext3
-QEMUARM_DEFAULT_ROOTFS="poky-image-sdk poky-image-sato poky-image-lsb poky-image-basic poky-image-minimal"
+QEMUARM_DEFAULT_ROOTFS="poky-image-sato-sdk poky-image-sato poky-image-lsb poky-image-basic poky-image-minimal"

QEMUMIPS_DEFAULT_KERNEL=vmlinux-qemumips.bin
QEMUMIPS_DEFAULT_FSTYPE=ext3
-QEMUMIPS_DEFAULT_ROOTFS="poky-image-sdk poky-image-sato poky-image-lsb poky-image-basic poky-image-minimal"
+QEMUMIPS_DEFAULT_ROOTFS="poky-image-sato-sdk poky-image-sato poky-image-lsb poky-image-basic poky-image-minimal"

QEMUPPC_DEFAULT_KERNEL=zImage-qemuppc.bin
QEMUPPC_DEFAULT_FSTYPE=ext3
-QEMUPPC_DEFAULT_ROOTFS="poky-image-sdk poky-image-sato poky-image-lsb poky-image-basic poky-image-minimal"
+QEMUPPC_DEFAULT_ROOTFS="poky-image-sato-sdk poky-image-sato poky-image-lsb poky-image-basic poky-image-minimal"

AKITA_DEFAULT_KERNEL=zImage-akita.bin
AKITA_DEFAULT_FSTYPE=jffs2
--
1.6.6.1

From: Nitin A Kamble <nitin.a.kamble@...>

The parallel build issue is fixed in the upstream perl git tree
differently. Replacing our fix with the upstream fix.

Signed-off-by: Nitin A Kamble <nitin.a.kamble@...>
---
.../perl/perl-5.12.2/parallel_build_fix.patch | 18 -
.../perl/perl-5.12.2/parallel_build_fix_1.patch | 25 +
.../perl/perl-5.12.2/parallel_build_fix_2.patch | 22 +
.../perl/perl-5.12.2/parallel_build_fix_3.patch | 6583 ++++++++++++++++++++
meta/recipes-devtools/perl/perl-native_5.12.2.bb | 6 +-
meta/recipes-devtools/perl/perl_5.12.2.bb | 6 +-
6 files changed, 6638 insertions(+), 22 deletions(-)
delete mode 100644 meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix.patch
create mode 100644 meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_1.patch
create mode 100644 meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_2.patch
create mode 100644 meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_3.patch

diff --git a/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix.patch b/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix.patch
deleted file mode 100644
index 476577e..0000000
--- a/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix.patch
+++ /dev/null
@@ -1,18 +0,0 @@
-This patch fixes the parallel make issue on a 40 way build system
-
-Nitin A Kamble <nitin.a.kamble@...>
-2011-02-16
-
-Index: perl-5.12.2/Makefile.SH
-===================================================================
---- perl-5.12.2.orig/Makefile.SH 2010-09-06 16:30:32.000000000 -0700
-+++ perl-5.12.2/Makefile.SH 2011-02-16 16:21:30.744143773 -0800
-@@ -198,6 +198,8 @@
- $this_target: uni.data" ;;
- Text/ParseWords) extra_dep="$extra_dep
- $this_target: lib/auto/Scalar/Util.$dlext" ;;
-+ POSIX) extra_dep="$extra_dep
-+$this_target: lib/auto/Cwd/Cwd.$dlext" ;;
- esac
- done
-
diff --git a/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_1.patch b/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_1.patch
new file mode 100644
index 0000000..63e6410
--- /dev/null
+++ b/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_1.patch
@@ -0,0 +1,25 @@
+Imported from perl git tree by Nitin A Kamble <nitin.a.kamble@...>
+2011-02-23
+
+commit 6695a346c41138df5b2c0e26b9a49b1f96137da0
+Author: Tony Cook <tony@...>
+Date: Thu Jul 22 09:54:13 2010 +1000
+
+ make_ext.pl populates @INC correctly, don't override it badly
+
+ PERL5LIB is populated by make_ext.pl with paths to the modules we need
+ to run, don't override this with "../../lib" since that may not have
+ been populated yet in a parallel build.
+
+diff --git a/ext/POSIX/Makefile.PL b/ext/POSIX/Makefile.PL
+index 392b6fb..9e6d091 100644
+--- a/ext/POSIX/Makefile.PL
++++ b/ext/POSIX/Makefile.PL
+@@ -1,7 +1,3 @@
+-# Explicitly avoid including '.' in @INC; autoloader gets confused since it
+-# can find POSIX.pm, but can't find autosplit.ix.
+-BEGIN { @INC = '../../lib';}
+-#
+ use ExtUtils::MakeMaker;
+ use ExtUtils::Constant 0.11 'WriteConstants';
+ use Config;
diff --git a/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_2.patch b/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_2.patch
new file mode 100644
index 0000000..6c536dd
--- /dev/null
+++ b/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_2.patch
@@ -0,0 +1,22 @@
+Imported from perl git tree by Nitin A Kamble <nitin.a.kamble@...>
+2011-02-23
+
+commit 24e93d7838b346d2ed632075f3d824a325170616
+Author: Tony Cook <tony@...>
+Date: Sat Aug 14 00:21:29 2010 +1000
+
+ POSIX/t/posix.t expects a certain start to Makefile.PL
+
+ 6695a346 changed the start of Makefile.PL, but t/posix.t reads that to
+ test its read() implementation, restore enough of the original for the
+ test to pass.
+
+diff --git a/ext/POSIX/Makefile.PL b/ext/POSIX/Makefile.PL
+index 9e6d091..292882c 100644
+--- a/ext/POSIX/Makefile.PL
++++ b/ext/POSIX/Makefile.PL
+@@ -1,3 +1,4 @@
++# Expect this line to be read by t/posix.t, don't change it
+ use ExtUtils::MakeMaker;
+ use ExtUtils::Constant 0.11 'WriteConstants';
+ use Config;
diff --git a/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_3.patch b/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_3.patch
new file mode 100644
index 0000000..a74a45d
--- /dev/null
+++ b/meta/recipes-devtools/perl/perl-5.12.2/parallel_build_fix_3.patch
@@ -0,0 +1,6583 @@
+Imported from perl git tree by Nitin A Kamble <nitin.a.kamble@...>
+2011-02-23
+
+commit 4feb80ac47a22e7de7d7c1c1d5dfb3d744a2a3a7
+Author: Jerry D. Hedden <jdhedden@...>
+Date: Tue Aug 17 13:17:11 2010 -0400
+
+ Move POSIX.pm to lib/POSIX.pm to fix autosplitter problem
+
+diff --git a/MANIFEST b/MANIFEST
+index 3036d73..faf8974 100644
+--- a/MANIFEST
++++ b/MANIFEST
+@@ -3183,9 +3183,9 @@ ext/POSIX/hints/openbsd.pl Hint for POSIX for named architecture
+ ext/POSIX/hints/sunos_4.pl Hint for POSIX for named architecture
+ ext/POSIX/hints/svr4.pl Hint for POSIX for named architecture
+ ext/POSIX/hints/uts.pl Hint for POSIX for named architecture
++ext/POSIX/lib/POSIX.pm POSIX extension Perl module
++ext/POSIX/lib/POSIX.pod POSIX extension documentation
+ ext/POSIX/Makefile.PL POSIX extension makefile writer
+-ext/POSIX/POSIX.pm POSIX extension Perl module
+-ext/POSIX/POSIX.pod POSIX extension documentation
+ ext/POSIX/POSIX.xs POSIX extension external subroutines
+ ext/POSIX/t/is.t See if POSIX isxxx() work
+ ext/POSIX/t/math.t Basic math tests for POSIX
+diff --git a/ext/POSIX/Makefile.PL b/ext/POSIX/Makefile.PL
+index 292882c..07c3841 100644
+--- a/ext/POSIX/Makefile.PL
++++ b/ext/POSIX/Makefile.PL
+@@ -18,7 +18,8 @@ WriteMakefile(
+ NAME => 'POSIX',
+ @libs,
+ XSPROTOARG => '-noprototypes', # XXX remove later?
+- VERSION_FROM => 'POSIX.pm',
++ VERSION_FROM => 'lib/POSIX.pm',
++ ABSTRACT_FROM => 'lib/POSIX.pod',
+ realclean => {FILES=> 'const-c.inc const-xs.inc'},
+ );
+
+diff --git a/ext/POSIX/POSIX.pm b/ext/POSIX/POSIX.pm
+deleted file mode 100644
+index ffbd9de..0000000
+--- a/ext/POSIX/POSIX.pm
++++ /dev/null
+@@ -1,1042 +0,0 @@
+-package POSIX;
+-use strict;
+-use warnings;
+-
+-our(@ISA, %EXPORT_TAGS, @EXPORT_OK, @EXPORT, $AUTOLOAD, %SIGRT) = ();
+-
+-our $VERSION = "1.19";
+-
+-use AutoLoader;
+-
+-use XSLoader ();
+-
+-use Fcntl qw(FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_RDLCK F_SETFD
+- F_SETFL F_SETLK F_SETLKW F_UNLCK F_WRLCK O_ACCMODE O_APPEND
+- O_CREAT O_EXCL O_NOCTTY O_NONBLOCK O_RDONLY O_RDWR O_TRUNC
+- O_WRONLY SEEK_CUR SEEK_END SEEK_SET
+- S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISREG
+- S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU S_ISGID S_ISUID
+- S_IWGRP S_IWOTH S_IWUSR S_IXGRP S_IXOTH S_IXUSR);
+-
+-# Grandfather old foo_h form to new :foo_h form
+-my $loaded;
+-
+-sub import {
+- load_imports() unless $loaded++;
+- my $this = shift;
+- my @list = map { m/^\w+_h$/ ? ":$_" : $_ } @_;
+- local $Exporter::ExportLevel = 1;
+- Exporter::import($this,@list);
+-}
+-
+-sub croak { require Carp; goto &Carp::croak }
+-# declare usage to assist AutoLoad
+-sub usage;
+-
+-XSLoader::load 'POSIX', $VERSION;
+-
+-sub AUTOLOAD {
+- no strict;
+- no warnings 'uninitialized';
+- if ($AUTOLOAD =~ /::(_?[a-z])/) {
+- # require AutoLoader;
+- $AutoLoader::AUTOLOAD = $AUTOLOAD;
+- goto &AutoLoader::AUTOLOAD
+- }
+- local $! = 0;
+- my $constname = $AUTOLOAD;
+- $constname =~ s/.*:://;
+- my ($error, $val) = constant($constname);
+- croak $error if $error;
+- *$AUTOLOAD = sub { $val };
+-
+- goto &$AUTOLOAD;
+-}
+-
+-package POSIX::SigAction;
+-
+-use AutoLoader 'AUTOLOAD';
+-
+-package POSIX::SigRt;
+-
+-use AutoLoader 'AUTOLOAD';
+-
+-use Tie::Hash;
+-
+-use vars qw($SIGACTION_FLAGS $_SIGRTMIN $_SIGRTMAX $_sigrtn @ISA);
+-@POSIX::SigRt::ISA = qw(Tie::StdHash);
+-
+-$SIGACTION_FLAGS = 0;
+-
+-tie %POSIX::SIGRT, 'POSIX::SigRt';
+-
+-sub DESTROY {};
+-
+-package POSIX;
+-
+-1;
+-__END__
+-
+-sub usage {
+- my ($mess) = @_;
+- croak "Usage: POSIX::$mess";
+-}
+-
+-sub redef {
+- my ($mess) = @_;
+- croak "Use method $mess instead";
+-}
+-
+-sub unimpl {
+- my ($mess) = @_;
+- $mess =~ s/xxx//;
+- croak "Unimplemented: POSIX::$mess";
+-}
+-
+-sub assert {
+- usage "assert(expr)" if @_ != 1;
+- if (!$_[0]) {
+- croak "Assertion failed";
+- }
+-}
+-
+-sub tolower {
+- usage "tolower(string)" if @_ != 1;
+- lc($_[0]);
+-}
+-
+-sub toupper {
+- usage "toupper(string)" if @_ != 1;
+- uc($_[0]);
+-}
+-
+-sub closedir {
+- usage "closedir(dirhandle)" if @_ != 1;
+- CORE::closedir($_[0]);
+-}
+-
+-sub opendir {
+- usage "opendir(directory)" if @_ != 1;
+- my $dirhandle;
+- CORE::opendir($dirhandle, $_[0])
+- ? $dirhandle
+- : undef;
+-}
+-
+-sub readdir {
+- usage "readdir(dirhandle)" if @_ != 1;
+- CORE::readdir($_[0]);
+-}
+-
+-sub rewinddir {
+- usage "rewinddir(dirhandle)" if @_ != 1;
+- CORE::rewinddir($_[0]);
+-}
+-
+-sub errno {
+- usage "errno()" if @_ != 0;
+- $! + 0;
+-}
+-
+-sub creat {
+- usage "creat(filename, mode)" if @_ != 2;
+- &open($_[0], &O_WRONLY | &O_CREAT | &O_TRUNC, $_[1]);
+-}
+-
+-sub fcntl {
+- usage "fcntl(filehandle, cmd, arg)" if @_ != 3;
+- CORE::fcntl($_[0], $_[1], $_[2]);
+-}
+-
+-sub getgrgid {
+- usage "getgrgid(gid)" if @_ != 1;
+- CORE::getgrgid($_[0]);
+-}
+-
+-sub getgrnam {
+- usage "getgrnam(name)" if @_ != 1;
+- CORE::getgrnam($_[0]);
+-}
+-
+-sub atan2 {
+- usage "atan2(x,y)" if @_ != 2;
+- CORE::atan2($_[0], $_[1]);
+-}
+-
+-sub cos {
+- usage "cos(x)" if @_ != 1;
+- CORE::cos($_[0]);
+-}
+-
+-sub exp {
+- usage "exp(x)" if @_ != 1;
+- CORE::exp($_[0]);
+-}
+-
+-sub fabs {
+- usage "fabs(x)" if @_ != 1;
+- CORE::abs($_[0]);
+-}
+-
+-sub log {
+- usage "log(x)" if @_ != 1;
+- CORE::log($_[0]);
+-}
+-
+-sub pow {
+- usage "pow(x,exponent)" if @_ != 2;
+- $_[0] ** $_[1];
+-}
+-
+-sub sin {
+- usage "sin(x)" if @_ != 1;
+- CORE::sin($_[0]);
+-}
+-
+-sub sqrt {
+- usage "sqrt(x)" if @_ != 1;
+- CORE::sqrt($_[0]);
+-}
+-
+-sub getpwnam {
+- usage "getpwnam(name)" if @_ != 1;
+- CORE::getpwnam($_[0]);
+-}
+-
+-sub getpwuid {
+- usage "getpwuid(uid)" if @_ != 1;
+- CORE::getpwuid($_[0]);
+-}
+-
+-sub longjmp {
+- unimpl "longjmp() is C-specific: use die instead";
+-}
+-
+-sub setjmp {
+- unimpl "setjmp() is C-specific: use eval {} instead";
+-}
+-
+-sub siglongjmp {
+- unimpl "siglongjmp() is C-specific: use die instead";
+-}
+-
+-sub sigsetjmp {
+- unimpl "sigsetjmp() is C-specific: use eval {} instead";
+-}
+-
+-sub kill {
+- usage "kill(pid, sig)" if @_ != 2;
+- CORE::kill $_[1], $_[0];
+-}
+-
+-sub raise {
+- usage "raise(sig)" if @_ != 1;
+- CORE::kill $_[0], $$; # Is this good enough?
+-}
+-
+-sub offsetof {
+- unimpl "offsetof() is C-specific, stopped";
+-}
+-
+-sub clearerr {
+- redef "IO::Handle::clearerr()";
+-}
+-
+-sub fclose {
+- redef "IO::Handle::close()";
+-}
+-
+-sub fdopen {
+- redef "IO::Handle::new_from_fd()";
+-}
+-
+-sub feof {
+- redef "IO::Handle::eof()";
+-}
+-
+-sub fgetc {
+- redef "IO::Handle::getc()";
+-}
+-
+-sub fgets {
+- redef "IO::Handle::gets()";
+-}
+-
+-sub fileno {
+- redef "IO::Handle::fileno()";
+-}
+-
+-sub fopen {
+- redef "IO::File::open()";
+-}
+-
+-sub fprintf {
+- unimpl "fprintf() is C-specific--use printf instead";
+-}
+-
+-sub fputc {
+- unimpl "fputc() is C-specific--use print instead";
+-}
+-
+-sub fputs {
+- unimpl "fputs() is C-specific--use print instead";
+-}
+-
+-sub fread {
+- unimpl "fread() is C-specific--use read instead";
+-}
+-
+-sub freopen {
+- unimpl "freopen() is C-specific--use open instead";
+-}
+-
+-sub fscanf {
+- unimpl "fscanf() is C-specific--use <> and regular expressions instead";
+-}
+-
+-sub fseek {
+- redef "IO::Seekable::seek()";
+-}
+-
+-sub fsync {
+- redef "IO::Handle::sync()";
+-}
+-
+-sub ferror {
+- redef "IO::Handle::error()";
+-}
+-
+-sub fflush {
+- redef "IO::Handle::flush()";
+-}
+-
+-sub fgetpos {
+- redef "IO::Seekable::getpos()";
+-}
+-
+-sub fsetpos {
+- redef "IO::Seekable::setpos()";
+-}
+-
+-sub ftell {
+- redef "IO::Seekable::tell()";
+-}
+-
+-sub fwrite {
+- unimpl "fwrite() is C-specific--use print instead";
+-}
+-
+-sub getc {
+- usage "getc(handle)" if @_ != 1;
+- CORE::getc($_[0]);
+-}
+-
+-sub getchar {
+- usage "getchar()" if @_ != 0;
+- CORE::getc(STDIN);
+-}
+-
+-sub gets {
+- usage "gets()" if @_ != 0;
+- scalar <STDIN>;
+-}
+-
+-sub perror {
+- print STDERR "@_: " if @_;
+- print STDERR $!,"\n";
+-}
+-
+-sub printf {
+- usage "printf(pattern, args...)" if @_ < 1;
+- CORE::printf STDOUT @_;
+-}
+-
+-sub putc {
+- unimpl "putc() is C-specific--use print instead";
+-}
+-
+-sub putchar {
+- unimpl "putchar() is C-specific--use print instead";
+-}
+-
+-sub puts {
+- unimpl "puts() is C-specific--use print instead";
+-}
+-
+-sub remove {
+- usage "remove(filename)" if @_ != 1;
+- (-d $_[0]) ? CORE::rmdir($_[0]) : CORE::unlink($_[0]);
+-}
+-
+-sub rename {
+- usage "rename(oldfilename, newfilename)" if @_ != 2;
+- CORE::rename($_[0], $_[1]);
+-}
+-
+-sub rewind {
+- usage "rewind(filehandle)" if @_ != 1;
+- CORE::seek($_[0],0,0);
+-}
+-
+-sub scanf {
+- unimpl "scanf() is C-specific--use <> and regular expressions instead";
+-}
+-
+-sub sprintf {
+- usage "sprintf(pattern,args)" if @_ == 0;
+- CORE::sprintf(shift,@_);
+-}
+-
+-sub sscanf {
+- unimpl "sscanf() is C-specific--use regular expressions instead";
+-}
+-
+-sub tmpfile {
+- redef "IO::File::new_tmpfile()";
+-}
+-
+-sub ungetc {
+- redef "IO::Handle::ungetc()";
+-}
+-
+-sub vfprintf {
+- unimpl "vfprintf() is C-specific";
+-}
+-
+-sub vprintf {
+- unimpl "vprintf() is C-specific";
+-}
+-
+-sub vsprintf {
+- unimpl "vsprintf() is C-specific";
+-}
+-
+-sub abs {
+- usage "abs(x)" if @_ != 1;
+- CORE::abs($_[0]);
+-}
+-
+-sub atexit {
+- unimpl "atexit() is C-specific: use END {} instead";
+-}
+-
+-sub atof {
+- unimpl "atof() is C-specific, stopped";
+-}
+-
+-sub atoi {
+- unimpl "atoi() is C-specific, stopped";
+-}
+-
+-sub atol {
+- unimpl "atol() is C-specific, stopped";
+-}
+-
+-sub bsearch {
+- unimpl "bsearch() not supplied";
+-}
+-
+-sub calloc {
+- unimpl "calloc() is C-specific, stopped";
+-}
+-
+-sub div {
+- unimpl "div() is C-specific, use /, % and int instead";
+-}
+-
+-sub exit {
+- usage "exit(status)" if @_ != 1;
+- CORE::exit($_[0]);
+-}
+-
+-sub free {
+- unimpl "free() is C-specific, stopped";
+-}
+-
+-sub getenv {
+- usage "getenv(name)" if @_ != 1;
+- $ENV{$_[0]};
+-}
+-
+-sub labs {
+- unimpl "labs() is C-specific, use abs instead";
+-}
+-
+-sub ldiv {
+- unimpl "ldiv() is C-specific, use /, % and int instead";
+-}
+-
+-sub malloc {
+- unimpl "malloc() is C-specific, stopped";
+-}
+-
+-sub qsort {
+- unimpl "qsort() is C-specific, use sort instead";
+-}
+-
+-sub rand {
+- unimpl "rand() is non-portable, use Perl's rand instead";
+-}
+-
+-sub realloc {
+- unimpl "realloc() is C-specific, stopped";
+-}
+-
+-sub srand {
+- unimpl "srand()";
+-}
+-
+-sub system {
+- usage "system(command)" if @_ != 1;
+- CORE::system($_[0]);
+-}
+-
+-sub memchr {
+- unimpl "memchr() is C-specific, use index() instead";
+-}
+-
+-sub memcmp {
+- unimpl "memcmp() is C-specific, use eq instead";
+-}
+-
+-sub memcpy {
+- unimpl "memcpy() is C-specific, use = instead";
+-}
+-
+-sub memmove {
+- unimpl "memmove() is C-specific, use = instead";
+-}
+-
+-sub memset {
+- unimpl "memset() is C-specific, use x instead";
+-}
+-
+-sub strcat {
+- unimpl "strcat() is C-specific, use .= instead";
+-}
+-
+-sub strchr {
+- unimpl "strchr() is C-specific, use index() instead";
+-}
+-
+-sub strcmp {
+- unimpl "strcmp() is C-specific, use eq instead";
+-}
+-
+-sub strcpy {
+- unimpl "strcpy() is C-specific, use = instead";
+-}
+-
+-sub strcspn {
+- unimpl "strcspn() is C-specific, use regular expressions instead";
+-}
+-
+-sub strerror {
+- usage "strerror(errno)" if @_ != 1;
+- local $! = $_[0];
+- $! . "";
+-}
+-
+-sub strlen {
+- unimpl "strlen() is C-specific, use length instead";
+-}
+-
+-sub strncat {
+- unimpl "strncat() is C-specific, use .= instead";
+-}
+-
+-sub strncmp {
+- unimpl "strncmp() is C-specific, use eq instead";
+-}
+-
+-sub strncpy {
+- unimpl "strncpy() is C-specific, use = instead";
+-}
+-
+-sub strpbrk {
+- unimpl "strpbrk() is C-specific, stopped";
+-}
+-
+-sub strrchr {
+- unimpl "strrchr() is C-specific, use rindex() instead";
+-}
+-
+-sub strspn {
+- unimpl "strspn() is C-specific, stopped";
+-}
+-
+-sub strstr {
+- usage "strstr(big, little)" if @_ != 2;
+- CORE::index($_[0], $_[1]);
+-}
+-
+-sub strtok {
+- unimpl "strtok() is C-specific, stopped";
+-}
+-
+-sub chmod {
+- usage "chmod(mode, filename)" if @_ != 2;
+- CORE::chmod($_[0], $_[1]);
+-}
+-
+-sub fstat {
+- usage "fstat(fd)" if @_ != 1;
+- local *TMP;
+- CORE::open(TMP, "<&$_[0]"); # Gross.
+- my @l = CORE::stat(TMP);
+- CORE::close(TMP);
+- @l;
+-}
+-
+-sub mkdir {
+- usage "mkdir(directoryname, mode)" if @_ != 2;
+- CORE::mkdir($_[0], $_[1]);
+-}
+-
+-sub stat {
+- usage "stat(filename)" if @_ != 1;
+- CORE::stat($_[0]);
+-}
+-
+-sub umask {
+- usage "umask(mask)" if @_ != 1;
+- CORE::umask($_[0]);
+-}
+-
+-sub wait {
+- usage "wait()" if @_ != 0;
+- CORE::wait();
+-}
+-
+-sub waitpid {
+- usage "waitpid(pid, options)" if @_ != 2;
+- CORE::waitpid($_[0], $_[1]);
+-}
+-
+-sub gmtime {
+- usage "gmtime(time)" if @_ != 1;
+- CORE::gmtime($_[0]);
+-}
+-
+-sub localtime {
+- usage "localtime(time)" if @_ != 1;
+- CORE::localtime($_[0]);
+-}
+-
+-sub time {
+- usage "time()" if @_ != 0;
+- CORE::time;
+-}
+-
+-sub alarm {
+- usage "alarm(seconds)" if @_ != 1;
+- CORE::alarm($_[0]);
+-}
+-
+-sub chdir {
+- usage "chdir(directory)" if @_ != 1;
+- CORE::chdir($_[0]);
+-}
+-
+-sub chown {
+- usage "chown(uid, gid, filename)" if @_ != 3;
+- CORE::chown($_[0], $_[1], $_[2]);
+-}
+-
+-sub execl {
+- unimpl "execl() is C-specific, stopped";
+-}
+-
+-sub execle {
+- unimpl "execle() is C-specific, stopped";
+-}
+-
+-sub execlp {
+- unimpl "execlp() is C-specific, stopped";
+-}
+-
+-sub execv {
+- unimpl "execv() is C-specific, stopped";
+-}
+-
+-sub execve {
+- unimpl "execve() is C-specific, stopped";
+-}
+-
+-sub execvp {
+- unimpl "execvp() is C-specific, stopped";
+-}
+-
+-sub fork {
+- usage "fork()" if @_ != 0;
+- CORE::fork;
+-}
+-
+-sub getegid {
+- usage "getegid()" if @_ != 0;
+- $) + 0;
+-}
+-
+-sub geteuid {
+- usage "geteuid()" if @_ != 0;
+- $> + 0;
+-}
+-
+-sub getgid {
+- usage "getgid()" if @_ != 0;
+- $( + 0;
+-}
+-
+-sub getgroups {
+- usage "getgroups()" if @_ != 0;
+- my %seen;
+- grep(!$seen{$_}++, split(' ', $) ));
+-}
+-
+-sub getlogin {
+- usage "getlogin()" if @_ != 0;
+- CORE::getlogin();
+-}
+-
+-sub getpgrp {
+- usage "getpgrp()" if @_ != 0;
+- CORE::getpgrp;
+-}
+-
+-sub getpid {
+- usage "getpid()" if @_ != 0;
+- $$;
+-}
+-
+-sub getppid {
+- usage "getppid()" if @_ != 0;
+- CORE::getppid;
+-}
+-
+-sub getuid {
+- usage "getuid()" if @_ != 0;
+- $<;
+-}
+-
+-sub isatty {
+- usage "isatty(filehandle)" if @_ != 1;
+- -t $_[0];
+-}
+-
+-sub link {
+- usage "link(oldfilename, newfilename)" if @_ != 2;
+- CORE::link($_[0], $_[1]);
+-}
+-
+-sub rmdir {
+- usage "rmdir(directoryname)" if @_ != 1;
+- CORE::rmdir($_[0]);
+-}
+-
+-sub setbuf {
+- redef "IO::Handle::setbuf()";
+-}
+-
+-sub setvbuf {
+- redef "IO::Handle::setvbuf()";
+-}
+-
+-sub sleep {
+- usage "sleep(seconds)" if @_ != 1;
+- $_[0] - CORE::sleep($_[0]);
+-}
+-
+-sub unlink {
+- usage "unlink(filename)" if @_ != 1;
+- CORE::unlink($_[0]);
+-}
+-
+-sub utime {
+- usage "utime(filename, atime, mtime)" if @_ != 3;
+- CORE::utime($_[1], $_[2], $_[0]);
+-}
+-
+-sub load_imports {
+-%EXPORT_TAGS = (
+-
+- assert_h => [qw(assert NDEBUG)],
+-
+- ctype_h => [qw(isalnum isalpha iscntrl isdigit isgraph islower
+- isprint ispunct isspace isupper isxdigit tolower toupper)],
+-
+- dirent_h => [],
+-
+- errno_h => [qw(E2BIG EACCES EADDRINUSE EADDRNOTAVAIL EAFNOSUPPORT
+- EAGAIN EALREADY EBADF EBUSY ECHILD ECONNABORTED
+- ECONNREFUSED ECONNRESET EDEADLK EDESTADDRREQ EDOM EDQUOT
+- EEXIST EFAULT EFBIG EHOSTDOWN EHOSTUNREACH EINPROGRESS
+- EINTR EINVAL EIO EISCONN EISDIR ELOOP EMFILE EMLINK
+- EMSGSIZE ENAMETOOLONG ENETDOWN ENETRESET ENETUNREACH
+- ENFILE ENOBUFS ENODEV ENOENT ENOEXEC ENOLCK ENOMEM
+- ENOPROTOOPT ENOSPC ENOSYS ENOTBLK ENOTCONN ENOTDIR
+- ENOTEMPTY ENOTSOCK ENOTTY ENXIO EOPNOTSUPP EPERM
+- EPFNOSUPPORT EPIPE EPROCLIM EPROTONOSUPPORT EPROTOTYPE
+- ERANGE EREMOTE ERESTART EROFS ESHUTDOWN ESOCKTNOSUPPORT
+- ESPIPE ESRCH ESTALE ETIMEDOUT ETOOMANYREFS ETXTBSY
+- EUSERS EWOULDBLOCK EXDEV errno)],
+-
+- fcntl_h => [qw(FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_RDLCK
+- F_SETFD F_SETFL F_SETLK F_SETLKW F_UNLCK F_WRLCK
+- O_ACCMODE O_APPEND O_CREAT O_EXCL O_NOCTTY O_NONBLOCK
+- O_RDONLY O_RDWR O_TRUNC O_WRONLY
+- creat
+- SEEK_CUR SEEK_END SEEK_SET
+- S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU
+- S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISGID S_ISREG S_ISUID
+- S_IWGRP S_IWOTH S_IWUSR)],
+-
+- float_h => [qw(DBL_DIG DBL_EPSILON DBL_MANT_DIG
+- DBL_MAX DBL_MAX_10_EXP DBL_MAX_EXP
+- DBL_MIN DBL_MIN_10_EXP DBL_MIN_EXP
+- FLT_DIG FLT_EPSILON FLT_MANT_DIG
+- FLT_MAX FLT_MAX_10_EXP FLT_MAX_EXP
+- FLT_MIN FLT_MIN_10_EXP FLT_MIN_EXP
+- FLT_RADIX FLT_ROUNDS
+- LDBL_DIG LDBL_EPSILON LDBL_MANT_DIG
+- LDBL_MAX LDBL_MAX_10_EXP LDBL_MAX_EXP
+- LDBL_MIN LDBL_MIN_10_EXP LDBL_MIN_EXP)],
+-
+- grp_h => [],
+-
+- limits_h => [qw( ARG_MAX CHAR_BIT CHAR_MAX CHAR_MIN CHILD_MAX
+- INT_MAX INT_MIN LINK_MAX LONG_MAX LONG_MIN MAX_CANON
+- MAX_INPUT MB_LEN_MAX NAME_MAX NGROUPS_MAX OPEN_MAX
+- PATH_MAX PIPE_BUF SCHAR_MAX SCHAR_MIN SHRT_MAX SHRT_MIN
+- SSIZE_MAX STREAM_MAX TZNAME_MAX UCHAR_MAX UINT_MAX
+- ULONG_MAX USHRT_MAX _POSIX_ARG_MAX _POSIX_CHILD_MAX
+- _POSIX_LINK_MAX _POSIX_MAX_CANON _POSIX_MAX_INPUT
+- _POSIX_NAME_MAX _POSIX_NGROUPS_MAX _POSIX_OPEN_MAX
+- _POSIX_PATH_MAX _POSIX_PIPE_BUF _POSIX_SSIZE_MAX
+- _POSIX_STREAM_MAX _POSIX_TZNAME_MAX)],
+-
+- locale_h => [qw(LC_ALL LC_COLLATE LC_CTYPE LC_MESSAGES
+- LC_MONETARY LC_NUMERIC LC_TIME NULL
+- localeconv setlocale)],
+-
+- math_h => [qw(HUGE_VAL acos asin atan ceil cosh fabs floor fmod
+- frexp ldexp log10 modf pow sinh tan tanh)],
+-
+- pwd_h => [],
+-
+- setjmp_h => [qw(longjmp setjmp siglongjmp sigsetjmp)],
+-
+- signal_h => [qw(SA_NOCLDSTOP SA_NOCLDWAIT SA_NODEFER SA_ONSTACK
+- SA_RESETHAND SA_RESTART SA_SIGINFO SIGABRT SIGALRM
+- SIGCHLD SIGCONT SIGFPE SIGHUP SIGILL SIGINT SIGKILL
+- SIGPIPE %SIGRT SIGRTMIN SIGRTMAX SIGQUIT SIGSEGV SIGSTOP
+- SIGTERM SIGTSTP SIGTTIN SIGTTOU SIGUSR1 SIGUSR2
+- SIG_BLOCK SIG_DFL SIG_ERR SIG_IGN SIG_SETMASK SIG_UNBLOCK
+- raise sigaction signal sigpending sigprocmask sigsuspend)],
+-
+- stdarg_h => [],
+-
+- stddef_h => [qw(NULL offsetof)],
+-
+- stdio_h => [qw(BUFSIZ EOF FILENAME_MAX L_ctermid L_cuserid
+- L_tmpname NULL SEEK_CUR SEEK_END SEEK_SET
+- STREAM_MAX TMP_MAX stderr stdin stdout
+- clearerr fclose fdopen feof ferror fflush fgetc fgetpos
+- fgets fopen fprintf fputc fputs fread freopen
+- fscanf fseek fsetpos ftell fwrite getchar gets
+- perror putc putchar puts remove rewind
+- scanf setbuf setvbuf sscanf tmpfile tmpnam
+- ungetc vfprintf vprintf vsprintf)],
+-
+- stdlib_h => [qw(EXIT_FAILURE EXIT_SUCCESS MB_CUR_MAX NULL RAND_MAX
+- abort atexit atof atoi atol bsearch calloc div
+- free getenv labs ldiv malloc mblen mbstowcs mbtowc
+- qsort realloc strtod strtol strtoul wcstombs wctomb)],
+-
+- string_h => [qw(NULL memchr memcmp memcpy memmove memset strcat
+- strchr strcmp strcoll strcpy strcspn strerror strlen
+- strncat strncmp strncpy strpbrk strrchr strspn strstr
+- strtok strxfrm)],
+-
+- sys_stat_h => [qw(S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU
+- S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISGID S_ISREG
+- S_ISUID S_IWGRP S_IWOTH S_IWUSR S_IXGRP S_IXOTH S_IXUSR
+- fstat mkfifo)],
+-
+- sys_times_h => [],
+-
+- sys_types_h => [],
+-
+- sys_utsname_h => [qw(uname)],
+-
+- sys_wait_h => [qw(WEXITSTATUS WIFEXITED WIFSIGNALED WIFSTOPPED
+- WNOHANG WSTOPSIG WTERMSIG WUNTRACED)],
+-
+- termios_h => [qw( B0 B110 B1200 B134 B150 B1800 B19200 B200 B2400
+- B300 B38400 B4800 B50 B600 B75 B9600 BRKINT CLOCAL
+- CREAD CS5 CS6 CS7 CS8 CSIZE CSTOPB ECHO ECHOE ECHOK
+- ECHONL HUPCL ICANON ICRNL IEXTEN IGNBRK IGNCR IGNPAR
+- INLCR INPCK ISIG ISTRIP IXOFF IXON NCCS NOFLSH OPOST
+- PARENB PARMRK PARODD TCIFLUSH TCIOFF TCIOFLUSH TCION
+- TCOFLUSH TCOOFF TCOON TCSADRAIN TCSAFLUSH TCSANOW
+- TOSTOP VEOF VEOL VERASE VINTR VKILL VMIN VQUIT VSTART
+- VSTOP VSUSP VTIME
+- cfgetispeed cfgetospeed cfsetispeed cfsetospeed tcdrain
+- tcflow tcflush tcgetattr tcsendbreak tcsetattr )],
+-
+- time_h => [qw(CLK_TCK CLOCKS_PER_SEC NULL asctime clock ctime
+- difftime mktime strftime tzset tzname)],
+-
+- unistd_h => [qw(F_OK NULL R_OK SEEK_CUR SEEK_END SEEK_SET
+- STDERR_FILENO STDIN_FILENO STDOUT_FILENO W_OK X_OK
+- _PC_CHOWN_RESTRICTED _PC_LINK_MAX _PC_MAX_CANON
+- _PC_MAX_INPUT _PC_NAME_MAX _PC_NO_TRUNC _PC_PATH_MAX
+- _PC_PIPE_BUF _PC_VDISABLE _POSIX_CHOWN_RESTRICTED
+- _POSIX_JOB_CONTROL _POSIX_NO_TRUNC _POSIX_SAVED_IDS
+- _POSIX_VDISABLE _POSIX_VERSION _SC_ARG_MAX
+- _SC_CHILD_MAX _SC_CLK_TCK _SC_JOB_CONTROL
+- _SC_NGROUPS_MAX _SC_OPEN_MAX _SC_PAGESIZE _SC_SAVED_IDS
+- _SC_STREAM_MAX _SC_TZNAME_MAX _SC_VERSION
+- _exit access ctermid cuserid
+- dup2 dup execl execle execlp execv execve execvp
+- fpathconf fsync getcwd getegid geteuid getgid getgroups
+- getpid getuid isatty lseek pathconf pause setgid setpgid
+- setsid setuid sysconf tcgetpgrp tcsetpgrp ttyname)],
+-
+- utime_h => [],
+-
+-);
+-
+-# Exporter::export_tags();
+-{
+- # De-duplicate the export list:
+- my %export;
+- @export{map {@$_} values %EXPORT_TAGS} = ();
+- # Doing the de-dup with a temporary hash has the advantage that the SVs in
+- # @EXPORT are actually shared hash key sacalars, which will save some memory.
+- push @EXPORT, keys %export;
+-}
+-
+-@EXPORT_OK = qw(
+- abs
+- alarm
+- atan2
+- chdir
+- chmod
+- chown
+- close
+- closedir
+- cos
+- exit
+- exp
+- fcntl
+- fileno
+- fork
+- getc
+- getgrgid
+- getgrnam
+- getlogin
+- getpgrp
+- getppid
+- getpwnam
+- getpwuid
+- gmtime
+- isatty
+- kill
+- lchown
+- link
+- localtime
+- log
+- mkdir
+- nice
+- open
+- opendir
+- pipe
+- printf
+- rand
+- read
+- readdir
+- rename
+- rewinddir
+- rmdir
+- sin
+- sleep
+- sprintf
+- sqrt
+- srand
+- stat
+- system
+- time
+- times
+- umask
+- unlink
+- utime
+- wait
+- waitpid
+- write
+-);
+-
+-require Exporter;
+-}
+-
+-package POSIX::SigAction;
+-
+-sub new { bless {HANDLER => $_[1], MASK => $_[2], FLAGS => $_[3] || 0, SAFE => 0}, $_[0] }
+-sub handler { $_[0]->{HANDLER} = $_[1] if @_ > 1; $_[0]->{HANDLER} };
+-sub mask { $_[0]->{MASK} = $_[1] if @_ > 1; $_[0]->{MASK} };
+-sub flags { $_[0]->{FLAGS} = $_[1] if @_ > 1; $_[0]->{FLAGS} };
+-sub safe { $_[0]->{SAFE} = $_[1] if @_ > 1; $_[0]->{SAFE} };
+-
+-package POSIX::SigRt;
+-
+-
+-sub _init {
+- $_SIGRTMIN = &POSIX::SIGRTMIN;
+- $_SIGRTMAX = &POSIX::SIGRTMAX;
+- $_sigrtn = $_SIGRTMAX - $_SIGRTMIN;
+-}
+-
+-sub _croak {
+- &_init unless defined $_sigrtn;
+- die "POSIX::SigRt not available" unless defined $_sigrtn && $_sigrtn > 0;
+-}
+-
+-sub _getsig {
+- &_croak;
+- my $rtsig = $_[0];
+- # Allow (SIGRT)?MIN( + n)?, a common idiom when doing these things in C.
+- $rtsig = $_SIGRTMIN + ($1 || 0)
+- if $rtsig =~ /^(?:(?:SIG)?RT)?MIN(\s*\+\s*(\d+))?$/;
+- return $rtsig;
+-}
+-
+-sub _exist {
+- my $rtsig = _getsig($_[1]);
+- my $ok = $rtsig >= $_SIGRTMIN && $rtsig <= $_SIGRTMAX;
+- ($rtsig, $ok);
+-}
+-
+-sub _check {
+- my ($rtsig, $ok) = &_exist;
+- die "No POSIX::SigRt signal $_[1] (valid range SIGRTMIN..SIGRTMAX, or $_SIGRTMIN..$_SIGRTMAX)"
+- unless $ok;
+- return $rtsig;
+-}
+-
+-sub new {
+- my ($rtsig, $handler, $flags) = @_;
+- my $sigset = POSIX::SigSet->new($rtsig);
+- my $sigact = POSIX::SigAction->new($handler,
+- $sigset,
+- $flags);
+- POSIX::sigaction($rtsig, $sigact);
+-}
+-
+-sub EXISTS { &_exist }
+-sub FETCH { my $rtsig = &_check;
+- my $oa = POSIX::SigAction->new();
+- POSIX::sigaction($rtsig, undef, $oa);
+- return $oa->{HANDLER} }
+-sub STORE { my $rtsig = &_check; new($rtsig, $_[2], $SIGACTION_FLAGS) }
+-sub DELETE { delete $SIG{ &_check } }
+-sub CLEAR { &_exist; delete @SIG{ &POSIX::SIGRTMIN .. &POSIX::SIGRTMAX } }
+-sub SCALAR { &_croak; $_sigrtn + 1 }
+diff --git a/ext/POSIX/POSIX.pod b/ext/POSIX/POSIX.pod
+deleted file mode 100644
+index 64852e9..0000000
+--- a/ext/POSIX/POSIX.pod
++++ /dev/null
+@@ -1,2218 +0,0 @@
+-=head1 NAME
+-
+-POSIX - Perl interface to IEEE Std 1003.1
+-
+-=head1 SYNOPSIS
+-
+- use POSIX;
+- use POSIX qw(setsid);
+- use POSIX qw(:errno_h :fcntl_h);
+-
+- printf "EINTR is %d\n", EINTR;
+-
+- $sess_id = POSIX::setsid();
+-
+- $fd = POSIX::open($path, O_CREAT|O_EXCL|O_WRONLY, 0644);
+- # note: that's a filedescriptor, *NOT* a filehandle
+-
+-=head1 DESCRIPTION
+-
+-The POSIX module permits you to access all (or nearly all) the standard
+-POSIX 1003.1 identifiers. Many of these identifiers have been given Perl-ish
+-interfaces.
+-
+-I<Everything is exported by default> with the exception of any POSIX
+-functions with the same name as a built-in Perl function, such as
+-C<abs>, C<alarm>, C<rmdir>, C<write>, etc.., which will be exported
+-only if you ask for them explicitly. This is an unfortunate backwards
+-compatibility feature. You can stop the exporting by saying C<use
+-POSIX ()> and then use the fully qualified names (ie. C<POSIX::SEEK_END>).
+-
+-This document gives a condensed list of the features available in the POSIX
+-module. Consult your operating system's manpages for general information on
+-most features. Consult L<perlfunc> for functions which are noted as being
+-identical to Perl's builtin functions.
+-
+-The first section describes POSIX functions from the 1003.1 specification.
+-The second section describes some classes for signal objects, TTY objects,
+-and other miscellaneous objects. The remaining sections list various
+-constants and macros in an organization which roughly follows IEEE Std
+-1003.1b-1993.
+-
+-=head1 NOTE
+-
+-The POSIX module is probably the most complex Perl module supplied with
+-the standard distribution. It incorporates autoloading, namespace games,
+-and dynamic loading of code that's in Perl, C, or both. It's a great
+-source of wisdom.
+-
+-=head1 CAVEATS
+-
+-A few functions are not implemented because they are C specific. If you
+-attempt to call these, they will print a message telling you that they
+-aren't implemented, and suggest using the Perl equivalent should one
+-exist. For example, trying to access the setjmp() call will elicit the
+-message "setjmp() is C-specific: use eval {} instead".
+-
+-Furthermore, some evil vendors will claim 1003.1 compliance, but in fact
+-are not so: they will not pass the PCTS (POSIX Compliance Test Suites).
+-For example, one vendor may not define EDEADLK, or the semantics of the
+-errno values set by open(2) might not be quite right. Perl does not
+-attempt to verify POSIX compliance. That means you can currently
+-successfully say "use POSIX", and then later in your program you find
+-that your vendor has been lax and there's no usable ICANON macro after
+-all. This could be construed to be a bug.
+-
+-=head1 FUNCTIONS
+-
+-=over 8
+-
+-=item _exit
+-
+-This is identical to the C function C<_exit()>. It exits the program
+-immediately which means among other things buffered I/O is B<not> flushed.
+-
+-Note that when using threads and in Linux this is B<not> a good way to
+-exit a thread because in Linux processes and threads are kind of the
+-same thing (Note: while this is the situation in early 2003 there are
+-projects under way to have threads with more POSIXly semantics in Linux).
+-If you want not to return from a thread, detach the thread.
+-
+-=item abort
+-
+-This is identical to the C function C<abort()>. It terminates the
+-process with a C<SIGABRT> signal unless caught by a signal handler or
+-if the handler does not return normally (it e.g. does a C<longjmp>).
+-
+-=item abs
+-
+-This is identical to Perl's builtin C<abs()> function, returning
+-the absolute value of its numerical argument.
+-
+-=item access
+-
+-Determines the accessibility of a file.
+-
+- if( POSIX::access( "/", &POSIX::R_OK ) ){
+- print "have read permission\n";
+- }
+-
+-Returns C<undef> on failure. Note: do not use C<access()> for
+-security purposes. Between the C<access()> call and the operation
+-you are preparing for the permissions might change: a classic
+-I<race condition>.
+-
+-=item acos
+-
+-This is identical to the C function C<acos()>, returning
+-the arcus cosine of its numerical argument. See also L<Math::Trig>.
+-
+-=item alarm
+-
+-This is identical to Perl's builtin C<alarm()> function,
+-either for arming or disarming the C<SIGARLM> timer.
+-
+-=item asctime
+-
+-This is identical to the C function C<asctime()>. It returns
+-a string of the form
+-
+- "Fri Jun 2 18:22:13 2000\n\0"
+-
+-and it is called thusly
+-
+- $asctime = asctime($sec, $min, $hour, $mday, $mon, $year,
+- $wday, $yday, $isdst);
+-
+-The C<$mon> is zero-based: January equals C<0>. The C<$year> is
+-1900-based: 2001 equals C<101>. C<$wday> and C<$yday> default to zero
+-(and are usually ignored anyway), and C<$isdst> defaults to -1.
+-
+-=item asin
+-
+-This is identical to the C function C<asin()>, returning
+-the arcus sine of its numerical argument. See also L<Math::Trig>.
+-
+-=item assert
+-
+-Unimplemented, but you can use L<perlfunc/die> and the L<Carp> module
+-to achieve similar things.
+-
+-=item atan
+-
+-This is identical to the C function C<atan()>, returning the
+-arcus tangent of its numerical argument. See also L<Math::Trig>.
+-
+-=item atan2
+-
+-This is identical to Perl's builtin C<atan2()> function, returning
+-the arcus tangent defined by its two numerical arguments, the I<y>
+-coordinate and the I<x> coordinate. See also L<Math::Trig>.
+-
+-=item atexit
+-
+-atexit() is C-specific: use C<END {}> instead, see L<perlsub>.
+-
+-=item atof
+-
+-atof() is C-specific. Perl converts strings to numbers transparently.
+-If you need to force a scalar to a number, add a zero to it.
+-
+-=item atoi
+-
+-atoi() is C-specific. Perl converts strings to numbers transparently.
+-If you need to force a scalar to a number, add a zero to it.
+-If you need to have just the integer part, see L<perlfunc/int>.
+-
+-=item atol
+-
+-atol() is C-specific. Perl converts strings to numbers transparently.
+-If you need to force a scalar to a number, add a zero to it.
+-If you need to have just the integer part, see L<perlfunc/int>.
+-
+-=item bsearch
+-
+-bsearch() not supplied. For doing binary search on wordlists,
+-see L<Search::Dict>.
+-
+-=item calloc
+-
+-calloc() is C-specific. Perl does memory management transparently.
+-
+-=item ceil
+-
+-This is identical to the C function C<ceil()>, returning the smallest
+-integer value greater than or equal to the given numerical argument.
+-
+-=item chdir
+-
+-This is identical to Perl's builtin C<chdir()> function, allowing
+-one to change the working (default) directory, see L<perlfunc/chdir>.
+-
+-=item chmod
+-
+-This is identical to Perl's builtin C<chmod()> function, allowing
+-one to change file and directory permissions, see L<perlfunc/chmod>.
+-
+-=item chown
+-
+-This is identical to Perl's builtin C<chown()> function, allowing one
+-to change file and directory owners and groups, see L<perlfunc/chown>.
+-
+-=item clearerr
+-
+-Use the method C<IO::Handle::clearerr()> instead, to reset the error
+-state (if any) and EOF state (if any) of the given stream.
+-
+-=item clock
+-
+-This is identical to the C function C<clock()>, returning the
+-amount of spent processor time in microseconds.
+-
+-=item close
+-
+-Close the file. This uses file descriptors such as those obtained by calling
+-C<POSIX::open>.
+-
+- $fd = POSIX::open( "foo", &POSIX::O_RDONLY );
+- POSIX::close( $fd );
+-
+-Returns C<undef> on failure.
+-
+-See also L<perlfunc/close>.
+-
+-=item closedir
+-
+-This is identical to Perl's builtin C<closedir()> function for closing
+-a directory handle, see L<perlfunc/closedir>.
+-
+-=item cos
+-
+-This is identical to Perl's builtin C<cos()> function, for returning
+-the cosine of its numerical argument, see L<perlfunc/cos>.
+-See also L<Math::Trig>.
+-
+-=item cosh
+-
+-This is identical to the C function C<cosh()>, for returning
+-the hyperbolic cosine of its numeric argument. See also L<Math::Trig>.
+-
+-=item creat
+-
+-Create a new file. This returns a file descriptor like the ones returned by
+-C<POSIX::open>. Use C<POSIX::close> to close the file.
+-
+- $fd = POSIX::creat( "foo", 0611 );
+- POSIX::close( $fd );
+-
+-See also L<perlfunc/sysopen> and its C<O_CREAT> flag.
+-
+-=item ctermid
+-
+-Generates the path name for the controlling terminal.
+-
+- $path = POSIX::ctermid();
+-
+-=item ctime
+-
+-This is identical to the C function C<ctime()> and equivalent
+-to C<asctime(localtime(...))>, see L</asctime> and L</localtime>.
+-
+-=item cuserid
+-
+-Get the login name of the owner of the current process.
+-
+- $name = POSIX::cuserid();
+-
+-=item difftime
+-
+-This is identical to the C function C<difftime()>, for returning
+-the time difference (in seconds) between two times (as returned
+-by C<time()>), see L</time>.
+-
+-=item div
+-
+-div() is C-specific, use L<perlfunc/int> on the usual C</> division and
+-the modulus C<%>.
+-
+-=item dup
+-
+-This is similar to the C function C<dup()>, for duplicating a file
+-descriptor.
+-
+-This uses file descriptors such as those obtained by calling
+-C<POSIX::open>.
+-
+-Returns C<undef> on failure.
+-
+-=item dup2
+-
+-This is similar to the C function C<dup2()>, for duplicating a file
+-descriptor to an another known file descriptor.
+-
+-This uses file descriptors such as those obtained by calling
+-C<POSIX::open>.
+-
+-Returns C<undef> on failure.
+-
+-=item errno
+-
+-Returns the value of errno.
+-
+- $errno = POSIX::errno();
+-
+-This identical to the numerical values of the C<$!>, see L<perlvar/$ERRNO>.
+-
+-=item execl
+-
+-execl() is C-specific, see L<perlfunc/exec>.
+-
+-=item execle
+-
+-execle() is C-specific, see L<perlfunc/exec>.
+-
+-=item execlp
+-
+-execlp() is C-specific, see L<perlfunc/exec>.
+-
+-=item execv
+-
+-execv() is C-specific, see L<perlfunc/exec>.
+-
+-=item execve
+-
+-execve() is C-specific, see L<perlfunc/exec>.
+-
+-=item execvp
+-
+-execvp() is C-specific, see L<perlfunc/exec>.
+-
+-=item exit
+-
+-This is identical to Perl's builtin C<exit()> function for exiting the
+-program, see L<perlfunc/exit>.
+-
+-=item exp
+-
+-This is identical to Perl's builtin C<exp()> function for
+-returning the exponent (I<e>-based) of the numerical argument,
+-see L<perlfunc/exp>.
+-
+-=item fabs
+-
+-This is identical to Perl's builtin C<abs()> function for returning
+-the absolute value of the numerical argument, see L<perlfunc/abs>.
+-
+-=item fclose
+-
+-Use method C<IO::Handle::close()> instead, or see L<perlfunc/close>.
+-
+-=item fcntl
+-
+-This is identical to Perl's builtin C<fcntl()> function,
+-see L<perlfunc/fcntl>.
+-
+-=item fdopen
+-
+-Use method C<IO::Handle::new_from_fd()> instead, or see L<perlfunc/open>.
+-
+-=item feof
+-
+-Use method C<IO::Handle::eof()> instead, or see L<perlfunc/eof>.
+-
+-=item ferror
+-
+-Use method C<IO::Handle::error()> instead.
+-
+-=item fflush
+-
+-Use method C<IO::Handle::flush()> instead.
+-See also L<perlvar/$OUTPUT_AUTOFLUSH>.
+-
+-=item fgetc
+-
+-Use method C<IO::Handle::getc()> instead, or see L<perlfunc/read>.
+-
+-=item fgetpos
+-
+-Use method C<IO::Seekable::getpos()> instead, or see L<L/seek>.
+-
+-=item fgets
+-
+-Use method C<IO::Handle::gets()> instead. Similar to E<lt>E<gt>, also known
+-as L<perlfunc/readline>.
+-
+-=item fileno
+-
+-Use method C<IO::Handle::fileno()> instead, or see L<perlfunc/fileno>.
+-
+-=item floor
+-
+-This is identical to the C function C<floor()>, returning the largest
+-integer value less than or equal to the numerical argument.
+-
+-=item fmod
+-
+-This is identical to the C function C<fmod()>.
+-
+- $r = fmod($x, $y);
+-
+-It returns the remainder C<$r = $x - $n*$y>, where C<$n = trunc($x/$y)>.
+-The C<$r> has the same sign as C<$x> and magnitude (absolute value)
+-less than the magnitude of C<$y>.
+-
+-=item fopen
+-
+-Use method C<IO::File::open()> instead, or see L<perlfunc/open>.
+-
+-=item fork
+-
+-This is identical to Perl's builtin C<fork()> function
+-for duplicating the current process, see L<perlfunc/fork>
+-and L<perlfork> if you are in Windows.
+-
+-=item fpathconf
+-
+-Retrieves the value of a configurable limit on a file or directory. This
+-uses file descriptors such as those obtained by calling C<POSIX::open>.
+-
+-The following will determine the maximum length of the longest allowable
+-pathname on the filesystem which holds C</var/foo>.
+-
+- $fd = POSIX::open( "/var/foo", &POSIX::O_RDONLY );
+- $path_max = POSIX::fpathconf( $fd, &POSIX::_PC_PATH_MAX );
+-
+-Returns C<undef> on failure.
+-
+-=item fprintf
+-
+-fprintf() is C-specific, see L<perlfunc/printf> instead.
+-
+-=item fputc
+-
+-fputc() is C-specific, see L<perlfunc/print> instead.
+-
+-=item fputs
+-
+-fputs() is C-specific, see L<perlfunc/print> instead.
+-
+-=item fread
+-
+-fread() is C-specific, see L<perlfunc/read> instead.
+-
+-=item free
+-
+-free() is C-specific. Perl does memory management transparently.
+-
+-=item freopen
+-
+-freopen() is C-specific, see L<perlfunc/open> instead.
+-
+-=item frexp
+-
+-Return the mantissa and exponent of a floating-point number.
+-
+- ($mantissa, $exponent) = POSIX::frexp( 1.234e56 );
+-
+-=item fscanf
+-
+-fscanf() is C-specific, use E<lt>E<gt> and regular expressions instead.
+-
+-=item fseek
+-
+-Use method C<IO::Seekable::seek()> instead, or see L<perlfunc/seek>.
+-
+-=item fsetpos
+-
+-Use method C<IO::Seekable::setpos()> instead, or seek L<perlfunc/seek>.
+-
+-=item fstat
+-
+-Get file status. This uses file descriptors such as those obtained by
+-calling C<POSIX::open>. The data returned is identical to the data from
+-Perl's builtin C<stat> function.
+-
+- $fd = POSIX::open( "foo", &POSIX::O_RDONLY );
+- @stats = POSIX::fstat( $fd );
+-
+-=item fsync
+-
+-Use method C<IO::Handle::sync()> instead.
+-
+-=item ftell
+-
+-Use method C<IO::Seekable::tell()> instead, or see L<perlfunc/tell>.
+-
+-=item fwrite
+-
+-fwrite() is C-specific, see L<perlfunc/print> instead.
+-
+-=item getc
+-
+-This is identical to Perl's builtin C<getc()> function,
+-see L<perlfunc/getc>.
+-
+-=item getchar
+-
+-Returns one character from STDIN. Identical to Perl's C<getc()>,
+-see L<perlfunc/getc>.
+-
+-=item getcwd
+-
+-Returns the name of the current working directory.
+-See also L<Cwd>.
+-
+-=item getegid
+-
+-Returns the effective group identifier. Similar to Perl' s builtin
+-variable C<$(>, see L<perlvar/$EGID>.
+-
+-=item getenv
+-
+-Returns the value of the specified environment variable.
+-The same information is available through the C<%ENV> array.
+-
+-=item geteuid
+-
+-Returns the effective user identifier. Identical to Perl's builtin C<$E<gt>>
+-variable, see L<perlvar/$EUID>.
+-
+-=item getgid
+-
+-Returns the user's real group identifier. Similar to Perl's builtin
+-variable C<$)>, see L<perlvar/$GID>.
+-
+-=item getgrgid
+-
+-This is identical to Perl's builtin C<getgrgid()> function for
+-returning group entries by group identifiers, see
+-L<perlfunc/getgrgid>.
+-
+-=item getgrnam
+-
+-This is identical to Perl's builtin C<getgrnam()> function for
+-returning group entries by group names, see L<perlfunc/getgrnam>.
+-
+-=item getgroups
+-
+-Returns the ids of the user's supplementary groups. Similar to Perl's
+-builtin variable C<$)>, see L<perlvar/$GID>.
+-
+-=item getlogin
+-
+-This is identical to Perl's builtin C<getlogin()> function for
+-returning the user name associated with the current session, see
+-L<perlfunc/getlogin>.
+-
+-=item getpgrp
+-
+-This is identical to Perl's builtin C<getpgrp()> function for
+-returning the process group identifier of the current process, see
+-L<perlfunc/getpgrp>.
+-
+-=item getpid
+-
+-Returns the process identifier. Identical to Perl's builtin
+-variable C<$$>, see L<perlvar/$PID>.
+-
+-=item getppid
+-
+-This is identical to Perl's builtin C<getppid()> function for
+-returning the process identifier of the parent process of the current
+-process , see L<perlfunc/getppid>.
+-
+-=item getpwnam
+-
+-This is identical to Perl's builtin C<getpwnam()> function for
+-returning user entries by user names, see L<perlfunc/getpwnam>.
+-
+-=item getpwuid
+-
+-This is identical to Perl's builtin C<getpwuid()> function for
+-returning user entries by user identifiers, see L<perlfunc/getpwuid>.
+-
+-=item gets
+-
+-Returns one line from C<STDIN>, similar to E<lt>E<gt>, also known
+-as the C<readline()> function, see L<perlfunc/readline>.
+-
+-B<NOTE>: if you have C programs that still use C<gets()>, be very
+-afraid. The C<gets()> function is a source of endless grief because
+-it has no buffer overrun checks. It should B<never> be used. The
+-C<fgets()> function should be preferred instead.
+-
+-=item getuid
+-
+-Returns the user's identifier. Identical to Perl's builtin C<$E<lt>> variable,
+-see L<perlvar/$UID>.
+-
+-=item gmtime
+-
+-This is identical to Perl's builtin C<gmtime()> function for
+-converting seconds since the epoch to a date in Greenwich Mean Time,
+-see L<perlfunc/gmtime>.
+-
+-=item isalnum
+-
+-This is identical to the C function, except that it can apply to a
+-single character or to a whole string. Note that locale settings may
+-affect what characters are considered C<isalnum>. Does not work on
+-Unicode characters code point 256 or higher. Consider using regular
+-expressions and the C</[[:alnum:]]/> construct instead, or possibly
+-the C</\w/> construct.
+-
+-=item isalpha
+-
+-This is identical to the C function, except that it can apply to
+-a single character or to a whole string. Note that locale settings
+-may affect what characters are considered C<isalpha>. Does not work
+-on Unicode characters code point 256 or higher. Consider using regular
+-expressions and the C</[[:alpha:]]/> construct instead.
+-
+-=item isatty
+-
+-Returns a boolean indicating whether the specified filehandle is connected
+-to a tty. Similar to the C<-t> operator, see L<perlfunc/-X>.
+-
+-=item iscntrl
+-
+-This is identical to the C function, except that it can apply to
+-a single character or to a whole string. Note that locale settings
+-may affect what characters are considered C<iscntrl>. Does not work
+-on Unicode characters code point 256 or higher. Consider using regular
+-expressions and the C</[[:cntrl:]]/> construct instead.
+-
+-=item isdigit
+-
+-This is identical to the C function, except that it can apply to
+-a single character or to a whole string. Note that locale settings
+-may affect what characters are considered C<isdigit> (unlikely, but
+-still possible). Does not work on Unicode characters code point 256
+-or higher. Consider using regular expressions and the C</[[:digit:]]/>
+-construct instead, or the C</\d/> construct.
+-
+-=item isgraph
+-
+-This is identical to the C function, except that it can apply to
+-a single character or to a whole string. Note that locale settings
+-may affect what characters are considered C<isgraph>. Does not work
+-on Unicode characters code point 256 or higher. Consider using regular
+-expressions and the C</[[:graph:]]/> construct instead.
+-
+-=item islower
+-
+-This is identical to the C function, except that it can apply to
+-a single character or to a whole string. Note that locale settings
+-may affect what characters are considered C<islower>. Does not work
+-on Unicode characters code point 256 or higher. Consider using regular
+-expressions and the C</[[:lower:]]/> construct instead. Do B<not> use
+-C</[a-z]/>.
+-
+-=item isprint
+-
+-This is identical to the C function, except that it can apply to
+-a single character or to a whole string. Note that locale settings
+-may affect what characters are considered C<isprint>. Does not work
+-on Unicode characters code point 256 or higher. Consider using regular
+-expressions and the C</[[:print:]]/> construct instead.
+-
+-=item ispunct
+-
+-This is identical to the C function, except that it can apply to
+-a single character or to a whole string. Note that locale settings
+-may affect what characters are considered C<ispunct>. Does not work
+-on Unicode characters code point 256 or higher. Consider using regular
+-expressions and the C</[[:punct:]]/> construct instead.
+-
+-=item isspace
+-
+-This is identical to the C function, except that it can apply to
+-a single character or to a whole string. Note that locale settings
+-may affect what characters are considered C<isspace>. Does not work
+-on Unicode characters code point 256 or higher. Consider using regular
+-expressions and the C</[[:space:]]/> construct instead, or the C</\s/>
+-construct. (Note that C</\s/> and C</[[:space:]]/> are slightly
+-different in that C</[[:space:]]/> can normally match a vertical tab,
+-while C</\s/> does not.)
+-
+-=item isupper
+-
+-This is identical to the C function, except that it can apply to
+-a single character or to a whole string. Note that locale settings
+-may affect what characters are considered C<isupper>. Does not work
+-on Unicode characters code point 256 or higher. Consider using regular
+-expressions and the C</[[:upper:]]/> construct instead. Do B<not> use
+-C</[A-Z]/>.
+-
+-=item isxdigit
+-
+-This is identical to the C function, except that it can apply to a single
+-character or to a whole string. Note that locale settings may affect what
+-characters are considered C<isxdigit> (unlikely, but still possible).
+-Does not work on Unicode characters code point 256 or higher.
+-Consider using regular expressions and the C</[[:xdigit:]]/>
+-construct instead, or simply C</[0-9a-f]/i>.
+-
+-=item kill
+-
+-This is identical to Perl's builtin C<kill()> function for sending
+-signals to processes (often to terminate them), see L<perlfunc/kill>.
+-
+-=item labs
+-
+-(For returning absolute values of long integers.)
+-labs() is C-specific, see L<perlfunc/abs> instead.
+-
+-=item lchown
+-
+-This is identical to the C function, except the order of arguments is
+-consistent with Perl's builtin C<chown()> with the added restriction
+-of only one path, not an list of paths. Does the same thing as the
+-C<chown()> function but changes the owner of a symbolic link instead
+-of the file the symbolic link points to.
+-
+-=item ldexp
+-
+-This is identical to the C function C<ldexp()>
+-for multiplying floating point numbers with powers of two.
+-
+- $x_quadrupled = POSIX::ldexp($x, 2);
+-
+-=item ldiv
+-
+-(For computing dividends of long integers.)
+-ldiv() is C-specific, use C</> and C<int()> instead.
+-
+-=item link
+-
+-This is identical to Perl's builtin C<link()> function
+-for creating hard links into files, see L<perlfunc/link>.
+-
+-=item localeconv
+-
+-Get numeric formatting information. Returns a reference to a hash
+-containing the current locale formatting values.
+-
+-Here is how to query the database for the B<de> (Deutsch or German) locale.
+-
+- $loc = POSIX::setlocale( &POSIX::LC_ALL, "de" );
+- print "Locale = $loc\n";
+- $lconv = POSIX::localeconv();
+- print "decimal_point = ", $lconv->{decimal_point}, "\n";
+- print "thousands_sep = ", $lconv->{thousands_sep}, "\n";
+- print "grouping = ", $lconv->{grouping}, "\n";
+- print "int_curr_symbol = ", $lconv->{int_curr_symbol}, "\n";
+- print "currency_symbol = ", $lconv->{currency_symbol}, "\n";
+- print "mon_decimal_point = ", $lconv->{mon_decimal_point}, "\n";
+- print "mon_thousands_sep = ", $lconv->{mon_thousands_sep}, "\n";
+- print "mon_grouping = ", $lconv->{mon_grouping}, "\n";
+- print "positive_sign = ", $lconv->{positive_sign}, "\n";
+- print "negative_sign = ", $lconv->{negative_sign}, "\n";
+- print "int_frac_digits = ", $lconv->{int_frac_digits}, "\n";
+- print "frac_digits = ", $lconv->{frac_digits}, "\n";
+- print "p_cs_precedes = ", $lconv->{p_cs_precedes}, "\n";
+- print "p_sep_by_space = ", $lconv->{p_sep_by_space}, "\n";
+- print "n_cs_precedes = ", $lconv->{n_cs_precedes}, "\n";
+- print "n_sep_by_space = ", $lconv->{n_sep_by_space}, "\n";
+- print "p_sign_posn = ", $lconv->{p_sign_posn}, "\n";
+- print "n_sign_posn = ", $lconv->{n_sign_posn}, "\n";
+-
+-=item localtime
+-
+-This is identical to Perl's builtin C<localtime()> function for
+-converting seconds since the epoch to a date see L<perlfunc/localtime>.
+-
+-=item log
+-
+-This is identical to Perl's builtin C<log()> function,
+-returning the natural (I<e>-based) logarithm of the numerical argument,
+-see L<perlfunc/log>.
+-
+-=item log10
+-
+-This is identical to the C function C<log10()>,
+-returning the 10-base logarithm of the numerical argument.
+-You can also use
+-
+- sub log10 { log($_[0]) / log(10) }
+-
+-or
+-
+- sub log10 { log($_[0]) / 2.30258509299405 }
+-
+-or
+-
+- sub log10 { log($_[0]) * 0.434294481903252 }
+-
+-=item longjmp
+-
+-longjmp() is C-specific: use L<perlfunc/die> instead.
+-
+-=item lseek
+-
+-Move the file's read/write position. This uses file descriptors such as
+-those obtained by calling C<POSIX::open>.
+-
+- $fd = POSIX::open( "foo", &POSIX::O_RDONLY );
+- $off_t = POSIX::lseek( $fd, 0, &POSIX::SEEK_SET );
+-
+-Returns C<undef> on failure.
+-
+-=item malloc
+-
+-malloc() is C-specific. Perl does memory management transparently.
+-
+-=item mblen
+-
+-This is identical to the C function C<mblen()>.
+-Perl does not have any support for the wide and multibyte
+-characters of the C standards, so this might be a rather
+-useless function.
+-
+-=item mbstowcs
+-
+-This is identical to the C function C<mbstowcs()>.
+-Perl does not have any support for the wide and multibyte
+-characters of the C standards, so this might be a rather
+-useless function.
+-
+-=item mbtowc
+-
+-This is identical to the C function C<mbtowc()>.
+-Perl does not have any support for the wide and multibyte
+-characters of the C standards, so this might be a rather
+-useless function.
+-
+-=item memchr
+-
+-memchr() is C-specific, see L<perlfunc/index> instead.
+-
+-=item memcmp
+-
+-memcmp() is C-specific, use C<eq> instead, see L<perlop>.
+-
+-=item memcpy
+-
+-memcpy() is C-specific, use C<=>, see L<perlop>, or see L<perlfunc/substr>.
+-
+-=item memmove
+-
+-memmove() is C-specific, use C<=>, see L<perlop>, or see L<perlfunc/substr>.
+-
+-=item memset
+-
+-memset() is C-specific, use C<x> instead, see L<perlop>.
+-
+-=item mkdir
+-
+-This is identical to Perl's builtin C<mkdir()> function
+-for creating directories, see L<perlfunc/mkdir>.
+-
+-=item mkfifo
+-
+-This is similar to the C function C<mkfifo()> for creating
+-FIFO special files.
+-
+- if (mkfifo($path, $mode)) { ....
+-
+-Returns C<undef> on failure. The C<$mode> is similar to the
+-mode of C<mkdir()>, see L<perlfunc/mkdir>, though for C<mkfifo>
+-you B<must> specify the C<$mode>.
+-
+-=item mktime
+-
+-Convert date/time info to a calendar time.
+-
+-Synopsis:
+-
+- mktime(sec, min, hour, mday, mon, year, wday = 0, yday = 0, isdst = -1)
+-
+-The month (C<mon>), weekday (C<wday>), and yearday (C<yday>) begin at zero.
+-I.e. January is 0, not 1; Sunday is 0, not 1; January 1st is 0, not 1. The
+-year (C<year>) is given in years since 1900. I.e. The year 1995 is 95; the
+-year 2001 is 101. Consult your system's C<mktime()> manpage for details
+-about these and the other arguments.
+-
+-Calendar time for December 12, 1995, at 10:30 am.
+-
+- $time_t = POSIX::mktime( 0, 30, 10, 12, 11, 95 );
+- print "Date = ", POSIX::ctime($time_t);
+-
+-Returns C<undef> on failure.
+-
+-=item modf
+-
+-Return the integral and fractional parts of a floating-point number.
+-
+- ($fractional, $integral) = POSIX::modf( 3.14 );
+-
+-=item nice
+-
+-This is similar to the C function C<nice()>, for changing
+-the scheduling preference of the current process. Positive
+-arguments mean more polite process, negative values more
+-needy process. Normal user processes can only be more polite.
+-
+-Returns C<undef> on failure.
+-
+-=item offsetof
+-
+-offsetof() is C-specific, you probably want to see L<perlfunc/pack> instead.
+-
+-=item open
+-
+-Open a file for reading for writing. This returns file descriptors, not
+-Perl filehandles. Use C<POSIX::close> to close the file.
+-
+-Open a file read-only with mode 0666.
+-
+- $fd = POSIX::open( "foo" );
+-
+-Open a file for read and write.
+-
+- $fd = POSIX::open( "foo", &POSIX::O_RDWR );
+-
+-Open a file for write, with truncation.
+-
+- $fd = POSIX::open( "foo", &POSIX::O_WRONLY | &POSIX::O_TRUNC );
+-
+-Create a new file with mode 0640. Set up the file for writing.
+-
+- $fd = POSIX::open( "foo", &POSIX::O_CREAT | &POSIX::O_WRONLY, 0640 );
+-
+-Returns C<undef> on failure.
+-
+-See also L<perlfunc/sysopen>.
+-
+-=item opendir
+-
+-Open a directory for reading.
+-
+- $dir = POSIX::opendir( "/var" );
+- @files = POSIX::readdir( $dir );
+- POSIX::closedir( $dir );
+-
+-Returns C<undef> on failure.
+-
+-=item pathconf
+-
+-Retrieves the value of a configurable limit on a file or directory.
+-
+-The following will determine the maximum length of the longest allowable
+-pathname on the filesystem which holds C</var>.
+-
+- $path_max = POSIX::pathconf( "/var", &POSIX::_PC_PATH_MAX );
+-
+-Returns C<undef> on failure.
+-
+-=item pause
+-
+-This is similar to the C function C<pause()>, which suspends
+-the execution of the current process until a signal is received.
+-
+-Returns C<undef> on failure.
+-
+-=item perror
+-
+-This is identical to the C function C<perror()>, which outputs to the
+-standard error stream the specified message followed by ": " and the
+-current error string. Use the C<warn()> function and the C<$!>
+-variable instead, see L<perlfunc/warn> and L<perlvar/$ERRNO>.
+-
+-=item pipe
+-
+-Create an interprocess channel. This returns file descriptors like those
+-returned by C<POSIX::open>.
+-
+- my ($read, $write) = POSIX::pipe();
+- POSIX::write( $write, "hello", 5 );
+- POSIX::read( $read, $buf, 5 );
+-
+-See also L<perlfunc/pipe>.
+-
+-=item pow
+-
+-Computes C<$x> raised to the power C<$exponent>.
+-
+- $ret = POSIX::pow( $x, $exponent );
+-
+-You can also use the C<**> operator, see L<perlop>.
+-
+-=item printf
+-
+-Formats and prints the specified arguments to STDOUT.
+-See also L<perlfunc/printf>.
+-
+-=item putc
+-
+-putc() is C-specific, see L<perlfunc/print> instead.
+-
+-=item putchar
+-
+-putchar() is C-specific, see L<perlfunc/print> instead.
+-
+-=item puts
+-
+-puts() is C-specific, see L<perlfunc/print> instead.
+-
+-=item qsort
+-
+-qsort() is C-specific, see L<perlfunc/sort> instead.
+-
+-=item raise
+-
+-Sends the specified signal to the current process.
+-See also L<perlfunc/kill> and the C<$$> in L<perlvar/$PID>.
+-
+-=item rand
+-
+-C<rand()> is non-portable, see L<perlfunc/rand> instead.
+-
+-=item read
+-
+-Read from a file. This uses file descriptors such as those obtained by
+-calling C<POSIX::open>. If the buffer C<$buf> is not large enough for the
+-read then Perl will extend it to make room for the request.
+-
+- $fd = POSIX::open( "foo", &POSIX::O_RDONLY );
+- $bytes = POSIX::read( $fd, $buf, 3 );
+-
+-Returns C<undef> on failure.
+-
+-See also L<perlfunc/sysread>.
+-
+-=item readdir
+-
+-This is identical to Perl's builtin C<readdir()> function
+-for reading directory entries, see L<perlfunc/readdir>.
+-
+-=item realloc
+-
+-realloc() is C-specific. Perl does memory management transparently.
+-
+-=item remove
+-
+-This is identical to Perl's builtin C<unlink()> function
+-for removing files, see L<perlfunc/unlink>.
+-
+-=item rename
+-
+-This is identical to Perl's builtin C<rename()> function
+-for renaming files, see L<perlfunc/rename>.
+-
+-=item rewind
+-
+-Seeks to the beginning of the file.
+-
+-=item rewinddir
+-
+-This is identical to Perl's builtin C<rewinddir()> function for
+-rewinding directory entry streams, see L<perlfunc/rewinddir>.
+-
+-=item rmdir
+-
+-This is identical to Perl's builtin C<rmdir()> function
+-for removing (empty) directories, see L<perlfunc/rmdir>.
+-
+-=item scanf
+-
+-scanf() is C-specific, use E<lt>E<gt> and regular expressions instead,
+-see L<perlre>.
+-
+-=item setgid
+-
+-Sets the real group identifier and the effective group identifier for
+-this process. Similar to assigning a value to the Perl's builtin
+-C<$)> variable, see L<perlvar/$EGID>, except that the latter
+-will change only the real user identifier, and that the setgid()
+-uses only a single numeric argument, as opposed to a space-separated
+-list of numbers.
+-
+-=item setjmp
+-
+-C<setjmp()> is C-specific: use C<eval {}> instead,
+-see L<perlfunc/eval>.
+-
+-=item setlocale
+-
+-Modifies and queries program's locale. The following examples assume
+-
+- use POSIX qw(setlocale LC_ALL LC_CTYPE);
+-
+-has been issued.
+-
+-The following will set the traditional UNIX system locale behavior
+-(the second argument C<"C">).
+-
+- $loc = setlocale( LC_ALL, "C" );
+-
+-The following will query the current LC_CTYPE category. (No second
+-argument means 'query'.)
+-
+- $loc = setlocale( LC_CTYPE );
+-
+-The following will set the LC_CTYPE behaviour according to the locale
+-environment variables (the second argument C<"">).
+-Please see your systems C<setlocale(3)> documentation for the locale
+-environment variables' meaning or consult L<perllocale>.
+-
+- $loc = setlocale( LC_CTYPE, "" );
+-
+-The following will set the LC_COLLATE behaviour to Argentinian
+-Spanish. B<NOTE>: The naming and availability of locales depends on
+-your operating system. Please consult L<perllocale> for how to find
+-out which locales are available in your system.
+-
+- $loc = setlocale( LC_COLLATE, "es_AR.ISO8859-1" );
+-
+-=item setpgid
+-
+-This is similar to the C function C<setpgid()> for
+-setting the process group identifier of the current process.
+-
+-Returns C<undef> on failure.
+-
+-=item setsid
+-
+-This is identical to the C function C<setsid()> for
+-setting the session identifier of the current process.
+-
+-=item setuid
+-
+-Sets the real user identifier and the effective user identifier for
+-this process. Similar to assigning a value to the Perl's builtin
+-C<$E<lt>> variable, see L<perlvar/$UID>, except that the latter
+-will change only the real user identifier.
+-
+-=item sigaction
+-
+-Detailed signal management. This uses C<POSIX::SigAction> objects for
+-the C<action> and C<oldaction> arguments (the oldaction can also be
+-just a hash reference). Consult your system's C<sigaction> manpage
+-for details, see also C<POSIX::SigRt>.
+-
+-Synopsis:
+-
+- sigaction(signal, action, oldaction = 0)
+-
+-Returns C<undef> on failure. The C<signal> must be a number (like
+-SIGHUP), not a string (like "SIGHUP"), though Perl does try hard
+-to understand you.
+-
+-If you use the SA_SIGINFO flag, the signal handler will in addition to
+-the first argument, the signal name, also receive a second argument, a
+-hash reference, inside which are the following keys with the following
+-semantics, as defined by POSIX/SUSv3:
+-
+- signo the signal number
+- errno the error number
+- code if this is zero or less, the signal was sent by
+- a user process and the uid and pid make sense,
+- otherwise the signal was sent by the kernel
+-
+-The following are also defined by POSIX/SUSv3, but unfortunately
+-not very widely implemented:
+-
+- pid the process id generating the signal
+- uid the uid of the process id generating the signal
+- status exit value or signal for SIGCHLD
+- band band event for SIGPOLL
+-
+-A third argument is also passed to the handler, which contains a copy
+-of the raw binary contents of the siginfo structure: if a system has
+-some non-POSIX fields, this third argument is where to unpack() them
+-from.
+-
+-Note that not all siginfo values make sense simultaneously (some are
+-valid only for certain signals, for example), and not all values make
+-sense from Perl perspective, you should to consult your system's
+-C<sigaction> and possibly also C<siginfo> documentation.
+-
+-=item siglongjmp
+-
+-siglongjmp() is C-specific: use L<perlfunc/die> instead.
+-
+-=item sigpending
+-
+-Examine signals that are blocked and pending. This uses C<POSIX::SigSet>
+-objects for the C<sigset> argument. Consult your system's C<sigpending>
+-manpage for details.
+-
+-Synopsis:
+-
+- sigpending(sigset)
+-
+-Returns C<undef> on failure.
+-
+-=item sigprocmask
+-
+-Change and/or examine calling process's signal mask. This uses
+-C<POSIX::SigSet> objects for the C<sigset> and C<oldsigset> arguments.
+-Consult your system's C<sigprocmask> manpage for details.
+-
+-Synopsis:
+-
+- sigprocmask(how, sigset, oldsigset = 0)
+-
+-Returns C<undef> on failure.
+-
+-=item sigsetjmp
+-
+-C<sigsetjmp()> is C-specific: use C<eval {}> instead,
+-see L<perlfunc/eval>.
+-
+-=item sigsuspend
+-
+-Install a signal mask and suspend process until signal arrives. This uses
+-C<POSIX::SigSet> objects for the C<signal_mask> argument. Consult your
+-system's C<sigsuspend> manpage for details.
+-
+-Synopsis:
+-
+- sigsuspend(signal_mask)
+-
+-Returns C<undef> on failure.
+-
+-=item sin
+-
+-This is identical to Perl's builtin C<sin()> function
+-for returning the sine of the numerical argument,
+-see L<perlfunc/sin>. See also L<Math::Trig>.
+-
+-=item sinh
+-
+-This is identical to the C function C<sinh()>
+-for returning the hyperbolic sine of the numerical argument.
+-See also L<Math::Trig>.
+-
+-=item sleep
+-
+-This is functionally identical to Perl's builtin C<sleep()> function
+-for suspending the execution of the current for process for certain
+-number of seconds, see L<perlfunc/sleep>. There is one significant
+-difference, however: C<POSIX::sleep()> returns the number of
+-B<unslept> seconds, while the C<CORE::sleep()> returns the
+-number of slept seconds.
+-
+-=item sprintf
+-
+-This is similar to Perl's builtin C<sprintf()> function
+-for returning a string that has the arguments formatted as requested,
+-see L<perlfunc/sprintf>.
+-
+-=item sqrt
+-
+-This is identical to Perl's builtin C<sqrt()> function.
+-for returning the square root of the numerical argument,
+-see L<perlfunc/sqrt>.
+-
+-=item srand
+-
+-Give a seed the pseudorandom number generator, see L<perlfunc/srand>.
+-
+-=item sscanf
+-
+-sscanf() is C-specific, use regular expressions instead,
+-see L<perlre>.
+-
+-=item stat
+-
+-This is identical to Perl's builtin C<stat()> function
+-for returning information about files and directories.
+-
+-=item strcat
+-
+-strcat() is C-specific, use C<.=> instead, see L<perlop>.
+-
+-=item strchr
+-
+-strchr() is C-specific, see L<perlfunc/index> instead.
+-
+-=item strcmp
+-
+-strcmp() is C-specific, use C<eq> or C<cmp> instead, see L<perlop>.
+-
+-=item strcoll
+-
+-This is identical to the C function C<strcoll()>
+-for collating (comparing) strings transformed using
+-the C<strxfrm()> function. Not really needed since
+-Perl can do this transparently, see L<perllocale>.
+-
+-=item strcpy
+-
+-strcpy() is C-specific, use C<=> instead, see L<perlop>.
+-
+-=item strcspn
+-
+-strcspn() is C-specific, use regular expressions instead,
+-see L<perlre>.
+-
+-=item strerror
+-
+-Returns the error string for the specified errno.
+-Identical to the string form of the C<$!>, see L<perlvar/$ERRNO>.
+-
+-=item strftime
+-
+-Convert date and time information to string. Returns the string.
+-
+-Synopsis:
+-
+- strftime(fmt, sec, min, hour, mday, mon, year, wday = -1, yday = -1, isdst = -1)
+-
+-The month (C<mon>), weekday (C<wday>), and yearday (C<yday>) begin at zero.
+-I.e. January is 0, not 1; Sunday is 0, not 1; January 1st is 0, not 1. The
+-year (C<year>) is given in years since 1900. I.e., the year 1995 is 95; the
+-year 2001 is 101. Consult your system's C<strftime()> manpage for details
+-about these and the other arguments.
+-
+-If you want your code to be portable, your format (C<fmt>) argument
+-should use only the conversion specifiers defined by the ANSI C
+-standard (C89, to play safe). These are C<aAbBcdHIjmMpSUwWxXyYZ%>.
+-But even then, the B<results> of some of the conversion specifiers are
+-non-portable. For example, the specifiers C<aAbBcpZ> change according
+-to the locale settings of the user, and both how to set locales (the
+-locale names) and what output to expect are non-standard.
+-The specifier C<c> changes according to the timezone settings of the
+-user and the timezone computation rules of the operating system.
+-The C<Z> specifier is notoriously unportable since the names of
+-timezones are non-standard. Sticking to the numeric specifiers is the
+-safest route.
+-
+-The given arguments are made consistent as though by calling
+-C<mktime()> before calling your system's C<strftime()> function,
+-except that the C<isdst> value is not affected.
+-
+-The string for Tuesday, December 12, 1995.
+-
+- $str = POSIX::strftime( "%A, %B %d, %Y", 0, 0, 0, 12, 11, 95, 2 );
+- print "$str\n";
+-
+-=item strlen
+-
+-strlen() is C-specific, use C<length()> instead, see L<perlfunc/length>.
+-
+-=item strncat
+-
+-strncat() is C-specific, use C<.=> instead, see L<perlop>.
+-
+-=item strncmp
+-
+-strncmp() is C-specific, use C<eq> instead, see L<perlop>.
+-
+-=item strncpy
+-
+-strncpy() is C-specific, use C<=> instead, see L<perlop>.
+-
+-=item strpbrk
+-
+-strpbrk() is C-specific, use regular expressions instead,
+-see L<perlre>.
+-
+-=item strrchr
+-
+-strrchr() is C-specific, see L<perlfunc/rindex> instead.
+-
+-=item strspn
+-
+-strspn() is C-specific, use regular expressions instead,
+-see L<perlre>.
+-
+-=item strstr
+-
+-This is identical to Perl's builtin C<index()> function,
+-see L<perlfunc/index>.
+-
+-=item strtod
+-
+-String to double translation. Returns the parsed number and the number
+-of characters in the unparsed portion of the string. Truly
+-POSIX-compliant systems set $! ($ERRNO) to indicate a translation
+-error, so clear $! before calling strtod. However, non-POSIX systems
+-may not check for overflow, and therefore will never set $!.
+-
+-strtod should respect any POSIX I<setlocale()> settings.
+-
+-To parse a string $str as a floating point number use
+-
+- $! = 0;
+- ($num, $n_unparsed) = POSIX::strtod($str);
+-
+-The second returned item and $! can be used to check for valid input:
+-
+- if (($str eq '') || ($n_unparsed != 0) || $!) {
+- die "Non-numeric input $str" . ($! ? ": $!\n" : "\n");
+- }
+-
+-When called in a scalar context strtod returns the parsed number.
+-
+-=item strtok
+-
+-strtok() is C-specific, use regular expressions instead, see
+-L<perlre>, or L<perlfunc/split>.
+-
+-=item strtol
+-
+-String to (long) integer translation. Returns the parsed number and
+-the number of characters in the unparsed portion of the string. Truly
+-POSIX-compliant systems set $! ($ERRNO) to indicate a translation
+-error, so clear $! before calling strtol. However, non-POSIX systems
+-may not check for overflow, and therefore will never set $!.
+-
+-strtol should respect any POSIX I<setlocale()> settings.
+-
+-To parse a string $str as a number in some base $base use
+-
+- $! = 0;
+- ($num, $n_unparsed) = POSIX::strtol($str, $base);
+-
+-The base should be zero or between 2 and 36, inclusive. When the base
+-is zero or omitted strtol will use the string itself to determine the
+-base: a leading "0x" or "0X" means hexadecimal; a leading "0" means
+-octal; any other leading characters mean decimal. Thus, "1234" is
+-parsed as a decimal number, "01234" as an octal number, and "0x1234"
+-as a hexadecimal number.
+-
+-The second returned item and $! can be used to check for valid input:
+-
+- if (($str eq '') || ($n_unparsed != 0) || !$!) {
+- die "Non-numeric input $str" . $! ? ": $!\n" : "\n";
+- }
+-
+-When called in a scalar context strtol returns the parsed number.
+-
+-=item strtoul
+-
+-String to unsigned (long) integer translation. strtoul() is identical
+-to strtol() except that strtoul() only parses unsigned integers. See
+-L</strtol> for details.
+-
+-Note: Some vendors supply strtod() and strtol() but not strtoul().
+-Other vendors that do supply strtoul() parse "-1" as a valid value.
+-
+-=item strxfrm
+-
+-String transformation. Returns the transformed string.
+-
+- $dst = POSIX::strxfrm( $src );
+-
+-Used in conjunction with the C<strcoll()> function, see L</strcoll>.
+-
+-Not really needed since Perl can do this transparently, see
+-L<perllocale>.
+-
+-=item sysconf
+-
+-Retrieves values of system configurable variables.
+-
+-The following will get the machine's clock speed.
+-
+- $clock_ticks = POSIX::sysconf( &POSIX::_SC_CLK_TCK );
+-
+-Returns C<undef> on failure.
+-
+-=item system
+-
+-This is identical to Perl's builtin C<system()> function, see
+-L<perlfunc/system>.
+-
+-=item tan
+-
+-This is identical to the C function C<tan()>, returning the
+-tangent of the numerical argument. See also L<Math::Trig>.
+-
+-=item tanh
+-
+-This is identical to the C function C<tanh()>, returning the
+-hyperbolic tangent of the numerical argument. See also L<Math::Trig>.
+-
+-=item tcdrain
+-
+-This is similar to the C function C<tcdrain()> for draining
+-the output queue of its argument stream.
+-
+-Returns C<undef> on failure.
+-
+-=item tcflow
+-
+-This is similar to the C function C<tcflow()> for controlling
+-the flow of its argument stream.
+-
+-Returns C<undef> on failure.
+-
+-=item tcflush
+-
+-This is similar to the C function C<tcflush()> for flushing
+-the I/O buffers of its argument stream.
+-
+-Returns C<undef> on failure.
+-
+-=item tcgetpgrp
+-
+-This is identical to the C function C<tcgetpgrp()> for returning the
+-process group identifier of the foreground process group of the controlling
+-terminal.
+-
+-=item tcsendbreak
+-
+-This is similar to the C function C<tcsendbreak()> for sending
+-a break on its argument stream.
+-
+-Returns C<undef> on failure.
+-
+-=item tcsetpgrp
+-
+-This is similar to the C function C<tcsetpgrp()> for setting the
+-process group identifier of the foreground process group of the controlling
+-terminal.
+-
+-Returns C<undef> on failure.
+-
+-=item time
+-
+-This is identical to Perl's builtin C<time()> function
+-for returning the number of seconds since the epoch
+-(whatever it is for the system), see L<perlfunc/time>.
+-
+-=item times
+-
+-The times() function returns elapsed realtime since some point in the past
+-(such as system startup), user and system times for this process, and user
+-and system times used by child processes. All times are returned in clock
+-ticks.
+-
+- ($realtime, $user, $system, $cuser, $csystem) = POSIX::times();
+-
+-Note: Perl's builtin C<times()> function returns four values, measured in
+-seconds.
+-
+-=item tmpfile
+-
+-Use method C<IO::File::new_tmpfile()> instead, or see L<File::Temp>.
+-
+-=item tmpnam
+-
+-Returns a name for a temporary file.
+-
+- $tmpfile = POSIX::tmpnam();
+-
+-For security reasons, which are probably detailed in your system's
+-documentation for the C library tmpnam() function, this interface
+-should not be used; instead see L<File::Temp>.
+-
+-=item tolower
+-
+-This is identical to the C function, except that it can apply to a single
+-character or to a whole string. Consider using the C<lc()> function,
+-see L<perlfunc/lc>, or the equivalent C<\L> operator inside doublequotish
+-strings.
+-
+-=item toupper
+-
+-This is identical to the C function, except that it can apply to a single
+-character or to a whole string. Consider using the C<uc()> function,
+-see L<perlfunc/uc>, or the equivalent C<\U> operator inside doublequotish
+-strings.
+-
+-=item ttyname
+-
+-This is identical to the C function C<ttyname()> for returning the
+-name of the current terminal.
+-
+-=item tzname
+-
+-Retrieves the time conversion information from the C<tzname> variable.
+-
+- POSIX::tzset();
+- ($std, $dst) = POSIX::tzname();
+-
+-=item tzset
+-
+-This is identical to the C function C<tzset()> for setting
+-the current timezone based on the environment variable C<TZ>,
+-to be used by C<ctime()>, C<localtime()>, C<mktime()>, and C<strftime()>
+-functions.
+-
+-=item umask
+-
+-This is identical to Perl's builtin C<umask()> function
+-for setting (and querying) the file creation permission mask,
+-see L<perlfunc/umask>.
+-
+-=item uname
+-
+-Get name of current operating system.
+-
+- ($sysname, $nodename, $release, $version, $machine) = POSIX::uname();
+-
+-Note that the actual meanings of the various fields are not
+-that well standardized, do not expect any great portability.
+-The C<$sysname> might be the name of the operating system,
+-the C<$nodename> might be the name of the host, the C<$release>
+-might be the (major) release number of the operating system,
+-the C<$version> might be the (minor) release number of the
+-operating system, and the C<$machine> might be a hardware identifier.
+-Maybe.
+-
+-=item ungetc
+-
+-Use method C<IO::Handle::ungetc()> instead.
+-
+-=item unlink
+-
+-This is identical to Perl's builtin C<unlink()> function
+-for removing files, see L<perlfunc/unlink>.
+-
+-=item utime
+-
+-This is identical to Perl's builtin C<utime()> function
+-for changing the time stamps of files and directories,
+-see L<perlfunc/utime>.
+-
+-=item vfprintf
+-
+-vfprintf() is C-specific, see L<perlfunc/printf> instead.
+-
+-=item vprintf
+-
+-vprintf() is C-specific, see L<perlfunc/printf> instead.
+-
+-=item vsprintf
+-
+-vsprintf() is C-specific, see L<perlfunc/sprintf> instead.
+-
+-=item wait
+-
+-This is identical to Perl's builtin C<wait()> function,
+-see L<perlfunc/wait>.
+-
+-=item waitpid
+-
+-Wait for a child process to change state. This is identical to Perl's
+-builtin C<waitpid()> function, see L<perlfunc/waitpid>.
+-
+- $pid = POSIX::waitpid( -1, POSIX::WNOHANG );
+- print "status = ", ($? / 256), "\n";
+-
+-=item wcstombs
+-
+-This is identical to the C function C<wcstombs()>.
+-Perl does not have any support for the wide and multibyte
+-characters of the C standards, so this might be a rather
+-useless function.
+-
+-=item wctomb
+-
+-This is identical to the C function C<wctomb()>.
+-Perl does not have any support for the wide and multibyte
+-characters of the C standards, so this might be a rather
+-useless function.
+-
+-=item write
+-
+-Write to a file. This uses file descriptors such as those obtained by
+-calling C<POSIX::open>.
+-
+- $fd = POSIX::open( "foo", &POSIX::O_WRONLY );
+- $buf = "hello";
+- $bytes = POSIX::write( $fd, $buf, 5 );
+-
+-Returns C<undef> on failure.
+-
+-See also L<perlfunc/syswrite>.
+-
+-=back
+-
+-=head1 CLASSES
+-
+-=head2 POSIX::SigAction
+-
+-=over 8
+-
+-=item new
+-
+-Creates a new C<POSIX::SigAction> object which corresponds to the C
+-C<struct sigaction>. This object will be destroyed automatically when
+-it is no longer needed. The first parameter is the handler, a sub
+-reference. The second parameter is a C<POSIX::SigSet> object, it
+-defaults to the empty set. The third parameter contains the
+-C<sa_flags>, it defaults to 0.
+-
+- $sigset = POSIX::SigSet->new(SIGINT, SIGQUIT);
+- $sigaction = POSIX::SigAction->new( \&handler, $sigset, &POSIX::SA_NOCLDSTOP );
+-
+-This C<POSIX::SigAction> object is intended for use with the C<POSIX::sigaction()>
+-function.
+-
+-=back
+-
+-=over 8
+-
+-=item handler
+-
+-=item mask
+-
+-=item flags
+-
+-accessor functions to get/set the values of a SigAction object.
+-
+- $sigset = $sigaction->mask;
+- $sigaction->flags(&POSIX::SA_RESTART);
+-
+-=item safe
+-
+-accessor function for the "safe signals" flag of a SigAction object; see
+-L<perlipc> for general information on safe (a.k.a. "deferred") signals. If
+-you wish to handle a signal safely, use this accessor to set the "safe" flag
+-in the C<POSIX::SigAction> object:
+-
+- $sigaction->safe(1);
+-
+-You may also examine the "safe" flag on the output action object which is
+-filled in when given as the third parameter to C<POSIX::sigaction()>:
+-
+- sigaction(SIGINT, $new_action, $old_action);
+- if ($old_action->safe) {
+- # previous SIGINT handler used safe signals
+- }
+-
+-=back
+-
+-=head2 POSIX::SigRt
+-
+-=over 8
+-
+-=item %SIGRT
+-
+-A hash of the POSIX realtime signal handlers. It is an extension of
+-the standard %SIG, the $POSIX::SIGRT{SIGRTMIN} is roughly equivalent
+-to $SIG{SIGRTMIN}, but the right POSIX moves (see below) are made with
+-the POSIX::SigSet and POSIX::sigaction instead of accessing the %SIG.
+-
+-You can set the %POSIX::SIGRT elements to set the POSIX realtime
+-signal handlers, use C<delete> and C<exists> on the elements, and use
+-C<scalar> on the C<%POSIX::SIGRT> to find out how many POSIX realtime
+-signals there are available (SIGRTMAX - SIGRTMIN + 1, the SIGRTMAX is
+-a valid POSIX realtime signal).
+-
+-Setting the %SIGRT elements is equivalent to calling this:
+-
+- sub new {
+- my ($rtsig, $handler, $flags) = @_;
+- my $sigset = POSIX::SigSet($rtsig);
+- my $sigact = POSIX::SigAction->new($handler, $sigset, $flags);
+- sigaction($rtsig, $sigact);
+- }
+-
+-The flags default to zero, if you want something different you can
+-either use C<local> on $POSIX::SigRt::SIGACTION_FLAGS, or you can
+-derive from POSIX::SigRt and define your own C<new()> (the tied hash
+-STORE method of the %SIGRT calls C<new($rtsig, $handler, $SIGACTION_FLAGS)>,
+-where the $rtsig ranges from zero to SIGRTMAX - SIGRTMIN + 1).
+-
+-Just as with any signal, you can use sigaction($rtsig, undef, $oa) to
+-retrieve the installed signal handler (or, rather, the signal action).
+-
+-B<NOTE:> whether POSIX realtime signals really work in your system, or
+-whether Perl has been compiled so that it works with them, is outside
+-of this discussion.
+-
+-=item SIGRTMIN
+-
+-Return the minimum POSIX realtime signal number available, or C<undef>
+-if no POSIX realtime signals are available.
+-
+-=item SIGRTMAX
+-
+-Return the maximum POSIX realtime signal number available, or C<undef>
+-if no POSIX realtime signals are available.
+-
+-=back
+-
+-=head2 POSIX::SigSet
+-
+-=over 8
+-
+-=item new
+-
+-Create a new SigSet object. This object will be destroyed automatically
+-when it is no longer needed. Arguments may be supplied to initialize the
+-set.
+-
+-Create an empty set.
+-
+- $sigset = POSIX::SigSet->new;
+-
+-Create a set with SIGUSR1.
+-
+- $sigset = POSIX::SigSet->new( &POSIX::SIGUSR1 );
+-
+-=item addset
+-
+-Add a signal to a SigSet object.
+-
+- $sigset->addset( &POSIX::SIGUSR2 );
+-
+-Returns C<undef> on failure.
+-
+-=item delset
+-
+-Remove a signal from the SigSet object.
+-
+- $sigset->delset( &POSIX::SIGUSR2 );
+-
+-Returns C<undef> on failure.
+-
+-=item emptyset
+-
+-Initialize the SigSet object to be empty.
+-
+- $sigset->emptyset();
+-
+-Returns C<undef> on failure.
+-
+-=item fillset
+-
+-Initialize the SigSet object to include all signals.
+-
+- $sigset->fillset();
+-
+-Returns C<undef> on failure.
+-
+-=item ismember
+-
+-Tests the SigSet object to see if it contains a specific signal.
+-
+- if( $sigset->ismember( &POSIX::SIGUSR1 ) ){
+- print "contains SIGUSR1\n";
+- }
+-
+-=back
+-
+-=head2 POSIX::Termios
+-
+-=over 8
+-
+-=item new
+-
+-Create a new Termios object. This object will be destroyed automatically
+-when it is no longer needed. A Termios object corresponds to the termios
+-C struct. new() mallocs a new one, getattr() fills it from a file descriptor,
+-and setattr() sets a file descriptor's parameters to match Termios' contents.
+-
+- $termios = POSIX::Termios->new;
+-
+-=item getattr
+-
+-Get terminal control attributes.
+-
+-Obtain the attributes for stdin.
+-
+- $termios->getattr( 0 ) # Recommended for clarity.
+- $termios->getattr()
+-
+-Obtain the attributes for stdout.
+-
+- $termios->getattr( 1 )
+-
+-Returns C<undef> on failure.
+-
+-=item getcc
+-
+-Retrieve a value from the c_cc field of a termios object. The c_cc field is
+-an array so an index must be specified.
+-
+- $c_cc[1] = $termios->getcc(1);
+-
+-=item getcflag
+-
+-Retrieve the c_cflag field of a termios object.
+-
+- $c_cflag = $termios->getcflag;
+-
+-=item getiflag
+-
+-Retrieve the c_iflag field of a termios object.
+-
+- $c_iflag = $termios->getiflag;
+-
+-=item getispeed
+-
+-Retrieve the input baud rate.
+-
+- $ispeed = $termios->getispeed;
+-
+-=item getlflag
+-
+-Retrieve the c_lflag field of a termios object.
+-
+- $c_lflag = $termios->getlflag;
+-
+-=item getoflag
+-
+-Retrieve the c_oflag field of a termios object.
+-
+- $c_oflag = $termios->getoflag;
+-
+-=item getospeed
+-
+-Retrieve the output baud rate.
+-
+- $ospeed = $termios->getospeed;
+-
+-=item setattr
+-
+-Set terminal control attributes.
+-
+-Set attributes immediately for stdout.
+-
+- $termios->setattr( 1, &POSIX::TCSANOW );
+-
+-Returns C<undef> on failure.
+-
+-=item setcc
+-
+-Set a value in the c_cc field of a termios object. The c_cc field is an
+-array so an index must be specified.
+-
+- $termios->setcc( &POSIX::VEOF, 1 );
+-
+-=item setcflag
+-
+-Set the c_cflag field of a termios object.
+-
+- $termios->setcflag( $c_cflag | &POSIX::CLOCAL );
+-
+-=item setiflag
+-
+-Set the c_iflag field of a termios object.
+-
+- $termios->setiflag( $c_iflag | &POSIX::BRKINT );
+-
+-=item setispeed
+-
+-Set the input baud rate.
+-
+- $termios->setispeed( &POSIX::B9600 );
+-
+-Returns C<undef> on failure.
+-
+-=item setlflag
+-
+-Set the c_lflag field of a termios object.
+-
+- $termios->setlflag( $c_lflag | &POSIX::ECHO );
+-
+-=item setoflag
+-
+-Set the c_oflag field of a termios object.
+-
+- $termios->setoflag( $c_oflag | &POSIX::OPOST );
+-
+-=item setospeed
+-
+-Set the output baud rate.
+-
+- $termios->setospeed( &POSIX::B9600 );
+-
+-Returns C<undef> on failure.
+-
+-=item Baud rate values
+-
+-B38400 B75 B200 B134 B300 B1800 B150 B0 B19200 B1200 B9600 B600 B4800 B50 B2400 B110
+-
+-=item Terminal interface values
+-
+-TCSADRAIN TCSANOW TCOON TCIOFLUSH TCOFLUSH TCION TCIFLUSH TCSAFLUSH TCIOFF TCOOFF
+-
+-=item c_cc field values
+-
+-VEOF VEOL VERASE VINTR VKILL VQUIT VSUSP VSTART VSTOP VMIN VTIME NCCS
+-
+-=item c_cflag field values
+-
+-CLOCAL CREAD CSIZE CS5 CS6 CS7 CS8 CSTOPB HUPCL PARENB PARODD
+-
+-=item c_iflag field values
+-
+-BRKINT ICRNL IGNBRK IGNCR IGNPAR INLCR INPCK ISTRIP IXOFF IXON PARMRK
+-
+-=item c_lflag field values
+-
+-ECHO ECHOE ECHOK ECHONL ICANON IEXTEN ISIG NOFLSH TOSTOP
+-
+-=item c_oflag field values
+-
+-OPOST
+-
+-=back
+-
+-=head1 PATHNAME CONSTANTS
+-
+-=over 8
+-
+-=item Constants
+-
+-_PC_CHOWN_RESTRICTED _PC_LINK_MAX _PC_MAX_CANON _PC_MAX_INPUT _PC_NAME_MAX _PC_NO_TRUNC _PC_PATH_MAX _PC_PIPE_BUF _PC_VDISABLE
+-
+-=back
+-
+-=head1 POSIX CONSTANTS
+-
+-=over 8
+-
+-=item Constants
+-
+-_POSIX_ARG_MAX _POSIX_CHILD_MAX _POSIX_CHOWN_RESTRICTED _POSIX_JOB_CONTROL _POSIX_LINK_MAX _POSIX_MAX_CANON _POSIX_MAX_INPUT _POSIX_NAME_MAX _POSIX_NGROUPS_MAX _POSIX_NO_TRUNC _POSIX_OPEN_MAX _POSIX_PATH_MAX _POSIX_PIPE_BUF _POSIX_SAVED_IDS _POSIX_SSIZE_MAX _POSIX_STREAM_MAX _POSIX_TZNAME_MAX _POSIX_VDISABLE _POSIX_VERSION
+-
+-=back
+-
+-=head1 SYSTEM CONFIGURATION
+-
+-=over 8
+-
+-=item Constants
+-
+-_SC_ARG_MAX _SC_CHILD_MAX _SC_CLK_TCK _SC_JOB_CONTROL _SC_NGROUPS_MAX _SC_OPEN_MAX _SC_PAGESIZE _SC_SAVED_IDS _SC_STREAM_MAX _SC_TZNAME_MAX _SC_VERSION
+-
+-=back
+-
+-=head1 ERRNO
+-
+-=over 8
+-
+-=item Constants
+-
+-E2BIG EACCES EADDRINUSE EADDRNOTAVAIL EAFNOSUPPORT EAGAIN EALREADY EBADF
+-EBUSY ECHILD ECONNABORTED ECONNREFUSED ECONNRESET EDEADLK EDESTADDRREQ
+-EDOM EDQUOT EEXIST EFAULT EFBIG EHOSTDOWN EHOSTUNREACH EINPROGRESS EINTR
+-EINVAL EIO EISCONN EISDIR ELOOP EMFILE EMLINK EMSGSIZE ENAMETOOLONG
+-ENETDOWN ENETRESET ENETUNREACH ENFILE ENOBUFS ENODEV ENOENT ENOEXEC
+-ENOLCK ENOMEM ENOPROTOOPT ENOSPC ENOSYS ENOTBLK ENOTCONN ENOTDIR
+-ENOTEMPTY ENOTSOCK ENOTTY ENXIO EOPNOTSUPP EPERM EPFNOSUPPORT EPIPE
+-EPROCLIM EPROTONOSUPPORT EPROTOTYPE ERANGE EREMOTE ERESTART EROFS
+-ESHUTDOWN ESOCKTNOSUPPORT ESPIPE ESRCH ESTALE ETIMEDOUT ETOOMANYREFS
+-ETXTBSY EUSERS EWOULDBLOCK EXDEV
+-
+-=back
+-
+-=head1 FCNTL
+-
+-=over 8
+-
+-=item Constants
+-
+-FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_OK F_RDLCK F_SETFD F_SETFL F_SETLK F_SETLKW F_UNLCK F_WRLCK O_ACCMODE O_APPEND O_CREAT O_EXCL O_NOCTTY O_NONBLOCK O_RDONLY O_RDWR O_TRUNC O_WRONLY
+-
+-=back
+-
+-=head1 FLOAT
+-
+-=over 8
+-
+-=item Constants
+-
+-DBL_DIG DBL_EPSILON DBL_MANT_DIG DBL_MAX DBL_MAX_10_EXP DBL_MAX_EXP DBL_MIN DBL_MIN_10_EXP DBL_MIN_EXP FLT_DIG FLT_EPSILON FLT_MANT_DIG FLT_MAX FLT_MAX_10_EXP FLT_MAX_EXP FLT_MIN FLT_MIN_10_EXP FLT_MIN_EXP FLT_RADIX FLT_ROUNDS LDBL_DIG LDBL_EPSILON LDBL_MANT_DIG LDBL_MAX LDBL_MAX_10_EXP LDBL_MAX_EXP LDBL_MIN LDBL_MIN_10_EXP LDBL_MIN_EXP
+-
+-=back
+-
+-=head1 LIMITS
+-
+-=over 8
+-
+-=item Constants
+-
+-ARG_MAX CHAR_BIT CHAR_MAX CHAR_MIN CHILD_MAX INT_MAX INT_MIN LINK_MAX LONG_MAX LONG_MIN MAX_CANON MAX_INPUT MB_LEN_MAX NAME_MAX NGROUPS_MAX OPEN_MAX PATH_MAX PIPE_BUF SCHAR_MAX SCHAR_MIN SHRT_MAX SHRT_MIN SSIZE_MAX STREAM_MAX TZNAME_MAX UCHAR_MAX UINT_MAX ULONG_MAX USHRT_MAX
+-
+-=back
+-
+-=head1 LOCALE
+-
+-=over 8
+-
+-=item Constants
+-
+-LC_ALL LC_COLLATE LC_CTYPE LC_MONETARY LC_NUMERIC LC_TIME
+-
+-=back
+-
+-=head1 MATH
+-
+-=over 8
+-
+-=item Constants
+-
+-HUGE_VAL
+-
+-=back
+-
+-=head1 SIGNAL
+-
+-=over 8
+-
+-=item Constants
+-
+-SA_NOCLDSTOP SA_NOCLDWAIT SA_NODEFER SA_ONSTACK SA_RESETHAND SA_RESTART
+-SA_SIGINFO SIGABRT SIGALRM SIGCHLD SIGCONT SIGFPE SIGHUP SIGILL SIGINT
+-SIGKILL SIGPIPE SIGQUIT SIGSEGV SIGSTOP SIGTERM SIGTSTP SIGTTIN SIGTTOU
+-SIGUSR1 SIGUSR2 SIG_BLOCK SIG_DFL SIG_ERR SIG_IGN SIG_SETMASK
+-SIG_UNBLOCK
+-
+-=back
+-
+-=head1 STAT
+-
+-=over 8
+-
+-=item Constants
+-
+-S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU S_ISGID S_ISUID S_IWGRP S_IWOTH S_IWUSR S_IXGRP S_IXOTH S_IXUSR
+-
+-=item Macros
+-
+-S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISREG
+-
+-=back
+-
+-=head1 STDLIB
+-
+-=over 8
+-
+-=item Constants
+-
+-EXIT_FAILURE EXIT_SUCCESS MB_CUR_MAX RAND_MAX
+-
+-=back
+-
+-=head1 STDIO
+-
+-=over 8
+-
+-=item Constants
+-
+-BUFSIZ EOF FILENAME_MAX L_ctermid L_cuserid L_tmpname TMP_MAX
+-
+-=back
+-
+-=head1 TIME
+-
+-=over 8
+-
+-=item Constants
+-
+-CLK_TCK CLOCKS_PER_SEC
+-
+-=back
+-
+-=head1 UNISTD
+-
+-=over 8
+-
+-=item Constants
+-
+-R_OK SEEK_CUR SEEK_END SEEK_SET STDIN_FILENO STDOUT_FILENO STDERR_FILENO W_OK X_OK
+-
+-=back
+-
+-=head1 WAIT
+-
+-=over 8
+-
+-=item Constants
+-
+-WNOHANG WUNTRACED
+-
+-=over 16
+-
+-=item WNOHANG
+-
+-Do not suspend the calling process until a child process
+-changes state but instead return immediately.
+-
+-=item WUNTRACED
+-
+-Catch stopped child processes.
+-
+-=back
+-
+-=item Macros
+-
+-WIFEXITED WEXITSTATUS WIFSIGNALED WTERMSIG WIFSTOPPED WSTOPSIG
+-
+-=over 16
+-
+-=item WIFEXITED
+-
+-WIFEXITED($?) returns true if the child process exited normally
+-(C<exit()> or by falling off the end of C<main()>)
+-
+-=item WEXITSTATUS
+-
+-WEXITSTATUS($?) returns the normal exit status of the child process
+-(only meaningful if WIFEXITED($?) is true)
+-
+-=item WIFSIGNALED
+-
+-WIFSIGNALED($?) returns true if the child process terminated because
+-of a signal
+-
+-=item WTERMSIG
+-
+-WTERMSIG($?) returns the signal the child process terminated for
+-(only meaningful if WIFSIGNALED($?) is true)
+-
+-=item WIFSTOPPED
+-
+-WIFSTOPPED($?) returns true if the child process is currently stopped
+-(can happen only if you specified the WUNTRACED flag to waitpid())
+-
+-=item WSTOPSIG
+-
+-WSTOPSIG($?) returns the signal the child process was stopped for
+-(only meaningful if WIFSTOPPED($?) is true)
+-
+-=back
+-
+-=back
+-
+diff --git a/ext/POSIX/lib/POSIX.pm b/ext/POSIX/lib/POSIX.pm
+new file mode 100644
+index 0000000..ffbd9de
+--- /dev/null
++++ b/ext/POSIX/lib/POSIX.pm
+@@ -0,0 +1,1042 @@
++package POSIX;
++use strict;
++use warnings;
++
++our(@ISA, %EXPORT_TAGS, @EXPORT_OK, @EXPORT, $AUTOLOAD, %SIGRT) = ();
++
++our $VERSION = "1.19";
++
++use AutoLoader;
++
++use XSLoader ();
++
++use Fcntl qw(FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_RDLCK F_SETFD
++ F_SETFL F_SETLK F_SETLKW F_UNLCK F_WRLCK O_ACCMODE O_APPEND
++ O_CREAT O_EXCL O_NOCTTY O_NONBLOCK O_RDONLY O_RDWR O_TRUNC
++ O_WRONLY SEEK_CUR SEEK_END SEEK_SET
++ S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISREG
++ S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU S_ISGID S_ISUID
++ S_IWGRP S_IWOTH S_IWUSR S_IXGRP S_IXOTH S_IXUSR);
++
++# Grandfather old foo_h form to new :foo_h form
++my $loaded;
++
++sub import {
++ load_imports() unless $loaded++;
++ my $this = shift;
++ my @list = map { m/^\w+_h$/ ? ":$_" : $_ } @_;
++ local $Exporter::ExportLevel = 1;
++ Exporter::import($this,@list);
++}
++
++sub croak { require Carp; goto &Carp::croak }
++# declare usage to assist AutoLoad
++sub usage;
++
++XSLoader::load 'POSIX', $VERSION;
++
++sub AUTOLOAD {
++ no strict;
++ no warnings 'uninitialized';
++ if ($AUTOLOAD =~ /::(_?[a-z])/) {
++ # require AutoLoader;
++ $AutoLoader::AUTOLOAD = $AUTOLOAD;
++ goto &AutoLoader::AUTOLOAD
++ }
++ local $! = 0;
++ my $constname = $AUTOLOAD;
++ $constname =~ s/.*:://;
++ my ($error, $val) = constant($constname);
++ croak $error if $error;
++ *$AUTOLOAD = sub { $val };
++
++ goto &$AUTOLOAD;
++}
++
++package POSIX::SigAction;
++
++use AutoLoader 'AUTOLOAD';
++
++package POSIX::SigRt;
++
++use AutoLoader 'AUTOLOAD';
++
++use Tie::Hash;
++
++use vars qw($SIGACTION_FLAGS $_SIGRTMIN $_SIGRTMAX $_sigrtn @ISA);
++@POSIX::SigRt::ISA = qw(Tie::StdHash);
++
++$SIGACTION_FLAGS = 0;
++
++tie %POSIX::SIGRT, 'POSIX::SigRt';
++
++sub DESTROY {};
++
++package POSIX;
++
++1;
++__END__
++
++sub usage {
++ my ($mess) = @_;
++ croak "Usage: POSIX::$mess";
++}
++
++sub redef {
++ my ($mess) = @_;
++ croak "Use method $mess instead";
++}
++
++sub unimpl {
++ my ($mess) = @_;
++ $mess =~ s/xxx//;
++ croak "Unimplemented: POSIX::$mess";
++}
++
++sub assert {
++ usage "assert(expr)" if @_ != 1;
++ if (!$_[0]) {
++ croak "Assertion failed";
++ }
++}
++
++sub tolower {
++ usage "tolower(string)" if @_ != 1;
++ lc($_[0]);
++}
++
++sub toupper {
++ usage "toupper(string)" if @_ != 1;
++ uc($_[0]);
++}
++
++sub closedir {
++ usage "closedir(dirhandle)" if @_ != 1;
++ CORE::closedir($_[0]);
++}
++
++sub opendir {
++ usage "opendir(directory)" if @_ != 1;
++ my $dirhandle;
++ CORE::opendir($dirhandle, $_[0])
++ ? $dirhandle
++ : undef;
++}
++
++sub readdir {
++ usage "readdir(dirhandle)" if @_ != 1;
++ CORE::readdir($_[0]);
++}
++
++sub rewinddir {
++ usage "rewinddir(dirhandle)" if @_ != 1;
++ CORE::rewinddir($_[0]);
++}
++
++sub errno {
++ usage "errno()" if @_ != 0;
++ $! + 0;
++}
++
++sub creat {
++ usage "creat(filename, mode)" if @_ != 2;
++ &open($_[0], &O_WRONLY | &O_CREAT | &O_TRUNC, $_[1]);
++}
++
++sub fcntl {
++ usage "fcntl(filehandle, cmd, arg)" if @_ != 3;
++ CORE::fcntl($_[0], $_[1], $_[2]);
++}
++
++sub getgrgid {
++ usage "getgrgid(gid)" if @_ != 1;
++ CORE::getgrgid($_[0]);
++}
++
++sub getgrnam {
++ usage "getgrnam(name)" if @_ != 1;
++ CORE::getgrnam($_[0]);
++}
++
++sub atan2 {
++ usage "atan2(x,y)" if @_ != 2;
++ CORE::atan2($_[0], $_[1]);
++}
++
++sub cos {
++ usage "cos(x)" if @_ != 1;
++ CORE::cos($_[0]);
++}
++
++sub exp {
++ usage "exp(x)" if @_ != 1;
++ CORE::exp($_[0]);
++}
++
++sub fabs {
++ usage "fabs(x)" if @_ != 1;
++ CORE::abs($_[0]);
++}
++
++sub log {
++ usage "log(x)" if @_ != 1;
++ CORE::log($_[0]);
++}
++
++sub pow {
++ usage "pow(x,exponent)" if @_ != 2;
++ $_[0] ** $_[1];
++}
++
++sub sin {
++ usage "sin(x)" if @_ != 1;
++ CORE::sin($_[0]);
++}
++
++sub sqrt {
++ usage "sqrt(x)" if @_ != 1;
++ CORE::sqrt($_[0]);
++}
++
++sub getpwnam {
++ usage "getpwnam(name)" if @_ != 1;
++ CORE::getpwnam($_[0]);
++}
++
++sub getpwuid {
++ usage "getpwuid(uid)" if @_ != 1;
++ CORE::getpwuid($_[0]);
++}
++
++sub longjmp {
++ unimpl "longjmp() is C-specific: use die instead";
++}
++
++sub setjmp {
++ unimpl "setjmp() is C-specific: use eval {} instead";
++}
++
++sub siglongjmp {
++ unimpl "siglongjmp() is C-specific: use die instead";
++}
++
++sub sigsetjmp {
++ unimpl "sigsetjmp() is C-specific: use eval {} instead";
++}
++
++sub kill {
++ usage "kill(pid, sig)" if @_ != 2;
++ CORE::kill $_[1], $_[0];
++}
++
++sub raise {
++ usage "raise(sig)" if @_ != 1;
++ CORE::kill $_[0], $$; # Is this good enough?
++}
++
++sub offsetof {
++ unimpl "offsetof() is C-specific, stopped";
++}
++
++sub clearerr {
++ redef "IO::Handle::clearerr()";
++}
++
++sub fclose {
++ redef "IO::Handle::close()";
++}
++
++sub fdopen {
++ redef "IO::Handle::new_from_fd()";
++}
++
++sub feof {
++ redef "IO::Handle::eof()";
++}
++
++sub fgetc {
++ redef "IO::Handle::getc()";
++}
++
++sub fgets {
++ redef "IO::Handle::gets()";
++}
++
++sub fileno {
++ redef "IO::Handle::fileno()";
++}
++
++sub fopen {
++ redef "IO::File::open()";
++}
++
++sub fprintf {
++ unimpl "fprintf() is C-specific--use printf instead";
++}
++
++sub fputc {
++ unimpl "fputc() is C-specific--use print instead";
++}
++
++sub fputs {
++ unimpl "fputs() is C-specific--use print instead";
++}
++
++sub fread {
++ unimpl "fread() is C-specific--use read instead";
++}
++
++sub freopen {
++ unimpl "freopen() is C-specific--use open instead";
++}
++
++sub fscanf {
++ unimpl "fscanf() is C-specific--use <> and regular expressions instead";
++}
++
++sub fseek {
++ redef "IO::Seekable::seek()";
++}
++
++sub fsync {
++ redef "IO::Handle::sync()";
++}
++
++sub ferror {
++ redef "IO::Handle::error()";
++}
++
++sub fflush {
++ redef "IO::Handle::flush()";
++}
++
++sub fgetpos {
++ redef "IO::Seekable::getpos()";
++}
++
++sub fsetpos {
++ redef "IO::Seekable::setpos()";
++}
++
++sub ftell {
++ redef "IO::Seekable::tell()";
++}
++
++sub fwrite {
++ unimpl "fwrite() is C-specific--use print instead";
++}
++
++sub getc {
++ usage "getc(handle)" if @_ != 1;
++ CORE::getc($_[0]);
++}
++
++sub getchar {
++ usage "getchar()" if @_ != 0;
++ CORE::getc(STDIN);
++}
++
++sub gets {
++ usage "gets()" if @_ != 0;
++ scalar <STDIN>;
++}
++
++sub perror {
++ print STDERR "@_: " if @_;
++ print STDERR $!,"\n";
++}
++
++sub printf {
++ usage "printf(pattern, args...)" if @_ < 1;
++ CORE::printf STDOUT @_;
++}
++
++sub putc {
++ unimpl "putc() is C-specific--use print instead";
++}
++
++sub putchar {
++ unimpl "putchar() is C-specific--use print instead";
++}
++
++sub puts {
++ unimpl "puts() is C-specific--use print instead";
++}
++
++sub remove {
++ usage "remove(filename)" if @_ != 1;
++ (-d $_[0]) ? CORE::rmdir($_[0]) : CORE::unlink($_[0]);
++}
++
++sub rename {
++ usage "rename(oldfilename, newfilename)" if @_ != 2;
++ CORE::rename($_[0], $_[1]);
++}
++
++sub rewind {
++ usage "rewind(filehandle)" if @_ != 1;
++ CORE::seek($_[0],0,0);
++}
++
++sub scanf {
++ unimpl "scanf() is C-specific--use <> and regular expressions instead";
++}
++
++sub sprintf {
++ usage "sprintf(pattern,args)" if @_ == 0;
++ CORE::sprintf(shift,@_);
++}
++
++sub sscanf {
++ unimpl "sscanf() is C-specific--use regular expressions instead";
++}
++
++sub tmpfile {
++ redef "IO::File::new_tmpfile()";
++}
++
++sub ungetc {
++ redef "IO::Handle::ungetc()";
++}
++
++sub vfprintf {
++ unimpl "vfprintf() is C-specific";
++}
++
++sub vprintf {
++ unimpl "vprintf() is C-specific";
++}
++
++sub vsprintf {
++ unimpl "vsprintf() is C-specific";
++}
++
++sub abs {
++ usage "abs(x)" if @_ != 1;
++ CORE::abs($_[0]);
++}
++
++sub atexit {
++ unimpl "atexit() is C-specific: use END {} instead";
++}
++
++sub atof {
++ unimpl "atof() is C-specific, stopped";
++}
++
++sub atoi {
++ unimpl "atoi() is C-specific, stopped";
++}
++
++sub atol {
++ unimpl "atol() is C-specific, stopped";
++}
++
++sub bsearch {
++ unimpl "bsearch() not supplied";
++}
++
++sub calloc {
++ unimpl "calloc() is C-specific, stopped";
++}
++
++sub div {
++ unimpl "div() is C-specific, use /, % and int instead";
++}
++
++sub exit {
++ usage "exit(status)" if @_ != 1;
++ CORE::exit($_[0]);
++}
++
++sub free {
++ unimpl "free() is C-specific, stopped";
++}
++
++sub getenv {
++ usage "getenv(name)" if @_ != 1;
++ $ENV{$_[0]};
++}
++
++sub labs {
++ unimpl "labs() is C-specific, use abs instead";
++}
++
++sub ldiv {
++ unimpl "ldiv() is C-specific, use /, % and int instead";
++}
++
++sub malloc {
++ unimpl "malloc() is C-specific, stopped";
++}
++
++sub qsort {
++ unimpl "qsort() is C-specific, use sort instead";
++}
++
++sub rand {
++ unimpl "rand() is non-portable, use Perl's rand instead";
++}
++
++sub realloc {
++ unimpl "realloc() is C-specific, stopped";
++}
++
++sub srand {
++ unimpl "srand()";
++}
++
++sub system {
++ usage "system(command)" if @_ != 1;
++ CORE::system($_[0]);
++}
++
++sub memchr {
++ unimpl "memchr() is C-specific, use index() instead";
++}
++
++sub memcmp {
++ unimpl "memcmp() is C-specific, use eq instead";
++}
++
++sub memcpy {
++ unimpl "memcpy() is C-specific, use = instead";
++}
++
++sub memmove {
++ unimpl "memmove() is C-specific, use = instead";
++}
++
++sub memset {
++ unimpl "memset() is C-specific, use x instead";
++}
++
++sub strcat {
++ unimpl "strcat() is C-specific, use .= instead";
++}
++
++sub strchr {
++ unimpl "strchr() is C-specific, use index() instead";
++}
++
++sub strcmp {
++ unimpl "strcmp() is C-specific, use eq instead";
++}
++
++sub strcpy {
++ unimpl "strcpy() is C-specific, use = instead";
++}
++
++sub strcspn {
++ unimpl "strcspn() is C-specific, use regular expressions instead";
++}
++
++sub strerror {
++ usage "strerror(errno)" if @_ != 1;
++ local $! = $_[0];
++ $! . "";
++}
++
++sub strlen {
++ unimpl "strlen() is C-specific, use length instead";
++}
++
++sub strncat {
++ unimpl "strncat() is C-specific, use .= instead";
++}
++
++sub strncmp {
++ unimpl "strncmp() is C-specific, use eq instead";
++}
++
++sub strncpy {
++ unimpl "strncpy() is C-specific, use = instead";
++}
++
++sub strpbrk {
++ unimpl "strpbrk() is C-specific, stopped";
++}
++
++sub strrchr {
++ unimpl "strrchr() is C-specific, use rindex() instead";
++}
++
++sub strspn {
++ unimpl "strspn() is C-specific, stopped";
++}
++
++sub strstr {
++ usage "strstr(big, little)" if @_ != 2;
++ CORE::index($_[0], $_[1]);
++}
++
++sub strtok {
++ unimpl "strtok() is C-specific, stopped";
++}
++
++sub chmod {
++ usage "chmod(mode, filename)" if @_ != 2;
++ CORE::chmod($_[0], $_[1]);
++}
++
++sub fstat {
++ usage "fstat(fd)" if @_ != 1;
++ local *TMP;
++ CORE::open(TMP, "<&$_[0]"); # Gross.
++ my @l = CORE::stat(TMP);
++ CORE::close(TMP);
++ @l;
++}
++
++sub mkdir {
++ usage "mkdir(directoryname, mode)" if @_ != 2;
++ CORE::mkdir($_[0], $_[1]);
++}
++
++sub stat {
++ usage "stat(filename)" if @_ != 1;
++ CORE::stat($_[0]);
++}
++
++sub umask {
++ usage "umask(mask)" if @_ != 1;
++ CORE::umask($_[0]);
++}
++
++sub wait {
++ usage "wait()" if @_ != 0;
++ CORE::wait();
++}
++
++sub waitpid {
++ usage "waitpid(pid, options)" if @_ != 2;
++ CORE::waitpid($_[0], $_[1]);
++}
++
++sub gmtime {
++ usage "gmtime(time)" if @_ != 1;
++ CORE::gmtime($_[0]);
++}
++
++sub localtime {
++ usage "localtime(time)" if @_ != 1;
++ CORE::localtime($_[0]);
++}
++
++sub time {
++ usage "time()" if @_ != 0;
++ CORE::time;
++}
++
++sub alarm {
++ usage "alarm(seconds)" if @_ != 1;
++ CORE::alarm($_[0]);
++}
++
++sub chdir {
++ usage "chdir(directory)" if @_ != 1;
++ CORE::chdir($_[0]);
++}
++
++sub chown {
++ usage "chown(uid, gid, filename)" if @_ != 3;
++ CORE::chown($_[0], $_[1], $_[2]);
++}
++
++sub execl {
++ unimpl "execl() is C-specific, stopped";
++}
++
++sub execle {
++ unimpl "execle() is C-specific, stopped";
++}
++
++sub execlp {
++ unimpl "execlp() is C-specific, stopped";
++}
++
++sub execv {
++ unimpl "execv() is C-specific, stopped";
++}
++
++sub execve {
++ unimpl "execve() is C-specific, stopped";
++}
++
++sub execvp {
++ unimpl "execvp() is C-specific, stopped";
++}
++
++sub fork {
++ usage "fork()" if @_ != 0;
++ CORE::fork;
++}
++
++sub getegid {
++ usage "getegid()" if @_ != 0;
++ $) + 0;
++}
++
++sub geteuid {
++ usage "geteuid()" if @_ != 0;
++ $> + 0;
++}
++
++sub getgid {
++ usage "getgid()" if @_ != 0;
++ $( + 0;
++}
++
++sub getgroups {
++ usage "getgroups()" if @_ != 0;
++ my %seen;
++ grep(!$seen{$_}++, split(' ', $) ));
++}
++
++sub getlogin {
++ usage "getlogin()" if @_ != 0;
++ CORE::getlogin();
++}
++
++sub getpgrp {
++ usage "getpgrp()" if @_ != 0;
++ CORE::getpgrp;
++}
++
++sub getpid {
++ usage "getpid()" if @_ != 0;
++ $$;
++}
++
++sub getppid {
++ usage "getppid()" if @_ != 0;
++ CORE::getppid;
++}
++
++sub getuid {
++ usage "getuid()" if @_ != 0;
++ $<;
++}
++
++sub isatty {
++ usage "isatty(filehandle)" if @_ != 1;
++ -t $_[0];
++}
++
++sub link {
++ usage "link(oldfilename, newfilename)" if @_ != 2;
++ CORE::link($_[0], $_[1]);
++}
++
++sub rmdir {
++ usage "rmdir(directoryname)" if @_ != 1;
++ CORE::rmdir($_[0]);
++}
++
++sub setbuf {
++ redef "IO::Handle::setbuf()";
++}
++
++sub setvbuf {
++ redef "IO::Handle::setvbuf()";
++}
++
++sub sleep {
++ usage "sleep(seconds)" if @_ != 1;
++ $_[0] - CORE::sleep($_[0]);
++}
++
++sub unlink {
++ usage "unlink(filename)" if @_ != 1;
++ CORE::unlink($_[0]);
++}
++
++sub utime {
++ usage "utime(filename, atime, mtime)" if @_ != 3;
++ CORE::utime($_[1], $_[2], $_[0]);
++}
++
++sub load_imports {
++%EXPORT_TAGS = (
++
++ assert_h => [qw(assert NDEBUG)],
++
++ ctype_h => [qw(isalnum isalpha iscntrl isdigit isgraph islower
++ isprint ispunct isspace isupper isxdigit tolower toupper)],
++
++ dirent_h => [],
++
++ errno_h => [qw(E2BIG EACCES EADDRINUSE EADDRNOTAVAIL EAFNOSUPPORT
++ EAGAIN EALREADY EBADF EBUSY ECHILD ECONNABORTED
++ ECONNREFUSED ECONNRESET EDEADLK EDESTADDRREQ EDOM EDQUOT
++ EEXIST EFAULT EFBIG EHOSTDOWN EHOSTUNREACH EINPROGRESS
++ EINTR EINVAL EIO EISCONN EISDIR ELOOP EMFILE EMLINK
++ EMSGSIZE ENAMETOOLONG ENETDOWN ENETRESET ENETUNREACH
++ ENFILE ENOBUFS ENODEV ENOENT ENOEXEC ENOLCK ENOMEM
++ ENOPROTOOPT ENOSPC ENOSYS ENOTBLK ENOTCONN ENOTDIR
++ ENOTEMPTY ENOTSOCK ENOTTY ENXIO EOPNOTSUPP EPERM
++ EPFNOSUPPORT EPIPE EPROCLIM EPROTONOSUPPORT EPROTOTYPE
++ ERANGE EREMOTE ERESTART EROFS ESHUTDOWN ESOCKTNOSUPPORT
++ ESPIPE ESRCH ESTALE ETIMEDOUT ETOOMANYREFS ETXTBSY
++ EUSERS EWOULDBLOCK EXDEV errno)],
++
++ fcntl_h => [qw(FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_RDLCK
++ F_SETFD F_SETFL F_SETLK F_SETLKW F_UNLCK F_WRLCK
++ O_ACCMODE O_APPEND O_CREAT O_EXCL O_NOCTTY O_NONBLOCK
++ O_RDONLY O_RDWR O_TRUNC O_WRONLY
++ creat
++ SEEK_CUR SEEK_END SEEK_SET
++ S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU
++ S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISGID S_ISREG S_ISUID
++ S_IWGRP S_IWOTH S_IWUSR)],
++
++ float_h => [qw(DBL_DIG DBL_EPSILON DBL_MANT_DIG
++ DBL_MAX DBL_MAX_10_EXP DBL_MAX_EXP
++ DBL_MIN DBL_MIN_10_EXP DBL_MIN_EXP
++ FLT_DIG FLT_EPSILON FLT_MANT_DIG
++ FLT_MAX FLT_MAX_10_EXP FLT_MAX_EXP
++ FLT_MIN FLT_MIN_10_EXP FLT_MIN_EXP
++ FLT_RADIX FLT_ROUNDS
++ LDBL_DIG LDBL_EPSILON LDBL_MANT_DIG
++ LDBL_MAX LDBL_MAX_10_EXP LDBL_MAX_EXP
++ LDBL_MIN LDBL_MIN_10_EXP LDBL_MIN_EXP)],
++
++ grp_h => [],
++
++ limits_h => [qw( ARG_MAX CHAR_BIT CHAR_MAX CHAR_MIN CHILD_MAX
++ INT_MAX INT_MIN LINK_MAX LONG_MAX LONG_MIN MAX_CANON
++ MAX_INPUT MB_LEN_MAX NAME_MAX NGROUPS_MAX OPEN_MAX
++ PATH_MAX PIPE_BUF SCHAR_MAX SCHAR_MIN SHRT_MAX SHRT_MIN
++ SSIZE_MAX STREAM_MAX TZNAME_MAX UCHAR_MAX UINT_MAX
++ ULONG_MAX USHRT_MAX _POSIX_ARG_MAX _POSIX_CHILD_MAX
++ _POSIX_LINK_MAX _POSIX_MAX_CANON _POSIX_MAX_INPUT
++ _POSIX_NAME_MAX _POSIX_NGROUPS_MAX _POSIX_OPEN_MAX
++ _POSIX_PATH_MAX _POSIX_PIPE_BUF _POSIX_SSIZE_MAX
++ _POSIX_STREAM_MAX _POSIX_TZNAME_MAX)],
++
++ locale_h => [qw(LC_ALL LC_COLLATE LC_CTYPE LC_MESSAGES
++ LC_MONETARY LC_NUMERIC LC_TIME NULL
++ localeconv setlocale)],
++
++ math_h => [qw(HUGE_VAL acos asin atan ceil cosh fabs floor fmod
++ frexp ldexp log10 modf pow sinh tan tanh)],
++
++ pwd_h => [],
++
++ setjmp_h => [qw(longjmp setjmp siglongjmp sigsetjmp)],
++
++ signal_h => [qw(SA_NOCLDSTOP SA_NOCLDWAIT SA_NODEFER SA_ONSTACK
++ SA_RESETHAND SA_RESTART SA_SIGINFO SIGABRT SIGALRM
++ SIGCHLD SIGCONT SIGFPE SIGHUP SIGILL SIGINT SIGKILL
++ SIGPIPE %SIGRT SIGRTMIN SIGRTMAX SIGQUIT SIGSEGV SIGSTOP
++ SIGTERM SIGTSTP SIGTTIN SIGTTOU SIGUSR1 SIGUSR2
++ SIG_BLOCK SIG_DFL SIG_ERR SIG_IGN SIG_SETMASK SIG_UNBLOCK
++ raise sigaction signal sigpending sigprocmask sigsuspend)],
++
++ stdarg_h => [],
++
++ stddef_h => [qw(NULL offsetof)],
++
++ stdio_h => [qw(BUFSIZ EOF FILENAME_MAX L_ctermid L_cuserid
++ L_tmpname NULL SEEK_CUR SEEK_END SEEK_SET
++ STREAM_MAX TMP_MAX stderr stdin stdout
++ clearerr fclose fdopen feof ferror fflush fgetc fgetpos
++ fgets fopen fprintf fputc fputs fread freopen
++ fscanf fseek fsetpos ftell fwrite getchar gets
++ perror putc putchar puts remove rewind
++ scanf setbuf setvbuf sscanf tmpfile tmpnam
++ ungetc vfprintf vprintf vsprintf)],
++
++ stdlib_h => [qw(EXIT_FAILURE EXIT_SUCCESS MB_CUR_MAX NULL RAND_MAX
++ abort atexit atof atoi atol bsearch calloc div
++ free getenv labs ldiv malloc mblen mbstowcs mbtowc
++ qsort realloc strtod strtol strtoul wcstombs wctomb)],
++
++ string_h => [qw(NULL memchr memcmp memcpy memmove memset strcat
++ strchr strcmp strcoll strcpy strcspn strerror strlen
++ strncat strncmp strncpy strpbrk strrchr strspn strstr
++ strtok strxfrm)],
++
++ sys_stat_h => [qw(S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU
++ S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISGID S_ISREG
++ S_ISUID S_IWGRP S_IWOTH S_IWUSR S_IXGRP S_IXOTH S_IXUSR
++ fstat mkfifo)],
++
++ sys_times_h => [],
++
++ sys_types_h => [],
++
++ sys_utsname_h => [qw(uname)],
++
++ sys_wait_h => [qw(WEXITSTATUS WIFEXITED WIFSIGNALED WIFSTOPPED
++ WNOHANG WSTOPSIG WTERMSIG WUNTRACED)],
++
++ termios_h => [qw( B0 B110 B1200 B134 B150 B1800 B19200 B200 B2400
++ B300 B38400 B4800 B50 B600 B75 B9600 BRKINT CLOCAL
++ CREAD CS5 CS6 CS7 CS8 CSIZE CSTOPB ECHO ECHOE ECHOK
++ ECHONL HUPCL ICANON ICRNL IEXTEN IGNBRK IGNCR IGNPAR
++ INLCR INPCK ISIG ISTRIP IXOFF IXON NCCS NOFLSH OPOST
++ PARENB PARMRK PARODD TCIFLUSH TCIOFF TCIOFLUSH TCION
++ TCOFLUSH TCOOFF TCOON TCSADRAIN TCSAFLUSH TCSANOW
++ TOSTOP VEOF VEOL VERASE VINTR VKILL VMIN VQUIT VSTART
++ VSTOP VSUSP VTIME
++ cfgetispeed cfgetospeed cfsetispeed cfsetospeed tcdrain
++ tcflow tcflush tcgetattr tcsendbreak tcsetattr )],
++
++ time_h => [qw(CLK_TCK CLOCKS_PER_SEC NULL asctime clock ctime
++ difftime mktime strftime tzset tzname)],
++
++ unistd_h => [qw(F_OK NULL R_OK SEEK_CUR SEEK_END SEEK_SET
++ STDERR_FILENO STDIN_FILENO STDOUT_FILENO W_OK X_OK
++ _PC_CHOWN_RESTRICTED _PC_LINK_MAX _PC_MAX_CANON
++ _PC_MAX_INPUT _PC_NAME_MAX _PC_NO_TRUNC _PC_PATH_MAX
++ _PC_PIPE_BUF _PC_VDISABLE _POSIX_CHOWN_RESTRICTED
++ _POSIX_JOB_CONTROL _POSIX_NO_TRUNC _POSIX_SAVED_IDS
++ _POSIX_VDISABLE _POSIX_VERSION _SC_ARG_MAX
++ _SC_CHILD_MAX _SC_CLK_TCK _SC_JOB_CONTROL
++ _SC_NGROUPS_MAX _SC_OPEN_MAX _SC_PAGESIZE _SC_SAVED_IDS
++ _SC_STREAM_MAX _SC_TZNAME_MAX _SC_VERSION
++ _exit access ctermid cuserid
++ dup2 dup execl execle execlp execv execve execvp
++ fpathconf fsync getcwd getegid geteuid getgid getgroups
++ getpid getuid isatty lseek pathconf pause setgid setpgid
++ setsid setuid sysconf tcgetpgrp tcsetpgrp ttyname)],
++
++ utime_h => [],
++
++);
++
++# Exporter::export_tags();
++{
++ # De-duplicate the export list:
++ my %export;
++ @export{map {@$_} values %EXPORT_TAGS} = ();
++ # Doing the de-dup with a temporary hash has the advantage that the SVs in
++ # @EXPORT are actually shared hash key sacalars, which will save some memory.
++ push @EXPORT, keys %export;
++}
++
++@EXPORT_OK = qw(
++ abs
++ alarm
++ atan2
++ chdir
++ chmod
++ chown
++ close
++ closedir
++ cos
++ exit
++ exp
++ fcntl
++ fileno
++ fork
++ getc
++ getgrgid
++ getgrnam
++ getlogin
++ getpgrp
++ getppid
++ getpwnam
++ getpwuid
++ gmtime
++ isatty
++ kill
++ lchown
++ link
++ localtime
++ log
++ mkdir
++ nice
++ open
++ opendir
++ pipe
++ printf
++ rand
++ read
++ readdir
++ rename
++ rewinddir
++ rmdir
++ sin
++ sleep
++ sprintf
++ sqrt
++ srand
++ stat
++ system
++ time
++ times
++ umask
++ unlink
++ utime
++ wait
++ waitpid
++ write
++);
++
++require Exporter;
++}
++
++package POSIX::SigAction;
++
++sub new { bless {HANDLER => $_[1], MASK => $_[2], FLAGS => $_[3] || 0, SAFE => 0}, $_[0] }
++sub handler { $_[0]->{HANDLER} = $_[1] if @_ > 1; $_[0]->{HANDLER} };
++sub mask { $_[0]->{MASK} = $_[1] if @_ > 1; $_[0]->{MASK} };
++sub flags { $_[0]->{FLAGS} = $_[1] if @_ > 1; $_[0]->{FLAGS} };
++sub safe { $_[0]->{SAFE} = $_[1] if @_ > 1; $_[0]->{SAFE} };
++
++package POSIX::SigRt;
++
++
++sub _init {
++ $_SIGRTMIN = &POSIX::SIGRTMIN;
++ $_SIGRTMAX = &POSIX::SIGRTMAX;
++ $_sigrtn = $_SIGRTMAX - $_SIGRTMIN;
++}
++
++sub _croak {
++ &_init unless defined $_sigrtn;
++ die "POSIX::SigRt not available" unless defined $_sigrtn && $_sigrtn > 0;
++}
++
++sub _getsig {
++ &_croak;
++ my $rtsig = $_[0];
++ # Allow (SIGRT)?MIN( + n)?, a common idiom when doing these things in C.
++ $rtsig = $_SIGRTMIN + ($1 || 0)
++ if $rtsig =~ /^(?:(?:SIG)?RT)?MIN(\s*\+\s*(\d+))?$/;
++ return $rtsig;
++}
++
++sub _exist {
++ my $rtsig = _getsig($_[1]);
++ my $ok = $rtsig >= $_SIGRTMIN && $rtsig <= $_SIGRTMAX;
++ ($rtsig, $ok);
++}
++
++sub _check {
++ my ($rtsig, $ok) = &_exist;
++ die "No POSIX::SigRt signal $_[1] (valid range SIGRTMIN..SIGRTMAX, or $_SIGRTMIN..$_SIGRTMAX)"
++ unless $ok;
++ return $rtsig;
++}
++
++sub new {
++ my ($rtsig, $handler, $flags) = @_;
++ my $sigset = POSIX::SigSet->new($rtsig);
++ my $sigact = POSIX::SigAction->new($handler,
++ $sigset,
++ $flags);
++ POSIX::sigaction($rtsig, $sigact);
++}
++
++sub EXISTS { &_exist }
++sub FETCH { my $rtsig = &_check;
++ my $oa = POSIX::SigAction->new();
++ POSIX::sigaction($rtsig, undef, $oa);
++ return $oa->{HANDLER} }
++sub STORE { my $rtsig = &_check; new($rtsig, $_[2], $SIGACTION_FLAGS) }
++sub DELETE { delete $SIG{ &_check } }
++sub CLEAR { &_exist; delete @SIG{ &POSIX::SIGRTMIN .. &POSIX::SIGRTMAX } }
++sub SCALAR { &_croak; $_sigrtn + 1 }
+diff --git a/ext/POSIX/lib/POSIX.pod b/ext/POSIX/lib/POSIX.pod
+new file mode 100644
+index 0000000..64852e9
+--- /dev/null
++++ b/ext/POSIX/lib/POSIX.pod
+@@ -0,0 +1,2218 @@
++=head1 NAME
++
++POSIX - Perl interface to IEEE Std 1003.1
++
++=head1 SYNOPSIS
++
++ use POSIX;
++ use POSIX qw(setsid);
++ use POSIX qw(:errno_h :fcntl_h);
++
++ printf "EINTR is %d\n", EINTR;
++
++ $sess_id = POSIX::setsid();
++
++ $fd = POSIX::open($path, O_CREAT|O_EXCL|O_WRONLY, 0644);
++ # note: that's a filedescriptor, *NOT* a filehandle
++
++=head1 DESCRIPTION
++
++The POSIX module permits you to access all (or nearly all) the standard
++POSIX 1003.1 identifiers. Many of these identifiers have been given Perl-ish
++interfaces.
++
++I<Everything is exported by default> with the exception of any POSIX
++functions with the same name as a built-in Perl function, such as
++C<abs>, C<alarm>, C<rmdir>, C<write>, etc.., which will be exported
++only if you ask for them explicitly. This is an unfortunate backwards
++compatibility feature. You can stop the exporting by saying C<use
++POSIX ()> and then use the fully qualified names (ie. C<POSIX::SEEK_END>).
++
++This document gives a condensed list of the features available in the POSIX
++module. Consult your operating system's manpages for general information on
++most features. Consult L<perlfunc> for functions which are noted as being
++identical to Perl's builtin functions.
++
++The first section describes POSIX functions from the 1003.1 specification.
++The second section describes some classes for signal objects, TTY objects,
++and other miscellaneous objects. The remaining sections list various
++constants and macros in an organization which roughly follows IEEE Std
++1003.1b-1993.
++
++=head1 NOTE
++
++The POSIX module is probably the most complex Perl module supplied with
++the standard distribution. It incorporates autoloading, namespace games,
++and dynamic loading of code that's in Perl, C, or both. It's a great
++source of wisdom.
++
++=head1 CAVEATS
++
++A few functions are not implemented because they are C specific. If you
++attempt to call these, they will print a message telling you that they
++aren't implemented, and suggest using the Perl equivalent should one
++exist. For example, trying to access the setjmp() call will elicit the
++message "setjmp() is C-specific: use eval {} instead".
++
++Furthermore, some evil vendors will claim 1003.1 compliance, but in fact
++are not so: they will not pass the PCTS (POSIX Compliance Test Suites).
++For example, one vendor may not define EDEADLK, or the semantics of the
++errno values set by open(2) might not be quite right. Perl does not
++attempt to verify POSIX compliance. That means you can currently
++successfully say "use POSIX", and then later in your program you find
++that your vendor has been lax and there's no usable ICANON macro after
++all. This could be construed to be a bug.
++
++=head1 FUNCTIONS
++
++=over 8
++
++=item _exit
++
++This is identical to the C function C<_exit()>. It exits the program
++immediately which means among other things buffered I/O is B<not> flushed.
++
++Note that when using threads and in Linux this is B<not> a good way to
++exit a thread because in Linux processes and threads are kind of the
++same thing (Note: while this is the situation in early 2003 there are
++projects under way to have threads with more POSIXly semantics in Linux).
++If you want not to return from a thread, detach the thread.
++
++=item abort
++
++This is identical to the C function C<abort()>. It terminates the
++process with a C<SIGABRT> signal unless caught by a signal handler or
++if the handler does not return normally (it e.g. does a C<longjmp>).
++
++=item abs
++
++This is identical to Perl's builtin C<abs()> function, returning
++the absolute value of its numerical argument.
++
++=item access
++
++Determines the accessibility of a file.
++
++ if( POSIX::access( "/", &POSIX::R_OK ) ){
++ print "have read permission\n";
++ }
++
++Returns C<undef> on failure. Note: do not use C<access()> for
++security purposes. Between the C<access()> call and the operation
++you are preparing for the permissions might change: a classic
++I<race condition>.
++
++=item acos
++
++This is identical to the C function C<acos()>, returning
++the arcus cosine of its numerical argument. See also L<Math::Trig>.
++
++=item alarm
++
++This is identical to Perl's builtin C<alarm()> function,
++either for arming or disarming the C<SIGARLM> timer.
++
++=item asctime
++
++This is identical to the C function C<asctime()>. It returns
++a string of the form
++
++ "Fri Jun 2 18:22:13 2000\n\0"
++
++and it is called thusly
++
++ $asctime = asctime($sec, $min, $hour, $mday, $mon, $year,
++ $wday, $yday, $isdst);
++
++The C<$mon> is zero-based: January equals C<0>. The C<$year> is
++1900-based: 2001 equals C<101>. C<$wday> and C<$yday> default to zero
++(and are usually ignored anyway), and C<$isdst> defaults to -1.
++
++=item asin
++
++This is identical to the C function C<asin()>, returning
++the arcus sine of its numerical argument. See also L<Math::Trig>.
++
++=item assert
++
++Unimplemented, but you can use L<perlfunc/die> and the L<Carp> module
++to achieve similar things.
++
++=item atan
++
++This is identical to the C function C<atan()>, returning the
++arcus tangent of its numerical argument. See also L<Math::Trig>.
++
++=item atan2
++
++This is identical to Perl's builtin C<atan2()> function, returning
++the arcus tangent defined by its two numerical arguments, the I<y>
++coordinate and the I<x> coordinate. See also L<Math::Trig>.
++
++=item atexit
++
++atexit() is C-specific: use C<END {}> instead, see L<perlsub>.
++
++=item atof
++
++atof() is C-specific. Perl converts strings to numbers transparently.
++If you need to force a scalar to a number, add a zero to it.
++
++=item atoi
++
++atoi() is C-specific. Perl converts strings to numbers transparently.
++If you need to force a scalar to a number, add a zero to it.
++If you need to have just the integer part, see L<perlfunc/int>.
++
++=item atol
++
++atol() is C-specific. Perl converts strings to numbers transparently.
++If you need to force a scalar to a number, add a zero to it.
++If you need to have just the integer part, see L<perlfunc/int>.
++
++=item bsearch
++
++bsearch() not supplied. For doing binary search on wordlists,
++see L<Search::Dict>.
++
++=item calloc
++
++calloc() is C-specific. Perl does memory management transparently.
++
++=item ceil
++
++This is identical to the C function C<ceil()>, returning the smallest
++integer value greater than or equal to the given numerical argument.
++
++=item chdir
++
++This is identical to Perl's builtin C<chdir()> function, allowing
++one to change the working (default) directory, see L<perlfunc/chdir>.
++
++=item chmod
++
++This is identical to Perl's builtin C<chmod()> function, allowing
++one to change file and directory permissions, see L<perlfunc/chmod>.
++
++=item chown
++
++This is identical to Perl's builtin C<chown()> function, allowing one
++to change file and directory owners and groups, see L<perlfunc/chown>.
++
++=item clearerr
++
++Use the method C<IO::Handle::clearerr()> instead, to reset the error
++state (if any) and EOF state (if any) of the given stream.
++
++=item clock
++
++This is identical to the C function C<clock()>, returning the
++amount of spent processor time in microseconds.
++
++=item close
++
++Close the file. This uses file descriptors such as those obtained by calling
++C<POSIX::open>.
++
++ $fd = POSIX::open( "foo", &POSIX::O_RDONLY );
++ POSIX::close( $fd );
++
++Returns C<undef> on failure.
++
++See also L<perlfunc/close>.
++
++=item closedir
++
++This is identical to Perl's builtin C<closedir()> function for closing
++a directory handle, see L<perlfunc/closedir>.
++
++=item cos
++
++This is identical to Perl's builtin C<cos()> function, for returning
++the cosine of its numerical argument, see L<perlfunc/cos>.
++See also L<Math::Trig>.
++
++=item cosh
++
++This is identical to the C function C<cosh()>, for returning
++the hyperbolic cosine of its numeric argument. See also L<Math::Trig>.
++
++=item creat
++
++Create a new file. This returns a file descriptor like the ones returned by
++C<POSIX::open>. Use C<POSIX::close> to close the file.
++
++ $fd = POSIX::creat( "foo", 0611 );
++ POSIX::close( $fd );
++
++See also L<perlfunc/sysopen> and its C<O_CREAT> flag.
++
++=item ctermid
++
++Generates the path name for the controlling terminal.
++
++ $path = POSIX::ctermid();
++
++=item ctime
++
++This is identical to the C function C<ctime()> and equivalent
++to C<asctime(localtime(...))>, see L</asctime> and L</localtime>.
++
++=item cuserid
++
++Get the login name of the owner of the current process.
++
++ $name = POSIX::cuserid();
++
++=item difftime
++
++This is identical to the C function C<difftime()>, for returning
++the time difference (in seconds) between two times (as returned
++by C<time()>), see L</time>.
++
++=item div
++
++div() is C-specific, use L<perlfunc/int> on the usual C</> division and
++the modulus C<%>.
++
++=item dup
++
++This is similar to the C function C<dup()>, for duplicating a file
++descriptor.
++
++This uses file descriptors such as those obtained by calling
++C<POSIX::open>.
++
++Returns C<undef> on failure.
++
++=item dup2
++
++This is similar to the C function C<dup2()>, for duplicating a file
++descriptor to an another known file descriptor.
++
++This uses file descriptors such as those obtained by calling
++C<POSIX::open>.
++
++Returns C<undef> on failure.
++
++=item errno
++
++Returns the value of errno.
++
++ $errno = POSIX::errno();
++
++This identical to the numerical values of the C<$!>, see L<perlvar/$ERRNO>.
++
++=item execl
++
++execl() is C-specific, see L<perlfunc/exec>.
++
++=item execle
++
++execle() is C-specific, see L<perlfunc/exec>.
++
++=item execlp
++
++execlp() is C-specific, see L<perlfunc/exec>.
++
++=item execv
++
++execv() is C-specific, see L<perlfunc/exec>.
++
++=item execve
++
++execve() is C-specific, see L<perlfunc/exec>.
++
++=item execvp
++
++execvp() is C-specific, see L<perlfunc/exec>.
++
++=item exit
++
++This is identical to Perl's builtin C<exit()> function for exiting the
++program, see L<perlfunc/exit>.
++
++=item exp
++
++This is identical to Perl's builtin C<exp()> function for
++returning the exponent (I<e>-based) of the numerical argument,
++see L<perlfunc/exp>.
++
++=item fabs
++
++This is identical to Perl's builtin C<abs()> function for returning
++the absolute value of the numerical argument, see L<perlfunc/abs>.
++
++=item fclose
++
++Use method C<IO::Handle::close()> instead, or see L<perlfunc/close>.
++
++=item fcntl
++
++This is identical to Perl's builtin C<fcntl()> function,
++see L<perlfunc/fcntl>.
++
++=item fdopen
++
++Use method C<IO::Handle::new_from_fd()> instead, or see L<perlfunc/open>.
++
++=item feof
++
++Use method C<IO::Handle::eof()> instead, or see L<perlfunc/eof>.
++
++=item ferror
++
++Use method C<IO::Handle::error()> instead.
++
++=item fflush
++
++Use method C<IO::Handle::flush()> instead.
++See also L<perlvar/$OUTPUT_AUTOFLUSH>.
++
++=item fgetc
++
++Use method C<IO::Handle::getc()> instead, or see L<perlfunc/read>.
++
++=item fgetpos
++
++Use method C<IO::Seekable::getpos()> instead, or see L<L/seek>.
++
++=item fgets
++
++Use method C<IO::Handle::gets()> instead. Similar to E<lt>E<gt>, also known
++as L<perlfunc/readline>.
++
++=item fileno
++
++Use method C<IO::Handle::fileno()> instead, or see L<perlfunc/fileno>.
++
++=item floor
++
++This is identical to the C function C<floor()>, returning the largest
++integer value less than or equal to the numerical argument.
++
++=item fmod
++
++This is identical to the C function C<fmod()>.
++
++ $r = fmod($x, $y);
++
++It returns the remainder C<$r = $x - $n*$y>, where C<$n = trunc($x/$y)>.
++The C<$r> has the same sign as C<$x> and magnitude (absolute value)
++less than the magnitude of C<$y>.
++
++=item fopen
++
++Use method C<IO::File::open()> instead, or see L<perlfunc/open>.
++
++=item fork
++
++This is identical to Perl's builtin C<fork()> function
++for duplicating the current process, see L<perlfunc/fork>
++and L<perlfork> if you are in Windows.
++
++=item fpathconf
++
++Retrieves the value of a configurable limit on a file or directory. This
++uses file descriptors such as those obtained by calling C<POSIX::open>.
++
++The following will determine the maximum length of the longest allowable
++pathname on the filesystem which holds C</var/foo>.
++
++ $fd = POSIX::open( "/var/foo", &POSIX::O_RDONLY );
++ $path_max = POSIX::fpathconf( $fd, &POSIX::_PC_PATH_MAX );
++
++Returns C<undef> on failure.
++
++=item fprintf
++
++fprintf() is C-specific, see L<perlfunc/printf> instead.
++
++=item fputc
++
++fputc() is C-specific, see L<perlfunc/print> instead.
++
++=item fputs
++
++fputs() is C-specific, see L<perlfunc/print> instead.
++
++=item fread
++
++fread() is C-specific, see L<perlfunc/read> instead.
++
++=item free
++
++free() is C-specific. Perl does memory management transparently.
++
++=item freopen
++
++freopen() is C-specific, see L<perlfunc/open> instead.
++
++=item frexp
++
++Return the mantissa and exponent of a floating-point number.
++
++ ($mantissa, $exponent) = POSIX::frexp( 1.234e56 );
++
++=item fscanf
++
++fscanf() is C-specific, use E<lt>E<gt> and regular expressions instead.
++
++=item fseek
++
++Use method C<IO::Seekable::seek()> instead, or see L<perlfunc/seek>.
++
++=item fsetpos
++
++Use method C<IO::Seekable::setpos()> instead, or seek L<perlfunc/seek>.
++
++=item fstat
++
++Get file status. This uses file descriptors such as those obtained by
++calling C<POSIX::open>. The data returned is identical to the data from
++Perl's builtin C<stat> function.
++
++ $fd = POSIX::open( "foo", &POSIX::O_RDONLY );
++ @stats = POSIX::fstat( $fd );
++
++=item fsync
++
++Use method C<IO::Handle::sync()> instead.
++
++=item ftell
++
++Use method C<IO::Seekable::tell()> instead, or see L<perlfunc/tell>.
++
++=item fwrite
++
++fwrite() is C-specific, see L<perlfunc/print> instead.
++
++=item getc
++
++This is identical to Perl's builtin C<getc()> function,
++see L<perlfunc/getc>.
++
++=item getchar
++
++Returns one character from STDIN. Identical to Perl's C<getc()>,
++see L<perlfunc/getc>.
++
++=item getcwd
++
++Returns the name of the current working directory.
++See also L<Cwd>.
++
++=item getegid
++
++Returns the effective group identifier. Similar to Perl' s builtin
++variable C<$(>, see L<perlvar/$EGID>.
++
++=item getenv
++
++Returns the value of the specified environment variable.
++The same information is available through the C<%ENV> array.
++
++=item geteuid
++
++Returns the effective user identifier. Identical to Perl's builtin C<$E<gt>>
++variable, see L<perlvar/$EUID>.
++
++=item getgid
++
++Returns the user's real group identifier. Similar to Perl's builtin
++variable C<$)>, see L<perlvar/$GID>.
++
++=item getgrgid
++
++This is identical to Perl's builtin C<getgrgid()> function for
++returning group entries by group identifiers, see
++L<perlfunc/getgrgid>.
++
++=item getgrnam
++
++This is identical to Perl's builtin C<getgrnam()> function for
++returning group entries by group names, see L<perlfunc/getgrnam>.
++
++=item getgroups
++
++Returns the ids of the user's supplementary groups. Similar to Perl's
++builtin variable C<$)>, see L<perlvar/$GID>.
++
++=item getlogin
++
++This is identical to Perl's builtin C<getlogin()> function for
++returning the user name associated with the current session, see
++L<perlfunc/getlogin>.
++
++=item getpgrp
++
++This is identical to Perl's builtin C<getpgrp()> function for
++returning the process group identifier of the current process, see
++L<perlfunc/getpgrp>.
++
++=item getpid
++
++Returns the process identifier. Identical to Perl's builtin
++variable C<$$>, see L<perlvar/$PID>.
++
++=item getppid
++
++This is identical to Perl's builtin C<getppid()> function for
++returning the process identifier of the parent process of the current
++process , see L<perlfunc/getppid>.
++
++=item getpwnam
++
++This is identical to Perl's builtin C<getpwnam()> function for
++returning user entries by user names, see L<perlfunc/getpwnam>.
++
++=item getpwuid
++
++This is identical to Perl's builtin C<getpwuid()> function for
++returning user entries by user identifiers, see L<perlfunc/getpwuid>.
++
++=item gets
++
++Returns one line from C<STDIN>, similar to E<lt>E<gt>, also known
++as the C<readline()> function, see L<perlfunc/readline>.
++
++B<NOTE>: if you have C programs that still use C<gets()>, be very
++afraid. The C<gets()> function is a source of endless grief because
++it has no buffer overrun checks. It should B<never> be used. The
++C<fgets()> function should be preferred instead.
++
++=item getuid
++
++Returns the user's identifier. Identical to Perl's builtin C<$E<lt>> variable,
++see L<perlvar/$UID>.
++
++=item gmtime
++
++This is identical to Perl's builtin C<gmtime()> function for
++converting seconds since the epoch to a date in Greenwich Mean Time,
++see L<perlfunc/gmtime>.
++
++=item isalnum
++
++This is identical to the C function, except that it can apply to a
++single character or to a whole string. Note that locale settings may
++affect what characters are considered C<isalnum>. Does not work on
++Unicode characters code point 256 or higher. Consider using regular
++expressions and the C</[[:alnum:]]/> construct instead, or possibly
++the C</\w/> construct.
++
++=item isalpha
++
++This is identical to the C function, except that it can apply to
++a single character or to a whole string. Note that locale settings
++may affect what characters are considered C<isalpha>. Does not work
++on Unicode characters code point 256 or higher. Consider using regular
++expressions and the C</[[:alpha:]]/> construct instead.
++
++=item isatty
++
++Returns a boolean indicating whether the specified filehandle is connected
++to a tty. Similar to the C<-t> operator, see L<perlfunc/-X>.
++
++=item iscntrl
++
++This is identical to the C function, except that it can apply to
++a single character or to a whole string. Note that locale settings
++may affect what characters are considered C<iscntrl>. Does not work
++on Unicode characters code point 256 or higher. Consider using regular
++expressions and the C</[[:cntrl:]]/> construct instead.
++
++=item isdigit
++
++This is identical to the C function, except that it can apply to
++a single character or to a whole string. Note that locale settings
++may affect what characters are considered C<isdigit> (unlikely, but
++still possible). Does not work on Unicode characters code point 256
++or higher. Consider using regular expressions and the C</[[:digit:]]/>
++construct instead, or the C</\d/> construct.
++
++=item isgraph
++
++This is identical to the C function, except that it can apply to
++a single character or to a whole string. Note that locale settings
++may affect what characters are considered C<isgraph>. Does not work
++on Unicode characters code point 256 or higher. Consider using regular
++expressions and the C</[[:graph:]]/> construct instead.
++
++=item islower
++
++This is identical to the C function, except that it can apply to
++a single character or to a whole string. Note that locale settings
++may affect what characters are considered C<islower>. Does not work
++on Unicode characters code point 256 or higher. Consider using regular
++expressions and the C</[[:lower:]]/> construct instead. Do B<not> use
++C</[a-z]/>.
++
++=item isprint
++
++This is identical to the C function, except that it can apply to
++a single character or to a whole string. Note that locale settings
++may affect what characters are considered C<isprint>. Does not work
++on Unicode characters code point 256 or higher. Consider using regular
++expressions and the C</[[:print:]]/> construct instead.
++
++=item ispunct
++
++This is identical to the C function, except that it can apply to
++a single character or to a whole string. Note that locale settings
++may affect what characters are considered C<ispunct>. Does not work
++on Unicode characters code point 256 or higher. Consider using regular
++expressions and the C</[[:punct:]]/> construct instead.
++
++=item isspace
++
++This is identical to the C function, except that it can apply to
++a single character or to a whole string. Note that locale settings
++may affect what characters are considered C<isspace>. Does not work
++on Unicode characters code point 256 or higher. Consider using regular
++expressions and the C</[[:space:]]/> construct instead, or the C</\s/>
++construct. (Note that C</\s/> and C</[[:space:]]/> are slightly
++different in that C</[[:space:]]/> can normally match a vertical tab,
++while C</\s/> does not.)
++
++=item isupper
++
++This is identical to the C function, except that it can apply to
++a single character or to a whole string. Note that locale settings
++may affect what characters are considered C<isupper>. Does not work
++on Unicode characters code point 256 or higher. Consider using regular
++expressions and the C</[[:upper:]]/> construct instead. Do B<not> use
++C</[A-Z]/>.
++
++=item isxdigit
++
++This is identical to the C function, except that it can apply to a single
++character or to a whole string. Note that locale settings may affect what
++characters are considered C<isxdigit> (unlikely, but still possible).
++Does not work on Unicode characters code point 256 or higher.
++Consider using regular expressions and the C</[[:xdigit:]]/>
++construct instead, or simply C</[0-9a-f]/i>.
++
++=item kill
++
++This is identical to Perl's builtin C<kill()> function for sending
++signals to processes (often to terminate them), see L<perlfunc/kill>.
++
++=item labs
++
++(For returning absolute values of long integers.)
++labs() is C-specific, see L<perlfunc/abs> instead.
++
++=item lchown
++
++This is identical to the C function, except the order of arguments is
++consistent with Perl's builtin C<chown()> with the added restriction
++of only one path, not an list of paths. Does the same thing as the
++C<chown()> function but changes the owner of a symbolic link instead
++of the file the symbolic link points to.
++
++=item ldexp
++
++This is identical to the C function C<ldexp()>
++for multiplying floating point numbers with powers of two.
++
++ $x_quadrupled = POSIX::ldexp($x, 2);
++
++=item ldiv
++
++(For computing dividends of long integers.)
++ldiv() is C-specific, use C</> and C<int()> instead.
++
++=item link
++
++This is identical to Perl's builtin C<link()> function
++for creating hard links into files, see L<perlfunc/link>.
++
++=item localeconv
++
++Get numeric formatting information. Returns a reference to a hash
++containing the current locale formatting values.
++
++Here is how to query the database for the B<de> (Deutsch or German) locale.
++
++ $loc = POSIX::setlocale( &POSIX::LC_ALL, "de" );
++ print "Locale = $loc\n";
++ $lconv = POSIX::localeconv();
++ print "decimal_point = ", $lconv->{decimal_point}, "\n";
++ print "thousands_sep = ", $lconv->{thousands_sep}, "\n";
++ print "grouping = ", $lconv->{grouping}, "\n";
++ print "int_curr_symbol = ", $lconv->{int_curr_symbol}, "\n";
++ print "currency_symbol = ", $lconv->{currency_symbol}, "\n";
++ print "mon_decimal_point = ", $lconv->{mon_decimal_point}, "\n";
++ print "mon_thousands_sep = ", $lconv->{mon_thousands_sep}, "\n";
++ print "mon_grouping = ", $lconv->{mon_grouping}, "\n";
++ print "positive_sign = ", $lconv->{positive_sign}, "\n";
++ print "negative_sign = ", $lconv->{negative_sign}, "\n";
++ print "int_frac_digits = ", $lconv->{int_frac_digits}, "\n";
++ print "frac_digits = ", $lconv->{frac_digits}, "\n";
++ print "p_cs_precedes = ", $lconv->{p_cs_precedes}, "\n";
++ print "p_sep_by_space = ", $lconv->{p_sep_by_space}, "\n";
++ print "n_cs_precedes = ", $lconv->{n_cs_precedes}, "\n";
++ print "n_sep_by_space = ", $lconv->{n_sep_by_space}, "\n";
++ print "p_sign_posn = ", $lconv->{p_sign_posn}, "\n";
++ print "n_sign_posn = ", $lconv->{n_sign_posn}, "\n";
++
++=item localtime
++
++This is identical to Perl's builtin C<localtime()> function for
++converting seconds since the epoch to a date see L<perlfunc/localtime>.
++
++=item log
++
++This is identical to Perl's builtin C<log()> function,
++returning the natural (I<e>-based) logarithm of the numerical argument,
++see L<perlfunc/log>.
++
++=item log10
++
++This is identical to the C function C<log10()>,
++returning the 10-base logarithm of the numerical argument.
++You can also use
++
++ sub log10 { log($_[0]) / log(10) }
++
++or
++
++ sub log10 { log($_[0]) / 2.30258509299405 }
++
++or
++
++ sub log10 { log($_[0]) * 0.434294481903252 }
++
++=item longjmp
++
++longjmp() is C-specific: use L<perlfunc/die> instead.
++
++=item lseek
++
++Move the file's read/write position. This uses file descriptors such as
++those obtained by calling C<POSIX::open>.
++
++ $fd = POSIX::open( "foo", &POSIX::O_RDONLY );
++ $off_t = POSIX::lseek( $fd, 0, &POSIX::SEEK_SET );
++
++Returns C<undef> on failure.
++
++=item malloc
++
++malloc() is C-specific. Perl does memory management transparently.
++
++=item mblen
++
++This is identical to the C function C<mblen()>.
++Perl does not have any support for the wide and multibyte
++characters of the C standards, so this might be a rather
++useless function.
++
++=item mbstowcs
++
++This is identical to the C function C<mbstowcs()>.
++Perl does not have any support for the wide and multibyte
++characters of the C standards, so this might be a rather
++useless function.
++
++=item mbtowc
++
++This is identical to the C function C<mbtowc()>.
++Perl does not have any support for the wide and multibyte
++characters of the C standards, so this might be a rather
++useless function.
++
++=item memchr
++
++memchr() is C-specific, see L<perlfunc/index> instead.
++
++=item memcmp
++
++memcmp() is C-specific, use C<eq> instead, see L<perlop>.
++
++=item memcpy
++
++memcpy() is C-specific, use C<=>, see L<perlop>, or see L<perlfunc/substr>.
++
++=item memmove
++
++memmove() is C-specific, use C<=>, see L<perlop>, or see L<perlfunc/substr>.
++
++=item memset
++
++memset() is C-specific, use C<x> instead, see L<perlop>.
++
++=item mkdir
++
++This is identical to Perl's builtin C<mkdir()> function
++for creating directories, see L<perlfunc/mkdir>.
++
++=item mkfifo
++
++This is similar to the C function C<mkfifo()> for creating
++FIFO special files.
++
++ if (mkfifo($path, $mode)) { ....
++
++Returns C<undef> on failure. The C<$mode> is similar to the
++mode of C<mkdir()>, see L<perlfunc/mkdir>, though for C<mkfifo>
++you B<must> specify the C<$mode>.
++
++=item mktime
++
++Convert date/time info to a calendar time.
++
++Synopsis:
++
++ mktime(sec, min, hour, mday, mon, year, wday = 0, yday = 0, isdst = -1)
++
++The month (C<mon>), weekday (C<wday>), and yearday (C<yday>) begin at zero.
++I.e. January is 0, not 1; Sunday is 0, not 1; January 1st is 0, not 1. The
++year (C<year>) is given in years since 1900. I.e. The year 1995 is 95; the
++year 2001 is 101. Consult your system's C<mktime()> manpage for details
++about these and the other arguments.
++
++Calendar time for December 12, 1995, at 10:30 am.
++
++ $time_t = POSIX::mktime( 0, 30, 10, 12, 11, 95 );
++ print "Date = ", POSIX::ctime($time_t);
++
++Returns C<undef> on failure.
++
++=item modf
++
++Return the integral and fractional parts of a floating-point number.
++
++ ($fractional, $integral) = POSIX::modf( 3.14 );
++
++=item nice
++
++This is similar to the C function C<nice()>, for changing
++the scheduling preference of the current process. Positive
++arguments mean more polite process, negative values more
++needy process. Normal user processes can only be more polite.
++
++Returns C<undef> on failure.
++
++=item offsetof
++
++offsetof() is C-specific, you probably want to see L<perlfunc/pack> instead.
++
++=item open
++
++Open a file for reading for writing. This returns file descriptors, not
++Perl filehandles. Use C<POSIX::close> to close the file.
++
++Open a file read-only with mode 0666.
++
++ $fd = POSIX::open( "foo" );
++
++Open a file for read and write.
++
++ $fd = POSIX::open( "foo", &POSIX::O_RDWR );
++
++Open a file for write, with truncation.
++
++ $fd = POSIX::open( "foo", &POSIX::O_WRONLY | &POSIX::O_TRUNC );
++
++Create a new file with mode 0640. Set up the file for writing.
++
++ $fd = POSIX::open( "foo", &POSIX::O_CREAT | &POSIX::O_WRONLY, 0640 );
++
++Returns C<undef> on failure.
++
++See also L<perlfunc/sysopen>.
++
++=item opendir
++
++Open a directory for reading.
++
++ $dir = POSIX::opendir( "/var" );
++ @files = POSIX::readdir( $dir );
++ POSIX::closedir( $dir );
++
++Returns C<undef> on failure.
++
++=item pathconf
++
++Retrieves the value of a configurable limit on a file or directory.
++
++The following will determine the maximum length of the longest allowable
++pathname on the filesystem which holds C</var>.
++
++ $path_max = POSIX::pathconf( "/var", &POSIX::_PC_PATH_MAX );
++
++Returns C<undef> on failure.
++
++=item pause
++
++This is similar to the C function C<pause()>, which suspends
++the execution of the current process until a signal is received.
++
++Returns C<undef> on failure.
++
++=item perror
++
++This is identical to the C function C<perror()>, which outputs to the
++standard error stream the specified message followed by ": " and the
++current error string. Use the C<warn()> function and the C<$!>
++variable instead, see L<perlfunc/warn> and L<perlvar/$ERRNO>.
++
++=item pipe
++
++Create an interprocess channel. This returns file descriptors like those
++returned by C<POSIX::open>.
++
++ my ($read, $write) = POSIX::pipe();
++ POSIX::write( $write, "hello", 5 );
++ POSIX::read( $read, $buf, 5 );
++
++See also L<perlfunc/pipe>.
++
++=item pow
++
++Computes C<$x> raised to the power C<$exponent>.
++
++ $ret = POSIX::pow( $x, $exponent );
++
++You can also use the C<**> operator, see L<perlop>.
++
++=item printf
++
++Formats and prints the specified arguments to STDOUT.
++See also L<perlfunc/printf>.
++
++=item putc
++
++putc() is C-specific, see L<perlfunc/print> instead.
++
++=item putchar
++
++putchar() is C-specific, see L<perlfunc/print> instead.
++
++=item puts
++
++puts() is C-specific, see L<perlfunc/print> instead.
++
++=item qsort
++
++qsort() is C-specific, see L<perlfunc/sort> instead.
++
++=item raise
++
++Sends the specified signal to the current process.
++See also L<perlfunc/kill> and the C<$$> in L<perlvar/$PID>.
++
++=item rand
++
++C<rand()> is non-portable, see L<perlfunc/rand> instead.
++
++=item read
++
++Read from a file. This uses file descriptors such as those obtained by
++calling C<POSIX::open>. If the buffer C<$buf> is not large enough for the
++read then Perl will extend it to make room for the request.
++
++ $fd = POSIX::open( "foo", &POSIX::O_RDONLY );
++ $bytes = POSIX::read( $fd, $buf, 3 );
++
++Returns C<undef> on failure.
++
++See also L<perlfunc/sysread>.
++
++=item readdir
++
++This is identical to Perl's builtin C<readdir()> function
++for reading directory entries, see L<perlfunc/readdir>.
++
++=item realloc
++
++realloc() is C-specific. Perl does memory management transparently.
++
++=item remove
++
++This is identical to Perl's builtin C<unlink()> function
++for removing files, see L<perlfunc/unlink>.
++
++=item rename
++
++This is identical to Perl's builtin C<rename()> function
++for renaming files, see L<perlfunc/rename>.
++
++=item rewind
++
++Seeks to the beginning of the file.
++
++=item rewinddir
++
++This is identical to Perl's builtin C<rewinddir()> function for
++rewinding directory entry streams, see L<perlfunc/rewinddir>.
++
++=item rmdir
++
++This is identical to Perl's builtin C<rmdir()> function
++for removing (empty) directories, see L<perlfunc/rmdir>.
++
++=item scanf
++
++scanf() is C-specific, use E<lt>E<gt> and regular expressions instead,
++see L<perlre>.
++
++=item setgid
++
++Sets the real group identifier and the effective group identifier for
++this process. Similar to assigning a value to the Perl's builtin
++C<$)> variable, see L<perlvar/$EGID>, except that the latter
++will change only the real user identifier, and that the setgid()
++uses only a single numeric argument, as opposed to a space-separated
++list of numbers.
++
++=item setjmp
++
++C<setjmp()> is C-specific: use C<eval {}> instead,
++see L<perlfunc/eval>.
++
++=item setlocale
++
++Modifies and queries program's locale. The following examples assume
++
++ use POSIX qw(setlocale LC_ALL LC_CTYPE);
++
++has been issued.
++
++The following will set the traditional UNIX system locale behavior
++(the second argument C<"C">).
++
++ $loc = setlocale( LC_ALL, "C" );
++
++The following will query the current LC_CTYPE category. (No second
++argument means 'query'.)
++
++ $loc = setlocale( LC_CTYPE );
++
++The following will set the LC_CTYPE behaviour according to the locale
++environment variables (the second argument C<"">).
++Please see your systems C<setlocale(3)> documentation for the locale
++environment variables' meaning or consult L<perllocale>.
++
++ $loc = setlocale( LC_CTYPE, "" );
++
++The following will set the LC_COLLATE behaviour to Argentinian
++Spanish. B<NOTE>: The naming and availability of locales depends on
++your operating system. Please consult L<perllocale> for how to find
++out which locales are available in your system.
++
++ $loc = setlocale( LC_COLLATE, "es_AR.ISO8859-1" );
++
++=item setpgid
++
++This is similar to the C function C<setpgid()> for
++setting the process group identifier of the current process.
++
++Returns C<undef> on failure.
++
++=item setsid
++
++This is identical to the C function C<setsid()> for
++setting the session identifier of the current process.
++
++=item setuid
++
++Sets the real user identifier and the effective user identifier for
++this process. Similar to assigning a value to the Perl's builtin
++C<$E<lt>> variable, see L<perlvar/$UID>, except that the latter
++will change only the real user identifier.
++
++=item sigaction
++
++Detailed signal management. This uses C<POSIX::SigAction> objects for
++the C<action> and C<oldaction> arguments (the oldaction can also be
++just a hash reference). Consult your system's C<sigaction> manpage
++for details, see also C<POSIX::SigRt>.
++
++Synopsis:
++
++ sigaction(signal, action, oldaction = 0)
++
++Returns C<undef> on failure. The C<signal> must be a number (like
++SIGHUP), not a string (like "SIGHUP"), though Perl does try hard
++to understand you.
++
++If you use the SA_SIGINFO flag, the signal handler will in addition to
++the first argument, the signal name, also receive a second argument, a
++hash reference, inside which are the following keys with the following
++semantics, as defined by POSIX/SUSv3:
++
++ signo the signal number
++ errno the error number
++ code if this is zero or less, the signal was sent by
++ a user process and the uid and pid make sense,
++ otherwise the signal was sent by the kernel
++
++The following are also defined by POSIX/SUSv3, but unfortunately
++not very widely implemented:
++
++ pid the process id generating the signal
++ uid the uid of the process id generating the signal
++ status exit value or signal for SIGCHLD
++ band band event for SIGPOLL
++
++A third argument is also passed to the handler, which contains a copy
++of the raw binary contents of the siginfo structure: if a system has
++some non-POSIX fields, this third argument is where to unpack() them
++from.
++
++Note that not all siginfo values make sense simultaneously (some are
++valid only for certain signals, for example), and not all values make
++sense from Perl perspective, you should to consult your system's
++C<sigaction> and possibly also C<siginfo> documentation.
++
++=item siglongjmp
++
++siglongjmp() is C-specific: use L<perlfunc/die> instead.
++
++=item sigpending
++
++Examine signals that are blocked and pending. This uses C<POSIX::SigSet>
++objects for the C<sigset> argument. Consult your system's C<sigpending>
++manpage for details.
++
++Synopsis:
++
++ sigpending(sigset)
++
++Returns C<undef> on failure.
++
++=item sigprocmask
++
++Change and/or examine calling process's signal mask. This uses
++C<POSIX::SigSet> objects for the C<sigset> and C<oldsigset> arguments.
++Consult your system's C<sigprocmask> manpage for details.
++
++Synopsis:
++
++ sigprocmask(how, sigset, oldsigset = 0)
++
++Returns C<undef> on failure.
++
++=item sigsetjmp
++
++C<sigsetjmp()> is C-specific: use C<eval {}> instead,
++see L<perlfunc/eval>.
++
++=item sigsuspend
++
++Install a signal mask and suspend process until signal arrives. This uses
++C<POSIX::SigSet> objects for the C<signal_mask> argument. Consult your
++system's C<sigsuspend> manpage for details.
++
++Synopsis:
++
++ sigsuspend(signal_mask)
++
++Returns C<undef> on failure.
++
++=item sin
++
++This is identical to Perl's builtin C<sin()> function
++for returning the sine of the numerical argument,
++see L<perlfunc/sin>. See also L<Math::Trig>.
++
++=item sinh
++
++This is identical to the C function C<sinh()>
++for returning the hyperbolic sine of the numerical argument.
++See also L<Math::Trig>.
++
++=item sleep
++
++This is functionally identical to Perl's builtin C<sleep()> function
++for suspending the execution of the current for process for certain
++number of seconds, see L<perlfunc/sleep>. There is one significant
++difference, however: C<POSIX::sleep()> returns the number of
++B<unslept> seconds, while the C<CORE::sleep()> returns the
++number of slept seconds.
++
++=item sprintf
++
++This is similar to Perl's builtin C<sprintf()> function
++for returning a string that has the arguments formatted as requested,
++see L<perlfunc/sprintf>.
++
++=item sqrt
++
++This is identical to Perl's builtin C<sqrt()> function.
++for returning the square root of the numerical argument,
++see L<perlfunc/sqrt>.
++
++=item srand
++
++Give a seed the pseudorandom number generator, see L<perlfunc/srand>.
++
++=item sscanf
++
++sscanf() is C-specific, use regular expressions instead,
++see L<perlre>.
++
++=item stat
++
++This is identical to Perl's builtin C<stat()> function
++for returning information about files and directories.
++
++=item strcat
++
++strcat() is C-specific, use C<.=> instead, see L<perlop>.
++
++=item strchr
++
++strchr() is C-specific, see L<perlfunc/index> instead.
++
++=item strcmp
++
++strcmp() is C-specific, use C<eq> or C<cmp> instead, see L<perlop>.
++
++=item strcoll
++
++This is identical to the C function C<strcoll()>
++for collating (comparing) strings transformed using
++the C<strxfrm()> function. Not really needed since
++Perl can do this transparently, see L<perllocale>.
++
++=item strcpy
++
++strcpy() is C-specific, use C<=> instead, see L<perlop>.
++
++=item strcspn
++
++strcspn() is C-specific, use regular expressions instead,
++see L<perlre>.
++
++=item strerror
++
++Returns the error string for the specified errno.
++Identical to the string form of the C<$!>, see L<perlvar/$ERRNO>.
++
++=item strftime
++
++Convert date and time information to string. Returns the string.
++
++Synopsis:
++
++ strftime(fmt, sec, min, hour, mday, mon, year, wday = -1, yday = -1, isdst = -1)
++
++The month (C<mon>), weekday (C<wday>), and yearday (C<yday>) begin at zero.
++I.e. January is 0, not 1; Sunday is 0, not 1; January 1st is 0, not 1. The
++year (C<year>) is given in years since 1900. I.e., the year 1995 is 95; the
++year 2001 is 101. Consult your system's C<strftime()> manpage for details
++about these and the other arguments.
++
++If you want your code to be portable, your format (C<fmt>) argument
++should use only the conversion specifiers defined by the ANSI C
++standard (C89, to play safe). These are C<aAbBcdHIjmMpSUwWxXyYZ%>.
++But even then, the B<results> of some of the conversion specifiers are
++non-portable. For example, the specifiers C<aAbBcpZ> change according
++to the locale settings of the user, and both how to set locales (the
++locale names) and what output to expect are non-standard.
++The specifier C<c> changes according to the timezone settings of the
++user and the timezone computation rules of the operating system.
++The C<Z> specifier is notoriously unportable since the names of
++timezones are non-standard. Sticking to the numeric specifiers is the
++safest route.
++
++The given arguments are made consistent as though by calling
++C<mktime()> before calling your system's C<strftime()> function,
++except that the C<isdst> value is not affected.
++
++The string for Tuesday, December 12, 1995.
++
++ $str = POSIX::strftime( "%A, %B %d, %Y", 0, 0, 0, 12, 11, 95, 2 );
++ print "$str\n";
++
++=item strlen
++
++strlen() is C-specific, use C<length()> instead, see L<perlfunc/length>.
++
++=item strncat
++
++strncat() is C-specific, use C<.=> instead, see L<perlop>.
++
++=item strncmp
++
++strncmp() is C-specific, use C<eq> instead, see L<perlop>.
++
++=item strncpy
++
++strncpy() is C-specific, use C<=> instead, see L<perlop>.
++
++=item strpbrk
++
++strpbrk() is C-specific, use regular expressions instead,
++see L<perlre>.
++
++=item strrchr
++
++strrchr() is C-specific, see L<perlfunc/rindex> instead.
++
++=item strspn
++
++strspn() is C-specific, use regular expressions instead,
++see L<perlre>.
++
++=item strstr
++
++This is identical to Perl's builtin C<index()> function,
++see L<perlfunc/index>.
++
++=item strtod
++
++String to double translation. Returns the parsed number and the number
++of characters in the unparsed portion of the string. Truly
++POSIX-compliant systems set $! ($ERRNO) to indicate a translation
++error, so clear $! before calling strtod. However, non-POSIX systems
++may not check for overflow, and therefore will never set $!.
++
++strtod should respect any POSIX I<setlocale()> settings.
++
++To parse a string $str as a floating point number use
++
++ $! = 0;
++ ($num, $n_unparsed) = POSIX::strtod($str);
++
++The second returned item and $! can be used to check for valid input:
++
++ if (($str eq '') || ($n_unparsed != 0) || $!) {
++ die "Non-numeric input $str" . ($! ? ": $!\n" : "\n");
++ }
++
++When called in a scalar context strtod returns the parsed number.
++
++=item strtok
++
++strtok() is C-specific, use regular expressions instead, see
++L<perlre>, or L<perlfunc/split>.
++
++=item strtol
++
++String to (long) integer translation. Returns the parsed number and
++the number of characters in the unparsed portion of the string. Truly
++POSIX-compliant systems set $! ($ERRNO) to indicate a translation
++error, so clear $! before calling strtol. However, non-POSIX systems
++may not check for overflow, and therefore will never set $!.
++
++strtol should respect any POSIX I<setlocale()> settings.
++
++To parse a string $str as a number in some base $base use
++
++ $! = 0;
++ ($num, $n_unparsed) = POSIX::strtol($str, $base);
++
++The base should be zero or between 2 and 36, inclusive. When the base
++is zero or omitted strtol will use the string itself to determine the
++base: a leading "0x" or "0X" means hexadecimal; a leading "0" means
++octal; any other leading characters mean decimal. Thus, "1234" is
++parsed as a decimal number, "01234" as an octal number, and "0x1234"
++as a hexadecimal number.
++
++The second returned item and $! can be used to check for valid input:
++
++ if (($str eq '') || ($n_unparsed != 0) || !$!) {
++ die "Non-numeric input $str" . $! ? ": $!\n" : "\n";
++ }
++
++When called in a scalar context strtol returns the parsed number.
++
++=item strtoul
++
++String to unsigned (long) integer translation. strtoul() is identical
++to strtol() except that strtoul() only parses unsigned integers. See
++L</strtol> for details.
++
++Note: Some vendors supply strtod() and strtol() but not strtoul().
++Other vendors that do supply strtoul() parse "-1" as a valid value.
++
++=item strxfrm
++
++String transformation. Returns the transformed string.
++
++ $dst = POSIX::strxfrm( $src );
++
++Used in conjunction with the C<strcoll()> function, see L</strcoll>.
++
++Not really needed since Perl can do this transparently, see
++L<perllocale>.
++
++=item sysconf
++
++Retrieves values of system configurable variables.
++
++The following will get the machine's clock speed.
++
++ $clock_ticks = POSIX::sysconf( &POSIX::_SC_CLK_TCK );
++
++Returns C<undef> on failure.
++
++=item system
++
++This is identical to Perl's builtin C<system()> function, see
++L<perlfunc/system>.
++
++=item tan
++
++This is identical to the C function C<tan()>, returning the
++tangent of the numerical argument. See also L<Math::Trig>.
++
++=item tanh
++
++This is identical to the C function C<tanh()>, returning the
++hyperbolic tangent of the numerical argument. See also L<Math::Trig>.
++
++=item tcdrain
++
++This is similar to the C function C<tcdrain()> for draining
++the output queue of its argument stream.
++
++Returns C<undef> on failure.
++
++=item tcflow
++
++This is similar to the C function C<tcflow()> for controlling
++the flow of its argument stream.
++
++Returns C<undef> on failure.
++
++=item tcflush
++
++This is similar to the C function C<tcflush()> for flushing
++the I/O buffers of its argument stream.
++
++Returns C<undef> on failure.
++
++=item tcgetpgrp
++
++This is identical to the C function C<tcgetpgrp()> for returning the
++process group identifier of the foreground process group of the controlling
++terminal.
++
++=item tcsendbreak
++
++This is similar to the C function C<tcsendbreak()> for sending
++a break on its argument stream.
++
++Returns C<undef> on failure.
++
++=item tcsetpgrp
++
++This is similar to the C function C<tcsetpgrp()> for setting the
++process group identifier of the foreground process group of the controlling
++terminal.
++
++Returns C<undef> on failure.
++
++=item time
++
++This is identical to Perl's builtin C<time()> function
++for returning the number of seconds since the epoch
++(whatever it is for the system), see L<perlfunc/time>.
++
++=item times
++
++The times() function returns elapsed realtime since some point in the past
++(such as system startup), user and system times for this process, and user
++and system times used by child processes. All times are returned in clock
++ticks.
++
++ ($realtime, $user, $system, $cuser, $csystem) = POSIX::times();
++
++Note: Perl's builtin C<times()> function returns four values, measured in
++seconds.
++
++=item tmpfile
++
++Use method C<IO::File::new_tmpfile()> instead, or see L<File::Temp>.
++
++=item tmpnam
++
++Returns a name for a temporary file.
++
++ $tmpfile = POSIX::tmpnam();
++
++For security reasons, which are probably detailed in your system's
++documentation for the C library tmpnam() function, this interface
++should not be used; instead see L<File::Temp>.
++
++=item tolower
++
++This is identical to the C function, except that it can apply to a single
++character or to a whole string. Consider using the C<lc()> function,
++see L<perlfunc/lc>, or the equivalent C<\L> operator inside doublequotish
++strings.
++
++=item toupper
++
++This is identical to the C function, except that it can apply to a single
++character or to a whole string. Consider using the C<uc()> function,
++see L<perlfunc/uc>, or the equivalent C<\U> operator inside doublequotish
++strings.
++
++=item ttyname
++
++This is identical to the C function C<ttyname()> for returning the
++name of the current terminal.
++
++=item tzname
++
++Retrieves the time conversion information from the C<tzname> variable.
++
++ POSIX::tzset();
++ ($std, $dst) = POSIX::tzname();
++
++=item tzset
++
++This is identical to the C function C<tzset()> for setting
++the current timezone based on the environment variable C<TZ>,
++to be used by C<ctime()>, C<localtime()>, C<mktime()>, and C<strftime()>
++functions.
++
++=item umask
++
++This is identical to Perl's builtin C<umask()> function
++for setting (and querying) the file creation permission mask,
++see L<perlfunc/umask>.
++
++=item uname
++
++Get name of current operating system.
++
++ ($sysname, $nodename, $release, $version, $machine) = POSIX::uname();
++
++Note that the actual meanings of the various fields are not
++that well standardized, do not expect any great portability.
++The C<$sysname> might be the name of the operating system,
++the C<$nodename> might be the name of the host, the C<$release>
++might be the (major) release number of the operating system,
++the C<$version> might be the (minor) release number of the
++operating system, and the C<$machine> might be a hardware identifier.
++Maybe.
++
++=item ungetc
++
++Use method C<IO::Handle::ungetc()> instead.
++
++=item unlink
++
++This is identical to Perl's builtin C<unlink()> function
++for removing files, see L<perlfunc/unlink>.
++
++=item utime
++
++This is identical to Perl's builtin C<utime()> function
++for changing the time stamps of files and directories,
++see L<perlfunc/utime>.
++
++=item vfprintf
++
++vfprintf() is C-specific, see L<perlfunc/printf> instead.
++
++=item vprintf
++
++vprintf() is C-specific, see L<perlfunc/printf> instead.
++
++=item vsprintf
++
++vsprintf() is C-specific, see L<perlfunc/sprintf> instead.
++
++=item wait
++
++This is identical to Perl's builtin C<wait()> function,
++see L<perlfunc/wait>.
++
++=item waitpid
++
++Wait for a child process to change state. This is identical to Perl's
++builtin C<waitpid()> function, see L<perlfunc/waitpid>.
++
++ $pid = POSIX::waitpid( -1, POSIX::WNOHANG );
++ print "status = ", ($? / 256), "\n";
++
++=item wcstombs
++
++This is identical to the C function C<wcstombs()>.
++Perl does not have any support for the wide and multibyte
++characters of the C standards, so this might be a rather
++useless function.
++
++=item wctomb
++
++This is identical to the C function C<wctomb()>.
++Perl does not have any support for the wide and multibyte
++characters of the C standards, so this might be a rather
++useless function.
++
++=item write
++
++Write to a file. This uses file descriptors such as those obtained by
++calling C<POSIX::open>.
++
++ $fd = POSIX::open( "foo", &POSIX::O_WRONLY );
++ $buf = "hello";
++ $bytes = POSIX::write( $fd, $buf, 5 );
++
++Returns C<undef> on failure.
++
++See also L<perlfunc/syswrite>.
++
++=back
++
++=head1 CLASSES
++
++=head2 POSIX::SigAction
++
++=over 8
++
++=item new
++
++Creates a new C<POSIX::SigAction> object which corresponds to the C
++C<struct sigaction>. This object will be destroyed automatically when
++it is no longer needed. The first parameter is the handler, a sub
++reference. The second parameter is a C<POSIX::SigSet> object, it
++defaults to the empty set. The third parameter contains the
++C<sa_flags>, it defaults to 0.
++
++ $sigset = POSIX::SigSet->new(SIGINT, SIGQUIT);
++ $sigaction = POSIX::SigAction->new( \&handler, $sigset, &POSIX::SA_NOCLDSTOP );
++
++This C<POSIX::SigAction> object is intended for use with the C<POSIX::sigaction()>
++function.
++
++=back
++
++=over 8
++
++=item handler
++
++=item mask
++
++=item flags
++
++accessor functions to get/set the values of a SigAction object.
++
++ $sigset = $sigaction->mask;
++ $sigaction->flags(&POSIX::SA_RESTART);
++
++=item safe
++
++accessor function for the "safe signals" flag of a SigAction object; see
++L<perlipc> for general information on safe (a.k.a. "deferred") signals. If
++you wish to handle a signal safely, use this accessor to set the "safe" flag
++in the C<POSIX::SigAction> object:
++
++ $sigaction->safe(1);
++
++You may also examine the "safe" flag on the output action object which is
++filled in when given as the third parameter to C<POSIX::sigaction()>:
++
++ sigaction(SIGINT, $new_action, $old_action);
++ if ($old_action->safe) {
++ # previous SIGINT handler used safe signals
++ }
++
++=back
++
++=head2 POSIX::SigRt
++
++=over 8
++
++=item %SIGRT
++
++A hash of the POSIX realtime signal handlers. It is an extension of
++the standard %SIG, the $POSIX::SIGRT{SIGRTMIN} is roughly equivalent
++to $SIG{SIGRTMIN}, but the right POSIX moves (see below) are made with
++the POSIX::SigSet and POSIX::sigaction instead of accessing the %SIG.
++
++You can set the %POSIX::SIGRT elements to set the POSIX realtime
++signal handlers, use C<delete> and C<exists> on the elements, and use
++C<scalar> on the C<%POSIX::SIGRT> to find out how many POSIX realtime
++signals there are available (SIGRTMAX - SIGRTMIN + 1, the SIGRTMAX is
++a valid POSIX realtime signal).
++
++Setting the %SIGRT elements is equivalent to calling this:
++
++ sub new {
++ my ($rtsig, $handler, $flags) = @_;
++ my $sigset = POSIX::SigSet($rtsig);
++ my $sigact = POSIX::SigAction->new($handler, $sigset, $flags);
++ sigaction($rtsig, $sigact);
++ }
++
++The flags default to zero, if you want something different you can
++either use C<local> on $POSIX::SigRt::SIGACTION_FLAGS, or you can
++derive from POSIX::SigRt and define your own C<new()> (the tied hash
++STORE method of the %SIGRT calls C<new($rtsig, $handler, $SIGACTION_FLAGS)>,
++where the $rtsig ranges from zero to SIGRTMAX - SIGRTMIN + 1).
++
++Just as with any signal, you can use sigaction($rtsig, undef, $oa) to
++retrieve the installed signal handler (or, rather, the signal action).
++
++B<NOTE:> whether POSIX realtime signals really work in your system, or
++whether Perl has been compiled so that it works with them, is outside
++of this discussion.
++
++=item SIGRTMIN
++
++Return the minimum POSIX realtime signal number available, or C<undef>
++if no POSIX realtime signals are available.
++
++=item SIGRTMAX
++
++Return the maximum POSIX realtime signal number available, or C<undef>
++if no POSIX realtime signals are available.
++
++=back
++
++=head2 POSIX::SigSet
++
++=over 8
++
++=item new
++
++Create a new SigSet object. This object will be destroyed automatically
++when it is no longer needed. Arguments may be supplied to initialize the
++set.
++
++Create an empty set.
++
++ $sigset = POSIX::SigSet->new;
++
++Create a set with SIGUSR1.
++
++ $sigset = POSIX::SigSet->new( &POSIX::SIGUSR1 );
++
++=item addset
++
++Add a signal to a SigSet object.
++
++ $sigset->addset( &POSIX::SIGUSR2 );
++
++Returns C<undef> on failure.
++
++=item delset
++
++Remove a signal from the SigSet object.
++
++ $sigset->delset( &POSIX::SIGUSR2 );
++
++Returns C<undef> on failure.
++
++=item emptyset
++
++Initialize the SigSet object to be empty.
++
++ $sigset->emptyset();
++
++Returns C<undef> on failure.
++
++=item fillset
++
++Initialize the SigSet object to include all signals.
++
++ $sigset->fillset();
++
++Returns C<undef> on failure.
++
++=item ismember
++
++Tests the SigSet object to see if it contains a specific signal.
++
++ if( $sigset->ismember( &POSIX::SIGUSR1 ) ){
++ print "contains SIGUSR1\n";
++ }
++
++=back
++
++=head2 POSIX::Termios
++
++=over 8
++
++=item new
++
++Create a new Termios object. This object will be destroyed automatically
++when it is no longer needed. A Termios object corresponds to the termios
++C struct. new() mallocs a new one, getattr() fills it from a file descriptor,
++and setattr() sets a file descriptor's parameters to match Termios' contents.
++
++ $termios = POSIX::Termios->new;
++
++=item getattr
++
++Get terminal control attributes.
++
++Obtain the attributes for stdin.
++
++ $termios->getattr( 0 ) # Recommended for clarity.
++ $termios->getattr()
++
++Obtain the attributes for stdout.
++
++ $termios->getattr( 1 )
++
++Returns C<undef> on failure.
++
++=item getcc
++
++Retrieve a value from the c_cc field of a termios object. The c_cc field is
++an array so an index must be specified.
++
++ $c_cc[1] = $termios->getcc(1);
++
++=item getcflag
++
++Retrieve the c_cflag field of a termios object.
++
++ $c_cflag = $termios->getcflag;
++
++=item getiflag
++
++Retrieve the c_iflag field of a termios object.
++
++ $c_iflag = $termios->getiflag;
++
++=item getispeed
++
++Retrieve the input baud rate.
++
++ $ispeed = $termios->getispeed;
++
++=item getlflag
++
++Retrieve the c_lflag field of a termios object.
++
++ $c_lflag = $termios->getlflag;
++
++=item getoflag
++
++Retrieve the c_oflag field of a termios object.
++
++ $c_oflag = $termios->getoflag;
++
++=item getospeed
++
++Retrieve the output baud rate.
++
++ $ospeed = $termios->getospeed;
++
++=item setattr
++
++Set terminal control attributes.
++
++Set attributes immediately for stdout.
++
++ $termios->setattr( 1, &POSIX::TCSANOW );
++
++Returns C<undef> on failure.
++
++=item setcc
++
++Set a value in the c_cc field of a termios object. The c_cc field is an
++array so an index must be specified.
++
++ $termios->setcc( &POSIX::VEOF, 1 );
++
++=item setcflag
++
++Set the c_cflag field of a termios object.
++
++ $termios->setcflag( $c_cflag | &POSIX::CLOCAL );
++
++=item setiflag
++
++Set the c_iflag field of a termios object.
++
++ $termios->setiflag( $c_iflag | &POSIX::BRKINT );
++
++=item setispeed
++
++Set the input baud rate.
++
++ $termios->setispeed( &POSIX::B9600 );
++
++Returns C<undef> on failure.
++
++=item setlflag
++
++Set the c_lflag field of a termios object.
++
++ $termios->setlflag( $c_lflag | &POSIX::ECHO );
++
++=item setoflag
++
++Set the c_oflag field of a termios object.
++
++ $termios->setoflag( $c_oflag | &POSIX::OPOST );
++
++=item setospeed
++
++Set the output baud rate.
++
++ $termios->setospeed( &POSIX::B9600 );
++
++Returns C<undef> on failure.
++
++=item Baud rate values
++
++B38400 B75 B200 B134 B300 B1800 B150 B0 B19200 B1200 B9600 B600 B4800 B50 B2400 B110
++
++=item Terminal interface values
++
++TCSADRAIN TCSANOW TCOON TCIOFLUSH TCOFLUSH TCION TCIFLUSH TCSAFLUSH TCIOFF TCOOFF
++
++=item c_cc field values
++
++VEOF VEOL VERASE VINTR VKILL VQUIT VSUSP VSTART VSTOP VMIN VTIME NCCS
++
++=item c_cflag field values
++
++CLOCAL CREAD CSIZE CS5 CS6 CS7 CS8 CSTOPB HUPCL PARENB PARODD
++
++=item c_iflag field values
++
++BRKINT ICRNL IGNBRK IGNCR IGNPAR INLCR INPCK ISTRIP IXOFF IXON PARMRK
++
++=item c_lflag field values
++
++ECHO ECHOE ECHOK ECHONL ICANON IEXTEN ISIG NOFLSH TOSTOP
++
++=item c_oflag field values
++
++OPOST
++
++=back
++
++=head1 PATHNAME CONSTANTS
++
++=over 8
++
++=item Constants
++
++_PC_CHOWN_RESTRICTED _PC_LINK_MAX _PC_MAX_CANON _PC_MAX_INPUT _PC_NAME_MAX _PC_NO_TRUNC _PC_PATH_MAX _PC_PIPE_BUF _PC_VDISABLE
++
++=back
++
++=head1 POSIX CONSTANTS
++
++=over 8
++
++=item Constants
++
++_POSIX_ARG_MAX _POSIX_CHILD_MAX _POSIX_CHOWN_RESTRICTED _POSIX_JOB_CONTROL _POSIX_LINK_MAX _POSIX_MAX_CANON _POSIX_MAX_INPUT _POSIX_NAME_MAX _POSIX_NGROUPS_MAX _POSIX_NO_TRUNC _POSIX_OPEN_MAX _POSIX_PATH_MAX _POSIX_PIPE_BUF _POSIX_SAVED_IDS _POSIX_SSIZE_MAX _POSIX_STREAM_MAX _POSIX_TZNAME_MAX _POSIX_VDISABLE _POSIX_VERSION
++
++=back
++
++=head1 SYSTEM CONFIGURATION
++
++=over 8
++
++=item Constants
++
++_SC_ARG_MAX _SC_CHILD_MAX _SC_CLK_TCK _SC_JOB_CONTROL _SC_NGROUPS_MAX _SC_OPEN_MAX _SC_PAGESIZE _SC_SAVED_IDS _SC_STREAM_MAX _SC_TZNAME_MAX _SC_VERSION
++
++=back
++
++=head1 ERRNO
++
++=over 8
++
++=item Constants
++
++E2BIG EACCES EADDRINUSE EADDRNOTAVAIL EAFNOSUPPORT EAGAIN EALREADY EBADF
++EBUSY ECHILD ECONNABORTED ECONNREFUSED ECONNRESET EDEADLK EDESTADDRREQ
++EDOM EDQUOT EEXIST EFAULT EFBIG EHOSTDOWN EHOSTUNREACH EINPROGRESS EINTR
++EINVAL EIO EISCONN EISDIR ELOOP EMFILE EMLINK EMSGSIZE ENAMETOOLONG
++ENETDOWN ENETRESET ENETUNREACH ENFILE ENOBUFS ENODEV ENOENT ENOEXEC
++ENOLCK ENOMEM ENOPROTOOPT ENOSPC ENOSYS ENOTBLK ENOTCONN ENOTDIR
++ENOTEMPTY ENOTSOCK ENOTTY ENXIO EOPNOTSUPP EPERM EPFNOSUPPORT EPIPE
++EPROCLIM EPROTONOSUPPORT EPROTOTYPE ERANGE EREMOTE ERESTART EROFS
++ESHUTDOWN ESOCKTNOSUPPORT ESPIPE ESRCH ESTALE ETIMEDOUT ETOOMANYREFS
++ETXTBSY EUSERS EWOULDBLOCK EXDEV
++
++=back
++
++=head1 FCNTL
++
++=over 8
++
++=item Constants
++
++FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_OK F_RDLCK F_SETFD F_SETFL F_SETLK F_SETLKW F_UNLCK F_WRLCK O_ACCMODE O_APPEND O_CREAT O_EXCL O_NOCTTY O_NONBLOCK O_RDONLY O_RDWR O_TRUNC O_WRONLY
++
++=back
++
++=head1 FLOAT
++
++=over 8
++
++=item Constants
++
++DBL_DIG DBL_EPSILON DBL_MANT_DIG DBL_MAX DBL_MAX_10_EXP DBL_MAX_EXP DBL_MIN DBL_MIN_10_EXP DBL_MIN_EXP FLT_DIG FLT_EPSILON FLT_MANT_DIG FLT_MAX FLT_MAX_10_EXP FLT_MAX_EXP FLT_MIN FLT_MIN_10_EXP FLT_MIN_EXP FLT_RADIX FLT_ROUNDS LDBL_DIG LDBL_EPSILON LDBL_MANT_DIG LDBL_MAX LDBL_MAX_10_EXP LDBL_MAX_EXP LDBL_MIN LDBL_MIN_10_EXP LDBL_MIN_EXP
++
++=back
++
++=head1 LIMITS
++
++=over 8
++
++=item Constants
++
++ARG_MAX CHAR_BIT CHAR_MAX CHAR_MIN CHILD_MAX INT_MAX INT_MIN LINK_MAX LONG_MAX LONG_MIN MAX_CANON MAX_INPUT MB_LEN_MAX NAME_MAX NGROUPS_MAX OPEN_MAX PATH_MAX PIPE_BUF SCHAR_MAX SCHAR_MIN SHRT_MAX SHRT_MIN SSIZE_MAX STREAM_MAX TZNAME_MAX UCHAR_MAX UINT_MAX ULONG_MAX USHRT_MAX
++
++=back
++
++=head1 LOCALE
++
++=over 8
++
++=item Constants
++
++LC_ALL LC_COLLATE LC_CTYPE LC_MONETARY LC_NUMERIC LC_TIME
++
++=back
++
++=head1 MATH
++
++=over 8
++
++=item Constants
++
++HUGE_VAL
++
++=back
++
++=head1 SIGNAL
++
++=over 8
++
++=item Constants
++
++SA_NOCLDSTOP SA_NOCLDWAIT SA_NODEFER SA_ONSTACK SA_RESETHAND SA_RESTART
++SA_SIGINFO SIGABRT SIGALRM SIGCHLD SIGCONT SIGFPE SIGHUP SIGILL SIGINT
++SIGKILL SIGPIPE SIGQUIT SIGSEGV SIGSTOP SIGTERM SIGTSTP SIGTTIN SIGTTOU
++SIGUSR1 SIGUSR2 SIG_BLOCK SIG_DFL SIG_ERR SIG_IGN SIG_SETMASK
++SIG_UNBLOCK
++
++=back
++
++=head1 STAT
++
++=over 8
++
++=item Constants
++
++S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU S_ISGID S_ISUID S_IWGRP S_IWOTH S_IWUSR S_IXGRP S_IXOTH S_IXUSR
++
++=item Macros
++
++S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISREG
++
++=back
++
++=head1 STDLIB
++
++=over 8
++
++=item Constants
++
++EXIT_FAILURE EXIT_SUCCESS MB_CUR_MAX RAND_MAX
++
++=back
++
++=head1 STDIO
++
++=over 8
++
++=item Constants
++
++BUFSIZ EOF FILENAME_MAX L_ctermid L_cuserid L_tmpname TMP_MAX
++
++=back
++
++=head1 TIME
++
++=over 8
++
++=item Constants
++
++CLK_TCK CLOCKS_PER_SEC
++
++=back
++
++=head1 UNISTD
++
++=over 8
++
++=item Constants
++
++R_OK SEEK_CUR SEEK_END SEEK_SET STDIN_FILENO STDOUT_FILENO STDERR_FILENO W_OK X_OK
++
++=back
++
++=head1 WAIT
++
++=over 8
++
++=item Constants
++
++WNOHANG WUNTRACED
++
++=over 16
++
++=item WNOHANG
++
++Do not suspend the calling process until a child process
++changes state but instead return immediately.
++
++=item WUNTRACED
++
++Catch stopped child processes.
++
++=back
++
++=item Macros
++
++WIFEXITED WEXITSTATUS WIFSIGNALED WTERMSIG WIFSTOPPED WSTOPSIG
++
++=over 16
++
++=item WIFEXITED
++
++WIFEXITED($?) returns true if the child process exited normally
++(C<exit()> or by falling off the end of C<main()>)
++
++=item WEXITSTATUS
++
++WEXITSTATUS($?) returns the normal exit status of the child process
++(only meaningful if WIFEXITED($?) is true)
++
++=item WIFSIGNALED
++
++WIFSIGNALED($?) returns true if the child process terminated because
++of a signal
++
++=item WTERMSIG
++
++WTERMSIG($?) returns the signal the child process terminated for
++(only meaningful if WIFSIGNALED($?) is true)
++
++=item WIFSTOPPED
++
++WIFSTOPPED($?) returns true if the child process is currently stopped
++(can happen only if you specified the WUNTRACED flag to waitpid())
++
++=item WSTOPSIG
++
++WSTOPSIG($?) returns the signal the child process was stopped for
++(only meaningful if WIFSTOPPED($?) is true)
++
++=back
++
++=back
++
diff --git a/meta/recipes-devtools/perl/perl-native_5.12.2.bb b/meta/recipes-devtools/perl/perl-native_5.12.2.bb
index 5996494..cd21e9e 100644
--- a/meta/recipes-devtools/perl/perl-native_5.12.2.bb
+++ b/meta/recipes-devtools/perl/perl-native_5.12.2.bb
@@ -4,7 +4,7 @@ SECTION = "libs"
LICENSE = "Artistic|GPL"
LIC_FILES_CHKSUM = "file://Copying;md5=2b4c6ffbcfcbdee469f02565f253d81a \
file://Artistic;md5=f921793d03cc6d63ec4b15e9be8fd3f8"
-PR = "r5"
+PR = "r6"

LIC_FILES_CHKSUM = "file://Copying;md5=2b4c6ffbcfcbdee469f02565f253d81a \
file://Artistic;md5=f921793d03cc6d63ec4b15e9be8fd3f8"
@@ -12,7 +12,9 @@ LIC_FILES_CHKSUM = "file://Copying;md5=2b4c6ffbcfcbdee469f02565f253d81a \
SRC_URI = "http://ftp.funet.fi/pub/CPAN/src/perl-${PV}.tar.gz \
file://Configure-multilib.patch;patch=1 \
file://perl-configpm-switch.patch;patch=1 \
- file://parallel_build_fix.patch \
+ file://parallel_build_fix_1.patch \
+ file://parallel_build_fix_2.patch \
+ file://parallel_build_fix_3.patch \
file://native-nopacklist.patch;patch=1 \
file://native-perlinc.patch;patch=1"

diff --git a/meta/recipes-devtools/perl/perl_5.12.2.bb b/meta/recipes-devtools/perl/perl_5.12.2.bb
index e659152..18fad18 100644
--- a/meta/recipes-devtools/perl/perl_5.12.2.bb
+++ b/meta/recipes-devtools/perl/perl_5.12.2.bb
@@ -8,7 +8,7 @@ PRIORITY = "optional"
# We need gnugrep (for -I)
DEPENDS = "virtual/db perl-native-${PV} grep-native"
DEPENDS += "gdbm zlib"
-PR = "r1"
+PR = "r2"

# 5.10.1 has Module::Build built-in
PROVIDES += "libmodule-build-perl"
@@ -18,7 +18,9 @@ PROVIDES += "libmodule-build-perl"

SRC_URI = "ftp://ftp.funet.fi/pub/CPAN/src/perl-${PV}.tar.gz \
file://Makefile.patch;patch=1 \
- file://parallel_build_fix.patch \
+ file://parallel_build_fix_1.patch \
+ file://parallel_build_fix_2.patch \
+ file://parallel_build_fix_3.patch \
file://Makefile.SH.patch;patch=1 \
file://installperl.patch;patch=1 \
file://perl-dynloader.patch;patch=1 \
--
1.6.6.1