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