curl - En ligne dans le Cloud

PROGRAMME:

Nom

curl - transférer une URL

SYNOPSIS

boucle [choix] [URL...]

DESCRIPTION

boucle est un outil pour transférer des données depuis ou vers un serveur, en utilisant l'un des protocoles pris en charge
(DICT, FICHIER, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP,
RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET et TFTP). La commande est conçue pour fonctionner
sans interaction avec l'utilisateur.

curl offre une multitude d'astuces utiles comme la prise en charge du proxy, l'authentification des utilisateurs, FTP
téléchargement, publication HTTP, connexions SSL, cookies, reprise de transfert de fichiers, Metalink, etc. Comme
vous verrez ci-dessous, le nombre de fonctionnalités vous fera tourner la tête !

curl est alimenté par libcurl pour toutes les fonctionnalités liées au transfert. Voir libcurl(3) pour en savoir plus.

URL

La syntaxe de l'URL dépend du protocole. Vous trouverez une description détaillée dans la RFC 3986.

Vous pouvez spécifier plusieurs URL ou parties d'URL en écrivant des ensembles de parties entre accolades comme dans :

http://site.{un,deux,trois}.com

ou vous pouvez obtenir des séquences de séries alphanumériques en utilisant [] comme dans :

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

ftp://ftp.numericals.com/file[001-100].txt (avec des zéros non significatifs)

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

Les séquences imbriquées ne sont pas prises en charge, mais vous pouvez en utiliser plusieurs les unes à côté des autres :

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

Vous pouvez spécifier n'importe quel nombre d'URL sur la ligne de commande. Ils seront récupérés dans un
manière séquentielle dans l'ordre spécifié.

Vous pouvez spécifier un compteur de pas pour les plages afin d'obtenir chaque Nième chiffre ou lettre :

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

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

Lorsque vous utilisez des séquences [] ou {} lorsqu'elles sont invoquées à partir d'une invite de ligne de commande, vous avez probablement
pour mettre l'URL complète entre guillemets doubles pour éviter que le shell n'interfère avec elle. Cette
s'applique également aux autres caractères traités de manière spéciale, comme par exemple '&', '?' et '*'.

Fournissez l'index de zone IPv6 dans l'URL avec un signe de pourcentage échappé et l'interface
Nom. Comme dans

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

Si vous spécifiez une URL sans préfixe protocol://, curl tentera de deviner quel protocole
vous voudrez peut-être. Il utilisera ensuite par défaut HTTP mais essayez d'autres protocoles basés sur des protocoles souvent utilisés.
préfixes de nom d'hôte. Par exemple, pour les noms d'hôte commençant par "ftp". curl vous assumera
voulez parler FTP.

curl fera de son mieux pour utiliser ce que vous lui transmettez comme URL. il ne cherche pas à le valider
comme une URL syntaxiquement correcte par tous les moyens mais est à la place très libéral avec ce qu'il
accepte.

curl tentera de réutiliser les connexions pour plusieurs transferts de fichiers, afin d'obtenir de nombreux
les fichiers du même serveur ne feront pas plusieurs connexions / poignées de main. Cela améliore
la vitesse. Bien sûr, cela n'est fait que sur les fichiers spécifiés sur une seule ligne de commande et ne peut pas
être utilisé entre des appels curl séparés.

PROGRESS COMPTEUR

curl affiche normalement un indicateur de progression pendant les opérations, indiquant la quantité de
données transférées, vitesses de transfert et temps estimé restant, etc.

curl affiche ces données sur le terminal par défaut, donc si vous invoquez curl pour faire un
opération et qu'il est sur le point d'écrire des données sur le terminal, il désactive la jauge de progression comme
sinon, cela gâcherait la sortie en mélangeant l'indicateur de progression et les données de réponse.

Si vous voulez un indicateur de progression pour les requêtes HTTP POST ou PUT, vous devez rediriger le
sortie de réponse dans un fichier, en utilisant la redirection du shell (>), -o [fichier] ou similaire.

Ce n'est pas le même cas pour l'upload FTP car cette opération ne crache aucune réponse
données au terminal.

Si vous préférez une "barre" de progression au lieu du compteur régulier, -# est votre ami.

OPTIONS

Les options commencent par un ou deux tirets. La plupart des options nécessitent une valeur supplémentaire à côté
pour eux.

La forme courte "tiret unique" des options, -d par exemple, peut être utilisée avec ou sans
un espace entre elle et sa valeur, bien qu'un espace soit un séparateur recommandé. Le long
La forme "double tiret", --data par exemple, nécessite un espace entre elle et sa valeur.

Les options de version courte qui ne nécessitent aucune valeur supplémentaire peuvent être utilisées immédiatement après
les uns aux autres, comme par exemple vous pouvez spécifier toutes les options -O, -L et -v à la fois comme
-OLv.

En général, toutes les options booléennes sont activées avec --option et encore une fois désactivé avec
--no-option. C'est-à-dire que vous utilisez exactement le même nom d'option mais le préfixez avec "no-".
Cependant, dans cette liste, nous répertorions et affichons la plupart du temps uniquement la version --option de ceux-ci. (Cette
concept avec --no options a été ajouté dans 7.19.0. Auparavant, la plupart des options étaient activées/désactivées
en cas d'utilisation répétée de la même option de ligne de commande.)

-#, --barre de progression
Faire progresser l'affichage curl comme une simple barre de progression au lieu de la norme, plus
informatif, compteur.

-:, --Suivant
Indique à curl d'utiliser une opération distincte pour l'URL suivante et associée
option. Cela vous permet d'envoyer plusieurs requêtes d'URL, chacune avec ses propres
des options, par exemple, comme des noms d'utilisateur différents ou des demandes personnalisées pour chacun.
(Ajouté dans 7.36.0)

-0, --http1.0
(HTTP) Indique à curl d'utiliser HTTP version 1.0 au lieu de l'utiliser en interne
préféré : HTTP 1.1.

--http1.1
(HTTP) Indique à curl d'utiliser HTTP version 1.1. Il s'agit de la version interne par défaut.
(Ajouté dans 7.33.0)

--http2
(HTTP) Demande à curl d'émettre ses requêtes en utilisant HTTP 2. Cela nécessite que le
libcurl sous-jacent a été construit pour le prendre en charge. (Ajouté dans 7.33.0)

--non-npn
Désactivez l'extension NPN TLS. NPN est activé par défaut si libcurl a été compilé avec
une bibliothèque SSL qui prend en charge NPN. NPN est utilisé par une libcurl qui prend en charge HTTP 2 pour
négocier le support HTTP 2 avec le serveur pendant les sessions https.

(Ajouté dans 7.36.0)

--pas d'alpn
Désactivez l'extension ALPN TLS. ALPN est activé par défaut si libcurl a été compilé
avec une bibliothèque SSL qui prend en charge ALPN. ALPN est utilisé par une libcurl qui prend en charge
HTTP 2 pour négocier la prise en charge de HTTP 2 avec le serveur pendant les sessions https.

(Ajouté dans 7.36.0)

-1, --tlsv1
(SSL) Force curl à utiliser TLS version 1.x lors de la négociation avec un serveur TLS distant.
Vous pouvez utiliser des options --tlsv1.0, --tlsv1.1et --tlsv1.2 pour contrôler la version TLS
plus précisément (si le backend SSL utilisé prend en charge un tel niveau de contrôle).

-2, --sslv2
(SSL) Force curl à utiliser SSL version 2 lors de la négociation avec un serveur SSL distant.
Parfois, curl est construit sans le support SSLv2. SSLv2 est largement considéré comme non sécurisé
(voir RFC 6176).

-3, --sslv3
(SSL) Force curl à utiliser SSL version 3 lors de la négociation avec un serveur SSL distant.
Parfois, curl est construit sans le support SSLv3. SSLv3 est largement considéré comme non sécurisé
(voir RFC 7568).

-4, --ipv4
Cette option indique à curl de résoudre les noms en adresses IPv4 uniquement, et pas par exemple
essayez IPv6.

-6, --ipv6
Cette option indique à curl de résoudre les noms en adresses IPv6 uniquement, et pas par exemple
essayez IPv4.

-a, --append
(FTP/SFTP) Lorsqu'il est utilisé dans un téléchargement, curl s'ajoute au fichier cible
au lieu de l'écraser. Si le fichier distant n'existe pas, il sera créé.
Notez que ce drapeau est ignoré par certains serveurs SFTP (dont OpenSSH).

-A, --user-agent
(HTTP) Spécifiez la chaîne User-Agent à envoyer au serveur HTTP. Certains mal fait
Les CGI échouent si ce champ n'est pas défini sur "Mozilla/4.0". Pour coder des blancs dans la chaîne,
entourez la chaîne de guillemets simples. Ceci peut également être réglé avec le -H,
--entête option bien sûr.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--anyauth
(HTTP) Indique à curl de déterminer la méthode d'authentification par lui-même et d'utiliser le plus
sécuriser celui que le site distant prétend prendre en charge. Cela se fait en faisant d'abord une requête
et vérifier les en-têtes de réponse, induisant ainsi éventuellement un tour de réseau supplémentaire
voyage. Ceci est utilisé au lieu de définir une méthode d'authentification spécifique, que vous
peut faire avec --de base, --digérer, --ntlmet --négocier.

Notez que l'utilisation de --anyauth n'est pas recommandée si vous effectuez des téléchargements à partir de stdin, car elle
peut exiger que les données soient envoyées deux fois, puis le client doit pouvoir revenir en arrière. Si
le besoin devrait survenir lors du téléchargement à partir de stdin, l'opération de téléchargement échouera.

-b, --cookie
(HTTP) Transmettez les données au serveur HTTP en tant que cookie. Ce sont soi-disant les données
précédemment reçu du serveur dans une ligne « Set-Cookie : ». Les données doivent être en
le format « NOM1=VALEUR1 ; NOM2=VALEUR2 ».

Si aucun symbole '=' n'est utilisé dans la ligne, il est traité comme un nom de fichier à utiliser pour lire
les lignes de cookies précédemment stockées, qui doivent être utilisées dans cette session si elles
rencontre. L'utilisation de cette méthode active également le moteur de cookie qui fera curl
enregistrer également les cookies entrants, ce qui peut être pratique si vous les utilisez en combinaison
les -L, --emplacement option. Le format de fichier du fichier à partir duquel lire les cookies
doivent être des en-têtes HTTP simples ou le format de fichier de cookie Netscape/Mozilla.

Le fichier spécifié avec -b, --biscuit n'est utilisé que comme entrée. Aucun cookie ne sera
écrit dans le fichier. Pour stocker des cookies, utilisez le -c, --boîte à cookies option.

Soyez prudent si vous utilisez cette option et plusieurs transferts peuvent se produire. Si
vous utilisez le NAME1=VALUE1 ; ou dans un fichier utilisez le format Set-Cookie et ne
spécifiez un domaine, le cookie est envoyé pour n'importe quel domaine (même après que les redirections sont
suivi) et ne peut pas être modifié par un cookie défini par le serveur. Si le moteur de cookies est
activé et qu'un serveur définit un cookie du même nom, les deux seront envoyés sur un
transfert futur vers ce serveur, probablement pas ce que vous vouliez. Pour répondre à ces
problèmes définissez un domaine dans Set-Cookie (cela inclura des sous-domaines) ou utilisez le
Format Netscape.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-B, --use-ascii
(FTP/LDAP) Activer le transfert ASCII. Pour FTP, cela peut également être appliqué en utilisant un
URL qui se termine par ";type=A". Cette option fait en sorte que les données envoyées à stdout soient sous forme de texte
mode pour les systèmes win32.

--de base
(HTTP) Indique à curl d'utiliser l'authentification de base HTTP avec l'hôte distant. C'est
la valeur par défaut et cette option est généralement inutile, à moins que vous ne l'utilisiez pour remplacer un
option précédemment définie qui définit une méthode d'authentification différente (telle que --ntlm,
--digérerou --négocier).

Utilisé avec -tu, --utilisateur ainsi que -X, --Procuration.

Voir aussi --proxy-basique.

-c, --cookie-jar
(HTTP) Spécifiez dans quel fichier vous voulez que curl écrive tous les cookies après un
opération. Curl écrit tous les cookies précédemment lus à partir d'un fichier spécifié ainsi que
tous les cookies reçus du(des) serveur(s) distant(s). Si aucun cookie n'est connu, aucune donnée ne sera
etre ecrit. Le fichier sera écrit en utilisant le format de fichier de cookie Netscape. Si tu
définissez le nom du fichier sur un seul tiret, "-", les cookies seront écrits sur stdout.

Cette option de ligne de commande activera le moteur de cookie qui fait curl record et
utiliser des cookies. Une autre façon de l'activer est d'utiliser le -b, --biscuit option.

Si la boîte à cookies ne peut pas être créée ou écrite, l'ensemble de l'opération curl ne sera pas
échouer ou même signaler une erreur clairement. L'utilisation de -v entraînera l'affichage d'un avertissement, mais
c'est le seul retour visible que vous obtenez sur cette situation potentiellement mortelle.

Depuis 7.43.0 cookies qui ont été importés au format Set-Cookie sans domaine
nom ne sont pas exportés par cette option.

Si cette option est utilisée plusieurs fois, le dernier nom de fichier spécifié sera utilisé.

-C, --continue-at
Continuer/Reprendre un transfert de fichier précédent au décalage donné. Le décalage donné est
le nombre exact d'octets qui seront ignorés, en comptant à partir du début de la
fichier source avant qu'il ne soit transféré vers la destination. S'il est utilisé avec des téléchargements, le
La commande du serveur FTP SIZE ne sera pas utilisée par curl.

