curl - Online în cloud

PROGRAM:

NUME

curl - transferați o adresă URL

REZUMAT

răsuci [Opțiuni] [URL...]

DESCRIERE

răsuci este un instrument de transfer de date de la sau către un server, folosind unul dintre protocoalele acceptate
(DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP,
RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET și TFTP). Comanda este concepută să funcționeze
fără interacțiunea utilizatorului.

curl oferă o mulțime de trucuri utile, cum ar fi suport proxy, autentificarea utilizatorilor, FTP
încărcare, postare HTTP, conexiuni SSL, cookie-uri, reluare transfer de fișiere, Metalink și multe altele. La fel de
veți vedea mai jos, numărul de caracteristici vă va face capul să se învârtă!

curl este alimentat de libcurl pentru toate caracteristicile legate de transfer. Vedea libcurl(3) pentru detalii.

URL-ul

Sintaxa URL este dependentă de protocol. Veți găsi o descriere detaliată în RFC 3986.

Puteți specifica mai multe adrese URL sau părți ale adreselor URL scriind seturi de părți între acolade, ca în:

http://site.{unu,doi,trei}.com

sau puteți obține secvențe de serii alfanumerice folosind [] ca în:

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

ftp://ftp.numericals.com/file[001-100].txt (cu zerouri la început)

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

Secvențele imbricate nu sunt acceptate, dar puteți folosi mai multe unele lângă altele:

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

Puteți specifica orice cantitate de adrese URL pe linia de comandă. Ele vor fi aduse într-o
mod secvenţial în ordinea specificată.

Puteți specifica un numărător de pași pentru intervale pentru a obține fiecare a N-a număr sau literă:

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

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

Când utilizați secvențele [] sau {} când sunt invocate dintr-o linie de comandă, probabil că aveți
pentru a pune adresa URL completă între ghilimele duble pentru a evita ca shell-ul să interfereze cu acesta. Acest
este valabil și pentru alte personaje tratate special, cum ar fi, de exemplu, „&”, „?” și '*'.

Furnizați indexul zonei IPv6 în adresa URL cu un semn procentual și interfața
Nume. Ca în

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

Dacă specificați URL fără prefix protocol://, curl va încerca să ghicească ce protocol
poate vrei. Apoi va fi implicit HTTP, dar încercați alte protocoale bazate pe cele utilizate des
prefixe de nume de gazdă. De exemplu, pentru numele de gazdă care încep cu „ftp”. curl te va presupune
vreau să vorbesc FTP.

curl va face tot posibilul să folosească ceea ce îi transmiteți ca URL. Nu încearcă să o valideze
ca o adresă URL corectă din punct de vedere sintactic prin orice mijloace, dar este în schimb foarte liberal cu ce
acceptă.

curl va încerca să refolosească conexiunile pentru transferuri multiple de fișiere, astfel încât să obțină multe
fișierele de pe același server nu vor face mai multe conexiuni / strângeri de mână. Acest lucru se îmbunătățește
viteză. Desigur, acest lucru se face numai pe fișierele specificate pe o singură linie de comandă și nu poate
poate fi folosit între invocări separate de curl.

PROGRESS METRU

curl afișează în mod normal un contor de progres în timpul operațiunilor, indicând cantitatea de
datele transferate, vitezele de transfer și timpul estimat rămas, etc.

curl afișează aceste date la terminal în mod implicit, deci dacă invocați curl pentru a face o
operație și este pe cale să scrie date pe terminal, acesta dezactivează contorul de progres ca
în caz contrar, s-ar încurca contorul de progres al amestecării de ieșire și datele de răspuns.

Dacă doriți un contor de progres pentru solicitările HTTP POST sau PUT, trebuie să redirecționați
ieșire răspuns la un fișier, folosind redirecționarea shell (>), -o [fișier] sau similar.

Nu este același caz pentru încărcarea FTP, deoarece operația nu scuipă niciun răspuns
date către terminal.

Dacă preferați o „bară” de progres în loc de contorul obișnuit, -# este prietenul tau.

OPŢIUNI

Opțiunile încep cu una sau două liniuțe. Multe dintre opțiuni necesită o valoare suplimentară în continuare
lor.

Forma scurtă „liniuță simplă” a opțiunilor, -d de exemplu, poate fi utilizată cu sau fără a
spațiu între acesta și valoarea sa, deși un spațiu este un separator recomandat. Cel lung
Forma „liniuță dublă”, --data de exemplu, necesită un spațiu între aceasta și valoarea sa.

Opțiunile de versiune scurtă care nu necesită valori suplimentare pot fi utilizate imediat următoare
unul față de celălalt, cum ar fi, de exemplu, puteți specifica toate opțiunile -O, -L și -v simultan ca
-OLv.

În general, toate opțiunile booleene sunt activate cu --opțiune și din nou dezactivat cu
--nO-opțiune. Adică utilizați exact același nume de opțiune, dar prefixați-l cu „nu-”.
Cu toate acestea, în această listă, în mare parte, listăm și arătăm doar versiunea --option a acestora. (Acest
conceptul cu --no opțiuni a fost adăugat în 7.19.0. Anterior, majoritatea opțiunilor erau activate/dezactivate
la utilizarea repetată a aceleiași opțiuni de linie de comandă.)

-#, --bara de progres
Faceți progresul afișajului curl ca o simplă bară de progres în loc de standard, mai mult
informativ, contor.

-:, --Următorul
Spune lui curl să folosească o operație separată pentru următoarea adresă URL și asociată
Opțiuni. Acest lucru vă permite să trimiteți mai multe solicitări URL, fiecare cu specificul său
opțiuni, de exemplu, cum ar fi diferite nume de utilizator sau solicitări personalizate pentru fiecare.
(Adăugat în 7.36.0)

-0, --http1.0
(HTTP) Spune curl să folosească versiunea HTTP 1.0 în loc să o folosească intern
de preferat: HTTP 1.1.

--http1.1
(HTTP) Spune lui curl să folosească HTTP versiunea 1.1. Aceasta este versiunea implicită internă.
(Adăugat în 7.33.0)

--http2
(HTTP) Spune curl să emită cererile folosind HTTP 2. Acest lucru necesită ca
libcurl-ul de bază a fost construit pentru a-l susține. (Adăugat în 7.33.0)

--nu-npn
Dezactivați extensia NPN TLS. NPN este activat implicit dacă libcurl a fost construit cu
o bibliotecă SSL care acceptă NPN. NPN este folosit de un libcurl care acceptă HTTP 2 to
negociați suport HTTP 2 cu serverul în timpul sesiunilor https.

(Adăugat în 7.36.0)

--no-alpn
Dezactivați extensia ALPN TLS. ALPN este activat implicit dacă libcurl a fost construit
cu o bibliotecă SSL care acceptă ALPN. ALPN este folosit de un libcurl care acceptă
HTTP 2 pentru a negocia suportul HTTP 2 cu serverul în timpul sesiunilor https.

(Adăugat în 7.36.0)

-1, --tlsv1
(SSL) Forțează curl să folosească TLS versiunea 1.x atunci când negociază cu un server TLS la distanță.
Puteți folosi opțiuni --tlsv1.0, --tlsv1.1, și --tlsv1.2 pentru a controla versiunea TLS
mai precis (dacă backend-ul SSL în uz acceptă un astfel de nivel de control).

-2, --sslv2
(SSL) Forțează curl să folosească SSL versiunea 2 atunci când negociază cu un server SSL la distanță.
Uneori, curl este construit fără suport SSLv2. SSLv2 este considerat nesigur
(vezi RFC 6176).

-3, --sslv3
(SSL) Forțează curl să folosească SSL versiunea 3 atunci când negociază cu un server SSL la distanță.
Uneori, curl este construit fără suport SSLv3. SSLv3 este considerat nesigur
(vezi RFC 7568).

-4, --ipv4
Această opțiune îi spune lui curl să rezolve numele numai la adrese IPv4, și nu de exemplu
încercați IPv6.

-6, --ipv6
Această opțiune îi spune lui curl să rezolve numele numai la adrese IPv6, și nu de exemplu
încercați IPv4.

-a, --anexează
(FTP/SFTP) Când este utilizat într-o încărcare, acest lucru face ca curl să se atașeze la fișierul țintă
în loc să-l suprascrie. Dacă fișierul de la distanță nu există, acesta va fi creat.
Rețineți că acest flag este ignorat de unele servere SFTP (inclusiv OpenSSH).

-A, --user-agent
(HTTP) Specificați șirul User-Agent de trimis către serverul HTTP. Unele prost făcute
CGI-urile nu reușesc dacă acest câmp nu este setat la „Mozilla/4.0”. Pentru a codifica spațiile libere din șir,
înconjurați șirul cu ghilimele simple. Acest lucru poate fi setat și cu -H,
--antet varianta desigur.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--anyauth
(HTTP) Îi spune lui curl să descopere singur metoda de autentificare și să folosească cel mai mult
securizați unul pe care site-ul la distanță pretinde că îl sprijină. Acest lucru se face făcând mai întâi o solicitare
și verificarea antetelor de răspuns, astfel încât posibil să se inducă o rețea suplimentară rotundă-
excursie. Acesta este utilizat în loc să setați o metodă de autentificare specifică, pe care dvs
pot face cu --de bază, --digera, --ntlm, și --a negocia.

Rețineți că utilizarea --anyauth nu este recomandată dacă faceți încărcări din stdin, deoarece aceasta
poate solicita ca datele să fie trimise de două ori și apoi clientul trebuie să poată derula înapoi. Dacă
trebuie să apară atunci când încărcați din stdin, operația de încărcare va eșua.

-b, --cookie
(HTTP) Transmite datele către serverul HTTP ca cookie. Se presupune că sunt datele
primit anterior de la server într-o linie „Set-Cookie:”. Datele ar trebui să fie în
formatul „NUME1=VALOARE1; NUME2=VALOARE2”.

Dacă nu este utilizat simbolul „=” în linie, acesta este tratat ca un nume de fișier de utilizat pentru a citi
linii cookie stocate anterior de la, care ar trebui folosite în această sesiune dacă acestea
Meci. Folosirea acestei metode activează și motorul cookie care va face curl
înregistrați și cookie-urile primite, ceea ce poate fi la îndemână dacă le utilizați în combinație
cu -L, --Locație opțiune. Formatul fișierului din care se citește cookie-urile
ar trebui să fie antete HTTP simple sau formatul de fișier cookie Netscape/Mozilla.

Fișierul specificat cu -b, --cookie este folosit doar ca intrare. Nu vor fi cookie-uri
scris la dosar. Pentru a stoca cookie-uri, utilizați -c, --borcan cu prajituri opțiune.

Fiți atenți dacă utilizați această opțiune și pot avea loc mai multe transferuri. Dacă
utilizați NAME1=VALUE1; sau într-un fișier utilizați formatul Set-Cookie și nu
specificați un domeniu, apoi cookie-ul este trimis pentru orice domeniu (chiar și după ce redirecționările sunt
urmat) și nu poate fi modificat de un cookie setat de server. Dacă motorul cookie este
activat și un server setează un cookie cu același nume, apoi ambele vor fi trimise pe un
transferul viitor pe acel server, probabil nu ceea ce intenționați. Pentru a aborda acestea
problemele setează un domeniu în Set-Cookie (făcând asta va include subdomenii) sau folosește
format Netscape.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-B, --use-ascii
(FTP/LDAP) Activați transferul ASCII. Pentru FTP, acest lucru poate fi impus și prin utilizarea unui
URL care se termină cu „;type=A”. Această opțiune face ca datele trimise către stdout să fie în text
mod pentru sistemele win32.

--de bază
(HTTP) Spune curl să folosească autentificarea de bază HTTP cu gazda la distanță. Aceasta este
implicit și această opțiune este de obicei inutilă, cu excepția cazului în care o utilizați pentru a suprascrie a
opțiune setată anterior care setează o metodă de autentificare diferită (cum ar fi --ntlm,
--digera, Sau --a negocia).

Folosit împreună cu -u, --utilizator și -X, --proxy.

Vezi si --proxy-de bază.

-c, --cookie-bor
(HTTP) Specificați în ce fișier doriți curl să scrie toate cookie-urile după finalizare
Operațiune. Curl scrie toate modulele cookie citite anterior dintr-un fișier specificat, precum și
toate cookie-urile primite de la servere la distanță. Dacă nu se cunosc cookie-uri, nicio dată nu va fi cunoscută
fi scris. Fișierul va fi scris folosind formatul de fișier cookie Netscape. daca tu
setați numele fișierului la o singură liniuță, „-”, cookie-urile vor fi scrise în stdout.

Această opțiune de linie de comandă va activa motorul cookie care face înregistrarea curl și
utilizați cookie-uri. O altă modalitate de a-l activa este folosirea -b, --cookie opțiune.

Dacă borcanul pentru cookie-uri nu poate fi creat sau scris în, întreaga operațiune de curl nu va fi
eșuează sau chiar raportează o eroare în mod clar. Folosind -v se va afișa un avertisment, dar
acesta este singurul feedback vizibil pe care îl primiți despre această situație posibil letală.

Din 7.43.0 cookie-uri care au fost importate în formatul Set-Cookie fără domeniu
numele nu sunt exportate de această opțiune.

Dacă această opțiune este folosită de mai multe ori, va fi folosit ultimul nume de fișier specificat.

-C, --continuare-at
Continuați/Reluați un transfer de fișier anterior la offset-ul dat. Offset-ul dat este
numărul exact de octeți care vor fi săriți, numărând de la începutul
fișierul sursă înainte de a fi transferat la destinație. Dacă este folosit cu încărcări,
Comanda SIZE de server FTP nu va fi folosită de curl.

