文件操作 - pxssh.html

文件: /usr/share/doc/pexpect-2.3/doc/pxssh.html

编辑文件内容

<!doctype html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><title>Python: module pxssh</title>
</head><body bgcolor="#f0f0f8">

<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
<tr bgcolor="#7799ee">
<td valign=bottom>&nbsp; 
&nbsp; <big><big>pxssh</big></big> (version 2.3)</td
><td align=right valign=bottom
><a href=".">index</a> <a href="file:/home/noah/pexpect/trunk/pexpect/pxssh.py">/home/noah/pexpect/trunk/pexpect/pxssh.py</a></td></tr></table>
 <tt>This&nbsp;class&nbsp;extends&nbsp;pexpect.<a href="pexpect.html#spawn">spawn</a>&nbsp;to&nbsp;specialize&nbsp;setting&nbsp;up&nbsp;SSH&nbsp;connections. 
This&nbsp;adds&nbsp;methods&nbsp;for&nbsp;login,&nbsp;logout,&nbsp;and&nbsp;expecting&nbsp;the&nbsp;shell&nbsp;prompt. 
&nbsp; 
$Id:&nbsp;<a href="#pxssh">pxssh</a>.py&nbsp;487&nbsp;2007-08-29&nbsp;22:33:29Z&nbsp;noah&nbsp;$</tt>

<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#aa55cc">
<td colspan=3 valign=bottom>&nbsp; 
<big>Modules</big></td></tr>
 
<tr><td bgcolor="#aa55cc"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="pexpect.html">pexpect</a> 
</td><td width="25%" valign=top><a href="time.html">time</a> 
</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ee77aa">
<td colspan=3 valign=bottom>&nbsp; 
<big>Classes</big></td></tr>
 
<tr><td bgcolor="#ee77aa"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
<td width="100%"><dl>
<dt><a href="pexpect.html#ExceptionPexpect">pexpect.ExceptionPexpect</a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)
</dt><dd>
<dl>
<dt><a href="pxssh.html#ExceptionPxssh">ExceptionPxssh</a>
</dt></dl>
</dd>
<dt><a href="pexpect.html#spawn">pexpect.spawn</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
</dt><dd>
<dl>
<dt><a href="pxssh.html#pxssh">pxssh</a>
</dt></dl>
</dd>
</dl>
 
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ffc8d8">
<td colspan=3 valign=bottom>&nbsp; 
<a name="ExceptionPxssh">class ExceptionPxssh</a>(<a href="pexpect.html#ExceptionPexpect">pexpect.ExceptionPexpect</a>)</td></tr>
 
<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
<td colspan=2><tt>Raised&nbsp;for&nbsp;<a href="#pxssh">pxssh</a>&nbsp;exceptions. &nbsp;</tt></td></tr>
<tr><td>&nbsp;</td>
<td width="100%"><dl><dt>Method resolution order:</dt>
<dd><a href="pxssh.html#ExceptionPxssh">ExceptionPxssh</a></dd>
<dd><a href="pexpect.html#ExceptionPexpect">pexpect.ExceptionPexpect</a></dd>
<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
</dl>
<hr>
Methods inherited from <a href="pexpect.html#ExceptionPexpect">pexpect.ExceptionPexpect</a>: 
<dl><dt><a name="ExceptionPxssh-__init__">__init__</a>(self, value)</dt></dl>

<dl><dt><a name="ExceptionPxssh-get_trace">get_trace</a>(self)</dt><dd><tt>This&nbsp;returns&nbsp;an&nbsp;abbreviated&nbsp;stack&nbsp;trace&nbsp;with&nbsp;lines&nbsp;that&nbsp;only&nbsp;concern 
the&nbsp;caller.&nbsp;In&nbsp;other&nbsp;words,&nbsp;the&nbsp;stack&nbsp;trace&nbsp;inside&nbsp;the&nbsp;Pexpect&nbsp;module 
is&nbsp;not&nbsp;included.</tt></dd></dl>

<hr>
Data descriptors inherited from <a href="pexpect.html#ExceptionPexpect">pexpect.ExceptionPexpect</a>: 
<dl><dt>__weakref__</dt>
<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
</dl>
<hr>
Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>: 
<dl><dt>__new__ = &lt;built-in method __new__ of type object at 0x81400e0&gt;<dd><tt>T.<a href="#ExceptionPxssh-__new__">__new__</a>(S,&nbsp;...)&nbsp;-&gt;&nbsp;a&nbsp;new&nbsp;object&nbsp;with&nbsp;type&nbsp;S,&nbsp;a&nbsp;subtype&nbsp;of&nbsp;T</tt></dl>

<hr>
Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>: 
<dl><dt><a name="ExceptionPxssh-__delattr__">__delattr__</a>(...)</dt><dd><tt>x.<a href="#ExceptionPxssh-__delattr__">__delattr__</a>('name')&nbsp;&lt;==&gt;&nbsp;del&nbsp;x.name</tt></dd></dl>

<dl><dt><a name="ExceptionPxssh-__getattribute__">__getattribute__</a>(...)</dt><dd><tt>x.<a href="#ExceptionPxssh-__getattribute__">__getattribute__</a>('name')&nbsp;&lt;==&gt;&nbsp;x.name</tt></dd></dl>

<dl><dt><a name="ExceptionPxssh-__getitem__">__getitem__</a>(...)</dt><dd><tt>x.<a href="#ExceptionPxssh-__getitem__">__getitem__</a>(y)&nbsp;&lt;==&gt;&nbsp;x[y]</tt></dd></dl>

<dl><dt><a name="ExceptionPxssh-__getslice__">__getslice__</a>(...)</dt><dd><tt>x.<a href="#ExceptionPxssh-__getslice__">__getslice__</a>(i,&nbsp;j)&nbsp;&lt;==&gt;&nbsp;x[i:j] 
&nbsp; 
Use&nbsp;of&nbsp;negative&nbsp;indices&nbsp;is&nbsp;not&nbsp;supported.</tt></dd></dl>

<dl><dt><a name="ExceptionPxssh-__reduce__">__reduce__</a>(...)</dt></dl>

<dl><dt><a name="ExceptionPxssh-__setattr__">__setattr__</a>(...)</dt><dd><tt>x.<a href="#ExceptionPxssh-__setattr__">__setattr__</a>('name',&nbsp;value)&nbsp;&lt;==&gt;&nbsp;x.name&nbsp;=&nbsp;value</tt></dd></dl>

<dl><dt><a name="ExceptionPxssh-__setstate__">__setstate__</a>(...)</dt></dl>

<hr>
Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>: 
<dl><dt>__dict__</dt>
</dl>
<dl><dt>args</dt>
</dl>
<dl><dt>message</dt>
<dd><tt>exception&nbsp;message</tt></dd>
</dl>
</td></tr></table> 
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ffc8d8">
<td colspan=3 valign=bottom>&nbsp; 
<a name="pxssh">class pxssh</a>(<a href="pexpect.html#spawn">pexpect.spawn</a>)</td></tr>
 
