curl - Online sa Cloud

PROGRAMA:

NAME

curl - maglipat ng URL

SINOPSIS

kulutan [mga pagpipilian] [URL...]

DESCRIPTION

kulutan ay isang tool upang maglipat ng data mula o papunta sa isang server, gamit ang isa sa mga sinusuportahang protocol
(DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP,
RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET at TFTP). Ang utos ay idinisenyo upang gumana
nang walang pakikipag-ugnayan ng gumagamit.

curl ay nag-aalok ng busload ng mga kapaki-pakinabang na trick tulad ng proxy support, user authentication, FTP
upload, HTTP post, SSL na koneksyon, cookies, file transfer resume, Metalink, at higit pa. Bilang
makikita mo sa ibaba, ang bilang ng mga tampok ay magpapaikot sa iyong ulo!

curl ay pinapagana ng libcurl para sa lahat ng feature na nauugnay sa paglilipat. Tingnan mo libcurl(3) para sa mga detalye.

URL

Ang syntax ng URL ay nakasalalay sa protocol. Makakahanap ka ng detalyadong paglalarawan sa RFC 3986.

Maaari mong tukuyin ang maramihang mga URL o bahagi ng mga URL sa pamamagitan ng pagsulat ng mga set ng bahagi sa loob ng mga brace tulad ng sa:

http://site.{isa, dalawa, tatlo}.com

o maaari kang makakuha ng mga pagkakasunud-sunod ng alphanumeric na serye sa pamamagitan ng paggamit ng [] tulad ng sa:

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

ftp://ftp.numericals.com/file[001-100].txt (na may mga nangungunang zero)

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

Hindi sinusuportahan ang mga nested sequence, ngunit maaari kang gumamit ng ilan sa tabi ng isa't isa:

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

Maaari mong tukuyin ang anumang dami ng mga URL sa command line. Sila ay kukunin sa a
sunud-sunod na paraan sa tinukoy na pagkakasunud-sunod.

Maaari kang tumukoy ng step counter para sa mga hanay upang makuha ang bawat Nth na numero o titik:

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

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

Kapag gumagamit ng [] o {} na mga sequence kapag na-invoke mula sa command line prompt, malamang na mayroon ka
upang ilagay ang buong URL sa loob ng double quote upang maiwasan ang shell na makagambala dito. Ito
napupunta din para sa iba pang mga character na itinuturing na espesyal, tulad ng halimbawa '&', '?' at '*'.

Ibigay ang IPv6 zone index sa URL na may nakatakas na percentage sign at ang interface
pangalan. Tulad sa

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

Kung tutukuyin mo ang URL na walang protocol:// prefix, susubukan ni curl na hulaan kung anong protocol
Baka gusto mo. Magde-default ito sa HTTP ngunit subukan ang iba pang mga protocol batay sa madalas na ginagamit
prefix ng host name. Halimbawa, para sa mga pangalan ng host na nagsisimula sa "ftp." ipapalagay ka ni curl
gustong magsalita ng FTP.

gagawin ng curl ang lahat ng makakaya upang gamitin ang ipinapasa mo dito bilang isang URL. Hindi nito sinusubukang patunayan ito
bilang isang syntactically tamang URL sa anumang paraan ngunit sa halip ay napaka liberal sa kung ano ito
tumatanggap.

curl ay susubukan na muling gumamit ng mga koneksyon para sa maraming paglilipat ng file, upang makakuha ng marami
Ang mga file mula sa parehong server ay hindi gagawa ng maramihang pagkonekta / pakikipagkamay. Nagpapabuti ito
bilis. Siyempre ito ay ginagawa lamang sa mga file na tinukoy sa isang linya ng command at hindi maaaring
gamitin sa pagitan ng magkahiwalay na curl invoke.

Pag-unlad METER

curl ay karaniwang nagpapakita ng isang progress meter sa panahon ng mga operasyon, na nagpapahiwatig ng dami ng
nailipat na data, bilis ng paglipat at tinantyang oras na natitira, atbp.

curl ay nagpapakita ng data na ito sa terminal bilang default, kaya kung hihingin mo ang curl na gawin ang isang
operasyon at malapit na itong magsulat ng data sa terminal, ito hindi pinapagana ang progress meter bilang
kung hindi, magugulo ang output ng paghahalo ng progress meter at data ng tugon.

Kung gusto mo ng progress meter para sa HTTP POST o PUT na mga kahilingan, kailangan mong i-redirect ang
tugon na output sa isang file, gamit ang shell redirect (>), -o [file] o katulad nito.

Hindi ito ang parehong kaso para sa pag-upload ng FTP dahil ang operasyong iyon ay hindi naglalabas ng anumang tugon
data sa terminal.

Kung mas gusto mo ang isang progress "bar" sa halip na ang regular na metro, -# ang iyong kaibigan.

Opsyon

Magsisimula ang mga opsyon sa isa o dalawang gitling. Marami sa mga opsyon ay nangangailangan ng karagdagang halaga sa susunod
sa kanila.

Ang maikling "single-dash" na anyo ng mga opsyon, -d halimbawa, ay maaaring gamitin nang may o walang a
espasyo sa pagitan nito at ng halaga nito, bagama't ang isang puwang ay isang inirerekomendang separator. Ang mahaba
Ang "double-dash" na form, --data halimbawa, ay nangangailangan ng puwang sa pagitan nito at ng halaga nito.

Ang mga pagpipilian sa maikling bersyon na hindi nangangailangan ng anumang karagdagang mga halaga ay maaaring gamitin kaagad sa susunod
sa isa't isa, tulad ng halimbawa maaari mong tukuyin ang lahat ng mga pagpipilian -O, -L at -v nang sabay-sabay bilang
-OLv.

Sa pangkalahatan, lahat ng mga opsyon sa boolean ay pinagana sa --opsyon at muli ay hindi pinagana sa
--hindi-opsyon. Ibig sabihin, ginagamit mo ang eksaktong parehong pangalan ng opsyon ngunit nilagyan ito ng prefix ng "no-".
Gayunpaman, sa listahang ito, kadalasan ay inililista at ipinapakita lang namin ang --option na bersyon ng mga ito. (Ito
konseptong may --walang mga opsyon na idinagdag sa 7.19.0. Dati karamihan sa mga opsyon ay naka-on/off
sa paulit-ulit na paggamit ng parehong opsyon sa command line.)

-#, --progress-bar
Gawin ang pag-usad ng curl display bilang isang simpleng progress bar sa halip na ang pamantayan, higit pa
impormasyon, metro.

-:, --susunod
Sinasabi sa curl na gumamit ng hiwalay na operasyon para sa sumusunod na URL at nauugnay
mga pagpipilian. Nagbibigay-daan ito sa iyong magpadala ng ilang kahilingan sa URL, bawat isa ay may sariling partikular
mga opsyon, halimbawa, tulad ng iba't ibang user name o custom na kahilingan para sa bawat isa.
(Idinagdag sa 7.36.0)

-0, --http1.0
(HTTP) Sinasabi sa curl na gumamit ng HTTP na bersyon 1.0 sa halip na gamitin ito sa loob
ginustong: HTTP 1.1.

--http1.1
(HTTP) Sinasabi sa curl na gumamit ng HTTP na bersyon 1.1. Ito ang panloob na default na bersyon.
(Idinagdag sa 7.33.0)

--http2
(HTTP) Sinasabi sa curl na mag-isyu ng mga kahilingan nito gamit ang HTTP 2. Kinakailangan nito na ang
ang pinagbabatayan na libcurl ay binuo upang suportahan ito. (Idinagdag sa 7.33.0)

--hindi-npn
Huwag paganahin ang extension ng NPN TLS. Ang NPN ay pinagana bilang default kung ang libcurl ay binuo gamit ang
isang SSL library na sumusuporta sa NPN. Ang NPN ay ginagamit ng isang libcurl na sumusuporta sa HTTP 2 to
makipag-ayos ng suporta sa HTTP 2 sa server sa mga sesyon ng https.

(Idinagdag sa 7.36.0)

--walang-alpn
Huwag paganahin ang extension ng ALPN TLS. Ang ALPN ay pinagana bilang default kung ang libcurl ay binuo
na may SSL library na sumusuporta sa ALPN. Ang ALPN ay ginagamit ng isang libcurl na sumusuporta
HTTP 2 upang makipag-ayos sa suporta ng HTTP 2 sa server sa panahon ng mga sesyon ng https.

(Idinagdag sa 7.36.0)

-1, --tlsv1
(SSL) Pinipilit ang curl na gamitin ang bersyon 1.x ng TLS kapag nakikipagnegosasyon sa isang remote na TLS server.
Maaari kang gumamit ng mga pagpipilian --tlsv1.0, --tlsv1.1, at --tlsv1.2 upang kontrolin ang bersyon ng TLS
mas tiyak (kung ang SSL backend na ginagamit ay sumusuporta sa ganoong antas ng kontrol).

-2, --sslv2
(SSL) Pinipilit ang curl na gamitin ang SSL bersyon 2 kapag nakikipag-usap sa isang malayuang SSL server.
Minsan ang curl ay binuo nang walang SSLv2 support. Ang SSLv2 ay malawak na itinuturing na hindi secure
(tingnan ang RFC 6176).

-3, --sslv3
(SSL) Pinipilit ang curl na gamitin ang SSL bersyon 3 kapag nakikipag-usap sa isang malayuang SSL server.
Minsan ang curl ay binuo nang walang SSLv3 support. Ang SSLv3 ay malawak na itinuturing na hindi secure
(tingnan ang RFC 7568).

-4, --ipv4
Sinasabi ng opsyong ito kay curl na lutasin ang mga pangalan sa mga IPv4 address lamang, at hindi halimbawa
subukan ang IPv6.

-6, --ipv6
Sinasabi ng opsyong ito kay curl na lutasin ang mga pangalan sa mga IPv6 address lamang, at hindi halimbawa
subukan ang IPv4.

-a, --dugtungan
(FTP/SFTP) Kapag ginamit sa isang pag-upload, ginagawa nitong idugtong ang curl sa target na file
sa halip na i-overwrite ito. Kung ang malayong file ay hindi umiiral, ito ay malilikha.
Tandaan na ang flag na ito ay hindi pinapansin ng ilang SFTP server (kabilang ang OpenSSH).

-A, --user-agent
(HTTP) Tukuyin ang string ng User-Agent na ipapadala sa HTTP server. Ang ilan ay hindi maganda ang ginawa
Nabigo ang mga CGI kung hindi nakatakda ang field na ito sa "Mozilla/4.0". Upang i-encode ang mga blangko sa string,
palibutan ang string ng mga solong quote mark. Maaari rin itong itakda sa -H,
--header option syempre.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--anyauth
(HTTP) Sinasabi sa curl na alamin ang mismong paraan ng pagpapatotoo, at gamitin ang karamihan
secure ang isa na inaangkin ng malayong site na sinusuportahan. Ginagawa ito sa pamamagitan ng unang paggawa ng isang kahilingan
at pagsuri sa mga response-header, kaya posibleng mag-udyok ng karagdagang network round-
paglalakbay. Ito ay ginagamit sa halip na magtakda ng isang partikular na paraan ng pagpapatunay, na ikaw
maaaring gawin sa --basic, --digest, --ntlm, at --makipag-ayos.

Tandaan na ang paggamit ng --anyauth ay hindi inirerekomenda kung mag-upload ka mula sa stdin, dahil ito
maaaring mangailangan ng data na ipadala nang dalawang beses at pagkatapos ay dapat na makapag-rewind ang kliyente. Kung
ang pangangailangan ay dapat lumitaw kapag nag-upload mula sa stdin, ang pag-upload ay mabibigo.

-b, --cookie
(HTTP) Ipasa ang data sa HTTP server bilang cookie. Ito ay dapat na ang data
dating natanggap mula sa server sa linyang "Set-Cookie:." Ang data ay dapat na nasa
ang format na "NAME1=VALUE1; NAME2=VALUE2".

Kung walang simbolong '=' ang ginamit sa linya, ituturing itong filename na gagamitin sa pagbabasa
dating nakaimbak na mga linya ng cookie mula sa, na dapat gamitin sa session na ito kung sila
tugma. Ang paggamit ng paraang ito ay nag-a-activate din sa cookie engine na gagawa ng curl
mag-record din ng mga papasok na cookies, na maaaring madaling gamitin kung pinagsama mo ito
sa -L, --lokasyon opsyon. Ang format ng file ng file kung saan magbabasa ng cookies
dapat ay simpleng HTTP header o ang Netscape/Mozilla cookie file format.

Ang file na tinukoy sa -b, --cookie ay ginagamit lamang bilang input. Walang magiging cookies
nakasulat sa file. Para mag-imbak ng cookies, gamitin ang -c, --JAR ng Cookie pagpipilian.

Mag-ingat kung ginagamit mo ang opsyong ito at maaaring mangyari ang maraming paglilipat. Kung
ginagamit mo ang NAME1=VALUE1; format, o sa isang file gamitin ang Set-Cookie na format at huwag
tumukoy ng isang domain, pagkatapos ay ipapadala ang cookie para sa anumang domain (kahit na matapos ang mga pag-redirect ay
sinundan) at hindi maaaring baguhin ng isang server-set cookie. Kung ang cookie engine ay
pinagana at ang isang server ay nagtatakda ng cookie na may parehong pangalan pagkatapos ay ipapadala ang dalawa sa a
paglipat sa hinaharap sa server na iyon, malamang na hindi kung ano ang iyong nilayon. Upang matugunan ang mga ito
mga isyu sa pagtatakda ng domain sa Set-Cookie (sa paggawa nito ay magsasama ng mga sub-domain) o gamitin ang
Format ng Netscape.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-B, --use-ascii
(FTP/LDAP) Paganahin ang paglipat ng ASCII. Para sa FTP, maaari din itong ipatupad sa pamamagitan ng paggamit ng isang
URL na nagtatapos sa ";type=A". Ang pagpipiliang ito ay nagiging sanhi ng data na ipinadala sa stdout na nasa text
mode para sa win32 system.

--basic
(HTTP) Sinasabi sa curl na gumamit ng HTTP Basic authentication sa remote host. Ito ay
ang default at ang pagpipiliang ito ay karaniwang walang kabuluhan, maliban kung gagamitin mo ito upang i-override ang a
dating itinakda na opsyon na nagtatakda ng ibang paraan ng pagpapatunay (tulad ng --ntlm,
--digest, O --makipag-ayos).

Ginagamit kasama ng -ikaw, --gumagamit at -x, --proxy.

Tingnan din --proxy-basic.

-c, --cookie-jar
(HTTP) Tukuyin kung aling file ang gusto mong i-curl upang isulat ang lahat ng cookies pagkatapos makumpleto
operasyon. Isinulat ni Curl ang lahat ng cookies na nabasa dati mula sa isang tinukoy na file pati na rin
lahat ng cookies na natanggap mula sa (mga) malayong server. Kung walang alam na cookies, walang data na malalaman
isulat. Isusulat ang file gamit ang Netscape cookie file format. kung ikaw
itakda ang pangalan ng file sa isang solong gitling, "-", ang cookies ay isusulat sa stdout.

I-activate ng pagpipiliang command line na ito ang cookie engine na gumagawa ng curl record at
gumamit ng cookies. Ang isa pang paraan upang maisaaktibo ito ay ang paggamit ng -b, --cookie pagpipilian.

Kung hindi magawa o maisulat ang cookie jar, hindi gagawin ang buong curl operation
mabigo o malinaw na mag-ulat ng error. Ang paggamit ng -v ay magkakaroon ng babala na ipinapakita, ngunit
iyon lang ang nakikitang feedback na makukuha mo tungkol sa posibleng nakamamatay na sitwasyong ito.

Mula noong 7.43.0 na cookies na na-import sa Set-Cookie na format na walang domain
ang pangalan ay hindi na-export ng opsyong ito.

Kung ang opsyong ito ay ginamit nang maraming beses, ang huling tinukoy na pangalan ng file ang gagamitin.