Folosiți „-C -” pentru a-i spune lui curl să afle automat unde/cum să reia transferul.
Apoi folosește fișierele de ieșire/intrare date pentru a-și da seama.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--cifre
(SSL) Specifică ce cifruri să folosească în conexiune. Lista de cifruri trebuie
specificați coduri valide. Citiți detaliile listei de criptare SSL pe această adresă URL:
https://www.openssl.org/docs/apps/ciphers.html

Cifrurile NSS sunt realizate diferit de OpenSSL și GnuTLS. Lista completă a NSS
ciphers se află în intrarea NSSCipherSuite la această adresă URL:
https://git.fedorahosted.org/cgit/mod_nss.git/plain/docs/mod_nss.html#Directives

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--comprimat
(HTTP) Solicitați un răspuns comprimat folosind unul dintre algoritmii suportați pentru curl și
salvați documentul necomprimat. Dacă se utilizează această opțiune și serverul trimite un
codificare neacceptată, curl va raporta o eroare.

--connect-timeout
Timp maxim în secunde pe care îl permiteți conexiunii lui Curl. Aceasta doar limitează
faza de conectare, deci dacă curl se conectează în perioada dată va continua
- dacă nu, va ieși. Din versiunea 7.32.0, această opțiune acceptă valori zecimale.

Consultați și -m, --max-time opțiune.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--create-dirs
Atunci când este utilizat împreună cu -o opțiunea, curl va crea localul necesar
ierarhia directoarelor după cum este necesar. Această opțiune creează direcțiile menționate cu -o
opțiune, nimic altceva. Dacă -o numele fișierului nu folosește nici un director sau dacă directorul pe care îl menționează
există deja, nu va fi creat niciun director.

Pentru a crea directoare la distanță când utilizați FTP sau SFTP, încercați --ftp-create-dirs.

--crlf Convertiți LF în CRLF în încărcare. Util pentru MVS (OS/390).

(SMTP adăugat în 7.40.0)

--crlfile
(HTTPS/FTPS) Furnizați un fișier folosind formatul PEM cu o listă de revocare a certificatelor
care pot specifica certificate peer care urmează să fie considerate revocate.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

(Adăugat în 7.19.7)

-d, --data
(HTTP) Trimite datele specificate într-o cerere POST către serverul HTTP, în același
felul în care o face un browser când un utilizator a completat un formular HTML și apasă pe
buton de trimitere. Acest lucru va determina curl să treacă datele către server folosind
aplicație de tip conținut/x-www-form-urlencoded. Compara cu -F, --formă.

-d, --date este la fel ca --data-ascii. --data-raw este aproape la fel, dar nu
au o interpretare specială a caracterului @. Pentru a posta date pur binare, tu
ar trebui să folosească în schimb --data-binary opțiune. Pentru a codifica prin URL valoarea unui formular
câmp pe care îl puteți folosi --data-urlencode.

Dacă oricare dintre aceste opțiuni este utilizată de mai multe ori pe aceeași linie de comandă, datele
piesele specificate vor fi îmbinate împreună cu un simbol & de separare. Astfel, folosind
„-d name=daniel -d skill=lousy” ar genera o bucată de postare care arată ca
'name=daniel&skill=lousy'.

Dacă începeți datele cu litera @, restul ar trebui să fie un nume de fișier de citit
date de la, sau - dacă doriți ca curl să citească datele din stdin. Mai multe fișiere pot
fi de asemenea specificat. Postarea datelor dintr-un fișier numit „foobar” ar fi astfel realizată
--date @foobar. Când --data i se spune să citească dintr-un astfel de fișier, transportul se întoarce
iar liniile noi vor fi eliminate. Dacă nu doriți ca caracterul @ să aibă un
utilizare specială de interpretare --data-raw in schimb.

-D, --dump-header
Scrieți anteturile protocolului în fișierul specificat.

Această opțiune este la îndemână atunci când doriți să stocați anteturile unui site HTTP
iti trimite. Cookie-urile din anteturi puteau fi apoi citite într-o a doua buclă
invocare prin folosirea -b, --cookie opțiune! The -c, --borcan cu prajituri opțiunea este o
o modalitate mai bună de a stoca cookie-uri.

Când sunt utilizate în FTP, liniile de răspuns ale serverului FTP sunt considerate „anteturi” și
astfel sunt salvati acolo.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--data-ascii
Vedea -d, --date.

--data-binary
(HTTP) Aceasta postează date exact așa cum este specificat, fără nicio prelucrare suplimentară.

Dacă începeți datele cu litera @, restul ar trebui să fie un nume de fișier. Datele sunt
postat într-o manieră similară ca --data-ascii face, cu excepția că noi linii și transport
returnările sunt păstrate și conversiile nu se fac niciodată.

Dacă această opțiune este folosită de mai multe ori, cele care urmează pe prima vor adăuga date
așa cum este descris în -d, --date.

--data-raw
(HTTP) Aceasta postează date în mod similar cu --date dar fără interpretarea specială
a caracterului @. Vedea -d, --date. (Adăugat în 7.43.0)

--data-urlencode
(HTTP) Aceasta postează date, similar cu celelalte opțiuni --data, cu excepția faptului că
aceasta realizează codificarea URL. (Adăugat în 7.18.0)

Pentru a fi compatibil CGI, partea ar trebui să înceapă cu a nume urmată de a
separator și o specificație de conținut. The parte poate fi trecută la curl folosind
una dintre următoarele sintaxe:

conţinut
Acest lucru va face curl URL-coda conținutul și îl va transmite mai departe. Doar fii atent
astfel încât conținutul să nu conțină niciun simbol = sau @, așa cum va fi atunci
faceți ca sintaxa să se potrivească cu unul dintre celelalte cazuri de mai jos!

=conținut
Acest lucru va face curl URL-coda conținutul și îl va transmite mai departe. Precedentul =
simbolul nu este inclus în date.

nume=conținut
Acest lucru va face curl URL-coda partea de conținut și va transmite asta mai departe. Rețineți că
se așteaptă ca partea de nume să fie deja codificată în URL.

@nume de fișier
Acest lucru va face să se încarce curl datele din fișierul dat (inclusiv orice linii noi),
Codați datele respective și transmiteți-le în POST.

nume@nume fișier
Acest lucru va face să se încarce curl datele din fișierul dat (inclusiv orice linii noi),
Codați datele respective și transmiteți-le în POST. Partea de nume primește un egal
semnul atasat, rezultand nume=urlencoded-file-content. Rețineți că numele
se așteaptă să fie deja codificat în URL.

--nivelul de delegare
set NIVEL pentru a spune serverului ce are voie să delege când vine vorba de utilizator
acreditările. Folosit cu GSS/kerberos.

niciunul Nu permiteți nicio delegare.

politică Delegă dacă și numai dacă steag-ul OK-AS-DELEGATE este setat în Kerberos
bilet de serviciu, care este o chestiune de politică.

întotdeauna Permiteți necondiționat serverului să delege.

--digera
(HTTP) Activează autentificarea HTTP Digest. Aceasta este o schemă de autentificare care
împiedică trimiterea parolei prin cablu în text clar. Folosește asta în
combinație cu normalul -u, --utilizator opțiunea de a seta numele de utilizator și parola. Vedea
de asemenea --ntlm, --a negocia și --anyauth pentru opțiunile conexe.

Dacă această opțiune este folosită de mai multe ori, se folosește doar prima.

--disable-eprt
(FTP) Spune-i lui curl să dezactiveze utilizarea comenzilor EPRT și LPRT atunci când se activează
Transferuri FTP. Curl va încerca întotdeauna mai întâi să folosească EPRT, apoi LPRT
înainte de a utiliza PORT, dar cu această opțiune, va folosi PORT imediat. EPRT și LPRT
sunt extensii la protocolul FTP original și este posibil să nu funcționeze pe toate serverele, dar
ele permit mai multe funcționalități într-un mod mai bun decât comanda tradițională PORT.

--eprt poate fi folosit pentru a activa din nou în mod explicit EPRT și --nu-eprt este un alias pentru
--disable-eprt.

Dezactivarea EPRT schimbă doar comportamentul activ. Dacă vrei să treci la pasiv
modul pe care nu trebuie să îl utilizați -P, --ftp-port sau forțați-l cu --ftp-pasv.

--disable-epsv
(FTP) Spune-i lui curl să dezactiveze utilizarea comenzii EPSV atunci când faci FTP pasiv
transferuri. Curl va încerca în mod normal întotdeauna prima dată să folosească EPSV înainte de PASV, dar
cu această opțiune, nu va încerca să folosească EPSV.

--epsv poate fi folosit pentru a activa în mod explicit EPSV din nou și --nu-epsv este un alias pentru
--disable-epsv.

Dezactivarea EPSV modifică doar comportamentul pasiv. Dacă doriți să treceți la activ
modul pe care trebuie să îl utilizați -P, --ftp-port.

--dns-interface
Spune-i lui curl să trimită cereri DNS de ieșire prin intermediul . Această opțiune este a
omologul la --interfață (care nu afectează DNS). Snurul furnizat trebuie să fie
un nume de interfață (nu o adresă).

Această opțiune necesită ca libcurl să fie construit cu un backend de rezolvare care acceptă
această operațiune. Backend-ul c-ares este singurul astfel de. (Adăugat în 7.33.0)

--dns-ipv4-addr
Spune-i lui curl să se lege atunci când faceți solicitări DNS IPv4, astfel încât DNS
cererile provin de la această adresă. Argumentul ar trebui să fie o singură adresă IPv4.

Această opțiune necesită ca libcurl să fie construit cu un backend de rezolvare care acceptă
această operațiune. Backend-ul c-ares este singurul astfel de. (Adăugat în 7.33.0)

--dns-ipv6-addr
Spune-i lui curl să se lege atunci când faceți solicitări DNS IPv6, astfel încât DNS
cererile provin de la această adresă. Argumentul ar trebui să fie o singură adresă IPv6.

Această opțiune necesită ca libcurl să fie construit cu un backend de rezolvare care acceptă
această operațiune. Backend-ul c-ares este singurul astfel de. (Adăugat în 7.33.0)

--dns-server
Setați lista de servere DNS care urmează să fie utilizate în loc de cea implicită de sistem. Lista de
Adresele IP trebuie separate prin virgule. Opțional, numerele de port pot fi
dat ca : după fiecare adresă IP.

Această opțiune necesită ca libcurl să fie construit cu un backend de rezolvare care acceptă
această operațiune. Backend-ul c-ares este singurul astfel de. (Adăugat în 7.33.0)

-e, --referer
(HTTP) Trimite informațiile „Pagina de referință” către serverul HTTP. Poate fi și asta
stabilit cu -H, --antet steag desigur. Când este folosit cu -L, --Locație puteți
adăugați „;auto” la adresa URL --referer pentru ca curl să seteze automat adresa URL anterioară
când urmează un antet Locație:. Șirul „;auto” poate fi folosit singur, chiar dacă
nu setați un --referer inițial.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-E, --cert
(SSL) Spune curl să folosească fișierul de certificat client specificat atunci când obține un fișier
cu HTTPS, FTPS sau alt protocol bazat pe SSL. Certificatul trebuie să fie în PKCS#12
format dacă utilizați Secure Transport sau format PEM dacă utilizați orice alt motor. Dacă
parola opțională nu este specificată, aceasta va fi solicitată pe terminal. Notă
că această opțiune presupune un fișier „certificat” care este cheia privată și
certificat de client concatenat! Vedea --cert și --cheie pentru a le preciza
independent.

Dacă curl este construit pe baza bibliotecii NSS SSL, atunci această opțiune poate spune curl
pseudonimul certificatului de utilizat în baza de date NSS definită de
variabila de mediu SSL_DIR (sau implicit /etc/pki/nssdb). Dacă NSS PEM PKCS#11
modulul (libnsspem.so) este disponibil, atunci fișierele PEM pot fi încărcate. Dacă doriți să utilizați
un fișier din directorul curent, precedați-l cu prefixul „./”, pentru a
evitați confuzia cu o poreclă. Dacă porecla conține „:”, trebuie să fie
precedat de „\”, astfel încât să nu fie recunoscut ca delimitator de parolă. Dacă
porecla conține „\”, trebuie să fie eliminată ca „\\”, astfel încât să nu fie recunoscută
ca personaj de evadare.

(Numai pentru iOS și Mac OS X) Dacă curl este construit împotriva Secure Transport, atunci
șirul de certificat poate fi fie numele unui certificat/cheie privată din
brelocul de sistem sau utilizator sau calea către un certificat codificat PKCS#12 și privat
cheie. Dacă doriți să utilizați un fișier din directorul curent, precedați-l cu
Prefixul „./”, pentru a evita confuzia cu o poreclă.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--motor
Selectați motorul cripto OpenSSL pe care să îl utilizați pentru operațiunile de cifrare. Utilizare --motor listă la
tipăriți o listă de motoare acceptate în timpul construirii. Rețineți că nu toate (sau niciunul) dintre
motoarele pot fi disponibile în timpul rulării.

--mediu inconjurator
(NUMAI RISC OS) Setează o serie de variabile de mediu, folosind numele the -w opțiune
suporturi, pentru a permite extragerea mai ușoară a informațiilor utile după rularea curl.

--egd-file
(SSL) Specificați numele căii către socket-ul Entropy Gathering Daemon. Priza este
folosit pentru a genera motorul aleatoriu pentru conexiunile SSL. Vezi și --random-file
opțiune.

--expect100-timeout
(HTTP) Timp maxim în secunde în care permiteți curl-ului să aștepte 100-continuare
răspuns când curl emite un antet Expects: 100-continue în cererea sa. În mod implicit
curl va aștepta o secundă. Această opțiune acceptă valori zecimale! Când bucla se oprește
așteptând, va continua ca și cum răspunsul a fost primit.