Utilisez "-C -" pour dire à curl de savoir automatiquement où/comment reprendre le transfert.
Il utilise ensuite les fichiers de sortie/entrée donnés pour le comprendre.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--chiffres
(SSL) Spécifie les chiffrements à utiliser dans la connexion. La liste des chiffres doit
spécifier des chiffrements valides. Lisez les détails de la liste de chiffrement SSL sur cette URL :
https://www.openssl.org/docs/apps/ciphers.html

Les chiffrements NSS sont effectués différemment d'OpenSSL et de GnuTLS. La liste complète des NSS
ciphers se trouve dans l'entrée NSSCipherSuite à cette URL :
https://git.fedorahosted.org/cgit/mod_nss.git/plain/docs/mod_nss.html#Directives

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--comprimé
(HTTP) Demander une réponse compressée à l'aide de l'un des algorithmes pris en charge par curl, et
enregistrez le document non compressé. Si cette option est utilisée et que le serveur envoie un
encodage non pris en charge, curl signalera une erreur.

--connect-timeout
Temps maximum en secondes que vous autorisez la connexion de curl. Cela ne limite
la phase de connexion, donc si curl se connecte dans la période donnée, il continuera
- sinon il sortira. Depuis la version 7.32.0, cette option accepte les valeurs décimales.

Voir aussi -m, --temps-max option.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--create-répertoires
Lorsqu'il est utilisé en conjonction avec le -o option, curl créera le local nécessaire
hiérarchie des répertoires selon les besoins. Cette option crée les répertoires mentionnés avec le -o
option, rien d'autre. Si la -o le nom du fichier n'utilise pas de répertoire ou si le répertoire qu'il mentionne
existent déjà, aucun répertoire ne sera créé.

Pour créer des répertoires distants lors de l'utilisation de FTP ou SFTP, essayez --ftp-create-répertoires.

--crlf Convertit LF en CRLF lors du téléchargement. Utile pour MVS (OS/390).

(SMTP ajouté dans 7.40.0)

--crlfile
(HTTPS/FTPS) Fournir un fichier au format PEM avec une liste de révocation de certificats
qui peuvent spécifier des certificats homologues qui doivent être considérés comme révoqués.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

(Ajouté dans 7.19.7)

-d, --données
(HTTP) Envoie les données spécifiées dans une requête POST au serveur HTTP, dans le même
manière qu'un navigateur fait lorsqu'un utilisateur a rempli un formulaire HTML et appuie sur le
bouton de soumission. Cela amènera curl à transmettre les données au serveur en utilisant le
application de type de contenu/x-www-form-urlencoded. Comparer aux -F, --former.

-ré, --Les données est la même que --data-ascii. --data-raw est presque le même mais ne
ont une interprétation spéciale du caractère @. Pour publier des données purement binaires, vous
devrait plutôt utiliser le --données-binaire option. Pour coder en URL la valeur d'un formulaire
champ que vous pouvez utiliser --data-urlencode.

Si l'une de ces options est utilisée plusieurs fois sur la même ligne de commande, les données
les pièces spécifiées seront fusionnées avec un &-symbole de séparation. Ainsi, en utilisant
'-d name=daniel -d skill=lousy' générerait un morceau de publication qui ressemble à
'name=daniel&skill=lousy'.

Si vous commencez les données par la lettre @, le reste devrait être un nom de fichier pour lire le
data from, ou - si vous voulez que curl lise les données depuis stdin. Plusieurs fichiers peuvent
également être précisé. L'affichage des données d'un fichier nommé 'foobar' se ferait donc avec
--Les données @foobar. Lorsque --data reçoit l'ordre de lire à partir d'un fichier comme celui-ci, les retours chariot
et les nouvelles lignes seront supprimées. Si vous ne voulez pas que le caractère @ ait un
usage spécial d'interprétation --data-raw à la place.

-D, --dump-header
Écrivez les en-têtes de protocole dans le fichier spécifié.

Cette option est pratique à utiliser lorsque vous souhaitez stocker les en-têtes qu'un site HTTP
vous envoie. Les cookies des en-têtes pourraient alors être lus dans une deuxième boucle
invocation en utilisant le -b, --biscuit option! Les -c, --boîte à cookies l'option est une
meilleure façon de stocker les cookies.

Lorsqu'elles sont utilisées dans FTP, les lignes de réponse du serveur FTP sont considérées comme des « en-têtes » et
y sont donc sauvés.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--data-ascii
See -ré, --Les données.

--données-binaire
(HTTP) Cela affiche les données exactement comme spécifié sans aucun traitement supplémentaire.

Si vous commencez les données par la lettre @, le reste doit être un nom de fichier. Les données sont
posté de la même manière que --data-ascii fait, sauf que les nouvelles lignes et le chariot
les retours sont conservés et les conversions ne sont jamais effectuées.

Si cette option est utilisée plusieurs fois, celles qui suivent la première ajouteront des données
comme décrit dans -ré, --Les données.

--data-raw
(HTTP) Cela publie des données de la même manière que --Les données mais sans l'interprétation spéciale
du caractère @. Voir -ré, --Les données. (Ajouté dans 7.43.0)

--data-urlencode
(HTTP) Cela publie des données, similaires aux autres options --data à l'exception que
ceci effectue le codage URL. (Ajouté dans 7.18.0)

Pour être conforme à CGI, le la partie devrait commencer par un prénom suivie d'une
séparateur et une spécification de contenu. Les la partie peut être passée à curl en utilisant
l'une des syntaxes suivantes :

contenu
Cela fera en sorte que curl URL encode le contenu et le transmette. Fais attention
afin que le contenu ne contienne aucun symbole = ou @, car cela
faites en sorte que la syntaxe corresponde à l'un des autres cas ci-dessous !

=contenu
Cela fera en sorte que curl URL encode le contenu et le transmette. Le précédent =
Le symbole n'est pas inclus dans les données.

nom=contenu
Cela fera en sorte que curl URL encode la partie contenue et la transmette. Noter que
la partie du nom devrait déjà être codée en URL.

@nom de fichier
Cela fera en sorte que curl charge les données du fichier donné (y compris les nouvelles lignes),
Encodez ces données par URL et transmettez-les dans le POST.

nom@nom de fichier
Cela fera en sorte que curl charge les données du fichier donné (y compris les nouvelles lignes),
Encodez ces données par URL et transmettez-les dans le POST. La partie nom obtient un égal
signe annexé, résultant en nom=contenu-du-fichier-codé-urlen. Notez que le nom
devrait déjà être codé en URL.

--NIVEAU de délégation
Ensemble NIVEAU pour dire au serveur ce qu'il est autorisé à déléguer en ce qui concerne l'utilisateur
crédits. Utilisé avec GSS/kerberos.

none N'autorise aucune délégation.

politique Délégués si et seulement si le drapeau OK-AS-DELEGATE est défini dans le Kerberos
ticket de service, ce qui est une question de politique du royaume.

toujours Autoriser inconditionnellement le serveur à déléguer.

--digérer
(HTTP) Active l'authentification HTTP Digest. Il s'agit d'un schéma d'authentification qui
empêche le mot de passe d'être envoyé sur le fil en texte clair. Utilisez ceci dans
combinaison avec la normale -tu, --utilisateur option pour définir le nom d'utilisateur et le mot de passe. Voir
aussi --ntlm, --négocier ainsi que --anyauth pour les options associées.

Si cette option est utilisée plusieurs fois, seule la première est utilisée.

--disable-eprt
(FTP) Dites à curl de désactiver l'utilisation des commandes EPRT et LPRT lors de l'activation
Transferts FTP. Curl essaiera normalement toujours d'abord d'utiliser EPRT, puis LPRT
avant d'utiliser PORT, mais avec cette option, il utilisera PORT immédiatement. EPRT et LPRT
sont des extensions du protocole FTP d'origine et peuvent ne pas fonctionner sur tous les serveurs, mais
ils permettent plus de fonctionnalités d'une meilleure manière que la commande PORT traditionnelle.

--eprt peut être utilisé pour réactiver explicitement l'EPRT et --no-eprt est un alias pour
--disable-eprt.

La désactivation de l'EPRT modifie uniquement le comportement actif. Si vous voulez passer au passif
mode que vous ne devez pas utiliser -P, --port-ftp ou le forcer avec --ftp-pasv.

--disable-epsv
(FTP) Dites à curl de désactiver l'utilisation de la commande EPSV lors d'un FTP passif
transferts. Curl essaiera normalement toujours d'abord d'utiliser EPSV avant PASV, mais
avec cette option, il n'essaiera pas d'utiliser EPSV.

--epsv peut être utilisé pour réactiver explicitement EPSV et --no-epsv est un alias pour
--disable-epsv.

La désactivation d'EPSV ne modifie que le comportement passif. Si vous souhaitez passer en mode actif
mode que vous devez utiliser -P, --port-ftp.

--dns-interface
Dites à curl d'envoyer les requêtes DNS sortantes via . Cette option est un
contrepartie de --interface (ce qui n'affecte pas le DNS). La chaîne fournie doit être
un nom d'interface (pas une adresse).

Cette option nécessite que libcurl ait été construit avec un moteur de résolution prenant en charge
cette opération. Le backend c-ares est le seul de ce type. (Ajouté dans 7.33.0)

--dns-ipv4-addr
Dites à curl de se lier à lors des requêtes DNS IPv4, de sorte que le DNS
les demandes proviennent de cette adresse. L'argument doit être une adresse IPv4 unique.

Cette option nécessite que libcurl ait été construit avec un moteur de résolution prenant en charge
cette opération. Le backend c-ares est le seul de ce type. (Ajouté dans 7.33.0)

--dns-ipv6-addr
Dites à curl de se lier à lors des requêtes DNS IPv6, de sorte que le DNS
les demandes proviennent de cette adresse. L'argument doit être une adresse IPv6 unique.

Cette option nécessite que libcurl ait été construit avec un moteur de résolution prenant en charge
cette opération. Le backend c-ares est le seul de ce type. (Ajouté dans 7.33.0)

--dns-serveurs
Définissez la liste des serveurs DNS à utiliser au lieu de la valeur par défaut du système. La liste de
Les adresses IP doivent être séparées par des virgules. Les numéros de port peuvent également être facultativement
donné comme : après chaque adresse IP.

Cette option nécessite que libcurl ait été construit avec un moteur de résolution prenant en charge
cette opération. Le backend c-ares est le seul de ce type. (Ajouté dans 7.33.0)

-e, --référent
(HTTP) Envoie les informations de la "Page de référence" au serveur HTTP. Cela peut aussi être
réglé avec le -H, --entête drapeau bien sûr. Lorsqu'il est utilisé avec -L, --emplacement vous pouvez
ajoutez ";auto" à l'URL --referer pour que curl définisse automatiquement l'URL précédente
lorsqu'il suit un en-tête Location:. La chaîne ";auto" peut être utilisée seule, même si
vous ne définissez pas de --referer initial.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-E, --cert
(SSL) Indique à curl d'utiliser le fichier de certificat client spécifié lors de l'obtention d'un fichier
avec HTTPS, FTPS ou un autre protocole basé sur SSL. Le certificat doit être en PKCS#12
format si vous utilisez Secure Transport, ou le format PEM si vous utilisez un autre moteur. Si la
le mot de passe facultatif n'est pas spécifié, il sera demandé sur le terminal. Noter
que cette option suppose un fichier "certificat" qui est la clé privée et le
certificat client concaténé ! Voir --cert ainsi que --clé pour les préciser
de façon autonome.

Si curl est construit par rapport à la bibliothèque SSL NSS, cette option peut indiquer à curl le
surnom du certificat à utiliser dans la base de données NSS définie par le
variable d'environnement SSL_DIR (ou par défaut /etc/pki/nssdb). Si le NSS PEM PKCS#11
module (libnsspem.so) est disponible, les fichiers PEM peuvent être chargés. Si vous voulez utiliser
un fichier du répertoire courant, veuillez le faire précéder du préfixe "./", afin de
éviter la confusion avec un surnom. Si le pseudo contient ":", il doit être
précédé de "\" afin qu'il ne soit pas reconnu comme délimiteur de mot de passe. Si la
le pseudo contient "\", il doit être échappé comme "\\" afin qu'il ne soit pas reconnu
comme caractère d'échappement.

(iOS et Mac OS X uniquement) Si curl est construit contre Secure Transport, le
la chaîne de certificat peut être soit le nom d'un certificat/clé privée dans le
système ou trousseau d'utilisateur, ou le chemin d'accès à un certificat encodé PKCS#12 et privé
clé. Si vous souhaitez utiliser un fichier du répertoire courant, veuillez le faire précéder de
Préfixe "./", afin d'éviter toute confusion avec un pseudonyme.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--moteur
Sélectionnez le moteur de chiffrement OpenSSL à utiliser pour les opérations de chiffrement. Utilisation --moteur liste à
imprimer une liste des moteurs pris en charge au moment de la construction. Notez que pas tous (ou aucun) des
les moteurs peuvent être disponibles au moment de l'exécution.

--environnement
(RISC OS UNIQUEMENT) Définit une plage de variables d'environnement, en utilisant les noms -w option
prend en charge, pour permettre une extraction plus facile des informations utiles après avoir exécuté curl.

--egd-fichier
(SSL) Spécifiez le chemin d'accès au socket Entropy Gathering Daemon. La prise est
utilisé pour amorcer le moteur aléatoire pour les connexions SSL. Voir aussi le --fichier aléatoire
option.

--expect100-timeout
(HTTP) Durée maximale en secondes pendant laquelle vous autorisez curl à attendre 100 continues
réponse lorsque curl émet un en-tête Expects: 100-continue dans sa requête. Par défaut
curl attendra une seconde. Cette option accepte les valeurs décimales ! Quand le curl s'arrête
en attente, il continuera comme si la réponse avait été reçue.

(Ajouté dans 7.47.0)

--cert-type
(SSL) Indique à curl dans quel type de certificat se trouve le certificat fourni. PEM, DER et
Les ENG sont des types reconnus. Si non spécifié, PEM est supposé.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--cacert
(SSL) Indique à curl d'utiliser le fichier de certificat spécifié pour vérifier l'homologue. Le fichier
peut contenir plusieurs certificats CA. Le ou les certificats doivent être au format PEM.
Normalement, curl est conçu pour utiliser un fichier par défaut pour cela, donc cette option est généralement
utilisé pour modifier ce fichier par défaut.

curl reconnaît la variable d'environnement nommée 'CURL_CA_BUNDLE' si elle est définie, et
utilise le chemin donné comme chemin d'accès à un ensemble de certificats CA. Cette option remplace celle
variable.

La version Windows de curl recherchera automatiquement un fichier de certificats CA nommé
´curl-ca-bundle.crt´, soit dans le même répertoire que curl.exe, soit dans le Current
Répertoire de travail, ou dans n'importe quel dossier le long de votre PATH.

Si curl est construit par rapport à la bibliothèque SSL NSS, le module NSS PEM PKCS#11
(libnsspem.so) doit être disponible pour que cette option fonctionne correctement.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--capath
(SSL) Indique à curl d'utiliser le répertoire de certificats spécifié pour vérifier l'homologue.
Plusieurs chemins peuvent être fournis en les séparant par ":" (par exemple
"chemin1:chemin2:chemin3"). Les certificats doivent être au format PEM, et si curl est construit
contre OpenSSL, le répertoire doit avoir été traité à l'aide de l'utilitaire c_rehash
fourni avec OpenSSL. À l'aide de --capath peut permettre à curl alimenté par OpenSSL de faire SSL-
connexions beaucoup plus efficacement que d'utiliser --cacert si le --cacert le fichier contient
de nombreux certificats CA.

Si cette option est définie, la valeur capath par défaut sera ignorée, et si elle est utilisée
plusieurs fois, le dernier sera utilisé.

--pinnedpubkey
(SSL) Indique à curl d'utiliser le fichier de clé publique spécifié (ou les hachages) pour vérifier le
pair. Cela peut être un chemin d'accès à un fichier qui contient une seule clé publique dans PEM ou DER
format, ou n'importe quel nombre de hachages sha64 codés en base256 précédés de 'sha256//' et
séparé par

Lors de la négociation d'une connexion TLS ou SSL, le serveur envoie un certificat indiquant
son identité. Une clé publique est extraite de ce certificat et si elle ne
correspondent exactement à la clé publique fournie à cette option, curl annulera le
connexion avant d'envoyer ou de recevoir des données.

Ajouté dans 7.39.0 pour OpenSSL, GnuTLS et GSKit. Ajouté dans 7.43.0 pour NSS et
wolfSSL/CyaSSL. Prise en charge de sha256 ajoutée dans 7.44.0 pour OpenSSL, GnuTLS, NSS et
wolfSSL/CyaSSL. Les autres backends SSL ne sont pas pris en charge.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--cert-statut
(SSL) Demande à curl de vérifier l'état du certificat du serveur à l'aide du
Demande d'état de certificat (alias agrafage OCSP) Extension TLS.

Si cette option est activée et que le serveur envoie une réponse invalide (par exemple expirée),
si la réponse suggère que le certificat du serveur a été révoqué, ou non
réponse est reçue, la vérification échoue.

Ceci n'est actuellement implémenté que dans les backends OpenSSL, GnuTLS et NSS. (Ajoutée
dans 7.41.0)

