curl - Dalam talian di Awan

JADUAL:

NAMA

curl - pindahkan URL

SINOPSIS

curl [pilihan] [URL...]

DESCRIPTION

curl ialah alat untuk memindahkan data dari atau ke pelayan, menggunakan salah satu protokol yang disokong
(DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP,
RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET dan TFTP). Perintah itu direka untuk berfungsi
tanpa interaksi pengguna.

curl menawarkan banyak bas helah berguna seperti sokongan proksi, pengesahan pengguna, FTP
muat naik, siaran HTTP, sambungan SSL, kuki, resume pemindahan fail, Metalink dan banyak lagi. Sebagai
anda akan lihat di bawah, bilangan ciri akan membuat kepala anda berputar!

curl dikuasakan oleh libcurl untuk semua ciri berkaitan pemindahan. Lihat libcurl(3) untuk maklumat lanjut.

URL

Sintaks URL bergantung pada protokol. Anda akan menemui penerangan terperinci dalam RFC 3986.

Anda boleh menentukan berbilang URL atau bahagian URL dengan menulis set bahagian dalam pendakap seperti dalam:

http://site.{satu,dua,tiga}.com

atau anda boleh mendapatkan urutan siri alfanumerik dengan menggunakan [] seperti dalam:

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

ftp://ftp.numericals.com/file[001-100].txt (dengan sifar pendahuluan)

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

Urutan bersarang tidak disokong, tetapi anda boleh menggunakan beberapa urutan bersebelahan:

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

Anda boleh menentukan sebarang jumlah URL pada baris arahan. Mereka akan diambil dalam a
secara berurutan mengikut susunan yang ditentukan.

Anda boleh menentukan pembilang langkah untuk julat untuk mendapatkan setiap nombor atau huruf N:

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

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

Apabila menggunakan jujukan [] atau {} apabila dipanggil daripada gesaan baris arahan, anda mungkin ada
untuk meletakkan URL penuh dalam petikan berganda untuk mengelakkan cangkerang daripada mengganggunya. ini
juga digunakan untuk watak lain yang dilayan istimewa, seperti contohnya '&', '?' dan '*'.

Sediakan indeks zon IPv6 dalam URL dengan tanda peratusan melarikan diri dan antara muka
nama. Seperti dalam

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

Jika anda menentukan URL tanpa awalan protokol://, curl akan cuba meneka protokol apa
anda mungkin mahu. Ia kemudiannya akan lalai kepada HTTP tetapi mencuba protokol lain berdasarkan yang sering digunakan
awalan nama hos. Contohnya, untuk nama hos bermula dengan "ftp." curl akan menganggap anda
nak cakap FTP.

curl akan melakukan yang terbaik untuk menggunakan perkara yang anda hantar kepadanya sebagai URL. Ia bukan cuba untuk mengesahkannya
sebagai URL yang betul secara sintaksis dengan apa-apa cara tetapi sebaliknya sangat liberal dengan apa itu
menerima.

curl akan cuba menggunakan semula sambungan untuk berbilang pemindahan fail, supaya mendapat banyak
fail dari pelayan yang sama tidak akan melakukan berbilang sambungan / jabat tangan. Ini bertambah baik
kelajuan. Sudah tentu ini hanya dilakukan pada fail yang ditentukan pada satu baris arahan dan tidak boleh
digunakan antara panggilan curl berasingan.

KEMAJUAN METER

curl biasanya memaparkan meter kemajuan semasa operasi, menunjukkan jumlah
data yang dipindahkan, kelajuan pemindahan dan anggaran masa yang tinggal, dsb.

curl memaparkan data ini ke terminal secara lalai, jadi jika anda memanggil curl untuk melakukan
operasi dan ia akan menulis data ke terminal, ia melumpuhkan meter kemajuan sebagai
jika tidak, ia akan mengacaukan output mencampurkan meter kemajuan dan data tindak balas.

Jika anda mahukan meter kemajuan untuk permintaan HTTP POST atau PUT, anda perlu mengubah hala
output respons kepada fail, menggunakan ubah hala shell (>), -o [file] atau serupa.

Ia bukan kes yang sama untuk muat naik FTP kerana operasi itu tidak mengeluarkan sebarang respons
data ke terminal.

Jika anda lebih suka "bar" kemajuan berbanding meter biasa, -# adalah kawan anda.

PILIHAN

Pilihan bermula dengan satu atau dua sengkang. Banyak pilihan memerlukan nilai tambahan seterusnya
kepada mereka.

Bentuk "single-dash" pendek bagi pilihan, -d sebagai contoh, boleh digunakan dengan atau tanpa a
ruang antaranya dan nilainya, walaupun ruang adalah pemisah yang disyorkan. Yang panjang
Borang "double-dash", --data sebagai contoh, memerlukan ruang antaranya dan nilainya.

Pilihan versi pendek yang tidak memerlukan sebarang nilai tambahan boleh digunakan serta-merta seterusnya
antara satu sama lain, seperti contohnya anda boleh menentukan semua pilihan -O, -L dan -v sekaligus sebagai
-OLv.

Secara umum, semua pilihan boolean didayakan dengan --pilihan dan sekali lagi dilumpuhkan dengan
--NO-pilihan. Iaitu, anda menggunakan nama pilihan yang sama tetapi awalan dengan "tidak-".
Walau bagaimanapun, dalam senarai ini kebanyakannya kami hanya menyenaraikan dan menunjukkan versi --option daripada mereka. (Ini
konsep dengan --tiada pilihan ditambahkan dalam 7.19.0. Sebelum ini kebanyakan pilihan telah dihidupkan/dimatikan
pada penggunaan berulang pilihan baris arahan yang sama.)

-#, --bar kemajuan
Jadikan kemajuan paparan curl sebagai bar kemajuan mudah dan bukannya standard, banyak lagi
maklumat, meter.

-:, --seterusnya
Memberitahu curl untuk menggunakan operasi berasingan untuk URL berikut dan berkaitan
pilihan. Ini membolehkan anda menghantar beberapa permintaan URL, masing-masing dengan khusus mereka sendiri
pilihan, contohnya, seperti nama pengguna yang berbeza atau permintaan tersuai untuk setiap satu.
(Ditambah dalam 7.36.0)

-0, --http1.0
(HTTP) Memberitahu curl untuk menggunakan HTTP versi 1.0 dan bukannya menggunakannya secara dalaman
pilihan: HTTP 1.1.

--http1.1
(HTTP) Memberitahu curl untuk menggunakan HTTP versi 1.1. Ini ialah versi lalai dalaman.
(Ditambah dalam 7.33.0)

--http2
(HTTP) Memberitahu curl untuk mengeluarkan permintaannya menggunakan HTTP 2. Ini memerlukan bahawa
libcurl asas dibina untuk menyokongnya. (Ditambah dalam 7.33.0)

--tidak-npn
Lumpuhkan sambungan NPN TLS. NPN didayakan secara lalai jika libcurl dibina dengan
perpustakaan SSL yang menyokong NPN. NPN digunakan oleh libcurl yang menyokong HTTP 2 to
berunding sokongan HTTP 2 dengan pelayan semasa sesi https.

(Ditambah dalam 7.36.0)

--tiada-alpn
Lumpuhkan sambungan ALPN TLS. ALPN didayakan secara lalai jika libcurl dibina
dengan perpustakaan SSL yang menyokong ALPN. ALPN digunakan oleh libcurl yang menyokong
HTTP 2 untuk merundingkan sokongan HTTP 2 dengan pelayan semasa sesi https.

(Ditambah dalam 7.36.0)

-1, --tlsv1
(SSL) Memaksa curl untuk menggunakan TLS versi 1.x apabila berunding dengan pelayan TLS jauh.
Anda boleh menggunakan pilihan --tlsv1.0, --tlsv1.1, dan --tlsv1.2 untuk mengawal versi TLS
dengan lebih tepat (jika bahagian belakang SSL yang digunakan menyokong tahap kawalan sedemikian).

-2, --sslv2
(SSL) Memaksa curl untuk menggunakan SSL versi 2 apabila berunding dengan pelayan SSL jauh.
Kadangkala curl dibina tanpa sokongan SSLv2. SSLv2 secara meluas dianggap tidak selamat
(lihat RFC 6176).

-3, --sslv3
(SSL) Memaksa curl untuk menggunakan SSL versi 3 apabila berunding dengan pelayan SSL jauh.
Kadangkala curl dibina tanpa sokongan SSLv3. SSLv3 secara meluas dianggap tidak selamat
(lihat RFC 7568).

-4, --ipv4
Pilihan ini memberitahu curl untuk menyelesaikan nama kepada alamat IPv4 sahaja, dan bukan sebagai contoh
cuba IPv6.

-6, --ipv6
Pilihan ini memberitahu curl untuk menyelesaikan nama kepada alamat IPv6 sahaja, dan bukan sebagai contoh
cuba IPv4.

-a, --tambah
(FTP/SFTP) Apabila digunakan dalam muat naik, ini menjadikan curl ditambah pada fail sasaran
bukannya menimpanya. Jika fail jauh tidak wujud, ia akan dibuat.
Ambil perhatian bahawa bendera ini diabaikan oleh beberapa pelayan SFTP (termasuk OpenSSH).

-A, --ejen pengguna
(HTTP) Tentukan rentetan Ejen Pengguna untuk dihantar ke pelayan HTTP. Beberapa dilakukan dengan teruk
CGI gagal jika medan ini tidak ditetapkan kepada "Mozilla/4.0". Untuk mengekod tempat kosong dalam rentetan,
kelilingi rentetan dengan tanda petikan tunggal. Ini juga boleh ditetapkan dengan -H,
--kepala pilihan sudah tentu.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--anyauth
(HTTP) Memberitahu curl untuk memikirkan kaedah pengesahan dengan sendirinya, dan menggunakan sepenuhnya
selamatkan satu tapak terpencil yang mendakwa untuk menyokong. Ini dilakukan dengan terlebih dahulu melakukan permintaan
dan menyemak pengepala respons, dengan itu mungkin mendorong rangkaian tambahan pusingan-
perjalanan. Ini digunakan dan bukannya menetapkan kaedah pengesahan tertentu, yang anda
boleh buat dengan --asas, --cerna, --ntlm, dan --berunding.

Ambil perhatian bahawa menggunakan --anyauth tidak disyorkan jika anda melakukan muat naik daripada stdin, kerana ia
mungkin memerlukan data dihantar dua kali dan kemudian pelanggan mesti boleh gulung semula. Jika
keperluan harus timbul apabila memuat naik dari stdin, operasi muat naik akan gagal.

-b, --kuki
(HTTP) Hantar data ke pelayan HTTP sebagai kuki. Ia sepatutnya data
diterima sebelum ini daripada pelayan dalam baris "Set-Cookie:". Data hendaklah dalam
format "NAME1=VALUE1; NAME2=VALUE2".

Jika tiada simbol '=' digunakan dalam baris, ia dianggap sebagai nama fail untuk digunakan untuk membaca
barisan kuki yang disimpan sebelum ini daripada, yang harus digunakan dalam sesi ini jika ia
perlawanan. Menggunakan kaedah ini juga mengaktifkan enjin kuki yang akan membuat curl
rekod kuki masuk juga, yang mungkin berguna jika anda menggunakan ini dalam kombinasi
dengan -L, --lokasi pilihan. Format fail fail untuk membaca kuki daripada
hendaklah pengepala HTTP biasa atau format fail kuki Netscape/Mozilla.

Fail yang dinyatakan dengan -b, --kuki hanya digunakan sebagai input. Tiada kuki akan menjadi
ditulis pada fail. Untuk menyimpan kuki, gunakan -c, --balang biskut pilihan.

Berhati-hati jika anda menggunakan pilihan ini dan beberapa pemindahan mungkin berlaku. Jika
anda menggunakan NAME1=VALUE1; format, atau dalam fail gunakan format Set-Cookie dan jangan
tentukan domain, kemudian kuki dihantar untuk mana-mana domain (walaupun selepas ubah hala
diikuti) dan tidak boleh diubah suai oleh kuki set pelayan. Jika enjin kuki adalah
diaktifkan dan pelayan menetapkan kuki dengan nama yang sama kemudian kedua-duanya akan dihantar pada a
pemindahan masa hadapan ke pelayan itu, mungkin bukan apa yang anda maksudkan. Untuk menangani perkara ini
isu menetapkan domain dalam Set-Cookie (melakukan itu akan termasuk sub-domain) atau menggunakan
Format Netscape.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-B, --use-ascii
(FTP/LDAP) Dayakan pemindahan ASCII. Untuk FTP, ini juga boleh dikuatkuasakan dengan menggunakan an
URL yang berakhir dengan ";type=A". Pilihan ini menyebabkan data yang dihantar ke stdout berada dalam teks
mod untuk sistem win32.

--asas
(HTTP) Memberitahu curl untuk menggunakan pengesahan Asas HTTP dengan hos jauh. Ini adalah
lalai dan pilihan ini biasanya tidak berguna, melainkan anda menggunakannya untuk mengatasi a
pilihan yang ditetapkan sebelum ini yang menetapkan kaedah pengesahan yang berbeza (seperti --ntlm,
--cerna, Atau --berunding).

Digunakan bersama-sama dengan -u, --pengguna and -x, --proksi.

Lihat juga --proksi-asas.

-c, --cookie-jar
(HTTP) Tentukan pada fail yang anda mahu curl untuk menulis semua kuki selepas selesai
operasi. Curl menulis semua kuki yang dibaca sebelum ini daripada fail tertentu serta
semua kuki diterima daripada pelayan jauh. Jika tiada kuki diketahui, tiada data akan
ditulis. Fail akan ditulis menggunakan format fail kuki Netscape. Jika awak
tetapkan nama fail kepada satu sempang, "-", kuki akan ditulis ke stdout.

Pilihan baris arahan ini akan mengaktifkan enjin kuki yang membuat rekod curl dan
gunakan kuki. Cara lain untuk mengaktifkannya adalah dengan menggunakan -b, --kuki pilihan.

Jika balang kuki tidak boleh dibuat atau ditulis, keseluruhan operasi curl tidak akan
gagal atau melaporkan ralat dengan jelas. Menggunakan -v akan mendapat amaran dipaparkan, tetapi
itulah satu-satunya maklum balas yang anda dapat tentang situasi yang mungkin membawa maut ini.

Sejak 7.43.0 kuki yang diimport dalam format Set-Kuki tanpa domain
nama tidak dieksport oleh pilihan ini.

Jika pilihan ini digunakan beberapa kali, nama fail terakhir yang ditentukan akan digunakan.

-C, --sambung-di
Teruskan/Sambung semula pemindahan fail sebelumnya pada offset yang diberikan. Offset yang diberikan ialah
bilangan tepat bait yang akan dilangkau, dikira dari awal bait
fail sumber sebelum ia dipindahkan ke destinasi. Jika digunakan dengan muat naik,
Perintah pelayan FTP SIZE tidak akan digunakan oleh curl.