(Adăugat în 7.47.0)

--tip-cert
(SSL) Spune curl în ce tip de certificat se află certificatul furnizat. PEM, DER și
ENG sunt tipuri recunoscute. Dacă nu este specificat, se presupune PEM.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--cacert
(SSL) Spune curl să folosească fișierul de certificat specificat pentru a verifica peer-ul. Fișierul
poate conține mai multe certificate CA. Certificatul(ele) trebuie să fie în format PEM.
În mod normal, curl este creat pentru a utiliza un fișier implicit pentru aceasta, deci această opțiune este de obicei
folosit pentru a modifica acel fișier implicit.

curl recunoaște variabila de mediu numită „CURL_CA_BUNDLE” dacă este setată și
folosește calea dată ca cale către un pachet de certificat CA. Această opțiune o înlocuiește
variabilă.

Versiunea pentru Windows a curl va căuta automat un fișier CA certs numit
„curl-ca-bundle.crt”, fie în același director ca curl.exe, fie în Current
Director de lucru sau în orice folder de-a lungul PATH.

Dacă curl este construit pe baza bibliotecii NSS SSL, modulul NSS PEM PKCS#11
(libnsspem.so) trebuie să fie disponibil pentru ca această opțiune să funcționeze corect.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--capath
(SSL) Spune curl să folosească directorul de certificat specificat pentru a verifica peer-ul.
Pot fi furnizate căi multiple, separându-le cu „:” (de ex
„cale1:cale2:cale3”). Certificatele trebuie să fie în format PEM, iar dacă curl este construit
împotriva OpenSSL, directorul trebuie să fi fost procesat folosind utilitarul c_rehash
furnizat cu OpenSSL. Folosind --capath poate permite curl alimentat de OpenSSL să facă SSL-
conexiuni mult mai eficient decât utilizarea --cacert dacă --cacert fișierul conține
multe certificate CA.

Dacă această opțiune este setată, valoarea implicită capath va fi ignorată și dacă este utilizată
de mai multe ori, ultimul va fi folosit.

--pinnedpubkey
(SSL) Spune curl să folosească fișierul cheie publică specificat (sau hash-uri) pentru a verifica
egal. Aceasta poate fi o cale către un fișier care conține o singură cheie publică în PEM sau DER
format sau orice număr de hash-uri sha64 codificate în base256 precedate de „sha256//” și
separat de

Când negociați o conexiune TLS sau SSL, serverul trimite un certificat care indică
identitatea acestuia. O cheie publică este extrasă din acest certificat și dacă nu
se potrivesc exact cu cheia publică furnizată acestei opțiuni, curl va anula
conexiune înainte de a trimite sau de a primi orice date.

Adăugat în 7.39.0 pentru OpenSSL, GnuTLS și GSKit. Adăugat în 7.43.0 pentru NSS și
wolfSSL/CyaSSL. Suport sha256 adăugat în 7.44.0 pentru OpenSSL, GnuTLS, NSS și
wolfSSL/CyaSSL. Alte backend-uri SSL nu sunt acceptate.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--cert-status
(SSL) Spune curl să verifice starea certificatului de server utilizând
Solicitare de stare a certificatului (denumită în continuare capsare OCSP) extensie TLS.

Dacă această opțiune este activată și serverul trimite un răspuns nevalid (de exemplu, expirat),
dacă răspunsul sugerează că certificatul de server a fost revocat sau nu
răspunsul este primit, verificarea eșuează.

Acest lucru este implementat în prezent numai în backend-urile OpenSSL, GnuTLS și NSS. (Adăugat
în 7.41.0)

--start fals

(SSL) Spune curl să folosească pornirea falsă în timpul strângerii de mână TLS. Pornirea falsă este un mod
unde un client TLS va începe să trimită datele aplicației înainte de a verifica
mesajul Terminat al serverului, salvând astfel o călătorie dus-întors atunci când efectuați un complet
strângere de mână.

Acest lucru este implementat în prezent numai în NSS și Secure Transport (pe iOS 7.0 sau
mai târziu sau OS X 10.9 sau o versiune ulterioară). (Adăugat în 7.42.0)

-f, --fail
(HTTP) Eșuează silențios (nicio ieșire) la erorile de server. Acest lucru se face în mare parte pentru
activați mai bine scripturile etc. pentru a face față mai bine încercărilor eșuate. În cazuri normale când
un server HTTP nu reușește să livreze un document, returnează un document HTML care indică acest lucru
(care descrie adesea și de ce și mai mult). Acest steag va preveni ondularea
emite asta și returnează eroarea 22.

Această metodă nu este sigură și există ocazii în care răspunsul nu are succes
codurile se vor strecura, mai ales atunci când este implicată autentificare (coduri de răspuns
401 și 407).

-F, --form
(HTTP) Acest lucru îi permite lui curl să emuleze un formular completat în care un utilizator a apăsat butonul
buton de trimitere. Acest lucru cauzează curl la datele POST utilizând tipul de conținut multipart/form-
date conform RFC 2388. Acest lucru permite încărcarea fișierelor binare etc. Pentru a forța
partea „conținut” să fie un fișier, prefixați numele fișierului cu un semn @. Pentru a primi doar
partea de conținut dintr-un fișier, prefixați numele fișierului cu simbolul <. The
diferența dintre @ și < este că @ face ca un fișier să fie atașat în postare ca
un fișier încărcat, în timp ce < creează un câmp de text și obține doar conținutul pentru asta
câmp text dintr-un fișier.

De exemplu, pentru a trimite fișierul cu parola la server, unde „parolă” este numele
câmpul-formular la care / Etc / passwd va fi intrarea:

răsuci -F parola=@/ Etc / passwd www.mypasswords.com

Pentru a citi conținut din stdin în loc de fișier, utilizați - ca nume de fișier. Acest lucru este valabil pentru
atât constructele @ cât și <. Din păcate, nu acceptă citirea fișierului din a
țeavă numită sau similar, deoarece are nevoie de dimensiunea completă înainte de a începe transferul.

De asemenea, puteți spune lui Curl ce tip de conținut să folosească folosind „type=”, într-un fel
similar cu:

răsuci -F"[e-mail protejat];type=text/html" url.com

or

răsuci -F „nume=daniel;tip=text/foo” url.com

De asemenea, puteți modifica în mod explicit câmpul de nume al unei părți de încărcare a fișierului prin setare
filename=, astfel:

răsuci -F „file=@localfile;filename=nameinpost” url.com

Dacă numele fișierului/calea conține „,” sau „;”, acesta trebuie să fie citat între ghilimele duble, cum ar fi:

răsuci -F "file=@\"localfile\";filename=\"nameinpost\"" url.com

or

răsuci -F 'file="@"localfile";filename="nameinpost"' url.com

Rețineți că, dacă un nume de fișier/cale este citat de ghilimele duble, orice ghilimele duble sau
bara oblică inversă din numele fișierului trebuie să fie eliminată de bara oblică inversă.

Vezi mai multe exemple și detalii în MANUAL.

Această opțiune poate fi folosită de mai multe ori.

--ftp-account [date]
(FTP) Când un server FTP solicită „datele contului” după ce numele de utilizator și parola au
au fost furnizate, aceste date sunt trimise folosind comanda ACCT. (Adăugat în 7.13.0)

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--ftp-alternativă-la-utilizator
(FTP) Dacă autentificarea cu comenzile USER și PASS eșuează, trimiteți această comandă.
Când vă conectați la serverul de transport securizat al Tumbleweed prin FTPS utilizând un client
certificat, folosind „SITE AUTH” va spune serverului să preia numele de utilizator de la
certificatul. (Adăugat în 7.15.5)

--ftp-create-dirs
(FTP/SFTP) Când o adresă URL/operație FTP sau SFTP utilizează o cale care nu este în prezent
există pe server, comportamentul standard al curl este să eșueze. Folosind această opțiune,
curl va încerca în schimb să creeze directoare lipsă.

--ftp-method [metodă]
(FTP) Controlați ce metodă ar trebui să folosească curl pentru a ajunge la un fișier pe un server FTP(S). The
argumentul metodei ar trebui să fie una dintre următoarele alternative:

multicwd
curl face o singură operație CWD pentru fiecare parte de cale din adresa URL dată. Pentru
ierarhii profunde, aceasta înseamnă foarte multe comenzi. Așa spune RFC 1738
ar trebui făcut. Acesta este comportamentul implicit, dar cel mai lent.

nocwd curl nu face deloc CWD. curl va face SIZE, RETR, STOR etc și va da un plin
calea către server pentru toate aceste comenzi. Acesta este cel mai rapid comportament.

singlecwd
curl face un CWD cu directorul țintă complet și apoi operează pe
fișier „în mod normal” (ca în cazul multicwd). Acesta este ceva mai multe standarde
conform decât „nocwd”, dar fără pedeapsa totală de „multicwd”.

(Adăugat în 7.15.1)

--ftp-pasv
(FTP) Utilizați modul pasiv pentru conexiunea de date. Pasivul este implicit intern
comportament, dar folosirea acestei opțiuni poate fi folosită pentru a înlocui un precedent -P/-ftp-port
opțiune. (Adăugat în 7.11.0)

Dacă această opțiune este folosită de mai multe ori, se folosește doar prima. Anularea unui
forțat pasiv într-adevăr nu este realizabil, dar atunci trebuie să aplicați corect
-P, --ftp-port din nou.

Modul pasiv înseamnă că curl va încerca mai întâi comanda EPSV și apoi PASV, dacă nu
--disable-epsv este folosit.

--ftp-skip-pasv-ip
(FTP) Spune-i lui curl să nu folosească adresa IP pe care o sugerează serverul în răspunsul său
comanda PASV a curl atunci când curl conectează conexiunea de date. În schimb, bucla va re-
utilizați aceeași adresă IP pe care o folosește deja pentru conexiunea de control. (Adăugat în
7.14.2)

Această opțiune nu are efect dacă se utilizează PORT, EPRT sau EPSV în loc de PASV.

--ftp-pret
(FTP) Spune-i lui curl să trimită o comandă PRET înainte de PASV (și EPSV). Anumite servere FTP,
în principal drftpd, necesită această comandă non-standard pentru listele de directoare, precum și
up și descărcări în modul PASV. (Adăugat în 7.20.x)

--ftp-ssl-ccc
(FTP) Utilizați CCC (Clear Command Channel) Oprește stratul SSL/TLS după
autentificarea. Restul comunicației canalului de control va fi necriptat.
Acest lucru permite routerelor NAT să urmărească tranzacția FTP. Modul implicit este pasiv.
Vedea --ftp-ssl-ccc-mode pentru alte moduri. (Adăugat în 7.16.1)

--ftp-ssl-ccc-mode [activ/pasiv]
(FTP) Utilizare CCC (Clear Command Channel) Setează modul CCC. Modul pasiv nu va
inițiază oprirea, dar în schimb așteptați ca serverul să o facă și nu va răspunde
la oprirea de pe server. Modul activ inițiază oprirea și așteaptă
pentru un raspuns de la server. (Adăugat în 7.16.2)

--ftp-ssl-control
(FTP) Necesită SSL/TLS pentru autentificarea FTP, clar pentru transfer. Permite securizare
autentificare, dar transferuri de date necriptate pentru eficiență. Eșuează
transfer dacă serverul nu acceptă SSL/TLS. (Adăugat în 7.16.0) care poate încă
va fi folosit, dar va fi eliminat într-o versiune viitoare.

--form-string
(HTTP) Similar cu --formă cu excepția faptului că șirul de valoare pentru parametrul numit este
folosit la propriu. Caracterele principale „@” și „<” și șirul „;type=” în
valoarea nu are o semnificație specială. Utilizați acest lucru de preferință --formă dacă există vreunul
posibilitatea ca valoarea șirului să declanșeze accidental caracteristicile „@” sau „<”.
of --formă.

-g, --globoff
Această opțiune dezactivează „Analizatorul de globare a adreselor URL”. Când setați această opțiune, dvs
poate specifica adrese URL care conțin literele {}[] fără ca acestea să fie
interpretată de curl în sine. Rețineți că aceste litere nu sunt URL-uri legale normale
conținut, dar acestea ar trebui să fie codificate conform standardului URI.

-G, --obține
Când este utilizată, această opțiune va face ca toate datele să fie specificate cu -d, --date, --data-binary
or --data-urlencode pentru a fi utilizat într-o solicitare HTTP GET în loc de cererea POST
care altfel ar fi folosit. Datele vor fi atașate la adresa URL cu un „?”
separator.

Dacă sunt utilizate în combinație cu -I, datele POST vor fi adăugate la adresa URL
cu o cerere HEAD.

Dacă această opțiune este folosită de mai multe ori, se folosește doar prima. Asta pentru ca
anularea unui GET nu are sens, dar ar trebui să aplicați
metoda alternativă pe care o preferați.

-H, --antet
(HTTP) Antet suplimentar de inclus în cerere atunci când trimiteți HTTP către un server. Tu
poate specifica orice număr de anteturi suplimentare. Rețineți că dacă ar trebui să adăugați o personalizare
antet care are același nume ca unul dintre cele interne pe care le-ar folosi curl, dvs
antetul setat extern va fi folosit în locul celui intern. Acest lucru vă permite să
face lucruri chiar mai complicate decât ar face curl în mod normal. Nu ar trebui să înlocuiți
setați intern anteturi fără să știți perfect ce faceți. Eliminați un
antet intern oferind o înlocuire fără conținut pe partea dreaptă a
două puncte, ca în: -H „Gazdă:”. Dacă trimiteți antetul personalizat fără valoare, atunci este
antetul trebuie să se încheie cu punct și virgulă, cum ar fi -H „X-Custom-Header;” a trimite
„X-Custom-Header:”.