--faux départ

(SSL) Indique à curl d'utiliser un faux départ pendant la négociation TLS. Le faux départ est un mode
où un client TLS commencera à envoyer des données d'application avant de vérifier le
message Terminé du serveur, économisant ainsi un aller-retour lors de l'exécution d'un
poignée de main.

Ceci n'est actuellement implémenté que dans NSS et Secure Transport (sur iOS 7.0 ou
versions ultérieures, ou OS X 10.9 ou versions ultérieures). (Ajouté dans 7.42.0)

-f, --échec
(HTTP) Échec silencieux (aucune sortie du tout) sur les erreurs du serveur. Ceci est principalement fait pour
mieux activer les scripts, etc. pour mieux gérer les tentatives infructueuses. Dans les cas normaux où
un serveur HTTP ne parvient pas à livrer un document, il renvoie un document HTML indiquant ainsi
(qui décrit souvent aussi pourquoi et plus). Ce drapeau empêchera curl de
sortir cela et renvoyer l'erreur 22.

Cette méthode n'est pas infaillible et il y a des occasions où une réponse non réussie
les codes passeront, en particulier lorsque l'authentification est impliquée (codes de réponse
401 et 407).

-F, --form
(HTTP) Cela permet à curl d'émuler un formulaire rempli dans lequel un utilisateur a appuyé sur le
bouton de soumission. Cela provoque curl aux données POST à ​​l'aide de Content-Type multipart/form-
données selon RFC 2388. Cela permet de télécharger des fichiers binaires, etc. Pour forcer
la partie « contenu » étant un fichier, préfixez le nom du fichier avec un signe @. Pour juste obtenir
la partie contenu d'un fichier, préfixez le nom du fichier avec le symbole <. Les
la différence entre @ et < est alors que @ fait qu'un fichier est joint à la publication comme
un téléchargement de fichier, tandis que le < crée un champ de texte et obtient simplement le contenu pour cela
champ de texte d'un fichier.

Exemple, pour envoyer votre fichier de mots de passe au serveur, où 'password' est le nom de
le champ de formulaire auquel / Etc / passwd sera l'entrée :

boucle -F mot de passe=@/ Etc / passwd www.mesmotsdepasse.com

Pour lire le contenu de stdin au lieu d'un fichier, utilisez - comme nom de fichier. Cela va pour
les deux constructions @ et <. Malheureusement, il ne prend pas en charge la lecture du fichier à partir d'un
nommé pipe ou similaire, car il a besoin de la taille complète avant le début du transfert.

Vous pouvez également indiquer à curl quel type de contenu utiliser en utilisant 'type=', d'une manière
semblable à:

boucle -F "[email protected];type=text/html" url.com

or

boucle -F "nom=daniel;type=texte/foo" url.com

Vous pouvez également modifier explicitement le champ de nom d'une partie de téléchargement de fichier en définissant
filename=, comme ceci :

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

Si le nom de fichier/chemin contient ',' ou ';', il doit être mis entre guillemets comme :

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

or

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

Notez que si un nom de fichier/chemin est entre guillemets, tout guillemet ou
La barre oblique inverse dans le nom de fichier doit être échappée par une barre oblique inverse.

Voir d'autres exemples et détails dans le MANUEL.

Cette option peut être utilisée plusieurs fois.

--ftp-compte [données]
(FTP) Lorsqu'un serveur FTP demande des « données de compte » après que le nom d'utilisateur et le mot de passe ont
fourni, ces données sont envoyées à l'aide de la commande ACCT. (Ajouté dans 7.13.0)

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--ftp-alternative-to-user
(FTP) Si l'authentification avec les commandes USER et PASS échoue, envoyez cette commande.
Lors de la connexion au serveur Secure Transport de Tumbleweed via FTPS à l'aide d'un client
certificat, en utilisant "SITE AUTH" indiquera au serveur de récupérer le nom d'utilisateur de
le certificat. (Ajouté dans 7.15.5)

--ftp-create-répertoires
(FTP/SFTP) Lorsqu'une URL/opération FTP ou SFTP utilise un chemin qui n'est pas actuellement
existent sur le serveur, le comportement standard de curl est d'échouer. En utilisant cette option,
curl tentera à la place de créer les répertoires manquants.

--ftp-method [méthode]
(FTP) Contrôle quelle méthode curl doit utiliser pour atteindre un fichier sur un serveur FTP(S). Les
L'argument de la méthode doit être l'une des alternatives suivantes :

multicwd
curl effectue une seule opération CWD pour chaque partie de chemin dans l'URL donnée. Pour
hiérarchies profondes, cela signifie de très nombreuses commandes. C'est ainsi que la RFC 1738 le dit
devrait être fait. C'est le comportement par défaut mais le plus lent.

nocwd curl ne fait pas du tout de CWD. curl fera SIZE, RETR, STOR etc et donnera un plein
chemin vers le serveur pour toutes ces commandes. C'est le comportement le plus rapide.

célibataire
curl effectue un CWD avec le répertoire cible complet, puis opère sur le
fichier "normalement" (comme dans le cas multicwd). C'est un peu plus les normes
conforme que 'nocwd' mais sans la pénalité complète de 'multicwd'.

(Ajouté dans 7.15.1)

--ftp-pasv
(FTP) Utilisez le mode passif pour la connexion de données. Passif est la valeur par défaut interne
comportement, mais l'utilisation de cette option peut être utilisée pour remplacer un précédent -P/-port-ftp
option. (Ajouté dans 7.11.0)

Si cette option est utilisée plusieurs fois, seule la première est utilisée. Annuler un
le passif forcé n'est vraiment pas faisable mais vous devez alors à la place appliquer le bon
-P, --port-ftp nouveau.

Le mode passif signifie que curl essaiera d'abord la commande EPSV, puis PASV, à moins que
--disable-epsv est utilisé.

--ftp-skip-pasv-ip
(FTP) Dites à curl de ne pas utiliser l'adresse IP suggérée par le serveur dans sa réponse à
la commande PASV de curl lorsque curl se connecte à la connexion de données. Au lieu de cela, curl re-
utiliser la même adresse IP qu'il utilise déjà pour la connexion de contrôle. (Ajouté dans
7.14.2)

Cette option n'a aucun effet si PORT, EPRT ou EPSV est utilisé au lieu de PASV.

--ftp-pret
(FTP) Dites à curl d'envoyer une commande PRET avant PASV (et EPSV). Certains serveurs FTP,
principalement drftpd, nécessite cette commande non standard pour les listes de répertoires ainsi que
et téléchargements en mode PASV. (Ajouté dans 7.20.x)

--ftp-ssl-ccc
(FTP) Utiliser CCC (Clear Command Channel) Arrête la couche SSL/TLS après
authentifiant. Le reste de la communication du canal de contrôle sera non crypté.
Cela permet aux routeurs NAT de suivre la transaction FTP. Le mode par défaut est passif.
See --ftp-ssl-ccc-mode pour les autres modes. (Ajouté dans 7.16.1)

--ftp-ssl-ccc-mode [actif/passif]
(FTP) Utiliser CCC (Clear Command Channel) Définit le mode CCC. Le mode passif ne
lancez l'arrêt, mais attendez plutôt que le serveur le fasse et ne répondra pas
à l'arrêt du serveur. Le mode actif initie l'arrêt et attend
pour une réponse du serveur. (Ajouté en 7.16.2)

--ftp-ssl-contrôle
(FTP) Exiger SSL/TLS pour la connexion FTP, effacer pour le transfert. Permet de sécuriser
authentification, mais transferts de données non cryptés pour plus d'efficacité. Échec le
transfert si le serveur ne prend pas en charge SSL/TLS. (Ajouté dans 7.16.0) qui peut toujours
être utilisé mais sera supprimé dans une future version.

--form-string
(HTTP) Similaire à --former sauf que la chaîne de valeur pour le paramètre nommé est
utilisé littéralement. Les premiers caractères '@' et '<' et la chaîne ';type=' dans le
valeur n'a pas de signification particulière. Utilisez ceci de préférence à --former s'il y en a
possibilité que la valeur de la chaîne déclenche accidentellement les fonctionnalités '@' ou '<'
of --former.

-g, --globoff
Cette option désactive l'"analyseur de globalisation d'URL". Lorsque vous définissez cette option, vous
peut spécifier des URL qui contiennent les lettres {}[] sans qu'elles soient
interprété par curl lui-même. Notez que ces lettres ne sont pas des URL légales normales
contenus mais ils doivent être encodés selon la norme URI.

-G, --obtenir
Lorsqu'elle est utilisée, cette option rendra toutes les données spécifiées avec -ré, --Les données, --données-binaire
or --data-urlencode à utiliser dans une requête HTTP GET au lieu de la requête POST
qui autrement serait utilisé. Les données seront ajoutées à l'URL avec un '?'
séparateur.

Si elles sont utilisées en combinaison avec -I, les données POST seront à la place ajoutées à l'URL
avec une demande HEAD.

Si cette option est utilisée plusieurs fois, seule la première est utilisée. Ceci est dû au fait
annuler un GET n'a pas de sens, mais vous devriez alors à la place appliquer le
méthode alternative que vous préférez.

-H, --en-tête
(HTTP) En-tête supplémentaire à inclure dans la requête lors de l'envoi de HTTP à un serveur. Tu
peut spécifier n'importe quel nombre d'en-têtes supplémentaires. Notez que si vous devez ajouter un
en-tête qui a le même nom que l'un des internes que curl utiliserait, votre
L'en-tête défini en externe sera utilisé à la place de l'en-tête interne. Cela vous permet de
faire des choses encore plus délicates que curl ne le ferait normalement. Vous ne devez pas remplacer
définir en interne des en-têtes sans savoir parfaitement ce que vous faites. Supprimer un
en-tête interne en donnant un remplacement sans contenu sur le côté droit de la
deux-points, comme dans : -H "Hôte :". Si vous envoyez l'en-tête personnalisé sans valeur, son
l'en-tête doit se terminer par un point-virgule, tel que -H "X-Custom-Header;" envoyer
"X-Personnalisé-En-tête :".