<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
<td colspan=2><tt>This&nbsp;class&nbsp;extends&nbsp;pexpect.<a href="pexpect.html#spawn">spawn</a>&nbsp;to&nbsp;specialize&nbsp;setting&nbsp;up&nbsp;SSH 
connections.&nbsp;This&nbsp;adds&nbsp;methods&nbsp;for&nbsp;login,&nbsp;logout,&nbsp;and&nbsp;expecting&nbsp;the&nbsp;shell 
prompt.&nbsp;It&nbsp;does&nbsp;various&nbsp;tricky&nbsp;things&nbsp;to&nbsp;handle&nbsp;many&nbsp;situations&nbsp;in&nbsp;the&nbsp;SSH 
login&nbsp;process.&nbsp;For&nbsp;example,&nbsp;if&nbsp;the&nbsp;session&nbsp;is&nbsp;your&nbsp;first&nbsp;login,&nbsp;then&nbsp;<a href="#pxssh">pxssh</a> 
automatically&nbsp;accepts&nbsp;the&nbsp;remote&nbsp;certificate;&nbsp;or&nbsp;if&nbsp;you&nbsp;have&nbsp;public&nbsp;key 
authentication&nbsp;setup&nbsp;then&nbsp;<a href="#pxssh">pxssh</a>&nbsp;won't&nbsp;wait&nbsp;for&nbsp;the&nbsp;password&nbsp;prompt. 
&nbsp; 
<a href="#pxssh">pxssh</a>&nbsp;uses&nbsp;the&nbsp;shell&nbsp;prompt&nbsp;to&nbsp;synchronize&nbsp;output&nbsp;from&nbsp;the&nbsp;remote&nbsp;host.&nbsp;In 
order&nbsp;to&nbsp;make&nbsp;this&nbsp;more&nbsp;robust&nbsp;it&nbsp;sets&nbsp;the&nbsp;shell&nbsp;prompt&nbsp;to&nbsp;something&nbsp;more 
unique&nbsp;than&nbsp;just&nbsp;$&nbsp;or&nbsp;#.&nbsp;This&nbsp;should&nbsp;work&nbsp;on&nbsp;most&nbsp;Borne/Bash&nbsp;or&nbsp;Csh&nbsp;style 
shells. 
&nbsp; 
Example&nbsp;that&nbsp;runs&nbsp;a&nbsp;few&nbsp;commands&nbsp;on&nbsp;a&nbsp;remote&nbsp;server&nbsp;and&nbsp;prints&nbsp;the&nbsp;result:: 
&nbsp;&nbsp;&nbsp;&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;import&nbsp;<a href="#pxssh">pxssh</a> 
&nbsp;&nbsp;&nbsp;&nbsp;import&nbsp;getpass 
&nbsp;&nbsp;&nbsp;&nbsp;try:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s&nbsp;=&nbsp;<a href="#pxssh">pxssh</a>.<a href="#pxssh">pxssh</a>() 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;hostname&nbsp;=&nbsp;raw_input('hostname:&nbsp;') 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;username&nbsp;=&nbsp;raw_input('username:&nbsp;') 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;password&nbsp;=&nbsp;getpass.getpass('password:&nbsp;') 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s.login&nbsp;(hostname,&nbsp;username,&nbsp;password) 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s.sendline&nbsp;('uptime')&nbsp;&nbsp;#&nbsp;run&nbsp;a&nbsp;command 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s.<a href="#pxssh-prompt">prompt</a>()&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;match&nbsp;the&nbsp;prompt 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;s.before&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;print&nbsp;everything&nbsp;before&nbsp;the&nbsp;prompt. 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s.sendline&nbsp;('ls&nbsp;-l') 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s.<a href="#pxssh-prompt">prompt</a>() 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;s.before 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s.sendline&nbsp;('df') 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s.<a href="#pxssh-prompt">prompt</a>() 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;s.before 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s.<a href="#pxssh-logout">logout</a>() 
&nbsp;&nbsp;&nbsp;&nbsp;except&nbsp;<a href="#pxssh">pxssh</a>.<a href="#ExceptionPxssh">ExceptionPxssh</a>,&nbsp;e: 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"<a href="#pxssh">pxssh</a>&nbsp;failed&nbsp;on&nbsp;login." 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;str(e) 
&nbsp; 
Note&nbsp;that&nbsp;if&nbsp;you&nbsp;have&nbsp;ssh-agent&nbsp;running&nbsp;while&nbsp;doing&nbsp;development&nbsp;with&nbsp;<a href="#pxssh">pxssh</a> 
then&nbsp;this&nbsp;can&nbsp;lead&nbsp;to&nbsp;a&nbsp;lot&nbsp;of&nbsp;confusion.&nbsp;Many&nbsp;X&nbsp;display&nbsp;managers&nbsp;(xdm, 
gdm,&nbsp;kdm,&nbsp;etc.)&nbsp;will&nbsp;automatically&nbsp;start&nbsp;a&nbsp;GUI&nbsp;agent.&nbsp;You&nbsp;may&nbsp;see&nbsp;a&nbsp;GUI 
dialog&nbsp;box&nbsp;popup&nbsp;asking&nbsp;for&nbsp;a&nbsp;password&nbsp;during&nbsp;development.&nbsp;You&nbsp;should&nbsp;turn 
off&nbsp;any&nbsp;key&nbsp;agents&nbsp;during&nbsp;testing.&nbsp;The&nbsp;'force_password'&nbsp;attribute&nbsp;will&nbsp;turn 
off&nbsp;public&nbsp;key&nbsp;authentication.&nbsp;This&nbsp;will&nbsp;only&nbsp;work&nbsp;if&nbsp;the&nbsp;remote&nbsp;SSH&nbsp;server 
is&nbsp;configured&nbsp;to&nbsp;allow&nbsp;password&nbsp;logins.&nbsp;Example&nbsp;of&nbsp;using&nbsp;'force_password' 
attribute:: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s&nbsp;=&nbsp;<a href="#pxssh">pxssh</a>.<a href="#pxssh">pxssh</a>() 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s.force_password&nbsp;=&nbsp;True 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;hostname&nbsp;=&nbsp;raw_input('hostname:&nbsp;') 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;username&nbsp;=&nbsp;raw_input('username:&nbsp;') 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;password&nbsp;=&nbsp;getpass.getpass('password:&nbsp;') 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s.login&nbsp;(hostname,&nbsp;username,&nbsp;password) &nbsp;</tt></td></tr>
<tr><td>&nbsp;</td>
<td width="100%"><dl><dt>Method resolution order:</dt>
<dd><a href="pxssh.html#pxssh">pxssh</a></dd>
<dd><a href="pexpect.html#spawn">pexpect.spawn</a></dd>
<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
</dl>
<hr>
Methods defined here: 
<dl><dt><a name="pxssh-__init__">__init__</a>(self, timeout=30, maxread=2000, searchwindowsize=None, logfile=None, cwd=None, env=None)</dt></dl>

<dl><dt><a name="pxssh-levenshtein_distance">levenshtein_distance</a>(self, a, b)</dt><dd><tt>This&nbsp;calculates&nbsp;the&nbsp;Levenshtein&nbsp;distance&nbsp;between&nbsp;a&nbsp;and&nbsp;b.</tt></dd></dl>

<dl><dt><a name="pxssh-login">login</a>(self, server, username, password='', terminal_type='ansi', original_prompt='[#$]', login_timeout=10, port=None, auto_prompt_reset=True)</dt><dd><tt>This&nbsp;logs&nbsp;the&nbsp;user&nbsp;into&nbsp;the&nbsp;given&nbsp;server.&nbsp;It&nbsp;uses&nbsp;the 
'original_prompt'&nbsp;to&nbsp;try&nbsp;to&nbsp;find&nbsp;the&nbsp;prompt&nbsp;right&nbsp;after&nbsp;login.&nbsp;When&nbsp;it 
finds&nbsp;the&nbsp;prompt&nbsp;it&nbsp;immediately&nbsp;tries&nbsp;to&nbsp;reset&nbsp;the&nbsp;prompt&nbsp;to&nbsp;something 
more&nbsp;easily&nbsp;matched.&nbsp;The&nbsp;default&nbsp;'original_prompt'&nbsp;is&nbsp;very&nbsp;optimistic 
and&nbsp;is&nbsp;easily&nbsp;fooled.&nbsp;It's&nbsp;more&nbsp;reliable&nbsp;to&nbsp;try&nbsp;to&nbsp;match&nbsp;the&nbsp;original 
prompt&nbsp;as&nbsp;exactly&nbsp;as&nbsp;possible&nbsp;to&nbsp;prevent&nbsp;false&nbsp;matches&nbsp;by&nbsp;server 
strings&nbsp;such&nbsp;as&nbsp;the&nbsp;"Message&nbsp;Of&nbsp;The&nbsp;Day".&nbsp;On&nbsp;many&nbsp;systems&nbsp;you&nbsp;can 
disable&nbsp;the&nbsp;MOTD&nbsp;on&nbsp;the&nbsp;remote&nbsp;server&nbsp;by&nbsp;creating&nbsp;a&nbsp;zero-length&nbsp;file 
called&nbsp;"~/.hushlogin"&nbsp;on&nbsp;the&nbsp;remote&nbsp;server.&nbsp;If&nbsp;a&nbsp;prompt&nbsp;cannot&nbsp;be&nbsp;found 
then&nbsp;this&nbsp;will&nbsp;not&nbsp;necessarily&nbsp;cause&nbsp;the&nbsp;login&nbsp;to&nbsp;fail.&nbsp;In&nbsp;the&nbsp;case&nbsp;of 
a&nbsp;timeout&nbsp;when&nbsp;looking&nbsp;for&nbsp;the&nbsp;prompt&nbsp;we&nbsp;assume&nbsp;that&nbsp;the&nbsp;original 
prompt&nbsp;was&nbsp;so&nbsp;weird&nbsp;that&nbsp;we&nbsp;could&nbsp;not&nbsp;match&nbsp;it,&nbsp;so&nbsp;we&nbsp;use&nbsp;a&nbsp;few&nbsp;tricks 
to&nbsp;guess&nbsp;when&nbsp;we&nbsp;have&nbsp;reached&nbsp;the&nbsp;prompt.&nbsp;Then&nbsp;we&nbsp;hope&nbsp;for&nbsp;the&nbsp;best&nbsp;and 
blindly&nbsp;try&nbsp;to&nbsp;reset&nbsp;the&nbsp;prompt&nbsp;to&nbsp;something&nbsp;more&nbsp;unique.&nbsp;If&nbsp;that&nbsp;fails 
then&nbsp;<a href="#pxssh-login">login</a>()&nbsp;raises&nbsp;an&nbsp;<a href="#ExceptionPxssh">ExceptionPxssh</a>&nbsp;exception. 
&nbsp; 
In&nbsp;some&nbsp;situations&nbsp;it&nbsp;is&nbsp;not&nbsp;possible&nbsp;or&nbsp;desirable&nbsp;to&nbsp;reset&nbsp;the 
original&nbsp;prompt.&nbsp;In&nbsp;this&nbsp;case,&nbsp;set&nbsp;'auto_prompt_reset'&nbsp;to&nbsp;False&nbsp;to 
inhibit&nbsp;setting&nbsp;the&nbsp;prompt&nbsp;to&nbsp;the&nbsp;UNIQUE_PROMPT.&nbsp;Remember&nbsp;that&nbsp;<a href="#pxssh">pxssh</a> 
uses&nbsp;a&nbsp;unique&nbsp;prompt&nbsp;in&nbsp;the&nbsp;<a href="#pxssh-prompt">prompt</a>()&nbsp;method.&nbsp;If&nbsp;the&nbsp;original&nbsp;prompt&nbsp;is 
not&nbsp;reset&nbsp;then&nbsp;this&nbsp;will&nbsp;disable&nbsp;the&nbsp;<a href="#pxssh-prompt">prompt</a>()&nbsp;method&nbsp;unless&nbsp;you 
manually&nbsp;set&nbsp;the&nbsp;PROMPT&nbsp;attribute.</tt></dd></dl>

<dl><dt><a name="pxssh-logout">logout</a>(self)</dt><dd><tt>This&nbsp;sends&nbsp;exit&nbsp;to&nbsp;the&nbsp;remote&nbsp;shell.&nbsp;If&nbsp;there&nbsp;are&nbsp;stopped&nbsp;jobs&nbsp;then 
this&nbsp;automatically&nbsp;sends&nbsp;exit&nbsp;twice.</tt></dd></dl>

