advanced-ssh-config 1.1.0

Advanced SSH config
===================

|Travis| |PyPI version| |PyPI downloads| |License| |Requires.io|
|Gitter|

|ASSH logo - Advanced SSH Config logo|

Enhances ``ssh_config`` file capabilities

**NOTE**: This program is called by
`ProxyCommand <http://en.wikibooks.org/wiki/OpenSSH/Cookbook/Proxies_and_Jump_Hosts#ProxyCommand_with_Netcat>`__
from `lib-ssh <https://www.libssh.org>`__.

--------------

It works *transparently* with :

- ssh
- scp
- rsync
- git
- and even desktop applications depending on ``lib-ssh`` (for instance
`Tower <http://www.git-tower.com>`__, `Atom.io <https://atom.io>`__,
`SSH Tunnel Manager <http://projects.tynsoe.org/fr/stm/>`__)

--------------

The ``.ssh/config`` file is automatically generated, you need to update
``.ssh/config.advanced`` file instead; With new features and a better
regex engine for the hostnames.

Usage
-----

.. code:: console

$assh--helpUsage:assh[OPTIONS]COMMAND[arg...]Commands:buildBuild.ssh/configbasedon.ssh/config.advancedconnect<host>Openaconnectionto<host>info<host>PrintconnectioninformationsinitBuilda.ssh/config.advancedfilebasedon.ssh/configgenerate-etc-hostsPrinta/etc/hostsfileof.ssh/config.advancedstatsPrintstatisticsOptions:--versionshowprogra{m}^{\prime }sversionnumberandexit-h,--helpshowthishelpmessageandexit-pPORT,--port=PORTSSHport-cCONFI{G}_{F}ILE,--config=CONFI{G}_{F}ILEss{h}_{c}onfigfile-f,--force-v,--verbose-lLO{G}_{L}EVEL,--lo{g}_{l}evel=LO{G}_{L}EVEL--dry-runCommmandlinefeatures----------------------\ast \ast Gatewaychaining\ast \ast ..code::bashsshfoo.com/bar.comConnectto‘‘bar.com‘‘usingsshandcreateaproxyon‘‘bar.com‘‘to‘‘foo.com‘‘.Thenconnectto‘‘foo.com‘‘usingthecreatedproxyon‘‘bar.com‘‘...code::bashsshfoo.com/bar.com/baz.comConnectto‘‘foo.com‘‘using‘‘bar.com/baz.com‘‘whichitselfuses‘‘baz.com‘‘.Configurationfeatures-----------------------\ast \ast regexforhostnames\ast \ast :‘‘gw.school-.\ast .domain.net‘‘-\ast \ast aliases\ast \ast :‘‘gate‘‘->‘‘gate.domain.tld‘‘-\ast \ast gateways\ast \ast :transparentsshconnectionschaining-\ast \ast includes\ast \ast :splitconfigurationintomultiplefiles,supportglobbing-\ast \ast localcommandexecution\ast \ast :finallyawaytoexecuteacommandlocallyonconnection-\ast \ast inheritance\ast \ast :‘‘inherits=gate.domain.tld‘‘-\ast \ast variableexpansion\ast \ast :‘‘User=$USER`` (take $\text{You can't use 'macro parameter character \#' in math mode}$]
gateways = bar # `ssh vm-42.joe.com will use `bar` as gateway which
# itself will use `foo.com` as gateway

[default]
ProxyCommand = assh --port=%p connect %h

--------------

.. code:: ini

# Complete example
[foo]
user = pacman
port = 2222
hostname = foo.com

[bar]
hostname = 1.2.3.4
gateways = foo
# By running `ssh bar`, you will ssh to `bar` through a `ssh foo`

[^vm-[0-9]*\.joe\.com$\text{You can't use 'macro parameter character \#' in math mode}$ curl -L https://github.com/moul/advanced-ssh-config/releases/download/v1.1.0/assh-`uname -s`-`uname -m` > /usr/local/bin/assh
$chmod+x/usr/local/bin/asshUsingPypi..code::console$ pip install advanced-ssh-config

Or by cloning

.. code:: console

$gitclonehttps://github.com/moul/advanced-ssh-config$ cd advanced-ssh-config
$makeinstallFirstrun---------Automaticallygenerateanew‘‘.ssh/config.advanced‘‘basedonyourcurrent‘‘.ssh/config‘‘file:..code::console$ assh init > ~/.ssh/config.advanced
$asshbuild-fTests-----..code::console$ make test

Docker
------

Build

.. code:: console

$dockerbuild-tmoul/advanced-ssh-config.Run..code::console$ docker run -rm -i -t moul/advanced-ssh-config
or
$dockerrun-rm-i-t-v$(pwd)/:/advanced_ssh_config moul/advanced-ssh-config
or
$ docker run -rm -i -t -v moul/advanced-ssh-config python setup.py test

Contributors
------------

- `Christo DeLange <https://github.com/dldinternet>`__

--

© 2009-2015 Manfred Touron - `MIT
License <https://github.com/moul/advanced-ssh-config/blob/master/License.txt>`__.

.. |Travis| image:: https://img.shields.io/travis/moul/advanced-ssh-config.svg
:target: https://travis-ci.org/moul/advanced-ssh-config
.. |PyPI version| image:: https://img.shields.io/pypi/v/advanced-ssh-config.svg
:target: https://pypi.python.org/pypi/advanced-ssh-config/
.. |PyPI downloads| image:: https://img.shields.io/pypi/dm/advanced-ssh-config.svg
:target:
.. |License| image:: https://img.shields.io/pypi/l/advanced-ssh-config.svg?style=flat
:target: https://github.com/moul/advanced-ssh-config/blob/develop/LICENSE.md
.. |Requires.io| image:: https://img.shields.io/requires/github/moul/advanced-ssh-config.svg
:target: https://requires.io/github/moul/advanced-ssh-config/requirements/
.. |Gitter| image:: https://img.shields.io/badge/chat-gitter-ff69b4.svg
:target: https://gitter.im/moul/advanced-ssh-config
.. |ASSH logo - Advanced SSH Config logo| image:: https://raw.githubusercontent.com/moul/advanced-ssh-config/develop/assets/assh.jpg
:target: https://github.com/moul/advanced-ssh-config