diff options
| author | PProvost <[email protected]> | 2020-05-11 08:54:23 -0600 |
|---|---|---|
| committer | PProvost <[email protected]> | 2020-05-11 08:54:23 -0600 |
| commit | 0c4f784459a7564933ed91bf39f00d12608cf91c (patch) | |
| tree | cfa743731d1cfb11d83119bf1c8d0d942e8c3c73 /common/src/nxe_packet_data_append.c | |
Initial commit
Diffstat (limited to 'common/src/nxe_packet_data_append.c')
| -rw-r--r-- | common/src/nxe_packet_data_append.c | 122 |
1 files changed, 122 insertions, 0 deletions
diff --git a/common/src/nxe_packet_data_append.c b/common/src/nxe_packet_data_append.c new file mode 100644 index 00000000..19c26210 --- /dev/null +++ b/common/src/nxe_packet_data_append.c @@ -0,0 +1,122 @@ +/**************************************************************************/ +/* */ +/* Copyright (c) Microsoft Corporation. All rights reserved. */ +/* */ +/* This software is licensed under the Microsoft Software License */ +/* Terms for Microsoft Azure RTOS. Full text of the license can be */ +/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */ +/* and in the root directory of this software. */ +/* */ +/**************************************************************************/ + + +/**************************************************************************/ +/**************************************************************************/ +/** */ +/** NetX Component */ +/** */ +/** Packet Pool Management (Packet) */ +/** */ +/**************************************************************************/ +/**************************************************************************/ + +#define NX_SOURCE_CODE + + +/* Include necessary system files. */ + +#include "nx_api.h" +#include "nx_packet.h" + +/* Bring in externs for caller checking code. */ + +NX_CALLER_CHECKING_EXTERNS + + +/**************************************************************************/ +/* */ +/* FUNCTION RELEASE */ +/* */ +/* _nxe_packet_data_append PORTABLE C */ +/* 6.0 */ +/* AUTHOR */ +/* */ +/* Yuxin Zhou, Microsoft Corporation */ +/* */ +/* DESCRIPTION */ +/* */ +/* This function checks for errors in the packet data append */ +/* function call. */ +/* */ +/* INPUT */ +/* */ +/* packet_ptr Pointer to packet to append */ +/* data_start Pointer to start of the data */ +/* data_size Number of bytes to append */ +/* pool_ptr Pool to allocate the packet */ +/* wait_option Suspension option */ +/* */ +/* OUTPUT */ +/* */ +/* status Completion status */ +/* */ +/* CALLS */ +/* */ +/* _nx_packet_data_append Actual packet data append */ +/* function */ +/* */ +/* CALLED BY */ +/* */ +/* Application Code */ +/* */ +/* RELEASE HISTORY */ +/* */ +/* DATE NAME DESCRIPTION */ +/* */ +/* 05-19-2020 Yuxin Zhou Initial Version 6.0 */ +/* */ +/**************************************************************************/ +UINT _nxe_packet_data_append(NX_PACKET *packet_ptr, VOID *data_start, ULONG data_size, + NX_PACKET_POOL *pool_ptr, ULONG wait_option) +{ + +UINT status; + + + /* Check for invalid input pointers. */ + if ((pool_ptr == NX_NULL) || (pool_ptr -> nx_packet_pool_id != NX_PACKET_POOL_ID) || + (packet_ptr == NX_NULL) || (data_start == NX_NULL)) + { + return(NX_PTR_ERROR); + } + + /* Check for an invalid size of data to append. */ + if (!data_size) + { + return(NX_SIZE_ERROR); + } + + /* Check for an invalid packet prepend pointer. */ + /*lint -e{946} suppress pointer subtraction, since it is necessary. */ + if (packet_ptr -> nx_packet_prepend_ptr < packet_ptr -> nx_packet_data_start) + { + return(NX_UNDERFLOW); + } + + /* Check for an invalid packet append pointer. */ + /*lint -e{946} suppress pointer subtraction, since it is necessary. */ + if (packet_ptr -> nx_packet_append_ptr > packet_ptr -> nx_packet_data_end) + { + return(NX_OVERFLOW); + } + + /* Check for appropriate caller. */ + NX_THREAD_WAIT_CALLER_CHECKING + + /* Call actual packet data append function. */ + status = _nx_packet_data_append(packet_ptr, data_start, data_size, pool_ptr, wait_option); + + /* Return completion status. */ + return(status); +} + |