<dl><dt><a name="pxssh-prompt">prompt</a>(self, timeout=20)</dt><dd><tt>This&nbsp;matches&nbsp;the&nbsp;shell&nbsp;prompt.&nbsp;This&nbsp;is&nbsp;little&nbsp;more&nbsp;than&nbsp;a&nbsp;short-cut 
to&nbsp;the&nbsp;<a href="#pxssh-expect">expect</a>()&nbsp;method.&nbsp;This&nbsp;returns&nbsp;True&nbsp;if&nbsp;the&nbsp;shell&nbsp;prompt&nbsp;was 
matched.&nbsp;This&nbsp;returns&nbsp;False&nbsp;if&nbsp;there&nbsp;was&nbsp;a&nbsp;timeout.&nbsp;Note&nbsp;that&nbsp;if&nbsp;you 
called&nbsp;<a href="#pxssh-login">login</a>()&nbsp;with&nbsp;auto_prompt_reset&nbsp;set&nbsp;to&nbsp;False&nbsp;then&nbsp;you&nbsp;should&nbsp;have 
manually&nbsp;set&nbsp;the&nbsp;PROMPT&nbsp;attribute&nbsp;to&nbsp;a&nbsp;regex&nbsp;pattern&nbsp;for&nbsp;matching&nbsp;the 
prompt.</tt></dd></dl>

<dl><dt><a name="pxssh-set_unique_prompt">set_unique_prompt</a>(self)</dt><dd><tt>This&nbsp;sets&nbsp;the&nbsp;remote&nbsp;prompt&nbsp;to&nbsp;something&nbsp;more&nbsp;unique&nbsp;than&nbsp;#&nbsp;or&nbsp;$. 
This&nbsp;makes&nbsp;it&nbsp;easier&nbsp;for&nbsp;the&nbsp;<a href="#pxssh-prompt">prompt</a>()&nbsp;method&nbsp;to&nbsp;match&nbsp;the&nbsp;shell&nbsp;prompt 
unambiguously.&nbsp;This&nbsp;method&nbsp;is&nbsp;called&nbsp;automatically&nbsp;by&nbsp;the&nbsp;<a href="#pxssh-login">login</a>() 
method,&nbsp;but&nbsp;you&nbsp;may&nbsp;want&nbsp;to&nbsp;call&nbsp;it&nbsp;manually&nbsp;if&nbsp;you&nbsp;somehow&nbsp;reset&nbsp;the 
shell&nbsp;prompt.&nbsp;For&nbsp;example,&nbsp;if&nbsp;you&nbsp;'su'&nbsp;to&nbsp;a&nbsp;different&nbsp;user&nbsp;then&nbsp;you 
will&nbsp;need&nbsp;to&nbsp;manually&nbsp;reset&nbsp;the&nbsp;prompt.&nbsp;This&nbsp;sends&nbsp;shell&nbsp;commands&nbsp;to 
the&nbsp;remote&nbsp;host&nbsp;to&nbsp;set&nbsp;the&nbsp;prompt,&nbsp;so&nbsp;this&nbsp;assumes&nbsp;the&nbsp;remote&nbsp;host&nbsp;is 
ready&nbsp;to&nbsp;receive&nbsp;commands. 
&nbsp; 
Alternatively,&nbsp;you&nbsp;may&nbsp;use&nbsp;your&nbsp;own&nbsp;prompt&nbsp;pattern.&nbsp;Just&nbsp;set&nbsp;the&nbsp;PROMPT 
attribute&nbsp;to&nbsp;a&nbsp;regular&nbsp;expression&nbsp;that&nbsp;matches&nbsp;it.&nbsp;In&nbsp;this&nbsp;case&nbsp;you 
should&nbsp;call&nbsp;<a href="#pxssh-login">login</a>()&nbsp;with&nbsp;auto_prompt_reset=False;&nbsp;then&nbsp;set&nbsp;the&nbsp;PROMPT 
attribute.&nbsp;After&nbsp;that&nbsp;the&nbsp;<a href="#pxssh-prompt">prompt</a>()&nbsp;method&nbsp;will&nbsp;try&nbsp;to&nbsp;match&nbsp;your&nbsp;prompt 
pattern.</tt></dd></dl>

<dl><dt><a name="pxssh-synch_original_prompt">synch_original_prompt</a>(self)</dt><dd><tt>This&nbsp;attempts&nbsp;to&nbsp;find&nbsp;the&nbsp;prompt.&nbsp;Basically,&nbsp;press&nbsp;enter&nbsp;and&nbsp;record 
the&nbsp;response;&nbsp;press&nbsp;enter&nbsp;again&nbsp;and&nbsp;record&nbsp;the&nbsp;response;&nbsp;if&nbsp;the&nbsp;two 
responses&nbsp;are&nbsp;similar&nbsp;then&nbsp;assume&nbsp;we&nbsp;are&nbsp;at&nbsp;the&nbsp;original&nbsp;prompt.</tt></dd></dl>

<hr>
Methods inherited from <a href="pexpect.html#spawn">pexpect.spawn</a>: 
<dl><dt><a name="pxssh-__del__">__del__</a>(self)</dt><dd><tt>This&nbsp;makes&nbsp;sure&nbsp;that&nbsp;no&nbsp;system&nbsp;resources&nbsp;are&nbsp;left&nbsp;open.&nbsp;Python&nbsp;only 
garbage&nbsp;collects&nbsp;Python&nbsp;objects.&nbsp;OS&nbsp;file&nbsp;descriptors&nbsp;are&nbsp;not&nbsp;Python 
objects,&nbsp;so&nbsp;they&nbsp;must&nbsp;be&nbsp;handled&nbsp;explicitly.&nbsp;If&nbsp;the&nbsp;child&nbsp;file 
descriptor&nbsp;was&nbsp;opened&nbsp;outside&nbsp;of&nbsp;this&nbsp;class&nbsp;(passed&nbsp;to&nbsp;the&nbsp;constructor) 
then&nbsp;this&nbsp;does&nbsp;not&nbsp;close&nbsp;it.</tt></dd></dl>

<dl><dt><a name="pxssh-__iter__">__iter__</a>(self)</dt><dd><tt>This&nbsp;is&nbsp;to&nbsp;support&nbsp;iterators&nbsp;over&nbsp;a&nbsp;file-like&nbsp;object.</tt></dd></dl>

<dl><dt><a name="pxssh-__str__">__str__</a>(self)</dt><dd><tt>This&nbsp;returns&nbsp;a&nbsp;human-readable&nbsp;string&nbsp;that&nbsp;represents&nbsp;the&nbsp;state&nbsp;of 
the&nbsp;object.</tt></dd></dl>

<dl><dt><a name="pxssh-close">close</a>(self, force=True)</dt><dd><tt>This&nbsp;closes&nbsp;the&nbsp;connection&nbsp;with&nbsp;the&nbsp;child&nbsp;application.&nbsp;Note&nbsp;that 
calling&nbsp;<a href="#pxssh-close">close</a>()&nbsp;more&nbsp;than&nbsp;once&nbsp;is&nbsp;valid.&nbsp;This&nbsp;emulates&nbsp;standard&nbsp;Python 
behavior&nbsp;with&nbsp;files.&nbsp;Set&nbsp;force&nbsp;to&nbsp;True&nbsp;if&nbsp;you&nbsp;want&nbsp;to&nbsp;make&nbsp;sure&nbsp;that 
the&nbsp;child&nbsp;is&nbsp;terminated&nbsp;(SIGKILL&nbsp;is&nbsp;sent&nbsp;if&nbsp;the&nbsp;child&nbsp;ignores&nbsp;SIGHUP 
and&nbsp;SIGINT).</tt></dd></dl>

<dl><dt><a name="pxssh-compile_pattern_list">compile_pattern_list</a>(self, patterns)</dt><dd><tt>This&nbsp;compiles&nbsp;a&nbsp;pattern-string&nbsp;or&nbsp;a&nbsp;list&nbsp;of&nbsp;pattern-strings. 
Patterns&nbsp;must&nbsp;be&nbsp;a&nbsp;StringType,&nbsp;EOF,&nbsp;TIMEOUT,&nbsp;SRE_Pattern,&nbsp;or&nbsp;a&nbsp;list&nbsp;of 
those.&nbsp;Patterns&nbsp;may&nbsp;also&nbsp;be&nbsp;None&nbsp;which&nbsp;results&nbsp;in&nbsp;an&nbsp;empty&nbsp;list&nbsp;(you 
might&nbsp;do&nbsp;this&nbsp;if&nbsp;waiting&nbsp;for&nbsp;an&nbsp;EOF&nbsp;or&nbsp;TIMEOUT&nbsp;condition&nbsp;without 
expecting&nbsp;any&nbsp;pattern). 
&nbsp; 
This&nbsp;is&nbsp;used&nbsp;by&nbsp;<a href="#pxssh-expect">expect</a>()&nbsp;when&nbsp;calling&nbsp;<a href="#pxssh-expect_list">expect_list</a>().&nbsp;Thus&nbsp;<a href="#pxssh-expect">expect</a>()&nbsp;is 
nothing&nbsp;more&nbsp;than:: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cpl&nbsp;=&nbsp;<a href="#pxssh-compile_pattern_list">compile_pattern_list</a>(pl) 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;<a href="#pxssh-expect_list">expect_list</a>(cpl,&nbsp;timeout) 
&nbsp; 
If&nbsp;you&nbsp;are&nbsp;using&nbsp;<a href="#pxssh-expect">expect</a>()&nbsp;within&nbsp;a&nbsp;loop&nbsp;it&nbsp;may&nbsp;be&nbsp;more 
efficient&nbsp;to&nbsp;compile&nbsp;the&nbsp;patterns&nbsp;first&nbsp;and&nbsp;then&nbsp;call&nbsp;<a href="#pxssh-expect_list">expect_list</a>(). 
This&nbsp;avoid&nbsp;calls&nbsp;in&nbsp;a&nbsp;loop&nbsp;to&nbsp;<a href="#pxssh-compile_pattern_list">compile_pattern_list</a>():: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cpl&nbsp;=&nbsp;<a href="#pxssh-compile_pattern_list">compile_pattern_list</a>(my_pattern) 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;while&nbsp;some_condition: 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;... 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;i&nbsp;=&nbsp;<a href="#pxssh-expect_list">expect_list</a>(clp,&nbsp;timeout) 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;...</tt></dd></dl>

