GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  POE::DRIVER::SYSRW (3)

.ds Aq ’

NAME

POE::Driver::SysRW - buffered, non-blocking I/O using sysread and syswrite

CONTENTS

SYNOPSIS

SYNOPSIS in POE::Driver illustrates how the interface works. This module is merely one implementation.

DESCRIPTION

This driver implements POE::Driver using sysread and syswrite.

PUBLIC METHODS

POE::Driver::SysRW introduces some additional features not covered in the base interface.

    new [BlockSize => OCTETS]

new() creates a new buffered I/O driver that uses sysread() to read data from a handle and syswrite() to flush data to that handle. The constructor accepts one optional named parameter, BlockSize, which indicates the maximum number of OCTETS that will be read at one time.

BlockSize is 64 kilobytes (65536 octets) by default. Higher values may improve performance in streaming applications, but the trade-off is a lower event granularity and increased resident memory usage.

Lower BlockSize values reduce memory consumption somewhat with corresponding throughput penalties.



  my $driver = POE::Driver::SysRW->new;

  my $driver = POE::Driver::SysRW->new( BlockSize => $block_size );



Drivers are commonly instantiated within POE::Wheel constructor calls:



  $_[HEAP]{wheel} = POE::Wheel::ReadWrite->new(
    InputHandle => \*STDIN,
    OutputHandle => \*STDOUT,
    Driver => POE::Driver::SysRW->new(),
    Filter => POE::Filter::Line->new(),
  );



Applications almost always use POE::Driver::SysRW, so POE::Wheel objects almost always will create their own if no Driver is specified.

    All Other Methods

POE::Driver::SysRW documents the abstract interface documented in POE::Driver. Please see POE::Driver for more details about the following methods:
flush
get
get_out_messages_buffered
put

SEE ALSO

POE::Driver, POE::Wheel.

Also see the SEE ALSO section of POE, which contains a brief roadmap of POE’s documentation.

AUTHORS & COPYRIGHTS

Please see POE for more information about authors and contributors.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 POE::DRIVER::SYSRW (3) 2015-06-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.