-C, --ituloy-sa
Magpatuloy/Ipagpatuloy ang isang nakaraang paglilipat ng file sa ibinigay na offset. Ang ibinigay na offset ay
ang eksaktong bilang ng mga byte na lalaktawan, na binibilang mula sa simula ng
source file bago ito mailipat sa destinasyon. Kung ginamit sa mga pag-upload, ang
Ang command ng FTP server na SIZE ay hindi gagamitin ng curl.

Gamitin ang "-C -" upang sabihin sa curl na awtomatikong malaman kung saan/paano ipagpatuloy ang paglipat.
Pagkatapos ay ginagamit nito ang ibinigay na output/input na mga file upang malaman iyon.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--ciphers
(SSL) Tinutukoy kung aling mga cipher ang gagamitin sa koneksyon. Ang listahan ng mga cipher ay dapat
tukuyin ang mga wastong cipher. Basahin ang mga detalye ng listahan ng SSL cipher sa URL na ito:
https://www.openssl.org/docs/apps/ciphers.html

Ang mga cipher ng NSS ay ginagawa nang iba kaysa sa OpenSSL at GnuTLS. Ang buong listahan ng NSS
Ang mga cipher ay nasa entry ng NSSCipherSuite sa URL na ito:
https://git.fedorahosted.org/cgit/mod_nss.git/plain/docs/mod_nss.html#Directives

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--naka-compress
(HTTP) Humiling ng naka-compress na tugon gamit ang isa sa mga algorithm na sinusuportahan ng curl, at
i-save ang hindi naka-compress na dokumento. Kung ginamit ang opsyong ito at magpapadala ang server ng isang
hindi sinusuportahang pag-encode, mag-uulat ng error ang curl.

--connect-timeout
Pinakamataas na oras sa mga segundo na pinapayagan mong tumagal ang koneksyon ni curl. Ito ay naglilimita lamang
ang bahagi ng koneksyon, kaya kung kumonekta ang curl sa loob ng ibinigay na panahon ito ay magpapatuloy
- kung hindi ito ay lalabas. Dahil ang bersyon 7.32.0, ang opsyong ito ay tumatanggap ng mga decimal value.

Tingnan din ang -m, --max-time pagpipilian.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--create-dirs
Kapag ginamit kasabay ng -o opsyon, ang curl ay lilikha ng kinakailangang lokal
hierarchy ng direktoryo kung kinakailangan. Ang pagpipiliang ito ay lumilikha ng mga dir na binanggit kasama ng -o
opsyon, wala nang iba. Kung ang -o Ang pangalan ng file ay hindi gumagamit ng dir o kung ang mga dir na binanggit nito
mayroon na, walang dir na gagawin.

Upang lumikha ng mga malayuang direktoryo kapag gumagamit ng FTP o SFTP, subukan --ftp-create-dirs.

--crlf I-convert ang LF sa CRLF sa pag-upload. Kapaki-pakinabang para sa MVS (OS/390).

(Idinagdag ang SMTP sa 7.40.0)

--crlfile
(HTTPS/FTPS) Magbigay ng file gamit ang PEM format na may Certificate Revocation List
na maaaring tukuyin ang mga peer certificate na ituturing na bawiin.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

(Idinagdag sa 7.19.7)

-d, --data
(HTTP) Ipinapadala ang tinukoy na data sa isang POST na kahilingan sa HTTP server, sa parehong
paraan na ginagawa ng isang browser kapag pinunan ng isang user ang isang HTML form at pinindot ang
pindutan ng isumite. Magiging sanhi ito ng curl na ipasa ang data sa server gamit ang
content-type na application/x-www-form-urlencoded. Ikumpara sa -F, --porma.

-d, --data ay pareho --data-ascii. --data-raw ay halos pareho ngunit hindi
magkaroon ng espesyal na interpretasyon ng karakter na @. Upang mag-post ng data na puro binary, ikaw
sa halip ay dapat gamitin ang --data-binary opsyon. Upang URL-encode ang halaga ng isang form
field na maaari mong gamitin --data-urlencode.

Kung ang alinman sa mga opsyong ito ay ginagamit nang higit sa isang beses sa parehong command line, ang data
ang mga pirasong tinukoy ay isasama sa isang naghihiwalay na &-simbolo. Kaya, gamit
Ang '-d name=daniel -d skill=lousy' ay bubuo ng post chunk na kamukha
'name=daniel&skill=lousy'.

Kung sisimulan mo ang data gamit ang titik @, ang natitira ay dapat na isang pangalan ng file upang mabasa ang
data mula sa, o - kung gusto mong basahin ng curl ang data mula sa stdin. Maaaring maramihang mga file
tukuyin din. Ang pag-post ng data mula sa isang file na pinangalanang 'foobar' ay gagawin sa
--data @foobar. Kapag sinabihan ang --data na magbasa mula sa isang file na tulad nito, babalik ang carriage
at ang mga bagong linya ay aalisin. Kung ayaw mong magkaroon ng karakter na @
espesyal na paggamit ng interpretasyon --data-raw sa halip.

-D, --dump-header
Isulat ang mga header ng protocol sa tinukoy na file.

Madaling gamitin ang opsyong ito kapag gusto mong iimbak ang mga header na isang HTTP site
ipinapadala sa iyo. Ang mga cookies mula sa mga header ay maaaring basahin sa isang pangalawang kulot
panawagan sa pamamagitan ng paggamit ng -b, --cookie pagpipilian! Ang -c, --JAR ng Cookie ang pagpipilian ay a
mas mahusay na paraan upang mag-imbak ng cookies.

Kapag ginamit sa FTP, ang mga linya ng tugon ng FTP server ay itinuturing na "mga header" at
kaya't naliligtas doon.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--data-ascii
Tingnan -d, --data.

--data-binary
(HTTP) Nagpo-post ito ng data nang eksakto tulad ng tinukoy nang walang anumang karagdagang pagproseso.

Kung sisimulan mo ang data gamit ang titik @, ang natitira ay dapat na isang filename. Ang data ay
nai-post sa katulad na paraan bilang --data-ascii ginagawa, maliban sa mga bagong linya at karwahe
ang mga pagbabalik ay pinapanatili at ang mga conversion ay hindi nagagawa.

Kung ginamit nang maraming beses ang opsyong ito, ang mga sumusunod sa una ay magdaragdag ng data
tulad ng inilarawan sa -d, --data.

--data-raw
(HTTP) Nag-post ito ng data na katulad ng --data ngunit walang espesyal na interpretasyon
ng karakter na @. Tingnan mo -d, --data. (Idinagdag sa 7.43.0)

--data-urlencode
(HTTP) Nag-post ito ng data, katulad ng iba pang --data na mga opsyon maliban doon
nagsasagawa ito ng URL-encoding. (Idinagdag sa 7.18.0)

Upang maging CGI-compliant, ang bahagi ay dapat magsimula sa a pangalan sinusundan ng isang
separator at isang detalye ng nilalaman. Ang bahagi ay maaaring ipasa sa curl gamit
isa sa mga sumusunod na syntax:

nilalaman
Gagawin nitong curl URL-encode ang nilalaman at ipapasa iyon. Ingat na lang
upang ang nilalaman ay hindi naglalaman ng anumang = o @ na mga simbolo, gaya ng mangyayari noon
gawin ang syntax na tumugma sa isa sa iba pang mga kaso sa ibaba!

= nilalaman
Gagawin nitong curl URL-encode ang nilalaman at ipapasa iyon. Ang nauna =
ang simbolo ay hindi kasama sa data.

pangalan=nilalaman
Gagawin nitong curl URL-encode ang bahagi ng nilalaman at ipapasa iyon. Tandaan na
ang bahagi ng pangalan ay inaasahang naka-encode na ng URL.

@filename
Gagawa ito ng curl load data mula sa ibinigay na file (kabilang ang anumang mga bagong linya),
I-encode ng URL ang data na iyon at ipasa ito sa POST.

pangalan@filename
Gagawa ito ng curl load data mula sa ibinigay na file (kabilang ang anumang mga bagong linya),
I-encode ng URL ang data na iyon at ipasa ito sa POST. Ang bahagi ng pangalan ay nakakakuha ng katumbas
sign na idinagdag, na nagreresulta sa name=urlencoded-file-content. Tandaan na ang pangalan
ay inaasahang naka-encode na ng URL.

--delegasyon LEVEL
Itakda ANTAS para sabihin sa server kung ano ang pinapayagang italaga pagdating sa user
mga kredensyal. Ginagamit sa GSS/kerberos.

none Huwag payagan ang anumang delegasyon.

Nagdedelegate ang patakaran kung at kung ang OK-AS-DELEGATE na flag ay nakatakda sa Kerberos
service ticket, na isang bagay ng realm policy.

palaging Walang kondisyong pinapayagan ang server na magtalaga.

--digest
(HTTP) Pinapagana ang HTTP Digest authentication. Ito ay isang authentication scheme na
pinipigilan ang password na maipadala sa pamamagitan ng wire sa malinaw na teksto. Gamitin ito sa
kumbinasyon sa normal -ikaw, --gumagamit opsyon upang itakda ang user name at password. Tingnan mo
Rin --ntlm, --makipag-ayos at --anyauth para sa mga kaugnay na opsyon.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang una lamang ang gagamitin.

--disable-eprt
(FTP) Sabihin sa curl na huwag paganahin ang paggamit ng EPRT at LPRT command kapag gumagawa ng aktibo
Mga paglilipat ng FTP. Karaniwang laging susubukan ng Curl na gamitin ang EPRT, pagkatapos ay ang LPRT
bago gamitin ang PORT, ngunit sa pagpipiliang ito, gagamit agad ito ng PORT. EPRT at LPRT
ay mga extension sa orihinal na FTP protocol, at maaaring hindi gumana sa lahat ng mga server, ngunit
pinapagana nila ang higit pang paggana sa mas mahusay na paraan kaysa sa tradisyonal na utos ng PORT.

--eprt ay maaaring gamitin upang tahasang paganahin muli ang EPRT at --no-eprt ay isang alyas para sa
--disable-eprt.

Ang hindi pagpapagana ng EPRT ay nagbabago lamang sa aktibong gawi. Kung gusto mong lumipat sa passive
mode na hindi mo kailangang gamitin -P, --ftp-port o pilitin ito --ftp-pasv.

--disable-epsv
(FTP) Sabihin sa curl na huwag paganahin ang paggamit ng EPSV command kapag gumagawa ng passive FTP
mga paglilipat. Karaniwang laging susubukan ng Curl na gamitin ang EPSV bago ang PASV, ngunit
sa opsyong ito, hindi nito susubukang gamitin ang EPSV.

--epsv ay maaaring gamitin upang tahasang paganahin muli ang EPSV at --no-epsv ay isang alyas para sa
--disable-epsv.

Ang hindi pagpapagana ng EPSV ay nagbabago lamang sa passive na gawi. Kung gusto mong lumipat sa active
mode na kailangan mong gamitin -P, --ftp-port.

--dns-interface
Sabihin sa curl na magpadala ng mga papalabas na kahilingan sa DNS . Ang pagpipiliang ito ay a
katapat sa --interface (na hindi nakakaapekto sa DNS). Ang ibinigay na string ay dapat na
isang pangalan ng interface (hindi isang address).

Ang pagpipiliang ito ay nangangailangan na ang libcurl ay binuo gamit ang isang solver backend na sumusuporta
ang operasyong ito. Ang c-ares backend ay ang tanging ganoon. (Idinagdag sa 7.33.0)

--dns-ipv4-addr
Sabihin kay curl na itali kapag gumagawa ng mga kahilingan sa IPv4 DNS, upang ang DNS
ang mga kahilingan ay nagmula sa address na ito. Ang argument ay dapat na isang solong IPv4 address.

Ang pagpipiliang ito ay nangangailangan na ang libcurl ay binuo gamit ang isang solver backend na sumusuporta
ang operasyong ito. Ang c-ares backend ay ang tanging ganoon. (Idinagdag sa 7.33.0)

--dns-ipv6-addr
Sabihin kay curl na itali kapag gumagawa ng mga kahilingan sa IPv6 DNS, upang ang DNS
ang mga kahilingan ay nagmula sa address na ito. Ang argument ay dapat na isang solong IPv6 address.

Ang pagpipiliang ito ay nangangailangan na ang libcurl ay binuo gamit ang isang solver backend na sumusuporta
ang operasyong ito. Ang c-ares backend ay ang tanging ganoon. (Idinagdag sa 7.33.0)

--dns-servers
Itakda ang listahan ng mga DNS server na gagamitin sa halip na ang default ng system. Ang listahan ng
Ang mga IP address ay dapat na pinaghihiwalay ng mga kuwit. Ang mga numero ng port ay maaari ding maging opsyonal
ibinigay bilang : pagkatapos ng bawat IP address.

Ang pagpipiliang ito ay nangangailangan na ang libcurl ay binuo gamit ang isang solver backend na sumusuporta
ang operasyong ito. Ang c-ares backend ay ang tanging ganoon. (Idinagdag sa 7.33.0)

-e, --referer
(HTTP) Ipinapadala ang impormasyon ng "Referrer Page" sa HTTP server. Pwede rin ito
itinakda kasama ang -H, --header flag syempre. Kapag ginamit sa -L, --lokasyon maaari mong
idagdag ang ";auto" sa --referer URL upang awtomatikong itakda ang curl sa nakaraang URL
kapag sumusunod ito sa isang Lokasyon: header. Ang ";auto" string ay maaaring gamitin nang mag-isa, kahit na
hindi ka nagtakda ng inisyal --referer.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-E, --cert
(SSL) Sinasabi sa curl na gamitin ang tinukoy na file ng certificate ng kliyente kapag kumukuha ng file
gamit ang HTTPS, FTPS o isa pang protocol na nakabatay sa SSL. Ang sertipiko ay dapat nasa PKCS#12
format kung gumagamit ng Secure Transport, o PEM format kung gumagamit ng anumang iba pang makina. Kung ang
hindi tinukoy ang opsyonal na password, itatanong ito sa terminal. Tandaan
na ang opsyong ito ay nagpapalagay ng isang "certificate" na file na pribadong key at ang
pinagsama-samang sertipiko ng kliyente! Tingnan mo --cert at --susi upang tukuyin ang mga ito
malaya

Kung ang curl ay binuo laban sa library ng NSS SSL kung gayon ang pagpipiliang ito ay maaaring sabihin sa curl ang
palayaw ng sertipiko na gagamitin sa loob ng database ng NSS na tinukoy ng
environment variable SSL_DIR (o bilang default /etc/pki/nssdb). Kung ang NSS PEM PKCS#11
Available ang module (libnsspem.so) pagkatapos ay maaaring ma-load ang mga PEM file. Kung gusto mong gamitin
isang file mula sa kasalukuyang direktoryo, mangyaring unahan ito ng "./" prefix, upang
maiwasan ang pagkalito sa isang palayaw. Kung ang palayaw ay naglalaman ng ":", kailangan ito
na nauuna sa "\" upang hindi ito makilala bilang password delimiter. Kung ang
Ang palayaw ay naglalaman ng "\", kailangan itong i-escape bilang "\\" upang hindi ito makilala
bilang isang karakter sa pagtakas.

(iOS at Mac OS X lang) Kung ang curl ay binuo laban sa Secure Transport, ang
certificate string ay maaaring maging pangalan ng isang certificate/pribadong key sa
system o user keychain, o ang path sa isang PKCS#12-encoded certificate at pribado
susi. Kung gusto mong gumamit ng file mula sa kasalukuyang direktoryo, mangyaring unahan ito ng
"./" prefix, upang maiwasan ang pagkalito sa isang palayaw.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--makina
Piliin ang OpenSSL crypto engine na gagamitin para sa mga operasyon ng cipher. Gamitin --makina listahan sa
mag-print ng listahan ng mga engine na sinusuportahan ng build-time. Tandaan na hindi lahat (o wala) sa
maaaring available ang mga makina sa oras ng pagtakbo.

--kapaligiran
(RISC OS LAMANG) Nagtatakda ng hanay ng mga variable ng kapaligiran, gamit ang mga pangalan na -w opsyon
suporta, upang payagan ang mas madaling pagkuha ng kapaki-pakinabang na impormasyon pagkatapos na tumakbo curl.

