NAME

IO::FDpassData - send/receive data and/or file descriptor

SYNOPSIS

            

              
              
use IO::FDpassData;
$bytessent = fd_sendata(socket, message, FD);
($bytesrcvd, message, FD) = fd_rcvdata(socket, $maxsize);
            
          

DESCRIPTION

This module will send and receive data and/or a file descriptor locally over a unix pipe.

• $bytessent = fd_sendata(socket, message, FD);

  
              
  
                
                
   input: socket file descriptor,
     {optional}   message,                may be zero length string
     {optional}   file descriptor         to send to other process
  NOTE: optional message may be 'undef' or zero length string
        optional FD may be omitted, 'undef'
   returns:       bytes sent
      or -1 on error
              
            

• ($bytesrcvd, message, FD) = fd_rcvdata(socket, $maxsize);

  
              
  
                
                
  input:  socket file descriptor,
  maximum length to receive       overrun will cause segfault??
  returns:        msg bytes received,             or -1 on error
  message,                may be zero a length string
    {optional}    file descriptor or undef
              
            

EXPORTS

            

              
              
fd_sendata
fd_recvdata
            
          

COPYRIGHT

Copyright Michael Robinton 2019

CREDITS

This package was inspired by an article published by Keith Packard https://keithp.com/blogs/fd-passing/ and the package IO::FDpass written by Marc A. Lehmann

SHORTCOMINGS

At the present time this package does not support Windows. Patches welcome.

LICENSE

This is free software; you can redistribute it and/or modify it under the terms of either:

a) the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or

b) the "Artistic License".

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.