<dl><dt><a name="pxssh-eof">eof</a>(self)</dt><dd><tt>This&nbsp;returns&nbsp;True&nbsp;if&nbsp;the&nbsp;EOF&nbsp;exception&nbsp;was&nbsp;ever&nbsp;raised.</tt></dd></dl>

<dl><dt><a name="pxssh-expect">expect</a>(self, pattern, timeout=-1, searchwindowsize=None)</dt><dd><tt>This&nbsp;seeks&nbsp;through&nbsp;the&nbsp;stream&nbsp;until&nbsp;a&nbsp;pattern&nbsp;is&nbsp;matched.&nbsp;The 
pattern&nbsp;is&nbsp;overloaded&nbsp;and&nbsp;may&nbsp;take&nbsp;several&nbsp;types.&nbsp;The&nbsp;pattern&nbsp;can&nbsp;be&nbsp;a 
StringType,&nbsp;EOF,&nbsp;a&nbsp;compiled&nbsp;re,&nbsp;or&nbsp;a&nbsp;list&nbsp;of&nbsp;any&nbsp;of&nbsp;those&nbsp;types. 
Strings&nbsp;will&nbsp;be&nbsp;compiled&nbsp;to&nbsp;re&nbsp;types.&nbsp;This&nbsp;returns&nbsp;the&nbsp;index&nbsp;into&nbsp;the 
pattern&nbsp;list.&nbsp;If&nbsp;the&nbsp;pattern&nbsp;was&nbsp;not&nbsp;a&nbsp;list&nbsp;this&nbsp;returns&nbsp;index&nbsp;0&nbsp;on&nbsp;a 
successful&nbsp;match.&nbsp;This&nbsp;may&nbsp;raise&nbsp;exceptions&nbsp;for&nbsp;EOF&nbsp;or&nbsp;TIMEOUT.&nbsp;To 
avoid&nbsp;the&nbsp;EOF&nbsp;or&nbsp;TIMEOUT&nbsp;exceptions&nbsp;add&nbsp;EOF&nbsp;or&nbsp;TIMEOUT&nbsp;to&nbsp;the&nbsp;pattern 
list.&nbsp;That&nbsp;will&nbsp;cause&nbsp;expect&nbsp;to&nbsp;match&nbsp;an&nbsp;EOF&nbsp;or&nbsp;TIMEOUT&nbsp;condition 
instead&nbsp;of&nbsp;raising&nbsp;an&nbsp;exception. 
&nbsp; 
If&nbsp;you&nbsp;pass&nbsp;a&nbsp;list&nbsp;of&nbsp;patterns&nbsp;and&nbsp;more&nbsp;than&nbsp;one&nbsp;matches,&nbsp;the&nbsp;first&nbsp;match 
in&nbsp;the&nbsp;stream&nbsp;is&nbsp;chosen.&nbsp;If&nbsp;more&nbsp;than&nbsp;one&nbsp;pattern&nbsp;matches&nbsp;at&nbsp;that&nbsp;point, 
the&nbsp;leftmost&nbsp;in&nbsp;the&nbsp;pattern&nbsp;list&nbsp;is&nbsp;chosen.&nbsp;For&nbsp;example:: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;the&nbsp;input&nbsp;is&nbsp;'foobar' 
&nbsp;&nbsp;&nbsp;&nbsp;index&nbsp;=&nbsp;p.expect&nbsp;(['bar',&nbsp;'foo',&nbsp;'foobar']) 
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;returns&nbsp;1&nbsp;('foo')&nbsp;even&nbsp;though&nbsp;'foobar'&nbsp;is&nbsp;a&nbsp;"better"&nbsp;match 
&nbsp; 
Please&nbsp;note,&nbsp;however,&nbsp;that&nbsp;buffering&nbsp;can&nbsp;affect&nbsp;this&nbsp;behavior,&nbsp;since 
input&nbsp;arrives&nbsp;in&nbsp;unpredictable&nbsp;chunks.&nbsp;For&nbsp;example:: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;the&nbsp;input&nbsp;is&nbsp;'foobar' 
&nbsp;&nbsp;&nbsp;&nbsp;index&nbsp;=&nbsp;p.expect&nbsp;(['foobar',&nbsp;'foo']) 
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;returns&nbsp;0&nbsp;('foobar')&nbsp;if&nbsp;all&nbsp;input&nbsp;is&nbsp;available&nbsp;at&nbsp;once, 
&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;but&nbsp;returs&nbsp;1&nbsp;('foo')&nbsp;if&nbsp;parts&nbsp;of&nbsp;the&nbsp;final&nbsp;'bar'&nbsp;arrive&nbsp;late 
&nbsp; 
After&nbsp;a&nbsp;match&nbsp;is&nbsp;found&nbsp;the&nbsp;instance&nbsp;attributes&nbsp;'before',&nbsp;'after'&nbsp;and 
'match'&nbsp;will&nbsp;be&nbsp;set.&nbsp;You&nbsp;can&nbsp;see&nbsp;all&nbsp;the&nbsp;data&nbsp;read&nbsp;before&nbsp;the&nbsp;match&nbsp;in 
'before'.&nbsp;You&nbsp;can&nbsp;see&nbsp;the&nbsp;data&nbsp;that&nbsp;was&nbsp;matched&nbsp;in&nbsp;'after'.&nbsp;The 
re.MatchObject&nbsp;used&nbsp;in&nbsp;the&nbsp;re&nbsp;match&nbsp;will&nbsp;be&nbsp;in&nbsp;'match'.&nbsp;If&nbsp;an&nbsp;error 
occurred&nbsp;then&nbsp;'before'&nbsp;will&nbsp;be&nbsp;set&nbsp;to&nbsp;all&nbsp;the&nbsp;data&nbsp;read&nbsp;so&nbsp;far&nbsp;and 
'after'&nbsp;and&nbsp;'match'&nbsp;will&nbsp;be&nbsp;None. 
&nbsp; 
If&nbsp;timeout&nbsp;is&nbsp;-1&nbsp;then&nbsp;timeout&nbsp;will&nbsp;be&nbsp;set&nbsp;to&nbsp;the&nbsp;self.timeout&nbsp;value. 
&nbsp; 
A&nbsp;list&nbsp;entry&nbsp;may&nbsp;be&nbsp;EOF&nbsp;or&nbsp;TIMEOUT&nbsp;instead&nbsp;of&nbsp;a&nbsp;string.&nbsp;This&nbsp;will 
catch&nbsp;these&nbsp;exceptions&nbsp;and&nbsp;return&nbsp;the&nbsp;index&nbsp;of&nbsp;the&nbsp;list&nbsp;entry&nbsp;instead 
of&nbsp;raising&nbsp;the&nbsp;exception.&nbsp;The&nbsp;attribute&nbsp;'after'&nbsp;will&nbsp;be&nbsp;set&nbsp;to&nbsp;the 
exception&nbsp;type.&nbsp;The&nbsp;attribute&nbsp;'match'&nbsp;will&nbsp;be&nbsp;None.&nbsp;This&nbsp;allows&nbsp;you&nbsp;to 
write&nbsp;code&nbsp;like&nbsp;this:: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;index&nbsp;=&nbsp;p.expect&nbsp;(['good',&nbsp;'bad',&nbsp;pexpect.EOF,&nbsp;pexpect.TIMEOUT]) 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;index&nbsp;==&nbsp;0: 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;do_something() 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;elif&nbsp;index&nbsp;==&nbsp;1: 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;do_something_else() 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;elif&nbsp;index&nbsp;==&nbsp;2: 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;do_some_other_thing() 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;elif&nbsp;index&nbsp;==&nbsp;3: 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;do_something_completely_different() 
&nbsp; 
instead&nbsp;of&nbsp;code&nbsp;like&nbsp;this:: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;try: 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;index&nbsp;=&nbsp;p.expect&nbsp;(['good',&nbsp;'bad']) 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;index&nbsp;==&nbsp;0: 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;do_something() 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;elif&nbsp;index&nbsp;==&nbsp;1: 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;do_something_else() 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;except&nbsp;EOF: 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;do_some_other_thing() 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;except&nbsp;TIMEOUT: 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;do_something_completely_different() 
&nbsp; 
These&nbsp;two&nbsp;forms&nbsp;are&nbsp;equivalent.&nbsp;It&nbsp;all&nbsp;depends&nbsp;on&nbsp;what&nbsp;you&nbsp;want.&nbsp;You 
can&nbsp;also&nbsp;just&nbsp;expect&nbsp;the&nbsp;EOF&nbsp;if&nbsp;you&nbsp;are&nbsp;waiting&nbsp;for&nbsp;all&nbsp;output&nbsp;of&nbsp;a 
child&nbsp;to&nbsp;finish.&nbsp;For&nbsp;example:: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;p&nbsp;=&nbsp;pexpect.<a href="pexpect.html#spawn">spawn</a>('/bin/ls') 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;p.expect&nbsp;(pexpect.EOF) 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;p.before 
&nbsp; 
If&nbsp;you&nbsp;are&nbsp;trying&nbsp;to&nbsp;optimize&nbsp;for&nbsp;speed&nbsp;then&nbsp;see&nbsp;<a href="#pxssh-expect_list">expect_list</a>().</tt></dd></dl>