--egd-file
(SSL) Tukuyin ang pangalan ng path sa Entropy Gathering Daemon socket. Ang socket ay
ginamit upang i-seed ang random na makina para sa mga koneksyon sa SSL. Tingnan din ang --random-file
pagpipilian.

--asahan ang 100-timeout
(HTTP) Maximum na oras sa mga segundo na pinapayagan mong maghintay ang curl para sa isang 100-continue
tugon kapag naglalabas ang curl ng Expects: 100-continue header sa kahilingan nito. Bilang default
maghihintay ng isang segundo ang curl. Tumatanggap ang opsyong ito ng mga decimal na halaga! Kapag huminto ang curl
naghihintay, magpapatuloy na parang natanggap na ang tugon.

(Idinagdag sa 7.47.0)

--cert-type
(SSL) Sinasabi sa curl kung anong uri ng certificate ang ibinigay na certificate. PEM, DER at
Ang ENG ay kinikilalang mga uri. Kung hindi tinukoy, ipinapalagay ang PEM.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--cacert
(SSL) Sinasabi sa curl na gamitin ang tinukoy na file ng certificate upang i-verify ang peer. Ang file
maaaring maglaman ng maraming CA certificate. Ang (mga) certificate ay dapat nasa PEM format.
Karaniwan ang curl ay binuo upang gumamit ng isang default na file para dito, kaya ang pagpipiliang ito ay karaniwang
ginamit upang baguhin ang default na file na iyon.

kinikilala ng curl ang variable ng kapaligiran na pinangalanang 'CURL_CA_BUNDLE' kung ito ay nakatakda, at
ay gumagamit ng ibinigay na landas bilang isang landas sa isang CA cert bundle. Ino-override iyon ng opsyong ito
variable

Ang bersyon ng windows ng curl ay awtomatikong maghahanap ng isang CA certs file na pinangalanan
´curl-ca-bundle.crt´, alinman sa parehong direktoryo ng curl.exe, o sa Kasalukuyang
Working Directory, o sa anumang folder sa iyong PATH.

Kung ang curl ay binuo laban sa NSS SSL library, ang NSS PEM PKCS#11 module
(libnsspem.so) ay kailangang maging available para gumana nang maayos ang opsyong ito.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--capath
(SSL) Sinasabi sa curl na gamitin ang tinukoy na direktoryo ng certificate upang i-verify ang peer.
Maaaring magbigay ng maramihang mga landas sa pamamagitan ng paghihiwalay sa kanila ng ":" (hal
"path1:path2:path3"). Ang mga certificate ay dapat nasa PEM format, at kung curl ay binuo
laban sa OpenSSL, dapat na naproseso ang direktoryo gamit ang c_rehash utility
ibinibigay sa OpenSSL. Gamit --capath maaaring payagan ang OpenSSL-powered curl na gumawa ng SSL-
mga koneksyon na mas mahusay kaysa sa paggamit --cacert kung ang --cacert naglalaman ng file
maraming CA certificate.

Kung nakatakda ang opsyong ito, babalewalain ang default na halaga ng capath, at kung gagamitin ito
ilang beses, ang huli ay gagamitin.

--pinnedpubkey
(SSL) Sinasabi sa curl na gamitin ang tinukoy na pampublikong key file (o mga hash) upang i-verify ang
kapantay. Ito ay maaaring isang path patungo sa isang file na naglalaman ng isang pampublikong key sa PEM o DER
format, o anumang bilang ng base64 na naka-encode na sha256 hash na sinusundan ng ´sha256//´ at
pinaghihiwalay ng ´;´

Kapag nakikipag-usap sa isang TLS o SSL na koneksyon, ang server ay nagpapadala ng isang sertipiko na nagpapahiwatig
pagkakakilanlan nito. Ang isang pampublikong susi ay kinukuha mula sa certificate na ito at kung hindi
eksaktong tumutugma sa pampublikong susi na ibinigay sa opsyong ito, i-abort ng curl ang
koneksyon bago magpadala o tumanggap ng anumang data.

Idinagdag sa 7.39.0 para sa OpenSSL, GnuTLS at GSKit. Idinagdag sa 7.43.0 para sa NSS at
wolfSSL/CyaSSL. Ang suporta ng sha256 ay idinagdag sa 7.44.0 para sa OpenSSL, GnuTLS, NSS at
wolfSSL/CyaSSL. Hindi suportado ang iba pang mga SSL backend.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--cert-status
(SSL) Sinasabi sa curl na i-verify ang status ng certificate ng server sa pamamagitan ng paggamit ng
Kahilingan sa Katayuan ng Certificate (aka. OCSP stapling) TLS extension.

Kung pinagana ang opsyong ito at nagpapadala ang server ng di-wastong (hal. nag-expire) na tugon,
kung ang tugon ay nagmumungkahi na ang sertipiko ng server ay binawi, o hindi
natanggap ang tugon, nabigo ang pag-verify.

Ito ay kasalukuyang ipinapatupad lamang sa OpenSSL, GnuTLS at NSS backend. (Idinagdag
sa 7.41.0)

--false-start

(SSL) Sinasabi sa curl na gumamit ng maling simula sa panahon ng TLS handshake. Ang maling pagsisimula ay isang mode
kung saan ang isang TLS client ay magsisimulang magpadala ng data ng aplikasyon bago i-verify ang
Tapos na ang mensahe ng server, kaya nagse-save ng round trip kapag gumaganap nang buo
pakikipagkamay.

Ito ay kasalukuyang ipinapatupad lamang sa NSS at Secure Transport (sa iOS 7.0 o
mamaya, o OS X 10.9 o mas bago) backend. (Idinagdag sa 7.42.0)

-f, --mabigo
(HTTP) Tahimik na nabigo (walang output) sa mga error sa server. Ito ay kadalasang ginagawa sa
mas mahusay na paganahin ang mga script atbp upang mas mahusay na makitungo sa mga nabigong pagtatangka. Sa mga normal na kaso kapag
nabigo ang isang HTTP server na maghatid ng dokumento, ibinabalik nito ang isang HTML na dokumento na nagsasabi nito
(na kadalasang naglalarawan din kung bakit at higit pa). Pipigilan ng watawat na ito ang pagkulot
outputing iyon at ibalik ang error 22.

Ang pamamaraang ito ay hindi mabibigo at may mga pagkakataon kung saan hindi matagumpay ang pagtugon
makakalusot ang mga code, lalo na kapag kasama ang pagpapatunay (mga response code
401 at 407).

-F, --form
(HTTP) Nagbibigay-daan ito sa curl na tularan ang isang fill-in na form kung saan pinindot ng isang user ang
pindutan ng isumite. Nagdudulot ito ng curl sa POST data gamit ang Content-Type multipart/form-
data ayon sa RFC 2388. Ito ay nagbibigay-daan sa pag-upload ng mga binary file atbp. Upang pilitin
ang bahaging 'nilalaman' upang maging isang file, lagyan ng prefix ang pangalan ng file na may @ sign. Para makuha lang
ang bahagi ng nilalaman mula sa isang file, prefix ang pangalan ng file na may simbolo na <. Ang
Ang pagkakaiba sa pagitan ng @ at < ay ang @ ay gumagawa ng isang file na nakakabit sa post bilang
isang pag-upload ng file, habang ang < ay gumagawa ng isang text field at kunin lamang ang mga nilalaman para doon
field ng text mula sa isang file.

Halimbawa, upang ipadala ang iyong password file sa server, kung saan 'password' ang pangalan ng
ang form-field kung saan / etc / passwd ang magiging input:

kulutan -F password=@/ etc / passwd www.mypasswords.com

Upang basahin ang nilalaman mula sa stdin sa halip na isang file, gamitin ang - bilang ang filename. Ito ay para sa
parehong @ at < construct. Sa kasamaang palad hindi nito sinusuportahan ang pagbabasa ng file mula sa a
pinangalanang pipe o katulad, dahil kailangan nito ang buong sukat bago magsimula ang paglipat.

Maaari mo ring sabihin sa curl kung anong Content-Type ang gagamitin sa pamamagitan ng paggamit ng 'type=', sa isang paraan
kapareho ng:

kulutan -F"[protektado ng email];type=text/html" url.com

or

kulutan -F "name=daniel;type=text/foo" url.com

Maaari mo ring tahasang baguhin ang field ng pangalan ng bahagi ng pag-upload ng file sa pamamagitan ng pagtatakda
filename=, tulad nito:

kulutan -F "file=@localfile;filename=nameinpost" url.com

Kung ang filename/path ay naglalaman ng ',' o ';', dapat itong ma-quote ng double-quotes tulad ng:

kulutan -F "file=@\"localfile\";filename=\"nameinpost\"" url.com

or

kulutan -F 'file=@"localfile";filename="nameinpost"' url.com

Tandaan na kung ang isang filename/path ay sinipi ng double-quote, anumang double-quote o
Ang backslash sa loob ng filename ay dapat na i-escape sa pamamagitan ng backslash.

Tingnan ang mga karagdagang halimbawa at detalye sa MANUAL.

Maaaring gamitin ang opsyong ito nang maraming beses.

--ftp-account [data]
(FTP) Kapag ang isang FTP server ay humingi ng "data ng account" pagkatapos ng user name at password
naibigay, ang data na ito ay ipinadala gamit ang ACCT command. (Idinagdag sa 7.13.0)

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--ftp-alternative-to-user
(FTP) Kung nabigo ang pagpapatotoo gamit ang USER at PASS command, ipadala ang command na ito.
Kapag kumokonekta sa server ng Secure Transport ng Tumbleweed sa FTPS gamit ang isang kliyente
certificate, gamit ang "SITE AUTH" ay magsasabi sa server na kunin ang username mula sa
ang sertipiko. (Idinagdag sa 7.15.5)

--ftp-create-dirs
(FTP/SFTP) Kapag ang isang FTP o SFTP URL/operasyon ay gumagamit ng isang path na hindi sa kasalukuyan
umiiral sa server, ang karaniwang pag-uugali ng curl ay mabibigo. Gamit ang opsyong ito,
curl ay sa halip ay susubukan na lumikha ng mga nawawalang direktoryo.

--ftp-method [paraan]
(FTP) Kontrolin kung anong paraan ang dapat gamitin ng curl upang maabot ang isang file sa isang FTP(S) server. Ang
method argument ay dapat isa sa mga sumusunod na alternatibo:

multicwd
curl ay gumagawa ng isang operasyon ng CWD para sa bawat bahagi ng path sa ibinigay na URL. Para sa
malalim na hierarchies nangangahulugan ito ng napakaraming utos. Ganito sinasabi ng RFC 1738
dapat gawin. Ito ang default ngunit ang pinakamabagal na pag-uugali.

walang CWD ang nocwd curl. curl ay gagawa ng SIZE, RETR, STOR atbp at magbibigay ng buo
path sa server para sa lahat ng mga utos na ito. Ito ang pinakamabilis na pag-uugali.

singlecwd
curl ang isang CWD na may buong target na direktoryo at pagkatapos ay gumagana sa
file "normal" (tulad ng sa multicwd case). Ito ay medyo higit pang mga pamantayan
sumusunod kaysa 'nocwd' ngunit walang buong parusa ng 'multicwd'.

(Idinagdag sa 7.15.1)

--ftp-pasv
(FTP) Gumamit ng passive mode para sa koneksyon ng data. Ang passive ay ang panloob na default
pag-uugali, ngunit ang paggamit ng opsyong ito ay maaaring gamitin upang i-override ang isang nakaraan -P/-ftp-port
opsyon. (Idinagdag sa 7.11.0)

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang una lamang ang gagamitin. Pag-undo ng isang
Ang ipinatupad na passive ay talagang hindi maaaring gawin ngunit kailangan mong ipatupad ang tama
-P, --ftp-port muli.

Ang ibig sabihin ng passive mode ay susubukan muna ng curl ang EPSV command at pagkatapos ay PASV, maliban kung
--disable-epsv Ginagamit.

--ftp-skip-pasv-ip
(FTP) Sabihin kay curl na huwag gamitin ang IP address na iminumungkahi ng server sa pagtugon nito
PASV command ng curl kapag ikinonekta ng curl ang koneksyon ng data. Sa halip ang curl ay muling-
gamitin ang parehong IP address na ginagamit na nito para sa kontrol na koneksyon. (Idinagdag sa
7.14.2)

Walang epekto ang opsyong ito kung PORT, EPRT o EPSV ang gagamitin sa halip na PASV.

--ftp-pret
(FTP) Sabihin kay curl na magpadala ng PRET command bago ang PASV (at EPSV). Ilang FTP server,
higit sa lahat drftpd, nangangailangan ng hindi karaniwang utos na ito para sa mga listahan ng direktoryo pati na rin
pataas at magda-download sa PASV mode. (Idinagdag sa 7.20.x)

--ftp-ssl-ccc
(FTP) Gumamit ng CCC (Clear Command Channel) I-shut down ang SSL/TLS layer pagkatapos
nagpapatotoo. Ang natitirang bahagi ng control channel na komunikasyon ay hindi mai-encrypt.
Ito ay nagpapahintulot sa NAT routers na sundin ang FTP transaksyon. Ang default na mode ay passive.
Tingnan --ftp-ssl-ccc-mode para sa iba pang mga mode. (Idinagdag sa 7.16.1)

--ftp-ssl-ccc-mode [aktibo/passive]
(FTP) Gamitin ang CCC (Clear Command Channel) Itinatakda ang CCC mode. Ang passive mode ay hindi
simulan ang shutdown, ngunit sa halip ay hintayin ang server na gawin ito, at hindi sasagot
sa pagsara mula sa server. Sinisimulan ng active mode ang shutdown at naghihintay
para sa tugon mula sa server. (Idinagdag sa 7.16.2)

--ftp-ssl-control
(FTP) Nangangailangan ng SSL/TLS para sa FTP login, malinaw para sa paglipat. Pinapayagan ang secure
pagpapatunay, ngunit hindi naka-encrypt na paglilipat ng data para sa kahusayan. Nabigo ang
ilipat kung hindi sinusuportahan ng server ang SSL/TLS. (Idinagdag sa 7.16.0) na maaari pa rin
gagamitin ngunit aalisin sa hinaharap na bersyon.

--form-string
(HTTP) Katulad ng --porma maliban na ang value string para sa pinangalanang parameter ay
ginamit nang literal. Nangunguna sa '@' at '<' na mga character, at ang ';type=' na string sa
walang espesyal na kahulugan ang halaga. Gamitin ito bilang kagustuhan sa --porma kung meron man
posibilidad na ang halaga ng string ay maaaring aksidenteng ma-trigger ang mga tampok na '@' o '<'
of --porma.

-g, --globoff
Ino-off ng opsyong ito ang "URL globbing parser". Kapag itinakda mo ang opsyong ito, ikaw
maaaring tumukoy ng mga URL na naglalaman ng mga letrang {}[] nang hindi nagkakaroon ng mga ito
binibigyang kahulugan ng curl mismo. Tandaan na ang mga titik na ito ay hindi normal na legal na URL
mga nilalaman ngunit dapat silang i-encode ayon sa pamantayan ng URI.

-G, --kunin mo
Kapag ginamit, gagawin ng pagpipiliang ito ang lahat ng data na tinukoy sa -d, --data, --data-binary
or --data-urlencode na gagamitin sa isang HTTP GET request sa halip na sa POST request
na kung hindi man ay gagamitin. Ang data ay idaragdag sa URL na may '?'
naghihiwalay

Kung ginamit kasabay ng -I, ang data ng POST ay sa halip ay idaragdag sa URL
na may kahilingan sa HEAD.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang una lamang ang gagamitin. Ito ay dahil ang
Ang pag-undo sa isang GET ay walang katuturan, ngunit sa halip ay dapat mong ipatupad ang
alternatibong paraan na gusto mo.