Gunakan "-C -" untuk memberitahu curl untuk mengetahui secara automatik tempat/cara meneruskan pemindahan.
Ia kemudian menggunakan fail output/input yang diberikan untuk memikirkannya.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--sifir
(SSL) Menentukan sifir yang hendak digunakan dalam sambungan. Senarai sifir mesti
nyatakan sifir yang sah. Baca butiran senarai sifir SSL pada URL ini:
https://www.openssl.org/docs/apps/ciphers.html

Sifir NSS dilakukan secara berbeza daripada OpenSSL dan GnuTLS. Senarai penuh NSS
ciphers berada dalam entri NSSCipherSuite di URL ini:
https://git.fedorahosted.org/cgit/mod_nss.git/plain/docs/mod_nss.html#Directives

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--dimampatkan
(HTTP) Minta respons termampat menggunakan salah satu algoritma sokongan curl, dan
simpan dokumen yang tidak dimampatkan. Jika pilihan ini digunakan dan pelayan menghantar satu
pengekodan tidak disokong, curl akan melaporkan ralat.

--sambung-tamat masa
Masa maksimum dalam saat yang anda benarkan sambungan curl diambil. Ini hanya menghadkan
fasa sambungan, jadi jika curl bersambung dalam tempoh tertentu ia akan berterusan
- jika tidak ia akan keluar. Sejak versi 7.32.0, pilihan ini menerima nilai perpuluhan.

Lihat juga -m, --masa-maks pilihan.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--create-dirs
Apabila digunakan bersama dengan -o pilihan, curl akan mencipta tempatan yang diperlukan
hierarki direktori mengikut keperluan. Pilihan ini mencipta dir yang disebut dengan -o
pilihan, tiada yang lain. Sekiranya -o nama fail tidak menggunakan dir atau jika dir yang disebutnya
sudah wujud, tiada dir akan dibuat.

Untuk membuat direktori jauh apabila menggunakan FTP atau SFTP, cuba --ftp-create-dirs.

--crlf Tukar LF kepada CRLF dalam muat naik. Berguna untuk MVS (OS/390).

(SMTP ditambah dalam 7.40.0)

--crlfile
(HTTPS/FTPS) Sediakan fail menggunakan format PEM dengan Senarai Pembatalan Sijil
yang boleh menentukan sijil rakan sebaya yang akan dianggap dibatalkan.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

(Ditambah dalam 7.19.7)

-d, --data
(HTTP) Menghantar data yang ditentukan dalam permintaan POST ke pelayan HTTP, dalam yang sama
cara yang dilakukan oleh penyemak imbas apabila pengguna telah mengisi borang HTML dan menekan butang
butang hantar. Ini akan menyebabkan curl menghantar data ke pelayan menggunakan
aplikasi jenis kandungan/x-www-form-urlencoded. Bandingkan dengan -F, --bentuk.

-d, --data adalah sama seperti --data-ascii. --data-mentah hampir sama tetapi tidak
mempunyai tafsiran khas tentang watak @. Untuk menghantar data secara binari semata-mata, anda
sebaliknya harus menggunakan --data-perduaan pilihan. Untuk mengekod URL nilai borang
medan yang anda boleh gunakan --data-urlencode.

Jika mana-mana pilihan ini digunakan lebih daripada sekali pada baris arahan yang sama, data
kepingan yang ditentukan akan digabungkan bersama dengan simbol &-pemisah. Oleh itu, menggunakan
'-d name=daniel -d skill=lousy' akan menghasilkan bongkah siaran yang kelihatan seperti itu
'name=daniel&skill=lousy'.

Jika anda memulakan data dengan huruf @, selebihnya hendaklah nama fail untuk membacanya
data daripada, atau - jika anda mahu curl membaca data daripada stdin. Berbilang fail boleh
juga dinyatakan. Menyiarkan data daripada fail bernama 'foobar' akan dilakukan dengan itu
--data @foobar. Apabila --data diberitahu untuk membaca daripada fail seperti itu, carriage kembali
dan baris baharu akan dilucutkan. Jika anda tidak mahu watak @ mempunyai a
penggunaan tafsiran khas --data-mentah sebaliknya.

-D, --dump-header
Tulis tajuk protokol ke fail yang ditentukan.

Pilihan ini berguna untuk digunakan apabila anda ingin menyimpan pengepala tapak HTTP
menghantar kepada anda. Kuki daripada pengepala kemudiannya boleh dibaca dalam lengkung kedua
seruan dengan menggunakan -b, --kuki pilihan! The -c, --balang biskut pilihan adalah
cara yang lebih baik untuk menyimpan kuki.

Apabila digunakan dalam FTP, baris respons pelayan FTP dianggap sebagai "pengepala" dan
dengan itu disimpan di sana.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--data-ascii
Lihat -d, --data.

--data-perduaan
(HTTP) Ini menyiarkan data tepat seperti yang ditentukan tanpa sebarang pemprosesan tambahan.

Jika anda memulakan data dengan huruf @, selebihnya hendaklah nama fail. Data ialah
disiarkan dengan cara yang sama seperti --data-ascii tidak, kecuali baris baharu dan pengangkutan
pulangan dipelihara dan penukaran tidak pernah dilakukan.

Jika pilihan ini digunakan beberapa kali, pilihan yang mengikuti yang pertama akan menambahkan data
seperti yang dijelaskan dalam -d, --data.

--data-mentah
(HTTP) Ini menyiarkan data yang serupa dengan --data tetapi tanpa tafsiran khas
daripada watak @. Lihat -d, --data. (Ditambah dalam 7.43.0)

--data-urlencode
(HTTP) Ini menyiarkan data, serupa dengan pilihan --data yang lain dengan pengecualian itu
ini menjalankan pengekodan URL. (Ditambah dalam 7.18.0)

Untuk mematuhi CGI, bahagian hendaklah dimulakan dengan a nama diikuti oleh a
pemisah dan spesifikasi kandungan. The bahagian boleh diluluskan untuk curl menggunakan
salah satu sintaks berikut:

kandungan
Ini akan menjadikan URL curl mengekod kandungan dan meneruskannya. Sila berhati-hati
supaya kandungan tidak mengandungi sebarang simbol = atau @, seperti yang akan berlaku kemudian
jadikan sintaks sepadan dengan salah satu kes lain di bawah!

= kandungan
Ini akan menjadikan URL curl mengekod kandungan dan meneruskannya. Sebelumnya =
simbol tidak disertakan dalam data.

nama = kandungan
Ini akan menjadikan URL curl mengekod bahagian kandungan dan meneruskannya. Perhatikan bahawa
bahagian nama dijangka sudah dikodkan URL.

@nama fail
Ini akan menjadikan data beban curl daripada fail yang diberikan (termasuk mana-mana baris baharu),
URL-enkodkan data itu dan hantarkannya dalam POST.

nama@nama fail
Ini akan menjadikan data beban curl daripada fail yang diberikan (termasuk mana-mana baris baharu),
Kod URL data itu dan hantarkannya dalam POST. Bahagian nama mendapat sama
tanda dilampirkan, mengakibatkan name=urlencoded-file-content. Perhatikan bahawa nama
dijangka sudah dikodkan URL.

--delegasi TAHAP
Tetapkan LEVEL untuk memberitahu pelayan perkara yang dibenarkan untuk diwakilkan apabila ia datang kepada pengguna
kelayakan. Digunakan dengan GSS/kerberos.

tiada Jangan benarkan sebarang perwakilan.

dasar Mewakilkan jika dan hanya jika bendera OK-AS-DELEGATE ditetapkan dalam Kerberos
tiket perkhidmatan, yang merupakan soal dasar alam.

sentiasa Benarkan pelayan mewakilkan tanpa syarat.

--cerna
(HTTP) Mendayakan pengesahan HTTP Digest. Ini adalah skim pengesahan yang
menghalang kata laluan daripada dihantar melalui wayar dalam teks yang jelas. Gunakan ini dalam
gabungan dengan biasa -u, --pengguna pilihan untuk menetapkan nama pengguna dan kata laluan. Lihat
Juga --ntlm, --berunding and --anyauth untuk pilihan yang berkaitan.

Jika pilihan ini digunakan beberapa kali, hanya yang pertama digunakan.

--disable-eprt
(FTP) Beritahu curl untuk melumpuhkan penggunaan arahan EPRT dan LPRT apabila melakukan aktif
Pemindahan FTP. Curl biasanya akan cuba menggunakan EPRT dahulu, kemudian LPRT
sebelum menggunakan PORT, tetapi dengan pilihan ini, ia akan menggunakan PORT serta-merta. EPRT dan LPRT
adalah sambungan kepada protokol FTP asal, dan mungkin tidak berfungsi pada semua pelayan, tetapi
mereka membolehkan lebih banyak fungsi dengan cara yang lebih baik daripada arahan PORT tradisional.

--eprt boleh digunakan untuk mendayakan EPRT semula secara eksplisit dan --no-eprt adalah alias untuk
--disable-eprt.

Melumpuhkan EPRT hanya mengubah tingkah laku aktif. Jika anda ingin bertukar kepada pasif
mod yang anda tidak perlu gunakan -P, --ftp-port atau paksa dengan --ftp-pasv.

--disable-epsv
(FTP) Beritahu curl untuk melumpuhkan penggunaan arahan EPSV apabila melakukan FTP pasif
pemindahan. Curl selalunya akan cuba menggunakan EPSV sebelum PASV, tetapi
dengan pilihan ini, ia tidak akan cuba menggunakan EPSV.

--epsv boleh digunakan untuk secara eksplisit mendayakan EPSV sekali lagi dan --no-epsv adalah alias untuk
--disable-epsv.

Melumpuhkan EPSV hanya mengubah tingkah laku pasif. Jika anda ingin bertukar kepada aktif
mod yang perlu anda gunakan -P, --ftp-port.

--dns-antara muka
Beritahu curl untuk menghantar permintaan DNS keluar melalui . Pilihan ini ialah a
rakan sejawat kepada --antara muka (yang tidak menjejaskan DNS). Rentetan yang dibekalkan mestilah
nama antara muka (bukan alamat).

Pilihan ini memerlukan libcurl dibina dengan hujung belakang penyelesai yang menyokong
operasi ini. Bahagian belakang c-ares adalah satu-satunya yang sedemikian. (Ditambah dalam 7.33.0)

--dns-ipv4-addr
Beritahu curl untuk mengikat apabila membuat permintaan DNS IPv4, supaya DNS
permintaan berasal dari alamat ini. Hujahnya mestilah alamat IPv4 tunggal.

Pilihan ini memerlukan libcurl dibina dengan hujung belakang penyelesai yang menyokong
operasi ini. Bahagian belakang c-ares adalah satu-satunya yang sedemikian. (Ditambah dalam 7.33.0)

--dns-ipv6-addr
Beritahu curl untuk mengikat apabila membuat permintaan DNS IPv6, supaya DNS
permintaan berasal dari alamat ini. Hujahnya mestilah alamat IPv6 tunggal.

Pilihan ini memerlukan libcurl dibina dengan hujung belakang penyelesai yang menyokong
operasi ini. Bahagian belakang c-ares adalah satu-satunya yang sedemikian. (Ditambah dalam 7.33.0)

--dns-servers
Tetapkan senarai pelayan DNS untuk digunakan dan bukannya lalai sistem. senarai
Alamat IP hendaklah dipisahkan dengan koma. Nombor port juga boleh menjadi pilihan
diberikan sebagai : selepas setiap alamat IP.

Pilihan ini memerlukan libcurl dibina dengan hujung belakang penyelesai yang menyokong
operasi ini. Bahagian belakang c-ares adalah satu-satunya yang sedemikian. (Ditambah dalam 7.33.0)

-e, --perujuk
(HTTP) Menghantar maklumat "Halaman Perujuk" ke pelayan HTTP. Ini pun boleh
ditetapkan dengan -H, --kepala bendera sudah tentu. Apabila digunakan dengan -L, --lokasi anda boleh
tambahkan ";auto" pada URL --referer untuk membuat curl secara automatik menetapkan URL sebelumnya
apabila ia mengikuti pengepala Lokasi:. Rentetan ";auto" boleh digunakan bersendirian, walaupun jika
anda tidak menetapkan permulaan --perujuk.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-E, --sijil
(SSL) Memberitahu curl untuk menggunakan fail sijil klien yang ditentukan apabila mendapatkan fail
dengan HTTPS, FTPS atau protokol berasaskan SSL yang lain. Sijil mestilah dalam PKCS#12
format jika menggunakan Pengangkutan Selamat, atau format PEM jika menggunakan mana-mana enjin lain. Sekiranya
kata laluan pilihan tidak dinyatakan, ia akan ditanya pada terminal. Catatan
bahawa pilihan ini menganggap fail "sijil" yang merupakan kunci peribadi dan
sijil pelanggan bercantum! Lihat --sijil and --kunci untuk menentukan mereka
secara bebas.

Jika curl dibina terhadap perpustakaan SSL NSS maka pilihan ini boleh memberitahu curl
nama panggilan sijil untuk digunakan dalam pangkalan data NSS yang ditakrifkan oleh
pembolehubah persekitaran SSL_DIR (atau secara lalai /etc/pki/nssdb). Jika NSS PEM PKCS#11
modul (libnsspem.so) tersedia kemudian fail PEM mungkin dimuatkan. Kalau nak guna
fail daripada direktori semasa, sila dahului dengan awalan "./", untuk
elakkan kekeliruan dengan nama panggilan. Jika nama panggilan mengandungi ":", ia perlu
didahului dengan "\" supaya ia tidak dikenali sebagai pembatas kata laluan. Sekiranya
nama panggilan mengandungi "\", ia perlu dilepaskan sebagai "\\" supaya ia tidak dikenali
sebagai watak melarikan diri.

(iOS dan Mac OS X sahaja) Jika curl dibina menggunakan Secure Transport, maka
rentetan sijil boleh sama ada nama sijil/kunci peribadi dalam
sistem atau rantai kunci pengguna, atau laluan ke sijil berkod PKCS#12 dan peribadi
kunci. Jika anda ingin menggunakan fail daripada direktori semasa, sila mendahuluinya dengan
Awalan "./", untuk mengelakkan kekeliruan dengan nama panggilan.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--enjin
Pilih enjin kripto OpenSSL untuk digunakan untuk operasi sifir. guna --enjin senarai kepada
mencetak senarai enjin yang disokong masa binaan. Ambil perhatian bahawa tidak semua (atau tiada) daripada
enjin mungkin tersedia pada masa operasi.

--persekitaran
(RISC OS SAHAJA) Menetapkan julat pembolehubah persekitaran, menggunakan nama -w pilihan
menyokong, untuk membolehkan pengekstrakan lebih mudah maklumat berguna selepas menjalankan curl.

--egd-file
(SSL) Tentukan nama laluan kepada soket Daemon Entropy Gathering. Soket adalah
digunakan untuk menyemai enjin rawak untuk sambungan SSL. Lihat juga --rawak-fail
pilihan.