curl s'assurera que chaque en-tête que vous ajoutez/remplacez est envoyé avec la bonne fin-
marqueur hors ligne, vous devez donc ne sauraient ajoutez cela dans le contenu de l'en-tête : ne
n'ajoutez pas de nouvelles lignes ou de retours chariot, ils ne feront que gâcher les choses pour vous.

Voir aussi -UNE, --agent utilisateur ainsi que -e, --référent options.

À partir de la version 7.37.0, vous devez --proxy-en-tête pour envoyer des en-têtes personnalisés destinés à un
Procuration.

Mise en situation :

# curl -H "X-Prénom : Joe" http://192.168.0.1/

ATTENTION: les en-têtes définis avec cette option seront définis dans toutes les requêtes - même après
les redirections sont suivies, comme lorsqu'on leur dit avec -L, --emplacement. Cela peut conduire à la
en-tête étant envoyé à d'autres hôtes que l'hôte d'origine, donc en-têtes sensibles
doit être utilisé avec prudence en combinaison avec les redirections suivantes.

Cette option peut être utilisée plusieurs fois pour ajouter/remplacer/supprimer plusieurs en-têtes.

--hostpubmd5
(SCP/SFTP) Transmettez une chaîne contenant 32 chiffres hexadécimaux. La chaîne doit être la
Somme de contrôle MD128 5 bits de la clé publique de l'hôte distant, curl refusera le
connexion avec l'hôte à moins que les sommes md5 ne correspondent. (Ajouté en 7.17.1)

--ignore-longueur-contenu
Pour HTTP, ignorez l'en-tête Content-Length. Ceci est particulièrement utile pour les serveurs
exécutant Apache 1.x, qui signalera une longueur de contenu incorrecte pour les fichiers plus volumineux
plus de 2 gigaoctets.

Pour FTP (depuis 7.46.0), ignorez la commande RETR pour déterminer la taille avant
télécharger un fichier.

-j'inclus
(HTTP) Incluez l'en-tête HTTP dans la sortie. L'en-tête HTTP inclut des choses comme
nom du serveur, date du document, version HTTP et plus encore...

-Je me dirige
(HTTP/FTP/FILE) Récupérez uniquement l'en-tête HTTP ! Les serveurs HTTP comportent la commande HEAD
qu'il utilise pour n'obtenir que l'en-tête d'un document. Lorsqu'il est utilisé sur un FTP ou
FILE, curl affiche uniquement la taille du fichier et l'heure de la dernière modification.

--interface
Effectuez une opération à l'aide d'une interface spécifiée. Vous pouvez entrer le nom de l'interface, IP
adresse ou nom d'hôte. Un exemple pourrait ressembler à :

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

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-j, --junk-session-cookies
(HTTP) Lorsque curl est invité à lire les cookies d'un fichier donné, cette option fera
il supprime tous les "cookies de session". Cela aura essentiellement le même effet que si un
une nouvelle session est lancée. Les navigateurs typiques rejettent toujours les cookies de session lorsque
ils sont fermés.

-J, --nom-en-tête-à distance
(HTTP) Cette option indique au -Ô, --nom-distant option pour utiliser le serveur spécifié
Nom de fichier Content-Disposition au lieu d'extraire un nom de fichier de l'URL.

Il n'y a aucune tentative de décoder les séquences % (encore) dans le nom de fichier fourni, donc ceci
L'option peut vous fournir des noms de fichiers plutôt inattendus.

-k, --non sécurisé
(SSL) Cette option permet explicitement à curl d'effectuer des connexions SSL « non sécurisées » et
transferts. Toutes les connexions SSL sont tentées pour être sécurisées à l'aide de l'autorité de certification
bundle de certificats installé par défaut. Cela rend toutes les connexions considérées
« non sécurisé » échoue à moins que -k, --peu sûr est utilisé.

Consultez cette ressource en ligne pour plus de détails :
http://curl.haxx.se/docs/sslcerts.html

-K, --config
Spécifiez le fichier de configuration à partir duquel lire les arguments curl. Le fichier de configuration est un texte
fichier dans lequel des arguments de ligne de commande peuvent être écrits qui seront ensuite utilisés comme si
ils ont été écrits sur la ligne de commande réelle.

Les options et leurs paramètres doivent être spécifiés sur la même ligne du fichier de configuration,
séparés par des espaces, deux points ou le signe égal. Les noms d'options longs peuvent
éventuellement être donné dans le fichier de configuration sans les doubles tirets initiaux et si c'est le cas,
les deux points ou les caractères égaux peuvent être utilisés comme séparateurs. Si l'option est
spécifié avec un ou deux tirets, il ne peut y avoir aucun caractère deux-points ou égal entre
l'option et son paramètre.

Si le paramètre doit contenir des espaces, le paramètre doit être entouré de
devis. Entre guillemets doubles, les séquences d'échappement suivantes sont disponibles : \\, \",
\t, \n, \r et \v. Une barre oblique inverse précédant toute autre lettre est ignorée. Si le premier
colonne d'une ligne de configuration est un caractère '#', le reste de la ligne sera traité comme
un commentaire. N'écrivez qu'une seule option par ligne physique dans le fichier de configuration.

Spécifiez le nom de fichier à -K, --config comme '-' pour que curl lise le fichier à partir de stdin.

Notez que pour pouvoir spécifier une URL dans le fichier de configuration, vous devez le spécifier
utilisant l' --url option, et non en écrivant simplement l'URL sur sa propre ligne. Alors, il
pourrait ressembler à ceci :

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

Lorsque curl est invoqué, il est toujours (sauf -q est utilisé) recherche une configuration par défaut
et l'utilise s'il est trouvé. Le fichier de configuration par défaut est vérifié dans ce qui suit
place dans cet ordre :

1) curl essaie de trouver le "home dir": il vérifie d'abord le CURL_HOME, puis
les variables d'environnement HOME. A défaut, il utilise getpwuid() sur Unix-like
systems (qui renvoie le répertoire d'accueil en fonction de l'utilisateur actuel de votre système). Au
Windows, il recherche ensuite la variable APPDATA, ou en dernier recours le
'%USERPROFILE%\Application Data'.

2) Sous Windows, s'il n'y a pas de fichier _curlrc dans le répertoire personnel, il en vérifie un dans
le même répertoire que l'exécutable curl est placé. Sur les systèmes de type Unix, il sera simplement
essayez de charger .curlrc à partir du répertoire d'accueil déterminé.

# --- Exemple de fichier ---
# ceci est un commentaire
url = "curl.haxx.se"
sortie = "curlhere.html"
user-agent = "superagent/1.0"

# et récupérez également une autre URL
url = "curl.haxx.se/docs/manpage.html"
-O
référent = "http://nowhereatall.com/"
# --- Fin du fichier exemple ---

Cette option peut être utilisée plusieurs fois pour charger plusieurs fichiers de configuration.

--keepalive-time
Cette option définit la durée pendant laquelle une connexion doit rester inactive avant d'envoyer
sondes keepalive et le temps entre les sondes keepalive individuelles. C'est actuellement
efficace sur les systèmes d'exploitation offrant les sockets TCP_KEEPIDLE et TCP_KEEPINTVL
options (c'est-à-dire Linux, AIX récent, HP-UX et plus). Cette option n'a aucun effet si
--pas de maintien en vie est utilisé. (Ajouté dans 7.18.0)

Si cette option est utilisée plusieurs fois, la dernière sera utilisée. Si non spécifié,
l'option par défaut est de 60 secondes.

--clé
(SSL/SSH) Nom du fichier de clé privée. Vous permet de fournir votre clé privée dans ce
fichier séparé. Pour SSH, s'il n'est pas spécifié, curl essaie les candidats suivants dans
ordre: '~/.ssh/id_rsa','~/.ssh/id_dsa', './id_rsa', './id_dsa'.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--type de clé
(SSL) Type de fichier de clé privée. Précisez quel type votre --clé fourni la clé privée est.
DER, PEM et ENG sont pris en charge. Si non spécifié, PEM est supposé.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--krb
(FTP) Activez l'authentification et l'utilisation Kerberos. Le niveau doit être saisi et doit
être l'un des termes « clair », « sûr », « confidentiel » ou « privé ». Faut-il utiliser un niveau
ce n'est pas l'un d'entre eux, « privé » sera utilisé à la place.

Cette option nécessite une bibliothèque construite avec le support de kerberos4. Ce n'est pas très
commun. Utilisation -V, --version pour voir si votre boucle le supporte.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-l, --liste uniquement
(FTP) Lors de la liste d'un répertoire FTP, ce commutateur force un affichage de nom uniquement. C'est
particulièrement utile si l'utilisateur souhaite analyser automatiquement le contenu d'un FTP
répertoire puisque la vue de répertoire normale n'utilise pas une apparence ou un format standard.
Lorsqu'elle est utilisée ainsi, l'option provoque l'envoi d'une commande NLST au serveur
au lieu de LISTE.

Remarque : certains serveurs FTP ne répertorient que les fichiers dans leur réponse à NLST ; ils ne
inclure des sous-répertoires et des liens symboliques.

(POP3) Lors de la récupération d'un e-mail spécifique de POP3, ce commutateur force une LISTE
commande à exécuter à la place de RETR. Ceci est particulièrement utile si l'utilisateur
veut voir si un identifiant de message spécifique existe sur le serveur et quelle est sa taille.

Remarque : lorsqu'il est combiné avec -X, --demander , cette option peut être utilisée pour envoyer
une commande UIDL à la place, de sorte que l'utilisateur peut utiliser l'identifiant unique de l'e-mail plutôt
que c'est l'identifiant du message pour faire la demande. (Ajouté dans 7.21.5)

-L, --emplacement
(HTTP/HTTPS) Si le serveur signale que la page demandée a été déplacée vers un autre
location (indiquée par un en-tête Location: et un code de réponse 3XX), cette option
fera curl refaire la demande sur le nouveau lieu. Si utilisé avec -je,
--comprendre or -JE, --diriger, les en-têtes de toutes les pages demandées seront affichés. Lorsque
l'authentification est utilisée, curl envoie uniquement ses informations d'identification à l'hôte initial. Si un
la redirection prend curl vers un hôte différent, il ne pourra pas intercepter le
utilisateur+mot de passe. Voir également --location-confiance sur la façon de changer cela. Vous pouvez limiter le
quantité de redirections à suivre en utilisant le --max-redirs option.

Lorsque curl suit une redirection et que la requête n'est pas un simple GET (par exemple POST
ou PUT), il fera la requête suivante avec un GET si la réponse HTTP était 301,
302 ou 303. Si le code de réponse était un autre code 3xx, curl renverra le
demande suivante en utilisant la même méthode non modifiée.

Vous pouvez dire à curl de ne pas changer la méthode de requête non-GET en GET après un 30x
réponse en utilisant les options dédiées pour cela : --post301, --post302 ainsi que
-post303.

--libcurl
Ajoutez cette option à n'importe quelle ligne de commande curl ordinaire, et vous obtiendrez un libcurl-
en utilisant le code source C écrit dans le fichier qui fait l'équivalent de ce que votre
l'opération en ligne de commande le fait !

Si cette option est utilisée plusieurs fois, le dernier nom de fichier donné sera utilisé. (Ajoutée
dans 7.16.1)

--taux-limite
Spécifiez le taux de transfert maximal que curl doit utiliser - pour les téléchargements et
téléchargements. Cette fonctionnalité est utile si vous avez un tuyau limité et que vous souhaitez que votre
transfert de ne pas utiliser toute votre bande passante. Pour le rendre plus lent qu'autrement
serait.

La vitesse donnée est mesurée en octets/seconde, à moins qu'un suffixe ne soit ajouté.
L'ajout de 'k' ou 'K' comptera le nombre en kilo-octets, 'm' ou M' le fait
mégaoctets, tandis que « g » ou « G » en fait des gigaoctets. Exemples : 200K, 3m et 1G.

Le taux indiqué est la vitesse moyenne comptée pendant tout le transfert. Ça veut dire
cette boucle peut utiliser des vitesses de transfert plus élevées en rafales courtes, mais avec le temps, elle utilise
pas plus que le tarif indiqué.

Si vous utilisez également le -O, --Limitation de vitesse option, cette option aura préséance et
peut paralyser légèrement la limitation de débit, pour aider à maintenir la logique de limitation de vitesse
travail.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--local-port [-num]
Définissez un numéro préféré ou une plage de numéros de port locaux à utiliser pour la ou les connexions.
Notez que les numéros de port sont par nature une ressource rare qui sera parfois occupée
donc définir cette plage sur quelque chose de trop étroit peut entraîner une connexion inutile
échecs de configuration. (Ajouté en 7.15.2)