curl se va asigura că fiecare antet pe care îl adăugați/înlocuiți este trimis cu finalul adecvat-
marcator de linie, așa ar trebui nu adăugați că ca parte a conținutului antetului: do
nu adăugați linii noi sau returnări de mașină, ele vor face doar încurcătură pentru dvs.

Consultați și -A, --agent utilizator și -e, --referer opțiuni.

Începând cu 7.37.0, aveți nevoie --proxy-header pentru a trimite anteturi personalizate destinate a
proxy.

Exemplu:

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

AVERTISMENT: anteturile setate cu această opțiune vor fi setate în toate solicitările - chiar și după
redirecționările sunt urmate, ca atunci când se spune cu -L, --Locație. Acest lucru poate duce la
antetul fiind trimis la alte gazde decât gazda originală, deci anteturi sensibile
ar trebui să fie folosit cu prudență în combinație cu următoarele redirecționări.

Această opțiune poate fi folosită de mai multe ori pentru a adăuga/înlocui/elimina mai multe anteturi.

--hostpubmd5
(SCP/SFTP) Transmite un șir care conține 32 de cifre hexazecimale. Coarda ar trebui să fie
Suma de control MD128 de 5 de biți a cheii publice a gazdei la distanță, curl va refuza
conexiune cu gazda, cu excepția cazului în care md5sums se potrivesc. (Adăugat în 7.17.1)

--ignora-lungimea-conținutului
Pentru HTTP, ignorați antetul Content-Length. Acest lucru este util în special pentru servere
rulează Apache 1.x, care va raporta lungimea conținutului incorectă pentru fișierele mai mari
mai mult de 2 gigaocteți.

Pentru FTP (din 7.46.0), săriți peste comanda RETR pentru a afla dimensiunea înainte
descărcarea unui fișier.

-eu includ
(HTTP) Includeți antetul HTTP în rezultat. Antetul HTTP include lucruri precum
numele serverului, data documentului, versiunea HTTP și multe altele...

-Eu, --cap
(HTTP/FTP/FIȘIER) Preluați numai antetul HTTP! Serverele HTTP au comanda HEAD
pe care aceasta le folosește pentru a obține nimic altceva decât antetul unui document. Când este utilizat pe un FTP sau
Fișier FILE, curl afișează numai dimensiunea fișierului și ora ultimei modificări.

--interfață
Efectuați o operațiune utilizând o interfață specificată. Puteți introduce numele interfeței, IP
adresa sau numele gazdei. Un exemplu ar putea arăta astfel:

curl --interface eth0:1 http://www.netscape.com/

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-j, --junk-session-cookies
(HTTP) Când curl i se spune să citească cookie-urile dintr-un fișier dat, această opțiune va face
renunță la toate „cookie-urile de sesiune”. Acest lucru va avea practic același efect ca și cum a
noua sesiune este începută. Browserele obișnuite elimină întotdeauna cookie-urile de sesiune când
sunt închise.

-J, --remote-header-name
(HTTP) Această opțiune îi spune -O, --nume-la distanță opțiunea de utilizare a serverului specificat
Content-Disposition nume de fișier în loc să extrageți un nume de fișier din URL.

Nu există nicio încercare de a decoda %-secvențe (încă) în numele fișierului furnizat, deci aceasta
opțiunea vă poate oferi nume de fișiere destul de neașteptate.

-k, --nesigur
(SSL) Această opțiune permite în mod explicit curl să efectueze conexiuni SSL „nesigure” și
transferuri. Toate conexiunile SSL sunt încercate să fie securizate prin utilizarea CA
pachetul de certificate instalat implicit. Acest lucru ia în considerare toate conexiunile
„nesigur” eșuează dacă nu -k, --nesigur este folosit.

Consultați această resursă online pentru mai multe detalii:
http://curl.haxx.se/docs/sslcerts.html

-K, --config
Specificați din ce fișier de configurare să citiți argumentele curl. Fișierul de configurare este un text
fișier în care pot fi scrise argumente în linia de comandă care apoi vor fi folosite ca și cum
au fost scrise pe linia de comandă propriu-zisă.

Opțiunile și parametrii acestora trebuie să fie specificați pe aceeași linie de fișier de configurare,
separate prin spații albe, două puncte sau semnul egal. Numele lungi de opțiuni pot
opțional să fie date în fișierul de configurare fără liniuțele duble inițiale și dacă da,
caracterele două puncte sau egale pot fi folosite ca separatori. Dacă opțiunea este
specificate cu una sau două liniuțe, nu pot exista două puncte sau un caracter egal între
opțiunea și parametrul acesteia.

Dacă parametrul trebuie să conțină spații albe, parametrul trebuie să fie inclus în interior
citate. Între ghilimele duble, sunt disponibile următoarele secvențe de evadare: \\, \",
\t, \n, \r și \v. O bară oblică inversă care precede orice altă literă este ignorată. Dacă primul
coloana unei linii de configurare este un caracter „#”, restul liniei va fi tratat ca
un comentariu. Scrieți o singură opțiune pe fiecare linie fizică în fișierul de configurare.

Specificați numele fișierului la -K, --config ca „-” pentru a face curl să citească fișierul din stdin.

Rețineți că pentru a putea specifica o adresă URL în fișierul de configurare, trebuie să o specificați
folosind --url opțiunea, și nu prin simpla scriere a adresei URL pe propria linie. Deci, asta
ar putea arata asemanator cu asta:

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

Când curl este invocat, acesta întotdeauna (cu excepția cazului în care -q este utilizat) verifică pentru o configurație implicită
fișier și îl folosește dacă este găsit. Fișierul de configurare implicit este verificat în cele ce urmează
plaseaza in aceasta ordine:

1) curl încearcă să găsească „directorul de acasă”: mai întâi verifică CURL_HOME și apoi
variabilele de mediu HOME. În caz contrar, folosește getpwuid() pe Unix-like
sisteme (care returnează directorul de acasă dat de utilizatorul curent din sistemul dumneavoastră). Pe
Windows, verifică apoi variabila APPDATA sau, ca ultimă soluție,
„%USERPROFILE%\Datele aplicației”.

2) Pe Windows, dacă nu există niciun fișier _curlrc în directorul de acasă, verifică unul în
este plasat același director în care executabilul curl este plasat. Pe sisteme asemănătoare Unix, va fi pur și simplu
încercați să încărcați .curlrc din directorul de acasă determinat.

# --- Exemplu de fișier ---
# acesta este un comentariu
url = "curl.haxx.se"
output = "curlhere.html"
user-agent = "superagent/1.0"

# și obțineți și o altă adresă URL
url = „curl.haxx.se/docs/manpage.html”
-O
referer = "http://nowhereatall.com/"
# --- Sfârșitul fișierului exemplu ---

Această opțiune poate fi folosită de mai multe ori pentru a încărca mai multe fișiere de configurare.

--ţine-timp
Această opțiune setează timpul pe care o conexiune trebuie să rămână inactivă înainte de trimitere
sondele keepalive și timpul dintre sondele keepalive individuale. În prezent este
eficient pe sistemele de operare care oferă soclul TCP_KEEPIDLE și TCP_KEEPINTVL
opțiuni (adică Linux, AIX recent, HP-UX și multe altele). Această opțiune nu are efect dacă
--nu-ţine în viaţă este folosit. (Adăugat în 7.18.0)

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima. Dacă nu este specificat,
opțiunea este implicită la 60 de secunde.

--cheie
(SSL/SSH) Nume fișier cheie privată. Vă permite să furnizați cheia dvs. privată în acest sens
dosar separat. Pentru SSH, dacă nu este specificat, curl încearcă următorii candidați
Ordin: '~/.ssh/id_rsa','~/.ssh/id_dsa', './id_rsa', './id_dsa'.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--tip-cheie
(SSL) Tip de fișier cu cheie privată. Specificați ce tip dvs --cheie cu condiția cheie privată este.
DER, PEM și ENG sunt acceptate. Dacă nu este specificat, se presupune PEM.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--krb
(FTP) Activați autentificarea și utilizarea Kerberos. Nivelul trebuie introdus și ar trebui
fie unul dintre „clar”, „sigur”, „confidenţial” sau „privat”. Ar trebui să folosiți un nivel
acesta nu este unul dintre acestea, va fi folosit în schimb „privat”.

Această opțiune necesită o bibliotecă construită cu suport kerberos4. Acest lucru nu este foarte
uzual. Utilizare -V, --versiune pentru a vedea dacă bucla o susține.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-l, --list-only
(FTP) Când listați un director FTP, acest comutator forțează o vizualizare numai cu nume. Aceasta este
util mai ales dacă utilizatorul dorește să analizeze automat conținutul unui FTP
director, deoarece vizualizarea normală a directorului nu folosește un aspect sau un format standard.
Când este utilizată astfel, opțiunea face ca o comandă NLST să fie trimisă către server
în loc de LIST.

Notă: Unele servere FTP listează numai fișiere în răspunsul lor la NLST; ei nu
includ subdirectoare și legături simbolice.

(POP3) Când preluați un anumit e-mail din POP3, acest comutator forțează o LISTĂ
comanda să fie executată în locul RETR. Acest lucru este deosebit de util dacă utilizatorul
vrea să vadă dacă un anumit ID de mesaj există pe server și ce dimensiune are.

Notă: Când este combinat cu -X, --cerere , această opțiune poate fi folosită pentru a trimite
o comandă UIDL, astfel încât utilizatorul poate folosi mai degrabă identificatorul unic al e-mailului
decât este ID-ul mesajului pentru a face cererea. (Adăugat în 7.21.5)

-L, --locație
(HTTP/HTTPS) Dacă serverul raportează că pagina solicitată s-a mutat pe o altă pagină
locație (indicată cu un antet Locație: și un cod de răspuns 3XX), această opțiune
va face curl reface cererea pe noul loc. Dacă este utilizat împreună cu -eu,
--include or -Eu, --cap, se vor afișa antetele din toate paginile solicitate. Când
este utilizată autentificarea, curl își trimite acreditările doar gazdei inițiale. În cazul în care un
redirecționarea duce curl la o altă gazdă, nu va putea intercepta
utilizator+parolă. Vezi si --locație-de încredere despre cum să schimbi asta. Puteți limita
cantitatea de redirecționări de urmat utilizând --max-redirs opțiune.

Când curl urmează o redirecționare și cererea nu este un simplu GET (de exemplu POST
sau PUT), va face următoarea solicitare cu un GET dacă răspunsul HTTP a fost 301,
302 sau 303. Dacă codul de răspuns a fost orice alt cod 3xx, curl va retrimite
următoarea solicitare folosind aceeași metodă nemodificată.

Puteți spune curl să nu schimbe metoda de solicitare non-GET în GET după 30x
răspuns folosind opțiunile dedicate pentru asta: --post301, --post302 și
-post303.

--libcurl
Adăugați această opțiune la orice linie de comandă curl obișnuită și veți obține un libcurl-
folosind codul sursă C scris în fișierul care face echivalentul a ceea ce dvs
operațiunea de linie de comandă face!

Dacă această opțiune este folosită de mai multe ori, va fi folosit ultimul nume de fișier dat. (Adăugat
în 7.16.1)

--limit-rate
Specificați rata maximă de transfer pe care doriți să o folosească curl - atât pentru descărcări, cât și pentru
încărcări. Această caracteristică este utilă dacă aveți o țeavă limitată și doriți
transferați pentru a nu folosi întreaga lățime de bandă. Pentru a o face mai lent decât altfel
va fi.

Viteza dată este măsurată în octeți/secundă, cu excepția cazului în care este adăugat un sufix.
Adăugarea „k” sau „K” va număra numărul ca kiloocteți, „m” sau M” îl face
megaocteți, în timp ce „g” sau „G” fac gigaocteți. Exemple: 200K, 3m și 1G.

Rata dată este viteza medie numărată pe parcursul întregului transfer. Inseamna
acea buclă ar putea folosi viteze de transfer mai mari în rafale scurte, dar în timp se folosește
nu mai mult decât rata dată.

Dacă folosiți și -Y, --Limită de viteză opțiunea, acea opțiune va avea prioritate și
ar putea paraliza ușor limitarea ratei, pentru a ajuta la păstrarea logicii limitei de viteză
lucru.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--local-port [-num]
Setați un număr preferat sau un interval de numere de porturi locale de utilizat pentru conexiuni.
Rețineți că numerele de port, prin natura lor, sunt o resursă limitată, care va fi ocupată uneori
deci setarea acestui interval la ceva prea îngust ar putea cauza conexiuni inutile
erori de configurare. (Adăugat în 7.15.2)

--locație-de încredere
(HTTP/HTTPS) Ca -L, --Locație, dar va permite trimiterea numelui + parolei tuturor
gazde către care site-ul poate redirecționa. Acest lucru poate introduce sau nu o garanție
încălcare dacă site-ul vă redirecționează către un site către care veți trimite autentificarea
info (care este text simplu în cazul autentificării de bază HTTP).

-m, --max-time
Timp maxim în secunde pe care îl permiteți să dureze întreaga operațiune. Acest lucru este util
pentru a preveni blocarea sarcinilor dvs. în lot ore în șir din cauza rețelelor sau a legăturilor lente
merge in jos. Din 7.32.0, această opțiune acceptă valori zecimale, dar cele reale
timeout-ul va scădea în precizie pe măsură ce timeout-ul specificat crește în zecimală
precizie. Vezi și --connect-timeout opțiune.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--login-options
Specificați opțiunile de conectare de utilizat în timpul autentificării serverului.

