curl - عبر الإنترنت في السحابة

برنامج:

اسم

curl - نقل عنوان URL

موجز

حليقة [خيارات] [URL ...]

الوصف

حليقة هي أداة لنقل البيانات من أو إلى خادم ، باستخدام أحد البروتوكولات المدعومة
(DICT ، FILE ، FTP ، FTPS ، GOPHER ، HTTP ، HTTPS ، IMAP ، IMAPS ، LDAP ، LDAPS ، POP3 ، POP3S ، RTMP ،
RTSP و SCP و SFTP و SMB و SMBS و SMTP و SMTPS و TELNET و TFTP). الأمر مصمم للعمل
بدون تدخل المستخدم.

يقدم curl عددًا كبيرًا من الحيل المفيدة مثل دعم الوكيل ومصادقة المستخدم و FTP
تحميل ، نشر HTTP ، اتصالات SSL ، ملفات تعريف الارتباط ، استئناف نقل الملفات ، Metalink ، والمزيد. كما
سترى أدناه ، عدد الميزات سيجعل رأسك تدور!

curl مدعوم من libcurl لجميع الميزات المتعلقة بالنقل. ارى libcurl3 للتفاصيل.

URL

يعتمد بناء جملة URL على البروتوكول. ستجد وصفًا مفصلاً في RFC 3986.

يمكنك تحديد عدة عناوين URL أو أجزاء من عناوين URL عن طريق كتابة مجموعات أجزاء داخل أقواس كما في:

http://site. {واحد، اثنان، ثلاثة}. com

أو يمكنك الحصول على تسلسلات من سلسلة أبجدية رقمية باستخدام [] كما في:

ftp: //ftp.numericals.com/file[1-100] .txt

ftp: //ftp.numericals.com/file[001-100] .txt (بأصفار بادئة)

ftp: //ftp.letters.com/file[az] .txt

التسلسلات المتداخلة غير مدعومة ، ولكن يمكنك استخدام عدة تسلسلات بجوار بعضها البعض:

http://any.org/archive[1996-1999] / vol [1-4] / part {a، b، c} .html

يمكنك تحديد أي مقدار من عناوين URL في سطر الأوامر. سيتم جلبهم في ملف
بطريقة متسلسلة بالترتيب المحدد.

يمكنك تحديد عداد خطوات للنطاقات للحصول على كل رقم أو حرف N:

http://www.numericals.com/file[1-100: 10] .txt

http://www.letters.com/file[az: 2] .txt

عند استخدام التسلسلات [] أو {} عند استدعاءها من موجه سطر الأوامر ، فمن المحتمل أن يكون لديك
لوضع عنوان URL الكامل بين علامتي اقتباس لتجنب تداخل الغلاف معه. هذه
ينطبق أيضًا على الأحرف الأخرى التي يتم التعامل معها بشكل خاص ، على سبيل المثال "&" ، "؟" و '*'.

قم بتوفير فهرس منطقة IPv6 في عنوان URL بعلامة النسبة المئوية للهروب والواجهة
اسم. كما هو الحال في

http://[fe80::3%25eth0]/

إذا قمت بتحديد عنوان URL بدون بروتوكول: // بادئة ، فسيحاول curl تخمين البروتوكول
قد ترغب. سيتم بعد ذلك افتراضيًا استخدام HTTP ولكن جرب بروتوكولات أخرى تستند إلى الاستخدام المتكرر
بادئات اسم المضيف. على سبيل المثال ، لأسماء المضيف التي تبدأ بـ "ftp." سوف يفترضك حليقة
تريد التحدث FTP.

سيبذل curl قصارى جهده لاستخدام ما تقوم بتمريره إليه كعنوان URL. إنها لا تحاول التحقق من صحتها
كعنوان URL صحيح نحويًا بأي وسيلة ولكن بدلاً من ذلك جدا الليبرالية مع ما
يقبل.

سيحاول curl إعادة استخدام الاتصالات لعمليات نقل ملفات متعددة ، بحيث يتم الحصول على العديد من ملفات
لن تقوم الملفات من نفس الخادم بإجراء اتصالات / مصافحة متعددة. هذا يحسن
سرعة. بالطبع يتم ذلك فقط على الملفات المحددة في سطر أوامر واحد ولا يمكن ذلك
يمكن استخدامها بين دعوات الضفيرة المنفصلة.

التقدم متر

يعرض curl عادةً مقياس التقدم أثناء العمليات ، مما يشير إلى مقدار
نقل البيانات وسرعات النقل والوقت المقدر المتبقي ، إلخ.

يعرض curl هذه البيانات إلى الجهاز بشكل افتراضي ، لذلك إذا قمت باستدعاء curl لعمل ملف
العملية وهي على وشك كتابة البيانات إلى المحطة تعطيل مقياس التقدم مثل
وإلا فإنه سوف يعبث بمقياس تقدم خلط الإخراج وبيانات الاستجابة.

إذا كنت تريد مقياس تقدم لطلبات HTTP POST أو PUT ، فأنت بحاجة إلى إعادة توجيه ملف
استجابة الإخراج إلى ملف ، باستخدام إعادة توجيه shell (>) ، -o [ملف] أو ما شابه.

ليس الأمر نفسه بالنسبة لتحميل FTP لأن هذه العملية لا تصدر أي استجابة
البيانات إلى المحطة.

إذا كنت تفضل "شريط" تقدم بدلاً من العداد العادي ، -# هو صديقك

OPTIONS

تبدأ الخيارات بشرطة واحدة أو شرطتين. تتطلب العديد من الخيارات قيمة إضافية بعد ذلك
لهم.

يمكن استخدام نموذج "شرطة مفردة" القصير للخيارات ، على سبيل المثال ، مع أو بدون علامة
المسافة بينه وبين قيمته ، على الرغم من أن المسافة هي فاصل موصى به. الطويل
نموذج "الشرطة المزدوجة" - البيانات على سبيل المثال ، يتطلب مسافة بينه وبين قيمته.

يمكن استخدام خيارات الإصدار القصير التي لا تحتاج إلى أي قيم إضافية على الفور بعد ذلك
لبعضهم البعض ، على سبيل المثال ، يمكنك تحديد جميع الخيارات -O و -L و -v مرة واحدة
-OLv.

بشكل عام ، يتم تمكين جميع الخيارات المنطقية باستخدام -خيار ومرة أخرى معطل مع
--الجوىاختيار. أي أنك تستخدم نفس اسم الخيار بالضبط ولكن تسبقه بـ "no-".
ومع ذلك ، في هذه القائمة ، نقوم في الغالب بإدراج وعرض نسخة الخيار منهم. (هذه
المفهوم مع - لم تتم إضافة خيارات في 7.19.0. في السابق تم تبديل تشغيل / إيقاف تشغيل معظم الخيارات
عند الاستخدام المتكرر لنفس خيار سطر الأوامر.)

-#، --شريط التقدم
اجعل عرض الضفيرة يتقدم كشريط تقدم بسيط بدلاً من المعيار ، المزيد
إعلامي ، متر.

-:، --التالي
يخبر curl لاستخدام عملية منفصلة لعنوان URL التالي والمرتبط به
والخيارات. يتيح لك هذا إرسال العديد من طلبات URL ، لكل منها طلبات خاصة بها
خيارات ، على سبيل المثال ، مثل أسماء مستخدمين مختلفة أو طلبات مخصصة لكل منها.
(أضيف في 7.36.0)

-0 ، --http1.0
(HTTP) يخبر curl باستخدام الإصدار 1.0 من HTTP بدلاً من استخدامه داخليًا
المفضل: HTTP 1.1.

- http1.1
(HTTP) يخبر curl لاستخدام الإصدار 1.1 من HTTP. هذه هي النسخة الافتراضية الداخلية.
(أضيف في 7.33.0)

- http2
(HTTP) يخبر curl لإصدار طلباته باستخدام HTTP 2. وهذا يتطلب أن يكون ملف
تم إنشاء libcurl الأساسي لدعمه. (أضيف في 7.33.0)

--لا- npn
قم بتعطيل ملحق NPN TLS. يتم تمكين NPN افتراضيًا إذا تم إنشاء libcurl باستخدام
مكتبة SSL تدعم NPN. يتم استخدام NPN بواسطة libcurl الذي يدعم HTTP 2 إلى
تفاوض بشأن دعم HTTP 2 مع الخادم أثناء جلسات https.

(أضيف في 7.36.0)

--لا alpn
قم بتعطيل امتداد ALPN TLS. يتم تمكين ALPN افتراضيًا إذا تم إنشاء libcurl
مع مكتبة SSL تدعم ALPN. يتم استخدام ALPN بواسطة libcurl الذي يدعم ملفات
HTTP 2 للتفاوض بشأن دعم HTTP 2 مع الخادم أثناء جلسات https.

(أضيف في 7.36.0)

-1، --tlsv1
(SSL) يفرض على curl استخدام TLS الإصدار 1.x عند التفاوض مع خادم TLS بعيد.
يمكنك استخدام الخيارات --tlsv1.0, --tlsv1.1و --tlsv1.2 للتحكم في إصدار TLS
بشكل أكثر دقة (إذا كانت الواجهة الخلفية SSL المستخدمة تدعم مثل هذا المستوى من التحكم).

-2، - sslv2
(SSL) يجبر curl على استخدام الإصدار 2 من SSL عند التفاوض مع خادم SSL بعيد.
أحيانًا يتم إنشاء curl بدون دعم SSLv2. يعتبر SSLv2 غير آمن على نطاق واسع
(انظر RFC 6176).

-3، - sslv3
(SSL) يجبر curl على استخدام الإصدار 3 من SSL عند التفاوض مع خادم SSL بعيد.
أحيانًا يتم إنشاء curl بدون دعم SSLv3. يعتبر SSLv3 غير آمن على نطاق واسع
(انظر RFC 7568).

-4 ، --ipv4
يخبر هذا الخيار curl بحل الأسماء لعناوين IPv4 فقط ، وليس على سبيل المثال
جرب IPv6.

-6 ، --ipv6
يخبر هذا الخيار curl بحل الأسماء لعناوين IPv6 فقط ، وليس على سبيل المثال
جرب IPv4.

-a ، - إرفاق
(FTP / SFTP) عند استخدامه في التحميل ، فإن هذا يجعل curl يلحق بالملف الهدف
بدلا من الكتابة فوقه. إذا لم يكن الملف البعيد موجودًا ، فسيتم إنشاؤه.
لاحظ أن بعض خوادم SFTP (بما في ذلك OpenSSH) تتجاهل هذه العلامة.

-A ، - وكيل المستخدم
(HTTP) حدد سلسلة User-Agent لإرسالها إلى خادم HTTP. البعض تم بشكل سيء
تفشل CGIs إذا لم يتم تعيين هذا الحقل على "Mozilla / 4.0". لتشفير الفراغات في السلسلة ،
تحيط السلسلة بعلامات اقتباس مفردة. يمكن أيضًا تعيين هذا بامتداد -H ،
- رأس خيار بالطبع.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--انياوث
(HTTP) يخبر curl لاكتشاف طريقة المصادقة بنفسه ، واستخدامه أكثر من غيره
تأمين واحد يدعي الموقع البعيد أنه يدعمه. يتم ذلك عن طريق تقديم طلب أولاً
والتحقق من رؤوس الاستجابة ، وبالتالي قد يؤدي إلى جولة شبكة إضافية-
رحلة قصيرة. يتم استخدام هذا بدلاً من تحديد طريقة مصادقة محددة ، والتي أنت
يمكن أن تفعل به --أساسي, --استوعب, - نتلمو - تفاوض.

لاحظ أن استخدام --anyauth غير مستحسن إذا قمت بتحميل من stdin ، لأنه
قد يتطلب إرسال البيانات مرتين ومن ثم يجب أن يكون العميل قادرًا على الترجيع. لو
يجب أن تنشأ الحاجة عند التحميل من stdin ، ستفشل عملية التحميل.

-ب ، - ملف تعريف الارتباط
(HTTP) قم بتمرير البيانات إلى خادم HTTP كملف تعريف ارتباط. من المفترض أنها البيانات
تم استلامها مسبقًا من الخادم في سطر "Set-Cookie:". يجب أن تكون البيانات بتنسيق
التنسيق "NAME1 = VALUE1 ؛ NAME2 = VALUE2".

إذا لم يتم استخدام رمز '=' في السطر ، فسيتم التعامل معه على أنه اسم ملف لاستخدامه في القراءة
سطور ملفات تعريف الارتباط المخزنة مسبقًا من ، والتي يجب استخدامها في هذه الجلسة إذا كانت
تطابق. يؤدي استخدام هذه الطريقة أيضًا إلى تنشيط محرك ملفات تعريف الارتباط الذي سيجعل الضفيرة
سجل ملفات تعريف الارتباط الواردة أيضًا ، والتي قد تكون مفيدة إذا كنت تستخدم هذا معًا
مع الالجائزة -L ، --موقعك اختيار. تنسيق الملف لقراءة ملفات تعريف الارتباط منه
يجب أن تكون رؤوس HTTP عادية أو تنسيق ملف ملف تعريف الارتباط Netscape / Mozilla.

الملف المحدد بامتداد -ب، --بسكويت يستخدم فقط كمدخلات. لن تكون ملفات تعريف الارتباط
مكتوب في الملف. لتخزين ملفات تعريف الارتباط ، استخدم ملف -c ، --وعاء البسكويت الخيار.

توخ الحذر إذا كنت تستخدم هذا الخيار وقد تحدث عمليات نقل متعددة. لو
كنت تستخدم NAME1 = VALUE1 ؛ أو في ملف ، استخدم تنسيق Set-Cookie ولا تفعل ذلك
تحديد مجال ، ثم يتم إرسال ملف تعريف الارتباط لأي مجال (حتى بعد إعادة التوجيه
يتبع) ولا يمكن تعديله بواسطة ملف تعريف ارتباط معيّن من قِبل الخادم. إذا كان محرك ملفات تعريف الارتباط
ممكّنًا ويعين الخادم ملف تعريف ارتباط يحمل نفس الاسم ، ثم يتم إرسال كلاهما على ملف
النقل المستقبلي إلى هذا الخادم ، على الأرجح ليس ما كنت تقصده. لمعالجة هذه
تعيين نطاق في Set-Cookie (القيام بذلك سوف يشمل المجالات الفرعية) أو استخدام
تنسيق Netscape.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-ب ، - استخدام أسكي
(FTP / LDAP) قم بتمكين نقل ASCII. بالنسبة إلى FTP ، يمكن أيضًا فرض ذلك باستخدام ملف
عنوان URL الذي ينتهي بـ "؛ اكتب = A". يؤدي هذا الخيار إلى أن تكون البيانات المرسلة إلى stdout في نص
الوضع لأنظمة win32.

--أساسي
(HTTP) يخبر curl لاستخدام مصادقة HTTP الأساسية مع المضيف البعيد. هذا هو
الافتراضي وهذا الخيار عادة ما يكون عديم الجدوى ، إلا إذا كنت تستخدمه لتجاوز ملف
الخيار الذي تم تعيينه مسبقًا والذي يحدد طريقة مصادقة مختلفة (مثل - نتلم,
--استوعبالطرق أو - تفاوض).

تستخدم مع -u ، --المستعمل و -x ، --الوكيل.

انظر أيضا --بروكسي الأساسية.

-c ، -cookie-jar
(HTTP) حدد الملف الذي تريد تجعيده لكتابة جميع ملفات تعريف الارتباط بعد اكتمالها
عملية. يكتب Curl أيضًا جميع ملفات تعريف الارتباط التي سبق قراءتها من ملف معين
جميع ملفات تعريف الارتباط المستلمة من الخادم (الخوادم) البعيد. إذا لم يتم التعرف على ملفات تعريف الارتباط ، فلن تكون هناك بيانات
أنيق المهنية عارضة. سيتم كتابة الملف باستخدام تنسيق ملف تعريف الارتباط Netscape. اذا أنت
اضبط اسم الملف على شرطة واحدة ، "-" ، ستتم كتابة ملفات تعريف الارتباط على stdout.

