.TH EXPECT 1 "29 December 1994" .SH "نام (NAME)" expect \- گفتگوی برنامه‌ریزی‌شده با برنامه‌های تعاملی، نسخه ۵ .SH "خلاصه دستور (SYNOPSIS)" .B expect [ .B \-dDinN ] [ .B \-c .I cmds ] [ [ .BR \- [ f | b ] ] .I cmdfile ] [ .I args ] .SH "مقدمه (INTRODUCTION)" .B Expect برنامه‌ای است که بر اساس یک اسکریپت با سایر برنامه‌های تعاملی «گفتگو» می‌کند. با دنبال کردن اسکریپت، .B Expect می‌داند چه انتظاری می‌توان از یک برنامه داشت و پاسخ درست چه باید باشد. یک زبان مفسری، ساختارهای کنترلی سطح بالا و انشعاب را برای هدایت گفتگو فراهم می‌کند. علاوه بر این، کاربر می‌تواند در صورت تمایل کنترل را به دست بگیرد و مستقیماً تعامل کند، و پس از آن کنترل را دوباره به اسکریپت بازگرداند. .PP .B Expectk ترکیبی از .B Expect و .B Tk است. رفتاری دقیقاً مشابه .B Expect و دستور .B wish مربوط به .B Tk دارد. همچنین می‌توان از .B Expect مستقیماً در C یا C++ (یعنی بدون Tcl) استفاده کرد. مدخل libexpect(3) را ببینید. .PP نام «Expect» از ایده توالی‌های .I send/expect گرفته شده که توسط uucp، kermit و سایر برنامه‌های کنترل مودم محبوبیت یافت. با این حال بر خلاف uucp، ابزار .B Expect عمومیت یافته است تا بتوان آن را به عنوان یک دستور در سطح کاربر برای هر برنامه و هدفی اجرا کرد. .B Expect در واقع می‌تواند هم‌زمان با چندین برنامه گفتگو کند. .PP به عنوان مثال، در اینجا برخی از کارهایی که .B Expect می‌تواند انجام دهد آورده شده است: .RS .TP 4 \(bu کاری کند که رایانه با شما تماس معکوس برقرار کند، تا بتوانید بدون پرداخت هزینه تماس وارد سیستم شوید. .TP \(bu یک بازی را آغاز کند (مانند rogue) و اگر پیکربندی بهینه ایجاد نشد، آن را (بارها و بارها) بازراه‌اندازی کند تا زمانی که ایجاد شود، سپس کنترل را به شما بسپارد. .TP \(bu دستور fsck را اجرا کند، و در پاسخ به پرسش‌های آن، بر اساس معیارهای از پیش تعیین‌شده پاسخ «yes» یا «no» بدهد یا کنترل را به شما بازگرداند. .TP \(bu به شبکه یا BBS دیگری (مانند MCI Mail یا CompuServe) متصل شود و نامه‌های شما را به طور خودکار دریافت کند تا به گونه‌ای به نظر برسد که در اصل به سیستم محلی شما ارسال شده است. .TP \(bu متغیرهای محیطی، دایرکتوری جاری، یا هر گونه اطلاعاتی را در بسترهایی چون rlogin، telnet، tip، su، chgrp و غیره منتقل کند. .RE .PP دلایل گوناگونی وجود دارد که چرا شل (shell) نمی‌تواند این وظایف را انجام دهد. (امتحان کنید، متوجه خواهید شد.) همه این‌ها با .B Expect امکان‌پذیر است. .PP به طور کلی، .B Expect برای اجرای هر برنامه‌ای که به تعامل بین برنامه و کاربر نیاز دارد، مفید است. تنها چیزی که نیاز است این است که بتوان این تعامل را به صورت برنامه‌ریزی‌شده توصیف کرد. همچنین در صورت تمایل، .B Expect می‌تواند کنترل را به کاربر بازگرداند (بدون متوقف کردن برنامه‌ای که کنترل می‌شود). به همین ترتیب، کاربر می‌تواند در هر زمانی کنترل را دوباره به اسکریپت برگرداند. .SH "نحوه استفاده (USAGE)" .B Expect فایل .I cmdfile را برای فهرستی از دستورها جهت اجرا می‌خواند. همچنین می‌توان .B Expect را در سیستم‌هایی که از نماد #! پشتیبانی می‌کنند، با نشانه‌گذاری اسکریپت به عنوان قابل اجرا و قرار دادن خط زیر به عنوان خط نخست اسکریپت، به صورت ضمنی فراخوانی کرد: #!/usr/local/bin/expect \-f البته، مسیر باید دقیقاً محل قرارگیری .B Expect را مشخص کند. /usr/local/bin تنها یک مثال است. پرچم .B \-c پیشوند دستوری است که باید پیش از هر دستور دیگری در اسکریپت اجرا شود. دستور باید داخل علامت نقل‌قول قرار گیرد تا از تجزیه شدن آن توسط شل جلوگیری شود. از این گزینه می‌توان چندین بار استفاده کرد. با جدا کردن دستورها به وسیله نقطه‌ویرگول، می‌توان چندین دستور را با یک پرچم .B \-c واحد اجرا کرد. دستورها به همان ترتیبی که نوشته شده‌اند اجرا می‌شوند. (هنگام استفاده از Expectk، این گزینه با .B \-command مشخص می‌شود.) .PP پرچم .B \-d برخی خروجی‌های عیب‌یابی را فعال می‌کند که عمدتاً فعالیت داخلی دستورهایی مانند .B expect و .B interact را گزارش می‌دهد. این پرچم اثری مشابه «exp_internal 1» در آغاز یک اسکریپت Expect دارد، به علاوه این‌که نسخه .B Expect نیز چاپ می‌شود. (دستور .B strace برای ردگیری دستورها، و دستور .B trace برای ردگیری انتساب‌های متغیرها مفید است.) (هنگام استفاده از Expectk، این گزینه با .B \-diag مشخص می‌شود.) .PP پرچم .B \-D یک اشکال‌زدا (debugger) تعاملی را فعال می‌کند. یک مقدار عدد صحیح باید پس از آن بیاید. اگر این مقدار غیرصفر باشد، یا اگر ^C فشرده شود (یا به یک نقطه توقف برخورد شود، یا دستور اشکال‌زدایی مناسب دیگری در اسکریپت پدیدار شود)، اشکال‌زدا پیش از رویه Tcl بعدی کنترل را به دست می‌گیرد. برای اطلاعات بیشتر درباره اشکال‌زدا، فایل README یا بخش «همچنین ببینید» (در ادامه) را ببینید. (هنگام استفاده از Expectk، این گزینه با .B \-Debug مشخص می‌شود.) .PP پرچم .B \-f پیشوند فایلی است که دستورها از آن خوانده می‌شوند. خود پرچم اختیاری است، زیرا تنها زمانی کاربرد دارد که از نماد #! (به بالا مراجعه کنید) استفاده شود، تا بتوان آرگومان‌های دیگری را در خط فرمان مشخص کرد. (هنگام استفاده از Expectk، این گزینه با .B \-file مشخص می‌شود.) .PP به طور پیش‌فرض، فایل دستورها به طور کامل در حافظه خوانده شده و یکجا اجرا می‌شود. گهگاه مطلوب است که فایل‌ها خط‌به‌خط خوانده شوند؛ به عنوان مثال stdin به این شکل خوانده می‌شود. برای اجبار فایل‌های دلخواه به اداره شدن با این روش، از پرچم .B \-b استفاده کنید. (هنگام استفاده از Expectk، این گزینه با .B \-buffer مشخص می‌شود.) توجه داشته باشید که بافرینگ stdio ممکن است همچنان رخ دهد، با این حال این موضوع نباید هنگام خواندن از یک fifo یا stdin مشکلی ایجاد کند. .PP اگر رشته «\-» به عنوان نام فایل داده شود، به جای آن ورودی استاندارد خوانده می‌شود. (برای خواندن از فایلی که نام واقعی آن «\-» است، از «./\-» استفاده کنید.) .PP پرچم .B \-i باعث می‌شود که .B Expect به جای خواندن دستورها از یک فایل، برای دریافت دستورها به صورت تعاملی اعلان (prompt) دهد. فرایند اعلان با دستور .B exit یا هنگام رسیدن به EOF پایان می‌یابد. برای اطلاعات بیشتر به .B interpreter (در ادامه) مراجعه کنید. اگر نه فایل دستور و نه گزینه .B \-c مشخص نشده باشند، پرچم .B \-i به صورت پیش‌فرض در نظر گرفته می‌شود. (هنگام استفاده از Expectk، این گزینه با .B \-interactive مشخص می‌شود.).PP .B \-\- می‌تواند برای مشخص کردن پایان گزینه‌ها به کار رود. این ویژگی زمانی مفید است که بخواهید یک آرگومان شبیه به گزینه را بدون اینکه توسط .B Expect تفسیر شود، به اسکریپت خود منتقل کنید. این نماد می‌تواند به شکلی کاربردی در خط #! قرار گیرد تا از هرگونه تفسیر پرچم‌مانند توسط Expect جلوگیری شود. برای مثال، عبارت زیر آرگومان‌های اصلی (شامل نام اسکریپت) را در متغیر .I argv باقی می‌گذارد. #!/usr/local/bin/expect \-\- توجه داشته باشید که هنگام افزودن آرگومان‌ها به خط #! باید قواعد معمول getopt(3) و execve(2) رعایت شوند. .PP فایل $exp_library/expect.rc در صورت وجود به طور خودکار بارگذاری (source) می‌شود، مگر آن‌که پرچم .B \-N به کار رفته باشد. (هنگام استفاده از Expectk، این گزینه به صورت .B \-NORC مشخص می‌شود.) بلافاصله پس از آن، فایل ~/.expect.rc به طور خودکار بارگذاری می‌شود، مگر اینکه پرچم .B \-n به کار رود. اگر متغیر محیطی DOTDIR تعریف شده باشد، به عنوان یک دایرکتوری در نظر گرفته شده و ‎.expect.rc از آنجا خوانده می‌شود. (هنگام استفاده از Expectk، این گزینه به صورت .B \-norc مشخص می‌شود.) این بارگذاری تنها پس از اجرای هرگونه پرچم .B \-c رخ می‌دهد. .PP .B \-v باعث می‌شود Expect شماره نسخه خود را چاپ کرده و خارج شود. (پرچم متناظر در Expectk، که از نام‌های طولانی برای پرچم‌ها استفاده می‌کند، \-version است.) .PP آرگومان‌های اختیاری .I args در قالب یک لیست ساختار یافته و در متغیری به نام .I argv ذخیره می‌شوند. .I argc با طول argv مقداردهی اولیه می‌شود. .PP متغیر .I argv0 به عنوان نام اسکریپت (یا باینری در صورتی که اسکریپتی به کار نرفته باشد) تعریف می‌شود. برای مثال، عبارت زیر نام اسکریپت و سه آرگومان نخست را چاپ می‌کند: .nf send_user "$argv0 [lrange $argv 0 2]\\n" .fi .SH "دستورها (COMMANDS)" .B Expect از .I Tcl (Tool Command Language) استفاده می‌کند. Tcl ساختارهای کنترل جریان (مانند if، for، break)، ارزیابی عبارات و چندین قابلیت دیگر مانند بازگشت (recursion)، تعریف رویه (procedure) و غیره را فراهم می‌کند. دستوراتی که در اینجا استفاده شده‌اند ولی تعریف نشده‌اند (مانند .BR set ، .BR if ، .BR exec ) دستورهای Tcl هستند (به tcl(3) مراجعه کنید). .B Expect از دستورهای دیگری نیز پشتیبانی می‌کند که در ادامه شرح داده شده‌اند. مگر در مواردی که مشخص شده باشد، دستورها یک رشته خالی برمی‌گردانند. .PP دستورها به ترتیب الفبایی فهرست شده‌اند تا بتوان به سرعت آن‌ها را پیدا کرد. با این حال، ممکن است برای کاربران جدید آسان‌تر باشد که مطالعه را با شرح دستورهای .BR spawn ، .BR send ، .BR expect و .BR interact به همین ترتیب آغاز کنند. توجه داشته باشید که بهترین مقدمه برای این زبان (هم Expect و هم Tcl) در کتاب «Exploring Expect» ارائه شده است (به بخش «همچنین ببینید (SEE ALSO)» در زیر مراجعه کنید). مثال‌هایی در این صفحه راهنما گنجانده شده‌اند، اما بسیار محدود هستند زیرا این صفحه راهنما اساساً به عنوان یک مرجع در نظر گرفته شده است. (توجه داشته باشید که در متن این صفحه راهنما، «Expect» با حرف بزرگ «E» به برنامه .B Expect اشاره دارد، در حالی که «expect» با حرف کوچک «e» به دستور .B expect درون برنامه .B Expect اشاره می‌کند.) .I .TP 6 .BI close " [-slave] [\-onexec 0|1] [\-i spawn_id]" اتصال به فرآیند جاری را می‌بندد. اکثر برنامه‌های تعاملی EOF را روی ورودی استاندارد (stdin) خود تشخیص داده و خارج می‌شوند؛ بنابراین .B close معمولاً برای خاتمه دادن به فرآیند نیز کفایت می‌کند. پرچم .B \-i فرآیند مورد نظر برای بستن را متناظر با spawn_id نام‌برده مشخص می‌کند. هر دو دستور .B expect و .B interact خروج فرآیند جاری را تشخیص داده و به طور ضمنی یک .B close انجام می‌دهند. اما اگر فرآیند را، به عنوان مثال، با «exec kill $pid» متوقف کنید، باید به صراحت .B close را فراخوانی نمایید. پرچم .B \-onexec مشخص می‌کند که آیا spawn id در هر فرآیند اشتقاق‌یافته جدیدی (spawned) بسته شود یا خیر، یا اینکه آیا فرآیند جایگزین (overlay) شده است. برای باز گذاشتن یک spawn id از مقدار 0 استفاده کنید. یک مقدار صحیح غیرصفر، بستن فرآیند اشتقاق‌یافته را در فرآیندهای جدید اجباری می‌کند (پیش‌فرض). پرچم .B \-slave طرف وابسته (slave) مرتبط با spawn id را می‌بندد. (به «spawn -pty» مراجعه کنید.) هنگامی که اتصال بسته شود، طرف وابسته (slave) نیز در صورت باز بودن به طور خودکار بسته می‌شود. صرف‌نظر از اینکه اتصال به طور ضمنی یا صریح بسته شود، باید .B wait را فراخوانی کنید تا اسلات فرآیند متناظر در هسته (kernel process slot) پاک‌سازی شود. دستور .B close دستور .B wait را فراخوانی نمی‌کند، چرا که هیچ تضمینی وجود ندارد که بستن اتصال فرآیند موجب خروج آن شود. برای اطلاعات بیشتر به .B wait در زیر مراجعه کنید. .TP .BI debug " [[-now] 0|1]" یک اشکال‌زدای Tcl را کنترل می‌کند که به شما امکان می‌دهد دستورها را گام‌به‌گام اجرا کنید، نقاط توقف (breakpoints) تعیین نمایید و غیره. بدون هیچ آرگومانی، در صورتی که اشکال‌زدا در حال اجرا نباشد مقدار 1 برگردانده می‌شود، وگرنه مقدار 0 برگردانده خواهد شد. با آرگومان 1، اشکال‌زدا شروع به کار می‌کند. با آرگومان 0، اشکال‌زدا متوقف می‌شود. اگر قبل از آرگومان 1 پرچم .B \-now آمده باشد، اشکال‌زدا بلافاصله شروع به کار می‌کند (یعنی در میانه خود دستور .BR debug ). در غیر این صورت، اشکال‌زدا با دستور Tcl بعدی آغاز به کار خواهد کرد. دستور .B debug هیچ‌کدام از تله‌ها (traps) را تغییر نمی‌دهد. این رفتار را با راه‌اندازی Expect با پرچم .B -D مقایسه کنید (بالا را ببینید). برای اطلاعات بیشتر درباره اشکال‌زدا، به فایل README یا بخش «همچنین ببینید (SEE ALSO)» (در زیر) مراجعه کنید. .TP .B disconnect ارتباط فرآیند منشعب‌شده (forked) را از ترمینال قطع می‌کند. این فرآیند به اجرا در پس‌زمینه ادامه می‌دهد. به فرآیند گروه فرآیندی (process group) ویژه خودش اختصاص داده می‌شود (در صورت امکان). ورودی/خروجی استاندارد به /dev/null هدایت می‌شود. .IP قطعه‌کد زیر از .B disconnect برای ادامه اجرای اسکریپت در پس‌زمینه استفاده می‌کند. .nf if {[fork]!=0} exit disconnect . . . .fi اسکریپت زیر یک گذرواژه را می‌خواند، و سپس هر ساعت برنامه‌ای را اجرا می‌کند که در هر بار اجرا به گذرواژه نیاز دارد. اسکریپت گذرواژه را فراهم می‌کند به طوری که شما تنها لازم است یک بار آن را وارد کنید. (دستور .B stty را ببینید که چگونگی خاموش کردن پژواک گذرواژه را نشان می‌دهد.) .nf send_user "password?\\ " expect_user -re "(.*)\\n" for {} 1 {} { if {[fork]!=0} {sleep 3600;continue} disconnect spawn priv_prog expect Password: send "$expect_out(1,string)\\r" . . . exit } .fi یک مزیت استفاده از .B disconnect نسبت به قابلیت فرآیند ناهمگام پوسته (&) این است که .B Expect می‌تواند پارامترهای ترمینال را پیش از قطع اتصال ذخیره کند و سپس بعداً آن‌ها را بر روی ptyهای جدید اعمال نماید. در صورت استفاده از &، .B Expect فرصتی برای خواندن پارامترهای ترمینال نخواهد داشت، چرا که پیش از دریافت کنترل توسط .BR Expect ، ارتباط ترمینال از قبل قطع شده است..TP .BI exit " [\-opts] [status]" باعث خروج .B Expect یا آماده‌سازی آن برای این کار می‌شود. پرچم .B \-onexit باعث می‌شود آرگومان بعدی به‌عنوان یک گردانندهٔ خروج (exit handler) به کار رود. بدون آرگومان، گردانندهٔ خروج فعلی بازگردانده می‌شود. پرچم .B \-noexit باعث می‌شود .B Expect برای خروج آماده شود، اما دقیقاً پیش از بازگرداندن واقعی کنترل به سیستم‌عامل متوقف گردد. گردانندهٔ خروج تعریف‌شده توسط کاربر و همچنین گرداننده‌های داخلی خود Expect اجرا می‌شوند. هیچ دستور Expect دیگری نباید اجرا شود. این قابلیت زمانی مفید است که Expect را به همراه سایر افزونه‌های Tcl اجرا می‌کنید. مفسر فعلی (و پنجرهٔ اصلی در صورت قرار داشتن در محیط Tk) باقی می‌مانند تا سایر افزونه‌های Tcl بتوانند عملیات پاک‌سازی را انجام دهند. اگر .B exit مربوط به Expect دوباره فراخوانی شود (به هر ترتیبی که ممکن است رخ دهد)، گرداننده‌ها مجدداً اجرا نخواهند شد. هنگام خروج، تمام اتصالات به فرایندهای منشعب‌شده (spawned) بسته می‌شوند. این بسته شدن توسط فرایندهای منشعب‌شده به‌صورت یک EOF تشخیص داده خواهد شد. دستور .B exit هیچ اقدام دیگری فراتر از آنچه در روال معمول _exit(2) انجام می‌شود صورت نمی‌دهد. بنابراین، فرایندهای منشعب‌شده‌ای که EOF را بررسی نمی‌کنند ممکن است همچنان به اجرای خود ادامه دهند. (شرایط گوناگونی برای تعیین این موضوع حائز اهمیت هستند؛ برای مثال اینکه چه سیگنال‌هایی به یک فرایند منشعب‌شده ارسال خواهد شد، اما این شرایط وابسته به سیستم بوده و معمولاً ذیل exit(3) مستند شده‌اند.) فرایندهای منشعب‌شده‌ای که به اجرای خود ادامه دهند توسط init به ارث برده خواهند شد. مقدار .I status (یا 0 در صورت عدم تعیین) به‌عنوان وضعیت خروج .BR Expect بازگردانده می‌شود. در صورت رسیدن به پایان اسکریپت، .B exit به‌طور ضمنی اجرا می‌گردد. .TP \fBexp_continue\fR [-continue_timer] دستور .B exp_continue به خود .B expect امکان می‌دهد تا به‌جای بازگشت به روال معمول، به اجرای خود ادامه دهد. به‌طور پیش‌فرض، .B exp_continue تایمر زمان‌بندی (timeout) را بازنشانی می‌کند. پرچم .I -continue_timer از راه‌اندازی مجدد تایمر جلوگیری می‌نماید. (برای اطلاعات بیشتر به .B expect مراجعه کنید.) .TP .BI exp_internal " [\-f file] value" در صورتی که .I value عددی غیر صفر باشد، باعث می‌شود دستورات بعدی اطلاعات عیب‌یابی داخلیِ .B Expect را به stderr ارسال کنند. در صورتی که .I value برابر 0 باشد، این خروجی غیرفعال می‌شود. اطلاعات عیب‌یابی شامل تک‌تک نویسه‌های دریافت‌شده و تمامی تلاش‌های صورت‌گرفته برای تطبیق خروجی فعلی با الگوها است. .IP اگر پارامتر اختیاریِ .I file مشخص شده باشد، تمام خروجی‌های عادی و اشکال‌زدایی (بدون در نظر گرفتن مقدار .IR value ) در آن فایل نوشته می‌شوند. هرگونه فایل خروجی عیب‌یابی پیشین بسته خواهد شد. پرچم .B \-info باعث می‌شود exp_internal توصیفی از جدیدترین آرگومان‌های داده‌شده به جز آرگومان‌های مربوط به info را بازگرداند. .TP .BI exp_open " [args] [\-i spawn_id]" یک شناسهٔ فایل Tcl بازمی‌گرداند که متناظر با spawn id اصلی است. سپس می‌توان از این شناسهٔ فایل به‌گونه‌ای استفاده کرد که گویی توسط دستور .B open در Tcl باز شده است. (شناسهٔ spawn id دیگر نباید استفاده شود. دستور .B wait نباید اجرا شود.) پرچم .B \-leaveopen شناسهٔ spawn id را برای دسترسی از طریق دستورات Expect باز نگه می‌دارد. در این حالت باید یک .B wait روی spawn id اجرا شود. .TP .BI exp_pid " [\-i spawn_id]" شناسهٔ فرایند (pid) متناظر با فرایند منشعب‌شدهٔ فعلی را بازمی‌گرداند. اگر از پرچم .B \-i استفاده شود، pid بازگردانده‌شده متناظر با شناسهٔ spawn id مشخص‌شده خواهد بود. .TP .B exp_send نام مستعاری است برای .BR send . .TP .B exp_send_error نام مستعاری است برای .BR send_error . .TP .B exp_send_log نام مستعاری است برای .BR send_log . .TP .B exp_send_tty نام مستعاری است برای .BR send_tty . .TP .B exp_send_user نام مستعاری است برای .BR send_user . .TP .BI exp_version " [[\-exit] version]" برای اطمینان از سازگاری اسکریپت با نسخهٔ فعلی Expect سودمند است. .IP بدون آرگومان، نسخهٔ فعلی .B Expect بازگردانده می‌شود. سپس می‌توان این نسخه را در اسکریپت خود درج کرد. اگر به‌طور قطعی می‌دانید که از قابلیت‌های نسخه‌های اخیر استفاده نمی‌کنید، می‌توانید نسخهٔ قدیمی‌تری را مشخص نمایید. .IP شماره نسخه‌ها از سه عدد تشکیل شده‌اند که با نقطه جدا می‌شوند. اولین عدد، شماره نسخهٔ اصلی (major) است. اسکریپت‌هایی که برای نسخه‌هایی از .B Expect با شماره نسخهٔ اصلیِ متفاوت نوشته شده باشند، تقریباً به‌طور قطع کار نخواهند کرد. اگر شماره‌های نسخهٔ اصلی مطابقت نداشته باشند، .B exp_version خطا بازمی‌گرداند. .IP دومین عدد، شماره نسخهٔ فرعی (minor) است. اسکریپت‌هایی که برای نسخه‌ای با شماره فرعی بزرگ‌تر از نسخهٔ فعلی نوشته شده‌اند ممکن است به قابلیت جدیدی وابسته باشند و اجرا نشوند. .B exp_version اگر شماره‌های نسخهٔ اصلی یکسان باشند اما شماره نسخهٔ فرعی اسکریپت بزرگ‌تر از نسخهٔ .BR Expect در حال اجرا باشد، خطایی بازمی‌گرداند. .IP سومین عدد نقشی در مقایسه نسخه ندارد. با این حال، هرگاه توزیع نرم‌افزاری .B Expect به هر نحوی تغییر کند (مانند افزودن مستندات بیشتر یا بهینه‌سازی)، این شماره افزایش می‌یابد. این شماره با انتشار هر نسخهٔ فرعی جدید به 0 بازنشانی می‌شود. .IP با پرچم .BR \-exit ، اگر نسخه قدیمی باشد، .B Expect پیام خطایی چاپ کرده و خارج می‌شود. .TP .BI expect " [[\-opts] pat1 body1] ... [\-opts] patn [bodyn]" منتظر می‌ماند تا یکی از الگوها با خروجی فرایند منشعب‌شده مطابقت یابد، مدت‌زمان مشخصی سپری شود، یا به انتهای فایل (end-of-file) برسد. اگر بدنهٔ نهایی خالی باشد، می‌توان از آن صرف‌نظر کرد. .IP الگوهای ناشی از جدیدترین دستور .B expect_before به‌طور ضمنی پیش از هر الگوی دیگری استفاده می‌شوند. الگوهای ناشی از جدیدترین دستور .B expect_after به‌طور ضمنی پس از هر الگوی دیگری استفاده می‌شوند. .IP اگر آرگومان‌های کل عبارت .B expect به بیش از یک خط نیاز داشته باشند، می‌توان تمام آرگومان‌ها را درون یک آکولاد قرار داد تا از پایان دادن به هر خط با نویسهٔ بک‌اسلش (backslash) جلوگیری شود. تنها در این حالت خاص، جایگزینی‌های معمول Tcl با وجود آکولادها رخ خواهند داد. .IP اگر یک الگو کلمهٔ کلیدی .BR eof باشد، بدنهٔ متناظر هنگام رسیدن به انتهای فایل اجرا می‌شود. اگر یک الگو کلمهٔ کلیدی .BR timeout باشد، بدنهٔ متناظر هنگام اتمام مهلت زمانی (timeout) اجرا می‌گردد. اگر از کلمهٔ کلیدی timeout استفاده نشود، در زمان پایان مهلت یک کنشِ تهی (null action) ضمنی اجرا می‌شود. دورهٔ مهلت پیش‌فرض ۱۰ ثانیه است اما می‌تواند برای نمونه با دستور "set timeout 30" روی ۳۰ ثانیه تنظیم شود. مهلت نامحدود را می‌توان با مقدار \-1 تعیین کرد. اگر الگویی کلمهٔ کلیدی .BR default باشد، بدنهٔ متناظر با آن در صورت رخداد مهلت زمانی یا رسیدن به انتهای فایل اجرا می‌شود. .IP اگر الگویی مطابقت پیدا کند، بدنهٔ متناظر با آن اجرا می‌شود. .B expect نتیجهٔ بدنه را بازمی‌گرداند (یا اگر هیچ الگویی مطابقت پیدا نکرد، یک رشتهٔ خالی برمی‌گرداند). در صورتی که چندین الگو مطابقت یابند، الگویی که در ابتدا آمده باشد برای انتخاب بدنه استفاده خواهد شد. .IP هر بار که خروجی جدیدی برسد، به ترتیبی که در فهرست ذکر شده‌اند با هر یک از الگوها مقایسه می‌شود. بدین ترتیب، می‌توانید با قرار دادن آخرین الگو به‌صورت چیزی که تضمین شده است نمایش داده می‌شود (مانند یک اعلان ورودی یا prompt)، عدم وجود تطابق را بررسی کنید. در مواردی که اعلان ورودی وجود ندارد، باید از .B timeout استفاده نمایید (دقیقاً همان‌گونه که در تعامل دستی عمل می‌کردید)..IP الگوها به سه روش مشخص می‌شوند. به طور پیش‌فرض، الگوها همانند دستور .B string match در Tcl مشخص می‌گردند. (چنین الگوهایی همچنین مشابه عبارات منظم C-shell هستند که معمولاً با نام الگوهای «glob» شناخته می‌شوند). پرچم .B \-gl می‌تواند برای محافظت از الگوهایی به کار رود که ممکن است در غیر این صورت با پرچم‌های .B expect تطبیق یابند. هر الگویی که با «-» شروع می‌شود باید به این شکل محافظت شود. (تمام رشته‌هایی که با «-» آغاز می‌شوند برای گزینه‌های آینده رزرو شده‌اند.) .IP برای مثال، قطعه کد زیر به دنبال یک ورود (login) موفقیت‌آمیز می‌گردد. (توجه داشته باشید که فرض شده است .B abort رویه‌ای است که در جای دیگری از اسکریپت تعریف شده است.) .nf .ta \w' expect 'u +\w'invalid password 'u expect { busy {puts busy\\n ; exp_continue} failed abort "invalid password" abort timeout abort connected } .fi استفاده از نقل‌قول برای الگوی چهارم ضروری است زیرا شامل یک فاصله است، که در غیر این صورت الگو را از کنش جدا می‌کرد. الگوهایی با کنش یکسان (مانند سومی و چهارمی) نیازمند ذکر مجدد کنش‌ها هستند. با استفاده از الگوهای سبک regexp می‌توان از این کار اجتناب کرد (زیر را ببینید). اطلاعات بیشتر درباره تشکیل الگوهای سبک glob را می‌توان در کتابچه راهنمای Tcl یافت. .IP الگوهای سبک regexp از ساختار نحوی تعریف‌شده توسط دستور .B regexp در Tcl (کوتاه‌شده‌ی «regular expression») پیروی می‌کنند. الگوهای regexp با پرچم .BR \-re معرفی می‌شوند. مثال قبلی را می‌توان با استفاده از یک regexp به صورت زیر بازنویسی کرد: .nf .ta \w' expect 'u +\w'connected 'u expect { busy {puts busy\\n ; exp_continue} \-re "failed|invalid password" abort timeout abort connected } .fi هر دو نوع الگو «مهارنشده» (unanchored) هستند. این بدان معناست که الگوها مجبور نیستند با کل رشته مطابقت داشته باشند، بلکه می‌توانند تطابق را در هر نقطه‌ای از رشته آغاز کرده و پایان دهند (تا زمانی که همه چیزهای دیگر مطابقت داشته باشند). از ^ برای تطابق با ابتدای رشته، و از $ برای تطابق با انتهای آن استفاده کنید. توجه داشته باشید که اگر منتظر انتهای رشته نمانید، پاسخ‌های شما می‌توانند به آسانی در میانه رشته و به هنگام بازتاب (echo) از فرآیند ایجادشده (spawned) قرار گیرند. با وجود اینکه نتایج همچنان صحیح تولید می‌شوند، اما خروجی ممکن است غیرطبیعی به نظر برسد. بنابراین، در صورتی که می‌توانید نویسه‌های انتهای رشته را دقیقاً توصیف کنید، استفاده از $ توصیه می‌شود. توجه داشته باشید که در بسیاری از ویرایشگرها، ^ و $ به ترتیب با ابتدا و انتهای خطوط تطابق دارند. با این حال، از آنجا که expect خط‌محور نیست، این نویسه‌ها با ابتدا و انتهای داده‌های فعلی در بافر تطابق expect (در مقایسه با خطوط) مطابقت می‌یابند. (همچنین یادداشت زیر را درباره «system indigestion» ببینید.) پرچم .B \-ex باعث می‌شود الگو به عنوان یک رشته «دقیق» (exact) تطبیق داده شود. هیچ تفسیری از *، ^، و غیره صورت نمی‌گیرد (اگرچه قراردادهای معمول Tcl همچنان باید رعایت شوند). الگوهای دقیق همیشه مهارنشده هستند. .IP پرچم .B \-nocase باعث می‌شود نویسه‌های بزرگ خروجی طوری مقایسه شوند که گویی نویسه‌های کوچک هستند. الگو تحت تأثیر قرار نمی‌گیرد. .IP هنگام خواندن خروجی، بیش از ۲۰۰۰ بایت می‌تواند باعث شود که بایت‌های اولیه «فراموش» شوند. این مقدار ممکن است با تابع .BR match_max تغییر یابد. (توجه داشته باشید که مقادیر بیش از حد بزرگ می‌توانند سرعت تطابق‌دهنده الگو را کاهش دهند.) اگر .I patlist برابر با .BR full_buffer باشد، در صورتی که .I match_max بایت دریافت شده باشد و هیچ الگوی دیگری مطابقت نیافته باشد، بدنه متناظر اجرا می‌شود. صرف‌نظر از اینکه کلمه کلیدی .B full_buffer استفاده شده باشد یا خیر، نویسه‌های فراموش‌شده در expect_out(buffer) نوشته می‌شوند. اگر .I patlist کلمه کلیدی .BR null باشد، و مقادیر null مجاز باشند (از طریق دستور .BR remove_nulls )، در صورتی که یک بایت ASCII 0 تطابق یابد، بدنه متناظر اجرا می‌شود. تطابق بایت‌های ۰ از طریق الگوهای glob یا regexp امکان‌پذیر نیست. پس از تطابق یک الگو (یا eof یا full_buffer)، هر خروجی تطابق‌یافته و خروجی‌های تطابق‌نیافته پیشین در متغیر .IR expect_out(buffer) ذخیره می‌شوند. تا ۹ زیررشته تطابق‌یافته با regexp در متغیرهای .I expect_out(1,string) تا .IR expect_out(9,string) ذخیره می‌شوند. اگر پرچم .B \-indices قبل از یک الگو استفاده شود، نمایه‌های شروع و پایان (در قالبی مناسب برای .BR lrange ) ۱۰ رشته در متغیرهای .I expect_out(X,start) و .I expect_out(X,end) ذخیره می‌شوند که در آن X یک رقم متناظر با موقعیت زیررشته در بافر است. رقم ۰ به رشته‌هایی اشاره دارد که با کل الگو تطابق یافته‌اند و هم برای الگوهای glob و هم الگوهای regexp تولید می‌شود. برای مثال، اگر فرآیندی خروجی "abcdefgh\\n" را تولید کرده باشد، نتیجه: .nf expect "cd" .fi به گونه‌ای است که گویی عبارت‌های زیر اجرا شده‌اند: .nf set expect_out(0,string) cd set expect_out(buffer) abcd .fi و "efgh\\n" در بافر خروجی باقی می‌ماند. اگر فرآیندی خروجی "abbbcabkkkka\\n" را تولید کرده باشد، نتیجه: .nf expect \-indices \-re "b(b*).*(k+)" .fi به گونه‌ای است که گویی عبارت‌های زیر اجرا شده‌اند: .nf set expect_out(0,start) 1 set expect_out(0,end) 10 set expect_out(0,string) bbbcabkkkk set expect_out(1,start) 2 set expect_out(1,end) 3 set expect_out(1,string) bb set expect_out(2,start) 10 set expect_out(2,end) 10 set expect_out(2,string) k set expect_out(buffer) abbbcabkkkk .fi و "a\\n" در بافر خروجی باقی می‌ماند. الگوی "*" (و \-re ".*") بافر خروجی را بدون خواندن هیچ خروجی بیشتری از فرآیند، خالی (flush) می‌کند. .IP به طور معمول، خروجی تطابق‌یافته از بافرهای داخلی Expect دور ریخته می‌شود. با قرار دادن پرچم .B \-notransfer قبل از یک الگو می‌توان از این امر جلوگیری کرد. این پرچم به‌ویژه در هنگام آزمایش سودمند است (و می‌تواند برای راحتی در هنگام آزمایش به "-not" خلاصه شود). شناسه spawn id مرتبط با خروجی تطابق‌یافته (یا eof یا full_buffer) در .IR expect_out(spawn_id) ذخیره می‌شود. پرچم .B \-timeout باعث می‌شود دستور expect فعلی به جای استفاده از مقدار متغیر timeout، از مقدار پس از خود به عنوان زمان انتظار (timeout) استفاده کند. به طور پیش‌فرض، الگوها در برابر خروجی فرآیند فعلی تطابق داده می‌شوند، اما پرچم .B \-i اعلام می‌کند که خروجی فهرست spawn_id نام‌برده‌شده با هر یک از الگوهای بعدی (تا .B \-i بعدی) تطبیق داده شود. فهرست spawn_id یا باید فهرستی از spawn_idها جداشده با فاصله خالی باشد یا متغیری که به چنین فهرستی از spawn_idها اشاره دارد. برای مثال، نمونه زیر منتظر دریافت "connected" از فرآیند فعلی، یا "busy"، "failed" یا "invalid password" از spawn_id نام‌برده‌شده توسط proc2$ می‌ماند. .nf expect { \-i $proc2 busy {puts busy\\n ; exp_continue} \-re "failed|invalid password" abort timeout abort connected } .fi مقدار متغیر سراسری .I any_spawn_id می‌تواند برای تطبیق الگوها با هر spawn_id که با تمام پرچم‌های .B \-i دیگر در دستور .B expect فعلی مشخص شده‌اند، استفاده شود. شناسه spawn_id مربوط به یک پرچم .B \-i بدون الگوی متناظر (یعنی بلافاصله پس از آن یک .BR \-i دیگر آمده باشد) برای تمام الگوهای دیگر در همان دستور .B expect که به .I any_spawn_id مرتبط هستند، در دسترس قرار می‌گیرد. پرچم .B \-i همچنین می‌تواند نام یک متغیر سراسری باشد که در این صورت متغیر برای دریافت فهرستی از spawn idها خوانده می‌شود. متغیر هر زمان که تغییر کند، مجدداً خوانده می‌شود. این کار روشی را برای تغییر مبدأ ورودی/خروجی (I/O) در زمان اجرای دستور فراهم می‌سازد. شناسه‌های spawn id ارائه‌شده از این طریق، spawn idهای «غیرمستقیم» (indirect) نامیده می‌شوند. کنش‌هایی مانند .B break و .B continue باعث می‌شوند ساختارهای کنترلی (یعنی .BR for ، .BR proc ) به شیوه معمول رفتار کنند. دستور .B exp_continue به خودِ .B expect اجازه می‌دهد تا به جای بازگشت به روال معمول، به اجرای خود ادامه دهد..IP این قابلیت برای جلوگیری از حلقه‌های صریح یا عبارت‌های تکراری expect مفید است. مثال زیر بخشی از یک قطعه‌کد برای خودکارسازی rlogin است. دستور .B exp_continue در صورتی که rlogin درخواست گذرواژه کند، از نیاز به نوشتن یک عبارت دوم .B expect (برای جستجوی دوبارهٔ اعلان) جلوگیری می‌کند. .nf expect { Password: { stty -echo send_user "password (for $user) on $host: " expect_user -re "(.*)\\n" send_user "\\n" send "$expect_out(1,string)\\r" stty echo exp_continue } incorrect { send_user "invalid password or account\\n" exit } timeout { send_user "connection to $host timed out\\n" exit } eof { send_user \\ "connection to host failed: $expect_out(buffer)" exit } -re $prompt } .fi برای نمونه، قطعه‌کد زیر می‌تواند به کاربر در هدایت تعاملی که پیش‌تر کاملاً خودکار شده است کمک کند. در این مورد، ترمینال در حالت raw قرار می‌گیرد. اگر کاربر «+» را فشار دهد، یک متغیر افزایش می‌یابد. اگر «p» فشرده شود، چندین نویسه بازگشت (return) به فرایند ارسال می‌شود، شاید برای تلنگر زدن به آن به نحوی؛ و «i» به کاربر اجازه می‌دهد با فرایند تعامل داشته باشد و عملاً واپایش را از اسکریپت پس بگیرد. در هر حالت، .B exp_continue به .B expect فعلی اجازه می‌دهد پس از اجرای کنش فعلی، به تطبیق الگو ادامه دهد. .nf stty raw \-echo expect_after { \-i $user_spawn_id "p" {send "\\r\\r\\r"; exp_continue} "+" {incr foo; exp_continue} "i" {interact; exp_continue} "quit" exit } .fi .IP به‌طور پیش‌فرض، .B exp_continue شمارشگر زمان‌بندی (timeout timer) را بازنشانی می‌کند. اگر .B exp_continue با پرچم .B \-continue_timer فراخوانی شود، این شمارشگر مجدداً راه‌اندازی نمی‌شود. .TP .BI expect_after " [expect_args]" دقیقاً مانند .B expect_before عمل می‌کند، با این تفاوت که اگر الگوهای هر دو دستور .B expect و .B expect_after بتوانند مطابقت یابند، از الگوی .B expect استفاده می‌شود. برای اطلاعات بیشتر دستور .B expect_before را ببینید. .TP .BI expect_background " [expect_args]" همان آرگومان‌های .BR expect را می‌پذیرد، اما بلافاصله بازمی‌گردد. الگوها هر زمان که ورودی جدیدی برسد آزمایش می‌شوند. الگوهای .B timeout و .B default برای .BR expect_background بی‌معنی هستند و بدون هیچ پیامی نادیده گرفته می‌شوند. در غیر این صورت، دستور .B expect_background دقیقاً مانند .B expect از الگوهای .B expect_before و .B expect_after استفاده می‌کند. هنگامی که کنش‌های .B expect_background در حال ارزیابی هستند، پردازش پس‌زمینه برای همان spawn id مسدود می‌شود. پردازش پس‌زمینه با تکمیل کنش از حالت مسدود خارج می‌شود. در حالی که پردازش پس‌زمینه مسدود است، امکان انجام یک .B expect (پیش‌زمینه) روی همان spawn id وجود دارد. امکان اجرای یک .B expect در حالی که یک .B expect_background از حالت مسدود خارج است، وجود ندارد. دستور .B expect_background برای یک spawn id مشخص با اعلان یک expect_background جدید با همان spawn id حذف می‌شود. اعلان .B expect_background بدون هیچ الگویی، توانایی تطبیق الگو در پس‌زمینه را از spawn id داده‌شده سلب می‌کند. .TP .BI expect_before " [expect_args]" همان آرگومان‌های .BR expect را می‌پذیرد، اما بلافاصله بازمی‌گردد. جفت‌های الگو\-کنش از جدیدترین .B expect_before با همان spawn id به‌طور ضمنی به تمامی دستورهای بعدی .B expect افزوده می‌شوند. اگر الگویی مطابقت یابد، به گونه‌ای با آن برخورد می‌شود که گویی در خود دستور .B expect مشخص شده بوده است، و بدنهٔ مرتبط در زمینهٔ (context) دستور .B expect اجرا می‌شود. اگر الگوهای هر دو دستور .B expect_before و .B expect بتوانند مطابقت یابند، از الگوی .B expect_before استفاده می‌شود. اگر هیچ الگویی مشخص نشود، spawn id برای هیچ الگویی بررسی نمی‌شود. مگر در صورتی که با پرچم .B \-i لغو شود، الگوهای .B expect_before با spawn id تعریف‌شده در زمان اجرای دستور .B expect_before (نه زمانی که الگوی آن تطبیق داده می‌شود) مطابقت داده می‌شوند. پرچم \-info باعث می‌شود .B expect_before مشخصات فعلی الگوهایی را که تطبیق خواهد داد بازگرداند. به‌طور پیش‌فرض، این پرچم گزارش spawn id فعلی را می‌دهد. برای دریافت اطلاعات درباره یک spawn id خاص، می‌توان مشخصهٔ آن را به‌صورت اختیاری ارائه داد. برای مثال: .nf expect_before -info -i $proc .fi حداکثر یک مشخصهٔ spawn id می‌توان ارائه داد. پرچم \-indirect شناسه‌های مستقیم spawn id را که صرفاً از مشخصات غیرمستقیم ناشی می‌شوند سرکوب می‌کند. به جای مشخصهٔ spawn id، پرچم «-all» باعث می‌شود «-info» دربارهٔ همهٔ spawn idها گزارش دهد. خروجی پرچم \-info را می‌توان مجدداً به عنوان آرگومان expect_before استفاده کرد. .TP .BI expect_tty " [expect_args]" مانند .B expect است اما نویسه‌ها را از /dev/tty (یعنی کلیدهای فشرده‌شده توسط کاربر) می‌خواند. به‌طور پیش‌فرض، خواندن در حالت cooked (پخته) انجام می‌شود. بنابراین، خطوط باید با یک بازگشت (return) پایان یابند تا .B expect بتواند آن‌ها را ببیند. این رفتار را می‌توان از طریق .B stty تغییر داد (دستور .B stty در ادامه را ببینید). .TP .BI expect_user " [expect_args]" مانند .B expect است اما نویسه‌ها را از stdin (یعنی کلیدهای فشرده‌شده توسط کاربر) می‌خواند. به‌طور پیش‌فرض، خواندن در حالت cooked (پخته) انجام می‌شود. بنابراین، خطوط باید با یک بازگشت (return) پایان یابند تا .B expect بتواند آن‌ها را ببیند. این رفتار را می‌توان از طریق .B stty تغییر داد (دستور .B stty در ادامه را ببینید). .TP .B fork یک فرایند جدید ایجاد می‌کند. فرایند جدید رونوشتی دقیق از فرایند فعلی .B Expect است. در صورت موفقیت، .B fork مقدار 0 را به فرایند جدید (فرزند) بازمی‌گرداند و شناسه فرایند (process ID) فرزند را به فرایند والد می‌دهد. در صورت شکست (که همواره به دلیل کمبود منابع، مانند فضای swap یا حافظه رخ می‌دهد)، .B fork مقدار \-1 را به فرایند والد بازمی‌گرداند و هیچ فرایند فرزندی ایجاد نمی‌شود..IP فرایندهای مشتق‌شده (forked) درست مانند فرایند اصلی از طریق دستور .B exit خارج می‌شوند. فرایندهای مشتق‌شده مجازند در فایل‌های گزارش (log) بنویسند. اگر اشکال‌زدایی یا ثبت وقایع را در بیشتر فرایندها غیرفعال نکنید، نتیجه می‌تواند گیج‌کننده باشد. .IP برخی از پیاده‌سازی‌های pty ممکن است حتی به طور موقت با چندین خواننده و نویسنده دچار اختلال و تداخل شوند. بنابراین، امن‌ترین کار این است که پیش از آغاز فرایندها (spawning)، عمل .B fork انجام شود. .TP .BI interact " [string1 body1] ... [stringn [bodyn]]" کنترل فرایند جاری را به کاربر واگذار می‌کند، به طوری که کلیدهای فشرده‌شده به فرایند جاری ارسال می‌شوند، و stdout و stderr فرایند جاری بازگردانده می‌شوند. .IP جفت‌های رشته-بدنه (string-body) می‌توانند به عنوان آرگومان مشخص شوند، که در این حالت با وارد شدن رشتهٔ مربوطه، بدنه اجرا می‌شود. (به طور پیش‌فرض، رشته به فرایند جاری ارسال نمی‌شود.) در صورتی که بدنهٔ پایانی وجود نداشته باشد، دستور .B interpreter فرض می‌شود. .IP اگر آرگومان‌های کل عبارت .B interact به بیش از یک خط نیاز داشته باشند، می‌توان تمام آرگومان‌ها را درون آکولاد قرار داد تا از پایان دادن به هر خط با یک backslash اجتناب شود. در این یک مورد، با وجود آکولادها، جایگزینی‌های معمول Tcl رخ خواهند داد. .IP برای مثال، دستور زیر interact را با جفت‌های رشته-بدنهٔ تعریف‌شدهٔ زیر اجرا می‌کند: هنگامی که ^Z فشرده شود، .B Expect معلق می‌شود. (پرچم .B \-reset حالت‌های ترمینال را بازمی‌گرداند.) هنگامی که ^A فشرده شود، کاربر پیام "you typed a control-A" را می‌بیند و یک ^A به فرایند ارسال می‌شود. هنگامی که $ فشرده شود، کاربر تاریخ را می‌بیند. هنگامی که ^C فشرده شود، .B Expect خارج می‌شود. اگر "foo" وارد شود، کاربر "bar" را می‌بیند. هنگامی که ~~ فشرده شود، مفسر .B Expect به صورت تعاملی اجرا می‌شود. .nf .ta \w' interact 'u +\w'$CTRLZ 'u +\w'{'u set CTRLZ \\032 interact { -reset $CTRLZ {exec kill \-STOP [pid]} \\001 {send_user "you typed a control\-A\\n"; send "\\001" } $ {send_user "The date is [clock format [clock seconds]]."} \\003 exit foo {send_user "bar"} ~~ } .fi .IP در جفت‌های رشته-بدنه، رشته‌ها به ترتیبی که به عنوان آرگومان فهرست شده‌اند تطبیق داده می‌شوند. رشته‌هایی که تطابق جزئی دارند، به امید رسیدن بقیهٔ نویسه‌ها به فرایند جاری ارسال نمی‌شوند. اگر سپس نویسه‌هایی وارد شوند به گونه‌ای که دیگر امکان هیچ تطابقی وجود نداشته باشد، تنها بخشی از رشته به فرایند ارسال خواهد شد که به هیچ وجه نمی‌تواند آغازگر تطابق دیگری باشد. بنابراین، رشته‌هایی که زیررشته‌ای از تطابق‌های جزئی هستند، در صورتی که رشته‌های اصلی که برای تطابق تلاش می‌کردند در نهایت ناموفق شوند، می‌توانند بعداً تطبیق داده شوند. .IP به طور پیش‌فرض، تطبیق رشته‌ها دقیق و بدون نویسه‌های عام (wildcard) است. (در مقابل، دستور .B expect به طور پیش‌فرض از الگوهای سبک glob استفاده می‌کند.) پرچم .B \-ex می‌تواند برای محافظت از الگوهایی استفاده شود که ممکن است در غیر این صورت با پرچم‌های .B interact اشتباه گرفته شوند. هر الگویی که با "-" آغاز می‌شود باید به این روش محافظت شود. (تمام رشته‌هایی که با "-" شروع می‌شوند برای گزینه‌های آینده رزرو شده‌اند.) پرچم .B \-re رشته را وادار می‌کند تا به عنوان الگویی به سبک عبارت باقاعده (regexp) تفسیر شود. در این حالت، زیررشته‌های منطبق در متغیر .I interact_out ذخیره می‌شوند؛ مشابه روشی که .B expect خروجی خود را در متغیر .B expect_out ذخیره می‌کند. پرچم .B \-indices نیز به طور مشابه پشتیبانی می‌شود. الگوی .B eof کنشی را معرفی می‌کند که هنگام پایان فایل (end-of-file) اجرا می‌شود. یک الگوی مجزای .B eof همچنین می‌تواند پس از پرچم .B \-output بیاید که در این صورت اگر هنگام نوشتن خروجی یک eof تشخیص داده شود، تطبیق می‌یابد. کنش پیش‌فرض .B eof مقدار "return" است، به طوری که .B interact به سادگی با دریافت هرگونه EOF بازمی‌گردد. الگوی .B timeout یک مهلت زمانی (به ثانیه) و کنشی را معرفی می‌کند که پس از خوانده نشدن هیچ نویسه‌ای برای یک مدت مشخص اجرا می‌شود. الگوی .B timeout به فرایندی اعمال می‌شود که اخیراً مشخص شده است. هیچ مهلت زمانی پیش‌فرضی وجود ندارد. متغیر ویژهٔ "timeout" (استفاده‌شده توسط دستور .BR expect ) هیچ تاثیری بر این مهلت زمانی ندارد. برای مثال، عبارت زیر می‌تواند برای خروج خودکار (autologout) کاربرانی استفاده شود که به مدت یک ساعت چیزی تایپ نکرده‌اند اما همچنان پیام‌های مکرر سیستمی دریافت می‌کنند: .nf interact -input $user_spawn_id timeout 3600 return -output \\ $spawn_id .fi اگر الگو کلیدواژهٔ .BR null باشد و مقادیر null مجاز باشند (از طریق دستور .BR remove_nulls )، در صورتی که یک بایت 0 در ASCII تطبیق یابد، بدنهٔ مربوطه اجرا می‌شود. تطبیق بایت‌های ۰ از طریق الگوهای glob یا regexp امکان‌پذیر نیست. قرار دادن پرچم .B \-iwrite پیش از یک الگو باعث می‌شود که متغیر .I interact_out(spawn_id) روی spawn_idای تنظیم شود که با الگو (یا eof) تطبیق یافته است. کنش‌هایی مانند .B break و .B continue باعث می‌شوند ساختارهای کنترلی (یعنی .BR for ، .BR proc ) به شیوهٔ معمول عمل کنند. با این حال، .B return باعث می‌شود interact به فراخوانندهٔ خود بازگردد، در حالی که .B inter_return باعث می‌شود .B interact موجب بازگشت در فراخوانندهٔ خود شود. برای مثال، اگر "proc foo" دستور .B interact را فراخوانی کند و سپس کنش .BR inter_return اجرا شود، .B proc foo بازمی‌گردد. (این بدان معناست که اگر .B interact دستور .B interpreter را فراخوانی کند، وارد کردن تعاملی .B return باعث ادامه یافتن interact خواهد شد، در حالی که .B inter_return باعث بازگشت interact به فراخواننده‌اش می‌شود.) .IP در طول .BR interact ، حالت raw استفاده می‌شود تا تمامی نویسه‌ها بتوانند به فرایند جاری منتقل شوند. اگر فرایند جاری سیگنال‌های کنترل کار (job control) را مدیریت نکند، در صورت ارسال سیگنال توقف (به طور پیش‌فرض ^Z) متوقف خواهد شد. برای راه‌اندازی مجدد آن، یک سیگنال ادامه ارسال کنید (مانند دستور "kill \-CONT "). اگر واقعاً می‌خواهید یک SIGSTOP به چنین فرایندی ارسال کنید (با ^Z)، اجرای csh در ابتدا و سپس اجرای برنامهٔ خود را در نظر بگیرید. از سوی دیگر، اگر می‌خواهید یک SIGSTOP به خود .B Expect ارسال کنید، ابتدا interpreter را فراخوانی کنید (شاید با استفاده از یک نویسهٔ گریز)، و سپس ^Z را فشار دهید. .IP جفت‌های رشته-بدنه می‌توانند به عنوان میانبری برای اجتناب از ورود به مفسر و اجرای تعاملی دستورها استفاده شوند. حالت قبلی ترمینال در زمان اجرای بدنهٔ یک جفت رشته-بدنه استفاده می‌شود. .IP برای سرعت بیشتر، کنش‌ها به طور پیش‌فرض در حالت raw اجرا می‌شوند. پرچم .B \-reset ترمینال را به حالتی که پیش از اجرای .B interact داشت بازمی‌گرداند (همواره، حالت cooked). توجه داشته باشید نویسه‌هایی که در هنگام تغییر حالت وارد می‌شوند ممکن است از دست بروند (یک ویژگی نامطلوب در درایور ترمینالِ برخی از سیستم‌ها). تنها دلیل برای استفاده از .B \-reset این است که کنش شما وابسته به اجرا در حالت cooked باشد..IP پرچم .B \-echo نویسه‌هایی را که با الگوی پس از آن مطابقت دارند، هم‌زمان با خوانده شدن هر نویسه، به فرایندی که آن‌ها را تولید کرده است بازمی‌گرداند. این ویژگی ممکن است زمانی مفید باشد که کاربر نیاز دارد بازخورد الگوهای نیمه‌تایپ‌شده را مشاهده کند. .IP اگر بازتاب (echo) یک الگو در حال انجام باشد اما در نهایت تطابق برقرار نشود، نویسه‌ها به فرایند ایجادشده ارسال می‌شوند. اگر فرایند ایجادشده نیز آن‌ها را بازتاب دهد، کاربر نویسه‌ها را دو بار خواهد دید. .B \-echo احتمالاً تنها در شرایطی مناسب است که بعید باشد کاربر الگو را ناتمام بگذارد. برای مثال، بخش زیر از rftp (اسکریپت ftp بازگشتی) گرفته شده است؛ جایی که از کاربر خواسته می‌شود برای دریافت (get)، ارسال (put) یا فهرست‌گیری (list) بازگشتی دایرکتوری جاری، ~g، ~p یا ~l را وارد کند. این‌ها با دستورهای عادی ftp چنان فاصله‌ای دارند که بعید است کاربر پس از ~ چیز دیگری را تایپ کند، مگر به اشتباه، که در آن صورت نیز احتمالاً نتیجه را به سادگی نادیده خواهد گرفت. .nf interact { -echo ~g {getcurdirectory 1} -echo ~l {getcurdirectory 0} -echo ~p {putcurdirectory} } .fi پرچم .B \-nobuffer نویسه‌هایی را که با الگوی پس از آن مطابقت دارند، هم‌زمان با خوانده شدن نویسه‌ها، به فرایند خروجی ارسال می‌کند. این ویژگی زمانی مفید است که بخواهید اجازه دهید یک برنامه الگو را بازتاب دهد. برای مثال، مورد زیر ممکن است برای نظارت بر شماره‌ای که فردی شماره‌گیری می‌کند (یک مودم با سبک Hayes) استفاده شود. با هر بار مشاهده "atd"، اسکریپت ادامه خط را ثبت می‌کند. .nf proc lognumber {} { interact -nobuffer -re "(.*)\\r" return puts $log "[clock format [clock seconds]]: dialed $interact_out(1,string)" } interact -nobuffer "atd" lognumber .fi .IP در طول .BR interact ، استفاده قبلی از .B log_user نادیده گرفته می‌شود. به‌ویژه، .B interact خروجی خود را مجبور می‌کند که ثبت (به خروجی استاندارد ارسال) شود، چرا که فرض بر این است که کاربر مایل نیست تعاملی کورکورانه داشته باشد. .IP پرچم .B \-o باعث می‌شود که هر جفت کلید-بدنه (key-body) پس از آن، بر خروجی فرایند جاری اعمال شود. این ویژگی برای مثال هنگام تعامل با میزبان‌هایی که در طول یک نشست telnet نویسه‌های ناخواسته ارسال می‌کنند مفید است. .IP به‌طور پیش‌فرض، .B interact انتظار دارد که کاربر روی stdin بنویسد و stdout خود فرایند .B Expect را بخواند. پرچم .B \-u (برگرفته از "user") باعث می‌شود .B interact کاربر را فرایندی در نظر بگیرد که با آرگومان آن نام‌گذاری شده است (که باید یک شناسه ایجادشده یا spawned id باشد). .IP این امر به دو فرایند نامرتبط اجازه می‌دهد تا بدون استفاده از یک حلقه صریح، به یکدیگر متصل شوند. برای کمک به اشکال‌زدایی، پیام‌های تشخیصی Expect همیشه به stderr فرستاده می‌شوند (یا برای برخی اطلاعات ثبت وقایع و اشکال‌زدایی، به stdout). به همین دلیل، دستور .B interpreter به صورت تعاملی از stdin خواهد خواند. .IP برای مثال، قطعه‌کد زیر یک فرایند login ایجاد می‌کند. سپس با کاربر شماره‌گیری می‌کند (نشان داده نشده)، و در نهایت آن دو را به یکدیگر متصل می‌سازد. البته، هر فرایندی را می‌توان جایگزین login کرد. برای نمونه، یک پوسته به کاربر اجازه می‌دهد تا بدون نیاز به ارائه حساب کاربری و گذرواژه کار کند. .nf spawn login set login $spawn_id spawn tip modem # dial back out to user # connect user to login interact \-u $login .fi برای ارسال خروجی به چندین فرایند، هر فهرست spawn id را با پیشوند پرچم .B \-output مشخص کنید. ورودی یک گروه از spawn idهای خروجی می‌تواند توسط فهرستی از spawn idها با پیشوند پرچم .B \-input تعیین شود. (هر دو پرچم .B \-input و .B \-output می‌توانند فهرست‌ها را به همان قالبی دریافت کنند که پرچم .B \-i در دستور .B expect دریافت می‌کند، با این تفاوت که any_spawn_id در .BR interact معنایی ندارد.) تمام پرچم‌ها و رشته‌ها (یا الگوها)ی بعدی تا زمانی که پرچم -input دیگری ظاهر شود، به این ورودی اعمال می‌شوند. اگر هیچ .B \-input ظاهر نشود، .B \-output به معنای "\-input $user_spawn_id \-output" تلقی خواهد شد. (مشابهاً برای الگوهایی که .BR \-input ندارند.) اگر یک .B \-input مشخص شود، جایگزین $user_spawn_id می‌شود. اگر دومین .B \-input مشخص شود، جایگزین $spawn_id خواهد شد. پرچم‌های .B \-input بیشتری را نیز می‌توان مشخص کرد. دو فرایند ورودی ضمنی به‌طور پیش‌فرض خروجی‌های خود را به صورت $spawn_id و $user_spawn_id (به طور معکوس) دارند. اگر یک پرچم .B \-input بدون پرچم .B \-output ظاهر شود، نویسه‌های آن فرایند دور ریخته می‌شوند. پرچم .B \-i زمانی که هیچ پرچم .B \-input یا .B \-output دیگری استفاده نشده باشد، جایگزینی برای spawn_id جاری معرفی می‌کند. یک پرچم \-i متضمن پرچم \-o نیز هست. تغییر فرایندهایی که با آن‌ها تعامل می‌شود با استفاده از spawn idهای غیرمستقیم امکان‌پذیر است. (شناسه‌های غیرمستقیم spawn id در بخش دستور expect شرح داده شده‌اند.) شناسه‌های غیرمستقیم spawn id را می‌توان با پرچم‌های -i، -u، -input یا -output تعیین کرد. .TP .B interpreter " [args]" باعث می‌شود که از کاربر به صورت تعاملی برای دریافت دستورهای .B Expect و Tcl درخواست شود. نتیجه هر دستور چاپ خواهد شد. .IP کنش‌هایی مانند .B break و .B continue باعث می‌شوند ساختارهای کنترلی (مانند .BR for و .BR proc ) به روش معمول رفتار کنند. اما .B return باعث می‌شود interpreter به فراخواننده خود بازگردد، در حالی که .B inter_return باعث می‌شود .B interpreter موجب بازگشت در فراخواننده خود شود. برای مثال، اگر "proc foo" دستور .B interpreter را فراخوانی کند و سپس کنش .B inter_return اجرا شود، .B proc foo بازمی‌گردد. هر دستور دیگری باعث می‌شود .B interpreter به درخواست دستورهای جدید ادامه دهد. .IP به‌طور پیش‌فرض، اعلان (prompt) شامل دو عدد صحیح است. عدد اول عمق پشته ارزیابی را مشخص می‌کند (یعنی چند بار Tcl_Eval فراخوانی شده است). عدد دوم شناسه تاریخچه در Tcl است. اعلان را می‌توان با تعریف رویه‌ای به نام "prompt1" تنظیم کرد که مقدار بازگشتی آن به عنوان اعلان بعدی استفاده می‌شود. اگر یک عبارت دارای علامت نقل‌قول، پرانتز، آکوالاد یا قلاب باز باشد، با رفتن به سطر جدید یک اعلان ثانویه (به‌طور پیش‌فرض "+> ") صادر می‌شود. اعلان ثانویه را می‌توان با تعریف رویه‌ای به نام "prompt2" تعیین کرد. .IP در طول اجرای .BR interpreter ، از حالت پخته (cooked mode) استفاده می‌شود، حتی اگر فراخواننده آن از حالت خام (raw mode) استفاده کرده باشد. .IP اگر stdin بسته شود، .B interpreter بازمی‌گردد مگر اینکه پرچم .B \-eof استفاده شده باشد؛ که در آن صورت، آرگومان بعدی فراخوانی می‌شود..TP .BI log_file " [args] [[\-a] file]" اگر نام فایلی ارائه شود، .B log_file رونوشتی از نشست را (با شروع از آن نقطه) در فایل ثبت خواهد کرد. اگر هیچ آرگومانی داده نشود، .B log_file ضبط را متوقف می‌کند. هر فایل لاگ قبلی بسته می‌شود. به جای نام فایل، می‌توان با استفاده از پرچم‌های .B \-open یا .B \-leaveopen یک شناسهٔ فایل Tcl ارائه داد. این عملکرد مشابه دستور .B spawn است. (برای اطلاعات بیشتر به .B spawn مراجعه کنید.) پرچم .B \-a باعث می‌شود خروجی‌هایی که توسط دستور .B log_user نادیده گرفته شده بودند نیز در لاگ ثبت شوند. به‌طور پیش‌فرض، دستور .B log_file به جای کوتاه‌کردن فایل‌های قدیمی، به انتهای آن‌ها .I ضمیمه می‌کند تا امکان فعال و غیرفعال کردن مکرر گزارش‌گیری در طول یک نشست فراهم باشد. برای خالی‌کردن فایل‌ها، از پرچم .B \-noappend استفاده کنید. پرچم .B \-info باعث می‌شود log_file توصیفی از جدیدترین آرگومان‌های غیر-info داده‌شده را برگرداند. .TP .BI log_user " \-info|0|1" به‌طور پیش‌فرض، گفتگوی send/expect در stdout (و در صورت باز بودن، در یک فایل لاگ) ثبت می‌شود. ثبت در stdout با دستور \(lqlog_user 0\(rq غیرفعال و با \(lqlog_user 1\(rq مجدداً فعال می‌شود. ثبت در فایل لاگ بدون تغییر می‌ماند. پرچم .B \-info باعث می‌شود log_user توصیفی از جدیدترین آرگومان‌های غیر-info داده‌شده را برگرداند. .TP .BI match_max " [\-d] [\-i spawn_id] [size]" اندازهٔ بافر (به بایت) را که به صورت داخلی توسط .B expect استفاده می‌شود تعیین می‌کند. بدون آرگومان .IR size ، اندازهٔ فعلی بازگردانده می‌شود. .IP با پرچم .BR \-d ، اندازهٔ پیش‌فرض تنظیم می‌شود. (پیش‌فرض اولیه ۲۰۰۰ است.) با پرچم .BR \-i ، اندازه برای spawn id نام‌برده تنظیم می‌شود، در غیر این صورت برای فرآیند فعلی تنظیم خواهد شد. .TP .BI overlay " [\-# spawn_id] [\-# spawn_id] [...] program [args]" دستور .IR "program args" را به جای برنامهٔ فعلی .B Expect که خاتمه می‌یابد، اجرا می‌کند. یک آرگومان خط تیرهٔ تنها (bare hyphen)، یک خط تیره در ابتدای نام دستور قرار می‌دهد، گویی که یک شل لاگین (login shell) است. تمام spawn_idها بسته می‌شوند به جز مواردی که به عنوان آرگومان نام برده شده‌اند. این‌ها به شناسه‌های فایل نام‌برده نگاشت می‌شوند. .IP شناسه‌های spawn_id برای به ارث بردن توسط برنامهٔ جدید به شناسه‌های فایل نگاشت می‌شوند. برای مثال، خط زیر chess را اجرا می‌کند و به آن اجازه می‌دهد توسط فرآیند فعلی کنترل شود \- مثلاً، یک استاد شطرنج. .nf overlay \-0 $spawn_id \-1 $spawn_id \-2 $spawn_id chess .fi این روش کارآمدتر از \(lqinteract \-u\(rq است، با این حال، توانایی انجام تعامل برنامه‌ریزی‌شده را فدا می‌کند زیرا فرآیند .B Expect دیگر در کنترل نیست. .IP توجه داشته باشید که هیچ ترمینال کنترلی ارائه نمی‌شود. بنابراین، اگر ورودی استاندارد را قطع کنید یا مجدداً نگاشت نمایید، برنامه‌هایی که کنترل شغل (job control) انجام می‌دهند (شل‌ها، login و غیره) به درستی کار نخواهند کرد. .TP .BI parity " [\-d] [\-i spawn_id] [value]" مشخص می‌کند که آیا پاریتی (parity) باید در خروجی فرآیندهای راه‌اندازی‌شده حفظ شود یا حذف گردد. اگر .I value صفر باشد، پاریتی حذف می‌شود، در غیر این صورت حذف نخواهد شد. بدون آرگومان .IR value ، مقدار فعلی برگردانده می‌شود. .IP با پرچم .BR \-d ، مقدار پیش‌فرض پاریتی تنظیم می‌شود. (پیش‌فرض اولیه ۱ است، یعنی پاریتی حذف نمی‌شود.) با پرچم .BR \-i ، مقدار پاریتی برای spawn id نام‌برده تنظیم می‌شود، در غیر این صورت برای فرآیند فعلی تنظیم خواهد شد. .TP .BI remove_nulls " [\-d] [\-i spawn_id] [value]" مشخص می‌کند که آیا کاراکترهای تهی (null) پیش از تطبیق الگو یا ذخیره در متغیر .I expect_out یا .IR interact_out ، از خروجی فرآیندهای راه‌اندازی‌شده حفظ یا حذف شوند. اگر .I value برابر ۱ باشد، کاراکترهای تهی حذف می‌شوند. اگر .I value برابر ۰ باشد، کاراکترهای تهی حذف نمی‌شوند. بدون آرگومان .IR value ، مقدار فعلی برگردانده می‌شود. .IP با پرچم .BR \-d ، مقدار پیش‌فرض تنظیم می‌شود. (پیش‌فرض اولیه ۱ است، یعنی کاراکترهای تهی حذف می‌شوند.) با پرچم .BR \-i ، مقدار برای spawn id نام‌برده تنظیم می‌شود، در غیر این صورت برای فرآیند فعلی تنظیم خواهد شد. چه کاراکترهای تهی حذف شوند یا نشوند، .B Expect بایت‌های null را در لاگ و stdout ثبت خواهد کرد. .TP .BI send " [\-flags] string" رشتهٔ .IR string را به فرآیند فعلی ارسال می‌کند. برای مثال، دستور .nf send "hello world\\r" .fi کاراکترهای h e l l o w o r l d را به فرآیند فعلی ارسال می‌کند. (زبان Tcl شامل یک دستور شبه-printf (به نام .BR format ) است که می‌تواند رشته‌هایی با هر میزان پیچیدگی دلخواه بسازد.) .IP کاراکترها بلافاصله ارسال می‌شوند، اگرچه برنامه‌های دارای ورودی میان‌گیرشدهٔ خطی (line-buffered) تا زمانی که کاراکتر return ارسال نشود کاراکترها را نخواهند خواند. کاراکتر return با \(lq\\r\(rq نشان داده می‌شود. پرچم .B \-\- باعث می‌شود آرگومان بعدی به جای یک پرچم، به عنوان یک رشته تفسیر شود. قبل از هر رشته‌ای می‌توان \(lq\-\-\(rq قرار داد، چه در ظاهر شبیه پرچم باشد و چه نباشد. این سازوکار مطمئنی را برای مشخص کردن رشته‌های متغیر بدون تداخل با مواردی که تصادفاً شبیه پرچم هستند، فراهم می‌کند. (تمام رشته‌هایی که با \(lq\-\(rq شروع می‌شوند برای گزینه‌های آینده رزرو شده‌اند.) پرچم .B \-i اعلام می‌کند که رشته به spawn_id نام‌برده ارسال شود. اگر spawn_id برابر .I user_spawn_id باشد و ترمینال در حالت raw قرار داشته باشد، کاراکترهای خط جدید (newline) در رشته به توالی‌های return-newline ترجمه می‌شوند تا طوری به نظر برسند که گویی ترمینال در حالت cooked قرار دارد. پرچم .B \-raw این ترجمه را غیرفعال می‌کند. پرچم .B \-null کاراکترهای null (بایت‌های ۰) را ارسال می‌کند. به‌طور پیش‌فرض، یک null ارسال می‌شود. یک عدد صحیح می‌تواند پس از .B \-null بیاید تا تعداد کاراکترهای null ارسالی را مشخص کند. پرچم .B \-break یک وضعیت break ایجاد می‌کند. این تنها در صورتی معنا دارد که spawn id به یک دستگاه tty باز شده از طریق \(lqspawn \-open\(rq اشاره کند. اگر فرآیندی مانند tip را راه‌اندازی کرده‌اید، باید از قرارداد tip برای ایجاد break استفاده کنید. پرچم .B \-s باعث می‌شود خروجی به صورت \(lqآهسته\(rq ارسال شود، تا بدین ترتیب از وضعیت رایجی که در آن رایانه سریع‌تر از بافر ورودی تایپ می‌کند (بافری که برای یک انسان طراحی شده که هرگز با آن سرعت تایپ نمی‌کند) جلوگیری شود. این خروجی توسط مقدار متغیر \(lqsend_slow\(rq کنترل می‌شود که یک لیست دو عنصری می‌گیرد. اولین عنصر یک عدد صحیح است که تعداد بایت‌هایی را که باید به طور یکپارچه (اتمیک) ارسال شوند توصیف می‌کند. عنصر دوم یک عدد حقیقی است که تعداد ثانیه‌هایی را مشخص می‌کند که ارسال‌های اتمیک باید با آن از یکدیگر فاصله داشته باشند. برای مثال، دستور \(lqset send_slow {10 .001}\(rq دستور \(lqsend \-s\(rq را وادار می‌کند تا رشته‌ها را با ۱ میلی‌ثانیه فاصله میان هر ۱۰ کاراکتر ارسال‌شده بفرستد. پرچم .B \-h باعث می‌شود خروجی (تا حدی) شبیه به تایپ واقعی یک انسان ارسال شود. تاخیرهای انسان‌گونه در میان کاراکترها ظاهر می‌شوند. (الگوریتم بر پایه توزیع وایبل (Weibull) است، همراه با تغییراتی متناسب با این کاربرد خاص.) این خروجی با مقدار متغیر \(lqsend_human\(rq کنترل می‌شود که یک لیست پنج عنصری می‌پذیرد. دو عنصر اول، میانگین زمان بین ورود (interarrival time) کاراکترها بر حسب ثانیه هستند. عنصر اول به‌طور پیش‌فرض استفاده می‌شود. عنصر دوم در انتهای کلمات استفاده می‌شود تا مکث‌های نامحسوسی را که گاهی اوقات در چنین گذارهایی رخ می‌دهند شبیه‌سازی کند. پارامتر سوم مقیاسی از متغیر بودن است که در آن ۰٫۱ کاملاً متغیر، ۱ تا حد معقولی متغیر، و ۱۰ کاملاً نامتغیر است. حالت‌های حدی از ۰ تا بی‌نهایت هستند. دو پارامتر آخر به ترتیب حداقل و حداکثر زمان بین ورود هستند. حداقل و حداکثر در آخر استفاده می‌شوند و زمان نهایی را محدود (clip) می‌کنند. اگر حداقل و حداکثر مقادیر کافی را برش بزنند، میانگین نهایی می‌تواند کاملاً متفاوت از میانگین داده‌شده باشد. به عنوان مثال، دستور زیر یک تایپیست سریع و یکدست را شبیه‌سازی می‌کند: .nf set send_human {.1 .3 1 .05 2} send \-h "I'm hungry. Let's do lunch." .fi در حالی که دستور زیر ممکن است پس از یک شب‌زنده‌داری سنگین مناسب‌تر باشد: .nf set send_human {.4 .4 .2 .5 100} send \-h "Goodd party lash night!" .fi توجه داشته باشید که خطاها شبیه‌سازی نمی‌شوند، اگرچه می‌توانید خودتان با گنجاندن اشتباهات و تصحیحات در یک آرگومان send، وضعیت‌های تصحیح خطا را ایجاد کنید. پرچم‌های ارسال کاراکترهای null، ارسال breakها، اجبار به خروجی آهسته و خروجی به سبک انسان مانعة‌الجمع هستند. تنها موردی که در آخر مشخص شود اعمال خواهد شد. علاوه بر این، هیچ آرگومان .I string نمی‌تواند همراه با پرچم‌های ارسال کاراکترهای null یا break مشخص شود. ایدهٔ خوبی است که قبل از اولین .B send به یک فرآیند، یک .B expect قرار دهید. .B expect منتظر شروع فرآیند خواهد ماند، در حالی که .B send نمی‌تواند این کار را انجام دهد. به ویژه اگر اولین .B send پیش از شروع اجرای فرآیند تکمیل شود، با خطر نادیده گرفته شدن داده‌هایتان مواجه می‌شوید. در شرایطی که برنامه‌های تعاملی اعلان اولیه (prompt) ارائه نمی‌دهند، می‌توانید قبل از .B send یک تاخیر قرار دهید، مانند: .nf # To avoid giving hackers hints on how to break in, # this system does not prompt for an external password. # Wait for 5 seconds for exec to complete spawn telnet very.secure.gov sleep 5 send password\\r .fi دستور .B exp_send یک نام مستعار برای .B send است. اگر از Expectk یا نسخه دیگری از Expect در محیط Tk استفاده می‌کنید، .B send توسط Tk برای هدفی کاملاً متفاوت تعریف شده است. .B exp_send برای سازگاری میان محیط‌ها ارائه شده است. نام‌های مستعار مشابهی برای سایر دستورهای send در Expect نیز ارائه شده است..TP .BI send_error " [\-flags] string" مانند .BR send است، با این تفاوت که خروجی به‌جای فرایند فعلی، به stderr ارسال می‌شود. .TP .BI send_log " [\--] string" مانند .BR send است، با این تفاوت که رشته فقط به فایل ثبت وقایع ارسال می‌شود (به .BR log_file مراجعه کنید). اگر هیچ فایل ثبت وقایعی باز نباشد، آرگومان‌ها نادیده گرفته می‌شوند. .TP .BI send_tty " [\-flags] string" مانند .BR send است، با این تفاوت که خروجی به‌جای فرایند فعلی، به /dev/tty ارسال می‌شود. .TP .BI send_user " [\-flags] string" مانند .BR send است، با این تفاوت که خروجی به‌جای فرایند فعلی، به stdout ارسال می‌شود. .TP .BI sleep " seconds" باعث می‌شود اسکریپت به مدت ثانیه‌های مشخص‌شده به خواب برود. ثانیه‌ها می‌توانند یک عدد اعشاری باشند. وقفه‌ها (و در صورت استفاده از Expectk، رویدادهای Tk) در حین به خواب رفتن Expect پردازش می‌شوند. .TP .BI spawn " [args] program [args]" فرایند جدیدی را ایجاد می‌کند که .IR "program args" را اجرا می‌نماید. ورودی استاندارد (stdin)، خروجی استاندارد (stdout) و خطای استاندارد (stderr) آن به Expect متصل می‌شوند تا بتوان توسط سایر دستورهای .B Expect در آن‌ها نوشت و از آن‌ها خواند. اتصال با .B close یا در صورتی که خود فرایند هر یک از شناسه‌های فایل را ببندد، قطع می‌شود. .IP هنگامی که فرایندی با .BR spawn آغاز می‌شود، متغیر .I spawn_id روی توصیف‌کننده‌ای تنظیم می‌شود که به آن فرایند ارجاع دارد. فرایندی که توسط .I spawn_id مشخص می‌شود، .IR "فرایند فعلی" در نظر گرفته می‌شود. .I spawn_id را می‌توان خواند یا نوشت که در عمل امکان کنترل کارها را فراهم می‌کند. .IP .I user_spawn_id یک متغیر سراسری شامل توصیف‌کننده‌ای است که به کاربر ارجاع دارد. برای مثال، هنگامی که .I spawn_id روی این مقدار تنظیم شود، .B expect مانند .BR expect_user رفتار می‌کند. .I .I error_spawn_id یک متغیر سراسری شامل توصیف‌کننده‌ای است که به خطای استاندارد ارجاع دارد. برای مثال، هنگامی که .I spawn_id روی این مقدار تنظیم شود، .B send مانند .BR send_error رفتار می‌کند. .IP .I tty_spawn_id یک متغیر سراسری شامل توصیف‌کننده‌ای است که به /dev/tty ارجاع دارد. اگر /dev/tty وجود نداشته باشد (مانند یک اسکریپت cron، at، یا batch)، آنگاه .I tty_spawn_id تعریف‌نشده است. این موضوع را می‌توان به صورت زیر بررسی کرد: .nf if {[info vars tty_spawn_id]} { # /dev/tty exists } else { # /dev/tty doesn't exist # probably in cron, batch, or at script } .fi .IP دستور .B spawn شناسه فرایند یونیکس را برمی‌گرداند. اگر هیچ فرایندی ایجاد نشود، 0 بازگردانده می‌شود. متغیر .I spawn_out(slave,name) روی نام دستگاه اسلیو pty تنظیم می‌شود. .IP به‌طور پیش‌فرض، .B spawn نام دستور و آرگومان‌های آن را بازتاب (echo) می‌دهد. پرچم .B \-noecho مانع از انجام این کار توسط .B spawn می‌شود. .IP پرچم .B \-console باعث می‌شود خروجی کنسول به فرایند ایجادشده بازهدایت شود. این قابلیت در همه سیستم‌ها پشتیبانی نمی‌شود. در درون، .B spawn از یک pty استفاده می‌کند که به همان شیوه tty کاربر مقداردهی اولیه می‌شود. همچنین تنظیمات آن طوری مقداردهی اولیه می‌شوند که همه موارد \(lqمعقول\(rq (مطابق با stty(1)) باشند. اگر متغیر .I stty_init تعریف شده باشد، به سبک آرگومان‌های stty به عنوان پیکربندی بیشتر تفسیر می‌شود. برای مثال، دستور \(lqset stty_init raw\(rq باعث می‌شود ترمینال‌های فرایندهای بعدیِ ایجادشده در حالت خام (raw) آغاز به کار کنند. .B \-nottycopy از مقداردهی اولیه بر اساس tty کاربر صرف‌نظر می‌کند. .B \-nottyinit از مقداردهی اولیه \(lqمعقول\(rq صرف‌نظر می‌کند. .IP به‌طور معمول، اجرای .B spawn زمان کمی می‌برد. اگر متوجه شدید که spawn زمان قابل‌توجهی صرف می‌کند، احتمالاً با ptyهایی مواجه شده است که مسدود (wedged) شده‌اند. تعدادی آزمایش روی ptyها انجام می‌شود تا از درگیر شدن با فرایندهای سرکش جلوگیری شود. (این آزمایش‌ها برای هر pty مسدودشده ۱۰ ثانیه زمان می‌برند.) اجرای Expect با گزینه .B \-d نشان می‌دهد که آیا .B Expect با چندین pty در وضعیت‌های نامتعارف مواجه شده است یا خیر. اگر نمی‌توانید فرایندهایی را که این ptyها به آن‌ها متصل هستند خاتمه دهید، تنها چاره ممکن است راه‌اندازی مجدد سیستم (reboot) باشد. اگر .I program به دلیل شکست exec(2) نتواند با موفقیت ایجاد شود (مثلاً هنگامی که .I program وجود ندارد)، یک پیام خطا توسط دستور بعدی .B interact یا .B expect بازگردانده می‌شود، به طوری که گویی .I program اجرا شده و پیام خطا را به عنوان خروجی تولید کرده است. این رفتار، پیامد طبیعی نحوه پیاده‌سازی .BR spawn است. در درون، spawn عمل fork را انجام می‌دهد که پس از آن فرایند ایجادشده هیچ راهی برای برقراری ارتباط با فرایند اصلی .B Expect به جز ارتباط از طریق spawn_id ندارد. پرچم .B \-open باعث می‌شود که آرگومان بعدی به عنوان یک شناسه فایل Tcl (یعنی بازگردانده‌شده توسط .BR open ) تفسیر شود. سپس شناسه spawn می‌تواند به گونه‌ای استفاده شود که گویی یک فرایند ایجادشده است. (دیگر نباید از شناسه فایل استفاده شود.) این امکان را فراهم می‌سازد تا با دستگاه‌های خام، فایل‌ها و خط‌لوله‌ها مانند فرایندهای ایجادشده بدون استفاده از pty رفتار شود. مقدار 0 برای نشان دادن اینکه هیچ فرایند مرتبطی وجود ندارد برگردانده می‌شود. هنگامی که اتصال به فرایند ایجادشده بسته شود، شناسه فایل Tcl نیز بسته خواهد شد. پرچم .B \-leaveopen مشابه .B \-open است، با این تفاوت که .B \-leaveopen باعث می‌شود شناسه فایل حتی پس از بسته شدن شناسه spawn باز بماند. پرچم .B \-pty باعث باز شدن یک pty می‌شود، اما فرایندی ایجاد نمی‌گردد. مقدار 0 برای نشان دادن اینکه هیچ فرایند مرتبطی وجود ندارد برگردانده می‌شود. Spawn_id طبق معمول تنظیم می‌گردد. متغیر .I spawn_out(slave,fd) روی شناسه فایل متناظر با اسلیو pty تنظیم می‌شود. می‌توان آن را با استفاده از \(lqclose \-slave\(rq بست. پرچم .B \-ignore سیگنالی را مشخص می‌کند که باید در فرایند ایجادشده نادیده گرفته شود. در غیر این صورت، سیگنال‌ها رفتار پیش‌فرض را دریافت می‌کنند. نام‌گذاری سیگنال‌ها مانند دستور .B trap است، با این تفاوت که هر سیگنال به یک پرچم جداگانه نیاز دارد. .TP .BI strace " level" باعث می‌شود عبارات بعدی پیش از اجرا چاپ شوند. (دستور trace در Tcl متغیرها را ردگیری می‌کند.) .I level مشخص می‌کند که ردگیری تا چه عمقی از پشته فراخوانی (call stack) ادامه یابد. برای مثال، دستور زیر .B Expect را در حالی اجرا می‌کند که ۴ سطح اول فراخوانی‌ها را ردگیری می‌کند، اما سطوح پایین‌تر از آن را ردگیری نمی‌نماید. .nf expect \-c "strace 4" script.exp .fi پرچم .B \-info باعث می‌شود strace توصیفی از جدیدترین آرگومان‌های غیر info داده‌شده را برگرداند..TP .BI stty " args" حالت‌های ترمینال را مشابه با دستور خارجی stty تغییر می‌دهد. به‌طور پیش‌فرض، به ترمینال کنترل‌کننده دسترسی پیدا می‌شود. با افزودن «< /dev/tty...» به دستور می‌توان به سایر ترمینال‌ها دسترسی یافت. (توجه داشته باشید که آرگومان‌ها نباید در یک آرگومان واحد گروه‌بندی شوند.) درخواست‌های بررسی وضعیت، آن را به عنوان نتیجه دستور بازمی‌گردانند. اگر وضعیتی درخواست نشود و به ترمینال کنترل‌کننده دسترسی پیدا شود، وضعیت پیشین مشخصه‌های raw و echo به شکلی بازگردانده می‌شود که بعداً بتواند توسط این دستور مورد استفاده قرار گیرد. برای نمونه، آرگومان‌های .B raw یا .B \-cooked ترمینال را در حالت raw قرار می‌دهند. آرگومان‌های .B \-raw یا .B cooked ترمینال را در حالت cooked قرار می‌دهند. آرگومان‌های .B echo و .B \-echo ترمینال را به ترتیب در حالت echo و noecho قرار می‌دهند. .IP مثال زیر نشان می‌دهد که چگونه می‌توان پژواک (echoing) را موقتاً غیرفعال کرد. این روش می‌تواند در اسکریپت‌هایی که در غیر این صورت خودکار هستند استفاده شود تا از تعبیه گذرواژه‌ها در آن‌ها جلوگیری شود. (توضیحات بیشتر در این مورد را در زیر، در بخش EXPECT HINTS ببینید.) .nf stty \-echo send_user "Password: " expect_user -re "(.*)\\n" set password $expect_out(1,string) stty echo .fi .TP .BI system " args" مقدار .I args را به عنوان ورودی به sh(1) می‌دهد، درست مانند اینکه به عنوان دستوری از یک ترمینال تایپ شده باشد. .B Expect تا زمان پایان یافتن شل منتظر می‌ماند. وضعیت بازگشتی از sh به همان روشی مدیریت می‌شود که .B exec وضعیت بازگشتی خود را مدیریت می‌کند. .IP برخلاف .B exec که stdin و stdout را به اسکریپت هدایت می‌کند، .B system هیچ تغییر مسیری انجام نمی‌دهد (مگر آنچه توسط خود رشته مشخص شده باشد). بنابراین، امکان استفاده از برنامه‌هایی که باید مستقیماً با /dev/tty ارتباط برقرار کنند وجود دارد. به همین دلیل، نتایج .B system در گزارش (log) ثبت نمی‌شوند. .TP .BI timestamp " [args]" یک برچسب زمانی (timestamp) بازمی‌گرداند. بدون هیچ آرگومانی، تعداد ثانیه‌های سپری‌شده از مبدأ زمانی (epoch) بازگردانده می‌شود. پرچم .B \-format رشته‌ای را معرفی می‌کند که بازگردانده می‌شود، اما جایگزینی‌هایی طبق قوانین POSIX برای strftime در آن اعمال می‌گردد. برای نمونه، %a با نام مخفف روز هفته (مثلاً Sat) جایگزین می‌شود. سایر موارد عبارتند از: .nf %a نام مخفف روز هفته %A نام کامل روز هفته %b نام مخفف ماه %B نام کامل ماه %c تاریخ-زمان مانند: Wed Oct 6 11:45:56 1993 %d روز ماه (01-31) %H ساعت (00-23) %I ساعت (01-12) %j روز (001-366) %m ماه (01-12) %M دقیقه (00-59) %p am یا pm %S ثانیه (00-61) %u روز (1-7، دوشنبه نخستین روز هفته است) %U هفته (00-53، نخستین یکشنبه، نخستین روز از هفته اول است) %V هفته (01-53، به سبک ISO 8601) %w روز (0-6) %W هفته (00-53، نخستین دوشنبه، نخستین روز از هفته اول است) %x تاریخ مانند: Wed Oct 6 1993 %X زمان مانند: 23:59:59 %y سال (00-99) %Y سال مانند: 1993 %Z منطقه زمانی (یا خالی در صورت عدم امکان تعیین) %% یک علامت درصد تنها .fi سایر مشخصه‌های % تعریف‌نشده هستند. سایر نویسه‌ها بدون تغییر عبور داده خواهند شد. تنها لوکال C پشتیبانی می‌شود. پرچم .B \-seconds تعدادی ثانیه از epoch را معرفی می‌کند تا به عنوان مبنایی برای قالب‌بندی استفاده شود. در غیر این صورت، از زمان جاری استفاده می‌شود. پرچم .B \-gmt خروجی برچسب زمانی را ملزم می‌کند تا از منطقه زمانی GMT استفاده کند. بدون این پرچم، از منطقه زمانی محلی استفاده می‌شود. .TP .BI trap " [[command] signals]" باعث می‌شود که .I command مشخص‌شده هنگام دریافت هر یک از سیگنال‌های داده‌شده در آینده، اجرا شود. دستور در دامنه سراسری (global scope) اجرا می‌شود. اگر .I command وجود نداشته باشد، کنش فعلی سیگنال بازگردانده می‌شود. اگر .I command رشته SIG_IGN باشد، سیگنال‌ها نادیده گرفته می‌شوند. اگر .I command رشته SIG_DFL باشد، کنش سیگنال‌ها به حالت پیش‌فرض سیستم بازگردانده می‌شود. .I signals یا یک سیگنال تکی است یا فهرستی از سیگنال‌ها. سیگنال‌ها ممکن است به صورت عددی یا نمادین مطابق با signal(3) مشخص شوند. پیشوند «SIG» می‌تواند حذف شود. بدون آرگومان (یا با آرگومان \-number)، دستور .B trap شماره سیگنالِ تله‌ای را که هم‌اکنون در حال اجراست بازمی‌گرداند. پرچم .B \-code کد بازگشتی دستور را به جای کدی که Tcl در هنگام شروع اجرای دستور قرار بود بازگرداند، استفاده می‌کند. پرچم .B \-interp باعث می‌شود دستور با استفاده از مفسری ارزیابی شود که در زمان شروع اجرای دستور فعال بوده است، نه زمانی که تله اعلان شده بود. پرچم .B \-name باعث می‌شود دستور .B trap نام سیگنالِ تله‌ای را که هم‌اکنون در حال اجراست بازگرداند. پرچم .B \-max باعث می‌شود دستور .B trap بزرگ‌ترین شماره سیگنالی را که می‌توان تنظیم کرد، بازگرداند. برای نمونه، دستور «trap {send_user "Ouch!"} SIGINT» هر بار که کاربر ^C را فشار دهد، عبارت "Ouch!" را چاپ خواهد کرد. به‌طور پیش‌فرض، SIGINT (که معمولاً با فشردن ^C ایجاد می‌شود) و SIGTERM باعث خروج Expect می‌شوند. این رفتار به دلیل تلهٔ زیر است که به‌طور پیش‌فرض هنگام شروع Expect ایجاد می‌شود. .nf trap exit {SIGINT SIGTERM} .fi اگر از پرچم \-D برای شروع اشکال‌زدا (debugger) استفاده کنید، SIGINT برای شروع اشکال‌زدای تعاملی بازتعریف می‌شود. این رفتار به دلیل تلهٔ زیر است: .nf trap {exp_debug 1} SIGINT .fi تلهٔ اشکال‌زدا را می‌توان با تنظیم متغیر محیطی EXPECT_DEBUG_INIT روی یک دستور تلهٔ جدید تغییر داد. البته می‌توانید هر دوی این‌ها را صرفاً با افزودن دستورهای trap به اسکریپت خود بازنویسی کنید. به‌ویژه، اگر دستور «trap exit SIGINT» اختصاصی خود را داشته باشید، جایگزین تلهٔ اشکال‌زدا خواهد شد. این کار زمانی مفید است که بخواهید به کلی از دسترسی کاربران به اشکال‌زدا جلوگیری کنید. اگر می‌خواهید تلهٔ سفارشی خود را روی SIGINT تعریف کنید اما همچنان هنگام فعال بودن اشکال‌زدا به آن تله‌گذاری شود، از عبارت زیر استفاده کنید: .nf if {![exp_debug]} {trap mystuff SIGINT} .fi همچنین، می‌توانید با استفاده از سیگنال دیگری به اشکال‌زدا تله بگذارید. دستور .B trap به شما اجازه نخواهد داد کنش مربوط به SIGALRM را بازنویسی کنید، زیرا این سیگنال به صورت داخلی توسط .BR Expect استفاده می‌شود. دستور disconnect مقدار SIGALRM را روی SIG_IGN (نادیده‌گرفتن) تنظیم می‌کند. تا زمانی که آن را در طول دستورهای بعدی spawn غیرفعال کنید، می‌توانید دوباره آن را فعال نمایید. برای اطلاعات بیشتر signal(3) را ببینید..TP .BI wait " [args]" تا زمانی که یک فرایند ایجادشده (یا فرایند فعلی در صورت مشخص نشدن هیچ فرایندی) پایان یابد، درنگ می‌کند. .IP دستور .B wait به‌طور معمول فهرستی از چهار عدد صحیح را برمی‌گرداند. اولین عدد صحیح، pid فرایندی است که منتظر آن بوده‌ایم. دومین عدد صحیح، spawn id متناظر است. سومین عدد صحیح در صورت وقوع خطای سیستم‌عامل، \-1 و در غیر این صورت 0 است. اگر عدد صحیح سوم 0 باشد، عدد صحیح چهارم وضعیتی (status) است که توسط فرایند ایجادشده بازگردانده شده است. اگر عدد صحیح سوم \-1 باشد، عدد صحیح چهارم مقدار errno تعیین‌شده توسط سیستم‌عامل است. متغیر سراسری errorCode نیز مقداردهی می‌شود. عناصر دیگری نیز ممکن است در انتهای مقدار بازگشتی از .BR wait ظاهر شوند. یک عنصر پنجم اختیاری، رده‌ای از اطلاعات را مشخص می‌کند. در حال حاضر، تنها مقدار ممکن برای این عنصر CHILDKILLED است که در این صورت، دو مقدار بعدی نام سیگنال به سبک C و یک توصیف متنی کوتاه خواهند بود. .IP پرچم .B \-i فرایندی را مشخص می‌کند که باید متناظر با spawn_id نام‌برده‌شده منتظر آن ماند (نه شناسه فرایند یا process id). درون یک گرداننده SIGCHLD، امکان انتظار برای هر فرایند ایجادشده با استفاده از spawn id \-1 وجود دارد. پرچم .B \-nowait باعث می‌شود که انتظار بلافاصله با نشانه یک انتظار موفقیت‌آمیز بازگردد. هنگامی که فرایند (بعداً) خارج شود، بدون نیاز به یک انتظار صریح، به‌طور خودکار ناپدید و پاک خواهد شد. دستور .B wait همچنین می‌تواند برای انتظار برای یک فرایند فورک‌شده با استفاده از آرگومان‌های "\-i \-1" استفاده شود. برعکس استفاده از آن با فرایندهای ایجادشده، این دستور در هر زمانی قابل اجرا است. هیچ کنترلی روی این‌که کدام فرایند درو (reap) شود وجود ندارد. با این حال، مقدار بازگشتی را می‌توان برای دریافت شناسه فرایند بررسی کرد. .SH "کتابخانه‌ها (LIBRARIES)" برنامه Expect به‌طور خودکار از دو کتابخانه توکار برای اسکریپت‌های Expect آگاه است. این کتابخانه‌ها توسط دایرکتوری‌های نام‌برده در متغیرهای exp_library و exp_exec_library تعریف می‌شوند. هر دوی آن‌ها برای نگهداری فایل‌های ابزاری که می‌توانند توسط اسکریپت‌های دیگر استفاده شوند در نظر گرفته شده‌اند. متغیر exp_library شامل فایل‌های مستقل از معماری است. متغیر exp_exec_library شامل فایل‌های وابسته به معماری است. بسته به سیستم شما، ممکن است هر دو دایرکتوری کاملاً خالی باشند. وجود فایل $exp_exec_library/cat-buffers نشان می‌دهد که آیا /bin/cat شما به‌طور پیش‌فرض بافر (buffer) انجام می‌دهد یا خیر. .SH "زیبانویسی (PRETTY-PRINTING)" یک تعریف vgrind برای زیبانویسی (pretty-printing) اسکریپت‌های .B Expect در دسترس است. با فرض اینکه تعریف vgrind ارائه‌شده همراه با توزیع .B Expect به‌درستی نصب شده باشد، می‌توانید از آن به صورت زیر استفاده کنید: .nf vgrind \-lexpect file .fi .SH "مثال‌ها (EXAMPLES)" شاید نحوه کنار هم قرار دادن تمام مواردی که این صفحه راهنما شرح می‌دهد بلافاصله آشکار نباشد. توصیه می‌کنم مثال‌های موجود در دایرکتوری example از توزیع .B Expect را مطالعه کرده و امتحان کنید. برخی از آن‌ها برنامه‌های واقعی هستند. برخی دیگر صرفاً نشان‌دهنده تکنیک‌های خاصی می‌باشند و البته، چندتایی هم صرفاً ترفندهای سریع و موقتی هستند. فایل INSTALL مروری سریع بر این برنامه‌ها دارد. .PP مقاله‌های .B Expect (به بخش SEE ALSO مراجعه کنید) نیز مفید هستند. اگرچه برخی مقاله‌ها از نحو مربوط به نسخه‌های قبلی Expect استفاده می‌کنند، اما مبانی منطقی همراه آن‌ها همچنان معتبر است و به جزئیات بسیار بیشتری نسبت به این صفحه راهنما می‌پردازد. .SH "هشدارها (CAVEATS)" افزونه‌ها ممکن است با نام دستورات Expect تداخل داشته باشند. برای مثال، .B send توسط Tk برای هدفی کاملاً متفاوت تعریف شده است. به همین دلیل، بیشتر دستورات .B Expect به صورت "exp_XXXX" نیز در دسترس هستند. دستورات و متغیرهایی که با "exp"، "inter"، "spawn" و "timeout" شروع می‌شوند نام مستعار (alias) ندارند. اگر به این سازگاری میان محیط‌ها نیاز دارید، از نام‌های گسترش‌یافته دستورات استفاده کنید. .B Expect دیدگاهی تا حدودی باز و منعطف نسبت به حوزه متغیرها (scoping) دارد. به‌ویژه، متغیرهایی که توسط دستورات اختصاصی برنامه .B Expect خوانده می‌شوند، ابتدا در حوزه محلی جستجو می‌شوند و در صورت پیدا نشدن، در حوزه سراسری. برای مثال، این ویژگی نیاز به قرار دادن "global timeout" در هر رویه‌ای که می‌نویسید و در آن از .B expect استفاده می‌شود را برطرف می‌سازد. از سوی دیگر، متغیرهای نوشته‌شده همیشه در حوزه محلی هستند (مگر اینکه دستور "global" صادر شده باشد). رایج‌ترین مشکلی که این موضوع ایجاد می‌کند زمانی است که spawn در یک رویه اجرا می‌شود. در خارج از رویه، .I spawn_id دیگر وجود ندارد، بنابراین فرایند ایجادشده صرفاً به دلیل حوزه متغیر دیگر در دسترس نخواهد بود. به چنین رویه‌هایی یک "global spawn_id" اضافه کنید. اگر نمی‌توانید قابلیت چندایجادی (multispawning) را فعال کنید (یعنی سیستم شما نه از select (BSD *.*)، نه از poll (SVR>2) و نه از چیزی معادل آن‌ها پشتیبانی می‌کند)، .B Expect تنها قادر خواهد بود در هر لحظه یک فرایند را کنترل کند. در این حالت، تلاشی برای مقداردهی .IR spawn_id نکنید، و همچنین نباید در حالی که یک فرایند ایجادشده در حال اجرا است، فرایندهایی را از طریق exec اجرا نمایید. علاوه بر این، قادر نخواهید بود به‌طور هم‌زمان از چندین فرایند (از جمله کاربر به عنوان یکی از آن‌ها) .B expect کنید. پارامترهای ترمینال می‌توانند تأثیر بزرگی روی اسکریپت‌ها داشته باشند. برای مثال، اگر اسکریپتی برای بررسی پژواک (echoing) نوشته شده باشد، در صورت خاموش بودن پژواک رفتار نادرستی نشان خواهد داد. به همین دلیل، Expect به‌طور پیش‌فرض پارامترهای ترمینال معقول (sane) را اعمال می‌کند. متأسفانه این امر می‌تواند شرایط را برای سایر برنامه‌ها ناخوشایند کند. به عنوان مثال، پوسته emacs می‌خواهد نگاشت‌های «معمول» را تغییر دهد: خطوط جدید به‌جای carriage-return newlines به newlines نگاشت می‌شوند و پژواک غیرفعال می‌شود. این به فرد امکان می‌دهد از emacs برای ویرایش خط ورودی استفاده کند. متأسفانه، Expect به هیچ وجه نمی‌تواند این موضوع را حدس بزند. می‌توانید درخواست کنید که Expect تنظیمات پیش‌فرض پارامترهای ترمینال خود را بازنویسی نکند، اما در این صورت باید هنگام نوشتن اسکریپت برای چنین محیط‌هایی بسیار محتاط باشید. در مورد emacs، از وابستگی به مواردی مانند پژواک و نگاشت‌های پایان خط خودداری کنید. دستوراتی که آرگومان‌ها را درون آکولاد به عنوان یک فهرست واحد می‌پذیرند (انواع .B expect و .BR interact ) از یک روش ابتکاری (heuristic) برای تشخیص اینکه آیا فهرست واقعاً یک آرگومان است یا چندین آرگومان استفاده می‌کنند. این روش ابتکاری تنها در حالتی ممکن است ناموفق باشد که فهرست در واقع نماینده یک آرگومان منفرد باشد که دارای چندین \en درون‌سازی‌شده به همراه نویسه‌های غیرفاصله‌ای در میان آن‌ها است. این حالت به قدر کافی بعید به نظر می‌رسد، با این حال می‌توان از آرگومان "\-nobrace" برای اجبار به رفتار با یک آرگومان منفرد به صورت یک آرگومان واحد استفاده کرد. از این گزینه می‌توان در کدهای Expect تولیدشده توسط ماشین استفاده نمود. به‌طور مشابه، \-brace رفتار با یک آرگومان منفرد به عنوان چندین الگو/عمل را اجباری می‌کند..SH "گزارش باگ‌ها (BUGS)" نام‌گذاری این برنامه به «sex» (مخفف «Smart EXec» یا «Send-EXpect») واقعاً وسوسه‌انگیز بود، اما عقل سلیم (یا شاید فقط سخت‌گیری اخلاقی) چیره شد. در برخی سیستم‌ها، هنگامی که یک شل فراخوانی (spawn) می‌شود، از عدم دسترسی به tty شکایت می‌کند اما با این وجود اجرا می‌شود. این بدان معناست که سیستم شما سازوکاری برای به دست آوردن tty کنترلی دارد که .B Expect از آن بی‌خبر است. لطفاً دریابید آن چیست و این اطلاعات را برای من ارسال کنید. سیستم‌عامل Ultrix 4.1 (حداقل آخرین نسخه‌های موجود در اینجا) مهلت‌های زمانی (timeout) بالاتر از 1000000 را معادل 0 در نظر می‌گیرد. سیستم‌عامل Digital UNIX 4.0A (و احتمالاً نسخه‌های دیگر) در صورتی که یک گرداننده برای سیگنال SIGCHLD تعریف کنید، از تخصیص ptyها خودداری می‌کند. برای اطلاعات بیشتر صفحهٔ grantpt را ببینید. سیستم‌عامل IRIX 6.0 مجوزهای دسترسی pty را به‌درستی مدیریت نمی‌کند، به‌طوری که اگر Expect تلاش کند یک pty را که پیش‌تر توسط شخص دیگری استفاده شده تخصیص دهد، با شکست مواجه می‌شود. به IRIX 6.1 ارتقا دهید. برنامهٔ Telnet (تنها تحت SunOS 4.1.2 تأیید شده) اگر TERM تنظیم نشده باشد معلق (hang) می‌شود. این مسئله در cron، at و اسکریپت‌های cgi که TERM را تعریف نمی‌کنند یک مشکل است. بنابراین باید آن را به‌طور صریح تنظیم کنید \- نوع آن معمولاً بی‌اهمیت است؛ فقط باید روی مقداری تنظیم شده باشد! نمونهٔ زیر احتمالاً برای بیشتر موارد کافی است. .nf set env(TERM) vt100 .fi برنامهٔ Tip (تنها تحت BSDI BSD/OS 3.1 i386 تأیید شده) اگر SHELL و HOME تنظیم نشده باشند معلق می‌شود. این مسئله در cron، at و اسکریپت‌های cgi که این متغیرهای محیطی را تعریف نمی‌کنند، مشکل‌ساز است. بنابراین باید آن‌ها را به‌طور صریح تنظیم کنید \- نوع آن‌ها معمولاً بی‌اهمیت است؛ فقط باید روی مقداری تنظیم شده باشند! نمونهٔ زیر احتمالاً برای بیشتر موارد کافی است. .nf set env(SHELL) /bin/sh set env(HOME) /usr/local/bin .fi برخی از پیاده‌سازی‌های pty به‌گونه‌ای طراحی شده‌اند که هسته هر خروجی خوانده‌نشده را ۱۰ تا ۱۵ ثانیه (تعداد واقعی به پیاده‌سازی بستگی دارد) پس از بسته شدن توصیف‌گر فایل توسط فرایند، دور می‌ریزد. بنابراین برنامه‌های .B Expect مانند .nf spawn date sleep 20 expect .fi با شکست مواجه خواهند شد. برای جلوگیری از این وضعیت، برنامه‌های غیرتعاملی را به جای .BR spawn با .B exec فراخوانی کنید. اگرچه چنین وضعیت‌هایی قابل‌تصور هستند، اما در عمل هرگز با شرایطی مواجه نشده‌ام که خروجی نهایی یک برنامهٔ واقعاً تعاملی به دلیل این رفتار از دست برود. از سوی دیگر، ptyهای Cray UNICOS هر خروجی خوانده‌نشده را بلافاصله پس از بسته شدن توصیف‌گر فایل توسط فرایند دور می‌اندازند. من این موضوع را به Cray گزارش کرده‌ام و آن‌ها در حال کار بر روی اصلاح آن هستند. گاهی اوقات به تأخیری میان اعلان (prompt) و پاسخ نیاز است؛ مانند زمانی که یک رابط tty در حال تغییر تنظیمات UART یا تطبیق نرخ‌های باود (baud rate) با بررسی بیت‌های start/stop است. معمولاً تمام آنچه نیاز است، توقف (sleep) برای یک یا دو ثانیه است. یک روش مطمئن‌تر، تلاش مجدد تا زمانی است که سخت‌افزار برای دریافت ورودی آماده شود. مثال زیر از هر دو راهبرد بهره می‌برد: .nf send "speed 9600\\r"; sleep 1 expect { timeout {send "\\r"; exp_continue} $prompt } .fi دستور trap \-code با هیچ دستوری که در حلقهٔ رویداد Tcl قرار دارد (مانند sleep) کار نخواهد کرد. مشکل این است که در حلقهٔ رویداد، Tcl کدهای بازگشتی گرداننده‌های رویداد ناهمگام (async) را نادیده می‌گیرد. یک راه‌حل جایگزین این است که پرچمی را در کد trap تنظیم کنید؛ سپس بلافاصله پس از اجرای آن دستور (یعنی sleep) پرچم را بررسی کنید. دستور expect_background آرگومان‌های \-timeout را نادیده می‌گیرد و به‌طور کلی هیچ مفهومی از مهلت زمانی ندارد. .SH "نکات EXPECT (EXPECT HINTS)" چندین نکته دربارهٔ .B Expect وجود دارد که ممکن است غیربدیهی به نظر برسند. این بخش سعی دارد با چند پیشنهاد به برخی از این موارد بپردازد. یک مشکل رایج در expect نحوهٔ تشخیص اعلان‌های شل (shell prompts) است. از آنجا که این اعلان‌ها توسط افراد مختلف و در شل‌های گوناگون به‌شکل متفاوتی سفارشی‌سازی می‌شوند، خودکارسازی قابل‌حمل rlogin بدون دانستن اعلان می‌تواند دشوار باشد. یک عرف منطقی این است که از کاربران خواسته شود یک عبارت باقاعده (regular expression) دربردارندهٔ توصیف اعلان خود (به‌ویژه بخش انتهایی آن) را در متغیر محیطی EXPECT_PROMPT ذخیره کنند. کدی شبیه به نمونهٔ زیر می‌تواند مورد استفاده قرار گیرد. اگر EXPECT_PROMPT وجود نداشته باشد، کد همچنان شانس خوبی برای کارکرد صحیح دارد. .nf set prompt "(%|#|\\\\$) $" ;# default prompt catch {set prompt $env(EXPECT_PROMPT)} expect -re $prompt .fi من شما را تشویق می‌کنم الگوهای .B expect را طوری بنویسید که انتهای هر آنچه را که انتظار دیدنش را دارید در بر گیرند. این کار از این احتمال که به یک پرسش پیش از مشاهدهٔ کامل آن پاسخ داده شود جلوگیری می‌کند. علاوه بر این، در حالی که ممکن است بتوانید پیش از مشاهدهٔ کامل پرسش به آن پاسخ دهید، اگر زود پاسخ دهید ممکن است پژواک پاسخ شما در میانهٔ پرسش پدیدار شود. به عبارت دیگر، گفتگوی نهایی صحیح خواهد بود اما آشفته و درهم‌ریخته به نظر می‌رسد. بیشتر اعلان‌ها شامل یک نویسهٔ فاصله در انتهای خود هستند. برای نمونه، اعلان ftp از \(aqf\(aq، \(aqt\(aq، \(aqp\(aq، \(aq>\(aq و (فاصله) تشکیل شده است. برای تطبیق این اعلان، باید تک‌تک این نویسه‌ها را به حساب آورید. عدم درج نویسهٔ فاصله یک اشتباه رایج است. فاصله را به‌طور صریح قرار دهید. اگر از الگویی به شکل X* استفاده کنید، نویسهٔ * تمام خروجی‌های دریافت‌شده از انتهای X تا آخرین چیز دریافت‌شده را مطابقت می‌دهد. این موضوع شهودی به نظر می‌رسد اما می‌تواند تا حدی گیج‌کننده باشد؛ زیرا عبارت «آخرین چیز دریافت‌شده» بسته به سرعت رایانه و پردازش I/O توسط هسته و گردانندهٔ دستگاه می‌تواند متغیر باشد. .PP به‌طور خاص، انسان‌ها تمایل دارند خروجی برنامه را در قالب تکه‌های بسیار بزرگ (به‌صورت یکپارچه و اتمیک) در حال دریافت ببینند، در حالی که در واقعیت بیشتر برنامه‌ها خروجی را خط به خط تولید می‌کنند. با فرض این موضوع، نویسهٔ * در الگوی بند پیشین ممکن است تنها انتهای خط فعلی را تطبیق دهد، حتی اگر به نظر برسد داده‌های بیشتری وجود دارد؛ زیرا در لحظهٔ تطبیق، تمام خروجی دریافت‌شده همان بوده است. .PP دستور .B expect هیچ راهی برای دانستن این موضوع ندارد که آیا خروجی بیشتری در راه است یا خیر، مگر اینکه الگوی شما مشخصاً آن را در نظر گرفته باشد. .PP حتی اتکا به بافرینگ خط‌محور نیز غیرهوشمندانه است. نه تنها برنامه‌ها به‌ندرت تعهدی دربارهٔ نوع بافرینگی که انجام می‌دهند ارائه می‌کنند، بلکه ناهماهنگی‌ها و وقفه‌های سیستمی می‌تواند خطوط خروجی را تکه‌تکه کند به‌طوری که خطوط در مکان‌هایی ظاهراً تصادفی شکسته شوند. بنابراین، اگر می‌توانید هنگام نوشتن الگوها چند نویسهٔ آخر یک اعلان را بیان کنید، عاقلانه است که حتماً این کار را انجام دهید. اگر در آخرین خروجی یک برنامه منتظر الگویی هستید و برنامه در عوض خروجی دیگری صادر کند، قادر نخواهید بود با کلیدواژهٔ .B timeout آن را تشخیص دهید. دلیل آن این است که .B expect دچار مهلت زمانی (timeout) نمی‌شود \- در عوض نشانگر .B eof را دریافت خواهد کرد. به جای آن از این نشانگر استفاده کنید؛ یا حتی بهتر، از هر دو بهره ببرید. به این ترتیب، اگر آن خط روزی جابه‌جا شود، نیازی به ویرایش خود خط نخواهید داشت. هنگامی که خروجی توسط گردانندهٔ ترمینال صادر می‌شود، خطوط جدید (newlines) معمولاً به توالی‌های carriage return و linefeed تبدیل می‌شوند. بنابراین، اگر الگویی می‌خواهید که صراحتاً با دو خط ناشی از مثلاً printf("foo\\nbar") مطابقت داشته باشد، باید از الگوی "foo\\r\\nbar" استفاده کنید. .PP تبدیل مشابهی هنگام خواندن ورودی از کاربر از طریق .BR expect_user رخ می‌دهد. در این حالت، زمانی که کلید return را فشار می‌دهید، به یک newline تبدیل می‌شود. اگر .B Expect سپس آن را به برنامه‌ای بفرستد که ترمینال خود را روی حالت خام یا raw تنظیم کرده باشد (مانند telnet)، مشکلی پیش خواهد آمد؛ زیرا آن برنامه انتظار یک return واقعی را دارد. (برخی برنامه‌ها در واقع بخشنده هستند و newlineها را به‌طور خودکار به return تبدیل می‌کنند، اما بیشتر آن‌ها این‌طور نیستند.) متأسفانه، هیچ راهی برای آگاهی از اینکه برنامه‌ای ترمینال خود را روی حالت raw قرار داده است وجود ندارد. .PP به جای جایگزینی دستی newline با return، راهکار استفاده از دستور "stty raw" است که این تبدیل را متوقف می‌سازد. با این حال توجه داشته باشید که این به معنای از دست دادن ویژگی‌های ویرایش خط در حالت پردازش‌شده (cooked) خواهد بود. .PP دستور .B interact به‌طور ضمنی ترمینال شما را روی حالت raw تنظیم می‌کند، بنابراین این مشکل در آن زمان پیش نخواهد آمد. اغلب مفید است که گذرواژه‌ها (یا دیگر اطلاعات محرمانه) در اسکریپت‌های .B Expect ذخیره شوند. این کار توصیه نمی‌شود، زیرا هر چیزی که روی یک رایانه ذخیره می‌شود ممکن است در دسترس دیگران قرار گیرد. بنابراین، درخواست تعاملی برای گذرواژه‌ها از درون اسکریپت، ایدهٔ هوشمندانه‌تری نسبت به درج مستقیم و تحت‌اللفظی آن‌ها است. با این وجود، گاهی اوقات چنین درجی تنها گزینهٔ ممکن است..PP متأسفانه، سیستم‌فایل UNIX روش مستقیمی برای ایجاد اسکریپت‌هایی که قابل اجرا اما غیرقابل خواندن باشند ندارد. سیستم‌هایی که از اسکریپت‌های شل با setgid پشتیبانی می‌کنند، می‌توانند این وضعیت را به‌طور غیرمستقیم به شرح زیر شبیه‌سازی کنند: .PP اسکریپت .B Expect (که حاوی داده‌های محرمانه است) را طبق روال معمول بسازید. مجوزهای دسترسی آن را روی 750 (\-rwxr\-x\-\-\-) قرار داده و مالکیت آن را به یک گروه قابل اعتماد، یعنی گروهی که مجاز به خواندن آن است، اختصاص دهید. در صورت نیاز، یک گروه جدید برای این منظور ایجاد کنید. سپس، یک اسکریپت /bin/sh با مجوزهای 2751 (\-rwxr\-s\-\-x) ایجاد کنید که متعلق به همان گروه قبلی باشد. .PP نتیجه، اسکریپتی است که می‌تواند توسط هر کاربری اجرا (و خوانده) شود. هنگامی که فراخوانی شود، اسکریپت .B Expect را اجرا می‌کند. .SH "همچنین ببینید (SEE ALSO)" .BR Tcl (3), .BR libexpect (3) .br .I "Exploring Expect: A Tcl-Based Toolkit for Automating Interactive Programs" \fRاثر Don Libes، ص. ۶۰۲، ISBN 1-56592-090-2، انتشارات O'Reilly and Associates، ۱۹۹۵. .br .I "expect: Curing Those Uncontrollable Fits of Interactivity" \fRاثر Don Libes، Proceedings of the Summer 1990 USENIX Conference, Anaheim, California, June 11-15, 1990. .br .I "Using .B expect to Automate System Administration Tasks" \fRاثر Don Libes، Proceedings of the 1990 USENIX Large Installation Systems Administration Conference, Colorado Springs, Colorado, October 17-19, 1990. .br .I "Tcl: An Embeddable Command Language" \fRاثر John Ousterhout، Proceedings of the Winter 1990 USENIX Conference, Washington, D.C., January 22-26, 1990. .br .I "expect: Scripts for Controlling Interactive Programs" \fRاثر Don Libes، Computing Systems, Vol. 4, No. 2, University of California Press Journals, November 1991. .br .I "Regression Testing and Conformance Testing Interactive Programs", \fRاثر Don Libes, Proceedings of the Summer 1992 USENIX Conference, pp. 135-144, San Antonio, TX, June 12-15, 1992. .br .I "Kibitz \- Connecting Multiple Interactive Programs Together", \fRاثر Don Libes، Software \- Practice & Experience, John Wiley & Sons, West Sussex, England, Vol. 23, No. 5, May, 1993. .br .I "A Debugger for Tcl Applications", \fRاثر Don Libes، Proceedings of the 1993 Tcl/Tk Workshop, Berkeley, CA, June 10-11, 1993. .SH "نویسنده (AUTHOR)" Don Libes، مؤسسه ملی استانداردها و فناوری (NIST) .SH "قدردانی‌ها (ACKNOWLEDGMENTS)" با تشکر از John Ousterhout برای Tcl، و Scott Paisley برای الهام‌بخشی. با تشکر از Rob Savoye برای کد پیکربندی خودکار Expect. .PP فایل HISTORY بخش عمده‌ای از سیر تکامل .BR expect را مستند کرده است. خواندن آن جالب است و می‌تواند بینش عمیق‌تری نسبت به این نرم‌افزار به شما بدهد. با تشکر از افرادی که نامشان در آن ذکر شده و اصلاحات باگ‌ها را فرستاده و کمک‌های دیگری ارائه دادند. .PP طراحی و پیاده‌سازی .B Expect تا حدی توسط دولت ایالات متحده تأمین مالی شده و بنابراین در مالکیت عمومی (public domain) قرار دارد. با این حال، در صورت استفاده از این برنامه و مستندات یا بخش‌هایی از آن‌ها، نویسنده و NIST تمایل دارند نام و اعتبارشان حفظ شود.