Puteți utiliza opțiunile de conectare pentru a specifica opțiunile specifice protocolului care pot fi utilizate
în timpul autentificării. În prezent, doar IMAP, POP3 și SMTP acceptă opțiunile de conectare.
Pentru mai multe informații despre opțiunile de conectare, consultați RFC 2384, RFC 5092 și IETF
draft draft-earhart-url-smtp-00.txt (Adăugat în 7.34.0).

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--mail-auth
(SMTP) Specificați o singură adresă. Acesta va fi folosit pentru a specifica autentificarea
adresa (identitatea) unui mesaj trimis care este transmis către un alt server.

(Adăugat în 7.25.0)

--mail-de la
(SMTP) Specificați o singură adresă de la care e-mailul dat ar trebui să fie trimis.

(Adăugat în 7.20.0)

--max-filesize
Specificați dimensiunea maximă (în octeți) a unui fișier de descărcat. Dacă dosarul solicitat este
mai mare decât această valoare, transferul nu va începe și curl va reveni cu ieșire
cod 63.

NOTĂ: Mărimea fișierului nu este întotdeauna cunoscută înainte de descărcare, iar pentru astfel de fișiere aceasta
opțiunea nu are efect chiar dacă transferul de fișiere ajunge să fie mai mare decât cea dată
limită. Acest lucru privește atât transferurile FTP, cât și HTTP.

--mail-rcpt
(SMTP) Specificați o singură adresă, un nume de utilizator sau un nume de listă de corespondență.

Când efectuați un transfer de e-mail, destinatarul trebuie să specifice o adresă de e-mail validă
pentru a trimite e-mailul către. (Adăugat în 7.20.0)

Când se efectuează o verificare a adresei (comandă VRFY), destinatarul ar trebui să fie
specificat ca nume de utilizator sau nume de utilizator și domeniu (conform secțiunii 3.5 din RFC5321).
(Adăugat în 7.34.0)

Când efectuați o extindere a listei de corespondență (comanda EXPN), destinatarul ar trebui să fie
specificat folosind numele listei de corespondență, cum ar fi „Prieteni” sau „Oficiul Londra”.
(Adăugat în 7.34.0)

--max-redirs
Setați numărul maxim de urmăriri de redirecționare permise. Dacă -L, --Locație este folosit,
această opțiune poate fi folosită pentru a preveni curl să urmărească redirecționări „în absurd”.
În mod implicit, limita este setată la 50 de redirecționări. Setați această opțiune la -1 pentru a o face
nelimitat.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--metalink
Această opțiune îi poate spune lui curl să analizeze și să proceseze un anumit URI ca fișier Metalink (ambele
versiunile 3 și 4 (RFC 5854) sunt acceptate) și folosesc oglinzile enumerate în
pentru failover dacă există erori (cum ar fi fișierul sau serverul care nu este disponibil).
De asemenea, va verifica hash-ul fișierului după finalizarea descărcării. Metalinkul
fișierul în sine este descărcat și procesat în memorie și nu stocat în fișierul local
sistemului.

Exemplu de utilizare a unui fișier Metalink la distanță:

răsuci --metalink http://www.example.com/example.metalink