-H, --header
(HTTP) Dagdag na header na isasama sa kahilingan kapag nagpapadala ng HTTP sa isang server. Ikaw
maaaring tumukoy ng anumang bilang ng mga karagdagang header. Tandaan na kung dapat kang magdagdag ng custom
header na may parehong pangalan bilang isa sa mga panloob na gagamitin ng curl, iyong
externally set header ang gagamitin sa halip na ang panloob. Ito ay nagpapahintulot sa iyo na
gumawa ng mas mapanlinlang na bagay kaysa sa karaniwang ginagawa ng curl. Hindi mo dapat palitan
panloob na itinakda ang mga header nang hindi lubos na nalalaman kung ano ang iyong ginagawa. Alisin ang isang
panloob na header sa pamamagitan ng pagbibigay ng kapalit na walang nilalaman sa kanang bahagi ng
colon, tulad ng sa: -H "Host:". Kung ipinadala mo ang pasadyang header na walang halaga kung gayon ito
dapat wakasan ang header na may semicolon, gaya ng -H "X-Custom-Header;" Ipadala
"X-Custom-Header:".

sisiguraduhin ng curl na ang bawat header na idaragdag/papalitan mo ay ipapadala nang may wastong dulo-
of-line marker, dapat ganito hindi idagdag iyon bilang bahagi ng nilalaman ng header: gawin
huwag magdagdag ng mga bagong linya o pagbabalik ng karwahe, magugulo lamang ang mga ito para sa iyo.

Tingnan din ang -A, --user-agent at -e, --referer mga pagpipilian.

Simula sa 7.37.0, kailangan mo --proxy-header upang magpadala ng mga custom na header na nilayon para sa a
proxy

Halimbawa:

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

BABALA: itatakda ang mga header na may ganitong opsyon sa lahat ng kahilingan - kahit na pagkatapos
ang mga pag-redirect ay sinusunod, tulad ng kapag sinabi sa -L, --lokasyon. Ito ay maaaring humantong sa
header na ipinapadala sa iba pang mga host kaysa sa orihinal na host, kaya sensitibong mga header
dapat gamitin nang may pag-iingat kasama ng mga sumusunod na pag-redirect.

Maaaring gamitin ang opsyong ito nang maraming beses upang magdagdag/magpalit/mag-alis ng maramihang mga header.

--hostpubmd5
(SCP/SFTP) Magpasa ng string na naglalaman ng 32 hexadecimal digit. Ang string ay dapat na ang
128 bit MD5 checksum ng pampublikong susi ng remote host, curl ay tanggihan ang
koneksyon sa host maliban kung tumugma ang md5sums. (Idinagdag sa 7.17.1)

--ignore-content-length
Para sa HTTP, Huwag pansinin ang header na Haba ng Nilalaman. Ito ay partikular na kapaki-pakinabang para sa mga server
nagpapatakbo ng Apache 1.x, na mag-uulat ng maling Haba ng Nilalaman para sa mga file na mas malaki
kaysa sa 2 gigabytes.

Para sa FTP (mula noong 7.46.0), laktawan ang RETR command para malaman ang laki noon
nagda-download ng file.

-i, --isama
(HTTP) Isama ang HTTP-header sa output. Kasama sa HTTP-header ang mga bagay tulad ng
pangalan ng server, petsa ng dokumento, bersyon ng HTTP at higit pa...

-Ako ang namumuno
(HTTP/FTP/FILE) Kunin lang ang HTTP-header! Itinatampok ng mga HTTP-server ang command na HEAD
na ginagamit nito upang walang makuha kundi ang header ng isang dokumento. Kapag ginamit sa isang FTP o
FILE file, curl ay nagpapakita lamang ng laki ng file at huling oras ng pagbabago.

--interface
Magsagawa ng operasyon gamit ang isang tinukoy na interface. Maaari mong ipasok ang pangalan ng interface, IP
address o host name. Ang isang halimbawa ay maaaring magmukhang:

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

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-j, --junk-session-cookies
(HTTP) Kapag sinabihan si curl na magbasa ng cookies mula sa isang naibigay na file, gagawin ang pagpipiliang ito
itinatapon nito ang lahat ng "cookies ng session". Ito ay karaniwang magkakaroon ng parehong epekto bilang kung a
magsisimula na ang bagong session. Palaging itinatapon ng mga karaniwang browser ang session cookies kapag
sarado na sila.

-J, --remote-header-pangalan
(HTTP) Sinasabi ng opsyong ito ang -O, --remote-pangalan opsyong gamitin ang tinukoy ng server
Content-Disposition filename sa halip na mag-extract ng filename mula sa URL.

Walang pagtatangkang i-decode ang %-sequences (pa) sa ibinigay na pangalan ng file, kaya ito
ang opsyon ay maaaring magbigay sa iyo ng hindi inaasahang mga pangalan ng file.

-k, --hindi sigurado
(SSL) Ang opsyong ito ay tahasang nagpapahintulot sa curl na magsagawa ng "hindi secure" na mga koneksyon sa SSL at
mga paglilipat. Sinusubukang gawing secure ang lahat ng koneksyon sa SSL sa pamamagitan ng paggamit ng CA
naka-install na bundle ng sertipiko bilang default. Isinasaalang-alang nito ang lahat ng koneksyon
"hindi sigurado" ay nabigo maliban kung -k, --insecure Ginagamit.

Tingnan ang online na mapagkukunang ito para sa karagdagang detalye:
http://curl.haxx.se/docs/sslcerts.html

-K, --config
Tukuyin kung saang config file magbabasa ng mga argumento ng curl. Ang config file ay isang text
file kung saan maaaring isulat ang mga argumento ng command line na pagkatapos ay gagamitin na parang
sila ay nakasulat sa aktwal na command line.

Ang mga opsyon at ang kanilang mga parameter ay dapat na tinukoy sa parehong linya ng config file,
pinaghihiwalay ng whitespace, colon, o ang equals sign. Ang mga pangalan ng mahahabang opsyon ay maaari
opsyonal na ibigay sa config file nang walang paunang double dashes at kung gayon,
ang colon o katumbas na mga character ay maaaring gamitin bilang mga separator. Kung ang pagpipilian ay
tinukoy na may isa o dalawang gitling, maaaring walang tutuldok o katumbas na karakter sa pagitan
ang opsyon at ang parameter nito.

Kung ang parameter ay naglalaman ng whitespace, ang parameter ay dapat na nakapaloob sa loob
quotes. Sa loob ng double quotes, available ang mga sumusunod na escape sequence: \\, \",
\t, \n, \r at \v. Ang isang backslash na nauuna sa anumang iba pang titik ay binabalewala. Kung ang una
column ng isang config line ay isang '#' na character, ang natitirang linya ay ituturing bilang
komento. Sumulat lamang ng isang opsyon sa bawat pisikal na linya sa config file.

Tukuyin ang filename sa -K, --config bilang '-' para basahin ng curl ang file mula sa stdin.

Tandaan na upang matukoy ang isang URL sa config file, kailangan mong tukuyin ito
gamit ang --url opsyon, at hindi sa pamamagitan lamang ng pagsulat ng URL sa sarili nitong linya. Kaya, ito
maaaring magmukhang katulad nito:

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

Kapag na-invoke ang curl, palagi itong (maliban kung -q ay ginagamit) sumusuri para sa isang default na config
file at ginagamit ito kung natagpuan. Ang default na config file ay sinusuri sa sumusunod
mga lugar sa ganitong pagkakasunud-sunod:

1) sinusubukang hanapin ng curl ang "home dir": Sinusuri muna nito ang CURL_HOME at pagkatapos
ang HOME environment variables. Kung nabigo iyon, gumagamit ito ng getpwuid() sa katulad ng Unix
system (na nagbabalik ng home dir na ibinigay sa kasalukuyang user sa iyong system). Naka-on
Windows, sinusuri nito ang variable na APPDATA, o bilang huling paraan ang
'%USERPROFILE%\Application Data'.

2) Sa mga bintana, kung walang _curlrc file sa home dir, sinusuri nito ang isa sa
ang parehong dir ang curl executable ay inilagay. Sa mga system na tulad ng Unix, ito ay simple
subukang i-load ang .curlrc mula sa natukoy na home dir.

# --- Halimbawa ng file ---
# ito ay isang komento
url = "curl.haxx.se"
output = "curlhere.html"
user-agent = "superagent/1.0"

# at kumuha din ng isa pang URL
url = "curl.haxx.se/docs/manpage.html"
-O
referer = "http://nowhereatall.com/"
# --- Katapusan ng halimbawang file ---

Maaaring gamitin ang opsyong ito nang maraming beses para mag-load ng maraming config file.

--keepalive-time
Itinatakda ng opsyong ito ang oras na kailangang manatiling idle ang isang koneksyon bago ipadala
keepalive probes at ang oras sa pagitan ng mga indibidwal na keepalive probes. Ito ay kasalukuyang
epektibo sa mga operating system na nag-aalok ng TCP_KEEPIDLE at TCP_KEEPINTVL socket
mga opsyon (ibig sabihin Linux, kamakailang AIX, HP-UX at higit pa). Ang pagpipiliang ito ay walang epekto kung
--walang-keepalive Ginagamit. (Idinagdag sa 7.18.0)

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin. Kung hindi tinukoy,
ang opsyon ay default sa 60 segundo.

--susi
(SSL/SSH) Private key file name. Binibigyang-daan kang ibigay ang iyong pribadong key dito
hiwalay na file. Para sa SSH, kung hindi tinukoy, susubukan ni curl ang mga sumusunod na kandidato
order: '~/.ssh/id_rsa','~/.ssh/id_dsa', './id_rsa', './id_dsa'.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--key-type
(SSL) Pribadong key na uri ng file. Tukuyin kung aling uri ang iyong --susi ibinigay ang pribadong susi ay.
Sinusuportahan ang DER, PEM, at ENG. Kung hindi tinukoy, ipinapalagay ang PEM.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--krb
(FTP) Paganahin ang pagpapatunay at paggamit ng Kerberos. Ang antas ay dapat ipasok at dapat
maging isa sa 'malinaw', 'ligtas', 'kumpidensyal', o 'pribado'. Dapat kang gumamit ng isang antas
hindi iyon isa sa mga ito, 'pribado' na lang ang gagamitin.

Ang opsyong ito ay nangangailangan ng library na binuo gamit ang kerberos4 na suporta. Ito ay hindi masyadong
karaniwan. Gamitin -V, --bersyon upang makita kung sinusuportahan ito ng iyong kulot.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-l, --listahan-lamang
(FTP) Kapag naglilista ng isang direktoryo ng FTP, pinipilit ng switch na ito ang isang view na pangalan lamang. Ito ay
lalo na kapaki-pakinabang kung gusto ng user na i-machine-parse ang mga nilalaman ng isang FTP
direktoryo dahil ang normal na view ng direktoryo ay hindi gumagamit ng karaniwang hitsura o format.
Kapag ginamit tulad nito, ang opsyon ay nagiging sanhi ng isang NLST command na maipadala sa server
sa halip na LIST.

Tandaan: Ang ilang FTP server ay naglilista lamang ng mga file sa kanilang tugon sa NLST; hindi nila
isama ang mga sub-directory at simbolikong link.

(POP3) Kapag kumukuha ng isang partikular na email mula sa POP3, pinipilit ng switch na ito ang isang LIST
utos na dapat gawin sa halip na RETR. Ito ay partikular na kapaki-pakinabang kung ang gumagamit
gustong makita kung mayroong isang partikular na message id sa server at kung ano ang laki nito.

Tandaan: Kapag pinagsama sa -X, --hiling , maaaring gamitin ang opsyong ito para magpadala
isang UIDL command sa halip, kaya maaaring gamitin ng user ang natatanging identifier ng email sa halip
kaysa sa message id para gawin ang kahilingan. (Idinagdag sa 7.21.5)

-L, --lokasyon
(HTTP/HTTPS) Kung ang server ay nag-ulat na ang hiniling na pahina ay inilipat sa ibang
lokasyon (ipinahiwatig na may Lokasyon: header at isang 3XX response code), ang opsyong ito
gagawa ng curl redo ang kahilingan sa bagong lugar. Kung gagamitin kasama ng -ako,
--isama or -ako, --ulo, ipapakita ang mga header mula sa lahat ng hiniling na pahina. Kailan
ginagamit ang pagpapatunay, ipinapadala lamang ng curl ang mga kredensyal nito sa unang host. Kung ang
ang pag-redirect ay tumatagal ng curl sa ibang host, hindi nito maharang ang
user+password. Tingnan din --lokasyon-pinagkakatiwalaan sa kung paano baguhin ito. Maaari mong limitahan ang
dami ng mga pag-redirect na susundan sa pamamagitan ng paggamit ng --max-redirs pagpipilian.

Kapag ang curl ay sumunod sa isang pag-redirect at ang kahilingan ay hindi isang simpleng GET (halimbawa POST
o PUT), gagawin nito ang sumusunod na kahilingan sa isang GET kung ang tugon ng HTTP ay 301,
302, o 303. Kung ang response code ay anumang iba pang 3xx code, muling ipapadala ng curl ang
sumusunod na kahilingan gamit ang parehong hindi binagong pamamaraan.

Maaari mong sabihin kay curl na huwag baguhin ang paraan ng paghiling na hindi GET upang GET pagkatapos ng 30x
tugon sa pamamagitan ng paggamit ng mga nakalaang opsyon para doon: --post301, --post302 at
-post303.

--libcurl
Idagdag ang opsyong ito sa anumang ordinaryong curl command line, at makakakuha ka ng libcurl-
gamit ang C source code na nakasulat sa file na gumagawa ng katumbas ng kung ano ang iyong
ginagawa ng command-line operation!

Kung ang opsyong ito ay ginamit nang maraming beses, ang huling ibinigay na pangalan ng file ay gagamitin. (Idinagdag
sa 7.16.1)

--limit-rate
Tukuyin ang maximum na rate ng paglipat na gusto mong gamitin ng curl - para sa parehong mga pag-download at
mga pag-upload. Ang tampok na ito ay kapaki-pakinabang kung mayroon kang isang limitadong tubo at gusto mo ang iyong
ilipat upang hindi gamitin ang iyong buong bandwidth. Upang gawin itong mas mabagal kaysa sa kung hindi man
maaring maging.

Ang ibinigay na bilis ay sinusukat sa bytes/segundo, maliban kung may idinagdag na suffix.
Ang pagdaragdag ng 'k' o 'K' ay bibilangin ang numero habang ginagawa ito ng kilobytes, 'm' o M'
megabytes, habang ginagawa itong gigabytes ng 'g' o 'G'. Mga halimbawa: 200K, 3m at 1G.

Ang ibinigay na rate ay ang average na bilis na binibilang sa buong paglilipat. Ibig sabihin
ang kulot na iyon ay maaaring gumamit ng mas mataas na bilis ng paglipat sa mga maikling pagsabog, ngunit sa paglipas ng panahon ito ay gumagamit
hindi hihigit sa ibinigay na rate.

Kung gagamitin mo rin ang -Y, --limit ng tulin opsyon, ang pagpipiliang iyon ay mauuna at
maaaring bahagyang mapilayan ang rate-limiting, upang makatulong na panatilihin ang speed-limit logic
nagtatrabaho.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--local-port [-num]
Magtakda ng gustong numero o hanay ng mga lokal na numero ng port na gagamitin para sa (mga) koneksyon.
Tandaan na ang mga numero ng port sa likas na katangian ay isang mahirap na mapagkukunan na magiging abala minsan
kaya ang pagtatakda ng saklaw na ito sa isang bagay na masyadong makitid ay maaaring magdulot ng hindi kinakailangang koneksyon
mga pagkabigo sa pag-setup. (Idinagdag sa 7.15.2)

--lokasyon-pinagkakatiwalaan
(HTTP/HTTPS) Gusto -L, --lokasyon, ngunit papayagan ang pagpapadala ng pangalan + password sa lahat
mga host na maaaring i-redirect ng site. Ito ay maaaring magpakilala o hindi ng isang seguridad
paglabag kung ire-redirect ka ng site sa isang site kung saan mo ipapadala ang iyong pagpapatotoo
info (na plaintext sa kaso ng HTTP Basic authentication).

-m, --max-time
Pinakamataas na oras sa mga segundo na pinapayagan mong gawin ang buong operasyon. Ito ay kapaki-pakinabang
para sa pagpigil sa iyong mga batch na trabaho na mabitin nang ilang oras dahil sa mabagal na network o link
pababa. Mula noong 7.32.0, ang opsyong ito ay tumatanggap ng mga decimal na halaga, ngunit ang aktwal
Ang timeout ay bababa sa katumpakan habang ang tinukoy na timeout ay tumataas sa decimal
katumpakan. Tingnan din ang --connect-timeout pagpipilian.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--login-options
Tukuyin ang mga opsyon sa pag-log in na gagamitin sa panahon ng pagpapatunay ng server.

