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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
.\" t
.\" Process this file with
.\" groff -man -Tascii sshproxyd.8
.\"
.TH SSHPROXYD 8 "DECEMBER 2007" Linux "User Manuals"
.SH NAME
sshproxyd \- sshproxy daemon
.SH SYNOPSIS
.B sshproxyd\fR [--config-dir \fIcfgdir\fR]
Normal run (in the foreground).
.B sshproxyd\fR [--config-dir \fIcfgdir\fR] --daemon [--user \fIuser\fR]
[--pid \fIpidfile\fR]
Run daemonized (in the background).
.SH DESCRIPTION
.I sshproxyd
acts as an authenticating proxy gateway for SSH2 connections.
It does not use \fIssh\fR(1) nor \fIsshd\fR(8) but implements its own SSH2
stack with the \fBparamiko\fR library.
.SH OPTIONS
.B "--config-dir (-c)"
.RS
Specify a configuration directory where \fIsshproxyd\fR will find the main
configuration file \fIsshproxy.ini\fR(5) and the private DSA private key
\fIid_dsa\fR. Default value is \fI~/.sshproxy\fR.
.RE
.B "--daemon (-d)"
.RS
Run \fIsshproxyd\fR in daemon mode. In daemon mode, \fIsshproxyd\fR puts itself
in the background and runs forever, waiting for incomming connections.
.RE
.B "--user (-u)"
.RS
Run \fIsshproxyd\fR as \fIuser\fR.
This option is mandatory if \fIsshproxyd\fR is run as root.
.RE
.B "--pid (-p)"
.RS
Record the process id of the daemon in the file \fIpidfile\fR. Default is
\fI/var/run/sshproxyd.pid\fR.
.RE
.SH FILES
.I ~/.sshproxy/sshproxy.ini
.RS
The main configuration file. See \fIsshproxy.ini\fR for further details.
.RE
.I ~/.sshproxy/id_dsa
.RS
The private hostkey file. This hostkey is automatically generated by
\fIsshproxyd\fR at startup if it doesn't exist.
.RE
.I /var/run/sshproxyd.pid
.RS
The pid file, mostly useful when \fIsshproxyd\fR is run with the \fB-d\fR
option.
.SH ENVIRONMENT
.IP SSHPROXY_CONFIG
If non-null the full path to the configuration directory. Equivalent to the
\fB-c\fR option.
.SH DIAGNOSTICS
Two debug logs are generated when \fIsshproxyd\fR is running:
.RE
~/.sshproxy/log/paramiko.log
.RS
This file contains paramiko's debug messages, relative to the SSH2 protocol.
.RE
~/.sshproxy/log/sshproxy.log
.RS
This file contains sshproxy's debug messages, relative to authentication, ACLs
and proxying.
.SH BUGS
Not all features of \fIsshd\fR(8) are implemented yet. \fIsshproxyd\fR currently
provides the following features:
.RS
Remote shell
.RE
.RS
Remote command execution
.RE
.RS
X11 forwarding
.RE
.RS
scp file transfer
.RE
.RS
remote port forwarding
.RE
.RS
local port forwarding
.RE
You can report any bug found on the sshproxy mailing list:
.RS
sshproxy@penguin.fr
.SH AUTHOR
David Guerizec <david@guerizec.net>
.SH "SEE ALSO"
.BR sshproxy-setup (1),
.BR pssh (1),
.BR pscp (1),
.BR sshproxy.ini (5),
The paramiko home page: <\fIhttp://www.lag.net/paramiko/\fR>
The sshproxy home page: <\fIhttp://sshproxy-project.org/\fR>
The sshproxy online documentation:
.RS
<\fIhttp://sshproxy-project.org/documentation/\fR>
|
