Manual Pages for UNIX Operating System command usage for man posix_spawn_file_actions_adddup2

Standard C Library Functions
                             posix_spawn_file_actions_adddup2(3C)



NAME
     posix_spawn_file_actions_adddup2 - add dup2 action to  spawn
     file actions object

SYNOPSIS
     #include 

     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   adds   a
     dup2(3C)  action  to  the  object referenced by file_actions
     that causes 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(3C).

RETURN VALUES
     Upon          successful           completion,           the
     posix_spawn_file_actions_adddup2()  function returns 0. Oth-
     erwise, an error number  is  be  returned  to  indicate  the
     error.

ERRORS
     The posix_spawn_file_actions_adddup2()  function  will  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 is not considered an error for the fildes argument passed
     to  posix_spawn_file_actions_adddup2()  to  specify  a  file



SunOS 5.11          Last change: 30 Jan 2004                    1






Standard C Library Functions
                             posix_spawn_file_actions_adddup2(3C)



     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(3C) or posix_spawnp(3C) operation.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     dup2(3C),                                   posix_spawn(3C),
     posix_spawn_file_actions_addclose(3C),
     posix_spawn_file_actions_destroy(3C),  attributes(5),  stan-
     dards(5)



























SunOS 5.11          Last change: 30 Jan 2004                    2






Standard C Library Functions
                             posix_spawn_file_actions_adddup2(3C)






















































SunOS 5.11          Last change: 30 Jan 2004                    3