Maaari mong gamitin ang mga opsyon sa pag-login upang tukuyin ang mga partikular na opsyon sa protocol na maaaring gamitin
sa panahon ng pagpapatunay. Sa kasalukuyan, sinusuportahan lamang ng IMAP, POP3 at SMTP ang mga opsyon sa pag-login.
Para sa higit pang impormasyon tungkol sa mga opsyon sa pag-log in, pakitingnan ang RFC 2384, RFC 5092 at IETF
draft draft-earhart-url-smtp-00.txt (Idinagdag sa 7.34.0).

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--mail-auth
(SMTP) Tumukoy ng isang address. Ito ay gagamitin upang tukuyin ang pagpapatunay
address (pagkakakilanlan) ng isang isinumiteng mensahe na ipinapadala sa ibang server.

(Idinagdag sa 7.25.0)

--mail-mula sa
(SMTP) Tukuyin ang isang address kung saan dapat ipadala ang ibinigay na mail.

(Idinagdag sa 7.20.0)

--max-filesize
Tukuyin ang maximum na laki (sa bytes) ng isang file na ida-download. Kung ang file na hiniling ay
mas malaki kaysa sa halagang ito, hindi magsisimula ang paglipat at babalik ang curl na may paglabas
code 63.

TANDAAN: Ang laki ng file ay hindi palaging kilala bago i-download, at para sa mga naturang file ito
Ang opsyon ay walang epekto kahit na ang paglilipat ng file ay mas malaki kaysa sa ibinigay na ito
limitasyon. Ito ay may kinalaman sa parehong FTP at HTTP transfer.

--mail-rcpt
(SMTP) Tumukoy ng iisang address, user name o pangalan ng mailing list.

Kapag nagsasagawa ng paglilipat ng mail, dapat na tukuyin ng tatanggap ang isang wastong email address
upang ipadala ang mail sa. (Idinagdag sa 7.20.0)

Kapag nagsasagawa ng pag-verify ng address (utos ng VRFY), ang tatanggap ay dapat na
tinukoy bilang user name o user name at domain (ayon sa Seksyon 3.5 ng RFC5321).
(Idinagdag sa 7.34.0)

Kapag nagsasagawa ng isang mailing list expand (EXPN command), ang tatanggap ay dapat
tinukoy gamit ang pangalan ng mailing list, gaya ng "Friends" o "London-Office".
(Idinagdag sa 7.34.0)

--max-redirs
Itakda ang maximum na bilang ng mga redirection-follow na pinapayagan. Kung -L, --lokasyon Ginagamit,
ang pagpipiliang ito ay maaaring gamitin upang maiwasan ang curl mula sa pagsunod sa mga pag-redirect "sa absurdum".
Bilang default, nakatakda ang limitasyon sa 50 pag-redirect. Itakda ang opsyong ito sa -1 para magawa ito
walang limitasyon.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--metalink
Maaaring sabihin ng opsyong ito ang curl na i-parse at iproseso ang isang ibinigay na URI bilang Metalink file (parehong
bersyon 3 at 4 (RFC 5854) ay suportado) at gamitin ang mga salamin na nakalista sa loob
para sa failover kung may mga error (gaya ng hindi available ang file o server).
Ive-verify din nito ang hash ng file pagkatapos makumpleto ang pag-download. Ang Metalink
Ang file mismo ay na-download at naproseso sa memorya at hindi nakaimbak sa lokal na file
system.

Halimbawa para gumamit ng malayuang Metalink file:

kulutan --metalink http://www.example.com/example.metalink

