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
//! `clap` command-line surface for the `geph` binary.
use clap::{Args, Parser, Subcommand};
#[derive(Parser)]
#[command(name = "geph5", version, about = "Geph5 command-line client")]
pub struct Cli {
#[command(subcommand)]
pub command: Command,
}
#[derive(Subcommand)]
pub enum Command {
/// Run the privileged supervising manager (must be run as root).
Manager,
/// Register the manager to run in the background across logins and reboots
/// (systemd on Linux, a boot-time scheduled task on Windows; must be run as
/// root/Administrator).
RegisterManager,
/// Remove the manager's background registration (must be run as
/// root/Administrator).
UnregisterManager,
/// Log in with an account secret. Reads from stdin if omitted.
Login {
/// The account secret.
secret: Option<String>,
},
/// Log out and forget the stored secret.
Logout,
/// Show account information.
Account,
/// Bring the tunnel up.
Connect,
/// Tear the tunnel down.
Disconnect,
/// Re-establish the tunnel with current settings, without a leak window.
Reconnect,
/// Show connection status.
Status,
/// View or change the exit constraint.
#[command(subcommand)]
ExitConstraint(ExitConstraintCmd),
/// List available exits.
Exits,
/// Show or set whether the local SOCKS5/HTTP proxies are enabled at all.
Proxy {
/// `on` or `off`. Omit to show the current setting.
state: Option<String>,
},
/// Show or set whether the system proxy is auto-configured while connected.
AutoProxy {
/// `on` or `off`. Omit to show the current setting.
state: Option<String>,
},
/// Show or set full-tunnel VPN mode.
Vpn {
/// `on` or `off`. Omit to show the current setting.
state: Option<String>,
},
/// Show or set whether private/LAN addresses bypass the tunnel.
LanAccess {
/// `on` or `off`. Omit to show the current setting.
state: Option<String>,
},
/// Show or set whether direct (non-bridge) connections to exits are allowed.
AllowDirect {
/// `on` or `off`. Omit to show the current setting.
state: Option<String>,
},
/// Show recent logs from the engine, via the manager.
Logs {
/// Number of log lines to show.
#[arg(short = 'n', long, default_value_t = 20)]
count: usize,
},
/// Internal: apply system proxy settings for the current user. The manager
/// re-invokes this dropped to the desktop user; not for direct use.
#[command(name = "__apply-proxy", hide = true)]
ApplyProxy {
/// `on` or `off`.
mode: String,
/// PAC URL (required for `on`).
url: Option<String>,
},
}
#[derive(Subcommand)]
pub enum ExitConstraintCmd {
/// Show the current exit constraint.
Get,
/// Set the exit constraint. With no flags, picks automatically.
Set(ExitConstraintSet),
}
#[derive(Args)]
pub struct ExitConstraintSet {
/// Two-letter country code, e.g. "us". Omit for automatic selection.
#[arg(long)]
pub country: Option<String>,
/// City name (requires --country).
#[arg(long, requires = "country")]
pub city: Option<String>,
}