--jangkakan 100-tamat masa
(HTTP) Masa maksimum dalam saat yang anda benarkan curl menunggu selama 100-sambungan
tindak balas apabila curl mengeluarkan pengepala Expects: 100-continue dalam permintaannya. Secara lalai
curl akan menunggu satu saat. Pilihan ini menerima nilai perpuluhan! Apabila curl berhenti
menunggu, ia akan berterusan seolah-olah sambutan telah diterima.

(Ditambah dalam 7.47.0)

--jenis-sijil
(SSL) Memberitahu curl jenis sijil yang terkandung dalam sijil yang disediakan. PEM, DER dan
ENG adalah jenis yang diiktiraf. Jika tidak dinyatakan, PEM diandaikan.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--cacert
(SSL) Memberitahu curl untuk menggunakan fail sijil yang ditentukan untuk mengesahkan rakan sebaya. Fail
mungkin mengandungi berbilang sijil CA. Sijil mestilah dalam format PEM.
Biasanya curl dibina untuk menggunakan fail lalai untuk ini, jadi pilihan ini biasanya
digunakan untuk mengubah fail lalai itu.

curl mengenali pembolehubah persekitaran bernama 'CURL_CA_BUNDLE' jika ia ditetapkan dan
menggunakan laluan yang diberikan sebagai laluan ke himpunan sijil CA. Pilihan ini mengatasi itu
berubah-ubah.

Versi windows curl secara automatik akan mencari fail sijil CA bernama
´curl-ca-bundle.crt´, sama ada dalam direktori yang sama seperti curl.exe, atau dalam Current
Direktori Kerja, atau dalam mana-mana folder di sepanjang PATH anda.

Jika curl dibina pada perpustakaan SSL NSS, modul NSS PEM PKCS#11
(libnsspem.so) perlu tersedia untuk pilihan ini berfungsi dengan betul.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--capath
(SSL) Memberitahu curl untuk menggunakan direktori sijil yang ditentukan untuk mengesahkan rakan sebaya.
Berbilang laluan boleh disediakan dengan memisahkannya dengan ":" (cth
"path1:path2:path3"). Sijil mestilah dalam format PEM dan jika curl dibina
terhadap OpenSSL, direktori mestilah telah diproses menggunakan utiliti c_rehash
dibekalkan dengan OpenSSL. menggunakan --capath boleh membenarkan curl berkuasa OpenSSL untuk membuat SSL-
sambungan jauh lebih cekap daripada menggunakan --cacert jika --cacert fail mengandungi
banyak sijil CA.

Jika pilihan ini ditetapkan, nilai capath lalai akan diabaikan dan jika ia digunakan
beberapa kali, yang terakhir akan digunakan.

--pinnedpubkey
(SSL) Memberitahu curl untuk menggunakan fail kunci awam yang ditentukan (atau cincangan) untuk mengesahkan
rakan sebaya. Ini boleh menjadi laluan ke fail yang mengandungi satu kunci awam dalam PEM atau DER
format, atau sebarang bilangan cincang sha64 yang dikodkan base256 didahului oleh ´sha256//´ dan
dipisahkan oleh ´;´

Apabila merundingkan sambungan TLS atau SSL, pelayan menghantar sijil yang menunjukkan
identitinya. Kunci awam diekstrak daripada sijil ini dan jika tidak
betul-betul sepadan dengan kunci awam yang disediakan untuk pilihan ini, curl akan membatalkan
sambungan sebelum menghantar atau menerima sebarang data.

Ditambah dalam 7.39.0 untuk OpenSSL, GnuTLS dan GSKit. Ditambah dalam 7.43.0 untuk NSS dan
wolfSSL/CyaSSL. sokongan sha256 ditambah dalam 7.44.0 untuk OpenSSL, GnuTLS, NSS dan
wolfSSL/CyaSSL. Bahagian belakang SSL lain tidak disokong.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--status-sijil
(SSL) Memberitahu curl untuk mengesahkan status sijil pelayan dengan menggunakan
Permintaan Status Sijil (aka. OCSP stapling) sambungan TLS.

Jika pilihan ini didayakan dan pelayan menghantar respons yang tidak sah (cth tamat tempoh),
jika respons menunjukkan bahawa sijil pelayan telah dibatalkan, atau tidak
maklum balas sama sekali diterima, pengesahan gagal.

Ini pada masa ini hanya dilaksanakan dalam bahagian belakang OpenSSL, GnuTLS dan NSS. (Tambah
pada tahun 7.41.0)

--permulaan-salah

(SSL) Memberitahu curl untuk menggunakan permulaan palsu semasa jabat tangan TLS. Permulaan palsu ialah mod
di mana pelanggan TLS akan mula menghantar data aplikasi sebelum mengesahkan
mesej Selesai pelayan, dengan itu menjimatkan perjalanan pergi dan balik apabila melakukan penuh
berjabat tangan.

Ini hanya dilaksanakan dalam NSS dan Pengangkutan Selamat (pada iOS 7.0 atau
kemudian, atau OS X 10.9 atau lebih baru) hujung belakang. (Ditambah dalam 7.42.0)

-f, --gagal
(HTTP) Gagal secara senyap (tiada keluaran langsung) pada ralat pelayan. Ini kebanyakannya dilakukan untuk
lebih baik membolehkan skrip dan lain-lain untuk menangani percubaan yang gagal dengan lebih baik. Dalam kes biasa apabila
pelayan HTTP gagal menghantar dokumen, ia mengembalikan dokumen HTML yang menyatakan demikian
(yang sering juga menerangkan mengapa dan banyak lagi). Bendera ini akan menghalang keriting daripada
mengeluarkan itu dan mengembalikan ralat 22.

Kaedah ini tidak selamat gagal dan ada kalanya tindak balas tidak berjaya
kod akan terlepas, terutamanya apabila pengesahan terlibat (kod tindak balas
401 dan 407).

-F, --bentuk
(HTTP) Ini membolehkan curl meniru borang yang telah diisi di mana pengguna telah menekan butang
butang hantar. Ini menyebabkan data melengkung ke POST menggunakan berbilang bahagian/bentuk- Jenis Kandungan
data mengikut RFC 2388. Ini membolehkan muat naik fail binari dsb. Untuk memaksa
bahagian 'kandungan' menjadi fail, awalan nama fail dengan tanda @. Untuk mendapatkan sahaja
bahagian kandungan daripada fail, awalan nama fail dengan simbol <. The
perbezaan antara @ dan < maka @ menjadikan fail dilampirkan dalam siaran sebagai
muat naik fail, manakala < membuat medan teks dan hanya dapatkan kandungan untuk itu
medan teks daripada fail.

Contoh, untuk menghantar fail kata laluan anda ke pelayan, di mana 'kata laluan' ialah nama
medan borang yang / etc / passwd akan menjadi input:

curl -F kata laluan=@/ etc / passwd www.kata laluan saya.com

Untuk membaca kandungan daripada stdin dan bukannya fail, gunakan - sebagai nama fail. Ini berlaku untuk
kedua-dua binaan @ dan <. Malangnya ia tidak menyokong membaca fail daripada a
dinamakan paip atau serupa, kerana ia memerlukan saiz penuh sebelum pemindahan bermula.

Anda juga boleh memberitahu curl jenis Kandungan yang hendak digunakan dengan menggunakan 'type=', dengan cara
sama seperti:

curl -F"[e-mel dilindungi];type=text/html" url.com

or

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

Anda juga boleh menukar secara eksplisit medan nama bahagian muat naik fail dengan menetapkan
nama fail=, seperti ini:

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

Jika nama fail/laluan mengandungi ',' atau ';', ia mesti dipetik dengan petikan berganda seperti:

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

or

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

Ambil perhatian bahawa jika nama fail/laluan dipetik dengan petikan berganda, sebarang petikan berganda atau
garis miring ke belakang dalam nama fail mesti dilepaskan dengan garis miring terbalik.

Lihat contoh dan butiran lanjut dalam MANUAL.

Pilihan ini boleh digunakan beberapa kali.

--ftp-akaun [data]
(FTP) Apabila pelayan FTP meminta "data akaun" selepas nama pengguna dan kata laluan ada
telah disediakan, data ini dihantar menggunakan arahan ACCT. (Ditambah dalam 7.13.0)

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--ftp-alternatif-kepada-pengguna
(FTP) Jika pengesahan dengan arahan USER dan PASS gagal, hantar arahan ini.
Apabila menyambung ke pelayan Pengangkutan Selamat Tumbleweed melalui FTPS menggunakan klien
sijil, menggunakan "SITE AUTH" akan memberitahu pelayan untuk mendapatkan nama pengguna daripada
sijil itu. (Ditambah dalam 7.15.5)

--ftp-create-dirs
(FTP/SFTP) Apabila URL/operasi FTP atau SFTP menggunakan laluan yang tidak pada masa ini
wujud pada pelayan, tingkah laku standard curl adalah gagal. Menggunakan pilihan ini,
curl sebaliknya akan cuba mencipta direktori yang hilang.

--ftp-method [kaedah]
(FTP) Kawal kaedah yang curl harus gunakan untuk mencapai fail pada pelayan FTP(S). The
hujah kaedah harus menjadi salah satu alternatif berikut:

multicwd
curl melakukan operasi CWD tunggal untuk setiap bahagian laluan dalam URL yang diberikan. Untuk
hierarki mendalam ini bermakna sangat banyak arahan. Ini adalah bagaimana RFC 1738 mengatakannya
patut dilakukan. Ini ialah tingkah laku lalai tetapi paling perlahan.

nocwd curl tidak melakukan CWD sama sekali. curl akan melakukan SIZE, RETR, STOR dll dan memberikan penuh
laluan ke pelayan untuk semua arahan ini. Ini adalah tingkah laku terpantas.

singlecwd
curl melakukan satu CWD dengan direktori sasaran penuh dan kemudian beroperasi pada
fail "biasa" (seperti dalam kes multicwd). Ini agak lebih standard
patuh daripada 'nocwd' tetapi tanpa penalti penuh 'multicwd'.

(Ditambah dalam 7.15.1)

--ftp-pasv
(FTP) Gunakan mod pasif untuk sambungan data. Pasif ialah lalai dalaman
tingkah laku, tetapi menggunakan pilihan ini boleh digunakan untuk mengatasi yang sebelumnya -P/-ftp-port
pilihan. (Ditambah dalam 7.11.0)

Jika pilihan ini digunakan beberapa kali, hanya yang pertama digunakan. Membatalkan an
pasif yang dikuatkuasakan sebenarnya tidak boleh dilakukan tetapi sebaliknya anda mesti melaksanakan yang betul
-P, --ftp-port lagi.

Mod pasif bermakna curl akan mencuba arahan EPSV dahulu dan kemudian PASV, melainkan
--disable-epsv digunakan.

--ftp-skip-pasv-ip
(FTP) Beritahu curl untuk tidak menggunakan alamat IP yang dicadangkan oleh pelayan dalam tindak balasnya
arahan PASV curl apabila curl menyambung sambungan data. Sebaliknya curl akan semula
gunakan alamat IP yang sama yang telah digunakan untuk sambungan kawalan. (Ditambah dalam
7.14.2)

Pilihan ini tidak mempunyai kesan jika PORT, EPRT atau EPSV digunakan dan bukannya PASV.

--ftp-pret
(FTP) Beritahu curl untuk menghantar arahan PRET sebelum PASV (dan EPSV). Pelayan FTP tertentu,
terutamanya drftpd, memerlukan arahan bukan standard ini untuk penyenaraian direktori serta
naik dan muat turun dalam mod PASV. (Ditambah dalam 7.20.x)

--ftp-ssl-ccc
(FTP) Gunakan CCC (Clear Command Channel) Tutup lapisan SSL/TLS selepas
mengesahkan. Selebihnya komunikasi saluran kawalan tidak akan disulitkan.
Ini membolehkan penghala NAT mengikuti transaksi FTP. Mod lalai adalah pasif.
Lihat --ftp-ssl-ccc-mod untuk mod lain. (Ditambah dalam 7.16.1)

--ftp-ssl-ccc-mod [aktif/pasif]
(FTP) Gunakan CCC (Clear Command Channel) Menetapkan mod CCC. Mod pasif tidak akan
mulakan penutupan, tetapi sebaliknya tunggu pelayan melakukannya, dan tidak akan membalas
kepada penutupan daripada pelayan. Mod aktif memulakan penutupan dan menunggu
untuk balasan daripada pelayan. (Ditambah dalam 7.16.2)

--ftp-ssl-control
(FTP) Memerlukan SSL/TLS untuk log masuk FTP, kosongkan untuk pemindahan. Membolehkan selamat
pengesahan, tetapi pemindahan data tidak disulitkan untuk kecekapan. Gagal
pindahkan jika pelayan tidak menyokong SSL/TLS. (Ditambah dalam 7.16.0) yang masih boleh
digunakan tetapi akan dialih keluar dalam versi akan datang.

--bentuk-rentetan
(HTTP) Serupa dengan --bentuk kecuali rentetan nilai untuk parameter yang dinamakan ialah
digunakan secara literal. Mendahului aksara '@' dan '<', dan rentetan ';type=' dalam
nilai tidak mempunyai makna khusus. Gunakan ini sebagai keutamaan kepada --bentuk jika ada
kemungkinan nilai rentetan mungkin mencetuskan ciri '@' atau '<' secara tidak sengaja
of --bentuk.

-g, --globoff
Pilihan ini mematikan "penghurai URL globbing". Apabila anda menetapkan pilihan ini, anda
boleh menentukan URL yang mengandungi huruf {}[] tanpa memerlukannya
ditafsirkan oleh curl itu sendiri. Ambil perhatian bahawa huruf ini bukan URL sah biasa
kandungan tetapi ia harus dikodkan mengikut standard URI.

-G, --dapatkan
Apabila digunakan, pilihan ini akan menjadikan semua data ditentukan dengan -d, --data, --data-perduaan
or --data-urlencode untuk digunakan dalam permintaan HTTP GET dan bukannya permintaan POST
yang sebaliknya akan digunakan. Data akan dilampirkan pada URL dengan '?'
pemisah.

Jika digunakan dalam kombinasi dengan -I, data POST sebaliknya akan dilampirkan pada URL
dengan permintaan HEAD.

Jika pilihan ini digunakan beberapa kali, hanya yang pertama digunakan. Ini adalah kerana
membatalkan GET tidak masuk akal, tetapi anda perlu menguatkuasakan
kaedah alternatif yang anda suka.

-H, --pengepala
(HTTP) Pengepala tambahan untuk disertakan dalam permintaan semasa menghantar HTTP ke pelayan. awak
boleh menentukan sebarang bilangan pengepala tambahan. Ambil perhatian bahawa jika anda perlu menambah adat
pengepala yang mempunyai nama yang sama seperti salah satu yang akan digunakan curl dalaman, your
pengepala yang ditetapkan secara luaran akan digunakan dan bukannya yang dalaman. Ini membolehkan anda
membuat perkara yang lebih rumit daripada curl biasanya lakukan. Anda tidak sepatutnya menggantikan
tetapkan pengepala dalaman tanpa mengetahui dengan baik apa yang anda lakukan. Keluarkan an
pengepala dalaman dengan memberikan penggantian tanpa kandungan di sebelah kanan
kolon, seperti dalam: -H "Hos:". Jika anda menghantar pengepala tersuai tanpa nilai maka ia
pengepala mesti ditamatkan dengan koma bertitik, seperti -H "X-Custom-Header;" untuk hantar
"X-Custom-Header:".

