PhLinkTransportData()

Add transport data to a linked list

Synopsis:

PhTransportLink_t * 
   PhLinkTransportData(
       PhTransportLink_t **first_link,
       PhTransportLink_t **last_link,
       char const * const data,
       int unsigned const size,
       iov_t *iovs,
       int unsigned const niovs );

Library:

ph

Description:

This function allocates a PhTransportLink_t structure and fills it in using the data, size, iovs, and niovs arguments. It then adds the new structure to the end of the linked list whose head is pointed to by first_link and whose tail is pointed to by last_link.

This function is used to build the linked list of data in a PhTransportCtrl_t structure.

Returns:

A pointer to the PhTransportLink_t structure, or NULL if there wasn't enough memory.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PhCreateTransportCtrl(), PhTransportCtrl_t, PhTransportFindLink(), PhTransportLink_t, PhTransportType()

Drag and Drop chapter of the Photon Programmer's Guide