herbglitch/archeus
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
archeus/doc/doxygen/html/d7/dfb/ssh_8c.html

624 lines
57 KiB
HTML
Raw Blame History

<!-- HTML header for doxygen 1.9.2-->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" class="dark-mode">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.12.0"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Archeus: /home/herbglitch/programs/archeus/arc/packages/networking/libssh/ssh.c File Reference</title>
<link href="../../tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="../../jquery.js"></script>
<script type="text/javascript" src="../../dynsections.js"></script>
<link href="../../navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="../../navtreedata.js"></script>
<script type="text/javascript" src="../../navtree.js"></script>
<script type="text/javascript" src="../../resize.js"></script>
<script type="text/javascript" src="../../cookie.js"></script>
<link href="../../search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="../../search/searchdata.js"></script>
<script type="text/javascript" src="../../search/search.js"></script>
<link href="../../doxygen.css" rel="stylesheet" type="text/css" />
<link href="../../doxygen-awesome.css" rel="stylesheet" type="text/css"/>
<link href="../../doxygen-awesome-sidebar-only.css" rel="stylesheet" type="text/css"/>
<link href="../../doxygen-awesome-sidebar-only-darkmode-toggle.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="../../doxygen-awesome-darkmode-toggle.js"></script>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">Archeus<span id="projectnumber">&#160;0.0.0</span>
</div>
<div id="projectbrief">A C library and game engine that focuses on documentation</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.12.0 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "../../search/",'.html');
/* @license-end */
</script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() { codefold.init(1); });
/* @license-end */
</script>
<script type="text/javascript" src="../../menudata.js"></script>
<script type="text/javascript" src="../../menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() {
initMenu('../../',true,false,'search.php','Search',true);
$(function() { init_search(); });
});
/* @license-end */
</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function(){initNavTree('d7/dfb/ssh_8c.html','../../'); initResizable(true); });
/* @license-end */
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<div id="MSearchResults">
<div class="SRPage">
<div id="SRIndex">
<div id="SRResults"></div>
<div class="SRStatus" id="Loading">Loading...</div>
<div class="SRStatus" id="Searching">Searching...</div>
<div class="SRStatus" id="NoMatches">No Matches</div>
</div>
</div>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#nested-classes">Data Structures</a> &#124;
<a href="#func-members">Functions</a> </div>
<div class="headertitle"><div class="title">ssh.c File Reference</div></div>
</div><!--header-->
<div class="contents">
<div class="textblock"><code>#include &quot;<a class="el" href="../../d8/dd3/ssh_8h_source.html">arc/networking/ssh.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="../../d8/dc2/errno_8h_source.html">arc/std/errno.h</a>&quot;</code><br />
<code>#include &quot;<a class="el" href="../../da/d66/string_8h_source.html">arc/std/string.h</a>&quot;</code><br />
<code>#include &lt;stdint.h&gt;</code><br />
<code>#include &lt;stdlib.h&gt;</code><br />
<code>#include &lt;libssh/libssh.h&gt;</code><br />
</div>
<p><a href="../../d7/dfb/ssh_8c_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="nested-classes" name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:ad5d8ab97d3635ecaf8fa78225cb960fb" id="r_ad5d8ab97d3635ecaf8fa78225cb960fb"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#ad5d8ab97d3635ecaf8fa78225cb960fb">verify_knownhost</a> (ssh_session session)</td></tr>
<tr class="separator:ad5d8ab97d3635ecaf8fa78225cb960fb"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ad489e520aa92d284e50db127e1e8157a" id="r_ad489e520aa92d284e50db127e1e8157a"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#ad489e520aa92d284e50db127e1e8157a">ARC_Ssh_Create</a> (<a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> **ssh, char *host, char *user, char *password)</td></tr>
<tr class="memdesc:ad489e520aa92d284e50db127e1e8157a"><td class="mdescLeft">&#160;</td><td class="mdescRight">creates <a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> type <br /></td></tr>
<tr class="separator:ad489e520aa92d284e50db127e1e8157a"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a08efa4bb06634fc63432bee3f0cafbc1" id="r_a08efa4bb06634fc63432bee3f0cafbc1"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a08efa4bb06634fc63432bee3f0cafbc1">ARC_Ssh_Destroy</a> (<a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> *ssh)</td></tr>
<tr class="memdesc:a08efa4bb06634fc63432bee3f0cafbc1"><td class="mdescLeft">&#160;</td><td class="mdescRight">destroyes <a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> type <br /></td></tr>
<tr class="separator:a08efa4bb06634fc63432bee3f0cafbc1"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a611049154ff185c551929068f3d0270a" id="r_a611049154ff185c551929068f3d0270a"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a611049154ff185c551929068f3d0270a">ARC_Ssh_RunInSession</a> (<a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> *ssh, <a class="el" href="../../d8/dd3/ssh_8h.html#aa6f481c13aec410d0902c4f9a5d94e9b">ARC_Ssh_SessionFn</a> sessionFn)</td></tr>
<tr class="memdesc:a611049154ff185c551929068f3d0270a"><td class="mdescLeft">&#160;</td><td class="mdescRight">runs a callback function within a ssh session <br /></td></tr>
<tr class="separator:a611049154ff185c551929068f3d0270a"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a1e5f9b0c05c7e9b9d99430dc05ef02b3" id="r_a1e5f9b0c05c7e9b9d99430dc05ef02b3"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a1e5f9b0c05c7e9b9d99430dc05ef02b3">ARC_Ssh_ExecStrInNewSession</a> (<a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> *ssh, char *command)</td></tr>
<tr class="separator:a1e5f9b0c05c7e9b9d99430dc05ef02b3"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a1cc4737620480eb72a38fd0bbc84a9d2" id="r_a1cc4737620480eb72a38fd0bbc84a9d2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="../../df/d06/structARC__String.html">ARC_String</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a1cc4737620480eb72a38fd0bbc84a9d2">ARC_Ssh_ExecStrInNewSessionAndGetResponse</a> (<a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> *ssh, char *command)</td></tr>
<tr class="separator:a1cc4737620480eb72a38fd0bbc84a9d2"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<h2 class="groupheader">Function Documentation</h2>
<a id="ad489e520aa92d284e50db127e1e8157a" name="ad489e520aa92d284e50db127e1e8157a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad489e520aa92d284e50db127e1e8157a">&#9670;&#160;</a></span>ARC_Ssh_Create()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void ARC_Ssh_Create </td>
<td>(</td>
<td class="paramtype"><a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> **</td> <td class="paramname"><span class="paramname"><em>ssh</em></span>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char *</td> <td class="paramname"><span class="paramname"><em>host</em></span>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char *</td> <td class="paramname"><span class="paramname"><em>user</em></span>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char *</td> <td class="paramname"><span class="paramname"><em>password</em></span>&#160;)</td>
</tr>
</table>
</div><div class="memdoc">
<p>creates <a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> type </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">ssh</td><td><a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> to create </td></tr>
</table>
</dd>
</dl>
<p class="definition">Definition at line <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00094">94</a> of file <a class="el" href="../../d7/dfb/ssh_8c_source.html">ssh.c</a>.</p>
<div class="fragment"><div class="line"><span class="lineno"> 94</span> {</div>
<div class="line"><span class="lineno"> 95</span> *ssh = (<a class="code hl_struct" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> *)malloc(<span class="keyword">sizeof</span>(<a class="code hl_struct" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a>));</div>
<div class="line"><span class="lineno"> 96</span> </div>
<div class="line"><span class="lineno"> 97</span> (*ssh)-&gt;<a class="code hl_variable" href="../../d8/d43/structARC__Ssh.html#acb504a5b1323711e58cc0fd66ac30dda">session</a> = ssh_new();</div>
<div class="line"><span class="lineno"> 98</span> <span class="keywordflow">if</span>((*ssh)-&gt;session == NULL){</div>
<div class="line"><span class="lineno"> 99</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#ab626cdbbebc1ac9abd1548a5f6f6195b">ARC_ERRNO_NULL</a>;</div>
<div class="line"><span class="lineno"> 100</span> ARC_DEBUG_ERR(<span class="stringliteral">&quot;ARC_Ssh_Create(ssh), ssh session could not be created\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 101</span> free(*ssh);</div>
<div class="line"><span class="lineno"> 102</span> *ssh = NULL;</div>
<div class="line"><span class="lineno"> 103</span> <span class="keywordflow">return</span>;</div>
<div class="line"><span class="lineno"> 104</span> }</div>
<div class="line"><span class="lineno"> 105</span> </div>
<div class="line"><span class="lineno"> 106</span> <span class="keywordflow">if</span>(host != NULL){</div>
<div class="line"><span class="lineno"> 107</span> ssh_options_set((*ssh)-&gt;session, SSH_OPTIONS_HOST, host);</div>
<div class="line"><span class="lineno"> 108</span> }</div>
<div class="line"><span class="lineno"> 109</span> </div>
<div class="line"><span class="lineno"> 110</span> <span class="keywordflow">if</span>(user != NULL){</div>
<div class="line"><span class="lineno"> 111</span> ssh_options_set((*ssh)-&gt;session, SSH_OPTIONS_USER, user);</div>
<div class="line"><span class="lineno"> 112</span> }</div>
<div class="line"><span class="lineno"> 113</span> </div>
<div class="line"><span class="lineno"> 114</span> int32_t returnCode = ssh_connect((*ssh)-&gt;session);</div>
<div class="line"><span class="lineno"> 115</span> <span class="keywordflow">if</span>(returnCode != SSH_OK){</div>
<div class="line"><span class="lineno"> 116</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#a12df35ef61d8cceea6360b586d09e5d1">ARC_ERRNO_CONNECTION</a>;</div>
<div class="line"><span class="lineno"> 117</span> ARC_DEBUG_LOG(<a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a>, <span class="stringliteral">&quot;ARC_Ssh_Create(ssh), ssh failed to connect to localhost: %s\n&quot;</span>, ssh_get_error((*ssh)-&gt;session));</div>
<div class="line"><span class="lineno"> 118</span> ssh_free((*ssh)-&gt;session);</div>
<div class="line"><span class="lineno"> 119</span> free(*ssh);</div>
<div class="line"><span class="lineno"> 120</span> *ssh = NULL;</div>
<div class="line"><span class="lineno"> 121</span> <span class="keywordflow">return</span>;</div>
<div class="line"><span class="lineno"> 122</span> }</div>
<div class="line"><span class="lineno"> 123</span> </div>
<div class="line"><span class="lineno"> 124</span> <span class="keywordflow">if</span>(<a class="code hl_function" href="#ad5d8ab97d3635ecaf8fa78225cb960fb">verify_knownhost</a>((*ssh)-&gt;session) &lt; 0){</div>
<div class="line"><span class="lineno"> 125</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#a12df35ef61d8cceea6360b586d09e5d1">ARC_ERRNO_CONNECTION</a>;</div>
<div class="line"><span class="lineno"> 126</span> ARC_DEBUG_ERR(<span class="stringliteral">&quot;ARC_Ssh_Create(ssh), ssh failed to verify knownhost\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 127</span> ssh_disconnect((*ssh)-&gt;session);</div>
<div class="line"><span class="lineno"> 128</span> ssh_free((*ssh)-&gt;session);</div>
<div class="line"><span class="lineno"> 129</span> free(*ssh);</div>
<div class="line"><span class="lineno"> 130</span> *ssh = NULL;</div>
<div class="line"><span class="lineno"> 131</span> }</div>
<div class="line"><span class="lineno"> 132</span> </div>
<div class="line"><span class="lineno"> 133</span> <span class="comment">//if no password is provided try to connect with a public key</span></div>
<div class="line"><span class="lineno"> 134</span> <span class="keywordflow">if</span>(password == NULL){</div>
<div class="line"><span class="lineno"> 135</span> returnCode = ssh_userauth_publickey_auto((*ssh)-&gt;session, NULL, NULL);</div>
<div class="line"><span class="lineno"> 136</span> <span class="keywordflow">if</span>(returnCode != SSH_AUTH_SUCCESS){</div>
<div class="line"><span class="lineno"> 137</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#a12df35ef61d8cceea6360b586d09e5d1">ARC_ERRNO_CONNECTION</a>;</div>
<div class="line"><span class="lineno"> 138</span> ARC_DEBUG_LOG(<a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a>, <span class="stringliteral">&quot;ARC_Ssh_Create(ssh), ssh failed to authenticate with password: %s\n&quot;</span>, ssh_get_error((*ssh)-&gt;session));</div>
<div class="line"><span class="lineno"> 139</span> ssh_disconnect((*ssh)-&gt;session);</div>
<div class="line"><span class="lineno"> 140</span> ssh_free((*ssh)-&gt;session);</div>
<div class="line"><span class="lineno"> 141</span> free(*ssh);</div>
<div class="line"><span class="lineno"> 142</span> *ssh = NULL;</div>
<div class="line"><span class="lineno"> 143</span> }</div>
<div class="line"><span class="lineno"> 144</span> </div>
<div class="line"><span class="lineno"> 145</span> ssh_send_ignore((*ssh)-&gt;session, <span class="stringliteral">&quot;mpv https://youtu.be/1P5BSm_oFJg --input-ipc-server=/tmp/mpvsocket --no-terminal &amp; disown&quot;</span>);</div>
<div class="line"><span class="lineno"> 146</span> </div>
<div class="line"><span class="lineno"> 147</span> <span class="keywordflow">return</span>;</div>
<div class="line"><span class="lineno"> 148</span> }</div>
<div class="line"><span class="lineno"> 149</span> </div>
<div class="line"><span class="lineno"> 150</span> <span class="comment">//try connecting with password</span></div>
<div class="line"><span class="lineno"> 151</span> returnCode = ssh_userauth_password((*ssh)-&gt;session, NULL, password);</div>
<div class="line"><span class="lineno"> 152</span> <span class="keywordflow">if</span>(returnCode != SSH_AUTH_SUCCESS){</div>
<div class="line"><span class="lineno"> 153</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#a12df35ef61d8cceea6360b586d09e5d1">ARC_ERRNO_CONNECTION</a>;</div>
<div class="line"><span class="lineno"> 154</span> ARC_DEBUG_LOG(<a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a>, <span class="stringliteral">&quot;ARC_Ssh_Create(ssh), ssh failed to authenticate with password: %s\n&quot;</span>, ssh_get_error((*ssh)-&gt;session));</div>
<div class="line"><span class="lineno"> 155</span> ssh_disconnect((*ssh)-&gt;session);</div>
<div class="line"><span class="lineno"> 156</span> ssh_free((*ssh)-&gt;session);</div>
<div class="line"><span class="lineno"> 157</span> free(*ssh);</div>
<div class="line"><span class="lineno"> 158</span> *ssh = NULL;</div>
<div class="line"><span class="lineno"> 159</span> }</div>
<div class="line"><span class="lineno"> 160</span>}</div>
<div class="ttc" id="aerrno_8h_html_a12df35ef61d8cceea6360b586d09e5d1"><div class="ttname"><a href="../../d8/dc2/errno_8h.html#a12df35ef61d8cceea6360b586d09e5d1">ARC_ERRNO_CONNECTION</a></div><div class="ttdeci">#define ARC_ERRNO_CONNECTION</div><div class="ttdef"><b>Definition</b> <a href="../../d8/dc2/errno_8h_source.html#l00012">errno.h:12</a></div></div>
<div class="ttc" id="aerrno_8h_html_a5884aa8cc9b4e733345e49f93b54f75a"><div class="ttname"><a href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a></div><div class="ttdeci">int32_t arc_errno</div><div class="ttdef"><b>Definition</b> <a href="../../d0/d90/errno_8c_source.html#l00005">errno.c:5</a></div></div>
<div class="ttc" id="aerrno_8h_html_ab626cdbbebc1ac9abd1548a5f6f6195b"><div class="ttname"><a href="../../d8/dc2/errno_8h.html#ab626cdbbebc1ac9abd1548a5f6f6195b">ARC_ERRNO_NULL</a></div><div class="ttdeci">#define ARC_ERRNO_NULL</div><div class="ttdef"><b>Definition</b> <a href="../../d8/dc2/errno_8h_source.html#l00006">errno.h:6</a></div></div>
<div class="ttc" id="assh_8c_html_ad5d8ab97d3635ecaf8fa78225cb960fb"><div class="ttname"><a href="#ad5d8ab97d3635ecaf8fa78225cb960fb">verify_knownhost</a></div><div class="ttdeci">int verify_knownhost(ssh_session session)</div><div class="ttdef"><b>Definition</b> <a href="../../d7/dfb/ssh_8c_source.html#l00015">ssh.c:15</a></div></div>
<div class="ttc" id="astructARC__Ssh_html"><div class="ttname"><a href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a></div><div class="ttdef"><b>Definition</b> <a href="../../d7/dfb/ssh_8c_source.html#l00011">ssh.c:11</a></div></div>
<div class="ttc" id="astructARC__Ssh_html_acb504a5b1323711e58cc0fd66ac30dda"><div class="ttname"><a href="../../d8/d43/structARC__Ssh.html#acb504a5b1323711e58cc0fd66ac30dda">ARC_Ssh::session</a></div><div class="ttdeci">ssh_session session</div><div class="ttdef"><b>Definition</b> <a href="../../d7/dfb/ssh_8c_source.html#l00012">ssh.c:12</a></div></div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="../../d0/d90/errno_8c_source.html#l00005">arc_errno</a>, <a class="el" href="../../d8/dc2/errno_8h_source.html#l00012">ARC_ERRNO_CONNECTION</a>, <a class="el" href="../../d8/dc2/errno_8h_source.html#l00006">ARC_ERRNO_NULL</a>, <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00012">ARC_Ssh::session</a>, and <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00015">verify_knownhost()</a>.</p>
</div>
</div>
<a id="a08efa4bb06634fc63432bee3f0cafbc1" name="a08efa4bb06634fc63432bee3f0cafbc1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a08efa4bb06634fc63432bee3f0cafbc1">&#9670;&#160;</a></span>ARC_Ssh_Destroy()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void ARC_Ssh_Destroy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> *</td> <td class="paramname"><span class="paramname"><em>ssh</em></span></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>destroyes <a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> type </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">ssh</td><td><a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> to destroy </td></tr>
</table>
</dd>
</dl>
<p class="definition">Definition at line <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00162">162</a> of file <a class="el" href="../../d7/dfb/ssh_8c_source.html">ssh.c</a>.</p>
<div class="fragment"><div class="line"><span class="lineno"> 162</span> {</div>
<div class="line"><span class="lineno"> 163</span> <span class="keywordflow">if</span>(ssh == NULL){</div>
<div class="line"><span class="lineno"> 164</span> <span class="keywordflow">return</span>;</div>
<div class="line"><span class="lineno"> 165</span> }</div>
<div class="line"><span class="lineno"> 166</span> </div>
<div class="line"><span class="lineno"> 167</span> ssh_disconnect(ssh-&gt;<a class="code hl_variable" href="../../d8/d43/structARC__Ssh.html#acb504a5b1323711e58cc0fd66ac30dda">session</a>);</div>
<div class="line"><span class="lineno"> 168</span> ssh_free(ssh-&gt;<a class="code hl_variable" href="../../d8/d43/structARC__Ssh.html#acb504a5b1323711e58cc0fd66ac30dda">session</a>);</div>
<div class="line"><span class="lineno"> 169</span> free(ssh);</div>
<div class="line"><span class="lineno"> 170</span>}</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00012">ARC_Ssh::session</a>.</p>
</div>
</div>
<a id="a1e5f9b0c05c7e9b9d99430dc05ef02b3" name="a1e5f9b0c05c7e9b9d99430dc05ef02b3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a1e5f9b0c05c7e9b9d99430dc05ef02b3">&#9670;&#160;</a></span>ARC_Ssh_ExecStrInNewSession()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void ARC_Ssh_ExecStrInNewSession </td>
<td>(</td>
<td class="paramtype"><a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> *</td> <td class="paramname"><span class="paramname"><em>ssh</em></span>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char *</td> <td class="paramname"><span class="paramname"><em>command</em></span>&#160;)</td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00199">199</a> of file <a class="el" href="../../d7/dfb/ssh_8c_source.html">ssh.c</a>.</p>
<div class="fragment"><div class="line"><span class="lineno"> 199</span> {</div>
<div class="line"><span class="lineno"> 200</span> ssh_channel channel;</div>
<div class="line"><span class="lineno"> 201</span> channel = ssh_channel_new(ssh-&gt;<a class="code hl_variable" href="../../d8/d43/structARC__Ssh.html#acb504a5b1323711e58cc0fd66ac30dda">session</a>);</div>
<div class="line"><span class="lineno"> 202</span> <span class="keywordflow">if</span>(channel == NULL){</div>
<div class="line"><span class="lineno"> 203</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#ab626cdbbebc1ac9abd1548a5f6f6195b">ARC_ERRNO_NULL</a>;</div>
<div class="line"><span class="lineno"> 204</span> ARC_DEBUG_ERR(<span class="stringliteral">&quot;ARC_Ssh_RunInSession(ssh, sessionFn), ssh failed to create channel\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 205</span> <span class="keywordflow">return</span>;</div>
<div class="line"><span class="lineno"> 206</span> }</div>
<div class="line"><span class="lineno"> 207</span> </div>
<div class="line"><span class="lineno"> 208</span> int32_t returnCode = ssh_channel_open_session(channel);</div>
<div class="line"><span class="lineno"> 209</span> <span class="keywordflow">if</span>(returnCode != SSH_OK){</div>
<div class="line"><span class="lineno"> 210</span> ssh_channel_free(channel);</div>
<div class="line"><span class="lineno"> 211</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#a12df35ef61d8cceea6360b586d09e5d1">ARC_ERRNO_CONNECTION</a>;</div>
<div class="line"><span class="lineno"> 212</span> ARC_DEBUG_LOG(<a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a>, <span class="stringliteral">&quot;ARC_Ssh_RunInSession(ssh, sessionFn), ssh failed to open session with return code: %d\n&quot;</span>, returnCode);</div>
<div class="line"><span class="lineno"> 213</span> <span class="keywordflow">return</span>;</div>
<div class="line"><span class="lineno"> 214</span> }</div>
<div class="line"><span class="lineno"> 215</span> </div>
<div class="line"><span class="lineno"> 216</span> returnCode = ssh_channel_request_exec(channel, command);</div>
<div class="line"><span class="lineno"> 217</span> <span class="keywordflow">if</span>(returnCode != SSH_OK){</div>
<div class="line"><span class="lineno"> 218</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#af21596945a4d9ac142fe4cfef53e7a80">ARC_ERRNO_DATA</a>;</div>
<div class="line"><span class="lineno"> 219</span> ARC_DEBUG_LOG(<a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a>, <span class="stringliteral">&quot;ARC_Ssh_RunInSession(ssh, sessionFn), ssh failed when executing command with error code: %d\n&quot;</span>, returnCode);</div>
<div class="line"><span class="lineno"> 220</span> }</div>
<div class="line"><span class="lineno"> 221</span> </div>
<div class="line"><span class="lineno"> 222</span> ssh_channel_send_eof(channel);</div>
<div class="line"><span class="lineno"> 223</span> ssh_channel_close(channel);</div>
<div class="line"><span class="lineno"> 224</span> ssh_channel_free(channel);</div>
<div class="line"><span class="lineno"> 225</span>}</div>
<div class="ttc" id="aerrno_8h_html_af21596945a4d9ac142fe4cfef53e7a80"><div class="ttname"><a href="../../d8/dc2/errno_8h.html#af21596945a4d9ac142fe4cfef53e7a80">ARC_ERRNO_DATA</a></div><div class="ttdeci">#define ARC_ERRNO_DATA</div><div class="ttdef"><b>Definition</b> <a href="../../d8/dc2/errno_8h_source.html#l00007">errno.h:7</a></div></div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="../../d0/d90/errno_8c_source.html#l00005">arc_errno</a>, <a class="el" href="../../d8/dc2/errno_8h_source.html#l00012">ARC_ERRNO_CONNECTION</a>, <a class="el" href="../../d8/dc2/errno_8h_source.html#l00007">ARC_ERRNO_DATA</a>, <a class="el" href="../../d8/dc2/errno_8h_source.html#l00006">ARC_ERRNO_NULL</a>, and <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00012">ARC_Ssh::session</a>.</p>
</div>
</div>
<a id="a1cc4737620480eb72a38fd0bbc84a9d2" name="a1cc4737620480eb72a38fd0bbc84a9d2"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a1cc4737620480eb72a38fd0bbc84a9d2">&#9670;&#160;</a></span>ARC_Ssh_ExecStrInNewSessionAndGetResponse()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="../../df/d06/structARC__String.html">ARC_String</a> * ARC_Ssh_ExecStrInNewSessionAndGetResponse </td>
<td>(</td>
<td class="paramtype"><a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> *</td> <td class="paramname"><span class="paramname"><em>ssh</em></span>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char *</td> <td class="paramname"><span class="paramname"><em>command</em></span>&#160;)</td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00227">227</a> of file <a class="el" href="../../d7/dfb/ssh_8c_source.html">ssh.c</a>.</p>
<div class="fragment"><div class="line"><span class="lineno"> 227</span> {</div>
<div class="line"><span class="lineno"> 228</span> ssh_channel channel;</div>
<div class="line"><span class="lineno"> 229</span> channel = ssh_channel_new(ssh-&gt;<a class="code hl_variable" href="../../d8/d43/structARC__Ssh.html#acb504a5b1323711e58cc0fd66ac30dda">session</a>);</div>
<div class="line"><span class="lineno"> 230</span> <span class="keywordflow">if</span>(channel == NULL){</div>
<div class="line"><span class="lineno"> 231</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#ab626cdbbebc1ac9abd1548a5f6f6195b">ARC_ERRNO_NULL</a>;</div>
<div class="line"><span class="lineno"> 232</span> ARC_DEBUG_ERR(<span class="stringliteral">&quot;ARC_Ssh_RunInSession(ssh, sessionFn), ssh failed to create channel\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 233</span> <span class="keywordflow">return</span> NULL;</div>
<div class="line"><span class="lineno"> 234</span> }</div>
<div class="line"><span class="lineno"> 235</span> </div>
<div class="line"><span class="lineno"> 236</span> int32_t returnCode = ssh_channel_open_session(channel);</div>
<div class="line"><span class="lineno"> 237</span> <span class="keywordflow">if</span>(returnCode != SSH_OK){</div>
<div class="line"><span class="lineno"> 238</span> ssh_channel_free(channel);</div>
<div class="line"><span class="lineno"> 239</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#a12df35ef61d8cceea6360b586d09e5d1">ARC_ERRNO_CONNECTION</a>;</div>
<div class="line"><span class="lineno"> 240</span> ARC_DEBUG_LOG(<a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a>, <span class="stringliteral">&quot;ARC_Ssh_RunInSession(ssh, sessionFn), ssh failed to open session with return code: %d\n&quot;</span>, returnCode);</div>
<div class="line"><span class="lineno"> 241</span> <span class="keywordflow">return</span> NULL;</div>
<div class="line"><span class="lineno"> 242</span> }</div>
<div class="line"><span class="lineno"> 243</span> </div>
<div class="line"><span class="lineno"> 244</span> returnCode = ssh_channel_request_exec(channel, command);</div>
<div class="line"><span class="lineno"> 245</span> <span class="keywordflow">if</span>(returnCode != SSH_OK){</div>
<div class="line"><span class="lineno"> 246</span> ssh_channel_close(channel);</div>
<div class="line"><span class="lineno"> 247</span> ssh_channel_free(channel);</div>
<div class="line"><span class="lineno"> 248</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#af21596945a4d9ac142fe4cfef53e7a80">ARC_ERRNO_DATA</a>;</div>
<div class="line"><span class="lineno"> 249</span> ARC_DEBUG_LOG(<a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a>, <span class="stringliteral">&quot;ARC_Ssh_RunInSession(ssh, sessionFn), ssh failed when executing command with error code: %d\n&quot;</span>, returnCode);</div>
<div class="line"><span class="lineno"> 250</span> <span class="keywordflow">return</span> NULL;</div>
<div class="line"><span class="lineno"> 251</span> }</div>
<div class="line"><span class="lineno"> 252</span> </div>
<div class="line"><span class="lineno"> 253</span> <span class="comment">//this is taken from https://api.libssh.org/master/libssh_tutor_command.html</span></div>
<div class="line"><span class="lineno"> 254</span> <span class="keywordtype">char</span> buffer[256];</div>
<div class="line"><span class="lineno"> 255</span> int32_t bytesSize;</div>
<div class="line"><span class="lineno"> 256</span> </div>
<div class="line"><span class="lineno"> 257</span> <a class="code hl_struct" href="../../df/d06/structARC__String.html">ARC_String</a> *returnString = NULL;</div>
<div class="line"><span class="lineno"> 258</span> </div>
<div class="line"><span class="lineno"> 259</span> bytesSize = ssh_channel_read(channel, buffer, <span class="keyword">sizeof</span>(buffer), 0);</div>
<div class="line"><span class="lineno"> 260</span> <span class="keywordflow">while</span>(bytesSize &gt; 0){</div>
<div class="line"><span class="lineno"> 261</span> <span class="keywordflow">if</span>(returnString == NULL){</div>
<div class="line"><span class="lineno"> 262</span> <a class="code hl_function" href="../../da/d66/string_8h.html#a709d2bb4b120569a636e0afdf5e8f1d0">ARC_String_Create</a>(&amp;returnString, buffer, bytesSize);</div>
<div class="line"><span class="lineno"> 263</span> </div>
<div class="line"><span class="lineno"> 264</span> bytesSize = ssh_channel_read(channel, buffer, <span class="keyword">sizeof</span>(buffer), 0);</div>
<div class="line"><span class="lineno"> 265</span> <span class="keywordflow">continue</span>;</div>
<div class="line"><span class="lineno"> 266</span> }</div>
<div class="line"><span class="lineno"> 267</span> </div>
<div class="line"><span class="lineno"> 268</span> <a class="code hl_function" href="../../da/d66/string_8h.html#a62f1a304befda4abb8258f760489c3a3">ARC_String_AppendCString</a>(&amp;returnString, (<span class="keyword">const</span> <span class="keywordtype">char</span> *)buffer, bytesSize);</div>
<div class="line"><span class="lineno"> 269</span> </div>
<div class="line"><span class="lineno"> 270</span> bytesSize = ssh_channel_read(channel, buffer, <span class="keyword">sizeof</span>(buffer), 0);</div>
<div class="line"><span class="lineno"> 271</span> }</div>
<div class="line"><span class="lineno"> 272</span> </div>
<div class="line"><span class="lineno"> 273</span> <span class="keywordflow">if</span>(bytesSize &lt; 0){</div>
<div class="line"><span class="lineno"> 274</span> ssh_channel_close(channel);</div>
<div class="line"><span class="lineno"> 275</span> ssh_channel_free(channel);</div>
<div class="line"><span class="lineno"> 276</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#af21596945a4d9ac142fe4cfef53e7a80">ARC_ERRNO_DATA</a>;</div>
<div class="line"><span class="lineno"> 277</span> ARC_DEBUG_ERR(<span class="stringliteral">&quot;ARC_Ssh_RunInSession(ssh, sessionFn), ssh failed when reading bytes from channel\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 278</span> </div>
<div class="line"><span class="lineno"> 279</span> <span class="keywordflow">if</span>(returnString != NULL){</div>
<div class="line"><span class="lineno"> 280</span> <a class="code hl_function" href="../../da/d66/string_8h.html#ac63d17182fd14297f5e7021488d74e35">ARC_String_Destroy</a>(returnString);</div>
<div class="line"><span class="lineno"> 281</span> }</div>
<div class="line"><span class="lineno"> 282</span> </div>
<div class="line"><span class="lineno"> 283</span> <span class="keywordflow">return</span> NULL;</div>
<div class="line"><span class="lineno"> 284</span> }</div>
<div class="line"><span class="lineno"> 285</span> </div>
<div class="line"><span class="lineno"> 286</span> ssh_channel_send_eof(channel);</div>
<div class="line"><span class="lineno"> 287</span> ssh_channel_close(channel);</div>
<div class="line"><span class="lineno"> 288</span> ssh_channel_free(channel);</div>
<div class="line"><span class="lineno"> 289</span> </div>
<div class="line"><span class="lineno"> 290</span> <span class="keywordflow">return</span> returnString;</div>
<div class="line"><span class="lineno"> 291</span>}</div>
<div class="ttc" id="astring_8h_html_a62f1a304befda4abb8258f760489c3a3"><div class="ttname"><a href="../../da/d66/string_8h.html#a62f1a304befda4abb8258f760489c3a3">ARC_String_AppendCString</a></div><div class="ttdeci">void ARC_String_AppendCString(ARC_String **string, const char *cstring, uint64_t length)</div><div class="ttdoc">appends to an ARC_String with an ARC_String</div><div class="ttdef"><b>Definition</b> <a href="../../d1/db0/string_8c_source.html#l00130">string.c:130</a></div></div>
<div class="ttc" id="astring_8h_html_a709d2bb4b120569a636e0afdf5e8f1d0"><div class="ttname"><a href="../../da/d66/string_8h.html#a709d2bb4b120569a636e0afdf5e8f1d0">ARC_String_Create</a></div><div class="ttdeci">void ARC_String_Create(ARC_String **string, char *data, uint64_t length)</div><div class="ttdoc">creates ARC_String type</div><div class="ttdef"><b>Definition</b> <a href="../../d1/db0/string_8c_source.html#l00009">string.c:9</a></div></div>
<div class="ttc" id="astring_8h_html_ac63d17182fd14297f5e7021488d74e35"><div class="ttname"><a href="../../da/d66/string_8h.html#ac63d17182fd14297f5e7021488d74e35">ARC_String_Destroy</a></div><div class="ttdeci">void ARC_String_Destroy(ARC_String *string)</div><div class="ttdoc">destroys ARC_String type</div><div class="ttdef"><b>Definition</b> <a href="../../d1/db0/string_8c_source.html#l00052">string.c:52</a></div></div>
<div class="ttc" id="astructARC__String_html"><div class="ttname"><a href="../../df/d06/structARC__String.html">ARC_String</a></div><div class="ttdoc">substring position within a string</div><div class="ttdef"><b>Definition</b> <a href="../../da/d66/string_8h_source.html#l00014">string.h:14</a></div></div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="../../d0/d90/errno_8c_source.html#l00005">arc_errno</a>, <a class="el" href="../../d8/dc2/errno_8h_source.html#l00012">ARC_ERRNO_CONNECTION</a>, <a class="el" href="../../d8/dc2/errno_8h_source.html#l00007">ARC_ERRNO_DATA</a>, <a class="el" href="../../d8/dc2/errno_8h_source.html#l00006">ARC_ERRNO_NULL</a>, <a class="el" href="../../d1/db0/string_8c_source.html#l00130">ARC_String_AppendCString()</a>, <a class="el" href="../../d1/db0/string_8c_source.html#l00009">ARC_String_Create()</a>, <a class="el" href="../../d1/db0/string_8c_source.html#l00052">ARC_String_Destroy()</a>, and <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00012">ARC_Ssh::session</a>.</p>
</div>
</div>
<a id="a611049154ff185c551929068f3d0270a" name="a611049154ff185c551929068f3d0270a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a611049154ff185c551929068f3d0270a">&#9670;&#160;</a></span>ARC_Ssh_RunInSession()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void ARC_Ssh_RunInSession </td>
<td>(</td>
<td class="paramtype"><a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> *</td> <td class="paramname"><span class="paramname"><em>ssh</em></span>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="../../d8/dd3/ssh_8h.html#aa6f481c13aec410d0902c4f9a5d94e9b">ARC_Ssh_SessionFn</a></td> <td class="paramname"><span class="paramname"><em>sessionFn</em></span>&#160;)</td>
</tr>
</table>
</div><div class="memdoc">
<p>runs a callback function within a ssh session </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">ssh</td><td><a class="el" href="../../d8/d43/structARC__Ssh.html">ARC_Ssh</a> to create and run function in ssh session </td></tr>
<tr><td class="paramname">sessionFN</td><td>callback to run in a ssh session </td></tr>
</table>
</dd>
</dl>
<p class="definition">Definition at line <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00172">172</a> of file <a class="el" href="../../d7/dfb/ssh_8c_source.html">ssh.c</a>.</p>
<div class="fragment"><div class="line"><span class="lineno"> 172</span> {</div>
<div class="line"><span class="lineno"> 173</span> ssh_channel channel;</div>
<div class="line"><span class="lineno"> 174</span> </div>
<div class="line"><span class="lineno"> 175</span> channel = ssh_channel_new(ssh-&gt;<a class="code hl_variable" href="../../d8/d43/structARC__Ssh.html#acb504a5b1323711e58cc0fd66ac30dda">session</a>);</div>
<div class="line"><span class="lineno"> 176</span> <span class="keywordflow">if</span>(channel == NULL){</div>
<div class="line"><span class="lineno"> 177</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#ab626cdbbebc1ac9abd1548a5f6f6195b">ARC_ERRNO_NULL</a>;</div>
<div class="line"><span class="lineno"> 178</span> ARC_DEBUG_ERR(<span class="stringliteral">&quot;ARC_Ssh_RunInSession(ssh, sessionFn), ssh failed to create channel\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 179</span> <span class="keywordflow">return</span>;</div>
<div class="line"><span class="lineno"> 180</span> }</div>
<div class="line"><span class="lineno"> 181</span> </div>
<div class="line"><span class="lineno"> 182</span> int32_t returnCode = ssh_channel_open_session(channel);</div>
<div class="line"><span class="lineno"> 183</span> <span class="keywordflow">if</span>(returnCode != SSH_OK){</div>
<div class="line"><span class="lineno"> 184</span> ssh_channel_free(channel);</div>
<div class="line"><span class="lineno"> 185</span> <a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a> = <a class="code hl_define" href="../../d8/dc2/errno_8h.html#a12df35ef61d8cceea6360b586d09e5d1">ARC_ERRNO_CONNECTION</a>;</div>
<div class="line"><span class="lineno"> 186</span> ARC_DEBUG_LOG(<a class="code hl_variable" href="../../d8/dc2/errno_8h.html#a5884aa8cc9b4e733345e49f93b54f75a">arc_errno</a>, <span class="stringliteral">&quot;ARC_Ssh_RunInSession(ssh, sessionFn), ssh failed to open session with return code: %d\n&quot;</span>, returnCode);</div>
<div class="line"><span class="lineno"> 187</span> <span class="keywordflow">return</span>;</div>
<div class="line"><span class="lineno"> 188</span> }</div>
<div class="line"><span class="lineno"> 189</span> </div>
<div class="line"><span class="lineno"> 190</span> <span class="comment">// sessionFn(ssh, );</span></div>
<div class="line"><span class="lineno"> 191</span> returnCode = ssh_channel_request_exec(channel, <span class="stringliteral">&quot;export DISPLAY=:0 ; volume --inc&quot;</span>);</div>
<div class="line"><span class="lineno"> 192</span> printf(<span class="stringliteral">&quot;return code: %d\n&quot;</span>, returnCode);</div>
<div class="line"><span class="lineno"> 193</span> </div>
<div class="line"><span class="lineno"> 194</span> ssh_channel_send_eof(channel);</div>
<div class="line"><span class="lineno"> 195</span> ssh_channel_close(channel);</div>
<div class="line"><span class="lineno"> 196</span> ssh_channel_free(channel);</div>
<div class="line"><span class="lineno"> 197</span>}</div>
</div><!-- fragment -->
<p class="reference">References <a class="el" href="../../d0/d90/errno_8c_source.html#l00005">arc_errno</a>, <a class="el" href="../../d8/dc2/errno_8h_source.html#l00012">ARC_ERRNO_CONNECTION</a>, <a class="el" href="../../d8/dc2/errno_8h_source.html#l00006">ARC_ERRNO_NULL</a>, and <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00012">ARC_Ssh::session</a>.</p>
</div>
</div>
<a id="ad5d8ab97d3635ecaf8fa78225cb960fb" name="ad5d8ab97d3635ecaf8fa78225cb960fb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad5d8ab97d3635ecaf8fa78225cb960fb">&#9670;&#160;</a></span>verify_knownhost()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int verify_knownhost </td>
<td>(</td>
<td class="paramtype">ssh_session</td> <td class="paramname"><span class="paramname"><em>session</em></span></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p class="definition">Definition at line <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00015">15</a> of file <a class="el" href="../../d7/dfb/ssh_8c_source.html">ssh.c</a>.</p>
<div class="fragment"><div class="line"><span class="lineno"> 15</span> {</div>
<div class="line"><span class="lineno"> 16</span> <span class="keyword">enum</span> ssh_known_hosts_e state;</div>
<div class="line"><span class="lineno"> 17</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *hash = NULL;</div>
<div class="line"><span class="lineno"> 18</span> ssh_key srv_pubkey = NULL;</div>
<div class="line"><span class="lineno"> 19</span> <span class="keywordtype">size_t</span> hlen;</div>
<div class="line"><span class="lineno"> 20</span> <span class="keywordtype">char</span> buf[10];</div>
<div class="line"><span class="lineno"> 21</span> <span class="keywordtype">char</span> *hexa;</div>
<div class="line"><span class="lineno"> 22</span> <span class="keywordtype">char</span> *p;</div>
<div class="line"><span class="lineno"> 23</span> <span class="keywordtype">int</span> cmp;</div>
<div class="line"><span class="lineno"> 24</span> <span class="keywordtype">int</span> rc;</div>
<div class="line"><span class="lineno"> 25</span> </div>
<div class="line"><span class="lineno"> 26</span> rc = ssh_get_server_publickey(session, &amp;srv_pubkey);</div>
<div class="line"><span class="lineno"> 27</span> <span class="keywordflow">if</span>(rc &lt; 0){</div>
<div class="line"><span class="lineno"> 28</span> <span class="keywordflow">return</span> -1;</div>
<div class="line"><span class="lineno"> 29</span> }</div>
<div class="line"><span class="lineno"> 30</span> </div>
<div class="line"><span class="lineno"> 31</span> rc = ssh_get_publickey_hash(srv_pubkey, SSH_PUBLICKEY_HASH_SHA1, &amp;hash, &amp;hlen);</div>
<div class="line"><span class="lineno"> 32</span> ssh_key_free(srv_pubkey);</div>
<div class="line"><span class="lineno"> 33</span> <span class="keywordflow">if</span>(rc &lt; 0){</div>
<div class="line"><span class="lineno"> 34</span> <span class="keywordflow">return</span> -1;</div>
<div class="line"><span class="lineno"> 35</span> }</div>
<div class="line"><span class="lineno"> 36</span> </div>
<div class="line"><span class="lineno"> 37</span> state = ssh_session_is_known_server(session);</div>
<div class="line"><span class="lineno"> 38</span> <span class="keywordflow">switch</span>(state){</div>
<div class="line"><span class="lineno"> 39</span> <span class="keywordflow">case</span> SSH_KNOWN_HOSTS_OK:</div>
<div class="line"><span class="lineno"> 40</span> <span class="comment">/* OK */</span></div>
<div class="line"><span class="lineno"> 41</span> <span class="keywordflow">break</span>;</div>
<div class="line"><span class="lineno"> 42</span> </div>
<div class="line"><span class="lineno"> 43</span> <span class="keywordflow">case</span> SSH_KNOWN_HOSTS_CHANGED:</div>
<div class="line"><span class="lineno"> 44</span> fprintf(stderr, <span class="stringliteral">&quot;Host key for server changed: it is now:\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 45</span> <span class="comment">//ssh_print_hexa(&quot;Public key hash&quot;, hash, hlen);</span></div>
<div class="line"><span class="lineno"> 46</span> fprintf(stderr, <span class="stringliteral">&quot;For security reasons, connection will be stopped\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 47</span> ssh_clean_pubkey_hash(&amp;hash);</div>
<div class="line"><span class="lineno"> 48</span> <span class="keywordflow">return</span> -1;</div>
<div class="line"><span class="lineno"> 49</span> </div>
<div class="line"><span class="lineno"> 50</span> <span class="keywordflow">case</span> SSH_KNOWN_HOSTS_OTHER:</div>
<div class="line"><span class="lineno"> 51</span> fprintf(stderr, <span class="stringliteral">&quot;The host key for this server was not found but an other type of key exists.\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 52</span> fprintf(stderr, <span class="stringliteral">&quot;An attacker might change the default server key to confuse your client into thinking the key does not exist\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 53</span> ssh_clean_pubkey_hash(&amp;hash);</div>
<div class="line"><span class="lineno"> 54</span> <span class="keywordflow">return</span> -1;</div>
<div class="line"><span class="lineno"> 55</span> </div>
<div class="line"><span class="lineno"> 56</span> <span class="keywordflow">case</span> SSH_KNOWN_HOSTS_NOT_FOUND:</div>
<div class="line"><span class="lineno"> 57</span> fprintf(stderr, <span class="stringliteral">&quot;Could not find known host file.\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 58</span> fprintf(stderr, <span class="stringliteral">&quot;If you accept the host key here, the file will be automatically created.\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 59</span> <span class="comment">/* FALL THROUGH to SSH_SERVER_NOT_KNOWN behavior */</span></div>
<div class="line"><span class="lineno"> 60</span> </div>
<div class="line"><span class="lineno"> 61</span> <span class="keywordflow">case</span> SSH_KNOWN_HOSTS_UNKNOWN:</div>
<div class="line"><span class="lineno"> 62</span> hexa = ssh_get_hexa(hash, hlen);</div>
<div class="line"><span class="lineno"> 63</span> fprintf(stderr,<span class="stringliteral">&quot;The server is unknown. Do you trust the host key?\n&quot;</span>);</div>
<div class="line"><span class="lineno"> 64</span> fprintf(stderr, <span class="stringliteral">&quot;Public key hash: %s\n&quot;</span>, hexa);</div>
<div class="line"><span class="lineno"> 65</span> ssh_string_free_char(hexa);</div>
<div class="line"><span class="lineno"> 66</span> ssh_clean_pubkey_hash(&amp;hash);</div>
<div class="line"><span class="lineno"> 67</span> p = fgets(buf, <span class="keyword">sizeof</span>(buf), stdin);</div>
<div class="line"><span class="lineno"> 68</span> <span class="keywordflow">if</span>(p == NULL){</div>
<div class="line"><span class="lineno"> 69</span> <span class="keywordflow">return</span> -1;</div>
<div class="line"><span class="lineno"> 70</span> }</div>
<div class="line"><span class="lineno"> 71</span> </div>
<div class="line"><span class="lineno"> 72</span> cmp = strncasecmp(buf, <span class="stringliteral">&quot;yes&quot;</span>, 3);</div>
<div class="line"><span class="lineno"> 73</span> <span class="keywordflow">if</span>(cmp != 0){</div>
<div class="line"><span class="lineno"> 74</span> <span class="keywordflow">return</span> -1;</div>
<div class="line"><span class="lineno"> 75</span> }</div>
<div class="line"><span class="lineno"> 76</span> </div>
<div class="line"><span class="lineno"> 77</span> rc = ssh_session_update_known_hosts(session);</div>
<div class="line"><span class="lineno"> 78</span> <span class="keywordflow">if</span>(rc &lt; 0){</div>
<div class="line"><span class="lineno"> 79</span> fprintf(stderr, <span class="stringliteral">&quot;Error %s\n&quot;</span>, strerror(errno));</div>
<div class="line"><span class="lineno"> 80</span> <span class="keywordflow">return</span> -1;</div>
<div class="line"><span class="lineno"> 81</span> }</div>
<div class="line"><span class="lineno"> 82</span> <span class="keywordflow">break</span>;</div>
<div class="line"><span class="lineno"> 83</span> </div>
<div class="line"><span class="lineno"> 84</span> <span class="keywordflow">case</span> SSH_KNOWN_HOSTS_ERROR:</div>
<div class="line"><span class="lineno"> 85</span> fprintf(stderr, <span class="stringliteral">&quot;Error %s&quot;</span>, ssh_get_error(session));</div>
<div class="line"><span class="lineno"> 86</span> ssh_clean_pubkey_hash(&amp;hash);</div>
<div class="line"><span class="lineno"> 87</span> <span class="keywordflow">return</span> -1;</div>
<div class="line"><span class="lineno"> 88</span> }</div>
<div class="line"><span class="lineno"> 89</span> </div>
<div class="line"><span class="lineno"> 90</span> ssh_clean_pubkey_hash(&amp;hash);</div>
<div class="line"><span class="lineno"> 91</span> <span class="keywordflow">return</span> 0;</div>
<div class="line"><span class="lineno"> 92</span>}</div>
</div><!-- fragment -->
<p class="reference">Referenced by <a class="el" href="../../d7/dfb/ssh_8c_source.html#l00094">ARC_Ssh_Create()</a>.</p>
</div>
</div>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- HTML footer for doxygen 1.9.2-->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul><li class="navelem"><a class="el" href="../../dir_93501a11e921083efbd154e0cdff5f10.html">packages</a></li><li class="navelem"><a class="el" href="../../dir_6d4706c88628d101f934aaf13e871b17.html">networking</a></li><li class="navelem"><a class="el" href="../../dir_4e7df8a09b2bea044f947dc813dc17f8.html">libssh</a></li><li class="navelem"><a class="el" href="../../d7/dfb/ssh_8c.html">ssh.c</a></li></ul>
</div>
<script type="text/javascript">
// script for doxygen 1.9.1
$(function() {
toggleButton = document.createElement('doxygen-awesome-dark-mode-toggle')
toggleButton.title = "Toggle Light/Dark Mode"
$(document).ready(function(){
document.getElementById("MSearchBox").parentNode.appendChild(toggleButton)
})
$(window).resize(function(){
document.getElementById("MSearchBox").parentNode.appendChild(toggleButton)
})
})
</script>
</body>
</html>
Reference in a new issue View git blame Copy permalink