--location-confiance
(HTTP/HTTPS) J'aime -L, --emplacement, mais permettra d'envoyer le nom + mot de passe à tous
hôtes vers lesquels le site peut rediriger. Cela peut ou non introduire une sécurité
violation si le site vous redirige vers un site auquel vous enverrez votre authentification
info (qui est en clair dans le cas de l'authentification HTTP Basic).

-m, --max-temps
Temps maximum en secondes que vous permettez à l'ensemble de l'opération de prendre. C'est utile
pour empêcher vos travaux par lots de se bloquer pendant des heures en raison de réseaux ou de liaisons lents
descente. Depuis la version 7.32.0, cette option accepte les valeurs décimales, mais la valeur réelle
le délai d'expiration diminuera en précision à mesure que le délai d'expiration spécifié augmentera en décimal
précision. Voir aussi le --connect-timeout option.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--options de connexion
Spécifiez les options de connexion à utiliser lors de l'authentification du serveur.

Vous pouvez utiliser les options de connexion pour spécifier les options spécifiques au protocole qui peuvent être utilisées
lors de l'authentification. À l'heure actuelle, seuls IMAP, POP3 et SMTP prennent en charge les options de connexion.
Pour plus d'informations sur les options de connexion, veuillez consulter RFC 2384, RFC 5092 et IETF
draft draft-earhart-url-smtp-00.txt (Ajouté dans 7.34.0).

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--mail-auth
(SMTP) Spécifiez une seule adresse. Ceci sera utilisé pour spécifier l'authentification
adresse (identité) d'un message soumis qui est relayé à un autre serveur.

(Ajouté dans 7.25.0)

--courrier de
(SMTP) Spécifiez une adresse unique à partir de laquelle le courrier donné doit être envoyé.

(Ajouté dans 7.20.0)

--max-filesize
Spécifiez la taille maximale (en octets) d'un fichier à télécharger. Si le fichier demandé est
supérieure à cette valeur, le transfert ne démarrera pas et curl reviendra avec exit
code 63.

REMARQUE: La taille du fichier n'est pas toujours connue avant le téléchargement, et pour de tels fichiers cette
l'option n'a aucun effet même si le transfert de fichier finit par être plus volumineux que cela étant donné
limite. Cela concerne à la fois les transferts FTP et HTTP.

--mail-rcpt
(SMTP) Spécifiez une seule adresse, un nom d'utilisateur ou un nom de liste de diffusion.

Lors de l'exécution d'un transfert de courrier, le destinataire doit spécifier une adresse e-mail valide
pour envoyer le courrier. (Ajouté dans 7.20.0)

Lors d'une vérification d'adresse (commande VRFY), le destinataire doit être
spécifié comme nom d'utilisateur ou nom d'utilisateur et domaine (conformément à la section 3.5 de la RFC5321).
(Ajouté dans 7.34.0)

Lors de l'exécution d'une extension de liste de diffusion (commande EXPN), le destinataire doit être
spécifié à l'aide du nom de la liste de diffusion, tel que « Friends » ou « London-Office ».
(Ajouté dans 7.34.0)

--max-redirs
Définissez le nombre maximal de suivis de redirection autorisés. Si -L, --emplacement est utilisé,
cette option peut être utilisée pour empêcher curl de suivre les redirections "in absurdum".
Par défaut, la limite est fixée à 50 redirections. Définissez cette option sur -1 pour le faire
illimité.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--métallique
Cette option peut dire à curl d'analyser et de traiter un URI donné en tant que fichier Metalink (les deux
les versions 3 et 4 (RFC 5854) sont prises en charge) et utilisent les miroirs répertoriés dans
pour le basculement s'il y a des erreurs (telles que le fichier ou le serveur n'étant pas disponible).
Il vérifiera également le hachage du fichier une fois le téléchargement terminé. Le Métalink
le fichier lui-même est téléchargé et traité en mémoire et non stocké dans le fichier local
système.

Exemple d'utilisation d'un fichier Metalink distant :

boucle --métallique http://www.example.com/example.metalink

