Baoding-FenShuaJiang
/
Green_GoodERP18_FSJ_Standard
Прати 1
Волим 0
Вики 捐赠
gooderp18绿色标准版
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Дрво: 0f75e31513
Гране Ознаке
${ item.name }
Create branch ${ searchTerm }
from '0f75e31513'
${ noResults }
Green_GoodERP18_FSJ_Standard/python/Doc/html/library/telnetlib.html

582 lines
41KB
Датотека Blame Историја 

  1. <!DOCTYPE html>

  2. 

  3. <html lang="en" data-content_root="../">

  4.   <head>

  5.     <meta charset="utf-8" />

  6.     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />

  7. <meta property="og:title" content="telnetlib — Telnet client" />

  8. <meta property="og:type" content="website" />

  9. <meta property="og:url" content="https://docs.python.org/3/library/telnetlib.html" />

  10. <meta property="og:site_name" content="Python documentation" />

  11. <meta property="og:description" content="Source code: Lib/telnetlib.py The telnetlib module provides a Telnet class that implements the Telnet protocol. See RFC 854 for details about the protocol. In addition, it provides symbolic constan..." />

  12. <meta property="og:image" content="https://docs.python.org/3/_static/og-image.png" />

  13. <meta property="og:image:alt" content="Python documentation" />

  14. <meta name="description" content="Source code: Lib/telnetlib.py The telnetlib module provides a Telnet class that implements the Telnet protocol. See RFC 854 for details about the protocol. In addition, it provides symbolic constan..." />

  15. <meta property="og:image:width" content="200" />

  16. <meta property="og:image:height" content="200" />

  17. <meta name="theme-color" content="#3776ab" />

  18. 

  19.     <title>telnetlib — Telnet client &#8212; Python 3.12.3 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0">

  20.     

  21.     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />

  22.     <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=bb723527" />

  23.     <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=b20cc3f5" />

  24.     

  25.     <script src="../_static/documentation_options.js?v=2c828074"></script>

  26.     <script src="../_static/doctools.js?v=888ff710"></script>

  27.     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>

  28.     

  29.     <script src="../_static/sidebar.js"></script>

  30.     

  31.     <link rel="search" type="application/opensearchdescription+xml"

  32.           title="Search within Python 3.12.3 documentation"

  33.           href="../_static/opensearch.xml"/>

  34.     <link rel="author" title="About these documents" href="../about.html" />

  35.     <link rel="index" title="Index" href="../genindex.html" />

  36.     <link rel="search" title="Search" href="../search.html" />

  37.     <link rel="copyright" title="Copyright" href="../copyright.html" />

  38.     <link rel="next" title="uu — Encode and decode uuencode files" href="uu.html" />

  39.     <link rel="prev" title="sunau — Read and write Sun AU files" href="sunau.html" />

  40.     <link rel="canonical" href="https://docs.python.org/3/library/telnetlib.html" />

  41.     

  42.       

  43.     

  44. 

  45.     

  46.     <style>

  47.       @media only screen {

  48.         table.full-width-table {

  49.             width: 100%;

  50.         }

  51.       }

  52.     </style>

  53. <link rel="stylesheet" href="../_static/pydoctheme_dark.css" media="(prefers-color-scheme: dark)" id="pydoctheme_dark_css">

  54.     <link rel="shortcut icon" type="image/png" href="../_static/py.svg" />

  55.             <script type="text/javascript" src="../_static/copybutton.js"></script>

  56.             <script type="text/javascript" src="../_static/menu.js"></script>

  57.             <script type="text/javascript" src="../_static/search-focus.js"></script>

  58.             <script type="text/javascript" src="../_static/themetoggle.js"></script> 

  59. 

  60.   </head>

  61. <body>

  62. <div class="mobile-nav">

  63.     <input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"

  64.            aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu" />

  65.     <nav class="nav-content" role="navigation">

  66.         <label for="menuToggler" class="toggler__label">

  67.             <span></span>

  68.         </label>

  69.         <span class="nav-items-wrapper">

  70.             <a href="https://www.python.org/" class="nav-logo">

  71.                 <img src="../_static/py.svg" alt="Python logo"/>

  72.             </a>

  73.             <span class="version_switcher_placeholder"></span>

  74.             <form role="search" class="search" action="../search.html" method="get">

  75.                 <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" class="search-icon">

  76.                     <path fill-rule="nonzero" fill="currentColor" d="M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z"></path>

  77.                 </svg>

  78.                 <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" />

  79.                 <input type="submit" value="Go"/>

  80.             </form>

  81.         </span>

  82.     </nav>

  83.     <div class="menu-wrapper">

  84.         <nav class="menu" role="navigation" aria-label="main navigation">

  85.             <div class="language_switcher_placeholder"></div>

  86.             

  87. <label class="theme-selector-label">

  88.     Theme

  89.     <select class="theme-selector" oninput="activateTheme(this.value)">

  90.         <option value="auto" selected>Auto</option>

  91.         <option value="light">Light</option>

  92.         <option value="dark">Dark</option>

  93.     </select>

  94. </label>

  95.   <div>

  96.     <h3><a href="../contents.html">Table of Contents</a></h3>

  97.     <ul>

  98. <li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate"><span class="pre">telnetlib</span></code> — Telnet client</a><ul>

  99. <li><a class="reference internal" href="#telnet-objects">Telnet Objects</a></li>

  100. <li><a class="reference internal" href="#telnet-example">Telnet Example</a></li>

  101. </ul>

  102. </li>

  103. </ul>

  104. 

  105.   </div>

  106.   <div>

  107.     <h4>Previous topic</h4>

  108.     <p class="topless"><a href="sunau.html"

  109.                           title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">sunau</span></code> — Read and write Sun AU files</a></p>

  110.   </div>

  111.   <div>

  112.     <h4>Next topic</h4>

  113.     <p class="topless"><a href="uu.html"

  114.                           title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">uu</span></code> — Encode and decode uuencode files</a></p>

  115.   </div>

  116.   <div role="note" aria-label="source link">

  117.     <h3>This Page</h3>

  118.     <ul class="this-page-menu">

  119.       <li><a href="../bugs.html">Report a Bug</a></li>

  120.       <li>

  121.         <a href="https://github.com/python/cpython/blob/main/Doc/library/telnetlib.rst"

  122.             rel="nofollow">Show Source

  123.         </a>

  124.       </li>

  125.     </ul>

  126.   </div>

  127.         </nav>

  128.     </div>

  129. </div>

  130. 

  131.   

  132.     <div class="related" role="navigation" aria-label="related navigation">

  133.       <h3>Navigation</h3>

  134.       <ul>

  135.         <li class="right" style="margin-right: 10px">

  136.           <a href="../genindex.html" title="General Index"

  137.              accesskey="I">index</a></li>

  138.         <li class="right" >

  139.           <a href="../py-modindex.html" title="Python Module Index"

  140.              >modules</a> |</li>

  141.         <li class="right" >

  142.           <a href="uu.html" title="uu — Encode and decode uuencode files"

  143.              accesskey="N">next</a> |</li>

  144.         <li class="right" >

  145.           <a href="sunau.html" title="sunau — Read and write Sun AU files"

  146.              accesskey="P">previous</a> |</li>

  147. 

  148.           <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>

  149.           <li><a href="https://www.python.org/">Python</a> &#187;</li>

  150.           <li class="switchers">

  151.             <div class="language_switcher_placeholder"></div>

  152.             <div class="version_switcher_placeholder"></div>

  153.           </li>

  154.           <li>

  155.               

  156.           </li>

  157.     <li id="cpython-language-and-version">

  158.       <a href="../index.html">3.12.3 Documentation</a> &#187;

  159.     </li>

  160. 

  161.           <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>

  162.           <li class="nav-item nav-item-2"><a href="superseded.html" accesskey="U">Superseded Modules</a> &#187;</li>

  163.         <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate"><span class="pre">telnetlib</span></code> — Telnet client</a></li>

  164.                 <li class="right">

  165.                     

  166. 

  167.     <div class="inline-search" role="search">

  168.         <form class="inline-search" action="../search.html" method="get">

  169.           <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />

  170.           <input type="submit" value="Go" />

  171.         </form>

  172.     </div>

  173.                      |

  174.                 </li>

  175.             <li class="right">

  176. <label class="theme-selector-label">

  177.     Theme

  178.     <select class="theme-selector" oninput="activateTheme(this.value)">

  179.         <option value="auto" selected>Auto</option>

  180.         <option value="light">Light</option>

  181.         <option value="dark">Dark</option>

  182.     </select>

  183. </label> |</li>

  184.             

  185.       </ul>

  186.     </div>    

  187. 

  188.     <div class="document">

  189.       <div class="documentwrapper">

  190.         <div class="bodywrapper">

  191.           <div class="body" role="main">

  192.             

  193.   <section id="module-telnetlib">

  194. <span id="telnetlib-telnet-client"></span><h1><a class="reference internal" href="#module-telnetlib" title="telnetlib: Telnet client class. (deprecated)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">telnetlib</span></code></a> — Telnet client<a class="headerlink" href="#module-telnetlib" title="Link to this heading">¶</a></h1>

  195. <p><strong>Source code:</strong> <a class="reference external" href="https://github.com/python/cpython/tree/3.12/Lib/telnetlib.py">Lib/telnetlib.py</a></p>

  196. <div class="deprecated-removed" id="index-0">

  197. <p><span class="versionmodified">Deprecated since version 3.11, will be removed in version 3.13: </span>The <a class="reference internal" href="#module-telnetlib" title="telnetlib: Telnet client class. (deprecated)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">telnetlib</span></code></a> module is deprecated

  198. (see <span class="target" id="index-1"></span><a class="pep reference external" href="https://peps.python.org/pep-0594/#telnetlib"><strong>PEP 594</strong></a> for details and alternatives).</p>

  199. </div>

  200. <hr class="docutils" />

  201. <p>The <a class="reference internal" href="#module-telnetlib" title="telnetlib: Telnet client class. (deprecated)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">telnetlib</span></code></a> module provides a <a class="reference internal" href="#telnetlib.Telnet" title="telnetlib.Telnet"><code class="xref py py-class docutils literal notranslate"><span class="pre">Telnet</span></code></a> class that implements the

  202. Telnet protocol.  See <span class="target" id="index-2"></span><a class="rfc reference external" href="https://datatracker.ietf.org/doc/html/rfc854.html"><strong>RFC 854</strong></a> for details about the protocol. In addition, it

  203. provides symbolic constants for the protocol characters (see below), and for the

  204. telnet options. The symbolic names of the telnet options follow the definitions

  205. in <code class="docutils literal notranslate"><span class="pre">arpa/telnet.h</span></code>, with the leading <code class="docutils literal notranslate"><span class="pre">TELOPT_</span></code> removed. For symbolic names

  206. of options which are traditionally not included in <code class="docutils literal notranslate"><span class="pre">arpa/telnet.h</span></code>, see the

  207. module source itself.</p>

  208. <p>The symbolic constants for the telnet commands are: IAC, DONT, DO, WONT, WILL,

  209. SE (Subnegotiation End), NOP (No Operation), DM (Data Mark), BRK (Break), IP

  210. (Interrupt process), AO (Abort output), AYT (Are You There), EC (Erase

  211. Character), EL (Erase Line), GA (Go Ahead), SB (Subnegotiation Begin).</p>

  212. <div class="availability docutils container">

  213. <p><a class="reference internal" href="intro.html#availability"><span class="std std-ref">Availability</span></a>: not Emscripten, not WASI.</p>

  214. <p>This module does not work or is not available on WebAssembly platforms

  215. <code class="docutils literal notranslate"><span class="pre">wasm32-emscripten</span></code> and <code class="docutils literal notranslate"><span class="pre">wasm32-wasi</span></code>. See

  216. <a class="reference internal" href="intro.html#wasm-availability"><span class="std std-ref">WebAssembly platforms</span></a> for more information.</p>

  217. </div>

  218. <dl class="py class">

  219. <dt class="sig sig-object py" id="telnetlib.Telnet">

  220. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">telnetlib.</span></span><span class="sig-name descname"><span class="pre">Telnet</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">host=None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">port=0</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">timeout</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet" title="Link to this definition">¶</a></dt>

  221. <dd><p><a class="reference internal" href="#telnetlib.Telnet" title="telnetlib.Telnet"><code class="xref py py-class docutils literal notranslate"><span class="pre">Telnet</span></code></a> represents a connection to a Telnet server. The instance is

  222. initially not connected by default; the <a class="reference internal" href="#telnetlib.Telnet.open" title="telnetlib.Telnet.open"><code class="xref py py-meth docutils literal notranslate"><span class="pre">open()</span></code></a> method must be used to

  223. establish a connection.  Alternatively, the host name and optional port

  224. number can be passed to the constructor too, in which case the connection to

  225. the server will be established before the constructor returns.  The optional

  226. <em>timeout</em> parameter specifies a timeout in seconds for blocking operations

  227. like the connection attempt (if not specified, the global default timeout

  228. setting will be used).</p>

  229. <p>Do not reopen an already connected instance.</p>

  230. <p>This class has many <code class="xref py py-meth docutils literal notranslate"><span class="pre">read_*()</span></code> methods.  Note that some of them  raise

  231. <a class="reference internal" href="exceptions.html#EOFError" title="EOFError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">EOFError</span></code></a> when the end of the connection is read, because they can return

  232. an empty string for other reasons.  See the individual descriptions below.</p>

  233. <p>A <a class="reference internal" href="#telnetlib.Telnet" title="telnetlib.Telnet"><code class="xref py py-class docutils literal notranslate"><span class="pre">Telnet</span></code></a> object is a context manager and can be used in a

  234. <a class="reference internal" href="../reference/compound_stmts.html#with"><code class="xref std std-keyword docutils literal notranslate"><span class="pre">with</span></code></a> statement.  When the <code class="xref std std-keyword docutils literal notranslate"><span class="pre">with</span></code> block ends, the

  235. <a class="reference internal" href="#telnetlib.Telnet.close" title="telnetlib.Telnet.close"><code class="xref py py-meth docutils literal notranslate"><span class="pre">close()</span></code></a> method is called:</p>

  236. <div class="highlight-python3 notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="kn">from</span> <span class="nn">telnetlib</span> <span class="kn">import</span> <span class="n">Telnet</span>

  237. <span class="gp">&gt;&gt;&gt; </span><span class="k">with</span> <span class="n">Telnet</span><span class="p">(</span><span class="s1">&#39;localhost&#39;</span><span class="p">,</span> <span class="mi">23</span><span class="p">)</span> <span class="k">as</span> <span class="n">tn</span><span class="p">:</span>

  238. <span class="gp">... </span>    <span class="n">tn</span><span class="o">.</span><span class="n">interact</span><span class="p">()</span>

  239. <span class="gp">...</span>

  240. </pre></div>

  241. </div>

  242. <div class="versionchanged">

  243. <p><span class="versionmodified changed">Changed in version 3.6: </span>Context manager support added</p>

  244. </div>

  245. </dd></dl>

  246. 

  247. <div class="admonition seealso">

  248. <p class="admonition-title">See also</p>

  249. <dl class="simple">

  250. <dt><span class="target" id="index-3"></span><a class="rfc reference external" href="https://datatracker.ietf.org/doc/html/rfc854.html"><strong>RFC 854</strong></a> - Telnet Protocol Specification</dt><dd><p>Definition of the Telnet protocol.</p>

  251. </dd>

  252. </dl>

  253. </div>

  254. <section id="telnet-objects">

  255. <span id="id1"></span><h2>Telnet Objects<a class="headerlink" href="#telnet-objects" title="Link to this heading">¶</a></h2>

  256. <p><a class="reference internal" href="#telnetlib.Telnet" title="telnetlib.Telnet"><code class="xref py py-class docutils literal notranslate"><span class="pre">Telnet</span></code></a> instances have the following methods:</p>

  257. <dl class="py method">

  258. <dt class="sig sig-object py" id="telnetlib.Telnet.read_until">

  259. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">read_until</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">expected</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">timeout</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.read_until" title="Link to this definition">¶</a></dt>

  260. <dd><p>Read until a given byte string, <em>expected</em>, is encountered or until <em>timeout</em>

  261. seconds have passed.</p>

  262. <p>When no match is found, return whatever is available instead, possibly empty

  263. bytes.  Raise <a class="reference internal" href="exceptions.html#EOFError" title="EOFError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">EOFError</span></code></a> if the connection is closed and no cooked data

  264. is available.</p>

  265. </dd></dl>

  266. 

  267. <dl class="py method">

  268. <dt class="sig sig-object py" id="telnetlib.Telnet.read_all">

  269. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">read_all</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.read_all" title="Link to this definition">¶</a></dt>

  270. <dd><p>Read all data until EOF as bytes; block until connection closed.</p>

  271. </dd></dl>

  272. 

  273. <dl class="py method">

  274. <dt class="sig sig-object py" id="telnetlib.Telnet.read_some">

  275. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">read_some</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.read_some" title="Link to this definition">¶</a></dt>

  276. <dd><p>Read at least one byte of cooked data unless EOF is hit. Return <code class="docutils literal notranslate"><span class="pre">b''</span></code> if

  277. EOF is hit.  Block if no data is immediately available.</p>

  278. </dd></dl>

  279. 

  280. <dl class="py method">

  281. <dt class="sig sig-object py" id="telnetlib.Telnet.read_very_eager">

  282. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">read_very_eager</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.read_very_eager" title="Link to this definition">¶</a></dt>

  283. <dd><p>Read everything that can be without blocking in I/O (eager).</p>

  284. <p>Raise <a class="reference internal" href="exceptions.html#EOFError" title="EOFError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">EOFError</span></code></a> if connection closed and no cooked data available.

  285. Return <code class="docutils literal notranslate"><span class="pre">b''</span></code> if no cooked data available otherwise. Do not block unless in

  286. the midst of an IAC sequence.</p>

  287. </dd></dl>

  288. 

  289. <dl class="py method">

  290. <dt class="sig sig-object py" id="telnetlib.Telnet.read_eager">

  291. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">read_eager</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.read_eager" title="Link to this definition">¶</a></dt>

  292. <dd><p>Read readily available data.</p>

  293. <p>Raise <a class="reference internal" href="exceptions.html#EOFError" title="EOFError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">EOFError</span></code></a> if connection closed and no cooked data available.

  294. Return <code class="docutils literal notranslate"><span class="pre">b''</span></code> if no cooked data available otherwise. Do not block unless in

  295. the midst of an IAC sequence.</p>

  296. </dd></dl>

  297. 

  298. <dl class="py method">

  299. <dt class="sig sig-object py" id="telnetlib.Telnet.read_lazy">

  300. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">read_lazy</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.read_lazy" title="Link to this definition">¶</a></dt>

  301. <dd><p>Process and return data already in the queues (lazy).</p>

  302. <p>Raise <a class="reference internal" href="exceptions.html#EOFError" title="EOFError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">EOFError</span></code></a> if connection closed and no data available. Return

  303. <code class="docutils literal notranslate"><span class="pre">b''</span></code> if no cooked data available otherwise.  Do not block unless in the

  304. midst of an IAC sequence.</p>

  305. </dd></dl>

  306. 

  307. <dl class="py method">

  308. <dt class="sig sig-object py" id="telnetlib.Telnet.read_very_lazy">

  309. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">read_very_lazy</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.read_very_lazy" title="Link to this definition">¶</a></dt>

  310. <dd><p>Return any data available in the cooked queue (very lazy).</p>

  311. <p>Raise <a class="reference internal" href="exceptions.html#EOFError" title="EOFError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">EOFError</span></code></a> if connection closed and no data available. Return

  312. <code class="docutils literal notranslate"><span class="pre">b''</span></code> if no cooked data available otherwise.  This method never blocks.</p>

  313. </dd></dl>

  314. 

  315. <dl class="py method">

  316. <dt class="sig sig-object py" id="telnetlib.Telnet.read_sb_data">

  317. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">read_sb_data</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.read_sb_data" title="Link to this definition">¶</a></dt>

  318. <dd><p>Return the data collected between a SB/SE pair (suboption begin/end). The

  319. callback should access these data when it was invoked with a <code class="docutils literal notranslate"><span class="pre">SE</span></code> command.

  320. This method never blocks.</p>

  321. </dd></dl>

  322. 

  323. <dl class="py method">

  324. <dt class="sig sig-object py" id="telnetlib.Telnet.open">

  325. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">open</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">host</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">port=0</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">timeout</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.open" title="Link to this definition">¶</a></dt>

  326. <dd><p>Connect to a host. The optional second argument is the port number, which

  327. defaults to the standard Telnet port (23). The optional <em>timeout</em> parameter

  328. specifies a timeout in seconds for blocking operations like the connection

  329. attempt (if not specified, the global default timeout setting will be used).</p>

  330. <p>Do not try to reopen an already connected instance.</p>

  331. <p class="audit-hook">Raises an <a class="reference internal" href="sys.html#auditing"><span class="std std-ref">auditing event</span></a> <code class="docutils literal notranslate"><span class="pre">telnetlib.Telnet.open</span></code> with arguments <code class="docutils literal notranslate"><span class="pre">self</span></code>, <code class="docutils literal notranslate"><span class="pre">host</span></code>, <code class="docutils literal notranslate"><span class="pre">port</span></code>.</p>

  332. </dd></dl>

  333. 

  334. <dl class="py method">

  335. <dt class="sig sig-object py" id="telnetlib.Telnet.msg">

  336. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">msg</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">msg</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.msg" title="Link to this definition">¶</a></dt>

  337. <dd><p>Print a debug message when the debug level is <code class="docutils literal notranslate"><span class="pre">&gt;</span></code> 0. If extra arguments are

  338. present, they are substituted in the message using the standard string

  339. formatting operator.</p>

  340. </dd></dl>

  341. 

  342. <dl class="py method">

  343. <dt class="sig sig-object py" id="telnetlib.Telnet.set_debuglevel">

  344. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">set_debuglevel</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">debuglevel</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.set_debuglevel" title="Link to this definition">¶</a></dt>

  345. <dd><p>Set the debug level.  The higher the value of <em>debuglevel</em>, the more debug

  346. output you get (on <code class="docutils literal notranslate"><span class="pre">sys.stdout</span></code>).</p>

  347. </dd></dl>

  348. 

  349. <dl class="py method">

  350. <dt class="sig sig-object py" id="telnetlib.Telnet.close">

  351. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">close</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.close" title="Link to this definition">¶</a></dt>

  352. <dd><p>Close the connection.</p>

  353. </dd></dl>

  354. 

  355. <dl class="py method">

  356. <dt class="sig sig-object py" id="telnetlib.Telnet.get_socket">

  357. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">get_socket</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.get_socket" title="Link to this definition">¶</a></dt>

  358. <dd><p>Return the socket object used internally.</p>

  359. </dd></dl>

  360. 

  361. <dl class="py method">

  362. <dt class="sig sig-object py" id="telnetlib.Telnet.fileno">

  363. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">fileno</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.fileno" title="Link to this definition">¶</a></dt>

  364. <dd><p>Return the file descriptor of the socket object used internally.</p>

  365. </dd></dl>

  366. 

  367. <dl class="py method">

  368. <dt class="sig sig-object py" id="telnetlib.Telnet.write">

  369. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">write</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">buffer</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.write" title="Link to this definition">¶</a></dt>

  370. <dd><p>Write a byte string to the socket, doubling any IAC characters. This can

  371. block if the connection is blocked.  May raise <a class="reference internal" href="exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">OSError</span></code></a> if the

  372. connection is closed.</p>

  373. <p class="audit-hook">Raises an <a class="reference internal" href="sys.html#auditing"><span class="std std-ref">auditing event</span></a> <code class="docutils literal notranslate"><span class="pre">telnetlib.Telnet.write</span></code> with arguments <code class="docutils literal notranslate"><span class="pre">self</span></code>, <code class="docutils literal notranslate"><span class="pre">buffer</span></code>.</p>

  374. <div class="versionchanged">

  375. <p><span class="versionmodified changed">Changed in version 3.3: </span>This method used to raise <a class="reference internal" href="socket.html#socket.error" title="socket.error"><code class="xref py py-exc docutils literal notranslate"><span class="pre">socket.error</span></code></a>, which is now an alias

  376. of <a class="reference internal" href="exceptions.html#OSError" title="OSError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">OSError</span></code></a>.</p>

  377. </div>

  378. </dd></dl>

  379. 

  380. <dl class="py method">

  381. <dt class="sig sig-object py" id="telnetlib.Telnet.interact">

  382. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">interact</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.interact" title="Link to this definition">¶</a></dt>

  383. <dd><p>Interaction function, emulates a very dumb Telnet client.</p>

  384. </dd></dl>

  385. 

  386. <dl class="py method">

  387. <dt class="sig sig-object py" id="telnetlib.Telnet.mt_interact">

  388. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">mt_interact</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.mt_interact" title="Link to this definition">¶</a></dt>

  389. <dd><p>Multithreaded version of <a class="reference internal" href="#telnetlib.Telnet.interact" title="telnetlib.Telnet.interact"><code class="xref py py-meth docutils literal notranslate"><span class="pre">interact()</span></code></a>.</p>

  390. </dd></dl>

  391. 

  392. <dl class="py method">

  393. <dt class="sig sig-object py" id="telnetlib.Telnet.expect">

  394. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">expect</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">list</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">timeout</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.expect" title="Link to this definition">¶</a></dt>

  395. <dd><p>Read until one from a list of a regular expressions matches.</p>

  396. <p>The first argument is a list of regular expressions, either compiled

  397. (<a class="reference internal" href="re.html#re-objects"><span class="std std-ref">regex objects</span></a>) or uncompiled (byte strings). The

  398. optional second argument is a timeout, in seconds; the default is to block

  399. indefinitely.</p>

  400. <p>Return a tuple of three items: the index in the list of the first regular

  401. expression that matches; the match object returned; and the bytes read up

  402. till and including the match.</p>

  403. <p>If end of file is found and no bytes were read, raise <a class="reference internal" href="exceptions.html#EOFError" title="EOFError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">EOFError</span></code></a>.

  404. Otherwise, when nothing matches, return <code class="docutils literal notranslate"><span class="pre">(-1,</span> <span class="pre">None,</span> <span class="pre">data)</span></code> where <em>data</em> is

  405. the bytes received so far (may be empty bytes if a timeout happened).</p>

  406. <p>If a regular expression ends with a greedy match (such as <code class="docutils literal notranslate"><span class="pre">.*</span></code>) or if more

  407. than one expression can match the same input, the results are

  408. non-deterministic, and may depend on the I/O timing.</p>

  409. </dd></dl>

  410. 

  411. <dl class="py method">

  412. <dt class="sig sig-object py" id="telnetlib.Telnet.set_option_negotiation_callback">

  413. <span class="sig-prename descclassname"><span class="pre">Telnet.</span></span><span class="sig-name descname"><span class="pre">set_option_negotiation_callback</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">callback</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#telnetlib.Telnet.set_option_negotiation_callback" title="Link to this definition">¶</a></dt>

  414. <dd><p>Each time a telnet option is read on the input flow, this <em>callback</em> (if set) is

  415. called with the following parameters: callback(telnet socket, command

  416. (DO/DONT/WILL/WONT), option).  No other action is done afterwards by telnetlib.</p>

  417. </dd></dl>

  418. 

  419. </section>

  420. <section id="telnet-example">

  421. <span id="id2"></span><h2>Telnet Example<a class="headerlink" href="#telnet-example" title="Link to this heading">¶</a></h2>

  422. <p>A simple example illustrating typical use:</p>

  423. <div class="highlight-python3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">getpass</span>

  424. <span class="kn">import</span> <span class="nn">telnetlib</span>

  425. 

  426. <span class="n">HOST</span> <span class="o">=</span> <span class="s2">&quot;localhost&quot;</span>

  427. <span class="n">user</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">&quot;Enter your remote account: &quot;</span><span class="p">)</span>

  428. <span class="n">password</span> <span class="o">=</span> <span class="n">getpass</span><span class="o">.</span><span class="n">getpass</span><span class="p">()</span>

  429. 

  430. <span class="n">tn</span> <span class="o">=</span> <span class="n">telnetlib</span><span class="o">.</span><span class="n">Telnet</span><span class="p">(</span><span class="n">HOST</span><span class="p">)</span>

  431. 

  432. <span class="n">tn</span><span class="o">.</span><span class="n">read_until</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;login: &quot;</span><span class="p">)</span>

  433. <span class="n">tn</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">user</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">&#39;ascii&#39;</span><span class="p">)</span> <span class="o">+</span> <span class="sa">b</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>

  434. <span class="k">if</span> <span class="n">password</span><span class="p">:</span>

  435.     <span class="n">tn</span><span class="o">.</span><span class="n">read_until</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;Password: &quot;</span><span class="p">)</span>

  436.     <span class="n">tn</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">password</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s1">&#39;ascii&#39;</span><span class="p">)</span> <span class="o">+</span> <span class="sa">b</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>

  437. 

  438. <span class="n">tn</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;ls</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>

  439. <span class="n">tn</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;exit</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>

  440. 

  441. <span class="nb">print</span><span class="p">(</span><span class="n">tn</span><span class="o">.</span><span class="n">read_all</span><span class="p">()</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s1">&#39;ascii&#39;</span><span class="p">))</span>

  442. </pre></div>

  443. </div>

  444. </section>

  445. </section>

  446. 

  447. 

  448.             <div class="clearer"></div>

  449.           </div>

  450.         </div>

  451.       </div>

  452.       <div class="sphinxsidebar" role="navigation" aria-label="main navigation">

  453.         <div class="sphinxsidebarwrapper">

  454.   <div>

  455.     <h3><a href="../contents.html">Table of Contents</a></h3>

  456.     <ul>

  457. <li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate"><span class="pre">telnetlib</span></code> — Telnet client</a><ul>

  458. <li><a class="reference internal" href="#telnet-objects">Telnet Objects</a></li>

  459. <li><a class="reference internal" href="#telnet-example">Telnet Example</a></li>

  460. </ul>

  461. </li>

  462. </ul>

  463. 

  464.   </div>

  465.   <div>

  466.     <h4>Previous topic</h4>

  467.     <p class="topless"><a href="sunau.html"

  468.                           title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">sunau</span></code> — Read and write Sun AU files</a></p>

  469.   </div>

  470.   <div>

  471.     <h4>Next topic</h4>

  472.     <p class="topless"><a href="uu.html"

  473.                           title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">uu</span></code> — Encode and decode uuencode files</a></p>

  474.   </div>

  475.   <div role="note" aria-label="source link">

  476.     <h3>This Page</h3>

  477.     <ul class="this-page-menu">

  478.       <li><a href="../bugs.html">Report a Bug</a></li>

  479.       <li>

  480.         <a href="https://github.com/python/cpython/blob/main/Doc/library/telnetlib.rst"

  481.             rel="nofollow">Show Source

  482.         </a>

  483.       </li>

  484.     </ul>

  485.   </div>

  486.         </div>

  487. <div id="sidebarbutton" title="Collapse sidebar">

  488. <span>«</span>

  489. </div>

  490. 

  491.       </div>

  492.       <div class="clearer"></div>

  493.     </div>  

  494.     <div class="related" role="navigation" aria-label="related navigation">

  495.       <h3>Navigation</h3>

  496.       <ul>

  497.         <li class="right" style="margin-right: 10px">

  498.           <a href="../genindex.html" title="General Index"

  499.              >index</a></li>

  500.         <li class="right" >

  501.           <a href="../py-modindex.html" title="Python Module Index"

  502.              >modules</a> |</li>

  503.         <li class="right" >

  504.           <a href="uu.html" title="uu — Encode and decode uuencode files"

  505.              >next</a> |</li>

  506.         <li class="right" >

  507.           <a href="sunau.html" title="sunau — Read and write Sun AU files"

  508.              >previous</a> |</li>

  509. 

  510.           <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>

  511.           <li><a href="https://www.python.org/">Python</a> &#187;</li>

  512.           <li class="switchers">

  513.             <div class="language_switcher_placeholder"></div>

  514.             <div class="version_switcher_placeholder"></div>

  515.           </li>

  516.           <li>

  517.               

  518.           </li>

  519.     <li id="cpython-language-and-version">

  520.       <a href="../index.html">3.12.3 Documentation</a> &#187;

  521.     </li>

  522. 

  523.           <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>

  524.           <li class="nav-item nav-item-2"><a href="superseded.html" >Superseded Modules</a> &#187;</li>

  525.         <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate"><span class="pre">telnetlib</span></code> — Telnet client</a></li>

  526.                 <li class="right">

  527.                     

  528. 

  529.     <div class="inline-search" role="search">

  530.         <form class="inline-search" action="../search.html" method="get">

  531.           <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />

  532.           <input type="submit" value="Go" />

  533.         </form>

  534.     </div>

  535.                      |

  536.                 </li>

  537.             <li class="right">

  538. <label class="theme-selector-label">

  539.     Theme

  540.     <select class="theme-selector" oninput="activateTheme(this.value)">

  541.         <option value="auto" selected>Auto</option>

  542.         <option value="light">Light</option>

  543.         <option value="dark">Dark</option>

  544.     </select>

  545. </label> |</li>

  546.             

  547.       </ul>

  548.     </div>  

  549.     <div class="footer">

  550.     &copy; 

  551.       <a href="../copyright.html">

  552.     

  553.     Copyright

  554.     

  555.       </a>

  556.      2001-2024, Python Software Foundation.

  557.     <br />

  558.     This page is licensed under the Python Software Foundation License Version 2.

  559.     <br />

  560.     Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.

  561.     <br />

  562.     

  563.       See <a href="/license.html">History and License</a> for more information.<br />

  564.     

  565.     

  566.     <br />

  567. 

  568.     The Python Software Foundation is a non-profit corporation.

  569. <a href="https://www.python.org/psf/donations/">Please donate.</a>

  570. <br />

  571.     <br />

  572.       Last updated on Apr 09, 2024 (13:47 UTC).

  573.     

  574.       <a href="/bugs.html">Found a bug</a>?

  575.     

  576.     <br />

  577. 

  578.     Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.2.6.

  579.     </div>

  580. 

  581.   </body>

  582. </html>
上海开阖软件有限公司 沪ICP备12045867号-1