Pentru a utiliza un fișier Metalink în sistemul de fișiere local, utilizați protocolul FILE (file://):

răsuci --metalink file://example.metalink

Vă rugăm să rețineți că, dacă protocolul FILE este dezactivat, nu există nicio modalitate de a utiliza un local
Fișierul Metalink la momentul scrierii acestui articol. De asemenea, rețineți că dacă --metalink și
--include sunt folosite împreună, --include vor fi ignorate. Acest lucru se datorează faptului că inclusiv
anteturile din răspuns vor rupe analizatorul Metalink și dacă anteturile sunt incluse
în fișierul descris în fișierul Metalink, verificarea hash va eșua.

(Adăugat în 7.27.0, dacă este construit pe baza bibliotecii libmetalink.)

-n, --netrc
Face ca curl să scaneze .netrc (_netrc pe Windows) în directorul principal al utilizatorului
pentru numele de conectare și parola. Acesta este de obicei folosit pentru FTP pe Unix. Dacă este folosit cu
HTTP, curl va permite autentificarea utilizatorului. Vedea netrc(5) ftp(1) pentru detalii despre
tipul fisierului. Curl nu se va plânge dacă acel fișier nu are permisiunile potrivite
(nu ar trebui să fie citibil în lume sau în grup). Variabila de mediu „HOME”
este folosit pentru a găsi directorul principal.

Un exemplu rapid și foarte simplu despre cum să configurați a .netrc pentru a permite curl la FTP la
mașina host.domain.com cu numele de utilizator „eu” și parola „secret” ar trebui
arata asemanator cu:

maşină gazdă.domeniu.com Logare eu parola secret

-N, --fără tampon
Dezactivează tamponarea fluxului de ieșire. În situații normale de lucru, curl va
utilizați un flux de ieșire tamponat standard care va avea efectul pe care îl va scoate
datele în bucăți, nu neapărat exact când sosesc datele. Folosind asta
opțiunea va dezactiva acea tamponare.

Rețineți că acesta este numele opțiunii negate documentat. Puteți folosi astfel --tampon la
impuneți tamponarea.

--netrc-file
Această opțiune este similară cu --netrc, cu excepția faptului că furnizați calea (absolut sau
relativ) la fișierul netrc pe care Curl ar trebui să-l folosească. Puteți specifica doar un singur netrc
fișier per invocare. Dacă mai multe --netrc-file sunt oferite opțiuni, numai ultimul
unu va fi folosit. (Adăugat în 7.21.5)

Această opțiune anulează orice utilizare a --netrc întrucât se exclud reciproc. Se va
respecta de asemenea --netrc-opțional dacă este specificat.

--netrc-opțional
Foarte similar cu --netrc, dar această opțiune face utilizarea .netrc facultativ si nu
obligatoriu ca și --netrc opțiunea face.

--a negocia
(HTTP) Activează autentificarea de negociere (SPNEGO).

Dacă doriți să activați Negocierea (SPNEGO) pentru autentificarea proxy, atunci utilizați
--proxy-negociate.

Această opțiune necesită o bibliotecă construită cu suport GSS-API sau SSPI. Utilizare -V,
--versiune pentru a vedea dacă bucla acceptă GSS-API/SSPI și SPNEGO.

Când utilizați această opțiune, trebuie să furnizați și un fals -u, --utilizator opțiunea de activare
codul de autentificare în mod corespunzător. Trimiterea unui „-u :” este suficientă ca nume de utilizator și
parola de la -u opțiunea nu sunt de fapt utilizate.

Dacă această opțiune este folosită de mai multe ori, se folosește doar prima.

--nu-ţine în viaţă
Dezactivează utilizarea mesajelor keepalive pe conexiunea TCP, ca curl implicit
le permite.

Rețineți că acesta este numele opțiunii negate documentat. Puteți folosi astfel --ține în viață
pentru a impune keepalive.

--no-sesiunid
(SSL) Dezactivează utilizarea de către curl a memoriei cache a ID-ului de sesiune SSL. În mod implicit, toate transferurile sunt
terminat folosind memoria cache. Rețineți că, deși nimic nu ar trebui să fie rănit încercând
reutilizați ID-urile de sesiune SSL, se pare că există implementări SSL rupte în sălbăticie
poate solicita să dezactivați acest lucru pentru a reuși. (Adăugat în 7.16.0)

Rețineți că acesta este numele opțiunii negate documentat. Puteți folosi astfel --sesiune ID
pentru a impune memorarea în cache a ID-ului de sesiune.

--noproxy
Lista de gazde separate prin virgulă care nu utilizează un proxy, dacă este specificat unul. The
numai metacaracterul este un singur caracter *, care se potrivește cu toate gazdele și efectiv
dezactivează proxy-ul. Fiecare nume din această listă se potrivește fie ca domeniu care
conține numele de gazdă sau numele de gazdă însuși. De exemplu, local.com s-ar potrivi
local.com, local.com:80 și www.local.com, dar nu și www.notlocal.com. (Adăugat în
7.19.4).

--ntlm (HTTP) Activează autentificarea NTLM. Metoda de autentificare NTLM a fost concepută de
Microsoft și este utilizat de serverele web IIS. Este un protocol proprietar, invers
conceput de oameni inteligenți și implementat în curl pe baza eforturilor lor. Acest
tip de comportament nu ar trebui să fie aprobat, ar trebui să încurajați pe toți cei care folosesc
NTLM pentru a trece la o metodă de autentificare publică și documentată, cum ar fi
Digera.

Dacă doriți să activați NTLM pentru autentificarea proxy, atunci utilizați --proxy-ntlm.

Această opțiune necesită o bibliotecă construită cu suport SSL. Utilizare -V, --versiune sa vezi daca
bucla dvs. acceptă NTLM.

Dacă această opțiune este folosită de mai multe ori, se folosește doar prima.

-o, --ieșire
Scrie ieșire în în loc de stdout. Dacă utilizați {} sau [] pentru a prelua
mai multe documente, puteți folosi „#” urmat de un număr în specificatorul.
Variabila respectivă va fi înlocuită cu șirul curent pentru adresa URL preluată.
Ca în:

curl http://{one,two}.site.com -o „fișier_#1.txt”

sau utilizați mai multe variabile precum:

curl http://{site,host}.host[1-5].com -o „#1_#2”

Puteți utiliza această opțiune de câte ori este numărul de adrese URL pe care le aveți.

Consultați și --create-dirs opțiunea de a crea directoarele locale în mod dinamic.
Specificarea ieșirii ca „-” (o singură liniuță) va forța rezultatul
stdout.

-O, --nume-la distanță
Scrieți rezultatul într-un fișier local numit ca fișierul de la distanță pe care îl primim. (Numai partea de fișier
din fișierul de la distanță este utilizat, calea este tăiată.)

Numele fișierului de la distanță de utilizat pentru salvare este extras din adresa URL dată, nimic
altceva.

În consecință, fișierul va fi salvat în directorul de lucru curent. daca tu
doriți ca fișierul să fie salvat într-un alt director, asigurați-vă că schimbați funcționarea curentă
directorul înainte de a invoca curl cu -O, --nume-la distanță steag!

Nu se face nicio decodare URL pentru numele fișierului. Dacă are %20 sau altă adresă URL codificată
părți ale numelui, vor ajunge așa cum este ca nume de fișier.

Puteți utiliza această opțiune de câte ori este numărul de adrese URL pe care le aveți.

--oauth2-bearer
(IMAP, POP3, SMTP) Specificați simbolul purtător pentru autentificarea serverului OAUTH 2.0.
Bearer Token este utilizat împreună cu numele de utilizator care poate fi specificat
Ca parte a --url or -u, --utilizator opțiuni.

Bearer Token și numele de utilizator sunt formatate conform RFC 6750.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--proxy-header
(HTTP) Antet suplimentar de inclus în cerere atunci când trimiteți HTTP către un proxy. Poți
specificați orice număr de anteturi suplimentare. Aceasta este opțiunea echivalentă cu -H, --antet
dar este pentru comunicarea proxy doar ca în solicitările CONNECT atunci când doriți a
antet separat trimis către proxy la ceea ce este trimis gazdei la distanță reală.

curl se va asigura că fiecare antet pe care îl adăugați/înlocuiți este trimis cu finalul adecvat-
marcator de linie, așa ar trebui nu adăugați că ca parte a conținutului antetului: do
nu adăugați linii noi sau returnări de mașină, ele vor face doar încurcătură pentru dvs.

Anteturile specificate cu această opțiune nu vor fi incluse în cererile pe care Curl le cunoaște
nu vor fi trimise unui proxy.

Această opțiune poate fi folosită de mai multe ori pentru a adăuga/înlocui/elimina mai multe anteturi.

(Adăugat în 7.37.0)

-p, --proxytunnel
Când este utilizat un proxy HTTP (-X, --proxy), această opțiune va genera protocoale non-HTTP
pentru a încerca să faceți un tunel prin proxy în loc să îl folosiți doar pentru a face HTTP-like
operațiuni. Abordarea tunelului se face cu cererea HTTP proxy CONNECT și
necesită ca proxy-ul să permită conectarea directă la numărul portului de la distanță curl vrea
a tunel prin la.

-P, --ftp-port
(FTP) Inversează rolurile implicite de inițiator/ascultător la conectarea cu FTP. Acest
comutatorul face ca curl să folosească modul activ. În practică, curl îi spune serverului să facă
conectați-vă înapoi la adresa și portul specificate de client, în timp ce modul pasiv solicită
serverul să configureze o adresă IP și un port la care să se conecteze. ar trebui să
fi unul dintre:

interfață
adică „eth0” pentru a specifica adresa IP a interfeței pe care doriți să o utilizați (Unix
numai)

Adresa IP
adică „192.168.10.1” pentru a specifica adresa IP exactă

numele gazdei
adică „my.host.domain” pentru a specifica mașina

- faceți curl să aleagă aceeași adresă IP care este deja folosită pentru control
conexiune

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima. Dezactivați utilizarea
PORT cu --ftp-pasv. Dezactivați încercarea de a utiliza comanda EPRT în loc de PORT
prin utilizarea --disable-eprt. EPRT este cu adevărat PORT++.

Începând cu 7.19.5, puteți adăuga „:[start]-[end]” în dreapta adresei, pentru
spune-i lui curl ce interval de porturi TCP să folosească. Asta înseamnă că specificați un interval de porturi, de la a
mai mic la un număr mai mare. Un singur număr funcționează de asemenea, dar rețineți că acesta
crește riscul de defecțiune, deoarece portul poate să nu fie disponibil.

--trece
(SSL/SSH) Expresie de acces pentru cheia privată

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--calea-ca-așa-asta
Spune-i lui curl să nu se ocupe de secvențele de /../ or /./ în calea URL dată. În mod normal
curl le va zdrobi sau îmbina în conformitate cu standardele, dar cu această opțiune vă setați
spune-i să nu facă asta.

(Adăugat în 7.42.0)

--post301
(HTTP) Spune curl să respecte RFC 7230/6.4.2 și să nu transforme cererile POST în GET
solicitări atunci când urmează o redirecționare 301. Comportamentul non-RFC este omniprezent în
browsere web, deci curl face conversia în mod implicit pentru a menține consistența.
Cu toate acestea, un server poate solicita un POST pentru a rămâne POST după o astfel de redirecționare.
Această opțiune are sens numai atunci când se utilizează -L, --Locație (Adăugat în 7.17.1)

--post302
(HTTP) Spune curl să respecte RFC 7230/6.4.3 și să nu transforme cererile POST în GET
solicitări atunci când urmează o redirecționare 302. Comportamentul non-RFC este omniprezent în
browsere web, deci curl face conversia în mod implicit pentru a menține consistența.
Cu toate acestea, un server poate solicita un POST pentru a rămâne POST după o astfel de redirecționare.
Această opțiune are sens numai atunci când se utilizează -L, --Locație (Adăugat în 7.19.1)

--post303
(HTTP) Spune curl să respecte RFC 7230/6.4.4 și să nu transforme cererile POST în GET
solicitări atunci când urmează o redirecționare 303. Comportamentul non-RFC este omniprezent în
browsere web, deci curl face conversia în mod implicit pentru a menține consistența.
Cu toate acestea, un server poate solicita un POST pentru a rămâne POST după o astfel de redirecționare.
Această opțiune are sens numai atunci când se utilizează -L, --Locație (Adăugat în 7.26.0)

--proto
Spune lui curl să folosească protocoalele enumerate pentru recuperarea inițială. Protocoalele sunt
evaluate de la stânga la dreapta, sunt separate prin virgulă și sunt fiecare un nume de protocol sau
„toate”, prefix opțional cu zero sau mai mulți modificatori. Modificatorii disponibili sunt:

+ Permiteți acest protocol în plus față de protocoalele deja permise (acesta este
implicit dacă nu este utilizat niciun modificator).

- Respinge acest protocol, eliminându-l din lista de protocoale deja permise.

= Permiteți numai acest protocol (ignorând lista deja permisă), deși subiect
pentru modificarea ulterioară prin intrări ulterioare din lista separată prin virgulă.

De exemplu:

--proto -ftps folosește protocoalele implicite, dar dezactivează ftps

--proto -toate,https,+http
activează numai http și https

--proto =http,https
de asemenea, activează numai http și https

Protocoalele necunoscute produc un avertisment. Acest lucru permite scripturilor să se bazeze în siguranță pe a fi
capabil să dezactiveze protocoalele potențial periculoase, fără a se baza pe suport pentru
acel protocol fiind încorporat în curl pentru a evita o eroare.

Această opțiune poate fi folosită de mai multe ori, caz în care efectul este același ca
concatenarea protocoalelor într-o singură instanță a opțiunii.

(Adăugat în 7.20.2)

--proto-implicit
Spune buclei să folosească protocol pentru orice URL care lipsește un nume de schemă.

Exemplu:

--proto-default https ftp.mozilla.org
https://ftp.mozilla.org

Un protocol necunoscut sau neacceptat provoacă o eroare CURLE_UNSUPPORTED_PROTOCOL.

Această opțiune nu modifică protocolul proxy implicit (http).

Fără această opțiune curl ar face o ghicire bazată pe gazdă, vezi --url pentru detalii.

(Adăugat în 7.45.0)

--proto-redir
Spune lui curl să folosească protocoalele enumerate la redirecționare. Vedeți --proto pentru a afla cum protocoale
sunt reprezentate.

Exemplu:

--proto-redir -all,http,https
Permiteți numai HTTP și HTTPS la redirecționare.

În mod implicit, curl va permite redirecționarea tuturor protocoalelor, cu excepția celor mai multe dezactivate pentru securitate
motive: Din moment ce 7.19.4 FILE și SCP sunt dezactivate, iar din 7.40.0 SMB și SMBS sunt de asemenea
dezactivat. Precizând toate or +toate activează toate protocoalele de redirecționare, inclusiv cele
dezactivat pentru securitate.

(Adăugat în 7.20.2)

--proxy-anyauth
Spune lui curl să aleagă o metodă de autentificare potrivită atunci când comunică cu
proxy dat. Acest lucru poate cauza o cerere/răspuns suplimentar dus-întors. (Adăugat în
7.13.2)

--proxy-de bază
Spune lui curl să folosească autentificarea de bază HTTP atunci când comunică cu datele date
proxy. Utilizare --de bază pentru activarea HTTP Basic cu o gazdă la distanță. De bază este implicit
metoda de autentificare curl folosește cu proxy.

--proxy-digest
Spune lui curl să folosească autentificarea HTTP Digest atunci când comunică cu datele date
proxy. Utilizare --digera pentru activarea HTTP Digest cu o gazdă la distanță.

--proxy-negociate
Spune lui curl să folosească autentificarea HTTP Negotiate (SPNEGO) atunci când comunică cu
proxy-ul dat. Utilizare --a negocia pentru activarea HTTP Negotiate (SPNEGO) cu o telecomandă
gazdă. (Adăugat în 7.17.1)

--proxy-ntlm
Spune lui curl să folosească autentificarea HTTP NTLM atunci când comunică cu proxy-ul dat.
Utilizare --ntlm pentru activarea NTLM cu o gazdă la distanță.

--nume-serviciu-proxy
Această opțiune vă permite să schimbați numele serviciului pentru negocierea proxy.

Exemple: --proxy-negotiate proxy-name --nume-serviciu-proxy sockd ar folosi
sockd/nume-proxy. (Adăugat în 7.43.0).

--proxy1.0
Utilizați proxy-ul HTTP 1.0 specificat. Dacă numărul portului nu este specificat, este
presupus la portul 1080.

Singura diferență între aceasta și opțiunea proxy HTTP (-X, --proxy), este asta
încercările de a utiliza CONNECT prin proxy vor specifica în schimb un protocol HTTP 1.0
a HTTP implicit 1.1.

--pubkey
(SSH) Numele fișierului cheie publică. Vă permite să furnizați cheia publică în acest separat
fișier.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

(Începând cu 7.39.0, curl încearcă să extragă automat cheia publică din
fișier cu cheie privată, deci trecerea acestei opțiuni nu este, în general, necesară. Rețineți că aceasta
extragerea cheii publice necesită ca libcurl să fie legat de o copie a libssh2 1.2.8
sau mai mare care este în sine legată de OpenSSL.)

-q Dacă este folosit ca prim parametru pe linia de comandă, curlrc fișierul de configurare nu va
fi citit și folosit. Vezi -K, --config pentru detalii despre fișierul de configurare implicit
cale de căutare.

-Q, --citat
(FTP/SFTP) Trimiteți o comandă arbitrară către serverul FTP sau SFTP de la distanță. Citat
comenzile sunt trimise ÎNAINTE ca transferul să aibă loc (chiar după PWD inițial
comandă într-un transfer FTP, mai exact). Pentru a face comenzile să aibă loc după a
transfer reușit, prefixați-le cu o liniuță „-”. Pentru a face comenzile să fie trimise după
curl a schimbat directorul de lucru, chiar înainte de prefixul comenzilor de transfer
comanda cu un „+” (acest lucru este acceptat numai pentru FTP). Puteți specifica orice număr
a comenzilor. Dacă serverul returnează eșec pentru una dintre comenzi, întregul
operațiunea va fi întreruptă. Trebuie să trimiteți comenzi FTP corecte din punct de vedere sintactic ca RFC
959 definește servere FTP sau una dintre comenzile enumerate mai jos pentru servere SFTP.
Această opțiune poate fi folosită de mai multe ori. Când vorbiți cu un server FTP, prefixați
comanda cu un asterisc (*) pentru a face curl să continue chiar dacă comanda eșuează ca de
curl implicit se va opri la prima eșec.

SFTP este un protocol binar. Spre deosebire de FTP, curl interpretează comenzile de citate SFTP
înainte de a le trimite la server. Numele fișierelor pot fi citate în stil shell la
încorporați spații sau caractere speciale. Mai jos este lista tuturor SFTP acceptate
comenzi citate:

fișierul grup chgrp
Comanda chgrp setează ID-ul de grup al fișierului la care este numit operandul fișierului
ID-ul grupului specificat de operandul de grup. Operandul de grup este o zecimală
ID-ul grupului întreg.

fișierul mod chmod
Comanda chmod modifică biții în modul fișier ai fișierului specificat. The
operandul de mod este un număr întreg octal de mod.

fișier utilizator chown
Comanda chown setează proprietarul fișierului numit de operandul fișierului la
ID-ul utilizatorului specificat de operandul utilizator. Operandul utilizator este o zecimală
ID utilizator întreg.

în fișier_sursă fișier_țintă
Comenzile ln și symlink creează o legătură simbolică la fișierul_țintă
locație care indică locația fișierului_sursă.

mkdir nume_director
Comanda mkdir creează directorul numit de operandul directory_name.

pwd Comanda pwd returnează calea absolută a lucrării curente
director.

redenumiți ținta sursă
Comanda rename redenumește fișierul sau directorul numit de operandul sursă
la calea de destinație numită de operandul țintă.

fișier rm
Comanda rm elimină fișierul specificat de operandul fișierului.

directorul rmdir
Comanda rmdir elimină intrarea în director specificată de director
operand, cu condiția să fie gol.

link simbolic fișier_sursă fișier_țintă
Vezi ln.

-r, --gamă
(HTTP/FTP/SFTP/FIȘIER) Preluați un interval de octeți (adică un document parțial) dintr-un
HTTP/1.1, server FTP sau SFTP sau un FIȘIER local. Intervalele pot fi specificate într-un număr
de căi.

0-499 specifică primii 500 de octeți

500-999 specifică al doilea 500 de octeți

-500 specifică ultimii 500 de octeți

9500- specifică octeții de la offset 9500 și înainte

0-0,-1 specifică doar primul și ultimul octet (*) (HTTP)

100-199,500-599
specifică două intervale separate de 100 de octeți (*) (HTTP)

(*) = NOTĂ că acest lucru va determina serverul să răspundă cu un răspuns în mai multe părți!

Numai caracterele cu cifre (0-9) sunt valide în câmpurile „start” și „stop” ale
sintaxa intervalului „start-stop”. Dacă în interval este dat un caracter fără cifre,
răspunsul serverului va fi nespecificat, în funcție de configurația serverului.

De asemenea, ar trebui să știți că multe servere HTTP/1.1 nu au această caracteristică
activat, astfel încât atunci când încercați să obțineți un interval, veți obține în schimb întregul
documentului.

Descărcările în intervalul FTP și SFTP acceptă doar sintaxa simplă „start-stop”.
(opțional cu unul dintre numere omis). Utilizarea FTP depinde de FTP-ul extins
comanda SIZE.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-R, --remote-time
Când este utilizat, acest lucru va face curl încercarea de a afla marcajul de timp al telecomenzii
fișier și, dacă acesta este disponibil, faceți ca fișierul local să primească același marcaj temporal.

--random-file
(SSL) Specificați calea către fișierul care conține ceea ce va fi considerat aleatoriu
date. Datele sunt folosite pentru a genera motorul aleatoriu pentru conexiunile SSL. Vezi și
--egd-file opțiune.

--raw (HTTP) Când este utilizat, dezactivează toată decodarea HTTP internă a conținutului sau transferului
codificări și, în schimb, le face să fie transmise nealterate, brute. (Adăugat în 7.16.2)

--remote-name-all
Această opțiune modifică acțiunea implicită pentru toate adresele URL date, care urmează să fie tratate ca și cum
-O, --nume-la distanță au fost folosite pentru fiecare. Deci, dacă doriți să dezactivați asta pentru a
URL specific după --remote-name-all a fost folosit, trebuie să utilizați „-o -” sau --Nu-
nume la distanță. (Adăugat în 7.19.0)

--rezolva
Furnizați o adresă personalizată pentru o anumită pereche de porturi și gazdă. Folosind asta, poți
faceți ca cererile de curl să utilizeze o adresă specificată și să împiedicați altfel
adresa rezolvată în mod normal care urmează să fie utilizată. Consideră-l un fel de / Etc / hosts alternativă
furnizate pe linia de comandă. Numărul portului ar trebui să fie numărul folosit pentru
protocol specific pentru care va fi folosită gazda. Înseamnă că aveți nevoie de mai multe intrări dacă
doriți să furnizați o adresă pentru aceeași gazdă, dar porturi diferite.

Această opțiune poate fi folosită de mai multe ori pentru a adăuga multe nume de gazdă de rezolvat.

(Adăugat în 7.21.3)

--reîncercați
Dacă o eroare tranzitorie este returnată când curl încearcă să efectueze un transfer, va fi
reîncercați acest număr de ori înainte de a renunța. Setarea numărului la 0 face ca curl să se descurce
fără reîncercări (care este implicit). Eroare tranzitorie înseamnă fie: un timeout, un FTP
cod de răspuns 4xx sau un cod de răspuns HTTP 5xx.

Când curl este pe cale să reîncerce un transfer, va aștepta mai întâi o secundă și apoi pentru
toate încercările viitoare vor dubla timpul de așteptare până când ajunge la 10 minute
care va fi atunci întârzierea dintre restul încercărilor. Prin utilizarea --reîncercați-
întârziere dezactivați acest algoritm de backoff exponențial. Vezi si --retry-max-time la
limitați timpul total permis pentru reîncercări. (Adăugat în 7.12.3)

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--retry-delay
Faceți curl să stea în această perioadă de timp înainte de fiecare reîncercare când transferul a eșuat
cu o eroare tranzitorie (schimbă algoritmul implicit de timp de retragere între
reîncercări). Această opțiune este interesantă doar dacă --reîncercați este de asemenea folosit. Setarea asta
întârzierea la zero va face curl să folosească timpul implicit de retragere. (Adăugat în 7.12.3)

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--retry-max-time
Cronometrul de reîncercare este resetat înainte de prima încercare de transfer. Reîncercările se vor face ca
obișnuit (vezi --reîncercați) atâta timp cât temporizatorul nu a atins această limită dată. Înștiințare
că dacă cronometrul nu a atins limita, cererea va fi făcută și în timp
performanță, poate dura mai mult decât această perioadă de timp dată. Pentru a limita un singur
timpul maxim al cererii, utilizare -m, --max-time. Setați această opțiune la zero pentru a nu expira
reîncercări. (Adăugat în 7.12.3)

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-s, --tăcut
Mod silențios sau silențios. Nu afișați contorul de progres sau mesajele de eroare. Face Curl
mut. Va scoate în continuare datele pe care le solicitați, eventual chiar către
terminal/stdout dacă nu îl redirecționați.

--sasl-ir
Activați răspunsul inițial în autentificarea SASL. (Adăugat în 7.31.0)

--numele serviciului
Această opțiune vă permite să schimbați numele serviciului pentru SPNEGO.

Exemple: --negocia --numele serviciului sockd ar folosi sockd/nume-server. (Adăugat în
7.43.0).

-S, --show-error
Când este utilizat cu -s face curl să arate un mesaj de eroare dacă nu reușește.

--ssl (FTP, POP3, IMAP, SMTP) Încercați să utilizați SSL/TLS pentru conexiune. Revine la un non-
conexiune sigură dacă serverul nu acceptă SSL/TLS. Vezi si --ftp-ssl-
Control și --ssl-reqd pentru diferite niveluri de criptare necesare. (Adăugat în
7.20.0)

Această opțiune era cunoscută anterior ca --ftp-ssl (Adăugat în 7.11.0). Acest nume de opțiune poate
va fi folosit în continuare, dar va fi eliminat într-o versiune viitoare.

--ssl-reqd
(FTP, POP3, IMAP, SMTP) Necesită SSL/TLS pentru conexiune. Termină
conexiune dacă serverul nu acceptă SSL/TLS. (Adăugat în 7.20.0)

Această opțiune era cunoscută anterior ca --ftp-ssl-reqd (adăugat în 7.15.5). Opțiunea aceea
numele poate fi folosit în continuare, dar va fi eliminat într-o versiune viitoare.

--ssl-permite-fiară
(SSL) Această opțiune îi spune lui curl să nu rezolve o defecțiune de securitate în SSL3 și
Protocoale TLS1.0 cunoscute sub numele de BEAST. Dacă această opțiune nu este utilizată, stratul SSL poate utiliza
soluții de soluționare cunoscute că cauzează probleme de interoperabilitate cu unele SSL mai vechi
implementari. AVERTISMENT: această opțiune slăbește securitatea SSL și prin utilizarea acesteia
steag pe care-l ceri exact pentru asta. (Adăugat în 7.25.0)

--ssl-no-revocare
(WinSSL) Această opțiune îi spune curl să dezactiveze verificările de revocare a certificatelor. AVERTIZARE:
această opțiune slăbește securitatea SSL și, folosind acest flag, ceri exact
acea. (Adăugat în 7.44.0)

--șosete4
Utilizați proxy-ul SOCKS4 specificat. Dacă numărul portului nu este specificat, se presupune
la portul 1080. (Adăugat în 7.15.2)

Această opțiune anulează orice utilizare anterioară a -X, --proxy, așa cum sunt reciproc
exclusiv.

Din 7.21.7, această opțiune este de prisos, deoarece puteți specifica un proxy socks4 cu
-X, --proxy folosind un prefix de protocol socks4://.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--socks4a
Utilizați proxy-ul SOCKS4a specificat. Dacă numărul portului nu este specificat, se presupune
la portul 1080. (Adăugat în 7.18.0)

Această opțiune anulează orice utilizare anterioară a -X, --proxy, așa cum sunt reciproc
exclusiv.

Din 7.21.7, această opțiune este de prisos, deoarece puteți specifica un proxy socks4a cu
-X, --proxy folosind un prefix de protocol socks4a://.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--socks5-hostname
Utilizați proxy-ul SOCKS5 specificat (și lăsați proxy-ul să rezolve numele gazdei). Dacă
numărul portului nu este specificat, se presupune că este la portul 1080. (Adăugat în 7.18.0)

Această opțiune anulează orice utilizare anterioară a -X, --proxy, așa cum sunt reciproc
exclusiv.

Din 7.21.7, această opțiune este superfluă, deoarece puteți specifica un nume de gazdă socks5
proxy cu -X, --proxy folosind un prefix de protocol socks5h://.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima. (Această opțiune a fost
documentate anterior greșit și folosite ca --șosete fără numărul adăugat.)

