summaryrefslogtreecommitdiff
path: root/network/ssh-chat/ssh-chat.rst
blob: 1e3dfb44ef886b53bb3b5b412fd20207d7154114 (plain)
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
.. RST source for ssh-chat(1) man page. Convert with:
..   rst2man.py ssh-chat.rst > ssh-chat.8
.. rst2man.py comes from the SBo development/docutils package.

.. |version| replace:: 1.10
.. |date| date::

========
ssh-chat
========

-----------------------------------------
custom ssh server providing IRC-like chat
-----------------------------------------

:Manual section: 8
:Manual group: SlackBuilds.org
:Date: |date|
:Version: |version|

SYNOPSIS
========

ssh-chat [*-options*]

DESCRIPTION
===========

ssh-chat is a custom SSH server written in Go. Instead of a shell,
clients get a chat prompt when they connect.

There is no specific client for ssh-chat; use a standard ssh client to connect.

OPTIONS
=======

-v, --verbose
  Show verbose logging.

--version
  Print version and exit.

-i, --identity=file
  Private key to identify server with. (default: ~/.ssh/id_rsa)

--bind=host:port
  Host and port to listen on. (default: 0.0.0.0:2022)

--admin=file
  File of public keys who are admins.

--whitelist=file
  Optional file of public keys who are allowed to connect.

--motd=file
  Optional Message of the Day file.

--log=file
  Write chat log to this file.

--pprof=yes
  Enable pprof http server for profiling.

-h, --help       Show this help message

DEMO
====

To connect to the project's ssh-chat server:

$ ssh ssh.chat

EXAMPLES
========

ssh-chat --verbose --bind ":22" --identity ~/.ssh/id_dsa

To bind on port 22, you'll need to make sure it's free (move any other ssh
daemons to another port) and run ssh-chat as root (or with sudo).

Note that ssh-chat doesn't run in the background. If you want to 'daemonize' it,
use the --log option, and run it with a command like:

$ cd / ; ssh-chat [options] --log=logfile </dev/null >/dev/null 2>&1 &

COPYRIGHT
=========

See the file /usr/doc/ssh-chat-|version|/LICENSE for license information.

AUTHORS
=======

ssh-chat was written by Andrey Petrov.

This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.

SEE ALSO
========

ssh(1), sshd(1)

The ssh-chat homepage: https://github.com/shazow/ssh-chat/