1POE::Pipe::OneWay(3)  User Contributed Perl Documentation POE::Pipe::OneWay(3)
2
3
4

NAME

6       POE::Pipe::OneWay - portable one-way pipe creation (works without POE)
7

SYNOPSIS

9         my ($read, $write) = POE::Pipe::OneWay->new();
10         die "couldn't create a pipe: $!" unless defined $read;
11

DESCRIPTION

13       POE::Pipe::OneWay makes unbuffered one-way pipes or it dies trying.
14
15       Pipes are troublesome beasts because the different pipe creation meth‐
16       ods have spotty support from one system to another.  Some systems have
17       "pipe()", others have "socketfactory()", and still others have neither.
18
19       POE::Pipe::OneWay tries different ways to make a pipe in the hope that
20       one of them will succeed on any given platform.  It tries them in
21       pipe() -> socketpair() -> IO::Socket::INET order.
22
23       So anyway, the syntax is pretty easy:
24
25         my ($read, $write) = POE::Pipe::OneWay->new();
26         die "couldn't create a pipe: $!" unless defined $read;
27
28       And now you have a pipe with a read side and a write side.
29

CONSTRUCTOR

31       new
32             my ($read, $write) = POE::Pipe::OneWay->new();
33

DEBUGGING

35       It's possible to force POE::Pipe::OneWay to use one of its underlying
36       pipe methods.  This was implemented for exercising each method in
37       tests, but it's possibly useful for others.
38
39       However, forcing OneWay's pipe method isn't documented because it's
40       cheezy and likely to change.  Use it at your own risk.
41

BUGS

43       The INET domain socket method may block for up to 1s if it fails.
44

46       POE::Pipe::OneWay is copyright 2000 by Rocco Caputo.  All rights
47       reserved.  POE::Pipe::OneWay is free software; you may redistribute it
48       and/or modify it under the same terms as Perl itself.
49
50
51
52perl v5.8.8                       2006-09-01              POE::Pipe::OneWay(3)
Impressum