Upang gumamit ng Metalink file sa lokal na file system, gamitin ang FILE protocol (file://):

kulutan --metalink file://example.metalink

Pakitandaan na kung ang FILE protocol ay hindi pinagana, walang paraan upang gumamit ng lokal
Metalink file sa oras ng pagsulat na ito. Tandaan din na kung --metalink at
--isama ay ginagamit nang magkasama, --isama ay hindi papansinin. Ito ay dahil kasama
ang mga header sa tugon ay masisira ang Metalink parser at kung ang mga header ay kasama
sa file na inilarawan sa Metalink file, mabibigo ang pagsusuri ng hash.

(Idinagdag sa 7.27.0, kung binuo laban sa library ng libmetalink.)

-n, --netrc
Ginagawang curl scan ang .netrc (_netrc sa Windows) na file sa home directory ng user
para sa login name at password. Ito ay karaniwang ginagamit para sa FTP sa Unix. Kung gagamitin sa
Ang HTTP, curl ay magbibigay-daan sa pagpapatunay ng user. Tingnan mo netrc(5) ftp(1) para sa mga detalye sa
format ng file. Hindi magrereklamo si Curl kung walang mga tamang pahintulot ang file na iyon
(hindi ito dapat na mabasa ng mundo o ng grupo). Ang variable ng kapaligiran na "HOME"
ay ginagamit upang mahanap ang home directory.

Isang mabilis at napakasimpleng halimbawa kung paano mag-setup a .netrc upang payagan ang curl sa FTP sa
ang machine host.domain.com na may user name na 'myself' at password ay 'secret' ay dapat
mukhang katulad ng:

makina host.domain.com login aking sarili password lihim

-N, --walang-buffer
Hindi pinapagana ang buffering ng output stream. Sa normal na mga sitwasyon sa trabaho, ang curl ay gagawin
gumamit ng karaniwang buffered output stream na magkakaroon ng epekto na ilalabas nito
ang data sa mga tipak, hindi kinakailangang eksakto kung kailan dumating ang data. Gamit ito
idi-disable ng opsyon ang buffering na iyon.

Tandaan na ito ang pinawalang-saysay na pangalan ng opsyon na nakadokumento. Maaari mong gamitin sa gayon --buffer sa
ipatupad ang buffering.

--netrc-file
Ang pagpipiliang ito ay katulad ng --netrc, maliban na ibigay mo ang landas (ganap o
relative) sa netrc file na dapat gamitin ni Curl. Maaari ka lamang tumukoy ng isang netrc
file sa bawat invocation. Kung marami --netrc-file ang mga pagpipilian ay ibinigay, tanging ang huli
isa gagamitin. (Idinagdag sa 7.21.5)

Ino-override ng opsyong ito ang anumang paggamit ng --netrc dahil sila ay kapwa eksklusibo. Ito ay
sumunod din --netrc-opsyonal kung tinukoy.

--netrc-opsyonal
Sobrang katulad sa --netrc, ngunit ginagawa ng opsyong ito ang paggamit ng .netrc opsyonal at hindi
sapilitan bilang ang --netrc ginagawa ng opsyon.

--makipag-ayos
(HTTP) Pinapagana ang Negotiate (SPNEGO) authentication.

Kung gusto mong paganahin ang Negotiate (SPNEGO) para sa proxy authentication, pagkatapos ay gamitin
--proxy-negotiate.

Ang opsyong ito ay nangangailangan ng library na binuo gamit ang GSS-API o SSPI na suporta. Gamitin -V,
--bersyon upang makita kung sinusuportahan ng iyong curl ang GSS-API/SSPI at SPNEGO.

Kapag ginagamit ang pagpipiliang ito, dapat ka ring magbigay ng pekeng -ikaw, --gumagamit opsyon upang i-activate
maayos ang authentication code. Ang pagpapadala ng '-u :' ay sapat na bilang user name at
password mula sa -u hindi talaga ginagamit ang opsyon.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang una lamang ang gagamitin.

--walang-keepalive
Hindi pinapagana ang paggamit ng mga keepalive na mensahe sa koneksyon ng TCP, bilang default na curl
nagbibigay-daan sa kanila.

Tandaan na ito ang pinawalang-saysay na pangalan ng opsyon na nakadokumento. Maaari mong gamitin sa gayon --panatilihing buhay
upang ipatupad ang keepalive.

--no-sessionid
(SSL) I-disable ang paggamit ni curl ng SSL session-ID caching. Bilang default, ang lahat ng mga paglilipat ay
tapos gamit ang cache. Tandaan na habang walang dapat masaktan sa pamamagitan ng pagtatangka
muling gumamit ng mga SSL session-ID, tila may mga sirang pagpapatupad ng SSL sa ligaw na iyon
Maaaring kailanganin mong huwag paganahin ito para magtagumpay ka. (Idinagdag sa 7.16.0)

Tandaan na ito ang pinawalang-saysay na pangalan ng opsyon na nakadokumento. Maaari mong gamitin sa gayon --sessionid
para ipatupad ang session-ID caching.

--noproxy
Listahan ng mga host na pinaghihiwalay ng kuwit na hindi gumagamit ng proxy, kung tinukoy ang isa. Ang
ang wildcard lang ay isang * character, na tumutugma sa lahat ng host, at epektibo
hindi pinapagana ang proxy. Ang bawat pangalan sa listahang ito ay tumutugma bilang alinman sa isang domain na
naglalaman ng hostname, o ang hostname mismo. Halimbawa, magkatugma ang local.com
local.com, local.com:80, at www.local.com, ngunit hindi www.notlocal.com. (Idinagdag sa
7.19.4).

--ntlm (HTTP) Pinapagana ang NTLM authentication. Ang paraan ng pagpapatunay ng NTLM ay dinisenyo ni
Microsoft at ginagamit ng mga web server ng IIS. Ito ay isang proprietary protocol, baligtarin-
ininhinyero ng matatalinong tao at ipinatupad sa curl batay sa kanilang mga pagsisikap. Ito
uri ng pag-uugali ay hindi dapat i-endorso, dapat mong hikayatin ang lahat ng gumagamit
NTLM upang lumipat sa isang pampubliko at nakadokumentong paraan ng pagpapatotoo sa halip, gaya ng
Digest.

Kung gusto mong paganahin ang NTLM para sa iyong proxy authentication, pagkatapos ay gamitin --proxy-ntlm.

Ang opsyong ito ay nangangailangan ng library na binuo gamit ang SSL support. Gamitin -V, --bersyon upang makita kung
ang iyong curl ay sumusuporta sa NTLM.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang una lamang ang gagamitin.

-o, --output
Isulat ang output sa sa halip na stdout. Kung gumagamit ka ng {} o [] para kunin
maramihang mga dokumento, maaari mong gamitin ang '#' na sinusundan ng isang numero sa specifier.
Ang variable na iyon ay papalitan ng kasalukuyang string para sa URL na kinukuha.
Tulad sa:

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

o gumamit ng ilang variable tulad ng:

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

Maaari mong gamitin ang opsyong ito nang kasing dami ng bilang ng mga URL na mayroon ka.

Tingnan din ang --create-dirs opsyon na lumikha ng mga lokal na direktoryo nang pabago-bago.
Ang pagtukoy sa output bilang '-' (isang solong gitling) ay pipilitin na gawin ang output sa
stdout.

-O, --remote-pangalan
Sumulat ng output sa isang lokal na file na pinangalanang tulad ng remote na file na nakukuha namin. (Tanging ang bahagi ng file
ng remote na file ay ginagamit, ang landas ay pinutol.)

Ang malayuang pangalan ng file na gagamitin para sa pag-save ay nakuha mula sa ibinigay na URL, wala
iba pa.

Dahil dito, mase-save ang file sa kasalukuyang gumaganang direktoryo. kung ikaw
gusto mong ma-save ang file sa ibang direktoryo, siguraduhing baguhin mo ang kasalukuyang gumagana
direktoryo bago ka mag-invoke ng curl gamit ang -O, --remote-pangalan bandila!

Walang ginawang pag-decode ng URL sa pangalan ng file. Kung mayroon itong %20 o iba pang URL na naka-encode
mga bahagi ng pangalan, magtatapos ang mga ito bilang pangalan ng file.

Maaari mong gamitin ang opsyong ito nang kasing dami ng bilang ng mga URL na mayroon ka.

--oauth2-bearer
(IMAP, POP3, SMTP) Tukuyin ang Bearer Token para sa OAUTH 2.0 server authentication.
Ang Bearer Token ay ginagamit kasabay ng user name na maaaring tukuyin
bilang bahagi ng mga --url or -ikaw, --gumagamit mga pagpipilian.

Ang Bearer Token at user name ay naka-format ayon sa RFC 6750.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--proxy-header
(HTTP) Dagdag na header na isasama sa kahilingan kapag nagpapadala ng HTTP sa isang proxy. Maaari mong
tukuyin ang anumang bilang ng mga karagdagang header. Ito ang katumbas na opsyon sa -H, --header
ngunit para sa proxy na komunikasyon lamang tulad ng sa CONNECT na mga kahilingan kapag gusto mo a
hiwalay na header na ipinadala sa proxy sa kung ano ang ipinadala sa aktwal na remote host.

sisiguraduhin ng curl na ang bawat header na idaragdag/papalitan mo ay ipapadala nang may wastong dulo-
of-line marker, dapat ganito hindi idagdag iyon bilang bahagi ng nilalaman ng header: gawin
huwag magdagdag ng mga bagong linya o pagbabalik ng karwahe, magugulo lamang ang mga ito para sa iyo.

Ang mga header na tinukoy sa opsyong ito ay hindi isasama sa mga kahilingang alam ni curl
ay hindi ipapadala sa isang proxy.

Maaaring gamitin ang opsyong ito nang maraming beses upang magdagdag/magpalit/mag-alis ng maramihang mga header.

(Idinagdag sa 7.37.0)

-p, --proxytunnel
Kapag gumamit ng HTTP proxy (-x, --proxy), ang pagpipiliang ito ay magdudulot ng mga hindi HTTP na protocol
upang subukang mag-tunnel sa pamamagitan ng proxy sa halip na gamitin lamang ito upang gawin ang HTTP-like
mga operasyon. Ang tunnel approach ay ginawa gamit ang HTTP proxy CONNECT request at
ay nangangailangan na ang proxy ay nagbibigay-daan sa direktang kumonekta sa remote port number curl gusto
sa lagusan sa.

-P, --ftp-port
(FTP) Binabaliktad ang mga default na initiator/tagapakinig na tungkulin kapag kumokonekta sa FTP. Ito
switch ay gumagawa curl gumamit ng aktibong mode. Sa pagsasanay, curl pagkatapos ay nagsasabi sa server na
kumonekta pabalik sa tinukoy na address at port ng kliyente, habang nagtatanong ang passive mode
ang server upang mag-set up ng IP address at port para makakonekta ito. dapat
maging isa sa:

interface
ie "eth0" upang tukuyin kung aling IP address ng interface ang gusto mong gamitin (Unix
lamang)

IP address
ibig sabihin, "192.168.10.1" upang tukuyin ang eksaktong IP address

pangalan ng host
ibig sabihin, "my.host.domain" upang tukuyin ang makina

- Papiliin ang curl ng parehong IP address na ginagamit na para sa kontrol
koneksyon

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin. Huwag paganahin ang paggamit ng
PORT na may --ftp-pasv. Huwag paganahin ang pagtatangkang gamitin ang utos ng EPRT sa halip na PORT
sa pamamagitan ng paggamit --disable-eprt. PORT++ talaga ang EPRT.

Simula sa 7.19.5, maaari mong idugtong ang ":[start]-[end]" sa kanan ng address, sa
sabihin sa curl kung anong TCP port range ang gagamitin. Ibig sabihin, tumukoy ka ng port range, mula sa a
mas mababa sa mas mataas na bilang. Ang isang solong numero ay gumagana rin, ngunit tandaan na ito
pinatataas ang panganib ng pagkabigo dahil maaaring hindi magagamit ang port.

--pasa
(SSL/SSH) Passphrase para sa pribadong key

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--path-as-is
Sabihin kay curl na huwag hawakan ang mga sequence ng /../ or /./ sa ibinigay na landas ng URL. Karaniwan
pipilitin o pagsasamahin ng curl ang mga ito ayon sa mga pamantayan ngunit itinakda ka ng pagpipiliang ito
sabihin mong huwag gawin iyon.

(Idinagdag sa 7.42.0)

--post301
(HTTP) Sinasabi sa curl na igalang ang RFC 7230/6.4.2 at huwag i-convert ang mga kahilingan sa POST sa GET
mga kahilingan kapag sumusunod sa isang 301 na pag-redirect. Ang hindi-RFC na pag-uugali ay nasa lahat ng dako
mga web browser, kaya ginagawa ng curl ang conversion bilang default upang mapanatili ang pagkakapare-pareho.
Gayunpaman, ang isang server ay maaaring mangailangan ng isang POST upang manatiling isang POST pagkatapos ng naturang pag-redirect.
Ang pagpipiliang ito ay makabuluhan lamang kapag ginagamit -L, --lokasyon (Idinagdag sa 7.17.1)

--post302
(HTTP) Sinasabi sa curl na igalang ang RFC 7230/6.4.3 at huwag i-convert ang mga kahilingan sa POST sa GET
mga kahilingan kapag sumusunod sa isang 302 na pag-redirect. Ang hindi-RFC na pag-uugali ay nasa lahat ng dako
mga web browser, kaya ginagawa ng curl ang conversion bilang default upang mapanatili ang pagkakapare-pareho.
Gayunpaman, ang isang server ay maaaring mangailangan ng isang POST upang manatiling isang POST pagkatapos ng naturang pag-redirect.
Ang pagpipiliang ito ay makabuluhan lamang kapag ginagamit -L, --lokasyon (Idinagdag sa 7.19.1)

--post303
(HTTP) Sinasabi sa curl na igalang ang RFC 7230/6.4.4 at huwag i-convert ang mga kahilingan sa POST sa GET
mga kahilingan kapag sumusunod sa isang 303 na pag-redirect. Ang hindi-RFC na pag-uugali ay nasa lahat ng dako
mga web browser, kaya ginagawa ng curl ang conversion bilang default upang mapanatili ang pagkakapare-pareho.
Gayunpaman, ang isang server ay maaaring mangailangan ng isang POST upang manatiling isang POST pagkatapos ng naturang pag-redirect.
Ang pagpipiliang ito ay makabuluhan lamang kapag ginagamit -L, --lokasyon (Idinagdag sa 7.26.0)

--proto
Sinasabi sa curl na gamitin ang mga nakalistang protocol para sa paunang pagkuha nito. Ang mga protocol ay
sinusuri mula kaliwa hanggang kanan, pinaghihiwalay ng kuwit, at ang bawat isa ay isang pangalan ng protocol o
'lahat', opsyonal na prefix ng zero o higit pang mga modifier. Ang mga magagamit na modifier ay:

+ Pahintulutan ang protocol na ito bilang karagdagan sa mga protocol na pinahihintulutan na (ito ang
default kung walang ginagamit na modifier).

- Tanggihan ang protocol na ito, alisin ito sa listahan ng mga protocol na pinahihintulutan na.

= Pahintulutan lamang ang protocol na ito (binalewala ang listahan na pinahihintulutan na), kahit na paksa
sa pagbabago sa ibang pagkakataon sa pamamagitan ng kasunod na mga entry sa comma separated list.

Halimbawa:

--proto -ftps gumagamit ng mga default na protocol, ngunit hindi pinapagana ang ftps

--proto -lahat, https+http
pinapagana lamang ang http at https

--proto =http,https
pinapagana lang din ang http at https

Ang mga hindi kilalang protocol ay gumagawa ng babala. Nagbibigay-daan ito sa mga script na ligtas na umasa sa pagiging
magagawang i-disable ang mga potensyal na mapanganib na protocol, nang hindi umaasa sa suporta para sa
ang protocol na iyon ay binuo sa curl upang maiwasan ang isang error.

Ang pagpipiliang ito ay maaaring gamitin nang maraming beses, kung saan ang epekto ay kapareho ng
pagsasama-sama ng mga protocol sa isang pagkakataon ng opsyon.

(Idinagdag sa 7.20.2)

--proto-default
Sinasabi ng curl na gamitin protokol para sa anumang URL na walang pangalan ng scheme.

Halimbawa:

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

Ang hindi alam o hindi sinusuportahang protocol ay nagdudulot ng error CURLE_UNSUPPORTED_PROTOCOL.

Hindi binabago ng opsyong ito ang default na proxy protocol (http).

Kung wala ang pagpipiliang ito, ang curl ay gagawa ng isang hula batay sa host, tingnan --url para sa mga detalye.

(Idinagdag sa 7.45.0)

--proto-redir
Sinasabi sa curl na gamitin ang mga nakalistang protocol sa pag-redirect. Tingnan ang --proto para sa kung paano ang mga protocol
ay kinakatawan.

Halimbawa:

--proto-redir -lahat,http,https
Payagan lamang ang HTTP at HTTPS sa pag-redirect.

Bilang default, papayagan ng curl ang lahat ng protocol sa pag-redirect maliban sa ilang naka-disable para sa seguridad
mga dahilan: Dahil ang 7.19.4 FILE at SCP ay hindi pinagana, at dahil ang 7.40.0 SMB at SMBS ay din
may kapansanan. Tinutukoy lahat or +lahat pinapagana ang lahat ng mga protocol sa pag-redirect, kabilang ang mga iyon
hindi pinagana para sa seguridad.

(Idinagdag sa 7.20.2)

--proxy-anyauth
Sinasabi sa curl na pumili ng angkop na paraan ng pagpapatunay kapag nakikipag-ugnayan sa
binigay na proxy. Maaaring magdulot ito ng dagdag na kahilingan/tugon round-trip. (Idinagdag sa
7.13.2)

--proxy-basic
Sinasabi sa curl na gumamit ng HTTP Basic authentication kapag nakikipag-ugnayan sa ibinigay
proxy. Gamitin --basic para sa pagpapagana ng HTTP Basic sa isang malayuang host. Basic ang default
paraan ng pagpapatunay na curl ay gumagamit ng mga proxy.

--proxy-digest
Sinasabi sa curl na gumamit ng HTTP Digest authentication kapag nakikipag-ugnayan sa ibinigay
proxy. Gamitin --digest para sa pagpapagana ng HTTP Digest sa isang malayuang host.

--proxy-negotiate
Sinasabi sa curl na gumamit ng HTTP Negotiate (SPNEGO) authentication kapag nakikipag-ugnayan sa
ang ibinigay na proxy. Gamitin --makipag-ayos para sa pagpapagana ng HTTP Negotiate (SPNEGO) gamit ang remote
host. (Idinagdag sa 7.17.1)

--proxy-ntlm
Sinasabi sa curl na gumamit ng HTTP NTLM authentication kapag nakikipag-ugnayan sa ibinigay na proxy.
paggamit --ntlm para sa pagpapagana ng NTLM sa isang malayuang host.

--proxy-service-name
Binibigyang-daan ka ng opsyong ito na baguhin ang pangalan ng serbisyo para sa proxy negotiation.

Mga halimbawa: --proxy-negotiate proxy-name --proxy-service-name gagamitin ni sockd
sockd/proxy-name. (Idinagdag sa 7.43.0).

--proxy1.0
Gamitin ang tinukoy na HTTP 1.0 proxy. Kung ang numero ng port ay hindi tinukoy, ito ay
ipinapalagay sa port 1080.

Ang tanging pagkakaiba sa pagitan nito at ng opsyong HTTP proxy (-x, --proxy), iyan ba
ang mga pagtatangkang gumamit ng CONNECT sa pamamagitan ng proxy ay tutukuyin sa halip ng HTTP 1.0 protocol
ng default na HTTP 1.1.

--pubkey
(SSH) Pangalan ng file ng pampublikong key. Binibigyang-daan kang ibigay ang iyong pampublikong susi sa hiwalay na ito
file.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

(Noong 7.39.0, sinusubukan ng curl na awtomatikong kunin ang pampublikong key mula sa
pribadong key file, kaya hindi kinakailangan ang pagpasa sa opsyong ito. Tandaan na ito
Ang pagkuha ng pampublikong key ay nangangailangan ng libcurl na maiugnay laban sa isang kopya ng libssh2 1.2.8
o mas mataas na mismong naka-link laban sa OpenSSL.)

-q Kung ginamit bilang unang parameter sa command line, ang curlrc config file ay hindi
basahin at gamitin. Tingnan ang -K, --config para sa mga detalye sa default na config file
landas ng paghahanap.

-Q, --quote
(FTP/SFTP) Magpadala ng arbitrary na command sa remote na FTP o SFTP server. Quote
ipinapadala ang mga utos BAGO maganap ang paglipat (pagkatapos lamang ng unang PWD
command sa isang FTP transfer, upang maging eksakto). Upang maganap ang mga utos pagkatapos ng a
matagumpay na paglipat, lagyan ng gitling '-' ang mga ito. Upang maipadala ang mga utos pagkatapos
binago ni curl ang gumaganang direktoryo, bago ang (mga) utos ng paglilipat, prefix
ang utos na may '+' (ito ay sinusuportahan lamang para sa FTP). Maaari mong tukuyin ang anumang numero
ng mga utos. Kung ang server ay nagbabalik ng kabiguan para sa isa sa mga utos, ang kabuuan
maa-abort ang operasyon. Dapat kang magpadala ng syntactically correct FTP command bilang RFC
Ang 959 ay tumutukoy sa mga FTP server, o isa sa mga command na nakalista sa ibaba sa mga SFTP server.
Maaaring gamitin ang opsyong ito nang maraming beses. Kapag nagsasalita sa isang FTP server, prefix ang
command na may asterisk (*) para magpatuloy ang curl kahit na nabigo ang command gaya ng by
ang default curl ay titigil sa unang pagkabigo.

Ang SFTP ay isang binary protocol. Hindi tulad ng para sa FTP, binibigyang-kahulugan ng curl ang mga utos ng panipi ng SFTP
mismo bago ipadala ang mga ito sa server. Ang mga pangalan ng file ay maaaring banggitin sa istilong shell
mag-embed ng mga puwang o mga espesyal na character. Ang sumusunod ay ang listahan ng lahat ng sinusuportahang SFTP
quote commands:

chgrp group file
Itinatakda ng chgrp command ang group ID ng file na pinangalanan ng file operand sa
ang group ID na tinukoy ng operand ng grupo. Ang operand ng pangkat ay isang decimal
integer group ID.

chmod mode na file
Binabago ng chmod command ang file mode bits ng tinukoy na file. Ang
Ang mode operand ay isang octal integer mode number.

chown user file
Itinatakda ng chown command ang may-ari ng file na pinangalanan ng file operand sa
ang user ID na tinukoy ng user operand. Ang user operand ay isang decimal
integer user ID.

Sa source_file target_file
Ang ln at symlink command ay lumikha ng simbolikong link sa target_file
lokasyon na tumuturo sa source_file na lokasyon.

mkdir directory_name
Ang mkdir command ay lumilikha ng direktoryo na pinangalanan ng directory_name operand.

pwd Ang pwd command ay nagbabalik ng absolute pathname ng kasalukuyang gumagana
direktoryo.

palitan ang pangalan ng target na pinagmulan
Pinapalitan ng rename command ang file o direktoryo na pinangalanan ng source operand
sa patutunguhang landas na pinangalanan ng target na operand.

rm file
Tinatanggal ng rm command ang file na tinukoy ng file operand.

direktoryo ng rmdir
Tinatanggal ng rmdir command ang entry sa direktoryo na tinukoy ng direktoryo
operand, kung ito ay walang laman.

symlink source_file target_file
Tingnan ang ln.

-r, --saklaw
(HTTP/FTP/SFTP/FILE) Kumuha ng byte range (ibig sabihin, isang bahagyang dokumento) mula sa isang
HTTP/1.1, FTP o SFTP server o isang lokal na FILE. Maaaring tukuyin ang mga saklaw sa isang numero
ng mga paraan.

0-499 tumutukoy sa unang 500 bytes

500-999 tumutukoy sa pangalawang 500 bytes

-500 tumutukoy sa huling 500 bytes

9500- tumutukoy sa mga byte mula sa offset 9500 at pasulong

0-0,-1 tumutukoy sa una at huling byte lamang(*)(HTTP)

100-199,500-599
tumutukoy sa dalawang magkahiwalay na 100-byte na hanay(*) (HTTP)

(*) = TANDAAN na ito ay magiging sanhi ng pagtugon ng server na may maraming bahagi na tugon!

Ang mga digit na character lamang (0-9) ang may bisa sa mga field na 'simula' at 'stop' ng
'start-stop' range syntax. Kung ang isang hindi-digit na character ay ibinigay sa hanay, ang
Ang tugon ng server ay hindi matutukoy, depende sa configuration ng server.

Dapat mo ring malaman na maraming HTTP/1.1 server ang walang feature na ito
pinagana, upang kapag sinubukan mong makakuha ng isang hanay, sa halip ay makukuha mo ang kabuuan
dokumento.

Sinusuportahan lamang ng mga pag-download ng hanay ng FTP at SFTP ang simpleng 'start-stop' syntax
(opsyonal sa isa sa mga numerong tinanggal). Ang paggamit ng FTP ay depende sa pinalawig na FTP
utos SIZE.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-R, --malayuang-oras
Kapag ginamit, gagawin nitong pagtatangka ng curl na alamin ang timestamp ng remote
file, at kung magagamit iyon gawin ang lokal na file na makuha ang parehong timestamp.

--random-file
(SSL) Tukuyin ang pangalan ng path sa file na naglalaman ng kung ano ang ituturing na random
datos. Ang data ay ginagamit upang i-seed ang random na makina para sa mga koneksyon sa SSL. Tingnan din ang
--egd-file pagpipilian.

--raw (HTTP) Kapag ginamit, hindi nito pinapagana ang lahat ng panloob na HTTP decoding ng nilalaman o paglilipat
encoding at sa halip ay pinapasa ang mga ito nang hindi nabago, hilaw. (Idinagdag sa 7.16.2)

--remote-name-lahat
Binabago ng opsyong ito ang default na pagkilos para sa lahat ng ibinigay na URL na haharapin na parang
-O, --remote-pangalan ay ginamit para sa bawat isa. Kaya kung gusto mong i-disable iyon para sa isang
tiyak na URL pagkatapos --remote-name-lahat ay ginamit, dapat mong gamitin ang "-o -" o --hindi-
remote-pangalan. (Idinagdag sa 7.19.0)

--resolba
Magbigay ng custom na address para sa isang partikular na host at pares ng port. Gamit ito, magagawa mo
gawin ang (mga) curl request na gumamit ng isang tinukoy na address at pigilan ang kung hindi man
karaniwang niresolbang address na gagamitin. Isaalang-alang ito ng isang uri ng / Etc / host alternatiba
ibinigay sa command line. Ang numero ng port ay dapat ang numerong ginamit para sa
tiyak na protocol na gagamitin ng host. Nangangahulugan ito na kailangan mo ng ilang mga entry kung
gusto mong magbigay ng address para sa parehong host ngunit magkaibang mga port.

Maaaring gamitin ang opsyong ito nang maraming beses upang magdagdag ng maraming pangalan ng host upang malutas.

(Idinagdag sa 7.21.3)

--subukang muli
Kung ang isang lumilipas na error ay ibinalik kapag ang curl ay sumusubok na magsagawa ng paglipat, ito ay gagawin
subukang muli ang ilang beses bago sumuko. Ang pagtatakda ng numero sa 0 ay ginagawang curl
walang muling pagsubok (na siyang default). Ang lumilipas na error ay nangangahulugan ng alinman sa: isang timeout, isang FTP
4xx response code o isang HTTP 5xx response code.

Kapag susubukang muli ni curl ang isang paglipat, maghihintay muna ito ng isang segundo at pagkatapos ay para sa
lahat ng paparating na muling pagsubok ay dodoblehin nito ang oras ng paghihintay hanggang umabot ito ng 10 minuto
na siyang magiging pagkaantala sa pagitan ng iba pang mga muling pagsubok. Sa pamamagitan ng paggamit --subukang muli-
antala hindi mo pinagana ang exponential backoff algorithm na ito. Tingnan din --retry-max-time sa
limitahan ang kabuuang oras na pinapayagan para sa muling pagsubok. (Idinagdag sa 7.12.3)

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--retry-delay
Patulog ng curl sa ganitong tagal bago ang bawat muling pagsubok kapag nabigo ang isang paglipat
na may lumilipas na error (binabago nito ang default na backoff time algorithm sa pagitan ng
muling subukan). Ang pagpipiliang ito ay kawili-wili lamang kung --subukang muli ay ginagamit din. Pagtatakda nito
ang pagkaantala sa zero ay gagawa ng curl na gamitin ang default na oras ng pag-backoff. (Idinagdag sa 7.12.3)

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--retry-max-time
Ang retry timer ay ni-reset bago ang unang pagtatangkang ilipat. Ang mga muling pagsubok ay gagawin bilang
karaniwan (tingnan --subukang muli) hangga't hindi naabot ng timer ang ibinigay na limitasyon. Pansinin
na kung ang timer ay hindi umabot sa limitasyon, ang kahilingan ay gagawin at habang
gumaganap, maaaring mas matagal ito kaysa sa ibinigay na yugto ng panahon. Upang limitahan ang isang solong
maximum na oras ng kahilingan, gamitin -m, --max-time. Itakda ang opsyong ito sa zero para hindi mag-timeout
muling sumusubok. (Idinagdag sa 7.12.3)

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-s, --tahimik
Tahimik o tahimik na mode. Huwag magpakita ng progress meter o mga mensahe ng error. Gumagawa ng Kulot
pipi. Ilalabas pa rin nito ang data na hinihiling mo, na posibleng maging sa
terminal/stdout maliban kung i-redirect mo ito.

--sasl-ir
I-enable ang paunang tugon sa SASL authentication. (Idinagdag sa 7.31.0)

--service-name
Binibigyang-daan ka ng opsyong ito na baguhin ang pangalan ng serbisyo para sa SPNEGO.

Mga halimbawa: --makipag-ayos --service-name Ang sockd ay gagamit ng sockd/server-name. (Idinagdag sa
7.43.0).

-S, --show-error
Kapag ginamit sa -s pinapalabas nito ang curl na isang mensahe ng error kung nabigo ito.

--ssl (FTP, POP3, IMAP, SMTP) Subukang gumamit ng SSL/TLS para sa koneksyon. Nagbabalik sa isang hindi-
secure na koneksyon kung hindi sinusuportahan ng server ang SSL/TLS. Tingnan din --ftp-ssl-
kontrol at --ssl-reqd para sa iba't ibang antas ng pag-encrypt na kinakailangan. (Idinagdag sa
7.20.0)