Pour utiliser un fichier Metalink dans le système de fichiers local, utilisez le protocole FILE (file://) :

boucle --metalink fichier://exemple.metalink

Veuillez noter que si le protocole FILE est désactivé, il n'y a aucun moyen d'utiliser un
Fichier Metalink au moment de la rédaction de cet article. Notez également que si --métallique ainsi que
--comprendre sont utilisés ensemble, --comprendre sera ignoré. C'est parce que l'inclusion
les en-têtes dans la réponse casseront l'analyseur Metalink et si les en-têtes sont inclus
dans le fichier décrit dans le fichier Metalink, la vérification du hachage échouera.

(Ajouté dans 7.27.0, s'il est construit avec la bibliothèque libmetalink.)

-n, --netrc
Fait que curl scanne le .netrc (_réseau sous Windows) dans le répertoire personnel de l'utilisateur
pour le nom de connexion et le mot de passe. Ceci est généralement utilisé pour FTP sous Unix. Si utilisé avec
HTTP, curl activera l'authentification de l'utilisateur. Voir réseau(5) ftp(1) pour plus de détails sur le
format de fichier. Curl ne se plaindra pas si ce fichier n'a pas les bonnes autorisations
(il ne doit pas être lisible par le monde ou par le groupe). La variable d'environnement "HOME"
est utilisé pour trouver le répertoire personnel.

Un exemple rapide et très simple de la configuration d'un .netrc pour autoriser curl vers FTP vers
la machine host.domain.com avec le nom d'utilisateur « moi-même » et le mot de passe « secret » devrait
ressemble à :

click hôte.domaine.com vous connecter moi-même Mot de passe secret

-N, --pas de tampon
Désactive la mise en mémoire tampon du flux de sortie. Dans des situations de travail normales, curl
utiliser un flux de sortie standard mis en mémoire tampon qui aura pour effet de sortir
les données en morceaux, pas nécessairement exactement quand les données arrivent. En utilisant ce
L'option désactivera cette mise en mémoire tampon.

Notez qu'il s'agit du nom d'option nié documenté. Vous pouvez ainsi utiliser --amortir à
appliquer la mise en mémoire tampon.

--netrc-fichier
Cette option est similaire à --netrc, sauf que vous fournissez le chemin (absolu ou
relatif) au fichier netrc que Curl doit utiliser. Vous ne pouvez spécifier qu'un seul réseau
fichier par appel. Si plusieurs --netrc-fichier des options sont fournies, seuls les dernier
UN sera utilisé. (Ajouté dans 7.21.5)

Cette option annule toute utilisation de --netrc car ils s'excluent mutuellement. Ce sera
aussi respecter --netrc-facultatif si spécifié.

--netrc-facultatif
Très semblable à --netrc, mais cette option rend l'utilisation de .netrc optionnel ne le comptant pas
obligatoire en tant que --netrc option fait.

--négocier
(HTTP) Active l'authentification Négocier (SPNEGO).

Si vous souhaitez activer la négociation (SPNEGO) pour l'authentification proxy, utilisez
--proxy-négocier.

Cette option nécessite une bibliothèque construite avec le support GSS-API ou SSPI. Utilisation -V,
--version pour voir si votre curl prend en charge GSS-API/SSPI et SPNEGO.

Lorsque vous utilisez cette option, vous devez également fournir un faux -tu, --utilisateur possibilité d'activer
correctement le code d'authentification. L'envoi d'un '-u :' suffit comme nom d'utilisateur et
mot de passe du -u l'option ne sont pas réellement utilisées.

Si cette option est utilisée plusieurs fois, seule la première est utilisée.

--pas de maintien en vie
Désactive l'utilisation des messages keepalive sur la connexion TCP, comme par défaut curl
leur permet.

Notez qu'il s'agit du nom d'option nié documenté. Vous pouvez ainsi utiliser --rester en vie
pour appliquer keepalive.

--no-identifiant de session
(SSL) Désactivez l'utilisation par curl de la mise en cache de l'ID de session SSL. Par défaut, tous les transferts sont
fait en utilisant le cache. Notez que même si rien ne devrait jamais être blessé en essayant de
réutiliser les identifiants de session SSL, il semble y avoir des implémentations SSL cassées dans la nature qui
peut vous obliger à désactiver cela pour que vous réussissiez. (Ajouté dans 7.16.0)

Notez qu'il s'agit du nom d'option nié documenté. Vous pouvez ainsi utiliser --ID de session
pour appliquer la mise en cache de l'ID de session.

--noproxy
Liste d'hôtes séparés par des virgules qui n'utilisent pas de proxy, s'il est spécifié. Les
seul le caractère générique est un seul caractère *, qui correspond à tous les hôtes, et effectivement
désactive le proxy. Chaque nom de cette liste correspond soit à un domaine qui
contient le nom d'hôte ou le nom d'hôte lui-même. Par exemple, local.com correspondrait
local.com, local.com:80 et www.local.com, mais pas www.notlocal.com. (Ajouté dans
7.19.4).

--ntlm (HTTP) Active l'authentification NTLM. La méthode d'authentification NTLM a été conçue par
Microsoft et est utilisé par les serveurs Web IIS. Il s'agit d'un protocole propriétaire, inverse-
conçu par des personnes intelligentes et mis en œuvre dans curl en fonction de leurs efforts. Cette
type de comportement ne doit pas être approuvé, vous devez encourager tous ceux qui utilisent
NTLM pour passer à une méthode d'authentification publique et documentée, telle que
Digérer.

Si vous souhaitez activer NTLM pour votre authentification proxy, utilisez --proxy-ntlm.

Cette option nécessite une bibliothèque construite avec le support SSL. Utilisation -V, --version Pour voir si
votre curl prend en charge NTLM.

Si cette option est utilisée plusieurs fois, seule la première est utilisée.

-o, --sortie
Écrire la sortie dans au lieu de stdout. Si vous utilisez {} ou [] pour récupérer
plusieurs documents, vous pouvez utiliser '#' suivi d'un nombre dans le spécificateur.
Cette variable sera remplacée par la chaîne actuelle de l'URL récupérée.
Comme dans:

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

ou utilisez plusieurs variables comme :

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

Vous pouvez utiliser cette option autant de fois que le nombre d'URL dont vous disposez.

Voir aussi --create-répertoires possibilité de créer dynamiquement les répertoires locaux.
Spécifier la sortie comme '-' (un seul tiret) forcera la sortie à être effectuée à
sortie standard.

-O, --nom-distant
Ecrivez la sortie dans un fichier local nommé comme le fichier distant que nous obtenons. (Seule la partie fichier
du fichier distant est utilisé, le chemin est coupé.)

Le nom du fichier distant à utiliser pour l'enregistrement est extrait de l'URL donnée, rien
autre.

Par conséquent, le fichier sera enregistré dans le répertoire de travail actuel. Si tu
voulez que le fichier soit enregistré dans un répertoire différent, assurez-vous de changer le travail actuel
répertoire avant d'appeler curl avec le -Ô, --nom-distant drapeau!

Aucun décodage d'URL n'est effectué sur le nom du fichier. S'il a %20 ou une autre URL encodée
parties du nom, ils finiront tels quels comme nom de fichier.

Vous pouvez utiliser cette option autant de fois que le nombre d'URL dont vous disposez.

--oauth2-porteur
(IMAP, POP3, SMTP) Spécifiez le jeton du porteur pour l'authentification du serveur OAUTH 2.0.
Le jeton du porteur est utilisé en conjonction avec le nom d'utilisateur qui peut être spécifié
dans le cadre de la --url or -tu, --utilisateur options.

Le jeton du porteur et le nom d'utilisateur sont formatés conformément à la RFC 6750.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--proxy-header
(HTTP) En-tête supplémentaire à inclure dans la requête lors de l'envoi de HTTP à un proxy. Tu peux
spécifiez un nombre quelconque d'en-têtes supplémentaires. C'est l'option équivalente à -H, --entête
mais est pour la communication proxy uniquement comme dans les requêtes CONNECT lorsque vous voulez un
en-tête séparé envoyé au proxy à ce qui est envoyé à l'hôte distant réel.

curl s'assurera que chaque en-tête que vous ajoutez/remplacez est envoyé avec la bonne fin-
marqueur hors ligne, vous devez donc ne sauraient ajoutez cela dans le contenu de l'en-tête : ne
n'ajoutez pas de nouvelles lignes ou de retours chariot, ils ne feront que gâcher les choses pour vous.

Les en-têtes spécifiés avec cette option ne seront pas inclus dans les requêtes que curl connaît
ne sera pas envoyé à un proxy.

Cette option peut être utilisée plusieurs fois pour ajouter/remplacer/supprimer plusieurs en-têtes.

(Ajouté dans 7.37.0)

-p, --proxytunnel
Lorsqu'un proxy HTTP est utilisé (-X, --Procuration), cette option entraînera des protocoles non HTTP
pour tenter de passer par le proxy au lieu de simplement l'utiliser pour faire comme HTTP
opérations. L'approche tunnel se fait avec la requête HTTP proxy CONNECT et
nécessite que le proxy autorise la connexion directe au numéro de port distant que curl veut
jusqu'au tunnel.

-P, --ftp-port
(FTP) Inverse les rôles d'initiateur/d'écoute par défaut lors de la connexion avec FTP. Cette
le commutateur fait que curl utilise le mode actif. En pratique, curl dit alors au serveur de
se reconnecter à l'adresse et au port spécifiés par le client, tandis que le mode passif demande
le serveur pour configurer une adresse IP et un port pour se connecter. devrait
être l'un des :

interface
c'est-à-dire "eth0" pour spécifier l'adresse IP de l'interface que vous souhaitez utiliser (Unix
seulement)

adresse IP
c'est-à-dire "192.168.10.1" pour spécifier l'adresse IP exacte

le nom d'hôte
c'est-à-dire "my.host.domain" pour spécifier la machine

- faire curl choisir la même adresse IP qui est déjà utilisée pour le contrôle
connexion

Si cette option est utilisée plusieurs fois, la dernière sera utilisée. Désactiver l'utilisation de
PORT avec --ftp-pasv. Désactiver la tentative d'utilisation de la commande EPRT au lieu de PORT
en utilisant --disable-eprt. EPRT est vraiment PORT++.

À partir de 7.19.5, vous pouvez ajouter ":[start]-[end]" à droite de l'adresse, pour
dire à curl quelle plage de ports TCP utiliser. Cela signifie que vous spécifiez une plage de ports, à partir d'un
inférieur à un nombre supérieur. Un seul numéro fonctionne aussi, mais notez qu'il
augmente le risque d'échec puisque le port peut ne pas être disponible.

--passe
(SSL/SSH) Mot de passe pour la clé privée

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--chemin-tel quel
Dites à curl de ne pas gérer les séquences de /../ or /./ dans le chemin d'URL donné. Normalement
curl les écrasera ou les fusionnera selon les normes, mais avec cette option, vous
dis-lui de ne pas faire ça.

(Ajouté dans 7.42.0)

--post301
(HTTP) Indique à curl de respecter la RFC 7230/6.4.2 et de ne pas convertir les requêtes POST en GET
demandes lors du suivi d'une redirection 301. Le comportement non-RFC est omniprésent dans
navigateurs Web, donc curl effectue la conversion par défaut pour maintenir la cohérence.
Cependant, un serveur peut exiger qu'un POST reste un POST après une telle redirection.
Cette option n'a de sens que lors de l'utilisation -L, --emplacement (Ajouté dans 7.17.1)

--post302
(HTTP) Indique à curl de respecter la RFC 7230/6.4.3 et de ne pas convertir les requêtes POST en GET
demandes lors du suivi d'une redirection 302. Le comportement non-RFC est omniprésent dans
navigateurs Web, donc curl effectue la conversion par défaut pour maintenir la cohérence.
Cependant, un serveur peut exiger qu'un POST reste un POST après une telle redirection.
Cette option n'a de sens que lors de l'utilisation -L, --emplacement (Ajouté dans 7.19.1)

--post303
(HTTP) Indique à curl de respecter la RFC 7230/6.4.4 et de ne pas convertir les requêtes POST en GET
demandes lors du suivi d'une redirection 303. Le comportement non-RFC est omniprésent dans
navigateurs Web, donc curl effectue la conversion par défaut pour maintenir la cohérence.
Cependant, un serveur peut exiger qu'un POST reste un POST après une telle redirection.
Cette option n'a de sens que lors de l'utilisation -L, --emplacement (Ajouté dans 7.26.0)

--proto
Indique à curl d'utiliser les protocoles répertoriés pour sa récupération initiale. Les protocoles sont
évalués de gauche à droite, sont séparés par des virgules et sont chacun un nom de protocole ou
'all', éventuellement préfixé par zéro ou plusieurs modificateurs. Les modificateurs disponibles sont :

+ Autoriser ce protocole en plus des protocoles déjà autorisés (c'est le
par défaut si aucun modificateur n'est utilisé).

- Refuser ce protocole en le retirant de la liste des protocoles déjà autorisés.

= Autoriser uniquement ce protocole (en ignorant la liste déjà autorisée), bien que sous réserve
à une modification ultérieure par des entrées ultérieures dans la liste séparée par des virgules.

Par exemple :

--proto -ftps utilise les protocoles par défaut, mais désactive ftps

--proto -tout,https,+http
active uniquement http et https

--proto = http, https
active également uniquement http et https

Les protocoles inconnus génèrent un avertissement. Cela permet aux scripts de s'appuyer en toute sécurité sur
capable de désactiver les protocoles potentiellement dangereux, sans compter sur la prise en charge de
ce protocole étant intégré à curl pour éviter une erreur.

Cette option peut être utilisée plusieurs fois, auquel cas l'effet est le même que
concaténer les protocoles dans une instance de l'option.

(Ajouté dans 7.20.2)

--proto-default
Indique à curl d'utiliser protocole pour toute URL manquant un nom de schéma.

Mise en situation :

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

Un protocole inconnu ou non pris en charge provoque une erreur CURLE_UNSUPPORTED_PROTOCOL.

Cette option ne modifie pas le protocole proxy par défaut (http).

Sans cette option, curl ferait une supposition basée sur l'hôte, voir --url pour en savoir plus.

(Ajouté dans 7.45.0)

--proto-redir
Indique à curl d'utiliser les protocoles répertoriés lors de la redirection. Voir --proto pour savoir comment les protocoles
sont représentées.

Mise en situation :

--proto-redir -all,http,https
Autoriser uniquement HTTP et HTTPS lors de la redirection.

Par défaut, curl autorisera tous les protocoles sur la redirection sauf plusieurs désactivés pour la sécurité
raisons : depuis 7.19.4 FILE et SCP sont désactivés, et depuis 7.40.0 SMB et SMBS sont également
désactivée. En précisant TOUTE or +tout active tous les protocoles de redirection, y compris ceux
désactivé pour des raisons de sécurité.

(Ajouté dans 7.20.2)

--proxy-anyauth
Indique à curl de choisir une méthode d'authentification appropriée lors de la communication avec le
procuration donnée. Cela peut entraîner un aller-retour supplémentaire de demande/réponse. (Ajouté dans
7.13.2)

--proxy-basique
Indique à curl d'utiliser l'authentification HTTP Basic lors de la communication avec le
Procuration. Utilisation --de base pour activer HTTP Basic avec un hôte distant. Basique est la valeur par défaut
méthode d'authentification que curl utilise avec les proxys.

--proxy-digest
Indique à curl d'utiliser l'authentification HTTP Digest lors de la communication avec le
Procuration. Utilisation --digérer pour activer HTTP Digest avec un hôte distant.

--proxy-négocier
Indique à curl d'utiliser l'authentification HTTP Negotiate (SPNEGO) lors de la communication avec
la procuration donnée. Utilisation --négocier pour activer HTTP Negotiate (SPNEGO) avec une télécommande
hôte. (Ajouté en 7.17.1)

--proxy-ntlm
Indique à curl d'utiliser l'authentification HTTP NTLM lors de la communication avec le proxy donné.
Utilisez --ntlm pour activer NTLM avec un hôte distant.

--proxy-service-name
Cette option vous permet de modifier le nom du service pour la négociation de proxy.

Exemples : --proxy-negotiate proxy-name --proxy-nom-du-service sockd utiliserait
sockd/nom-proxy. (Ajouté dans 7.43.0).

--proxy1.0
Utilisez le proxy HTTP 1.0 spécifié. Si le numéro de port n'est pas spécifié, il est
supposé au port 1080.

La seule différence entre cela et l'option proxy HTTP (-X, --Procuration), est-ce
les tentatives d'utilisation de CONNECT via le proxy spécifieront un protocole HTTP 1.0 à la place
du HTTP 1.1 par défaut.

--pubkey
(SSH) Nom du fichier de clé publique. Vous permet de fournir votre clé publique dans ce
fichier.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

(À partir de la version 7.39.0, curl tente d'extraire automatiquement la clé publique du
fichier de clé privée, il n'est donc généralement pas nécessaire de passer cette option. Notez que ce
l'extraction de clé publique nécessite que libcurl soit lié à une copie de libssh2 1.2.8
ou supérieur qui est lui-même lié à OpenSSL.)

-q S'il est utilisé comme premier paramètre sur la ligne de commande, le curlrc le fichier de configuration ne sera pas
être lu et utilisé. Voir le -K, --config pour plus de détails sur le fichier de configuration par défaut
chemin de recherche.

-Q, --citation
(FTP/SFTP) Envoyez une commande arbitraire au serveur distant FTP ou SFTP. Citation
les commandes sont envoyées AVANT le transfert (juste après le PWD initial
commande dans un transfert FTP, pour être exact). Pour que les commandes aient lieu après un
transfert réussi, faites-les précéder d'un tiret « - ». Pour que les commandes soient envoyées après
curl a changé de répertoire de travail, juste avant la ou les commandes de transfert, préfixe
la commande avec un '+' (cela n'est pris en charge que pour FTP). Vous pouvez spécifier n'importe quel nombre
de commandes. Si le serveur renvoie un échec pour l'une des commandes, l'ensemble
l'opération sera interrompue. Vous devez envoyer des commandes FTP syntaxiquement correctes en tant que RFC
959 définit aux serveurs FTP, ou l'une des commandes répertoriées ci-dessous aux serveurs SFTP.
Cette option peut être utilisée plusieurs fois. Lorsque vous parlez à un serveur FTP, préfixez le
commande avec un astérisque (*) pour que curl continue même si la commande échoue comme par
curl par défaut s'arrêtera au premier échec.

SFTP est un protocole binaire. Contrairement à FTP, curl interprète les commandes de citation SFTP
lui-même avant de les envoyer au serveur. Les noms de fichiers peuvent être entre guillemets de style shell pour
incorporer des espaces ou des caractères spéciaux. Voici la liste de tous les SFTP pris en charge
commandes de citation :

fichier de groupe chgrp
La commande chgrp définit l'ID de groupe du fichier nommé par l'opérande de fichier sur
l'ID de groupe spécifié par l'opérande de groupe. L'opérande de groupe est un nombre décimal
ID de groupe entier.

fichier de mode chmod
La commande chmod modifie les bits de mode fichier du fichier spécifié. Les
L'opérande de mode est un nombre de mode entier octal.

fichier utilisateur chown
La commande chown définit le propriétaire du fichier nommé par l'opérande de fichier à
l'ID utilisateur spécifié par l'opérande utilisateur. L'opérande utilisateur est un nombre décimal
ID utilisateur entier.

dans le fichier_source fichier_cible
Les commandes ln et symlink créent un lien symbolique dans le fichier_cible
emplacement pointant vers l'emplacement du fichier_source.

mkdir nom_répertoire
La commande mkdir crée le répertoire nommé par l'opérande nom_répertoire.

pwd La commande pwd renvoie le chemin absolu du chemin d'accès en cours
répertoire.

renommer la cible source
La commande rename renomme le fichier ou le répertoire nommé par l'opérande source
au chemin de destination nommé par l'opérande cible.

fichier rm
La commande rm supprime le fichier spécifié par l'opérande de fichier.

répertoire rmdir
La commande rmdir supprime l'entrée de répertoire spécifiée par le répertoire
opérande, à condition qu'il soit vide.

lien symbolique fichier_source fichier_cible
Voir ln.

-r, --range
(HTTP/FTP/SFTP/FILE) Récupérer une plage d'octets (c'est-à-dire un document partiel) d'un
Serveur HTTP/1.1, FTP ou SFTP ou un FICHIER local. Les plages peuvent être spécifiées dans un nombre
des moyens.

0-499 spécifie les 500 premiers octets

500-999 spécifie les 500 deuxièmes octets

- 500 spécifie les 500 derniers octets

Séries 9500- spécifie les octets à partir de l'offset 9500 et vers l'avant

0-0,-1 spécifie le premier et le dernier octet uniquement (*) (HTTP)

100-199,500-599
spécifie deux plages distinctes de 100 octets (*) (HTTP)

(*) = NOTEZ que cela entraînera une réponse du serveur avec une réponse en plusieurs parties !

Seuls les caractères numériques (0-9) sont valides dans les champs 'start' et 'stop' du
Syntaxe de plage 'start-stop'. Si un caractère non numérique est donné dans la plage, le
la réponse du serveur ne sera pas spécifiée, selon la configuration du serveur.

Vous devez également savoir que de nombreux serveurs HTTP/1.1 n'ont pas cette fonctionnalité
activé, de sorte que lorsque vous essayez d'obtenir une plage, vous obtenez à la place l'ensemble
document.

Les téléchargements des plages FTP et SFTP ne prennent en charge que la syntaxe simple « start-stop »
(éventuellement avec un des nombres omis). L'utilisation du FTP dépend du FTP étendu
commande TAILLE.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-R, --remote-temps
Lorsqu'il est utilisé, cela fera en sorte que curl tentera de comprendre l'horodatage de la télécommande
fichier, et s'il est disponible, faites en sorte que le fichier local obtienne le même horodatage.

--random-file
(SSL) Spécifiez le chemin d'accès au fichier contenant ce qui sera considéré comme aléatoire
Les données. Les données sont utilisées pour amorcer le moteur aléatoire pour les connexions SSL. Voir aussi le
--egd-fichier option.

--raw (HTTP) Lorsqu'il est utilisé, il désactive tout décodage HTTP interne de contenu ou de transfert
codages et les rend à la place transmis sans modification, brut. (Ajouté en 7.16.2)

--remote-name-all
Cette option modifie l'action par défaut pour toutes les URL données à traiter comme si
-Ô, --nom-distant ont été utilisés pour chacun. Donc, si vous voulez désactiver cela pour un
URL spécifique après --remote-name-all a été utilisé, vous devez utiliser "-o -" ou --non-
nom-distant. (Ajouté dans 7.19.0)

--résoudre
Fournissez une adresse personnalisée pour une paire hôte/port spécifique. En utilisant cela, vous pouvez
faire en sorte que les requêtes curl utilisent une adresse spécifiée et empêchent le contraire
adresse normalement résolue à utiliser. Considérez cela comme une sorte de / Etc / hosts alternative
fourni sur la ligne de commande. Le numéro de port doit être le numéro utilisé pour le
protocole spécifique pour lequel l'hôte sera utilisé. Cela signifie que vous avez besoin de plusieurs entrées si
vous souhaitez fournir une adresse pour le même hôte mais des ports différents.

Cette option peut être utilisée plusieurs fois pour ajouter de nombreux noms d'hôtes à résoudre.

(Ajouté dans 7.21.3)

--réessayez
Si une erreur transitoire est renvoyée lorsque curl essaie d'effectuer un transfert, il
réessayez ce nombre de fois avant d'abandonner. Mettre le nombre à 0 fait curl
aucune nouvelle tentative (ce qui est la valeur par défaut). Une erreur transitoire signifie soit : un timeout, un FTP
Code de réponse 4xx ou code de réponse HTTP 5xx.

Lorsque curl est sur le point de réessayer un transfert, il attendra d'abord une seconde, puis pendant
toutes les tentatives à venir, il doublera le temps d'attente jusqu'à ce qu'il atteigne 10 minutes
qui sera alors le délai entre le reste des tentatives. En utilisant --réessayez-
retarder vous désactivez cet algorithme d'arrêt exponentiel. Voir également --retry-max-temps à
limiter le temps total autorisé pour les tentatives. (Ajouté en 7.12.3)

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--retry-delay
Faire dormir curl cette durée avant chaque nouvelle tentative lorsqu'un transfert a échoué
avec une erreur transitoire (il modifie l'algorithme de délai d'attente par défaut entre
tentatives). Cette option n'est intéressante que si --réessayez est également utilisé. Définir ce
le délai à zéro obligera curl à utiliser le délai d'attente par défaut. (Ajouté en 7.12.3)

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--retry-max-time
Le temporisateur de nouvelle tentative est réinitialisé avant la première tentative de transfert. Les tentatives seront effectuées comme
habituel (voir --réessayez) tant que le temporisateur n'a pas atteint cette limite donnée. Avis
que si le temporisateur n'a pas atteint la limite, la demande sera faite et pendant que
l'exécution, cela peut prendre plus de temps que cette période de temps donnée. Pour limiter un seul
durée maximale de la demande, utilisez -m, --temps-max. Définissez cette option sur zéro pour ne pas expirer
tentatives. (Ajouté en 7.12.3)

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-s, --silencieux
Mode silencieux ou silencieux. Ne pas afficher la jauge de progression ou les messages d'erreur. fait des boucles
muet. Il produira toujours les données que vous demandez, potentiellement même au
terminal/stdout à moins que vous ne le redirigiez.

--sasl-ir
Activez la réponse initiale dans l'authentification SASL. (Ajouté dans 7.31.0)

--Nom du service
Cette option vous permet de modifier le nom du service pour SPNEGO.

Exemples : --negotiate --Nom du service sockd utiliserait sockd/nom-serveur. (Ajouté dans
7.43.0).

-S, --show-erreur
Lorsqu'il est utilisé avec -s il fait afficher un message d'erreur à curl s'il échoue.

--ssl (FTP, POP3, IMAP, SMTP) Essayez d'utiliser SSL/TLS pour la connexion. Revient à un non-
connexion sécurisée si le serveur ne prend pas en charge SSL/TLS. Voir également --ftp-ssl-
des bactéries ainsi que --ssl-reqd pour les différents niveaux de cryptage requis. (Ajouté dans
7.20.0)

Cette option était auparavant connue sous le nom de --ftp-ssl (Ajouté dans 7.11.0). Ce nom d'option peut
toujours utilisé mais sera supprimé dans une future version.

--ssl-reqd
(FTP, POP3, IMAP, SMTP) Nécessite SSL/TLS pour la connexion. Met fin au
connexion si le serveur ne prend pas en charge SSL/TLS. (Ajouté dans 7.20.0)

Cette option était auparavant connue sous le nom de --ftp-ssl-reqd (ajouté en 7.15.5). Cette option
nom peut toujours être utilisé mais sera supprimé dans une future version.

--ssl-allow-beast
(SSL) Cette option indique à curl de ne pas contourner une faille de sécurité dans le SSL3 et
Protocoles TLS1.0 connus sous le nom de BEAST. Si cette option n'est pas utilisée, la couche SSL peut utiliser
solutions de contournement connues pour causer des problèmes d'interopérabilité avec certains SSL plus anciens
implémentations. ATTENTION : cette option desserre la sécurité SSL, et en utilisant cette
drapeau que vous demandez exactement cela. (Ajouté dans 7.25.0)

--ssl-no-revoke
(WinSSL) Cette option indique à curl de désactiver les vérifications de révocation de certificat. ATTENTION:
cette option desserre la sécurité SSL, et en utilisant ce drapeau vous demandez exactement
cette. (Ajouté dans 7.44.0)

--socks4
Utilisez le proxy SOCKS4 spécifié. Si le numéro de port n'est pas spécifié, il est supposé
au port 1080. (Ajouté dans 7.15.2)

Cette option remplace toute utilisation précédente de -X, --Procuration, car ils sont mutuellement
exclusive.

Depuis la 7.21.7, cette option est superflue puisque vous pouvez spécifier un proxy chaussettes4 avec
-X, --Procuration en utilisant un préfixe de protocole chaussettes4://.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--socks4a
Utilisez le proxy SOCKS4a spécifié. Si le numéro de port n'est pas spécifié, il est supposé
au port 1080. (Ajouté dans 7.18.0)

Cette option remplace toute utilisation précédente de -X, --Procuration, car ils sont mutuellement
exclusive.

Depuis 7.21.7, cette option est superflue puisque vous pouvez spécifier un proxy chaussettes4a avec
-X, --Procuration en utilisant un préfixe de protocole chaussettes4a://.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--socks5-nom d'hôte
Utilisez le proxy SOCKS5 spécifié (et laissez le proxy résoudre le nom d'hôte). Si la
le numéro de port n'est pas spécifié, il est supposé au port 1080. (Ajouté dans 7.18.0)

Cette option remplace toute utilisation précédente de -X, --Procuration, car ils sont mutuellement
exclusive.

Depuis la 7.21.7, cette option est superflue puisque vous pouvez spécifier un nom d'hôte chaussettes5
proxy avec -X, --Procuration en utilisant un préfixe de protocole chaussettes5h://.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée. (Cette option était
précédemment mal documenté et utilisé comme --socks sans le numéro ajouté.)

--socks5
Utilisez le proxy SOCKS5 spécifié - mais résolvez le nom d'hôte localement. Si le port
n'est pas spécifié, il est supposé au port 1080.

Cette option remplace toute utilisation précédente de -X, --Procuration, car ils sont mutuellement
exclusive.

Depuis la 7.21.7, cette option est superflue puisque vous pouvez spécifier un proxy chaussettes5 avec
-X, --Procuration en utilisant un préfixe de protocole chaussettes5://.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée. (Cette option était
précédemment mal documenté et utilisé comme --socks sans le numéro ajouté.)

Cette option (ainsi que --chaussettes4) ne fonctionne pas avec IPV6, FTPS ou LDAP.

--socks5-gssapi-service
Le nom de service par défaut pour un serveur de chaussettes est rcmd/server-fqdn. Cette option permet
à vous de le changer.

Exemples : --socks5 nom-proxy --socks5-gssapi-service sockd utiliserait sockd/proxy-
nom --socks5 nom-proxy --socks5-gssapi-service sockd/real-name utiliserait
sockd/real-name pour les cas où le proxy-name ne correspond pas au nom principal.
(Ajouté en 7.19.4).

--socks5-gssapi-nec
Dans le cadre de la négociation GSS-API, un mode de protection est négocié. RFC 1961 dit
dans la section 4.3/4.4, il devrait être protégé, mais l'implémentation de référence NEC
ne fait pas. L'option --socks5-gssapi-nec permet l'échange non protégé du
négociation du mode de protection. (Ajouté en 7.19.4).

--stderr
Rediriger toutes les écritures vers stderr vers le fichier spécifié à la place. Si le nom du fichier est un
plain '-', il est écrit à la place dans stdout.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-t, --telnet-option
Passez les options au protocole telnet. Les options prises en charge sont :

TTYPE= Définit le type de terminal.

XDISPLOC= Définit l'emplacement d'affichage X.

NEW_ENV= Définit une variable d'environnement.

-T, --upload-file
Cela transfère le fichier local spécifié vers l'URL distante. S'il n'y a pas de partie de fichier
dans l'URL spécifiée, Curl ajoutera le nom du fichier local. NOTEZ que vous devez utiliser
un / de fin sur le dernier répertoire pour vraiment prouver à Curl qu'il n'y a pas de fichier
name ou curl penseront que votre dernier nom de répertoire est le nom du fichier distant à
utilisation. Cela entraînera probablement l'échec de l'opération de téléchargement. S'il est utilisé sur
un serveur HTTP(S), la commande PUT sera utilisée.

Utilisez le nom de fichier "-" (un seul tiret) pour utiliser stdin au lieu d'un fichier donné.
Alternativement, le nom de fichier "." (un seul point) peut être spécifié au lieu de "-" pour
utiliser stdin en mode non bloquant pour permettre la lecture de la sortie du serveur pendant que stdin est en cours
téléchargé.

Vous pouvez spécifier un -T pour chaque URL sur la ligne de commande. Chaque paire -T + URL
spécifie ce qu'il faut télécharger et où. curl prend également en charge le "globbing" du -T
argument, ce qui signifie que vous pouvez télécharger plusieurs fichiers vers une seule URL en utilisant le
même style de globalisation d'URL pris en charge dans l'URL, comme ceci :

curl -T "{fichier1,fichier2}" http://www.uploadtothissite.com

ou encore

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

--tcp-nodelay
Activez l'option TCP_NODELAY. Voir le curl_easy_setopt(3) page de manuel pour plus de détails
à propos de cette option. (Ajouté en 7.11.2)

--tftp-blksize
(TFTP) Définissez l'option TFTP BLKSIZE (doit être >512). C'est la taille du bloc qui boucle
essaiera d'utiliser lors du transfert de données vers ou depuis un serveur TFTP. Par défaut 512
octets seront utilisés.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

(Ajouté dans 7.20.0)

--tlsauthtype
Définissez le type d'authentification TLS. Actuellement, la seule option prise en charge est "SRP", pour
TLS-SRP (RFC 5054). Si --tlsuser ainsi que --tlsmot de passe sont spécifiés mais --tlsauthtype
n'est pas, alors cette option est par défaut "SRP". (Ajouté au 7.21.4)

--tlspassword
Définir le mot de passe à utiliser avec la méthode d'authentification TLS spécifiée avec
--tlsauthtype. Nécessite que --tlsuser également être réglé. (Ajouté au 7.21.4)

--tlsuser
Définir le nom d'utilisateur à utiliser avec la méthode d'authentification TLS spécifiée avec
--tlsauthtype. Nécessite que --tlsmot de passe également être réglé. (Ajouté au 7.21.4)

--tlsv1.0
(SSL) Force curl à utiliser TLS version 1.0 lors de la négociation avec un serveur TLS distant.
(Ajouté dans 7.34.0)

--tlsv1.1
(SSL) Force curl à utiliser TLS version 1.1 lors de la négociation avec un serveur TLS distant.
(Ajouté dans 7.34.0)

--tlsv1.2
(SSL) Force curl à utiliser TLS version 1.2 lors de la négociation avec un serveur TLS distant.
(Ajouté dans 7.34.0)

--tr-encodage
(HTTP) Demander une réponse de codage de transfert compressée à l'aide de l'un des algorithmes
curl prend en charge et décompressez les données lors de leur réception.

(Ajouté dans 7.21.6)

--trace
Permet un vidage de trace complet de toutes les données entrantes et sortantes, y compris descriptives
informations, au fichier de sortie donné. Utilisez "-" comme nom de fichier pour que la sortie soit envoyée
à la sortie standard.

Cette option remplace les utilisations précédentes de -dans, --verbeux or --trace-ascii.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--trace-ascii
Permet un vidage de trace complet de toutes les données entrantes et sortantes, y compris descriptives
informations, au fichier de sortie donné. Utilisez "-" comme nom de fichier pour que la sortie soit envoyée
à la sortie standard.

Ceci est très similaire à --tracer, mais laisse de côté la partie hexadécimale et n'affiche que le
Partie ASCII du vidage. Il fait une sortie plus petite qui pourrait être plus facile à lire pour
humains non entraînés.

Cette option remplace les utilisations précédentes de -dans, --verbeux or --tracer.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--trace-temps
Ajoute un horodatage à chaque trace ou ligne détaillée que curl affiche. (Ajouté dans
7.14.0)

--unix-socket
(HTTP) Connectez-vous via ce socket de domaine Unix, au lieu d'utiliser le réseau.
(Ajouté dans 7.40.0)

-u, --user
Spécifiez le nom d'utilisateur et le mot de passe à utiliser pour l'authentification du serveur. Dérogations -n,
--netrc ainsi que --netrc-facultatif.

Si vous spécifiez simplement le nom d'utilisateur, curl vous demandera un mot de passe.

Le nom d'utilisateur et les mots de passe sont séparés sur le premier deux-points, ce qui rend
impossible d'utiliser deux points dans le nom d'utilisateur avec cette option. Le mot de passe peut,
encore.

Lorsque vous utilisez Kerberos V5 avec un serveur Windows, vous devez inclure le
nom de domaine dans le nom d'utilisateur, afin que le serveur obtienne avec succès un
Billet Kerberos. Si vous ne le faites pas, la négociation d'authentification initiale peut échouer.

Lors de l'utilisation de NTLM, le nom d'utilisateur peut être spécifié simplement comme nom d'utilisateur, sans
le domaine, s'il y a un seul domaine et forêt dans votre configuration par exemple.

Pour spécifier le nom de domaine, utilisez le nom de connexion de niveau inférieur ou l'UPN (utilisateur principal
Nom). Par exemple, EXEMPLE\utilisateur et [email protected] respectivement.