--șosete5
Utilizați proxy-ul SOCKS5 specificat - dar rezolvați numele gazdei local. Dacă portul
numărul nu este specificat, este presupus la portul 1080.

Această opțiune anulează orice utilizare anterioară a -X, --proxy, așa cum sunt reciproc
exclusiv.

Din 7.21.7, această opțiune este de prisos, deoarece puteți specifica un proxy socks5 cu
-X, --proxy folosind un prefix de protocol socks5://.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima. (Această opțiune a fost
documentate anterior greșit și folosite ca --șosete fără numărul adăugat.)

Această opțiune (precum și --șosete4) nu funcționează cu IPV6, FTPS sau LDAP.

--socks5-gssapi-service
Numele implicit al serviciului pentru un server socks este rcmd/server-fqdn. Această opțiune permite
tu să-l schimbi.

Exemple: --socks5 proxy-name --socks5-gssapi-service sockd ar folosi sockd/proxy-
nume --socks5 nume-proxy --socks5-gssapi-service ar folosi sockd/real-name
sockd/real-name pentru cazurile în care numele proxy nu se potrivește cu numele principal.
(Adăugat în 7.19.4).

--socks5-gssapi-nec
Ca parte a negocierii GSS-API, este negociat un mod de protecție. RFC 1961 spune
în secțiunea 4.3/4.4 ar trebui protejat, dar implementarea de referință NEC
nu. Optiunea --socks5-gssapi-nec permite schimbul neprotejat al
negocierea modului de protecție. (Adăugat în 7.19.4).

--stderr
În schimb, redirecționează toate scrierile către stderr către fișierul specificat. Dacă numele fișierului este a
simplu „-”, este în schimb scris în stdout.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-t, --telnet-opțiune
Transferați opțiunile la protocolul telnet. Opțiunile acceptate sunt:

TTYPE= Setează tipul terminalului.

XDISPLOC= Setează locația de afișare X.

NEW_ENV= Setează o variabilă de mediu.

-T, --upload-file
Aceasta transferă fișierul local specificat la adresa URL la distanță. Dacă nu există o parte de fișier
în adresa URL specificată, Curl va adăuga numele fișierului local. NOTĂ că trebuie să utilizați
un final / pe ultimul director pentru a-i dovedi cu adevărat lui Curl că nu există niciun fișier
name sau curl va crede că ultimul nume de director este numele fișierului de la distanță
utilizare. Cel mai probabil, aceasta va duce la eșecul operațiunii de încărcare. Dacă aceasta este folosită pe
un server HTTP(S), va fi folosită comanda PUT.

Utilizați numele de fișier „-” (o singură liniuță) pentru a utiliza stdin în loc de un fișier dat.
Alternativ, numele fișierului „.” (o singură perioadă) poate fi specificată în loc de „-” la
utilizați stdin în modul de non-blocare pentru a permite citirea ieșirii serverului în timp ce stdin este în curs
încărcat.

Puteți specifica câte un -T pentru fiecare URL de pe linia de comandă. Fiecare pereche -T + URL
specifică ce să încarce și unde. curl acceptă, de asemenea, „globbing” a -T
argument, ceea ce înseamnă că puteți încărca mai multe fișiere la o singură adresă URL utilizând
același stil de plasare a adreselor URL acceptat în URL, astfel:

curl -T „{fișier1, fișier2}” http://www.uploadtothissite.com

sau chiar

curl -T "img[1-1000].png" loading="leneș" ftp://ftp.picturemania.com/upload/

--tcp-nodelay
Activați opțiunea TCP_NODELAY. Vezi curl_easy_setopt(3) pagina de manual pentru detalii
despre această opțiune. (Adăugat în 7.11.2)

--tftp-blksiize
(TFTP) Setați opțiunea TFTP BLKSIZE (trebuie să fie >512). Aceasta este dimensiunea blocului care se ondula
va încerca să utilizeze atunci când transferă date către sau de la un server TFTP. Implicit 512
vor fi utilizați octeți.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

(Adăugat în 7.20.0)

--tlsauthtype
Setați tipul de autentificare TLS. În prezent, singura opțiune acceptată este „SRP”, pt
TLS-SRP (RFC 5054). Dacă --tlsuser și --tlsparola sunt specificate dar --tlsauthtype
nu este, atunci această opțiune este implicită „SRP”. (Adăugat în 7.21.4)

--tlsparola
Setați parola pentru utilizare cu metoda de autentificare TLS specificată cu
--tlsauthtype. Necesită asta --tlsuser fi setat de asemenea. (Adăugat în 7.21.4)

--tlsuser
Setați numele de utilizator pentru a fi utilizat cu metoda de autentificare TLS specificată cu
--tlsauthtype. Necesită asta --tlsparola fi setat de asemenea. (Adăugat în 7.21.4)

--tlsv1.0
(SSL) Forțează curl să folosească TLS versiunea 1.0 atunci când negociază cu un server TLS la distanță.
(Adăugat în 7.34.0)

--tlsv1.1
(SSL) Forțează curl să folosească TLS versiunea 1.1 atunci când negociază cu un server TLS la distanță.
(Adăugat în 7.34.0)

--tlsv1.2
(SSL) Forțează curl să folosească TLS versiunea 1.2 atunci când negociază cu un server TLS la distanță.
(Adăugat în 7.34.0)

--tr-encoding
(HTTP) Solicitați un răspuns de transfer-codare comprimat folosind unul dintre algoritmi
curl suportă și decomprimați datele în timp ce le primiți.

(Adăugat în 7.21.6)

--urmă
Permite un dump complet de urmărire a tuturor datelor de intrare și de ieșire, inclusiv descriptive
informații, la fișierul de ieșire dat. Utilizați „-” ca nume de fișier pentru a trimite rezultatul
a stdout.

Această opțiune înlocuiește utilizările anterioare ale -v, --verbos or --trace-ascii.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--trace-ascii
Permite un dump complet de urmărire a tuturor datelor de intrare și de ieșire, inclusiv descriptive
informații, la fișierul de ieșire dat. Utilizați „-” ca nume de fișier pentru a trimite rezultatul
a stdout.

Acesta este foarte asemănător cu --urmă, dar omite partea hexagonală și arată doar
Partea ASCII a gunoiului. Oferă rezultate mai mici, pentru care ar putea fi mai ușor de citit
oameni neantrenați.

Această opțiune înlocuiește utilizările anterioare ale -v, --verbos or --urmă.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--urme-timp
Afișează un marcaj de timp la fiecare urmă sau linie verbosă care se afișează curl. (Adăugat în
7.14.0)

--unix-socket
(HTTP) Conectați-vă prin acest soclu de domeniu Unix, în loc să utilizați rețeaua.
(Adăugat în 7.40.0)

-u, --utilizator
Specificați numele de utilizator și parola de utilizat pentru autentificarea serverului. Anulează -n,
--netrc și --netrc-opțional.

Dacă pur și simplu specificați numele de utilizator, curl va solicita o parolă.

Numele de utilizator și parolele sunt împărțite pe primele două puncte, ceea ce îl face
imposibil de utilizat două puncte în numele de utilizator cu această opțiune. Parola poate,
încă.

Când utilizați Kerberos V5 cu un server bazat pe Windows, ar trebui să includeți Windows
nume de domeniu în numele de utilizator, pentru ca serverul să obțină cu succes a
Biletul Kerberos. Dacă nu o faceți, strângerea de mână de autentificare inițială poate eșua.

Când utilizați NTLM, numele de utilizator poate fi specificat simplu ca nume de utilizator, fără
domeniul, dacă există un singur domeniu și pădure în configurația dvs., de exemplu.

Pentru a specifica numele de domeniu, utilizați fie Nume de conectare la nivel inferior, fie UPN (Principal de utilizator
Nume) formate. De exemplu, EXEMPLU\utilizator și [e-mail protejat] respectiv.

Dacă utilizați un binar curl activat pentru Windows SSPI și efectuați Kerberos V5, negociați,
Autentificare NTLM sau Digest, atunci îi puteți spune lui curl să selecteze numele de utilizator și
parola din mediul dvs. specificând un singur două puncte cu această opțiune: „-u
:".

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-U, --proxy-user
Specificați numele de utilizator și parola de utilizat pentru autentificarea proxy.

Dacă utilizați un binar curl activat pentru Windows SSPI și faceți fie Negociere, fie NTLM
autentificare, apoi îi puteți spune lui curl să selecteze numele de utilizator și parola de la
mediul dumneavoastră prin specificarea unui singur două puncte cu această opțiune: „-U :”.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--url
Specificați o adresă URL de preluat. Această opțiune este mai ales utilă atunci când doriți să specificați adrese URL
într-un fișier de configurare.