<dl><dt><a name="pxssh-expect_exact">expect_exact</a>(self, pattern_list, timeout=-1, searchwindowsize=-1)</dt><dd><tt>This&nbsp;is&nbsp;similar&nbsp;to&nbsp;<a href="#pxssh-expect">expect</a>(),&nbsp;but&nbsp;uses&nbsp;plain&nbsp;string&nbsp;matching&nbsp;instead 
of&nbsp;compiled&nbsp;regular&nbsp;expressions&nbsp;in&nbsp;'pattern_list'.&nbsp;The&nbsp;'pattern_list' 
may&nbsp;be&nbsp;a&nbsp;string;&nbsp;a&nbsp;list&nbsp;or&nbsp;other&nbsp;sequence&nbsp;of&nbsp;strings;&nbsp;or&nbsp;TIMEOUT&nbsp;and 
EOF. 
&nbsp; 
This&nbsp;call&nbsp;might&nbsp;be&nbsp;faster&nbsp;than&nbsp;<a href="#pxssh-expect">expect</a>()&nbsp;for&nbsp;two&nbsp;reasons:&nbsp;string 
searching&nbsp;is&nbsp;faster&nbsp;than&nbsp;RE&nbsp;matching&nbsp;and&nbsp;it&nbsp;is&nbsp;possible&nbsp;to&nbsp;limit&nbsp;the 
search&nbsp;to&nbsp;just&nbsp;the&nbsp;end&nbsp;of&nbsp;the&nbsp;input&nbsp;buffer. 
&nbsp; 
This&nbsp;method&nbsp;is&nbsp;also&nbsp;useful&nbsp;when&nbsp;you&nbsp;don't&nbsp;want&nbsp;to&nbsp;have&nbsp;to&nbsp;worry&nbsp;about 
escaping&nbsp;regular&nbsp;expression&nbsp;characters&nbsp;that&nbsp;you&nbsp;want&nbsp;to&nbsp;match.</tt></dd></dl>

<dl><dt><a name="pxssh-expect_list">expect_list</a>(self, pattern_list, timeout=-1, searchwindowsize=-1)</dt><dd><tt>This&nbsp;takes&nbsp;a&nbsp;list&nbsp;of&nbsp;compiled&nbsp;regular&nbsp;expressions&nbsp;and&nbsp;returns&nbsp;the 
index&nbsp;into&nbsp;the&nbsp;pattern_list&nbsp;that&nbsp;matched&nbsp;the&nbsp;child&nbsp;output.&nbsp;The&nbsp;list&nbsp;may 
also&nbsp;contain&nbsp;EOF&nbsp;or&nbsp;TIMEOUT&nbsp;(which&nbsp;are&nbsp;not&nbsp;compiled&nbsp;regular 
expressions).&nbsp;This&nbsp;method&nbsp;is&nbsp;similar&nbsp;to&nbsp;the&nbsp;<a href="#pxssh-expect">expect</a>()&nbsp;method&nbsp;except&nbsp;that 
<a href="#pxssh-expect_list">expect_list</a>()&nbsp;does&nbsp;not&nbsp;recompile&nbsp;the&nbsp;pattern&nbsp;list&nbsp;on&nbsp;every&nbsp;call.&nbsp;This 
may&nbsp;help&nbsp;if&nbsp;you&nbsp;are&nbsp;trying&nbsp;to&nbsp;optimize&nbsp;for&nbsp;speed,&nbsp;otherwise&nbsp;just&nbsp;use 
the&nbsp;<a href="#pxssh-expect">expect</a>()&nbsp;method.&nbsp;&nbsp;This&nbsp;is&nbsp;called&nbsp;by&nbsp;<a href="#pxssh-expect">expect</a>().&nbsp;If&nbsp;timeout==-1&nbsp;then 
the&nbsp;self.timeout&nbsp;value&nbsp;is&nbsp;used.&nbsp;If&nbsp;searchwindowsize==-1&nbsp;then&nbsp;the 
self.searchwindowsize&nbsp;value&nbsp;is&nbsp;used.</tt></dd></dl>

<dl><dt><a name="pxssh-expect_loop">expect_loop</a>(self, searcher, timeout=-1, searchwindowsize=-1)</dt><dd><tt>This&nbsp;is&nbsp;the&nbsp;common&nbsp;loop&nbsp;used&nbsp;inside&nbsp;expect.&nbsp;The&nbsp;'searcher'&nbsp;should&nbsp;be 
an&nbsp;instance&nbsp;of&nbsp;searcher_re&nbsp;or&nbsp;searcher_string,&nbsp;which&nbsp;describes&nbsp;how&nbsp;and&nbsp;what 
to&nbsp;search&nbsp;for&nbsp;in&nbsp;the&nbsp;input. 
&nbsp; 
See&nbsp;<a href="#pxssh-expect">expect</a>()&nbsp;for&nbsp;other&nbsp;arguments,&nbsp;return&nbsp;value&nbsp;and&nbsp;exceptions.</tt></dd></dl>

<dl><dt><a name="pxssh-fileno">fileno</a>(self)</dt><dd><tt>This&nbsp;returns&nbsp;the&nbsp;file&nbsp;descriptor&nbsp;of&nbsp;the&nbsp;pty&nbsp;for&nbsp;the&nbsp;child.</tt></dd></dl>

<dl><dt><a name="pxssh-flush">flush</a>(self)</dt><dd><tt>This&nbsp;does&nbsp;nothing.&nbsp;It&nbsp;is&nbsp;here&nbsp;to&nbsp;support&nbsp;the&nbsp;interface&nbsp;for&nbsp;a 
File-like&nbsp;object.</tt></dd></dl>

<dl><dt><a name="pxssh-getecho">getecho</a>(self)</dt><dd><tt>This&nbsp;returns&nbsp;the&nbsp;terminal&nbsp;echo&nbsp;mode.&nbsp;This&nbsp;returns&nbsp;True&nbsp;if&nbsp;echo&nbsp;is 
on&nbsp;or&nbsp;False&nbsp;if&nbsp;echo&nbsp;is&nbsp;off.&nbsp;Child&nbsp;applications&nbsp;that&nbsp;are&nbsp;expecting&nbsp;you 
to&nbsp;enter&nbsp;a&nbsp;password&nbsp;often&nbsp;set&nbsp;ECHO&nbsp;False.&nbsp;See&nbsp;<a href="#pxssh-waitnoecho">waitnoecho</a>().</tt></dd></dl>

<dl><dt><a name="pxssh-getwinsize">getwinsize</a>(self)</dt><dd><tt>This&nbsp;returns&nbsp;the&nbsp;terminal&nbsp;window&nbsp;size&nbsp;of&nbsp;the&nbsp;child&nbsp;tty.&nbsp;The&nbsp;return 
value&nbsp;is&nbsp;a&nbsp;tuple&nbsp;of&nbsp;(rows,&nbsp;cols).</tt></dd></dl>

<dl><dt><a name="pxssh-interact">interact</a>(self, escape_character='\x1d', input_filter=None, output_filter=None)</dt><dd><tt>This&nbsp;gives&nbsp;control&nbsp;of&nbsp;the&nbsp;child&nbsp;process&nbsp;to&nbsp;the&nbsp;interactive&nbsp;user&nbsp;(the 
human&nbsp;at&nbsp;the&nbsp;keyboard).&nbsp;Keystrokes&nbsp;are&nbsp;sent&nbsp;to&nbsp;the&nbsp;child&nbsp;process,&nbsp;and 
the&nbsp;stdout&nbsp;and&nbsp;stderr&nbsp;output&nbsp;of&nbsp;the&nbsp;child&nbsp;process&nbsp;is&nbsp;printed.&nbsp;This 
simply&nbsp;echos&nbsp;the&nbsp;child&nbsp;stdout&nbsp;and&nbsp;child&nbsp;stderr&nbsp;to&nbsp;the&nbsp;real&nbsp;stdout&nbsp;and 
it&nbsp;echos&nbsp;the&nbsp;real&nbsp;stdin&nbsp;to&nbsp;the&nbsp;child&nbsp;stdin.&nbsp;When&nbsp;the&nbsp;user&nbsp;types&nbsp;the 
escape_character&nbsp;this&nbsp;method&nbsp;will&nbsp;stop.&nbsp;The&nbsp;default&nbsp;for 
escape_character&nbsp;is&nbsp;^].&nbsp;This&nbsp;should&nbsp;not&nbsp;be&nbsp;confused&nbsp;with&nbsp;ASCII&nbsp;27&nbsp;-- 
the&nbsp;ESC&nbsp;character.&nbsp;ASCII&nbsp;29&nbsp;was&nbsp;chosen&nbsp;for&nbsp;historical&nbsp;merit&nbsp;because 
this&nbsp;is&nbsp;the&nbsp;character&nbsp;used&nbsp;by&nbsp;'telnet'&nbsp;as&nbsp;the&nbsp;escape&nbsp;character.&nbsp;The 
escape_character&nbsp;will&nbsp;not&nbsp;be&nbsp;sent&nbsp;to&nbsp;the&nbsp;child&nbsp;process. 
&nbsp; 
You&nbsp;may&nbsp;pass&nbsp;in&nbsp;optional&nbsp;input&nbsp;and&nbsp;output&nbsp;filter&nbsp;functions.&nbsp;These 
functions&nbsp;should&nbsp;take&nbsp;a&nbsp;string&nbsp;and&nbsp;return&nbsp;a&nbsp;string.&nbsp;The&nbsp;output_filter 
will&nbsp;be&nbsp;passed&nbsp;all&nbsp;the&nbsp;output&nbsp;from&nbsp;the&nbsp;child&nbsp;process.&nbsp;The&nbsp;input_filter 
will&nbsp;be&nbsp;passed&nbsp;all&nbsp;the&nbsp;keyboard&nbsp;input&nbsp;from&nbsp;the&nbsp;user.&nbsp;The&nbsp;input_filter 
is&nbsp;run&nbsp;BEFORE&nbsp;the&nbsp;check&nbsp;for&nbsp;the&nbsp;escape_character. 
&nbsp; 
Note&nbsp;that&nbsp;if&nbsp;you&nbsp;change&nbsp;the&nbsp;window&nbsp;size&nbsp;of&nbsp;the&nbsp;parent&nbsp;the&nbsp;SIGWINCH 
signal&nbsp;will&nbsp;not&nbsp;be&nbsp;passed&nbsp;through&nbsp;to&nbsp;the&nbsp;child.&nbsp;If&nbsp;you&nbsp;want&nbsp;the&nbsp;child 
window&nbsp;size&nbsp;to&nbsp;change&nbsp;when&nbsp;the&nbsp;parent's&nbsp;window&nbsp;size&nbsp;changes&nbsp;then&nbsp;do 
something&nbsp;like&nbsp;the&nbsp;following&nbsp;example:: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;import&nbsp;pexpect,&nbsp;struct,&nbsp;fcntl,&nbsp;termios,&nbsp;signal,&nbsp;sys 
&nbsp;&nbsp;&nbsp;&nbsp;def&nbsp;sigwinch_passthrough&nbsp;(sig,&nbsp;data): 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s&nbsp;=&nbsp;struct.pack("HHHH",&nbsp;0,&nbsp;0,&nbsp;0,&nbsp;0) 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;a&nbsp;=&nbsp;struct.unpack('hhhh',&nbsp;fcntl.ioctl(sys.stdout.<a href="#pxssh-fileno">fileno</a>(),&nbsp;termios.TIOCGWINSZ&nbsp;,&nbsp;s)) 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;global&nbsp;p 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;p.<a href="#pxssh-setwinsize">setwinsize</a>(a[0],a[1]) 
&nbsp;&nbsp;&nbsp;&nbsp;p&nbsp;=&nbsp;pexpect.<a href="pexpect.html#spawn">spawn</a>('/bin/bash')&nbsp;#&nbsp;Note&nbsp;this&nbsp;is&nbsp;global&nbsp;and&nbsp;used&nbsp;in&nbsp;sigwinch_passthrough. 
&nbsp;&nbsp;&nbsp;&nbsp;signal.signal(signal.SIGWINCH,&nbsp;sigwinch_passthrough) 
&nbsp;&nbsp;&nbsp;&nbsp;p.<a href="#pxssh-interact">interact</a>()</tt></dd></dl>