سيقوم خيار سطر الأوامر هذا بتنشيط محرك ملفات تعريف الارتباط الذي يقوم بعمل سجل curl و
استخدام ملفات تعريف الارتباط. هناك طريقة أخرى لتنشيطه وهي استخدام ملف -ب، --بسكويت الخيار.

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

منذ 7.43.0 ملفات تعريف الارتباط التي تم استيرادها بتنسيق Set-Cookie بدون مجال
لم يتم تصدير الاسم من خلال هذا الخيار.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام اسم الملف المحدد الأخير.

-C ، - تابع-في
متابعة / استئناف نقل الملف السابق عند الإزاحة المحددة. الإزاحة المعطاة هي
العدد الدقيق للبايتات التي سيتم تخطيها ، بدءًا من بداية
ملف المصدر قبل نقله إلى الوجهة. إذا تم استخدامه مع التحميلات ، فإن ملف
لن يتم استخدام أمر خادم FTP SIZE بواسطة curl.

استخدم "-C -" لإخبار curl بالتعرف على مكان / كيفية استئناف النقل تلقائيًا.
ثم يستخدم ملفات الإخراج / الإدخال المحددة لمعرفة ذلك.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- الشفرات
(SSL) يحدد أي الأصفار يتم استخدامه في الاتصال. يجب أن قائمة الأصفار
تحديد الأصفار الصالحة. اقرأ تفاصيل قائمة تشفير SSL على عنوان URL هذا:
https://www.openssl.org/docs/apps/ciphers.html

يتم عمل شفرات NSS بشكل مختلف عن OpenSSL و GnuTLS. القائمة الكاملة لـ NSS
الشفرات موجودة في إدخال NSSCipherSuite في عنوان URL هذا:
https://git.fedorahosted.org/cgit/mod_nss.git/plain/docs/mod_nss.html#Directives

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--مضغوط
(HTTP) اطلب استجابة مضغوطة باستخدام أحد الخوارزميات التي تدعمها curl ، و
احفظ المستند غير المضغوط. إذا تم استخدام هذا الخيار وقام الخادم بإرسال ملف
ترميز غير مدعوم ، سيُبلغ curl عن خطأ.

--ربط مهلة
أقصى وقت بالثواني يسمح لاتصال curl بأخذها. هذا يحد فقط
مرحلة الاتصال ، لذلك إذا اتصل curl خلال فترة معينة ، فسيستمر
- إذا لم يكن كذلك فسوف يخرج. منذ الإصدار 7.32.0 ، يقبل هذا الخيار القيم العشرية.

انظر أيضا م ، --أقصى وقت الخيار.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- إنشاء dirs
عند استخدامه مع ملف -o الخيار ، سيخلق curl الملف المحلي الضروري
التسلسل الهرمي للدليل حسب الحاجة. يقوم هذا الخيار بإنشاء الأدوار المذكورة بامتداد -o
خيار ، لا شيء غير ذلك. إذا كان -o اسم الملف لا يستخدم dir أو إذا ذكره dirs
موجود بالفعل ، لن يتم إنشاء دير.

لإنشاء أدلة بعيدة عند استخدام FTP أو SFTP ، جرب - ftp-create-dirs.

--crlf تحويل LF إلى CRLF في الرفع. مفيد لـ MVS (OS / 390).

(تمت إضافة SMTP في 7.40.0)

--crlfile
(HTTPS / FTPS) قم بتوفير ملف باستخدام تنسيق PEM مع قائمة إبطال الشهادات
التي قد تحدد شهادات النظراء التي تعتبر ملغاة.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

(أضيف في 7.19.7)

-د ، - البيانات
(HTTP) يرسل البيانات المحددة في طلب POST إلى خادم HTTP ، بنفس الطريقة
بالطريقة التي يقوم بها المتصفح عندما يملأ المستخدم نموذج HTML ويضغط على ملف
زر الإرسال. سيؤدي ذلك إلى قيام curl بتمرير البيانات إلى الخادم باستخدام ملف
تطبيق نوع المحتوى / x-www-form-urlencoded. قارن ب -F، --شكل.

-د، --البيانات بالضبط مثل --data-ascii. - البيانات الخام يكاد يكون هو نفسه لكنه لا
تفسير خاص للحرف @. لنشر البيانات الثنائية البحتة ، أنت
يجب بدلاً من ذلك استخدام - ثنائي البيانات اختيار. لتشفير URL قيمة النموذج
المجال الذي قد تستخدمه - البيانات- urlencode.

إذا تم استخدام أي من هذه الخيارات أكثر من مرة في نفس سطر الأوامر ، البيانات
سيتم دمج القطع المحددة مع فصل & -رمز. وهكذا ، باستخدام
يؤدي '-d name = daniel -d Skills = lousy' إلى إنشاء مقطع منشور يبدو مثل
"الاسم = دانيال والمهارة = رديء".

إذا بدأت البيانات بالحرف @ ، فيجب أن يكون الباقي اسم ملف لقراءة
البيانات من ، أو - إذا كنت تريد curl لقراءة البيانات من stdin. يمكن ملفات متعددة
يتم تحديدها أيضًا. وبالتالي يتم إرسال البيانات من ملف يسمى "foobar" باستخدام
--البيانات تضمين التغريدة عندما يُطلب من - البيانات أن تقرأ من ملف كهذا ، يعود السطر
وسيتم تجريد الأسطر الجديدة. إذا كنت لا تريد أن يكون للحرف @ امتداد
استخدام تفسير خاص - البيانات الخام بدلا من ذلك.

-D ، - رأس التفريغ
اكتب رؤوس البروتوكول في الملف المحدد.

هذا الخيار سهل الاستخدام عندما تريد تخزين رؤوس موقع HTTP
يرسل لك. يمكن بعد ذلك قراءة ملفات تعريف الارتباط من الرؤوس في حلقة ثانية
الدعاء باستخدام -ب، --بسكويت اختيار! ال -c ، --وعاء البسكويت الخيار هو
أفضل طريقة لتخزين ملفات تعريف الارتباط.

عند استخدامها في FTP ، تعتبر خطوط استجابة خادم FTP بمثابة "رؤوس" و
هكذا يتم حفظها هناك.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--data-ascii
يرى -د، --البيانات.

- ثنائي البيانات
(HTTP) هذا ينشر البيانات كما هو محدد تمامًا دون أي معالجة إضافية على الإطلاق.

إذا بدأت البيانات بالحرف @ ، فيجب أن يكون الباقي اسم ملف. البيانات
نشر بطريقة مماثلة مثل --data-ascii لا ، باستثناء تلك السطور الجديدة والعربة
يتم الاحتفاظ بالعائدات ولا يتم إجراء التحويلات أبدًا.

إذا تم استخدام هذا الخيار عدة مرات ، فإن الخيارات التي تلي الخيار الأول ستلحق البيانات
كما هو موضح في -د، --البيانات.

- البيانات الخام
(HTTP) هذا ينشر البيانات بشكل مشابه لـ --البيانات لكن بدون تفسير خاص
من الحرف @. ارى -د، --البيانات. (أضيف في 7.43.0)

- البيانات- urlencode
(HTTP) هذا ينشر البيانات ، على غرار خيارات البيانات الأخرى باستثناء ذلك
هذا يؤدي إلى ترميز URL. (أضيف في 7.18.0)

لتكون متوافقة مع CGI ، يجب أن يكون يجب أن يبدأ الجزء ب الاسم تليها
فاصل ومواصفات المحتوى. ال يمكن تمرير جزء إلى حليقة باستخدام
أحد التركيبات التالية:

محتوى
سيؤدي ذلك إلى جعل عنوان URL curl يشفر المحتوى ويمرره. فقط كن حذرا
بحيث لا يحتوي المحتوى على أي رموز = أو @ ، حيث سيحدث ذلك بعد ذلك
اجعل بناء الجملة يتطابق مع إحدى الحالات الأخرى أدناه!

= المحتوى
سيؤدي ذلك إلى جعل عنوان URL curl يشفر المحتوى ويمرره. السابق =
لم يتم تضمين الرمز في البيانات.

الاسم = المحتوى
سيؤدي ذلك إلى جعل عنوان URL curl يشفر جزء المحتوى ويمرر ذلك. لاحظ أن
من المتوقع أن يكون جزء الاسم مشفرًا بعنوان URL بالفعل.

@اسم الملف
سيؤدي ذلك إلى جعل بيانات تحميل curl من الملف المحدد (بما في ذلك أي أسطر جديدة) ،
يقوم URL بترميز تلك البيانات ونقلها في POST.

name @ filename
سيؤدي ذلك إلى جعل بيانات تحميل curl من الملف المحدد (بما في ذلك أي أسطر جديدة) ،
يقوم URL بترميز تلك البيانات ونقلها في POST. جزء الاسم يحصل على قدم المساواة
تم إلحاقه ، مما أدى إلى الاسم = urlencoded-file-content. لاحظ أن الاسم
من المتوقع أن يكون مشفرًا بعنوان URL بالفعل.

- مستوى التفويض
المجموعات LEVEL لإخبار الخادم بما يجوز تفويضه عندما يتعلق الأمر بالمستخدم
أوراق اعتماد. تستخدم مع GSS / kerberos.

لا شيء لا تسمح بأي تفويض.

سياسة التفويضات فقط إذا تم تعيين علامة OK-AS-DELEGATE في Kerberos
تذكرة الخدمة ، وهي مسألة تتعلق بسياسة المجال.

السماح دائمًا للخادم بالتفويض دون قيد أو شرط.

--استوعب
(HTTP) يُمكّن مصادقة HTTP Digest. هذا هو مخطط المصادقة أن
يمنع إرسال كلمة المرور عبر السلك بنص واضح. استخدم هذا في
تركيبة مع الوضع الطبيعي -u ، --المستعمل خيار لتعيين اسم المستخدم وكلمة المرور. ارى
أيضا - نتلم, - تفاوض و --انياوث للخيارات ذات الصلة.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأول فقط.

--تعطيل- eprt
(FTP) أخبر curl بتعطيل استخدام أوامر EPRT و LPRT عند القيام بالنشاط
تحويلات FTP. سيحاول Curl دائمًا أولاً استخدام EPRT ، ثم LPRT
قبل استخدام PORT ، ولكن مع هذا الخيار ، سيستخدم PORT على الفور. EPRT و LPRT
هي امتدادات لبروتوكول FTP الأصلي ، وقد لا تعمل على جميع الخوادم ، ولكن
أنها تتيح المزيد من الوظائف بطريقة أفضل من أمر PORT التقليدي.

--eprt يمكن استخدامها لتمكين EPRT بشكل صريح مرة أخرى و --لا- eprt هو اسم مستعار ل
--تعطيل- eprt.

يؤدي تعطيل EPRT إلى تغيير السلوك النشط فقط. إذا كنت تريد التبديل إلى المبني للمجهول
الوضع الذي تحتاج إلى عدم استخدامه -P ، - منفذ ftp أو إجبارها --ftp-pasv.

--تعطيل epsv
(FTP) اطلب من curl تعطيل استخدام أمر EPSV عند تنفيذ بروتوكول FTP سلبي
التحويلات. عادةً ما يحاول Curl أولاً استخدام EPSV قبل PASV ، ولكن
مع هذا الخيار ، لن يحاول استخدام EPSV.

- epsv يمكن استخدامها لتمكين EPSV بشكل صريح مرة أخرى و --لا epsv هو اسم مستعار ل
--تعطيل epsv.

يؤدي تعطيل EPSV إلى تغيير السلوك السلبي فقط. إذا كنت تريد التبديل إلى نشط
الوضع الذي تحتاج إلى استخدامه -P ، - منفذ ftp.

- واجهة dns
اطلب من curl إرسال طلبات DNS الصادرة من خلال . هذا الخيار هو ملف
النظير ل --واجهه المستخدم (الذي لا يؤثر على DNS). يجب أن تكون السلسلة المزودة
اسم واجهة (وليس عنوان).

يتطلب هذا الخيار إنشاء libcurl بواجهة خلفية لوحدة الحل التي تدعم
هذه العملية. الواجهة الخلفية c-ares هي الوحيدة من نوعها. (أضيف في 7.33.0)

--dns-ipv4-addr
أخبر curl بالالتزام به عند تقديم طلبات IPv4 DNS ، بحيث يكون DNS
الطلبات تنشأ من هذا العنوان. يجب أن تكون الوسيطة عنوان IPv4 واحدًا.

يتطلب هذا الخيار إنشاء libcurl بواجهة خلفية لوحدة الحل التي تدعم
هذه العملية. الواجهة الخلفية c-ares هي الوحيدة من نوعها. (أضيف في 7.33.0)

--dns-ipv6-addr
أخبر curl بالالتزام به عند تقديم طلبات IPv6 DNS ، بحيث يكون DNS
الطلبات تنشأ من هذا العنوان. يجب أن تكون الوسيطة عنوان IPv6 واحدًا.

يتطلب هذا الخيار إنشاء libcurl بواجهة خلفية لوحدة الحل التي تدعم
هذه العملية. الواجهة الخلفية c-ares هي الوحيدة من نوعها. (أضيف في 7.33.0)

--dns- خوادم
قم بتعيين قائمة خوادم DNS المراد استخدامها بدلاً من النظام الافتراضي. القائمة ل
يجب فصل عناوين IP بفاصلات. قد تكون أرقام المنافذ اختياريًا أيضًا
نظرا ل : بعد كل عنوان IP.

يتطلب هذا الخيار إنشاء libcurl بواجهة خلفية لوحدة الحل التي تدعم
هذه العملية. الواجهة الخلفية c-ares هي الوحيدة من نوعها. (أضيف في 7.33.0)

-e ، - المرجع
(HTTP) يرسل معلومات "الصفحة المرجعية" إلى خادم HTTP. يمكن أن يكون هذا أيضًا
مع مجموعة -H ، - رأس علم بالطبع. عند استخدامها مع -L ، --موقعك تستطيع
قم بإلحاق "؛ auto" إلى عنوان URL المرجعي - لجعل curl يقوم تلقائيًا بتعيين عنوان URL السابق
عندما يتبع العنوان: الموقع. يمكن استخدام السلسلة "؛ auto" بمفردها ، حتى لو
لم تقم بتعيين مرجع أولي.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-E، --cert
(SSL) يخبر curl باستخدام ملف شهادة العميل المحدد عند الحصول على ملف
مع HTTPS أو FTPS أو بروتوكول آخر قائم على SSL. يجب أن تكون الشهادة في PKCS # 12
التنسيق في حالة استخدام تنسيق النقل الآمن ، أو تنسيق PEM في حالة استخدام أي محرك آخر. إذا كان
لم يتم تحديد كلمة المرور الاختيارية ، وسيتم الاستعلام عنها على الجهاز. ملحوظة
أن هذا الخيار يفترض وجود ملف "شهادة" يمثل المفتاح الخاص و
شهادة العميل متسلسلة! ارى - شهادة و --مفتاح لتحديدهم
بشكل مستقل.

إذا تم إنشاء curl مقابل مكتبة NSS SSL ، فيمكن لهذا الخيار أن يخبر curl عن ملف
لقب الشهادة المراد استخدامها ضمن قاعدة بيانات NSS المحددة بواسطة
متغير البيئة SSL_DIR (أو افتراضيًا / etc / pki / nssdb). إذا كان NSS PEM PKCS # 11
الوحدة النمطية (libnsspem.so) متاحة ، ثم يمكن تحميل ملفات PEM. إذا كنت تريد استخدام
ملف من الدليل الحالي ، يرجى أن تسبقه ببادئة "./" ، من أجل
تجنب الالتباس مع لقب. إذا كان الاسم المستعار يحتوي على ":" ، فيجب أن يكون كذلك
مسبوقة بـ "\" بحيث لا يتم التعرف عليها كمحدد لكلمة المرور. إذا كان
اللقب يحتوي على "\" ، يجب تخطيه كـ "\\" حتى لا يتم التعرف عليه
كشخصية هروب.

