prg_mem_copy()

Abstract

Copies the contents of a source block of memory into a destination block of memory.

Syntax

prg_mem_copy (from_ptr, to_ptr, size)
Argument Type Description
from_ptr void * Pointer to block of memory to be copied
to_ptr void * Pointer to block of memory to hold copy. [These pointers can point to any data type, from integer to complex data structure. Casting of the passed pointer value is not necessary, since it is performed automatically by the macro which implements the function. However, both source and destination pointers should point to the same data type, so that the destination block of memory is large enough to contain the source block of memory, without waste.]
size size_t Size of the block of memory to be copied, in units of bytes. [The size of a data type can be obtained using the C language pseudo-function sizeof(), as illustrated in the Example section.]

Return Type

void

No return value.

prg_mem_funcs.h

Example

/* receive a packet from the nearest neighbor */
pkptr = op_pk_get (op_intrpt_strm ());

/* extract the log data structure */
op_pk_nfd_get (pkptr, "fd.log", &log_ptr);

/* add information on this node to the log */
log_ptr->node_list [log_ptr->num_nodes] = node_user_id;
log_ptr->num_nodes++;

/* allocate a copy of the log for local use */
local_log_ptr = (Log_DS *) prg_mem_alloc (sizeof (Log_DS));

/* produce the copy */
prg_mem_copy (log_ptr, local_log_ptr, sizeof (Log_DS));

/* send the packet to the next node */
op_pk_send (pkptr, OUT_STRM);

Details

This function can be applied to data structures or simple data types that have been dynamically allocated via prg_mem_alloc(), or statically-defined as state variables or temporary variables. However, it should only be used on user-defined data structures, not Riverbed Modeler-defined data structures such as Packet and Distribution, because a raw copy operation will not have the sophistication necessary to produce a usable duplicate, given the internal data structure accounting and referencing methods (ignoring this warning can lead to simulation errors).

Data structures which contain pointers to other data structures can be copied via this function, but the structures referenced by the pointers are not copied by the raw byte transfer. This does not cause problems if the subsidiary structures that are referenced are not modified. However, if modifications are performed on the subsidiary structures through one copy of the parent structure, all copies are affected. If this is undesired, the user’s process code should scan through the original and copy parent structures, manually copying over subsidiary data structures as well.

Purpose

Provides a mechanism for conveniently creating a duplicate of any type of data structure. This may be useful when a data structure’s contents are created by one process, but will be used by two or more processes.

Errors

  • Program Abort: Segmentation violation. (due to invalid pointer arguments, or either pointer not pointing to a large enough allocated block of memory)
  • Recoverable Error: Invalid size (<size>) specified for memory copy.

Reference

  • use prg_mem_alloc() to allocate a block of memory into which another block’s contents can be copied
  • use prg_mem_free() to deallocate a block of memory

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com