source: general/prog/expect.xml@ 0aeb696

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 0aeb696 was 0aeb696, checked in by Randy McMurchy <randy@…>, 18 years ago

Added a comment to each file that may need a mention of a test suite added to it, this allows closing of bug #1697

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5951 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 15.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!-- Inserted as a reminder to do this. The mention of a test suite
8 is usually right before the root user installation commands. Please
9 delete these 12 (including one blank) lines after you are done.-->
10
11 <!-- Use one of the two mentions below about a test suite,
12 delete the line that is not applicable. Of course, if the
13 test suite uses syntax other than "make check", revise the
14 line to reflect the actual syntax to run the test suite -->
15
16 <!-- <para>This package does not come with a test suite.</para> -->
17 <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
18
19 <!ENTITY expect-download-http "http://expect.nist.gov/old/expect-&expect-version;.tar.gz">
20 <!ENTITY expect-download-ftp " ">
21 <!ENTITY expect-md5sum "230400129630335b3060a42f66fec11d">
22 <!ENTITY expect-size "525 KB">
23 <!ENTITY expect-buildsize "4.6 MB">
24 <!ENTITY expect-time "0.07 SBU">
25]>
26
27<sect1 id="expect" xreflabel="Expect-&expect-version;">
28 <?dbhtml filename="expect.html"?>
29
30 <sect1info>
31 <othername>$LastChangedBy$</othername>
32 <date>$Date$</date>
33 <keywordset>
34 <keyword role="package">expect-&expect-version;.tar</keyword>
35 <keyword role="ftpdir">expect</keyword>
36 </keywordset>
37 </sect1info>
38
39 <title>Expect-&expect-version;</title>
40
41 <indexterm zone="expect">
42 <primary sortas="a-Expect">Expect</primary>
43 </indexterm>
44
45 <sect2 role="package">
46 <title>Introduction to Expect</title>
47
48 <para>The <application>Expect</application> package contains tools for
49 automating interactive applications such as <command>telnet</command>,
50 <command>ftp</command>, <command>passwd</command>,
51 <command>fsck</command>, <command>rlogin</command>,
52 <command>tip</command>, etc. <application>Expect</application> is
53 also useful for testing these same applications as well as easing all sorts of
54 tasks that are prohibitively difficult with anything else.</para>
55
56 <bridgehead renderas="sect3">Package Information</bridgehead>
57 <itemizedlist spacing="compact">
58 <listitem>
59 <para>Download (HTTP): <ulink url="&expect-download-http;"/></para>
60 </listitem>
61 <listitem>
62 <para>Download (FTP): <ulink url="&expect-download-ftp;"/></para>
63 </listitem>
64 <listitem>
65 <para>Download MD5 sum: &expect-md5sum;</para>
66 </listitem>
67 <listitem>
68 <para>Download size: &expect-size;</para>
69 </listitem>
70 <listitem>
71 <para>Estimated disk space required: &expect-buildsize;</para>
72 </listitem>
73 <listitem>
74 <para>Estimated build time: &expect-time;</para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79 <itemizedlist spacing="compact">
80 <listitem>
81 <para>Required Patch: <ulink
82 url="&patch-root;/expect-&expect-version;-spawn-2.patch"/></para>
83 </listitem>
84 </itemizedlist>
85
86 <bridgehead renderas="sect3">Expect Dependencies</bridgehead>
87
88 <bridgehead renderas="sect4">Required</bridgehead>
89 <para role="required"><xref linkend="tcl"/></para>
90
91 <bridgehead renderas="sect4">Optional</bridgehead>
92 <para role="optional"><xref linkend="tk"/></para>
93
94 <para condition="html" role="usernotes">User Notes:
95 <ulink url="&blfs-wiki;/expect"/></para>
96
97 </sect2>
98
99 <sect2 role="installation">
100 <title>Installation of Expect</title>
101
102 <para>Install <application>Expect</application> by running the following
103 commands:</para>
104
105<screen><userinput>patch -Np1 -i ../expect-&expect-version;-spawn-2.patch &amp;&amp;
106./configure --prefix=/usr --with-tcl=/usr/lib \
107 --with-tclinclude=/usr/include/tcl8.4 --enable-shared &amp;&amp;
108make</userinput></screen>
109
110 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
111
112<screen role="root"><userinput>make install &amp;&amp;
113ln -sf ../libexpect5.43.a /usr/lib/expect5.43</userinput></screen>
114
115 </sect2>
116
117 <sect2 role="commands">
118 <title>Command Explanations</title>
119
120 <para><parameter>--enable-shared</parameter>: This option enables
121 building the shared library.</para>
122
123 <para><option>--with-tk=/usr/lib</option>: Use this option to link in the
124 <application>Tk</application> library.</para>
125
126 <para><command>ln -sf ../libexpect5.43.a /usr/lib/expect5.43</command>: This
127 command creates a required link to the static library.</para>
128
129 </sect2>
130
131 <sect2 role="configuration">
132 <title>Configuring Expect</title>
133
134 <sect3 id="expect-config">
135 <title>Config Files</title>
136
137 <para><filename>$exp_library/expect.rc</filename> and
138 <filename>~/.expect.rc</filename></para>
139
140 <indexterm zone="expect expect-config">
141 <primary sortas="e-AA.expect.rc">~/.expect.rc</primary>
142 </indexterm>
143
144 <indexterm zone="expect expect-config">
145 <primary sortas="e-Aexp_library-expect.rc">$exp_library/expect.rc</primary>
146 </indexterm>
147
148 </sect3>
149
150 <sect3>
151 <title>Configuration Information</title>
152
153 <para>Reference the <command>expect</command> man page for information about
154 utilizing the <filename>expect.rc</filename> configuration files. Additionally,
155 many of the tools contained in the <application>Expect</application> package
156 will use their own configuration files. Reference the respective man page, or
157 examine the script directly for configuration file information.</para>
158
159 </sect3>
160
161 </sect2>
162
163 <sect2 role="content">
164 <title>Contents</title>
165
166 <segmentedlist>
167 <segtitle>Installed Programs</segtitle>
168 <segtitle>Installed Library</segtitle>
169 <segtitle>Installed Directory</segtitle>
170
171 <seglistitem>
172 <seg>autoexpect, autopasswd, cryptdir, decryptdir, dislocate, expect, ftp-rfc,
173 kibitz, lpunlock, mkpasswd, passmass, rftp, rlogin-cwd, timed-read, timed-run,
174 unbuffer, weather, and optionally (if <application>Expect</application> was
175 linked against <application>Tk</application>), expectk, multixterm,
176 tknewsbiff, tkpasswd, xkibitz, and xpstat</seg>
177 <seg>libexpect5.43.{so,a}</seg>
178 <seg>/usr/lib/expect5.43</seg>
179 </seglistitem>
180 </segmentedlist>
181
182 <variablelist>
183 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
184 <?dbfo list-presentation="list"?>
185 <?dbhtml list-presentation="table"?>
186
187 <varlistentry id="autoexpect">
188 <term><command>autoexpect</command></term>
189 <listitem>
190 <para>generates an <application>Expect</application> script from
191 watching a session.</para>
192 <indexterm zone="expect autoexpect">
193 <primary sortas="b-autoexpect">autoexpect</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry id="autopasswd">
199 <term><command>autopasswd</command></term>
200 <listitem>
201 <para>is a wrapper to make <command>passwd</command>(1) be
202 non-interactive.</para>
203 <indexterm zone="expect autopasswd">
204 <primary sortas="b-autopasswd">autopasswd</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="cryptdir">
210 <term><command>cryptdir</command></term>
211 <listitem>
212 <para>encrypts all files in a directory.</para>
213 <indexterm zone="expect cryptdir">
214 <primary sortas="b-cryptdir">cryptdir</primary>
215 </indexterm>
216 </listitem>
217 </varlistentry>
218
219 <varlistentry id="decryptdir">
220 <term><command>decryptdir</command></term>
221 <listitem>
222 <para>decrypts all files in a directory.</para>
223 <indexterm zone="expect decryptdir">
224 <primary sortas="b-decryptdir">decryptdir</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="dislocate">
230 <term><command>dislocate</command></term>
231 <listitem>
232 <para>allows processes to be disconnected and reconnected to a
233 terminal.</para>
234 <indexterm zone="expect dislocate">
235 <primary sortas="b-dislocate">dislocate</primary>
236 </indexterm>
237 </listitem>
238 </varlistentry>
239
240 <varlistentry id="expect-prog">
241 <term><command>expect</command></term>
242 <listitem>
243 <para>is a program that <quote>talks</quote> to other interactive
244 programs according to a script.</para>
245 <indexterm zone="expect expect-prog">
246 <primary sortas="b-expect">expect</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 <varlistentry id="ftp-rfc">
252 <term><command>ftp-rfc</command></term>
253 <listitem>
254 <para>retrieves an RFC (or the index) from UUNET.</para>
255 <indexterm zone="expect ftp-rfc">
256 <primary sortas="b-ftp-rfc">ftp-rfc</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 <varlistentry id="kibitz">
262 <term><command>kibitz</command></term>
263 <listitem>
264 <para>allows two (or more) people to interact with one shell
265 (or any arbitrary program).</para>
266 <indexterm zone="expect kibitz">
267 <primary sortas="b-kibitz">kibitz</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="lpunlock">
273 <term><command>lpunlock</command></term>
274 <listitem>
275 <para>unhangs a printer which claims it is <quote>waiting for
276 lock</quote>.</para>
277 <indexterm zone="expect lpunlock">
278 <primary sortas="b-lpunlock">lpunlock</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="mkpasswd">
284 <term><command>mkpasswd</command></term>
285 <listitem>
286 <para>generates passwords and can apply them automatically to
287 users.</para>
288 <indexterm zone="expect mkpasswd">
289 <primary sortas="b-mkpasswd">mkpasswd</primary>
290 </indexterm>
291 </listitem>
292 </varlistentry>
293
294 <varlistentry id="passmass">
295 <term><command>passmass</command></term>
296 <listitem>
297 <para>changes a password on multiple machines.</para>
298 <indexterm zone="expect passmass">
299 <primary sortas="b-passmass">passmass</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="rftp">
305 <term><command>rftp</command></term>
306 <listitem>
307 <para>is much like <command>ftp</command> except it uses
308 <option>~g</option> and <option>~p</option> instead of
309 <option>mget</option> and <option>mput</option>.</para>
310 <indexterm zone="expect rftp">
311 <primary sortas="b-rftp">rftp</primary>
312 </indexterm>
313 </listitem>
314 </varlistentry>
315
316 <varlistentry id="rlogin-cwd">
317 <term><command>rlogin-cwd</command></term>
318 <listitem>
319 <para>is <command>rlogin</command> except it uses the local current
320 directory as the current working directory on the remote machine.</para>
321 <indexterm zone="expect rlogin-cwd">
322 <primary sortas="b-rlogin-cwd">rlogin-cwd</primary>
323 </indexterm>
324 </listitem>
325 </varlistentry>
326
327 <varlistentry id="timed-read">
328 <term><command>timed-read</command></term>
329 <listitem>
330 <para> reads a complete line from stdin and aborts after a given
331 number of seconds.</para>
332 <indexterm zone="expect timed-read">
333 <primary sortas="b-timed-read">timed-read</primary>
334 </indexterm>
335 </listitem>
336 </varlistentry>
337
338 <varlistentry id="timed-run">
339 <term><command>timed-run</command></term>
340 <listitem>
341 <para>runs a program for a given amount of time.</para>
342 <indexterm zone="expect timed-run">
343 <primary sortas="b-timed-run">timed-run</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="unbuffer">
349 <term><command>unbuffer</command></term>
350 <listitem>
351 <para>disables the output buffering that occurs when program output
352 is redirected.</para>
353 <indexterm zone="expect unbuffer">
354 <primary sortas="b-unbuffer">unbuffer</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="weather">
360 <term><command>weather</command></term>
361 <listitem>
362 <para>retrieves a weather report (courtesy University of Michigan)
363 for a given city or geographical area.</para>
364 <indexterm zone="expect weather">
365 <primary sortas="b-weather">weather</primary>
366 </indexterm>
367 </listitem>
368 </varlistentry>
369
370 <varlistentry id="expectk">
371 <term><command>expectk</command></term>
372 <listitem>
373 <para>is a combination of <application>Expect</application> with
374 <application>Tk</application> and should run any <command>wish</command>
375 or <application>Expect</application> script.</para>
376 <indexterm zone="expect expectk">
377 <primary sortas="b-expectk">expectk</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381
382 <varlistentry id="multixterm">
383 <term><command>multixterm</command></term>
384 <listitem>
385 <para>creates multiple <command>xterm</command>s that can be driven
386 together or separately.</para>
387 <indexterm zone="expect multixterm">
388 <primary sortas="b-multixterm">multixterm</primary>
389 </indexterm>
390 </listitem>
391 </varlistentry>
392
393 <varlistentry id="tknewsbiff">
394 <term><command>tknewsbiff</command></term>
395 <listitem>
396 <para>pops up a window when there is unread news in your favorite
397 newsgroups and removes the window after you've read the news.</para>
398 <indexterm zone="expect tknewsbiff">
399 <primary sortas="b-tknewsbiff">tknewsbiff</primary>
400 </indexterm>
401 </listitem>
402 </varlistentry>
403
404 <varlistentry id="tkpasswd">
405 <term><command>tkpasswd</command></term>
406 <listitem>
407 <para>is a script to change passwords using
408 <command>expectk</command>.</para>
409 <indexterm zone="expect tkpasswd">
410 <primary sortas="b-tkpasswd">tkpasswd</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="xkibitz">
416 <term><command>xkibitz</command></term>
417 <listitem>
418 <para>allows users in separate <command>xterm</command>s to share
419 one shell (or any program that runs in an <command>xterm</command>).</para>
420 <indexterm zone="expect xkibitz">
421 <primary sortas="b-xkibitz">xkibitz</primary>
422 </indexterm>
423 </listitem>
424 </varlistentry>
425
426 <varlistentry id="xpstat">
427 <term><command>xpstat</command></term>
428 <listitem>
429 <para>is a script that acts as a front-end for <command>xpilot</command>.</para>
430 <indexterm zone="expect xpstat">
431 <primary sortas="b-xpstat">xpstat</primary>
432 </indexterm>
433 </listitem>
434 </varlistentry>
435
436 <varlistentry id="libexpect">
437 <term><filename class='libraryfile'>libexpect5.43.{so,a}</filename></term>
438 <listitem>
439 <para> contains functions that allow <application>Expect</application> to be
440 used as a <application>Tcl</application> extension or to be used directly from
441 C or C++ (without <application>Tcl</application>).</para>
442 <indexterm zone="expect libexpect">
443 <primary sortas="c-libexpect5.43">libexpect5.43.{so,a}</primary>
444 </indexterm>
445 </listitem>
446 </varlistentry>
447
448 </variablelist>
449
450 </sect2>
451
452</sect1>
453
Note: See TracBrowser for help on using the repository browser.