.\" -*- coding: UTF-8 -*-
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.ie n \{\
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds C`
. ds C'
'br\}
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.de IX
..
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
. \}
.\}
.rr rF
.if n .ds AD l
.\"
.\" Required to disable full justification in groff 1.23.0.
.\" ========================================================================
.\"
.IX العنوان "WGET 1"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH WGET 1 "7 نوفمبر 2025" "جنو ويجيت 1.25.0" "جنو ويجيت"
.if n .ad l
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.nh
.SH الاسم
ويجيت \- منزل الشبكة غير التفاعلي.
.SH موجز
.IX ترويسة موجز
wget [\fIالخيار\fP]... [\fIرابط_المسار\fP]...
.SH الوصف
.IX ترويسة الوصف
جنو ويجيت أداة حرة لتنزيل الملفات من الويب بشكل غير تفاعلي. وتدعم بروتوكولات
HTTP و HTTPS و FTP، بالإضافة إلى الاستجلاب عبر وكلاء HTTP.
.PP
ويجيت غير تفاعلي، مما يعني أنه يمكنه العمل في الخلفية بينما لا يكون المستخدم
مسجل الدخول. وهذا يتيح لك بدء عملية استجلاب ثم الفصل من النظام، وترك ويجيت
ينهي العمل. وعلى النقيض من ذلك، تتطلب معظم متصفحات الويب حضور المستخدم
المستمر، وهو ما قد يمثل عائقًا كبيرًا عند نقل الكثير من البيانات.
.PP
يمكن لويجيت تتبع الروابط في صفحات HTML و XHTML و CSS، لإنشاء نسخ محلية من
مواقع الويب البعيدة، مع إعادة إنشاء هيكل الدليل للموقع الأصلي بالكامل. يُشار
إلى هذا أحيانًا باسم "التنزيل المتكرر". وأثناء القيام بذلك، يحترم ويجيت
معيار استبعاد الروبوتات (\fI/robots.txt\fP). يمكن توجيه ويجيت لتحويل الروابط في
الملفات المنزلة لتشير إلى الملفات المحلية، للعرض دون اتصال.
.PP
صُمم ويجيت ليكون قويًا عبر اتصالات الشبكة البطيئة أو غير المستقرة؛ فإذا فشل
التنزيل بسبب مشكلة في الشبكة، فسيواصل المحاولة حتى يُستجلب الملف
بالكامل. وإذا كان الخادم يدعم إعادة الاستجلاب، فإنه سيوجه الخادم لمواصلة
التنزيل من حيث توقف.
.SH الخيارات
.IX ترويسة الخيارات
.SS "بنية الخيار"
.IX "قسم فرعي" "بنية الخيار"
بما أن ويجيت يستخدم جنو getopt لمعالجة وسائط سطر الأوامر، فإن لكل خيار شكلًا
طويلًا إلى جانب الشكل القصير. الخيارات الطويلة أكثر ملاءمة للتذكر، ولكنها
تستغرق وقتًا في الكتابة. يمكنك مزج أنماط الخيارات المختلفة بحرية، أو تحديد
الخيارات بعد وسائط سطر الأوامر. وبالتالي يمكنك كتابة:
.PP
.Vb 1
\& wget \-r \-\-tries=10 http://fly.srk.fer.hr/ \-o log
.Ve
.PP
يمكن حذف المسافة بين الخيار الذي يقبل وسيطًا والوسيط نفسه. فبدلًا من \fB\-o log\fP يمكنك كتابة \fB\-olog\fP.
.PP
يمكنك وضع عدة خيارات لا تتطلب وسائط معًا، مثل:
.PP
.Vb 1
\& wget \-drc <رابط_المسار>
.Ve
.PP
هذا يعادل تمامًا:
.PP
.Vb 1
\& wget \-d \-r \-c <رابط_المسار>
.Ve
.PP
نظرًا لأنه يمكن تحديد الخيارات بعد الوسائط، يمكنك إنهاؤها بـ \fB\-\-\fP. لذا
سيحاول ما يلي تنزيل الرابط \fB\-x\fP، مع الإبلاغ عن الفشل في \fIlog\fP:
.PP
.Vb 1
\& wget \-o log \-\- \-x
.Ve
.PP
الخيارات التي تقبل قوائم مفصولة بفاصلة تحترم جميعها العرف القائل بأن تحديد
قائمة فارغة يمسح قيمتها. قد يكون هذا مفيدًا لمسح إعدادات \fI.wgetrc\fP. على
سبيل المثال، إذا كان ملف \fI.wgetrc\fP الخاص بك يضبط
\f(CW\*(C`exclude_directories\*(C'\fP على \fI/cgi\-bin\fP، فإن المثال التالي سيعيد
ضبطه أولًا، ثم يضبطه لاستبعاد \fI/~nobody\fP و \fI/~somebody\fP. يمكنك أيضًا مسح
القوائم في \fI.wgetrc\fP.
.PP
.Vb 1
\& wget \-X "" \-X /~nobody,/~somebody
.Ve
.PP
معظم الخيارات التي لا تقبل وسائط هي خيارات \fIمنطقية\fP، سميت بهذا الاسم لأنه
يمكن التقاط حالتها بمتغير نعم أو لا ("منطقي"). على سبيل المثال، يخبر
\fB\-\-follow\-ftp\fP ويجيت بتتبع روابط FTP من ملفات HTML، ومن ناحية أخرى، يخبره
\&\fB\-\-no\-glob\fP بعدم إجراء مطابقة أنماط الملفات (globbing) على روابط
FTP. يكون الخيار المنطقي إما \fIإيجابيًا\fP أو \fIسلبيًا\fP (يبدأ بـ
\fB\-\-no\fP). تشترك كل هذه الخيارات في عدة خصائص.
.PP
ما لم يُذكر خلاف ذلك، يُفترض أن السلوك المبدئي هو عكس ما ينجزه الخيار. على
سبيل المثال، يفترض الوجود الموثق لـ \fB\-\-follow\-ftp\fP أن المبدئي هو \fIعدم\fP
تتبع روابط FTP من صفحات HTML.
.PP
يمكن نفي الخيارات الإيجابية بإضافة البادئة \fB\-\-no\-\fP إلى اسم الخيار؛ ويمكن
نفي الخيارات السلبية بحذف البادئة \&\fB\-\-no\-\fP. قد يبدو هذا زائدًا عن الحاجة \-
فإذا كان المبدئي لخيار إيجابي هو عدم القيام بشيء ما، فلماذا نوفر طريقة
لإيقافه صراحة؟ لكن ملف بدء التشغيل قد يغير المبدئي في الواقع. على سبيل
المثال، استخدام \f(CW\*(C`follow_ftp = on\*(C'\fP في \&\fI.wgetrc\fP يجعل ويجيت
\fIيتتبع\fP روابط FTP مبدئيًا، واستخدام \fB\-\-no\-follow\-ftp\fP هو الطريقة الوحيدة
لاستعادة المبدئي المصنعي من سطر الأوامر.
.SS "خيارات بدء التشغيل الأساسية"
.IX "قسم فرعي" "خيارات بدء التشغيل الأساسية"
.IP \fB\-V\fP 4
.IX عنصر \-V
.PD 0
.IP \fB\-\-version\fP 4
.IX عنصر \-\-version
.PD
اعرض إصدار ويجيت.
.IP \fB\-h\fP 4
.IX عنصر \-h
.PD 0
.IP \fB\-\-help\fP 4
.IX عنصر \-\-help
.PD
اطبع رسالة مساعدة تصف كل خيارات سطر الأوامر لويجيت.
.IP \fB\-b\fP 4
.IX عنصر \-b
.PD 0
.IP \fB\-\-background\fP 4
.IX عنصر \-\-background
.PD
انتقل إلى الخلفية فور بدء التشغيل. إذا لم يُحدد ملف مخرجات عبر \fB\-o\fP، تُوجه
المخرجات إلى \fIwget\-log\fP.
.IP "\fB\-e\fP \fIالأمر\fP" 4
.IX عنصر "\-e الأمر"
.PD 0
.IP "\fB\-\-execute\fP \fIالأمر\fP" 4
.IX عنصر "\-\-execute الأمر"
.PD
نفذ \fIالأمر\fP كما لو كان جزءًا من \fI.wgetrc\fP. الأمر المستدعى بهذه الطريقة
سيُنفذ \&\fIبعد\fP الأوامر في \fI.wgetrc\fP، وبالتالي يأخذ الأسبقية عليها. إذا كنت
بحاجة لتحديد أكثر من أمر wgetrc، استخدم عدة حالات من \fB\-e\fP.
.SS "خيارات التسجيل وملف المدخلات"
.IX "قسم فرعي" "خيارات التسجيل وملف المدخلات"
.IP "\fB\-o\fP \fIملف_السجل\fP" 4
.IX عنصر "\-o ملف_السجل"
.PD 0
.IP \fB\-\-output\-file=\fP\fIملف_السجل\fP 4
.IX عنصر \-\-output\-file=ملف_السجل
.PD
سجل كل الرسائل في \fIملف_السجل\fP. عادةً ما يُبلغ عن الرسائل إلى الخطأ القياسي.
.IP "\fB\-a\fP \fIملف_السجل\fP" 4
.IX عنصر "\-a ملف_السجل"
.PD 0
.IP \fB\-\-append\-output=\fP\fIملف_السجل\fP 4
.IX عنصر \-\-append\-output=ملف_السجل
.PD
ألحق بـ \fIملف_السجل\fP. هذا هو نفسه \fB\-o\fP، إلا أنه يلحق بـ \fIملف_السجل\fP بدلًا
من الكتابة فوق ملف السجل القديم. إذا لم يكن \&\fIملف_السجل\fP موجودًا، يُنشأ
ملف جديد.
.IP \fB\-d\fP 4
.IX عنصر \-d
.PD 0
.IP \fB\-\-debug\fP 4
.IX عنصر \-\-debug
.PD
فعل مخرجات التنقيح، مما يعني معلومات متنوعة مهمة لمطوري ويجيت إذا لم يعمل
بشكل صحيح. قد يكون مدير نظامك قد اختار تجميع ويجيت بدون دعم التنقيح، وفي هذه
الحالة لن يعمل \fB\-d\fP. يرجى ملاحظة أن التجميع مع دعم التنقيح آمن دائمًا \-\-\-
ويجيت المجمع مع دعم التنقيح \&لن يطبع أي معلومات تنقيح ما لم يُطلب ذلك
بواسطة \fB\-d\fP.
.IP \fB\-q\fP 4
.IX عنصر \-q
.PD 0
.IP \fB\-\-quiet\fP 4
.IX عنصر \-\-quiet
.PD
أوقف مخرجات ويجيت.
.IP \fB\-v\fP 4
.IX عنصر \-v
.PD 0
.IP \fB\-\-verbose\fP 4
.IX عنصر \-\-verbose
.PD
فعل المخرجات المسهبة، مع كل البيانات المتاحة. المخرجات المبدئية مسهبة.
.IP \fB\-nv\fP 4
.IX عنصر \-nv
.PD 0
.IP \fB\-\-no\-verbose\fP 4
.IX عنصر \-\-no\-verbose
.PD
أوقف الإسهاب دون أن يكون صامتًا تمامًا (استخدم \fB\-q\fP لذلك)، مما يعني أن
رسائل الخطأ والمعلومات الأساسية ستظل تُطبع.
.IP \fB\-\-report\-speed=\fP\fIالنوع\fP 4
.IX عنصر \-\-report\-speed=النوع
أخرج عرض النطاق الترددي كـ \fIنوع\fP. القيمة الوحيدة المقبولة هي \fBbits\fP.
.IP "\fB\-i\fP \fIملف\fP" 4
.IX عنصر "\-i ملف"
.PD 0
.IP \fB\-\-input\-file=\fP\fIملف\fP 4
.IX عنصر \-\-input\-file=ملف
.PD
اقرأ روابط المسار من \fIملف\fP محلي أو خارجي. إذا حُدد \fB\-\fP كـ \fIملف\fP، تُقرأ
الروابط من المدخلات القياسية. (استخدم \fB./\-\fP للقراءة من ملف اسمه الحرفي
\fB\-\fP.)
.Sp
إذا استُخدمت هذه الدالة، فلا داعي لوجود روابط مسار في سطر الأوامر. إذا كانت
هناك روابط في كل من سطر الأوامر وفي ملف مدخلات، فستكون الروابط الموجودة في
سطر الأوامر هي الأولى التي تُستجلب. إذا لم يُحدد \fB\-\-force\-html\fP، فيجب أن
يتكون \fIالملف\fP من سلسلة من الروابط، رابط واحد لكل سطر.
.Sp
ومع ذلك، إذا حددت \fB\-\-force\-html\fP، فسيُعتبر المستند \fBhtml\fP. في هذه الحالة
قد تواجه مشاكل مع الروابط النسبية، والتي يمكنك حلها إما بإضافة
\f(CW\*(C`\*(C'\fP إلى المستندات أو بتحديد
\&\fB\-\-base=\fP\fIرابط\fP في سطر الأوامر.
.Sp
إذا كان \fIالملف\fP خارجيًا، فسيُعامل المستند آليًا على أنه \fBhtml\fP إذا تطابق
Content\-Type مع \fBtext/html\fP. علاوة على ذلك، سيُستخدم موقع \fIالملف\fP ضمنيًا
كمرجع أساسي (base href) إذا لم يُحدد أي مرجع.
.Sp
إذا كان \fIالملف\fP محليًا، في الأنظمة التي تدعم ذلك، فسيُفتح بعلامة
\f(CW\*(C`O_NONBLOCK\*(C'\fP للسماح بالقراءة غير المحظورة من الملف. سيحاول
\fBويجيت\fP مواصلة القراءة من الملف حتى الوصول إلى نهاية الملف (EOF) أو
إغلاقه. يتيح ذلك دفق قائمة ملفات للاستجلاب حيث تُولد القائمة ديناميكيًا
أثناء تنفيذ العملية. حاليًا، هذه الميزة غير متوفرة على منصات ويندوز.
.IP \fB\-\-input\-metalink=\fP\fIملف\fP 4
.IX عنصر \-\-input\-metalink=ملف
نزل الملفات المشمولة في \fIملف\fP ميتالينك (Metalink) المحلي. إصدارات ميتالينك
3 و 4 مدعومة.
.IP \fB\-\-keep\-badhash\fP 4
.IX عنصر \-\-keep\-badhash
يحتفظ بملفات ميتالينك المنزلة ذات البصمة (hash) السيئة. يلحق .badhash باسم
ملفات ميتالينك التي بها عدم تطابق في مجموع التحقق، باستثناء عدم الكتابة فوق
الملفات الموجودة.
.IP \fB\-\-metalink\-over\-http\fP 4
.IX عنصر \-\-metalink\-over\-http
يصدر طلب HTTP HEAD بدلًا من GET ويستخرج البيانات الوصفية لميتالينك من
ترويسات الاستجابة. ثم ينتقل إلى تنزيل ميتالينك. إذا لم يُعثر على بيانات
وصفية صالحة لميتالينك، فإنه يعود إلى تنزيل HTTP العادي. يفعل تنزيل/معالجة
ملفات \fBContent\-Type: application/metalink4+xml\fP.
.IP \fB\-\-metalink\-index=\fP\fIرقم\fP 4
.IX عنصر \-\-metalink\-index=رقم
اضبط الرقم الترتيبي لـ metaurl الخاص بميتالينك
\fBapplication/metalink4+xml\fP. من 1 إلى إجمالي عدد
"application/metalink4+xml" المتاح. حدد 0 أو \fBinf\fP لاختيار أول واحد جيد. قد
تكون روابط metaurl، مثل تلك الموجودة في \fB\-\-metalink\-over\-http\fP، قد رُتبت
حسب قيمة مفتاح الأولوية؛ ضع ذلك في الاعتبار لاختيار الرقم الصحيح.
.IP \fB\-\-preferred\-location\fP 4
.IX عنصر \-\-preferred\-location
اضبط الموقع المفضل لموارد ميتالينك. يكون لهذا تأثير في حال توفر موارد متعددة
بنفس الأولوية.
.IP \fB\-\-xattr\fP 4
.IX عنصر \-\-xattr
فعل استخدام السمات الموسعة لنظام الملفات لحفظ رابط المسار الأصلي وقيمة
ترويسة HTTP Referer إذا استُخدمت.
.Sp
كن على علم بأن الرابط قد يحتوي على معلومات خاصة مثل رموز الوصول أو بيانات
الاستيثاق.
.IP \fB\-F\fP 4
.IX عنصر \-F
.PD 0
.IP \fB\-\-force\-html\fP 4
.IX عنصر \-\-force\-html
.PD
عند قراءة المدخلات من ملف، افرض معالجته كملف HTML. يتيح لك ذلك استجلاب
الروابط النسبية من ملفات HTML الموجودة على قرصك المحلي، عن طريق إضافة
\f(CW\*(C`\*(C'\fP إلى HTML، أو باستخدام خيار
سطر الأوامر \fB\-\-base\fP.
.IP "\fB\-B\fP \fIرابط\fP" 4
.IX عنصر "\-B رابط"
.PD 0
.IP \fB\-\-base=\fP\fIرابط\fP 4
.IX عنصر \-\-base=رابط
.PD
يحلل الروابط النسبية باستخدام \fIالرابط\fP كنقطة مرجعية، عند قراءة الروابط من
ملف HTML المحدد عبر خيار \&\fB\-i\fP/\fB\-\-input\-file\fP (بالتزامن مع
\&\fB\-\-force\-html\fP، أو عندما استُجلب ملف المدخلات عن بعد من خادم يصفه بأنه
HTML). يعادل هذا وجود وسم \f(CW\*(C`BASE\*(C'\fP في ملف مدخلات HTML، مع كون
\&\fIالرابط\fP هو قيمة السمة \f(CW\*(C`href\*(C'\fP.
.Sp
على سبيل المثال، إذا حددت \fBhttp://foo/bar/a.html\fP لـ \&\fIالرابط\fP، وقرأ
ويجيت \fB../baz/b.html\fP من ملف المدخلات، فسيتم تحليله إلى
\fBhttp://foo/baz/b.html\fP.
.IP \fB\-\-config=\fP\fIملف\fP 4
.IX عنصر \-\-config=ملف
حدد موقع ملف بدء تشغيل ترغب في استخدامه بدلًا من الملف (الملفات)
المبدئي. استخدم \-\-no\-config لتعطيل قراءة ملفات الإعداد. إذا أُعطي كل من
\-\-config و \-\-no\-config، فسيُتجاهل \-\-no\-config.
.IP \fB\-\-rejected\-log=\fP\fIملف_السجل\fP 4
.IX عنصر \-\-rejected\-log=ملف_السجل
يسجل جميع حالات رفض الروابط في \fIملف_السجل\fP كقيم مفصولة بفاصلة. تشمل القيم
سبب الرفض، والرابط، والرابط الأب الذي وُجد فيه.
.SS "خيارات التنزيل"
.IX "قسم فرعي" "خيارات التنزيل"
.IP \fB\-\-bind\-address=\fP\fIالعنوان\fP 4
.IX عنصر \-\-bind\-address=العنوان
عند إجراء اتصالات TCP/IP للعميل، اربط بـ \fIالعنوان\fP على الجهاز المحلي. قد
يُحدد \fIالعنوان\fP كاسم مضيف أو عنوان IP. قد يكون هذا الخيار مفيدًا إذا كان
جهازك مربوطًا بعناوين IP متعددة.
.IP \fB\-\-bind\-dns\-address=\fP\fIالعنوان\fP 4
.IX عنصر \-\-bind\-dns\-address=العنوان
[لـ libcares فقط] يتجاوز هذا العنوان المسار لطلبات DNS. إذا كنت بحاجة إلى
الالتفاف على الإعدادات القياسية من /etc/resolv.conf، فإن هذا الخيار مع
\fB\-\-dns\-servers\fP هو صديقك. يجب تحديد \&\fIالعنوان\fP إما كعنوان IPv4 أو
IPv6. يحتاج ويجيت إلى أن يكون مجمعًا مع libcares ليكون هذا الخيار متاحًا.
.IP \fB\-\-dns\-servers=\fP\fIالعناوين\fP 4
.IX عنصر \-\-dns\-servers=العناوين
[لـ libcares فقط] تتجاوز العناوين المعطاة عناوين خوادم الأسماء القياسية، على
سبيل المثال كما هي مهيأة في /etc/resolv.conf. قد تُحدد \&\fIالعناوين\fP إما
كعناوين IPv4 أو IPv6، مفصولة بفاصلة. يحتاج ويجيت إلى أن يكون مجمعًا مع
libcares ليكون هذا الخيار متاحًا.
.IP "\fB\-t\fP \fIالرقم\fP" 4
.IX عنصر "\-t الرقم"
.PD 0
.IP \fB\-\-tries=\fP\fIالرقم\fP 4
.IX عنصر \-\-tries=الرقم
.PD
اضبط عدد المحاولات على \fIالرقم\fP. حدد 0 أو \fBinf\fP لإعادة محاولة غير
محدودة. المبدئي هو إعادة المحاولة 20 مرة، باستثناء الأخطاء القاتلة مثل "رفض
الاتصال" أو "غير موجود" (404)، والتي لا تُعاد المحاولة فيها.
.IP "\fB\-O\fP \fIملف\fP" 4
.IX عنصر "\-O ملف"
.PD 0
.IP \fB\-\-output\-document=\fP\fIملف\fP 4
.IX عنصر \-\-output\-document=ملف
.PD
لن تُكتب المستندات في الملفات المناسبة، ولكن سيتم دمجها جميعًا معًا وكتابتها
في \fIملف\fP. إذا استُخدم \fB\-\fP كـ \fIملف\fP، فستُطبع المستندات إلى المخرجات
القياسية، مع تعطيل تحويل الروابط. (استخدم \fB./\-\fP للطباعة إلى ملف اسمه الحرفي
\fB\-\fP.)
.Sp
لا يُقصد من استخدام \fB\-O\fP مجرد "استخدام الاسم \&\fIملف\fP بدلًا من الاسم
الموجود في الرابط"؛ بل هو مشابه لإعادة توجيه الصدفة: يُقصد من \&\fBwget \-O file http://foo\fP أن يعمل مثل \&\fBwget \-O \- http://foo > file\fP؛ سيتم
اقتطاع \fIالملف\fP فورًا، وسيُكتب كل المحتوى المنزل هناك.
.Sp
لهذا السبب، فإن \fB\-N\fP (للتحقق من الطابع الزمني) غير مدعوم بالتزامن مع \fB\-O\fP:
بما أن \fIالملف\fP يُنشأ دائمًا من جديد، فإنه سيحتوي دائمًا على طابع زمني حديث
جدًا. سيصدر تحذير إذا استُخدم هذا المزيج.
.Sp
بالمثل، قد لا يعمل استخدام \fB\-r\fP أو \fB\-p\fP مع \fB\-O\fP كما تتوقع: لن يقوم ويجيت
بتنزيل الملف الأول فقط إلى \fIالملف\fP ثم تنزيل الباقي بأسمائهم العادية: بل
سيتم وضع \fIكل\fP المحتوى المنزل في \fIالملف\fP. تم تعطيل هذا في الإصدار 1.11،
ولكن أُعيد استخدامه (مع تحذير) في 1.11.2، حيث توجد بعض الحالات التي قد يكون
فيها لهذا السلوك فائدة بالفعل.
.Sp
لا يُقبل الدمج مع \fB\-nc\fP إلا إذا كان ملف المخرجات المعطى غير موجود.
.Sp
لاحظ أن الدمج مع \fB\-k\fP مسموح به فقط عند تنزيل مستند واحد، حيث إنه في هذه
الحالة سيحول ببساطة جميع الروابط النسبية إلى روابط خارجية؛ لا معنى لـ \fB\-k\fP
مع روابط متعددة عندما تُنزل جميعها إلى ملف واحد؛ لا يمكن استخدام \&\fB\-k\fP إلا
عندما تكون المخرجات ملفًا عاديًا.
.IP \fB\-nc\fP 4
.IX عنصر \-nc
.PD 0
.IP \fB\-\-no\-clobber\fP 4
.IX عنصر \-\-no\-clobber
.PD
إذا نُزل ملف أكثر من مرة في نفس الدليل، فإن سلوك ويجيت يعتمد على بعض
الخيارات، بما في ذلك \fB\-nc\fP. في حالات معينة، سيتم \fIسحق\fP الملف المحلي، أو
الكتابة فوقه، عند التنزيل المتكرر. وفي حالات أخرى سيتم الحفاظ عليه.
.Sp
عند تشغيل ويجيت بدون \fB\-N\fP أو \fB\-nc\fP أو \fB\-r\fP أو \&\fB\-p\fP، فإن تنزيل نفس
الملف في نفس الدليل سيؤدي إلى الحفاظ على النسخة الأصلية من \fIالملف\fP وتسمية
النسخة الثانية \fIالملف\fP\fB.1\fP. وإذا نُزل هذا الملف مرة أخرى، فستسمى النسخة
الثالثة \fIالملف\fP\fB.2\fP، وهكذا. (هذا هو السلوك أيضًا مع \fB\-nd\fP، حتى لو كان
\fB\-r\fP أو \&\fB\-p\fP قيد التنفيذ.) عند تحديد \fB\-nc\fP، يُكبت هذا السلوك، وسيرفض
ويجيت تنزيل نسخ أحدث من \&\fIالملف\fP. لذلك، فإن "\f(CW\*(C`no\-clobber\*(C'\fP" هو
في الواقع تسمية خاطئة في هذا الوضع \- فليس السحق هو ما يُمنع (حيث كانت
اللاحقات العددية تمنع السحق بالفعل)، بل إن حفظ النسخ المتعددة هو ما يُمنع.
.Sp
عند تشغيل ويجيت مع \fB\-r\fP أو \fB\-p\fP، ولكن بدون \fB\-N\fP أو \&\fB\-nd\fP أو \fB\-nc\fP،
فإن إعادة تنزيل ملف سيؤدي إلى قيام النسخة الجديدة ببساطة بالكتابة فوق
القديمة. ستمنع إضافة \fB\-nc\fP هذا السلوك، مما يؤدي بدلًا من ذلك إلى الحفاظ على
النسخة الأصلية وتجاهل أي نسخ أحدث على الخادم.
.Sp
عند تشغيل ويجيت مع \fB\-N\fP، مع أو بدون \fB\-r\fP أو \&\fB\-p\fP، فإن قرار تنزيل نسخة
أحدث من ملف من عدمه يعتمد على الطابع الزمني المحلي والبعيد وحجم الملف. لا
يجوز تحديد \fB\-nc\fP في نفس وقت تحديد \fB\-N\fP.
.Sp
لا يُقبل الدمج مع \fB\-O\fP/\fB\-\-output\-document\fP إلا إذا كان ملف المخرجات المعطى
غير موجود.
.Sp
لاحظ أنه عند تحديد \fB\-nc\fP، فإن الملفات التي تنتهي باللاحقات \&\fB.html\fP أو
\&\fB.htm\fP ستُحمل من القرص المحلي وتُحلل كما لو كانت قد استُجلبت من الويب.
.IP \fB\-\-backups=\fP\fIالنسخ_الاحتياطية\fP 4
.IX عنصر \-\-backups=النسخ_الاحتياطية
قبل الكتابة (فوق) ملف، انسخ ملفًا موجودًا احتياطيًا عن طريق إضافة لاحقة
\&\fB.1\fP (\fB_1\fP على VMS) إلى اسم الملف. يتم تدوير ملفات النسخ الاحتياطي هذه
إلى \fB.2\fP و \fB.3\fP، وهكذا، حتى \fIالنسخ_الاحتياطية\fP (وتُفقد بعد ذلك).
.IP \fB\-\-no\-netrc\fP 4
.IX عنصر \-\-no\-netrc
لا تحاول الحصول على بيانات الاستيثاق من ملف \fI.netrc\fP. مبدئيًا يُبحث في ملف
\&\fI.netrc\fP عن بيانات الاستيثاق في حال لم يُمرر أي منها في سطر الأوامر وكان
الاستيثاق مطلوبًا.
.IP \fB\-c\fP 4
.IX عنصر \-c
.PD 0
.IP \fB\-\-continue\fP 4
.IX عنصر \-\-continue
.PD
واصل استجلاب ملف منزل جزئيًا. هذا مفيد عندما تريد إنهاء تنزيل بدأ بواسطة
حالة سابقة لويجيت، أو بواسطة برنامج آخر. على سبيل المثال:
.Sp
.Vb 1
\& wget \-c ftp://sunsite.doc.ic.ac.uk/ls\-lR.Z
.Ve
.Sp
إذا كان هناك ملف باسم \fIls\-lR.Z\fP في الدليل الحالي، فسيفترض ويجيت أنه الجزء
الأول من الملف البعيد، وسيطلب من الخادم مواصلة الاستجلاب من إزاحة تساوي طول
الملف المحلي.
.Sp
لاحظ أنك لست بحاجة إلى تحديد هذا الخيار إذا كنت تريد فقط من استدعاء ويجيت
الحالي إعادة محاولة تنزيل ملف في حالة فقدان الاتصال في منتصف العملية. هذا هو
السلوك المبدئي. يؤثر \&\fB\-c\fP فقط على استئناف التنزيلات التي بدأت \fIقبل\fP هذا
الاستدعاء لويجيت، والتي لا تزال ملفاتها المحلية موجودة.
.Sp
بدون الخيار \fB\-c\fP، سيقوم المثال السابق بتنزيل الملف البعيد إلى \fIls\-lR.Z.1\fP
فقط، تاركًا ملف \fIls\-lR.Z\fP المبتور وشأنه.
.Sp
إذا استخدمت الخيار \fB\-c\fP على ملف غير فارغ، ولم يدعم الخادوم استكمال التنزيل،
فسيعيد Wget بدء التنزيل من الصفر ويستبدل الملف الموجود بالكامل.
.Sp
بدءًا من الإصدار 1.7 من Wget، إذا استخدمت الخيار \fB\-c\fP على ملف حجمه مساوٍ
لحجم الملف الموجود على الخادوم، سيرفض Wget تنزيل الملف ويطبع رسالة
توضيحية. ويحدث الشيء نفسه عندما يكون حجم الملف على الخادوم أصغر مما هو
محليًا (يُفترض أن ذلك بسبب تغييره على الخادوم منذ آخر محاولة تنزيل)\-\-\-ولأن
"الاستكمال" غير ذي جدوى، لن يحدث أي تنزيل.
.Sp
على الجانب الآخر، عند استخدام \fB\-c\fP، سيُعتبر أي ملف يكون حجمه على الخادوم
أكبر منه محليًا تنزيلًا غير مكتمل، وسيُنزّل \f(CW\*(C`(length(remote) \- length(local))\*(C'\fP بايت فقط وتُلحق بنهاية الملف المحلي. يمكن أن يكون هذا
السلوك مرغوبًا في حالات معينة\-\-\-على سبيل المثال، يمكنك استخدام \fBwget \-c\fP
لتنزيل الجزء الجديد فقط الذي أُلحق بمجموعة بيانات أو ملف سجلات.
.Sp
ومع ذلك، إذا كان الملف أكبر على الخادوم بسبب \&\fIتغييره\fP، وليس مجرد
\fIالإلحاق\fP إليه، فستنتهي بملف مشوه. ليس لدى Wget طريقة للتحقق من أن الملف
المحلي هو بالفعل بادئة صالحة للملف البعيد. يجب أن تكون حذرًا بشكل خاص من هذا
عند استخدام \fB\-c\fP بالتزامن مع \fB\-r\fP، حيث سيُعتبر كل ملف مرشحًا ليكون
"تنزيلًا غير مكتمل".
.Sp
حالة أخرى قد تحصل فيها على ملف مشوه إذا حاولت استخدام \&\fB\-c\fP هي إذا كان
لديك وكيل HTTP رديء يدرج سلسلة نصية مثل "انقطع النقل" في الملف
المحلي. مستقبلاً، قد يُضاف خيار "تراجع" للتعامل مع هذه الحالة.
.Sp
لاحظ أن \fB\-c\fP يعمل فقط مع خواديم FTP وخواديم HTTP التي تدعم ترويسة
\f(CW\*(C`Range\*(C'\fP.
.IP \fB\-\-start\-pos=\fP\fIOFFSET\fP 4
.IX عنصر \-\-start\-pos=OFFSET
يبدأ التنزيل من الموقع \fIOFFSET\fP (بدءًا من الصفر). يمكن التعبير عن الإزاحة
بالبايت، أو بالكيلوبايت باستخدام اللاحقة \`k\*(Aq، أو بالميجابايت باستخدام
اللاحقة \`m\*(Aq، إلخ.
.Sp
يتمتع \&\fB\-\-start\-pos\fP بأسبقية أعلى من \fB\-\-continue\fP. عندما يُحدد
\&\fB\-\-start\-pos\fP و \fB\-\-continue\fP معًا، سيُصدر wget تحذيرًا ثم يواصل العمل
كما لو كان \fB\-\-continue\fP غائبًا.
.Sp
يُشترط دعم الخادوم لاستكمال التنزيل، وإلا فلن يكون \fB\-\-start\-pos\fP
مفيدًا. راجع \fB\-c\fP للتفاصيل.
.IP \fB\-\-progress=\fP\fItype\fP 4
.IX عنصر \-\-progress=type
يحدد نوع مؤشر التقدم الذي ترغب في استخدامه. المؤشرات القانونية هي "dot"
(نقطة) و "bar" (شريط).
.Sp
يُستخدم المؤشر "bar" مبدئيًا. يرسم شريط تقدم بنظام ASCII (يُعرف أيضًا بعرض
"الميزان") يوضح حالة الاسترجاع. إذا لم يكن المخرج محطة طرفية (TTY)،
فسيُستخدم المؤشر "dot" مبدئيًا.
.Sp
استخدم \fB\-\-progress=dot\fP للتبديل إلى عرض النقاط. يتتبع الاسترجاع عبر طباعة
نقاط على الشاشة، تمثل كل نقطة مقدارًا ثابتًا من البيانات المُننزلة.
.Sp
يمكن لنوع (\fItype\fP) التقدم أيضًا أن يأخذ معاملًا واحدًا أو أكثر. تختلف
المعاملات بناءً على النوع المختار. تُمرر المعاملات إلى النوع بإلحاقها به
مفصولة بنقطتين رأسيتين (:) هكذا:
\&\fB\-\-progress=\fP\fItype\fP\fB:\fP\fIparameter1\fP\fB:\fP\fIparameter2\fP.
.Sp
عند استخدام الاسترجاع المنقط، يمكنك ضبط النمط (\fIstyle\fP) عبر تحديد النوع مثل
\fBdot:\fP\fIstyle\fP. تعطي الأنماط المختلفة معاني مختلفة للنقطة الواحدة. مع نمط
\f(CW\*(C`default\*(C'\fP المبدئي، تمثل كل نقطة 1K، وتوجد عشر نقاط في كل مجموعة
و 50 نقطة في السطر. أما نمط \f(CW\*(C`binary\*(C'\fP فله توجه أكثر ملاءمة لـ
"الحاسوب"\-\-\-نقاط بحجم 8K، ومجموعات من 16 نقطة و 48 نقطة في السطر (مما يجعل
السطر 384K). نمط \f(CW\*(C`mega\*(C'\fP مناسب لتنزيل الملفات الكبيرة\-\-\-تمثل كل
نقطة 64K مسترجع، وهناك ثماني نقاط في المجموعة، و 48 نقطة في كل سطر (بحيث
يحتوي كل سطر على 3M). وإذا كان نمط \f(CW\*(C`mega\*(C'\fP غير كافٍ، فيمكنك
استخدام نمط \f(CW\*(C`giga\*(C'\fP\-\-\-تمثل كل نقطة 1M مسترجع، وهناك ثماني نقاط في
المجموعة، و 32 نقطة في كل سطر (بحيث يحتوي كل سطر على 32M).
.Sp
مع \fB\-\-progress=bar\fP، يوجد حاليًا معاملان ممكنان، \&\fIforce\fP و \fInoscroll\fP.
.Sp
عندما لا يكون المخرج محطة طرفية، يعود شريط التقدم دائمًا إلى نمط "dot"، حتى
لو مُرر \fB\-\-progress=bar\fP إلى Wget أثناء الاستدعاء. يمكن تجاوز هذا السلوك
وفرض مخرج "bar" باستخدام المعامل "force" مثل \fB\-\-progress=bar:force\fP.
.Sp
مبدئيًا، يقوم شريط التقدم بنمط \fBbar\fP بتمرير اسم الملف من اليسار إلى اليمين
للملف الذي يجري تنزيله إذا تجاوز اسم الملف أقصى طول مخصص لعرضه. في حالات
معينة، مثل استخدام \&\fB\-\-progress=bar:force\fP، قد لا يرغب المرء في تمرير اسم
الملف في شريط التقدم. عبر تمرير المعامل "noscroll"، يمكن إجبار Wget على عرض
أكبر قدر ممكن من اسم الملف دون تمريره.
.Sp
لاحظ أنه يمكنك ضبط النمط المبدئي باستخدام أمر \f(CW\*(C`progress\*(C'\fP في ملف
\&\fI.wgetrc\fP. يمكن تجاوز هذا الإعداد من سطر الأوامر. على سبيل المثال، لفرض
مخرج الشريط بدون تمرير، استخدم \fB\-\-progress=bar:force:noscroll\fP.
.IP \fB\-\-show\-progress\fP 4
.IX عنصر \-\-show\-progress
يفرض على wget عرض شريط التقدم في أي مستوى من مستويات الإسهاب.
.Sp
مبدئيًا، يعرض wget شريط التقدم في الوضع المسهب فقط. ومع ذلك، قد يرغب المرء
في أن يعرض wget شريط التقدم على الشاشة بالتزامن مع أي أوضاع إسهاب أخرى مثل
\fB\-\-no\-verbose\fP أو \fB\-\-quiet\fP. هذه خاصية مرغوبة غالبًا عند استدعاء wget
لتنزيل عدة ملفات صغيرة أو كبيرة. في مثل هذه الحالة، يمكن ببساطة استدعاء wget
بهذا المعامل للحصول على مخرج أنظف بكثير على الشاشة.
.Sp
سيفرض هذا الخيار أيضًا طباعة شريط التقدم إلى \fIstderr\fP عند استخدامه جنباً
إلى جنب مع خيار \fB\-\-output\-file\fP.
.IP \fB\-N\fP 4
.IX عنصر \-N
.PD 0
.IP \fB\-\-timestamping\fP 4
.IX عنصر \-\-timestamping
.PD
يُفعّل الختم الزمني.
.IP \fB\-\-no\-if\-modified\-since\fP 4
.IX عنصر \-\-no\-if\-modified\-since
لا يرسل ترويسة If\-Modified\-Since في وضع \fB\-N\fP. يرسل طلب HEAD تمهيدي بدلاً من
ذلك. ليس لهذا تأثير إلا في وضع \fB\-N\fP.
.IP \fB\-\-no\-use\-server\-timestamps\fP 4
.IX عنصر \-\-no\-use\-server\-timestamps
لا يضبط الختم الزمني للملف المحلي بناءً على الختم الزمني الموجود على
الخادوم.
.Sp
مبدئيًا، عند تنزيل ملف، تُضبط أختامه الزمنية لتطابق تلك الموجودة في الملف
البعيد. يسمح هذا باستخدام \&\fB\-\-timestamping\fP في استدعاءات wget اللاحقة. ومع
ذلك، من المفيد أحيانًا جعل الختم الزمني للملف المحلي يعتمد على وقت تنزيله
الفعلي؛ ولهذا الغرض، وُفر خيار \&\fB\-\-no\-use\-server\-timestamps\fP.
.IP \fB\-S\fP 4
.IX عنصر \-S
.PD 0
.IP \fB\-\-server\-response\fP 4
.IX عنصر \-\-server\-response
.PD
يطبع الترويسات المرسلة من خواديم HTTP والاستجابات المرسلة من خواديم FTP.
.IP \fB\-\-spider\fP 4
.IX عنصر \-\-spider
عند الاستدعاء بهذا الخيار، سيسلك Wget سلوك \fIعنكبوت\fP ويب، مما يعني أنه لن
ينزل الصفحات، بل سيتحقق فقط من وجودها. على سبيل المثال، يمكنك استخدام Wget
للتحقق من علاماتك المرجعية:
.Sp
.Vb 1
\& wget \-\-spider \-\-force\-html \-i bookmarks.html
.Ve
.Sp
تحتاج هذه الميزة إلى عمل أكثر بكثير لكي يقترب Wget من وظائف عناكب الويب
الحقيقية.
.IP "\fB\-T seconds\fP" 4
.IX عنصر "\-T seconds"
.PD 0
.IP \fB\-\-timeout=\fP\fIseconds\fP 4
.IX عنصر \-\-timeout=seconds
.PD
يضبط مهلة الشبكة إلى \fIseconds\fP من الثواني. وهذا يعادل تحديد
\fB\-\-dns\-timeout\fP و \fB\-\-connect\-timeout\fP و \&\fB\-\-read\-timeout\fP، كلها في نفس
الوقت.
.Sp
عند التفاعل مع الشبكة، يمكن لـ Wget التحقق من المهلة وإيقاف العملية إذا
استغرقت وقتًا طويلاً. يمنع هذا الحالات الشاذة مثل القراءات المعلقة
والاتصالات اللانهائية. المهلة الوحيدة المفعّلة مبدئيًا هي مهلة قراءة قدرها
900 ثانية. ضبط المهلة على 0 يعطلها تمامًا. ما لم تكن تعرف ما تفعله، فمن
الأفضل عدم تغيير إعدادات المهلة المبدئية.
.Sp
تقبل جميع الخيارات المتعلقة بالمهلة قيمًا عشرية، بالإضافة إلى قيم أجزاء
الثانية. على سبيل المثال، \fB0.1\fP ثانية هو خيار قانوني (وإن كان غير حكيم)
للمهلة. مهلات أجزاء الثانية مفيدة للتحقق من أوقات استجابة الخادوم أو لاختبار
زمن وصول الشبكة.
.IP \fB\-\-dns\-timeout=\fP\fIseconds\fP 4
.IX عنصر \-\-dns\-timeout=seconds
يضبط مهلة البحث في نظام أسماء النطاقات (DNS) إلى \fIseconds\fP من
الثواني. ستفشل عمليات البحث التي لا تكتمل خلال الوقت المحدد. مبدئيًا، لا
توجد مهلة لعمليات البحث في DNS، بخلاف تلك التي تنفذها مكتبات النظام.
.IP \fB\-\-connect\-timeout=\fP\fIseconds\fP 4
.IX عنصر \-\-connect\-timeout=seconds
يضبط مهلة الاتصال إلى \fIseconds\fP من الثواني. سيتم إجهاض اتصالات TCP التي
تستغرق وقتًا أطول لإنشائها. مبدئيًا، لا توجد مهلة اتصال، بخلاف تلك التي
تنفذها مكتبات النظام.
.IP \fB\-\-read\-timeout=\fP\fIseconds\fP 4
.IX عنصر \-\-read\-timeout=seconds
يضبط مهلة القراءة (والكتابة) إلى \fIseconds\fP من الثواني. يشير "الوقت" في هذه
المهلة إلى \fIوقت الخمول\fP: إذا لم يتم استلام أي بيانات لأكثر من عدد الثواني
المحدد في أي لحظة أثناء التنزيل، تفشل القراءة ويُعاد بدء التنزيل. لا يؤثر
هذا الخيار مباشرة على مدة التنزيل بالكامل.
.Sp
بالطبع، قد يختار الخادوم البعيد إنهاء الاتصال في وقت أبكر مما يتطلبه هذا
الخيار. مهلة القراءة المبدئية هي 900 ثانية.
.IP \fB\-\-limit\-rate=\fP\fIamount\fP 4
.IX عنصر \-\-limit\-rate=amount
يحد من سرعة التنزيل إلى \fIamount\fP بايت في الثانية. يمكن التعبير عن المقدار
بالبايت، أو بالكيلوبايت مع اللاحقة \fBk\fP، أو بالميجابايت مع اللاحقة \fBm\fP. على
سبيل المثال، \fB\-\-limit\-rate=20k\fP سيحد من معدل الاسترجاع إلى 20KB/s. هذا مفيد
عندما لا تريد لـ Wget استهلاك كامل النطاق الترددي المتاح لأي سبب كان.
.Sp
يسمح هذا الخيار باستخدام الأرقام العشرية، عادةً بالتزامن مع لواحق القوى؛ على
سبيل المثال، \fB\-\-limit\-rate=2.5k\fP قيمة قانونية.
.Sp
لاحظ أن Wget ينفذ التحديد عبر النوم لفترة زمنية مناسبة بعد قراءة شبكية
استغرقت وقتاً أقل مما هو محدد بالمعدل. تؤدي هذه الاستراتيجية في النهاية إلى
إبطاء نقل TCP إلى المعدل المحدد تقريبًا. ومع ذلك، قد يستغرق الوصول إلى هذا
التوازن بعض الوقت، لذا لا تتفاجأ إذا لم يعمل تحديد المعدل جيدًا مع الملفات
الصغيرة جدًا.
.IP "\fB\-w\fP \fIseconds\fP" 4
.IX عنصر "\-w seconds"
.PD 0
.IP \fB\-\-wait=\fP\fIseconds\fP 4
.IX عنصر \-\-wait=seconds
.PD
ينتظر عدد الثواني المحدد بين عمليات الاسترجاع. يُوصى باستخدام هذا الخيار،
لأنه يخفف الحمل على الخادوم بجعل الطلبات أقل تكرارًا. بدلاً من الثواني، يمكن
تحديد الوقت بالدقائق باستخدام اللاحقة \f(CW\*(C`m\*(C'\fP، أو بالساعات باستخدام
اللاحقة \f(CW\*(C`h\*(C'\fP، أو بالأيام باستخدام اللاحقة \f(CW\*(C`d\*(C'\fP.
.Sp
تحديد قيمة كبيرة لهذا الخيار مفيد إذا كانت الشبكة أو المضيف الوجهة متوقفين،
بحيث يمكن لـ Wget الانتظار لفترة كافية لتوقع إصلاح خطأ الشبكة بشكل معقول قبل
إعادة المحاولة. يتأثر فاصل الانتظار المحدد بهذه الوظيفة بخيار
\&\f(CW\*(C`\-\-random\-wait\*(C'\fP، انظر إليه.
.IP \fB\-\-waitretry=\fP\fIseconds\fP 4
.IX عنصر \-\-waitretry=seconds
إذا كنت لا تريد أن ينتظر Wget بين \fIكل\fP استرجاع، بل فقط بين إعادات محاولة
التنزيلات الفاشلة، فيمكنك استخدام هذا الخيار. سيستخدم Wget \fIتراجعًا خطيًا\fP،
حيث ينتظر ثانية واحدة بعد الفشل الأول لملف معين، ثم ينتظر ثانيتين بعد الفشل
الثاني لذلك الملف، وصولاً إلى الحد الأقصى لعدد الثواني (\fIseconds\fP) الذي
تحدده.
.Sp
يفترض Wget قيمة مبدئية قدرها 10 ثوانٍ.
.IP \fB\-\-random\-wait\fP 4
.IX عنصر \-\-random\-wait
قد تقوم بعض المواقع بتحليل السجلات لتحديد برامج الاسترجاع مثل Wget عبر البحث
عن تشابهات ذات دلالة إحصائية في الوقت الفاصل بين الطلبات. يؤدي هذا الخيار
إلى تغيير الوقت بين الطلبات ليتراوح بين 0.5 و 1.5 * \fIwait\fP من الثواني، حيث
حُدد \fIwait\fP باستخدام خيار \fB\-\-wait\fP، وذلك لإخفاء وجود Wget عن مثل هذا
التحليل.
.Sp
قدم مقال نُشر عام 2001 في منشور مخصص للتطوير على منصة استهلاكية شهيرة شفرة
برمجية لإجراء هذا التحليل على الطاير. اقترح كاتب المقال الحظر على مستوى
عناوين الفئة C لضمان حظر برامج الاسترجاع الآلية رغم تغيير العناوين التي
يوفرها بروتوكول DHCP.
.Sp
استُلهم خيار \fB\-\-random\-wait\fP من هذه التوصية غير الحكيمة بحظر كثير من
المستخدمين غير المرتبطين ببعضهم عن موقع ويب بسبب تصرفات مستخدم واحد.
.IP \fB\-\-no\-proxy\fP 4
.IX عنصر \-\-no\-proxy
لا تستخدم الوكلاء، حتى لو كان متغير البيئة المناسب \f(CW*_proxy\fP معرفًا.
.IP "\fB\-Q\fP \fIquota\fP" 4
.IX عنصر "\-Q quota"
.PD 0
.IP \fB\-\-quota=\fP\fIquota\fP 4
.IX عنصر \-\-quota=quota
.PD
يحدد حصة التنزيل للاسترجاعات الآلية. يمكن تحديد القيمة بالبايت (مبدئيًا)، أو
بالكيلوبايت (مع اللاحقة \fBk\fP)، أو بالميجابايت (مع اللاحقة \fBm\fP).
.Sp
لاحظ أن الحصة لن تؤثر أبدًا على تنزيل ملف واحد. لذا إذا حددت \fBwget \-Q10k https://example.com/ls\-lR.gz\fP، فسيتم تنزيل كامل ملف \&\fIls\-lR.gz\fP. وينطبق
الشيء نفسه حتى عند تحديد عدة عناوين URL على سطر الأوامر. يتم التحقق من الحصة
فقط في نهاية كل ملف مُنزّل، لذا فلن تؤدي أبدًا إلى ملف مُنزّل
جزئيًا. وبالتالي يمكنك كتابة \fBwget \-Q2m \-i sites\fP بأمان\-\-\-سيتم إجهاض
التنزيل بعد اكتمال تنزيل الملف الذي يستنفد الحصة.
.Sp
ضبط الحصة على 0 أو \fBinf\fP يجعل حصة التنزيل غير محدودة.
.IP \fB\-\-no\-dns\-cache\fP 4
.IX عنصر \-\-no\-dns\-cache
يعطل تخزين عمليات البحث في DNS بالخبيئة. عادةً، يتذكر Wget عناوين IP التي
بحث عنها في DNS حتى لا يضطر لمراسلة خادوم DNS بشكل متكرر لنفس المجموعة
(الصغيرة عادةً) من المضيفين الذين يسترجع منهم. هذه الخبيئة توجد في الذاكرة
فقط؛ وسوف تراسل أي دورة تشغيل جديدة لـ Wget نظام DNS مرة أخرى.
.Sp
ومع ذلك، أُفيد بأنه في بعض الحالات لا يكون من المرغوب فيه تخزين أسماء
المضيفين في الخبيئة، حتى طوال مدة تشغيل تطبيق قصير الأمد مثل Wget. بهذا
الخيار، يصدر Wget بحث DNS جديدًا (بصورة أدق، استدعاءً جديدًا لـ
\f(CW\*(C`gethostbyname\*(C'\fP أو \&\f(CW\*(C`getaddrinfo\*(C'\fP) في كل مرة ينشئ
فيها اتصالاً جديدًا. يرجى ملاحظة أن هذا الخيار \fIلن\fP يؤثر على التخزين في
الخبيئة الذي قد تقوم به مكتبة الحل أو طبقة تخزين خارجية مثل NSCD.
.Sp
إذا كنت لا تفهم بالضبط ما يفعله هذا الخيار، فمن المحتمل أنك لن تحتاجه.
.IP \fB\-\-restrict\-file\-names=\fP\fImodes\fP 4
.IX عنصر \-\-restrict\-file\-names=modes
يغير الشخصيات الموجودة في عناوين URL البعيدة التي يجب الهروب منها أثناء
توليد أسماء الملفات المحلية. الشخصيات التي يتم \fIتقييدها\fP عبر هذا الخيار يتم
الهروب منها، أي استبدالها بـ \f(CB%HH\fR، حيث \&\fBHH\fP هو الرقم الست عشري
الذي يقابل الشخصية المقيدة. يمكن استخدام هذا الخيار أيضًا لفرض أن تكون جميع
حالات الأحرف إما صغيرة أو كبيرة.
.Sp
مبدئيًا، يقوم Wget بالهروب من الشخصيات غير الصالحة أو غير الآمنة كجزء من
أسماء الملفات في نظام التشغيل الخاص بك، بالإضافة إلى شخصيات التحكم التي تكون
عادةً غير قابلة للطباعة. هذا الخيار مفيد لتغيير هذه الإعدادات المبدئية، ربما
لأنك تقوم بالتنزيل إلى قسم غير أصلي، أو لأنك تريد تعطيل الهروب من شخصيات
التحكم، أو تريد تقييد الشخصيات بشكل أكبر لتشمل فقط تلك الموجودة في نطاق قيم
ASCII.
.Sp
الأوضاع (\fImodes\fP) هي مجموعة من القيم النصية المفصولة بفاصلة. القيم المقبولة
هي \fBunix\fP و \fBwindows\fP و \fBnocontrol\fP و \&\fBascii\fP و \fBlowercase\fP و
\fBuppercase\fP. القيمتان \&\fBunix\fP و \fBwindows\fP مانعتان لبعضهما البعض (ستحل
إحداهما محل الأخرى)، وكذلك \fBlowercase\fP و \&\fBuppercase\fP. هاتان الأخيرتان
هما حالتان خاصتان، حيث لا تغيران مجموعة الشخصيات التي سيتم الهروب منها، بل
تفرضان تحويل مسارات الملفات المحلية إما إلى حالة الأحرف الصغيرة أو الكبيرة.
.Sp
عند تحديد "unix"، يهرب Wget من الشخصية \fB/\fP وشخصيات التحكم في النطاقات 0\-\-31
و 128\-\-159. هذا هو المبدئي في أنظمة التشغيل الشبيهة بيونكس.
.Sp
عند إعطاء "windows"، يهرب Wget من الشخصيات \fB\e\fP و \&\fB|\fP و \fB/\fP و \fB:\fP و
\fB?\fP و \fB"\fP و \fB*\fP و \fB<\fP و \&\fB>\fP، وشخصيات التحكم في النطاقات 0\-\-31
و 128\-\-159. بالإضافة إلى هذا، يستخدم Wget في وضع ويندوز \fB+\fP بدلاً من \&\fB:\fP
لفصل المضيف والمنفذ في أسماء الملفات المحلية، ويستخدم \&\fB@\fP بدلاً من \fB?\fP
لفصل جزء الاستعلام عن باقي اسم الملف. لذلك، عنوان URL الذي سيُحفظ باسم
\&\fBwww.xemacs.org:4300/search.pl?input=blah\fP في وضع يونكس سيُحفظ باسم
\fBwww.xemacs.org+4300/search.pl@input=blah\fP في وضع ويندوز. هذا الوضع هو
المبدئي في ويندوز.
.Sp
إذا حددت \fBnocontrol\fP، فسيتم إيقاف الهروب من شخصيات التحكم أيضًا. قد يكون
لهذا الخيار معنى عندما تقوم بتنزيل عناوين URL تحتوي أسماؤها على شخصيات
UTF\-8، على نظام يمكنه حفظ وعرض أسماء الملفات بترميز UTF\-8 (بعض قيم البايت
الممكنة المستخدمة في تسلسلات بايت UTF\-8 تقع في نطاق القيم التي صنفها Wget كـ
"تحكم").
.Sp
يُستخدم وضع \fBascii\fP لتحديد أن أي بايتات تقع قيمها خارج نطاق شخصيات ASCII
(أي أكبر من 127) يجب الهروب منها. يمكن أن يكون هذا مفيدًا عند حفظ أسماء
الملفات التي لا يطابق ترميزها الترميز المستخدم محليًا.
.IP \fB\-4\fP 4
.IX عنصر \-4
.PD 0
.IP \fB\-\-inet4\-only\fP 4
.IX عنصر \-\-inet4\-only
.IP \fB\-6\fP 4
.IX عنصر \-6
.IP \fB\-\-inet6\-only\fP 4
.IX عنصر \-\-inet6\-only
.PD
يفرض الاتصال بعناوين IPv4 أو IPv6. مع \fB\-\-inet4\-only\fP أو \fB\-4\fP، سيتصل Wget
فقط بمضيفي IPv4، متجاهلاً سجلات AAAA في DNS، ورافضًا الاتصال بعناوين IPv6
المحددة في عناوين URL. وبالعكس، مع \fB\-\-inet6\-only\fP أو \fB\-6\fP، سيتصل Wget فقط
بمضيفي IPv6 ويتجاهل سجلات A وعناوين IPv4.
.Sp
لا ينبغي أن يكون أي من الخيارين مطلوباً في العادة. مبدئيًا، سيستخدم Wget
المدرك لـ IPv6 عائلة العناوين المحددة في سجل DNS للمضيف. إذا استجاب DNS بكل
من عناوين IPv4 و IPv6، فسيجربها Wget في تسلسل حتى يجد واحدًا يمكنه الاتصال
به. (انظر أيضًا خيار \&\f(CW\*(C`\-\-prefer\-family\*(C'\fP الموضح أدناه.)
.Sp
يمكن استخدام هذه الخيارات لفرض استخدام عائلات عناوين IPv4 أو IPv6 عمدًا على
الأنظمة ذات العائلة المزدوجة، عادةً للمساعدة في التنقيح أو للتعامل مع تكوين
شبكة معطل. يمكن تحديد واحد فقط من \&\fB\-\-inet6\-only\fP و \fB\-\-inet4\-only\fP في نفس
الوقت. لا يتوفر أي من الخيارين في Wget المترجم بدون دعم IPv6.
.IP \fB\-\-prefer\-family=none/IPv4/IPv6\fP 4
.IX عنصر \-\-prefer\-family=none/IPv4/IPv6
عند إعطائه خيارًا من عدة عناوين، يتصل بالعناوين ذات عائلة العناوين المحددة
أولاً. يُستخدم ترتيب العناوين الذي يرجعه DNS بدون تغيير مبدئيًا.
.Sp
هذا يتجنب الأخطاء الزائفة ومحاولات الاتصال عند الوصول إلى المضيفين الذين يتم
حلهم إلى كل من عناوين IPv6 و IPv4 من شبكات IPv4. على سبيل المثال، يتم حل
\fBwww.kame.net\fP إلى \&\fB2001:200:0:8002:203:47ff:fea5:3085\fP وإلى
\&\fB203.178.141.194\fP. عندما تكون العائلة المفضلة هي \f(CW\*(C`IPv4\*(C'\fP،
يُستخدم عنوان IPv4 أولاً؛ وعندما تكون العائلة المفضلة هي \f(CW\*(C`IPv6\*(C'\fP،
يُستخدم عنوان IPv6 أولاً؛ وإذا كانت القيمة المحددة هي \f(CW\*(C`none\*(C'\fP،
يُستخدم ترتيب العناوين الذي يرجعه DNS دون تغيير.
.Sp
بخلاف \fB\-4\fP و \fB\-6\fP، لا يمنع هذا الخيار الوصول إلى أي عائلة عناوين، بل يغير
فقط \fIالترتيب\fP الذي يتم به الوصول إلى العناوين. لاحظ أيضًا أن إعادة الترتيب
التي يقوم بها هذا الخيار هي \fIمستقرة\fP\-\-\-فهي لا تؤثر على ترتيب عناوين نفس
العائلة. أي أن الترتيب النسبي لجميع عناوين IPv4 وجميع عناوين IPv6 يظل كما هو
في جميع الحالات.
.IP \fB\-\-retry\-connrefused\fP 4
.IX عنصر \-\-retry\-connrefused
يعتبر "الاتصال مرفوض" خطأً عابرًا ويحاول مرة أخرى. عادةً يستسلم Wget لعنوان
URL عندما لا يتمكن من الاتصال بالموقع لأن فشل الاتصال يُعتبر علامة على أن
الخادوم لا يعمل على الإطلاق وأن إعادات المحاولة لن تفيد. هذا الخيار مخصص
لمرآة المواقع غير الموثوقة التي تميل خواديمها للاختفاء لفترات قصيرة من
الزمن.
.IP \fB\-\-user=\fP\fIuser\fP 4
.IX عنصر \-\-user=user
.PD 0
.IP \fB\-\-password=\fP\fIpassword\fP 4
.IX عنصر \-\-password=password
.PD
يحدد اسم المستخدم \fIuser\fP وكلمة السر \fIpassword\fP لكل من استرجاع ملفات FTP و
HTTP. يمكن تجاوز هذه المعاملات باستخدام خياري \fB\-\-ftp\-user\fP و
\fB\-\-ftp\-password\fP لاتصالات FTP وخياري \fB\-\-http\-user\fP و \fB\-\-http\-password\fP
لاتصالات HTTP.
.IP \fB\-\-ask\-password\fP 4
.IX عنصر \-\-ask\-password
يطلب كلمة سر لكل اتصال يتم إنشاؤه. لا يمكن تحديده عند استخدام \fB\-\-password\fP،
لأنهما مانعان لبعضهما البعض.
.IP \fB\-\-use\-askpass=\fP\fIcommand\fP 4
.IX عنصر \-\-use\-askpass=command
يطلب اسم المستخدم وكلمة السر باستخدام الأمر المحدد. إذا لم يُحدد أي أمر،
فسيُستخدم الأمر الموجود في متغير البيئة WGET_ASKPASS. وإذا لم يكن
WGET_ASKPASS مضبوطًا، فسيُستخدم الأمر الموجود في متغير البيئة SSH_ASKPASS.
.Sp
يمكنك ضبط الأمر المبدئي لـ use\-askpass في ملف \fI.wgetrc\fP. ويمكن تجاوز هذا
الإعداد من سطر الأوامر.
.IP \fB\-\-no\-iri\fP 4
.IX عنصر \-\-no\-iri
يعطل دعم معرّفات الموارد الدولية (IRI). استخدم \fB\-\-iri\fP لتفعيله. دعم IRI
مفعل مبدئيًا.
.Sp
يمكنك ضبط الحالة المبدئية لدعم IRI باستخدام أمر \f(CW\*(C`iri\*(C'\fP في ملف
\&\fI.wgetrc\fP. ويمكن تجاوز هذا الإعداد من سطر الأوامر.
.IP \fB\-\-local\-encoding=\fP\fIencoding\fP 4
.IX عنصر \-\-local\-encoding=encoding
يفرض على Wget استخدام \fIencoding\fP كترميز للنظام المبدئي. يؤثر هذا على كيفية
تحويل Wget لعناوين URL المحددة كوسائط من المحلية إلى UTF\-8 لدعم IRI.
.Sp
يستخدم Wget وظيفة \f(CWnl_langinfo()\fP ثم متغير البيئة \f(CW\*(C`CHARSET\*(C'\fP
للحصول على المحلية. وإذا فشل، يُستخدم ترميز ASCII.
.Sp
يمكنك ضبط الترميز المحلي المبدئي باستخدام أمر \f(CW\*(C`local_encoding\*(C'\fP
في ملف \fI.wgetrc\fP. ويمكن تجاوز هذا الإعداد من سطر الأوامر.
.IP \fB\-\-remote\-encoding=\fP\fIencoding\fP 4
.IX عنصر \-\-remote\-encoding=encoding
يفرض على Wget استخدام \fIencoding\fP كترميز الخادوم البعيد المبدئي. يؤثر هذا
على كيفية تحويل Wget لمعرفات الموارد (URIs) الموجودة في الملفات من الترميز
البعيد إلى UTF\-8 أثناء جلب متكرر. هذا الخيار مفيد فقط لدعم IRI، لتفسير
الشخصيات غير المنتمية لـ ASCII.
.Sp
بالنسبة لـ HTTP، يمكن العثور على الترميز البعيد في ترويسة
\f(CW\*(C`Content\-Type\*(C'\fP الخاصة بـ HTTP وفي وسم ميتا HTML
\f(CW\*(C`Content\-Type http\-equiv\*(C'\fP.
.Sp
يمكنك ضبط الترميز المبدئي باستخدام أمر \f(CW\*(C`remoteencoding\*(C'\fP في ملف
\&\fI.wgetrc\fP. ويمكن تجاوز هذا الإعداد من سطر الأوامر.
.IP \fB\-\-unlink\fP 4
.IX عنصر \-\-unlink
يفرض على Wget فصل (unlink) الملف بدلاً من سحق الملف الموجود. هذا الخيار مفيد
للتنزيل إلى دليل يحتوي على روابط صلبة.
.SS "خيارات الدليل"
.IX "قسم فرعي" "خيارات الدليل"
.IP \fB\-nd\fP 4
.IX عنصر \-nd
.PD 0
.IP \fB\-\-no\-directories\fP 4
.IX عنصر \-\-no\-directories
.PD
لا تُنشئ تسلسلًا هرميًا للأدلة عند الجلب الاستدعائي. بتفعيل هذا الخيار، سوف
تُحفظ جميع الملفات في الدليل الحالي، دون الكتابة فوق الملفات الموجودة (إذا
ظهر اسم أكثر من مرة، فستحصل أسماء الملفات على الامتدادات \fB.n\fP).
.IP \fB\-x\fP 4
.IX عنصر \-x
.PD 0
.IP \fB\-\-force\-directories\fP 4
.IX عنصر \-\-force\-directories
.PD
عكس خيار \fB\-nd\fP\-\-\-يُنشئ تسلسلًا هرميًا للأدلة، حتى لو لم يكن ليُنشأ لولا
ذلك. على سبيل المثال، سيؤدي الأمر \fBwget \-x http://fly.srk.fer.hr/robots.txt\fP إلى حفظ الملف المُنزل في
\&\fIfly.srk.fer.hr/robots.txt\fP.
.IP \fB\-nH\fP 4
.IX عنصر \-nH
.PD 0
.IP \fB\-\-no\-host\-directories\fP 4
.IX عنصر \-\-no\-host\-directories
.PD
عطّل توليد الأدلة المسبوقة باسم المضيف. مبدئيًا، سيؤدي استدعاء Wget باستخدام
\fB\-r http://fly.srk.fer.hr/\fP إلى إنشاء بنية أدلة تبدأ بـ
\fIfly.srk.fer.hr/\fP. هذا الخيار يعطل هذا السلوك.
.IP \fB\-\-protocol\-directories\fP 4
.IX عنصر \-\-protocol\-directories
استخدم اسم البروتوكول كمكون دليل لأسماء الملفات المحلية. على سبيل المثال،
باستخدام هذا الخيار، سيحفظ \fBwget \-r http://\fP\fIhost\fP الملفات في
\&\fBhttp/\fP\fIhost\fP\fB/...\fP بدلًا من مجرد \fIhost\fP\fB/...\fP.
.IP \fB\-\-cut\-dirs=\fP\fInumber\fP 4
.IX عنصر \-\-cut\-dirs=number
تجاهل \fInumber\fP من مكونات الدليل. هذا مفيد للحصول على تحكم دقيق في الدليل
حيث سيُحفظ الجلب الاستدعائي.
.Sp
على سبيل المثال، الدليل في \&\fBftp://ftp.xemacs.org/pub/xemacs/\fP. إذا جلبته
باستخدام \&\fB\-r\fP، فسيُحفظ محليًا تحت \&\fIftp.xemacs.org/pub/xemacs/\fP. بينما
يمكن لخيار \fB\-nH\fP إزالة جزء \fIftp.xemacs.org/\fP، ستظل عالقًا مع
\&\fIpub/xemacs\fP. هنا يأتي دور \fB\-\-cut\-dirs\fP؛ فهو يجعل Wget لا "يرى"
\fInumber\fP من مكونات الدليل البعيد. إليك عدة أمثلة على كيفية عمل خيار
\fB\-\-cut\-dirs\fP.
.Sp
.Vb 4
\& بلا خيارات \-> ftp.xemacs.org/pub/xemacs/
\& \-nH \-> pub/xemacs/
\& \-nH \-\-cut\-dirs=1 \-> xemacs/
\& \-nH \-\-cut\-dirs=2 \-> .
\&
\& \-\-cut\-dirs=1 \-> ftp.xemacs.org/xemacs/
\& ...
.Ve
.Sp
إذا كنت تريد فقط التخلص من بنية الأدلة، فإن هذا الخيار يشبه مزيجًا من \fB\-nd\fP
و \fB\-P\fP. ومع ذلك، على عكس \&\fB\-nd\fP، لا يفقد \fB\-\-cut\-dirs\fP الأدلة
الفرعية\-\-\-على سبيل المثال، مع \fB\-nH \-\-cut\-dirs=1\fP، سيُوضع دليل \fIbeta/\fP
الفرعي في \fIxemacs/beta\fP، كما هو متوقع.
.IP "\fB\-P\fP \fIبادئة\fP" 4
.IX عنصر "\-P prefix"
.PD 0
.IP \fB\-\-directory\-prefix=\fP\fIprefix\fP 4
.IX عنصر \-\-directory\-prefix=prefix
.PD
اضبط بادئة الدليل إلى \fIprefix\fP. \fIبادئة الدليل\fP هي الدليل حيث ستُحفظ جميع
الملفات والأدلة الفرعية الأخرى، أي قمة شجرة الجلب. القيمة المبدئية هي \fB.\fP
(الدليل الحالي).
.SS "خيارات HTTP"
.IX "قسم فرعي" "خيارات HTTP"
.IP \fB\-\-default\-page=\fP\fIname\fP 4
.IX عنصر \-\-default\-page=name
استخدم \fIname\fP كاسم ملف مبدئي عندما لا يكون معروفًا (أي لروابط URL التي
تنتهي بشرطة مائلة)، بدلًا من \fIindex.html\fP.
.IP \fB\-E\fP 4
.IX عنصر \-E
.PD 0
.IP \fB\-\-adjust\-extension\fP 4
.IX عنصر \-\-adjust\-extension
.PD
إذا نُزّل ملف من نوع \fBapplication/xhtml+xml\fP أو \fBtext/html\fP وكان رابط URL
لا ينتهي بالتعبير النمطي \&\fB\e.[Hh][Tt][Mm][Ll]?\fP، فسيؤدي هذا الخيار إلى
إلحاق اللاحقة \fB.html\fP باسم الملف المحلي. هذا مفيد، على سبيل المثال، عندما
تعكس موقعًا بعيدًا يستخدم صفحات \fB.asp\fP، لكنك تريد أن تكون الصفحات المعكوسة
قابلة للعرض على خادم Apache العادي. استخدام جيد آخر لهذا هو عند تنزيل المواد
المولدة بواسطة CGI. رابط URL مثل \fBhttp://site.com/article.cgi?25\fP سيُحفظ
باسم \&\fIarticle.cgi?25.html\fP.
.Sp
لاحظ أن أسماء الملفات التي تُغيّر بهذه الطريقة سيُعاد تنزيلها في كل مرة تعيد
فيها عكس الموقع، لأن Wget لا يمكنه معرفة أن الملف المحلي \&\fIX.html\fP يقابل
رابط URL البعيد \fIX\fP (بما أنه لا يعرف بعد أن رابط URL ينتج مخرجات من نوع
\&\fBtext/html\fP أو \fBapplication/xhtml+xml\fP).
.Sp
بدءًا من الإصدار 1.12، سيضمن Wget أيضًا أن أي ملفات مُنزلة من نوع
\fBtext/css\fP تنتهي باللاحقة \fB.css\fP، وغُيّر اسم الخيار من \fB\-\-html\-extension\fP
ليعكس سلوكه الجديد بشكل أفضل. لا يزال اسم الخيار القديم مقبولًا، ولكن يجب
اعتباره مهجورًا الآن.
.Sp
بدءًا من الإصدار 1.19.2، سيضمن Wget أيضًا أن أي ملفات مُنزلة ذات
\f(CW\*(C`Content\-Encoding\*(C'\fP من نوع \fBbr\fP أو \fBcompress\fP أو \fBdeflate\fP أو
\fBgzip\fP تنتهي باللاحقة \fB.br\fP و \fB.Z\fP و \fB.zlib\fP و \fB.gz\fP على التوالي.
.Sp
في وقت ما في المستقبل، قد يُوسّع هذا الخيار ليشمل لواحق لأنواع أخرى من
المحتوى، بما في ذلك أنواع المحتوى التي لا يحللها Wget.
.IP \fB\-\-http\-user=\fP\fIuser\fP 4
.IX عنصر \-\-http\-user=user
.PD 0
.IP \fB\-\-http\-password=\fP\fIpassword\fP 4
.IX عنصر \-\-http\-password=password
.PD
حدد اسم المستخدم \fIuser\fP وكلمة السر \fIpassword\fP على خادم HTTP. وفقًا لنوع
التحدي، سيقوم Wget بترميزهما باستخدام مخطط الاستيثاق \f(CW\*(C`basic\*(C'\fP
(غير آمن)، أو \f(CW\*(C`digest\*(C'\fP، أو \f(CW\*(C`NTLM\*(C'\fP الخاص بويندوز.
.Sp
طريقة أخرى لتحديد اسم المستخدم وكلمة السر هي في رابط URL نفسه. كلتا
الطريقتين تكشفان كلمة السر لأي شخص يهتم بتشغيل \f(CW\*(C`ps\*(C'\fP. لمنع رؤية
كلمات السر، استخدم \fB\-\-use\-askpass\fP أو خزنها في \fI.wgetrc\fP أو \fI.netrc\fP،
وتأكد من حماية تلك الملفات من المستخدمين الآخرين باستخدام
\f(CW\*(C`chmod\*(C'\fP. إذا كانت كلمات السر مهمة حقًا، فلا تتركها في تلك
الملفات أيضًا\-\-\-حرر الملفات واحذفها بعد أن يبدأ Wget التنزيل.
.IP \fB\-\-no\-http\-keep\-alive\fP 4
.IX عنصر \-\-no\-http\-keep\-alive
أوقف ميزة "keep\-alive" لتنزيلات HTTP. عادةً ما يطلب Wget من الخادم إبقاء
الاتصال مفتوحًا بحيث، عندما تنزل أكثر من مستند واحد من نفس الخادم، تُنقل عبر
نفس اتصال TCP. هذا يوفر الوقت ويقلل في الوقت نفسه الحمل على الخادم.
.Sp
هذا الخيار مفيد عندما، لسبب ما، لا تعمل الاتصالات المستمرة (keep\-alive) معك،
على سبيل المثال بسبب علة في الخادم أو بسبب عدم قدرة السكربتات من جانب الخادم
على التعامل مع الاتصالات.
.IP \fB\-\-no\-cache\fP 4
.IX عنصر \-\-no\-cache
عطّل الخبيئة من جانب الخادم. في هذه الحالة، سيرسل Wget إلى الخادم البعيد
التوجيهات المناسبة (\fBCache\-Control: no\-cache\fP و \&\fBPragma: no\-cache\fP)
للحصول على الملف من الخدمة البعيدة، بدلًا من إرجاع النسخة المخبأة. هذا مفيد
بشكل خاص لجلب وتفريغ المستندات منتهية الصلاحية على خوادم الوكيل.
.Sp
التخبئة مسموح بها مبدئيًا.
.IP \fB\-\-no\-cookies\fP 4
.IX عنصر \-\-no\-cookies
عطّل استخدام ملفات تعريف الارتباط (الكوكيز). ملفات تعريف الارتباط هي آلية
للحفاظ على الحالة من جانب الخادم. يرسل الخادم للعميل كوكيز باستخدام رأس
\&\f(CW\*(C`Set\-Cookie\*(C'\fP، ويستجيب العميل بنفس الكوكيز عند الطلبات
اللاحقة. بما أن الكوكيز تسمح لأصحاب الخوادم بتتبع الزوار وللمواقع بتبادل هذه
المعلومات، يعتبرها البعض انتهاكًا للخصوصية. المبدئي هو استخدام الكوكيز؛ ومع
ذلك، فإن \fIتخزين\fP الكوكيز ليس مفعلًا مبدئيًا.
.IP "\fB\-\-load\-cookies\fP \fIfile\fP" 4
.IX عنصر "\-\-load\-cookies file"
حمّل الكوكيز من \fIfile\fP قبل أول جلب HTTP. \&\fIfile\fP هو ملف نصي بالتنسيق
المستخدم أصلًا في ملف \&\fIcookies.txt\fP الخاص بـ Netscape.
.Sp
ستستخدم هذا الخيار عادةً عند عكس المواقع التي تتطلب منك تسجيل الدخول للوصول
إلى بعض أو كل محتواها. تعمل عملية تسجيل الدخول عادةً عن طريق إصدار خادم
الويب لكوكيز HTTP عند استلام والتحقق من بيانات اعتمادك. ثم يُعاد إرسال
الكوكيز بواسطة المتصفح عند الوصول إلى ذلك الجزء من الموقع، وبذلك يثبت هويتك.
.Sp
يتطلب عكس مثل هذا الموقع أن يرسل Wget نفس الكوكيز التي يرسلها متصفحك عند
التواصل مع الموقع. ويتحقق ذلك من خلال \&\fB\-\-load\-cookies\fP\-\-\-ببساطة وجه Wget
إلى موقع ملف \&\fIcookies.txt\fP، وسيرسل نفس الكوكيز التي سيرسلها متصفحك في نفس
الحالة. تحتفظ المتصفحات المختلفة بملفات الكوكيز النصية في مواقع مختلفة:
.RS 4
.ie n .IP """Netscape 4.x.""" 4
.el .IP "\f(CWNetscape 4.x.\fR" 4
.IX عنصر "Netscape 4.x."
الكوكيز موجودة في \fI~/.netscape/cookies.txt\fP.
.ie n .IP """Mozilla and Netscape 6.x.""" 4
.el .IP "\f(CWMozilla and Netscape 6.x.\fR" 4
.IX عنصر "Mozilla و Netscape 6.x."
يُسمى ملف الكوكيز الخاص بـ Mozilla أيضًا \fIcookies.txt\fP، ويقع في مكان ما تحت
\fI~/.mozilla\fP، في دليل تشكيلتك. ينتهي المسار الكامل عادةً ليبدو بشكل ما مثل
\&\fI~/.mozilla/default/some\-weird\-string/cookies.txt\fP.
.ie n .IP """Internet Explorer.""" 4
.el .IP "\f(CWInternet Explorer.\fR" 4
.IX عنصر "Internet Explorer."
يمكنك إنتاج ملف كوكيز يمكن لـ Wget استخدامه عن طريق استخدام قائمة ملف
(File)، استيراد وتصدير (Import and Export)، تصدير الكوكيز (Export
Cookies). اختُبر هذا مع Internet Explorer 5؛ ولا نضمن عمله مع الإصدارات
الأقدم.
.ie n .IP """Other browsers.""" 4
.el .IP "\f(CWOther browsers.\fR" 4
.IX عنصر "متصفحات أخرى."
إذا كنت تستخدم متصفحًا مختلفًا لإنشاء الكوكيز الخاصة بك، فإن
\&\fB\-\-load\-cookies\fP سيعمل فقط إذا تمكنت من تحديد موقع أو إنتاج ملف كوكيز
بتنسيق Netscape الذي يتوقعه Wget.
.RE
.RS 4
.Sp
إذا لم تستطع استخدام \fB\-\-load\-cookies\fP، فقد يظل هناك بديل. إذا كان متصفحك
يدعم "مدير كوكيز"، يمكنك استخدامه لعرض الكوكيز المستخدمة عند الوصول إلى
الموقع الذي تعكسه. دون اسم وقيمة الكوكيز، ووجه Wget يدويًا لإرسال تلك
الكوكيز، متجاوزًا دعم الكوكيز "الرسمي":
.Sp
.Vb 1
\& wget \-\-no\-cookies \-\-header "Cookie: ="
.Ve
.RE
.IP "\fB\-\-save\-cookies\fP \fIfile\fP" 4
.IX عنصر "\-\-save\-cookies file"
احفظ الكوكيز في \fIfile\fP قبل الخروج. لن يحفظ هذا الكوكيز التي انتهت صلاحيتها
أو التي ليس لها وقت انتهاء (ما يسمى "كوكيز الجلسة")، ولكن انظر أيضًا
\fB\-\-keep\-session\-cookies\fP.
.IP \fB\-\-keep\-session\-cookies\fP 4
.IX عنصر \-\-keep\-session\-cookies
عند تحديده، يجعل \fB\-\-save\-cookies\fP يحفظ أيضًا كوكيز الجلسة. كوكيز الجلسة لا
تُحفظ عادةً لأن المقصود منها البقاء في الذاكرة ونسيانها عند الخروج من
المتصفح. حفظها مفيد في المواقع التي تتطلب منك تسجيل الدخول أو زيارة الصفحة
الرئيسية قبل أن تتمكن من الوصول إلى بعض الصفحات. مع هذا الخيار، تُعتبر
عمليات تشغيل Wget المتعددة جلسة متصفح واحدة بالنسبة للموقع.
.Sp
بما أن تنسيق ملف الكوكيز لا يحمل عادةً كوكيز الجلسة، فإن Wget يسمها بطابع
زمني لانتهاء الصلاحية قيمته 0. يتعرف خيار \&\fB\-\-load\-cookies\fP الخاص بـ Wget
على هذه ككوكيز جلسة، ولكن قد يربك ذلك المتصفحات الأخرى. لاحظ أيضًا أن
الكوكيز المحملة بهذه الطريقة ستُعامل مثل كوكيز الجلسة الأخرى، مما يعني أنه
إذا كنت تريد من \&\fB\-\-save\-cookies\fP الحفاظ عليها مرة أخرى، يجب عليك استخدام
\&\fB\-\-keep\-session\-cookies\fP مرة أخرى.
.IP \fB\-\-ignore\-length\fP 4
.IX عنصر \-\-ignore\-length
لسوء الحظ، ترسل بعض خوادم HTTP (برامج CGI، لكي نكون أكثر دقة) رؤوس
\f(CW\*(C`Content\-Length\*(C'\fP زائفة، مما يجعل Wget يخرج عن السيطرة، لأنه
يعتقد أنه لم يُجلب المستند بالكامل. يمكنك اكتشاف هذه المتلازمة إذا حاول Wget
جلب نفس المستند مرارًا وتكرارًا، مدعيًا في كل مرة أن الاتصال (الذي يكون
طبيعيًا لولا ذلك) قد أُغلق عند نفس البايت تمامًا.
.Sp
باستخدام هذا الخيار، سيتجاهل Wget رأس \f(CW\*(C`Content\-Length\*(C'\fP\-\-\-كما لو
أنه لم يكن موجودًا أصلًا.
.IP \fB\-\-header=\fP\fIheader\-line\fP 4
.IX عنصر \-\-header=header\-line
أرسل \fIheader\-line\fP مع بقية الرؤوس في كل طلب HTTP. يُرسل الرأس المقدم كما
هو، مما يعني أنه يجب أن يحتوي على الاسم والقيمة مفصولين بنقطتين رأسيتين،
ويجب ألا يحتوي على أسطر جديدة.
.Sp
يمكنك تحديد أكثر من رأس إضافي واحد عن طريق تحديد \&\fB\-\-header\fP أكثر من مرة.
.Sp
.Vb 3
\& wget \-\-header=\*(AqAccept\-Charset: iso\-8859\-2\*(Aq \e
\& \-\-header=\*(AqAccept\-Language: hr\*(Aq \e
\& http://fly.srk.fer.hr/
.Ve
.Sp
تحديد سلسلة فارغة كقيمة للرأس سيؤدي إلى مسح جميع الرؤوس السابقة التي حددها
المستخدم.
.Sp
بدءًا من Wget 1.10، يمكن استخدام هذا الخيار لتجاوز الرؤوس التي تُولد آليًا
بخلاف ذلك. هذا المثال يوجه Wget للاتصال بـ localhost، ولكن مع تحديد
\fBfoo.bar\fP في رأس \f(CW\*(C`Host\*(C'\fP:
.Sp
.Vb 1
\& wget \-\-header="Host: foo.bar" http://localhost/
.Ve
.Sp
في إصدارات Wget الأقدم من 1.10، تسبب هذا الاستخدام لـ \fB\-\-header\fP في إرسال
رؤوس مكررة.
.IP \fB\-\-compression=\fP\fItype\fP 4
.IX عنصر \-\-compression=type
اختر نوع الضغط المراد استخدامه. القيم المسموح بها هي \&\fBauto\fP، و \fBgzip\fP و
\fBnone\fP.
.Sp
إذا حُدد \fBauto\fP أو \fBgzip\fP، يطلب Wget من الخادم ضغط الملف باستخدام تنسيق
ضغط gzip. إذا قام الخادم بضغط الملف واستجاب مع تعيين حقل رأس
\f(CW\*(C`Content\-Encoding\*(C'\fP بشكل مناسب، فسيُفك ضغط الملف آليًا.
.Sp
إذا حُدد \fBnone\fP، فلن يطلب wget من الخادم ضغط الملف ولن يفك ضغط أي استجابات
من الخادم. هذا هو المبدئي.
.Sp
دعم الضغط تجريبي حاليًا. في حال تفعيله، يرجى الإبلاغ عن أي علل إلى
\f(CW\*(C`bug\-wget@gnu.org\*(C'\fP.
.IP \fB\-\-max\-redirect=\fP\fInumber\fP 4
.IX عنصر \-\-max\-redirect=number
يحدد الحد الأقصى لعدد عمليات إعادة التوجيه التي يجب اتباعها لمورد
ما. المبدئي هو 20، وهو عادةً أكثر بكثير مما هو ضروري. ومع ذلك، في تلك
المناسبات التي تريد فيها السماح بالمزيد (أو الأقل)، هذا هو الخيار المستخدم.
.IP \fB\-\-proxy\-user=\fP\fIuser\fP 4
.IX عنصر \-\-proxy\-user=user
.PD 0
.IP \fB\-\-proxy\-password=\fP\fIpassword\fP 4
.IX عنصر \-\-proxy\-password=password
.PD
حدد اسم المستخدم \fIuser\fP وكلمة السر \fIpassword\fP للاستيثاق على خادم
وكيل. سيقوم Wget بترميزهما باستخدام مخطط استيثاق \&\f(CW\*(C`basic\*(C'\fP.
.Sp
اعتبارات أمنية مماثلة لتلك الخاصة بـ \fB\-\-http\-password\fP تنطبق هنا أيضًا.
.IP \fB\-\-referer=\fP\fIurl\fP 4
.IX عنصر \-\-referer=url
أدرج رأس \`Referer: \fIurl\fP\*(Aq في طلب HTTP. مفيد لـ جلب المستندات التي
تتطلب معالجة من جانب الخادم والتي تفترض أنها تُجلب دائمًا بواسطة متصفحات ويب
تفاعلية ولا تظهر بشكل صحيح إلا عندما يُضبط المُحيل (Referer) إلى إحدى
الصفحات التي تشير إليها.
.IP \fB\-\-save\-headers\fP 4
.IX عنصر \-\-save\-headers
احفظ الرؤوس المرسلة من قبل خادم HTTP في الملف، مسبوقة بـ المحتويات الفعلية،
مع سطر فارغ كفاصل.
.IP "\fB\-U\fP \fIagent\-string\fP" 4
.IX عنصر "\-U agent\-string"
.PD 0
.IP \fB\-\-user\-agent=\fP\fIagent\-string\fP 4
.IX عنصر \-\-user\-agent=agent\-string
.PD
عرّف نفسك كـ \fIagent\-string\fP لخادم HTTP.
.Sp
يسمح بروتوكول HTTP للعملاء بالتعريف عن أنفسهم باستخدام حقل رأس
\&\f(CW\*(C`User\-Agent\*(C'\fP. يتيح ذلك تمييز برمجيات ويب، عادةً لأغراض إحصائية
أو لتتبع انتهاكات البروتوكول. يعرّف Wget نفسه عادةً كـ \&\fBWget/\fP\fIversion\fP،
حيث \fIversion\fP هو رقم الإصدار الحالي لـ Wget.
.Sp
ومع ذلك، عُرف عن بعض المواقع فرض سياسة تفصيل المخرجات وفقًا للمعلومات
المقدمة في \f(CW\*(C`User\-Agent\*(C'\fP. وبينما لا تعد هذه فكرة سيئة نظريًا، فقد
أُسيء استخدامها من قبل خوادم تحرم العملاء من المعلومات بخلاف (تاريخيًا)
Netscape أو، بشكل متكرر أكثر، Microsoft Internet Explorer. يتيح لك هذا
الخيار تغيير سطر \f(CW\*(C`User\-Agent\*(C'\fP الذي يصدره Wget. لا يُنصح باستخدام
هذا الخيار، إلا إذا كنت تعرف حقًا ما تفعله.
.Sp
تحديد وكيل مستخدم فارغ باستخدام \fB\-\-user\-agent=""\fP يوجه Wget بعدم إرسال رأس
\f(CW\*(C`User\-Agent\*(C'\fP في طلبات HTTP.
.IP \fB\-\-post\-data=\fP\fIstring\fP 4
.IX عنصر \-\-post\-data=string
.PD 0
.IP \fB\-\-post\-file=\fP\fIfile\fP 4
.IX عنصر \-\-post\-file=file
.PD
استخدم POST كطريقة لجميع طلبات HTTP وأرسل البيانات المحددة في متن
الطلب. يرسل \fB\-\-post\-data\fP السلسلة \fIstring\fP كبيانات، بينما يرسل
\fB\-\-post\-file\fP محتويات \fIfile\fP. بخلاف ذلك، فإنهما يعملان بنفس الطريقة
تمامًا. وبشكل خاص، كلاهما يتوقع محتوى من النموذج
\f(CW\*(C`key1=value1&key2=value2\*(C'\fP، مع ترميز النسبة المئوية للأحرف
الخاصة؛ الفرق الوحيد هو أن أحدهما يتوقع محتواه كمعامل سطر أوامر والآخر يقبل
محتواه من ملف. وبشكل خاص، \fB\-\-post\-file\fP ليس لنقل الملفات كمرفقات نموذج: يجب
أن تظهر هذه كبيانات \f(CW\*(C`key=value\*(C'\fP (مع ترميز النسبة المئوية
المناسب) تمامًا مثل أي شيء آخر. لا يدعم Wget حاليًا
\&\f(CW\*(C`multipart/form\-data\*(C'\fP لنقل بيانات POST؛ فقط
\&\f(CW\*(C`application/x\-www\-form\-urlencoded\*(C'\fP. يجب تحديد واحد فقط من
\&\fB\-\-post\-data\fP و \fB\-\-post\-file\fP.
.Sp
يرجى ملاحظة أن wget لا يتطلب أن يكون المحتوى من النموذج
\&\f(CW\*(C`key1=value1&key2=value2\*(C'\fP، ولا يختبر ذلك. سيقوم Wget ببساطة
بنقل أي بيانات تقدم له. ومع ذلك، تتوقع معظم الخوادم أن تكون بيانات POST
بالتنسيق أعلاه عند معالجة نماذج HTML.
.Sp
عند إرسال طلب POST باستخدام خيار \fB\-\-post\-file\fP، يعامل Wget الملف كملف ثنائي
وسيرسل كل حرف في طلب POST دون تجريد أسطر جديدة لاحقة أو أحرف تغذية
الصفحة. أي أحرف تحكم أخرى في النص ستُرسل أيضًا كما هي في طلب POST.
.Sp
يرجى العلم أن Wget يحتاج إلى معرفة حجم بيانات POST مسبقًا. لذلك يجب أن يكون
المعامل لـ \f(CW\*(C`\-\-post\-file\*(C'\fP ملفًا عاديًا؛ لن يعمل تحديد FIFO أو شيء
مثل \fI/dev/stdin\fP. ليس من الواضح تمامًا كيفية الالتفاف على هذا القيد المتأصل
في HTTP/1.0. على الرغم من أن HTTP/1.1 يقدم النقل المجزأ (chunked) الذي لا
يتطلب معرفة طول الطلب مسبقًا، إلا أن العميل لا يمكنه استخدام النقل المجزأ ما
لم يعرف أنه يتحدث إلى خادم HTTP/1.1. ولا يمكنه معرفة ذلك حتى يتلقى استجابة،
والتي بدورها تتطلب اكتمال الطلب \-\- مشكلة البيضة والدجاجة.
.Sp
ملاحظة: بدءًا من الإصدار 1.15 إذا أُعيد توجيه Wget بعد اكتمال طلب POST،
فسيعتمد سلوكه على رمز الاستجابة الذي أرجعه الخادم. في حالة 301 (نُقل بشكل
دائم)، أو 302 (نُقل مؤقتًا) أو 307 (إعادة توجيه مؤقتة)، سيستمر Wget، وفقًا
لـ RFC2616، في إرسال طلب POST. في حال أراد الخادم من العميل تغيير طريقة
الطلب عند إعادة التوجيه، فيجب عليه إرسال رمز الاستجابة 303 (انظر غيره).
.Sp
يوضح هذا المثال كيفية تسجيل الدخول إلى خادم باستخدام POST ثم المتابعة لتنزيل
الصفحات المطلوبة، والتي يفترض أنها متاحة فقط للمستخدمين المأذون لهم:
.Sp
.Vb 4
\& # سجل الدخول إلى الخادم. يمكن فعل ذلك مرة واحدة فقط.
\& wget \-\-save\-cookies cookies.txt \e
\& \-\-post\-data \*(Aquser=foo&password=bar\*(Aq \e
\& http://example.com/auth.php
\&
\& # الآن جلب الصفحة أو الصفحات التي نهتم بها.
\& wget \-\-load\-cookies cookies.txt \e
\& \-p http://example.com/interesting/article.php
.Ve
.Sp
إذا كان الخادم يستخدم كوكيز الجلسة لتتبع استيثاق المستخدم، فإن ما ورد أعلاه
لن يعمل لأن \fB\-\-save\-cookies\fP لن يحفظها (وكذلك المتصفحات) وسيكون ملف
\fIcookies.txt\fP فارغًا. في هذه الحالة استخدم \fB\-\-keep\-session\-cookies\fP مع
\&\fB\-\-save\-cookies\fP لفرض حفظ كوكيز الجلسة.
.IP \fB\-\-method=\fP\fIHTTP\-Method\fP 4
.IX عنصر \-\-method=HTTP\-Method
لغرض سكربتات RESTful، يسمح Wget بإرسال طرق HTTP أخرى دون الحاجة إلى تعيينها
صراحةً باستخدام \fB\-\-header=Header\-Line\fP. سيستخدم Wget أي سلسلة تُمرر إليه
بعد \fB\-\-method\fP كطريقة HTTP إلى الخادم.
.IP \fB\-\-body\-data=\fP\fIData\-String\fP 4
.IX عنصر \-\-body\-data=Data\-String
.PD 0
.IP \fB\-\-body\-file=\fP\fIData\-File\fP 4
.IX عنصر \-\-body\-file=Data\-File
.PD
يجب ضبطه عندما يلزم إرسال بيانات إضافية إلى الخادم مع الطريقة المحددة
باستخدام \fB\-\-method\fP. يرسل \fB\-\-body\-data\fP السلسلة \fIstring\fP كبيانات، بينما
يرسل \fB\-\-body\-file\fP محتويات \fIfile\fP. بخلاف ذلك، فإنهما يعملان بنفس الطريقة
تمامًا.
.Sp
حاليًا، \fB\-\-body\-file\fP \fIليس\fP لنقل الملفات ككل. لا يدعم Wget حاليًا
\f(CW\*(C`multipart/form\-data\*(C'\fP لنقل البيانات؛ فقط
\f(CW\*(C`application/x\-www\-form\-urlencoded\*(C'\fP. في المستقبل، قد يُغير هذا
بحيث يرسل wget ملف \fB\-\-body\-file\fP كملف كامل بدلًا من إرسال محتوياته إلى
الخادم. يرجى العلم أن Wget يحتاج إلى معرفة محتويات بيانات المتن (BODY)
مسبقًا، وبالتالي يجب أن يكون المعامل لـ \fB\-\-body\-file\fP ملفًا عاديًا. انظر
\fB\-\-post\-file\fP للحصول على شرح أكثر تفصيلاً. يجب تحديد واحد فقط من
\fB\-\-body\-data\fP و \fB\-\-body\-file\fP.
.Sp
إذا أُعيد توجيه Wget بعد اكتمال الطلب، فسيقوم Wget بتعليق الطريقة الحالية
وإرسال طلب GET حتى تكتمل إعادة التوجيه. هذا صحيح لجميع رموز استجابة إعادة
التوجيه باستثناء 307 (إعادة توجيه مؤقتة) والذي يُستخدم لتحديد صراحةً أن
طريقة الطلب يجب \fIألا\fP تتغير. استثناء آخر هو عندما تُضبط الطريقة على
\f(CW\*(C`POST\*(C'\fP، وفي هذه الحالة تُتبع قواعد إعادة التوجيه المحددة تحت
\fB\-\-post\-data\fP.
.IP \fB\-\-content\-disposition\fP 4
.IX عنصر \-\-content\-disposition
إذا ضُبط هذا على وضع التشغيل (on)، فسيُفعل الدعم التجريبي (غير الوظيفي
بالكامل) لرؤوس \&\f(CW\*(C`Content\-Disposition\*(C'\fP. يمكن أن يؤدي هذا حاليًا
إلى رحلات ذهاب وإياب إضافية إلى الخادم لطلب \f(CW\*(C`HEAD\*(C'\fP، ومن المعروف
أنه يعاني من بعض العلل، وهذا هو سبب عدم تفعيله مبدئيًا حاليًا.
.Sp
هذا الخيار مفيد لبعض برامج CGI لتنزيل الملفات التي تستخدم رؤوس
\&\f(CW\*(C`Content\-Disposition\*(C'\fP لوصف ما يجب أن يكون عليه اسم الملف
المُنزل.
.Sp
عند دمجه مع \fB\-\-metalink\-over\-http\fP و \fB\-\-trust\-server\-names\fP، تتم تسمية ملف
\fBContent\-Type: application/metalink4+xml\fP باستخدام حقل اسم الملف في
\&\f(CW\*(C`Content\-Disposition\*(C'\fP، إذا كان متاحًا.
.IP \fB\-\-content\-on\-error\fP 4
.IX عنصر \-\-content\-on\-error
إذا ضُبط هذا على وضع التشغيل (on)، فلن يتخطى wget المحتوى عندما يستجيب
الخادم برمز حالة http يشير إلى خطأ.
.IP \fB\-\-trust\-server\-names\fP 4
.IX عنصر \-\-trust\-server\-names
إذا ضُبط هذا الخيار، فسيعتمد اسم الملف المحلي عند إعادة التوجيه على عنوان
URL المُعاد التوجيه إليه. يعتمد اسم الملف المحلي مبدئيًا على عنوان URL
الأصلي. يفيد هذا عند إجراء جلب متكرر لأن عناوين URL المُعاد توجيهها في
الكثير من مواقع الويب تقابل بنية ملفات أساسية، بينما لا تفعل ذلك عناوين URL
الخاصة بالروابط.
.IP \fB\-\-auth\-no\-challenge\fP 4
.IX عنصر \-\-auth\-no\-challenge
إذا أُعطي هذا الخيار، سيرسل Wget معلومات الاستيثاق الأساسية لبروتوكول HTTP
(اسم المستخدم وكلمة السر بنص صرف) لجميع الطلبات، تمامًا كما كان يفعل Wget
1.10.2 وما قبله مبدئيًا.
.Sp
لا يُنصح باستخدام هذا الخيار، وهو مخصص فقط لدعم بعض الخوادم الغامضة القليلة
التي لا ترسل أبدًا تحديات استيثاق HTTP، ولكنها تقبل معلومات استيثاق غير
مطلوبة، بالإضافة إلى الاستيثاق القائم على النماذج مثلًا.
.IP \fB\-\-retry\-on\-host\-error\fP 4
.IX عنصر \-\-retry\-on\-host\-error
اعتبار أخطاء المضيف، مثل "فشل مؤقت في حل الاسم"، أخطاءً عابرة وغير قاتلة.
.IP \fB\-\-retry\-on\-http\-error=\fP\fIرمز[,رمز,...]\fP 4
.IX عنصر \-\-retry\-on\-http\-error=رمز[,رمز,...]
اعتبار رموز استجابة HTTP المعطاة أخطاءً عابرة وغير قاتلة. مرر قائمة مفصولة
بفاصلات لرموز استجابة HTTP المكونة من 3 أرقام كمعامل. يفيد هذا في التحايل
على ظروف خاصة تتطلب إعادة المحاولة، ولكن الخادم يستجيب برمز خطأ لا يعيد Wget
المحاولة عنده عادةً. قد تكون هذه الأخطاء 503 (الخدمة غير متوفرة) و 429
(طلبات كثيرة جدًا). تخضع عمليات إعادة المحاولة المُمكّنة بهذا الخيار لتوقيت
إعادة المحاولة المعتاد وقيود عدد مرات إعادة المحاولة في Wget.
.Sp
استخدام هذا الخيار مخصص لدعم حالات استخدام خاصة فقط ولا يُنصح به عمومًا،
لأنه قد يفرض إعادة المحاولة حتى في الحالات التي يحاول فيها الخادم فعليًا
تقليل حمله. يرجى استخدامه بحكمة وفقط إذا كنت تعرف ما تفعله.
.SS "خيارات HTTPS (SSL/TLS)"
.IX "قسم فرعي" "خيارات HTTPS (SSL/TLS)"
لدعم تنزيلات HTTP المُعماة (HTTPS)، يجب أن يُصرّف Wget مع مكتبة SSL
خارجية. المبدئي الحالي هو GnuTLS. بالإضافة إلى ذلك، يدعم Wget أيضًا HSTS
(أمن النقل الصارم لـ HTTP). إذا صُرّف Wget بدون دعم SSL، فلن تتوفر أي من هذه
الخيارات.
.IP \fB\-\-secure\-protocol=\fP\fIبروتوكول\fP 4
.IX عنصر \-\-secure\-protocol=بروتوكول
اختر البروتوكول الآمن المراد استخدامه. القيم المسموح بها هي \fBauto\fP، و
\&\fBSSLv2\fP، و \fBSSLv3\fP، و \fBTLSv1\fP، و \fBTLSv1_1\fP، و \fBTLSv1_2\fP، و
\&\fBTLSv1_3\fP و \fBPFS\fP. إذا استُخدم \fBauto\fP، تُمنح مكتبة SSL حرية اختيار
البروتوكول المناسب آليًا، ويتحقق ذلك بإرسال تحية TLSv1. هذا هو الخيار
المبدئي.
.Sp
تحديد \fBSSLv2\fP، أو \fBSSLv3\fP، أو \fBTLSv1\fP، أو \fBTLSv1_1\fP، أو \&\fBTLSv1_2\fP، أو
\fBTLSv1_3\fP يفرض استخدام البروتوكول المقابل. يفيد هذا عند التحدث إلى تطبيقات
خوادم SSL القديمة والمليئة بالعلل التي تجعل من الصعب على مكتبة SSL الأساسية
اختيار إصدار البروتوكول الصحيح. لحسن الحظ، هذه الخوادم نادرة جدًا.
.Sp
تحديد \fBPFS\fP يفرض استخدام ما يسمى بمجموعات شفرات "أمن التوجيه
المثالي". باختصار، يضيف PFS أمانًا عن طريق إنشاء مفتاح لمرة واحدة لكل اتصال
SSL. له تأثير أكبر قليلاً على وحدة المعالجة المركزية في العميل والخادم. نحن
نستخدم شفرات معروفة بأنها آمنة (مثل لا MD4) وبروتوكول TLS. يستبعد هذا الوضع
أيضًا صراحةً طرق تبادل المفاتيح غير التابعة لـ PFS، مثل RSA.
.IP \fB\-\-https\-only\fP 4
.IX عنصر \-\-https\-only
عندما يكون في الوضع المتكرر، تُتبع روابط HTTPS فقط.
.IP \fB\-\-ciphers\fP 4
.IX عنصر \-\-ciphers
اضبط سلسلة قائمة الشفرات. عادةً ما تحدد هذه السلسلة مجموعات الشفرات وخيارات
SSL/TLS الأخرى التي يرغب المستخدم في استخدامها، بترتيب مفضل محدد (تسميها
GnuTLS \*(Aqسلسلة الأولوية\*(Aq). ستُغذى هذه السلسلة حرفيًا لمحرك SSL/TLS
(OpenSSL أو GnuTLS) وبالتالي يعتمد تنسيقها وصياغتها على ذلك. لن يقوم Wget
بمعالجتها أو التلاعب بها بأي شكل من الأشكال. ارجع إلى وثائق OpenSSL أو
GnuTLS لمزيد من المعلومات.
.IP \fB\-\-no\-check\-certificate\fP 4
.IX عنصر \-\-no\-check\-certificate
عدم التحقق من شهادة الخادم مقابل سلطات التصديق المتاحة. وأيضًا عدم اشتراط
تطابق اسم مضيف عنوان URL مع الاسم الشائع المقدم في الشهادة.
.Sp
بدءًا من Wget 1.10، أصبح المبدئي هو التحقق من شهادة الخادم مقابل سلطات
التصديق المعترف بها، مما يقطع مصافحة SSL ويوقف التنزيل إذا فشل التحقق. على
الرغم من أن هذا يوفر تنزيلات أكثر أمانًا، إلا أنه يكسر التوافق التشغيلي مع
بعض المواقع التي كانت تعمل مع إصدارات Wget السابقة، خاصة تلك التي تستخدم
شهادات ذاتية التوقيع، أو منتهية الصلاحية، أو غير صالحة بأي شكل آخر. يفرض هذا
الخيار وضع تشغيل "غير آمن" يحول أخطاء التحقق من الشهادة إلى تحذيرات ويسمح لك
بالمتابعة.
.Sp
إذا واجهت أخطاء "التحقق من الشهادة" أو تلك التي تقول إن "الاسم الشائع لا
يطابق اسم المضيف المطلوب"، يمكنك استخدام هذا الخيار لتجاوز التحقق والمتابعة
في التنزيل. \&\fIاستخدم هذا الخيار فقط إذا كنت مقتنعًا بخلاف ذلك بأصالة الموقع، أو إذا كنت لا تهتم حقًا بصلاحية شهادته.\fP يكاد يكون من السيئ دائمًا
عدم التحقق من الشهادات عند نقل بيانات سرية أو مهمة. بالنسبة للشهادات ذاتية
التوقيع/الداخلية، يجب تنزيل الشهادة والتحقق منها بدلاً من فرض هذا الوضع غير
الآمن. إذا كنت متأكدًا حقًا من عدم رغبتك في أي تحقق من الشهادة، يمكنك تحديد
\-\-check\-certificate=quiet لإخبار wget بعدم طباعة أي تحذير بشأن الشهادات غير
الصالحة، وإن كان هذا في معظم الحالات هو التصرف الخاطئ.
.IP \fB\-\-certificate=\fP\fIملف\fP 4
.IX عنصر \-\-certificate=ملف
استخدم شهادة العميل المخزنة في \fIملف\fP. هذا مطلوب للخوادم التي ضُبطت لتطلب
شهادات من العملاء الذين يتصلون بها. عادةً لا تُطلب شهادة وهذا التبديل
اختياري.
.IP \fB\-\-certificate\-type=\fP\fIنوع\fP 4
.IX عنصر \-\-certificate\-type=نوع
حدد نوع شهادة العميل. القيم المسموح بها هي \&\fBPEM\fP (مفترض مبدئيًا) و
\fBDER\fP، المعروف أيضًا باسم \&\fBASN1\fP.
.IP \fB\-\-private\-key=\fP\fIملف\fP 4
.IX عنصر \-\-private\-key=ملف
قراءة المفتاح الخاص من \fIملف\fP. يتيح لك هذا تقديم المفتاح الخاص في ملف منفصل
عن الشهادة.
.IP \fB\-\-private\-key\-type=\fP\fIنوع\fP 4
.IX عنصر \-\-private\-key\-type=نوع
حدد نوع المفتاح الخاص. القيم المقبولة هي \fBPEM\fP (المبدئية) و \fBDER\fP.
.IP \fB\-\-ca\-certificate=\fP\fIملف\fP 4
.IX عنصر \-\-ca\-certificate=ملف
استخدم \fIملف\fP كملف يحتوي على حزمة سلطات التصديق ("CA") للتحقق من
الأطراف. يجب أن تكون الشهادات بتنسيق PEM.
.Sp
بدون هذا الخيار، يبحث Wget عن شهادات CA في المواقع المحددة من قبل النظام،
والتي تم اختيارها في وقت تثبيت OpenSSL.
.IP \fB\-\-ca\-directory=\fP\fIدليل\fP 4
.IX عنصر \-\-ca\-directory=دليل
يحدد الدليل الذي يحتوي على شهادات CA بتنسيق PEM. يحتوي كل ملف على شهادة CA
واحدة، ويعتمد اسم الملف على قيمة هاش مشتقة من الشهادة. يتحقق ذلك عن طريق
معالجة دليل الشهادات باستخدام أداة \f(CW\*(C`c_rehash\*(C'\fP المرفقة مع
OpenSSL. استخدام \fB\-\-ca\-directory\fP أكثر كفاءة من \&\fB\-\-ca\-certificate\fP عند
تثبيت العديد من الشهادات لأنه يسمح لـ Wget بجلب الشهادات عند الطلب.
.Sp
بدون هذا الخيار، يبحث Wget عن شهادات CA في المواقع المحددة من قبل النظام،
والتي تم اختيارها في وقت تثبيت OpenSSL.
.IP \fB\-\-crl\-file=\fP\fIملف\fP 4
.IX عنصر \-\-crl\-file=ملف
يحدد ملف قائمة إبطال الشهادات (CRL) في \fIملف\fP. هذا مطلوب للشهادات التي
أُبطلت من قبل سلطات التصديق.
.IP \fB\-\-pinnedpubkey=ملف/هاشات\fP 4
.IX عنصر \-\-pinnedpubkey=ملف/هاشات
يخبر wget باستخدام ملف المفتاح العام المحدد (أو الهاشات) للتحقق من الطرف
الآخر. يمكن أن يكون هذا مسارًا لملف يحتوي على مفتاح عام واحد بتنسيق PEM أو
DER، أو أي عدد من هاشات sha256 المرمزة بـ base64 والمسبوقة بـ "sha256//"
والمفصولة بـ ";"
.Sp
عند التفاوض على اتصال TLS أو SSL، يرسل الخادم شهادة تشير إلى هويته. يُستخرج
مفتاح عام من هذه الشهادة، وإذا لم يطابق تمامًا المفتاح (أو المفاتيح) العامة
المقدمة لهذا الخيار، فسيقطع wget الاتصال قبل إرسال أو استقبال أي بيانات.
.IP \fB\-\-random\-file=\fP\fIملف\fP 4
.IX عنصر \-\-random\-file=ملف
[OpenSSL و LibreSSL فقط] استخدم \fIملف\fP كمصدر للبيانات العشوائية لبذر مولد
الأرقام العشوائية الزائفة على الأنظمة التي لا تحتوي على \fI/dev/urandom\fP.
.Sp
في مثل هذه الأنظمة، تحتاج مكتبة SSL إلى مصدر خارجي للعشوائية للتهيئة. يمكن
توفير العشوائية عن طريق EGD (انظر \&\fB\-\-egd\-file\fP أدناه) أو قراءتها من مصدر
خارجي يحدده المستخدم. إذا لم يُحدد هذا الخيار، يبحث Wget عن بيانات عشوائية
في \f(CW$RANDFILE\fP أو، إذا لم يكن مضبوطًا، في \f(CI$HOME\fI/.rnd\fP.
.Sp
إذا كنت تتلقى الخطأ "Could not seed OpenSSL PRNG; disabling SSL."، فيجب عليك
توفير بيانات عشوائية باستخدام بعض الطرق الموضحة أعلاه.
.IP \fB\-\-egd\-file=\fP\fIملف\fP 4
.IX عنصر \-\-egd\-file=ملف
[OpenSSL فقط] استخدم \fIملف\fP كمقبس EGD. يرمز EGD إلى \fIعفريت جمع الإنتروبيا\fP،
وهو برنامج في مساحة المستخدم يجمع البيانات من مصادر النظام المتنوعة غير
المتوقعة ويجعلها متاحة للبرامج الأخرى التي قد تحتاج إليها. تحتاج برمجيات
التعمية، مثل مكتبة SSL، إلى مصادر عشوائية غير متكررة لبذر مولد الأرقام
العشوائية المستخدم لإنتاج مفاتيح قوية تعموِيًا.
.Sp
يسمح OpenSSL للمستخدم بتحديد مصدر الإنتروبيا الخاص به باستخدام متغير البيئة
\&\f(CW\*(C`RAND_FILE\*(C'\fP. إذا لم يكن هذا المتغير مضبوطًا، أو إذا كان الملف
المحدد لا ينتج عشوائية كافية، فسيقرأ OpenSSL بيانات عشوائية من مقبس EGD
المحدد باستخدام هذا الخيار.
.Sp
إذا لم يُحدد هذا الخيار (ولم يُستخدم أمر التشغيل المكافئ)، فلن يتم الاتصال
بـ EGD أبدًا. لا توجد حاجة إلى EGD في أنظمة يونكس الحديثة التي تدعم
\fI/dev/urandom\fP.
.IP \fB\-\-no\-hsts\fP 4
.IX عنصر \-\-no\-hsts
يدعم Wget مبدئيًا HSTS (أمن النقل الصارم لـ HTTP، وفق RFC 6797). استخدم
\fB\-\-no\-hsts\fP لجعل Wget يتصرف كوكيل مستخدم غير متوافق مع HSTS. ونتيجة لذلك،
سيتجاهل Wget جميع ترويسات \f(CW\*(C`Strict\-Transport\-Security\*(C'\fP، ولن يفرض
أي سياسة HSTS موجودة.
.IP \fB\-\-hsts\-file=\fP\fIملف\fP 4
.IX عنصر \-\-hsts\-file=ملف
يخزن Wget قاعدة بيانات HSTS الخاصة به مبدئيًا في \fI~/.wget\-hsts\fP. يمكنك
استخدام \fB\-\-hsts\-file\fP لتجاوز ذلك. سيستخدم Wget الملف المقدم كقاعدة بيانات
HSTS. يجب أن يتوافق هذا الملف مع تنسيق قاعدة بيانات HSTS الصحيح الذي يستخدمه
Wget. إذا لم يتمكن Wget من تحليل الملف المقدم، فسيكون السلوك غير محدد.
.Sp
قاعدة بيانات HSTS الخاصة بـ Wget هي ملف نصي صرف. يحتوي كل سطر على مدخلة HSTS
(أي موقع أصدر ترويسة \f(CW\*(C`Strict\-Transport\-Security\*(C'\fP وبالتالي حدد
سياسة HSTS ملموسة ليتم تطبيقها). يتجاهل Wget الأسطر التي تبدأ بشرطة
(\f(CW\*(C`#\*(C'\fP). يرجى ملاحظة أنه على الرغم من سهولة القراءة البشرية هذه،
فإن التعديل اليدوي لقاعدة بيانات HSTS ليس فكرة جيدة عمومًا.
.Sp
يتكون سطر مدخلة HSTS من عدة حقول مفصولة بمسافة بيضاء واحدة أو أكثر:
.Sp
\&\f(CW\*(C`<اسم_المضيف> SP [<المنفذ>] SP <تضمين_النطاقات_الفرعية> SP <تاريخ_الإنشاء> SP <أقصى_عمر>\*(C'\fP
.Sp
يشير حقلا \fIhostname\fP و \fIport\fP إلى اسم المضيف والمنفذ اللذين تُطبق عليهما
سياسة HSTS المعطاة. قد يكون حقل \fIport\fP صفرًا، وسيكون كذلك في معظم
الحالات. وهذا يعني أن رقم المنفذ لن يؤخذ في الاعتبار عند تحديد ما إذا كان
يجب تطبيق سياسة HSTS هذه على طلب معين (سيُقيّم اسم المضيف فقط). عندما يكون
\fIport\fP مختلفًا عن الصفر، سيُقيّم كل من اسم المضيف والمنفذ المستهدف ولن
تُطبق سياسة HSTS إلا إذا تطابق كلاهما. أُدرجت هذه الميزة لأغراض
الاختبار/التطوير فقط. تنشئ مجموعة اختبار Wget (في \fItestenv/\fP) قواعد بيانات
HSTS بمنافذ صريحة لغرض ضمان سلوك Wget الصحيح. لا يُنصح بتطبيق سياسات HSTS
على منافذ غير المنافذ المبدئية وفق RFC 6797 (انظر الملحق ب "الاختلافات بين
سياسة HSTS وسياسة المنشأ نفسه"). وبالتالي، لا ينبغي استخدام هذه الوظيفة في
بيئات الإنتاج وسيكون \fIport\fP عادةً صفرًا. الحقول الثلاثة الأخيرة تفعل ما هو
متوقع منها. يمكن أن يكون الحقل \fIinclude_subdomains\fP إما \f(CW1\fP أو \f(CW0\fP
ويشير إلى ما إذا كان ينبغي أن تكون النطاقات الفرعية للنطاق المستهدف جزءًا من
سياسة HSTS المعطاة أيضًا. يحمل حقلا \fIcreated\fP و \fImax\-age\fP قيم الطابع
الزمني لوقت إنشاء هذه المدخلة (أول رؤية بواسطة Wget) والقيمة المحددة في HSTS
وهي \*(Aqmax\-age\*(Aq، والتي تحدد المدة التي يجب أن تظل فيها سياسة HSTS
نشطة، مقاسة بالثواني المنقضية منذ الطابع الزمني المخزن في \fIcreated\fP. بمجرد
مرور ذلك الوقت، لن تعد سياسة HSTS تلك صالحة وستُزال في النهاية من قاعدة
البيانات.
.Sp
إذا قدمت قاعدة بيانات HSTS الخاصة بك عبر \fB\-\-hsts\-file\fP، فكن على علم بأن
Wget قد يعدل الملف المقدم إذا حدث أي تغيير بين سياسات HSTS التي طلبتها
الخوادم البعيدة وتلك الموجودة في الملف. عندما يخرج Wget، فإنه يحدث فعليًا
قاعدة بيانات HSTS عن طريق إعادة كتابة ملف قاعدة البيانات بالمدخلات الجديدة.
.Sp
إذا كان الملف المقدم غير موجود، فسينشئ Wget واحدًا. سيحتوي هذا الملف على
مدخلات HSTS الجديدة. إذا لم تُنشأ أي مدخلات HSTS (لم ترسل أي من الخوادم
ترويسات \f(CW\*(C`Strict\-Transport\-Security\*(C'\fP) فلن يُنشأ أي ملف، ولا حتى
ملف فارغ. ينطبق هذا السلوك على ملف قاعدة البيانات المبدئي (\fI~/.wget\-hsts\fP)
أيضًا: لن يُنشأ حتى يفرض خادم ما سياسة HSTS.
.Sp
تُبذل العناية لعدم تجاوز التغييرات المحتملة التي تجريها عمليات Wget الأخرى
في نفس الوقت على قاعدة بيانات HSTS. قبل تفريغ مدخلات HSTS المحدثة في الملف،
سيعيد Wget قراءته ويدمج التغييرات.
.Sp
لا يُنصح باستخدام قاعدة بيانات HSTS مخصصة و/أو تعديل واحدة موجودة. لمزيد من
المعلومات حول التهديدات الأمنية المحتملة الناشئة عن مثل هذه الممارسة، انظر
القسم 14 "اعتبارات أمنية" من RFC 6797، وخاصة القسم 14.9 "التلاعب الإبداعي
بمخزن سياسة HSTS".
.IP \fB\-\-warc\-file=\fP\fIملف\fP 4
.IX عنصر \-\-warc\-file=ملف
استخدم \fIملف\fP كملف WARC الوجهة.
.IP \fB\-\-warc\-header=\fP\fIسلسلة\fP 4
.IX عنصر \-\-warc\-header=سلسلة
استخدم \fIسلسلة\fP في سجل warcinfo.
.IP \fB\-\-warc\-max\-size=\fP\fIحجم\fP 4
.IX عنصر \-\-warc\-max\-size=حجم
اضبط الحد الأقصى لحجم ملفات WARC على \fIحجم\fP.
.IP \fB\-\-warc\-cdx\fP 4
.IX عنصر \-\-warc\-cdx
كتابة ملفات فهرس CDX.
.IP \fB\-\-warc\-dedup=\fP\fIملف\fP 4
.IX عنصر \-\-warc\-dedup=ملف
عدم تخزين السجلات المدرجة في ملف CDX هذا.
.IP \fB\-\-no\-warc\-compression\fP 4
.IX عنصر \-\-no\-warc\-compression
عدم ضغط ملفات WARC باستخدام GZIP.
.IP \fB\-\-no\-warc\-digests\fP 4
.IX عنصر \-\-no\-warc\-digests
عدم حساب خلاصات (digests) SHA1.
.IP \fB\-\-no\-warc\-keep\-log\fP 4
.IX عنصر \-\-no\-warc\-keep\-log
عدم تخزين ملف السجل في سجل WARC.
.IP \fB\-\-warc\-tempdir=\fP\fIدليل\fP 4
.IX عنصر \-\-warc\-tempdir=دليل
حدد موقع الملفات المؤقتة التي ينشئها كاتب WARC.
.SS "خيارات FTP"
.IX "قسم فرعي" "خيارات FTP"
.IP \fB\-\-ftp\-user=\fP\fIمستخدم\fP 4
.IX عنصر \-\-ftp\-user=مستخدم
.PD 0
.IP \fB\-\-ftp\-password=\fP\fIكلمة_السر\fP 4
.IX عنصر \-\-ftp\-password=كلمة_السر
.PD
حدد اسم المستخدم \fIمستخدم\fP وكلمة السر \fIكلمة_السر\fP على خادم FTP. بدون هذا،
أو خيار التشغيل المقابل، تكون كلمة السر المبدئية هي \fB\-wget@\fP، والتي تُستخدم
عادةً لـ FTP المجهول.
.Sp
توجد طريقة أخرى لتحديد اسم المستخدم وكلمة السر وهي في عنوان URL نفسه. تُظهر
أي من الطريقتين كلمة السر الخاصة بك لأي شخص يكلف نفسه عناء تشغيل
\f(CW\*(C`ps\*(C'\fP. لمنع رؤية كلمات السر، خزنها في \fI.wgetrc\fP أو \fI.netrc\fP،
وتأكد من حماية تلك الملفات من المستخدمين الآخرين باستخدام
\f(CW\*(C`chmod\*(C'\fP. إذا كانت كلمات السر مهمة حقًا، فلا تتركها في تلك
الملفات أيضًا \-\-\- حرر الملفات واحذفها بعد أن يبدأ Wget التنزيل.
.IP \fB\-\-no\-remove\-listing\fP 4
.IX عنصر \-\-no\-remove\-listing
عدم إزالة ملفات \fI.listing\fP المؤقتة الناتجة عن عمليات جلب FTP. تحتوي هذه
الملفات عادةً على قوائم الدليل الخام المستلمة من خوادم FTP. قد يكون عدم
إزالتها مفيدًا لأغراض التنقِيح، أو عندما تريد أن تكون قادرًا على التحقق
بسهولة من محتويات أدلة الخادم البعيد (على سبيل المثال للتحقق من اكتمال
المرآة التي تشغلها).
.Sp
لاحظ أنه على الرغم من أن Wget يكتب في اسم ملف معروف لهذا الملف، إلا أن هذا
لا يشكل ثغرة أمنية في حالة قيام مستخدم بجعل \&\fI.listing\fP رابطًا رمزيًا لـ
\fI/etc/passwd\fP أو شيء من هذا القبيل وطلب من \f(CW\*(C`root\*(C'\fP تشغيل Wget في
دليله. اعتمادًا على الخيارات المستخدمة، فإما سيرفض Wget الكتابة في
\&\fI.listing\fP، مما يؤدي إلى فشل عملية التجميع/التكرار/ختم الوقت، أو سيُحذف
الرابط الرمزي ويُستبدل بملف \&\fI.listing\fP الفعلي، أو ستُكتب القائمة في ملف
\&\fI.listing.number\fP.
.Sp
وعلى الرغم من أن هذا الموقف لا يمثل مشكلة، إلا أنه لا ينبغي لـ
\f(CW\*(C`root\*(C'\fP أبدًا تشغيل Wget في دليل مستخدم غير موثوق به. يمكن
للمستخدم القيام بشيء بسيط مثل ربط \fIindex.html\fP بـ \fI/etc/passwd\fP وطلب من
\f(CW\*(C`root\*(C'\fP تشغيل Wget مع \fB\-N\fP أو \fB\-r\fP حتى يُكتب فوق الملف.
.IP \fB\-\-no\-glob\fP 4
.IX عنصر \-\-no\-glob
إيقاف تجميع (globbing) FTP. يشير التجميع إلى استخدام محارف خاصة شبيهة
بالصدفة (\fIwildcards\fP)، مثل \fB*\fP و \fB?\fP و \fB[\fP و \fB]\fP لجلب أكثر من ملف من
نفس الدليل في وقت واحد، مثل:
.Sp
.Vb 1
\& wget ftp://gnjilux.srk.fer.hr/*.msg
.Ve
.Sp
مبدئيًا، سيُفعّل التجميع إذا كان عنوان URL يحتوي على محرف تجميع. يمكن
استخدام هذا الخيار لتفعيل أو تعطيل التجميع بشكل دائم.
.Sp
قد تضطر إلى وضع عنوان URL بين علامتي اقتباس لحمايته من التوسع بواسطة
الصدفة. يجعل التجميع Wget يبحث عن قائمة الدليل، وهي خاصة بالنظام. لهذا السبب
يعمل حاليًا فقط مع خوادم يونكس FTP (وتلك التي تحاكي مخرجات يونكس
\f(CW\*(C`ls\*(C'\fP).
.IP \fB\-\-no\-passive\-ftp\fP 4
.IX عنصر \-\-no\-passive\-ftp
تعطيل استخدام وضع نقل FTP \fIالسلبي\fP. يتطلب FTP السلبي أن يتصل العميل بالخادم
لإنشاء اتصال البيانات بدلاً من العكس.
.Sp
إذا كان الجهاز متصلاً بالإنترنت مباشرة، فيجب أن يعمل كل من FTP السلبي والنشط
بشكل جيد على حد سواء. خلف معظم تكوينات الجدار الناري و NAT، يكون لـ FTP
السلبي فرصة أفضل للعمل. ومع ذلك، في بعض تكوينات الجدار الناري النادرة، يعمل
FTP النشط فعليًا عندما لا يعمل FTP السلبي. إذا كنت تشك في أن هذه هي الحالة،
فاستخدم هذا الخيار، أو اضبط \f(CW\*(C`passive_ftp=off\*(C'\fP في ملف التهيئة
الخاص بك.
.IP \fB\-\-preserve\-permissions\fP 4
.IX عنصر \-\-preserve\-permissions
الحفاظ على أذونات الملفات البعيدة بدلاً من الأذونات التي يضبطها umask.
.IP \fB\-\-retr\-symlinks\fP 4
.IX عنصر \-\-retr\-symlinks
مبدئيًا، عند جلب أدلة FTP بشكل متكرر ومصادفة رابط رمزي، يُجتاز الرابط الرمزي
وتُجلب الملفات التي يشير إليها. حاليًا، لا يجتاز Wget الروابط الرمزية للأدلة
لتنزيلها بشكل متكرر، على الرغم من أن هذه الميزة قد تُضاف في المستقبل.
.Sp
عند تحديد \fB\-\-retr\-symlinks=no\fP، لا يُنزل الملف المرتبط به. بدلاً من ذلك،
يُنشأ رابط رمزي مطابق على نظام الملفات المحلي. لن يُجلب الملف المشار إليه
إلا إذا واجهه هذا الجلب المتكرر بشكل منفصل وقام بتنزيله على أي حال. يشكل هذا
" "الخيار خطرًا أمنيًا حيث قد يتسبب خادم FTP خبيث في جعل Wget يكتب في ملفات
خارج الأدلة المقصودة من خلال ملف \&.LISTING مصمم خصيصًا.
.Sp
لاحظ أنه عند جلب ملف (ليس دليلاً) لأنه حُدد في سطر الأوامر، بدلاً من الوصول
إليه عبر التكرار، فلن يكون لهذا الخيار أي تأثير. تُجتاز الروابط الرمزية
دائمًا في هذه الحالة.
.SS "خيارات FTPS"
.IX "قسم فرعي" "خيارات FTPS"
.IP \fB\-\-ftps\-implicit\fP 4
.IX عنصر \-\-ftps\-implicit
يخبر هذا الخيار Wget باستخدام FTPS ضمنيًا. يتكون FTPS الضمني من تهيئة
SSL/TLS منذ بداية اتصال التحكم. لا يرسل هذا الخيار أمر \f(CW\*(C`AUTH TLS\*(C'\fP: إنه يفترض أن الخادم يتحدث FTPS ويبدأ اتصال SSL/TLS مباشرة. إذا
نجحت المحاولة، تستمر الجلسة تمامًا مثل FTPS العادي (يُرسل \f(CW\*(C`PBSZ\*(C'\fP
و \f(CW\*(C`PROT\*(C'\fP، وما إلى ذلك). لم يعد FTPS الضمني متطلبًا لتطبيقات
FTPS، وبالتالي قد لا تدعمه العديد من الخوادم. إذا مُرّر \fB\-\-ftps\-implicit\fP
ولم يُحدد رقم منفذ صريح، فسيُستخدم المنفذ المبدئي لـ FTPS الضمني، 990، بدلاً
من المنفذ المبدئي لـ FTPS "العادي" (الصريح) وهو نفس منفذ FTP، 21.
.IP \fB\-\-no\-ftps\-resume\-ssl\fP 4
.IX عنصر \-\-no\-ftps\-resume\-ssl
عدم استئناف جلسة SSL/TLS في قناة البيانات. عند بدء اتصال بيانات، يحاول Wget
استئناف جلسة SSL/TLS التي بدأت سابقًا في اتصال التحكم. يتجنب استئناف جلسة
SSL/TLS إجراء مصافحة جديدة تمامًا عن طريق إعادة استخدام معلمات SSL/TLS لجلسة
سابقة. عادةً ما تفضل خوادم FTPS ذلك، لذا يفعل Wget هذا مبدئيًا. ومع ذلك، في
ظروف نادرة، قد يرغب المرء في بدء جلسة SSL/TLS جديدة تمامًا في كل اتصال
بيانات. هذا هو الغرض من \fB\-\-no\-ftps\-resume\-ssl\fP.
.IP \fB\-\-ftps\-clear\-data\-connection\fP 4
.IX عنصر \-\-ftps\-clear\-data\-connection
ستكون جميع اتصالات البيانات بنص صرف. فقط اتصال التحكم سيكون تحت
SSL/TLS. سيرسل Wget أمر \f(CW\*(C`PROT C\*(C'\fP لتحقيق ذلك، والذي يجب أن يوافق
عليه الخادم.
.IP \fB\-\-ftps\-fallback\-to\-ftp\fP 4
.IX عنصر \-\-ftps\-fallback\-to\-ftp
التراجع إلى FTP إذا كان FTPS غير مدعوم من الخادم الهدف. لأسباب أمنية، لا
يُفعل هذا الخيار مبدئيًا. السلوك المبدئي هو الإنهاء مع خطأ. إذا لم يستجب
الخادم بنجاح لأمر \f(CW\*(C`AUTH TLS\*(C'\fP الأولي، أو في حالة FTPS الضمني، إذا
رُفضت محاولة اتصال SSL/TLS الأولية، يُعتبر أن هذا الخادم لا يدعم FTPS.
.SS "خيارات الجلب المتكرر"
.IX "قسم فرعي" "خيارات الجلب المتكرر"
.IP \fB\-r\fP 4
.IX عنصر \-r
.PD 0
.IP \fB\-\-recursive\fP 4
.IX عنصر \-\-recursive
.PD
شغل الجلب المتكرر. العمق الأقصى المبدئي هو 5.
.IP "\fB\-l\fP \fIالعمق\fP" 4
.IX عنصر "\-l العمق"
.PD 0
.IP \fB\-\-level=\fP\fIالعمق\fP 4
.IX عنصر \-\-level=العمق
.PD
اضبط الحد الأقصى لعدد المجلدات الفرعية التي سيتكرر Wget بداخلها إلى
\fIالعمق\fP. من أجل منع التحميل غير المقصود للمواقع الكبيرة جدًا عند استخدام
التكرار، حُدد هذا بعمق 5 مبدئيًا، أي أنه سيجتاز 5 أدلة بحد أقصى بدءًا من
المسار (URL) المقدم. اضبط \fB\-l 0\fP أو \fB\-l inf\fP لعمق تكرار غير محدود.
.Sp
.Vb 1
\& wget \-r \-l 0 http://<الموقع>/1.html
.Ve
.Sp
مثاليًا، قد يتوقع المرء أن يحمل هذا \fI1.html\fP فقط، ولكن لسوء الحظ ليس هذا هو
الحال، لأن \fB\-l 0\fP يكافئ \&\fB\-l inf\fP\-\-\-أي تكرار غير محدود. لتحميل صفحة HTML
واحدة (أو بضعة منها)، حددها جميعًا في سطر الأوامر واترك \fB\-r\fP و
\fB\-l\fP. لتحميل العناصر الضرورية لعرض صفحة HTML واحدة، انظر \fBpage requisites\fP.
.IP \fB\-\-delete\-after\fP 4
.IX عنصر \-\-delete\-after
يخبر هذا الخيار Wget بحذف كل ملف يحمله، \&\fIبعد\fP القيام بذلك. إنه مفيد للجلب
المسبق للصفحات الشائعة عبر الوكيل، مثلًا:
.Sp
.Vb 1
\& wget \-r \-nd \-\-delete\-after http://whatever.com/~popular/page/
.Ve
.Sp
الخيار \fB\-r\fP مخصص للجلب تكراريًا، و \fB\-nd\fP لعدم إنشاء مجلدات.
.Sp
لاحظ أن \fB\-\-delete\-after\fP يحذف الملفات على الجهاز المحلي. ولا يصدر أمر
\fBDELE\fP لمواقع FTP البعيدة، على سبيل المثال. لاحظ أيضًا أنه عند تحديد
\fB\-\-delete\-after\fP، يُتجاهل \&\fB\-\-convert\-links\fP، لذا لا تُنشأ ملفات \fB.orig\fP
في المقام الأول.
.IP \fB\-k\fP 4
.IX عنصر \-k
.PD 0
.IP \fB\-\-convert\-links\fP 4
.IX عنصر \-\-convert\-links
.PD
بعد اكتمال التحميل، حوّل الروابط في المستند لتجعلها مناسبة للعرض
المحلي. يؤثر هذا ليس فقط على الروابط التشعبية المرئية، بل على أي جزء من
المستند يرتبط بمحتوى خارجي، مثل الصور المضمنة، وروابط أوراق الأنماط،
والروابط التشعبية للمحتوى غير التابع لـ HTML، إلخ.
.Sp
سيتغير كل رابط بإحدى طريقتين:
.RS 4
.IP \(bu 4
سوف تُغير الروابط المؤدية إلى ملفات حُملت بواسطة Wget لتشير إلى الملف الذي
تشير إليه كرابط نسبي.
.Sp
مثال: إذا كان الملف المحمل \fI/foo/doc.html\fP يشير إلى \&\fI/bar/img.gif\fP، وهو
محمل أيضًا، فسيُعدل الرابط في \fIdoc.html\fP ليشير إلى \fB../bar/img.gif\fP. هذا
النوع من التحويل يعمل بموثوقية لتركيبات المجلدات العشوائية.
.IP \(bu 4
ستُغير الروابط المؤدية إلى ملفات لم تُحمل بواسطة Wget لتشمل اسم المضيف
والمسار المطلق للموقع الذي تشير إليه.
.Sp
مثال: إذا كان الملف المحمل \fI/foo/doc.html\fP يشير إلى \&\fI/bar/img.gif\fP (أو
إلى \fI../bar/img.gif\fP)، فسيُعدل الرابط في \&\fIdoc.html\fP ليشير إلى
\&\fIhttp://hostname/bar/img.gif\fP.
.RE
.RS 4
.Sp
بسبب هذا، يعمل التصفح المحلي بموثوقية: إذا حُمل ملف مرتبط، فسيشير الرابط إلى
اسمه المحلي؛ وإذا لم يُحمل، فسيشير الرابط إلى عنوانه الكامل على الإنترنت
بدلًا من تقديم رابط معطل. حقيقة أن الروابط السابقة حُولت إلى روابط نسبية
تضمن إمكانية نقل الهيكل المحمل إلى مجلد آخر.
.Sp
لاحظ أن Wget لا يعرف الروابط التي حُملت إلا في نهاية التحميل فقط. لهذا
السبب، سيُنفذ العمل الذي يقوم به \fB\-k\fP في نهاية جميع التحميلات.
.RE
.IP \fB\-\-convert\-file\-only\fP 4
.IX عنصر \-\-convert\-file\-only
يحول هذا الخيار جزء اسم الملف فقط من العناوين (URLs)، تاركًا بقية العناوين
دون تغيير. يُشار أحيانًا إلى جزء اسم الملف هذا باسم "الاسم الأساسي"، رغم
أننا نتجنب هذا المصطلح هنا لعدم التسبب في ارتباك.
.Sp
يعمل بشكل جيد خاصة بالاقتران مع \fB\-\-adjust\-extension\fP، رغم أن هذا الاقتران
غير مفروض. يثبت فائدته لملء خبيئات الإنترنت بملفات حُملت من مضيفين مختلفين.
.Sp
مثال: إذا كان هناك رابط يشير إلى \fI//foo.com/bar.cgi?xyz\fP مع تفعيل
\&\fB\-\-adjust\-extension\fP وكانت وجهته المحلية من المفترض أن تكون
\&\fI./foo.com/bar.cgi?xyz.css\fP، فسيُحول الرابط إلى
\&\fI//foo.com/bar.cgi?xyz.css\fP. لاحظ أنه عُدل جزء اسم الملف فقط. تُرك بقية
العنوان دون تغيير، بما في ذلك مسار الشبكة (\f(CW\*(C`//\*(C'\fP) الذي كان
سيُعالج لولا ذلك بواسطة Wget ويُحول إلى المخطط الفعلي (أي
\f(CW\*(C`http://\*(C'\fP).
.IP \fB\-K\fP 4
.IX عنصر \-K
.PD 0
.IP \fB\-\-backup\-converted\fP 4
.IX عنصر \-\-backup\-converted
.PD
عند تحويل ملف، انسخ النسخة الأصلية احتياطيًا مع اللاحقة \fB.orig\fP. يؤثر على
سلوك \fB\-N\fP.
.IP \fB\-m\fP 4
.IX عنصر \-m
.PD 0
.IP \fB\-\-mirror\fP 4
.IX عنصر \-\-mirror
.PD
شغل الخيارات المناسبة للمرآة. يشغل هذا الخيار التكرار والختم الزمني، ويضبط
عمق تكرار غير محدود ويحتفظ بقوائم مجلدات FTP. يعادل حاليًا \&\fB\-r \-N \-l inf \-\-no\-remove\-listing\fP.
.IP \fB\-p\fP 4
.IX عنصر \-p
.PD 0
.IP \fB\-\-page\-requisites\fP 4
.IX عنصر \-\-page\-requisites
.PD
يتسبب هذا الخيار في قيام Wget بتحميل جميع الملفات الضرورية لعرض صفحة HTML
معينة بشكل صحيح. ويشمل ذلك أشياء مثل الصور المضمنة، والأصوات، وأوراق الأنماط
المشار إليها.
.Sp
عادةً، عند تحميل صفحة HTML واحدة، لا تُحمل أي مستندات ضرورية قد تكون مطلوبة
لعرضها بشكل صحيح. استخدام \&\fB\-r\fP مع \fB\-l\fP يمكن أن يساعد، ولكن بما أن Wget
لا يميز عادةً بين المستندات الخارجية والمضمنة، فغالبًا ما يُترك المرء مع
"مستندات ورقية" تفتقر إلى متطلباتها.
.Sp
على سبيل المثال، لنفترض أن المستند \fI1.html\fP يحتوي على وسم
\f(CW\*(C`\*(C'\fP يشير إلى \fI1.gif\fP ووسم \f(CW\*(C`\*(C'\fP
يشير إلى المستند الخارجي \fI2.html\fP. ولنفترض أن \fI2.html\fP مماثل ولكن صورته هي
\fI2.gif\fP ويرتبط بـ \fI3.html\fP. لنفترض أن هذا يستمر حتى رقم مرتفع بشكل عشوائي.
.Sp
إذا نُفذ الأمر:
.Sp
.Vb 1
\& wget \-r \-l 2 http://<الموقع>/1.html
.Ve
.Sp
فسوف تُحمل \fI1.html\fP، و \fI1.gif\fP، و \fI2.html\fP، و \fI2.gif\fP، و
\&\fI3.html\fP. كما ترى، \fI3.html\fP بدون متطلبه \fI3.gif\fP لأن Wget يقوم ببساطة
بعد عدد القفزات (حتى 2) بعيدًا عن \fI1.html\fP لتحديد أين يتوقف التكرار. ومع
ذلك، باستخدام هذا الأمر:
.Sp
.Vb 1
\& wget \-r \-l 2 \-p http://<الموقع>/1.html
.Ve
.Sp
جميع الملفات المذكورة أعلاه \fIو\fP متطلب \fI3.html\fP وهو \fI3.gif\fP سوف
تُحمل. وبالمثل،
.Sp
.Vb 1
\& wget \-r \-l 1 \-p http://<الموقع>/1.html
.Ve
.Sp
سيتسبب في تحميل \fI1.html\fP، و \fI1.gif\fP، و \fI2.html\fP، و \fI2.gif\fP. قد يعتقد
المرء أن:
.Sp
.Vb 1
\& wget \-r \-l 0 \-p http://<الموقع>/1.html
.Ve
.Sp
سيحمل فقط \fI1.html\fP و \fI1.gif\fP، ولكن لسوء الحظ ليس هذا هو الحال، لأن \fB\-l 0\fP
يكافئ \&\fB\-l inf\fP\-\-\-أي تكرار غير محدود. لتحميل صفحة HTML واحدة (أو بضعة
منها، جميعها محددة في سطر الأوامر أو في ملف مدخلات عناوين \&\fB\-i\fP)
ومتطلباتها، اترك ببساطة \&\fB\-r\fP و \fB\-l\fP:
.Sp
.Vb 1
\& wget \-p http://<الموقع>/1.html
.Ve
.Sp
لاحظ أن Wget سيتصرف كما لو حُدد \fB\-r\fP، ولكن سيُحمل فقط تلك الصفحة الواحدة
ومتطلباتها. لن تُتبع الروابط من تلك الصفحة إلى مستندات خارجية. في الواقع،
لتحميل صفحة واحدة وجميع متطلباتها (حتى لو كانت موجودة على مواقع ويب منفصلة)،
وللتأكد من عرض المجموعة بشكل صحيح محليًا، يفضل هذا المؤلف استخدام بضعة
خيارات بالإضافة إلى \fB\-p\fP:
.Sp
.Vb 1
\& wget \-E \-H \-k \-K \-p http://<الموقع>/<المستند>
.Ve
.Sp
لإنهاء هذا الموضوع، يجدر معرفة أن فكرة Wget عن رابط مستند خارجي هي أي عنوان
(URL) محدد في وسم \f(CW\*(C`\*(C'\fP، أو وسم
\&\f(CW\*(C`\*(C'\fP، أو وسم \f(CW\*(C`\*(C'\fP بخلاف
\f(CW\*(C`\*(C'\fP.
.IP \fB\-\-strict\-comments\fP 4
.IX عنصر \-\-strict\-comments
شغل التحليل الصارم لتعليقات HTML. السلوك المبدئي هو إنهاء التعليقات عند أول
ظهور لـ \fB\-\->\fP.
.Sp
وفقًا للمواصفات، تُعبر تعليقات HTML كـ \&\fIإعلانات\fP SGML. الإعلان هو وسم خاص
يبدأ بـ \&\fB\fP، مثل \fB\fP، والذي
قد يحتوي على تعليقات بين زوج من محددات \fB\-\-\fP. تعليقات HTML هي "إعلانات
فارغة"، إعلانات SGML بدون أي نص غير تعليقي. لذلك، \fB\fP هو
تعليق صالح، وكذلك \fB\fP، ولكن \fB\fP
ليس كذلك.
.Sp
من ناحية أخرى، معظم كتاب HTML لا ينظرون للتعليقات كأي شيء آخر سوى نص محدد بـ
\fB\fP، وهو ليس تمامًا نفس الشيء. على سبيل المثال، شيء مثل
\fB\fP يعمل كتعليق صالح طالما أن عدد الشرطات هو مضاعف
للأربعة (!). وإذا لم يكن كذلك، فإن التعليق تقنيًا يستمر حتى \&\fB\-\-\fP التالية،
والتي قد تكون في الطرف الآخر من المستند. وبسبب هذا، فإن العديد من المتصفحات
الشائعة تتجاهل المواصفات تمامًا وتنفذ ما يتوقعه المستخدمون: تعليقات محددة بـ
\&\fB\fP.
.Sp
حتى الإصدار 1.9، كان Wget يفسر التعليقات بصرامة، مما أدى إلى فقدان روابط في
العديد من صفحات الويب التي كانت تُعرض بشكل جيد في المتصفحات، ولكن لسوء حظها
احتوت على تعليقات غير متوافقة. بدءًا من الإصدار 1.9، انضم Wget إلى صفوف
العملاء الذين ينفذون التعليقات "البسيطة"، منهيًا كل تعليق عند أول ظهور لـ
\&\fB\-\->\fP.
.Sp
إذا كنت تريد، لأي سبب كان، تحليلًا صارمًا للتعليقات، فاستخدم هذا الخيار
لتشغيله.
.SS "خيارات القبول/الرفض المتكرر"
.IX "قسم فرعي" "خيارات القبول/الرفض المتكرر"
.IP "\fB\-A\fP \fIقائمة_القبول\fP \fB\-\-accept\fP \fIقائمة_القبول\fP" 4
.IX عنصر "\-A قائمة_القبول \-\-accept قائمة_القبول"
.PD 0
.IP "\fB\-R\fP \fIقائمة_الرفض\fP \fB\-\-reject\fP \fIقائمة_الرفض\fP" 4
.IX عنصر "\-R قائمة_الرفض \-\-reject قائمة_الرفض"
.PD
حدد قوائم مفصولة بفواصل من لاحقات أسماء الملفات أو الأنماط لقبولها أو
رفضها. لاحظ أنه إذا ظهرت أي من أحرف البدل، \fB*\fP، أو \fB?\fP، أو \fB[\fP، أو
\&\fB]\fP، في عنصر من \fIقائمة_القبول\fP أو \fIقائمة_الرفض\fP، فسيُعامل كنمط وليس
كلاحقة. في هذه الحالة، يجب عليك إحاطة النمط بعلامات اقتباس لمنع الصدفة من
توسيعه، مثل \fB\-A "*.mp3"\fP أو \fB\-A \*(Aq*.mp3\*(Aq\fP.
.IP "\fB\-\-accept\-regex\fP \fIتعبير_نمطي_للعنوان\fP" 4
.IX عنصر "\-\-accept\-regex تعبير_نمطي_للعنوان"
.PD 0
.IP "\fB\-\-reject\-regex\fP \fIتعبير_نمطي_للعنوان\fP" 4
.IX عنصر "\-\-reject\-regex تعبير_نمطي_للعنوان"
.PD
حدد تعبيرًا نمطيًا لقبول أو رفض العنوان (URL) الكامل.
.IP "\fB\-\-regex\-type\fP \fIنوع_التعبير_النمطي\fP" 4
.IX عنصر "\-\-regex\-type نوع_التعبير_النمطي"
حدد نوع التعبير النمطي. الأنواع الممكنة هي \fBposix\fP أو \&\fBpcre\fP. لاحظ أنه
لتتمكن من استخدام النوع \fBpcre\fP، يجب أن يكون wget قد جُمع مع دعم libpcre.
.IP "\fB\-D\fP \fIقائمة_النطاقات\fP" 4
.IX عنصر "\-D قائمة_النطاقات"
.PD 0
.IP \fB\-\-domains=\fP\fIقائمة_النطاقات\fP 4
.IX عنصر \-\-domains=قائمة_النطاقات
.PD
اضبط النطاقات التي ستُتبع. \fIقائمة_النطاقات\fP هي قائمة من النطاقات مفصولة
بفواصل. لاحظ أن هذا لا يشغل \fB\-H\fP.
.IP "\fB\-\-exclude\-domains\fP \fIقائمة_النطاقات\fP" 4
.IX عنصر "\-\-exclude\-domains قائمة_النطاقات"
حدد النطاقات التي \fIلا\fP ينبغي اتباعها.
.IP \fB\-\-follow\-ftp\fP 4
.IX عنصر \-\-follow\-ftp
اتبع روابط FTP من مستندات HTML. بدون هذا الخيار، سيتجاهل Wget جميع روابط
FTP.
.IP \fB\-\-follow\-tags=\fP\fIقائمة\fP 4
.IX عنصر \-\-follow\-tags=قائمة
يمتلك Wget جدولًا داخليًا لأزواج (وسم HTML / سمة) التي يأخذها في الاعتبار
عند البحث عن المستندات المرتبطة أثناء الجلب المتكرر. وإذا أراد المستخدم
مراعاة مجموعة فرعية فقط من تلك الوسوم، فيجب عليه تحديد هذه الوسوم في
\fIقائمة\fP مفصولة بفواصل مع هذا الخيار.
.IP \fB\-\-ignore\-tags=\fP\fIقائمة\fP 4
.IX عنصر \-\-ignore\-tags=قائمة
هذا هو عكس الخيار \fB\-\-follow\-tags\fP. لتخطي وسوم HTML معينة عند البحث تكراريًا
عن مستندات لتحميلها، حددها في \fIقائمة\fP مفصولة بفواصل.
.Sp
في الماضي، كان هذا الخيار هو الرهان الأفضل لتحميل صفحة واحدة ومتطلباتها،
باستخدام سطر أوامر مثل:
.Sp
.Vb 1
\& wget \-\-ignore\-tags=a,area \-H \-k \-K \-r http://<الموقع>/<المستند>
.Ve
.Sp
ومع ذلك، صادف مؤلف هذا الخيار صفحة بها وسوم مثل \&\f(CW\*(C`\*(C'\fP وأدرك أن تحديد الوسوم لتجاهلها لم يكن
كافيًا. لا يمكن للمرء ببساطة إخبار Wget بتجاهل \f(CW\*(C`\*(C'\fP،
لأن أوراق الأنماط لن تُحمل حينها. الآن الرهان الأفضل لتحميل صفحة واحدة
ومتطلباتها هو خيار \fB\-\-page\-requisites\fP المخصص.
.IP \fB\-\-ignore\-case\fP 4
.IX عنصر \-\-ignore\-case
تجاهل حالة الأحرف عند مطابقة الملفات والمجلدات. يؤثر هذا على سلوك الخيارات
\-R و \-A و \-I و \-X، بالإضافة إلى تطبيق الأنماط عند التحميل من مواقع FTP. على
سبيل المثال، مع هذا الخيار، \fB\-A "*.txt"\fP سيطابق \fBfile1.txt\fP، وأيضًا
\&\fBfile2.TXT\fP، و \fBfile3.TxT\fP، وهكذا. علامات الاقتباس في المثال لمنع الصدفة
من توسيع النمط.
.IP \fB\-H\fP 4
.IX عنصر \-H
.PD 0
.IP \fB\-\-span\-hosts\fP 4
.IX عنصر \-\-span\-hosts
.PD
تمكين التجاوز عبر المضيفين عند إجراء الجلب المتكرر.
.IP \fB\-L\fP 4
.IX عنصر \-L
.PD 0
.IP \fB\-\-relative\fP 4
.IX عنصر \-\-relative
.PD
اتبع الروابط النسبية فقط. مفيد لجلب صفحة رئيسة محددة دون أي مشتتات، ولا حتى
تلك الموجودة على نفس المضيفين.
.IP "\fB\-I\fP \fIقائمة\fP" 4
.IX عنصر "\-I قائمة"
.PD 0
.IP \fB\-\-include\-directories=\fP\fIقائمة\fP 4
.IX عنصر \-\-include\-directories=قائمة
.PD
حدد قائمة مفصولة بفواصل للمجلدات التي ترغب في اتباعها عند التحميل. قد تحتوي
عناصر \fIالقائمة\fP على أحرف بدل.
.IP "\fB\-X\fP \fIقائمة\fP" 4
.IX عنصر "\-X قائمة"
.PD 0
.IP \fB\-\-exclude\-directories=\fP\fIقائمة\fP 4
.IX عنصر \-\-exclude\-directories=قائمة
.PD
حدد قائمة مفصولة بفواصل للمجلدات التي ترغب في استبعادها من التحميل. قد تحتوي
عناصر \&\fIالقائمة\fP على أحرف بدل.
.IP \fB\-np\fP 4
.IX عنصر \-np
.PD 0
.IP \fB\-\-no\-parent\fP 4
.IX عنصر \-\-no\-parent
.PD
لا تصعد أبدًا إلى المجلد الأب عند الجلب تكراريًا. هذا خيار مفيد، لأنه يضمن
تحميل الملفات الموجودة \&\fIأسفل\fP تسلسل هرمي معين فقط.
.SH البيئة
.IX ترويسة البيئة
يدعم Wget الوكلاء لعمليات جلب HTTP و FTP. الطريقة القياسية لتحديد موقع
الوكيل، والتي يتعرف عليها Wget، هي استخدام متغيرات البيئة التالية:
.IP \fBhttp_proxy\fP 4
.IX عنصر http_proxy
.PD 0
.IP \fBhttps_proxy\fP 4
.IX عنصر https_proxy
.PD
إذا ضُبطت، فيجب أن تحتوي متغيرات \fBhttp_proxy\fP و \fBhttps_proxy\fP على عناوين
(URLs) الوكلاء لاتصالات HTTP و HTTPS على التوالي.
.IP \fBftp_proxy\fP 4
.IX عنصر ftp_proxy
يجب أن يحتوي هذا المتغير على عنوان الوكيل لاتصالات FTP. من الشائع جدًا ضبط
\&\fBhttp_proxy\fP و \fBftp_proxy\fP على نفس العنوان.
.IP \fBno_proxy\fP 4
.IX عنصر no_proxy
يجب أن يحتوي هذا المتغير على قائمة مفصولة بفواصل لامتدادات النطاقات التي
\fIلا\fP ينبغي استخدام الوكيل لها. على سبيل المثال، إذا كانت قيمة \&\fBno_proxy\fP
هي \fB.mit.edu\fP، فلن يُستخدم الوكيل لجلب مستندات من MIT.
.SH "حالة الخروج"
.IX ترويسة "حالة الخروج"
قد يعيد Wget أحد رموز الخطأ المتعددة إذا واجه مشكلات.
.ie n .IP 0 4
.el .IP \f(CW0\fR 4
.IX عنصر 0
لم تحدث أي مشكلات.
.ie n .IP 1 4
.el .IP \f(CW1\fR 4
.IX عنصر 1
رمز خطأ عام.
.ie n .IP 2 4
.el .IP \f(CW2\fR 4
.IX عنصر 2
خطأ في التحليل\-\-\-على سبيل المثال، عند تحليل خيارات سطر الأوامر، أو
\&\fB.wgetrc\fP أو \fB.netrc\fP...
.ie n .IP 3 4
.el .IP \f(CW3\fR 4
.IX عنصر 3
خطأ في إدخال/إخراج الملف.
.ie n .IP 4 4
.el .IP \f(CW4\fR 4
.IX عنصر 4
فشل في الشبكة.
.ie n .IP 5 4
.el .IP \f(CW5\fR 4
.IX عنصر 5
فشل في الاستيثاق من SSL.
.ie n .IP 6 4
.el .IP \f(CW6\fR 4
.IX عنصر 6
فشل في استيثاق اسم المستخدم/كلمة المرور.
.ie n .IP 7 4
.el .IP \f(CW7\fR 4
.IX عنصر 7
أخطاء في البروتوكول.
.ie n .IP 8 4
.el .IP \f(CW8\fR 4
.IX عنصر 8
أصدر الخادم استجابة خطأ.
.PP
باستثناء 0 و 1، فإن رموز الخروج ذات الأرقام الأقل لها الأولوية على تلك ذات
الأرقام الأعلى، عند مواجهة أنواع متعددة من الأخطاء.
.PP
في إصدارات Wget قبل 1.12، كانت حالة خروج Wget تميل إلى أن تكون غير مفيدة
وغير متسقة. التحميلات المتكررة كانت دائمًا تقريبًا تعيد 0 (نجاح)، بغض النظر
عن أي مشكلات وُجهت، وعمليات الجلب غير المتكررة كانت تعيد فقط الحالة المقابلة
لأحدث محاولة تحميل.
.SH الملفات
.IX ترويسة الملفات
.IP \fB/usr/local/etc/wgetrc\fP 4
.IX عنصر /usr/local/etc/wgetrc
الموقع المبدئي لملف التشغيل \fIالعالمي\fP.
.IP \fB.wgetrc\fP 4
.IX عنصر .wgetrc
ملف تشغيل المستخدم.
.SH العلل
.IX ترويسة العلل
نرحب بتقديم تقارير الأخطاء عبر متعقب أخطاء GNU Wget (انظر
<\fBhttps://savannah.gnu.org/bugs/?func=additem&group=wget\fP>) أو إلى
قائمتنا البريدية <\fBbug\-wget@gnu.org\fP>.
.PP
زر <\fBhttps://lists.gnu.org/mailman/listinfo/bug\-wget\fP> للحصول على
مزيد من المعلومات (كيفية الاشتراك، أرشيف القائمة، ...).
.PP
قبل إرسال تقرير عن علة بالفعل، يرجى محاولة اتباع بعض الإرشادات البسيطة.
.IP 1. 4
يرجى محاولة التأكد من أن السلوك الذي تراه هو علة بالفعل. إذا انهار وجت
(Wget)، فهذه علة. وإذا لم يعمل وجت كما هو موثق، فهذه علة. وإذا كانت الأمور
تعمل بغرابة، ولكنك لست متأكدًا من الطريقة التي يُفترض أن تعمل بها، فقد تكون
علة بالفعل، ولكن قد ترغب في مراجعة التوثيق والقوائم البريدية.
.IP 2. 4
حاول تكرار العلة في أبسط ظروف ممكنة. على سبيل المثال، إذا انهار وجت أثناء
التنزيل باستخدام \fBwget \-rl0 \-kKE \-t5 \-\-no\-proxy http://example.com \-o /tmp/log\fP، فيجب أن تحاول معرفة ما إذا كان الانهيار قابلًا للتكرار، وما إذا
كان سيحدث مع مجموعة أبسط من الخيارات. قد تحاول أيضًا بدء التنزيل من الصفحة
التي حدث فيها الانهيار لمعرفة ما إذا كانت تلك الصفحة قد تسببت في الانهيار
بشكل ما.
.Sp
أيضًا، بينما سأكون مهتمًا على الأرجح بمعرفة محتويات ملف \fI.wgetrc\fP الخاص بك،
إلا أن مجرد إدراجه بالكامل في رسالة التنقيح ربما يكون فكرة سيئة. بدلًا من
ذلك، يجب عليك أولًا محاولة معرفة ما إذا كانت العلة تتكرر مع نقل \fI.wgetrc\fP
بعيدًا. فقط إذا اتضح أن إعدادات \fI.wgetrc\fP تؤثر على العلة، فأرسل لي الأجزاء
ذات الصلة من الملف.
.IP 3. 4
يرجى بدء وجت بالخيار \fB\-d\fP وإرسال المخرجات الناتجة (أو الأجزاء ذات الصلة
منها). إذا وُزّع وجت بدون دعم التنقيح، فأعد تجميعه\-\-\-فمن الأسهل بكثير تتبع
العلل مع تفعيل دعم التنقيح.
.Sp
ملاحظة: يرجى التأكد من إزالة أي معلومات حساسة محتملة من سجل التنقيح قبل
إرساله إلى عنوان البلاغ عن العلل. الخيار \f(CW\*(C`\-d\*(C'\fP لن يسعى لجمع
معلومات حساسة، ولكن السجل سيحتوي على نسخة كاملة تقريبًا لتواصل وجت مع
الخادم، والذي قد يشمل كلمات المرور وأجزاءً من البيانات المنزلة. وبما أن
عنوان البلاغ عن العلل مؤرشف علنًا، فيمكنك افتراض أن جميع تقارير العلل مرئية
للعامة.
.IP 4. 4
إذا انهار وجت، فحاول تشغيله في منقح، مثل \f(CW\*(C`gdb \`which wget\` core\*(C'\fP واكتب \f(CW\*(C`where\*(C'\fP للحصول على تتبع خلفي. قد لا يعمل هذا
إذا كان مدير النظام قد عطل ملفات الـ core، ولكن من الآمن تجربته.
.SH "انظر أيضًا"
.IX ترويسة "انظر أيضًا"
هذا \fBليس\fP الدليل الكامل لـ GNU Wget. لمزيد من المعلومات الكاملة، بما في ذلك
شروحات أكثر تفصيلًا لبعض الخيارات، وعدد من الأوامر المتاحة للاستخدام مع
ملفات \fI.wgetrc\fP والخيار \fB\-e\fP، راجع مدخل GNU Info لـ \fIwget\fP.
.PP
انظر أيضًا \fBwget2\fP\|(1)، وهي النسخة المحدثة من GNU Wget مع دعم أفضل للتنزيل
المتكرر والبروتوكولات الحديثة مثل HTTP/2.
.SH المؤلف
.IX ترويسة المؤلف
كُتب في الأصل بواسطة Hrvoje Nikšić . ويقوم
بصيانته حاليًا كل من Darshit Shah و Tim Rühsen
.
.SH "حقوق النسخ"
.IX ترويسة "حقوق النسخ"
حقوق النشر (c) 1996\-\-2011, 2015, 2018\-\-2024 لمؤسسة البرمجيات الحرة،
المحدودة.
.PP
يُمنح الإذن بنسخ وتوزيع و/أو تعديل هذا المستند بموجب شروط رخصة جنو للوثائق
الحرة (GNU Free Documentation License)، الإصدار 1.3 أو أي إصدار لاحق تنشره
مؤسسة البرمجيات الحرة؛ مع عدم وجود أقسام ثابتة، وبدون نصوص غلاف أمامي، وبدون
نصوص غلاف خلفي. نُسخة من الرخصة مضمنة في القسم المعنون "GNU Free
Documentation License".
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .