1 /* 2 * Copyright (c) 2023 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 SOFTBUS_DFX_ANONYMIZE_H 17 #define SOFTBUS_DFX_ANONYMIZE_H 18 19 #ifdef __cplusplus 20 extern "C" { 21 #endif 22 /** 23 * Anonymize the sensitive plain text. 24 * 25 * @note Need to call {@link AnonymizeFree} to release anonymizedStr. 26 * @param plainStr The plain string to be anonymized. 27 * @param anonymizedStr The anonymized string. 28 */ 29 void Anonymize(const char *plainStr, char **anonymizedStr); 30 31 /** 32 * Anonymize the sensitive plain deviceName. 33 * 34 * @note Need to call {@link AnonymizeFree} to release anonymizedStr. 35 * @param plainStr The plain string to be anonymized. 36 * @param anonymizedStr The anonymized string. 37 */ 38 void AnonymizeDeviceName(const char *plainStr, char **anonymizedStr); 39 40 /** 41 * Release the anonymized string. 42 * 43 * @param anonymizedStr The anonymized string. 44 */ 45 void AnonymizeFree(char *anonymizedStr); 46 47 /** 48 * Return the anonymized string if anonymizedStr is not null, 49 * else return "NULL" 50 * 51 * @param anonymizedStr The anonymized string. 52 */ 53 const char *AnonymizeWrapper(const char *anonymizedStr); 54 55 #ifdef __cplusplus 56 } 57 #endif 58 #endif // SOFTBUS_DFX_ANONYMIZE_H 59