---
name: "ACE_SV_Message_Queue"
section: "3"
platform: "linux"
package: "libace-doc"
version: "5.0.7-4"
release: "Debian 2.2 (Potato)"
platforms: ["linux"]
url: "https://new.carta.tech/ACE_SV_Message_Queue"
---

# ACE\_SV\_Message\_Queue(3)

Defines the header file for the C++ wrapper for System V IPC message queues.

## NAME

ACE\_SV\_Message\_Queue -  Defines the header file for the C++ wrapper for System V IPC message queues.

## SYNOPSIS

```
#include <ace/SV_Message_Queue.h>
class ACE_SV_Message_Queue
{
  public:
        enum{ ACE_CREATE = IPC_CREAT,
        ACE_OPEN = 0,
        ACE_NOWAIT = IPC_NOWAIT };

    ACE_SV_Message_Queue (void);
    ACE_SV_Message_Queue (
        key_t external_id,
        int create = ACE_SV_Message_Queue::ACE_OPEN,
        int perms = ACE_DEFAULT_FILE_PERMS
        );
    int open (
        key_t external_id,
        int create = ACE_SV_Message_Queue::ACE_OPEN,
        int perms = ACE_DEFAULT_FILE_PERMS
        );
    ~ACE_SV_Message_Queue (void);
    int close (void);
    int remove (void);
    int recv (
        ACE_SV_Message &mb,
        int length,
        long mtype = 0,
        int mflags = 0
        );
    int send (const ACE_SV_Message &mb, int length, int mflags = 0);
    int control (int option, void *arg = 0);
    int get_id (void);
    void set_id (int);
    void dump (void) const;
    ACE_ALLOC_HOOK_DECLARE;
  protected:
    int internal_id_;
};
```

## Useful symbolic constants.

## Initialization and termination methods.

```
ACE_SV_Message_Queue (void);
```

```
ACE_SV_Message_Queue (
    key_t external_id,
    int create = ACE_SV_Message_Queue::ACE_OPEN,
    int perms = ACE_DEFAULT_FILE_PERMS
    );
```

```
int open (
    key_t external_id,
    int create = ACE_SV_Message_Queue::ACE_OPEN,
    int perms = ACE_DEFAULT_FILE_PERMS
    );
```

Open a message queue using the external\_id.

```
~ACE_SV_Message_Queue (void);
```

```
int close (void);
```

Close down this instance of the message queue without removing it from the system.

```
int remove (void);
```

Close down and remove the message queue from the system.

## Message transfer methods.

```
int recv (
    ACE_SV_Message &mb,
    int length,
    long mtype = 0,
    int mflags = 0
    );
```

```
int send (const ACE_SV_Message &mb, int length, int mflags = 0);
```

```
int control (int option, void *arg = 0);
```

Access the underlying control operations.

## Get/set the underly internal id.

```
int get_id (void);
```

```
void set_id (int);
```

```
void dump (void) const;
```

Dump the state of an object.

```
ACE_ALLOC_HOOK_DECLARE;
```

Declare the dynamic allocation hooks.

## AUTHOR

Doug Schmidt

## LIBRARY

ace