1anytermd(1) anytermd(1)
2
6 anytermd - A terminal-emulating HTTP daemon
7
9 anytermd [--command arg] [--device arg] [--baudrate arg] [--port arg]
10 [--user arg] [--auth arg] [--charset arg] [--foreground] [--diff]
11 [--nodiff] [--max-sessions arg] [--max-http-connections arg]
12 [--local-only] [--name arg]
13 anytermd --help
15
17 Anyterm provides a terminal window on a web page, so you can run com‐
18 mand-line programs on a machine even when the only access to it is over
19 HTTP.
20 Anyterm consists of some Javascript on a web page, an XmlHttpRequest
22 channel on standard ports back to the server, an HTTP proxy such as
23 Apache's mod_proxy and the Anyterm daemon. The daemon, anytermd, uses a
24 pseudo-terminal to communicate with a shell or other application, and
25 includes terminal emulation. Key presses are picked up by the Javscript
26 which sends them to the daemon; changes to the emulated screen are sent
27 from the daemon to the Javascript which updates its display. Perfor‐
28 mance is quite reasonable and SSL can be used to secure the connection.
29 For security reasons, it is highly recommended that anytermd NOT be
30 exposed directly to the Internet! See the section SECURITY below.
31
33 Default values are indicated in parentheses ().
34 -c | --command arg (=/bin/bash)
36 Command to run in terminal
37 -d | --device arg
39 Device to connect to (e.g. serial port)
40 -b | --baudrate arg
42 Baud rate for serial port device (=9600)
43 -p | --port arg (=8080)
45 Port number to listen on
46 -u | --user arg
48 User to run as
49 -a | --auth arg (=none)
51 Authorisation: none|null|trivial
52 -s | --charset arg (=ascii)
54 Character set
55 -f | --foreground
57 run in foreground
58 --diff Send only differences to browser
60 -n | --nodiff
62 Send whole screen to browser each time
63 -m | --max-sessions arg (=20)
65 Maximum number of simultaneous sessions
66 --max-http-connections arg (=25)
68 Maximum number of simultaneous HTTP connections
69 --local-only
71 Accept connections only from localhost
72 --name arg (=anyterm)
74 Name used for logging and pid file
75 --help show help message
77
79 Do not run anytermd as root.
80 Anyterm's code has not been audited for security. It is almost cer‐
82 tainly possible to cause it to crash by sending it invalid input, and
83 experience suggests that this sort of weakness can also be exploited to
84 allow arbitary code execution.
85 Note that all CGI applications and similar programs are subject to this
87 sort of problem, though some are better written than others. The
88 Anyterm code does not need run with a higher priviledge level than any
89 other web application, so weaknesses in Anyterm do not put your system
90 at any higher risk than weaknesses in any other web application would.
91 Avoid exposing anytermd directly to the Internet.
93 anytermd should be used only as a backend service, reachable only via a
95 frontend HTTPS proxy, such as Apache, that requires authentication.
96 http://anyterm.org/1.1/install.html gives examples of how to set this
97 up.
98 A more complete and up-to-date discussion of security issues in
100 anytermd can be found at http://anyterm.org/security.html.
101
103 If you just want to test Anyterm, you can do:
104 anytermd --local-only
106 and then connect to http://localhost:8080 with your Javascript-enabled
108 web browser. The brower should display a terminal window containing a
109 bash command prompt owned by the user who started anytermd.
110 If you want to set up SSH-over-HTTP access on localhost:8022, you might
112 run it as:
113 anytermd --command "/usr/bin/ssh -o your-username@localhost" --port
115 8022 --user nobody --charset utf-8 --local-only
116
118 Anyterm is more fully documented on its web site, http://anyterm.org/.
119 The web site may be more up-to-date than this man page.
120
122 Anyterm is written by Phil Endecott. This man page was contributed by
123 Eric Rossen.
124Phil Endecott 1.1.something anytermd(1)