nvscibuf.h

Go to the documentation of this file.

/*
 * Header file for NvSciBuf APIs
 *
 * SPDX-FileCopyrightText: Copyright (c) 2018-2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 * SPDX-License-Identifier: LicenseRef-NvidiaProprietary
 *
 * NVIDIA CORPORATION, its affiliates and licensors retain all intellectual
 * property and proprietary rights in and to this material, related
 * documentation and any modifications thereto. Any use, reproduction,
 * disclosure or distribution of this material and related documentation
 * without an express license agreement from NVIDIA CORPORATION or
 * its affiliates is strictly prohibited.
 */
#ifndef INCLUDED_NVSCIBUF_H
#define INCLUDED_NVSCIBUF_H
 
#include <stddef.h>
#include <stdbool.h>
#include <stdint.h>
#include "nvscierror.h"
#include "nvsciipc.h"
 
#if defined(__cplusplus)
extern "C"
{
#endif
 
#if defined __GNUC__
    #define PACK_BUF( __Declaration__ ) __Declaration__ __attribute__((packed))
#else
    #define PACK_BUF( __Declaration__ ) __pragma(pack(push, 1)) __Declaration__ __pragma(pack(pop))
#endif
 
typedef enum {
    NvSciBufType_General = 0U,
    NvSciBufType_RawBuffer = 1U,
    NvSciBufType_Image = 2U,
    NvSciBufType_Tensor = 3U,
    NvSciBufType_Array = 4U,
    NvSciBufType_Pyramid = 5U,
    NvSciBufType_MaxValid = 6U,
    NvSciBufType_UpperBound = 6U,
} NvSciBufType;
 
static const uint32_t NvSciBufMajorVersion = 2U;
 
static const uint32_t NvSciBufMinorVersion = 11U;
 
#if defined(__cplusplus)
 
static const int NV_SCI_BUF_TENSOR_MAX_DIMS = 8;
 
static const int NV_SCI_BUF_IMAGE_MAX_PLANES = 3;
 
static const int NV_SCI_BUF_PYRAMID_MAX_LEVELS = 10;
 
static const int NVSCIBUF_EXPORT_DESC_SIZE = 32;
 
static const uint32_t NV_SCI_BUF_PEER_INFO_MAX_NUMBER = 128U;
 
static const uint32_t NV_SCI_BUF_PEER_INFO_SELF_SOCID = 0xFFFFFFFFu;
 
static const uint32_t NV_SCI_BUF_PEER_INFO_SELF_VMID = 0xFFFFFFFFu;
 
static const int NV_SCI_BUF_PEER_HW_ENGINE_MAX_NUMBER = 128U;
 
static const uint32_t NV_SCI_BUF_MAX_GPUS = 16u;
 
static const int NV_SCI_BUF_ATTRKEY_BIT_COUNT = 16;
 
static const int NV_SCI_BUF_DATATYPE_BIT_COUNT = 10;
 
static const int NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC = 0;
 
/*
 * @brief Global constant to specify the start-bit of attribute Keytype.
 */
static const int NV_SCI_BUF_KEYTYPE_BIT_START =
        (NV_SCI_BUF_DATATYPE_BIT_COUNT + NV_SCI_BUF_ATTRKEY_BIT_COUNT);
 
static const int NV_SCI_BUF_GENERAL_ATTR_KEY_START =
           (NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) |
           (NvSciBufType_General << NV_SCI_BUF_ATTRKEY_BIT_COUNT);
 
static const int NV_SCI_BUF_RAW_BUF_ATTR_KEY_START =
           (NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) |
           (NvSciBufType_RawBuffer << NV_SCI_BUF_ATTRKEY_BIT_COUNT);
 
static const int NV_SCI_BUF_IMAGE_ATTR_KEY_START =
           (NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) |
           (NvSciBufType_Image << NV_SCI_BUF_ATTRKEY_BIT_COUNT);
 
static const int NV_SCI_BUF_PYRAMID_ATTR_KEY_START =
           (NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) |
           (NvSciBufType_Pyramid << NV_SCI_BUF_ATTRKEY_BIT_COUNT);
 
static const int NV_SCI_BUF_ARRAY_ATTR_KEY_START =
           (NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) |
           (NvSciBufType_Array << NV_SCI_BUF_ATTRKEY_BIT_COUNT);
 
static const int NV_SCI_BUF_TENSOR_ATTR_KEY_START =
           (NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) |
           (NvSciBufType_Tensor << NV_SCI_BUF_ATTRKEY_BIT_COUNT);
 
#else
 
#define NV_SCI_BUF_TENSOR_MAX_DIMS  8u
 
#define NV_SCI_BUF_IMAGE_MAX_PLANES 3u
 
#define NV_SCI_BUF_PYRAMID_MAX_LEVELS 10u
 
#define NVSCIBUF_EXPORT_DESC_SIZE   32u
 
#define NV_SCI_BUF_PEER_INFO_MAX_NUMBER 128u
 
#define NV_SCI_BUF_PEER_INFO_SELF_SOCID 0xFFFFFFFFu
 
#define NV_SCI_BUF_PEER_INFO_SELF_VMID 0xFFFFFFFFu
 
#define NV_SCI_BUF_PEER_HW_ENGINE_MAX_NUMBER  128U
 
#define NV_SCI_BUF_MAX_GPUS 16
 
#define NV_SCI_BUF_ATTRKEY_BIT_COUNT  16u
 
#define NV_SCI_BUF_DATATYPE_BIT_COUNT  10u
 
#define NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC 0u
 
#define NV_SCI_BUF_KEYTYPE_BIT_START \
        (NV_SCI_BUF_DATATYPE_BIT_COUNT + NV_SCI_BUF_ATTRKEY_BIT_COUNT)
 
#define NV_SCI_BUF_GENERAL_ATTR_KEY_START \
        ((NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) | \
        (NvSciBufType_General << NV_SCI_BUF_ATTRKEY_BIT_COUNT))
 
#define NV_SCI_BUF_RAW_BUF_ATTR_KEY_START \
          ((NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) | \
          (NvSciBufType_RawBuffer << NV_SCI_BUF_ATTRKEY_BIT_COUNT))
 
#define NV_SCI_BUF_IMAGE_ATTR_KEY_START \
          ((NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) | \
          (NvSciBufType_Image << NV_SCI_BUF_ATTRKEY_BIT_COUNT))
 
#define NV_SCI_BUF_PYRAMID_ATTR_KEY_START \
          ((NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) | \
          (NvSciBufType_Pyramid << NV_SCI_BUF_ATTRKEY_BIT_COUNT))
 
#define NV_SCI_BUF_ARRAY_ATTR_KEY_START \
          ((NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) | \
          (NvSciBufType_Array << NV_SCI_BUF_ATTRKEY_BIT_COUNT))
 
#define NV_SCI_BUF_TENSOR_ATTR_KEY_START \
          ((NV_SCI_BUF_ATTR_KEY_TYPE_PUBLIC << NV_SCI_BUF_KEYTYPE_BIT_START) | \
          (NvSciBufType_Tensor << NV_SCI_BUF_ATTRKEY_BIT_COUNT))
 
#endif
 
typedef enum {
    NvSciBufAttrKey_LowerBound =         NV_SCI_BUF_GENERAL_ATTR_KEY_START,
 
    NvSciBufGeneralAttrKey_Types,
 
    NvSciBufGeneralAttrKey_NeedCpuAccess,
 
    NvSciBufGeneralAttrKey_RequiredPerm,
 
    NvSciBufGeneralAttrKey_EnableCpuCache,
 
    NvSciBufGeneralAttrKey_GpuId,
 
    NvSciBufGeneralAttrKey_CpuNeedSwCacheCoherency,
 
    NvSciBufGeneralAttrKey_ActualPerm,
 
    NvSciBufGeneralAttrKey_VidMem_GpuId,
 
    NvSciBufGeneralAttrKey_EnableGpuCache,
 
    NvSciBufGeneralAttrKey_GpuSwNeedCacheCoherency,
 
    NvSciBufGeneralAttrKey_EnableGpuCompression,
 
    NvSciBufGeneralAttrKey_PeerLocationInfo,
 
    NvSciBufGeneralAttrKey_PeerHwEngineArray,
 
    NvSciBufRawBufferAttrKey_Size   =  NV_SCI_BUF_RAW_BUF_ATTR_KEY_START,
 
    NvSciBufRawBufferAttrKey_Align,
 
    NvSciBufImageAttrKey_Layout   =    NV_SCI_BUF_IMAGE_ATTR_KEY_START,
 
    NvSciBufImageAttrKey_TopPadding,
 
    NvSciBufImageAttrKey_BottomPadding,
 
    NvSciBufImageAttrKey_LeftPadding,
 
    NvSciBufImageAttrKey_RightPadding,
 
    NvSciBufImageAttrKey_VprFlag,
 
    NvSciBufImageAttrKey_Size,
 
    NvSciBufImageAttrKey_Alignment,
 
    NvSciBufImageAttrKey_PlaneCount,
 
    NvSciBufImageAttrKey_PlaneColorFormat,
 
    NvSciBufImageAttrKey_PlaneColorStd,
 
    NvSciBufImageAttrKey_PlaneBaseAddrAlign,
 
    NvSciBufImageAttrKey_PlaneWidth,
 
    NvSciBufImageAttrKey_PlaneHeight,
 
    NvSciBufImageAttrKey_PlaneScanType = 0x2000e,
    NvSciBufImageAttrKey_ScanType = NvSciBufImageAttrKey_PlaneScanType,
 
    NvSciBufImageAttrKey_PlaneBitsPerPixel,
 
    NvSciBufImageAttrKey_PlaneOffset,
 
    NvSciBufImageAttrKey_PlaneDatatype,
 
    NvSciBufImageAttrKey_PlaneChannelCount,
 
    NvSciBufImageAttrKey_PlaneSecondFieldOffset,
 
    NvSciBufImageAttrKey_PlanePitch,
 
    NvSciBufImageAttrKey_PlaneAlignedHeight,
 
    NvSciBufImageAttrKey_PlaneAlignedSize,
 
    NvSciBufImageAttrKey_ImageCount,
 
    NvSciBufImageAttrKey_SurfType,
 
    NvSciBufImageAttrKey_SurfMemLayout,
 
    NvSciBufImageAttrKey_SurfSampleType,
 
    NvSciBufImageAttrKey_SurfBPC,
 
    NvSciBufImageAttrKey_SurfComponentOrder,
 
    NvSciBufImageAttrKey_SurfWidthBase,
 
    NvSciBufImageAttrKey_SurfHeightBase,
 
    NvSciBufImageAttrKey_SurfColorStd,
 
    NvSciBufTensorAttrKey_DataType  =  NV_SCI_BUF_TENSOR_ATTR_KEY_START,
 
    NvSciBufTensorAttrKey_NumDims,
 
    NvSciBufTensorAttrKey_SizePerDim,
 
    NvSciBufTensorAttrKey_AlignmentPerDim,
 
    NvSciBufTensorAttrKey_StridesPerDim,
 
    NvSciBufTensorAttrKey_PixelFormat,
 
    NvSciBufTensorAttrKey_BaseAddrAlign,
 
    NvSciBufTensorAttrKey_Size,
 
    NvSciBufArrayAttrKey_DataType   =  NV_SCI_BUF_ARRAY_ATTR_KEY_START,
 
    NvSciBufArrayAttrKey_Stride,
 
    NvSciBufArrayAttrKey_Capacity,
 
    NvSciBufArrayAttrKey_Size,
 
    NvSciBufArrayAttrKey_Alignment,
 
    NvSciBufPyramidAttrKey_NumLevels  =  NV_SCI_BUF_PYRAMID_ATTR_KEY_START,
 
    NvSciBufPyramidAttrKey_Scale,
 
    NvSciBufPyramidAttrKey_LevelOffset,
 
    NvSciBufPyramidAttrKey_LevelSize,
 
    NvSciBufPyramidAttrKey_Alignment,
 
    NvSciBufAttrKey_UpperBound = 0x3ffffffU,
 
} NvSciBufAttrKey;
 
typedef enum {
    NvSciBufAccessPerm_Readonly = 1,
    NvSciBufAccessPerm_ReadWrite = 3,
    NvSciBufAccessPerm_Auto,
    NvSciBufAccessPerm_Invalid,
} NvSciBufAttrValAccessPerm;
 
typedef enum {
    NvSciBufImage_BlockLinearType,
    NvSciBufImage_PitchLinearType,
} NvSciBufAttrValImageLayoutType;
 
typedef enum {
    NvSciBufScan_ProgressiveType,
    NvSciBufScan_InterlaceType,
} NvSciBufAttrValImageScanType;
 
typedef enum {
    NvSciColor_LowerBound,
    /* RAW PACKED */
    /* Bit ordering for little endian machine is as follows
     * for NvSciColor_X12Bayer20GBRG
     * pattern  BBBBBBBB BBBBBBBB BBBB**** ******** GGGGGGGG GGGGGGGG GGGG**** ********
     *          +------+ +------+ +------+ +------+ +------+ +------+ +------+ +------+
     * bit      63    56 55    48 47    40 39    32 31    24 23    16 15     8 7      0
     *          +---------------------------------+ +---------------------------------+
     * pixel                     1                                   0
     *          +---------------------------------------------------------------------+
     * pitch                                       0
     *
     * pattern  GGGGGGGG GGGGGGGG GGGG**** ******** RRRRRRRR RRRRRRRR RRRR**** ********
     *          +------+ +------+ +------+ +------+ +------+ +------+ +------+ +------+
     * bit      63    56 55    48 47    40 39    32 31    24 23    16 15     8 7      0
     *          +---------------------------------+ +---------------------------------+
     * pixel                     1                                   0
     *          +---------------------------------------------------------------------+
     * pitch                                       1
     *
     * '*' means undefined bit value
     */
    NvSciColor_Bayer8RGGB,
    NvSciColor_Bayer8CCCC,
    NvSciColor_Bayer8BGGR,
    NvSciColor_Bayer8GBRG,
    NvSciColor_Bayer8GRBG,
    NvSciColor_Bayer16BGGR,
    NvSciColor_Bayer16CCCC,
    NvSciColor_Bayer16GBRG,
    NvSciColor_Bayer16GRBG,
    NvSciColor_Bayer16RGGB,
    NvSciColor_Bayer16RCCB,
    NvSciColor_Bayer16BCCR,
    NvSciColor_Bayer16CRBC,
    NvSciColor_Bayer16CBRC,
    NvSciColor_Bayer16RCCC,
    NvSciColor_Bayer16CCCR,
    NvSciColor_Bayer16CRCC,
    NvSciColor_Bayer16CCRC,
    NvSciColor_X2Bayer14GBRG,
    NvSciColor_X4Bayer12GBRG,
    NvSciColor_X6Bayer10GBRG,
    NvSciColor_X2Bayer14GRBG,
    NvSciColor_X4Bayer12GRBG,
    NvSciColor_X6Bayer10GRBG,
    NvSciColor_X2Bayer14BGGR,
    NvSciColor_X4Bayer12BGGR,
    NvSciColor_X6Bayer10BGGR,
    NvSciColor_X2Bayer14RGGB,
    NvSciColor_X4Bayer12RGGB,
    NvSciColor_X6Bayer10RGGB,
    NvSciColor_X2Bayer14CCCC,
    NvSciColor_X4Bayer12CCCC,
    NvSciColor_X6Bayer10CCCC,
    NvSciColor_X4Bayer12RCCB,
    NvSciColor_X4Bayer12BCCR,
    NvSciColor_X4Bayer12CRBC,
    NvSciColor_X4Bayer12CBRC,
    NvSciColor_X4Bayer12RCCC,
    NvSciColor_X4Bayer12CCCR,
    NvSciColor_X4Bayer12CRCC,
    NvSciColor_X4Bayer12CCRC,
    NvSciColor_Signed_X2Bayer14CCCC,
    NvSciColor_Signed_X4Bayer12CCCC,
    NvSciColor_Signed_X6Bayer10CCCC,
    NvSciColor_Signed_Bayer16CCCC,
    NvSciColor_FloatISP_Bayer16CCCC,
    NvSciColor_FloatISP_Bayer16RGGB,
    NvSciColor_FloatISP_Bayer16BGGR,
    NvSciColor_FloatISP_Bayer16GRBG,
    NvSciColor_FloatISP_Bayer16GBRG,
    NvSciColor_FloatISP_Bayer16RCCB,
    NvSciColor_FloatISP_Bayer16BCCR,
    NvSciColor_FloatISP_Bayer16CRBC,
    NvSciColor_FloatISP_Bayer16CBRC,
    NvSciColor_FloatISP_Bayer16RCCC,
    NvSciColor_FloatISP_Bayer16CCCR,
    NvSciColor_FloatISP_Bayer16CRCC,
    NvSciColor_FloatISP_Bayer16CCRC,
    NvSciColor_X12Bayer20CCCC,
    NvSciColor_X12Bayer20BGGR,
    NvSciColor_X12Bayer20RGGB,
    NvSciColor_X12Bayer20GRBG,
    NvSciColor_X12Bayer20GBRG,
    NvSciColor_X12Bayer20RCCB,
    NvSciColor_X12Bayer20BCCR,
    NvSciColor_X12Bayer20CRBC,
    NvSciColor_X12Bayer20CBRC,
    NvSciColor_X12Bayer20RCCC,
    NvSciColor_X12Bayer20CCCR,
    NvSciColor_X12Bayer20CRCC,
    NvSciColor_X12Bayer20CCRC,
    NvSciColor_Signed_X12Bayer20CCCC,
    /*
     * Note: This is currently not supported, and setting this attribute key
     * will fail.
     */
    NvSciColor_Signed_X12Bayer20GBRG,
 
    /* Semiplanar formats */
    /* Bit ordering for little endian machine is as follows
     * for NvSciColor_V8U8
     * pattern  VVVVVVVV UUUUUUUU
     *          +------+ +------+
     * bit      15     8 7      0
     *          +---------------+
     * pixel            0
     *
     * for NvSciColor_U8_V8
     * pattern  VVVVVVVV UUUUUUUU
     *          +------+ +------+
     * bit      15     8 7      0
     *          +---------------+
     * pixel            0
     *
     * for NvSciColor_V10U10
     * pattern  VVVVVVVV VV****** UUUUUUUU UU******
     *          +------+ +------+ +------+ +------+
     * bit      31    24 23    16 15     8 7      0
     *          +---------------------------------+
     * pixel                     0
     *
     * '*' means undefined bit value
     */
    NvSciColor_U8V8,
    NvSciColor_U8_V8,
    NvSciColor_V8U8,
    NvSciColor_V8_U8,
    NvSciColor_U10V10,
    NvSciColor_V10U10,
    NvSciColor_U12V12,
    NvSciColor_V12U12,
    NvSciColor_U16V16,
    NvSciColor_V16U16,
 
    /* PLANAR formats */
    /* Bit ordering for little endian machine is as follows
     * for NvSciColor_Y12
     * pattern  YYYYYYYY YYYY****
     *          +------+ +------+
     * bit      15     8 7      0
     *          +---------------+
     * pixel            0
     * '*' means undefined bit value
     */
    NvSciColor_Y8,
    NvSciColor_Y10,
    NvSciColor_Y12,
    NvSciColor_Y16,
    NvSciColor_U8,
    NvSciColor_V8,
    NvSciColor_U10,
    NvSciColor_V10,
    NvSciColor_U12,
    NvSciColor_V12,
    NvSciColor_U16,
    NvSciColor_V16,
 
    /* Packed YUV formats */
    /* NvSciColor_Y8U8Y8V8, NvSciColor_Y8V8Y8U8, NvSciColor_U8Y8V8Y8, NvSciColor_V8Y8U8Y8 follow
     * different component order than generic word representation.
     *
     * Bit ordering for little endian machine is as follows
     * for NvSciColor_U8Y8V8Y8
     * pattern  YYYYYYYY VVVVVVVV YYYYYYYY UUUUUUUU
     *          +------+ +------+ +------+ +------+
     * bit      31    24 23    16 15     8 7      0
     *          +---------------------------------+
     * pixel                     0
     *
     * for NvSciColor_A16Y16U16V16
     * pattern  AAAAAAAAAAAAAAAA YYYYYYYYYYYYYYYY UUUUUUUUUUUUUUUU VVVVVVVVVVVVVVVV
     *          +--------------+ +--------------+ +--------------+ +--------------+
     * bit      63            48 47            32 31            16 15             0
     *          +-----------------------------------------------------------------+
     * pixel                                     0
     *
     */
    NvSciColor_A8Y8U8V8,
    NvSciColor_Y8U8Y8V8,
    NvSciColor_Y8V8Y8U8,
    NvSciColor_U8Y8V8Y8,
    NvSciColor_V8Y8U8Y8,
    NvSciColor_A16Y16U16V16,
 
    /* RGBA PACKED */
    /* Bit ordering for little endian machine is as follows
     * for NvSciColor_A2R10G10B10
     * pattern  AARRRRRR RRRRGGGG GGGGGGBB BBBBBBBB
     *          +------+ +------+ +------+ +------+
     * bit      31    24 23    16 15     8 7      0
     *          +---------------------------------+
     * pixel                     0
     *
     */
    NvSciColor_A8,
    NvSciColor_Signed_A8,
    NvSciColor_B8G8R8A8,
    NvSciColor_A8R8G8B8,
    NvSciColor_A8B8G8R8,
    NvSciColor_A2R10G10B10,
    NvSciColor_A16,
    NvSciColor_Signed_A16,
    NvSciColor_Signed_R16G16,
    NvSciColor_A16B16G16R16,
    NvSciColor_Signed_A16B16G16R16,
    NvSciColor_Float_A16B16G16R16,
    NvSciColor_A32,
    NvSciColor_Signed_A32,
    NvSciColor_Float_A16,
 
    /* 10-bit 4x4 RGB-IR Bayer formats */
    /* Bit ordering for little endian machine is as follows
     * for NvSciColor_X6Bayer10BGGI_RGGI
     * pattern  GGGGGGGG GG****** RRRRRRRR RR****** GGGGGGGG GG****** BBBBBBBB BB******
     *          +------+ +------+ +------+ +------+ +------+ +------+ +------+ +------+
     * bit      63    56 55    48 47    40 39    32 31    24 23    16 15     8 7      0
     *          +---------------+ +---------------+ +---------------+ +---------------+
     * pixel            3                 2                 1                 0
     *          +---------------------------------------------------------------------+
     * pitch                                       0
     *
     * pattern  IIIIIIII II****** GGGGGGGG GG****** IIIIIIII II****** GGGGGGGG GG******
     *          +------+ +------+ +------+ +------+ +------+ +------+ +------+ +------+
     * bit      63    56 55    48 47    40 39    32 31    24 23    16 15     8 7      0
     *          +---------------+ +---------------+ +---------------+ +---------------+
     * pixel            3                 2                 1                 0
     *          +---------------------------------------------------------------------+
     * pitch                                       1
     *
     * pattern  GGGGGGGG GG****** BBBBBBBB BB****** GGGGGGGG GG****** RRRRRRRR RR******
     *          +------+ +------+ +------+ +------+ +------+ +------+ +------+ +------+
     * bit      63    56 55    48 47    40 39    32 31    24 23    16 15     8 7      0
     *          +---------------+ +---------------+ +---------------+ +---------------+
     * pixel            3                 2                 1                 0
     *          +---------------------------------------------------------------------+
     * pitch                                       2
     *
     * pattern  IIIIIIII II****** GGGGGGGG GG****** IIIIIIII II****** GGGGGGGG GG******
     *          +------+ +------+ +------+ +------+ +------+ +------+ +------+ +------+
     * bit      63    56 55    48 47    40 39    32 31    24 23    16 15     8 7      0
     *          +---------------+ +---------------+ +---------------+ +---------------+
     * pixel            3                 2                 1                 0
     *          +---------------------------------------------------------------------+
     * pitch                                       3
     *
     * '*' means undefined bit value
     */
    NvSciColor_X6Bayer10BGGI_RGGI,
    NvSciColor_X6Bayer10GBIG_GRIG,
    NvSciColor_X6Bayer10GIBG_GIRG,
    NvSciColor_X6Bayer10IGGB_IGGR,
    NvSciColor_X6Bayer10RGGI_BGGI,
    NvSciColor_X6Bayer10GRIG_GBIG,
    NvSciColor_X6Bayer10GIRG_GIBG,
    NvSciColor_X6Bayer10IGGR_IGGB,
 
    /* 12-bit 4x4 RGB-IR Bayer formats */
    NvSciColor_X4Bayer12BGGI_RGGI,
    NvSciColor_X4Bayer12GBIG_GRIG,
    NvSciColor_X4Bayer12GIBG_GIRG,
    NvSciColor_X4Bayer12IGGB_IGGR,
    NvSciColor_X4Bayer12RGGI_BGGI,
    NvSciColor_X4Bayer12GRIG_GBIG,
    NvSciColor_X4Bayer12GIRG_GIBG,
    NvSciColor_X4Bayer12IGGR_IGGB,
 
    /* 14-bit 4x4 RGB-IR Bayer formats */
    NvSciColor_X2Bayer14BGGI_RGGI,
    NvSciColor_X2Bayer14GBIG_GRIG,
    NvSciColor_X2Bayer14GIBG_GIRG,
    NvSciColor_X2Bayer14IGGB_IGGR,
    NvSciColor_X2Bayer14RGGI_BGGI,
    NvSciColor_X2Bayer14GRIG_GBIG,
    NvSciColor_X2Bayer14GIRG_GIBG,
    NvSciColor_X2Bayer14IGGR_IGGB,
 
    /* 16-bit 4x4 RGB-IR Bayer formats */
    NvSciColor_Bayer16BGGI_RGGI,
    NvSciColor_Bayer16GBIG_GRIG,
    NvSciColor_Bayer16GIBG_GIRG,
    NvSciColor_Bayer16IGGB_IGGR,
    NvSciColor_Bayer16RGGI_BGGI,
    NvSciColor_Bayer16GRIG_GBIG,
    NvSciColor_Bayer16GIRG_GIBG,
    NvSciColor_Bayer16IGGR_IGGB,
 
    /* Right-justified Bayer RAW format */
    /* Bit ordering for little endian machine is as follows
     * for NvSciColor_X4Bayer12RGGB_RJ
     * pattern  ****GGGG GGGGGGGG ****RRRR RRRRRRRR
     *          +------+ +------+ +------+ +------+
     * bit      31    24 23    16 15     8 7      0
     *          +---------------+ +---------------+
     * pixel            1                 0
     *          +---------------------------------+
     * pitch                     0
     *
     * pattern  ****BBBB BBBBBBBB ****GGGG GGGGGGGG
     *          +------+ +------+ +------+ +------+
     * bit      31    24 23    16 15     8 7      0
     *          +---------------+ +---------------+
     * pixel            1                 0
     *          +---------------------------------+
     * pitch                     1
     *
     * '*' means undefined bit value
     */
    NvSciColor_X4Bayer12RGGB_RJ,
 
    /* RGB PLANAR */
    NvSciColor_R8,
    NvSciColor_G8,
    NvSciColor_B8,
 
    NvSciColor_UpperBound
} NvSciBufAttrValColorFmt;
 
typedef enum {
    NvSciColorStd_SRGB,
    NvSciColorStd_REC601_SR,
    NvSciColorStd_REC601_ER,
    NvSciColorStd_REC709_SR,
    NvSciColorStd_REC709_ER,
    NvSciColorStd_REC2020_RGB,
    NvSciColorStd_REC2020_SR,
    NvSciColorStd_REC2020_ER,
    NvSciColorStd_YcCbcCrc_SR,
    NvSciColorStd_YcCbcCrc_ER,
    NvSciColorStd_SENSOR_RGBA,
    NvSciColorStd_REQ2020PQ_ER,
} NvSciBufAttrValColorStd;
 
typedef enum {
    NvSciSurfType_YUV,
    NvSciSurfType_RGBA,
    NvSciSurfType_RAW,
    NvSciSurfType_MaxValid,
} NvSciBufSurfType;
 
typedef enum {
    NvSciSurfMemLayout_Packed,
    NvSciSurfMemLayout_SemiPlanar,
    NvSciSurfMemLayout_Planar,
    NvSciSurfMemLayout_MaxValid,
} NvSciBufSurfMemLayout;
 
typedef enum {
    NvSciSurfSampleType_420,
    NvSciSurfSampleType_422,
    NvSciSurfSampleType_444,
    NvSciSurfSampleType_422R,
    NvSciSurfSampleType_400,
    NvSciSurfSampleType_MaxValid,
} NvSciBufSurfSampleType;
 
typedef enum {
    NvSciSurfBPC_Layout_16_8_8,
    NvSciSurfBPC_Layout_10_8_8,
    NvSciSurfBPC_8,
    NvSciSurfBPC_10,
    NvSciSurfBPC_12,
    NvSciSurfBPC_14,
    NvSciSurfBPC_16,
    NvSciSurfBPC_MaxValid,
} NvSciBufSurfBPC;
 
typedef enum {
    NvSciSurfComponentOrder_YUV,
    NvSciSurfComponentOrder_YVU,
    NvSciSurfComponentOrder_Luma,
    NvSciSurfComponentOrder_MaxValid,
} NvSciBufSurfComponentOrder;
 
typedef enum {
    NvSciDataType_Int4,
    NvSciDataType_Uint4,
    NvSciDataType_Int8,
    NvSciDataType_Uint8,
    NvSciDataType_Int16,
    NvSciDataType_Uint16,
    NvSciDataType_Int32,
    NvSciDataType_Uint32,
    NvSciDataType_Float16,
    NvSciDataType_Float32,
    NvSciDataType_FloatISP,
    NvSciDataType_Bool,
    NvSciDataType_UpperBound
} NvSciBufAttrValDataType;
 
typedef enum {
    NvSciBufCompressionType_None,
 
    NvSciBufCompressionType_GenericCompressible,
} NvSciBufCompressionType;
 
typedef struct {
    uint8_t bytes[16];
} NvSciRmGpuId;
 
typedef struct {
    NvSciRmGpuId gpuId;
 
    bool cacheability;
} NvSciBufAttrValGpuCache;
 
typedef struct {
    NvSciRmGpuId gpuId;
 
    NvSciBufCompressionType compressionType;
} NvSciBufAttrValGpuCompression;
 
typedef struct {
    uint64_t x0;
    uint64_t y0;
    uint64_t x1;
    uint64_t y1;
} NvSciBufRect;
 
typedef enum {
    NvSciBufHwEngName_Invalid   = 0,
    NvSciBufHwEngName_Display   = 4,
    NvSciBufHwEngName_Isp       = 11,
    NvSciBufHwEngName_Vi        = 12,
    NvSciBufHwEngName_Csi       = 30,
    NvSciBufHwEngName_Vic       = 106,
    NvSciBufHwEngName_Gpu       = 107,
    NvSciBufHwEngName_MSENC     = 109,
    NvSciBufHwEngName_NVDEC     = 117,
    NvSciBufHwEngName_NVJPG     = 118,
    NvSciBufHwEngName_PVA       = 121,
    NvSciBufHwEngName_DLA       = 122,
    NvSciBufHwEngName_PCIe      = 123,
    NvSciBufHwEngName_OFA       = 124,
    NvSciBufHwEngName_NPM       = 125,
    NvSciBufHwEngName_Num       = 126
} NvSciBufHwEngName;
 
typedef enum {
    NvSciBufPlatformName_LowerBound,
    NvSciBufPlatformName_Orin,
    NvSciBufPlatformName_PG189,
    NvSciBufPlatformName_PG199,
    NvSciBufPlatformName_Thor,
    NvSciBufPlatformName_UpperBound
} NvSciBufPlatformName;
 
PACK_BUF(typedef struct {
    NvSciBufHwEngName engName;
    NvSciBufPlatformName platName;
}) NvSciBufPeerHwEngine;
 
typedef struct NvSciBufModuleRec* NvSciBufModule;
 
typedef struct {
      NvSciBufAttrKey key;
 
      const void* value;
 
      size_t len;
} NvSciBufAttrKeyValuePair;
 
typedef struct NvSciBufObjRefRec* NvSciBufObj;
 
typedef const struct NvSciBufObjRefRec* NvSciBufObjConst;
 
 
typedef struct NvSciBufAttrListRec* NvSciBufAttrList;
 
PACK_BUF(typedef struct {
      uint64_t data[NVSCIBUF_EXPORT_DESC_SIZE];
}) NvSciBufObjIpcExportDescriptor;
 
PACK_BUF(typedef struct {
    uint32_t socID;
    uint32_t vmID;
    uint64_t reserved;
}) NvSciBufPeerLocationInfo;
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a module is NULL
 *      - @a newAttrList is NULL
 * - NvSciError_InsufficientMemory if insufficient system memory to
 *   create a NvSciBufAttrList.
 * - NvSciError_InvalidState if a new NvSciBufAttrList cannot be associated
 *   with the given NvSciBufModule.
 * - NvSciError_ResourceError if system lacks resource other than memory.
 * - panics if @a module is invalid.
 *
 * @pre @id{NvSciBufAttrListCreate_Precond_001} @asil{QM}
 *  Valid NvSciBufModule is obtained.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufAttrListCreate(
    NvSciBufModule module,
    NvSciBufAttrList* newAttrList);
 
void NvSciBufAttrListFree(
    NvSciBufAttrList attrList);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a attrList is NULL
 *      - @a attrList is reconciled
 *      - @a attrList is an unreconciled NvSciBufAttrList obtained from
 *        NvSciBufAttrListAppendUnreconciled or
 *        NvSciBufAttrListIpcImportUnreconciled
 *      - @a pairArray is NULL
 *      - @a pairCount is 0
 *      - any of the NvSciBufAttrKey(s) specified in the NvSciBufAttrKeyValuePair
 *        array is output only
 *      - any of the NvSciBufAttrKey(s) specified in the NvSciBufAttrKeyValuePair
 *        array has already been set
 *      - the NvSciBufGeneralAttrKey_Types key set (or currently being set) on
 *        @a attrList does not contain the NvSciBufType of the datatype
 *        NvSciBufAttrKey(s)
 *      - any of the NvSciBufAttrKey(s) specified in the NvSciBufAttrKeyValuePair
 *        array occurs more than once
 *      - any of the NvSciBufAttrKey(s) specified in @a pairArray is not a
 *        valid enumeration value defined by the NvSciBufAttrKey enum
 *      - length(s) set for NvSciBufAttrKey(s) in @a pairArray are invalid
 *      - value(s) set for NvSciBufAttrKey(s) in @a pairArray are invalid
 * - NvSciError_InsufficientMemory if not enough system memory.
 * - Panics if any of the following occurs:
 *      - @a attrList is not valid
 *
 * @pre @id{NvSciBufAttrListSetAttrs_Precond_001} @asil{QM}
 *  Valid unreconciled NvSciBufAttrList is obtained.
 * @post @id{NvSciBufAttrListSetAttrs_Postcond_001} @asil{QM}
 *  pairArray values are copied to attrList. Set attributes are made
 * non-writeable in NvSciBufAttrList.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufAttrListSetAttrs(
    NvSciBufAttrList attrList,
    NvSciBufAttrKeyValuePair* pairArray,
    size_t pairCount);
 
size_t NvSciBufAttrListGetSlotCount(
    NvSciBufAttrList attrList);
 
NvSciError NvSciBufAttrListGetAttrs(
    NvSciBufAttrList attrList,
    NvSciBufAttrKeyValuePair* pairArray,
    size_t pairCount);
 
NvSciError NvSciBufAttrListSlotGetAttrs(
    NvSciBufAttrList attrList,
    size_t slotIndex,
    NvSciBufAttrKeyValuePair* pairArray,
    size_t pairCount);
 
#if (NV_IS_SAFETY == 0)
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if @a attrList is invalid.
 *
 * @note This API is deprecated and will be removed in a future version. This
 * prototype is only provided to not break compiliation of older code. Its use
 * is not supported. Do not rely on using this API.
 *
 * @pre
 * - Valid unreconciled NvSciBufAttrList is obtained.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 *
 * @endif
 */
NvSciError NvSciBufAttrListDebugDump(
    NvSciBufAttrList attrList,
    void** buf,
    size_t* len);
#endif
 
#if (NV_IS_SAFETY == 0)
 
#else
 
#endif
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a inputArray[] is NULL
 *      - @a inputCount is 0
 *      -conciliation is
 *        unset
 *      - an attribute key is set to an unsupported value considering the data
 *        type(s) of the NvSciBufAttrList(s) involved in reconciliation
 */
#if (NV_IS_SAFETY == 0)
 
#endif
 
NvSciError NvSciBufAttrListReconcile(
    const NvSciBufAttrList inputArray[],
    size_t inputCount,
    NvSciBufAttrList* newReconciledAttrList,
    NvSciBufAttrList* newConflictList);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a origAttrList is NULL
 *      - @a newAttrList is NULL
 *      - the NvSciBufGeneralAttrKey_Types key is not set on @a origAttrList
 * - NvSciError_InsufficientMemory if there is insufficient system memory
 *   to create a new NvSciBufAttrList.
 * - NvSciError_InvalidState if a new NvSciBufAttrList cannot be associated
 *   with the NvSciBufModule of @a origAttrList to create the new
 *   NvSciBufAttrList.
 * - NvSciError_ResourceError if system lacks resource other than memory.
 * - panics if @a origAttrList is invalid
 *
 * @pre @id{NvSciBufAttrListClone_PreCond_001} @asil{QM}
 *  Valid NvSciBufAttrList is obtained.
 * @post @id{NvSciBufAttrListClone_PostCond_001}
 *  If the original NvSciBufAttrList is unreconciled, then modification will be
 * allowed on the cloned NvSciBufAttrList using set attributes APIs even if the
 * attributes had been set in the original NvSciBufAttrList, but the calls to
 * set attributes in either NvSciBufAttrList will not affect the other.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufAttrListClone(
    NvSciBufAttrList origAttrList,
    NvSciBufAttrList* newAttrList);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState if the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a inputUnreconciledAttrListArray is NULL
 *      - @a inputUnreconciledAttrListCount is 0
 *      - @a newUnreconciledAttrList is NULL
 *      - any of the NvSciBufAttrList(s) in @a inputUnreconciledAttrListArray
 *        is reconciled
 *      - not all the NvSciBufAttrLists in @a inputUnreconciledAttrListArray
 *        are bound to the same NvSciBufModule instance.
 *      - an NvSciBufAttrList appears multiple times in @a inputUnreconciledAttrListArray
 *      - the NvSciBufGeneralAttrKey_Types key is not set on any of the
 *        NvSciBufAttrList(s) in @a inputUnreconciledAttrListArray
 * - NvSciError_InsufficientMemory if memory allocation failed.
 * - NvSciError_InvalidState if a new NvSciBufAttrList cannot be associated
 *   with the NvSciBufModule associated with the NvSciBufAttrList(s) in the
 *   given @a inputUnreconciledAttrListArray to create the new NvSciBufAttrList.
 * - NvSciError_ResourceError if system lacks resource other than memory.
 * - panics if @a any NvSciBufAttrList in the @a
 *   inputUnreconciledAttrListArray is invalid
 *
 * @pre @id{NvSciBufAttrListAppendUnreconciled_PreCond_001} @asil{QM}
 *  Valid unreconciled NvSciBufAttrList(s) are obtained.
 * @post @id{NvSciBufAttrListAppendUnreconciled_PostCond_001}
 *  Appended NvSciBufAttrList is read-only and the attribute values in the
 * list cannot be modified using set attribute APIs.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufAttrListAppendUnreconciled(
    const NvSciBufAttrList inputUnreconciledAttrListArray[],
    size_t inputUnreconciledAttrListCount,
    NvSciBufAttrList* newUnreconciledAttrList);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a attrList is NULL
 *      - @a isReconciled is NULL
 * - panics if @a attrList is invalid
 *
 * @pre @id{NvSciBufAttrListIsReconciled_PreCond_001} @asil{QM}
 *  Valid NvSciBufAttrList is obtained.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufAttrListIsReconciled(
    NvSciBufAttrList attrList,
    bool* isReconciled);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *         - @a reconciledAttrList is NULL or
 *         - @a unreconciledAttrListArray[] is NULL or
 *         - @a unreconciledAttrListCount is zero or
 *         - @a isReconcileListValid is NULL
 *         - any of the NvSciBufAttrList in @a unreconciledAttrListArray is
 *           reconciled.
 *         - not all the NvSciBufAttrLists in @a unreconciledAttrListArray are
 *           bound to the same NvSciBufModule.
 *         - an NvSciBufAttrList appears multiple times in @a unreconciledAttrListArray
 * - NvSciError_ReconciliationFailed if validation of reconciled
 *   NvSciBufAttrList failed against input unreconciled NvSciBufAttrList(s).
 * - NvSciError_InsufficientMemory if internal memory allocation failed.
 * - NvSciError_Overflow if internal integer overflow occurs.
 * - Panics if:
 *         - @a unreconciled NvSciBufAttrList(s) in unreconciledAttrListArray
 *           is invalid.
 *         - @a reconciledAttrList is not valid.
 *
 * @pre @id{NvSciBufAttrListValidateReconciled_PreCond_001} @asil{QM}
 *  Valid reconciled NvSciBufAttrList is obtained.
 * @pre @id{NvSciBufAttrListValidateReconciled_PreCond_002} @asil{QM}
 *  Valid unreconciled NvSciBufAttrList(s) are obtained.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufAttrListValidateReconciled(
    NvSciBufAttrList reconciledAttrList,
    const NvSciBufAttrList unreconciledAttrListArray[],
    size_t unreconciledAttrListCount,
    bool* isReconcileListValid);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState if the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a bufObj is NULL
 *      - @a dupObj is NULL
 * - NvSciError_InsufficientMemory if memory allocation is failed.
 * - NvSciError_InvalidState if the total number of NvSciBufObjs referencing
 *   the memory object is INT32_MAX and the caller tries to take one more
 *   reference using this API.
 * - NvSciError_ResourceError if system lacks resource other than memory
 * - Panics if @a bufObj is invalid.
 *
 * @pre @id{NvSciBufObjDup_PreCond_001} @asil{QM}
 *  Valid NvSciBufObj is obtained.
 * @post @id{NvSciBufObjDup_PostCond_001}
 *  The duplicated NvSciBufObj is not a completely new NvSciBufObj. Therefore,
 * read write operations from one affects the state the other, because it is the same underlying memory.
 * @arr @id{NvSciBufDupObjDup_REC_001} @asil{QM}
 *  The resulting NvSciBufDupObj must be freed separately by the user.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufObjDup(
    NvSciBufObj bufObj,
    NvSciBufObj* dupObj);
 
#if (NV_IS_SAFETY == 0)
 
#else
 
#endif
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a attrListCount is 0
 *      - @a attrListArray is NULL
 *      - @a bufObj is NULL
 *      - any of the NvSciBufAttrList in @a attrListArray is reconciled.
 *      - not all the NvSciBufAttrLists in @a attrListArray are bound to
 *        the same NvSciBufModule.
 *      - an NvSciBufAttrList appears multiple times in @a attrListArray
 *      - an attribute key necessary for reconciling against the given data
 *      type(s) of the NvSciBufAttrList(s) involved in reconciliation is
 *      unset
 *      - an attribute key is set to an unsupported value considering the data
 *      type(s) of the NvSciBufAttrList(s) involved in reconciliation
 */
#if (NV_IS_SAFETY == 0)
 
#endif
 
NvSciError NvSciBufAttrListReconcileAndObjAlloc(
    const NvSciBufAttrList attrListArray[],
    size_t attrListCount,
    NvSciBufObj* bufObj,
    NvSciBufAttrList* newConflictList);
 
void NvSciBufObjFree(
    NvSciBufObj bufObj);
 
NvSciError NvSciBufObjGetAttrList(
    NvSciBufObj bufObj,
    NvSciBufAttrList* bufAttrList);
 
NvSciError NvSciBufObjGetCpuPtr(
    NvSciBufObj bufObj,
    void**  ptr);
 
NvSciError NvSciBufObjGetConstCpuPtr(
    NvSciBufObj bufObj,
    const void**  ptr);
 
NvSciError NvSciBufObjFlushCpuCacheRange(
    NvSciBufObj bufObj,
    uint64_t offset,
    uint64_t len);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState if the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a reconciledAttrList is NULL
 *      - @a reconciledAttrList is not a reconciled NvSciBufAttrList
 *      - @a bufObj is NULL
 * - NvSciError_InsufficientMemory if there is insufficient memory
 *   to complete the operation.
 * - NvSciError_InvalidState if a new NvSciBufObj cannot be associated
 *   with the NvSciBufModule with which @a reconciledAttrList is associated to
 *   create the new NvSciBufObj.
 * - NvSciError_ResourceError if any of the following occurs:
 *      - NVIDIA driver stack failed during buffer allocation
 *      - system lacks resource other than memory
 * - Panics if @a reconciledAttrList is invalid.
 *
 * @pre @id{NvSciBufObjAlloc_PreCond_001} @asil{QM}
 *  Valid reconciled NvSciBufAttrList is obtained.
 * @arr @id{NvSciBufObjAlloc_RES_001} @asil{QM}
 *  The allocator process will have read write permission to the newly Allocated NvSciBufObj.
 * @arr @id{NvSciBufObjAlloc_REC_002} @asil{QM}
 *  This function does not take ownership of the reconciled NvSciBufAttrList.
 * The caller remains responsible for freeing the reconciled NvSciBufAttrList.
 * The caller may free the reconciled NvSciBufAttrList any time after this
 * function is called.
 * @arr @id{NvSciBufObjAlloc_RES_003} @asil{D}
 *  It is not guaranteed that the input reconciled NvSciBufAttrList in this
 *  API is the same NvSciBufAttrList that is associated with the allocated
 *  NvSciBufObj. However, the attributes describing CPU accessibility and
 *  buffer size are guaranteed to be the same in both NvSciBufAttrLists.
 *
 *  However, in general, it is recommended that in order to query the
 *  value(s) of attribute(s) from the reconciled NvSciBufAttrList associated
 *  with an NvSciBufObj after allocation, they must first obtain the reconciled
 *  NvSciBufAttrList from the NvSciBufObj using NvSciBufObjGetAttrList()
 *  rather than using a saved NvSciBufAttrList.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufObjAlloc(
    NvSciBufAttrList reconciledAttrList,
    NvSciBufObj* bufObj);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState if the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a bufObj is NULL
 *      - @a newBufObj is NULL
 *      - @a reducedPerm is not NvSciBufAccessPerm_Readonly or
 *        NvSciBufAccessPerm_ReadWrite
 *      - @a reducedPerm is greater than the permissions specified in the value
 *        of the NvSciBufGeneralAttrKey_ActualPerm key
 * - NvSciError_InsufficientMemory if memory allocation failed.
 * - NvSciError_InvalidState if any of the following occurs:
 *      - the total number of NvSciBufObj(s) referencing the memory object is
 *        INT32_MAX and the caller tries to take one more reference using this
 *        API.
 *      - a new NvSciBufObj cannot be associated with the NvSciBufModule with
 *        which @a bufObj is associated to create the new NvSciBufAttrList
 *        when the requested access permissions are less than the permissions
 *        represented by the input NvSciBufObj
 * - NvSciError_ResourceError if any of the following occurs:
 *      - NVIDIA driver stack failed while assigning new permission to the buffer handle
 *      - system lacks resource other than memory
 */
#if (NV_IS_SAFETY == 0)
 
#endif
 
NvSciError NvSciBufObjDupWithReducePerm(
    NvSciBufObj bufObj,
    NvSciBufAttrValAccessPerm reducedPerm,
    NvSciBufObj* newBufObj);
 
NvSciError NvSciBufObjGetPixels(
    NvSciBufObj bufObj,
    const NvSciBufRect* rect,
    void** dstPtrs,
    const uint32_t* dstPtrSizes,
    const uint32_t* dstPitches);
 
NvSciError NvSciBufObjPutPixels(
    NvSciBufObj bufObj,
    const NvSciBufRect* rect,
    const void** srcPtrs,
    const uint32_t* srcPtrSizes,
    const uint32_t* srcPitches);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState if the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a attrListAndObjDesc is NULL
 *      - @a attrListAndObjDescSize is NULL
 *      - @a bufObj is NULL
 *      - @a ipcEndpoint is invalid
 *      - @a permissions takes value other than NvSciBufAccessPerm_Readonly,
 *        NvSciBufAccessPerm_ReadWrite or NvSciBufAccessPerm_Auto.
 * - NvSciError_InsufficientMemory if memory allocation failed
 * - NvSciError_InvalidOperation if reconciled NvSciBufAttrList of @a bufObj
 *   has greater permissions for the @a ipcEndpoint peer than the
 *   @a permissions
 * - NvSciError_Overflow if an arithmetic overflow occurs due to an invalid
 *     export descriptor
 * - NvSciError_NotPermitted if NvSciBufObj and NvSciBufAttrList associated
 *   with it are not being exported in the reverse direction of IPC path in
 *   which unreconciled NvSciBufAttrLists involved in reconciliation of
 *   NvSciBufAttrList associated with the input NvScibufObj were exported.
 * - NvSciError_ResourceError if the NVIDIA driver stack failed.
 * - NvSciError_TryItAgain if current operation needs to be retried by the
 *   user. This error is returned only when communication boundary is chip to
 *   chip (C2c).
 * - Panic if @a bufObj is invalid
 *
 * @pre @id{NvSciBufIpcExportAttrListAndObj_PreCond_001} @asil{QM}
 *  Valid NvSciBufObj obtained.
 * @pre @id{NvSciBufIpcExportAttrListAndObj_PreCond_002} @asil{QM}
 *  Valid NvSciIpcEndpoint is obtained.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufIpcExportAttrListAndObj(
    NvSciBufObj bufObj,
    NvSciBufAttrValAccessPerm permissions,
    NvSciIpcEndpoint ipcEndpoint,
    void** attrListAndObjDesc,
    size_t* attrListAndObjDescSize);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState if the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a module is NULL
 *      - @a ipcEndpoint is invalid
 *      - @a attrListAndObjDesc is NULL
 *      - @a attrListAndObjDesc represents an NvSciBufAttrList with invalid
 *        attribute key values set
 *      - @a attrListAndObjDesc represents an NvSciBufAttrList which is
 *        unreconciled.
 *      - @a attrListAndObjDesc is invalid
 *      - @a attrListAndObjDescSize is 0
 *      - @a count is 0, provided @a attrList is non-NULL
 *      - @a minPermissions are invalid.
 *      - @a bufObj is NULL
 * - NvSciError_NotSupported if any of the following occurs:
 *      - @a attrListAndObjDesc is incompatible
 *      - Internal attribute of the imported NvSciBufAttrList represents
 *        memory domain which is not supported.
 * - NvSciError_AccessDenied if @a minPermissions are greater than permissions
 *     with which NvSciBufObj was exported
 * - NvSciError_AttrListValidationFailed if any of the following occurs:
 *      - input unreconciled NvSciBufAttrList(s)' contraints are not satisfied
 *        by attributes  associated with the imported NvSciBufObj
 *      - an NvSciBufAttrList appears multiple times in @a attrList
 * - NvSciError_InsufficientMemory if memory allocation failed
 * - NvSciError_ResourceError if any of the following occurs:
 *      - NVIDIA driver stack failed
 *      - system lacks resource other than memory
 * - NvSciError_TryItAgain if current operation needs to be retried by the
 *   user. This error is returned only when communication boundary is chip to
 *   chip (C2c).
 * - NvSciError_InvalidState if any of the following occurs:
 *      - Imported NvSciBufAttrList cannot be associated with @a module.
 *      - Imported NvSciBufObj cannot be associated with @a module.
 * - Panic if:
 *    - @a any of the unreconciled NvSciBufAttrList(s) are not valid
 *    - @a module is invalid
 *
 * @pre @id{NvSciBufIpcImportAttrListAndObj_PreCond_001} @asil{QM}
 *  Valid NvSciBufModule is obtained.
 * @pre @id{NvSciBufIpcImportAttrListAndObj_PreCond_002} @asil{QM}
 *  Valid unreconciled NvSciBufAttrList(s) are obtained.
 * @pre @id{NvSciBufIpcImportAttrListAndObj_PreCond_003} @asil{QM}
 *  Valid NvSciIpcEndpoint is obtained.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufIpcImportAttrListAndObj(
    NvSciBufModule module,
    NvSciIpcEndpoint ipcEndpoint,
    const void* attrListAndObjDesc,
    size_t attrListAndObjDescSize,
    const NvSciBufAttrList attrList[],
    size_t count,
    NvSciBufAttrValAccessPerm minPermissions,
    int64_t timeoutUs,
    NvSciBufObj* bufObj);
 
void NvSciBufAttrListAndObjFreeDesc(
    void* attrListAndObjDescBuf);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState if the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a bufObj is NULL
 *      - @a accPerm takes value other than NvSciBufAccessPerm_Readonly,
 *        NvSciBufAccessPerm_ReadWrite or NvSciBufAccessPerm_Auto.
 *      - @a ipcEndpoint is invalid
 *      - @a exportData is NULL
 * - NvSciError_InsufficientMemory if memory allocation failed.
 * - NvSciError_InvalidOperation if reconciled NvSciBufAttrList of @a bufObj
 *   has greater permissions for the @a ipcEndpoint peer than the
 *   @a accPerm
 * - NvSciError_NotPermitted if NvSciBufObj is not being exported in the
 *   reverse direction of IPC path in which unreconciled NvSciBufAttrLists
 *   involved in reconciliation of NvSciBufAttrList associated with the input
 *   NvScibufObj were exported.
 * - NvSciError_ResourceError if the NVIDIA driver stack failed.
 * - NvSciError_TryItAgain if current operation needs to be retried by the
 *   user. This error is returned only when communication boundary is chip to
 *   chip (C2c).
 * - Panic if @a bufObj is invalid
 *
 * @pre @id{NvSciBufObjIpcExport_PreCond_001} @asil{QM}
 *  Valid NvSciBufObj is obtained.
 * @pre @id{NvSciBufObjIpcExport_PreCond_002} @asil{QM}
 *  Valid NvSciIpcEndpoint is obtained.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufObjIpcExport(
    NvSciBufObj bufObj,
    NvSciBufAttrValAccessPerm accPerm,
    NvSciIpcEndpoint ipcEndpoint,
    NvSciBufObjIpcExportDescriptor* exportData);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState if the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_AccessDenied if minPermissions are greater than permissions
 *     with which object was exported
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a ipcEndpoint is invalid
 *      - @a desc is NULL or invalid
 *      - @a reconciledAttrList is NULL
 *      - @a reconciledAttrList is unreconciled.
 *      - @a minPermissions are invalid.
 *      - @a bufObj is NULL
 * - NvSciError_InsufficientMemory if there is insufficient system memory.
 * - NvSciError_Overflow if an arithmetic overflow occurs due to an invalid
 *     export descriptor
 * - NvSciError_ResourceError if any of the following occurs:
 *      - NVIDIA driver stack failed
 *      - system lacks resource other than memory
 * - NvSciError_TryItAgain if current operation needs to be retried by the
 *   user. This error is returned only when communication boundary is chip to
 *   chip (C2c).
 */
#if defined (BACKEND_RESMAN)
#if (BACKEND_RESMAN)
 
#endif
#endif
 
NvSciError NvSciBufObjIpcImport(
    NvSciIpcEndpoint ipcEndpoint,
    const NvSciBufObjIpcExportDescriptor* desc,
    NvSciBufAttrList reconciledAttrList,
    NvSciBufAttrValAccessPerm minPermissions,
    int64_t timeoutUs,
    NvSciBufObj* bufObj);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a inputArray is NULL
 *      - @a inputCount is 0
 *      - @a bufObj is NULL
 *      - not all the NvSciBufAttrList(s) in @a inputArray and the reconciled
 *        NvSciBufAttrList bound to @a bufObj are bound to same NvSciBufModule
 *        instance.
 *      - an NvSciBufAttrList appears multiple times in @a inputArray
 *      - if any of the NvSciBufAttrList is reconciled in @a inputArray
 *      - the NvSciBufGeneralAttrKey_Types key is not set on any of the
 *        NvSciBufAttrList(s) in @a inputArray
 * - NvSciError_InsufficientMemory if internal memory allocation failed.
 * - NvSciError_ResourceError if system lacks resource other than memory.
 * - NvSciError_ReconciliationFailed if validation of reconciled
 *   NvSciBufAttrList associated with input @a bufObj failed against input
 *   unreconciled NvSciBufAttrList(s) in @a inputArray.
 * - NvSciError_Overflow if internal integer overflow occurs.
 * - panics if @a any NvSciBufAttrList in the @a
 *   inputArray is invalid
 *
 * @pre @id{NvSciBufObjAttachPeer_PreCond_001} @asil{QM}
 *  Valid NvSciBufObj is allocated.
 * @pre @id{NvSciBufObjAttachPeer_PreCond_002} @asil{QM}
 *  Valid unreconciled NvSciBufAttrList(s) inside @a inputArray.
 * @post @id{NvSciBufObjAttachPeer_PostCond_001}
 *  NvSciBufObj and reconciled NvSciBufAttrList associated with @a bufObj is exportable
 * to remote peers NvSciIpcEndpoints whose unreconciled NvSciBufAttrList was provided
 * as input to this function if the operation is successful.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes, with the following conditions:
 *      - Provided there is no active operation involving the input
 *        NvSciBufAttrList @a attrList
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufObjAttachPeer(
    NvSciBufObj bufObj,
    const NvSciBufAttrList inputArray[],
    size_t inputCount);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a unreconciledAttrListArray is NULL
 *      - any of the NvSciBufAttrLists in the @a unreconciledAttrListArray is
 *        reconciled.
 *      - not all the NvSciBufAttrLists in the @a unreconciledAttrListArray are
 *        bound to the same NvSciBufModule.
 *      - an NvSciBufAttrList appears multiple times in @a unreconciledAttrListArray
 *      - @a unreconciledAttrListCount is 0
 *      - @a ipcEndpoint is invalid
 *      - @a descBuf is NULL
 *      - @a descLen is NULL
 * - NvSciError_InsufficientResource if any of the following occurs:
 *      - the API is unable to implicitly append an additional attribute key
 *        when needed
 * - NvSciError_InsufficientMemory if memory allocation failed.
 * - Panic if @a any of the NvSciBufAttrList(s) in @a unreconciledAttrListArray
 *   is invalid.
 *
 * @pre @id{NvSciBufAttrListIpcExportUnreconciled_PreCond_001} @asil{QM}
 *  Valid unreconciled NvSciBufAttrList(s) are obtained.
 * @pre @id{NvSciBufAttrListIpcExportUnreconciled_PreCond_002} @asil{QM}
 *  Valid NvSciIpcEndpoint is obtained.
 * @post @id{NvSciBufAttrListIpcExportUnreconciled_PostCond_001}
 *  When exporting an array containing multiple unreconciled
 * NvSciBufAttrLists, the importing endpoint still imports just one unreconciled
 * NvSciBufAttrList. This unreconciled NvSciBufAttrList is referred to as a
 * multi-slot NvSciBufAttrList. It logically represents an array of
 * NvSciBufAttrLists.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufAttrListIpcExportUnreconciled(
    const NvSciBufAttrList unreconciledAttrListArray[],
    size_t unreconciledAttrListCount,
    NvSciIpcEndpoint ipcEndpoint,
    void** descBuf,
    size_t* descLen);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a reconciledAttrList is NULL
 *      - @a reconciledAttrList is unreconciled.
 *      - @a ipcEndpoint is invalid
 *      - @a descBuf is NULL
 *      - @a descLen is NULL
 * - NvSciError_InsufficientMemory if memory allocation failed.
 * - NvSciError_NotPermitted if reconciled NvSciBufAttrList is not being
 *   exported in the reverse direction of IPC path in which unreconciled
 *   NvSciBufAttrLists involved in reconciliation of input NvSciBufAttrList were
 *   exported.
 * - Panic if @a reconciledAttrList is invalid.
 *
 * @pre @id{NvSciBufAttrListIpcExportReconciled_PreCond_001} @asil{QM}
 *  Valid reconciled NvSciBufAttrList is obtained.
 * @pre @id{NvSciBufAttrListIpcExportReconciled_PreCond_002} @asil{QM}
 *  Valid NvSciIpcEndpoint is obtained.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufAttrListIpcExportReconciled(
    NvSciBufAttrList reconciledAttrList,
    NvSciIpcEndpoint ipcEndpoint,
    void** descBuf,
    size_t* descLen);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a module is NULL
 *      - @a ipcEndpoint is invalid
 *      - @a descBuf is NULL
 *      - @a descBuf represents an NvSciBufAttrList with invalid attribute key
 *        values set
 *      - @a descBuf represents an NvSciBufAttrList which is reconciled.
 *      - @a descBuf is invalid
 *      - @a descLen is 0
 *      - @a importedUnreconciledAttrList is NULL
 * - NvSciError_NotSupported if @a descBuf represents an NvSciBufAttrList with
 *     same key multiple times.
 * - NvSciError_InsufficientMemory if insufficient system memory.
 * - NvSciError_InvalidState if imported NvSciBufAttrList cannot be
 *     associated with @a module.
 * - NvSciError_ResourceError if system lacks resource other than memory.
 * - Panic if @a module is invalid
 *
 * @pre @id{NvSciBufAttrListIpcImportUnreconciled_PreCond_001} @asil{QM}
 *  Valid NvSciBufModule is obtained.
 * @pre @id{NvSciBufAttrListIpcImportUnreconciled_PreCond_002} @asil{QM}
 *  Valid NvSciIpcEndpoint is obtained.
 * @post @id{NvSciBufAttrListAppendUnreconciled_PostCond_001}
 *  Imported NvSciBufAttrList is no longer writable.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufAttrListIpcImportUnreconciled(
    NvSciBufModule module,
    NvSciIpcEndpoint ipcEndpoint,
    const void* descBuf,
    size_t descLen,
    NvSciBufAttrList* importedUnreconciledAttrList);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a module is NULL
 *      - @a ipcEndpoint is invalid
 *      - @a descBuf is NULL
 *      - @a descBuf represents an NvSciBufAttrList with invalid attribute key
 *        values set
 *      - @a descBuf represents an NvSciBufAttrList which is unreconciled.
 *      - @a descBuf is invalid
 *      - @a descLen is 0
 *      - @a importedReconciledAttrList is NULL
 *      - @a inputUnreconciledAttrListCount is 0 provided
 *        @a inputUnreconciledAttrListArray is non-NULL
 * - NvSciError_NotSupported if any of the following occurs:
 *      - @a descBuf is incompatible
 * - NvSciError_InsufficientMemory if memory allocation failed.
 * - NvSciError_AttrListValidationFailed if any of the following occurs:
 *      - input unreconciled NvSciBufAttrList(s)' attribute constraints are not
 *        satisfied by attributes associated with the imported importedReconciledAttrList.
 *      - an NvSciBufAttrList appears multiple times in @a inputUnreconciledAttrListArray
 * - NvSciError_InvalidState if imported NvSciBufAttrList cannot be
 *     associated with @a module.
 * - NvSciError_ResourceError if system lacks resource other than memory.
 * - Panic if:
 *      - @a any of the NvSciBufAttrList in
 *        inputUnreconciledAttrListArray is invalid
 *      - @a module is invalid
 *
 * @pre @id{NvSciBufAttrListIpcImportReconciled_PreCond_001} @asil{QM}
 *  Valid NvSciBufModule is obtained.
 * @pre @id{NvSciBufAttrListIpcImportReconciled_PreCond_002} @asil{QM}
 *  Valid unreconciled NvSciBufAttrList(s) are obtained.
 * @pre @id{NvSciBufAttrListIpcImportReconciled_PreCond_003} @asil{QM}
 *  Valid NvSciIpcEndpoint is obtained.
 * @arr @id{NvSciBufAttrListIpcImportReconciled_REC_001} @asil{QM}
 *  It is recommended that the importing process validates the reconciled
 * NvSciBufAttrList against the input unreconciled NvSciBufAttrList(s),
 * so that the importing process can be sure that an NvSciBufObj will
 * satisfy the input constraints.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufAttrListIpcImportReconciled(
    NvSciBufModule module,
    NvSciIpcEndpoint ipcEndpoint,
    const void* descBuf,
    size_t descLen,
    const NvSciBufAttrList inputUnreconciledAttrListArray[],
    size_t inputUnreconciledAttrListCount,
    NvSciBufAttrList* importedReconciledAttrList);
 
 
void NvSciBufAttrListFreeDesc(
    void* descBuf);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState if the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if @a newModule is NULL.
 * - NvSciError_InsufficientMemory if memory is not available.
 * - NvSciError_ResourceError if any of the following occurs:
 *      - NVIDIA driver stack failed
 *      - system lacks resource other than memory
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufModuleOpen(
    NvSciBufModule* newModule);
 
void NvSciBufModuleClose(
    NvSciBufModule module);
 
#if (NV_IS_SAFETY == 0)
 
#endif
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a isCompatible is NULL
 */
#if (NV_IS_SAFETY == 0)
 
#endif
 
NvSciError NvSciBufCheckVersionCompatibility(
    uint32_t majorVer,
    uint32_t minorVer,
    bool* isCompatible);
 
#if (NV_IS_SAFETY == 0)
 
#else
 
#endif
 
NvSciError NvSciBufObjValidate(
    NvSciBufObj bufObj);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_InsufficientMemory If any allocation of memory fails for validation.
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a reconciledAttrList is NULL
 *      - @a pairArray is NULL
 *      - NvSciBufAttrKey specified in @a pairArray is invalid.
 *      - @a pairCount is 0.
 *  - NvSciError_AttrListValidationFailed indicates that reconciled
 *    NvSciBufAttrList is not valid against the user provided key value pair(s).
 * - panics if @a reconciledAttrList is invalid.
 *
 * @pre @id{NvSciBufAttrListValidateReconciledAgainstAttrs_PreCond_001} @asil{B}
 *  Valid reconciled NvSciBufAttrList is obtained.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: Yes
 *   - Runtime: No
 *   - De-Init: No
 */
NvSciError NvSciBufAttrListValidateReconciledAgainstAttrs(
    const NvSciBufAttrList reconciledAttrList,
    const NvSciBufAttrKeyValuePair* pairArray,
    const size_t pairCount);
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_BadParameter if any of the following occurs:
 *      - @a bufObj is NULL
 *      - @a ipcEndpoint is invalid
 *      - @a accPerm is NULL.
 * - panics if @a bufObj is invalid.
 *
 * @pre @id{NvSciBufObjGetMaxPerm_PreCond_001} @asil{B}
 *  Valid NvSciBufObj is obtained.
 * @pre @id{NvSciBufObjGetMaxPerm_PreCond_002} @asil{QM}
 *  Valid NvSciIpcEndpoint is obtained.
 *
 * @usage
 * - Allowed context for the API call
 *   - Interrupt handler: No
 *   - Signal handler: No
 *   - Thread-safe: Yes
 *   - Re-entrant: No
 *   - Async/Sync: Sync
 * - Required privileges: None
 * - API group
 *   - Init: No
 *   - Runtime: Yes
 *   - De-Init: No
 */
 
NvSciError NvSciBufObjGetMaxPerm(
    const NvSciBufObj bufObj,
    const NvSciIpcEndpoint ipcEndpoint,
    NvSciBufAttrValAccessPerm* accPerm);
 
 
#ifndef __QNX__
 
#if (defined(NV_QNX))
/*
 * - NvSciError_InvalidState If the Init Mode API is called in Runtime Mode.
 */
#endif
/*
 * - NvSciError_ResourceError if system lacks resource other than memory.
 * - panics if @a bufObj is invalid.
 */
#else
 
#endif
 
NvSciError NvSciBufObjGetDmaBufFd(
    NvSciBufObj bufObj,
    int* fd);
 
 
#if defined(__cplusplus)
}
#endif // __cplusplus
 
#endif /* INCLUDED_NVSCIBUF_H */