cdns_rs/a_sync/cfg_resolv_parser.rs
1/*-
2 * cdns-rs - a simple sync/async DNS query library
3 *
4 * Copyright (C) 2020 Aleksandr Morozov
5 *
6 * Copyright 2025 Aleksandr Morozov
7 *
8 * Licensed under the EUPL, Version 1.2 or - as soon they will be approved by
9 * the European Commission - subsequent versions of the EUPL (the "Licence").
10 *
11 * You may not use this work except in compliance with the Licence.
12 *
13 * You may obtain a copy of the Licence at:
14 *
15 * https://joinup.ec.europa.eu/software/page/eupl
16 *
17 * Unless required by applicable law or agreed to in writing, software
18 * distributed under the Licence is distributed on an "AS IS" basis, WITHOUT
19 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
20 * Licence for the specific language governing permissions and limitations
21 * under the Licence.
22 */
23
24/// This file contains the config file parsers.
25
26
27use std::path::Path;
28
29use async_trait::async_trait;
30
31
32use crate::cfg_resolv_parser::{ResolveConfig, OptionFlags};
33use crate::common::{RESOLV_CFG_PATH, RESOLV_CFG_PATH_P};
34use crate::error::*;
35
36use super::caches::CacheOperations;
37use super::cfg_parsers::{ConfigParser, read_file};
38
39
40
41impl CacheOperations for ResolveConfig
42{
43 fn is_reload_allowed(&self) -> bool
44 {
45 return !self.option_flags.contains(OptionFlags::OPT_NO_RELOAD);
46 }
47}
48
49
50#[async_trait]
51impl ConfigParser<ResolveConfig> for ResolveConfig
52{
53 async
54 fn parse_config() -> CDnsResult<Self>
55 {
56 let file_content = read_file(RESOLV_CFG_PATH).await?;
57
58 let ret = Self::parser_resolv_internal(file_content.as_str());
59
60 return ret;
61 }
62
63 fn get_file_path() -> &'static Path
64 {
65 return &RESOLV_CFG_PATH_P;
66 }
67
68 fn is_default(&self) -> bool
69 {
70 return self.nameservers.is_empty();
71 }
72}
73
74impl ResolveConfig
75{
76 /// This function should be used when the program which uses this library
77 /// requires to override the systems /etc/resolv.conf
78 pub async
79 fn async_custom_config(resolv_cfg: &str) -> CDnsResult<Self>
80 {
81 return Self::parser_resolv_internal(resolv_cfg);
82 }
83}
84
85