(iOS و Mac OS X فقط) إذا تم إنشاء curl مقابل Secure Transport ، فسيتم إنشاء ملف
يمكن أن تكون سلسلة الشهادة إما اسم الشهادة / المفتاح الخاص في ملف
سلسلة مفاتيح النظام أو المستخدم ، أو المسار إلى شهادة PKCS # 12 المشفرة والخاصة
مفتاح. إذا كنت تريد استخدام ملف من الدليل الحالي ، فيرجى أن تسبقه بـ
"./" ، لتجنب الخلط بينه وبين لقب.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--محرك
حدد محرك تشفير OpenSSL لاستخدامه في عمليات التشفير. يستخدم --محرك قائمة إلى
اطبع قائمة بالمحركات المدعومة وقت البناء. لاحظ أنه ليس كل (أو لا شيء) من
قد تكون المحركات متاحة في وقت التشغيل.

--بيئة
(RISC OS ONLY) يعيّن نطاقًا من متغيرات البيئة ، باستخدام الأسماء -w خيار
يدعم ، للسماح باستخراج أسهل للمعلومات المفيدة بعد تشغيل الضفيرة.

--ملف
(SSL) حدد اسم المسار لمقبس Entropy Gathering Daemon. المقبس هو
تستخدم لبذر المحرك العشوائي لاتصالات SSL. انظر أيضا - ملف عشوائي
الخيار.

-توقع 100 مهلة
(HTTP) أقصى وقت بالثواني يسمح لـ curl بانتظار 100 متابعة
استجابة عندما يصدر curl يتوقع: 100-continue header في طلبه. بشكل افتراضي
سوف الضفيرة الانتظار ثانية واحدة. هذا الخيار يقبل القيم العشرية! عندما يتوقف الضفيرة
الانتظار ، سيستمر كما لو تم تلقي الرد.

(أضيف في 7.47.0)

- نوع الخدمة
(SSL) يخبر عن نوع الشهادة التي توجد بها الشهادة المقدمة. PEM و DER و
إنج من الأنواع المعترف بها. إذا لم يتم تحديده ، فسيتم افتراض PEM.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--cacert
(SSL) يخبر curl لاستخدام ملف الشهادة المحدد للتحقق من النظير. الملف
قد تحتوي على شهادات CA متعددة. يجب أن تكون الشهادة (الشهادات) بتنسيق PEM.
عادةً ما يتم إنشاء curl لاستخدام ملف افتراضي لهذا الغرض ، لذلك يكون هذا الخيار عادةً
تستخدم لتغيير هذا الملف الافتراضي.

يتعرف curl على متغير البيئة المسمى "CURL_CA_BUNDLE" إذا تم تعيينه ، و
يستخدم المسار المحدد كمسار إلى حزمة شهادات المرجع المصدق. هذا الخيار يتجاوز ذلك
المتغير.

سيبحث إصدار windows من curl تلقائيًا عن ملف شهادات CA المسمى
´curl-ca-bundle.crt´ ، إما في نفس الدليل مثل curl.exe ، أو في Current
دليل العمل ، أو في أي مجلد على طول المسار الخاص بك.

إذا تم بناء curl مقابل مكتبة NSS SSL ، فإن الوحدة النمطية NSS PEM PKCS # 11
(libnsspem.so) يجب أن يكون متاحًا حتى يعمل هذا الخيار بشكل صحيح.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- كاباث
(SSL) يخبر curl لاستخدام دليل الشهادة المحدد للتحقق من النظير.
يمكن توفير مسارات متعددة عن طريق فصلها بـ ":" (على سبيل المثال
"path1: path2: path3"). يجب أن تكون الشهادات بتنسيق PEM ، وإذا تم إنشاء curl
مقابل OpenSSL ، يجب أن تتم معالجة الدليل باستخدام الأداة المساعدة c_rehash
مزود بـ OpenSSL. استخدام - كاباث يمكن أن تسمح لـ OpenSSL curl بجعل SSL-
أكثر كفاءة بكثير من استخدام --cacert إذا كان --cacert يحتوي الملف
العديد من شهادات CA.

إذا تم تعيين هذا الخيار ، فسيتم تجاهل قيمة capath الافتراضية ، وإذا تم استخدامها
عدة مرات ، سيتم استخدام آخر مرة.

--pinnedpubkey
(SSL) يخبر curl باستخدام ملف المفتاح العام المحدد (أو التجزئة) للتحقق من ملف
الأقران. يمكن أن يكون هذا مسارًا لملف يحتوي على مفتاح عام واحد في PEM أو DER
تنسيق ، أو أي عدد من تجزئات base64 المشفرة sha256 مسبوقة بـ ´sha256 // ´ و
مفصوله ب

عند التفاوض على اتصال TLS أو SSL ، يرسل الخادم شهادة تشير إلى
هويته. يتم استخراج مفتاح عمومي من هذه الشهادة وإذا لم يتم ذلك
يطابق تمامًا المفتاح العمومي المتوفر لهذا الخيار ، سيؤدي curl إلى إحباط ملف
الاتصال قبل إرسال أو استقبال أي بيانات.

تمت الإضافة في 7.39.0 لـ OpenSSL و GnuTLS و GSKit. تمت الإضافة في 7.43.0 لـ NSS و
wolfSSL / CyaSSL. تمت إضافة دعم sha256 في 7.44.0 لـ OpenSSL و GnuTLS و NSS و
wolfSSL / CyaSSL. خلفيات SSL الأخرى غير مدعومة.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- شهادة الحالة
(SSL) يخبر curl للتحقق من حالة شهادة الخادم باستخدام ملف
طلب حالة الشهادة (المعروف أيضًا باسم تدبيس OCSP) امتداد TLS.

إذا تم تمكين هذا الخيار وأرسل الخادم استجابة غير صالحة (على سبيل المثال منتهية الصلاحية) ،
إذا كانت الاستجابة تشير إلى أن شهادة الخادم قد تم إبطالها ، أم لا
تم استلام الرد على الإطلاق ، فشل التحقق.

يتم تنفيذ هذا حاليًا فقط في خلفيات OpenSSL و GnuTLS و NSS. (مضاف
في 7.41.0)

--بداية خاطئة

(SSL) يخبر curl باستخدام بداية خاطئة أثناء مصافحة TLS. البداية الخاطئة هي طريقة
حيث سيبدأ عميل TLS في إرسال بيانات التطبيق قبل التحقق من
تم الانتهاء من رسالة الخادم ، وبالتالي حفظ رحلة ذهابًا وإيابًا عند إجراء ملف
مصافحة.

يتم تنفيذ ذلك حاليًا فقط في NSS و Secure Transport (على iOS 7.0 أو
أحدث أو OS X 10.9 أو أحدث) الخلفية. (أضيف في 7.42.0)

-f ، - فشل
(HTTP) يفشل بصمت (لا يوجد مخرج على الإطلاق) في أخطاء الخادم. يتم ذلك في الغالب ل
تمكين البرامج النصية وما إلى ذلك بشكل أفضل للتعامل بشكل أفضل مع المحاولات الفاشلة. في الحالات العادية عندما
فشل خادم HTTP في تسليم مستند ، ويعيد مستند HTML ينص على ذلك
(والذي غالبًا ما يصف أيضًا السبب والمزيد). هذا العلم سيمنع التفاف من
إخراج ذلك وإرجاع الخطأ 22.

هذه الطريقة ليست آمنة من الفشل وهناك حالات يكون فيها الرد غير ناجح
ستنزلق الرموز ، خاصةً عندما يتعلق الأمر بالمصادقة (رموز الاستجابة
401 و 407).

-F، --form
(HTTP) يتيح ذلك لـ curl محاكاة نموذج مملوء يقوم فيه المستخدم بالضغط على ملف
زر الإرسال. يؤدي هذا إلى تجعيد بيانات POST باستخدام نوع المحتوى متعدد الأجزاء / النموذج-
البيانات وفقًا لـ RFC 2388. يتيح ذلك تحميل الملفات الثنائية وما إلى ذلك
جزء "المحتوى" ليكون ملفًا ، فابدأ اسم الملف بعلامة @. لمجرد الحصول عليها
جزء المحتوى من ملف ، ابدأ اسم الملف بالرمز <. ال
الفرق بين @ و <هو إذن أن @ يجعل ملفًا يتم إرفاقه في المنشور كـ
تحميل ملف ، بينما يقوم <بإنشاء حقل نصي والحصول على محتويات لذلك
حقل نصي من ملف.

على سبيل المثال ، لإرسال ملف كلمة المرور إلى الخادم ، حيث يكون "password" هو اسم
حقل النموذج الذي / الخ / باسود سيكون المدخل:

حليقة -F كلمة المرور = @/ الخ / باسود www.mypasswords.com

لقراءة المحتوى من stdin بدلاً من ملف ، استخدم - كاسم ملف. هذا ينطبق على
على حد سواء @ و <. للأسف لا يدعم قراءة الملف من ملف
أنبوب مسمى أو ما شابه ، حيث يحتاج إلى الحجم الكامل قبل بدء النقل.

يمكنك أيضًا إخبار curl بنوع المحتوى المراد استخدامه باستخدام "type =" بطريقة ما
مشابه ل:

حليقة -F "[البريد الإلكتروني محمي];type=text/html" url.com

or

حليقة -F "name = daniel ؛ type = text / foo" url.com

يمكنك أيضًا تغيير حقل الاسم بشكل صريح لجزء تحميل الملف عن طريق الإعداد
اسم الملف = ، مثل هذا:

حليقة -F "file = @ localfile ؛ اسم الملف = nameinpost" url.com

إذا احتوى اسم الملف / المسار على "،" أو "؛" ، فيجب أن يتم اقتباسه بعلامات اقتباس مزدوجة مثل:

حليقة -F "file = @ \" localfile \ "؛ اسم الملف = \" nameinpost \ "" url.com

or

حليقة -F 'file = @ "localfile" ؛ اسم الملف = "nameinpost"' url.com

لاحظ أنه إذا تم اقتباس اسم الملف / المسار بعلامات اقتباس مزدوجة ، أو أي علامة اقتباس مزدوجة أو
يجب تخطي الشرطة المائلة للخلف داخل اسم الملف بخط مائل عكسي.

اطلع على مزيد من الأمثلة والتفاصيل في الدليل.

يمكن استخدام هذا الخيار عدة مرات.

--ftp-account [البيانات]
(FTP) عندما يطلب خادم FTP "بيانات الحساب" بعد اسم المستخدم وكلمة المرور
تم توفير هذه البيانات باستخدام أمر ACCT. (تمت الإضافة في 7.13.0)

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- -ftp- بديل للمستخدم
(FTP) إذا فشلت المصادقة باستخدام أمري USER و PASS ، أرسل هذا الأمر.
عند الاتصال بخادم النقل الآمن لـ Tumbleweed عبر FTPS باستخدام عميل
الشهادة ، باستخدام "SITE AUTH" ستخبر الخادم باسترداد اسم المستخدم من
الشهادة. (أضيف في 7.15.5)

- ftp-create-dirs
(FTP / SFTP) عندما يستخدم عنوان URL / عملية FTP أو SFTP مسارًا لا يستخدم حاليًا
موجودة على الخادم ، السلوك القياسي لـ curl هو الفشل. باستخدام هذا الخيار ،
سيحاول curl بدلاً من ذلك إنشاء أدلة مفقودة.

طريقة --ftp [طريقة]
(FTP) التحكم في الطريقة التي يجب أن يستخدمها curl للوصول إلى ملف على خادم FTP (S). ال
يجب أن تكون حجة الأسلوب أحد البدائل التالية:

multicwd
curl يقوم بعملية CWD واحدة لكل جزء مسار في عنوان URL المحدد. ل
التسلسلات الهرمية العميقة وهذا يعني الكثير من الأوامر. هكذا يقولها RFC 1738
ينبغي القيام به. هذا هو السلوك الافتراضي ولكنه أبطأ السلوك.

nocwd curl لا يفعل CWD على الإطلاق. curl سيفعل SIZE ، RETR ، STOR وما إلى ذلك ويعطي كامل
المسار إلى الخادم لجميع هذه الأوامر. هذا هو أسرع سلوك.

مفرد
يقوم curl بعمل CWD واحد مع الدليل الهدف الكامل ثم يعمل على ملف
ملف "بشكل طبيعي" (كما هو الحال في حالة multicwd). هذا إلى حد ما المزيد من المعايير
متوافق مع "nocwd" ولكن بدون العقوبة الكاملة لـ "multicwd".

(أضيف في 7.15.1)

--ftp-pasv
(FTP) استخدم الوضع الخامل لاتصال البيانات. المبني للمجهول هو الافتراضي الداخلي
السلوك ، ولكن يمكن استخدام هذا الخيار لتجاوز سابقة -P / -ftp- المنفذ
اختيار. (تمت الإضافة في الإصدار 7.11.0)

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

يعني الوضع الخامل أن curl سيحاول أمر EPSV أولاً ثم PASV ، ما لم يكن
--تعطيل epsv .

--ftp-تخطي-pasv-ip
(FTP) أخبر curl بعدم استخدام عنوان IP الذي يقترحه الخادم في استجابته له
أمر PASV الخاص بـ curl عندما يربط curl اتصال البيانات. بدلا من ذلك سوف الضفيرة إعادة-
استخدم نفس عنوان IP الذي يستخدمه بالفعل لاتصال التحكم. (مضاف في
7.14.2)

لا يكون لهذا الخيار أي تأثير إذا تم استخدام PORT أو EPRT أو EPSV بدلاً من PASV.

- ftp- بريتيش
(FTP) اطلب من curl إرسال أمر PRET قبل PASV (و EPSV). خوادم FTP معينة ،
بشكل أساسي drftpd ، يتطلب هذا الأمر غير القياسي لقوائم الدليل أيضًا
يصل والتنزيلات في وضع PASV. (تمت الإضافة في 7.20.x)

--ftp-ssl-ccc
(FTP) Use CCC (Clear Command Channel) يغلق طبقة SSL / TLS بعد ذلك
المصادقة. ستكون بقية اتصالات قناة التحكم غير مشفرة.
يسمح هذا لأجهزة توجيه NAT باتباع معاملة FTP. الوضع الافتراضي هو الخامل.
يرى --ftp-ssl-ccc-mode لأنماط أخرى. (أضيف في 7.16.1)

--ftp-ssl-ccc-mode [نشط / سلبي]
(FTP) Use CCC (Clear Command Channel) يضبط وضع CCC. لن يكون الوضع الخامل
بدء إيقاف التشغيل ، ولكن بدلاً من ذلك انتظر حتى يقوم الخادم بذلك ، ولن يرد
إلى الاغلاق من الخادم. يبدأ الوضع النشط في إيقاف التشغيل وينتظر
للرد من الخادم. (أضيف في 7.16.2)

- التحكم في FTP-SSL
(FTP) طلب SSL / TLS لتسجيل الدخول إلى FTP ، مسح للنقل. يسمح بأمان
المصادقة ، ولكن عمليات نقل البيانات غير المشفرة لتحقيق الكفاءة. فشل
نقل إذا كان الخادم لا يدعم SSL / TLS. (تمت إضافته في 7.16.0) لا يزال بإمكانه
يمكن استخدامها ولكن ستتم إزالتها في إصدار لاحق.

- نموذج السلسلة
(HTTP) على غرار --شكل فيما عدا أن سلسلة القيمة للمعامل المحدد هي
تستخدم حرفيا. تبدأ الأحرف '@' و '<' ، و '؛ اكتب =' سلسلة في
القيمة ليس لها معنى خاص. استخدم هذا في التفضيل ل --شكل إذا كان هناك أي منها
احتمال أن تؤدي قيمة السلسلة إلى تشغيل ميزات "@" أو "<" عن طريق الخطأ
of --شكل.

-g ، --جلوبوف
يؤدي هذا الخيار إلى إيقاف تشغيل "محلل تجميع عناوين URL". عندما تقوم بتعيين هذا الخيار ، فأنت
يمكن تحديد عناوين URL التي تحتوي على الأحرف {} [] بدون الحاجة إلى وجودها
يفسرها الضفيرة نفسها. لاحظ أن هذه الأحرف ليست عنوان URL قانوني عادي
المحتويات ولكن يجب ترميزها وفقًا لمعيار URI.

-G ، - الحصول على
عند استخدامه ، سيجعل هذا الخيار جميع البيانات المحددة بـ -د، --البيانات, - ثنائي البيانات
or - البيانات- urlencode ليتم استخدامها في طلب HTTP GET بدلاً من طلب POST
التي سيتم استخدامها لولا ذلك. سيتم إلحاق البيانات بعنوان URL بعلامة "؟"
فاصل.