curl akan memastikan bahawa setiap pengepala yang anda tambah/ganti dihantar dengan hujung yang betul-
penanda barisan, anda hendaklah demikian tidak tambah itu sebagai sebahagian daripada kandungan pengepala: lakukan
tidak menambah baris baharu atau pemulangan pengangkutan, ia hanya akan mengacaukan keadaan untuk anda.

Lihat juga -A, --ejen-pengguna and -e, --perujuk pilihan.

Bermula pada 7.37.0, anda perlukan --proxy-header untuk menghantar pengepala tersuai bertujuan untuk a
proksi.

Contoh:

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

BERKHATAN :: pengepala yang ditetapkan dengan pilihan ini akan ditetapkan dalam semua permintaan - walaupun selepas itu
ubah hala diikuti, seperti apabila diberitahu dengan -L, --lokasi. Ini boleh membawa kepada
pengepala dihantar ke hos lain daripada hos asal, pengepala jadi sensitif
hendaklah digunakan dengan berhati-hati digabungkan dengan ubah hala berikut.

Pilihan ini boleh digunakan beberapa kali untuk menambah/mengganti/mengalih keluar berbilang pengepala.

--hostpubmd5
(SCP/SFTP) Lulus rentetan yang mengandungi 32 digit heksadesimal. Rentetan itu hendaklah
128 bit MD5 checksum kunci awam hos jauh, curl akan menolak
sambungan dengan hos melainkan md5sums sepadan. (Ditambah dalam 7.17.1)

--abaikan-panjang-kandungan
Untuk HTTP, Abaikan pengepala Panjang Kandungan. Ini amat berguna untuk pelayan
menjalankan Apache 1.x, yang akan melaporkan Panjang Kandungan yang salah untuk fail yang lebih besar
daripada 2 gigabait.

Untuk FTP (sejak 7.46.0), langkau arahan RETR untuk mengetahui saiz sebelum ini
memuat turun fail.

-i, --termasuk
(HTTP) Sertakan pengepala HTTP dalam output. Pengepala HTTP termasuk perkara seperti
nama pelayan, tarikh dokumen, versi HTTP dan banyak lagi...

-Saya, --kepala
(HTTP/FTP/FILE) Ambil pengepala HTTP sahaja! Pelayan HTTP menampilkan arahan HEAD
yang digunakan untuk mendapatkan apa-apa selain pengepala dokumen. Apabila digunakan pada FTP atau
fail FILE, curl memaparkan saiz fail dan masa pengubahsuaian terakhir sahaja.

--antara muka
Lakukan operasi menggunakan antara muka yang ditentukan. Anda boleh memasukkan nama antara muka, IP
alamat atau nama hos. Contoh boleh kelihatan seperti:

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

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-j, --kuki-sesi-sampah
(HTTP) Apabila curl diberitahu untuk membaca kuki daripada fail tertentu, pilihan ini akan membuat
ia membuang semua "kuki sesi". Ini pada asasnya akan mempunyai kesan yang sama seperti jika a
sesi baru dimulakan. Pelayar biasa sentiasa membuang kuki sesi apabila
mereka ditutup.

-J, --nama-pengepala-jauh
(HTTP) Pilihan ini memberitahu -O, --nama-jauh pilihan untuk menggunakan pelayan yang ditentukan
Nama fail Content-Disposition dan bukannya mengekstrak nama fail daripada URL.

Tiada percubaan untuk menyahkod %-jujukan (belum) dalam nama fail yang disediakan, jadi ini
pilihan mungkin memberi anda nama fail yang agak tidak dijangka.

-k, --tidak selamat
(SSL) Pilihan ini secara eksplisit membenarkan curl melakukan sambungan SSL "tidak selamat" dan
pemindahan. Semua sambungan SSL cuba dibuat selamat dengan menggunakan CA
bundle sijil dipasang secara lalai. Ini menjadikan semua sambungan dipertimbangkan
"tidak selamat" gagal melainkan -k, --tidak selamat digunakan.

Lihat sumber dalam talian ini untuk butiran lanjut:
http://curl.haxx.se/docs/sslcerts.html

-K, --config
Tentukan fail konfigurasi untuk membaca argumen curl. Fail konfigurasi ialah teks
fail di mana argumen baris arahan boleh ditulis yang kemudiannya akan digunakan seolah-olah
mereka ditulis pada baris arahan sebenar.

Pilihan dan parameternya mesti dinyatakan pada baris fail konfigurasi yang sama,
dipisahkan oleh ruang putih, bertindih atau tanda sama. Nama pilihan panjang boleh
secara pilihan diberikan dalam fail konfigurasi tanpa tanda sempang berganda awal dan jika ya,
aksara bertindih atau sama boleh digunakan sebagai pemisah. Jika pilihan itu
ditentukan dengan satu atau dua sengkang, tidak boleh ada titik bertindih atau aksara yang sama antara
pilihan dan parameternya.

Jika parameter mengandungi ruang putih, parameter mesti disertakan di dalamnya
petikan. Dalam petikan berganda, urutan pelarian berikut tersedia: \\, \",
\t, \n, \r dan \v. Tanda serong ke belakang sebelum mana-mana huruf lain diabaikan. Jika yang pertama
lajur baris konfigurasi ialah aksara '#', baris selebihnya akan dianggap sebagai
satu komen. Hanya tulis satu pilihan bagi setiap baris fizikal dalam fail konfigurasi.

Tentukan nama fail kepada -K, --config sebagai '-' untuk membuat curl membaca fail dari stdin.

Ambil perhatian bahawa untuk dapat menentukan URL dalam fail konfigurasi, anda perlu menentukannya
menggunakan --url pilihan, dan bukan dengan hanya menulis URL pada barisnya sendiri. Jadi ia
boleh kelihatan serupa dengan ini:

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

Apabila curl dipanggil, ia sentiasa (melainkan -q digunakan) menyemak konfigurasi lalai
fail dan menggunakannya jika dijumpai. Fail konfigurasi lalai disemak dalam perkara berikut
tempat dalam susunan ini:

1) curl cuba mencari "home dir": Ia mula-mula menyemak CURL_HOME dan kemudian
pembolehubah persekitaran HOME. Jika gagal, ia menggunakan getpwuid() pada seperti Unix
sistem (yang mengembalikan dir rumah yang diberikan pengguna semasa dalam sistem anda). hidup
Windows, ia kemudian menyemak pembolehubah APPDATA, atau sebagai pilihan terakhir
'%USERPROFILE%\Data Aplikasi'.

2) Pada tetingkap, jika tiada fail _curlrc dalam dir rumah, ia akan menyemak satu dalam
dir yang sama yang boleh laku curl diletakkan. Pada sistem seperti Unix, ia hanya akan
cuba muatkan .curlrc dari dir rumah yang ditentukan.

# --- Contoh fail ---
# ini adalah ulasan
url = "curl.haxx.se"
output = "curlhere.html"
ejen pengguna = "superagent/1.0"

# dan ambil URL lain juga
url = "curl.haxx.se/docs/manpage.html"
-O
perujuk = "http://nowhereatall.com/"
# --- Akhir fail contoh ---

Pilihan ini boleh digunakan beberapa kali untuk memuatkan berbilang fail konfigurasi.

--keepalive-masa
Pilihan ini menetapkan masa sambungan perlu kekal melahu sebelum menghantar
probe keepalive dan masa antara probe keepalive individu. Ia pada masa ini
berkesan pada sistem pengendalian yang menawarkan soket TCP_KEEPIDLE dan TCP_KEEPINTVL
pilihan (bermaksud Linux, AIX terkini, HP-UX dan banyak lagi). Pilihan ini tidak mempunyai kesan jika
--tidak-terus hidup digunakan. (Ditambah dalam 7.18.0)

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan. Jika tidak dinyatakan,
pilihan lalai kepada 60 saat.

--kunci
(SSL/SSH) Nama fail kunci peribadi. Membolehkan anda memberikan kunci peribadi anda dalam hal ini
fail berasingan. Untuk SSH, jika tidak dinyatakan, curl mencuba calon berikut masuk
pesanan:'~/.ssh/id_rsa','~/.ssh/id_dsa', './id_rsa', './id_dsa'.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--jenis-kunci
(SSL) Jenis fail kunci peribadi. Nyatakan jenis anda --kunci dengan syarat kunci persendirian adalah.
DER, PEM dan ENG disokong. Jika tidak dinyatakan, PEM diandaikan.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--krb
(FTP) Dayakan pengesahan dan penggunaan Kerberos. Tahap mesti dimasukkan dan harus
menjadi salah satu yang 'jelas', 'selamat', 'rahsia' atau 'peribadi'. Sekiranya anda menggunakan tahap
itu bukan salah satu daripada ini, 'peribadi' sebaliknya akan digunakan.

Pilihan ini memerlukan perpustakaan yang dibina dengan sokongan kerberos4. Ini bukan sangat
biasa. guna -V, --versi untuk melihat sama ada keriting anda menyokongnya.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-l, --senarai sahaja
(FTP) Apabila menyenaraikan direktori FTP, suis ini memaksa paparan nama sahaja. Ini adalah
amat berguna jika pengguna ingin menghurai mesin kandungan FTP
direktori kerana paparan direktori biasa tidak menggunakan rupa atau format standard.
Apabila digunakan seperti ini, pilihan menyebabkan arahan NLST dihantar ke pelayan
bukannya LIST.

Nota: Sesetengah pelayan FTP hanya menyenaraikan fail dalam respons mereka kepada NLST; mereka tidak
termasuk sub-direktori dan pautan simbolik.

(POP3) Apabila mendapatkan semula e-mel tertentu daripada POP3, suis ini memaksa LIST
arahan yang perlu dilakukan dan bukannya RETR. Ini amat berguna jika pengguna
ingin melihat sama ada id mesej tertentu wujud pada pelayan dan saiznya.

Nota: Apabila digabungkan dengan -X, --permintaan , pilihan ini boleh digunakan untuk menghantar
arahan UIDL sebaliknya, jadi pengguna boleh menggunakan pengecam unik e-mel
daripada id mesej untuk membuat permintaan. (Ditambah dalam 7.21.5)

-L, --lokasi
(HTTP/HTTPS) Jika pelayan melaporkan bahawa halaman yang diminta telah berpindah ke halaman lain
lokasi (ditunjukkan dengan pengepala Lokasi: dan kod respons 3XX), pilihan ini
akan membuat curl membuat semula permintaan di tempat baharu. Jika digunakan bersama-sama dengan -saya,
--termasuk or -saya, --kepala, pengepala daripada semua halaman yang diminta akan ditunjukkan. Bila
pengesahan digunakan, curl hanya menghantar bukti kelayakannya kepada hos awal. Sekiranya
redirect mengambil curl ke hos yang berbeza, ia tidak akan dapat memintas
pengguna+kata laluan. Lihat juga --lokasi-dipercayai tentang cara mengubah ini. Anda boleh mengehadkan
jumlah ubah hala untuk diikuti dengan menggunakan --maks-redir pilihan.

Apabila curl mengikuti ubah hala dan permintaan itu bukan GET biasa (contohnya POST
atau PUT), ia akan melakukan permintaan berikut dengan GET jika respons HTTP ialah 301,
302, atau 303. Jika kod respons ialah kod 3xx lain, curl akan menghantar semula
permintaan berikut menggunakan kaedah tidak diubah suai yang sama.

Anda boleh memberitahu curl untuk tidak menukar kaedah permintaan bukan GET kepada GET selepas 30x
respons dengan menggunakan pilihan khusus untuk itu: --post301, --post302 and
-post303.

--libcurl
Tambahkan pilihan ini pada mana-mana baris arahan curl biasa, dan anda akan mendapat libcurl-
menggunakan kod sumber C yang ditulis pada fail yang melakukan setara dengan apa yang anda
operasi baris arahan tidak!

Jika pilihan ini digunakan beberapa kali, nama fail terakhir yang diberikan akan digunakan. (Tambah
pada tahun 7.16.1)

--kadar-had
Tentukan kadar pemindahan maksimum yang anda mahu curl gunakan - untuk kedua-dua muat turun dan
muat naik. Ciri ini berguna jika anda mempunyai paip terhad dan anda mahukan anda
pindahkan untuk tidak menggunakan keseluruhan lebar jalur anda. Untuk menjadikannya lebih perlahan daripada sebaliknya
akan menjadi.

Kelajuan yang diberikan diukur dalam bait/saat, melainkan akhiran dilampirkan.
Menambahkan 'k' atau 'K' akan mengira nombor sebagai kilobait, 'm' atau M' menjadikannya
megabait, manakala 'g' atau 'G' menjadikannya gigabait. Contoh: 200K, 3m dan 1G.

Kadar yang diberikan ialah purata kelajuan yang dikira semasa keseluruhan pemindahan. Ia bermaksud
curl itu mungkin menggunakan kelajuan pemindahan yang lebih tinggi dalam letusan pendek, tetapi dari masa ke masa ia digunakan
tidak melebihi kadar yang diberikan.

Jika anda juga menggunakan -Y, --had laju pilihan, pilihan itu akan diutamakan dan
mungkin melumpuhkan sedikit pengehadan kadar, untuk membantu mengekalkan logik had laju
bekerja.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--pelabuhan-tempatan [-bilangan]
Tetapkan nombor pilihan atau julat nombor port tempatan untuk digunakan untuk sambungan.
Ambil perhatian bahawa nombor port secara semula jadi adalah sumber yang terhad yang kadangkala akan sibuk
jadi menetapkan julat ini kepada sesuatu yang terlalu sempit mungkin menyebabkan sambungan yang tidak perlu
kegagalan persediaan. (Ditambah dalam 7.15.2)

--lokasi-dipercayai
(HTTP/HTTPS) Suka -L, --lokasi, tetapi akan membenarkan penghantaran nama + kata laluan kepada semua
hos yang tapak mungkin ubah hala ke. Ini mungkin atau mungkin tidak memperkenalkan keselamatan
melanggar jika tapak tersebut mengubah hala anda ke tapak yang anda akan hantar pengesahan anda
info (yang merupakan plaintext dalam kes pengesahan Asas HTTP).

-m, --masa maks
Masa maksimum dalam saat yang anda benarkan untuk keseluruhan operasi. Ini berguna
untuk menghalang kerja kelompok anda daripada digantung selama berjam-jam kerana rangkaian atau pautan yang perlahan
turun bawah. Sejak 7.32.0, pilihan ini menerima nilai perpuluhan, tetapi yang sebenar
tamat masa akan berkurangan dalam ketepatan apabila tamat masa yang ditentukan meningkat dalam perpuluhan
ketepatan. Lihat juga --sambung-tamat masa pilihan.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--pilihan-log masuk
Nyatakan pilihan log masuk untuk digunakan semasa pengesahan pelayan.