<dl><dt><a name="pxssh-isalive">isalive</a>(self)</dt><dd><tt>This&nbsp;tests&nbsp;if&nbsp;the&nbsp;child&nbsp;process&nbsp;is&nbsp;running&nbsp;or&nbsp;not.&nbsp;This&nbsp;is 
non-blocking.&nbsp;If&nbsp;the&nbsp;child&nbsp;was&nbsp;terminated&nbsp;then&nbsp;this&nbsp;will&nbsp;read&nbsp;the 
exitstatus&nbsp;or&nbsp;signalstatus&nbsp;of&nbsp;the&nbsp;child.&nbsp;This&nbsp;returns&nbsp;True&nbsp;if&nbsp;the&nbsp;child 
process&nbsp;appears&nbsp;to&nbsp;be&nbsp;running&nbsp;or&nbsp;False&nbsp;if&nbsp;not.&nbsp;It&nbsp;can&nbsp;take&nbsp;literally 
SECONDS&nbsp;for&nbsp;Solaris&nbsp;to&nbsp;return&nbsp;the&nbsp;right&nbsp;status.</tt></dd></dl>

<dl><dt><a name="pxssh-isatty">isatty</a>(self)</dt><dd><tt>This&nbsp;returns&nbsp;True&nbsp;if&nbsp;the&nbsp;file&nbsp;descriptor&nbsp;is&nbsp;open&nbsp;and&nbsp;connected&nbsp;to&nbsp;a 
tty(-like)&nbsp;device,&nbsp;else&nbsp;False.</tt></dd></dl>

<dl><dt><a name="pxssh-kill">kill</a>(self, sig)</dt><dd><tt>This&nbsp;sends&nbsp;the&nbsp;given&nbsp;signal&nbsp;to&nbsp;the&nbsp;child&nbsp;application.&nbsp;In&nbsp;keeping 
with&nbsp;UNIX&nbsp;tradition&nbsp;it&nbsp;has&nbsp;a&nbsp;misleading&nbsp;name.&nbsp;It&nbsp;does&nbsp;not&nbsp;necessarily 
kill&nbsp;the&nbsp;child&nbsp;unless&nbsp;you&nbsp;send&nbsp;the&nbsp;right&nbsp;signal.</tt></dd></dl>

<dl><dt><a name="pxssh-next">next</a>(self)</dt><dd><tt>This&nbsp;is&nbsp;to&nbsp;support&nbsp;iterators&nbsp;over&nbsp;a&nbsp;file-like&nbsp;object.</tt></dd></dl>

<dl><dt><a name="pxssh-read">read</a>(self, size=-1)</dt><dd><tt>This&nbsp;reads&nbsp;at&nbsp;most&nbsp;"size"&nbsp;bytes&nbsp;from&nbsp;the&nbsp;file&nbsp;(less&nbsp;if&nbsp;the&nbsp;read&nbsp;hits 
EOF&nbsp;before&nbsp;obtaining&nbsp;size&nbsp;bytes).&nbsp;If&nbsp;the&nbsp;size&nbsp;argument&nbsp;is&nbsp;negative&nbsp;or 
omitted,&nbsp;read&nbsp;all&nbsp;data&nbsp;until&nbsp;EOF&nbsp;is&nbsp;reached.&nbsp;The&nbsp;bytes&nbsp;are&nbsp;returned&nbsp;as 
a&nbsp;string&nbsp;object.&nbsp;An&nbsp;empty&nbsp;string&nbsp;is&nbsp;returned&nbsp;when&nbsp;EOF&nbsp;is&nbsp;encountered 
immediately.</tt></dd></dl>

<dl><dt><a name="pxssh-read_nonblocking">read_nonblocking</a>(self, size=1, timeout=-1)</dt><dd><tt>This&nbsp;reads&nbsp;at&nbsp;most&nbsp;size&nbsp;characters&nbsp;from&nbsp;the&nbsp;child&nbsp;application.&nbsp;It 
includes&nbsp;a&nbsp;timeout.&nbsp;If&nbsp;the&nbsp;read&nbsp;does&nbsp;not&nbsp;complete&nbsp;within&nbsp;the&nbsp;timeout 
period&nbsp;then&nbsp;a&nbsp;TIMEOUT&nbsp;exception&nbsp;is&nbsp;raised.&nbsp;If&nbsp;the&nbsp;end&nbsp;of&nbsp;file&nbsp;is&nbsp;read 
then&nbsp;an&nbsp;EOF&nbsp;exception&nbsp;will&nbsp;be&nbsp;raised.&nbsp;If&nbsp;a&nbsp;log&nbsp;file&nbsp;was&nbsp;set&nbsp;using 
<a href="#pxssh-setlog">setlog</a>()&nbsp;then&nbsp;all&nbsp;data&nbsp;will&nbsp;also&nbsp;be&nbsp;written&nbsp;to&nbsp;the&nbsp;log&nbsp;file. 
&nbsp; 
If&nbsp;timeout&nbsp;is&nbsp;None&nbsp;then&nbsp;the&nbsp;read&nbsp;may&nbsp;block&nbsp;indefinitely.&nbsp;If&nbsp;timeout&nbsp;is&nbsp;-1 
then&nbsp;the&nbsp;self.timeout&nbsp;value&nbsp;is&nbsp;used.&nbsp;If&nbsp;timeout&nbsp;is&nbsp;0&nbsp;then&nbsp;the&nbsp;child&nbsp;is 
polled&nbsp;and&nbsp;if&nbsp;there&nbsp;was&nbsp;no&nbsp;data&nbsp;immediately&nbsp;ready&nbsp;then&nbsp;this&nbsp;will&nbsp;raise 
a&nbsp;TIMEOUT&nbsp;exception. 
&nbsp; 
The&nbsp;timeout&nbsp;refers&nbsp;only&nbsp;to&nbsp;the&nbsp;amount&nbsp;of&nbsp;time&nbsp;to&nbsp;read&nbsp;at&nbsp;least&nbsp;one 
character.&nbsp;This&nbsp;is&nbsp;not&nbsp;effected&nbsp;by&nbsp;the&nbsp;'size'&nbsp;parameter,&nbsp;so&nbsp;if&nbsp;you&nbsp;call 
<a href="#pxssh-read_nonblocking">read_nonblocking</a>(size=100,&nbsp;timeout=30)&nbsp;and&nbsp;only&nbsp;one&nbsp;character&nbsp;is 
available&nbsp;right&nbsp;away&nbsp;then&nbsp;one&nbsp;character&nbsp;will&nbsp;be&nbsp;returned&nbsp;immediately. 
It&nbsp;will&nbsp;not&nbsp;wait&nbsp;for&nbsp;30&nbsp;seconds&nbsp;for&nbsp;another&nbsp;99&nbsp;characters&nbsp;to&nbsp;come&nbsp;in. 
&nbsp; 
This&nbsp;is&nbsp;a&nbsp;wrapper&nbsp;around&nbsp;os.<a href="#pxssh-read">read</a>().&nbsp;It&nbsp;uses&nbsp;select.select()&nbsp;to 
implement&nbsp;the&nbsp;timeout.</tt></dd></dl>

