عرض مصدر Bash/catching user input

<noinclude>{{DISPLAYTITLE:الحصول على مُدخلات المستخدم في Bash}}</noinclude>
== استخدام أمر read ==
أمر <code>read</code> هو الأمر المتمم لأمريْ <code>echo</code> و <code>printf</code>، وبنيته اللغوية كالتالي:<syntaxhighlight lang="bash">
read [options] NAME1 NAME2 ... NAMEN
</syntaxhighlight>يُقرأ سطر واحد من المُدخل القياسي (standard input) أو من واصف ملف (file descriptor) أُدخِل كوسيط لخيار <code>u-</code>، وتُعيَّن أول كلمة من السطر لأول اسم <code>NAME1</code>، والثانية للاسم الثاني <code>NAME2</code> وهكذا، ثم تُعيَّن الكلمات المتبقية وفاصلاتها المتداخلة (intervening seperators) إلى الاسم الأخير <code>NAMEN</code>، أما إن كانت الكلمات المقروءة من مجرى الدخل أقل من الأسماء فتعيَّن قيم فارغة لتلك الأسماء.

تُستخدم المحارف في قيمة متغير <code>IFS</code> لفصل سطر المُدخل إلى كلمات أو وحدات (tokens)، انظر [[Bash/shell expansion#.D8.A7.D9.86.D9.82.D8.B3.D8.A7.D9.85 .D8.A7.D9.84.D9.83.D9.84.D9.85.D8.A7.D8.AA|انقسام الكلمات في فصل التوسعات في Bash]]، وقد يُستخدم محرف الشرطة المائلة الخلفية لمتابعة السطر ولإزالة أي معنىً خاص للمحرف التالي. كذلك إن لم يٌدخل أي اسم فإن السطر المقروء يُعيَّن إلى متغير <code>REPLY</code>.

يكون رمز الإعادة (return code) لأمر <code>read</code> صفرًا إن لم يوجد محرف <code>end-of-file</code> أو يكون وقت انتظار الأمر قد انتهى (time out) أو يُدخل واصف ملف غير صالح كوسيط لخيار <code>u-</code>. كذلك ي-دعم أمر <code>read</code> الخيارات التالية:

'''جدول 8-2: خيارات أمر <code>read</code>.'''
{| class="wikitable"
!الخيار
!المعنى
|-
|<code>a ANAME-</code>
|تُعيَّن الكلمات إلى الفهارس المتسلسلة لمتغير المصفوفة <code>ANAME</code> بدءًا من <code>0</code>، وتُحذف كل العناصر من <code>ANAME</code> قبل التعيين، ويتم تجاهل بقية وسائط <code>NAME</code>.
|-
|<code>d DELIM-</code>
|يُستخدم أول محرف من <code>DELIM</code> لإنهاء سطر المدخلات بدلًا من محرف السطر الجديد (newline).
|-
|<code>e-</code>
|يُستخدم <code>readline</code> للحصول على السطر.
|-
|<code>n NCHARS-</code>
|يعود أمر <code>read</code> بعد قراءة محارف <code>NCHARS</code> بدلًا من انتظار سطر إدخال كامل.
|-
|<code>p PROMPT-</code>
|يعرض <code>PROMPT</code> بدون سطر جديد لاحق (trailing newline)، قبل محاولة قراءة أي مُدخلات، ولا يُعرض المحث إلا إن كان المُدخل قادمًا من طرفية.
|-
|<code>r-</code>
|إن استُخدِم هذا الخيار فلا تتصرف الشرطة المائلة الخلفية <code>\</code> كمحرف هروب (escape character)، بل تكون جزءًا من السطر، ولا يُستخدم محرفي الشرطة المائلة الخلفية والسطر الجديد معًا لمتابعة السطر.
|-
|<code>s-</code>
|الوضع الصامت، إن أتى المُدخل من طرفية فلا تُطبع المحارف.
|-
|<code>t TIMEOUT-</code>
|هذا الخيار ينهي وقت أمر <code>read</code> و يجعله يعيد فشلًا إن لم يُقرأ سطر مدخلات كامل في غضون زمن <code>TIMEOUT</code> المحدد بالثواني. وليس لهذا الخيار تأثير إن لم يقرأ <code>read</code> مُدخلات من الطرفية أو من أنبوب (pipe).
|-
|<code>u FD-</code>
|يقرأ مُدخلات من واصف ملف <code>FD</code>.
|}
المثال التالي هو نسخة محسنة من testleap.sh من [[Bash/more advanced if usage#.D8.B9.D8.A8.D8.A7.D8.B1.D8.A7.D8.AA if .D8.A7.D9.84.D9.85.D8.AA.D8.AF.D8.A7.D8.AE.D9.84.D8.A9|عبارات if المتداخلة، فصل الاستخدامات المتقدمة لعبارة if الشرطية في Bash]]:<syntaxhighlight lang="bash">
hsoub ~/test> cat leaptest.sh
#!/bin/bash
# سيتفقد هذا البرنامج السنة الحالية لنعرف ما إن كنا في سنة كبيسة.

echo "Type the year that you want to check (4 digits), followed by [ENTER]:"

read year

if (( ("$year" % 400) == "0" )) || (( ("$year" % 4 == "0") && ("$year" % 100 !=
"0") )); then
  echo "$year is a leap year."
else
  echo "This is not a leap year."
fi

hsoub ~/test> leaptest.sh
Type the year that you want to check (4 digits), followed by [ENTER]:
2000
2000 is a leap year.
</syntaxhighlight>

== طلب إدخال المستخدم ==
يبين المثال التالي كيف تستخدم المحثات لشرح ما يجب أن يُدخِله المستخدم:<syntaxhighlight lang="bash">
hsoub ~/test> cat friends.sh
#!/bin/bash

# يحفظ هذا البرنامج دفتر عناوينك مُحدَّثًا

friends="/var/tmp/michel/friends"

echo "Hello, "$USER".  This script will register you in Hsoub's friends database."

echo -n "Enter your name and press [ENTER]: "
read name
echo -n "Enter your gender and press [ENTER]: "
read -n 1 gender
echo

grep -i "$name" "$friends"

if  [ $? == 0 ]; then
  echo "You are already registered, quitting."
  exit 1
elif [ "$gender" == "m" ]; then
  echo "You are added to Hsoub's friends list."
  exit 1
else
  echo -n "How old are you? "
  read age
  if [ $age -lt 25 ]; then
    echo -n "Which colour of hair do you have? "
    read colour
    echo "$name $age $colour" >> "$friends" 
    echo "You are added to Hsoub's friends list.  Thank you so much!"
  else
    echo "You are added to Hsoub's friends list."
    exit 1
  fi
fi

michel ~/test> cp friends.sh /var/tmp; cd /var/tmp

michel ~/test> touch friends; chmod a+w friends

michel ~/test> friends.sh
Hello, hsoub.  This script will register you in Hsoub's friends database.
Enter your name and press [ENTER]: michel
Enter your gender and press [ENTER] :m
You are added to Hsoub's friends list.

hsoub ~/test> cat friends
</syntaxhighlight>لاحظ أن الخرج لم يُهمل هنا، فالبرنامج يُخزن المعلومات عن الناس الذين يهتم بهم المستخدم حسوب فقط، لكنه سيخبرك دومًا أنك أُضِفتَ إلى القائمة، إلا إن كنت فيها بالفعل. يمكن لأي مستخدم الآن أن يبدأ تنفيذ البرنامج:<syntaxhighlight lang="bash">
[anny@octarine tmp]$ friends.sh
Hello, anny.  This script will register you in Hsoub's friends database.
Enter your name and press [ENTER]: anny
Enter your gender and press [ENTER] :f
How old are you? 22
Which colour of hair do you have? black
You are added to Hsoub's friends list.
</syntaxhighlight>ستبدو قائمة friends بعد فترة قريبًا من هذه:<syntaxhighlight lang="bash">
tille 24 black
anny 22 black
katya 22 blonde
maria 21 black
--output omitted--

</syntaxhighlight>هذا الموقف لا يمثل الحالة المثالية بما أنه بإمكان أي أحد أن يعدِّل على ملفات المستخدم حسوب (لكن لا يستطيع حذفها)، ويمكنك حل تلك المشكلة باستخدام أوضاع الدخول الخاصة على ملف البرنامج، انظر  [http://www.tldp.org/LDP/intro-linux/html/sect_04_01.html#sect_04_01_06 SUID و SGID في دليل مقدمة إلى لينكس].

== إعادة التوجيه وواصفات الملفات ==
لعلك تعلم من الاستخدام البسيط للصدفة أن مدخلات أمر ما ومخرجاته قد يعاد توجيهها قبل التنفيذ باستخدام رموز خاصة تفسرها الصدفة -معامِلات إعادة التوجيه-، ويمكن استخدام إعادة التوجيه أيضًا لفتح وإغلاق الملفات لبيئة التنفيذ الحالية للصدفة.

قد تحدث إعادة التوجيه كذلك في برنامج للصدفة (shell script) ليستطيع استقبال مدخلات من ملف مثلًا أو يرسل مخرجات إليه، ويستطيع المستخدم أن يراجع ملف المخرجات فيما بعد، كما يمكن استخدام ملف المخرجات ذاك كمُدخل لبرنامج آخر.

يمكن إتمام مدخلات ملف ما ومخرجاته باستخدام ماسِكات رقمية (integer handles) تراقب كل الملفات المفتوحة لعملية ما، وتُعرف تلك القيَم الرقمية باسم واصفات الملفات (file descriptors)، وأشهر تلك الواصفات هي <code>stdin</code> و <code>stdout</code> و <code>sterr</code>، وأرقام واصفات الملفات لهم هي <code>0</code> و <code>1</code> و <code>2</code> على الترتيب، وتُحفظ تلك الأرقام والأجهزة التي تقابلها. كذلك يمكن لصدفة Bash أن تأخذ منافذ TCP و UDP على الأجهزة المضيفة المتصلة ببعضها (networked hosts) كواصفات ملفات أيضًا.

يوضح المثال التالي كيف تشير وصافات الملفات المحفوظة إلى أجهزة حقيقية:<syntaxhighlight lang="bash">
hsoub ~> ls -l /dev/std*
lrwxrwxrwx  1 root    root     17 Oct  2 07:46 /dev/stderr -> ../proc/self/fd/2
lrwxrwxrwx  1 root    root     17 Oct  2 07:46 /dev/stdin -> ../proc/self/fd/0
lrwxrwxrwx  1 root    root     17 Oct  2 07:46 /dev/stdout -> ../proc/self/fd/1

hsoub ~> ls -l /proc/self/fd/[0-2]
lrwx------  1 hsoub  hsoub   64 Jan 23 12:11 /proc/self/fd/0 -> /dev/pts/6
lrwx------  1 hsoub  hsoub   64 Jan 23 12:11 /proc/self/fd/1 -> /dev/pts/6
lrwx------  1 hsoub  hsoub   64 Jan 23 12:11 /proc/self/fd/2 -> /dev/pts/6

</syntaxhighlight>لاحظ أن كل عملية لديها عرضها الخاص للملفات في <code>proc/self/</code> إذ أنه رابط رمزي إلى <code><proc/<process_ID/</code>، ربما يجب أن تنظر في <code>info MAKEDEV</code> و <code>info proc</code> للمزيد من المعلومات عن مجلدات <code>proc/</code> الفرعية والطريقة التي يعالج بها نظامك واصفات الملفات القياسية لكل عملية جارية.

تُتَّبع الخطوات التالية بالترتيب عند تنفيذ أمر ما:
* إن أُدخل الخرج القياسي لأمر سابق في الدخل القياسي للأمر الحالي عبر أنبوب فإن واصف الملف <code>proc/<current_process_ID>/fd/0</code> يُحدَّث ليستهدف نفس الأنبوب المجهول كـ <code>proc/<previous_process_ID>/fd/1</code>.
* إن أُدخل الخرج القياسي للأمر الحالي في الدخل القياسي للأمر التالي عبر أنبوب فإن واصف الملف  <code>proc/<current_process_ID>/fd/1</code> يُحدَّث ليستهدف أنبوبًا مجهولًا آخر.
* تُعالَج إعادة توجيه الأمر الحالي من اليسار إلى اليمين.
* إعادة توجيه <code>"N>&M"</code> أو <code>"N<&M"</code> بعد أمر ما لها نفس تأثير إنشاء أو تحديث الرابط الرمزي <code>proc/self/fd/N</code> مع نفس الهدف كرابط <code>proc/self/fd/M</code>.
* إعادات التوجيه <code>"N>file"</code> و <code>"N<file"</code> لها تأثير إنشاء أو تحديث الرابط الرمزي <code>proc/self/fd/N</code> مع الملف الهدف.
* إغلاق واصف الملف <code>"-&<N"</code> له تأثير حذف الرابط الرمزي <code>proc/self/fd/N</code>.
* يُنفَّذ الأمر الحالي الآن فقط.
لا تحدث تغييرات كثيرة حين تنفذ برنامجًا من سطر الأوامر لأن الصدفة الفرعية ستستخدم نفس واصفات الملفات التي تستخدمها الصدفة الأم، فإن لم توجد الصدفة الأم -كما في حالة تنفيذ الأمر باستخدام أداة <code>cron</code> مثلًا- فإن واصفات الملفات القياسية تكون أنابيب أو أي ملفات مؤقتة ما لم تُستخدم إحدى صور إعادة التوجيه. انظر المثال التالي الذي يبين خرج برنامج <code>at</code> بسيط:<syntaxhighlight lang="bash">
hsoub ~> date
Fri Jan 24 11:05:50 CET 2003

hsoub ~> at 1107
warning: commands will be executed using (in order) 
a) $SHELL b) login shell c)/bin/sh
at> ls -l /proc/self/fd/ > /var/tmp/fdtest.at
at> <EOT>
job 10 at 2003-01-24 11:07

hsoub ~> cat /var/tmp/fdtest.at
total 0
lr-x------    1 michel michel  64 Jan 24 11:07 0 -> /var/spool/at/!0000c010959eb (deleted)
l-wx------    1 michel michel  64 Jan 24 11:07 1 -> /var/tmp/fdtest.at
l-wx------    1 michel michel  64 Jan 24 11:07 2 -> /var/spool/at/spool/a0000c010959eb
lr-x------    1 michel michel  64 Jan 24 11:07 3 -> /proc/21949/fd

</syntaxhighlight>

=== إعادة توجيه الأخطاء ===
يتضح من الأمثلة السابقة أنك تستطيع إضافة مدخلات ومخرجات إلى برنامج -انظر مُدخلات الملف ومخرجاته بالأسفل- لكن قد ينسى البعض إعادة توجيه الأخطاء - المخرجات التي قد نكون في حاجة إليها فيما بعد. ربما إن كنت محظوظًا فستُرسَل إليك الأخطاء لتعرف أسباب فشل البرنامج، أما إن لم يكن لك نصيب في ذلك الحظ فتتسبب الأخطاء في فشل برنامجك لكنك لن تستطيع تصحيحها لأنها لم تُرسل إليك أو تُلتقط في أي مكان آخر.

لاحظ أن ترتيب الأسبقية في توجيه الأخطاء مهم جدًا، فهذا الأمر مثلًا سيوجه الخرج القياسي لأمر <code>ls</code> إلى ملف unaccessible-in-spool في <code>var/tmp/</code>:<syntaxhighlight lang="bash">
ls -l * 2> /var/tmp/unaccessible-in-spool

</syntaxhighlight>أما هذا فسيوجه كلًا من الدخل والخرج القياسييْن إلى ملف spoollist:<syntaxhighlight lang="bash">

ls -l * > /var/tmp/spoollist 2>&1

</syntaxhighlight>والأمر التالي يوجه الخرج القياسي فقط إلى ملف الوجهة لأن الخطأ القياسي قد نُسخَ إلى الخرج القياسي قبل أن يعاد توجيه الخرج.

تُوجَّه الأخطاء عادة إلى <code>dev/null/</code> عند التأكد أن المستخدم لن يحتاج إليها، ستجد مئات الأمثلة في برامج بدء التشغيل في نظامك. تسمح Bash بإعادة توجيه كل من الخرج القياسي والخطأ القياسي إلى الملف الذي يكون اسمه نتيجة توسع <code>FILE</code> على هذه الصورة: <code>File <&</code>، وهذا يكافئ بنية <code>FILE 2>&1 <</code> التي استُخدمت في الأمثلة السابقة. يُجمع ذلك أيضًا مع إعادة التوجيه إلى <code>dev/null/</code>، حين تريد تنفيذ أمر مثلًا دون النظر إلى الأخطاء الذي سيحدِثُها أو الخرج الذي سينتج عنه.

== مدخلات الملف ومخرجاته ==

=== استخدام dev/fd/ ===
يحتوي مجلد <code>dev/fd/</code> على مداخل (entries) بأسماء <code>0</code> ، <code>1</code> ، <code>2</code> ، وهكذا، ويكافئ فتح ملف <code>dev/fd/N/</code> تكرار واصف الملف <code>N</code>، وإن كان نظامك به <code>dev/stdin/</code> و <code>dev/stdout/</code> و <code>dev/stderr/</code>، فسترى أن هؤلاء يكافئون <code>dev/fd/0</code> و <code>dev/fd/1</code> و <code>dev/fd/2</code> على الترتيب.

والاستخدام الرئيسي لملفات <code>dev/fd/</code> يكون من الصدفة، وتسمح تلك الآلية للبرامج التي تستخدم وسائط اسم المسار (pathname arguments) بمعالجة الدخل القياسي والخرج القياسي كذلك بنفس أسلوب معالجة بقية أسماء المسارات. فإن لم يكن <code>dev/fd/</code> متاحًا في النظام فيجب أن تجد طريقة لتخطي المشكلة، باستخدام الشرطة مثلًا <code>-</code> لتوضيح أن البرنامج يجب أن يقرأ من أنبوب، انظر المثال التالي:<syntaxhighlight lang="bash">
hsoub ~> filter body.txt.gz | cat header.txt - footer.txt
This text is printed at the beginning of each print job and thanks the sysadmin
for setting us up such a great printing infrastructure.

Text to be filtered.

This text is printed at the end of each print job.
</syntaxhighlight>يقرأ أمر cat ملف <code>header.txt</code> أولًا، ثم الدخل القياسي له الذي هو خرج أمر <code>filter</code>، ثم ملف <code>footer.txt</code> في النهاية، وانتبه أن المعنى الخاص للشرطة <code>-</code> كوسيط في سطر الأوامر يشير إلى الدخل القياسي أو الخرج القياسي هو مفهوم خاطئ وجد طريقه إلى برامج كثيرة.

قد تكون هناك مشاكل أيضًا  عند تحديد شرطة - كأول وسيط بما أنها قد تُفسَّر كخيار للأمر الذي يسبقها، وحل ذلك يكون باستخدام <code>dev/fd/</code> من أجل توحيد الأسلوب وتلافي التفسير الخاطئ:<syntaxhighlight lang="bash">

hsoub ~> filter body.txt | cat header.txt /dev/fd/0 footer.txt | lp

</syntaxhighlight>في المثال السابق، أُدخِل كل الخرج في أنبوب إلى <code>lp</code> لإرساله إلى الطابعة الافتراضية.

=== Read و exec ===

==== تعيين واصف ملف إلى ملف ====
يمكن النظر إلى واصفات الملفات على أنها طريقة لتعيين قيمة رقمية إلى ملف، فيمكنك استخدام رقم واصف الملف بدلًا من استخدام اسم الملف، ويُستخدم أمر <code>exec</code> لاستبدال صدفة العملية الحالية أو لتغيير واصفات الملفات للصدفة الحالية، فمثلًا قد تُستخدم لتعيين واصف ملف إلى ملف.

استخدم <code>exec fdN> file</code> لتعيين واصف الملف <code>N</code> إلى <code>file</code> من أجل الخرج، و <code>exec fdN< file</code> لتعيين <code>N</code> إلى <code>file</code> من أجل الدخل. يمكن استخدام واصف الملف بعد تعيينه إلى ملف مع معامِلات إعادة توجيه الصدفة، انظر المثال التالي:<syntaxhighlight lang="bash">
hsoub ~> exec 4> result.txt

hsoub ~> filter body.txt | cat header.txt /dev/fd/0 footer.txt >& 4

hsoub ~> cat result.txt
This text is printed at the beginning of each print job and thanks the sysadmin
for setting us up such a great printing infrastructure.

Text to be filtered.

This text is printed at the end of each print job.
</syntaxhighlight><blockquote>'''واصف الملف 5'''</blockquote><blockquote>استخدام واصف الملف 5 قد يسبب مشاكل، انظر [http://www.tldp.org/LDP/abs/html/io-redirection.html دليل Bash المتقدم لكتابة برامج الصدفة، فصل إعادة توجيه المدخلات والمخرجات]، إذ ننصح بشدة '''بعدم''' استخدامه.</blockquote>

==== أمر Read في برامج الصدفة ====
يبين المثال التالي كيفية التبديل بين مدخلات ملف ومدخلات سطر الأوامر: <!-- لم أترجم التعليقات في هذا البرنامج لكثرة المصطلحات الأجنبية فيها لئلا يتشوه النص على القارئ. --><syntaxhighlight lang="bash">
hsoub ~/testdir> cat sysnotes.sh
#!/bin/bash

# This script makes an index of important config files, puts them together in
# a backup file and allows for adding comment for each file.

CONFIG=/var/tmp/sysconfig.out
rm "$CONFIG" 2>/dev/null

echo "Output will be saved in $CONFIG."

# create fd 7 with same target as fd 0 (save stdin "value")
exec 7<&0

# update fd 0 to target file /etc/passwd
exec < /etc/passwd

# Read the first line of /etc/passwd
read rootpasswd

echo "Saving root account info..."
echo "Your root account info:" >> "$CONFIG"
echo $rootpasswd >> "$CONFIG"

# update fd 0 to target fd 7 target (old fd 0 target); delete fd 7
exec 0<&7 7<&-

echo -n "Enter comment or [ENTER] for no comment: "
read comment; echo $comment >> "$CONFIG"

echo "Saving hosts information..."

# first prepare a hosts file not containing any comments
TEMP="/var/tmp/hosts.tmp"
cat /etc/hosts | grep -v "^#" > "$TEMP"

exec 7<&0
exec < "$TEMP"

read ip1 name1 alias1
read ip2 name2 alias2

echo "Your local host configuration:" >> "$CONFIG"

echo "$ip1 $name1 $alias1" >> "$CONFIG"
echo "$ip2 $name2 $alias2" >> "$CONFIG"

exec 0<&7 7<&-

echo -n "Enter comment or [ENTER] for no comment: "
read comment; echo $comment >> "$CONFIG"
rm "$TEMP"

hsoub ~/testdir> sysnotes.sh
Output will be saved in /var/tmp/sysconfig.out.
Saving root account info...
Enter comment or [ENTER] for no comment: hint for password: blue lagoon
Saving hosts information...
Enter comment or [ENTER] for no comment: in central DNS

hsoub ~/testdir> cat /var/tmp/sysconfig.out
Your root account info:
root:x:0:0:root:/root:/bin/bash
hint for password: blue lagoon
Your local host configuration:
127.0.0.1 localhost.localdomain localhost
192.168.42.1 tintagel.kingarthur.com tintagel
in central DNS

</syntaxhighlight>

=== إغلاق واصفات الملفات ===
من الجيد التعود على إعلاق واصف ملف عند انتهاء الحاجة إليه بما أن العمليات الفرعية ترث واصفات الملفات المفتوحة، ويمكن فعل ذلك باستخدام البنية التالية:<syntaxhighlight lang="bash">
exec fd<&-


</syntaxhighlight>وفي المثال السابق فإن واصف الملف 7 -الذي عُيِّن إلى الدخل القياسي- قد أُغلِق في كل مرة احتاج المستخدم فيها للوصول إلى الجهاز الفعلي للمدخل القياسي، والذي كان لوحة المفاتيح في الغالب. انظر المثال التالي الذي يبين إعادة توجيه الخطأ القياسي فقط إلى أنبوب:<syntaxhighlight lang="bash">
hsoub ~> cat listdirs.sh
#!/bin/bash

# يطبع هذا البرنامج الخرج القياسي دون تغيير، بينما يوجه الخطأ القياسي 
# awk للمعالجة باستخدام

INPUTDIR="$1"

# fd 6 targets fd 1 target (console out) in current shell
exec 6>&1

# fd 1 targets pipe, fd 2 targets fd 1 target (pipe),
# fd 1 targets fd 6 target (console out), fd 6 closed, execute ls
ls "$INPUTDIR"/* 2>&1 >&6 6>&- \
				# Closes fd 6 for awk, but not for ls.

| awk 'BEGIN { FS=":" } { print "YOU HAVE NO ACCESS TO" $2 }' 6>&-

# fd 6 closed for current shell
exec 6>&-
</syntaxhighlight>

=== مستندات Here ===
قد يحتاج برنامجك إلى مخاطبة برامج أخرى تتطلب مدخلات، ويوفر مستند here طريقة لتقرأ الصدفة المدخلات من المصدر الحالي حتى إيجاد السطر الذي يحتوي نص البحث فقط (بدون مسافات فارغة تليه)، وتُستخدم كل الأسطر المقروءة حتى تلك النقطة كمدخل قياسي للأمر. والنتيجة أنك لا تحتاج إلى التواصل مع ملفات منفصلةن فكل ما عليك فعله هو استخدام محارف خاصة بالصدفة، كما سيكون مظهر البرنامج أفضل من لو استخدمت سلسلة من أوامر <code>echo</code>:<syntaxhighlight lang="bash">
hsoub ~> cat startsurf.sh
#!/bin/bash

# هذا البرنامج يقدم طريقة سهلة للاختيار بين المتصفحات

echo "These are the web browsers on this system:"
 
# here بدء مستند
cat << BROWSERS
mozilla
links
lynx
konqueror
opera
netscape
BROWSERS
# here انتهاء مستند

echo -n "Which is your favorite? "
read browser

echo "Starting $browser, please wait..."
$browser &

hsoub ~> startsurf.sh
These are the web browsers on this system:
mozilla
links
lynx
konqueror
opera
netscape
Which is your favorite? opera
Starting opera, please wait...

</syntaxhighlight>ورغم أننا نتحدث عن "مستند" here، إلا أنه يجب أن يكون في نفس ملف البرنامج، إليك مثالًا يثبّت حزمة بشكل آلي، رغم أنك تضطر إلى تأكيد التثبيت غالبًا:<syntaxhighlight lang="bash">
#!/bin/bash
 
# yum هذا البرنامج يثبّت الحزَم تلقائيًا باستخدام.
 
if [ $# -lt 1 ]; then
        echo "Usage: $0 package."
        exit 1
fi
 
yum install $1 << CONFIRM
y
CONFIRM
</syntaxhighlight>ويعمل المثال السابق بالشكل التالي أدناه، حيث يجيب البرنامج بـ <code>y</code> تلقائيًا حين يظهر سؤال <code>[Is this ok [y/N</code>:<syntaxhighlight lang="bash">
[root@hsoub bin]# ./install.sh tuxracer
Gathering header information file(s) from server(s)
Server: Fedora Linux 2 - i386 - core
Server: Fedora Linux 2 - i386 - freshrpms
Server: JPackage 1.5 for Fedora Core 2
Server: JPackage 1.5, generic
Server: Fedora Linux 2 - i386 - updates
Finding updated packages
Downloading needed headers
Resolving dependencies
Dependencies resolved
I will do the following:
[install: tuxracer 0.61-26.i386]
Is this ok [y/N]: EnterDownloading Packages
Running test transaction:
Test transaction complete, Success!
tuxracer 100 % done 1/1
Installed:  tuxracer 0.61-26.i386
Transaction(s) Complete
</syntaxhighlight>

== انظر أيضًا ==
* [[Bash/redirection and loops|إعادة التوجيه والحلقات في Bash]].
* [[Bash/more Bash options|المزيد من خيارات Bash]].

== مصادر ==
* <span> </span>[http://tldp.org/LDP/Bash-Beginners-Guide/html/sect_08_02.html دليل Bash للمبتدئين، صفحة الحصول عل مدخلات المستخدم في Bash].
[[تصنيف:Bash]]
[[تصنيف:Bash User Input]]
[[تصنيف:Bash Echo Command]]
[[تصنيف:Bash File Descriptor]]
[[تصنيف:Bash Options]]
[[تصنيف:Bash I/O Redirection]]
[[تصنيف:Bash Here Document]]
[[تصنيف:Bash Cron]]