pistol 4.0.18

A Rust Library about Cybersecurity
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

use std::net::{IpAddr, Ipv4Addr};
use thiserror::Error;

#[derive(Error, Debug)]
pub enum PistolError {
    /* OS DETECT ERROR */
    #[error("calculation of diff vec failed, the input vec length is not enough")]
    CalcDiffFailed,
    #[error("build {probe_name} ipv4 packet failed")]
    BuildIpv4PacketFailed { probe_name: String },
    #[error("build {probe_name} ipv6 packet failed")]
    BuildIpv6PacketFailed { probe_name: String },
    #[error("build {probe_name} icmp packet failed")]
    BuildIcmpPacketFailed { probe_name: String },
    #[error("build {probe_name} icmpv6 packet failed")]
    BuildIcmpv6PacketFailed { probe_name: String },
    #[error("build {probe_name} tcp packet failed")]
    BuildTcpPacketFailed { probe_name: String },
    #[error("build udp packet failed")]
    BuildUdpPacketFailed { probe_name: String },
    #[error("calculation of isr failed")]
    CalcISRFailed,
    #[error("calculation of ss failed")]
    CalcSSFailed,
    #[error("icmp length is not enough")]
    CalcUNFailed,
    #[error("not enough port value for os detect")]
    OSDetectPortsNotEnough,
    #[error("os detect results is null")]
    OSDetectResultsNullError,
    #[error("tsval value length is not enough")]
    TsValIsNull,
    #[error("system time error")]
    SystemTimeError(#[from] std::time::SystemTimeError),
    #[error("os db parser error: {name}-{line}")]
    OSDBParseError { name: String, line: String },
    #[error("service probes parser error: {name}-{line}")]
    ServiceProbesParseError { name: String, line: String },
    #[error("service probes protocol unknown: {protocol}")]
    ServiceProbesProtocolUnknown { protocol: String },
    #[error("zip error")]
    ZipError(#[from] zip::result::ZipError),
    #[error("zip file empty")]
    ZipEmptyError,

    /* PING ERROR */
    #[error("The target {target} does not support this detection method {method}")]
    PingDetectionMethodError { target: IpAddr, method: String },

    /* SCAN ERROR */
    #[error(
        "idle scan zombie {zombie_ipv4} port {zombie_port} cannot be used because IP ID sequence class is: all zeros, try another proxy"
    )]
    IdleScanAllZeroError {
        zombie_ipv4: Ipv4Addr,
        zombie_port: u16,
    },
    #[error("serde json error")]
    SerdeJsonError(#[from] serde_json::Error),

    /* SERVICE DETECT ERROR */
    #[error("parse int error")]
    ParseIntError(#[from] std::num::ParseIntError),
    #[error("fancy_regex error")]
    FancyRegexError(#[from] fancy_regex::Error),
    #[error("no match found")]
    NoMatchFound,
    #[error("can not unescape string [{s}]: {e}")]
    CanNotUnescapeString { s: String, e: String },

    /* LAYERS ERROR */
    #[error("create datalink channel failed")]
    CreateDatalinkChannelFailed,
    #[error("can not found the target mac address, please make sure the target is alive")]
    CanNotFoundMacAddress,
    #[error("can not found the route's mac address")]
    CanNotFoundRouteMacAddress,
    #[error("can not found the interface")]
    CanNotFoundInterface,
    #[error("can not found the source address, please set the source address maunal")]
    CanNotFoundSourceAddress,
    #[error("can not found router address")]
    CanNotFoundRouterAddress,
    #[error("build packet error occurret at [{location}]")]
    BuildPacketError { location: String },
    #[error("the `PistolRunner` monitoring threads is not running, please run it first")]
    PistolRunnerIsNotRunning,

    /* ROUTE ERROR */
    #[error("subnetwork error")]
    RegexError(#[from] regex::Error),

    /* HOP ERROR */
    #[error(
        "the destination address {dst_addr} and source address {src_addr} protocols do not match"
    )]
    AddressProtocolError { dst_addr: IpAddr, src_addr: IpAddr },

    /* OTHER ERROR */
    #[error("std error")]
    IOError(#[from] std::io::Error),
    #[error("subnetwork error")]
    SubnetworkError(#[from] subnetwork::SubnetworkError),
    #[error("hex error")]
    FromHexError(#[from] hex::FromHexError),
    #[error("init the capture function error: {e}")]
    InitCaptureError { e: String },
    #[error("save the traffic error: {e}")]
    SaveCaptureError { e: String },
    #[error("pcapture error")]
    PcaptureError(#[from] pcapture::error::PcaptureError),
    #[error("try lock {var_name} failed: {e}")]
    TryLockGlobalVarFailed { var_name: String, e: String },
    #[error("tracing error")]
    SetGlobalDefaultError(#[from] tracing::subscriber::SetGlobalDefaultError),
    #[error("input {v} is too loog to convert to u32")]
    InputTooLoog { v: String },
}