Anda boleh menggunakan pilihan log masuk untuk menentukan pilihan khusus protokol yang boleh digunakan
semasa pengesahan. Pada masa ini hanya pilihan log masuk sokongan IMAP, POP3 dan SMTP.
Untuk maklumat lanjut tentang pilihan log masuk sila lihat RFC 2384, RFC 5092 dan IETF
draf draf-earhart-url-smtp-00.txt (Ditambah dalam 7.34.0).

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--mel-auth
(SMTP) Tentukan satu alamat. Ini akan digunakan untuk menentukan pengesahan
alamat (identiti) mesej yang dihantar yang sedang disampaikan kepada pelayan lain.

(Ditambah dalam 7.25.0)

--mel-daripada
(SMTP) Tentukan satu alamat yang mel yang diberikan harus dihantar.

(Ditambah dalam 7.20.0)

--saiz fail maksimum
Tentukan saiz maksimum (dalam bait) fail untuk dimuat turun. Jika fail yang diminta adalah
lebih besar daripada nilai ini, pemindahan tidak akan bermula dan curl akan kembali dengan keluar
kod 63.

PERHATIAN: Saiz fail tidak selalu diketahui sebelum dimuat turun, dan untuk fail sedemikian ini
pilihan tidak mempunyai kesan walaupun pemindahan fail akhirnya menjadi lebih besar daripada yang diberikan
had. Ini melibatkan pemindahan FTP dan HTTP.

--mel-rcpt
(SMTP) Tentukan satu alamat, nama pengguna atau nama senarai mel.

Semasa melakukan pemindahan mel, penerima harus menyatakan alamat e-mel yang sah
untuk menghantar mel kepada. (Ditambah dalam 7.20.0)

Apabila melakukan pengesahan alamat (arahan VRFY), penerima sepatutnya
dinyatakan sebagai nama pengguna atau nama pengguna dan domain (mengikut Seksyen 3.5 RFC5321).
(Ditambah dalam 7.34.0)

Apabila melaksanakan senarai mel mengembangkan (arahan EXPN), penerima harus
ditentukan menggunakan nama senarai mel, seperti "Rakan" atau "London-Office".
(Ditambah dalam 7.34.0)

--maks-redir
Tetapkan bilangan maksimum ubah hala-pengikut yang dibenarkan. Jika -L, --lokasi digunakan,
pilihan ini boleh digunakan untuk menghalang curl daripada mengikuti ubah hala "dalam absurdum".
Secara lalai, had ditetapkan kepada 50 ubah hala. Tetapkan pilihan ini kepada -1 untuk menjadikannya
tanpa had.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--metalink
Pilihan ini boleh memberitahu curl untuk menghuraikan dan memproses URI yang diberikan sebagai fail Metalink (kedua-duanya
versi 3 dan 4 (RFC 5854) disokong) dan gunakan cermin yang disenaraikan dalam
untuk failover jika terdapat ralat (seperti fail atau pelayan tidak tersedia).
Ia juga akan mengesahkan cincangan fail selepas muat turun selesai. Metalink
fail itu sendiri dimuat turun dan diproses dalam memori dan tidak disimpan dalam fail tempatan
sistem.

Contoh untuk menggunakan fail Metalink jauh:

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

