## NAME

ACE_FIFO_Recv_Msg - Receiver side for the record oriented C++ wrapper for UNIX FIFOs.

## SYNOPSIS

    #include <ace/FIFO_Recv_Msg.h>

    class ACE_FIFO_Recv_Msg : public ACE_FIFO_Recv
    {
      public:
        ACE_FIFO_Recv_Msg (void);
        ACE_FIFO_Recv_Msg (
            const ASYS_TCHAR *rendezvous,
            int flags = O_CREAT | O_RDONLY,
            int perms = ACE_DEFAULT_FILE_PERMS,
            int persistent = 1,
            LPSECURITY_ATTRIBUTES sa = 0
            );
        int open (
            const ASYS_TCHAR *rendezvous,
            int flags = O_CREAT | O_RDONLY,
            int perms = ACE_DEFAULT_FILE_PERMS,
            int persistent = 1,
            LPSECURITY_ATTRIBUTES sa = 0
            );
        ssize_t recv (ACE_Str_Buf &msg);
        ssize_t recv (void *buf, size_t len);
        ssize_t recv (ACE_Str_Buf *data, ACE_Str_Buf *cntl, int *flags);
        ssize_t recv (
            int *band,
            ACE_Str_Buf *data,
            ACE_Str_Buf *cntl,
            int *flags
            );
        void dump (void) const;
        ACE_ALLOC_HOOK_DECLARE;
    };

## Initialization methods.

    ACE_FIFO_Recv_Msg (void);

Default constructor.

    ACE_FIFO_Recv_Msg (
        const ASYS_TCHAR *rendezvous,
        int flags = O_CREAT | O_RDONLY,
        int perms = ACE_DEFAULT_FILE_PERMS,
        int persistent = 1,
        LPSECURITY_ATTRIBUTES sa = 0
        );

Open up a record-oriented named pipe for reading.

    int open (
        const ASYS_TCHAR *rendezvous,
        int flags = O_CREAT | O_RDONLY,
        int perms = ACE_DEFAULT_FILE_PERMS,
        int persistent = 1,
        LPSECURITY_ATTRIBUTES sa = 0
        );

Open up a record-oriented named pipe for reading.

    ssize_t recv (ACE_Str_Buf &msg);

Recv `msg` as an ACE_Str_Buf.

    ssize_t recv (void *buf, size_t len);

Recv `msg` as a buffer.

    ssize_t recv (ACE_Str_Buf *data, ACE_Str_Buf *cntl, int *flags);

Recv `data` and `cntl` message via Stream pipes.

    ssize_t recv (
        int *band,
        ACE_Str_Buf *data,
        ACE_Str_Buf *cntl,
        int *flags
        );

Recv `data` and `cntl` message via Stream pipes in "band" mode.

    void dump (void) const;

Dump the state of an object.

    ACE_ALLOC_HOOK_DECLARE;

Declare the dynamic allocation hooks.

## AUTHOR

Doug Schmidt

## LIBRARY

ace