diff --git a/docs/SSHLibrary-3.0.0.rst b/docs/SSHLibrary-3.0.0.rst
new file mode 100644
index 000000000..09271c17d
--- /dev/null
+++ b/docs/SSHLibrary-3.0.0.rst
@@ -0,0 +1,126 @@
+================
+SSHLibrary 3.0.0
+================
+
+
+.. default-role:: code
+
+
+SSHLibrary_ is a `Robot Framework`_ test library for SSH and SFTP.
+SSHLibrary 3.0.0  is a new release with Python 3 support and
+other fixes and enhancements.
+
+If you have pip_ installed, just run
+
+::
+
+   pip install --upgrade robotframework-sshlibrary
+
+to install the latest release or use
+
+::
+
+   pip install robotframework-sshlibrary==3.0.0
+
+to install exactly this version. Alternatively you can download the source
+distribution from PyPI_ and install it manually.
+
+SSHLibrary 3.0.0 was released on Friday April 27, 2018.
+
+.. _Robot Framework: http://robotframework.org
+.. _SSHLibrary: https://github.com/robotframework/SSHLibrary
+.. _pip: http://pip-installer.org
+.. _PyPI: https://pypi.python.org/pypi/robotframework-sshlibrary
+.. _issue tracker: https://github.com/robotframework/SSHLibrary/issues?q=milestone%3Av3.0.0
+
+
+.. contents::
+   :depth: 2
+   :local:
+
+Most important enhancements
+===========================
+
+The main new feature in SSHLibrary 3.0.0 is the support for Python 3. The supported interpreters are Python 2.7, Python 3.4+ and Jython 2.7 (`#219`_).
+
+Another important feature is the possibility to use sudo to execute and start commands (`#189`_).
+
+The keyword documentation has been improved (`#223`_).
+
+Backwards incompatible changes
+==============================
+
+New arguments were added to `Login with Public Key` keyword and `delay` must be provided as a named argument (`#146`_).
+
+Acknowledgements
+================
+
+Thanks to `@rainmanwy <https://github.com/rainmanwy>`_ for the Python 3
+pull request (`#207`_) and also others who provided earlier PRs related
+to it.
+
+Big thanks also to `Mihai Pârvu <https://github.com/mihaiparvu>`_,
+`Oana Brinzan <https://github.com/oanab11>`_ and
+`Andreea Kovacs <https://github.com/andreeakovacs>`_ for their work and
+especially for promising to work as SSHLibrary maintainers!
+
+.. _#207: https://github.com/robotframework/SSHLibrary/pull/207
+
+Full list of fixes and enhancements
+===================================
+
+.. list-table::
+    :header-rows: 1
+
+    * - ID
+      - Type
+      - Priority
+      - Summary
+    * - `#219`_
+      - enhancement
+      - critical
+      - Python 3 compatibility
+    * - `#189`_
+      - enhancement
+      - high
+      - sudo for  "Execute Command" and "Start Command" 
+    * - `#223`_
+      - enhancement
+      - high
+      - Enhance keyword documentation
+    * - `#182`_
+      - bug
+      - medium
+      - 'Put Directory' command doesn't upload correctly the files with ':' in the name.
+    * - `#146`_
+      - enhancement
+      - medium
+      - Login using agent forwarding
+    * - `#199`_
+      - enhancement
+      - medium
+      - Support regexp for connection prompt
+    * - `#201`_
+      - enhancement
+      - medium
+      - Add support for Travis CI
+    * - `#132`_
+      - enhancement
+      - low
+      - Capture the pre login banner
+    * - `#174`_
+      - enhancement
+      - low
+      - Enhance acceptance tests to cover IPv6
+
+Altogether 9 issues. View on the `issue tracker <https://github.com/robotframework/SSHLibrary/issues?q=milestone%3Av3.0.0>`__.
+
+.. _#219: https://github.com/robotframework/SSHLibrary/issues/219
+.. _#189: https://github.com/robotframework/SSHLibrary/issues/189
+.. _#223: https://github.com/robotframework/SSHLibrary/issues/223
+.. _#182: https://github.com/robotframework/SSHLibrary/issues/182
+.. _#146: https://github.com/robotframework/SSHLibrary/issues/146
+.. _#199: https://github.com/robotframework/SSHLibrary/issues/199
+.. _#201: https://github.com/robotframework/SSHLibrary/issues/201
+.. _#132: https://github.com/robotframework/SSHLibrary/issues/132
+.. _#174: https://github.com/robotframework/SSHLibrary/issues/174
diff --git a/docs/SSHLibrary.html b/docs/SSHLibrary.html
index 99e3d71f4..a5c5c0910 100644
--- a/docs/SSHLibrary.html
+++ b/docs/SSHLibrary.html
@@ -5,8 +5,8 @@
 <meta http-equiv="Pragma" content="no-cache">
 <meta http-equiv="Expires" content="-1">
 <meta http-equiv="X-UA-Compatible" content="IE=edge">
