Metadata-Version: 2.1
Name: ssh-wait
Version: 1.0.1
Summary: SSH wait
Home-page: https://github.com/barry-scott/CLI-tools
Author: Barry Scott
Author-email: barry@barrys-emacs.org
License: Apache 2.0
Keywords: development
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Utilities
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
Requires-Dist: colour-text

# ssh_wait module and ssh-wait command



## ssh-wait command

    Usage: ssh-wait <options> <host>

    ssh-wait will wait for the service to be available
    on <host>.

        --verbose
            - print progress messages
        --nowait
            - check once and exit 0 if can connect exit 1 if cannot
        --wait-limit=<limit>
            - exit 2 if service is not avaiable within <limit> seconds.
              defaults to 600.
        --service=<service>
            - check the service <service>. Can be a service
              name or a port number. Default is ssh.

## ssh_wait module

ssh_wait module

- `ssh_wait( host, service='ssh', wait=True, wait_limit=600, log_fn=print )`

The `ssh_wait` function waits for `host` to be available if 'wait` is True. Otherwise
it will checks once and returns.

The return code to indicate status of the host:

- 0 - success the host is accepting ssh connections
- 1 - failed to connect to host
- 2 - failed to connect within `wait_limit` seconds
- 3 - `service` is not known

The `service` argument can be either the name of the service (as listed in `/etc/services`) or the port number.

By default `log_fn` is the print function and will be used to log messages.
Pass `None` for `log_fn` to surpress all messages.


