* Copyright 2020-2021 Huawei Technologies Co., Ltd
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#include "debug/common.h"
#include <memory>
#include <iomanip>
#include <optional>
#include <fstream>
#include "utils/system/env.h"
#include "utils/system/file_system.h"
#include "utils/log_adapter.h"
#include "utils/file_utils.h"
#include "utils/utils.h"
namespace mindspore {
std::optional<std::string> Common::CreatePrefixPath(const std::string &input_path, const bool support_relative_path) {
std::optional<std::string> prefix_path;
std::optional<std::string> file_name;
FileUtils::SplitDirAndFileName(input_path, &prefix_path, &file_name);
if (!file_name.has_value()) {
MS_LOG(ERROR) << "Cannot get file_name from: " << input_path;
return std::nullopt;
}
auto file_name_str = file_name.value();
#if defined(SYSTEM_ENV_POSIX)
if (file_name_str.length() > NAME_MAX) {
MS_LOG(ERROR) << "The length of file name: " << file_name_str.length() << " exceeds limit: " << NAME_MAX;
return std::nullopt;
}
#endif
std::string prefix_path_str;
if (prefix_path.has_value()) {
auto create_prefix_path = FileUtils::CreateNotExistDirs(prefix_path.value(), support_relative_path);
if (!create_prefix_path.has_value()) {
return std::nullopt;
}
prefix_path_str = create_prefix_path.value();
} else {
auto pwd_path = FileUtils::GetRealPath("./");
if (!pwd_path.has_value()) {
MS_LOG(ERROR) << "Cannot get pwd path";
return std::nullopt;
}
prefix_path_str = pwd_path.value();
}
return std::string(prefix_path_str + "/" + file_name_str);
}
bool Common::CommonFuncForConfigPath(const std::string &default_path, const std::string &env_path, std::string *value) {
MS_EXCEPTION_IF_NULL(value);
value->clear();
if (!env_path.empty()) {
char real_path[PATH_MAX] = {0};
#if defined(SYSTEM_ENV_WINDOWS)
if (_fullpath(real_path, common::SafeCStr(env_path), PATH_MAX) == nullptr) {
MS_LOG(ERROR) << "The dir " << env_path << " does not exist.";
return false;
}
*value = real_path;
return true;
#else
if (realpath(env_path.c_str(), real_path)) {
*value = real_path;
return true;
}
MS_LOG(ERROR) << "Invalid env path, path : " << env_path;
return false;
#endif
}
*value = default_path;
return true;
}
std::optional<std::string> Common::GetConfigFile(const std::string &env) {
if (env.empty()) {
MS_LOG(EXCEPTION) << "Invalid env";
}
auto config_path_str = common::GetEnv(env);
if (config_path_str.empty()) {
MS_LOG(ERROR) << "Please export env:" << env;
return std::nullopt;
}
MS_LOG(INFO) << "Async Dump Getenv env:" << env << "=" << config_path_str;
auto real_path = FileUtils::GetRealPath(common::SafeCStr(config_path_str));
if (!real_path.has_value()) {
MS_LOG(ERROR) << "Can't get real_path";
return std::nullopt;
}
std::string dump_config_file = real_path.value();
std::shared_ptr<system::FileSystem> fs = system::Env::GetFileSystem();
MS_EXCEPTION_IF_NULL(fs);
if (!fs->FileExist(dump_config_file)) {
MS_LOG(ERROR) << dump_config_file << " not exist.";
return std::nullopt;
}
auto point_pos = dump_config_file.find_last_of('.');
if (point_pos == std::string::npos) {
MS_LOG(EXCEPTION) << "Invalid json file name:" << dump_config_file;
}
auto suffix = dump_config_file.substr(point_pos + 1);
if (suffix != "json") {
MS_LOG(EXCEPTION) << "[DataDump] dump config file suffix only supports json! But got:." << suffix;
}
return dump_config_file;
}
bool Common::IsStrLengthValid(const std::string &str, size_t length_limit, const std::string &error_message) {
auto len_str = str.length();
if (len_str > length_limit) {
MS_LOG(ERROR) << error_message << "The length is " << str.length() << ", exceeding the limit of " << length_limit
<< ".";
return false;
}
return true;
}
bool Common::IsEveryFilenameValid(const std::string &path, size_t length_limit, const std::string &error_message) {
if (path.empty()) {
MS_LOG(WARNING) << error_message << "The path is empty.";
return false;
}
size_t len_path = path.length();
size_t left_pos = 0;
for (size_t i = 0; i < len_path; i++) {
if (i != 0) {
if (path[i] == '\\' || path[i] == '/') {
auto cur_len = i - left_pos;
if (cur_len > length_limit) {
MS_LOG(WARNING) << error_message << "The name length of '" << path.substr(left_pos, cur_len) << "' is "
<< cur_len << ". It is out of the limit which is " << length_limit << ".";
return false;
}
left_pos = i + 1;
}
}
}
if (!(path[len_path - 1] == '\\' || path[len_path - 1] == '/')) {
auto cur_len = len_path - left_pos;
if (cur_len > length_limit) {
MS_LOG(WARNING) << error_message << "The name length of '" << path.substr(left_pos, cur_len) << "' is " << cur_len
<< ". It is out of the limit which is " << length_limit << ".";
return false;
}
}
return true;
}
bool Common::IsPathValid(const std::string &path, size_t length_limit, const std::string &error_message) {
std::string err_msg = "Detail: ";
if (!error_message.empty()) {
err_msg = error_message + " " + err_msg;
}
if (path.empty()) {
MS_LOG(WARNING) << err_msg << "The path is empty.";
return false;
}
if (!IsStrLengthValid(path, length_limit, err_msg)) {
return false;
}
if (!std::all_of(path.begin(), path.end(), [](char c) {
return ::isalpha(c) || ::isdigit(c) || c == '-' || c == '_' || c == '.' || c == '/';
})) {
MS_LOG(ERROR) << err_msg << "The path only supports alphabets, digit or {'-', '_', '.', '/'}, but got:" << path
<< ".";
return false;
}
if (path[0] != '/') {
MS_LOG(ERROR) << err_msg << "The path only supports absolute path and should start with '/'.";
return false;
}
if (!IsEveryFilenameValid(path, MAX_OS_FILENAME_LENGTH, err_msg)) {
return false;
}
return true;
}
bool Common::IsFilenameValid(const std::string &filename, size_t length_limit, const std::string &error_message) {
std::string err_msg = "Detail: ";
if (!error_message.empty()) {
err_msg = error_message + " " + err_msg;
}
if (filename.empty()) {
MS_LOG(WARNING) << err_msg << "The filename is empty.";
return false;
}
if (!IsStrLengthValid(filename, length_limit, err_msg)) {
return false;
}
auto func = [](char c) { return ::isalpha(c) || ::isdigit(c) || c == '-' || c == '_' || c == '.'; };
if (!std::all_of(filename.begin(), filename.end(), func)) {
MS_LOG(ERROR) << err_msg << "The filename only supports alphabets, digit or {'-', '_', '.'}, but got:" << filename
<< ".";
return false;
}
return true;
}
std::string Common::AddId(const std::string &filename, const std::string &suffix) {
static size_t g_id = 0;
std::ostringstream s;
auto i = filename.rfind(suffix);
const int spaces = 4;
if (i >= filename.size()) {
s << filename;
s << "_" << std::setfill('0') << std::setw(spaces) << g_id;
} else {
s << filename.substr(0, i);
s << "_" << std::setfill('0') << std::setw(spaces) << g_id;
if (i + 1 < filename.size()) {
s << filename.substr(i);
}
}
g_id++;
return s.str();
}
bool Common::SaveStringToFile(const std::string filename, const std::string string_info) {
if (filename.size() >= PATH_MAX) {
MS_LOG(ERROR) << "File path " << filename << " is too long.";
return false;
}
auto real_path = CreatePrefixPath(filename);
if (!real_path.has_value()) {
MS_LOG(ERROR) << "Get real path failed. path=" << filename;
return false;
}
ChangeFileMode(real_path.value(), S_IRWXU);
std::ofstream ofs;
ofs.open(real_path.value());
if (!ofs.is_open()) {
MS_LOG(ERROR) << "Open dump file '" << real_path.value() << "' failed!" << ErrnoToString(errno);
return false;
}
ofs << string_info << std::endl;
ofs.close();
ChangeFileMode(real_path.value(), S_IRUSR);
return true;
}
bool Common::FileExists(const std::string &filepath) {
std::ifstream f(filepath);
bool cache_file_existed = f.good();
f.close();
return cache_file_existed;
}
struct GlogLogDirRegister {
GlogLogDirRegister() {
const std::string logtostderr = common::GetEnv("GLOG_logtostderr");
const std::string log_dir = common::GetEnv("GLOG_log_dir");
if (!logtostderr.empty() && !log_dir.empty()) {
std::string logtostderr_str = std::string(logtostderr);
std::string log_dir_str = std::string(log_dir);
if (logtostderr_str != "0") {
return;
}
const std::string rank_id = common::GetEnv("RANK_ID");
const std::string gpu_rank_id = common::GetEnv("OMPI_COMM_WORLD_RANK");
std::string rank = "0";
bool both_exist = false;
if (!rank_id.empty() && gpu_rank_id.empty()) {
rank = std::string(rank_id);
} else if (rank_id.empty() && !gpu_rank_id.empty()) {
rank = std::string(gpu_rank_id);
} else if (!rank_id.empty() && !gpu_rank_id.empty()) {
rank = std::string(rank_id);
both_exist = true;
}
log_dir_str += "/rank_" + rank + "/logs/";
auto real_log_dir_str = Common::CreatePrefixPath(log_dir_str, true);
if (!real_log_dir_str.has_value()) {
MS_LOG(ERROR) << "The path of log files, which set by 'GLOG_log_dir', is invalid.";
exit(EXIT_FAILURE);
}
if (both_exist) {
MS_LOG(WARNING) << "Environment variables RANK_ID and OMPI_COMM_WORLD_RANK both exist, we will use RANK_ID to "
"get rank id by default.";
}
}
}
} _glog_log_dir_register;
}