1 /* 2 * Copyright (c) 2022 Huawei Device Co., Ltd. 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 * See the License for the specific language governing permissions and 13 * limitations under the License. 14 */ 15 16 #ifndef _SYSCAP_TOOL_H 17 #define _SYSCAP_TOOL_H 18 19 #include "stdint.h" 20 21 #ifdef __cplusplus 22 #if __cplusplus 23 extern "C" { 24 #endif /* __cplusplus */ 25 #endif /* __cplusplus */ 26 27 const int32_t SINGLE_FEAT_LENGTH = 32 * 8; 28 const int32_t SINGLE_SYSCAP_LENGTH = SINGLE_FEAT_LENGTH + 17; // 17, size of prefix "SystemCapability." 29 30 /** 31 * @brief parse rpcid.sc, get the syscap info. 32 * @param inputFile Indicates the path rpcid.sc. 33 * @param syscapSetBuf Indicates the arrays of syscap string prased from rpcid.sc, 34 * after useing, need to free if through FreeDecodeBuffer(). 35 * @param syscapSetLength Indicates the length of syscapSetBuf, the length of single syscap is SINGLE_SYSCAP_LENGTH. 36 * @return Returns 0 if prase successfully; returns -1 otherwise. 37 */ 38 int32_t RPCIDFileDecodeToBuffer(char *inputFile, char **syscapSetBuf, uint32_t *syscapSetLength); 39 40 /** 41 * @brief parse rpcid stream, get the syscap info. 42 * @param contextBuffer Indicates the buffer of rpcid stream. 43 * @param bufferLen Indicates the length of rpcid stream buffer. 44 * @param syscapSetBuf Indicates the arrays of syscap string prased from rpcid.sc, 45 * after useing, need to free if through FreeDecodeBuffer(). 46 * @param syscapSetLength Indicates the length of syscapSetBuf, the length of single syscap is SINGLE_SYSCAP_LENGTH. 47 * @return Returns 0 if prase successfully; returns -1 otherwise. 48 */ 49 int32_t RPCIDStreamDecodeToBuffer( 50 char *contextBuffer, uint32_t bufferLen, char **syscapSetBuf, uint32_t *syscapSetLength); 51 52 /** 53 * @brief free the buffer alloced in RPCIDFileDecodeToBuffer() or RPCIDStreamDecodeToBuffer(). 54 * @param syscapBuf Indicates the buffer address. 55 */ 56 void FreeDecodeBuffer(char *syscapBuf); 57 58 #ifdef __cplusplus 59 #if __cplusplus 60 } 61 #endif /* __cplusplus */ 62 #endif /* __cplusplus */ 63 64 #endif /* _SYSCAP_TOOL_H */