Ang pagpipiliang ito ay dating kilala bilang --ftp-ssl (Idinagdag sa 7.11.0). Ang pangalan ng opsyon na iyon ay maaari
magagamit pa rin ngunit aalisin sa hinaharap na bersyon.

--ssl-reqd
(FTP, POP3, IMAP, SMTP) Nangangailangan ng SSL/TLS para sa koneksyon. Tinatapos ang
koneksyon kung hindi sinusuportahan ng server ang SSL/TLS. (Idinagdag sa 7.20.0)

Ang pagpipiliang ito ay dating kilala bilang --ftp-ssl-reqd (idinagdag sa 7.15.5). Yung option
maaari pa ring gamitin ang pangalan ngunit aalisin sa hinaharap na bersyon.

--ssl-allow-beast
(SSL) Ang pagpipiliang ito ay nagsasabi sa curl na huwag gumana sa isang kakulangan sa seguridad sa SSL3 at
TLS1.0 protocol na kilala bilang BEAST. Kung hindi ginagamit ang opsyong ito, maaaring gamitin ang SSL layer
mga workaround na kilala na nagdudulot ng mga problema sa interoperability sa ilang mas lumang SSL
mga pagpapatupad. BABALA: pinapaluwag ng opsyong ito ang seguridad ng SSL, at sa paggamit nito
watawat na hinihiling mo nang eksakto iyon. (Idinagdag sa 7.25.0)

--ssl-no-revoke
(WinSSL) Sinasabi ng opsyong ito sa curl na huwag paganahin ang mga pagsusuri sa pagbawi ng certificate. BABALA:
ang pagpipiliang ito ay nagpapaluwag sa seguridad ng SSL, at sa pamamagitan ng paggamit ng bandilang ito ay eksaktong hinihiling mo
na. (Idinagdag sa 7.44.0)

--medyas4
Gamitin ang tinukoy na SOCKS4 proxy. Kung ang numero ng port ay hindi tinukoy, ito ay ipinapalagay
sa port 1080. (Idinagdag sa 7.15.2)

Ino-override ng opsyong ito ang anumang nakaraang paggamit ng -x, --proxy, dahil pareho sila
eksklusibo.

Mula noong 7.21.7, ang opsyon na ito ay kalabisan dahil maaari mong tukuyin ang isang socks4 proxy na may
-x, --proxy gamit ang isang socks4:// protocol prefix.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--medyas4a
Gamitin ang tinukoy na SOCKS4a proxy. Kung ang numero ng port ay hindi tinukoy, ito ay ipinapalagay
sa port 1080. (Idinagdag sa 7.18.0)

Ino-override ng opsyong ito ang anumang nakaraang paggamit ng -x, --proxy, dahil pareho sila
eksklusibo.

Mula noong 7.21.7, ang opsyon na ito ay kalabisan dahil maaari mong tukuyin ang isang socks4a proxy na may
-x, --proxy gamit ang isang socks4a:// protocol prefix.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--socks5-hostname
Gamitin ang tinukoy na SOCKS5 proxy (at hayaan ang proxy na lutasin ang pangalan ng host). Kung ang
Ang numero ng port ay hindi tinukoy, ito ay ipinapalagay sa port 1080. (Idinagdag sa 7.18.0)

Ino-override ng opsyong ito ang anumang nakaraang paggamit ng -x, --proxy, dahil pareho sila
eksklusibo.

Mula noong 7.21.7, hindi kailangan ang opsyong ito dahil maaari kang tumukoy ng hostname ng socks5
proxy na may -x, --proxy gamit ang isang socks5h:// protocol prefix.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin. (Ang pagpipiliang ito ay
dating maling naidokumento at ginamit bilang --medyas na walang numerong nakadugtong.)

--medyas5
Gamitin ang tinukoy na SOCKS5 proxy - ngunit lutasin ang pangalan ng host nang lokal. Kung ang daungan
numero ay hindi tinukoy, ito ay ipinapalagay sa port 1080.

Ino-override ng opsyong ito ang anumang nakaraang paggamit ng -x, --proxy, dahil pareho sila
eksklusibo.

Mula noong 7.21.7, ang opsyon na ito ay kalabisan dahil maaari mong tukuyin ang isang socks5 proxy na may
-x, --proxy gamit ang isang socks5:// protocol prefix.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin. (Ang pagpipiliang ito ay
dating maling naidokumento at ginamit bilang --medyas na walang numerong nakadugtong.)

Ang pagpipiliang ito (pati na rin --medyas4) ay hindi gumagana sa IPV6, FTPS o LDAP.

--socks5-gssapi-service
Ang default na pangalan ng serbisyo para sa isang server ng medyas ay rcmd/server-fqdn. Pinapayagan ng pagpipiliang ito
mong baguhin ito.

Mga halimbawa: --socks5 proxy-name --socks5-gssapi-service gagamit si sockd ng sockd/proxy-
pangalan --socks5 proxy-name --socks5-gssapi-service sockd/real-name ang gagamitin
sockd/real-name para sa mga kaso kung saan ang proxy-name ay hindi tumutugma sa pangunahing pangalan.
(Idinagdag sa 7.19.4).

--medyas5-gssapi-nec
Bilang bahagi ng negosasyon ng GSS-API, isang paraan ng proteksyon ang pinag-uusapan. Sabi ng RFC 1961
sa seksyon 4.3/4.4 dapat itong protektahan, ngunit ang pagpapatupad ng sanggunian ng NEC
ay hindi. Ang pagpipilian --medyas5-gssapi-nec nagbibigay-daan sa hindi protektadong pagpapalitan ng
negosasyon sa mode ng proteksyon. (Idinagdag sa 7.19.4).

--stderr
I-redirect ang lahat ng pagsusulat sa stderr sa tinukoy na file sa halip. Kung ang pangalan ng file ay a
plain '-', sa halip ay isinulat ito sa stdout.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-t, --telnet-opsyon
Ipasa ang mga opsyon sa telnet protocol. Ang mga sinusuportahang opsyon ay:

TTYPE= Itinatakda ang uri ng terminal.

XDISPLOC= Itinatakda ang lokasyon ng X display.

NEW_ENV= Nagtatakda ng variable ng kapaligiran.

-T, --upload-file
Inililipat nito ang tinukoy na lokal na file sa malayong URL. Kung walang bahagi ng file
sa tinukoy na URL, idaragdag ng Curl ang lokal na pangalan ng file. TANDAAN na dapat mong gamitin
isang trailing / sa huling direktoryo upang talagang patunayan kay Curl na walang file
Iisipin ng pangalan o curl na ang iyong huling pangalan ng direktoryo ay ang malayuang pangalan ng file
gamitin. Malamang na magiging sanhi iyon upang mabigo ang pagpapatakbo ng pag-upload. Kung ito ay ginagamit sa
isang HTTP(S) server, ang PUT command ang gagamitin.

Gamitin ang pangalan ng file na "-" (isang solong gitling) upang gamitin ang stdin sa halip na isang naibigay na file.
Bilang kahalili, ang pangalan ng file na "." (isang solong panahon) ay maaaring tukuyin sa halip na "-" sa
gumamit ng stdin sa non-blocking mode upang payagan ang pagbabasa ng output ng server habang ginagawa ang stdin
nai-upload.

Maaari mong tukuyin ang isang -T para sa bawat URL sa command line. Ang bawat pares ng -T + URL
tumutukoy kung ano ang ia-upload at kung saan. Sinusuportahan din ng curl ang "globbing" ng -T
argument, ibig sabihin ay makakapag-upload ka ng maraming file sa isang URL sa pamamagitan ng paggamit ng
parehong istilo ng globbing ng URL na sinusuportahan sa URL, tulad nito:

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

o kahit na

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

--tcp-nodelay
I-on ang opsyong TCP_NODELAY. Tingnan ang curl_easy_setopt(3) man page para sa mga detalye
tungkol sa opsyong ito. (Idinagdag sa 7.11.2)

--tftp-blksize
(TFTP) Itakda ang opsyong TFTP BLKSIZE (dapat na >512). Ito ang block size na kulot
susubukang gamitin kapag naglilipat ng data papunta o mula sa isang TFTP server. Bilang default 512
bytes ang gagamitin.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

(Idinagdag sa 7.20.0)

--tlsauthtype
Itakda ang uri ng pagpapatunay ng TLS. Sa kasalukuyan, ang tanging sinusuportahang opsyon ay "SRP", para sa
TLS-SRP (RFC 5054). Kung --tlsuser at --tlspassword ay tinukoy ngunit --tlsauthtype
ay hindi, kung gayon ang pagpipiliang ito ay magiging default sa "SRP". (Idinagdag sa 7.21.4)

--tlspassword
Itakda ang password para gamitin sa TLS authentication method na tinukoy sa
--tlsauthtype. Nangangailangan yan --tlsuser itakda din. (Idinagdag sa 7.21.4)

--tlsuser
Itakda ang username para sa paggamit sa TLS authentication method na tinukoy sa
--tlsauthtype. Nangangailangan yan --tlspassword itakda din. (Idinagdag sa 7.21.4)

--tlsv1.0
(SSL) Pinipilit ang curl na gamitin ang bersyon 1.0 ng TLS kapag nakikipag-usap sa isang remote na TLS server.
(Idinagdag sa 7.34.0)

--tlsv1.1
(SSL) Pinipilit ang curl na gamitin ang bersyon 1.1 ng TLS kapag nakikipag-usap sa isang remote na TLS server.
(Idinagdag sa 7.34.0)

--tlsv1.2
(SSL) Pinipilit ang curl na gamitin ang bersyon 1.2 ng TLS kapag nakikipag-usap sa isang remote na TLS server.
(Idinagdag sa 7.34.0)

--tr-encoding
(HTTP) Humiling ng naka-compress na Transfer-Encoding na tugon gamit ang isa sa mga algorithm
curl support, at i-uncompress ang data habang tinatanggap ito.

(Idinagdag sa 7.21.6)

--bakas
Pinapagana ang isang buong trace dump ng lahat ng papasok at papalabas na data, kabilang ang mapaglarawang
impormasyon, sa ibinigay na output file. Gamitin ang "-" bilang filename upang maipadala ang output
upang stdout.

Ino-override ng opsyong ito ang mga nakaraang paggamit ng -sa, --verbose or --trace-ascii.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--trace-ascii
Pinapagana ang isang buong trace dump ng lahat ng papasok at papalabas na data, kabilang ang mapaglarawang
impormasyon, sa ibinigay na output file. Gamitin ang "-" bilang filename upang maipadala ang output
upang stdout.

Ito ay halos kapareho sa --bakas, ngunit iniiwan ang hex na bahagi at ipinapakita lamang ang
ASCII bahagi ng dump. Gumagawa ito ng mas maliit na output na maaaring mas madaling basahin
mga taong hindi sinanay.

Ino-override ng opsyong ito ang mga nakaraang paggamit ng -sa, --verbose or --bakas.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--trace-time
Naglalagay ng time stamp sa bawat trace o verbose line na ipinapakita ng curl. (Idinagdag sa
7.14.0)

--unix-socket
(HTTP) Kumonekta sa pamamagitan ng Unix domain socket na ito, sa halip na gamitin ang network.
(Idinagdag sa 7.40.0)

-u, --gumagamit
Tukuyin ang user name at password na gagamitin para sa pagpapatunay ng server. Mga override -n,
--netrc at --netrc-opsyonal.

Kung tutukuyin mo lang ang user name, mag-prompt si curl para sa isang password.

Ang user name at mga password ay nahahati sa unang colon, na gumagawa nito
imposibleng gumamit ng colon sa user name gamit ang opsyong ito. Ang password ay maaari,
pa rin.

Kapag gumagamit ng Kerberos V5 sa isang Windows based server dapat mong isama ang Windows
domain name sa user name, upang matagumpay na makakuha ang server ng a
Ticket ng Kerberos. Kung hindi mo gagawin, maaaring mabigo ang paunang pakikipagkamay sa pagpapatunay.

Kapag gumagamit ng NTLM, ang user name ay maaaring tukuyin lamang bilang user name, nang wala
ang domain, kung mayroong isang domain at kagubatan sa iyong setup halimbawa.

Upang tukuyin ang domain name, gamitin ang alinman sa Down-Level Logon Name o UPN (User Principal
Pangalan) mga format. Halimbawa, EXAMPLE\user at [protektado ng email] ayon sa pagkakabanggit.

Kung gumagamit ka ng Windows SSPI-enabled curl binary at nagsasagawa ng Kerberos V5, Negotiate,
NTLM o Digest authentication pagkatapos ay maaari mong sabihin sa curl na piliin ang user name at
password mula sa iyong kapaligiran sa pamamagitan ng pagtukoy ng isang colon na may ganitong opsyon: "-u
: ".

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-U, --proxy-user
Tukuyin ang user name at password na gagamitin para sa proxy authentication.

Kung gumagamit ka ng Windows SSPI-enabled curl binary at gagawin ang alinman sa Negotiate o NTLM
pagpapatunay pagkatapos ay maaari mong sabihin sa curl upang piliin ang user name at password mula sa
iyong kapaligiran sa pamamagitan ng pagtukoy ng isang colon na may ganitong opsyon: "-U :".

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--url
Tumukoy ng URL na kukunin. Ang pagpipiliang ito ay kadalasang madaling gamitin kapag gusto mong tukuyin ang (mga) URL
sa isang config file.

Kung ang ibinigay na URL ay walang pangalan ng scheme (gaya ng "http://" o "ftp://" atbp) kung gayon
curl ay gagawa ng hula batay sa host. Kung ang pinakamalabas na pangalan ng sub-domain ay tumutugma
DICT, FTP, IMAP, LDAP, POP3 o SMTP pagkatapos ang protocol na iyon ay gagamitin, kung hindi man ay HTTP
gagamitin. Dahil ang 7.45.0 na paghula ay maaaring hindi paganahin sa pamamagitan ng pagtatakda ng default na protocol,
makita --proto-default para sa mga detalye.

