Struct GetConfResponse 

pub struct GetConfResponse {
    pub entries: HashMap<String, Vec<String>>,
}

Parsed response from the GETCONF command.

Contains a mapping of configuration option names to their values. Options can have zero, one, or multiple values.

Value Semantics

• Empty Vec: Option is unset or using default value
• Single element: Option has one value
• Multiple elements: Option has multiple values (e.g., ExitPolicy)

Example

use stem_rs::response::{ControlMessage, GetConfResponse};

let msg = ControlMessage::from_str(
    "250-ControlPort=9051\r\n\
     250-DirPort\r\n\
     250 OK\r\n",
    None,
    false
).unwrap();

let response = GetConfResponse::from_message(&msg).unwrap();

// ControlPort has a value
assert_eq!(
    response.entries.get("ControlPort"),
    Some(&vec!["9051".to_string()])
);

// DirPort is unset (empty Vec)
assert_eq!(response.entries.get("DirPort"), Some(&vec![]));

Fields

entries: HashMap<String, Vec<String>>

Mapping of configuration option names to their values.

Each key is a configuration option name (e.g., “ControlPort”). Each value is a Vec of strings:

• Empty Vec: option is unset
• Single element: option has one value
• Multiple elements: option has multiple values

Implementations

impl GetConfResponse

pub fn from_message(message: &ControlMessage) -> Result<Self, Error>

Parses a GETCONF response from a control message.

Extracts configuration option names and their values from the response.

Arguments

• message - The control message to parse

Errors

Returns an error if:

• Error::InvalidArguments: One or more requested configuration options were not recognized by Tor
• Error::Protocol: The response had a non-OK status code for other reasons

Example

use stem_rs::response::{ControlMessage, GetConfResponse};

// Successful response
let msg = ControlMessage::from_str(
    "250-SocksPort=9050\r\n250 OK\r\n",
    None,
    false
).unwrap();
let response = GetConfResponse::from_message(&msg).unwrap();
assert_eq!(
    response.entries.get("SocksPort"),
    Some(&vec!["9050".to_string()])
);

// Empty response (no options requested)
let msg = ControlMessage::from_str("250 OK\r\n", None, false).unwrap();
let response = GetConfResponse::from_message(&msg).unwrap();
assert!(response.entries.is_empty());

Trait Implementations

impl Clone for GetConfResponse

fn clone(&self) -> GetConfResponse

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GetConfResponse

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.