Untuk menggunakan fail Metalink dalam sistem fail tempatan, gunakan protokol FILE (fail://):

curl --metalink file://example.metalink

Sila ambil perhatian bahawa jika protokol FILE dilumpuhkan, tiada cara untuk menggunakan tempatan
Fail Metalink pada masa penulisan ini. Juga ambil perhatian bahawa jika --metalink and
--termasuk digunakan bersama, --termasuk akan diabaikan. Ini kerana termasuk
pengepala dalam respons akan memecahkan penghurai Metalink dan jika pengepala disertakan
dalam fail yang diterangkan dalam fail Metalink, semakan cincang akan gagal.

(Ditambah dalam 7.27.0, jika dibina terhadap perpustakaan libmetalink.)

-n, --netrc
Membuat imbasan keriting .netrc (_netrc pada Windows) fail dalam direktori rumah pengguna
untuk nama log masuk dan kata laluan. Ini biasanya digunakan untuk FTP pada Unix. Jika digunakan dengan
HTTP, curl akan membolehkan pengesahan pengguna. Lihat netrc(5) ftp(1) untuk butiran mengenai
format fail. Curl tidak akan mengadu jika fail itu tidak mempunyai kebenaran yang betul
(ia tidak sepatutnya boleh dibaca oleh dunia atau kumpulan). Pembolehubah persekitaran "HOME"
digunakan untuk mencari direktori rumah.

Contoh yang cepat dan sangat mudah tentang cara menyediakan a .netrc untuk membenarkan curl ke FTP ke
hos mesin.domain.com dengan nama pengguna 'saya' dan kata laluan 'rahsia' sepatutnya
kelihatan serupa dengan:

mesin hos.domain.com log masuk diri saya kata laluan rahsia

-N, --tiada-penampan
Melumpuhkan penimbalan aliran keluaran. Dalam situasi kerja biasa, curl akan
gunakan aliran keluaran buffer standard yang akan mempunyai kesan yang akan dikeluarkan
data dalam ketulan, tidak semestinya tepat apabila data tiba. Menggunakan ini
pilihan akan melumpuhkan penimbalan itu.

Ambil perhatian bahawa ini ialah nama pilihan yang dinafikan yang didokumenkan. Anda boleh menggunakan --penampan kepada
menguatkuasakan penimbalan.

--netrc-file
Pilihan ini serupa dengan --netrc, kecuali anda menyediakan laluan (mutlak atau
relatif) kepada fail netrc yang harus digunakan oleh Curl. Anda hanya boleh menentukan satu netrc
fail setiap seruan. Jika beberapa --netrc-file pilihan disediakan, hanya yang lepas
1 akan digunakan. (Ditambah dalam 7.21.5)

Pilihan ini mengatasi sebarang penggunaan --netrc kerana ia saling eksklusif. Ia akan
turut mematuhi --netrc-pilihan jika dinyatakan.

--netrc-pilihan
Sangat serupa dengan --netrc, tetapi pilihan ini menjadikan penggunaan .netrc pilihan dan tidak
wajib sebagai --netrc pilihan tidak.

--berunding
(HTTP) Membolehkan pengesahan Rundingan (SPNEGO).

Jika anda ingin mendayakan Rundingan (SPNEGO) untuk pengesahan proksi, kemudian gunakan
--proksi-berunding.

Pilihan ini memerlukan perpustakaan yang dibina dengan sokongan GSS-API atau SSPI. guna -V,
--versi untuk melihat sama ada curl anda menyokong GSS-API/SSPI dan SPNEGO.

Apabila menggunakan pilihan ini, anda juga mesti memberikan yang palsu -u, --pengguna pilihan untuk mengaktifkan
kod pengesahan dengan betul. Menghantar '-u :' sudah memadai sebagai nama pengguna dan
kata laluan daripada -u pilihan sebenarnya tidak digunakan.

Jika pilihan ini digunakan beberapa kali, hanya yang pertama digunakan.

--tidak-terus hidup
Melumpuhkan penggunaan mesej keepalive pada sambungan TCP, seperti curl lalai
membolehkan mereka.

Ambil perhatian bahawa ini ialah nama pilihan yang dinafikan yang didokumenkan. Anda boleh menggunakan --keeplive
untuk menguatkuasakan keepalive.

--tiada-sessionid
(SSL) Lumpuhkan penggunaan caching ID sesi SSL oleh curl. Secara lalai semua pemindahan adalah
dilakukan menggunakan cache. Ambil perhatian bahawa walaupun tiada apa-apa yang boleh terluka dengan mencuba
menggunakan semula ID sesi SSL, nampaknya terdapat pelaksanaan SSL yang rosak di alam liar itu
mungkin memerlukan anda untuk melumpuhkan ini agar anda berjaya. (Ditambah dalam 7.16.0)

Ambil perhatian bahawa ini ialah nama pilihan yang dinafikan yang didokumenkan. Anda boleh menggunakan --sessionid
untuk menguatkuasakan cache ID sesi.

--tiada proksi
Senarai hos yang dipisahkan koma yang tidak menggunakan proksi, jika ditentukan. The
hanya kad bebas ialah satu * aksara, yang sepadan dengan semua hos, dan berkesan
melumpuhkan proksi. Setiap nama dalam senarai ini dipadankan sebagai sama ada domain yang
mengandungi nama hos, atau nama hos itu sendiri. Sebagai contoh, local.com akan sepadan
local.com, local.com:80 dan www.local.com, tetapi bukan www.notlocal.com. (Ditambah dalam
7.19.4).

--ntlm (HTTP) Mendayakan pengesahan NTLM. Kaedah pengesahan NTLM direka oleh
Microsoft dan digunakan oleh pelayan web IIS. Ia adalah protokol proprietari, terbalik-
direka bentuk oleh orang yang pandai dan dilaksanakan secara curl berdasarkan usaha mereka. ini
jenis tingkah laku tidak sepatutnya disokong, anda harus menggalakkan semua orang yang menggunakan
NTLM untuk beralih kepada kaedah pengesahan awam dan didokumenkan sebaliknya, seperti
Hadam.

Jika anda ingin mendayakan NTLM untuk pengesahan proksi anda, kemudian gunakan --proksi-ntlm.

Pilihan ini memerlukan perpustakaan yang dibina dengan sokongan SSL. guna -V, --versi untuk melihat jika
keriting anda menyokong NTLM.

Jika pilihan ini digunakan beberapa kali, hanya yang pertama digunakan.

-o, --output
Tulis output ke bukannya stdout. Jika anda menggunakan {} atau [] untuk mengambil
berbilang dokumen, anda boleh menggunakan '#' diikuti dengan nombor dalam penentu.
Pembolehubah itu akan digantikan dengan rentetan semasa untuk URL yang diambil.
Seperti dalam:

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

atau gunakan beberapa pembolehubah seperti:

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

Anda boleh menggunakan pilihan ini seberapa banyak bilangan URL yang anda miliki.

Lihat juga --create-dirs pilihan untuk mencipta direktori tempatan secara dinamik.
Menentukan output sebagai '-' (sengkang tunggal) akan memaksa output dilakukan ke
stdout.

-O, --nama-jauh
Tulis output ke fail tempatan bernama seperti fail jauh yang kami dapat. (Hanya bahagian fail
daripada fail jauh digunakan, laluan terputus.)

Nama fail jauh untuk digunakan untuk menyimpan diekstrak daripada URL yang diberikan, tiada apa-apa
lain.

Akibatnya, fail akan disimpan dalam direktori kerja semasa. Jika awak
mahu fail disimpan dalam direktori lain, pastikan anda menukar kerja semasa
direktori sebelum anda menggunakan curl dengan -O, --nama-jauh bendera!

Tiada penyahkodan URL dilakukan pada nama fail. Jika ia mempunyai %20 atau URL lain yang dikodkan
bahagian nama, mereka akan berakhir apa adanya sebagai nama fail.

Anda boleh menggunakan pilihan ini seberapa banyak bilangan URL yang anda miliki.

--oauth2-pembawa
(IMAP, POP3, SMTP) Tentukan Token Pembawa untuk pengesahan pelayan OAUTH 2.0.
Token Pembawa digunakan bersama dengan nama pengguna yang boleh ditentukan
sebagai sebahagian daripada --url or -u, --pengguna pilihan.

Token Pembawa dan nama pengguna diformatkan mengikut RFC 6750.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--proxy-header
(HTTP) Pengepala tambahan untuk disertakan dalam permintaan apabila menghantar HTTP kepada proksi. Anda boleh
nyatakan sebarang bilangan pengepala tambahan. Ini adalah pilihan yang setara dengan -H, --kepala
tetapi untuk komunikasi proksi sahaja seperti dalam permintaan CONNECT apabila anda mahu a
pengepala berasingan dihantar kepada proksi kepada apa yang dihantar ke hos jauh sebenar.

curl akan memastikan bahawa setiap pengepala yang anda tambah/ganti dihantar dengan hujung yang betul-
penanda barisan, anda hendaklah demikian tidak tambah itu sebagai sebahagian daripada kandungan pengepala: lakukan
tidak menambah baris baharu atau pemulangan pengangkutan, ia hanya akan mengacaukan keadaan untuk anda.

Pengepala yang ditentukan dengan pilihan ini tidak akan disertakan dalam permintaan yang diketahui curl
tidak akan dihantar kepada proksi.

Pilihan ini boleh digunakan beberapa kali untuk menambah/mengganti/mengalih keluar berbilang pengepala.

(Ditambah dalam 7.37.0)

-p, --proxytunnel
Apabila proksi HTTP digunakan (-x, --proksi), pilihan ini akan menyebabkan protokol bukan HTTP
untuk cuba membuat terowong melalui proksi dan bukannya hanya menggunakannya untuk melakukan seperti HTTP
operasi. Pendekatan terowong dibuat dengan permintaan CONNECT proksi HTTP dan
memerlukan proksi membenarkan sambungan terus ke nombor port terpencil yang dikehendaki
untuk terowong melalui ke.

-P, --ftp-port
(FTP) Membalikkan peranan pemula/pendengar lalai apabila menyambung dengan FTP. ini
suis menjadikan curl menggunakan mod aktif. Dalam amalan, curl kemudian memberitahu pelayan untuk
sambung kembali ke alamat dan port yang ditentukan pelanggan, sementara mod pasif bertanya
pelayan untuk menyediakan alamat IP dan port untuk disambungkan. sepatutnya
menjadi salah satu daripada:

antara muka
iaitu "eth0" untuk menentukan alamat IP antara muka yang anda mahu gunakan (Unix
sahaja)

Alamat IP
iaitu "192.168.10.1" untuk menentukan alamat IP yang tepat

nama hos
iaitu "my.host.domain" untuk menentukan mesin

- buat curl memilih alamat IP yang sama yang telah digunakan untuk kawalan
sambungan

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan. Lumpuhkan penggunaan
PELABUHAN dengan --ftp-pasv. Lumpuhkan percubaan untuk menggunakan arahan EPRT dan bukannya PORT
dengan menggunakan --disable-eprt. EPRT memang PORT++.

Bermula pada 7.19.5, anda boleh menambahkan ":[start]-[end]" di sebelah kanan alamat, untuk
beritahu curl julat port TCP yang hendak digunakan. Ini bermakna anda menentukan julat port, daripada a
lebih rendah kepada nombor yang lebih tinggi. Satu nombor juga berfungsi, tetapi ambil perhatian bahawa ia
meningkatkan risiko kegagalan kerana pelabuhan mungkin tidak tersedia.

--lulus
(SSL/SSH) Ungkapan laluan untuk kunci persendirian

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--laluan-seperti-adalah
Beritahu curl untuk tidak mengendalikan urutan /../ or /./ dalam laluan URL yang diberikan. Biasalah
curl akan meremukkan atau menggabungkannya mengikut piawaian tetapi dengan pilihan ini menetapkan anda
suruh jangan buat macam tu.

(Ditambah dalam 7.42.0)

--post301
(HTTP) Memberitahu curl untuk menghormati RFC 7230/6.4.2 dan tidak menukar permintaan POST kepada GET
permintaan apabila mengikuti ubah hala 301. Tingkah laku bukan RFC terdapat di mana-mana
pelayar web, jadi curl melakukan penukaran secara lalai untuk mengekalkan konsistensi.
Walau bagaimanapun, pelayan mungkin memerlukan POST untuk kekal sebagai POST selepas pengalihan tersebut.
Pilihan ini bermakna hanya apabila menggunakan -L, --lokasi (Ditambah dalam 7.17.1)

--post302
(HTTP) Memberitahu curl untuk menghormati RFC 7230/6.4.3 dan tidak menukar permintaan POST kepada GET
permintaan apabila mengikuti ubah hala 302. Tingkah laku bukan RFC terdapat di mana-mana
pelayar web, jadi curl melakukan penukaran secara lalai untuk mengekalkan konsistensi.
Walau bagaimanapun, pelayan mungkin memerlukan POST untuk kekal sebagai POST selepas pengalihan tersebut.
Pilihan ini bermakna hanya apabila menggunakan -L, --lokasi (Ditambah dalam 7.19.1)

--post303
(HTTP) Memberitahu curl untuk menghormati RFC 7230/6.4.4 dan tidak menukar permintaan POST kepada GET
permintaan apabila mengikuti ubah hala 303. Tingkah laku bukan RFC terdapat di mana-mana
pelayar web, jadi curl melakukan penukaran secara lalai untuk mengekalkan konsistensi.
Walau bagaimanapun, pelayan mungkin memerlukan POST untuk kekal sebagai POST selepas pengalihan tersebut.
Pilihan ini bermakna hanya apabila menggunakan -L, --lokasi (Ditambah dalam 7.26.0)

--proto
Memberitahu curl untuk menggunakan protokol yang disenaraikan untuk mendapatkan semula awalnya. Protokol adalah
dinilai dari kiri ke kanan, dipisahkan koma, dan setiap satu nama protokol atau
'semua', secara pilihan diawali dengan sifar atau lebih pengubah suai. Pengubah suai yang tersedia ialah:

+ Benarkan protokol ini sebagai tambahan kepada protokol yang telah dibenarkan (ini ialah
lalai jika tiada pengubah digunakan).

- Tolak protokol ini, alih keluarnya daripada senarai protokol yang telah dibenarkan.

= Benarkan protokol ini sahaja (mengabaikan senarai yang telah dibenarkan), walaupun tertakluk
kepada pengubahsuaian kemudian dengan entri berikutnya dalam senarai dipisahkan koma.

Sebagai contoh:

--proto -ftps menggunakan protokol lalai, tetapi melumpuhkan ftps

--proto -semua,https+http
hanya mendayakan http dan https

--proto =http,https
juga hanya mendayakan http dan https

Protokol yang tidak diketahui menghasilkan amaran. Ini membolehkan skrip selamat bergantung pada wujud
dapat melumpuhkan protokol yang berpotensi berbahaya, tanpa bergantung pada sokongan untuk
protokol itu dibina ke dalam curl untuk mengelakkan ralat.

Pilihan ini boleh digunakan beberapa kali, dalam hal ini kesannya adalah sama seperti
menggabungkan protokol ke dalam satu contoh pilihan.

(Ditambah dalam 7.20.2)

--proto-lalai
Memberitahu curl untuk digunakan protokol untuk mana-mana URL yang tiada nama skema.

Contoh:

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

Protokol yang tidak diketahui atau tidak disokong menyebabkan ralat CURLE_UNSUPPORTED_PROTOCOL.

Pilihan ini tidak mengubah protokol proksi lalai (http).

Tanpa pilihan ini curl akan membuat tekaan berdasarkan hos, lihat --url untuk maklumat lanjut.

(Ditambah dalam 7.45.0)

--proto-redir
Memberitahu curl untuk menggunakan protokol yang disenaraikan pada ubah hala. Lihat --proto untuk mengetahui cara protokol
diwakili.

Contoh:

--proto-redir -semua,http,https
Benarkan hanya HTTP dan HTTPS pada ubah hala.

Secara lalai curl akan membenarkan semua protokol pada ubah hala kecuali beberapa dilumpuhkan untuk keselamatan
sebab: Memandangkan 7.19.4 FILE dan SCP dilumpuhkan, dan sejak 7.40.0 SMB dan SMBS juga
kurang upaya. Menentukan semua or +semua membolehkan semua protokol pada ubah hala, termasuk yang
dilumpuhkan untuk keselamatan.

(Ditambah dalam 7.20.2)

--proksi-anyauth
Memberitahu curl untuk memilih kaedah pengesahan yang sesuai apabila berkomunikasi dengan
diberi proksi. Ini mungkin menyebabkan permintaan tambahan/tindak balas pergi balik. (Ditambah dalam
7.13.2)

--proksi-asas
Memberitahu curl untuk menggunakan pengesahan Asas HTTP apabila berkomunikasi dengan yang diberikan
proksi. guna --asas untuk mendayakan HTTP Basic dengan hos jauh. Asas ialah lalai
kaedah pengesahan curl menggunakan dengan proksi.

--proksi-cerna
Memberitahu curl untuk menggunakan pengesahan HTTP Digest apabila berkomunikasi dengan yang diberikan
proksi. guna --cerna untuk mendayakan HTTP Digest dengan hos jauh.

--proksi-berunding
Memberitahu curl untuk menggunakan pengesahan HTTP Negotiate (SPNEGO) apabila berkomunikasi dengan
proksi yang diberikan. guna --berunding untuk membolehkan HTTP Runding (SPNEGO) dengan alat kawalan jauh
tuan rumah. (Ditambah dalam 7.17.1)

--proksi-ntlm
Memberitahu curl untuk menggunakan pengesahan NTLM HTTP apabila berkomunikasi dengan proksi yang diberikan.
Penggunaan --ntlm untuk mendayakan NTLM dengan hos jauh.

--proxy-service-name
Pilihan ini membolehkan anda menukar nama perkhidmatan untuk rundingan proksi.

Contoh: --proxy-negotiate proxy-name --proxy-service-name sockd akan gunakan
sockd/nama-proksi. (Ditambah dalam 7.43.0).

--proksi1.0
Gunakan proksi HTTP 1.0 yang ditentukan. Jika nombor port tidak dinyatakan, ia adalah
diandaikan pada port 1080.

Satu-satunya perbezaan antara ini dan pilihan proksi HTTP (-x, --proksi), ialah
percubaan untuk menggunakan CONNECT melalui proksi akan menentukan protokol HTTP 1.0 sebaliknya
daripada HTTP lalai 1.1.

--pubkey
(SSH) Nama fail kunci awam. Membenarkan anda memberikan kunci awam anda dalam bahagian berasingan ini
fail.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

(Sehingga 7.39.0, curl cuba untuk mengekstrak kunci awam secara automatik daripada
fail kunci peribadi, jadi lulus pilihan ini biasanya tidak diperlukan. Perhatikan bahawa ini
pengekstrakan kunci awam memerlukan libcurl dipautkan dengan salinan libssh2 1.2.8
atau lebih tinggi yang dikaitkan dengan OpenSSL.)

-q Jika digunakan sebagai parameter pertama pada baris arahan, the curlrc fail konfigurasi tidak akan
dibaca dan digunakan. Lihat -K, --config untuk butiran mengenai fail konfigurasi lalai
laluan carian.

-Q, --petikan
(FTP/SFTP) Hantar arahan sewenang-wenangnya ke pelayan FTP atau SFTP jauh. petikan
arahan dihantar SEBELUM pemindahan berlaku (sejurus selepas PWD awal
arahan dalam pemindahan FTP, tepatnya). Untuk membuat arahan berlaku selepas a
pemindahan berjaya, awalan mereka dengan sempang '-'. Untuk membuat arahan dihantar selepas
curl telah menukar direktori kerja, sejurus sebelum arahan pemindahan, awalan
arahan dengan '+' (ini hanya disokong untuk FTP). Anda boleh menentukan sebarang nombor
daripada perintah. Jika pelayan mengembalikan kegagalan untuk salah satu arahan, keseluruhannya
operasi akan dibatalkan. Anda mesti menghantar arahan FTP yang betul secara sintaksis sebagai RFC
959 mentakrifkan kepada pelayan FTP, atau salah satu daripada arahan yang disenaraikan di bawah untuk pelayan SFTP.
Pilihan ini boleh digunakan beberapa kali. Apabila bercakap dengan pelayan FTP, awalan
arahan dengan asterisk (*) untuk membuat curl diteruskan walaupun arahan itu gagal seperti oleh
curl lalai akan berhenti pada kegagalan pertama.

SFTP ialah protokol binari. Tidak seperti untuk FTP, curl mentafsir arahan petikan SFTP
sendiri sebelum menghantarnya ke pelayan. Nama fail boleh dipetik dengan gaya shell
benamkan ruang atau aksara khas. Berikut ialah senarai semua SFTP yang disokong
perintah petikan:

fail kumpulan chgrp
Perintah chgrp menetapkan ID kumpulan fail yang dinamakan oleh operan fail kepada
ID kumpulan yang ditentukan oleh operan kumpulan. Operan kumpulan ialah perpuluhan
ID kumpulan integer.

fail mod chmod
Perintah chmod mengubah suai bit mod fail bagi fail yang ditentukan. The
operan mod ialah nombor mod integer oktal.

fail pengguna chown
Perintah chown menetapkan pemilik fail yang dinamakan oleh operan fail kepada
ID pengguna yang ditentukan oleh operan pengguna. Operan pengguna ialah perpuluhan
ID pengguna integer.

Dalam fail_sumber_fail_target
Perintah ln dan symlink mencipta pautan simbolik di target_file
lokasi menunjuk ke lokasi source_file.

nama_direktori mkdir
Perintah mkdir mencipta direktori yang dinamakan oleh operan directory_name.

pwd Perintah pwd mengembalikan nama laluan mutlak kerja semasa
direktori.

menamakan semula sasaran sumber
Perintah rename menamakan semula fail atau direktori yang dinamakan oleh operan sumber
ke laluan destinasi yang dinamakan oleh operan sasaran.

fail rm
Perintah rm mengalih keluar fail yang ditentukan oleh operan fail.

direktori rmdir
Perintah rmdir mengalih keluar masukan direktori yang ditentukan oleh direktori
operan, dengan syarat ia kosong.

symlink source_file target_file
Lihat ln.

-r, --julat
(HTTP/FTP/SFTP/FILE) Dapatkan julat bait (iaitu dokumen separa) daripada
HTTP/1.1, pelayan FTP atau SFTP atau FILE setempat. Julat boleh ditentukan dalam nombor
cara.

0-499 menentukan 500 bait pertama

500-999 menentukan 500 bait kedua

-500 menentukan 500 bait terakhir

9500- menentukan bait dari offset 9500 dan ke hadapan

0-0,-1 menentukan bait pertama dan terakhir sahaja(*)(HTTP)

100-199,500-599
menentukan dua julat 100-bait yang berasingan(*) (HTTP)

(*) = CATATAN bahawa ini akan menyebabkan pelayan membalas dengan respons berbilang bahagian!

Hanya aksara digit (0-9) yang sah dalam medan 'mula' dan 'berhenti'
sintaks julat 'mula-henti'. Jika aksara bukan digit diberikan dalam julat, the
respons pelayan tidak akan ditentukan, bergantung pada konfigurasi pelayan.

Anda juga harus sedar bahawa banyak pelayan HTTP/1.1 tidak mempunyai ciri ini
didayakan, supaya apabila anda cuba mendapatkan julat, sebaliknya anda akan mendapat keseluruhannya
dokumen.

Muat turun julat FTP dan SFTP hanya menyokong sintaks 'mula-henti' yang mudah
(sebagai pilihan dengan salah satu nombor ditinggalkan). Penggunaan FTP bergantung pada FTP lanjutan
perintah SIZE.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-R, --masa jauh
Apabila digunakan, ini akan membuat percubaan curl untuk mengetahui cap masa alat kawalan jauh
fail, dan jika itu tersedia, jadikan fail tempatan mendapat cap masa yang sama.

--rawak-fail
(SSL) Tentukan nama laluan ke fail yang mengandungi perkara yang akan dianggap sebagai rawak
data. Data digunakan untuk menyemai enjin rawak untuk sambungan SSL. Lihat juga
--egd-fail pilihan.

--raw (HTTP) Apabila digunakan, ia melumpuhkan semua penyahkodan HTTP dalaman bagi kandungan atau pemindahan
pengekodan dan sebaliknya menjadikannya diteruskan tanpa diubah, mentah. (Ditambah dalam 7.16.2)

--nama-jauh-semua
Pilihan ini mengubah tindakan lalai untuk semua URL yang diberikan untuk ditangani seolah-olah
-O, --nama-jauh digunakan untuk setiap satu. Jadi jika anda ingin melumpuhkan itu untuk a
URL tertentu selepas --nama-jauh-semua telah digunakan, anda mesti menggunakan "-o -" atau --tidak-
nama jauh. (Ditambah dalam 7.19.0)

--selesaikan
Sediakan alamat tersuai untuk pasangan hos dan port tertentu. Menggunakan ini, anda boleh
buat permintaan curl menggunakan alamat yang ditentukan dan cegah sebaliknya
alamat biasa diselesaikan untuk digunakan. Pertimbangkan ia semacam / Etc / tuan rumah alternatif
disediakan pada baris arahan. Nombor port hendaklah nombor yang digunakan untuk
protokol khusus yang akan digunakan oleh hos. Ini bermakna anda memerlukan beberapa entri jika
anda ingin memberikan alamat untuk hos yang sama tetapi pelabuhan yang berbeza.

Pilihan ini boleh digunakan berkali-kali untuk menambah banyak nama hos untuk diselesaikan.

(Ditambah dalam 7.21.3)

--cuba semula
Jika ralat sementara dikembalikan apabila curl cuba melakukan pemindahan, ia akan
cuba semula beberapa kali ini sebelum berputus asa. Menetapkan nombor kepada 0 menjadikan curl berfungsi
tiada percubaan semula (iaitu lalai). Ralat sementara bermaksud sama ada: tamat masa, FTP
kod respons 4xx atau kod respons HTTP 5xx.

Apabila curl hendak mencuba semula pemindahan, ia akan menunggu satu saat dahulu dan kemudian untuk
semua percubaan semula yang akan datang ia akan menggandakan masa menunggu sehingga mencapai 10 minit
yang kemudiannya akan menjadi kelewatan antara percubaan semula yang lain. Dengan menggunakan --cuba semula-
kelewatan anda melumpuhkan algoritma backoff eksponen ini. Lihat juga --cuba semula-masa-maks kepada
hadkan jumlah masa yang dibenarkan untuk percubaan semula. (Ditambah dalam 7.12.3)

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--cuba semula-penangguhan
Buat tidur keriting dalam jumlah masa ini sebelum setiap percubaan semula apabila pemindahan gagal
dengan ralat sementara (ia menukar algoritma masa mundur lalai antara
cuba semula). Pilihan ini hanya menarik jika --cuba semula juga digunakan. Menetapkan ini
kelewatan kepada sifar akan menjadikan curl menggunakan masa mundur lalai. (Ditambah dalam 7.12.3)

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--cuba semula-masa-maks
Pemasa cuba semula ditetapkan semula sebelum percubaan pemindahan pertama. Percubaan semula akan dilakukan sebagai
biasa (lihat --cuba semula) selagi pemasa belum mencapai had yang diberikan ini. Notis
bahawa jika pemasa belum mencapai had, permintaan akan dibuat dan sementara
berprestasi, ia mungkin mengambil masa lebih lama daripada tempoh masa yang diberikan ini. Untuk menghadkan satu
masa maksimum permintaan, gunakan -m, --masa-maks. Tetapkan pilihan ini kepada sifar kepada tidak tamat masa
mencuba semula. (Ditambah dalam 7.12.3)

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-s, --senyap
Mod senyap atau senyap. Jangan tunjukkan meter kemajuan atau mesej ralat. Membuat Keriting
bisu. Ia masih akan mengeluarkan data yang anda minta, bahkan berpotensi ke
terminal/stdout melainkan anda mengubah halanya.

--sasl-ir
Dayakan respons awal dalam pengesahan SASL. (Ditambah dalam 7.31.0)

--nama-perkhidmatan
Pilihan ini membolehkan anda menukar nama perkhidmatan untuk SPNEGO.

Contoh: --berunding --nama-perkhidmatan sockd akan menggunakan sockd/server-name. (Ditambah dalam
7.43.0).

-S, --tunjuk-ralat
Apabila digunakan dengan -s ia menjadikan curl menunjukkan mesej ralat jika ia gagal.

--ssl (FTP, POP3, IMAP, SMTP) Cuba gunakan SSL/TLS untuk sambungan. Berbalik kepada bukan-
sambungan selamat jika pelayan tidak menyokong SSL/TLS. Lihat juga --ftp-ssl-
kawalan and --ssl-reqd untuk tahap penyulitan yang berbeza diperlukan. (Ditambah dalam
7.20.0)

Pilihan ini dahulunya dikenali sebagai --ftp-ssl (Ditambah dalam 7.11.0). Nama pilihan itu boleh
masih digunakan tetapi akan dialih keluar dalam versi akan datang.

--ssl-reqd
(FTP, POP3, IMAP, SMTP) Memerlukan SSL/TLS untuk sambungan. Menamatkan
sambungan jika pelayan tidak menyokong SSL/TLS. (Ditambah dalam 7.20.0)

Pilihan ini dahulunya dikenali sebagai --ftp-ssl-reqd (ditambah dalam 7.15.5). Pilihan itu
nama masih boleh digunakan tetapi akan dialih keluar dalam versi akan datang.

--ssl-benarkan-binatang
(SSL) Pilihan ini memberitahu curl untuk tidak mengatasi kecacatan keselamatan dalam SSL3 dan
Protokol TLS1.0 yang dikenali sebagai BEAST. Jika pilihan ini tidak digunakan, lapisan SSL boleh digunakan
penyelesaian yang diketahui menyebabkan masalah saling kendali dengan beberapa SSL lama
pelaksanaan. AMARAN: pilihan ini melonggarkan keselamatan SSL, dan dengan menggunakan ini
bendera yang anda minta untuk itu. (Ditambah dalam 7.25.0)

--ssl-tidak-membatalkan
(WinSSL) Pilihan ini memberitahu curl untuk melumpuhkan semakan pembatalan sijil. AMARAN:
pilihan ini melonggarkan keselamatan SSL, dan dengan menggunakan bendera ini anda meminta dengan tepat
itu. (Ditambah dalam 7.44.0)

--stokin4
Gunakan proksi SOCKS4 yang ditentukan. Jika nombor port tidak dinyatakan, ia diandaikan
pada port 1080. (Ditambah dalam 7.15.2)

Pilihan ini mengatasi sebarang penggunaan sebelumnya -x, --proksi, kerana mereka bersama
eksklusif.

Sejak 7.21.7, pilihan ini tidak diperlukan kerana anda boleh menentukan proksi socks4 dengannya
-x, --proksi menggunakan awalan protokol socks4://.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--stokin4a
Gunakan proksi SOCKS4a yang ditentukan. Jika nombor port tidak dinyatakan, ia diandaikan
pada port 1080. (Ditambah dalam 7.18.0)

Pilihan ini mengatasi sebarang penggunaan sebelumnya -x, --proksi, kerana mereka bersama
eksklusif.

Sejak 7.21.7, pilihan ini tidak diperlukan kerana anda boleh menentukan proksi socks4a dengannya
-x, --proksi menggunakan awalan protokol socks4a://.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--socks5-nama hos
Gunakan proksi SOCKS5 yang ditentukan (dan biarkan proksi menyelesaikan nama hos). Sekiranya
nombor port tidak dinyatakan, ia diandaikan pada port 1080. (Ditambah dalam 7.18.0)

Pilihan ini mengatasi sebarang penggunaan sebelumnya -x, --proksi, kerana mereka bersama
eksklusif.

Sejak 7.21.7, pilihan ini tidak diperlukan kerana anda boleh menentukan nama hos socks5
proksi dengan -x, --proksi menggunakan awalan protokol socks5h://.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan. (Pilihan ini ialah
didokumenkan secara salah sebelum ini dan digunakan sebagai --stokin tanpa nombor yang dilampirkan.)