Maaaring gamitin ang opsyong ito kahit ilang beses. Upang kontrolin kung saan nakasulat ang URL na ito,
gamitin ang -o, --output o ang -O, --remote-pangalan mga pagpipilian.

-v, --verbose
Maging mas verbose/talkative sa panahon ng operasyon. Kapaki-pakinabang para sa pag-debug at makita
ano ang nangyayari "sa ilalim ng talukbong". Ang isang linya na nagsisimula sa '>' ay nangangahulugang "data ng header" na ipinadala
sa pamamagitan ng curl, ang '<' ay nangangahulugang "data ng header" na natanggap ng curl na nakatago sa mga normal na kaso,
at ang isang linya na nagsisimula sa '*' ay nangangahulugang karagdagang impormasyon na ibinigay ng curl.

Tandaan na kung gusto mo lamang ng mga header ng HTTP sa output, -ako, --isama maaaring ang
opsyon na hinahanap mo.

Kung sa tingin mo ay hindi pa rin nagbibigay sa iyo ng sapat na mga detalye ang opsyong ito, isaalang-alang ang paggamit
--bakas or --trace-ascii sa halip.

Ino-override ng opsyong ito ang mga nakaraang paggamit ng --trace-ascii or --bakas.

paggamit -oo, --tahimik para patahimikin si curl.

-w, --write-out
Gumawa ng impormasyon ng curl display sa stdout pagkatapos ng isang kumpletong paglipat. Ang pormat ay a
string na maaaring naglalaman ng plain text na may halong anumang bilang ng mga variable. Ang format
maaaring tukuyin bilang literal na "string", o maaari mong ipabasa sa curl ang format mula sa a
file na may "@filename" at upang sabihin kay curl na basahin ang format mula sa stdin na iyong isinulat
"@-".

Ang mga variable na nasa format ng output ay papalitan ng value o text
sa tingin ng kulot na iyon ay angkop, tulad ng inilarawan sa ibaba. Ang lahat ng mga variable ay tinukoy bilang
%{variable_name} at upang mag-output ng isang normal na % isulat mo lang ang mga ito bilang %%. Maaari kang mag-output
isang newline sa pamamagitan ng paggamit ng \n, isang carriage return na may \r at isang tab space na may \t.

TANDAAN: Ang %-symbol ay isang espesyal na simbolo sa win32-environment, kung saan lahat
dapat doblehin ang mga paglitaw ng % kapag ginagamit ang opsyong ito.

Ang mga variable na magagamit ay:

uri_ng nilalaman Ang Uri ng Nilalaman ng hiniling na dokumento, kung mayroon man.

filename_effective
Ang tunay na filename kung saan sinusulatan ng curl. Ito ay lamang
makabuluhan kung sasabihin ang curl na magsulat sa isang file na may --remote-pangalan
or --output opsyon. Ito ay pinakakapaki-pakinabang sa kumbinasyon ng
--remote-header-name opsyon. (Idinagdag sa 7.25.1)

ftp_entry_path Napunta ang paunang path curl noong nag-log in sa remote FTP
server. (Idinagdag sa 7.15.4)

http_code Ang numerical response code na nakita sa huling nakuha
HTTP(S) o FTP(s) transfer. Sa 7.18.2 ang alias response_code ay
idinagdag upang ipakita ang parehong impormasyon.

http_connect Ang numerical code na natagpuan sa huling tugon (mula sa a
proxy) sa isang curl CONNECT na kahilingan. (Idinagdag sa 7.12.4)

local_ip Ang IP address ng lokal na dulo ng pinakakamakailang tapos na koneksyon
- maaaring alinman sa IPv4 o IPv6 (Idinagdag sa 7.29.0)

local_port Ang lokal na numero ng port ng pinakakamakailang ginawang koneksyon (Idinagdag sa
7.29.0)

num_connects Bilang ng mga bagong koneksyon na ginawa sa kamakailang paglilipat. (Idinagdag sa
7.12.3)

num_redirects Bilang ng mga pag-redirect na sinundan sa kahilingan. (Idinagdag sa
7.12.3)

redirect_url Kapag ang isang HTTP na kahilingan ay ginawa nang walang -L upang sundin ang mga pag-redirect, ito
ipapakita ng variable ang aktwal na URL ng isang pag-redirect gusto dalhin ka sa.
(Idinagdag sa 7.18.2)

remote_ip Ang malayong IP address ng pinakahuling ginawang koneksyon - ay maaaring
alinman sa IPv4 o IPv6 (Idinagdag sa 7.29.0)

remote_port Ang remote port number ng pinakakamakailang ginawang koneksyon (Idinagdag
sa 7.29.0)

size_download Ang kabuuang halaga ng mga byte na na-download.

size_header Ang kabuuang halaga ng mga byte ng na-download na mga header.

size_request Ang kabuuang halaga ng mga byte na ipinadala sa kahilingan sa HTTP.

size_upload Ang kabuuang halaga ng mga byte na na-upload.

bilis_pag-download Ang average na bilis ng pag-download na sinukat ng curl para sa kumpletong
download. Mga byte bawat segundo.

bilis_pag-upload Ang average na bilis ng pag-upload na sinukat ng curl para sa kumpletong pag-upload.
Mga byte bawat segundo.

ssl_verify_result
Ang resulta ng pag-verify ng SSL peer certificate noon
hiniling. 0 ay nangangahulugan na ang pag-verify ay matagumpay. (Idinagdag sa
7.19.0)

time_appconnect
Ang oras, sa mga segundo, ay tumagal mula sa simula hanggang sa SSL/SSH/etc
kumonekta/kamay sa remote host ay nakumpleto. (Idinagdag sa
7.19.0)

pagkakakonekta ng oras Ang oras, sa mga segundo, ay tumagal mula sa simula hanggang sa kumonekta ang TCP
sa remote host (o proxy) ay nakumpleto.

time_namelookup
Ang oras, sa mga segundo, tumagal mula sa simula hanggang sa pangalan
natapos ang paglutas.

time_pretransfer
Ang oras, sa mga segundo, ay tumagal mula sa simula hanggang sa paglilipat ng file
magsisimula pa lang. Kabilang dito ang lahat ng pre-transfer command at
negosasyon na tiyak sa partikular na (mga) protocol
kasangkot.

time_redirect Ang oras, sa mga segundo, na kinuha para sa lahat ng mga hakbang sa pag-redirect ay kasama ang pangalan
lookup, kumonekta, pretransfer at ilipat bago ang final
nagsimula ang transaksyon. ipinapakita ng time_redirect ang kumpletong pagpapatupad
oras para sa maraming pag-redirect. (Idinagdag sa 7.12.3)

time_starttransfer
Ang oras, sa mga segundo, ay tumagal mula sa simula hanggang sa unang byte
kakalipat lang. Kabilang dito ang time_pretransfer at
gayundin ang oras na kailangan ng server para kalkulahin ang resulta.

oras_kabuuan Ang kabuuang oras, sa mga segundo, na tumagal ang buong operasyon. Ang oras
ay ipapakita na may millisecond na resolution.

url_effective Ang URL na huling kinuha. Ito ang pinakamakahulugan kung nagawa mo na
sinabi kay curl na sundan ang lokasyon: mga header.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-x, --proxy <[protocol://][user:password@]proxyhost[:port]>
Gamitin ang tinukoy na proxy.

Maaaring tukuyin ang proxy string gamit ang isang protocol:// prefix upang tukuyin ang alternatibo
mga proxy protocol. Gumamit ng socks4://, socks4a://, socks5:// o socks5h:// para humiling ng
tiyak na bersyon ng SOCKS na gagamitin. Walang tinukoy na protocol, http:// at lahat ng iba pa
ay ituturing bilang HTTP proxy. (Ang suporta sa protocol ay idinagdag sa curl 7.21.7)

Kung ang port number ay hindi tinukoy sa proxy string, ito ay ipinapalagay na 1080.

Ino-override ng opsyong ito ang mga kasalukuyang variable ng kapaligiran na nagtatakda ng proxy na gagamitin. Kung
mayroong isang variable ng kapaligiran na nagtatakda ng isang proxy, maaari mong itakda ang proxy sa "" sa
i-override ito.

Ang lahat ng mga operasyon na isinasagawa sa isang HTTP proxy ay magiging malinaw
na-convert sa HTTP. Nangangahulugan ito na ang ilang partikular na protocol na operasyon ay maaaring hindi
magagamit. Ito ay hindi ang kaso kung maaari mong tunnel sa pamamagitan ng proxy, bilang isa sa
ang -p, --proxytunnel pagpipilian.

Ang user at password na maaaring ibigay sa proxy string ay na-decode ng URL
kulot. Binibigyang-daan ka nitong makapasa sa mga espesyal na character tulad ng @ sa pamamagitan ng paggamit ng %40 o pass
sa isang colon na may %3a.

Maaaring tukuyin ang proxy host sa parehong paraan tulad ng proxy environment
mga variable, kabilang ang protocol prefix (http://) at ang naka-embed na user +
password.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-X, --kahilingan
(HTTP) Tumutukoy ng custom na paraan ng kahilingan na gagamitin kapag nakikipag-ugnayan sa HTTP
server. Ang tinukoy na paraan ng kahilingan ay gagamitin sa halip na ang paraan kung hindi man
ginamit (na nagde-default sa GET). Basahin ang detalye ng HTTP 1.1 para sa mga detalye at
mga paliwanag. Kasama sa mga karaniwang karagdagang kahilingan sa HTTP ang PUT at DELETE, ngunit nauugnay
ang mga teknolohiya tulad ng WebDAV ay nag-aalok ng PROPFIND, COPY, MOVE at higit pa.

Karaniwang hindi mo kailangan ang opsyong ito. Lahat ng uri ng GET, HEAD, POST at PUT na kahilingan
sa halip ay hinihimok sa pamamagitan ng paggamit ng mga nakalaang opsyon sa command line.

Binabago lamang ng pagpipiliang ito ang aktwal na salitang ginamit sa kahilingan sa HTTP, hindi nito binabago
baguhin ang paraan ng pag-uugali ng curl. Kaya halimbawa kung gusto mong gumawa ng maayos na HEAD
kahilingan, ang paggamit ng -X HEAD ay hindi sapat. Kailangan mong gamitin ang -ako, --ulo pagpipilian.

Ang method string na itinakda mo sa -X ay gagamitin para sa lahat ng kahilingan, na kung gusto mo
halimbawa ng paggamit -L, --lokasyon maaaring magdulot ng hindi sinasadyang mga side-effects kapag ang curl ay hindi
baguhin ang paraan ng paghiling ayon sa HTTP 30x response code - at katulad nito.

(FTP) Tumutukoy ng custom na FTP command na gagamitin sa halip na LIST kapag gumagawa ng mga listahan ng file
gamit ang FTP.

(POP3) Tumutukoy ng custom na POP3 command na gagamitin sa halip na LIST o RETR. (Idinagdag sa
7.26.0)

(IMAP) Tumutukoy ng custom na IMAP command na gagamitin sa halip na LIST. (Idinagdag noong 7.30.0)

(SMTP) Tumutukoy ng custom na SMTP command na gagamitin sa halip na HELP o VRFY. (Idinagdag sa
7.34.0)

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

--xattr
Kapag nagse-save ng output sa isang file, sinasabi ng opsyong ito sa curl na mag-imbak ng ilang metadata ng file
sa pinalawak na mga katangian ng file. Sa kasalukuyan, ang URL ay nakaimbak sa xdg.origin.url
attribute at, para sa HTTP, ang uri ng content ay nakaimbak sa mime_type attribute. Kung
hindi sinusuportahan ng file system ang mga pinahabang katangian, may babala.

-y, --bilis-oras
Kung ang pag-download ay mas mabagal kaysa sa speed-limit byte bawat segundo sa panahon ng speed-time
panahon, ang pag-download ay maa-abort. Kung gagamitin ang speed-time, ang default na speed-limit
ay magiging 1 maliban kung itakda sa -Y.

Kinokontrol ng opsyong ito ang mga paglilipat at sa gayon ay hindi makakaapekto sa mabagal na pagkonekta atbp. Kung ito
ay isang pag-aalala para sa iyo, subukan ang --connect-timeout pagpipilian.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-Y, --speed-limit
Kung ang isang pag-download ay mas mabagal kaysa sa ibinigay na bilis na ito (sa bytes bawat segundo) para sa bilis ng oras
segundo ito ay naa-abort. ang bilis-oras ay nakatakda sa -y at 30 kung hindi nakatakda.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-z, --time-cond |
(HTTP/FTP) Humiling ng isang file na nabago sa ibang pagkakataon kaysa sa ibinigay na oras at
petsa, o isa na nabago bago ang oras na iyon. Ang ay maaaring maging
lahat ng uri ng mga string ng petsa o kung hindi ito tumutugma sa anumang panloob, ito ay kinuha bilang
isang filename at sinusubukang kunin ang petsa ng pagbabago (mtime) mula sa sa halip. Tingnan mo
ang curl_getdate(3) mga man page para sa mga detalye ng pagpapahayag ng petsa.

Simulan ang expression ng petsa gamit ang isang gitling (-) para humiling ito ng isang dokumento na
mas matanda kaysa sa ibinigay na petsa/oras, ang default ay isang dokumento na mas bago kaysa sa
tinukoy na petsa/oras.

Kung ang pagpipiliang ito ay ginamit nang maraming beses, ang huli ay gagamitin.

-h, --tulong
Tulong sa paggamit. Inililista nito ang lahat ng kasalukuyang opsyon sa command line na may maikling paglalarawan.

-M, --manwal
Manwal. Ipakita ang malaking tulong na teksto.

-V, --versi
Nagpapakita ng impormasyon tungkol sa curl at ang bersyon ng libcurl na ginagamit nito.

Kasama sa unang linya ang buong bersyon ng curl, libcurl at iba pang 3rd party
mga aklatan na naka-link sa executable.

Ang pangalawang linya (nagsisimula sa "Mga Protocol:") ay nagpapakita ng lahat ng mga protocol na nag-uulat ng libcurl
para suportahan.

Ang ikatlong linya (nagsisimula sa "Mga Tampok:") ay nagpapakita ng mga partikular na feature na iniulat ng libcurl
alok. Kasama sa mga available na feature ang:

IPv6 Maaari mong gamitin ang IPv6 dito.

krb4 Krb4 para sa FTP ay suportado.

Ang mga bersyon ng SSL SSL ng iba't ibang mga protocol ay suportado, tulad ng HTTPS, FTPS, POP3S
at iba pa.

libz Ang awtomatikong decompression ng mga naka-compress na file sa HTTP ay sinusuportahan.

Sinusuportahan ang NTLM NTLM authentication.

Debug Gumagamit ang curl na ito ng libcurl na binuo gamit ang Debug. Nagbibigay-daan ito ng higit pang pagsubaybay sa error
at memory debugging atbp. Para sa mga curl-developer lamang!

AsynchDNS
Gumagamit ang curl na ito ng asynchronous name resolves. Ang mga asynchronous na paglutas ng pangalan ay maaaring
tapos gamit ang alinman sa c-ares o ang sinulid na mga solver backend.

Sinusuportahan ang pagpapatunay ng SPNEGO SPNEGO.

Largefile
Sinusuportahan ng curl na ito ang mga paglilipat ng malalaking file, mga file na mas malaki sa 2GB.

IDN Sinusuportahan ng curl na ito ang IDN - mga internasyonal na pangalan ng domain.

GSS-API
Ang GSS-API ay suportado.

SSPI SSPI ay suportado.

TLS-SRP
Ang pagpapatotoo ng SRP (Secure Remote Password) ay sinusuportahan para sa TLS.

Ang suporta sa HTTP2 HTTP/2 ay built-in.

metalink
Sinusuportahan ng curl na ito ang Metalink (parehong bersyon 3 at 4 (RFC 5854)), na
naglalarawan ng mga salamin at hash. curl ay gagamit ng mga salamin para failover kung mayroon
ay mga error (tulad ng hindi available na file o server).

Gumamit ng curl online gamit ang mga serbisyo ng onworks.net