posix_spawn_file_actions_adddup2(3p) - phpMan

POSIX_SPAWN_FILE_ACTIONS_ADDDUP2(P)        POSIX_SPAWN_FILE_ACTIONS_ADDDUP2(P)



NAME
       posix_spawn_file_actions_adddup2  -  add  dup2  action to spawn file actions object
       (ADVANCED REALTIME)

SYNOPSIS
       #include <spawn.h>

       int posix_spawn_file_actions_adddup2(posix_spawn_file_actions_t *
              file_actions, int fildes, int newfildes);


DESCRIPTION
       The posix_spawn_file_actions_adddup2() function shall add a dup2()  action  to  the
       object referenced by file_actions that shall cause the file descriptor fildes to be
       duplicated as newfildes (as if dup2( fildes, newfildes) had been called) when a new
       process is spawned using this file actions object.

       A  spawn file actions object is as defined in posix_spawn_file_actions_addclose() .

RETURN VALUE
       Upon successful completion, the posix_spawn_file_actions_adddup2()  function  shall
       return zero; otherwise, an error number shall be returned to indicate the error.

ERRORS
       The posix_spawn_file_actions_adddup2() function shall fail if:

       EBADF  The  value  specified  by fildes or newfildes is negative or greater than or
              equal to {OPEN_MAX}.

       ENOMEM Insufficient memory exists to add to the spawn file actions object.


       The posix_spawn_file_actions_adddup2() function may fail if:

       EINVAL The value specified by file_actions is invalid.


       It shall not be  considered  an  error  for  the  fildes  argument  passed  to  the
       posix_spawn_file_actions_adddup2()  function to specify a file descriptor for which
       the specified operation could not be performed at the time of the  call.  Any  such
       error will be detected when the associated file actions object is later used during
       a posix_spawn() or posix_spawnp() operation.

       The following sections are informative.

EXAMPLES
       None.

APPLICATION USAGE
       The posix_spawn_file_actions_adddup2() function is part of  the  Spawn  option  and
       need not be provided on all implementations.

RATIONALE
       Refer to the RATIONALE in posix_spawn_file_actions_addclose() .

FUTURE DIRECTIONS
       None.

SEE ALSO
       dup()      ,      posix_spawn()     ,     posix_spawn_file_actions_addclose()     ,
       posix_spawn_file_actions_destroy() , posix_spawnp() , the Base  Definitions  volume
       of IEEE Std 1003.1-2001, <spawn.h>

COPYRIGHT
       Portions of this text are reprinted and reproduced in electronic form from IEEE Std
       1003.1, 2003 Edition, Standard for Information  Technology  --  Portable  Operating
       System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C)
       2001-2003 by the Institute of Electrical and Electronics  Engineers,  Inc  and  The
       Open  Group.  In the event of any discrepancy between this version and the original
       IEEE and The Open Group Standard, the original IEEE and The Open Group Standard  is
       the   referee   document.   The   original  Standard  can  be  obtained  online  at
       http://www.opengroup.org/unix/online.html .



POSIX                                2003  POSIX_SPAWN_FILE_ACTIONS_ADDDUP2(P)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-10 11:01 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)