--stokin5
Gunakan proksi SOCKS5 yang ditentukan - tetapi selesaikan nama hos secara setempat. Jika pelabuhan
nombor tidak dinyatakan, ia diandaikan pada port 1080.

Pilihan ini mengatasi sebarang penggunaan sebelumnya -x, --proksi, kerana mereka bersama
eksklusif.

Sejak 7.21.7, pilihan ini tidak diperlukan kerana anda boleh menentukan proksi socks5 dengannya
-x, --proksi menggunakan awalan protokol socks5://.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan. (Pilihan ini ialah
didokumenkan secara salah sebelum ini dan digunakan sebagai --stokin tanpa nombor yang dilampirkan.)

Pilihan ini (serta --stokin4) tidak berfungsi dengan IPV6, FTPS atau LDAP.

--socks5-gssapi-service
Nama perkhidmatan lalai untuk pelayan stokin ialah rcmd/server-fqdn. Pilihan ini membolehkan
anda untuk mengubahnya.

Contoh: --socks5 proxy-name --socks5-gssapi-service sockd akan menggunakan sockd/proxy-
nama --socks5 nama proksi --socks5-gssapi-service sockd/nama sebenar akan digunakan
sockd/nama sebenar untuk kes di mana nama proksi tidak sepadan dengan nama utama.
(Ditambah dalam 7.19.4).

--stokin5-gssapi-nec
Sebagai sebahagian daripada rundingan GSS-API, mod perlindungan dirundingkan. RFC 1961 berkata
dalam seksyen 4.3/4.4 ia harus dilindungi, tetapi pelaksanaan rujukan NEC
tidak. Pilihannya --stokin5-gssapi-nec membenarkan pertukaran tanpa perlindungan daripada
rundingan mod perlindungan. (Ditambah dalam 7.19.4).

--stderr
Ubah hala semua penulisan ke stderr ke fail yang ditentukan sebaliknya. Jika nama fail ialah a
biasa '-', ia sebaliknya ditulis kepada stdout.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-t, --telnet-option
Hantar pilihan kepada protokol telnet. Pilihan yang disokong ialah:

TTYPE= Menetapkan jenis terminal.

XDISPLOC= Menetapkan lokasi paparan X.

NEW_ENV= Menetapkan pembolehubah persekitaran.

-T, --muat naik-fail
Ini memindahkan fail tempatan yang ditentukan ke URL jauh. Jika tiada bahagian fail
dalam URL yang ditentukan, Curl akan menambahkan nama fail setempat. AMBIL PERHATIAN bahawa anda mesti menggunakan
jejak / pada direktori terakhir untuk benar-benar membuktikan kepada Curl bahawa tiada fail
nama atau curl akan berfikir bahawa nama direktori terakhir anda ialah nama fail jauh
guna. Itu kemungkinan besar akan menyebabkan operasi muat naik gagal. Jika ini digunakan pada
pelayan HTTP(S), arahan PUT akan digunakan.

Gunakan nama fail "-" (sengkang tunggal) untuk menggunakan stdin dan bukannya fail yang diberikan.
Secara bergantian, nama fail "." (satu tempoh) boleh dinyatakan dan bukannya "-" kepada
gunakan stdin dalam mod tidak menyekat untuk membenarkan membaca output pelayan semasa stdin sedang dijalankan
dimuat naik.

Anda boleh menentukan satu -T untuk setiap URL pada baris arahan. Setiap pasangan -T + URL
menentukan apa yang hendak dimuat naik dan ke mana. curl juga menyokong "globbing" -T
argumen, bermakna anda boleh memuat naik berbilang fail ke satu URL dengan menggunakan
gaya globbing URL yang sama disokong dalam URL, seperti ini:

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

atau

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

--tcp-nodelay
Hidupkan pilihan TCP_NODELAY. Lihat curl_easy_setopt(3) halaman manusia untuk butiran
tentang pilihan ini. (Ditambah dalam 7.11.2)

--tftp-blksize
(TFTP) Tetapkan pilihan TFTP BLKSIZE (mesti >512). Ini adalah saiz blok yang melengkung
akan cuba gunakan apabila memindahkan data ke atau dari pelayan TFTP. Secara lalai 512
bait akan digunakan.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

(Ditambah dalam 7.20.0)

--tlsauthtype
Tetapkan jenis pengesahan TLS. Pada masa ini, satu-satunya pilihan yang disokong ialah "SRP", untuk
TLS-SRP (RFC 5054). Jika --tlsuser and --tlskata laluan dinyatakan tetapi --tlsauthtype
tidak, maka pilihan ini lalai kepada "SRP". (Ditambah dalam 7.21.4)

--tlskata laluan
Tetapkan kata laluan untuk digunakan dengan kaedah pengesahan TLS yang ditentukan dengan
--tlsauthtype. Memerlukan itu --tlsuser juga ditetapkan. (Ditambah dalam 7.21.4)

--tlsuser
Tetapkan nama pengguna untuk digunakan dengan kaedah pengesahan TLS yang ditentukan dengan
--tlsauthtype. Memerlukan itu --tlskata laluan juga ditetapkan. (Ditambah dalam 7.21.4)

--tlsv1.0
(SSL) Memaksa curl untuk menggunakan TLS versi 1.0 apabila berunding dengan pelayan TLS jauh.
(Ditambah dalam 7.34.0)

--tlsv1.1
(SSL) Memaksa curl untuk menggunakan TLS versi 1.1 apabila berunding dengan pelayan TLS jauh.
(Ditambah dalam 7.34.0)

--tlsv1.2
(SSL) Memaksa curl untuk menggunakan TLS versi 1.2 apabila berunding dengan pelayan TLS jauh.
(Ditambah dalam 7.34.0)

--tr-pengekodan
(HTTP) Minta respons Pemindahan-Pengekodan termampat menggunakan salah satu algoritma
curl menyokong, dan nyahmampat data semasa menerimanya.

(Ditambah dalam 7.21.6)

--jejak
Mendayakan pembuangan surih penuh semua data masuk dan keluar, termasuk deskriptif
maklumat, ke fail output yang diberikan. Gunakan "-" sebagai nama fail untuk menghantar output
untuk stdout.

Pilihan ini mengatasi penggunaan sebelumnya -v, --verbose or - jejak-ascii.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--trace-ascii
Mendayakan pembuangan surih penuh semua data masuk dan keluar, termasuk deskriptif
maklumat, ke fail output yang diberikan. Gunakan "-" sebagai nama fail untuk menghantar output
untuk stdout.

Ini sangat serupa dengan --jejak, tetapi meninggalkan bahagian hex dan hanya menunjukkan
ASCII sebahagian daripada tempat pembuangan. Ia menjadikan output yang lebih kecil yang mungkin lebih mudah dibaca
manusia yang tidak terlatih.

Pilihan ini mengatasi penggunaan sebelumnya -v, --verbose or --jejak.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

- masa jejak
Menandakan cap masa pada setiap jejak atau baris kata kerja yang terpapar lencong. (Ditambah dalam
7.14.0)

--soket-unix
(HTTP) Sambung melalui soket domain Unix ini, bukannya menggunakan rangkaian.
(Ditambah dalam 7.40.0)

-u, --pengguna
Tentukan nama pengguna dan kata laluan untuk digunakan untuk pengesahan pelayan. Mengatasi -n,
--netrc and --netrc-pilihan.

Jika anda hanya menyatakan nama pengguna, curl akan meminta kata laluan.

Nama pengguna dan kata laluan dibahagikan pada kolon pertama, yang menjadikannya
mustahil untuk menggunakan titik bertindih dalam nama pengguna dengan pilihan ini. Kata laluan boleh,
masih ada.

Apabila menggunakan Kerberos V5 dengan pelayan berasaskan Windows, anda harus memasukkan Windows
nama domain dalam nama pengguna, agar pelayan berjaya mendapatkan a
Tiket Kerberos. Jika anda tidak melakukannya maka jabat tangan pengesahan awal mungkin gagal.

Apabila menggunakan NTLM, nama pengguna boleh ditentukan hanya sebagai nama pengguna, tanpa
domain, jika terdapat satu domain dan hutan dalam persediaan anda sebagai contoh.

Untuk menentukan nama domain gunakan Nama Log Masuk Tahap Bawah atau UPN (Pengetua Pengguna
nama) format. Contohnya, CONTOH\pengguna dan [e-mel dilindungi] masing-masing.

Jika anda menggunakan binari keriting yang didayakan Windows SSPI dan melaksanakan Kerberos V5, Runding,
Pengesahan NTLM atau Digest maka anda boleh memberitahu curl untuk memilih nama pengguna dan
kata laluan dari persekitaran anda dengan menyatakan satu titik bertindih dengan pilihan ini: "-u
:".

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-U, --pengguna-proksi
Tentukan nama pengguna dan kata laluan untuk digunakan untuk pengesahan proksi.

Jika anda menggunakan binari keriting yang didayakan Windows SSPI dan lakukan sama ada Berunding atau NTLM
pengesahan maka anda boleh memberitahu curl untuk memilih nama pengguna dan kata laluan daripada
persekitaran anda dengan menyatakan satu titik bertindih dengan pilihan ini: "-U :".

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--url
Tentukan URL untuk diambil. Pilihan ini kebanyakannya berguna apabila anda ingin menentukan URL
dalam fail konfigurasi.