-<meta content="Robot Framework 3.0.2 (Python 3.6.4 on linux)" name="Generator">
-<link rel="icon" type="image/x-icon" href="data:image/x-icon;base64,AAABAAEAEBAQAAEABAAoAQAAFgAAACgAAAAQAAAAIAAAAAEABAAAAAAAAAIAAAAAAAAAAAAAEAAAAAAAAAAAAAAAJEBoACtnfgA5cYYAERsiAEx2lAAbKkQAcazBACZCVwAcM1cAK0ucAAMDBQAnQncASG+FABkoVQAyWmgA6f8SgvH/Ij99+GLyIinyJfn/Yi//KSLzUy9iZogpIld3/4JVVTkid7vyUjNVNVJEAGOZ6Z7pXwAABpmZkRiLAAAGiJZpmGAAAEEt3SXdxAAATC7o/u3EAAC8MRZpjasAAAY1VVVTYAAABKqqqqpAAAAADKqq4AAAAAAAv4sAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMADAADgAwAA4AcAAOAHAADgBwAAwAcAAOAHAADgDwAA8A8AAPg/AAD+fwAA">
+<meta content="Robot Framework 3.0.4rc1 (Python 3.6.4 on linux)" name="Generator">
+<link rel="icon" type="image/x-icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKcAAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAAqAAAAAAAAAAAAAAAAAAAALIAAAD/AAAA4AAAANwAAADcAAAA3AAAANwAAADcAAAA3AAAANwAAADcAAAA4AAAAP8AAACxAAAAAAAAAKYAAAD/AAAAuwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAC/AAAA/wAAAKkAAAD6AAAAzAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAN8AAAD/AAAA+gAAAMMAAAAAAAAAAgAAAGsAAABrAAAAawAAAGsAAABrAAAAawAAAGsAAABrAAAADAAAAAAAAADaAAAA/wAAAPoAAADDAAAAAAAAAIsAAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAANEAAAAAAAAA2gAAAP8AAAD6AAAAwwAAAAAAAAAAAAAAMgAAADIAAAAyAAAAMgAAADIAAAAyAAAAMgAAADIAAAAFAAAAAAAAANoAAAD/AAAA+gAAAMMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADaAAAA/wAAAPoAAADDAAAAAAAAADwAAAB8AAAAAAAAAGAAAABcAAAAAAAAAH8AAABKAAAAAAAAAAAAAAAAAAAA2gAAAP8AAAD6AAAAwwAAAAAAAADCAAAA/wAAACkAAADqAAAA4QAAAAAAAAD7AAAA/wAAALAAAAAGAAAAAAAAANoAAAD/AAAA+gAAAMMAAAAAAAAAIwAAAP4AAAD/AAAA/wAAAGAAAAAAAAAAAAAAAMkAAAD/AAAAigAAAAAAAADaAAAA/wAAAPoAAADDAAAAAAAAAAAAAAAIAAAAcAAAABkAAAAAAAAAAAAAAAAAAAAAAAAAEgAAAAAAAAAAAAAA2gAAAP8AAAD7AAAAywAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAN4AAAD/AAAAqwAAAP8AAACvAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALIAAAD/AAAAsgAAAAAAAAC5AAAA/wAAAMoAAADAAAAAwAAAAMAAAADAAAAAwAAAAMAAAADAAAAAwAAAAMkAAAD/AAAAvAAAAAAAAAAAAAAAAAAAAKwAAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAArQAAAAAAAAAAwAMAAIABAAAf+AAAP/wAAD/8AAAgBAAAP/wAAD/8AAA//AAAJIwAADHEAAA//AAAP/wAAB/4AACAAQAAwAMAAA==">
 <style media="all" type="text/css">
 body {
     background: white;
@@ -547,7 +547,7 @@
 jQuery.extend({highlight:function(e,t,n,r){if(e.nodeType===3){var i=e.data.match(t);if(i){var s=document.createElement(n||"span");s.className=r||"highlight";var o=e.splitText(i.index);o.splitText(i[0].length);var u=o.cloneNode(true);s.appendChild(u);o.parentNode.replaceChild(s,o);return 1}}else if(e.nodeType===1&&e.childNodes&&!/(script|style)/i.test(e.tagName)&&!(e.tagName===n.toUpperCase()&&e.className===r)){for(var a=0;a<e.childNodes.length;a++){a+=jQuery.highlight(e.childNodes[a],t,n,r)}}return 0}});jQuery.fn.unhighlight=function(e){var t={className:"highlight",element:"span"};jQuery.extend(t,e);return this.find(t.element+"."+t.className).each(function(){var e=this.parentNode;e.replaceChild(this.firstChild,this);e.normalize()}).end()};jQuery.fn.highlight=function(e,t){var n={className:"highlight",element:"span",caseSensitive:false,wordsOnly:false};jQuery.extend(n,t);if(e.constructor===String){e=[e]}e=jQuery.grep(e,function(e,t){return e!=""});e=jQuery.map(e,function(e,t){return e.replace(/[-[\]{}()*+?.,\\^$|#\s]/g,"\\$&")});if(e.length==0){return this}var r=n.caseSensitive?"":"i";var i="("+e.join("|")+")";if(n.wordsOnly){i="\\b"+i+"\\b"}var s=new RegExp(i,r);return this.each(function(){jQuery.highlight(this,s,n.element,n.className)})}
 </script>
 <script type="text/javascript">
-libdoc = {"all_tags":[],"contains_tags":false,"doc":"<p>Robot Framework test library for SSH and SFTP.\x3c/p>\n<p>The library has the following main usages:\x3c/p>\n<ul>\n<li>Executing commands on the remote machine, either with blocking or non-blocking behaviour (see <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a> and <a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>, respectively).\x3c/li>\n<li>Writing and reading in an interactive shell (e.g. <a href=\"#Read\" class=\"name\">Read\x3c/a> and <a href=\"#Write\" class=\"name\">Write\x3c/a>).\x3c/li>\n<li>Transferring files and directories over SFTP (e.g. <a href=\"#Get%20File\" class=\"name\">Get File\x3c/a> and <a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a>).\x3c/li>\n<li>Ensuring that files or directories exist on the remote machine (e.g. <a href=\"#File%20Should%20Exist\" class=\"name\">File Should Exist\x3c/a> and <a href=\"#Directory%20Should%20Not%20Exist\" class=\"name\">Directory Should Not Exist\x3c/a>).\x3c/li>\n\x3c/ul>\n<p>This library works both with Python and Jython, but uses different tools internally depending on the interpreter. See <a href=\"http://code.google.com/p/robotframework-sshlibrary/wiki/InstallationInstructions\">installation instructions\x3c/a> for more details about the dependencies. IronPython is unfortunately not supported.\x3c/p>\n<h3 id=\"Table of contents\">Table of contents\x3c/h3>\n<ul>\n<li><a href=\"#Connections%20and%20login\" class=\"name\">Connections and login\x3c/a>\x3c/li>\n<li><a href=\"#Configuration\" class=\"name\">Configuration\x3c/a>\x3c/li>\n<li><a href=\"#Executing%20commands\" class=\"name\">Executing commands\x3c/a>\x3c/li>\n<li><a href=\"#Interactive%20shells\" class=\"name\">Interactive shells\x3c/a>\x3c/li>\n<li><a href=\"#Pattern%20matching\" class=\"name\">Pattern matching\x3c/a>\x3c/li>\n<li><a href=\"#Example\" class=\"name\">Example\x3c/a>\x3c/li>\n<li><a href=\"#Importing\" class=\"name\">Importing\x3c/a>\x3c/li>\n<li><a href=\"#Shortcuts\" class=\"name\">Shortcuts\x3c/a>\x3c/li>\n<li><a href=\"#Keywords\" class=\"name\">Keywords\x3c/a>\x3c/li>\n\x3c/ul>\n<h2 id=\"Connections and login\">Connections and login\x3c/h2>\n<p>The library supports multiple connections to different hosts. New connections are opened with <a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>.\x3c/p>\n<p>Logging into the host is done either with username and password (<a href=\"#Login\" class=\"name\">Login\x3c/a>) or with public/private key pair (<a href=\"#Login%20With%20Public%20Key\" class=\"name\">Login With Public key\x3c/a>).\x3c/p>\n<p>Only one connection can be active at a time. This means that most of the keywords only affect the active connection. Active connection can be changed with <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a>.\x3c/p>\n<h2 id=\"Configuration\">Configuration\x3c/h2>\n<p>Default settings for all the upcoming connections can be configured on <a href=\"#Importing\" class=\"name\">library importing\x3c/a> or later with <a href=\"#Set%20Default%20Configuration\" class=\"name\">Set Default Configuration\x3c/a>. All the settings are listed further below.\x3c/p>\n<p>Using <a href=\"#Set%20Default%20Configuration\" class=\"name\">Set Default Configuration\x3c/a> does not affect the already open connections. Settings of the current connection can be configured with <a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a>. Settings of another, non-active connection, can be configured by first using <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a> and then <a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a>.\x3c/p>\n<p>Most of the defaults can be overridden per connection by defining them as arguments to <a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>. Otherwise the defaults are used.\x3c/p>\n<h3 id=\"Configurable per connection\">Configurable per connection\x3c/h3>\n<h4 id=\"Default prompt\">Default prompt\x3c/h4>\n<p>Argument <span class=\"name\">prompt\x3c/span> defines the character sequence used by <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> and must be set before that keyword can be used.\x3c/p>\n<p>If you know the prompt on the remote machine, it is recommended to set it to ease reading output from the server after using <a href=\"#Write\" class=\"name\">Write\x3c/a>. In addition to that, <a href=\"#Login\" class=\"name\">Login\x3c/a> and <a href=\"#Login%20With%20Public%20Key\" class=\"name\">Login With Public Key\x3c/a> can read the server output more efficiently when the prompt is set.\x3c/p>\n<p>Prompt can be specified either as a normal string or a regular expression. The latter is especially useful if the prompt changes as a result of the executed commands. Prompt can be set to be a regular expression by giving <span class=\"name\">prompt\x3c/span> argument a value starting with <span class=\"name\">REGEXP\x3c/span> and the regexp inside square brackets after. e.g. <span class=\"name\">prompt=REGEXP:[$#]\x3c/span>. The support for regular expressions is new in SSHLibrary 3.0.0.\x3c/p>\n<h4 id=\"Default encoding\">Default encoding\x3c/h4>\n<p>Argument <span class=\"name\">encoding\x3c/span> defines the <a href=\"http://docs.python.org/2/library/codecs.html#standard-encodings\">character encoding\x3c/a> of input and output sequences. Starting from SSHLibrary 2.0, the default value is <span class=\"name\">UTF-8\x3c/span>.\x3c/p>\n<h4 id=\"Default path separator\">Default path separator\x3c/h4>\n<p>Argument <span class=\"name\">path_separator\x3c/span> must be set to the one known by the operating system and the SSH server on the remote machine. The path separator is used by keywords <a href=\"#Get%20File\" class=\"name\">Get File\x3c/a>, <a href=\"#Put%20File\" class=\"name\">Put File\x3c/a>, <a href=\"#Get%20Directory\" class=\"name\">Get Directory\x3c/a> and <a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a> for joining paths correctly on the remote host.\x3c/p>\n<p>The default path separator is forward slash (<span class=\"name\">/\x3c/span>) which works on Unix-like machines. On Windows the path separator to use depends on the SSH server. Some servers use forward slash and others backslash, and users need to configure the <span class=\"name\">path_separator\x3c/span> accordingly. Notice that using a backslash in Robot Framework test data requires doubling it like <span class=\"name\">\\\\\x3c/span>.\x3c/p>\n<p>Configuring the library and connection specific path separator is a new feature in SSHLibrary 2.0. Prior to it <a href=\"#Get%20File\" class=\"name\">Get File\x3c/a> and <a href=\"#Put%20File\" class=\"name\">Put File\x3c/a> had their own <span class=\"name\">path_separator\x3c/span> arguments. These keyword specific arguments were deprecated in 2.0 and will be removed in the future.\x3c/p>\n<h4 id=\"Default timeout\">Default timeout\x3c/h4>\n<p>Argument <span class=\"name\">timeout\x3c/span> is used by <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a> variants. The default value is <span class=\"name\">3 seconds\x3c/span>.\x3c/p>\n<p>Value must be in Robot Framework's time format, e.g. <span class=\"name\">3\x3c/span>, <span class=\"name\">4.5s\x3c/span>, <span class=\"name\">1 minute\x3c/span> and <span class=\"name\">2 min 3 s\x3c/span> are all accepted. See section <span class=\"name\">Time Format\x3c/span> in the Robot Framework User Guide for details.\x3c/p>\n<h4 id=\"Default newline\">Default newline\x3c/h4>\n<p>Argument <span class=\"name\">newline\x3c/span> is the line break sequence used by <a href=\"#Write\" class=\"name\">Write\x3c/a> keyword and must be set according to the operating system on the remote machine. The default value is <span class=\"name\">LF\x3c/span> (same as <span class=\"name\">\\n\x3c/span>) which is used on Unix-like operating systems. With Windows remote machines, you need to set this to <span class=\"name\">CRLF\x3c/span> (<span class=\"name\">\\r\\n\x3c/span>).\x3c/p>\n<h4 id=\"Default terminal settings\">Default terminal settings\x3c/h4>\n<p>Argument <span class=\"name\">term_type\x3c/span> defines the virtual terminal type, and arguments <span class=\"name\">width\x3c/span> and <span class=\"name\">height\x3c/span> can be used to control its  virtual size.\x3c/p>\n<h3 id=\"Not configurable per connection\">Not configurable per connection\x3c/h3>\n<h4 id=\"Default loglevel\">Default loglevel\x3c/h4>\n<p>Argument <span class=\"name\">loglevel\x3c/span> sets the log level used to log the output read by <a href=\"#Read\" class=\"name\">Read\x3c/a>, <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>, <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a>, <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a>, <a href=\"#Write\" class=\"name\">Write\x3c/a>, <a href=\"#Write%20Until%20Expected%20Output\" class=\"name\">Write Until Expected Output\x3c/a>, <a href=\"#Login\" class=\"name\">Login\x3c/a> and <a href=\"#Login%20With%20Public%20Key\" class=\"name\">Login With Public Key\x3c/a>. The default level is <span class=\"name\">INFO\x3c/span>.\x3c/p>\n<p><span class=\"name\">loglevel\x3c/span> is not configurable per connection but can be overridden by passing it as an argument to the most of the mentioned keywords. Possible argument values are <span class=\"name\">TRACE\x3c/span>, <span class=\"name\">DEBUG\x3c/span>, <span class=\"name\">INFO\x3c/span> and <span class=\"name\">WARN\x3c/span>.\x3c/p>\n<h2 id=\"Executing commands\">Executing commands\x3c/h2>\n<p>For executing commands on the remote machine, there are two possibilities:\x3c/p>\n<ul>\n<li><a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a> and <a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>. The command is executed in a new shell on the remote machine, which means that possible changes to the environment (e.g. changing working directory, setting environment variables, etc.) are not visible to the subsequent keywords.\x3c/li>\n\x3c/ul>\n<ul>\n<li><a href=\"#Write\" class=\"name\">Write\x3c/a>, <a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a>, <a href=\"#Write%20Until%20Expected%20Output\" class=\"name\">Write Until Expected Output\x3c/a>, <a href=\"#Read\" class=\"name\">Read\x3c/a>, <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>, <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> and <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a>. These keywords operate in an interactive shell, which means that changes to the environment are visible to the subsequent keywords.\x3c/li>\n\x3c/ul>\n<h2 id=\"Interactive shells\">Interactive shells\x3c/h2>\n<p><a href=\"#Write\" class=\"name\">Write\x3c/a>, <a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a>, <a href=\"#Write%20Until%20Expected%20Output\" class=\"name\">Write Until Expected Output\x3c/a>, <a href=\"#Read\" class=\"name\">Read\x3c/a>, <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>, <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> and <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a> can be used to interact with the server within the same shell.\x3c/p>\n<h3 id=\"Consumed output\">Consumed output\x3c/h3>\n<p>All of these keywords, except <a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a>, consume the read or the written text from the server output before returning. In practice this means that the text is removed from the server output, i.e. subsequent calls to <a href=\"#Read\" class=\"name\">Read\x3c/a> keywords do not return text that was already read. This is illustrated by the example below.\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>echo hello\x3c/td>\n<td>\x3c/td>\n<td># consumes written <span class=\"name\">echo hello\x3c/span>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td><a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>\x3c/td>\n<td>hello\x3c/td>\n<td># consumes read <span class=\"name\">hello\x3c/span> and everything before it\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${stdout}\x3c/td>\n<td>hello\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td><a href=\"#Read\" class=\"name\">Read\x3c/a>\x3c/td>\n<td>\x3c/td>\n<td># consumes everything available\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Not Contain\x3c/span>\x3c/td>\n<td>${stdout}\x3c/td>\n<td>hello\x3c/td>\n<td># <span class=\"name\">hello\x3c/span> was already consumed earlier\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The consumed text is logged by the keywords and their argument <span class=\"name\">loglevel\x3c/span> can be used to override <a href=\"#Default loglevel\">the default log level\x3c/a>.\x3c/p>\n<p><a href=\"#Login\" class=\"name\">Login\x3c/a> and <a href=\"#Login%20With%20Public%20Key\" class=\"name\">Login With Public Key\x3c/a> consume everything on the server output or if <a href=\"#Default prompt\">the prompt is set\x3c/a>, everything until the prompt.\x3c/p>\n<h3 id=\"Reading\">Reading\x3c/h3>\n<p><a href=\"#Read\" class=\"name\">Read\x3c/a>, <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>, <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> and <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a> can be used to read from the server. The read text is also consumed from the server output.\x3c/p>\n<p><a href=\"#Read\" class=\"name\">Read\x3c/a> reads everything available on the server output, thus clearing it.\x3c/p>\n<p><a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a> variants read output up until and <b>including\x3c/b> <span class=\"name\">expected\x3c/span> text. These keywords will fail if <a href=\"#Default timeout\">the timeout\x3c/a> expires before <span class=\"name\">expected\x3c/span> is found.\x3c/p>\n<h3 id=\"Writing\">Writing\x3c/h3>\n<p><a href=\"#Write\" class=\"name\">Write\x3c/a> and <a href=\"#Write%20Until%20Expected%20Output\" class=\"name\">Write Until Expected Output\x3c/a> consume the written text from the server output while <a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a> does not.\x3c/p>\n<p>These keywords do not return any output triggered by the written text. To get the output, one of the <a href=\"#Read\" class=\"name\">Read\x3c/a> keywords must be explicitly used.\x3c/p>\n<h2 id=\"Pattern matching\">Pattern matching\x3c/h2>\n<p>Some keywords allow their arguments to be specified as <i>glob patterns\x3c/i> where:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>*\x3c/td>\n<td>matches anything, even an empty string\x3c/td>\n\x3c/tr>\n<tr>\n<td>?\x3c/td>\n<td>matches any single character\x3c/td>\n\x3c/tr>\n<tr>\n<td>[chars]\x3c/td>\n<td>matches any character inside square brackets (e.g. <span class=\"name\">[abc]\x3c/span> matches either <span class=\"name\">a\x3c/span>, <span class=\"name\">b\x3c/span> or <span class=\"name\">c\x3c/span>)\x3c/td>\n\x3c/tr>\n<tr>\n<td>[!chars]\x3c/td>\n<td>matches any character not inside square brackets\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Pattern matching is case-sensitive regardless the local or remote operating system. Matching is implemented using Python's <a href=\"http://docs.python.org/library/fnmatch.html\">fnmatch module\x3c/a>.\x3c/p>\n<h2 id=\"Example\">Example\x3c/h2>\n<pre>\n<b>***\x3c/b> Settings <b>***\x3c/b>\nDocumentation          This example demonstrates executing commands on a remote machine\n...                    and getting their output and the return code.\n...\n...                    Notice how connections are handled as part of the suite setup and\n...                    teardown. This saves some time when executing several test cases.\n\nLibrary                <span class=\"name\">SSHLibrary\x3c/span>\nSuite Setup            <span class=\"name\">Open Connection And Log In\x3c/span>\nSuite Teardown         <a href=\"#Close%20All%20Connections\" class=\"name\">Close All Connections\x3c/a>\n\n<b>***\x3c/b> Variables <b>***\x3c/b>\n${HOST}                localhost\n${USERNAME}            test\n${PASSWORD}            test\n\n<b>***\x3c/b> Test Cases <b>***\x3c/b>\nExecute Command And Verify Output\n    [Documentation]    <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a> can be used to ran commands on the remote machine.\n    ...                The keyword returns the standard output by default.\n    ${output}=    <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>    echo Hello SSHLibrary!\n    <span class=\"name\">Should Be Equal\x3c/span>    ${output}    Hello SSHLibrary!\n\nExecute Command And Verify Return Code\n    [Documentation]    Often getting the return code of the command is enough.\n    ...                This behaviour can be adjusted as <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a> arguments.\n    ${rc}=    <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>    echo Success guaranteed.    return_stdout=False    return_rc=True\n    <span class=\"name\">Should Be Equal\x3c/span>    ${rc}    ${0}\n\nExecuting Commands In An Interactive Session\n    [Documentation]    <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a> always executes the command in a new shell.\n    ...                This means that changes to the environment are not persisted\n    ...                between subsequent <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a> keyword calls.\n    ...                <a href=\"#Write\" class=\"name\">Write\x3c/a> and <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a> variants can be used to operate in the same shell.\n    <a href=\"#Write\" class=\"name\">Write\x3c/a>    cd ..\n    <a href=\"#Write\" class=\"name\">Write\x3c/a>    echo Hello from the parent directory!\n    ${output}=    <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>    directory!\n    <span class=\"name\">Should End With\x3c/span>     ${output}    Hello from the parent directory!\n\n<b>***\x3c/b> Keywords <b>***\x3c/b>\nOpen Connection And Log In\n   <a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>    ${HOST}\n   <a href=\"#Login\" class=\"name\">Login\x3c/a>    ${USERNAME}    ${PASSWORD}\n\x3c/pre>\n<p>Save the content as file <span class=\"name\">executing_command.txt\x3c/span> and run:\x3c/p>\n<pre>\npybot executing_commands.txt\n\x3c/pre>\n<p>You may want to override the variables from commandline to try this out on your remote machine:\x3c/p>\n<pre>\npybot -v HOST:my.server.com -v USERNAME:johndoe -v PASSWORD:secretpasswd executing_commands.txt\n\x3c/pre>","generated":"2018-04-24 10:37:56","inits":[{"args":["timeout=3 seconds","newline=LF","prompt=None","loglevel=INFO","term_type=vt100","width=80","height=24","path_separator=/","encoding=UTF-8"],"doc":"<p>SSHLibrary allows some import time <a href=\"#Configuration\" class=\"name\">configuration\x3c/a>.\x3c/p>\n<p>If the library is imported without any arguments, the library defaults are used:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Library\x3c/td>\n<td>SSHLibrary\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Only arguments that are given are changed. In this example, <a href=\"#Default timeout\">the timeout\x3c/a> is changed to <span class=\"name\">10 seconds\x3c/span> but other settings are left to the library defaults:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Library\x3c/td>\n<td>SSHLibrary\x3c/td>\n<td>10 seconds\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p><a href=\"#Default prompt\">Prompt\x3c/a> does not have a default value and must be explicitly set to use <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a>. In this example, the prompt is set to <span class=\"name\">$\x3c/span>:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Library\x3c/td>\n<td>SSHLibrary\x3c/td>\n<td>prompt=$\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Prompt can also be a regular expression (since SSHLibrary 3.0.0):\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td>prompt=REGEXP:[$#]\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Multiple settings are possible. In this example, the library is brought into use with <a href=\"#Default newline\">newline\x3c/a> and <a href=\"#Default path separator\">path_separator\x3c/a> known by Windows:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Library\x3c/td>\n<td>SSHLibrary\x3c/td>\n<td>newline=CRLF\x3c/td>\n<td>path_separator=\\\\\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <a href=\"#Default terminal settings\"><span class=\"name\">term_type\x3c/span>\x3c/a>, <a href=\"#Default terminal settings\"><span class=\"name\">width\x3c/span>\x3c/a>, <a href=\"#Default terminal settings\"><span class=\"name\">height\x3c/span>\x3c/a>, <a href=\"#Default path separator\"><span class=\"name\">path separator\x3c/span>\x3c/a> and <a href=\"#Default encoding\"><span class=\"name\">encoding\x3c/span>\x3c/a> were added in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"Init","shortdoc":"SSHLibrary allows some import time `configuration`.","tags":[]}],"keywords":[{"args":[],"doc":"<p>Closes all open connections.\x3c/p>\n<p>This keyword is ought to be used either in test or suite teardown to make sure all the connections are closed before the test execution finishes.\x3c/p>\n<p>After this keyword, the connection indices returned by <a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a> are reset and start from <span class=\"name\">1\x3c/span>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>build.local.net\x3c/td>\n\x3c/tr>\n<tr>\n<td># Do something with the connections\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>[Teardown]\x3c/td>\n<td>Close all connections\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Close All Connections","shortdoc":"Closes all open connections.","tags":[]},{"args":[],"doc":"<p>Closes the current connection.\x3c/p>\n<p>No other connection is made active by this keyword. Manually use <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a> to switch to another connection.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Login\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n\x3c/tr>\n<tr>\n<td>Get File\x3c/td>\n<td>results.txt\x3c/td>\n<td>/tmp\x3c/td>\n\x3c/tr>\n<tr>\n<td>Close Connection\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td># Do something with /tmp/results.txt\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Close Connection","shortdoc":"Closes the current connection.","tags":[]},{"args":["path"],"doc":"<p>Fails if the given <span class=\"name\">path\x3c/span> does not point to an existing directory.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Directory Should Exist\x3c/td>\n<td>/usr/share/man\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Note that symlinks are followed:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Directory Should Exist\x3c/td>\n<td>/usr/local/man\x3c/td>\n<td># Points to /usr/share/man/\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>New in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"Directory Should Exist","shortdoc":"Fails if the given `path` does not point to an existing directory.","tags":[]},{"args":["path"],"doc":"<p>Fails if the given <span class=\"name\">path\x3c/span> points to an existing directory.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Directory Should Not Exist\x3c/td>\n<td>/non/existing\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Note that this keyword follows symlinks. Thus the example fails if <span class=\"name\">/non/existing\x3c/span> is a link that points to an existing directory.\x3c/p>\n<p>New in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"Directory Should Not Exist","shortdoc":"Fails if the given `path` points to an existing directory.","tags":[]},{"args":["logfile"],"doc":"<p>Enables logging of SSH protocol output to given <span class=\"name\">logfile\x3c/span>.\x3c/p>\n<p>All the existing and upcoming connections are logged onwards from the moment the keyword was called.\x3c/p>\n<p><span class=\"name\">logfile\x3c/span> is path to a file that is writable by the current local user. If the file already exists, it will be overwritten.\x3c/p>\n<p><b>Note:\x3c/b> This keyword only works with Python, i.e. when executing tests with <span class=\"name\">pybot\x3c/span>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n<td># Not logged\x3c/td>\n\x3c/tr>\n<tr>\n<td>Enable SSH Logging\x3c/td>\n<td>myserver.log\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Login\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>build.local.net\x3c/td>\n<td># Logged\x3c/td>\n\x3c/tr>\n<tr>\n<td># Do something with the connections\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td># Check myserver.log for detailed debug information\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Enable Ssh Logging","shortdoc":"Enables logging of SSH protocol output to given `logfile`.","tags":[]},{"args":["command","return_stdout=True","return_stderr=False","return_rc=False","sudo=False","sudo_password=None"],"doc":"<p>Executes <span class=\"name\">command\x3c/span> on the remote machine and returns its outputs.\x3c/p>\n<p>This keyword executes the <span class=\"name\">command\x3c/span> and returns after the execution has been finished. Use <a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a> if the command should be started on the background.\x3c/p>\n<p>By default, only the standard output is returned:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${stdout}=\x3c/td>\n<td>Execute Command\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${stdout}\x3c/td>\n<td>Hello John!\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <span class=\"name\">return_stdout\x3c/span>, <span class=\"name\">return_stderr\x3c/span> and <span class=\"name\">return_rc\x3c/span> are used to specify, what is returned by this keyword. If several arguments evaluate to true, multiple values are returned. Non-empty strings, except <span class=\"name\">false\x3c/span> and <span class=\"name\">False\x3c/span>, evaluate to true.\x3c/p>\n<p>If errors are needed as well, set the respective argument value to true:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${stdout}\x3c/td>\n<td>${stderr}=\x3c/td>\n<td>Execute Command\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>return_stderr=True\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Empty\x3c/td>\n<td>${stderr}\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Often checking the return code is enough:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${rc}=\x3c/td>\n<td>Execute Command\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>return_stdout=False\x3c/td>\n<td>return_rc=True\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal As Integers\x3c/td>\n<td>${rc}\x3c/td>\n<td>0\x3c/td>\n<td># succeeded\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <span class=\"name\">sudo\x3c/span> and <span class=\"name\">sudo_password\x3c/span> are used for executing commands within a sudo session. Due to different permission elevation in Cygwin, these two arguments will not work under Windows.\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Execute Command\x3c/td>\n<td>pwd\x3c/td>\n<td>sudo=True\x3c/td>\n<td>sudo_password=test\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The <span class=\"name\">command\x3c/span> is always executed in a new shell. Thus possible changes to the environment (e.g. changing working directory) are not visible to the later keywords:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${pwd}=\x3c/td>\n<td>Execute Command\x3c/td>\n<td>pwd\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${pwd}\x3c/td>\n<td>/home/johndoe\x3c/td>\n\x3c/tr>\n<tr>\n<td>Execute Command\x3c/td>\n<td>cd /tmp\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${pwd}=\x3c/td>\n<td>Execute Command\x3c/td>\n<td>pwd\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${pwd}\x3c/td>\n<td>/home/johndoe\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p><a href=\"#Write\" class=\"name\">Write\x3c/a> and <a href=\"#Read\" class=\"name\">Read\x3c/a> can be used for <a href=\"#Interactive shells\">running multiple commands in the same shell\x3c/a>.\x3c/p>\n<p>This keyword logs the executed command and its exit status with log level <span class=\"name\">INFO\x3c/span>.\x3c/p>\n<p><span class=\"name\">sudo\x3c/span> and <span class=\"name\">sudo_password\x3c/span> arguments are new in SSHLibrary 3.0.0.\x3c/p>","matched":true,"name":"Execute Command","shortdoc":"Executes `command` on the remote machine and returns its outputs.","tags":[]},{"args":["path"],"doc":"<p>Fails if the given <span class=\"name\">path\x3c/span> does NOT point to an existing file.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>File Should Exist\x3c/td>\n<td>/boot/initrd.img\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Note that symlinks are followed:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>File Should Exist\x3c/td>\n<td>/initrd.img\x3c/td>\n<td># Points to boot/initrd.img\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>New in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"File Should Exist","shortdoc":"Fails if the given `path` does NOT point to an existing file.","tags":[]},{"args":["path"],"doc":"<p>Fails if the given <span class=\"name\">path\x3c/span> points to an existing file.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>File Should Not Exist\x3c/td>\n<td>/non/existing\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Note that this keyword follows symlinks. Thus the example fails if <span class=\"name\">/non/existing\x3c/span> is a link that points an existing file.\x3c/p>\n<p>New in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"File Should Not Exist","shortdoc":"Fails if the given `path` points to an existing file.","tags":[]},{"args":["index_or_alias=None","index=False","host=False","alias=False","port=False","timeout=False","newline=False","prompt=False","term_type=False","width=False","height=False","encoding=False"],"doc":"<p>Return information about the connection.\x3c/p>\n<p>Connection is not changed by this keyword, use <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a> to change the active connection.\x3c/p>\n<p>If <span class=\"name\">index_or_alias\x3c/span> is not given, the information of the current connection is returned.\x3c/p>\n<p>This keyword returns an object that has the following attributes:\x3c/p>\n<table border=\"1\">\n<tr>\n<th>Name\x3c/th>\n<th>Type\x3c/th>\n<th>Explanation\x3c/th>\n\x3c/tr>\n<tr>\n<td>index\x3c/td>\n<td>integer\x3c/td>\n<td>Number of the connection. Numbering starts from <span class=\"name\">1\x3c/span>.\x3c/td>\n\x3c/tr>\n<tr>\n<td>host\x3c/td>\n<td>string\x3c/td>\n<td>Destination hostname.\x3c/td>\n\x3c/tr>\n<tr>\n<td>alias\x3c/td>\n<td>string\x3c/td>\n<td>An optional alias given when creating the connection.\x3c/td>\n\x3c/tr>\n<tr>\n<td>port\x3c/td>\n<td>integer\x3c/td>\n<td>Destination port.\x3c/td>\n\x3c/tr>\n<tr>\n<td>timeout\x3c/td>\n<td>string\x3c/td>\n<td><a href=\"#Default timeout\">Timeout\x3c/a> length in textual representation.\x3c/td>\n\x3c/tr>\n<tr>\n<td>newline\x3c/td>\n<td>string\x3c/td>\n<td><a href=\"#Default newline\">The line break sequence\x3c/a> used by <a href=\"#Write\" class=\"name\">Write\x3c/a> keyword.\x3c/td>\n\x3c/tr>\n<tr>\n<td>prompt\x3c/td>\n<td>string\x3c/td>\n<td><a href=\"#Default prompt\">Prompt character sequence\x3c/a> for <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a>.\x3c/td>\n\x3c/tr>\n<tr>\n<td>term_type\x3c/td>\n<td>string\x3c/td>\n<td>Type of the <a href=\"#Default terminal settings\">virtual terminal\x3c/a>.\x3c/td>\n\x3c/tr>\n<tr>\n<td>width\x3c/td>\n<td>integer\x3c/td>\n<td>Width of the <a href=\"#Default terminal settings\">virtual terminal\x3c/a>.\x3c/td>\n\x3c/tr>\n<tr>\n<td>height\x3c/td>\n<td>integer\x3c/td>\n<td>Height of the <a href=\"#Default terminal settings\">virtual terminal\x3c/a>.\x3c/td>\n\x3c/tr>\n<tr>\n<td>path_separator\x3c/td>\n<td>string\x3c/td>\n<td><a href=\"#Default path separator\">The path separator\x3c/a> used on the remote host.\x3c/td>\n\x3c/tr>\n<tr>\n<td>encoding\x3c/td>\n<td>string\x3c/td>\n<td><a href=\"#Default encoding\">The encoding\x3c/a> used for inputs and outputs.\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>If there is no connection, an object having <span class=\"name\">index\x3c/span> and <span class=\"name\">host\x3c/span> as <span class=\"name\">None\x3c/span> is returned, rest of its attributes having their values as configuration defaults.\x3c/p>\n<p>If you want the information for all the open connections, use <a href=\"#Get%20Connections\" class=\"name\">Get Connections\x3c/a>.\x3c/p>\n<p>Getting connection information of the current connection:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>far.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>near.server.com\x3c/td>\n<td>prompt=&gt;&gt;\x3c/td>\n<td># Current connection\x3c/td>\n\x3c/tr>\n<tr>\n<td>${nearhost}=\x3c/td>\n<td>Get Connection\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${nearhost.host}\x3c/td>\n<td>near.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${nearhost.index}\x3c/td>\n<td>2\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${nearhost.prompt}\x3c/td>\n<td>&gt;&gt;\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${nearhost.term_type}\x3c/td>\n<td>vt100\x3c/td>\n<td># From defaults\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Getting connection information using an index:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>far.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>near.server.com\x3c/td>\n<td># Current connection\x3c/td>\n\x3c/tr>\n<tr>\n<td>${farhost}=\x3c/td>\n<td>Get Connection\x3c/td>\n<td>1\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${farhost.host}\x3c/td>\n<td>far.server.com\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Getting connection information using an alias:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>far.server.com\x3c/td>\n<td>alias=far\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>near.server.com\x3c/td>\n<td># Current connection\x3c/td>\n\x3c/tr>\n<tr>\n<td>${farhost}=\x3c/td>\n<td>Get Connection\x3c/td>\n<td>far\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${farhost.host}\x3c/td>\n<td>far.server.com\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${farhost.alias}\x3c/td>\n<td>far\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>This keyword can also return plain connection attributes instead of the whole connection object. This can be adjusted using the boolean arguments <span class=\"name\">index\x3c/span>, <span class=\"name\">host\x3c/span>, <span class=\"name\">alias\x3c/span>, and so on, that correspond to the attribute names of the object. If such arguments are given, and they evaluate to true (e.g. any non-empty string except <span class=\"name\">false\x3c/span> or <span class=\"name\">False\x3c/span>), only the respective connection attributes are returned. Note that attributes are always returned in the same order arguments are specified in the signature.\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n<td>alias=example\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${host}=\x3c/td>\n<td>Get Connection\x3c/td>\n<td>host=True\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${host}\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${host}\x3c/td>\n<td>${alias}=\x3c/td>\n<td>Get Connection\x3c/td>\n<td>host=yes\x3c/td>\n<td>alias=please\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${host}\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${alias}\x3c/td>\n<td>example\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Getting only certain attributes is especially useful when using this library via the Remote library interface. This interface does not support returning custom objects, but individual attributes can be returned just fine.\x3c/p>\n<p>This keyword logs the connection information with log level <span class=\"name\">INFO\x3c/span>.\x3c/p>\n<p>New in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"Get Connection","shortdoc":"Return information about the connection.","tags":[]},{"args":[],"doc":"<p>Return information about all the open connections.\x3c/p>\n<p>This keyword returns a list of objects that are identical to the ones returned by <a href=\"#Get%20Connection\" class=\"name\">Get Connection\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>near.server.com\x3c/td>\n<td>timeout=10s\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>far.server.com\x3c/td>\n<td>timeout=5s\x3c/td>\n\x3c/tr>\n<tr>\n<td>${nearhost}\x3c/td>\n<td>${farhost}=\x3c/td>\n<td>Get Connections\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${nearhost.host}\x3c/td>\n<td>near.server.com\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal As Integers\x3c/td>\n<td>${nearhost.timeout}\x3c/td>\n<td>10\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal As Integers\x3c/td>\n<td>${farhost.port}\x3c/td>\n<td>22\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal As Integers\x3c/td>\n<td>${farhost.timeout}\x3c/td>\n<td>5\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>This keyword logs the information of connections with log level <span class=\"name\">INFO\x3c/span>.\x3c/p>","matched":true,"name":"Get Connections","shortdoc":"Return information about all the open connections.","tags":[]},{"args":["source","destination=.","recursive=False"],"doc":"<p>Downloads a directory, including its content, from the remote machine to the local machine.\x3c/p>\n<p><span class=\"name\">source\x3c/span> is a path on the remote machine. Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p><span class=\"name\">destination\x3c/span> is the target path on the local machine.  Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p><span class=\"name\">recursive\x3c/span> specifies, whether to recursively download all subdirectories inside <span class=\"name\">source\x3c/span>. Subdirectories are downloaded if the argument value evaluates to true.\x3c/p>\n<p>Examples:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Get Directory\x3c/td>\n<td>/var/logs\x3c/td>\n<td>/tmp\x3c/td>\n\x3c/tr>\n<tr>\n<td>Get Directory\x3c/td>\n<td>/var/logs\x3c/td>\n<td>/tmp/non/existing\x3c/td>\n\x3c/tr>\n<tr>\n<td>Get Directory\x3c/td>\n<td>/var/logs\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Get Directory\x3c/td>\n<td>/var/logs\x3c/td>\n<td>recursive=True\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The local <span class=\"name\">destination\x3c/span> is created as following:\x3c/p>\n<p>1. If <span class=\"name\">destination\x3c/span> is an existing path on the local machine, <span class=\"name\">source\x3c/span> directory is downloaded into it.\x3c/p>\n<p>2. If <span class=\"name\">destination\x3c/span> does not exist on the local machine, it is created and the content of <span class=\"name\">source\x3c/span> directory is downloaded into it.\x3c/p>\n<p>3. If <span class=\"name\">destination\x3c/span> is not given, <span class=\"name\">source\x3c/span> directory is downloaded into the current working directory on the local machine. This is typically the directory where the test execution was started and thus accessible using built-in <span class=\"name\">${EXECDIR}\x3c/span> variable.\x3c/p>\n<p>New in SSHLibrary 2.0.\x3c/p>\n<p>See also <a href=\"#Get%20File\" class=\"name\">Get File\x3c/a>.\x3c/p>","matched":true,"name":"Get Directory","shortdoc":"Downloads a directory, including its content, from the remote machine to the local machine.","tags":[]},{"args":["source","destination=."],"doc":"<p>Downloads file(s) from the remote machine to the local machine.\x3c/p>\n<p><span class=\"name\">source\x3c/span> is a path on the remote machine. Both absolute paths and paths relative to the current working directory are supported. If the source contains wildcards explained in <a href=\"#Pattern%20matching\" class=\"name\">pattern matching\x3c/a>, all files matching it are downloaded. In this case <span class=\"name\">destination\x3c/span> must always be a directory.\x3c/p>\n<p><span class=\"name\">destination\x3c/span> is the target path on the local machine. Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p><span class=\"name\">path_separator\x3c/span> was <b>removed\x3c/b> in SSHLibrary 2.1. Use <a href=\"#Default path separator\">the library or the connection specific setting\x3c/a> instead.\x3c/p>\n<p>Examples:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Get File\x3c/td>\n<td>/var/log/auth.log\x3c/td>\n<td>/tmp/\x3c/td>\n\x3c/tr>\n<tr>\n<td>Get File\x3c/td>\n<td>/tmp/example.txt\x3c/td>\n<td>C:\\\\temp\\\\new_name.txt\x3c/td>\n\x3c/tr>\n<tr>\n<td>Get File\x3c/td>\n<td>/path/to/*.txt\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The local <span class=\"name\">destination\x3c/span> is created using the rules explained below:\x3c/p>\n<p>1. If the <span class=\"name\">destination\x3c/span> is an existing file, the <span class=\"name\">source\x3c/span> file is downloaded over it.\x3c/p>\n<p>2. If the <span class=\"name\">destination\x3c/span> is an existing directory, the <span class=\"name\">source\x3c/span> file is downloaded into it. Possible file with the same name is overwritten.\x3c/p>\n<p>3. If the <span class=\"name\">destination\x3c/span> does not exist and it ends with the path separator of the local operating system, it is considered a directory. The directory is then created and the <span class=\"name\">source\x3c/span> file is downloaded into it. Possible missing intermediate directories are also created.\x3c/p>\n<p>4. If the <span class=\"name\">destination\x3c/span> does not exist and does not end with the local path separator, it is considered a file. The <span class=\"name\">source\x3c/span> file is downloaded and saved using that file name, and possible missing intermediate directories are also created.\x3c/p>\n<p>5. If <span class=\"name\">destination\x3c/span> is not given, the current working directory on the local machine is used as the destination. This is typically the directory where the test execution was started and thus accessible using built-in <span class=\"name\">${EXECDIR}\x3c/span> variable.\x3c/p>\n<p>Argument <span class=\"name\">path_separator\x3c/span> was deprecated in SSHLibrary 2.0.\x3c/p>\n<p>See also <a href=\"#Get%20Directory\" class=\"name\">Get Directory\x3c/a>.\x3c/p>","matched":true,"name":"Get File","shortdoc":"Downloads file(s) from the remote machine to the local machine.","tags":[]},{"args":["host=None","port=22"],"doc":"<p>Returns the banner supplied by the server upon connect.\x3c/p>\n<p>There are 2 ways of getting banner information:\x3c/p>\n<ul>\n<li>independent of any connection:\x3c/li>\n\x3c/ul>\n<table border=\"1\">\n<tr>\n<td>${banner} =\x3c/td>\n<td>Get Pre Login Banner\x3c/td>\n<td>${HOST}\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${banner}\x3c/td>\n<td>Testing pre-login banner\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The argument 'host' is mandatory for getting banner key without open connection.\x3c/p>\n<ul>\n<li>from current connection:\x3c/li>\n\x3c/ul>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>${HOST}\x3c/td>\n<td>prompt=${PROMPT}\x3c/td>\n\x3c/tr>\n<tr>\n<td>Login\x3c/td>\n<td>${USERNAME}\x3c/td>\n<td>${PASSWORD}\x3c/td>\n\x3c/tr>\n<tr>\n<td>${banner} =\x3c/td>\n<td>Get Pre Login Banner\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${banner}\x3c/td>\n<td>Testing pre-login banner\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>New in SSHLibrary 3.0.0. This keyword does not work with Jython.\x3c/p>","matched":true,"name":"Get Pre Login Banner","shortdoc":"Returns the banner supplied by the server upon connect.","tags":[]},{"args":["path","pattern=None","absolute=False"],"doc":"<p>A wrapper for <a href=\"#List%20Directory\" class=\"name\">List Directory\x3c/a> that returns only directories.\x3c/p>\n<p>New in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"List Directories In Directory","shortdoc":"A wrapper for `List Directory` that returns only directories.","tags":[]},{"args":["path","pattern=None","absolute=False"],"doc":"<p>Returns and logs items in the remote <span class=\"name\">path\x3c/span>, optionally filtered with <span class=\"name\">pattern\x3c/span>.\x3c/p>\n<p><span class=\"name\">path\x3c/span> is a path on the remote machine. Both absolute paths and paths relative to the current working directory are supported. If <span class=\"name\">path\x3c/span> is a symlink, it is followed.\x3c/p>\n<p>Item names are returned in case-sensitive alphabetical order, e.g. ['A Name', 'Second', 'a lower case name', 'one more']. Implicit directories <span class=\"name\">.\x3c/span> and <span class=\"name\">..\x3c/span> are not returned. The returned items are automatically logged.\x3c/p>\n<p>By default, the item names are returned relative to the given remote path (e.g. <span class=\"name\">file.txt\x3c/span>). If you want them be returned in the absolute format (e.g. <span class=\"name\">/home/johndoe/file.txt\x3c/span>), set the <span class=\"name\">absolute\x3c/span> argument to any non-empty string.\x3c/p>\n<p>If <span class=\"name\">pattern\x3c/span> is given, only items matching it are returned. The pattern matching syntax is explained in <a href=\"#Pattern%20matching\" class=\"name\">pattern matching\x3c/a>.\x3c/p>\n<p>Examples (using also other <a href=\"#List%20Directory\" class=\"name\">List Directory\x3c/a> variants):\x3c/p>\n<table border=\"1\">\n<tr>\n<td>@{items}=\x3c/td>\n<td>List Directory\x3c/td>\n<td>/home/johndoe\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>@{files}=\x3c/td>\n<td>List Files In Directory\x3c/td>\n<td>/tmp\x3c/td>\n<td>*.txt\x3c/td>\n<td>absolute=True\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>If you are only interested in directories or files, use <a href=\"#List%20Files%20In%20Directory\" class=\"name\">List Files In Directory\x3c/a> or <a href=\"#List%20Directories%20In%20Directory\" class=\"name\">List Directories In Directory\x3c/a>, respectively.\x3c/p>\n<p>New in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"List Directory","shortdoc":"Returns and logs items in the remote `path`, optionally filtered with `pattern`.","tags":[]},{"args":["path","pattern=None","absolute=False"],"doc":"<p>A wrapper for <a href=\"#List%20Directory\" class=\"name\">List Directory\x3c/a> that returns only files.\x3c/p>\n<p>New in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"List Files In Directory","shortdoc":"A wrapper for `List Directory` that returns only files.","tags":[]},{"args":["username","password","delay=0.5 seconds"],"doc":"<p>Logs into the SSH server with the given <span class=\"name\">username\x3c/span> and <span class=\"name\">password\x3c/span>.\x3c/p>\n<p>Connection must be opened before using this keyword.\x3c/p>\n<p>This keyword reads, returns and logs the server output after logging in. If the <a href=\"#Default prompt\">prompt is set\x3c/a>, everything until the prompt is read. Otherwise the output is read using the <a href=\"#Read\" class=\"name\">Read\x3c/a> keyword with the given <span class=\"name\">delay\x3c/span>. The output is logged using the <a href=\"#Default loglevel\">default log level\x3c/a>.\x3c/p>\n<p>Example that logs in and returns the output:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>linux.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Login\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>Last login at\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Example that logs in and returns everything until the prompt:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>linux.server.com\x3c/td>\n<td>prompt=$\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Login\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>johndoe@linux:~$\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Argument <span class=\"name\">delay\x3c/span> was added in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"Login","shortdoc":"Logs into the SSH server with the given `username` and `password`.","tags":[]},{"args":["username","keyfile","password=","allow_agent=False","look_for_keys=False","delay=0.5 seconds"],"doc":"<p>Logs into the SSH server using key-based authentication.\x3c/p>\n<p>Connection must be opened before using this keyword.\x3c/p>\n<p><span class=\"name\">username\x3c/span> is the username on the remote machine.\x3c/p>\n<p><span class=\"name\">keyfile\x3c/span> is a path to a valid OpenSSH private key file on the local filesystem.\x3c/p>\n<p><span class=\"name\">password\x3c/span> is used to unlock the <span class=\"name\">keyfile\x3c/span> if unlocking is required.\x3c/p>\n<p>This keyword reads, returns and logs the server output after logging in. If the <a href=\"#Default prompt\">prompt is set\x3c/a>, everything until the prompt is read. Otherwise the output is read using the <a href=\"#Read\" class=\"name\">Read\x3c/a> keyword with the given <span class=\"name\">delay\x3c/span>. The output is logged using the <a href=\"#Default loglevel\">default log level\x3c/a>.\x3c/p>\n<p>Example that logs in using a private key and returns the output:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>linux.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Login With Public Key\x3c/td>\n<td>johndoe\x3c/td>\n<td>/home/johndoe/.ssh/id_rsa\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${motd}\x3c/td>\n<td>Last login at\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>With locked private keys, the keyring <span class=\"name\">password\x3c/span> is required:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>linux.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Login With Public Key\x3c/td>\n<td>johndoe\x3c/td>\n<td>/home/johndoe/.ssh/id_dsa\x3c/td>\n<td>keyringpasswd\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p><span class=\"name\">allow_agent\x3c/span> enables the connection to the SSH agent. <span class=\"name\">look_for_keys\x3c/span> enables the searching for discoverable private key files in <span class=\"name\">~/.ssh/\x3c/span>.\x3c/p>\n<p>Argument <span class=\"name\">delay\x3c/span> was added in SSHLibrary 2.0. Arguments <span class=\"name\">allow_agent\x3c/span> and <span class=\"name\">look_for_keys\x3c/span> were added in SSHLibrary 3.0.0 and do not work when using Jython.\x3c/p>","matched":true,"name":"Login With Public Key","shortdoc":"Logs into the SSH server using key-based authentication.","tags":[]},{"args":["host","alias=None","port=22","timeout=None","newline=None","prompt=None","term_type=None","width=None","height=None","path_separator=None","encoding=None"],"doc":"<p>Opens a new SSH connection to the given <span class=\"name\">host\x3c/span> and <span class=\"name\">port\x3c/span>.\x3c/p>\n<p>The new connection is made active. Possible existing connections are left open in the background.\x3c/p>\n<p>Note that on Jython this keyword actually opens a connection and will fail immediately on unreachable hosts. On Python the actual connection attempt will not be done until <a href=\"#Login\" class=\"name\">Login\x3c/a> is called.\x3c/p>\n<p>This keyword returns the index of the new connection which can be used later to switch back to it. Indices start from <span class=\"name\">1\x3c/span> and are reset when <a href=\"#Close%20All%20Connections\" class=\"name\">Close All Connections\x3c/a> is used.\x3c/p>\n<p>Optional <span class=\"name\">alias\x3c/span> can be given for the connection and can be used for switching between connections, similarly as the index. See <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a> for more details.\x3c/p>\n<p>Connection parameters, like <a href=\"#Default timeout\"><span class=\"name\">timeout\x3c/span>\x3c/a> and <a href=\"#Default newline\"><span class=\"name\">newline\x3c/span>\x3c/a> are documented in <a href=\"#Configuration\" class=\"name\">configuration\x3c/a>. If they are not defined as arguments, <a href=\"#Configuration\">the library defaults\x3c/a> are used for the connection.\x3c/p>\n<p>All the arguments, except <span class=\"name\">host\x3c/span>, <span class=\"name\">alias\x3c/span> and <span class=\"name\">port\x3c/span> can be later updated with <a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a>.\x3c/p>\n<p>Starting from SSHLibrary 1.1, a shell is automatically opened by this keyword.\x3c/p>\n<p>Port <span class=\"name\">22\x3c/span> is assumed by default:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${index}=\x3c/td>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Non-standard port may be given as an argument:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${index}=\x3c/td>\n<td>Open Connection\x3c/td>\n<td>192.168.1.1\x3c/td>\n<td>port=23\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Aliases are handy, if you need to switch back to the connection later:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n<td>alias=myserver\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td># Do something with my.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>192.168.1.1\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Switch Connection\x3c/td>\n<td>myserver\x3c/td>\n<td>\x3c/td>\n<td># Back to my.server.com\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Settings can be overridden per connection, otherwise the ones set on <a href=\"#Importing\" class=\"name\">library importing\x3c/a> or with <a href=\"#Set%20Default%20Configuration\" class=\"name\">Set Default Configuration\x3c/a> are used:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>192.168.1.1\x3c/td>\n<td>timeout=1 hour\x3c/td>\n<td>newline=CRLF\x3c/td>\n\x3c/tr>\n<tr>\n<td># Do something with the connection\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n<td># Default timeout\x3c/td>\n<td># Default line breaks\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p><a href=\"#Default terminal settings\">The terminal settings\x3c/a> are also configurable per connection:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>192.168.1.1\x3c/td>\n<td>term_type=ansi\x3c/td>\n<td>width=40\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <a href=\"#Default path separator\"><span class=\"name\">path_separator\x3c/span>\x3c/a> and <a href=\"#Default encoding\"><span class=\"name\">encoding\x3c/span>\x3c/a> were added in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"Open Connection","shortdoc":"Opens a new SSH connection to the given `host` and `port`.","tags":[]},{"args":["source","destination=.","mode=0744","newline=","recursive=False"],"doc":"<p>Uploads a directory, including its content, from the local machine to the remote machine.\x3c/p>\n<p><span class=\"name\">source\x3c/span> is the path on the local machine. Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p><span class=\"name\">destination\x3c/span> is the target path on the remote machine. Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p><span class=\"name\">mode\x3c/span> can be used to set the target file permission. Numeric values are accepted. The default value is <span class=\"name\">0744\x3c/span> (-rwxr--r--).\x3c/p>\n<p><span class=\"name\">newline\x3c/span> can be used to force the line break characters that are written to the remote files. Valid values are <span class=\"name\">LF\x3c/span> and <span class=\"name\">CRLF\x3c/span>.\x3c/p>\n<p><span class=\"name\">recursive\x3c/span> specifies, whether to recursively upload all subdirectories inside <span class=\"name\">source\x3c/span>. Subdirectories are uploaded if the argument value evaluates to true.\x3c/p>\n<p>Examples:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Put Directory\x3c/td>\n<td>/var/logs\x3c/td>\n<td>/tmp\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Put Directory\x3c/td>\n<td>/var/logs\x3c/td>\n<td>/tmp/non/existing\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Put Directory\x3c/td>\n<td>/var/logs\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Put Directory\x3c/td>\n<td>/var/logs\x3c/td>\n<td>recursive=True\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Put Directory\x3c/td>\n<td>/var/logs\x3c/td>\n<td>/home/groups/robot\x3c/td>\n<td>mode=0770\x3c/td>\n\x3c/tr>\n<tr>\n<td>Put Directory\x3c/td>\n<td>/var/logs\x3c/td>\n<td>newline=CRLF\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The remote <span class=\"name\">destination\x3c/span> is created as following:\x3c/p>\n<p>1. If <span class=\"name\">destination\x3c/span> is an existing path on the remote machine, <span class=\"name\">source\x3c/span> directory is uploaded into it.\x3c/p>\n<p>2. If <span class=\"name\">destination\x3c/span> does not exist on the remote machine, it is created and the content of <span class=\"name\">source\x3c/span> directory is uploaded into it.\x3c/p>\n<p>3. If <span class=\"name\">destination\x3c/span> is not given, <span class=\"name\">source\x3c/span> directory is typically uploaded to user's home directory on the remote machine.\x3c/p>\n<p>New in SSHLibrary 2.0.\x3c/p>\n<p>See also <a href=\"#Put%20File\" class=\"name\">Put File\x3c/a>.\x3c/p>","matched":true,"name":"Put Directory","shortdoc":"Uploads a directory, including its content, from the local machine to the remote machine.","tags":[]},{"args":["source","destination=.","mode=0744","newline="],"doc":"<p>Uploads file(s) from the local machine to the remote machine.\x3c/p>\n<p><span class=\"name\">source\x3c/span> is the path on the local machine. Both absolute paths and paths relative to the current working directory are supported. If the source contains wildcards explained in <a href=\"#Pattern%20matching\" class=\"name\">pattern matching\x3c/a>, all files matching it are uploaded. In this case <span class=\"name\">destination\x3c/span> must always be a directory.\x3c/p>\n<p><span class=\"name\">destination\x3c/span> is the target path on the remote machine. Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p><span class=\"name\">mode\x3c/span> can be used to set the target file permission. Numeric values are accepted. The default value is <span class=\"name\">0744\x3c/span> (-rwxr--r--).\x3c/p>\n<p><span class=\"name\">newline\x3c/span> can be used to force the line break characters that are written to the remote files. Valid values are <span class=\"name\">LF\x3c/span> and <span class=\"name\">CRLF\x3c/span>.\x3c/p>\n<p><span class=\"name\">path_separator\x3c/span> was <b>removed\x3c/b> in SSHLibrary 2.1. Use <a href=\"#Default path separator\">the library or the connection specific setting\x3c/a> instead.\x3c/p>\n<p>Examples:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Put File\x3c/td>\n<td>/path/to/*.txt\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Put File\x3c/td>\n<td>/path/to/*.txt\x3c/td>\n<td>/home/groups/robot\x3c/td>\n<td>mode=0770\x3c/td>\n\x3c/tr>\n<tr>\n<td>Put File\x3c/td>\n<td>/path/to/*.txt\x3c/td>\n<td>newline=CRLF\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The remote <span class=\"name\">destination\x3c/span> is created as following:\x3c/p>\n<p>1. If <span class=\"name\">destination\x3c/span> is an existing file, <span class=\"name\">source\x3c/span> file is uploaded over it.\x3c/p>\n<p>2. If <span class=\"name\">destination\x3c/span> is an existing directory, <span class=\"name\">source\x3c/span> file is uploaded into it. Possible file with same name is overwritten.\x3c/p>\n<p>3. If <span class=\"name\">destination\x3c/span> does not exist and it ends with <a href=\"#Default path separator\">the path separator\x3c/a>, it is considered a directory. The directory is then created and <span class=\"name\">source\x3c/span> file uploaded into it. Possibly missing intermediate directories are also created.\x3c/p>\n<p>4. If <span class=\"name\">destination\x3c/span> does not exist and it does not end with <a href=\"#Default path separator\">the path separator\x3c/a>, it is considered a file. If the path to the file does not exist, it is created.\x3c/p>\n<p>5. If <span class=\"name\">destination\x3c/span> is not given, the user's home directory on the remote machine is used as the destination.\x3c/p>\n<p>See also <a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a>.\x3c/p>","matched":true,"name":"Put File","shortdoc":"Uploads file(s) from the local machine to the remote machine.","tags":[]},{"args":["loglevel=None","delay=None"],"doc":"<p>Consumes and returns everything available on the server output.\x3c/p>\n<p>If <span class=\"name\">delay\x3c/span> is given, this keyword waits that amount of time and reads output again. This wait-read cycle is repeated as long as further reads return more output or the <a href=\"#Default timeout\">timeout\x3c/a> expires. <span class=\"name\">delay\x3c/span> must be given in Robot Framework's time format (e.g. <span class=\"name\">5\x3c/span>, <span class=\"name\">4.5s\x3c/span>, <span class=\"name\">3 minutes\x3c/span>, <span class=\"name\">2 min 3 sec\x3c/span>) that is explained in detail in the User Guide.\x3c/p>\n<p>This keyword is most useful for reading everything from the server output, thus clearing it.\x3c/p>\n<p>The read output is logged. <span class=\"name\">loglevel\x3c/span> can be used to override the <a href=\"#Default loglevel\">default log level\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Login\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Write\x3c/td>\n<td>sudo su -\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Read\x3c/td>\n<td>delay=0.5s\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>[sudo] password for johndoe:\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Write\x3c/td>\n<td>secretpasswd\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Read\x3c/td>\n<td>loglevel=WARN\x3c/td>\n<td># Shown in the console due to loglevel\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>root@\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See <a href=\"#Interactive%20shells\" class=\"name\">interactive shells\x3c/a> for more information about writing and reading in general.\x3c/p>\n<p>Argument <span class=\"name\">delay\x3c/span> was added in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"Read","shortdoc":"Consumes and returns everything available on the server output.","tags":[]},{"args":["return_stdout=True","return_stderr=False","return_rc=False"],"doc":"<p>Returns outputs of the most recent started command.\x3c/p>\n<p>At least one command must have been started using <a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a> before this keyword can be used.\x3c/p>\n<p>By default, only the standard output of the started command is returned:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Start Command\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td>Read Command Output\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${stdout}\x3c/td>\n<td>Hello John!\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <span class=\"name\">return_stdout\x3c/span>, <span class=\"name\">return_stderr\x3c/span> and <span class=\"name\">return_rc\x3c/span> are used to specify, what is returned by this keyword. If several arguments evaluate to true, multiple values are returned. Non-empty strings, except <span class=\"name\">false\x3c/span> and <span class=\"name\">False\x3c/span>, evaluate to true.\x3c/p>\n<p>If errors are needed as well, set the argument value to true:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Start Command\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}\x3c/td>\n<td>${stderr}=\x3c/td>\n<td>Read Command Output\x3c/td>\n<td>return_stderr=True\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Empty\x3c/td>\n<td>${stderr}\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Often checking the return code is enough:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Start Command\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${rc}=\x3c/td>\n<td>Read Command Output\x3c/td>\n<td>return_stdout=False\x3c/td>\n<td>return_rc=True\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal As Integers\x3c/td>\n<td>${rc}\x3c/td>\n<td>0\x3c/td>\n<td># succeeded\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Using <a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a> and <a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a> follows 'last in, first out' (LIFO) policy, meaning that <a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a> operates on the most recent started command, after which that command is discarded and its output cannot be read again.\x3c/p>\n<p>If several commands have been started, the output of the last started command is returned. After that, a subsequent call will return the output of the new last (originally the second last) command:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Start Command\x3c/td>\n<td>echo 'HELLO'\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Start Command\x3c/td>\n<td>echo 'SECOND'\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td>Read Command Output\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${stdout}\x3c/td>\n<td>'SECOND'\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td>Read Command Output\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${stdout}\x3c/td>\n<td>'HELLO'\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>This keyword logs the read command with log level <span class=\"name\">INFO\x3c/span>.\x3c/p>","matched":true,"name":"Read Command Output","shortdoc":"Returns outputs of the most recent started command.","tags":[]},{"args":["expected","loglevel=None"],"doc":"<p>Consumes and returns the server output until <span class=\"name\">expected\x3c/span> is encountered.\x3c/p>\n<p>Text up until and including the <span class=\"name\">expected\x3c/span> will be returned.\x3c/p>\n<p>If <a href=\"#Default timeout\">the timeout\x3c/a> expires before the match is found, this keyword fails.\x3c/p>\n<p>The read output is logged. <span class=\"name\">loglevel\x3c/span> can be used to override the <a href=\"#Default loglevel\">default log level\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Login\x3c/td>\n<td>johndoe\x3c/td>\n<td>${PASSWORD}\x3c/td>\n\x3c/tr>\n<tr>\n<td>Write\x3c/td>\n<td>sudo su -\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Read Until\x3c/td>\n<td>:\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>[sudo] password for johndoe:\x3c/td>\n\x3c/tr>\n<tr>\n<td>Write\x3c/td>\n<td>${PASSWORD}\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Read Until\x3c/td>\n<td>@\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should End With\x3c/td>\n<td>${output}\x3c/td>\n<td>root@\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See also <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> and <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a> keywords. For more details about reading and writing in general, see <a href=\"#Interactive%20shells\" class=\"name\">interactive shells\x3c/a> section.\x3c/p>","matched":true,"name":"Read Until","shortdoc":"Consumes and returns the server output until `expected` is encountered.","tags":[]},{"args":["loglevel=None"],"doc":"<p>Consumes and returns the server output until the prompt is found.\x3c/p>\n<p>Text up and until prompt is returned. <a href=\"#Default prompt\">The prompt must be set\x3c/a> before this keyword is used.\x3c/p>\n<p>If <a href=\"#Default timeout\">the timeout\x3c/a> expires before the match is found, this keyword fails.\x3c/p>\n<p>This keyword is useful for reading output of a single command when output of previous command has been read and that command does not produce prompt characters in its output.\x3c/p>\n<p>The read output is logged. <span class=\"name\">loglevel\x3c/span> can be used to override the <a href=\"#Default loglevel\">default log level\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n<td>prompt=$\x3c/td>\n\x3c/tr>\n<tr>\n<td>Login\x3c/td>\n<td>johndoe\x3c/td>\n<td>${PASSWORD}\x3c/td>\n\x3c/tr>\n<tr>\n<td>Write\x3c/td>\n<td>sudo su -\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Write\x3c/td>\n<td>${PASSWORD}\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Set Client Configuration\x3c/td>\n<td>prompt=#\x3c/td>\n<td># For root, the prompt is #\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Read Until Prompt\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should End With\x3c/td>\n<td>${output}\x3c/td>\n<td>root@myserver:~#\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See also <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a> and <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a> keywords. For more details about reading and writing in general, see <a href=\"#Interactive%20shells\" class=\"name\">interactive shells\x3c/a> section.\x3c/p>","matched":true,"name":"Read Until Prompt","shortdoc":"Consumes and returns the server output until the prompt is found.","tags":[]},{"args":["regexp","loglevel=None"],"doc":"<p>Consumes and returns the server output until a match to <span class=\"name\">regexp\x3c/span> is found.\x3c/p>\n<p><span class=\"name\">regexp\x3c/span> can be a pattern or a compiled regexp object.\x3c/p>\n<p>Text up until and including the <span class=\"name\">regexp\x3c/span> will be returned.\x3c/p>\n<p>Regular expression check is implemented using the Python <a href=\"http://docs.python.org/2/library/re.html\">re module\x3c/a>. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.\x3c/p>\n<p>Things to note about the <span class=\"name\">regexp\x3c/span> syntax:\x3c/p>\n<ul>\n<li>Backslash is an escape character in the test data, and possible backslashes in the pattern must thus be escaped with another backslash (e.g. '\\\\d\\\\w+').\x3c/li>\n\x3c/ul>\n<ul>\n<li>Possible flags altering how the expression is parsed (e.g. re.IGNORECASE, re.MULTILINE) can be set by prefixing the pattern with the '(?iLmsux)' group (e.g. '(?im)pattern'). The available flags are 'IGNORECASE': 'i', 'MULTILINE': 'm', 'DOTALL': 's', 'VERBOSE': 'x', 'UNICODE': 'u', and 'LOCALE': 'L'.\x3c/li>\n\x3c/ul>\n<p>If <a href=\"#Default timeout\">the timeout\x3c/a> expires before the match is found, this keyword fails.\x3c/p>\n<p>The read output is logged. <span class=\"name\">loglevel\x3c/span> can be used to override the <a href=\"#Default loglevel\">default log level\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Login\x3c/td>\n<td>johndoe\x3c/td>\n<td>${PASSWORD}\x3c/td>\n\x3c/tr>\n<tr>\n<td>Write\x3c/td>\n<td>sudo su -\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Read Until Regexp\x3c/td>\n<td>\\\\[.*\\\\].*:\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>[sudo] password for johndoe:\x3c/td>\n\x3c/tr>\n<tr>\n<td>Write\x3c/td>\n<td>${PASSWORD}\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Read Until Regexp\x3c/td>\n<td>.*@\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>root@\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See also <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a> and <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> keywords. For more details about reading and writing in general, see <a href=\"#Interactive%20shells\" class=\"name\">interactive shells\x3c/a> section.\x3c/p>","matched":true,"name":"Read Until Regexp","shortdoc":"Consumes and returns the server output until a match to `regexp` is found.","tags":[]},{"args":["timeout=None","newline=None","prompt=None","term_type=None","width=None","height=None","path_separator=None","encoding=None"],"doc":"<p>Update the <a href=\"#Configuration\" class=\"name\">configuration\x3c/a> of the current connection.\x3c/p>\n<p>Only parameters whose value is other than <span class=\"name\">None\x3c/span> are updated.\x3c/p>\n<p>In the following example, <a href=\"#Default prompt\"><span class=\"name\">prompt\x3c/span>\x3c/a> is set for the current connection. Other settings are left intact:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Set Client Configuration\x3c/td>\n<td>prompt=$\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${myserver}=\x3c/td>\n<td>Get Connection\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${myserver.prompt}\x3c/td>\n<td>$\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Using keyword does not affect the other connections:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>linux.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Set Client Configuration\x3c/td>\n<td>prompt=$\x3c/td>\n<td>\x3c/td>\n<td># Only linux.server.com affected\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>windows.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Set Client Configuration\x3c/td>\n<td>prompt=&gt;\x3c/td>\n<td>\x3c/td>\n<td># Only windows.server.com affected\x3c/td>\n\x3c/tr>\n<tr>\n<td>${linux}\x3c/td>\n<td>${windows}=\x3c/td>\n<td>Get Connections\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${linux.prompt}\x3c/td>\n<td>$\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${windows.prompt}\x3c/td>\n<td>&gt;\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Multiple settings are possible. This example updates <a href=\"#Default terminal settings\">the terminal settings\x3c/a> of the current connection:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>192.168.1.1\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Set Client Configuration\x3c/td>\n<td>term_type=ansi\x3c/td>\n<td>width=40\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <a href=\"#Default path separator\"><span class=\"name\">path_separator\x3c/span>\x3c/a> and <a href=\"#Default encoding\"><span class=\"name\">encoding\x3c/span>\x3c/a> were added in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"Set Client Configuration","shortdoc":"Update the `configuration` of the current connection.","tags":[]},{"args":["timeout=None","newline=None","prompt=None","loglevel=None","term_type=None","width=None","height=None","path_separator=None","encoding=None"],"doc":"<p>Update the default <a href=\"#Configuration\" class=\"name\">configuration\x3c/a>.\x3c/p>\n<p>Please note that using this keyword does not affect the already open connections. Use <a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a> to configure the active connection.\x3c/p>\n<p>Only parameters whose value is other than <span class=\"name\">None\x3c/span> are updated.\x3c/p>\n<p>This example sets <a href=\"#Default prompt\"><span class=\"name\">prompt\x3c/span>\x3c/a> to <span class=\"name\">$\x3c/span>:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Set Default Configuration\x3c/td>\n<td>prompt=$\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>This example sets <a href=\"#Default newline\"><span class=\"name\">newline\x3c/span>\x3c/a> and <a href=\"#Default path separator\"><span class=\"name\">path_separator\x3c/span>\x3c/a> to the ones known by Windows:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Set Default Configuration\x3c/td>\n<td>newline=CRLF\x3c/td>\n<td>path_separator=\\\\\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Sometimes you might want to use longer <a href=\"#Default timeout\"><span class=\"name\">timeout\x3c/span>\x3c/a> for all the subsequent connections without affecting the existing ones:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Set Default Configuration\x3c/td>\n<td>timeout=5 seconds\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>local.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Set Default Configuration\x3c/td>\n<td>timeout=20 seconds\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>emea.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>apac.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${local}\x3c/td>\n<td>${emea}\x3c/td>\n<td>${apac}=\x3c/td>\n<td>Get Connections\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal As Integers\x3c/td>\n<td>${local.timeout}\x3c/td>\n<td>5\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal As Integers\x3c/td>\n<td>${emea.timeout}\x3c/td>\n<td>20\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal As Integers\x3c/td>\n<td>${apac.timeout}\x3c/td>\n<td>20\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <a href=\"#Default terminal settings\"><span class=\"name\">term_type\x3c/span>\x3c/a>, <a href=\"#Default terminal settings\"><span class=\"name\">width\x3c/span>\x3c/a>, <a href=\"#Default terminal settings\"><span class=\"name\">height\x3c/span>\x3c/a>, <a href=\"#Default path separator\"><span class=\"name\">path_separator\x3c/span>\x3c/a> and <a href=\"#Default encoding\"><span class=\"name\">encoding\x3c/span>\x3c/a> were added in SSHLibrary 2.0.\x3c/p>","matched":true,"name":"Set Default Configuration","shortdoc":"Update the default `configuration`.","tags":[]},{"args":["command","sudo=False","sudo_password=None"],"doc":"<p>Starts execution of the <span class=\"name\">command\x3c/span> on the remote machine and returns immediately.\x3c/p>\n<p>This keyword returns nothing and does not wait for the <span class=\"name\">command\x3c/span> execution to be finished. If waiting for the output is required, use <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a> instead.\x3c/p>\n<p>This keyword does not return any output generated by the started <span class=\"name\">command\x3c/span>. Use <a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a> to read the output:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Start Command\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td>Read Command Output\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${stdout}\x3c/td>\n<td>Hello John!\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The <span class=\"name\">command\x3c/span> is always executed in a new shell, similarly as with <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>. Thus possible changes to the environment (e.g. changing working directory) are not visible to the later keywords:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Start Command\x3c/td>\n<td>pwd\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${pwd}=\x3c/td>\n<td>Read Command Output\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${pwd}\x3c/td>\n<td>/home/johndoe\x3c/td>\n\x3c/tr>\n<tr>\n<td>Start Command\x3c/td>\n<td>cd /tmp\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Start Command\x3c/td>\n<td>pwd\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${pwd}=\x3c/td>\n<td>Read Command Output\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${pwd}\x3c/td>\n<td>/home/johndoe\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <span class=\"name\">sudo\x3c/span> and <span class=\"name\">sudo_password\x3c/span> are used for executing commands within a sudo session. Due to different permission elevation in Cygwin, these two arguments will not work under Windows.\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Start Command\x3c/td>\n<td>pwd\x3c/td>\n<td>sudo=True\x3c/td>\n<td>sudo_password=test\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p><a href=\"#Write\" class=\"name\">Write\x3c/a> and <a href=\"#Read\" class=\"name\">Read\x3c/a> can be used for <a href=\"#Interactive shells\">running multiple commands in the same shell\x3c/a>.\x3c/p>\n<p>This keyword logs the started command with log level <span class=\"name\">INFO\x3c/span>.\x3c/p>\n<p><span class=\"name\">sudo\x3c/span> and <span class=\"name\">sudo_password\x3c/span> arguments are new in SSHLibrary 3.0.0.\x3c/p>","matched":true,"name":"Start Command","shortdoc":"Starts execution of the `command` on the remote machine and returns immediately.","tags":[]},{"args":["index_or_alias"],"doc":"<p>Switches the active connection by index or alias.\x3c/p>\n<p><span class=\"name\">index_or_alias\x3c/span> is either connection index (an integer) or alias (a string). Index is got as the return value of <a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>. Alternatively, both index and alias can queried as attributes of the object returned by <a href=\"#Get%20Connection\" class=\"name\">Get Connection\x3c/a>.\x3c/p>\n<p>This keyword returns the index of the previous active connection, which can be used to switch back to that connection later.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${myserver}=\x3c/td>\n<td>Open Connection\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Login\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Open Connection\x3c/td>\n<td>build.local.net\x3c/td>\n<td>alias=Build\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Login\x3c/td>\n<td>jenkins\x3c/td>\n<td>jenkins\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Switch Connection\x3c/td>\n<td>${myserver}\x3c/td>\n<td>\x3c/td>\n<td># Switch using index\x3c/td>\n\x3c/tr>\n<tr>\n<td>${username}=\x3c/td>\n<td>Execute Command\x3c/td>\n<td>whoami\x3c/td>\n<td># Executed on my.server.com\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${username}\x3c/td>\n<td>johndoe\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Switch Connection\x3c/td>\n<td>Build\x3c/td>\n<td>\x3c/td>\n<td># Switch using alias\x3c/td>\n\x3c/tr>\n<tr>\n<td>${username}=\x3c/td>\n<td>Execute Command\x3c/td>\n<td>whoami\x3c/td>\n<td># Executed on build.local.net\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Be Equal\x3c/td>\n<td>${username}\x3c/td>\n<td>jenkins\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Switch Connection","shortdoc":"Switches the active connection by index or alias.","tags":[]},{"args":["text","loglevel=None"],"doc":"<p>Writes the given <span class=\"name\">text\x3c/span> on the remote machine and appends a newline.\x3c/p>\n<p>Appended <a href=\"#Default newline\">newline\x3c/a> can be configured.\x3c/p>\n<p>This keyword returns and <a href=\"#Interactive shells\">consumes\x3c/a> the written <span class=\"name\">text\x3c/span> (including the appended newline) from the server output.\x3c/p>\n<p>The written <span class=\"name\">text\x3c/span> is logged. <span class=\"name\">loglevel\x3c/span> can be used to override the <a href=\"#Default loglevel\">default log level\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${written}=\x3c/td>\n<td>Write\x3c/td>\n<td>su\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${written}\x3c/td>\n<td>su\x3c/td>\n<td># Returns the consumed output\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Read\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Not Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>${written}\x3c/td>\n<td># Was consumed from the output\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>Password:\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Write\x3c/td>\n<td>invalidpasswd\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Read\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>su: Authentication failure\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See also <a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a>.\x3c/p>","matched":true,"name":"Write","shortdoc":"Writes the given `text` on the remote machine and appends a newline.","tags":[]},{"args":["text"],"doc":"<p>Writes the given <span class=\"name\">text\x3c/span> on the remote machine without appending a newline.\x3c/p>\n<p>Unlike <a href=\"#Write\" class=\"name\">Write\x3c/a>, this keyword returns and <a href=\"#Interactive shells\">consumes\x3c/a> nothing.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Write Bare\x3c/td>\n<td>su\\n\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Read\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>su\x3c/td>\n<td># Was not consumed from output\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>Password:\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Write Bare\x3c/td>\n<td>invalidpasswd\\n\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td>Read\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>Should Contain\x3c/td>\n<td>${output}\x3c/td>\n<td>su: Authentication failure\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See also <a href=\"#Write\" class=\"name\">Write\x3c/a>.\x3c/p>","matched":true,"name":"Write Bare","shortdoc":"Writes the given `text` on the remote machine without appending a newline.","tags":[]},{"args":["text","expected","timeout","retry_interval","loglevel=None"],"doc":"<p>Writes the given <span class=\"name\">text\x3c/span> repeatedly until <span class=\"name\">expected\x3c/span> appears in the server output.\x3c/p>\n<p>This keyword returns nothing.\x3c/p>\n<p><span class=\"name\">text\x3c/span> is written without appending a newline and is <a href=\"#Interactive shells\">consumed\x3c/a> from the server output before <span class=\"name\">expected\x3c/span> is read.\x3c/p>\n<p>If <span class=\"name\">expected\x3c/span> does not appear in output within <span class=\"name\">timeout\x3c/span>, this keyword fails. <span class=\"name\">retry_interval\x3c/span> defines the time before writing <span class=\"name\">text\x3c/span> again. Both <span class=\"name\">timeout\x3c/span> and <span class=\"name\">retry_interval\x3c/span> must be given in Robot Framework's time format (e.g. <span class=\"name\">5\x3c/span>, <span class=\"name\">1 minute\x3c/span>, <span class=\"name\">2 min 3 s\x3c/span>, <span class=\"name\">4.5\x3c/span>).\x3c/p>\n<p>The written <span class=\"name\">text\x3c/span> is logged. <span class=\"name\">loglevel\x3c/span> can be used to override the <a href=\"#Default loglevel\">default log level\x3c/a>.\x3c/p>\n<p>This example will write <span class=\"name\">lsof -c python26\\n\x3c/span> (list all files currently opened by python 2.6), until <span class=\"name\">myscript.py\x3c/span> appears in the output. The command is written every 0.5 seconds. The keyword fails if <span class=\"name\">myscript.py\x3c/span> does not appear in the server output in 5 seconds:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Write Until Expected Output\x3c/td>\n<td>lsof -c python26\\n\x3c/td>\n<td>expected=myscript.py\x3c/td>\n<td>timeout=5s\x3c/td>\n<td>retry_interval=0.5s\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Write Until Expected Output","shortdoc":"Writes the given `text` repeatedly until `expected` appears in the server output.","tags":[]}],"name":"SSHLibrary","named_args":true,"scope":"global","version":"3.0.0rc1"};
+libdoc = {"all_tags":[],"contains_tags":false,"doc":"<p>SSHLibrary is a Robot Framework test library for SSH and SFTP.\x3c/p>\n<p>This document explains how to use keywords provided by SSHLibrary. For information about installation, support, and more please visit the <a href=\"https://github.com/robotframework/SSHLibrary\">project page\x3c/a>. For more information about Robot Framework, see <a href=\"http://robotframework.org\">http://robotframework.org\x3c/a>.\x3c/p>\n<p>The library has the following main usages:\x3c/p>\n<ul>\n<li>Executing commands on the remote machine, either with blocking or non-blocking behaviour (see <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a> and <a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>, respectively).\x3c/li>\n<li>Writing and reading in an interactive shell (e.g. <a href=\"#Read\" class=\"name\">Read\x3c/a> and <a href=\"#Write\" class=\"name\">Write\x3c/a>).\x3c/li>\n<li>Transferring files and directories over SFTP (e.g. <a href=\"#Get%20File\" class=\"name\">Get File\x3c/a> and <a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a>).\x3c/li>\n<li>Ensuring that files or directories exist on the remote machine (e.g. <a href=\"#File%20Should%20Exist\" class=\"name\">File Should Exist\x3c/a> and <a href=\"#Directory%20Should%20Not%20Exist\" class=\"name\">Directory Should Not Exist\x3c/a>).\x3c/li>\n\x3c/ul>\n<p>This library works both with Python and Jython, but uses different SSH modules internally depending on the interpreter. See <a href=\"http://robotframework.org/SSHLibrary/#installation\">installation instructions\x3c/a> for more details about the dependencies. IronPython is unfortunately not supported. Python 3 is supported starting from SSHLibrary 3.0.0.\x3c/p>\n<h3 id=\"Table of contents\">Table of contents\x3c/h3>\n<ul>\n<li><a href=\"#Connections%20and%20login\" class=\"name\">Connections and login\x3c/a>\x3c/li>\n<li><a href=\"#Configuration\" class=\"name\">Configuration\x3c/a>\x3c/li>\n<li><a href=\"#Executing%20commands\" class=\"name\">Executing commands\x3c/a>\x3c/li>\n<li><a href=\"#Interactive%20shells\" class=\"name\">Interactive shells\x3c/a>\x3c/li>\n<li><a href=\"#Pattern%20matching\" class=\"name\">Pattern matching\x3c/a>\x3c/li>\n<li><a href=\"#Example\" class=\"name\">Example\x3c/a>\x3c/li>\n<li><a href=\"#Importing\" class=\"name\">Importing\x3c/a>\x3c/li>\n<li><a href=\"#Shortcuts\" class=\"name\">Shortcuts\x3c/a>\x3c/li>\n<li><a href=\"#Keywords\" class=\"name\">Keywords\x3c/a>\x3c/li>\n\x3c/ul>\n<h2 id=\"Connections and login\">Connections and login\x3c/h2>\n<p>SSHLibrary supports multiple connections to different hosts. New connections are opened with <a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>.\x3c/p>\n<p>Login into the host is done either with username and password (<a href=\"#Login\" class=\"name\">Login\x3c/a>) or with public/private key pair (<a href=\"#Login%20With%20Public%20Key\" class=\"name\">Login With Public key\x3c/a>).\x3c/p>\n<p>Only one connection can be active at a time. This means that most of the keywords only affect the active connection. Active connection can be changed with <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a>.\x3c/p>\n<h2 id=\"Configuration\">Configuration\x3c/h2>\n<p>Default settings for all the upcoming connections can be configured on <a href=\"#Importing\" class=\"name\">library importing\x3c/a> or later with <a href=\"#Set%20Default%20Configuration\" class=\"name\">Set Default Configuration\x3c/a>.\x3c/p>\n<p>Using <a href=\"#Set%20Default%20Configuration\" class=\"name\">Set Default Configuration\x3c/a> does not affect the already open connections. Settings of the current connection can be configured with <a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a>. Settings of another, non-active connection, can be configured by first using <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a> and then <a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a>.\x3c/p>\n<p>Most of the defaults can be overridden per connection by defining them as arguments to <a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>. Otherwise the defaults are used.\x3c/p>\n<h3 id=\"Configurable per connection\">Configurable per connection\x3c/h3>\n<h4 id=\"Prompt\">Prompt\x3c/h4>\n<p>Argument <code>prompt\x3c/code> defines the character sequence used by <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> and must be set before that keyword can be used.\x3c/p>\n<p>If you know the prompt on the remote machine, it is recommended to set it to ease reading output from the server after using <a href=\"#Write\" class=\"name\">Write\x3c/a>. In addition to that, <a href=\"#Login\" class=\"name\">Login\x3c/a> and <a href=\"#Login%20With%20Public%20Key\" class=\"name\">Login With Public Key\x3c/a> can read the server output more efficiently when the prompt is set.\x3c/p>\n<p>Prompt can be specified either as a normal string or as a regular expression. The latter is especially useful if the prompt changes as a result of the executed commands. Prompt can be set to be a regular expression by giving the prompt argument a value starting with <code>REGEXP:\x3c/code> followed by the actual regular expression like <code>prompt=REGEXP:[$#]\x3c/code>. See the <a href=\"#Regular%20expressions\" class=\"name\">Regular expressions\x3c/a> section for more details about the syntax.\x3c/p>\n<p>The support for regular expressions is new in SSHLibrary 3.0.0.\x3c/p>\n<h4 id=\"Encoding\">Encoding\x3c/h4>\n<p>Argument <code>encoding\x3c/code> defines the <a href=\"https://docs.python.org/3/library/codecs.html#standard-encodings\">character encoding\x3c/a> of input and output sequences. The default encoding is UTF-8.\x3c/p>\n<h4 id=\"Path separator\">Path separator\x3c/h4>\n<p>Argument <code>path_separator\x3c/code> must be set to the one known by the operating system and the SSH server on the remote machine. The path separator is used by keywords <a href=\"#Get%20File\" class=\"name\">Get File\x3c/a>, <a href=\"#Put%20File\" class=\"name\">Put File\x3c/a>, <a href=\"#Get%20Directory\" class=\"name\">Get Directory\x3c/a> and <a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a> for joining paths correctly on the remote host.\x3c/p>\n<p>The default path separator is forward slash <code>/\x3c/code> which works on Unix-like machines. On Windows the path separator to use depends on the SSH server. Some servers use forward slash and others backslash, and users need to configure the <code>path_separator\x3c/code> accordingly. Notice that using a backslash in Robot Framework test data requires doubling it like <code>\\\\\x3c/code>.\x3c/p>\n<p>The path separator can be configured on <a href=\"#Importing\" class=\"name\">library importing\x3c/a> or later, using <a href=\"#Set%20Default%20Configuration\" class=\"name\">Set Default Configuration\x3c/a>, <a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a> and <a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>.\x3c/p>\n<h4 id=\"Timeout\">Timeout\x3c/h4>\n<p>Argument <code>timeout\x3c/code> is used by <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a> variants. The default value is <code>3 seconds\x3c/code>.\x3c/p>\n<p>Value must be in Robot Framework's time format such as <code>3\x3c/code>, <code>4.5s\x3c/code>, <code>1 minute\x3c/code> and <code>2 min 3 s\x3c/code>.  For more information about the time syntax see the <a href=\"http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#time-format\">Robot Framework User Guide\x3c/a>.\x3c/p>\n<h4 id=\"Newline\">Newline\x3c/h4>\n<p>Argument <code>newline\x3c/code> is the line break sequence used by <a href=\"#Write\" class=\"name\">Write\x3c/a> keyword and must be set according to the operating system on the remote machine. The default value is <code>LF\x3c/code> (same as <code>\\n\x3c/code>) which is used on Unix-like operating systems. With Windows remote machines, you need to set this to <code>CRLF\x3c/code> (<code>\\r\\n\x3c/code>).\x3c/p>\n<h4 id=\"Terminal settings\">Terminal settings\x3c/h4>\n<p>Argument <code>term_type\x3c/code> defines the virtual terminal type, and arguments <code>width\x3c/code> and <code>height\x3c/code> can be used to control its  virtual size.\x3c/p>\n<h3 id=\"Not configurable per connection\">Not configurable per connection\x3c/h3>\n<h4 id=\"Loglevel\">Loglevel\x3c/h4>\n<p>Argument <code>loglevel\x3c/code> sets the log level used to log the output read by <a href=\"#Read\" class=\"name\">Read\x3c/a>, <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>, <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a>, <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a>, <a href=\"#Write\" class=\"name\">Write\x3c/a>, <a href=\"#Write%20Until%20Expected%20Output\" class=\"name\">Write Until Expected Output\x3c/a>, <a href=\"#Login\" class=\"name\">Login\x3c/a> and <a href=\"#Login%20With%20Public%20Key\" class=\"name\">Login With Public Key\x3c/a>. The default level is <code>INFO\x3c/code>.\x3c/p>\n<p><code>loglevel\x3c/code> is not configurable per connection but can be overridden by passing it as an argument to the most of the aforementioned keywords. Possible argument values are <code>TRACE\x3c/code>, <code>DEBUG\x3c/code>, <code>INFO\x3c/code> and <code>WARN\x3c/code>.\x3c/p>\n<h2 id=\"Executing commands\">Executing commands\x3c/h2>\n<p>For executing commands on the remote machine, there are two possibilities:\x3c/p>\n<ul>\n<li><a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a> and <a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>. The command is executed in a new shell on the remote machine, which means that possible changes to the environment (e.g. changing working directory, setting environment variables, etc.) are not visible to the subsequent keywords.\x3c/li>\n\x3c/ul>\n<ul>\n<li><a href=\"#Write\" class=\"name\">Write\x3c/a>, <a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a>, <a href=\"#Write%20Until%20Expected%20Output\" class=\"name\">Write Until Expected Output\x3c/a>, <a href=\"#Read\" class=\"name\">Read\x3c/a>, <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>, <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> and <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a>. These keywords operate in an interactive shell, which means that changes to the environment are visible to the subsequent keywords.\x3c/li>\n\x3c/ul>\n<h2 id=\"Interactive shells\">Interactive shells\x3c/h2>\n<p><a href=\"#Write\" class=\"name\">Write\x3c/a>, <a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a>, <a href=\"#Write%20Until%20Expected%20Output\" class=\"name\">Write Until Expected Output\x3c/a>, <a href=\"#Read\" class=\"name\">Read\x3c/a>, <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>, <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> and <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a> can be used to interact with the server within the same shell.\x3c/p>\n<h3 id=\"Consumed output\">Consumed output\x3c/h3>\n<p>All of these keywords, except <a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a>, consume the read or the written text from the server output before returning. In practice this means that the text is removed from the server output, i.e. subsequent calls to <a href=\"#Read\" class=\"name\">Read\x3c/a> keywords do not return text that was already read. This is illustrated by the example below.\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>echo hello\x3c/td>\n<td>\x3c/td>\n<td># Consumes written <code>echo hello\x3c/code>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td><a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>\x3c/td>\n<td>hello\x3c/td>\n<td># Consumes read <code>hello\x3c/code> and everything before it\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${stdout}\x3c/td>\n<td>hello\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td><a href=\"#Read\" class=\"name\">Read\x3c/a>\x3c/td>\n<td>\x3c/td>\n<td># Consumes everything available\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Not Contain\x3c/span>\x3c/td>\n<td>${stdout}\x3c/td>\n<td>hello\x3c/td>\n<td># <code>hello\x3c/code> was already consumed earlier\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The consumed text is logged by the keywords and their argument <code>loglevel\x3c/code> can be used to override the default <a href=\"#Loglevel\" class=\"name\">log level\x3c/a>.\x3c/p>\n<p><a href=\"#Login\" class=\"name\">Login\x3c/a> and <a href=\"#Login%20With%20Public%20Key\" class=\"name\">Login With Public Key\x3c/a> consume everything on the server output or if the <a href=\"#Prompt\" class=\"name\">prompt\x3c/a> is set, everything until the prompt.\x3c/p>\n<h3 id=\"Reading\">Reading\x3c/h3>\n<p><a href=\"#Read\" class=\"name\">Read\x3c/a>, <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>, <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> and <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a> can be used to read from the server. The read text is also consumed from the server output.\x3c/p>\n<p><a href=\"#Read\" class=\"name\">Read\x3c/a> reads everything available on the server output, thus clearing it.\x3c/p>\n<p><a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a> variants read output up until and <b>including\x3c/b> <code>expected\x3c/code> text. These keywords will fail if the <a href=\"#Timeout\" class=\"name\">timeout\x3c/a> expires before <code>expected\x3c/code> is found.\x3c/p>\n<h3 id=\"Writing\">Writing\x3c/h3>\n<p><a href=\"#Write\" class=\"name\">Write\x3c/a> and <a href=\"#Write%20Until%20Expected%20Output\" class=\"name\">Write Until Expected Output\x3c/a> consume the written text from the server output while <a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a> does not.\x3c/p>\n<p>These keywords do not return any output triggered by the written text. To get the output, one of the <a href=\"#Read\" class=\"name\">Read\x3c/a> keywords must be explicitly used.\x3c/p>\n<h2 id=\"Pattern matching\">Pattern matching\x3c/h2>\n<h3 id=\"Glob patterns\">Glob patterns\x3c/h3>\n<p>Some keywords allow their arguments to be specified as <i>glob patterns\x3c/i> where:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>*\x3c/td>\n<td>matches anything, even an empty string\x3c/td>\n\x3c/tr>\n<tr>\n<td>?\x3c/td>\n<td>matches any single character\x3c/td>\n\x3c/tr>\n<tr>\n<td>[chars]\x3c/td>\n<td>matches any character inside square brackets (e.g. <code>[abc]\x3c/code> matches either <code>a\x3c/code>, <code>b\x3c/code> or <code>c\x3c/code>)\x3c/td>\n\x3c/tr>\n<tr>\n<td>[!chars]\x3c/td>\n<td>matches any character not inside square brackets\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Pattern matching is case-sensitive regardless the local or remote operating system. Matching is implemented using Python's <a href=\"https://docs.python.org/3/library/fnmatch.html\">fnmatch module\x3c/a>.\x3c/p>\n<h3 id=\"Regular expressions\">Regular expressions\x3c/h3>\n<p>Some keywords support pattern matching using regular expressions, which are more powerful but also more complicated than <a href=\"#Glob%20patterns\" class=\"name\">glob patterns\x3c/a>. This library uses Python's regular expressions, which are introduced in the <a href=\"https://docs.python.org/3/howto/regex.html\">Regular Expression HOWTO\x3c/a>.\x3c/p>\n<p>Remember that in Robot Framework data the backslash that is used a lot in regular expressions is an escape character and needs to be doubled to get a literal backslash. For example, <code>\\\\d\\\\d\\\\s\x3c/code> matches two digits followed by a whitespace character.\x3c/p>\n<p>Possible flags altering how the expression is parsed (e.g. <code>re.IGNORECASE\x3c/code>, <code>re.MULTILINE\x3c/code>) can be set by prefixing the pattern with the <code>(?iLmsux)\x3c/code> group. The available flags are <code>IGNORECASE\x3c/code>: <code>i\x3c/code>, <code>MULTILINE\x3c/code>: <code>m\x3c/code>, <code>DOTALL\x3c/code>: <code>s\x3c/code>, <code>VERBOSE\x3c/code>: <code>x\x3c/code>, <code>UNICODE\x3c/code>: <code>u\x3c/code>, and <code>LOCALE\x3c/code>: <code>L\x3c/code>. For example, <code>(?is)pat.ern\x3c/code> uses <code>IGNORECASE\x3c/code> and <code>DOTALL\x3c/code> flags.\x3c/p>\n<h2 id=\"Example\">Example\x3c/h2>\n<pre>\n<b>***\x3c/b> Settings <b>***\x3c/b>\nDocumentation          This example demonstrates executing commands on a remote machine\n...                    and getting their output and the return code.\n...\n...                    Notice how connections are handled as part of the suite setup and\n...                    teardown. This saves some time when executing several test cases.\n\nLibrary                <span class=\"name\">SSHLibrary\x3c/span>\nSuite Setup            <span class=\"name\">Open Connection And Log In\x3c/span>\nSuite Teardown         <a href=\"#Close%20All%20Connections\" class=\"name\">Close All Connections\x3c/a>\n\n<b>***\x3c/b> Variables <b>***\x3c/b>\n${HOST}                localhost\n${USERNAME}            test\n${PASSWORD}            test\n\n<b>***\x3c/b> Test Cases <b>***\x3c/b>\nExecute Command And Verify Output\n    [Documentation]    Execute Command can be used to ran commands on the remote machine.\n    ...                The keyword returns the standard output by default.\n    ${output}=         <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>  echo Hello SSHLibrary!\n    <span class=\"name\">Should Be Equal\x3c/span>    ${output}        Hello SSHLibrary!\n\nExecute Command And Verify Return Code\n    [Documentation]    Often getting the return code of the command is enough.\n    ...                This behaviour can be adjusted as Execute Command arguments.\n    ${rc}=             <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>  echo Success guaranteed.    return_stdout=False    return_rc=True\n    <span class=\"name\">Should Be Equal\x3c/span>    ${rc}            ${0}\n\nExecuting Commands In An Interactive Session\n    [Documentation]    Execute Command always executes the command in a new shell.\n    ...                This means that changes to the environment are not persisted\n    ...                between subsequent Execute Command keyword calls.\n    ...                Write and Read Until variants can be used to operate in the same shell.\n    <a href=\"#Write\" class=\"name\">Write\x3c/a>              cd ..\n    <a href=\"#Write\" class=\"name\">Write\x3c/a>              echo Hello from the parent directory!\n    ${output}=         <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>       directory!\n    <span class=\"name\">Should End With\x3c/span>    ${output}        Hello from the parent directory!\n\n<b>***\x3c/b> Keywords <b>***\x3c/b>\nOpen Connection And Log In\n   <a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>     ${HOST}\n   <a href=\"#Login\" class=\"name\">Login\x3c/a>               ${USERNAME}        ${PASSWORD}\n\x3c/pre>\n<p>Save the content as file <code>executing_command.txt\x3c/code> and run:\x3c/p>\n<p><code>robot executing_commands.txt\x3c/code>\x3c/p>\n<p>You may want to override the variables from commandline to try this out on your remote machine:\x3c/p>\n<p><code>robot -v HOST:my.server.com -v USERNAME:johndoe -v PASSWORD:secretpasswd executing_commands.txt\x3c/code>\x3c/p>","generated":"2018-04-27 11:46:50","inits":[{"args":["timeout=3 seconds","newline=LF","prompt=None","loglevel=INFO","term_type=vt100","width=80","height=24","path_separator=/","encoding=UTF-8"],"doc":"<p>SSHLibrary allows some import time <a href=\"#Configuration\" class=\"name\">configuration\x3c/a>.\x3c/p>\n<p>If the library is imported without any arguments, the library defaults are used:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Library\x3c/td>\n<td>SSHLibrary\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Only arguments that are given are changed. In this example the <a href=\"#Timeout\" class=\"name\">timeout\x3c/a> is changed to <code>10 seconds\x3c/code> but  other settings are left to the library defaults:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Library\x3c/td>\n<td>SSHLibrary\x3c/td>\n<td>10 seconds\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The <a href=\"#Prompt\" class=\"name\">prompt\x3c/a> does not have a default value and must be explicitly set to be able to use <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a>. Since SSHLibrary 3.0.0, the prompt can also be a regular expression:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Library\x3c/td>\n<td>SSHLibrary\x3c/td>\n<td>prompt=REGEXP:[$#]\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Multiple settings are also possible. In the example below, the library is brought into use with <a href=\"#Newline\" class=\"name\">newline\x3c/a> and <a href=\"#Path%20separator\" class=\"name\">path separator\x3c/a> known by Windows:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Library\x3c/td>\n<td>SSHLibrary\x3c/td>\n<td>newline=CRLF\x3c/td>\n<td>path_separator=\\\\\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Init","shortdoc":"SSHLibrary allows some import time `configuration`.","tags":[]}],"keywords":[{"args":[],"doc":"<p>Closes all open connections.\x3c/p>\n<p>This keyword is ought to be used either in test or suite teardown to make sure all the connections are closed before the test execution finishes.\x3c/p>\n<p>After this keyword, the connection indices returned by <a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a> are reset and start from <code>1\x3c/code>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>build.local.net\x3c/td>\n\x3c/tr>\n<tr>\n<td># Do something with the connections\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>[Teardown]\x3c/td>\n<td><a href=\"#Close%20All%20Connections\" class=\"name\">Close all connections\x3c/a>\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Close All Connections","shortdoc":"Closes all open connections.","tags":[]},{"args":[],"doc":"<p>Closes the current connection.\x3c/p>\n<p>No other connection is made active by this keyword. Manually use <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a> to switch to another connection.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Login\" class=\"name\">Login\x3c/a>\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Get%20File\" class=\"name\">Get File\x3c/a>\x3c/td>\n<td>results.txt\x3c/td>\n<td>/tmp\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Close%20Connection\" class=\"name\">Close Connection\x3c/a>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td># Do something with /tmp/results.txt\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Close Connection","shortdoc":"Closes the current connection.","tags":[]},{"args":["path"],"doc":"<p>Fails if the given <code>path\x3c/code> does not point to an existing directory.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Directory%20Should%20Exist\" class=\"name\">Directory Should Exist\x3c/a>\x3c/td>\n<td>/usr/share/man\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Note that symlinks are followed:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Directory%20Should%20Exist\" class=\"name\">Directory Should Exist\x3c/a>\x3c/td>\n<td>/usr/local/man\x3c/td>\n<td># Points to /usr/share/man/\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Directory Should Exist","shortdoc":"Fails if the given ``path`` does not point to an existing directory.","tags":[]},{"args":["path"],"doc":"<p>Fails if the given <code>path\x3c/code> points to an existing directory.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Directory%20Should%20Not%20Exist\" class=\"name\">Directory Should Not Exist\x3c/a>\x3c/td>\n<td>/non/existing\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Note that this keyword follows symlinks. Thus the example fails if <code>/non/existing\x3c/code> is a link that points to an existing directory.\x3c/p>","matched":true,"name":"Directory Should Not Exist","shortdoc":"Fails if the given ``path`` points to an existing directory.","tags":[]},{"args":["logfile"],"doc":"<p>Enables logging of SSH protocol output to given <code>logfile\x3c/code>.\x3c/p>\n<p>All the existing and upcoming connections are logged onwards from the moment the keyword was called.\x3c/p>\n<p><code>logfile\x3c/code> is path to a file that is writable by the current local user. If the file already exists, it will be overwritten.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td># Not logged\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Enable%20Ssh%20Logging\" class=\"name\">Enable SSH Logging\x3c/a>\x3c/td>\n<td>myserver.log\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Login\" class=\"name\">Login\x3c/a>\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>build.local.net\x3c/td>\n<td># Logged\x3c/td>\n\x3c/tr>\n<tr>\n<td># Do something with the connections\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td># Check myserver.log for detailed debug information\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p><b>Note:\x3c/b> This keyword does not work when using Jython.\x3c/p>","matched":true,"name":"Enable Ssh Logging","shortdoc":"Enables logging of SSH protocol output to given ``logfile``.","tags":[]},{"args":["command","return_stdout=True","return_stderr=False","return_rc=False","sudo=False","sudo_password=None"],"doc":"<p>Executes <code>command\x3c/code> on the remote machine and returns its outputs.\x3c/p>\n<p>This keyword executes the <code>command\x3c/code> and returns after the execution has been finished. Use <a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a> if the command should be started in the background.\x3c/p>\n<p>By default, only the standard output is returned:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${stdout}=\x3c/td>\n<td><a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${stdout}\x3c/td>\n<td>Hello John!\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <code>return_stdout\x3c/code>, <code>return_stderr\x3c/code> and <code>return_rc\x3c/code> are used to specify, what is returned by this keyword. If several arguments evaluate to true, multiple values are returned. Non-empty strings, except <code>false\x3c/code> and <code>False\x3c/code>, evaluate to true.\x3c/p>\n<p>If errors are needed as well, set the respective argument value to true:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${stdout}\x3c/td>\n<td>${stderr}=\x3c/td>\n<td><a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>return_stderr=True\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Empty\x3c/span>\x3c/td>\n<td>${stderr}\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Often checking the return code is enough:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${rc}=\x3c/td>\n<td><a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>return_stdout=False\x3c/td>\n<td>return_rc=True\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal As Integers\x3c/span>\x3c/td>\n<td>${rc}\x3c/td>\n<td>0\x3c/td>\n<td># succeeded\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <code>sudo\x3c/code> and <code>sudo_password\x3c/code> are used for executing commands within a sudo session. Due to different permission elevation in Cygwin, these two arguments will not work when using it.\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>\x3c/td>\n<td>pwd\x3c/td>\n<td>sudo=True\x3c/td>\n<td>sudo_password=test\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The <code>command\x3c/code> is always executed in a new shell. Thus possible changes to the environment (e.g. changing working directory) are not visible to the later keywords:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${pwd}=\x3c/td>\n<td><a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>\x3c/td>\n<td>pwd\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${pwd}\x3c/td>\n<td>/home/johndoe\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>\x3c/td>\n<td>cd /tmp\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${pwd}=\x3c/td>\n<td><a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>\x3c/td>\n<td>pwd\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${pwd}\x3c/td>\n<td>/home/johndoe\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p><a href=\"#Write\" class=\"name\">Write\x3c/a> and <a href=\"#Read\" class=\"name\">Read\x3c/a> can be used for running multiple commands in the same shell. See <a href=\"#Interactive%20shells\" class=\"name\">interactive shells\x3c/a> section for more information.\x3c/p>\n<p>This keyword logs the executed command and its exit status with log level <code>INFO\x3c/code>.\x3c/p>\n<p><code>sudo\x3c/code> and <code>sudo_password\x3c/code> arguments are new in SSHLibrary 3.0.0.\x3c/p>","matched":true,"name":"Execute Command","shortdoc":"Executes ``command`` on the remote machine and returns its outputs.","tags":[]},{"args":["path"],"doc":"<p>Fails if the given <code>path\x3c/code> does NOT point to an existing file.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#File%20Should%20Exist\" class=\"name\">File Should Exist\x3c/a>\x3c/td>\n<td>/boot/initrd.img\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Note that symlinks are followed:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#File%20Should%20Exist\" class=\"name\">File Should Exist\x3c/a>\x3c/td>\n<td>/initrd.img\x3c/td>\n<td># Points to /boot/initrd.img\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"File Should Exist","shortdoc":"Fails if the given ``path`` does NOT point to an existing file.","tags":[]},{"args":["path"],"doc":"<p>Fails if the given <code>path\x3c/code> points to an existing file.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#File%20Should%20Not%20Exist\" class=\"name\">File Should Not Exist\x3c/a>\x3c/td>\n<td>/non/existing\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Note that this keyword follows symlinks. Thus the example fails if <code>/non/existing\x3c/code> is a link that points an existing file.\x3c/p>","matched":true,"name":"File Should Not Exist","shortdoc":"Fails if the given ``path`` points to an existing file.","tags":[]},{"args":["index_or_alias=None","index=False","host=False","alias=False","port=False","timeout=False","newline=False","prompt=False","term_type=False","width=False","height=False","encoding=False"],"doc":"<p>Returns information about the connection.\x3c/p>\n<p>Connection is not changed by this keyword, use <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a> to change the active connection.\x3c/p>\n<p>If <code>index_or_alias\x3c/code> is not given, the information of the current connection is returned.\x3c/p>\n<p>This keyword returns an object that has the following attributes:\x3c/p>\n<table border=\"1\">\n<tr>\n<th>Name\x3c/th>\n<th>Type\x3c/th>\n<th>Explanation\x3c/th>\n\x3c/tr>\n<tr>\n<td>index\x3c/td>\n<td>integer\x3c/td>\n<td>Number of the connection. Numbering starts from <code>1\x3c/code>.\x3c/td>\n\x3c/tr>\n<tr>\n<td>host\x3c/td>\n<td>string\x3c/td>\n<td>Destination hostname.\x3c/td>\n\x3c/tr>\n<tr>\n<td>alias\x3c/td>\n<td>string\x3c/td>\n<td>An optional alias given when creating the connection.\x3c/td>\n\x3c/tr>\n<tr>\n<td>port\x3c/td>\n<td>integer\x3c/td>\n<td>Destination port.\x3c/td>\n\x3c/tr>\n<tr>\n<td>timeout\x3c/td>\n<td>string\x3c/td>\n<td><a href=\"#Timeout\" class=\"name\">Timeout\x3c/a> length in textual representation.\x3c/td>\n\x3c/tr>\n<tr>\n<td>newline\x3c/td>\n<td>string\x3c/td>\n<td>The line break sequence used by <a href=\"#Write\" class=\"name\">Write\x3c/a> keyword. See <a href=\"#Newline\" class=\"name\">newline\x3c/a>.\x3c/td>\n\x3c/tr>\n<tr>\n<td>prompt\x3c/td>\n<td>string\x3c/td>\n<td><a href=\"#Prompt\" class=\"name\">Prompt\x3c/a> character sequence for <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a>.\x3c/td>\n\x3c/tr>\n<tr>\n<td>term_type\x3c/td>\n<td>string\x3c/td>\n<td>Type of the virtual terminal. See <a href=\"#Terminal%20settings\" class=\"name\">terminal settings\x3c/a>.\x3c/td>\n\x3c/tr>\n<tr>\n<td>width\x3c/td>\n<td>integer\x3c/td>\n<td>Width of the virtual terminal. See <a href=\"#Terminal%20settings\" class=\"name\">terminal settings\x3c/a>.\x3c/td>\n\x3c/tr>\n<tr>\n<td>height\x3c/td>\n<td>integer\x3c/td>\n<td>Height of the virtual terminal. See <a href=\"#Terminal%20settings\" class=\"name\">terminal settings\x3c/a>.\x3c/td>\n\x3c/tr>\n<tr>\n<td>path_separator\x3c/td>\n<td>string\x3c/td>\n<td>The <a href=\"#Path%20separator\" class=\"name\">path separator\x3c/a> used on the remote host.\x3c/td>\n\x3c/tr>\n<tr>\n<td>encoding\x3c/td>\n<td>string\x3c/td>\n<td>The <a href=\"#Encoding\" class=\"name\">encoding\x3c/a> used for inputs and outputs.\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>If there is no connection, an object having <code>index\x3c/code> and <code>host\x3c/code> as <code>None\x3c/code> is returned, rest of its attributes having their values as configuration defaults.\x3c/p>\n<p>If you want the information for all the open connections, use <a href=\"#Get%20Connections\" class=\"name\">Get Connections\x3c/a>.\x3c/p>\n<p>Getting connection information of the current connection:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>far.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>near.server.com\x3c/td>\n<td>prompt=&gt;&gt;\x3c/td>\n<td># Current connection\x3c/td>\n\x3c/tr>\n<tr>\n<td>${nearhost}=\x3c/td>\n<td><a href=\"#Get%20Connection\" class=\"name\">Get Connection\x3c/a>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${nearhost.host}\x3c/td>\n<td>near.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${nearhost.index}\x3c/td>\n<td>2\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${nearhost.prompt}\x3c/td>\n<td>&gt;&gt;\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${nearhost.term_type}\x3c/td>\n<td>vt100\x3c/td>\n<td># From defaults\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Getting connection information using an index:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>far.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>near.server.com\x3c/td>\n<td># Current connection\x3c/td>\n\x3c/tr>\n<tr>\n<td>${farhost}=\x3c/td>\n<td><a href=\"#Get%20Connection\" class=\"name\">Get Connection\x3c/a>\x3c/td>\n<td>1\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${farhost.host}\x3c/td>\n<td>far.server.com\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Getting connection information using an alias:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>far.server.com\x3c/td>\n<td>alias=far\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>near.server.com\x3c/td>\n<td># Current connection\x3c/td>\n\x3c/tr>\n<tr>\n<td>${farhost}=\x3c/td>\n<td><a href=\"#Get%20Connection\" class=\"name\">Get Connection\x3c/a>\x3c/td>\n<td>far\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${farhost.host}\x3c/td>\n<td>far.server.com\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${farhost.alias}\x3c/td>\n<td>far\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>This keyword can also return plain connection attributes instead of the whole connection object. This can be adjusted using the boolean arguments <code>index\x3c/code>, <code>host\x3c/code>, <code>alias\x3c/code>, and so on, that correspond to the attribute names of the object. If such arguments are given, and they evaluate to true (e.g. any non-empty string except <code>false\x3c/code> or <code>False\x3c/code>), only the respective connection attributes are returned. Note that attributes are always returned in the same order arguments are specified in the signature.\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td>alias=example\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${host}=\x3c/td>\n<td><a href=\"#Get%20Connection\" class=\"name\">Get Connection\x3c/a>\x3c/td>\n<td>host=True\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${host}\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${host}\x3c/td>\n<td>${alias}=\x3c/td>\n<td><a href=\"#Get%20Connection\" class=\"name\">Get Connection\x3c/a>\x3c/td>\n<td>host=yes\x3c/td>\n<td>alias=please\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${host}\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${alias}\x3c/td>\n<td>example\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Getting only certain attributes is especially useful when using this library via the Remote library interface. This interface does not support returning custom objects, but individual attributes can be returned just fine.\x3c/p>\n<p>This keyword logs the connection information with log level <code>INFO\x3c/code>.\x3c/p>","matched":true,"name":"Get Connection","shortdoc":"Returns information about the connection.","tags":[]},{"args":[],"doc":"<p>Returns information about all the open connections.\x3c/p>\n<p>This keyword returns a list of objects that are identical to the ones returned by <a href=\"#Get%20Connection\" class=\"name\">Get Connection\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>near.server.com\x3c/td>\n<td>timeout=10s\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>far.server.com\x3c/td>\n<td>timeout=5s\x3c/td>\n\x3c/tr>\n<tr>\n<td>${nearhost}\x3c/td>\n<td>${farhost}=\x3c/td>\n<td><a href=\"#Get%20Connections\" class=\"name\">Get Connections\x3c/a>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${nearhost.host}\x3c/td>\n<td>near.server.com\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal As Integers\x3c/span>\x3c/td>\n<td>${nearhost.timeout}\x3c/td>\n<td>10\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal As Integers\x3c/span>\x3c/td>\n<td>${farhost.port}\x3c/td>\n<td>22\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal As Integers\x3c/span>\x3c/td>\n<td>${farhost.timeout}\x3c/td>\n<td>5\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>This keyword logs the information of connections with log level <code>INFO\x3c/code>.\x3c/p>","matched":true,"name":"Get Connections","shortdoc":"Returns information about all the open connections.","tags":[]},{"args":["source","destination=.","recursive=False"],"doc":"<p>Downloads a directory, including its content, from the remote machine to the local machine.\x3c/p>\n<p><code>source\x3c/code> is a path on the remote machine. Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p><code>destination\x3c/code> is the target path on the local machine.  Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p><code>recursive\x3c/code> specifies whether to recursively download all subdirectories inside <code>source\x3c/code>. Subdirectories are downloaded if the argument value evaluates to true.\x3c/p>\n<p>Examples:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Get%20Directory\" class=\"name\">Get Directory\x3c/a>\x3c/td>\n<td>/var/logs\x3c/td>\n<td>/tmp\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Get%20Directory\" class=\"name\">Get Directory\x3c/a>\x3c/td>\n<td>/var/logs\x3c/td>\n<td>/tmp/non/existing\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Get%20Directory\" class=\"name\">Get Directory\x3c/a>\x3c/td>\n<td>/var/logs\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Get%20Directory\" class=\"name\">Get Directory\x3c/a>\x3c/td>\n<td>/var/logs\x3c/td>\n<td>recursive=True\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The local <code>destination\x3c/code> is created as following:\x3c/p>\n<p>1. If <code>destination\x3c/code> is an existing path on the local machine, <code>source\x3c/code> directory is downloaded into it.\x3c/p>\n<p>2. If <code>destination\x3c/code> does not exist on the local machine, it is created and the content of <code>source\x3c/code> directory is downloaded into it.\x3c/p>\n<p>3. If <code>destination\x3c/code> is not given, <code>source\x3c/code> directory is downloaded into the current working directory on the local &lt;machine. This is typically the directory where the test execution was started and thus accessible using the built-in <code>${EXECDIR}\x3c/code> variable.\x3c/p>\n<p>See also <a href=\"#Get%20File\" class=\"name\">Get File\x3c/a>.\x3c/p>","matched":true,"name":"Get Directory","shortdoc":"Downloads a directory, including its content, from the remote machine to the local machine.","tags":[]},{"args":["source","destination=."],"doc":"<p>Downloads file(s) from the remote machine to the local machine.\x3c/p>\n<p><code>source\x3c/code> is a path on the remote machine. Both absolute paths and paths relative to the current working directory are supported. If the source contains wildcards explained in <a href=\"#Glob%20patterns\" class=\"name\">glob patterns\x3c/a>, all files matching it are downloaded. In this case <code>destination\x3c/code> must always be a directory.\x3c/p>\n<p><code>destination\x3c/code> is the target path on the local machine. Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p>Examples:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Get%20File\" class=\"name\">Get File\x3c/a>\x3c/td>\n<td>/var/log/auth.log\x3c/td>\n<td>/tmp/\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Get%20File\" class=\"name\">Get File\x3c/a>\x3c/td>\n<td>/tmp/example.txt\x3c/td>\n<td>C:\\\\temp\\\\new_name.txt\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Get%20File\" class=\"name\">Get File\x3c/a>\x3c/td>\n<td>/path/to/*.txt\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The local <code>destination\x3c/code> is created using the rules explained below:\x3c/p>\n<p>1. If the <code>destination\x3c/code> is an existing file, the <code>source\x3c/code> file is downloaded over it.\x3c/p>\n<p>2. If the <code>destination\x3c/code> is an existing directory, the <code>source\x3c/code> file is downloaded into it. Possible file with the same name is overwritten.\x3c/p>\n<p>3. If the <code>destination\x3c/code> does not exist and it ends with the path separator of the local operating system, it is considered a directory. The directory is then created and the <code>source\x3c/code> file is downloaded into it. Possible missing intermediate directories are also created.\x3c/p>\n<p>4. If the <code>destination\x3c/code> does not exist and does not end with the local path separator, it is considered a file. The <code>source\x3c/code> file is downloaded and saved using that file name, and possible missing intermediate directories are also created.\x3c/p>\n<p>5. If <code>destination\x3c/code> is not given, the current working directory on the local machine is used as the destination. This is typically the directory where the test execution was started and thus accessible using built-in <code>${EXECDIR}\x3c/code> variable.\x3c/p>\n<p>See also <a href=\"#Get%20Directory\" class=\"name\">Get Directory\x3c/a>.\x3c/p>","matched":true,"name":"Get File","shortdoc":"Downloads file(s) from the remote machine to the local machine.","tags":[]},{"args":["host=None","port=22"],"doc":"<p>Returns the banner supplied by the server upon connect.\x3c/p>\n<p>There are 2 ways of getting banner information.\x3c/p>\n<p>1. Independent of any connection:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${banner} =\x3c/td>\n<td><a href=\"#Get%20Pre%20Login%20Banner\" class=\"name\">Get Pre Login Banner\x3c/a>\x3c/td>\n<td>${HOST}\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${banner}\x3c/td>\n<td>Testing pre-login banner\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The argument <code>host\x3c/code> is mandatory for getting banner key without an open connection.\x3c/p>\n<p>2. From the current connection:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>${HOST}\x3c/td>\n<td>prompt=${PROMPT}\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Login\" class=\"name\">Login\x3c/a>\x3c/td>\n<td>${USERNAME}\x3c/td>\n<td>${PASSWORD}\x3c/td>\n\x3c/tr>\n<tr>\n<td>${banner} =\x3c/td>\n<td><a href=\"#Get%20Pre%20Login%20Banner\" class=\"name\">Get Pre Login Banner\x3c/a>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${banner}\x3c/td>\n<td>Testing pre-login banner\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>New in SSHLibrary 3.0.0.\x3c/p>\n<p><b>Note:\x3c/b> This keyword does not work when using Jython.\x3c/p>","matched":true,"name":"Get Pre Login Banner","shortdoc":"Returns the banner supplied by the server upon connect.","tags":[]},{"args":["path","pattern=None","absolute=False"],"doc":"<p>A wrapper for <a href=\"#List%20Directory\" class=\"name\">List Directory\x3c/a> that returns only directories.\x3c/p>","matched":true,"name":"List Directories In Directory","shortdoc":"A wrapper for `List Directory` that returns only directories.","tags":[]},{"args":["path","pattern=None","absolute=False"],"doc":"<p>Returns and logs items in the remote <code>path\x3c/code>, optionally filtered with <code>pattern\x3c/code>.\x3c/p>\n<p><code>path\x3c/code> is a path on the remote machine. Both absolute paths and paths relative to the current working directory are supported. If <code>path\x3c/code> is a symlink, it is followed.\x3c/p>\n<p>Item names are returned in case-sensitive alphabetical order, e.g. <code>['A Name', 'Second', 'a lower case name', 'one more']\x3c/code>. Implicit directories <code>.\x3c/code> and <code>..\x3c/code> are not returned. The returned items are automatically logged.\x3c/p>\n<p>By default, the item names are returned relative to the given remote path (e.g. <code>file.txt\x3c/code>). If you want them be returned in the absolute format (e.g. <code>/home/johndoe/file.txt\x3c/code>), set the <code>absolute\x3c/code> argument to any non-empty string.\x3c/p>\n<p>If <code>pattern\x3c/code> is given, only items matching it are returned. The pattern is a glob pattern and its syntax is explained in the <a href=\"#Pattern%20matching\" class=\"name\">Pattern matching\x3c/a> section.\x3c/p>\n<p>Examples (using also other <a href=\"#List%20Directory\" class=\"name\">List Directory\x3c/a> variants):\x3c/p>\n<table border=\"1\">\n<tr>\n<td>@{items}=\x3c/td>\n<td><a href=\"#List%20Directory\" class=\"name\">List Directory\x3c/a>\x3c/td>\n<td>/home/johndoe\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>@{files}=\x3c/td>\n<td><a href=\"#List%20Files%20In%20Directory\" class=\"name\">List Files In Directory\x3c/a>\x3c/td>\n<td>/tmp\x3c/td>\n<td>*.txt\x3c/td>\n<td>absolute=True\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>If you are only interested in directories or files, use <a href=\"#List%20Files%20In%20Directory\" class=\"name\">List Files In Directory\x3c/a> or <a href=\"#List%20Directories%20In%20Directory\" class=\"name\">List Directories In Directory\x3c/a>, respectively.\x3c/p>","matched":true,"name":"List Directory","shortdoc":"Returns and logs items in the remote ``path``, optionally filtered with ``pattern``.","tags":[]},{"args":["path","pattern=None","absolute=False"],"doc":"<p>A wrapper for <a href=\"#List%20Directory\" class=\"name\">List Directory\x3c/a> that returns only files.\x3c/p>","matched":true,"name":"List Files In Directory","shortdoc":"A wrapper for `List Directory` that returns only files.","tags":[]},{"args":["username","password","delay=0.5 seconds"],"doc":"<p>Logs into the SSH server with the given <code>username\x3c/code> and <code>password\x3c/code>.\x3c/p>\n<p>Connection must be opened before using this keyword.\x3c/p>\n<p>This keyword reads, returns and logs the server output after logging in. If the <a href=\"#Prompt\" class=\"name\">prompt\x3c/a> is set, everything until the prompt is read. Otherwise the output is read using the <a href=\"#Read\" class=\"name\">Read\x3c/a> keyword with the given <code>delay\x3c/code>. The output is logged using the default <a href=\"#Loglevel\" class=\"name\">log level\x3c/a>.\x3c/p>\n<p>Example that logs in and returns the output:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>linux.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Login\" class=\"name\">Login\x3c/a>\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>Last login at\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Example that logs in and returns everything until the prompt:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>linux.server.com\x3c/td>\n<td>prompt=$\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Login\" class=\"name\">Login\x3c/a>\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>johndoe@linux:~$\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Login","shortdoc":"Logs into the SSH server with the given ``username`` and ``password``.","tags":[]},{"args":["username","keyfile","password=","allow_agent=False","look_for_keys=False","delay=0.5 seconds"],"doc":"<p>Logs into the SSH server using key-based authentication.\x3c/p>\n<p>Connection must be opened before using this keyword.\x3c/p>\n<p><code>username\x3c/code> is the username on the remote machine.\x3c/p>\n<p><code>keyfile\x3c/code> is a path to a valid OpenSSH private key file on the local filesystem.\x3c/p>\n<p><code>password\x3c/code> is used to unlock the <code>keyfile\x3c/code> if needed.\x3c/p>\n<p>This keyword reads, returns and logs the server output after logging in. If the <a href=\"#Prompt\" class=\"name\">prompt\x3c/a> is set, everything until the prompt is read. Otherwise the output is read using the <a href=\"#Read\" class=\"name\">Read\x3c/a> keyword with the given <code>delay\x3c/code>. The output is logged using the default <a href=\"#Loglevel\" class=\"name\">log level\x3c/a>.\x3c/p>\n<p>Example that logs in using a private key and returns the output:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>linux.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Login%20With%20Public%20Key\" class=\"name\">Login With Public Key\x3c/a>\x3c/td>\n<td>johndoe\x3c/td>\n<td>/home/johndoe/.ssh/id_rsa\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${motd}\x3c/td>\n<td>Last login at\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>With locked private keys, the keyring <code>password\x3c/code> is required:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>linux.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Login%20With%20Public%20Key\" class=\"name\">Login With Public Key\x3c/a>\x3c/td>\n<td>johndoe\x3c/td>\n<td>/home/johndoe/.ssh/id_dsa\x3c/td>\n<td>keyringpasswd\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p><code>allow_agent\x3c/code> enables the connection to the SSH agent. <code>look_for_keys\x3c/code> enables the searching for discoverable private key files in <code>~/.ssh/\x3c/code>.\x3c/p>\n<p><code>allow_agent\x3c/code> and <code>look_for_keys\x3c/code> arguments are new in SSHLibrary 3.0.0.\x3c/p>\n<p><b>Note:\x3c/b> <code>allow_agent\x3c/code> and <code>look_for_keys\x3c/code> do not work when using Jython.\x3c/p>","matched":true,"name":"Login With Public Key","shortdoc":"Logs into the SSH server using key-based authentication.","tags":[]},{"args":["host","alias=None","port=22","timeout=None","newline=None","prompt=None","term_type=None","width=None","height=None","path_separator=None","encoding=None"],"doc":"<p>Opens a new SSH connection to the given <code>host\x3c/code> and <code>port\x3c/code>.\x3c/p>\n<p>The new connection is made active. Possible existing connections are left open in the background.\x3c/p>\n<p>Note that on Jython this keyword actually opens a connection and will fail immediately on unreachable hosts. On Python the actual connection attempt will not be done until <a href=\"#Login\" class=\"name\">Login\x3c/a> is called.\x3c/p>\n<p>This keyword returns the index of the new connection which can be used later to switch back to it. Indices start from <code>1\x3c/code> and are reset when <a href=\"#Close%20All%20Connections\" class=\"name\">Close All Connections\x3c/a> is used.\x3c/p>\n<p>Optional <code>alias\x3c/code> can be given for the connection and can be used for switching between connections, similarly as the index. See <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a> for more details.\x3c/p>\n<p>Connection parameters, like <a href=\"#Timeout\" class=\"name\">timeout\x3c/a> and <a href=\"#Newline\" class=\"name\">newline\x3c/a> are documented in <a href=\"#Configuration\" class=\"name\">configuration\x3c/a>. If they are not defined as arguments, the library defaults are used for the connection.\x3c/p>\n<p>All the arguments, except <code>host\x3c/code>, <code>alias\x3c/code> and <code>port\x3c/code> can be later updated with <a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a>.\x3c/p>\n<p>Port <code>22\x3c/code> is assumed by default:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${index}=\x3c/td>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Non-standard port may be given as an argument:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${index}=\x3c/td>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>192.168.1.1\x3c/td>\n<td>port=23\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Aliases are handy, if you need to switch back to the connection later:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td>alias=myserver\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td># Do something with my.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>192.168.1.1\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a>\x3c/td>\n<td>myserver\x3c/td>\n<td>\x3c/td>\n<td># Back to my.server.com\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Settings can be overridden per connection, otherwise the ones set on <a href=\"#Importing\" class=\"name\">library importing\x3c/a> or with <a href=\"#Set%20Default%20Configuration\" class=\"name\">Set Default Configuration\x3c/a> are used:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Open Connection\x3c/td>\n<td>192.168.1.1\x3c/td>\n<td>timeout=1 hour\x3c/td>\n<td>newline=CRLF\x3c/td>\n\x3c/tr>\n<tr>\n<td># Do something with the connection\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td># Default timeout\x3c/td>\n<td># Default line breaks\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The <a href=\"#Terminal%20settings\" class=\"name\">terminal settings\x3c/a> are also configurable per connection:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>192.168.1.1\x3c/td>\n<td>term_type=ansi\x3c/td>\n<td>width=40\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Open Connection","shortdoc":"Opens a new SSH connection to the given ``host`` and ``port``.","tags":[]},{"args":["source","destination=.","mode=0744","newline=","recursive=False"],"doc":"<p>Uploads a directory, including its content, from the local machine to the remote machine.\x3c/p>\n<p><code>source\x3c/code> is the path on the local machine. Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p><code>destination\x3c/code> is the target path on the remote machine. Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p><code>mode\x3c/code> can be used to set the target file permission. Numeric values are accepted. The default value is <code>0744\x3c/code> (<code>-rwxr--r--\x3c/code>).\x3c/p>\n<p><code>newline\x3c/code> can be used to force the line break characters that are written to the remote files. Valid values are <code>LF\x3c/code> and <code>CRLF\x3c/code>.\x3c/p>\n<p><code>recursive\x3c/code> specifies whether to recursively upload all subdirectories inside <code>source\x3c/code>. Subdirectories are uploaded if the argument value evaluates to true.\x3c/p>\n<p>Examples:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a>\x3c/td>\n<td>/var/logs\x3c/td>\n<td>/tmp\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a>\x3c/td>\n<td>/var/logs\x3c/td>\n<td>/tmp/non/existing\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a>\x3c/td>\n<td>/var/logs\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a>\x3c/td>\n<td>/var/logs\x3c/td>\n<td>recursive=True\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a>\x3c/td>\n<td>/var/logs\x3c/td>\n<td>/home/groups/robot\x3c/td>\n<td>mode=0770\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a>\x3c/td>\n<td>/var/logs\x3c/td>\n<td>newline=CRLF\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The remote <code>destination\x3c/code> is created as following:\x3c/p>\n<p>1. If <code>destination\x3c/code> is an existing path on the remote machine, <code>source\x3c/code> directory is uploaded into it.\x3c/p>\n<p>2. If <code>destination\x3c/code> does not exist on the remote machine, it is created and the content of <code>source\x3c/code> directory is uploaded into it.\x3c/p>\n<p>3. If <code>destination\x3c/code> is not given, <code>source\x3c/code> directory is typically uploaded to user's home directory on the remote machine.\x3c/p>\n<p>See also <a href=\"#Put%20File\" class=\"name\">Put File\x3c/a>.\x3c/p>","matched":true,"name":"Put Directory","shortdoc":"Uploads a directory, including its content, from the local machine to the remote machine.","tags":[]},{"args":["source","destination=.","mode=0744","newline="],"doc":"<p>Uploads file(s) from the local machine to the remote machine.\x3c/p>\n<p><code>source\x3c/code> is the path on the local machine. Both absolute paths and paths relative to the current working directory are supported. If the source contains wildcards explained in <a href=\"#Glob%20patterns\" class=\"name\">glob patterns\x3c/a>, all files matching it are uploaded. In this case <code>destination\x3c/code> must always be a directory.\x3c/p>\n<p><code>destination\x3c/code> is the target path on the remote machine. Both absolute paths and paths relative to the current working directory are supported.\x3c/p>\n<p><code>mode\x3c/code> can be used to set the target file permission. Numeric values are accepted. The default value is <code>0744\x3c/code> (<code>-rwxr--r--\x3c/code>).\x3c/p>\n<p><code>newline\x3c/code> can be used to force the line break characters that are written to the remote files. Valid values are <code>LF\x3c/code> and <code>CRLF\x3c/code>.\x3c/p>\n<p>Examples:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Put%20File\" class=\"name\">Put File\x3c/a>\x3c/td>\n<td>/path/to/*.txt\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Put%20File\" class=\"name\">Put File\x3c/a>\x3c/td>\n<td>/path/to/*.txt\x3c/td>\n<td>/home/groups/robot\x3c/td>\n<td>mode=0770\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Put%20File\" class=\"name\">Put File\x3c/a>\x3c/td>\n<td>/path/to/*.txt\x3c/td>\n<td>newline=CRLF\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The remote <code>destination\x3c/code> is created as following:\x3c/p>\n<p>1. If <code>destination\x3c/code> is an existing file, <code>source\x3c/code> file is uploaded over it.\x3c/p>\n<p>2. If <code>destination\x3c/code> is an existing directory, <code>source\x3c/code> file is uploaded into it. Possible file with same name is overwritten.\x3c/p>\n<p>3. If <code>destination\x3c/code> does not exist and it ends with the <a href=\"#Path%20separator\" class=\"name\">path separator\x3c/a>, it is considered a directory. The directory is then created and <code>source\x3c/code> file uploaded into it. Possibly missing intermediate directories are also created.\x3c/p>\n<p>4. If <code>destination\x3c/code> does not exist and it does not end with the <a href=\"#Path%20separator\" class=\"name\">path separator\x3c/a>, it is considered a file. If the path to the file does not exist, it is created.\x3c/p>\n<p>5. If <code>destination\x3c/code> is not given, the user's home directory on the remote machine is used as the destination.\x3c/p>\n<p>See also <a href=\"#Put%20Directory\" class=\"name\">Put Directory\x3c/a>.\x3c/p>","matched":true,"name":"Put File","shortdoc":"Uploads file(s) from the local machine to the remote machine.","tags":[]},{"args":["loglevel=None","delay=None"],"doc":"<p>Consumes and returns everything available on the server output.\x3c/p>\n<p>If <code>delay\x3c/code> is given, this keyword waits that amount of time and reads output again. This wait-read cycle is repeated as long as further reads return more output or the default <a href=\"#Timeout\" class=\"name\">timeout\x3c/a> expires. <code>delay\x3c/code> must be given in Robot Framework's time format (e.g. <code>5\x3c/code>, <code>4.5s\x3c/code>, <code>3 minutes\x3c/code>, <code>2 min 3 sec\x3c/code>) that is explained in detail in the <a href=\"http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#time-format\">User Guide\x3c/a>.\x3c/p>\n<p>This keyword is most useful for reading everything from the server output, thus clearing it.\x3c/p>\n<p>The read output is logged. <code>loglevel\x3c/code> can be used to override the default <a href=\"#Loglevel\" class=\"name\">log level\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Login\" class=\"name\">Login\x3c/a>\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>sudo su -\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Read\" class=\"name\">Read\x3c/a>\x3c/td>\n<td>delay=0.5s\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>[sudo] password for johndoe:\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>secretpasswd\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Read\" class=\"name\">Read\x3c/a>\x3c/td>\n<td>loglevel=WARN\x3c/td>\n<td># Shown in the console due to loglevel\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>root@\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See <a href=\"#Interactive%20shells\" class=\"name\">interactive shells\x3c/a> for more information about writing and reading in general.\x3c/p>","matched":true,"name":"Read","shortdoc":"Consumes and returns everything available on the server output.","tags":[]},{"args":["return_stdout=True","return_stderr=False","return_rc=False"],"doc":"<p>Returns outputs of the most recent started command.\x3c/p>\n<p>At least one command must have been started using <a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a> before this keyword can be used.\x3c/p>\n<p>By default, only the standard output of the started command is returned:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td><a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${stdout}\x3c/td>\n<td>Hello John!\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <code>return_stdout\x3c/code>, <code>return_stderr\x3c/code> and <code>return_rc\x3c/code> are used to specify, what is returned by this keyword. If several arguments evaluate to true, multiple values are returned. Non-empty strings, except <code>false\x3c/code> and <code>False\x3c/code>, evaluate to true.\x3c/p>\n<p>If errors are needed as well, set the argument value to true:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}\x3c/td>\n<td>${stderr}=\x3c/td>\n<td><a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a>\x3c/td>\n<td>return_stderr=True\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Empty\x3c/span>\x3c/td>\n<td>${stderr}\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Often checking the return code is enough:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${rc}=\x3c/td>\n<td><a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a>\x3c/td>\n<td>return_stdout=False\x3c/td>\n<td>return_rc=True\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal As Integers\x3c/span>\x3c/td>\n<td>${rc}\x3c/td>\n<td>0\x3c/td>\n<td># succeeded\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Using <a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a> and <a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a> follows LIFO (last in, first out) policy, meaning that <a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a> operates on the most recent started command, after which that command is discarded and its output cannot be read again.\x3c/p>\n<p>If several commands have been started, the output of the last started command is returned. After that, a subsequent call will return the output of the new last (originally the second last) command:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>\x3c/td>\n<td>echo 'HELLO'\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>\x3c/td>\n<td>echo 'SECOND'\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td><a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${stdout}\x3c/td>\n<td>'SECOND'\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td><a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${stdout}\x3c/td>\n<td>'HELLO'\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>This keyword logs the read command with log level <code>INFO\x3c/code>.\x3c/p>","matched":true,"name":"Read Command Output","shortdoc":"Returns outputs of the most recent started command.","tags":[]},{"args":["expected","loglevel=None"],"doc":"<p>Consumes and returns the server output until <code>expected\x3c/code> is encountered.\x3c/p>\n<p>Text up until and including the <code>expected\x3c/code> will be returned.\x3c/p>\n<p>If the <a href=\"#Timeout\" class=\"name\">timeout\x3c/a> expires before the match is found, this keyword fails.\x3c/p>\n<p>The read output is logged. <code>loglevel\x3c/code> can be used to override the default <a href=\"#Loglevel\" class=\"name\">log level\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Login\" class=\"name\">Login\x3c/a>\x3c/td>\n<td>johndoe\x3c/td>\n<td>${PASSWORD}\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>sudo su -\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>\x3c/td>\n<td>:\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>[sudo] password for johndoe:\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>${PASSWORD}\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a>\x3c/td>\n<td>@\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should End With\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>root@\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See also <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> and <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a> keywords. For more details about reading and writing in general, see the <a href=\"#Interactive%20shells\" class=\"name\">Interactive shells\x3c/a> section.\x3c/p>","matched":true,"name":"Read Until","shortdoc":"Consumes and returns the server output until ``expected`` is encountered.","tags":[]},{"args":["loglevel=None"],"doc":"<p>Consumes and returns the server output until the prompt is found.\x3c/p>\n<p>Text up and until prompt is returned. The <a href=\"#Prompt\" class=\"name\">prompt\x3c/a> must be set before this keyword is used.\x3c/p>\n<p>If the <a href=\"#Timeout\" class=\"name\">timeout\x3c/a> expires before the match is found, this keyword fails.\x3c/p>\n<p>This keyword is useful for reading output of a single command when output of previous command has been read and that command does not produce prompt characters in its output.\x3c/p>\n<p>The read output is logged. <code>loglevel\x3c/code> can be used to override the default <a href=\"#Loglevel\" class=\"name\">log level\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td>prompt=$\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Login\" class=\"name\">Login\x3c/a>\x3c/td>\n<td>johndoe\x3c/td>\n<td>${PASSWORD}\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>sudo su -\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>${PASSWORD}\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a>\x3c/td>\n<td>prompt=#\x3c/td>\n<td># For root, the prompt is #\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should End With\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>root@myserver:~#\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See also <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a> and <a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a> keywords. For more details about reading and writing in general, see the <a href=\"#Interactive%20shells\" class=\"name\">Interactive shells\x3c/a> section.\x3c/p>","matched":true,"name":"Read Until Prompt","shortdoc":"Consumes and returns the server output until the prompt is found.","tags":[]},{"args":["regexp","loglevel=None"],"doc":"<p>Consumes and returns the server output until a match to <code>regexp\x3c/code> is found.\x3c/p>\n<p><code>regexp\x3c/code> can be a regular expression pattern or a compiled regular expression object. See the <a href=\"#Regular%20expressions\" class=\"name\">Regular expressions\x3c/a> section for more details about the syntax.\x3c/p>\n<p>Text up until and including the <code>regexp\x3c/code> will be returned.\x3c/p>\n<p>If the <a href=\"#Timeout\" class=\"name\">timeout\x3c/a> expires before the match is found, this keyword fails.\x3c/p>\n<p>The read output is logged. <code>loglevel\x3c/code> can be used to override the default <a href=\"#Loglevel\" class=\"name\">log level\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Login\" class=\"name\">Login\x3c/a>\x3c/td>\n<td>johndoe\x3c/td>\n<td>${PASSWORD}\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>sudo su -\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a>\x3c/td>\n<td>\\\\[.*\\\\].*:\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>[sudo] password for johndoe:\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>${PASSWORD}\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Read%20Until%20Regexp\" class=\"name\">Read Until Regexp\x3c/a>\x3c/td>\n<td>.*@\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>root@\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See also <a href=\"#Read%20Until\" class=\"name\">Read Until\x3c/a> and <a href=\"#Read%20Until%20Prompt\" class=\"name\">Read Until Prompt\x3c/a> keywords. For more details about reading and writing in general, see the <a href=\"#Interactive%20shells\" class=\"name\">Interactive shells\x3c/a> section.\x3c/p>","matched":true,"name":"Read Until Regexp","shortdoc":"Consumes and returns the server output until a match to ``regexp`` is found.","tags":[]},{"args":["timeout=None","newline=None","prompt=None","term_type=None","width=None","height=None","path_separator=None","encoding=None"],"doc":"<p>Update the <a href=\"#Configuration\" class=\"name\">configuration\x3c/a> of the current connection.\x3c/p>\n<p>Only parameters whose value is other than <code>None\x3c/code> are updated.\x3c/p>\n<p>In the following example, <a href=\"#Prompt\" class=\"name\">prompt\x3c/a> is set for the current connection. Other settings are left intact:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection    \x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a>\x3c/td>\n<td>prompt=$\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${myserver}=\x3c/td>\n<td><a href=\"#Get%20Connection\" class=\"name\">Get Connection\x3c/a>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${myserver.prompt}\x3c/td>\n<td>$\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Using keyword does not affect the other connections:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>linux.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a>\x3c/td>\n<td>prompt=$\x3c/td>\n<td>\x3c/td>\n<td># Only linux.server.com affected\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection    \x3c/a>\x3c/td>\n<td>windows.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a>\x3c/td>\n<td>prompt=&gt;\x3c/td>\n<td>\x3c/td>\n<td># Only windows.server.com affected\x3c/td>\n\x3c/tr>\n<tr>\n<td>${linux}\x3c/td>\n<td>${windows}=\x3c/td>\n<td><a href=\"#Get%20Connections\" class=\"name\">Get Connections\x3c/a>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${linux.prompt}\x3c/td>\n<td>$\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${windows.prompt}\x3c/td>\n<td>&gt;\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Multiple settings are possible. This example updates the <a href=\"#Terminal%20settings\" class=\"name\">terminal settings\x3c/a> of the current connection:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>192.168.1.1\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a>\x3c/td>\n<td>term_type=ansi\x3c/td>\n<td>width=40\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Set Client Configuration","shortdoc":"Update the `configuration` of the current connection.","tags":[]},{"args":["timeout=None","newline=None","prompt=None","loglevel=None","term_type=None","width=None","height=None","path_separator=None","encoding=None"],"doc":"<p>Update the default <a href=\"#Configuration\" class=\"name\">configuration\x3c/a>.\x3c/p>\n<p>Please note that using this keyword does not affect the already opened connections. Use <a href=\"#Set%20Client%20Configuration\" class=\"name\">Set Client Configuration\x3c/a> to configure the active connection.\x3c/p>\n<p>Only parameters whose value is other than <code>None\x3c/code> are updated.\x3c/p>\n<p>This example sets <a href=\"#Prompt\" class=\"name\">prompt\x3c/a> to <code>$\x3c/code>:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Set%20Default%20Configuration\" class=\"name\">Set Default Configuration\x3c/a>\x3c/td>\n<td>prompt=$\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>This example sets <a href=\"#Newline\" class=\"name\">newline\x3c/a> and <a href=\"#Path%20separator\" class=\"name\">path separator\x3c/a> to the ones known by Windows:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Set%20Default%20Configuration\" class=\"name\">Set Default Configuration\x3c/a>\x3c/td>\n<td>newline=CRLF\x3c/td>\n<td>path_separator=\\\\\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Sometimes you might want to use longer <a href=\"#Timeout\" class=\"name\">timeout\x3c/a> for all the subsequent connections without affecting the existing ones:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Set%20Default%20Configuration\" class=\"name\">Set Default Configuration\x3c/a>\x3c/td>\n<td>timeout=5 seconds\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection       \x3c/a>\x3c/td>\n<td>local.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Set%20Default%20Configuration\" class=\"name\">Set Default Configuration\x3c/a>\x3c/td>\n<td>timeout=20 seconds\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>emea.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>apac.server.com\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${local}\x3c/td>\n<td>${emea}\x3c/td>\n<td>${apac}=\x3c/td>\n<td><a href=\"#Get%20Connections\" class=\"name\">Get Connections\x3c/a>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal As Integers\x3c/span>\x3c/td>\n<td>${local.timeout}\x3c/td>\n<td>5\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal As Integers\x3c/span>\x3c/td>\n<td>${emea.timeout}\x3c/td>\n<td>20\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal As Integers\x3c/span>\x3c/td>\n<td>${apac.timeout}\x3c/td>\n<td>20\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Set Default Configuration","shortdoc":"Update the default `configuration`.","tags":[]},{"args":["command","sudo=False","sudo_password=None"],"doc":"<p>Starts execution of the <code>command\x3c/code> on the remote machine and returns immediately.\x3c/p>\n<p>This keyword returns nothing and does not wait for the <code>command\x3c/code> execution to be finished. If waiting for the output is required, use <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a> instead.\x3c/p>\n<p>This keyword does not return any output generated by the started <code>command\x3c/code>. Use <a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a> to read the output:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>\x3c/td>\n<td>echo 'Hello John!'\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${stdout}=\x3c/td>\n<td><a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${stdout}\x3c/td>\n<td>Hello John!\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>The <code>command\x3c/code> is always executed in a new shell, similarly as with <a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>. Thus possible changes to the environment (e.g. changing working directory) are not visible to the later keywords:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>\x3c/td>\n<td>pwd\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${pwd}=\x3c/td>\n<td><a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${pwd}\x3c/td>\n<td>/home/johndoe\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>\x3c/td>\n<td>cd /tmp\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>\x3c/td>\n<td>pwd\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${pwd}=\x3c/td>\n<td><a href=\"#Read%20Command%20Output\" class=\"name\">Read Command Output\x3c/a>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${pwd}\x3c/td>\n<td>/home/johndoe\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>Arguments <code>sudo\x3c/code> and <code>sudo_password\x3c/code> are used for executing commands within a sudo session. Due to different permission elevation in Cygwin, these two arguments will not when using it.\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Start%20Command\" class=\"name\">Start Command\x3c/a>\x3c/td>\n<td>pwd\x3c/td>\n<td>sudo=True\x3c/td>\n<td>sudo_password=test\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p><a href=\"#Write\" class=\"name\">Write\x3c/a> and <a href=\"#Read\" class=\"name\">Read\x3c/a> can be used for running multiple commands in the same shell. See <a href=\"#Interactive%20shells\" class=\"name\">interactive shells\x3c/a> section for more information.\x3c/p>\n<p>This keyword logs the started command with log level <code>INFO\x3c/code>.\x3c/p>\n<p><code>sudo\x3c/code> and <code>sudo_password\x3c/code> arguments are new in SSHLibrary 3.0.0.\x3c/p>","matched":true,"name":"Start Command","shortdoc":"Starts execution of the ``command`` on the remote machine and returns immediately.","tags":[]},{"args":["index_or_alias"],"doc":"<p>Switches the active connection by index or alias.\x3c/p>\n<p><code>index_or_alias\x3c/code> is either connection index (an integer) or alias (a string). Index is got as the return value of <a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>. Alternatively, both index and alias can queried as attributes of the object returned by <a href=\"#Get%20Connection\" class=\"name\">Get Connection\x3c/a>.\x3c/p>\n<p>This keyword returns the index of the previous active connection, which can be used to switch back to that connection later.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${myserver}=\x3c/td>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>my.server.com\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Login\" class=\"name\">Login\x3c/a>\x3c/td>\n<td>johndoe\x3c/td>\n<td>secretpasswd\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Open%20Connection\" class=\"name\">Open Connection\x3c/a>\x3c/td>\n<td>build.local.net\x3c/td>\n<td>alias=Build\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Login\" class=\"name\">Login\x3c/a>\x3c/td>\n<td>jenkins\x3c/td>\n<td>jenkins\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a>\x3c/td>\n<td>${myserver}\x3c/td>\n<td>\x3c/td>\n<td># Switch using index\x3c/td>\n\x3c/tr>\n<tr>\n<td>${username}=\x3c/td>\n<td><a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>\x3c/td>\n<td>whoami\x3c/td>\n<td># Executed on my.server.com\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${username}\x3c/td>\n<td>johndoe\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Switch%20Connection\" class=\"name\">Switch Connection\x3c/a>\x3c/td>\n<td>Build\x3c/td>\n<td>\x3c/td>\n<td># Switch using alias\x3c/td>\n\x3c/tr>\n<tr>\n<td>${username}=\x3c/td>\n<td><a href=\"#Execute%20Command\" class=\"name\">Execute Command\x3c/a>\x3c/td>\n<td>whoami\x3c/td>\n<td># Executed on build.local.net\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Be Equal\x3c/span>\x3c/td>\n<td>${username}\x3c/td>\n<td>jenkins\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Switch Connection","shortdoc":"Switches the active connection by index or alias.","tags":[]},{"args":["text","loglevel=None"],"doc":"<p>Writes the given <code>text\x3c/code> on the remote machine and appends a newline.\x3c/p>\n<p>Appended <a href=\"#Newline\" class=\"name\">newline\x3c/a> can be configured.\x3c/p>\n<p>This keyword returns and consumes the written <code>text\x3c/code> (including the appended newline) from the server output. See the <a href=\"#Interactive%20shells\" class=\"name\">Interactive shells\x3c/a> section for more information.\x3c/p>\n<p>The written <code>text\x3c/code> is logged. <code>loglevel\x3c/code> can be used to override the default <a href=\"#Loglevel\" class=\"name\">log level\x3c/a>.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>${written}=\x3c/td>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>su\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${written}\x3c/td>\n<td>su\x3c/td>\n<td># Returns the consumed output\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Read\" class=\"name\">Read\x3c/a>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Not Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>${written}\x3c/td>\n<td># Was consumed from the output\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>Password:\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Write\" class=\"name\">Write\x3c/a>\x3c/td>\n<td>invalidpasswd\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Read\" class=\"name\">Read\x3c/a>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>su: Authentication failure\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See also <a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a>.\x3c/p>","matched":true,"name":"Write","shortdoc":"Writes the given ``text`` on the remote machine and appends a newline.","tags":[]},{"args":["text"],"doc":"<p>Writes the given <code>text\x3c/code> on the remote machine without appending a newline.\x3c/p>\n<p>Unlike <a href=\"#Write\" class=\"name\">Write\x3c/a>, this keyword returns and consumes nothing. See the <a href=\"#Interactive%20shells\" class=\"name\">Interactive shells\x3c/a> section for more information.\x3c/p>\n<p>Example:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a>\x3c/td>\n<td>su\\n\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Read\" class=\"name\">Read\x3c/a>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>su\x3c/td>\n<td># Was not consumed from output\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>Password:\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><a href=\"#Write%20Bare\" class=\"name\">Write Bare\x3c/a>\x3c/td>\n<td>invalidpasswd\\n\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td>${output}=\x3c/td>\n<td><a href=\"#Read\" class=\"name\">Read\x3c/a>\x3c/td>\n<td>\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n<tr>\n<td><span class=\"name\">Should Contain\x3c/span>\x3c/td>\n<td>${output}\x3c/td>\n<td>su: Authentication failure\x3c/td>\n<td>\x3c/td>\n\x3c/tr>\n\x3c/table>\n<p>See also <a href=\"#Write\" class=\"name\">Write\x3c/a>.\x3c/p>","matched":true,"name":"Write Bare","shortdoc":"Writes the given ``text`` on the remote machine without appending a newline.","tags":[]},{"args":["text","expected","timeout","retry_interval","loglevel=None"],"doc":"<p>Writes the given <code>text\x3c/code> repeatedly until <code>expected\x3c/code> appears in the server output.\x3c/p>\n<p>This keyword returns nothing.\x3c/p>\n<p><code>text\x3c/code> is written without appending a newline and is consumed from the server output before <code>expected\x3c/code> is read. See more information on the <a href=\"#Interactive%20shells\" class=\"name\">Interactive shells\x3c/a> section.\x3c/p>\n<p>If <code>expected\x3c/code> does not appear in output within <code>timeout\x3c/code>, this keyword fails. <code>retry_interval\x3c/code> defines the time before writing <code>text\x3c/code> again. Both <code>timeout\x3c/code> and <code>retry_interval\x3c/code> must be given in Robot Framework's time format (e.g. <code>5\x3c/code>, <code>1 minute\x3c/code>, <code>2 min 3 s\x3c/code>, <code>4.5\x3c/code>) that is explained in detail in the <a href=\"http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#time-format\">User Guide\x3c/a>.\x3c/p>\n<p>The written <code>text\x3c/code> is logged. <code>loglevel\x3c/code> can be used to override the default <a href=\"#Loglevel\" class=\"name\">log level\x3c/a>.\x3c/p>\n<p>This example will write <code>lsof -c python27\\n\x3c/code> (list all files currently opened by Python 2.7), until <code>myscript.py\x3c/code> appears in the output. The command is written every 0.5 seconds. The keyword fails if <code>myscript.py\x3c/code> does not appear in the server output in 5 seconds:\x3c/p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Write%20Until%20Expected%20Output\" class=\"name\">Write Until Expected Output\x3c/a>\x3c/td>\n<td>lsof -c python27\\n\x3c/td>\n<td>expected=myscript.py\x3c/td>\n<td>timeout=5s\x3c/td>\n<td>retry_interval=0.5s\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Write Until Expected Output","shortdoc":"Writes the given ``text`` repeatedly until ``expected`` appears in the server output.","tags":[]}],"name":"SSHLibrary","named_args":true,"scope":"global","version":"3.0.0"};
 </script>
 <title></title>
 </head>
diff --git a/src/SSHLibrary/version.py b/src/SSHLibrary/version.py
index 11744f47e..8943444b8 100644
--- a/src/SSHLibrary/version.py
+++ b/src/SSHLibrary/version.py
@@ -13,4 +13,4 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
-VERSION = '3.0.0rc2.dev1'
+VERSION = '3.0.0'