login about faq

Does anyone know how to kill a process in Tectia without having to suspend it with Control-Z, find its pid and "kill -INT [pid]"? In putty we can just do Control-C, but this doesnt work in Tectia.

I'm not sure if this is because of the default configuration in my company. The tectia version deployed is


asked Sep 12 '12 at 00:37

Zenshai's gravatar image


Hello, Tectia Client/ConnectSecure supports escape characters that you can use to i.e. terminate an active client connection.

Moreover, Tectia also has a client side daemon that you can use to control individual channels and other client features, but also, to query other cool information out from the client. Most of the commands will work on all platforms: Windows, Linux, Unix and z/OS operating systems.


Start the daemon first by running command (Windows, Linux, Unix, z/OS):


Then run the following ssh-broker-ctl command with parameters to manipulate the client daemon:

-bash-3.1$ ssh-broker-ctl

Usage: ssh-broker-ctl command [options]
Generic options:
-q, --quiet            Define that little or no output is to be
-s, --short            Shorter, more machine readable output.
-v, --verbose          Display more information, if available.
-w, --wide             Do not truncate long output lines.
-e, --charset=CS       Defines the output character set. See -e help for
                       a list.
    --time-format=FMT  Time format to be used in the output. The default
                       depends on system locale settings.
-a, --broker-address=ADDR
                       Connect to separate Connection Broker process
                       using the given address.
-h, --help             Display a context-sensitive help text.
-D, --debug=STR        Define the debug level.
-V, --version          Display the version string.

Available commands:
status                 Display status of the running Connection Broker.
list-connections       List of open connections.
list-channels          List of open connection channels.
list-keys              List of user private keys.
list-clients           List of connected client processes.
list-profiles          List of connection profiles.
list-tunnel-listeners  List of open tunnel listeners (port forwards).
connection-status      Display a detailed connection status.
close-connection       Close a connection.
close-channel          Close a channel.
disconnect-client      Disconnect a Connection Broker client.
open-tunnel-listener   Open a new tunnel listener.
close-tunnel-listener  Close tunnel listener.
view-key               Display detailed key information.
add-key                Add a new private key.
key-passphrase         Prompt the user private key passphrase.
add-provider           Add a key provider to the Connection Broker.
list-providers         List key providers in the Connection Broker.
remove-provider        Remove a key provider from Connection Broker.
key-upload             Upload a public key to a remote server.
keylog                 View and operate on the key upload log.
pkcs10-sign            Generate a PKCS#10 certificate signing request.
generate-key           Generate a new private key.
probe-key              Fetch a SecSh server host key.
remove-key             Remove a private key.
auth-handler           Default authentication handler.
config-value           Display configuration values.
validate-certificate   Validate a X.509 certificate.
add-certificate        Add a X.509 certificate to the cache.
add-crl                Add a X.509 CRL to the cache.
debug                  Define the Connection Broker debug settings.
start-gui              Start the Connection Broker GUI.
connector              Enable the Connector in the Connection Broker.
reload                 Reload the Connection Broker configuration file.
start                  Start a new Connection Broker.
stop                   Stop the Connection Broker.

Additional per command usage is available with 'ssh-broker-ctl cmd --help'.

Some example ssh-broker-ctl commands are:

ssh-broker-ctl status
ssh-broker-ctl list-clients
ssh-broker-ctl disconnect-client <CLIENT ID HERE>
ssh-broker-ctl list-channels
ssh-broker-ctl close-channel <CHANNEL ID HERE>
ssh-broker-ctl list-connections
ssh-broker-ctl close-connection <CONNECTION ID HERE>
ssh-broker-ctl list-keys
ssh-broker-ctl key-passphrase <KEY ID HERE>
ssh-broker-ctl reload


Escape Sequences

sshg3 supports escape sequences to manage a running session. For an escape sequence to take effect, it must
be typed directly after a newline character (press Enter first). The escape sequences are not displayed on
screen during typing.

The following escape sequences are supported:
~.     Terminates the connection

~Ctrl-Z    Suspends the session

~~    Sends the escape character literally.

~#    Lists forwarded connections

~-    Disables the escape character irrevocably

~?    Displays a summary of escape sequences

~r    Initiates rekeying manually

~s    Gives connection statistics, including server and client version, packets in, packets out, compression, key
exchange algorithms, public-key algorithms, and symmetric ciphers

~u   Uploads the chosen public key automatically to the server. If the user has only one key, it will be uploaded. Otherwise the largest key with a name that matches id_dsa_<size>_a will be selected

~U   Uploads a public key to the server. A list of available keys is printed and the user is prompted to select one to be uploaded

~c   Gives statistics for individual channels (data window sizes etc). This is for debugging purposes

~V   Dumps the client version number to stderr (useful for troubleshooting)

Hopefully this helps!

Regards, Sami Marttinen


answered Oct 24 '12 at 04:07

Sami%20Marttinen's gravatar image

Sami Marttinen ♦

Your answer
toggle preview

Follow this question

By Email:

Once you sign in you will be able to subscribe for any updates here



Answers and Comments

Markdown Basics

  • *italic* or __italic__
  • **bold** or __bold__
  • link:[text](http://url.com/ "title")
  • image?![alt text](/path/img.jpg "title")
  • numbered list: 1. Foo 2. Bar
  • to add a line break simply add two spaces to where you would like the new line to be.
  • basic HTML tags are also supported



Asked: Sep 12 '12 at 00:37

Seen: 4,778 times

Last updated: Oct 24 '12 at 04:07

All user contributed content licensed under the cc-by-sa license.
Powered by OSQA.