Si vous utilisez un binaire curl Windows SSPI et exécutez Kerberos V5, Negotiate,
Authentification NTLM ou Digest, vous pouvez alors demander à curl de sélectionner le nom d'utilisateur et
mot de passe de votre environnement en spécifiant un seul deux-points avec cette option : "-u
: ".

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-U, --proxy-user
Spécifiez le nom d'utilisateur et le mot de passe à utiliser pour l'authentification proxy.

Si vous utilisez un binaire curl Windows SSPI et effectuez soit Negotiate soit NTLM
authentification, vous pouvez demander à curl de sélectionner le nom d'utilisateur et le mot de passe à partir de
votre environnement en spécifiant un seul deux-points avec cette option : "-U :".

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--url
Spécifiez une URL à récupérer. Cette option est surtout pratique lorsque vous souhaitez spécifier des URL
dans un fichier de configuration.

S'il manque un nom de schéma à l'URL donnée (comme "http://" ou "ftp://", etc.), alors
curl fera une supposition en fonction de l'hôte. Si le nom de sous-domaine le plus externe correspond
DICT, FTP, IMAP, LDAP, POP3 ou SMTP alors ce protocole sera utilisé, sinon HTTP
sera utilisé. Depuis 7.45.0, la devinette peut être désactivée en définissant un protocole par défaut,
sur le lien --proto-par défaut pour en savoir plus.

