prt_packet.h File Reference

PRT data packet. More...

#include "prt.h"

Include dependency graph for prt_packet.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	prt_packet_s
	VDP's data packet A packet of data transferred through VDP's channels. More...

Typedefs
typedef struct prt_packet_s	prt_packet_t
	VDP's data packet A packet of data transferred through VDP's channels. More...

Functions
prt_packet_t *	prt_packet_new (size_t data_size)
	packet constructor Sets the number of references to one. More...
void	prt_packet_release (prt_packet_t *packet)
	Release a packet. Decrements the number of active references. Destroys the packet when the last reference is removed. More...

Detailed Description

PRT data packet.

Author

Jakub Kurzak

PULSAR Runtime /pulsar/ Copyright (C) 2012-2013 University of Tennessee.

Definition in file prt_packet.h.

Typedef Documentation

typedef struct prt_packet_s prt_packet_t

VDP's data packet A packet of data transferred through VDP's channels.

Function Documentation

prt_packet_t* prt_packet_new

(

size_t

data_size

)

packet constructor Sets the number of references to one.

Parameters

data_size

size of the packet in bytes

Returns

new packet

Definition at line 22 of file prt_packet.c.

References prt_packet_s::data, prt_packet_s::num_refs, and prt_assert.

{
    prt_packet_t *packet = (prt_packet_t*)malloc(sizeof(prt_packet_t));
    prt_assert(packet != NULL, "malloc failed");

    packet->data = malloc(data_size);
    prt_assert(packet->data != NULL, "malloc failed");

    packet->num_refs = 1;
    return packet;
}

Here is the caller graph for this function:

void prt_packet_release

(

prt_packet_t *

packet

)

Release a packet. Decrements the number of active references. Destroys the packet when the last reference is removed.

Parameters

packet

Definition at line 42 of file prt_packet.c.

References prt_packet_s::data, prt_packet_s::num_refs, and prt_assert.

{
    int num_refs = __sync_sub_and_fetch(&packet->num_refs, 1);
    prt_assert(num_refs >= 0, "negative number of data references");
    if (num_refs == 0) {
        free(packet->data);
        free(packet);
    }
}

Here is the caller graph for this function: