source: general/prog/expect.xml@ 47274444

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 47274444 was 47274444, checked in by Pierre Labastie <pieere@…>, 4 years ago

Format postlfs/security and misc/forgotten

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