<dl><dt><a name="pxssh-readline">readline</a>(self, size=-1)</dt><dd><tt>This&nbsp;reads&nbsp;and&nbsp;returns&nbsp;one&nbsp;entire&nbsp;line.&nbsp;A&nbsp;trailing&nbsp;newline&nbsp;is&nbsp;kept 
in&nbsp;the&nbsp;string,&nbsp;but&nbsp;may&nbsp;be&nbsp;absent&nbsp;when&nbsp;a&nbsp;file&nbsp;ends&nbsp;with&nbsp;an&nbsp;incomplete 
line.&nbsp;Note:&nbsp;This&nbsp;<a href="#pxssh-readline">readline</a>()&nbsp;looks&nbsp;for&nbsp;a&nbsp;\r\n&nbsp;pair&nbsp;even&nbsp;on&nbsp;UNIX 
because&nbsp;this&nbsp;is&nbsp;what&nbsp;the&nbsp;pseudo&nbsp;tty&nbsp;device&nbsp;returns.&nbsp;So&nbsp;contrary&nbsp;to&nbsp;what 
you&nbsp;may&nbsp;expect&nbsp;you&nbsp;will&nbsp;receive&nbsp;the&nbsp;newline&nbsp;as&nbsp;\r\n.&nbsp;An&nbsp;empty&nbsp;string 
is&nbsp;returned&nbsp;when&nbsp;EOF&nbsp;is&nbsp;hit&nbsp;immediately.&nbsp;Currently,&nbsp;the&nbsp;size&nbsp;argument&nbsp;is 
mostly&nbsp;ignored,&nbsp;so&nbsp;this&nbsp;behavior&nbsp;is&nbsp;not&nbsp;standard&nbsp;for&nbsp;a&nbsp;file-like 
object.&nbsp;If&nbsp;size&nbsp;is&nbsp;0&nbsp;then&nbsp;an&nbsp;empty&nbsp;string&nbsp;is&nbsp;returned.</tt></dd></dl>

<dl><dt><a name="pxssh-readlines">readlines</a>(self, sizehint=-1)</dt><dd><tt>This&nbsp;reads&nbsp;until&nbsp;EOF&nbsp;using&nbsp;<a href="#pxssh-readline">readline</a>()&nbsp;and&nbsp;returns&nbsp;a&nbsp;list&nbsp;containing 
the&nbsp;lines&nbsp;thus&nbsp;read.&nbsp;The&nbsp;optional&nbsp;"sizehint"&nbsp;argument&nbsp;is&nbsp;ignored.</tt></dd></dl>

<dl><dt><a name="pxssh-send">send</a>(self, s)</dt><dd><tt>This&nbsp;sends&nbsp;a&nbsp;string&nbsp;to&nbsp;the&nbsp;child&nbsp;process.&nbsp;This&nbsp;returns&nbsp;the&nbsp;number&nbsp;of 
bytes&nbsp;written.&nbsp;If&nbsp;a&nbsp;log&nbsp;file&nbsp;was&nbsp;set&nbsp;then&nbsp;the&nbsp;data&nbsp;is&nbsp;also&nbsp;written&nbsp;to 
the&nbsp;log.</tt></dd></dl>

<dl><dt><a name="pxssh-sendcontrol">sendcontrol</a>(self, char)</dt><dd><tt>This&nbsp;sends&nbsp;a&nbsp;control&nbsp;character&nbsp;to&nbsp;the&nbsp;child&nbsp;such&nbsp;as&nbsp;Ctrl-C&nbsp;or 
Ctrl-D.&nbsp;For&nbsp;example,&nbsp;to&nbsp;send&nbsp;a&nbsp;Ctrl-G&nbsp;(ASCII&nbsp;7):: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;child.<a href="#pxssh-sendcontrol">sendcontrol</a>('g') 
&nbsp; 
See&nbsp;also,&nbsp;<a href="#pxssh-sendintr">sendintr</a>()&nbsp;and&nbsp;<a href="#pxssh-sendeof">sendeof</a>().</tt></dd></dl>

<dl><dt><a name="pxssh-sendeof">sendeof</a>(self)</dt><dd><tt>This&nbsp;sends&nbsp;an&nbsp;EOF&nbsp;to&nbsp;the&nbsp;child.&nbsp;This&nbsp;sends&nbsp;a&nbsp;character&nbsp;which&nbsp;causes 
the&nbsp;pending&nbsp;parent&nbsp;output&nbsp;buffer&nbsp;to&nbsp;be&nbsp;sent&nbsp;to&nbsp;the&nbsp;waiting&nbsp;child 
program&nbsp;without&nbsp;waiting&nbsp;for&nbsp;end-of-line.&nbsp;If&nbsp;it&nbsp;is&nbsp;the&nbsp;first&nbsp;character 
of&nbsp;the&nbsp;line,&nbsp;the&nbsp;<a href="#pxssh-read">read</a>()&nbsp;in&nbsp;the&nbsp;user&nbsp;program&nbsp;returns&nbsp;0,&nbsp;which&nbsp;signifies 
end-of-file.&nbsp;This&nbsp;means&nbsp;to&nbsp;work&nbsp;as&nbsp;expected&nbsp;a&nbsp;<a href="#pxssh-sendeof">sendeof</a>()&nbsp;has&nbsp;to&nbsp;be 
called&nbsp;at&nbsp;the&nbsp;beginning&nbsp;of&nbsp;a&nbsp;line.&nbsp;This&nbsp;method&nbsp;does&nbsp;not&nbsp;send&nbsp;a&nbsp;newline. 
It&nbsp;is&nbsp;the&nbsp;responsibility&nbsp;of&nbsp;the&nbsp;caller&nbsp;to&nbsp;ensure&nbsp;the&nbsp;eof&nbsp;is&nbsp;sent&nbsp;at&nbsp;the 
beginning&nbsp;of&nbsp;a&nbsp;line.</tt></dd></dl>

<dl><dt><a name="pxssh-sendintr">sendintr</a>(self)</dt><dd><tt>This&nbsp;sends&nbsp;a&nbsp;SIGINT&nbsp;to&nbsp;the&nbsp;child.&nbsp;It&nbsp;does&nbsp;not&nbsp;require 
the&nbsp;SIGINT&nbsp;to&nbsp;be&nbsp;the&nbsp;first&nbsp;character&nbsp;on&nbsp;a&nbsp;line.</tt></dd></dl>

<dl><dt><a name="pxssh-sendline">sendline</a>(self, s='')</dt><dd><tt>This&nbsp;is&nbsp;like&nbsp;<a href="#pxssh-send">send</a>(),&nbsp;but&nbsp;it&nbsp;adds&nbsp;a&nbsp;line&nbsp;feed&nbsp;(os.linesep).&nbsp;This 
returns&nbsp;the&nbsp;number&nbsp;of&nbsp;bytes&nbsp;written.</tt></dd></dl>

<dl><dt><a name="pxssh-setecho">setecho</a>(self, state)</dt><dd><tt>This&nbsp;sets&nbsp;the&nbsp;terminal&nbsp;echo&nbsp;mode&nbsp;on&nbsp;or&nbsp;off.&nbsp;Note&nbsp;that&nbsp;anything&nbsp;the 
child&nbsp;sent&nbsp;before&nbsp;the&nbsp;echo&nbsp;will&nbsp;be&nbsp;lost,&nbsp;so&nbsp;you&nbsp;should&nbsp;be&nbsp;sure&nbsp;that 
your&nbsp;input&nbsp;buffer&nbsp;is&nbsp;empty&nbsp;before&nbsp;you&nbsp;call&nbsp;<a href="#pxssh-setecho">setecho</a>().&nbsp;For&nbsp;example,&nbsp;the 
following&nbsp;will&nbsp;work&nbsp;as&nbsp;expected:: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;p&nbsp;=&nbsp;pexpect.<a href="pexpect.html#spawn">spawn</a>('cat') 
&nbsp;&nbsp;&nbsp;&nbsp;p.sendline&nbsp;('1234')&nbsp;#&nbsp;We&nbsp;will&nbsp;see&nbsp;this&nbsp;twice&nbsp;(once&nbsp;from&nbsp;tty&nbsp;echo&nbsp;and&nbsp;again&nbsp;from&nbsp;cat). 
&nbsp;&nbsp;&nbsp;&nbsp;p.expect&nbsp;(['1234']) 
&nbsp;&nbsp;&nbsp;&nbsp;p.expect&nbsp;(['1234']) 
&nbsp;&nbsp;&nbsp;&nbsp;p.<a href="#pxssh-setecho">setecho</a>(False)&nbsp;#&nbsp;Turn&nbsp;off&nbsp;tty&nbsp;echo 
&nbsp;&nbsp;&nbsp;&nbsp;p.sendline&nbsp;('abcd')&nbsp;#&nbsp;We&nbsp;will&nbsp;set&nbsp;this&nbsp;only&nbsp;once&nbsp;(echoed&nbsp;by&nbsp;cat). 
&nbsp;&nbsp;&nbsp;&nbsp;p.sendline&nbsp;('wxyz')&nbsp;#&nbsp;We&nbsp;will&nbsp;set&nbsp;this&nbsp;only&nbsp;once&nbsp;(echoed&nbsp;by&nbsp;cat) 
&nbsp;&nbsp;&nbsp;&nbsp;p.expect&nbsp;(['abcd']) 
&nbsp;&nbsp;&nbsp;&nbsp;p.expect&nbsp;(['wxyz']) 
&nbsp; 
The&nbsp;following&nbsp;WILL&nbsp;NOT&nbsp;WORK&nbsp;because&nbsp;the&nbsp;lines&nbsp;sent&nbsp;before&nbsp;the&nbsp;setecho 
will&nbsp;be&nbsp;lost:: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;p&nbsp;=&nbsp;pexpect.<a href="pexpect.html#spawn">spawn</a>('cat') 
&nbsp;&nbsp;&nbsp;&nbsp;p.sendline&nbsp;('1234')&nbsp;#&nbsp;We&nbsp;will&nbsp;see&nbsp;this&nbsp;twice&nbsp;(once&nbsp;from&nbsp;tty&nbsp;echo&nbsp;and&nbsp;again&nbsp;from&nbsp;cat). 
&nbsp;&nbsp;&nbsp;&nbsp;p.<a href="#pxssh-setecho">setecho</a>(False)&nbsp;#&nbsp;Turn&nbsp;off&nbsp;tty&nbsp;echo 
&nbsp;&nbsp;&nbsp;&nbsp;p.sendline&nbsp;('abcd')&nbsp;#&nbsp;We&nbsp;will&nbsp;set&nbsp;this&nbsp;only&nbsp;once&nbsp;(echoed&nbsp;by&nbsp;cat). 
&nbsp;&nbsp;&nbsp;&nbsp;p.sendline&nbsp;('wxyz')&nbsp;#&nbsp;We&nbsp;will&nbsp;set&nbsp;this&nbsp;only&nbsp;once&nbsp;(echoed&nbsp;by&nbsp;cat) 
&nbsp;&nbsp;&nbsp;&nbsp;p.expect&nbsp;(['1234']) 
&nbsp;&nbsp;&nbsp;&nbsp;p.expect&nbsp;(['1234']) 
&nbsp;&nbsp;&nbsp;&nbsp;p.expect&nbsp;(['abcd']) 
&nbsp;&nbsp;&nbsp;&nbsp;p.expect&nbsp;(['wxyz'])</tt></dd></dl>

