necouchman commented on a change in pull request #111: GUACAMOLE-422: Document
support for timezone handshake and parameter.
URL: https://github.com/apache/guacamole-manual/pull/111#discussion_r310305443
##########
File path: src/chapters/configuring.xml
##########
@@ -3229,11 +3248,73 @@ color9: rgb:80/00/80</programlisting>
<para><indexterm>
<primary>SSH</primary>
<secondary>command</secondary>
- </indexterm>The command to execute
over the SSH session, if
- any. This parameter is optional. If
not specified, the SSH
+ </indexterm>By default, SSH sessions
will
+ start an interactive shell. The shell
+ that is used will be determined by the
+ SSH server, normally by reading the
user's
+ default login shell specified in
+ <filename>/etc/passwd</filename>. If
you
+ wish to override this and run a
specific
+ command, you can do so by filling in a
+ value for this parameter. Assuming the
+ server allows arbitrary commands to be
+ run, the session will attempt to start
+ the specified command in place of the
+ shell. This parameter is optional. If
not specified, the SSH
session will use the user's default
shell.</para>
</entry>
</row>
+ <row>
+ <entry><parameter>timezone</parameter></entry>
+ <entry>
+ <para>
+ <indexterm>
+ <primary>SSH</primary>
+ <secondary>timezone</secondary>
+ </indexterm>This parameter allows you
+ to control the timezone that is sent
+ to the server over the SSH connection,
+ which will change the way local time is
+ displayed on the server.</para>
+ <para>
+ The mechanism used to do this over SSH
+ connections is by setting the
+ <envar>TZ</envar> variable on the SSH
+ connection to the timezone specified by
+ this parameter. This means that the
SSH
+ server must allow the <envar>TZ</envar>
+ variable to be set/overriden - many SSH
+ server implementations have this
disabled
+ by default. To get this to work, you
may
+ need to modify the configuration of the
+ SSH server and explicitly allow for
+ <envar>TZ</envar> to be set/overriden.
+ </para>
+ <para>
+ The available values of this parameter
are
+ standard IANA key zone format
timezones,
+ and the value will be sent directly to
+ the server in this format.
+ </para>
+ </entry>
+ </row>
+ <row>
+
<entry><parameter>server-alive-interval</parameter></entry>
Review comment:
:coffee: ??
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
With regards,
Apache Git Services