Cette option peut être utilisée un nombre illimité de fois. Pour contrôler où cette URL est écrite,
utiliser le -o, --output au sein de l’ -Ô, --nom-distant options.

-v, --verbeux
Soyez plus bavard/bavard pendant l'opération. Utile pour déboguer et voir
ce qui se passe "sous le capot". Une ligne commençant par « > » signifie « données d'en-tête » envoyées
par curl, '<' signifie "données d'en-tête" reçues par curl qui sont masquées dans les cas normaux,
et une ligne commençant par '*' signifie des informations supplémentaires fournies par curl.

Notez que si vous voulez uniquement des en-têtes HTTP dans la sortie, -je, --comprendre pourrait être le
option que vous recherchez.

Si vous pensez que cette option ne vous donne toujours pas assez de détails, envisagez d'utiliser
--tracer or --trace-ascii à la place.

Cette option remplace les utilisations précédentes de --trace-ascii or --tracer.

Utilisez -Oui, --silencieux pour rendre le curl silencieux.

-w, --write-out
Faire curl afficher les informations sur stdout après un transfert terminé. Le format est un
chaîne pouvant contenir du texte brut mélangé à un nombre quelconque de variables. Le format
peut être spécifié comme une "chaîne" littérale, ou vous pouvez demander à curl de lire le format à partir d'un
fichier avec "@filename" et pour dire à curl de lire le format à partir de stdin que vous écrivez
"@-".

Les variables présentes dans le format de sortie seront remplacées par la valeur ou le texte
cette boucle pense appropriée, comme décrit ci-dessous. Toutes les variables sont spécifiées comme
%{variable_name} et pour afficher un % normal, vous les écrivez simplement sous la forme %%. Vous pouvez sortir
une nouvelle ligne en utilisant \n, un retour chariot avec \r et une tabulation avec \t.

REMARQUE: Le symbole % est un symbole spécial dans l'environnement win32, où tous
les occurrences de % doivent être doublées lors de l'utilisation de cette option.

Les variables disponibles sont :

Content_type Le type de contenu du document demandé, le cas échéant.

nom_fichier_effectif
Le nom de fichier ultime dans lequel curl écrit. C'est seulement
significatif si curl est invité à écrire dans un fichier avec le --nom-distant
or --output option. Il est plus utile en combinaison avec le
--nom-en-tête-à distance option. (Ajouté dans 7.25.1)

ftp_entry_path Le chemin initial curl s'est terminé lors de la connexion au FTP distant
serveur. (Ajouté en 7.15.4)

code_http Le code de réponse numérique qui a été trouvé dans le dernier extrait
Transfert HTTP(S) ou FTP(s). En 7.18.2 l'alias Code de réponse était
ajouté pour afficher les mêmes informations.

http_connecter Le code numérique trouvé dans la dernière réponse (à partir d'un
proxy) à une requête curl CONNECT. (Ajouté en 7.12.4)

local_ip L'adresse IP de l'extrémité locale de la dernière connexion effectuée
- peut être IPv4 ou IPv6 (Ajouté dans 7.29.0)

port_local Le numéro de port local de la dernière connexion effectuée (ajouté dans
7.29.0)

nombre_connexions Nombre de nouvelles connexions effectuées lors du transfert récent. (Ajouté dans
7.12.3)

nombre_redirections Nombre de redirections qui ont été suivies dans la demande. (Ajouté dans
7.12.3)

redirect_url Lorsqu'une requête HTTP a été faite sans -L pour suivre les redirections, cela
La variable affichera l'URL réelle d'une redirection pourra vous emmener à.
(Ajouté dans 7.18.2)

remote_ip L'adresse IP distante de la dernière connexion établie - peut être
IPv4 ou IPv6 (Ajouté dans 7.29.0)

port_distant Le numéro de port distant de la dernière connexion effectuée (ajouté
dans 7.29.0)

taille_télécharger Le nombre total d'octets qui ont été téléchargés.

taille_en-tête Le nombre total d'octets des en-têtes téléchargés.

taille_request Le nombre total d'octets qui ont été envoyés dans la requête HTTP.

taille_upload Le nombre total d'octets qui ont été téléchargés.

speed_download La vitesse de téléchargement moyenne que curl mesurée pour l'ensemble
Télécharger. Octets par seconde.

vitesse_upload La vitesse de téléchargement moyenne que curl mesurée pour le téléchargement complet.
Octets par seconde.

ssl_verify_result
Le résultat de la vérification du certificat d'homologue SSL qui a été
demandé. 0 signifie que la vérification a réussi. (Ajouté dans
7.19.0)

time_appconnect
Le temps, en secondes, qu'il a fallu du début jusqu'au SSL/SSH/etc
la connexion/l'établissement de liaison avec l'hôte distant a été effectué. (Ajouté dans
7.19.0)

heure_connecter Le temps, en secondes, qu'il a fallu depuis le début jusqu'à la connexion TCP
à l'hôte distant (ou proxy) a été effectuée.

recherche_nom_heure
Le temps, en secondes, qu'il a fallu depuis le début jusqu'au nom
la résolution était terminée.

time_pretransfer
Le temps, en secondes, qu'il a fallu depuis le début jusqu'au transfert de fichier
était sur le point de commencer. Cela inclut toutes les commandes de pré-transfert et
négociations qui sont spécifiques au(x) protocole(s) particulier(s)
impliqué.

time_redirect Le temps, en secondes, qu'il a fallu pour que toutes les étapes de redirection incluent le nom
recherche, connexion, pré-transfert et transfert avant la finale
la transaction a été lancée. time_redirect montre l'exécution complète
temps pour plusieurs redirections. (Ajouté en 7.12.3)

time_starttransfer
Le temps, en secondes, qu'il a fallu depuis le début jusqu'au premier octet
était sur le point d'être transféré. Cela inclut time_pretransfer et
également le temps nécessaire au serveur pour calculer le résultat.

temps_total Le temps total, en secondes, que l'opération complète a duré. Le temps
sera affiché avec une résolution en millisecondes.

url_efficace L'URL qui a été récupérée en dernier. Ceci est plus significatif si vous avez
a dit à curl de suivre l'emplacement : en-têtes.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-x, --proxy <[protocol://][user:password@]proxyhost[:port]>
Utilisez le proxy spécifié.

La chaîne proxy peut être spécifiée avec un préfixe protocol:// pour spécifier une alternative
protocoles proxy. Utilisez chaussettes4://, chaussettes4a://, chaussettes5:// ou chaussettes5h:// pour demander le
version SOCKS spécifique à utiliser. Aucun protocole spécifié, http:// et tous les autres
seront traités comme des proxys HTTP. (Le support du protocole a été ajouté dans curl 7.21.7)

Si le numéro de port n'est pas spécifié dans la chaîne proxy, il est supposé être 1080.

Cette option remplace les variables d'environnement existantes qui définissent le proxy à utiliser. Si
il y a une variable d'environnement définissant un proxy, vous pouvez définir le proxy sur "" pour
le remplacer.

Toutes les opérations qui sont effectuées sur un proxy HTTP seront de manière transparente
converti en HTTP. Cela signifie que certaines opérations spécifiques au protocole peuvent ne pas être
disponible. Ce n'est pas le cas si vous pouvez passer par le proxy, comme un avec
le -p, --proxytunnel option.

L'utilisateur et le mot de passe qui pourraient être fournis dans la chaîne de proxy sont l'URL décodée par
boucle. Cela vous permet de transmettre des caractères spéciaux tels que @ en utilisant %40 ou de passer
dans un deux-points avec %3a.

L'hôte proxy peut être spécifié exactement de la même manière que l'environnement proxy
variables, y compris le préfixe du protocole (http://) et l'utilisateur intégré +
mot de passe.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-X, --requête
(HTTP) Spécifie une méthode de requête personnalisée à utiliser lors de la communication avec le HTTP
serveur. La méthode de requête spécifiée sera utilisée à la place de la méthode sinon
utilisé (qui est par défaut GET). Lisez la spécification HTTP 1.1 pour plus de détails et
explications. Les requêtes HTTP supplémentaires courantes incluent PUT et DELETE, mais liées
des technologies telles que WebDAV offrent PROPFIND, COPY, MOVE et plus encore.

Normalement, vous n'avez pas besoin de cette option. Toutes sortes de requêtes GET, HEAD, POST et PUT
sont plutôt invoqués en utilisant des options de ligne de commande dédiées.

Cette option ne change que le mot réel utilisé dans la requête HTTP, elle ne change pas
modifier le comportement de curl. Donc par exemple si vous voulez faire un vrai HEAD
demande, l'utilisation de -X HEAD ne suffira pas. Vous devez utiliser le -JE, --diriger option.

La chaîne de méthode que vous définissez avec -X sera utilisée pour toutes les requêtes, qui si vous pour
exemple d'utilisation -L, --emplacement peut provoquer des effets secondaires involontaires lorsque curl ne fonctionne pas
changer la méthode de demande selon les codes de réponse HTTP 30x - et similaires.

(FTP) Spécifie une commande FTP personnalisée à utiliser à la place de LIST lors de la création de listes de fichiers
avec FTP.

(POP3) Spécifie une commande POP3 personnalisée à utiliser à la place de LIST ou RETR. (Ajouté dans
7.26.0)

(IMAP) Spécifie une commande IMAP personnalisée à utiliser à la place de LIST. (Ajouté dans 7.30.0)

(SMTP) Spécifie une commande SMTP personnalisée à utiliser à la place de HELP ou VRFY. (Ajouté dans
7.34.0)

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

--xattr
Lors de l'enregistrement de la sortie dans un fichier, cette option indique à curl de stocker certaines métadonnées de fichier
dans les attributs de fichier étendus. Actuellement, l'URL est stockée dans le xdg.origin.url
et, pour HTTP, le type de contenu est stocké dans l'attribut mime_type. Si
le système de fichiers ne prend pas en charge les attributs étendus, un avertissement est émis.

-y, --speed-time
Si un téléchargement est plus lent que la vitesse limite en octets par seconde pendant un temps de vitesse
période, le téléchargement est interrompu. Si speed-time est utilisé, la limite de vitesse par défaut
sera 1 à moins qu'il ne soit défini avec -Y.

Cette option contrôle les transferts et n'affectera donc pas les connexions lentes, etc.
est une préoccupation pour vous, essayez le --connect-timeout option.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-Y, --speed-limit
Si un téléchargement est plus lent que cette vitesse donnée (en octets par seconde) pour la vitesse-temps
secondes, il est interrompu. vitesse-temps est réglé avec -y et est de 30 s'il n'est pas défini.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-z, --time-cond |
(HTTP/FTP) Demander un fichier qui a été modifié après l'heure indiquée et
date, ou qui a été modifié avant cette heure. Les peut être
toutes sortes de chaînes de date ou si elle ne correspond à aucune chaîne interne, elle est considérée comme
un nom de fichier et essaie d'obtenir la date de modification (mtime) de au lieu. Voir
le curl_getdate(3) pages de manuel pour les détails de l'expression de date.

Commencez l'expression de date par un tiret (-) pour lui demander un document qui est
plus ancien que la date/heure donnée, par défaut est un document qui est plus récent que le
date/heure spécifiée.

Si cette option est utilisée plusieurs fois, la dernière sera utilisée.

-h, --aide
Aide à l'utilisation. Cela répertorie toutes les options de ligne de commande actuelles avec une courte description.

-M, --manuel
Manuel. Affichez l'énorme texte d'aide.

-V, --version
Affiche des informations sur curl et la version de libcurl qu'il utilise.

La première ligne comprend la version complète de curl, libcurl et d'autres tiers
bibliothèques liées à l'exécutable.

La deuxième ligne (commence par "Protocoles :") affiche tous les protocoles signalés par libcurl
soutenir.

La troisième ligne (commence par « Features : ») montre les fonctionnalités spécifiques que libcurl rapporte à
offre. Les fonctionnalités disponibles incluent :

IPv6 Vous pouvez utiliser IPv6 avec cela.

krb4 Krb4 pour FTP est pris en charge.

SSL Les versions SSL de divers protocoles sont prises en charge, tels que HTTPS, FTPS, POP3S
etc.

libz La décompression automatique des fichiers compressés via HTTP est prise en charge.

NTLM L'authentification NTLM est prise en charge.

Debug Cette boucle utilise une libcurl construite avec Debug. Cela permet plus de suivi des erreurs
et le débogage de la mémoire, etc. Pour les développeurs curl uniquement !

AsynchDNS
Cette boucle utilise des résolutions de noms asynchrones. Les résolutions de noms asynchrones peuvent être
fait en utilisant soit les backends c-ares ou les résolveurs threadés.

L'authentification SPNEGO SPNEGO est prise en charge.

Largefile
Cette boucle prend en charge les transferts de fichiers volumineux, les fichiers de plus de 2 Go.

IDN Cette boucle prend en charge les IDN - noms de domaine internationaux.

GSS-API
GSS-API est pris en charge.

SSPI SSPI est pris en charge.

TLS-SRP
L'authentification SRP (Secure Remote Password) est prise en charge pour TLS.

La prise en charge de HTTP2 HTTP/2 a été intégrée.

encre métallique
Cette boucle prend en charge Metalink (versions 3 et 4 (RFC 5854)), qui
décrit les miroirs et les hachages. curl utilisera des miroirs pour le basculement s'il y a
sont des erreurs (telles que l'indisponibilité du fichier ou du serveur).

Utiliser curl en ligne à l'aide des services onworks.net