إذا تم استخدامه مع -I ، فسيتم بدلاً من ذلك إلحاق بيانات POST بعنوان URL
مع طلب HEAD.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأول فقط. هذا بسبب
لا يعد التراجع عن أمر GET منطقيًا ، ولكن يجب عليك بدلاً من ذلك تطبيق
طريقة بديلة تفضلها.

-H ، - رأس
(HTTP) رأس إضافي لتضمينه في الطلب عند إرسال HTTP إلى الخادم. أنت
قد تحدد أي عدد من الرؤوس الإضافية. لاحظ أنه إذا كان يجب عليك إضافة ملف
header الذي يحمل نفس الاسم الذي قد يستخدمه أحد التطبيقات الداخلية ، your
سيتم استخدام الرأس الذي تم تعيينه خارجيًا بدلاً من الرأس الداخلي. هذا يسمح لك
حتى تجعل الأشياء أكثر تعقيدًا مما تفعله الضفيرة عادةً. لا يجب أن تحل محل
قم بتعيين الرؤوس داخليًا دون معرفة ما تفعله جيدًا. قم بإزالة ملف
رأس داخلي بإعطاء بديل بدون محتوى على الجانب الأيمن من
القولون ، كما في: -H "Host:". إذا قمت بإرسال رأس مخصص بدون قيمة ، فسيكون ملف
يجب إنهاء الرأس بفاصلة منقوطة ، مثل -H "X-Custom-Header؛" لترسل
"X-Custom-Header:".

سيتأكد curl من إرسال كل عنوان تضيفه / تستبدله بالنهاية المناسبة-
من الخط ، يجب عليك بالتالي ليس أضف ذلك كجزء من محتوى الرأس: do
لا تضيف أسطرًا جديدة أو إرجاع إلى أول السطر ، فسيؤدي ذلك إلى إفساد الأشياء من أجلك فقط.

انظر أيضا -أ، --وكيل المستخدم و -e، - المرجع خيارات.

بدءًا من 7.37.0 ، أنت بحاجة إلى - رأس موثق لإرسال رؤوس مخصصة مخصصة لـ
الوكيل.

على سبيل المثال:

# curl -H "X-First-Name: Joe" http://192.168.0.1/

تحذير: سيتم تعيين الرؤوس مع هذا الخيار في جميع الطلبات - حتى بعد ذلك
يتم اتباع عمليات إعادة التوجيه ، كما هو الحال عند إخبارها بـ -L ، --موقعك. هذا يمكن أن يؤدي إلى
يتم إرسال رأس الصفحة إلى مضيفين آخرين غير المضيف الأصلي ، رؤوس حساسة للغاية
يجب استخدامه بحذر مع عمليات إعادة التوجيه التالية.

يمكن استخدام هذا الخيار عدة مرات لإضافة / استبدال / إزالة رؤوس متعددة.

--hostpubmd5
(SCP / SFTP) قم بتمرير سلسلة تحتوي على 32 رقمًا سداسيًا عشريًا. يجب أن تكون السلسلة هي
128 بت MD5 المجموع الاختباري للمفتاح العام للمضيف البعيد ، سيرفض curl ملف
الاتصال مع المضيف ما لم تتطابق md5sums. (أضيف في 7.17.1)

- تجاهل-طول المحتوى
بالنسبة إلى HTTP ، تجاهل عنوان Content-Length. هذا مفيد بشكل خاص للخوادم
تشغيل Apache 1.x ، والذي سيبلغ عن طول المحتوى غير الصحيح للملفات الأكبر حجمًا
من 2 جيجا بايت.

بالنسبة إلى FTP (منذ 7.46.0) ، تخطي الأمر RETR لمعرفة الحجم من قبل
تنزيل ملف.

-i ، - بما في ذلك
(HTTP) قم بتضمين رأس HTTP في الإخراج. يتضمن رأس HTTP أشياء مثل
اسم الخادم وتاريخ المستند وإصدار HTTP والمزيد ...

-أنا رأس
(HTTP / FTP / FILE) جلب رأس HTTP فقط! تتميز خوادم HTTP بأمر HEAD
الذي يستخدمه هذا للحصول على أي شيء سوى رأس المستند. عند استخدامها على FTP أو
ملف FILE ، يعرض curl حجم الملف ووقت التعديل الأخير فقط.

--واجهه المستخدم
قم بإجراء عملية باستخدام واجهة محددة. يمكنك إدخال اسم الواجهة ، IP
العنوان أو اسم المضيف. مثال يمكن أن يبدو مثل:

حليقة - واجهة eth0: 1 http://www.netscape.com/

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-j، -junk-session-cookies
(HTTP) عندما يُطلب من curl قراءة ملفات تعريف الارتباط من ملف معين ، فإن هذا الخيار يعمل
فإنه يتجاهل كافة "ملفات تعريف الارتباط للجلسة". سيكون لهذا بشكل أساسي نفس التأثير كما لو كان ملف
بدأت جلسة جديدة. المتصفحات النموذجية دائما تتجاهل ملفات تعريف الارتباط للجلسة عندما
لقد أغلقت.

-J ، -اسم-رأس-بعيد
(HTTP) يخبر هذا الخيار ملف -O ، - اسم بعيد الخيار لاستخدام الخادم المحدد
اسم ملف ترتيب المحتوى بدلاً من استخراج اسم ملف من عنوان URL.

لا توجد محاولة لفك ترميز٪-Sequences (حتى الآن) في اسم الملف المقدم ، لذلك هذا
قد يوفر لك الخيار أسماء ملفات غير متوقعة إلى حد ما.

-ك ، - غير آمن
(SSL) يسمح هذا الخيار صراحةً لـ curl بتنفيذ اتصالات SSL "غير الآمنة" و
التحويلات. تتم محاولة تأمين كافة اتصالات SSL باستخدام المرجع المصدق (CA)
حزمة الشهادات مثبتة بشكل افتراضي. هذا يجعل جميع الاتصالات في الاعتبار
"غير آمنة" تفشل ما لم -ك، --غير آمن .

راجع هذا المورد عبر الإنترنت لمزيد من التفاصيل:
http://curl.haxx.se/docs/sslcerts.html

-K ، - تكوين
حدد ملف التكوين الذي تريد قراءة وسيطات curl منه. ملف التكوين هو نص
ملف حيث يمكن كتابة وسيطات سطر الأوامر والتي سيتم استخدامها بعد ذلك كما لو
تم كتابتها على سطر الأوامر الفعلي.

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

إذا كانت المعلمة ستحتوي على مسافة بيضاء ، فيجب وضع المعلمة داخلها
يقتبس. ضمن علامات الاقتباس المزدوجة ، تتوفر تسلسلات الإفلات التالية: \\ ، \ "،
\ t و \ n و \ r و \ v. يتم تجاهل الشرطة المائلة للخلف التي تسبق أي حرف آخر. إذا كان أول
عمود سطر التكوين هو حرف "#" ، سيتم التعامل مع باقي السطر على أنه
تعليق. اكتب خيارًا واحدًا فقط لكل سطر مادي في ملف التكوين.

حدد اسم الملف إلى -K، --config كـ "-" لجعل curl يقرأ الملف من stdin.

لاحظ أنه لتتمكن من تحديد عنوان URL في ملف التكوين ، يجب عليك تحديده
يستخدم ال --url وليس فقط عن طريق كتابة عنوان URL على السطر الخاص به. لذلك ، هو
يمكن أن يشبه هذا:

url = "http://curl.haxx.se/docs/"

عندما يتم استدعاء curl ، فإنه دائمًا (ما لم يكن -q يستخدم) يتحقق من التهيئة الافتراضية
ملف ويستخدمه إذا وجد. يتم التحقق من ملف التكوين الافتراضي في ما يلي
الأماكن بهذا الترتيب:

1) يحاول curl العثور على "home dir": يقوم أولاً بالتحقق من CURL_HOME ثم
متغيرات البيئة الرئيسية. إذا تعذر ذلك ، فإنه يستخدم getpwuid () على نظام يشبه يونكس
الأنظمة (التي تعيد مسار المنزل مع الأخذ في الاعتبار المستخدم الحالي في نظامك). تشغيل
Windows ، ثم يتحقق من متغير APPDATA ، أو كملاذ أخير
"٪ USERPROFILE٪ \ بيانات التطبيق".

2) في windows ، إذا لم يكن هناك ملف _curlrc في مسار المنزل ، فإنه يتحقق من ملف
يتم وضع الملف القابل للتنفيذ الضفيرة نفس دير. في الأنظمة الشبيهة بيونكس ، سوف تفعل ذلك بكل بساطة
حاول تحميل .curlrc من دير المنزل المحدد.

# - مثال على الملف -
# هذا تعليق
url = "curl.haxx.se"
الإخراج = "curlhere.html"
وكيل المستخدم = "وكيل فائق / 1.0"

# وجلب عنوان URL آخر أيضًا
url = "curl.haxx.se/docs/manpage.html"
-O
المرجع = "http://nowhereatall.com/"
# --- نهاية نموذج الملف ---

يمكن استخدام هذا الخيار عدة مرات لتحميل ملفات تكوين متعددة.

- حفظ الوقت
يعيّن هذا الخيار الوقت الذي يجب أن يظل فيه الاتصال خاملاً قبل الإرسال
تحقيقات Keepalive والوقت بين تحقيقات Keepalive الفردية. إنها حاليا
فعال على أنظمة التشغيل التي توفر مأخذ توصيل TCP_KEEPIDLE و TCP_KEEPINTVL
خيارات (تعني Linux و AIX الأخير و HP-UX والمزيد). هذا الخيار ليس له أي تأثير إذا
--لا يحفظه يستخدم. (أضيف في 7.18.0)

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير. إذا لم يتم تحديدها ،
الخيار الافتراضي هو 60 ثانية.

--مفتاح
(SSL / SSH) اسم ملف المفتاح الخاص. يسمح لك بتقديم مفتاحك الخاص في هذا
ملف منفصل. بالنسبة إلى SSH ، إذا لم يتم تحديده ، يحاول curl المرشحين التاليين بتنسيق
ترتيب: '~ / .ssh / id_rsa'،'~ / .ssh / id_dsa'،' ./id_rsa '،' ./id_dsa '.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--نوع المفتاح
(SSL) نوع ملف المفتاح الخاص. حدد نوع ملف --مفتاح شريطة أن يكون المفتاح الخاص.
يتم دعم DER و PEM و ENG. إذا لم يتم تحديده ، فسيتم افتراض PEM.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--krb
(FTP) قم بتمكين مصادقة Kerberos واستخدامها. يجب إدخال المستوى ويجب
أن تكون ذات تصنيف "واضح" أو "آمن" أو "سري" أو "خاص". يجب عليك استخدام المستوى
هذا ليس واحدًا من هؤلاء ، سيتم استخدام "خاص" بدلاً من ذلك.

يتطلب هذا الخيار مكتبة تم إنشاؤها بدعم kerberos4. هذا ليس جدا
مشترك. يستخدم -الخامس، --الإصدار لمعرفة ما إذا كانت الضفيرة تدعمها.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-l ، - قائمة فقط
(FTP) عند إدراج دليل FTP ، يفرض رمز التبديل هذا عرض الاسم فقط. هذا هو
مفيد بشكل خاص إذا أراد المستخدم التحليل الآلي لمحتويات بروتوكول نقل الملفات
الدليل لأن عرض الدليل العادي لا يستخدم مظهرًا أو تنسيقًا قياسيًا.
عند استخدامه بهذا الشكل ، يؤدي الخيار إلى إرسال أمر NLST إلى الخادم
بدلا من LIST.

ملاحظة: بعض خوادم FTP تسرد الملفات فقط في استجابتها لـ NLST ؛ لا يفعلون
تشمل الدلائل الفرعية والروابط الرمزية.

(POP3) عند استرداد بريد إلكتروني معين من POP3 ، يفرض رمز التبديل هذا LIST
الأمر المطلوب تنفيذه بدلاً من RETR. هذا مفيد بشكل خاص إذا كان المستخدم
يريد معرفة ما إذا كان معرف رسالة معين موجودًا على الخادم وما هو حجمه.

ملاحظة: عند دمجها مع -X ، --طلب ، يمكن استخدام هذا الخيار للإرسال
أمر UIDL بدلاً من ذلك ، لذلك قد يستخدم المستخدم المعرف الفريد للبريد الإلكتروني بدلاً من ذلك
من معرف الرسالة لتقديم الطلب. (تمت الإضافة في 7.21.5)

-L ، - الموقع
(HTTP / HTTPS) إذا أبلغ الخادم عن انتقال الصفحة المطلوبة إلى ملف
الموقع (يشار إليه بالموقع: رأس ورمز استجابة 3XX) ، هذا الخيار
سيجعل curl يعيد الطلب في المكان الجديد. إذا تم استخدامها مع -أنا،
--يشمل or -أنا، --رئيس، سيتم عرض رؤوس جميع الصفحات المطلوبة. متي
يتم استخدام المصادقة ، يرسل curl أوراق اعتماده فقط إلى المضيف الأولي. اذا كان
تأخذ عملية إعادة التوجيه curl إلى مضيف مختلف ، ولن تتمكن من اعتراض ملف
المستخدم + كلمة المرور. أنظر أيضا - موقع موثوق به حول كيفية تغيير هذا. يمكنك تحديد
كمية عمليات إعادة التوجيه التي يجب اتباعها باستخدام ملف - ماكس ريدرس الخيار.

عندما يتبع curl إعادة توجيه والطلب ليس أمر GET عاديًا (على سبيل المثال POST
أو PUT) ، فسيقوم بتنفيذ الطلب التالي باستخدام GET إذا كانت استجابة HTTP 301 ،
302 أو 303. إذا كان رمز الاستجابة هو أي كود 3xx آخر ، فسوف يعيد curl إرسال
بعد الطلب باستخدام نفس الطريقة غير المعدلة.

يمكنك إخبار curl بعدم تغيير طريقة طلب non-GET إلى GET بعد 30x
للرد باستخدام الخيارات المخصصة لذلك: - بوست 301, - بوست 302 و
-الرسالة 303.

--libcurl
قم بإلحاق هذا الخيار بأي سطر أوامر curl عادي ، وستحصل على libcurl-
باستخدام شفرة المصدر C المكتوبة على الملف الذي يفعل ما يعادل ما لديك
عملية سطر الأوامر لا!

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام آخر اسم ملف محدد. (مضاف
في 7.16.1)

- معدل الحد
حدد الحد الأقصى لمعدل النقل الذي تريد استخدام curl - لكل من التنزيلات و
التحميلات. هذه الميزة مفيدة إذا كان لديك أنبوب محدود وكنت ترغب في
نقل عدم استخدام النطاق الترددي الخاص بك بالكامل. لجعله أبطأ مما هو عليه خلاف ذلك
سيكون.

يتم قياس السرعة المحددة بالبايت / ثانية ، ما لم يتم إلحاق لاحقة.
يؤدي إلحاق "k" أو "K" إلى حساب الرقم بالكيلو بايت ، أو جعله "m" أو "M"
ميغابايت ، بينما "g" أو "G" تجعلها غيغابايت. أمثلة: 200 ألف ، 3 أمتار ، 1 جي.

المعدل المحدد هو متوسط ​​السرعة المحسوبة أثناء عملية النقل بأكملها. هذا يعني
قد يستخدم هذا الضفيرة سرعات نقل أعلى في رشقات نارية قصيرة ، ولكنه يستخدم بمرور الوقت
لا يزيد عن السعر المعطى.

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

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--ميناء محلي [-num]
قم بتعيين رقم أو نطاق مفضل من أرقام المنافذ المحلية لاستخدامها في الاتصال (الاتصالات).
لاحظ أن أرقام المنافذ بطبيعتها هي مورد نادر سيكون مشغولًا في بعض الأحيان
لذا فإن تعيين هذا النطاق على شيء ضيق للغاية قد يؤدي إلى اتصال غير ضروري
فشل الإعداد. (تمت الإضافة في 7.15.2)