Dacă adresa URL dată lipsește un nume de schemă (cum ar fi „http://” sau „ftp://” etc.), atunci
curl va face o ghicire pe baza gazdei. Dacă numele subdomeniului cel mai exterior se potrivește
DICT, FTP, IMAP, LDAP, POP3 sau SMTP, atunci acel protocol va fi utilizat, altfel HTTP
va fi folosit. Deoarece 7.45.0 ghicitul poate fi dezactivat prin setarea unui protocol implicit,
vedea --proto-implicit pentru detalii.

Această opțiune poate fi folosită de orice număr. Pentru a controla unde este scrisă această adresă URL,
utilizați -o, --ieșire sau -O, --nume-la distanță opțiuni.

-v, --verbos
Fii mai verbos/vorbăreț în timpul operației. Util pentru depanare și vizualizare
ce se întâmplă „sub capotă”. O linie care începe cu „>” înseamnă „datele antetului” trimise
prin curl, „<” înseamnă „date antet” primite de curl care este ascuns în cazuri normale,
iar o linie care începe cu „*” înseamnă informații suplimentare furnizate de curl.

Rețineți că, dacă doriți doar antete HTTP în ieșire, -eu, --include ar putea fi
opțiunea pe care o cauți.

Dacă credeți că această opțiune încă nu vă oferă suficiente detalii, luați în considerare utilizarea
--urmă or --trace-ascii in schimb.

Această opțiune înlocuiește utilizările anterioare ale --trace-ascii or --urmă.

Utilizare -da, --tăcut pentru a face curl liniştit.

-w, --scrieți
Faceți informații de afișare curl pe stdout după un transfer finalizat. Formatul este a
șir care poate conține text simplu amestecat cu orice număr de variabile. Formatul
poate fi specificat ca un „șir” literal sau puteți cere curl să citească formatul din a
fișier cu „@filename” și să-i spuneți lui curl să citească formatul din stdin pe care îl scrieți
„@-”.

Variabilele prezente în formatul de ieșire vor fi înlocuite cu valoarea sau textul
acea buclă crede potrivită, așa cum este descris mai jos. Toate variabilele sunt specificate ca
%{variable_name} și pentru a scoate un % normal, trebuie doar să le scrieți ca %%. Puteți ieși
o nouă linie folosind \n, o întoarcere la căruță cu \r și un spațiu de tabulație cu \t.

NOTĂ: Simbolul % este un simbol special în mediul win32, unde toate
aparițiile de % trebuie dublate atunci când utilizați această opțiune.

Variabilele disponibile sunt:

tipul de conținut Tipul de conținut al documentului solicitat, dacă a existat.

filename_effective
Numele de fișier final în care curl scrie. Aceasta este numai
semnificativ dacă lui curl i se spune să scrie într-un fișier cu --nume-la distanță
or --ieșire opțiune. Este cel mai util în combinație cu
--remote-header-name opțiune. (Adăugat în 7.25.1)

ftp_entry_path Curl-ul inițial al căii a ajuns în momentul conectării la FTP-ul de la distanță
Server. (Adăugat în 7.15.4)

http_code Codul de răspuns numeric care a fost găsit în ultimul preluat
Transfer HTTP(S) sau FTP(e). În 7.18.2 aliasul cod_răspuns a fost
adăugat pentru a afișa aceleași informații.

http_connect Codul numeric care a fost găsit în ultimul răspuns (de la a
proxy) la o cerere curl CONNECT. (Adăugat în 7.12.4)

local_ip Adresa IP a capătului local al celei mai recente conexiuni efectuate
- poate fi IPv4 sau IPv6 (Adăugat în 7.29.0)

port_local Numărul portului local al celei mai recente conexiuni efectuate (Adăugat în
7.29.0)

num_connects Numărul de conexiuni noi efectuate în transferul recent. (Adăugat în
7.12.3)

num_redirects Numărul de redirecționări care au fost urmate în cerere. (Adăugat în
7.12.3)

redirect_url Când a fost făcută o solicitare HTTP fără -L pentru a urma redirecționările, aceasta
variabila va afișa adresa URL reală o redirecționare ar te duce la.
(Adăugat în 7.18.2)

remote_ip Adresa IP de la distanță a celei mai recente conexiuni efectuate - poate fi
fie IPv4, fie IPv6 (Adăugat în 7.29.0)

port_la distanță Numărul portului de la distanță al celei mai recente conexiuni (Adăugat
în 7.29.0)

dimensiune_descărcare Cantitatea totală de octeți care au fost descărcați.

size_header Cantitatea totală de octeți ai antetelor descărcate.

dimensiune_cerere Cantitatea totală de octeți care au fost trimiși în cererea HTTP.

size_upload Cantitatea totală de octeți care au fost încărcați.

speed_download Viteza medie de descărcare care curl a măsurat pentru a completa
Descarca. Octeți pe secundă.

speed_upload Viteza medie de încărcare care curl a măsurat pentru încărcarea completă.
Octeți pe secundă.

ssl_verify_result
Rezultatul verificării certificatului SSL peer care a fost
solicitat. 0 înseamnă că verificarea a avut succes. (Adăugat în
7.19.0)

time_appconnect
Timpul, în secunde, a durat de la început până la SSL/SSH/etc
conectarea/strângerea de mână la gazda la distanță a fost finalizată. (Adăugat în
7.19.0)

time_connect Timpul, în secunde, a durat de la început până la conectarea TCP
la gazda la distanță (sau proxy) a fost finalizată.

time_namelookup
Timpul, în secunde, a durat de la început până la denumire
rezolvarea a fost finalizată.

timp_pretransfer
Timpul, în secunde, a durat de la început până la transferul fișierului
era pe cale să înceapă. Aceasta include toate comenzile pre-transfer și
negocieri care sunt specifice protocolului (protocoalelor)
implicate.

redirecționare_timp Timpul, în secunde, necesar pentru toți pașii de redirecționare include numele
căutați, conectați, pretransferați și transferați înainte de finală
tranzacția a fost începută. time_redirect arată execuția completă
timp pentru mai multe redirecționări. (Adăugat în 7.12.3)

time_starttransfer
Timpul, în secunde, a durat de la început până la primul octet
tocmai era pe punctul de a fi transferat. Aceasta include time_pretransfer și
de asemenea, timpul necesar serverului pentru a calcula rezultatul.

total_timp Timpul total, în secunde, în care a durat operațiunea completă. Timpul
va fi afișat cu rezoluție în milisecunde.

url_effective Adresa URL care a fost preluată ultima dată. Acest lucru este cel mai semnificativ dacă ai făcut-o
i-a spus lui curl să urmeze locația: anteturi.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-x, --proxy <[protocol://][user:parolă@]proxyhost[:port]>
Utilizați proxy-ul specificat.

Șirul proxy poate fi specificat cu un prefix protocol:// pentru a specifica o alternativă
protocoale proxy. Utilizați socks4://, socks4a://, socks5:// sau socks5h:// pentru a solicita
versiunea specifică SOCKS care urmează să fie utilizată. Niciun protocol specificat, http:// și toate celelalte
vor fi tratate ca proxy HTTP. (Suportul pentru protocol a fost adăugat în curl 7.21.7)

Dacă numărul portului nu este specificat în șirul proxy, se presupune că este 1080.

Această opțiune înlocuiește variabilele de mediu existente care setează proxy-ul să fie utilizat. Dacă
Există o variabilă de mediu care setează un proxy, puteți seta proxy la „” pentru
depășește-l.

Toate operațiunile care sunt efectuate pe un proxy HTTP vor fi în mod transparent
convertit la HTTP. Înseamnă că anumite operațiuni specifice protocolului ar putea să nu fie
disponibil. Acesta nu este cazul dacă puteți tunel prin proxy, ca unul cu
il -p, --proxytunnel opțiune.

Utilizatorul și parola care ar putea fi furnizate în șirul proxy sunt URL decodificate de
răsuci. Acest lucru vă permite să treceți caractere speciale, cum ar fi @, folosind %40 sau pass
într-un colon cu %3a.

Gazda proxy poate fi specificată exact în același mod ca și mediul proxy
variabile, inclusiv prefixul de protocol (http://) și utilizatorul încorporat +
parola.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-X, --cerere
(HTTP) Specifică o metodă de solicitare personalizată de utilizat atunci când comunicați cu HTTP
Server. Metoda de solicitare specificată va fi utilizată în locul metodei altfel
utilizat (care este implicit GET). Citiți specificația HTTP 1.1 pentru detalii și
explicatii. Solicitările HTTP suplimentare comune includ PUT și DELETE, dar sunt legate
tehnologii precum WebDAV oferă PROPFIND, COPY, MOVE și multe altele.

În mod normal, nu aveți nevoie de această opțiune. Tot felul de solicitări GET, HEAD, POST și PUT
sunt mai degrabă invocate prin utilizarea opțiunilor dedicate liniei de comandă.

Această opțiune schimbă doar cuvântul real folosit în cererea HTTP, nu
modifică modul în care se comportă bucla. Deci, de exemplu, dacă doriți să faceți un HEAD adecvat
cerere, utilizarea -X HEAD nu va fi suficientă. Trebuie să utilizați -Eu, --cap opțiune.

Șirul de metodă pe care l-ați setat cu -X va fi folosit pentru toate solicitările, ceea ce dacă doriți
exemplu de utilizare -L, --Locație poate provoca efecte secundare neintenționate atunci când ondularea nu are loc
modificarea metodei de solicitare conform codurilor de răspuns HTTP 30x - și similare.

(FTP) Specifică o comandă FTP personalizată de utilizat în loc de LIST atunci când faceți liste de fișiere
cu FTP.

(POP3) Specifică o comandă POP3 personalizată de utilizat în loc de LIST sau RETR. (Adăugat în
7.26.0)

(IMAP) Specifică o comandă IMAP personalizată de utilizat în loc de LIST. (Adăugat în 7.30.0)

(SMTP) Specifică o comandă SMTP personalizată de utilizat în loc de HELP sau VRFY. (Adăugat în
7.34.0)

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

--xattr
Când salvați rezultatul într-un fișier, această opțiune îi spune curl să stocheze anumite metadate ale fișierului
în atributele de fișier extinse. În prezent, adresa URL este stocată în xdg.origin.url
și, pentru HTTP, tipul de conținut este stocat în atributul mime_type. Dacă
sistemul de fișiere nu acceptă atribute extinse, este emis un avertisment.

-y, --viteza-timp
Dacă o descărcare este mai lentă decât limita de viteză octeți pe secundă în timpul unei viteze
perioadă, descărcarea este anulată. Dacă se folosește speed-time, limita implicită de viteză
va fi 1 dacă nu este stabilit cu -Y.

Această opțiune controlează transferurile și, prin urmare, nu va afecta conexiunile lente etc. Dacă aceasta
este o preocupare pentru tine, încearcă --connect-timeout opțiune.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-Y, --limită-viteză
Dacă o descărcare este mai lentă decât această viteză dată (în octeți pe secundă) pentru viteza-timp
secunde se anulează. viteza-timp este setat cu -y și este 30 dacă nu este setat.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-z, --time-cond |
(HTTP/FTP) Solicitați un fișier care a fost modificat mai târziu decât ora dată și
data sau unul care a fost modificat înainte de acea oră. The poate fi
tot felul de șiruri de date sau dacă nu se potrivește cu cele interne, se ia ca
un nume de fișier și încearcă să obțină data modificării (mtime) de la in schimb. Vedea
il curl_getdate(3) pagini de manual pentru detalii despre expresia datei.

Începeți expresia de dată cu o liniuță (-) pentru a solicita un document care este
mai vechi decât data/ora dată, implicit este un document care este mai nou decât
data/ora specificate.

Dacă această opțiune este folosită de mai multe ori, va fi folosită ultima.

-h, --ajutor
Ajutor la utilizare. Aceasta listează toate opțiunile curente ale liniei de comandă cu o scurtă descriere.

-M, --manual
Manual. Afișează textul uriaș de ajutor.

-V, --versiune
Afișează informații despre curl și versiunea libcurl pe care o folosește.

Prima linie include versiunea completă a curl, libcurl și a altor terțe părți
biblioteci legate de executabilul.

A doua linie (începe cu „Protocoale:”) arată toate protocoalele pe care libcurl le raportează
a sustine.

A treia linie (începe cu „Features:”) arată caracteristicile specifice către care libcurl le raportează
oferi. Caracteristicile disponibile includ:

IPv6 Puteți utiliza IPv6 cu aceasta.

krb4 Krb4 pentru FTP este acceptat.

SSL Sunt acceptate versiunile SSL ale diferitelor protocoale, cum ar fi HTTPS, FTPS, POP3S
şi aşa mai departe.

libz Decomprimarea automată a fișierelor comprimate prin HTTP este acceptată.

NTLM Autentificarea NTLM este acceptată.

Debug Acest curl folosește un libcurl construit cu Debug. Acest lucru permite mai multă urmărire a erorilor
și depanare a memoriei etc. Numai pentru dezvoltatorii curl!

AsynchDNS
Această curl folosește rezolvări de nume asincrone. Rezolvarile de nume asincrone pot fi
realizat folosind fie c-ares, fie backend-urile cu threaded resolver.

SPNEGO Autentificarea SPNEGO este acceptată.

Largefile
Acest curl acceptă transferuri de fișiere mari, fișiere mai mari de 2 GB.

IDN Această buclă acceptă IDN - nume de domenii internaționale.

GSS-API
GSS-API este acceptat.

SSPI SSPI este acceptat.

TLS SRP
Autentificarea SRP (Secure Remote Password) este acceptată pentru TLS.

Suportul HTTP2 HTTP/2 a fost încorporat.

metalink
Această buclă acceptă Metalink (atât versiunea 3, cât și 4 (RFC 5854)), care
descrie oglinzi și hashuri. curl va folosi oglinzi pentru failover dacă există
sunt erori (cum ar fi fișierul sau serverul care nu este disponibil).

Utilizați curl online folosind serviciile onworks.net