Jika URL yang diberikan tiada nama skema (seperti "http://" atau "ftp://" dll) maka
curl akan membuat tekaan berdasarkan hos. Jika nama subdomain paling luar sepadan
DICT, FTP, IMAP, LDAP, POP3 atau SMTP maka protokol itu akan digunakan, sebaliknya HTTP
akan digunakan. Memandangkan 7.45.0 meneka boleh dilumpuhkan dengan menetapkan protokol lalai,
lihat --proto-lalai untuk maklumat lanjut.

Pilihan ini boleh digunakan beberapa kali. Untuk mengawal tempat URL ini ditulis,
menggunakan -o, --pengeluaran atau -O, --nama-jauh pilihan.

-v, --verbose
Menjadi lebih bertele-tele/bercakap semasa operasi. Berguna untuk menyahpepijat dan melihat
apa yang berlaku "di bawah tudung". Baris yang bermula dengan '>' bermaksud "data pengepala" dihantar
oleh curl, '<' bermaksud "data pengepala" yang diterima oleh curl yang disembunyikan dalam kes biasa,
dan baris bermula dengan '*' bermaksud maklumat tambahan yang disediakan oleh curl.

Ambil perhatian bahawa jika anda hanya mahukan pengepala HTTP dalam output, -saya, --termasuk mungkin itu
pilihan yang anda cari.

Jika anda rasa pilihan ini masih tidak memberikan anda butiran yang mencukupi, pertimbangkan untuk menggunakan
--jejak or - jejak-ascii sebaliknya.

Pilihan ini mengatasi penggunaan sebelumnya - jejak-ascii or --jejak.

Penggunaan -ya, --senyap untuk membuat curl senyap.

-w, --tuliskan
Buat maklumat paparan curl pada stdout selepas pemindahan selesai. Formatnya ialah a
rentetan yang mungkin mengandungi teks biasa bercampur dengan sebarang bilangan pembolehubah. Formatnya
boleh ditentukan sebagai "rentetan" literal, atau anda boleh meminta curl membaca format daripada a
fail dengan "@filename" dan untuk memberitahu curl membaca format daripada stdin yang anda tulis
"@-".

Pembolehubah yang terdapat dalam format output akan digantikan dengan nilai atau teks
curl itu difikirkan sesuai, seperti yang diterangkan di bawah. Semua pembolehubah dinyatakan sebagai
%{variable_name} dan untuk mengeluarkan % biasa anda hanya menulisnya sebagai %%. Anda boleh keluarkan
baris baharu dengan menggunakan \n, pemulangan gerabak dengan \r dan ruang tab dengan \t.

PERHATIAN: %-symbol ialah simbol khas dalam win32-environment, di mana semua
kejadian % mesti digandakan apabila menggunakan pilihan ini.

Pembolehubah yang ada ialah:

jenis kandungan Jenis Kandungan dokumen yang diminta, jika ada.

nama fail_berkesan
Nama fail muktamad yang ditulis oleh curl. Ini sahaja
bermakna jika curl diberitahu untuk menulis ke fail dengan --nama-jauh
or --pengeluaran pilihan. Ia paling berguna dalam kombinasi dengan
--nama-pengepala-jauh pilihan. (Ditambah dalam 7.25.1)

ftp_entry_path Laluan awal curl berakhir apabila log masuk ke FTP jauh
pelayan. (Ditambah dalam 7.15.4)

http_code Kod respons berangka yang ditemui pada yang terakhir diambil
Pemindahan HTTP(S) atau FTP(s). Dalam 7.18.2 alias kod_tindak balas adalah
ditambahkan untuk menunjukkan maklumat yang sama.

http_connect Kod berangka yang ditemui dalam respons terakhir (daripada a
proksi) kepada permintaan CONNECT curl. (Ditambah dalam 7.12.4)

local_ip Alamat IP hujung tempatan sambungan yang paling baru dilakukan
- boleh sama ada IPv4 atau IPv6 (Ditambah dalam 7.29.0)

local_port Nombor port tempatan bagi sambungan yang paling baru dilakukan (Ditambah dalam
7.29.0)

num_connects Bilangan sambungan baharu yang dibuat dalam pemindahan baru-baru ini. (Ditambah dalam
7.12.3)

num_redirects Bilangan ubah hala yang diikuti dalam permintaan. (Ditambah dalam
7.12.3)

redirect_url Apabila permintaan HTTP dibuat tanpa -L untuk mengikuti ubah hala, ini
pembolehubah akan menunjukkan URL sebenar ubah hala akan membawa anda ke.
(Ditambah dalam 7.18.2)

remote_ip Alamat IP jauh bagi sambungan yang paling baru dilakukan - boleh
sama ada IPv4 atau IPv6 (Ditambah dalam 7.29.0)

port_jauh Nombor port jauh bagi sambungan yang paling baru dilakukan (Ditambah
pada tahun 7.29.0)

saiz_muat turun Jumlah bait yang telah dimuat turun.

size_header Jumlah bait pengepala yang dimuat turun.

saiz_permintaan Jumlah bait yang dihantar dalam permintaan HTTP.

saiz_muat naik Jumlah bait yang telah dimuat naik.

kelajuan_muat turun Kelajuan muat turun purata yang curl diukur untuk lengkap
muat turun. Bait sesaat.

kelajuan_muat naik Purata kelajuan muat naik yang diukur lengkung untuk muat naik lengkap.
Bait sesaat.

ssl_verify_result
Hasil pengesahan sijil rakan sebaya SSL itu
diminta. 0 bermakna pengesahan telah berjaya. (Ditambah dalam
7.19.0)

time_appconnect
Masa, dalam beberapa saat, ia mengambil masa dari mula sehingga SSL/SSH/etc
sambung/jabat tangan ke hos jauh telah selesai. (Ditambah dalam
7.19.0)

sambung masa Masa, dalam beberapa saat, yang diambil dari mula sehingga TCP bersambung
kepada hos jauh (atau proksi) telah selesai.

masa_namelookup
Masa, dalam beberapa saat, diambil dari mula sehingga nama
penyelesaian telah selesai.

masa_prapindahan
Masa, dalam beberapa saat, ia mengambil masa dari mula sehingga pemindahan fail
baru nak mula. Ini termasuk semua arahan pra-pemindahan dan
rundingan yang khusus untuk protokol tertentu
terbabit.

hala_masa Masa, dalam beberapa saat, yang diambil untuk semua langkah ubah hala termasuk nama
cari, sambung, prapindah dan pindahkan sebelum perlawanan akhir
transaksi telah dimulakan. time_redirect menunjukkan pelaksanaan lengkap
masa untuk berbilang ubah hala. (Ditambah dalam 7.12.3)

time_starttransfer
Masa, dalam beberapa saat, diambil dari mula hingga bait pertama
baru sahaja hendak dipindahkan. Ini termasuk time_pretransfer dan
juga masa yang diperlukan pelayan untuk mengira hasilnya.

masa_jumlah Jumlah masa, dalam saat, operasi penuh berlangsung. Masa
akan dipaparkan dengan resolusi milisaat.

url_effective URL yang terakhir diambil. Ini paling bermakna jika anda pernah
menyuruh curl mengikuti lokasi: pengepala.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-x, --proxy <[protokol://][pengguna:kata laluan@]proxyhost[:port]>
Gunakan proksi yang ditentukan.

Rentetan proksi boleh ditentukan dengan awalan protokol:// untuk menentukan alternatif
protokol proksi. Gunakan socks4://, socks4a://, socks5:// atau socks5h:// untuk meminta
versi SOCKS tertentu untuk digunakan. Tiada protokol dinyatakan, http:// dan semua yang lain
akan dianggap sebagai proksi HTTP. (Sokongan protokol telah ditambahkan dalam curl 7.21.7)

Jika nombor port tidak dinyatakan dalam rentetan proksi, ia diandaikan sebagai 1080.

Pilihan ini mengatasi pembolehubah persekitaran sedia ada yang menetapkan proksi untuk digunakan. Jika
terdapat pembolehubah persekitaran yang menetapkan proksi, anda boleh menetapkan proksi kepada "" kepada
mengatasinya.

Semua operasi yang dilakukan melalui proksi HTTP akan secara telus
ditukar kepada HTTP. Ini bermakna bahawa operasi khusus protokol tertentu mungkin tidak
tersedia. Ini tidak berlaku jika anda boleh membuat terowong melalui proksi, sebagai satu dengan
yang -p, --proxytunnel pilihan.

Pengguna dan kata laluan yang mungkin disediakan dalam rentetan proksi adalah URL dinyahkod oleh
keriting. Ini membolehkan anda menghantar aksara khas seperti @ dengan menggunakan %40 atau lulus
dalam kolon dengan %3a.

Hos proksi boleh ditentukan dengan cara yang sama seperti persekitaran proksi
pembolehubah, termasuk awalan protokol (http://) dan pengguna terbenam +
kata laluan.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-X, --permintaan
(HTTP) Menentukan kaedah permintaan tersuai untuk digunakan semasa berkomunikasi dengan HTTP
pelayan. Kaedah permintaan yang ditentukan akan digunakan dan bukannya kaedah sebaliknya
digunakan (yang lalai kepada GET). Baca spesifikasi HTTP 1.1 untuk butiran dan
penerangan. Permintaan HTTP tambahan biasa termasuk PUT dan DELETE, tetapi berkaitan
teknologi seperti WebDAV menawarkan PROPFIND, COPY, MOVE dan banyak lagi.

Biasanya anda tidak memerlukan pilihan ini. Macam-macam permintaan GET, HEAD, POST dan PUT
agak dipanggil dengan menggunakan pilihan baris arahan khusus.

Pilihan ini hanya mengubah perkataan sebenar yang digunakan dalam permintaan HTTP, ia tidak
mengubah cara curl berkelakuan. Jadi sebagai contoh jika anda ingin membuat KEPALA yang betul
permintaan, menggunakan -X HEAD tidak akan mencukupi. Anda perlu menggunakan -saya, --kepala pilihan.

Rentetan kaedah yang anda tetapkan dengan -X akan digunakan untuk semua permintaan, yang jika anda mahu
contoh penggunaan -L, --lokasi boleh menyebabkan kesan sampingan yang tidak diingini apabila curl tidak
tukar kaedah permintaan mengikut kod respons HTTP 30x - dan serupa.

(FTP) Menentukan perintah FTP tersuai untuk digunakan dan bukannya LIST apabila melakukan senarai fail
dengan FTP.

(POP3) Menentukan perintah POP3 tersuai untuk digunakan dan bukannya LIST atau RETR. (Ditambah dalam
7.26.0)

(IMAP) Menentukan perintah IMAP tersuai untuk digunakan dan bukannya LIST. (Ditambah pada 7.30.0)

(SMTP) Menentukan perintah SMTP tersuai untuk digunakan dan bukannya HELP atau VRFY. (Ditambah dalam
7.34.0)

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

--xattr
Apabila menyimpan output ke fail, pilihan ini memberitahu curl untuk menyimpan metadata fail tertentu
dalam atribut fail lanjutan. Pada masa ini, URL disimpan dalam xdg.origin.url
atribut dan, untuk HTTP, jenis kandungan disimpan dalam atribut mime_type. Jika
sistem fail tidak menyokong atribut lanjutan, amaran dikeluarkan.

-y, --kelajuan-masa
Jika muat turun lebih perlahan daripada bait had kelajuan sesaat semasa masa kelajuan
tempoh, muat turun akan dibatalkan. Jika masa kelajuan digunakan, had laju lalai
akan menjadi 1 melainkan ditetapkan dengan -Y.

Pilihan ini mengawal pemindahan dan dengan itu tidak akan menjejaskan sambungan perlahan dsb. Jika ini
adalah kebimbangan untuk anda, cuba --sambung-tamat masa pilihan.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-Y, --had-laju
Jika muat turun adalah lebih perlahan daripada kelajuan yang diberikan ini (dalam bait sesaat) untuk masa kelajuan
beberapa saat ia akan digugurkan. masa kelajuan ditetapkan dengan -y dan ialah 30 jika tidak ditetapkan.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-z, --masa-cond |
(HTTP/FTP) Minta fail yang telah diubah suai lewat daripada masa yang diberikan dan
tarikh, atau tarikh yang telah diubah suai sebelum masa itu. The boleh jadi
semua jenis rentetan tarikh atau jika ia tidak sepadan dengan mana-mana rentetan dalaman, ia diambil sebagai
nama fail dan cuba mendapatkan tarikh pengubahsuaian (mtime) daripada sebaliknya. Lihat
yang curl_getdate(3) halaman manual untuk butiran ungkapan tarikh.

Mulakan ungkapan tarikh dengan sempang (-) untuk membuatnya meminta dokumen yang
lebih lama daripada tarikh/masa yang diberikan, lalai ialah dokumen yang lebih baharu daripada
tarikh/masa yang ditetapkan.

Jika pilihan ini digunakan beberapa kali, yang terakhir akan digunakan.

-h, --bantuan
Bantuan penggunaan. Ini menyenaraikan semua pilihan baris arahan semasa dengan penerangan ringkas.

-M, --manual
Manual. Paparkan teks bantuan yang besar.

-V, - Penukaran
Memaparkan maklumat tentang curl dan versi libcurl yang digunakannya.

Baris pertama termasuk versi penuh curl, libcurl dan pihak ketiga yang lain
perpustakaan yang dikaitkan dengan boleh laku.

Baris kedua (bermula dengan "Protokol:") menunjukkan semua protokol yang dilaporkan oleh libcurl
untuk menyokong.

Baris ketiga (bermula dengan "Ciri:") menunjukkan ciri khusus yang dilaporkan oleh libcurl
tawaran. Ciri yang tersedia termasuk:

IPv6 Anda boleh menggunakan IPv6 dengan ini.

krb4 Krb4 untuk FTP disokong.

Versi SSL SSL pelbagai protokol disokong, seperti HTTPS, FTPS, POP3S
dan sebagainya.

libz Penyahmampatan automatik fail termampat melalui HTTP disokong.

Pengesahan NTLM NTLM disokong.

Nyahpepijat Keriting ini menggunakan libcurl yang dibina dengan Nyahpepijat. Ini membolehkan lebih banyak penjejakan ralat
dan penyahpepijatan memori dsb. Untuk pembangun keriting sahaja!

AsynchDNS
Keriting ini menggunakan penyelesaian nama tak segerak. Penyelesaian nama tak segerak boleh
dilakukan menggunakan sama ada c-ares atau hujung belakang penyelesai berulir.

Pengesahan SPNEGO SPNEGO disokong.

Largefile
Curl ini menyokong pemindahan fail besar, fail lebih besar daripada 2GB.

IDN Curl ini menyokong IDN - nama domain antarabangsa.

GSS-API
GSS-API disokong.

SSPI SSPI disokong.

TLS SRP
Pengesahan SRP (Secure Remote Password) disokong untuk TLS.

Sokongan HTTP2 HTTP/2 telah terbina dalam.

pautan meta
Curl ini menyokong Metalink (kedua-dua versi 3 dan 4 (RFC 5854)), yang
menerangkan cermin dan cincang. curl akan menggunakan cermin untuk failover jika ada
adalah ralat (seperti fail atau pelayan tidak tersedia).

Gunakan curl dalam talian menggunakan perkhidmatan onworks.net