pod/modpods/Open3.pod

   1 =head1 NAME
   2
   3 IPC::Open3, open3 - open a process for reading, writing, and error handling
   4
   5 =head1 SYNOPSIS
   6
   7     $pid = open3('WTRFH', 'RDRFH', 'ERRFH'
   8                     'some cmd and args', 'optarg', ...);
   9
  10 =head1 DESCRIPTION
  11
  12 Extremely similar to open2(), open3() spawns the given $cmd and
  13 connects RDRFH for reading, WTRFH for writing, and ERRFH for errors.  If
  14 ERRFH is '', or the same as RDRFH, then STDOUT and STDERR of the child are
  15 on the same file handle.
  16
  17 If WTRFH begins with ">&", then WTRFH will be closed in the parent, and
  18 the child will read from it directly.  if RDRFH or ERRFH begins with
  19 ">&", then the child will send output directly to that file handle.  In both
  20 cases, there will be a dup(2) instead of a pipe(2) made.
  21
  22 All caveats from open2() continue to apply.  See L<open2> for details.
  23