- موقع موثوق به
(HTTP / HTTPS) مثل -L ، --موقعك، ولكنها ستسمح بإرسال الاسم + كلمة المرور للجميع
المضيفين الذين قد يعيد الموقع التوجيه إليهم. هذا قد أو لا يقدم الأمن
خرق إذا أعاد الموقع توجيهك إلى موقع سترسل إليه مصادقتك
info (وهو نص عادي في حالة مصادقة HTTP الأساسية).

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

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- خيارات تسجيل الدخول
حدد خيارات تسجيل الدخول لاستخدامها أثناء مصادقة الخادم.

يمكنك استخدام خيارات تسجيل الدخول لتحديد خيارات بروتوكول معينة يمكن استخدامها
أثناء المصادقة. في الوقت الحالي ، يدعم فقط IMAP و POP3 و SMTP خيارات تسجيل الدخول.
لمزيد من المعلومات حول خيارات تسجيل الدخول ، يرجى مراجعة RFC 2384 و RFC 5092 و IETF
مشروع مسودة إيرهارت url-smtp-00.txt (أضيف في 7.34.0).

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- مصادقة البريد الإلكتروني
(SMTP) حدد عنوانًا واحدًا. سيتم استخدام هذا لتحديد المصادقة
عنوان (هوية) الرسالة المرسلة التي يتم ترحيلها إلى خادم آخر.

(أضيف في 7.25.0)

--البريد من
(SMTP) حدد عنوانًا واحدًا يتم إرسال البريد المحدد منه.

(أضيف في 7.20.0)

--الحد الأقصى لحجم الملف
حدد الحجم الأقصى (بالبايت) للملف المراد تنزيله. إذا كان الملف المطلوب هو
أكبر من هذه القيمة ، لن يبدأ التحويل وسيعود curl مع الخروج
كود 63.

NOTE: لا يكون حجم الملف معروفًا دائمًا قبل التنزيل ، وهذا هو الحال بالنسبة لمثل هذه الملفات
الخيار ليس له أي تأثير حتى لو انتهى نقل الملف إلى أكبر من هذا المعطى
حد. هذا يتعلق بكل من عمليات نقل FTP و HTTP.

- mail-rcpt
(SMTP) حدد عنوانًا واحدًا أو اسم مستخدم أو اسم قائمة بريدية.

عند إجراء نقل البريد ، يجب على المستلم تحديد عنوان بريد إلكتروني صالح
لإرسال البريد إلى. (تمت الإضافة في 7.20.0)

عند إجراء التحقق من العنوان (أمر VRFY) ، يجب أن يكون المستلم
المحدد كاسم المستخدم أو اسم المستخدم والمجال (وفقًا للقسم 3.5 من RFC5321).
(أضيف في 7.34.0)

عند تنفيذ قائمة بريدية قم بتوسيع (أمر EXPN) ، يجب أن يكون المستلم
المحدد باستخدام اسم القائمة البريدية ، مثل "الأصدقاء" أو "مكتب لندن".
(أضيف في 7.34.0)

- ماكس ريدرس
قم بتعيين الحد الأقصى المسموح به لمتابعات إعادة التوجيه. لو -L ، --موقعك يستخدم ،
يمكن استخدام هذا الخيار لمنع curl من اتباع عمليات إعادة التوجيه "في عبثية".
افتراضيًا ، يتم تعيين الحد على 50 عملية إعادة توجيه. اضبط هذا الخيار على -1 لجعله
لا حدود لها.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- ميتالينك
يمكن لهذا الخيار أن يخبر curl عن تحليل URI ومعالجته كملف Metalink (كلاهما
الإصدار 3 و 4 (RFC 5854) مدعومان) والاستفادة من المرايا المدرجة بداخله
لتجاوز الفشل إذا كانت هناك أخطاء (مثل عدم توفر الملف أو الخادم).
سيتحقق أيضًا من تجزئة الملف بعد اكتمال التنزيل. ميتالينك
يتم تنزيل الملف نفسه ومعالجته في الذاكرة ولا يتم تخزينه في الملف المحلي
نظام.

مثال على استخدام ملف Metalink بعيد:

حليقة - ميتالينك http://www.example.com/example.metalink

