yrutschle / sslh

Applicative Protocol Multiplexer (e.g. share SSH and HTTPS on the same port)

Home Page:https://www.rutschle.net/tech/sslh/README.html

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Please update FAQ regarding verbosity

MikhailRyazanov opened this issue · comments

doc/FAQ.md still says to use -v for debugging:

sslh/doc/FAQ.md

Lines 15 to 27 in eb84c6a

In general, if something doesn't work, you'll want to run
`sslh` with lots of logging, and the logging directly in
the terminal (Otherwise, logs are sent to `syslog`, and
usually end up in `/var/log/auth.log`). You will achieve
this by running `sslh` in foreground with verbose:
```
sslh -v 1 -f -F myconfig.cfg
```
Higher values of `verbose` produce more information. 1 is
usually sufficient. 2 will also print incoming packets used
for probing.

but this has stopped working completely since v2.0:

sslh/ChangeLog

Lines 29 to 32 in eb84c6a

New log system: instead of --verbose with arbitrary
levels, there are now several message classes. Each
message class can be set to go to stderr, syslog, or
both. Classes are documented in example.cfg.

and results in an error:

sslhcfg: invalid option "-v"

Thus the FAQ must be updated accordingly.

And a question: is there now a simple way to increase verbosity ”in general”? Or for some kind of messages — for example, it is not clear whether setting --verbose-connections will have any effect on --verbose-connections-try and --verbose-connections-error, or each of them needs to be set explicitly to see all connection-related messages.

The man file also must be updated, as it still “documents” the -v option instead of all these --verbose-...:

sslh [B<-F>I<config file>] [B<-t> I<num>] [B<--transparent>] [B<-p> I<listening address> [B<-p> I<listening address> ...] [B<--tls> I<target address for TLS>] [B<--ssh> I<target address for SSH>] [B<--openvpn> I<target address for OpenVPN>] [B<--http> I<target address for HTTP>] [B<--xmpp> I<target address for XMPP>] [B<--tinc> I<target address for TINC>] [B<--anyprot> I<default target address>] [B<--on-timeout> I<protocol name>] [B<-u> I<username>] [B<-C> I<chroot>] [B<-P> I<pidfile>] [-v] [-i] [-V] [-f] [-n]

and

sslh/sslh.pod

Lines 167 to 169 in eb84c6a

=item B<-v>, B<--verbose>
Increase verboseness.