---
name: "xs_msg_copy"
section: "3"
platform: "linux"
package: "libxs-dev"
version: "1.2.0-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/xs_msg_copy"
---

# xs\_msg\_copy(3)

copy content of a message to another message

## NAME

xs\_msg\_copy - copy content of a message to another message

## SYNOPSIS

**int xs\_msg\_copy (xs\_msg\_t** *\*dest***, xs\_msg\_t** *\*src***);**

## DESCRIPTION

The *xs\_msg\_copy()* function shall copy the message object referenced by *src* to the message object referenced by *dest*. The original content of *dest*, if any, shall be released.

**Caution**\

The implementation may choose not to physically copy the message content, rather to share the underlying buffer between *src* and *dest*. Avoid modifying message content after a message has been copied with *xs\_msg\_copy()*, doing so can result in undefined behaviour. If what you need is an actual hard copy, allocate a new message using *xs\_msg\_init\_size()* and copy the message content using *memcpy()*.

**Caution**\

Never access *xs\_msg\_t* members directly, instead always use the *xs\_msg* family of functions.

## RETURN VALUE

The *xs\_msg\_copy()* function shall return zero if successful. Otherwise it shall return -1 and set *errno* to one of the values defined below.

## ERRORS

**EFAULT**

Invalid message.

## SEE ALSO

[**xs\_msg\_move**(3)](/xs_msg_move/3.md) [**xs\_msg\_init**(3)](/xs_msg_init/3.md) [**xs\_msg\_init\_size**(3)](/xs_msg_init_size/3.md) [**xs\_msg\_init\_data**(3)](/xs_msg_init_data/3.md) [**xs\_msg\_close**(3)](/xs_msg_close/3.md) [**xs**(7)](/xs/7.md)

## AUTHORS

The Crossroads documentation was written by Martin Sustrik \<**sustrik@250bpm.com**\[1\]\> and Martin Lucina \<**martin@lucina.net**\[2\]\>.

## NOTES

- 1\.

  sustrik@250bpm.com

  mailto:sustrik@250bpm.com

- 2\.

  martin@lucina.net

  mailto:martin@lucina.net