لاستخدام ملف Metalink في نظام الملفات المحلي ، استخدم بروتوكول FILE (ملف: //):

حليقة - ملف metalink: //example.metalink

يرجى ملاحظة أنه إذا تم تعطيل بروتوكول FILE ، فلا توجد طريقة لاستخدام بروتوكول محلي
ملف Metalink في وقت كتابة هذا التقرير. لاحظ أيضًا أنه إذا كان - ميتالينك و
--يشمل تستخدم معا ، --يشمل سيتم تجاهله. هذا لأن بما في ذلك
ستؤدي الرؤوس في الاستجابة إلى كسر المحلل اللغوي لـ Metalink وإذا تم تضمين الرؤوس
في الملف الموصوف في ملف Metalink ، سيفشل فحص التجزئة.

(تمت الإضافة في 7.27.0 ، إذا تم إنشاؤها مقابل مكتبة libmetalink.)

-n ، - netrc
يجعل فحص الضفيرة .netrc (_نترك على Windows) في الدليل الرئيسي للمستخدم
لاسم تسجيل الدخول وكلمة المرور. يستخدم هذا عادةً لـ FTP على Unix. إذا استخدمت مع
HTTP ، curl سيمكن مصادقة المستخدم. ارى نترك5 بروتوكول نقل الملفات1 للحصول على تفاصيل حول
تنسيق الملف. لن يشتكي Curl إذا لم يكن لدى هذا الملف الأذونات الصحيحة
(يجب ألا يكون مقروءًا عالميًا أو جماعيًا). متغير البيئة "HOME"
يستخدم للعثور على الدليل الرئيسي.

مثال سريع وبسيط للغاية عن كيفية إعداد ملف .netrc للسماح بالتجعيد إلى FTP إلى
يجب أن يكون الجهاز host.domain.com مع اسم المستخدم "نفسي" وكلمة المرور "سري"
تبدو مشابهة لـ:

آلة host.domain.com تسجيل الدخول نفسي كلمه السر سري

-N ، - لا عازلة
تعطيل التخزين المؤقت لتدفق الإخراج. في حالات العمل العادية ، سوف الضفيرة
استخدام دفق الإخراج المخزن القياسي الذي سيكون له تأثير أنه سينتج
البيانات في أجزاء ، ليس بالضرورة بالضبط عند وصول البيانات. باستخدام هذا
الخيار سيعطل هذا التخزين المؤقت.

لاحظ أن هذا هو اسم الخيار المرفوض الموثق. يمكنك بالتالي استخدام ملفات --متعادل إلى
فرض التخزين المؤقت.

- netrc- ملف
هذا الخيار مشابه لـ - netrc، فيما عدا أنك تقدم المسار (مطلق أو
نسبي) لملف netrc الذي يجب أن يستخدمه Curl. يمكنك تحديد netrc واحد فقط
ملف لكل احتجاج. إذا عدة - netrc- ملف يتم توفير الخيارات ، فقط آخر
صورة واحدة؟ سوف يستخدم. (تمت الإضافة في 7.21.5)

يتجاوز هذا الخيار أي استخدام لـ - netrc لأنها حصرية بشكل متبادل. ستكون
تلتزم أيضا - netrc- اختياري إذا تم تحديد ذلك.

- netrc- اختياري
تشبه الى حد بعيد - netrc، ولكن هذا الخيار يجعل استخدام .netrc اختياري و لا
إلزامي مثل - netrc الخيار لا.

- تفاوض
(HTTP) يمكّن مصادقة التفاوض (SPNEGO).

إذا كنت تريد تمكين التفاوض (SPNEGO) لمصادقة الوكيل ، فاستخدم
- التفاوض.

يتطلب هذا الخيار مكتبة تم إنشاؤها باستخدام دعم GSS-API أو SSPI. يستخدم -الخامس،
--الإصدار لمعرفة ما إذا كان curl الخاص بك يدعم GSS-API / SSPI و SPNEGO.

عند استخدام هذا الخيار ، يجب عليك أيضًا تقديم مزيف -u ، --المستعمل خيار للتنشيط
رمز المصادقة بشكل صحيح. إرسال "-u:" كافي كاسم المستخدم و
كلمة المرور من -u لا يتم استخدام الخيار في الواقع.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأول فقط.

--لا يحفظه
لتعطيل استخدام رسائل Keepalive على اتصال TCP ، مثل curl افتراضيًا
تمكنهم.

لاحظ أن هذا هو اسم الخيار المرفوض الموثق. يمكنك بالتالي استخدام ملفات --حافظ على حياتك
لفرض البقاء على قيد الحياة.

--لا الدورة
(SSL) تعطيل استخدام curl للتخزين المؤقت لمعرف جلسة SSL. افتراضيا جميع عمليات النقل
باستخدام ذاكرة التخزين المؤقت. لاحظ أنه بينما لا يجب أن يتأذى شيء أبدًا من خلال المحاولة
إعادة استخدام معرفات جلسة SSL ، يبدو أن هناك تطبيقات SSL معطلة في البرية
قد يتطلب منك تعطيل هذا لكي تنجح. (تمت الإضافة في 7.16.0)

لاحظ أن هذا هو اسم الخيار المرفوض الموثق. يمكنك بالتالي استخدام ملفات --معرف جلسة العمل
لفرض التخزين المؤقت لمعرف الجلسة.

--لا الوكيل
قائمة مفصولة بفواصل للمضيفين الذين لا يستخدمون وكيلاً ، إذا تم تحديد واحد. ال
فقط البدل هو حرف * واحد ، والذي يتطابق مع جميع المضيفين ، وبشكل فعال
يعطل الوكيل. يتم مطابقة كل اسم في هذه القائمة على أنه إما مجال
يحتوي على اسم المضيف أو اسم المضيف نفسه. على سبيل المثال ، سيطابق local.com
local.com و local.com:80 و www.local.com ولكن ليس www.notlocal.com. (مضاف في
7.19.4).

--ntlm (HTTP) لتمكين مصادقة NTLM. تم تصميم طريقة مصادقة NTLM بواسطة
Microsoft ويستخدم من قبل خوادم الويب IIS. إنه بروتوكول مملوك ، عكسي-
تم تصميمه من قبل أشخاص أذكياء وتم تنفيذه في حليقة بناءً على جهودهم. هذه
لا ينبغي اعتماد نوع من السلوك ، يجب عليك تشجيع كل من يستخدم
NTLM للتبديل إلى طريقة مصادقة عامة وموثقة بدلاً من ذلك ، مثل
استوعب.

إذا كنت تريد تمكين NTLM لمصادقة الوكيل ، فاستخدم --بروكسي- ntlm.

يتطلب هذا الخيار مكتبة مبنية بدعم SSL. يستخدم -الخامس، --الإصدار لمعرفة ما إذا
الضفيرة الخاصة بك تدعم NTLM.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأول فقط.

-o ، - الإخراج
كتابة الإخراج إلى بدلا من stdout. إذا كنت تستخدم {} أو [] للجلب
مستندات متعددة ، يمكنك استخدام "#" متبوعًا برقم في ملف محدد.
سيتم استبدال هذا المتغير بالسلسلة الحالية لعنوان URL الذي يتم جلبه.
كما هو الحال في:

curl http: // {one، two} .site.com -o "file_ # 1.txt"

أو استخدم عدة متغيرات مثل:

curl http: // {site، host} .host [1-5] .com -o "# 1_ # 2"

يمكنك استخدام هذا الخيار عدة مرات مثل عدد عناوين URL لديك.

انظر أيضا - إنشاء dirs خيار لإنشاء الدلائل المحلية ديناميكيًا.
سيؤدي تحديد الإخراج كـ "-" (شرطة واحدة) إلى إجبار الإخراج على القيام به
com.stdout.

-O ، -اسم-بعيد
اكتب الإخراج إلى ملف محلي يسمى مثل الملف البعيد الذي نحصل عليه. (فقط جزء الملف
من الملف البعيد ، يتم قطع المسار.)

يتم استخراج اسم الملف البعيد المراد استخدامه للحفظ من عنوان URL المحدد ، لا شيء
آخر.

نتيجة لذلك ، سيتم حفظ الملف في دليل العمل الحالي. اذا أنت
تريد حفظ الملف في دليل مختلف ، تأكد من تغيير العمل الحالي
الدليل قبل استدعاء curl بامتداد -O ، - اسم بعيد علم!

لم يتم فك تشفير عنوان URL على اسم الملف. إذا كان يحتوي على٪ 20 أو عنوان URL آخر مشفر
أجزاء من الاسم ، سينتهي بها الأمر كما هو كاسم ملف.

يمكنك استخدام هذا الخيار عدة مرات مثل عدد عناوين URL لديك.

--أوث2- حامل
(IMAP ، POP3 ، SMTP) حدد رمز الحامل لمصادقة خادم OAUTH 2.0.
يتم استخدام رمز الحامل مع اسم المستخدم الذي يمكن تحديده
كجزء من --url or -u ، --المستعمل خيارات.

تم تنسيق رمز الحامل واسم المستخدم وفقًا لـ RFC 6750.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- رأس موثق
(HTTP) رأس إضافي لتضمينه في الطلب عند إرسال HTTP إلى وكيل. يمكنك
تحديد أي عدد من الرؤوس الإضافية. هذا هو الخيار المكافئ ل -H ، - رأس
ولكن للاتصال بالوكيل فقط كما هو الحال في طلبات CONNECT عندما تريد ملف
يتم إرسال رأس منفصل إلى الوكيل إلى ما يتم إرساله إلى المضيف البعيد الفعلي.

سيتأكد curl من إرسال كل عنوان تضيفه / تستبدله بالنهاية المناسبة-
من الخط ، يجب عليك بالتالي ليس أضف ذلك كجزء من محتوى الرأس: do
لا تضيف أسطرًا جديدة أو إرجاع إلى أول السطر ، فسيؤدي ذلك إلى إفساد الأشياء من أجلك فقط.

لن يتم تضمين الرؤوس المحددة مع هذا الخيار في الطلبات التي يعرفها curl
لن يتم إرسالها إلى وكيل.

يمكن استخدام هذا الخيار عدة مرات لإضافة / استبدال / إزالة رؤوس متعددة.

(أضيف في 7.37.0)

-p ، - proxytunnel
عند استخدام وكيل HTTP (-x ، --الوكيل) ، سيؤدي هذا الخيار إلى بروتوكولات بخلاف HTTP
لمحاولة المرور عبر الوكيل بدلاً من مجرد استخدامه للقيام بمثل HTTP
عمليات. تم إجراء نهج النفق باستخدام طلب CONNECT وكيل HTTP و
يتطلب أن يسمح الوكيل بالاتصال المباشر برقم المنفذ البعيد الذي يريده حليقة
للنفق من خلال.

-P ، - منفذ ftp
(FTP) يعكس أدوار البادئ / المستمع الافتراضية عند الاتصال بـ FTP. هذه
مفتاح يجعل الضفيرة تستخدم الوضع النشط. في الممارسة العملية ، يخبر curl الخادم بـ
الاتصال مرة أخرى بالعنوان والمنفذ المحددين للعميل ، بينما يطلب الوضع الخامل
الخادم لإعداد عنوان IP والمنفذ للاتصال به. يجب
كن واحداً من:

الواجهة
مثل "eth0" لتحديد عنوان IP الخاص بالواجهة الذي تريد استخدامه (Unix
فقط)

عنوان IP
أي "192.168.10.1" لتحديد عنوان IP الدقيق

اسم المضيف
على سبيل المثال "my.host.domain" لتحديد الجهاز

- اجعل curl يختار نفس عنوان IP المستخدم بالفعل للتحكم
صلة

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير. تعطيل استخدام
PORT مع --ftp-pasv. قم بتعطيل محاولة استخدام الأمر EPRT بدلاً من PORT
باستخدام --تعطيل- eprt. EPRT هو حقًا PORT ++.

بدءًا من 7.19.5 ، يمكنك إلحاق ": [start] - [end]" يمين العنوان ، بـ
أخبر curl عن نطاق منفذ TCP المطلوب استخدامه. هذا يعني أنك تحدد نطاق منفذ ، من أ
أقل إلى رقم أعلى. يعمل رقم واحد أيضًا ، لكن لاحظ ذلك
يزيد من خطر الفشل لأن المنفذ قد لا يكون متاحا.

--يمر
(SSL / SSH) عبارة مرور المفتاح الخاص

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--المسار كما هو
أخبر curl بعدم التعامل مع تسلسل /../ or /./ في مسار URL المحدد. عادة
curl سوف يسحقهم أو يدمجهم وفقًا للمعايير ولكن مع هذا الخيار يضبطك
قل لها ألا تفعل ذلك.

(أضيف في 7.42.0)

- بوست 301
(HTTP) يخبر curl باحترام RFC 7230 / 6.4.2 وعدم تحويل طلبات POST إلى GET
الطلبات عند اتباع إعادة التوجيه 301. السلوك غير RFC موجود في كل مكان في
متصفحات الويب ، لذلك يقوم curl بالتحويل افتراضيًا للحفاظ على التناسق.
ومع ذلك ، قد يتطلب الخادم POST ليظل POST بعد إعادة التوجيه هذه.
هذا الخيار مفيد فقط عند استخدام -L ، --موقعك (أضيف في 7.17.1)

- بوست 302
(HTTP) يخبر curl باحترام RFC 7230 / 6.4.3 وعدم تحويل طلبات POST إلى GET
الطلبات عند اتباع إعادة التوجيه 302. السلوك غير RFC موجود في كل مكان في
متصفحات الويب ، لذلك يقوم curl بالتحويل افتراضيًا للحفاظ على التناسق.
ومع ذلك ، قد يتطلب الخادم POST ليظل POST بعد إعادة التوجيه هذه.
هذا الخيار مفيد فقط عند استخدام -L ، --موقعك (أضيف في 7.19.1)

- بوست 303
(HTTP) يخبر curl باحترام RFC 7230 / 6.4.4 وعدم تحويل طلبات POST إلى GET
الطلبات عند اتباع إعادة التوجيه 303. السلوك غير RFC موجود في كل مكان في
متصفحات الويب ، لذلك يقوم curl بالتحويل افتراضيًا للحفاظ على التناسق.
ومع ذلك ، قد يتطلب الخادم POST ليظل POST بعد إعادة التوجيه هذه.
هذا الخيار مفيد فقط عند استخدام -L ، --موقعك (أضيف في 7.26.0)

--بروتو
يخبر curl باستخدام البروتوكولات المدرجة لاسترجاعها الأولي. البروتوكولات
يتم تقييمها من اليسار إلى اليمين ، ومفصولة بفواصل ، وكل منها عبارة عن اسم بروتوكول أو
"all" ، مسبوقة اختياريًا بصفر أو أكثر من المُعدِّلات. المعدلات المتاحة هي:

+ السماح بهذا البروتوكول بالإضافة إلى البروتوكولات المسموح بها بالفعل (هذا هو
الافتراضي إذا لم يتم استخدام معدل).

- رفض هذا البروتوكول وإزالته من قائمة البروتوكولات المسموح بها بالفعل.

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

فمثلا:

--بروتو -قدم في الثانية يستخدم البروتوكولات الافتراضية ، لكنه يعطل بروتوكول نقل الملفات في الثانية

--بروتو -all و https و + http
يمكّن فقط http و https

--بروتو = http، https
يقوم أيضًا بتمكين http و https فقط

البروتوكولات غير المعروفة تعطي تحذيراً. هذا يسمح للبرامج النصية بالاعتماد بأمان على الوجود
قادر على تعطيل البروتوكولات التي يحتمل أن تكون خطرة ، دون الاعتماد على دعم
يتم تضمين هذا البروتوكول في curl لتجنب حدوث خطأ.

يمكن استخدام هذا الخيار عدة مرات ، وفي هذه الحالة يكون التأثير هو نفسه
ربط البروتوكولات في مثيل واحد من الخيار.

(أضيف في 7.20.2)

--بروتو الافتراضي
يحكي الضفيرة للاستخدام بروتوكول لأي عنوان URL يفتقد اسم مخطط.

على سبيل المثال:

--بروتو الافتراضي https ftp.mozilla.org
https://ftp.mozilla.org

بروتوكول غير معروف أو غير مدعوم يتسبب في حدوث خطأ CURLE_UNSUPPORTED_PROTOCOL.

لا يغير هذا الخيار بروتوكول الوكيل الافتراضي (http).

بدون هذا الخيار من شأنه أن يجعل curl تخمينًا بناءً على المضيف ، انظر --url للتفاصيل.

(أضيف في 7.45.0)

--بروتو ريدير
يخبر curl لاستخدام البروتوكولات المدرجة في إعادة التوجيه. انظر --proto لمعرفة كيفية البروتوكولات
ممثلة.

على سبيل المثال:

--proto-redir-all، http، https
السماح فقط ببروتوكول HTTP و HTTPS عند إعادة التوجيه.

بشكل افتراضي ، سيسمح curl لجميع البروتوكولات عند إعادة التوجيه باستثناء العديد من البروتوكولات المعطلة للأمان
الأسباب: نظرًا لتعطيل 7.19.4 FILE و SCP ، ومنذ 7.40.0 يتم تعطيل SMB و SMBS أيضًا
معاق. التحديد من جميع or + الكل تمكن جميع البروتوكولات الخاصة بإعادة التوجيه ، بما في ذلك تلك
معطل للأمان.

(أضيف في 7.20.2)

--بروكسي-أيوث
يخبر curl باختيار طريقة مصادقة مناسبة عند الاتصال بـ
الوكيل المعطى. قد يتسبب هذا في طلب إضافي / استجابة ذهابًا وإيابًا. (مضاف في
7.13.2)

--بروكسي الأساسية
يخبر curl لاستخدام مصادقة HTTP الأساسية عند الاتصال بملف
الوكيل. يستخدم --أساسي لتمكين HTTP Basic مع مضيف بعيد. الأساسي هو الافتراضي
يستخدم أسلوب المصادقة curl مع الوكلاء.

- هضم مؤكد
يخبر curl لاستخدام مصادقة HTTP Digest عند التواصل مع المعطى
الوكيل. يستخدم --استوعب لتمكين HTTP Digest مع مضيف بعيد.

- التفاوض
يخبر curl باستخدام مصادقة HTTP التفاوض (SPNEGO) عند الاتصال بـ
الوكيل المحدد. يستخدم - تفاوض لتمكين تفاوض HTTP (SPNEGO) مع جهاز تحكم عن بعد
مضيف. (أضيف في 7.17.1)

--بروكسي- ntlm
يخبر curl لاستخدام مصادقة HTTP NTLM عند الاتصال بالوكيل المحدد.
استعمل - نتلم لتمكين NTLM مع مضيف بعيد.

- اسم الخدمة-proxy
يتيح لك هذا الخيار تغيير اسم الخدمة لمفاوضات الوكيل.

أمثلة: - التفاوض - الوكيل - اسم الوكيل - اسم الخدمة-proxy سوف تستخدم sockd
sockd / اسم الوكيل. (أضيف في 7.43.0).

--بروكسي 1.0
استخدم وكيل HTTP 1.0 المحدد. إذا لم يتم تحديد رقم المنفذ ، فسيكون كذلك
يفترض في المنفذ 1080.

الفرق الوحيد بين هذا وخيار وكيل HTTP (-x ، --الوكيل)، هل هذا
ستحدد محاولات استخدام CONNECT عبر الوكيل بروتوكول HTTP 1.0 بدلاً من ذلك
من الافتراضي HTTP 1.1.

--pubkey
(SSH) اسم ملف المفتاح العام. يسمح لك بتقديم مفتاحك العام في هذا المنفصل
ملف.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

(اعتبارًا من 7.39.0 ، يحاول curl استخراج المفتاح العمومي تلقائيًا من ملف
ملف مفتاح خاص ، لذا فإن تمرير هذا الخيار ليس مطلوبًا بشكل عام. لاحظ أن هذا
يتطلب استخراج المفتاح العام ربط libcurl بنسخة libssh2 1.2.8
أو أعلى يكون مرتبطًا بـ OpenSSL.)

-q إذا تم استخدامه كأول معلمة في سطر الأوامر ، فإن ملف com.curlrc ملف التكوين لا
أن تقرأ وتستخدم. انظر -ك، - تكوين للحصول على تفاصيل حول ملف التكوين الافتراضي
مسار البحث.

-Q ، - اقتبس
(FTP / SFTP) أرسل أمرًا عشوائيًا إلى خادم بروتوكول نقل الملفات (FTP) أو خادم بروتوكول نقل الملفات الآمن (SFTP) البعيد. اقتبس
يتم إرسال الأوامر قبل أن يتم النقل (مباشرة بعد الأشخاص ذوي الإعاقة الأولي
الأمر في نقل FTP ، على وجه الدقة). لإصدار الأوامر بعد أ
نقل ناجح ، ابدئيهم بشرطة "-". لجعل الأوامر ترسل بعد
قام curl بتغيير دليل العمل ، مباشرة قبل أمر (أوامر) النقل ، البادئة
الأمر مع "+" (هذا مدعوم فقط لبروتوكول نقل الملفات). يمكنك تحديد أي رقم
من الأوامر. إذا أعاد الخادم فشل أحد الأوامر ، فسيتم حذف ملف
سيتم إحباط العملية. يجب عليك إرسال أوامر FTP صحيحة نحويًا مثل RFC
959 يعرف لخوادم FTP ، أو أحد الأوامر المذكورة أدناه لخوادم SFTP.
يمكن استخدام هذا الخيار عدة مرات. عند التحدث إلى خادم FTP ، قم ببادئة
الأمر بعلامة النجمة (*) لجعل curl يستمر حتى إذا فشل الأمر كما هو
ستتوقف الضفيرة الافتراضية عند الفشل الأول.

SFTP هو بروتوكول ثنائي. بخلاف FTP ، يفسر curl أوامر اقتباس SFTP
نفسها قبل إرسالها إلى الخادم. قد يتم اقتباس أسماء الملفات بنمط shell
تضمين مسافات أو أحرف خاصة. فيما يلي قائمة بجميع SFTP المدعومة
أوامر الاقتباس:

chgrp group
يقوم الأمر chgrp بتعيين معرف المجموعة للملف المسمى بواسطة معامل الملف إلى
معرف المجموعة المحدد بواسطة معامل المجموعة. معامل المجموعة هو رقم عشري
معرف مجموعة صحيح.

ملف وضع chmod
يعدل الأمر chmod وحدات وضع الملف للملف المحدد. ال
معامل الوضع هو رقم وضع عدد صحيح ثماني.

chown ملف المستخدم
يقوم الأمر chown بتعيين مالك الملف المسمى بواسطة معامل الملف إلى
معرف المستخدم المحدد بواسطة معامل المستخدم. معامل المستخدم هو رقم عشري
معرف مستخدم صحيح.

في ملف source_file target_file
ينشئ الأمران ln و symlink ارتباطًا رمزيًا في ملف target_file
يشير الموقع إلى موقع source_file.

mkdir Directory_name
يقوم الأمر mkdir بإنشاء الدليل المسمى بمعامل اسم الدليل.

pwd يُرجع الأمر pwd اسم المسار المطلق للعمل الحالي
الدليل.

إعادة تسمية المصدر الهدف
يقوم الأمر rename بإعادة تسمية الملف أو الدليل المسمى بواسطة المعامل المصدر
إلى مسار الوجهة المسمى بواسطة المعامل الهدف.

ملف rm
يقوم الأمر rm بإزالة الملف المحدد بواسطة معامل الملف.

دليل rmdir
يقوم الأمر rmdir بإزالة إدخال الدليل المحدد بواسطة الدليل
المعامل بشرط أن يكون فارغًا.

رابط الملف source_file target_file
انظر ln.

-r ، - المدى
(HTTP / FTP / SFTP / FILE) قم باسترداد نطاق بايت (أي مستند جزئي) من ملف
خادم HTTP / 1.1 أو FTP أو SFTP أو ملف محلي. يمكن تحديد النطاقات برقم
من الطرق.

0-499 يحدد أول 500 بايت

500-999 تحدد الثانية 500 بايت

-500 يحدد آخر 500 بايت

9500- يحدد البايت من الإزاحة 9500 وما بعدها

0-0 ، -1 يحدد البايت الأول والأخير فقط (*) (HTTP)

100-199,500-599
يحدد نطاقين منفصلين 100 بايت (*) (HTTP)

(*) = لاحظ أن هذا سيؤدي إلى قيام الخادم بالرد باستجابة متعددة الأجزاء!

فقط الأحرف الرقمية (0-9) صالحة في حقلي "البدء" و "الإيقاف" في
بناء جملة النطاق "بدء-إيقاف". إذا تم تقديم حرف غير رقمي في النطاق ، فسيتم إنشاء ملف
ستكون استجابة الخادم غير محددة ، اعتمادًا على تكوين الخادم.

يجب أن تدرك أيضًا أن العديد من خوادم HTTP / 1.1 لا تحتوي على هذه الميزة
مُمكّن ، لذلك عندما تحاول الحصول على نطاق ، ستحصل بدلاً من ذلك على الكل
وثيقة.

تدعم تنزيلات نطاق FTP و SFTP فقط بناء الجملة البسيط "بدء-إيقاف"
(اختياريًا مع حذف أحد الأرقام). يعتمد استخدام FTP على FTP الممتد
الأمر الحجم.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-R ، - الوقت البعيد
عند استخدامه ، سيؤدي ذلك إلى محاولة التفاف لمعرفة الطابع الزمني لجهاز التحكم عن بُعد
الملف ، وإذا كان ذلك متاحًا ، فاجعل الملف المحلي يحصل على نفس الطابع الزمني.

- ملف عشوائي
(SSL) حدد اسم المسار لملف يحتوي على ما سيتم اعتباره عشوائيًا
البيانات. يتم استخدام البيانات لبذر المحرك العشوائي لاتصالات SSL. انظر أيضا
--ملف الخيار.

--raw (HTTP) عند استخدامه ، فإنه يعطل كل عمليات فك تشفير HTTP الداخلية للمحتوى أو نقله
الترميز وبدلاً من ذلك يجعلها تمر دون تغيير ، خام. (أضيف في 7.16.2)

- بعيد اسم كل
يغير هذا الخيار الإجراء الافتراضي لجميع عناوين URL المحددة ليتم التعامل معها كما لو
-O ، - اسم بعيد تم استخدامها لكل واحد. لذلك إذا كنت ترغب في تعطيل ذلك لملف
محدد بعد URL - بعيد اسم كل تم استخدامه ، يجب عليك استخدام "-o -" أو --لا-
اسم بعيد. (أضيف في 7.19.0)

--حل
قم بتوفير عنوان مخصص لمضيف معين وزوج منفذ. باستخدام هذا يمكنك
اجعل طلبات (طلبات) curl تستخدم عنوانًا محددًا وتمنع خلاف ذلك
عنوان حل عادة لاستخدامه. اعتبرها نوعا من / الخ / المضيفين البديل
المقدمة في سطر الأوامر. يجب أن يكون رقم المنفذ هو الرقم المستخدم لـ
بروتوكول محدد سيتم استخدام المضيف من أجله. هذا يعني أنك بحاجة إلى عدة إدخالات إذا
تريد تقديم عنوان لنفس المضيف ولكن لمنافذ مختلفة.

يمكن استخدام هذا الخيار عدة مرات لإضافة العديد من أسماء المضيف لحلها.

(أضيف في 7.21.3)

- إعادة
إذا تم إرجاع خطأ عابر عندما يحاول curl إجراء نقل ، فسيتم ذلك
أعد المحاولة هذا العدد من المرات قبل الاستسلام. ضبط الرقم على 0 يجعل curl يفعل
لا توجد محاولات لإعادة المحاولة (وهو الإعداد الافتراضي). خطأ عابر يعني إما: مهلة ، FTP
رمز استجابة 4xx أو رمز استجابة HTTP 5xx.

عندما يكون curl على وشك إعادة محاولة النقل ، سينتظر أولاً ثانية واحدة ثم
ستضاعف جميع المحاولات القادمة وقت الانتظار حتى يصل إلى 10 دقائق
والذي سيكون وقتئذٍ التأخير بين باقي محاولات إعادة المحاولة. باستخدام - إعادة -
تأخير تقوم بتعطيل خوارزمية التراجع الأسية هذه. أنظر أيضا --ريتري ماكس الوقت إلى
تحديد الوقت الإجمالي المسموح به لعمليات إعادة المحاولة. (أضيف في 7.12.3)

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- رجوع التأخير
اجعل وضع curl في وضع السكون هذا مقدار الوقت قبل كل إعادة محاولة عند فشل النقل
مع خطأ عابر (يغير خوارزمية وقت التراجع الافتراضية بين
يعيد المحاولة). هذا الخيار مثير للاهتمام فقط إذا - إعادة يستخدم أيضا. تحديد هذا
التأخير إلى الصفر سيجعل الضفيرة تستخدم وقت التراجع الافتراضي. (أضيف في 7.12.3)

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--ريتري ماكس الوقت
تتم إعادة تعيين مؤقت إعادة المحاولة قبل محاولة النقل الأولى. ستتم إعادة المحاولات كـ
المعتاد (انظر - إعادة) طالما أن المؤقت لم يصل إلى هذا الحد المعين. تنويه
أنه إذا لم يصل المؤقت إلى الحد الأقصى ، فسيتم تقديم الطلب وأثناء ذلك
أداء ، قد يستغرق وقتا أطول من هذه الفترة الزمنية المحددة. لتقييد واحد
طلب الحد الأقصى من الوقت ، واستخدام م ، --أقصى وقت. اضبط هذا الخيار على صفر لعدم انتهاء المهلة
يعيد المحاولة. (أضيف في 7.12.3)

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-س ، - صامت
الوضع الصامت أو الهادئ. لا تظهر مقياس التقدم أو رسائل الخطأ. يجعل الضفيرة
كتم الصوت. سيستمر في إخراج البيانات التي تطلبها ، وربما حتى إلى ملف
المحطة / stdout ما لم تقم بإعادة توجيهه.

--sasl-ir
تفعيل الاستجابة الأولية في مصادقة SASL. (أضيف في 7.31.0)

--اسم الخدمة
يتيح لك هذا الخيار تغيير اسم الخدمة لـ SPNEGO.

أمثلة: - التفاوض --اسم الخدمة قد يستخدم sockd اسم خادم / sockd. (مضاف في
7.43.0).

-S ، - إظهار الخطأ
عند استخدامها مع -s يجعل curl يظهر رسالة خطأ إذا فشل.

--ssl (FTP، POP3، IMAP، SMTP) حاول استخدام SSL / TLS للاتصال. يعود إلى غير-
اتصال آمن إذا كان الخادم لا يدعم SSL / TLS. أنظر أيضا --ftp-ssl-
مراقبة و --ssl-reqd لمستويات مختلفة من التشفير المطلوب. (مضاف في
7.20.0)

كان هذا الخيار يُعرف سابقًا باسم --ftp-ssl (أضيف في 7.11.0). يمكن أن اسم الخيار
لا يزال مستخدمًا ولكن ستتم إزالته في إصدار لاحق.

--ssl-reqd
(FTP ، POP3 ، IMAP ، SMTP) يتطلب SSL / TLS للاتصال. ينهي
الاتصال إذا كان الخادم لا يدعم SSL / TLS. (تمت الإضافة في 7.20.0)

كان هذا الخيار يُعرف سابقًا باسم --ftp-ssl-reqd (تمت إضافته في 7.15.5). هذا الخيار
لا يزال من الممكن استخدام الاسم ولكن ستتم إزالته في إصدار لاحق.

--ssl-allow-beast
(SSL) يخبر هذا الخيار curl بعدم التغلب على ثغرة أمنية في SSL3 و
تُعرف بروتوكولات TLS1.0 باسم BEAST. إذا لم يتم استخدام هذا الخيار ، فقد تستخدم طبقة SSL
الحلول المعروفة بأنها تسبب مشاكل التشغيل البيني مع بعض SSL الأقدم
تطبيقات. تحذير: يؤدي هذا الخيار إلى تخفيف أمان SSL ، وذلك باستخدام هذا الخيار
علم تسأل عن ذلك بالضبط. (تمت الإضافة في الإصدار 7.25.0)

--ssl-no-revocate
(WinSSL) يخبر هذا الخيار curl بتعطيل عمليات فحص إبطال الشهادة. تحذير:
يؤدي هذا الخيار إلى فك أمان طبقة المقابس الآمنة ، وباستخدام هذه العلامة تطلبها بالضبط
الذي - التي. (أضيف في 7.44.0)

- الجوارب 4
استخدم بروكسي SOCKS4 المحدد. إذا لم يتم تحديد رقم المنفذ ، فمن المفترض
في المنفذ 1080. (تمت الإضافة في 7.15.2)

يتجاوز هذا الخيار أي استخدام سابق لـ -x ، --الوكيل، لأنهما متبادلان
الحصري.

منذ 7.21.7 ، يعد هذا الخيار غير ضروري حيث يمكنك تحديد وكيل socks4 باستخدام
-x ، --الوكيل باستخدام socks4: // بروتوكول بادئة.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- الجوارب
استخدم بروكسي SOCKS4a المحدد. إذا لم يتم تحديد رقم المنفذ ، فمن المفترض
في المنفذ 1080. (تمت الإضافة في 7.18.0)

يتجاوز هذا الخيار أي استخدام سابق لـ -x ، --الوكيل، لأنهما متبادلان
الحصري.

منذ 7.21.7 ، يعد هذا الخيار غير ضروري حيث يمكنك تحديد وكيل socks4a باستخدام
-x ، --الوكيل باستخدام socks4a: // بادئة البروتوكول.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--socks5-hostname
استخدم بروكسي SOCKS5 المحدد (ودع الوكيل يحل اسم المضيف). إذا كان
لم يتم تحديد رقم المنفذ ، ومن المفترض أن يكون عند المنفذ 1080. (تمت الإضافة في 7.18.0)

يتجاوز هذا الخيار أي استخدام سابق لـ -x ، --الوكيل، لأنهما متبادلان
الحصري.

منذ 7.21.7 ، يعد هذا الخيار غير ضروري حيث يمكنك تحديد اسم مضيف socks5
الوكيل مع -x ، --الوكيل باستخدام socks5h: // بادئة البروتوكول.

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

- الجوارب 5
استخدم بروكسي SOCKS5 المحدد - ولكن قم بحل اسم المضيف محليًا. إذا كان المنفذ
الرقم غير محدد ، فمن المفترض عند المنفذ 1080.

يتجاوز هذا الخيار أي استخدام سابق لـ -x ، --الوكيل، لأنهما متبادلان
الحصري.

منذ 7.21.7 ، يعد هذا الخيار غير ضروري حيث يمكنك تحديد وكيل socks5 باستخدام
-x ، --الوكيل باستخدام socks5: // بروتوكول بادئة.

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

هذا الخيار (وكذلك - الجوارب 4) لا يعمل مع IPV6 أو FTPS أو LDAP.

- الجوارب 5-gssapi- الخدمة
اسم الخدمة الافتراضي لخادم socks هو rcmd / server-fqdn. هذا الخيار يسمح
لك لتغييره.

أمثلة: --socks5 proxy-name - الجوارب 5-gssapi- الخدمة قد يستخدم sockd sockd / proxy-
الاسم - اسم الوكيل الجوارب5 - الجوارب 5-gssapi- الخدمة سيستخدم sockd / الاسم الحقيقي
sockd / الاسم الحقيقي للحالات التي لا يتطابق فيها اسم الوكيل مع الاسم الأساسي.
(أضيفت في 7.19.4).

- الجوارب 5-gssapi-nec
يتم التفاوض على وضع الحماية كجزء من مفاوضات GSS-API. رد RFC 1961 يقول
في القسم 4.3 / 4.4 يجب حمايته ، لكن تنفيذ مرجع NEC
لا. الخيار - الجوارب 5-gssapi-nec يسمح بالتبادل غير المحمي لـ
التفاوض على وضع الحماية. (أضيفت في 7.19.4).

- ستدير
إعادة توجيه جميع عمليات الكتابة إلى stderr إلى الملف المحدد بدلاً من ذلك. إذا كان اسم الملف هو ملف
عادي "-" ، تمت كتابته بدلاً من ذلك إلى stdout.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-t ، - خيار telnet
قم بتمرير الخيارات إلى بروتوكول telnet. الخيارات المدعومة هي:

TTYPE = يضبط نوع المحطة.

XDISPLOC = يضبط موقع العرض X.

NEW_ENV = يحدد متغير البيئة.

-T ، - تحميل ملف
يؤدي ذلك إلى نقل الملف المحلي المحدد إلى عنوان URL البعيد. إذا لم يكن هناك ملف جزء
في عنوان URL المحدد ، سيُلحق Curl اسم الملف المحلي. لاحظ أنه يجب عليك استخدام
لاحقًا / في الدليل الأخير ليثبت حقًا لـ Curl أنه لا يوجد ملف
سيعتقد name أو curl أن اسم الدليل الأخير هو اسم الملف البعيد لـ
استعمال. سيؤدي ذلك على الأرجح إلى فشل عملية التحميل. إذا تم استخدام هذا على
خادم HTTP (S) ، سيتم استخدام الأمر PUT.

استخدم اسم الملف "-" (شرطة واحدة) لاستخدام stdin بدلاً من ملف معين.
بالتناوب ، اسم الملف "." (فترة واحدة) يمكن تحديدها بدلاً من "-" إلى
استخدم stdin في وضع عدم الحظر للسماح بقراءة إخراج الخادم أثناء تشغيل stdin
مرفوع.

يمكنك تحديد واحد -T لكل عنوان URL في سطر الأوامر. كل زوج -T + URL
يحدد ما سيتم تحميله وأين. يدعم curl أيضًا "globbing" لـ -T
الحجة ، مما يعني أنه يمكنك تحميل ملفات متعددة إلى عنوان URL واحد باستخدام امتداد
نفس نمط globbing لعنوان URL المدعوم في عنوان URL ، مثل هذا:

curl -T "{file1 ، file2}" http://www.uploadtothissite.com

أو حتى

curl -T "img [1-1000] .png" تحميل = "كسول" ftp://ftp.picturemania.com/upload/

--tcp-nodelay
قم بتشغيل خيار TCP_NODELAY. انظر curl_easy_setopt3 صفحة الرجل للحصول على التفاصيل
حول هذا الخيار. (تمت الإضافة في الإصدار 7.11.2)

--tftp-blksize
(TFTP) قم بتعيين خيار TFTP BLKSIZE (يجب أن يكون> ​​512). هذا هو حجم الكتلة التي تجعد
سيحاول استخدامها عند نقل البيانات من وإلى خادم TFTP. بشكل افتراضي 512
سيتم استخدام البايت.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

(أضيف في 7.20.0)

--tlsauthtype
قم بتعيين نوع مصادقة TLS. حاليًا ، الخيار الوحيد المدعوم هو "SRP" ، لـ
TLS-SRP (RFC 5054). لو --tlsuser و --tlspassword محددة ولكن --tlsauthtype
ليست كذلك ، ثم هذا الخيار الافتراضي "SRP". (أضيف في 7.21.4)

--tlspassword
قم بتعيين كلمة مرور للاستخدام مع طريقة مصادقة TLS المحددة مع
--tlsauthtype. يتطلب أن --tlsuser يتم تعيينها أيضًا. (أضيف في 7.21.4)

--tlsuser
قم بتعيين اسم مستخدم للاستخدام مع طريقة مصادقة TLS المحددة مع
--tlsauthtype. يتطلب أن --tlspassword يتم تعيينها أيضًا. (أضيف في 7.21.4)

--tlsv1.0
(SSL) يفرض على curl استخدام TLS الإصدار 1.0 عند التفاوض مع خادم TLS بعيد.
(أضيف في 7.34.0)

--tlsv1.1
(SSL) يفرض على curl استخدام TLS الإصدار 1.1 عند التفاوض مع خادم TLS بعيد.
(أضيف في 7.34.0)

--tlsv1.2
(SSL) يفرض على curl استخدام TLS الإصدار 1.2 عند التفاوض مع خادم TLS بعيد.
(أضيف في 7.34.0)

- ترميز TR
(HTTP) اطلب استجابة ترميز نقل مضغوطة باستخدام إحدى الخوارزميات
curl يدعم ، ويفك ضغط البيانات أثناء استلامها.

(أضيف في 7.21.6)

--أثر
يتيح التفريغ الكامل للتتبع لجميع البيانات الواردة والصادرة ، بما في ذلك الوصف
المعلومات ، إلى ملف الإخراج المحدد. استخدم "-" كاسم ملف لإرسال الإخراج
إلى stdout.

يتجاوز هذا الخيار الاستخدامات السابقة لـ -الخامس، - الإسراف or --تتبع أسكي.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--تتبع- ASCII
يتيح التفريغ الكامل للتتبع لجميع البيانات الواردة والصادرة ، بما في ذلك الوصف
المعلومات ، إلى ملف الإخراج المحدد. استخدم "-" كاسم ملف لإرسال الإخراج
إلى stdout.

هذا مشابه جدا ل --أثر، لكنه يترك الجزء السداسي ويظهر فقط ملف
جزء ASCII من التفريغ. إنه يجعل الإخراج أصغر قد يكون من الأسهل قراءته
بشر غير مدربين.

يتجاوز هذا الخيار الاستخدامات السابقة لـ -الخامس، - الإسراف or --أثر.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- وقت التتبع
يضيف طابعًا زمنيًا مسبقًا لكل خط تتبع أو خط مطول يتم عرضه. (مضاف في
7.14.0)

- مأخذ يونيكس
(HTTP) قم بالاتصال من خلال مقبس مجال Unix هذا ، بدلاً من استخدام الشبكة.
(أضيف في 7.40.0)

-u، --user
حدد اسم المستخدم وكلمة المرور لاستخدامهما لمصادقة الخادم. يتجاوز -ن،
- netrc و - netrc- اختياري.

إذا قمت ببساطة بتحديد اسم المستخدم ، فسيطالبك curl بكلمة مرور.

يتم تقسيم اسم المستخدم وكلمات المرور على النقطتين الأولى ، مما يجعلها
من المستحيل استخدام نقطتين في اسم المستخدم مع هذا الخيار. كلمة المرور يمكن ،
ما يزال.

عند استخدام Kerberos V5 مع خادم يعمل بنظام Windows ، يجب عليك تضمين Windows
اسم المجال في اسم المستخدم ، حتى يتمكن الخادم من الحصول على ملف
تذكرة Kerberos. إذا لم تقم بذلك ، فقد تفشل عملية اتصال المصادقة الأولية.

عند استخدام NTLM ، يمكن تحديد اسم المستخدم ببساطة كاسم مستخدم ، بدون
المجال ، إذا كان هناك مجال واحد ومجموعة واحدة في الإعداد الخاص بك على سبيل المثال.

لتحديد اسم المجال ، استخدم إما اسم تسجيل الدخول من المستوى الأدنى أو UPN (User Principal
Name) التنسيقات. على سبيل المثال ، EXAMPLE \ user and [البريد الإلكتروني محمي] على التوالي.

إذا كنت تستخدم ملف ثنائي curl ممكّن لـ Windows SSPI وقمت بتنفيذ Kerberos V5 ، تفاوض ،
مصادقة NTLM أو Digest ، ثم يمكنك إخبار curl بتحديد اسم المستخدم و
كلمة المرور من بيئتك عن طريق تحديد نقطتين مع هذا الخيار: "-u
: ".

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-U ، - proxy-user
حدد اسم المستخدم وكلمة المرور لاستخدامهما لمصادقة الوكيل.

إذا كنت تستخدم ملف ثنائي curl ممكّن لـ Windows SSPI وقم بإجراء تفاوض أو NTLM
المصادقة ثم يمكنك إخبار curl بتحديد اسم المستخدم وكلمة المرور من
بيئتك عن طريق تحديد نقطتين مع هذا الخيار: "-U:".

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

--url
حدد عنوان URL لجلبه. يكون هذا الخيار مفيدًا في الغالب عندما تريد تحديد عناوين URL
في ملف التكوين.

إذا كان عنوان URL يفتقد اسم مخطط (مثل "http: //" أو "ftp: //" وما إلى ذلك) إذن
سيجري curl تخمينًا بناءً على المضيف. إذا تطابق اسم المجال الفرعي الأبعد
DICT أو FTP أو IMAP أو LDAP أو POP3 أو SMTP ثم سيتم استخدام هذا البروتوكول ، وإلا HTTP
سوف يستخدم. نظرًا لأنه يمكن تعطيل التخمين 7.45.0 عن طريق تعيين بروتوكول افتراضي ،
انظر تعريف --بروتو الافتراضي للتفاصيل.

يمكن استخدام هذا الخيار في أي عدد من المرات. للتحكم في مكان كتابة عنوان URL هذا ،
استخدم ال -o ، --انتاج أو ال -O ، - اسم بعيد خيارات.

-v ، - الإسراف
كن أكثر إسهاما / ثرثارة أثناء العملية. مفيد في التصحيح والرؤية
ما الذي يحدث "تحت الغطاء". السطر الذي يبدأ بـ ">" يعني إرسال "بيانات الرأس"
بواسطة curl ، تعني "<" "بيانات الرأس" التي يتم تلقيها بواسطة curl والتي تكون مخفية في الحالات العادية ،
والخط الذي يبدأ بـ "*" يعني المعلومات الإضافية التي يوفرها curl.

لاحظ أنه إذا كنت تريد فقط رؤوس HTTP في الإخراج ، -أنا، --يشمل قد يكون ال
الخيار الذي تبحث عنه.

إذا كنت تعتقد أن هذا الخيار لا يزال لا يوفر لك تفاصيل كافية ، ففكر في استخدام
--أثر or --تتبع أسكي بدلا من ذلك.

يتجاوز هذا الخيار الاستخدامات السابقة لـ --تتبع أسكي or --أثر.

استعمل -س، --صامتة لجعل الضفيرة هادئة.

-w ، - الكتابة
جعل معلومات عرض curl على stdout بعد اكتمال النقل. التنسيق هو ملف
سلسلة قد تحتوي على نص عادي ممزوج بأي عدد من المتغيرات. التنسيق
يمكن تحديدها على أنها "سلسلة" حرفية ، أو يمكنك قراءة curl التنسيق من ملف
ملف مع "filename" ولإخبار curl لقراءة التنسيق من stdin تكتبه
"@ -".

سيتم استبدال المتغيرات الموجودة في تنسيق الإخراج بالقيمة أو النص
الذي يعتقده الضفيرة مناسبًا ، كما هو موضح أدناه. تم تحديد جميع المتغيرات كـ
٪ {variable_name} ولإخراج٪ عادي ، فقط اكتبهم كـ ٪٪. يمكنك الإخراج
سطر جديد باستخدام \ n ، حرف إرجاع بـ \ r ومسافة علامة جدولة بـ \ t.

NOTE: ٪ -symbol هو رمز خاص في بيئة win32 ، حيث كل شيء
يجب مضاعفة تكرارات٪ عند استخدام هذا الخيار.

المتغيرات المتاحة هي:

CONTENT_TYPE نوع محتوى المستند المطلوب ، إن وجد.

اسم الملف ساري المفعول
اسم الملف النهائي الذي يكتبه curl. هذا فقط
مفيد إذا طلب من curl الكتابة إلى ملف بامتداد - اسم بعيد
or --انتاج اختيار. إنها مفيدة للغاية عند دمجه مع امتداد
- اسم رأس بعيد اختيار. (تمت الإضافة في الإصدار 7.25.1)

ftp_entry_path انتهى مسار التفاف المسار الأولي عند تسجيل الدخول إلى FTP البعيد
الخادم. (أضيف في 7.15.4)

http_code رمز الاستجابة الرقمية الذي تم العثور عليه في آخر استرداد
نقل HTTP (S) أو FTP (s). في 7.18.2 الاسم المستعار رد_كود وكان
أضيفت لإظهار نفس المعلومات.

http_connect الكود العددي الذي تم العثور عليه في الرد الأخير (من a
الوكيل) لطلب curl CONNECT. (أضيف في 7.12.4)

local_ip عنوان IP للنهاية المحلية لآخر اتصال تم إجراؤه
- يمكن أن يكون إما IPv4 أو IPv6 (تمت الإضافة في 7.29.0)

ميناء محلي رقم المنفذ المحلي لآخر اتصال تم إجراؤه (تمت إضافته بتنسيق
7.29.0)

عدد_وصلات عدد الوصلات الجديدة التي تم إجراؤها في عملية النقل الأخيرة. (مضاف في
7.12.3)

عدد_إعادة التوجيهات عدد عمليات إعادة التوجيه التي تم اتباعها في الطلب. (مضاف في
7.12.3)

إعادة توجيه URL عند إجراء طلب HTTP بدون -L لاتباع عمليات إعادة التوجيه ، يكون هذا
متغير سيعرض عنوان URL الفعلي إعادة توجيه سوف يأخذك إلى.
(أضيف في 7.18.2)

الملكية الفكرية عن بعد يمكن أن يكون عنوان IP البعيد لآخر اتصال تم
إما IPv4 أو IPv6 (تمت إضافته في 7.29.0)

المنفذ البعيد رقم المنفذ البعيد لآخر اتصال تم (تمت الإضافة
في 7.29.0)

size_download العدد الإجمالي للبايتات التي تم تنزيلها.

حجم_رأس المقدار الإجمالي للبايت للرؤوس التي تم تنزيلها.

طلب الحجم المبلغ الإجمالي للبايتات التي تم إرسالها في طلب HTTP.

size_upload المبلغ الإجمالي للبايتات التي تم تحميلها.

speed_download متوسط ​​سرعة التنزيل التي يقاسها التجعيد للإكمال
تحميل. بايت في الثانية.

speed_upload متوسط ​​سرعة التحميل التي تم قياسها للتحميل الكامل.
بايت في الثانية.

ssl_verify_result
نتيجة التحقق من شهادة نظير SSL التي كانت
طلب. 0 يعني أن التحقق كان ناجحًا. (مضاف في
7.19.0)

time_appconnect
الوقت ، بالثواني ، الذي استغرقه من البداية حتى SSL / SSH / إلخ
تم إكمال الاتصال / المصافحة بالمضيف البعيد. (مضاف في
7.19.0)

ربط الوقت الوقت ، بالثواني ، الذي استغرقه من البداية حتى اتصال TCP
إلى المضيف البعيد (أو الوكيل).

الوقت_البحث
الوقت ، بالثواني ، استغرق من البداية حتى الاسم
تم الانتهاء من حل.

الوقت_تفسير
الوقت ، بالثواني ، المستغرق من البداية حتى نقل الملف
كان على وشك البدء. وهذا يشمل جميع أوامر ما قبل النقل و
المفاوضات الخاصة بالبروتوكول (البروتوكولات) المعين
متورط.

الوقت_إعادة التوجيه الوقت ، بالثواني ، الذي استغرقته جميع خطوات إعادة التوجيه بما في ذلك الاسم
البحث ، الاتصال ، النقل المسبق والتحويل قبل النهائي
بدأت الصفقة. يظهر time_redirect التنفيذ الكامل
حان الوقت لعمليات إعادة التوجيه المتعددة. (أضيف في 7.12.3)

time_starttransfer
الوقت ، بالثواني ، استغرق من البداية حتى البايت الأول
كان على وشك أن يتم نقله. يتضمن ذلك time_pretransfer و
أيضًا الوقت الذي يحتاجه الخادم لحساب النتيجة.

الوقت_المجموع الوقت الإجمالي ، بالثواني ، الذي استغرقته العملية الكاملة. الوقت
سيتم عرضها بدقة مللي ثانية.

url_efficiency آخر عنوان URL تم جلبه. هذا هو الأكثر أهمية إذا كنت
قال لـ curl أن يتبع الموقع: الرؤوس.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-x ، --proxy <[protocol: //] [user: password @] proxyhost [: port]>
استخدم الوكيل المحدد.

يمكن تحديد سلسلة الوكيل ببروتوكول: // بادئة لتحديد البديل
البروتوكولات الوكيل. استخدم socks4: // أو socks4a: // أو socks5: // أو socks5h: // لطلب
إصدار SOCKS محدد للاستخدام. لم يتم تحديد بروتوكول ، http: // وكل الآخرين
سيتم التعامل مع وكلاء HTTP. (تمت إضافة دعم البروتوكول في curl 7.21.7)

إذا لم يتم تحديد رقم المنفذ في سلسلة الوكيل ، فمن المفترض أن يكون 1080.

يتجاوز هذا الخيار متغيرات البيئة الحالية التي تقوم بتعيين الوكيل للاستخدام. لو
هناك متغير بيئة يقوم بتعيين وكيل ، يمكنك تعيين الوكيل على "" إلى
تجاوزها.

ستكون جميع العمليات التي يتم إجراؤها عبر وكيل HTTP بشفافية
تم تحويله إلى HTTP. هذا يعني أن عمليات بروتوكول معينة قد لا تكون كذلك
متوفرة. ليس هذا هو الحال إذا كان يمكنك المرور عبر الوكيل ، مثل واحد مع
ال -p ، - proxytunnel الخيار.

المستخدم وكلمة المرور اللذين قد يتم توفيرهما في سلسلة الوكيل يتم فك تشفير عنوان URL بواسطة
لفة. يسمح لك هذا بتمرير الأحرف الخاصة مثل @ باستخدام٪ 40 أو تمرير
في نقطتين مع٪ 3 أ.

يمكن تحديد مضيف الوكيل بنفس الطريقة تمامًا مثل بيئة الوكيل
المتغيرات ، بما في ذلك بادئة البروتوكول (http: //) والمستخدم المضمن +
كلمه السر.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-X ، - طلب
(HTTP) يحدد طريقة طلب مخصصة لاستخدامها عند الاتصال بـ HTTP
الخادم. سيتم استخدام طريقة الطلب المحددة بدلاً من الطريقة بخلاف ذلك
مستخدمة (التي يتم تعيينها افتراضيًا على GET). اقرأ مواصفات HTTP 1.1 للحصول على التفاصيل و
تفسيرات. تتضمن طلبات HTTP الإضافية الشائعة PUT و DELETE ، لكنها مرتبطة
تقنيات مثل WebDAV تقدم PROPFIND و COPY و MOVE والمزيد.

عادة لا تحتاج هذا الخيار. جميع أنواع طلبات GET و HEAD و POST و PUT
بدلاً من ذلك ، يتم استدعاؤها باستخدام خيارات سطر أوامر مخصصة.

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

سيتم استخدام سلسلة الطريقة التي قمت بتعيينها باستخدام -X لجميع الطلبات ، والتي إذا كنت تريد ذلك
استخدام سبيل المثال -L ، --موقعك قد يسبب آثارًا جانبية غير مقصودة عندما لا يحدث تجعيد الشعر
تغيير طريقة الطلب وفقًا لرموز استجابة HTTP 30x - وما شابه ذلك.

(FTP) يحدد أمر FTP مخصصًا لاستخدامه بدلاً من LIST عند عمل قوائم الملفات
مع FTP.

(POP3) يحدد أمر POP3 مخصصًا لاستخدامه بدلاً من LIST أو RETR. (مضاف في
7.26.0)

(IMAP) يحدد أمر IMAP مخصص لاستخدامه بدلاً من LIST. (أضيف في 7.30.0)

يحدد (SMTP) أمر SMTP مخصصًا لاستخدامه بدلاً من HELP أو VRFY. (مضاف في
7.34.0)

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

- xattr
عند حفظ الإخراج إلى ملف ، يخبر هذا الخيار curl بتخزين بيانات تعريف معينة للملف
في سمات الملف الممتد. حاليًا ، يتم تخزين عنوان URL في xdg.origin.url
بالنسبة إلى HTTP ، يتم تخزين نوع المحتوى في سمة mime_type. لو
نظام الملفات لا يدعم السمات الموسعة ، يتم إصدار تحذير.

-ص ، -وقت السرعة
إذا كان التنزيل أبطأ من بايتات حد السرعة في الثانية أثناء وقت السرعة
فترة ، يتم إحباط التنزيل. إذا تم استخدام وقت السرعة ، فإن حد السرعة الافتراضي
سيكون 1 ما لم يتم تعيينه بـ -Y.

يتحكم هذا الخيار في عمليات النقل وبالتالي لن يؤثر على عمليات الاتصال البطيئة وما إلى ذلك. إذا كان هذا هو الحال
مصدر قلق بالنسبة لك ، جرب --ربط مهلة الخيار.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-ص ، - حد السرعة
إذا كان التنزيل أبطأ من هذه السرعة المحددة (بالبايت في الثانية) لوقت السرعة
ثواني يتم إحباطها. يتم ضبط وقت السرعة مع -y و 30 إذا لم يتم تحديدها.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-z ، - شرطي الوقت |
(HTTP / FTP) اطلب ملفًا تم تعديله بعد الوقت المحدد و
التاريخ أو التاريخ الذي تم تعديله قبل ذلك الوقت. ال يمكن ان يكون
كل أنواع سلاسل التاريخ أو إذا لم تتطابق مع أي سلاسل داخلية ، يتم اعتبارها على أنها
اسم ملف ويحاول الحصول على تاريخ التعديل (mtime) من في حين أن. ارى
ال curl_getdate3 صفحات الرجل للحصول على تفاصيل التعبير عن التاريخ.

ابدأ تعبير التاريخ بشرطة (-) لجعله يطلب مستندًا
أقدم من التاريخ / الوقت المحدد ، الافتراضي هو مستند أحدث من
التاريخ / الوقت المحدد.

إذا تم استخدام هذا الخيار عدة مرات ، فسيتم استخدام الخيار الأخير.

-h ، - مساعدة
مساعدة الاستخدام. هذا يسرد جميع خيارات سطر الأوامر الحالية مع وصف موجز.

- م ، - يدوي
كتيب. اعرض نص المساعدة الضخم.

-V ، - الإصدار
يعرض معلومات حول curl وإصدار libcurl الذي يستخدمه.

يتضمن السطر الأول النسخة الكاملة من curl و libcurl والجهات الخارجية الأخرى
مكتبات مرتبطة بالملف القابل للتنفيذ.

يعرض السطر الثاني (يبدأ بـ "البروتوكولات:") كافة البروتوكولات التي يبلغ عنها libcurl
من أجل دعم.

يعرض السطر الثالث (يبدأ بـ "الميزات:") ميزات محددة يقدمها libcurl إلى
يعرض. تشمل الميزات المتوفرة:

IPv6 يمكنك استخدام IPv6 مع هذا.

يتم دعم krb4 Krb4 لبروتوكول نقل الملفات.

يتم دعم إصدارات SSL SSL من البروتوكولات المختلفة ، مثل HTTPS و FTPS و POP3S
وما إلى ذلك وهلم جرا.

libz يتم دعم فك الضغط التلقائي للملفات المضغوطة عبر HTTP.

يتم دعم مصادقة NTLM NTLM.

تصحيح الأخطاء يستخدم هذا الضفيرة libcurl المبني مع Debug. هذا يتيح المزيد من تعقب الأخطاء
وتصحيح أخطاء الذاكرة وما إلى ذلك لمطوري curl فقط!

AsynchDNS
يستخدم هذا الضفيرة حلول اسم غير متزامنة. يمكن أن يكون حل الاسم غير المتزامن
يتم ذلك باستخدام إما c-ares أو الخلفيات الخلفية لوحدة الحل الملولب.

يتم دعم مصادقة SPNEGO SPNEGO.

Largefile
يدعم هذا الضفيرة عمليات نقل الملفات الكبيرة والملفات الأكبر من 2 جيجابايت.

IDN هذا curl يدعم IDN - أسماء النطاقات الدولية.

واجهة برمجة تطبيقات GSS
يتم دعم GSS-API.

يتم دعم SSPI SSPI.

TLS-سام رينسى
يتم دعم مصادقة SRP (كلمة المرور الآمنة عن بُعد) لـ TLS.

تم تضمين دعم HTTP2 HTTP / 2.

ميتالينك
يدعم هذا الضفيرة Metalink (كلا الإصدارين 3 و 4 (RFC 5854)) ، والتي
يصف المرايا والتجزئة. سيستخدم curl المرايا لتجاوز الفشل إذا كان هناك
هي أخطاء (مثل عدم توفر الملف أو الخادم).

استخدم curl عبر الإنترنت باستخدام خدمات onworks.net