<dl><dt><a name="pxssh-setlog">setlog</a>(self, fileobject)</dt><dd><tt>This&nbsp;method&nbsp;is&nbsp;no&nbsp;longer&nbsp;supported&nbsp;or&nbsp;allowed.</tt></dd></dl>

<dl><dt><a name="pxssh-setmaxread">setmaxread</a>(self, maxread)</dt><dd><tt>This&nbsp;method&nbsp;is&nbsp;no&nbsp;longer&nbsp;supported&nbsp;or&nbsp;allowed.&nbsp;I&nbsp;don't&nbsp;like&nbsp;getters 
and&nbsp;setters&nbsp;without&nbsp;a&nbsp;good&nbsp;reason.</tt></dd></dl>

<dl><dt><a name="pxssh-setwinsize">setwinsize</a>(self, r, c)</dt><dd><tt>This&nbsp;sets&nbsp;the&nbsp;terminal&nbsp;window&nbsp;size&nbsp;of&nbsp;the&nbsp;child&nbsp;tty.&nbsp;This&nbsp;will&nbsp;cause 
a&nbsp;SIGWINCH&nbsp;signal&nbsp;to&nbsp;be&nbsp;sent&nbsp;to&nbsp;the&nbsp;child.&nbsp;This&nbsp;does&nbsp;not&nbsp;change&nbsp;the 
physical&nbsp;window&nbsp;size.&nbsp;It&nbsp;changes&nbsp;the&nbsp;size&nbsp;reported&nbsp;to&nbsp;TTY-aware 
applications&nbsp;like&nbsp;vi&nbsp;or&nbsp;curses&nbsp;--&nbsp;applications&nbsp;that&nbsp;respond&nbsp;to&nbsp;the 
SIGWINCH&nbsp;signal.</tt></dd></dl>

<dl><dt><a name="pxssh-terminate">terminate</a>(self, force=False)</dt><dd><tt>This&nbsp;forces&nbsp;a&nbsp;child&nbsp;process&nbsp;to&nbsp;terminate.&nbsp;It&nbsp;starts&nbsp;nicely&nbsp;with 
SIGHUP&nbsp;and&nbsp;SIGINT.&nbsp;If&nbsp;"force"&nbsp;is&nbsp;True&nbsp;then&nbsp;moves&nbsp;onto&nbsp;SIGKILL.&nbsp;This 
returns&nbsp;True&nbsp;if&nbsp;the&nbsp;child&nbsp;was&nbsp;terminated.&nbsp;This&nbsp;returns&nbsp;False&nbsp;if&nbsp;the 
child&nbsp;could&nbsp;not&nbsp;be&nbsp;terminated.</tt></dd></dl>

<dl><dt><a name="pxssh-wait">wait</a>(self)</dt><dd><tt>This&nbsp;waits&nbsp;until&nbsp;the&nbsp;child&nbsp;exits.&nbsp;This&nbsp;is&nbsp;a&nbsp;blocking&nbsp;call.&nbsp;This&nbsp;will 
not&nbsp;read&nbsp;any&nbsp;data&nbsp;from&nbsp;the&nbsp;child,&nbsp;so&nbsp;this&nbsp;will&nbsp;block&nbsp;forever&nbsp;if&nbsp;the 
child&nbsp;has&nbsp;unread&nbsp;output&nbsp;and&nbsp;has&nbsp;terminated.&nbsp;In&nbsp;other&nbsp;words,&nbsp;the&nbsp;child 
may&nbsp;have&nbsp;printed&nbsp;output&nbsp;then&nbsp;called&nbsp;exit();&nbsp;but,&nbsp;technically,&nbsp;the&nbsp;child 
is&nbsp;still&nbsp;alive&nbsp;until&nbsp;its&nbsp;output&nbsp;is&nbsp;read.</tt></dd></dl>

<dl><dt><a name="pxssh-waitnoecho">waitnoecho</a>(self, timeout=-1)</dt><dd><tt>This&nbsp;waits&nbsp;until&nbsp;the&nbsp;terminal&nbsp;ECHO&nbsp;flag&nbsp;is&nbsp;set&nbsp;False.&nbsp;This&nbsp;returns 
True&nbsp;if&nbsp;the&nbsp;echo&nbsp;mode&nbsp;is&nbsp;off.&nbsp;This&nbsp;returns&nbsp;False&nbsp;if&nbsp;the&nbsp;ECHO&nbsp;flag&nbsp;was 
not&nbsp;set&nbsp;False&nbsp;before&nbsp;the&nbsp;timeout.&nbsp;This&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;detect&nbsp;when&nbsp;the 
child&nbsp;is&nbsp;waiting&nbsp;for&nbsp;a&nbsp;password.&nbsp;Usually&nbsp;a&nbsp;child&nbsp;application&nbsp;will&nbsp;turn 
off&nbsp;echo&nbsp;mode&nbsp;when&nbsp;it&nbsp;is&nbsp;waiting&nbsp;for&nbsp;the&nbsp;user&nbsp;to&nbsp;enter&nbsp;a&nbsp;password.&nbsp;For 
example,&nbsp;instead&nbsp;of&nbsp;expecting&nbsp;the&nbsp;"password:"&nbsp;prompt&nbsp;you&nbsp;can&nbsp;wait&nbsp;for 
the&nbsp;child&nbsp;to&nbsp;set&nbsp;ECHO&nbsp;off:: 
&nbsp; 
&nbsp;&nbsp;&nbsp;&nbsp;p&nbsp;=&nbsp;pexpect.<a href="pexpect.html#spawn">spawn</a>&nbsp;('ssh&nbsp;user@example.com') 
&nbsp;&nbsp;&nbsp;&nbsp;p.<a href="#pxssh-waitnoecho">waitnoecho</a>() 
&nbsp;&nbsp;&nbsp;&nbsp;p.<a href="#pxssh-sendline">sendline</a>(mypassword) 
&nbsp; 
If&nbsp;timeout&nbsp;is&nbsp;None&nbsp;then&nbsp;this&nbsp;method&nbsp;to&nbsp;block&nbsp;forever&nbsp;until&nbsp;ECHO&nbsp;flag&nbsp;is 
False.</tt></dd></dl>

<dl><dt><a name="pxssh-write">write</a>(self, s)</dt><dd><tt>This&nbsp;is&nbsp;similar&nbsp;to&nbsp;<a href="#pxssh-send">send</a>()&nbsp;except&nbsp;that&nbsp;there&nbsp;is&nbsp;no&nbsp;return&nbsp;value.</tt></dd></dl>

<dl><dt><a name="pxssh-writelines">writelines</a>(self, sequence)</dt><dd><tt>This&nbsp;calls&nbsp;<a href="#pxssh-write">write</a>()&nbsp;for&nbsp;each&nbsp;element&nbsp;in&nbsp;the&nbsp;sequence.&nbsp;The&nbsp;sequence 
can&nbsp;be&nbsp;any&nbsp;iterable&nbsp;object&nbsp;producing&nbsp;strings,&nbsp;typically&nbsp;a&nbsp;list&nbsp;of 
strings.&nbsp;This&nbsp;does&nbsp;not&nbsp;add&nbsp;line&nbsp;separators&nbsp;There&nbsp;is&nbsp;no&nbsp;return&nbsp;value.</tt></dd></dl>

<hr>
Data descriptors inherited from <a href="pexpect.html#spawn">pexpect.spawn</a>: 
<dl><dt>__dict__</dt>
<dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
</dl>
<dl><dt>__weakref__</dt>
<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
</dl>
</td></tr></table></td></tr></table>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#55aa55">
<td colspan=3 valign=bottom>&nbsp; 
<big>Data</big></td></tr>
 
<tr><td bgcolor="#55aa55"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
<td width="100%">__all__ = ['ExceptionPxssh', 'pxssh'] 
__revision__ = '$Revision: 399 $' 
__version__ = '2.3'</td></tr></table>
</body></html>

文件操作 - pxssh.html

文件: /usr/share/doc/pexpect-2.3/doc/pxssh.html

编辑文件内容

修改文件时间

删除文件