curl - Online en la nube

PROGRAMA:

NOMBRE

curl - transferir una URL

SINOPSIS

rizo [opciones] [URL ...]

DESCRIPCIÓN

rizo es una herramienta para transferir datos desde o hacia un servidor, utilizando uno de los protocolos compatibles
(DICT, ARCHIVO, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP,
RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET y TFTP). El comando está diseñado para funcionar
sin interacción del usuario.

curl ofrece una gran cantidad de trucos útiles como soporte de proxy, autenticación de usuario, FTP
carga, publicación HTTP, conexiones SSL, cookies, currículum vitae de transferencia de archivos, Metalink y más. Como
Verás a continuación, ¡la cantidad de funciones te hará girar la cabeza!

curl funciona con libcurl para todas las funciones relacionadas con la transferencia. Ver libcurl(3) para obtener más detalles.

Enlance

La sintaxis de la URL depende del protocolo. Encontrará una descripción detallada en RFC 3986.

Puede especificar varias URL o partes de URL escribiendo conjuntos de partes entre llaves como en:

http://site. {uno, dos, tres} .com

o puede obtener secuencias de series alfanuméricas usando [] como en:

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

ftp://ftp.numericals.com/archivo[001-100] .txt (con ceros a la izquierda)

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

Las secuencias anidadas no son compatibles, pero puede usar varias una al lado de la otra:

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

Puede especificar cualquier cantidad de URL en la línea de comando. Serán traídos en un
de manera secuencial en el orden especificado.

Puede especificar un contador de pasos para los rangos para obtener cada enésimo número o letra:

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

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

Al usar secuencias [] o {} cuando se invoca desde una línea de comandos, probablemente tenga
poner la URL completa entre comillas dobles para evitar que el shell interfiera con ella. Esta
también se aplica a otros caracteres tratados de forma especial, como por ejemplo '&', '?' y '*'.

Proporcione el índice de la zona IPv6 en la URL con un signo de porcentaje de escape y la interfaz
nombre. Como en

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

Si especifica una URL sin el prefijo protocol: //, curl intentará adivinar qué protocolo
podrías querer. A continuación, utilizará HTTP de forma predeterminada, pero probará otros protocolos basados ​​en los de uso frecuente.
prefijos de nombre de host. Por ejemplo, para los nombres de host que comienzan con "ftp". curl asumirá que
quiero hablar FTP.

curl hará todo lo posible para usar lo que le pase como URL. No está intentando validarlo
como una URL sintácticamente correcta por cualquier medio, pero en su lugar es muy liberal con lo que
acepta.

curl intentará reutilizar las conexiones para múltiples transferencias de archivos, por lo que obtener muchos
Los archivos del mismo servidor no realizarán múltiples conexiones / apretones de manos. Esto mejora
velocidad. Por supuesto, esto solo se hace en archivos especificados en una sola línea de comando y no puede
ser utilizado entre invocaciones de curl separadas.

PROGRESO MEDIDOR

curl normalmente muestra un medidor de progreso durante las operaciones, que indica la cantidad de
datos transferidos, velocidades de transferencia y tiempo restante estimado, etc.

curl muestra estos datos en la terminal de forma predeterminada, por lo que si invoca a curl para hacer una
operación y está a punto de escribir datos en el terminal, desactiva el medidor de progreso como
de lo contrario, estropearía la salida de mezcla del medidor de progreso y los datos de respuesta.

Si desea un medidor de progreso para las solicitudes HTTP POST o PUT, debe redirigir el
salida de respuesta a un archivo, usando shell redirect (>), -o [archivo] o similar.

No es el mismo caso para la carga FTP ya que esa operación no arroja ninguna respuesta
datos al terminal.

Si prefiere una "barra" de progreso en lugar del medidor normal, -# es su amigo.

CAMPUS

Las opciones comienzan con uno o dos guiones. Muchas de las opciones requieren un valor adicional a continuación.
a ellos.

La forma corta de "un solo guión" de las opciones, -d por ejemplo, puede usarse con o sin un
espacio entre él y su valor, aunque se recomienda un espacio como separador. El largo
La forma de "doble guión", --data, por ejemplo, requiere un espacio entre ella y su valor.

Las opciones de versión corta que no necesitan ningún valor adicional se pueden utilizar inmediatamente a continuación.
entre sí, como por ejemplo, puede especificar todas las opciones -O, -L y -v a la vez como
-OLv.

En general, todas las opciones booleanas están habilitadas con -opción y una vez más discapacitados con
--nO-opción. Es decir, usa exactamente el mismo nombre de opción pero antepone "no-".
Sin embargo, en esta lista, en su mayoría, solo enumeramos y mostramos la versión --option de ellos. (Esta
concepto con --no se agregó ninguna opción en 7.19.0. Anteriormente, la mayoría de las opciones se activaban / desactivaban
en el uso repetido de la misma opción de línea de comando).

-#, --barra de progreso
Haga que el progreso de la visualización de rizos sea una barra de progreso simple en lugar de la estándar, más
informativo, metro.

-:, --Siguiente
Le dice a curl que use una operación separada para la siguiente URL y asociada
opciones. Esto le permite enviar varias solicitudes de URL, cada una con sus propias
opciones, por ejemplo, como diferentes nombres de usuario o solicitudes personalizadas para cada uno.
(Agregado en 7.36.0)

-0, --http1.0
(HTTP) Le dice a curl que use HTTP versión 1.0 en lugar de usar su internamente
preferido: HTTP 1.1.

--http1.1
(HTTP) Le dice a curl que use HTTP versión 1.1. Ésta es la versión interna predeterminada.
(Agregado en 7.33.0)

--http2
(HTTP) Le dice a curl que emita sus solicitudes usando HTTP 2. Esto requiere que el
libcurl subyacente fue construido para soportarlo. (Agregado en 7.33.0)

--no-npn
Deshabilite la extensión NPN TLS. NPN está habilitado por defecto si libcurl fue construido con
una biblioteca SSL que admite NPN. NPN es utilizado por una libcurl que admite HTTP 2 para
negociar la compatibilidad con HTTP 2 con el servidor durante las sesiones https.

(Agregado en 7.36.0)

--no-alpn
Deshabilite la extensión ALPN TLS. ALPN está habilitado por defecto si libcurl fue construido
con una biblioteca SSL que admita ALPN. ALPN es utilizado por una libcurl que admite
HTTP 2 para negociar la compatibilidad con HTTP 2 con el servidor durante las sesiones https.

(Agregado en 7.36.0)

-1, --tlsv1
(SSL) Obliga a curl a utilizar la versión 1.x de TLS al negociar con un servidor TLS remoto.
Puedes usar opciones --tlsv1.0, --tlsv1.1y --tlsv1.2 para controlar la versión TLS
más precisamente (si el backend SSL en uso admite tal nivel de control).

-2, --sslv2
(SSL) Obliga a curl a utilizar SSL versión 2 al negociar con un servidor SSL remoto.
A veces, curl se crea sin compatibilidad con SSLv2. SSLv2 se considera inseguro
(ver RFC 6176).

-3, --sslv3
(SSL) Obliga a curl a utilizar SSL versión 3 al negociar con un servidor SSL remoto.
A veces, curl se crea sin compatibilidad con SSLv3. SSLv3 se considera inseguro
(ver RFC 7568).

-4, --ipv4
Esta opción le dice a curl que resuelva nombres solo en direcciones IPv4, y no, por ejemplo
prueba IPv6.

-6, --ipv6
Esta opción le dice a curl que resuelva nombres solo en direcciones IPv6, y no, por ejemplo
prueba IPv4.

-a, --anexar
(FTP / SFTP) Cuando se usa en una carga, esto hace que curl se agregue al archivo de destino
en lugar de sobrescribirlo. Si el archivo remoto no existe, se creará.
Tenga en cuenta que algunos servidores SFTP (incluido OpenSSH) ignoran esta bandera.

-A, --usuario-agente
(HTTP) Especifique la cadena de agente de usuario para enviar al servidor HTTP. Algunos mal hechos
Los CGI fallan si este campo no está configurado en "Mozilla / 4.0". Para codificar espacios en blanco en la cadena,
rodee la cadena con comillas simples. Esto también se puede configurar con el -H,
--encabezamiento opción por supuesto.

Si esta opción se usa varias veces, se usará la última.

--anyauth
(HTTP) Le dice a curl que averigüe el método de autenticación por sí mismo y utilice la mayor cantidad de
asegure uno que el sitio remoto afirma ser compatible. Esto se hace primero haciendo una solicitud
y comprobar los encabezados de respuesta, lo que posiblemente induzca una ronda de red adicional
viaje. Esto se utiliza en lugar de establecer un método de autenticación específico, que
puedo hacer con --básico, --digerir, --ntlmy --negociar.

Tenga en cuenta que no se recomienda usar --anyauth si realiza cargas desde stdin, ya que
puede requerir que los datos se envíen dos veces y luego el cliente debe poder rebobinar. Si
debe surgir la necesidad al cargar desde stdin, la operación de carga fallará.

-b, - galleta
(HTTP) Pasa los datos al servidor HTTP como una cookie. Supuestamente son los datos
recibido previamente del servidor en una línea "Set-Cookie:". Los datos deben estar en
el formato "NOMBRE1 = VALOR1; NOMBRE2 = VALOR2".

Si no se usa el símbolo '=' en la línea, se trata como un nombre de archivo para usar para leer
líneas de cookies almacenadas previamente de, que deben usarse en esta sesión si
fósforo. El uso de este método también activa el motor de cookies que hará que el rizo
también registre las cookies entrantes, lo que puede ser útil si está usando esto en combinación
con el -l, --localización opción. El formato de archivo del archivo para leer las cookies
deben ser encabezados HTTP simples o el formato de archivo de cookies de Netscape / Mozilla.

El archivo especificado con -B, --Galleta solo se utiliza como entrada. No habrá cookies
escrito en el archivo. Para almacenar cookies, use el -C, --tarro de galletas .

Tenga cuidado si está usando esta opción y pueden ocurrir múltiples transferencias. Si
usas NAME1 = VALUE1; formato, o en un archivo use el formato Set-Cookie y no
especificar un dominio, la cookie se envía para cualquier dominio (incluso después de que se
seguido) y no puede ser modificado por una cookie configurada por el servidor. Si el motor de cookies es
habilitado y un servidor establece una cookie con el mismo nombre, entonces ambos se enviarán en un
transferencia futura a ese servidor, probablemente no sea lo que pretendía. Para abordar estos
Los problemas establecen un dominio en Set-Cookie (al hacerlo, se incluirán subdominios) o usar el
Formato de Netscape.

Si esta opción se usa varias veces, se usará la última.

-B, --use-ascii
(FTP / LDAP) Habilita la transferencia ASCII. Para FTP, esto también se puede hacer cumplir mediante un
URL que termina con "; tipo = A". Esta opción hace que los datos enviados a stdout estén en texto
modo para sistemas win32.

--básico
(HTTP) Le dice a curl que utilice la autenticación básica HTTP con el host remoto. Este es
el valor predeterminado y esta opción generalmente no tiene sentido, a menos que la use para anular un
opción configurada previamente que establece un método de autenticación diferente (como --ntlm,
--digeriro --negociar).

Usado junto con -tu, --usuario y -X, --apoderado.

Vea también --proxy-básico.

-c, - tarro de galletas
(HTTP) Especifique en qué archivo desea que curl escriba todas las cookies después de completar
operación. Curl escribe todas las cookies leídas previamente de un archivo específico, así como
todas las cookies recibidas de servidores remotos. Si no se conocen cookies, no habrá datos
ser escrito. El archivo se escribirá utilizando el formato de archivo de cookies de Netscape. Si tu
establezca el nombre del archivo en un solo guión, "-", las cookies se escribirán en stdout.

Esta opción de línea de comando activará el motor de cookies que hace que curl registre y
utilizar cookies. Otra forma de activarlo es usar el -B, --Galleta .

Si no se puede crear o escribir en el tarro de galletas, toda la operación de curl no
fallar o incluso informar un error claramente. El uso de -v mostrará una advertencia, pero
esa es la única retroalimentación visible que recibe sobre esta situación posiblemente letal.

Desde 7.43.0 cookies que se importaron en el formato Set-Cookie sin un dominio
Esta opción no exporta el nombre.

Si esta opción se usa varias veces, se usará el último nombre de archivo especificado.

-C, --continuar-en
Continuar / Reanudar una transferencia de archivo anterior en el desplazamiento dado. El desplazamiento dado es
el número exacto de bytes que se omitirán, contando desde el principio de la
archivo de origen antes de que se transfiera al destino. Si se usa con cargas, el
Curl no utilizará el comando SIZE del servidor FTP.

Utilice "-C -" para decirle a curl que averigüe automáticamente dónde y cómo reanudar la transferencia.
Luego usa los archivos de entrada / salida dados para averiguarlo.

Si esta opción se usa varias veces, se usará la última.

--cifras
(SSL) Especifica qué cifrados utilizar en la conexión. La lista de cifrados debe
especificar cifrados válidos. Lea los detalles de la lista de cifrado SSL en esta URL:
https://www.openssl.org/docs/apps/ciphers.html

Los cifrados NSS se realizan de manera diferente a OpenSSL y GnuTLS. La lista completa de NSS
ciphers está en la entrada NSSCipherSuite en esta URL:
https://git.fedorahosted.org/cgit/mod_nss.git/plain/docs/mod_nss.html#Directives

Si esta opción se usa varias veces, se usará la última.

--comprimido
(HTTP) Solicite una respuesta comprimida utilizando uno de los algoritmos que admite curl, y
guarde el documento sin comprimir. Si se utiliza esta opción y el servidor envía un
codificación no admitida, curl informará de un error.

--connect-timeout
Tiempo máximo en segundos que permites que tome la conexión de curl. Esto solo limita
la fase de conexión, por lo que si curl se conecta dentro del período dado, continuará
- si no, saldrá. Desde la versión 7.32.0, esta opción acepta valores decimales.

Vea también el -metro, --máx-tiempo .

Si esta opción se usa varias veces, se usará la última.

--crear-dirs
Cuando se usa junto con el -o opción, curl creará el local necesario
jerarquía de directorios según sea necesario. Esta opción crea los directorios mencionados con el -o
opción, nada más. Si el -o el nombre del archivo no usa dir o si los directorios que menciona
ya existe, no se creará ningún directorio.

Para crear directorios remotos al usar FTP o SFTP, intente --ftp-crear-directorios.

--crlf Convierte LF a CRLF en la carga. Útil para MVS (OS / 390).

(SMTP agregado en 7.40.0)

--crlfile
(HTTPS / FTPS) Proporcione un archivo con formato PEM con una lista de revocación de certificados
que puede especificar certificados de pares que se considerarán revocados.

Si esta opción se usa varias veces, se usará la última.

(Agregado en 7.19.7)

-d, --data
(HTTP) Envía los datos especificados en una solicitud POST al servidor HTTP, en el mismo
forma en que lo hace un navegador cuando un usuario ha completado un formulario HTML y presiona el botón
botón de enviar. Esto hará que curl pase los datos al servidor usando el
aplicación de tipo de contenido / x-www-form-urlencoded. Comparar con -F, --formulario.

-D, --datos es el mismo que --datos-ascii. --datos sin procesar es casi lo mismo pero no
tienen una interpretación especial del carácter @. Para publicar datos puramente binarios,
en su lugar debería usar el --datos-binarios opción. Para codificar en URL el valor de un formulario
campo que puede usar --código de URL de datos.

Si alguna de estas opciones se usa más de una vez en la misma línea de comando, los datos
las piezas especificadas se fusionarán con un símbolo & de separación. Por lo tanto, usando
'-d name = daniel -d skill = pésimo' generaría un fragmento de publicación que se parece a
'nombre = daniel & skill = pésimo'.

Si comienza los datos con la letra @, el resto debe ser un nombre de archivo para leer el
data from, o - si desea que curl lea los datos de stdin. Varios archivos pueden
también se especificará. Publicar datos de un archivo llamado 'foobar' se haría entonces con
--datos @foobar. Cuando se le dice a --data que lea de un archivo como ese, el carro retorna
y las nuevas líneas se eliminarán. Si no desea que el carácter @ tenga un
uso de interpretación especial --datos sin procesar preferiblemente.

-D, --dump-header
Escribe los encabezados del protocolo en el archivo especificado.

Esta opción es útil para usar cuando desea almacenar los encabezados que un sitio HTTP
te envía. Las cookies de los encabezados se podrían leer en un segundo rizo
invocación utilizando el -B, --Galleta ¡opción! los -C, --tarro de galletas la opción es una
mejor forma de almacenar cookies.

Cuando se utiliza en FTP, las líneas de respuesta del servidor FTP se consideran "encabezados" y
así se guardan allí.

Si esta opción se usa varias veces, se usará la última.

--data-ascii
See -D, --datos.

--data-binary
(HTTP) Esto publica los datos exactamente como se especifica sin ningún procesamiento adicional.

Si comienza los datos con la letra @, el resto debe ser un nombre de archivo. Los datos son
publicado de manera similar a --datos-ascii lo hace, excepto que las nuevas líneas y el carro
los retornos se conservan y las conversiones nunca se realizan.

Si esta opción se usa varias veces, las que siguen a la primera agregarán datos
como se describe en -D, --datos.

--data-raw
(HTTP) Esto publica datos de manera similar a --datos pero sin la interpretación especial
del carácter @. Ver -D, --datos. (Agregado en 7.43.0)

--data-urlencode
(HTTP) Esto publica datos, similar a las otras opciones --data con la excepción de que
esto realiza la codificación de URL. (Agregado en 7.18.0)

Para ser compatible con CGI, el parte debe comenzar con un nombre seguido por un
separador y una especificación de contenido. los parte se puede pasar al rizo usando
una de las siguientes sintaxis:

contenido
Esto hará que curl codifique en URL el contenido y lo transmita. Sólo sé cuidadoso
para que el contenido no contenga ningún símbolo = o @, ya que entonces
¡Haga que la sintaxis coincida con uno de los otros casos a continuación!

= contenido
Esto hará que curl codifique en URL el contenido y lo transmita. El anterior =
El símbolo no está incluido en los datos.

nombre = contenido
Esto hará que curl codifique en URL la parte del contenido y la transmita. Tenga en cuenta que
Se espera que la parte del nombre ya esté codificada en URL.

@Nombre del archivo
Esto hará que curl cargue datos desde el archivo dado (incluyendo cualquier nueva línea),
Codifique en URL esos datos y transmítalos en el POST.

nombre @ nombre de archivo
Esto hará que curl cargue datos desde el archivo dado (incluyendo cualquier nueva línea),
Codifique en URL esos datos y transmítalos en el POST. La parte del nombre obtiene un igual
signo adjunto, lo que resulta en nombre = contenido-archivo-codificado-urlen. Tenga en cuenta que el nombre
se espera que ya esté codificado en URL.

- NIVEL de delegación
Set NIVEL para decirle al servidor lo que puede delegar cuando se trata de usuario
cartas credenciales. Usado con GSS / kerberos.

ninguno No permite ninguna delegación.

política Delega si y solo si el indicador OK-AS-DELEGATE está establecido en Kerberos
ticket de servicio, que es una cuestión de política del reino.

siempre Permitir incondicionalmente que el servidor delegue.

--digerir
(HTTP) Habilita la autenticación HTTP Digest. Este es un esquema de autenticación que
evita que la contraseña se envíe por cable en texto sin cifrar. Usa esto en
combinación con lo normal -tu, --usuario opción para configurar el nombre de usuario y la contraseña. Ver
también --ntlm, --negociar y --anyauth para opciones relacionadas.

Si esta opción se usa varias veces, solo se usa la primera.

--disable-eprt
(FTP) Dile a curl que desactive el uso de los comandos EPRT y LPRT cuando esté activo
Transferencias FTP. Curl normalmente siempre intentará primero usar EPRT, luego LPRT
antes de usar PORT, pero con esta opción, usará PORT de inmediato. EPRT y LPRT
son extensiones del protocolo FTP original y es posible que no funcionen en todos los servidores, pero
permiten más funcionalidad de una mejor manera que el comando PORT tradicional.

--eprt se puede utilizar para habilitar explícitamente EPRT de nuevo y --sin-eprt es un alias para
--disable-eprt.

La desactivación de EPRT solo cambia el comportamiento activo. Si quieres cambiar a pasivo
modo que no necesitas usar -PAG, --puerto ftp o forzarlo con --ftp-pasv.

--disable-epsv
(FTP) Dile a curl que desactive el uso del comando EPSV al hacer FTP pasivo
transferencias. Normalmente, Curl siempre intentará utilizar EPSV antes que PASV, pero
con esta opción, no intentará utilizar EPSV.

--epsv se puede usar para habilitar explícitamente EPSV nuevamente y --no-epsv es un alias para
--disable-epsv.

La desactivación de EPSV solo cambia el comportamiento pasivo. Si desea cambiar a activo
modo que necesitas usar -PAG, --puerto ftp.

--dns-interfaz
Dile a curl que envíe solicitudes de DNS salientes a través de . Esta opción es una
contraparte de --interfaz (que no afecta al DNS). La cadena suministrada debe ser
un nombre de interfaz (no una dirección).

Esta opción requiere que libcurl se haya creado con un servidor de resolución que admita
esta operacion. El backend de c-ares es el único de este tipo. (Agregado en 7.33.0)

--dns-ipv4-addr
Dile a curl que se una al realizar solicitudes de DNS IPv4, de modo que el DNS
las solicitudes se originan en esta dirección. El argumento debe ser una única dirección IPv4.

Esta opción requiere que libcurl se haya creado con un servidor de resolución que admita
esta operacion. El backend de c-ares es el único de este tipo. (Agregado en 7.33.0)

--dns-ipv6-addr
Dile a curl que se una al realizar solicitudes de DNS IPv6, de modo que el DNS
las solicitudes se originan en esta dirección. El argumento debe ser una única dirección IPv6.

Esta opción requiere que libcurl se haya creado con un servidor de resolución que admita
esta operacion. El backend de c-ares es el único de este tipo. (Agregado en 7.33.0)

--servidores-dns
Configure la lista de servidores DNS que se utilizarán en lugar del predeterminado del sistema. La lista de
Las direcciones IP deben estar separadas por comas. Los números de puerto también pueden ser opcionalmente
dado como : después de cada dirección IP.

Esta opción requiere que libcurl se haya creado con un servidor de resolución que admita
esta operacion. El backend de c-ares es el único de este tipo. (Agregado en 7.33.0)

-e, --referer
(HTTP) Envía la información de la "Página de referencia" al servidor HTTP. Esto también puede ser
establecer con el -H, --encabezamiento bandera por supuesto. Cuando se usa con -l, --localización usted puede
agregue "; auto" a la URL de referencia para que curl establezca automáticamente la URL anterior
cuando sigue un encabezado Location :. La cadena "; auto" se puede utilizar sola, incluso si
no establece un --referer inicial.

Si esta opción se usa varias veces, se usará la última.

-E, --cert
(SSL) Le dice a curl que use el archivo de certificado de cliente especificado al obtener un archivo
con HTTPS, FTPS u otro protocolo basado en SSL. El certificado debe estar en PKCS # 12
formato si usa Transporte seguro, o formato PEM si usa cualquier otro motor. Si el
No se especifica la contraseña opcional, se consultará en el terminal. Nota
que esta opción asume un archivo de "certificado" que es la clave privada y el
certificado de cliente concatenado! Ver - concierto y --llave para especificarlos
de forma independiente.

Si curl se construye contra la biblioteca NSS SSL, esta opción puede indicarle a curl el
apodo del certificado que se utilizará dentro de la base de datos NSS definida por el
variable de entorno SSL_DIR (o por defecto / etc / pki / nssdb). Si el NSS PEM PKCS # 11
módulo (libnsspem.so) está disponible, entonces se pueden cargar los archivos PEM. Si quieres usar
un archivo del directorio actual, antepóngalo con el prefijo "./" para
evite la confusión con un apodo. Si el apodo contiene ":", debe ser
precedido por "\" para que no se reconozca como delimitador de contraseña. Si el
el apodo contiene "\", debe escaparse como "\\" para que no se reconozca
como personaje de escape.

(Solo iOS y Mac OS X) Si curl se basa en el transporte seguro, entonces el
La cadena de certificado puede ser el nombre de un certificado / clave privada en el
sistema o llavero de usuario, o la ruta a un certificado codificado PKCS # 12 y privado
llave. Si desea utilizar un archivo del directorio actual, precedalo con
Prefijo "./", para evitar confusiones con un apodo.

Si esta opción se usa varias veces, se usará la última.

--motor
Seleccione el motor de cifrado OpenSSL que se utilizará para las operaciones de cifrado. Usar --motor lista a
imprima una lista de motores admitidos en tiempo de compilación. Tenga en cuenta que no todos (o ninguno) de los
Los motores pueden estar disponibles en tiempo de ejecución.

--medio ambiente
(SÓLO RISC OS) Establece un rango de variables de entorno, utilizando los nombres -w opción
soportes, para permitir una extracción más fácil de información útil después de haber ejecutado curl.

--egd-file
(SSL) Especifique el nombre de la ruta al socket del demonio de recopilación de entropía. El enchufe es
utilizado para inicializar el motor aleatorio para conexiones SSL. Ver también el --archivo aleatorio
.

--expect100-timeout
(HTTP) Tiempo máximo en segundos que le permite a curl esperar 100-continue
respuesta cuando curl emite un encabezado Expects: 100-continue en su solicitud. Por defecto
curl esperará un segundo. ¡Esta opción acepta valores decimales! Cuando el rizo se detiene
esperando, continuará como si se hubiera recibido la respuesta.

(Agregado en 7.47.0)

- tipo de concierto
(SSL) Le dice a curl en qué tipo de certificado está el certificado proporcionado. PEM, DER y
ENG son tipos reconocidos. Si no se especifica, se asume PEM.

Si esta opción se usa varias veces, se usará la última.

--cacert
(SSL) Le dice a curl que use el archivo de certificado especificado para verificar el par. El archivo
puede contener varios certificados CA. Los certificados deben estar en formato PEM.
Normalmente, curl está diseñado para usar un archivo predeterminado para esto, por lo que esta opción suele ser
utilizado para alterar ese archivo predeterminado.

curl reconoce la variable de entorno denominada 'CURL_CA_BUNDLE' si está configurada, y
utiliza la ruta dada como ruta a un paquete de certificados de CA. Esta opción anula eso
variable.

La versión de Windows de curl buscará automáticamente un archivo de certificados de CA denominado
´curl-ca-bundle.crt´, ya sea en el mismo directorio que curl.exe, o en el actual
Directorio de trabajo, o en cualquier carpeta a lo largo de su RUTA.

Si curl se crea contra la biblioteca NSS SSL, el módulo NSS PEM PKCS # 11
(libnsspem.so) debe estar disponible para que esta opción funcione correctamente.

Si esta opción se usa varias veces, se usará la última.

--capacidad
(SSL) Le dice a curl que use el directorio de certificados especificado para verificar el par.
Se pueden proporcionar varias rutas separándolas con ":" (p. Ej.
"ruta1: ruta2: ruta3"). Los certificados deben estar en formato PEM y, si se crea curl
contra OpenSSL, el directorio debe haber sido procesado usando la utilidad c_rehash
suministrado con OpenSSL. Utilizando --capacidad puede permitir que el curl impulsado por OpenSSL haga SSL-
conexiones mucho más eficiente que usar --cacert si el --cacert el archivo contiene
muchos certificados CA.

Si se establece esta opción, se ignorará el valor de capacidad predeterminado, y si se usa
varias veces, se utilizará el último.

--pinnedpubkey
(SSL) Le dice a curl que use el archivo de clave pública especificado (o hashes) para verificar la
mirar. Esta puede ser una ruta a un archivo que contiene una única clave pública en PEM o DER.
formato, o cualquier número de hashes sha64 codificados en base256 precedidos por ´sha256 // ´ y
separado por

Al negociar una conexión TLS o SSL, el servidor envía un certificado indicando
su identidad. Se extrae una clave pública de este certificado y si no
coincidir exactamente con la clave pública proporcionada para esta opción, curl abortará el
conexión antes de enviar o recibir datos.

Agregado en 7.39.0 para OpenSSL, GnuTLS y GSKit. Agregado en 7.43.0 para NSS y
wolfSSL / CyaSSL. soporte sha256 agregado en 7.44.0 para OpenSSL, GnuTLS, NSS y
wolfSSL / CyaSSL. No se admiten otros backends SSL.

Si esta opción se usa varias veces, se usará la última.

--cert-estado
(SSL) Le dice a curl que verifique el estado del certificado del servidor usando el
Solicitud de estado de certificado (también conocido como grapado OCSP) Extensión TLS.

Si esta opción está habilitada y el servidor envía una respuesta no válida (por ejemplo, caducada),
si la respuesta sugiere que el certificado del servidor ha sido revocado, o no
se recibe una respuesta, la verificación falla.

Actualmente, esto solo se implementa en los backends de OpenSSL, GnuTLS y NSS. (Adicional
en 7.41.0)

--Inicio en falso

(SSL) Le dice a curl que utilice un inicio falso durante el protocolo de enlace TLS. El inicio falso es un modo
donde un cliente TLS comenzará a enviar datos de la aplicación antes de verificar la
mensaje Finalizado del servidor, ahorrando así un viaje de ida y vuelta al realizar una
apretón de manos.

Actualmente, esto solo está implementado en NSS y Secure Transport (en iOS 7.0 o
posterior, o OS X 10.9 o posterior) backends. (Agregado en 7.42.0)

-f, --fallo
(HTTP) Falla silenciosamente (sin salida) en los errores del servidor. Esto se hace principalmente para
habilitar mejor los scripts, etc. para tratar mejor los intentos fallidos. En casos normales cuando
un servidor HTTP no puede entregar un documento, devuelve un documento HTML indicándolo
(que a menudo también describe por qué y más). Esta bandera evitará que el rizo
generar eso y devolver el error 22.

Este método no es a prueba de fallas y hay ocasiones en las que la respuesta no exitosa
los códigos se filtrarán, especialmente cuando se trata de autenticación (códigos de respuesta
401 y 407).

-F, --formulario
(HTTP) Esto permite que curl emule un formulario completo en el que un usuario ha presionado el
botón de enviar. Esto hace que la curvatura a los datos POST utilizando el tipo de contenido multiparte / formulario-
datos de acuerdo con RFC 2388. Esto permite la carga de archivos binarios, etc. Para forzar
la parte 'contenido' para ser un archivo, anteponga el nombre del archivo con un signo @. Solo para conseguir
la parte del contenido de un archivo, anteponga el nombre del archivo con el símbolo <. los
La diferencia entre @ y <es entonces que @ hace que un archivo se adjunte en la publicación como
una carga de archivo, mientras que <hace un campo de texto y solo obtiene el contenido para eso
campo de texto de un archivo.

Por ejemplo, para enviar su archivo de contraseña al servidor, donde 'contraseña' es el nombre de
el campo de formulario al que / Etc / passwd será la entrada:

rizo -F contraseña = @/ Etc / passwd www.miscontraseñas.com

Para leer contenido de stdin en lugar de un archivo, use - como nombre de archivo. Esto va por
construcciones @ y <. Desafortunadamente, no admite la lectura del archivo desde un
tubería con nombre o similar, ya que necesita el tamaño completo antes de que comience la transferencia.

También puede decirle a curl qué tipo de contenido usar usando 'type =', de una manera
Similar a:

rizo -F "[email protected];tipo=texto/html" url.com

or

rizo -F "nombre = daniel; tipo = texto / foo" url.com

También puede cambiar explícitamente el campo de nombre de una parte de carga de archivos configurando
filename =, así:

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

Si el nombre de archivo / ruta contiene ',' o ';', debe estar entre comillas dobles como:

rizo -F "archivo = @ \" archivo local \ "; nombre de archivo = \" nameinpost \ "" url.com

or

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

Tenga en cuenta que si un nombre de archivo / ruta se cita entre comillas dobles, cualquier comilla doble o
La barra invertida dentro del nombre del archivo debe tener un escape con barra invertida.

Vea más ejemplos y detalles en el MANUAL.

Esta opción se puede utilizar varias veces.

--ftp-account [datos]
(FTP) Cuando un servidor FTP solicita "datos de cuenta" después de que el nombre de usuario y la contraseña hayan
proporcionado, estos datos se envían mediante el comando ACCT. (Agregado en 7.13.0)

Si esta opción se usa varias veces, se usará la última.

--ftp-alternativa-al-usuario
(FTP) Si la autenticación con los comandos USER y PASS falla, envíe este comando.
Al conectarse al servidor de transporte seguro de Tumbleweed a través de FTPS utilizando un cliente
certificado, el uso de "AUTORIZACIÓN DEL SITIO" le dirá al servidor que recupere el nombre de usuario de
el certificado. (Agregado en 7.15.5)

--ftp-crear-directorios
(FTP / SFTP) Cuando una operación / URL FTP o SFTP utiliza una ruta que no
existen en el servidor, el comportamiento estándar de curl es fallar. Usando esta opción,
curl en su lugar intentará crear directorios faltantes.

--ftp-method [método]
(FTP) Controla qué método debe usar curl para acceder a un archivo en un servidor FTP (S). los
El argumento del método debe ser una de las siguientes alternativas:

Multicwd
curl realiza una única operación CWD para cada parte de la ruta en la URL dada. Para
jerarquías profundas esto significa muchos comandos. Así lo dice RFC 1738
debería estar hecho. Este es el comportamiento predeterminado pero el más lento.

nocwd curl no hace CWD en absoluto. curl hará SIZE, RETR, STOR, etc. y dará un
ruta al servidor para todos estos comandos. Este es el comportamiento más rápido.

soltero
curl hace un CWD con el directorio de destino completo y luego opera en el
archivo "normalmente" (como en el caso de multicwd). Esto es algo más estándar
compatible que 'nocwd' pero sin la penalización completa de 'multicwd'.

(Agregado en 7.15.1)

--ftp-pasv
(FTP) Utilice el modo pasivo para la conexión de datos. Pasivo es el predeterminado interno
comportamiento, pero el uso de esta opción se puede utilizar para anular un anterior -P / -puerto-ftp
opción. (Agregado en 7.11.0)

Si esta opción se usa varias veces, solo se usa la primera. Deshaciendo un
pasivo forzado realmente no es factible, pero en su lugar debe hacer cumplir el correcto
-PAG, --puerto ftp de nuevo.

El modo pasivo significa que curl probará primero el comando EPSV y luego PASV, a menos que
--disable-epsv se utiliza.

--ftp-skip-pasv-ip
(FTP) Dile a curl que no use la dirección IP que sugiere el servidor en su respuesta a
comando PASV de curl cuando curl conecta la conexión de datos. En su lugar, el rizo
utilice la misma dirección IP que ya utiliza para la conexión de control. (Agregado en
7.14.2).

Esta opción no tiene ningún efecto si se utiliza PORT, EPRT o EPSV en lugar de PASV.

--ftp-pret
(FTP) Dile a curl que envíe un comando PRET antes de PASV (y EPSV). Ciertos servidores FTP,
principalmente drftpd, requieren este comando no estándar para listados de directorios, así como
up y descargas en modo PASV. (Agregado en 7.20.x)

--ftp-ssl-ccc
(FTP) Use CCC (Clear Command Channel) Apaga la capa SSL / TLS después
autenticando. El resto de la comunicación del canal de control no estará cifrado.
Esto permite que los enrutadores NAT sigan la transacción FTP. El modo predeterminado es pasivo.
See --ftp-ssl-ccc-modo para otros modos. (Agregado en 7.16.1)

--ftp-ssl-ccc-mode [activo / pasivo]
(FTP) Usar CCC (Borrar canal de comando) Configura el modo CCC. El modo pasivo no
iniciar el apagado, pero en su lugar esperar a que el servidor lo haga, y no responderá
al cierre del servidor. El modo activo inicia el apagado y espera
para obtener una respuesta del servidor. (Agregado en 7.16.2)

--ftp-ssl-control
(FTP) Requiere SSL / TLS para el inicio de sesión de FTP, desactivado para transferencia. Permite asegurar
autenticación, pero transferencias de datos no cifradas para mayor eficiencia. Falla el
transferir si el servidor no es compatible con SSL / TLS. (Agregado en 7.16.0) que aún puede
se utilizará, pero se eliminará en una versión futura.

--form-string
(HTTP) Similar a --formulario excepto que la cadena de valor para el parámetro nombrado es
utilizado literalmente. Los caracteres '@' y '<' iniciales y la cadena '; type =' en el
El valor no tiene un significado especial. Utilice esto en lugar de --formulario si hay alguno
posibilidad de que el valor de la cadena active accidentalmente las características '@' o '<'
of --formulario.

-g, --globoff
Esta opción desactiva el "analizador global de URL". Cuando configura esta opción,
puede especificar URL que contengan las letras {} [] sin que sean
interpretado por el propio rizo. Tenga en cuenta que estas letras no son URL legales normales.
contenidos, pero deben estar codificados de acuerdo con el estándar URI.

-G, --obtener
Cuando se usa, esta opción hará que todos los datos especificados con -D, --datos, --datos-binarios
or --código de URL de datos para ser utilizado en una solicitud HTTP GET en lugar de la solicitud POST
que de otro modo se utilizaría. Los datos se adjuntarán a la URL con un '?'
separador.

Si se usa en combinación con -I, los datos POST se agregarán en su lugar a la URL
con una solicitud HEAD.

Si esta opción se usa varias veces, solo se usa la primera. Esto es porque
deshacer un GET no tiene sentido, pero en su lugar debería hacer cumplir la
método alternativo que prefiera.

-H, --encabezado
(HTTP) Encabezado adicional para incluir en la solicitud al enviar HTTP a un servidor. usted
puede especificar cualquier número de encabezados adicionales. Tenga en cuenta que si debe agregar un
encabezado que tiene el mismo nombre que uno de los internos que usaría curl, su
Se utilizará el encabezado establecido externamente en lugar del interno. Esto te permite
hacer cosas aún más complicadas de lo que haría normalmente curl. No deberías reemplazar
establecer encabezados internamente sin saber perfectamente bien lo que está haciendo. Quitar un
encabezado interno dando un reemplazo sin contenido en el lado derecho del
dos puntos, como en: -H "Host:". Si envía el encabezado personalizado sin valor, entonces su
el encabezado debe terminar con un punto y coma, como -H "X-Custom-Header;" mandar
"X-Encabezado-personalizado:".

curl se asegurará de que cada encabezado que agregue / reemplace se envíe con el final adecuado
marcador de línea, debe no agregue eso como parte del contenido del encabezado: hacer
no agregue nuevas líneas o retornos de carro, solo arruinarán las cosas para usted.

Vea también el -UN, --agente de usuario y -mi, --referente .

A partir de 7.37.0, necesita --proxy-encabezado para enviar encabezados personalizados destinados a un
apoderado.

Ejemplo:

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

ADVERTENCIA: los encabezados configurados con esta opción se establecerán en todas las solicitudes, incluso después
se siguen las redirecciones, como cuando se dice con -l, --localización. Esto puede llevar a
El encabezado se envía a otros hosts distintos al host original, por lo que los encabezados sensibles
debe usarse con precaución junto con los siguientes redireccionamientos.

Esta opción se puede usar varias veces para agregar / reemplazar / eliminar múltiples encabezados.

--hostpubmd5
(SCP / SFTP) Pase una cadena que contenga 32 dígitos hexadecimales. La cadena debe ser la
Suma de comprobación MD128 de 5 bits de la clave pública del host remoto, curl rechazará la
conexión con el host a menos que los md5sums coincidan. (Agregado en 7.17.1)

--ignorar-contenido-longitud
Para HTTP, ignore el encabezado Content-Length. Esto es particularmente útil para servidores.
ejecutando Apache 1.x, que informará una longitud de contenido incorrecta para archivos más grandes
de 2 gigabytes.

Para FTP (desde 7.46.0), omita el comando RETR para averiguar el tamaño antes
descargar un archivo.

-Incluyo
(HTTP) Incluya el encabezado HTTP en la salida. El encabezado HTTP incluye cosas como
nombre del servidor, fecha del documento, versión HTTP y más ...

-Me dirijo
(HTTP / FTP / FILE) ¡Obtenga solo el encabezado HTTP! Los servidores HTTP cuentan con el comando HEAD
que esto usa para obtener nada más que el encabezado de un documento. Cuando se utiliza en un FTP o
FILE file, curl solo muestra el tamaño del archivo y la hora de la última modificación.

--interfaz
Realice una operación usando una interfaz especificada. Puede ingresar el nombre de la interfaz, IP
dirección o nombre de host. Un ejemplo podría verse así:

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

Si esta opción se usa varias veces, se usará la última.

-j, - cookies-de-sesión-basura
(HTTP) Cuando se le dice a curl que lea las cookies de un archivo determinado, esta opción hará
descarta todas las "cookies de sesión". Esto básicamente tendrá el mismo efecto que si un
se inicia una nueva sesión. Los navegadores habituales siempre descartan las cookies de sesión cuando
están cerrados.

-J, --nombre-encabezado-remoto
(HTTP) Esta opción le dice al -Oh, --nombre-remoto opción para utilizar el servidor especificado
Nombre de archivo de disposición de contenido en lugar de extraer un nombre de archivo de la URL.

No hay ningún intento de decodificar% -secuencias (todavía) en el nombre de archivo proporcionado, por lo que esto
La opción puede proporcionarle nombres de archivo bastante inesperados.

-k, - inseguro
(SSL) Esta opción permite explícitamente que curl realice conexiones SSL "inseguras" y
transferencias. Todas las conexiones SSL se intentan asegurar mediante el uso de CA
paquete de certificados instalado de forma predeterminada. Esto hace que se consideren todas las conexiones
"inseguro" fallará a menos que -k, --inseguro se utiliza.

Consulte este recurso en línea para obtener más detalles:
http://curl.haxx.se/docs/sslcerts.html

-K, --config
Especifique de qué archivo de configuración leer los argumentos curl. El archivo de configuración es un texto
archivo en el que se pueden escribir argumentos de línea de comando que luego se usarán como si
fueron escritos en la línea de comando real.

Las opciones y sus parámetros deben especificarse en la misma línea del archivo de configuración,
separados por espacios en blanco, dos puntos o el signo igual. Los nombres de opciones largos pueden
opcionalmente en el archivo de configuración sin los guiones dobles iniciales y, de ser así,
los dos puntos o los caracteres iguales se pueden utilizar como separadores. Si la opcion es
especificado con uno o dos guiones, no puede haber dos puntos o un carácter igual entre
la opción y su parámetro.

Si el parámetro va a contener espacios en blanco, el parámetro debe incluirse entre
citas. Entre comillas dobles, están disponibles las siguientes secuencias de escape: \\, \ ",
\ t, \ n, \ r y \ v. Se ignora una barra invertida que precede a cualquier otra letra. Si el primero
columna de una línea de configuración es un carácter '#', el resto de la línea se tratará como
un comentario. Solo escriba una opción por línea física en el archivo de configuración.

Especifique el nombre del archivo en -K, --config como '-' para que curl lea el archivo desde stdin.

Tenga en cuenta que para poder especificar una URL en el archivo de configuración, debe especificarlo
usando el --url opción, y no simplemente escribiendo la URL en su propia línea. Por lo que
podría verse similar a esto:

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

Cuando se invoca curl, siempre (a menos que -q se utiliza) comprueba una configuración predeterminada
archivo y lo usa si lo encuentra. El archivo de configuración predeterminado se comprueba en el siguiente
lugares en este orden:

1) curl intenta encontrar el "directorio de inicio": primero busca el CURL_HOME y luego
las variables de entorno HOME. De lo contrario, usa getpwuid () en tipo Unix
systems (que devuelve el directorio de inicio dado el usuario actual en su sistema). Sobre
Windows, luego busca la variable APPDATA o, como último recurso, la
'% PERFIL DE USUARIO% \ Datos de la aplicación'.

2) En Windows, si no hay un archivo _curlrc en el directorio de inicio, busca uno en
en el mismo directorio se coloca el ejecutable curl. En sistemas similares a Unix, simplemente
intente cargar .curlrc desde el directorio de inicio determinado.

# --- Archivo de ejemplo ---
# esto es un comentario
url = "curl.haxx.se"
output = "curlhere.html"
user-agent = "superagent / 1.0"

# y busca otra URL también
url = "curl.haxx.se/docs/manpage.html"
-O
referer = "http://nowhereatall.com/"
# --- Fin del archivo de ejemplo ---

Esta opción se puede utilizar varias veces para cargar varios archivos de configuración.

--keepalive-time
Esta opción establece el tiempo que una conexión debe permanecer inactiva antes de enviar
sondas keepalive y el tiempo entre sondas keepalive individuales. Es actualmente
efectivo en sistemas operativos que ofrecen el socket TCP_KEEPIDLE y TCP_KEEPINTVL
opciones (es decir, Linux, AIX reciente, HP-UX y más). Esta opción no tiene ningún efecto si
--no-mantener vivo se utiliza. (Agregado en 7.18.0)

Si esta opción se usa varias veces, se usará la última. Si no se especifica,
la opción tiene un valor predeterminado de 60 segundos.

--llave
(SSL / SSH) Nombre de archivo de clave privada. Le permite proporcionar su clave privada en este
archivo separado. Para SSH, si no se especifica, curl prueba los siguientes candidatos en
pedido: '~ / .ssh / id_rsa','~ / .ssh / id_dsa',' ./id_rsa ',' ./id_dsa '.

Si esta opción se usa varias veces, se usará la última.

- tipo de llave
(SSL) Tipo de archivo de clave privada. Especifique de qué tipo --llave siempre que la clave privada sea.
Se admiten DER, PEM y ENG. Si no se especifica, se asume PEM.

Si esta opción se usa varias veces, se usará la última.

--krb
(FTP) Habilite la autenticación y el uso de Kerberos. El nivel debe ingresarse y debe
ser uno de "claro", "seguro", "confidencial" o "privado". ¿Deberías usar un nivel?
que no es uno de estos, en su lugar se utilizará 'privado'.

Esta opción requiere una biblioteca construida con soporte kerberos4. Esto no es muy
común. Usar -V, --versión para ver si tu rizo lo soporta.

Si esta opción se usa varias veces, se usará la última.

-l, --sólo lista
(FTP) Cuando se enumera un directorio FTP, este conmutador fuerza una vista de solo nombre. Este es
especialmente útil si el usuario desea analizar automáticamente el contenido de un FTP
directorio ya que la vista de directorio normal no usa un aspecto o formato estándar.
Cuando se usa así, la opción hace que se envíe un comando NLST al servidor
en lugar de LIST.

Nota: algunos servidores FTP enumeran solo archivos en su respuesta a NLST; ellos no
incluyen subdirectorios y enlaces simbólicos.

(POP3) Al recuperar un correo electrónico específico de POP3, este interruptor fuerza una LISTA
comando que se ejecutará en lugar de RETR. Esto es particularmente útil si el usuario
quiere ver si existe un ID de mensaje específico en el servidor y qué tamaño tiene.

Nota: cuando se combina con -X, --solicitud , esta opción se puede utilizar para enviar
un comando UIDL en su lugar, por lo que el usuario puede utilizar el identificador único del correo electrónico en lugar de
que su ID de mensaje para realizar la solicitud. (Agregado en 7.21.5)

-L, --ubicación
(HTTP / HTTPS) Si el servidor informa que la página solicitada se ha movido a una
ubicación (indicada con un encabezado Ubicación: y un código de respuesta 3XX), esta opción
hará que curl rehaga la solicitud en el nuevo lugar. Si se usa junto con -I,
--incluir or -YO, --cabeza, se mostrarán los encabezados de todas las páginas solicitadas. Cuando
se utiliza la autenticación, curl solo envía sus credenciales al host inicial. Si un
redireccionar lleva curl a un host diferente, no podrá interceptar el
usuario + contraseña. Ver también - ubicación de confianza sobre cómo cambiar esto. Puedes limitar el
cantidad de redireccionamientos a seguir usando el --max-redirs .

Cuando curl sigue una redirección y la solicitud no es un GET simple (por ejemplo, POST
o PUT), hará la siguiente solicitud con un GET si la respuesta HTTP fue 301,
302 o 303. Si el código de respuesta era cualquier otro código 3xx, curl reenviará el
siguiente solicitud utilizando el mismo método sin modificar.

Puede decirle a curl que no cambie el método de solicitud que no es GET a GET después de 30x
respuesta usando las opciones dedicadas para eso: --post301, --post302 y
-post303.

--libcurl
Agregue esta opción a cualquier línea de comando curl ordinaria, y obtendrá una libcurl-
usando el código fuente de C escrito en el archivo que hace el equivalente de lo que su
¡La operación de línea de comandos sí lo hace!

Si esta opción se usa varias veces, se usará el último nombre de archivo dado. (Adicional
en 7.16.1)

- tasa límite
Especifique la tasa de transferencia máxima que desea que utilice curl, tanto para descargas como para
cargas. Esta función es útil si tiene una tubería limitada y desea que su
transferencia para no utilizar todo su ancho de banda. Para hacerlo más lento de lo contrario
sería.

La velocidad dada se mide en bytes / segundo, a menos que se agregue un sufijo.
Agregar 'k' o 'K' contará el número como kilobytes, 'm' o M 'lo hace
megabytes, mientras que 'g' o 'G' lo convierte en gigabytes. Ejemplos: 200K, 3m y 1G.

La tasa dada es la velocidad promedio contada durante toda la transferencia. Significa
ese rizo puede usar velocidades de transferencia más altas en ráfagas cortas, pero con el tiempo usa
no más de la tasa dada.

Si también usa el -Y, --Límite de velocidad opción, esa opción tendrá prioridad y
podría paralizar ligeramente la limitación de velocidad, para ayudar a mantener la lógica del límite de velocidad
trabajando.

Si esta opción se usa varias veces, se usará la última.

--puerto local [-num]
Establezca un número o rango preferido de números de puerto local para usar en las conexiones.
Tenga en cuenta que los números de puerto, por naturaleza, son un recurso escaso que a veces estará ocupado
por lo que establecer este rango en algo demasiado estrecho podría causar una conexión innecesaria
fallas de configuración. (Agregado en 7.15.2)

- ubicación de confianza
(HTTP / HTTPS) Me gusta -l, --localización, pero permitirá enviar el nombre + contraseña a todos
hosts a los que el sitio puede redirigir. Esto puede introducir una seguridad o no
incumplimiento si el sitio lo redirige a un sitio al que enviará su autenticación
info (que es texto sin formato en el caso de la autenticación básica HTTP).

-m, --max-time
Tiempo máximo en segundos que permites que dure toda la operación. Esto es útil
para evitar que sus trabajos por lotes se cuelguen durante horas debido a redes o enlaces lentos
bajando. Desde 7.32.0, esta opción acepta valores decimales, pero el actual
El tiempo de espera disminuirá en precisión a medida que aumenta el tiempo de espera especificado en decimal
precisión. Ver también el - tiempo de espera de conexión .

Si esta opción se usa varias veces, se usará la última.

- opciones de inicio de sesión
Especifique las opciones de inicio de sesión que se utilizarán durante la autenticación del servidor.

Puede utilizar las opciones de inicio de sesión para especificar las opciones específicas del protocolo que se pueden utilizar
durante la autenticación. En la actualidad, solo IMAP, POP3 y SMTP admiten las opciones de inicio de sesión.
Para obtener más información sobre las opciones de inicio de sesión, consulte RFC 2384, RFC 5092 e IETF
draft draft-earhart-url-smtp-00.txt (agregado en 7.34.0).

Si esta opción se usa varias veces, se usará la última.

--mail-auth
(SMTP) Especifique una única dirección. Esto se utilizará para especificar la autenticación.
dirección (identidad) de un mensaje enviado que se está transmitiendo a otro servidor.

(Agregado en 7.25.0)

--correo de
(SMTP) Especifique una única dirección desde la que se debe enviar el correo dado.

(Agregado en 7.20.0)

--Tamaño máximo de archivo
Especifique el tamaño máximo (en bytes) de un archivo para descargar. Si el archivo solicitado es
mayor que este valor, la transferencia no se iniciará y el rizo volverá con la salida
código 63.

NOTA: El tamaño del archivo no siempre se conoce antes de la descarga, y para tales archivos este
La opción no tiene ningún efecto incluso si la transferencia de archivos termina siendo mayor que esta dada
límite. Esto se refiere tanto a las transferencias FTP como a las HTTP.

--mail-rcpt
(SMTP) Especifique una única dirección, nombre de usuario o nombre de lista de correo.

Al realizar una transferencia de correo, el destinatario debe especificar una dirección de correo electrónico válida
para enviar el correo. (Agregado en 7.20.0)

Al realizar una verificación de dirección (comando VRFY), el destinatario debe
especificado como nombre de usuario o nombre de usuario y dominio (según la Sección 3.5 de RFC5321).
(Agregado en 7.34.0)

Al realizar una expansión de la lista de correo (comando EXPN), el destinatario debe
especificado utilizando el nombre de la lista de correo, como "Amigos" o "Oficina de Londres".
(Agregado en 7.34.0)

--max-redirs
Establezca el número máximo de seguimientos de redirección permitidos. Si -l, --localización es usado
esta opción se puede utilizar para evitar que curl siga las redirecciones "in absurdum".
De forma predeterminada, el límite está establecido en 50 redirecciones. Establezca esta opción en -1 para que sea
sin límites.

Si esta opción se usa varias veces, se usará la última.

--metalink
Esta opción puede decirle a curl que analice y procese un URI dado como archivo Metalink (ambos
versión 3 y 4 (RFC 5854) son compatibles) y hacer uso de los espejos enumerados en
para la conmutación por error si hay errores (como que el archivo o el servidor no están disponibles).
También verificará el hash del archivo después de que se complete la descarga. El Metalink
el archivo en sí se descarga y procesa en la memoria y no se almacena en el archivo local
.

Ejemplo para utilizar un archivo Metalink remoto:

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

Para usar un archivo Metalink en el sistema de archivos local, use el protocolo FILE (file: //):

rizo --metalink file: //example.metalink

Tenga en cuenta que si el protocolo FILE está deshabilitado, no hay forma de utilizar un
Metalink en el momento de escribir este artículo. También tenga en cuenta que si --metalink y
--incluir se usan juntos, --incluir será ignorado. Esto se debe a que al incluir
los encabezados en la respuesta romperán el analizador de Metalink y si los encabezados están incluidos
en el archivo descrito en el archivo Metalink, la comprobación de hash fallará.

(Agregado en 7.27.0, si se compila con la biblioteca libmetalink).

-n, --netrc
Hace que el rizo escanee el .netrc (_netrc en Windows) en el directorio de inicio del usuario
para el nombre de inicio de sesión y la contraseña. Suele utilizarse para FTP en Unix. Si se usa con
HTTP, curl habilitará la autenticación de usuario. Ver netrc(5) ftp(1) para detalles sobre el
formato de archivo. Curl no se quejará si ese archivo no tiene los permisos adecuados
(no debe ser legible para el mundo ni para el grupo). La variable de entorno "HOME"
se utiliza para buscar el directorio de inicio.

Un ejemplo rápido y muy simple de cómo configurar un .netrc para permitir curl a FTP para
la máquina host.domain.com con el nombre de usuario 'yo mismo' y la contraseña 'secreta' debería
parece similar a:

máquina host.dominio.com Inicie sesión yo mismo la contraseña secreto

-N, - sin búfer
Desactiva el almacenamiento en búfer del flujo de salida. En situaciones de trabajo normales, el rizo
utilizar un flujo de salida estándar almacenado en búfer que tendrá el efecto de que generará
los datos en trozos, no necesariamente exactamente cuando llegan los datos. Usando esto
La opción desactivará ese almacenamiento en búfer.

Tenga en cuenta que este es el nombre de opción negado documentado. Por lo tanto, puede utilizar --buffer a
hacer cumplir el almacenamiento en búfer.

--archivonetrc
Esta opción es similar a --netrc, excepto que proporcione la ruta (absoluta o
relativo) al archivo netrc que Curl debería usar. Solo puede especificar una netrc
archivo por invocación. Si varios --archivonetrc se proporcionan opciones, solo las pasado
una se utilizará. (Agregado en 7.21.5)

Esta opción anula cualquier uso de --netrc ya que son mutuamente excluyentes. Va a
también acatar --netrc-opcional si se especifica.

--netrc-opcional
Muy similar a --netrc, pero esta opción hace que el uso de .netrc opcional y no
obligatorio como el --netrc la opción lo hace.

--negociar
(HTTP) Habilita la autenticación Negociar (SPNEGO).

Si desea habilitar Negociar (SPNEGO) para la autenticación de proxy, utilice
--proxy-negociar.

Esta opción requiere una biblioteca construida con soporte GSS-API o SSPI. Usar -V,
--versión para ver si su curl es compatible con GSS-API / SSPI y SPNEGO.

Al usar esta opción, también debe proporcionar una -tu, --usuario opción para activar
el código de autenticación correctamente. Enviar un '-u:' es suficiente como nombre de usuario y
contraseña del -u opción no se utiliza realmente.

Si esta opción se usa varias veces, solo se usa la primera.

--no-mantener vivo
Deshabilita el uso de mensajes keepalive en la conexión TCP, como por defecto curl
les permite.

Tenga en cuenta que este es el nombre de opción negado documentado. Por lo tanto, puede utilizar --mantener viva
para hacer cumplir keepalive.

--no-id de sesión
(SSL) Deshabilita el uso de curl del almacenamiento en caché de ID de sesión SSL. Por defecto, todas las transferencias son
hecho usando el caché. Tenga en cuenta que, si bien nada debería lastimarse al intentar
reutilizar los ID de sesión SSL, parece haber implementaciones SSL rotas en la naturaleza que
puede requerir que deshabilite esto para que tenga éxito. (Agregado en 7.16.0)

Tenga en cuenta que este es el nombre de opción negado documentado. Por lo tanto, puede utilizar --ID de sesión
para hacer cumplir el almacenamiento en caché de ID de sesión.

--noproxy
Lista separada por comas de hosts que no utilizan un proxy, si se especifica uno. los
solo el comodín es un solo carácter *, que coincide con todos los hosts y de manera efectiva
deshabilita el proxy. Cada nombre de esta lista coincide con un dominio que
contiene el nombre de host o el nombre de host en sí. Por ejemplo, local.com coincidiría
local.com, local.com:80 y www.local.com, pero no www.notlocal.com. (Agregado en
7.19.4).

--ntlm (HTTP) Habilita la autenticación NTLM. El método de autenticación NTLM fue diseñado por
Microsoft y es utilizado por servidores web IIS. Es un protocolo propietario, inverso
diseñado por personas inteligentes e implementado en curl en función de sus esfuerzos. Esta
tipo de comportamiento no debe ser respaldado, debe alentar a todos los que usan
NTLM para cambiar a un método de autenticación público y documentado, como
Digerir.

Si desea habilitar NTLM para su autenticación de proxy, utilice --proxy-ntlm.

Esta opción requiere una biblioteca construida con soporte SSL. Usar -V, --versión para ver si
su curl es compatible con NTLM.

Si esta opción se usa varias veces, solo se usa la primera.

-o, --salida
Escribir salida en en lugar de stdout. Si está utilizando {} o [] para recuperar
varios documentos, puede utilizar '#' seguido de un número en el especificador.
Esa variable se reemplazará con la cadena actual de la URL que se está recuperando.
Como en:

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

o use varias variables como:

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

Puede utilizar esta opción tantas veces como la cantidad de URL que tenga.

Vea también el --crear-dirs opción para crear los directorios locales de forma dinámica.
Especificar la salida como '-' (un solo guión) obligará a que la salida se realice en
salida estándar.

-O, --nombre-remoto
Escribe la salida en un archivo local llamado como el archivo remoto que obtenemos. (Solo la parte del archivo
del archivo remoto, la ruta se corta.)

El nombre del archivo remoto que se usará para guardar se extrae de la URL proporcionada, nada
más.

Consecuentemente, el archivo se guardará en el directorio de trabajo actual. Si tu
desea que el archivo se guarde en un directorio diferente, asegúrese de cambiar el trabajo actual
directorio antes de invocar curl con el -Oh, --nombre-remoto ¡bandera!

No se realiza ninguna decodificación de URL en el nombre del archivo. Si tiene% 20 u otra URL codificada
partes del nombre, terminarán como están como el nombre del archivo.

Puede utilizar esta opción tantas veces como la cantidad de URL que tenga.

--oauth2-portador
(IMAP, POP3, SMTP) Especifique el token de portador para la autenticación del servidor OAUTH 2.0.
El token de portador se utiliza junto con el nombre de usuario que se puede especificar
como parte de la --url or -tu, --usuario .

El token de portador y el nombre de usuario están formateados de acuerdo con RFC 6750.

Si esta opción se usa varias veces, se usará la última.

--proxy-header
(HTTP) Encabezado adicional para incluir en la solicitud al enviar HTTP a un proxy. Puedes
especifique cualquier número de encabezados adicionales. Esta es la opción equivalente a -H, --encabezamiento
pero es para comunicación proxy solo como en las solicitudes CONNECT cuando desea un
encabezado separado enviado al proxy a lo que se envía al host remoto real.

curl se asegurará de que cada encabezado que agregue / reemplace se envíe con el final adecuado
marcador de línea, debe no agregue eso como parte del contenido del encabezado: hacer
no agregue nuevas líneas o retornos de carro, solo arruinarán las cosas para usted.

Los encabezados especificados con esta opción no se incluirán en las solicitudes que conozca curl
no se enviará a un proxy.

Esta opción se puede usar varias veces para agregar / reemplazar / eliminar múltiples encabezados.

(Agregado en 7.37.0)

-p, --túnel proxy
Cuando se utiliza un proxy HTTP (-X, --apoderado), esta opción provocará protocolos que no sean HTTP
para intentar hacer un túnel a través del proxy en lugar de simplemente usarlo para hacer algo similar a HTTP
operaciones. El enfoque del túnel se realiza con la solicitud CONNECT del proxy HTTP y
requiere que el proxy permita la conexión directa al número de puerto remoto que curl quiere
para hacer un túnel a través de.

-P, - puerto ftp
(FTP) Invierte las funciones predeterminadas de iniciador / oyente cuando se conecta con FTP. Esta
El interruptor hace que curl use el modo activo. En la práctica, curl le dice al servidor que
conéctese de nuevo a la dirección y al puerto especificados por el cliente, mientras que el modo pasivo pregunta
el servidor para configurar una dirección IP y un puerto para que se conecte. deberían
ser uno de:

interfaz.
es decir, "eth0" para especificar la dirección IP de la interfaz que desea utilizar (Unix
solamente)

Dirección IP
es decir, "192.168.10.1" para especificar la dirección IP exacta

nombre de host
es decir, "my.host.domain" para especificar la máquina

- hacer que curl elija la misma dirección IP que ya se usa para el control
conexión

Si esta opción se usa varias veces, se usará la última. Deshabilitar el uso de
PUERTO con --ftp-pasv. Deshabilite el intento de usar el comando EPRT en lugar de PORT
mediante el uso --disable-eprt. EPRT es realmente PORT ++.

A partir de 7.19.5, puede agregar ": [inicio] - [final]" a la derecha de la dirección, para
dígale a curl qué rango de puertos TCP usar. Eso significa que especificas un rango de puertos, desde un
más bajo a un número más alto. Un solo número también funciona, pero tenga en cuenta que
aumenta el riesgo de falla ya que el puerto puede no estar disponible.

--aprobar
(SSL / SSH) Frase de contraseña para la clave privada

Si esta opción se usa varias veces, se usará la última.

--ruta como está
Dile a curl que no maneje secuencias de /../ or /./ en la ruta URL proporcionada. Normalmente
curl los aplastará o fusionará de acuerdo con los estándares, pero con esta opción lo configurará
dile que no haga eso.

(Agregado en 7.42.0)

--post301
(HTTP) Le dice a curl que respete RFC 7230 / 6.4.2 y no convierta las solicitudes POST en GET
solicitudes al seguir una redirección 301. El comportamiento no RFC es omnipresente en
navegadores web, por lo que curl realiza la conversión de forma predeterminada para mantener la coherencia.
Sin embargo, un servidor puede requerir que una POST siga siendo POST después de dicha redirección.
Esta opción es significativa solo cuando se usa -l, --localización (Agregado en 7.17.1)

--post302
(HTTP) Le dice a curl que respete RFC 7230 / 6.4.3 y no convierta las solicitudes POST en GET
solicitudes al seguir una redirección 302. El comportamiento no RFC es omnipresente en
navegadores web, por lo que curl realiza la conversión de forma predeterminada para mantener la coherencia.
Sin embargo, un servidor puede requerir que una POST siga siendo POST después de dicha redirección.
Esta opción es significativa solo cuando se usa -l, --localización (Agregado en 7.19.1)

--post303
(HTTP) Le dice a curl que respete RFC 7230 / 6.4.4 y no convierta las solicitudes POST en GET
solicitudes al seguir una redirección 303. El comportamiento no RFC es omnipresente en
navegadores web, por lo que curl realiza la conversión de forma predeterminada para mantener la coherencia.
Sin embargo, un servidor puede requerir que una POST siga siendo POST después de dicha redirección.
Esta opción es significativa solo cuando se usa -l, --localización (Agregado en 7.26.0)

--proto
Le dice a curl que utilice los protocolos enumerados para su recuperación inicial. Los protocolos son
evaluados de izquierda a derecha, están separados por comas y cada uno es un nombre de protocolo o
'todos', opcionalmente prefijado por cero o más modificadores. Los modificadores disponibles son:

+ Permita este protocolo además de los protocolos ya permitidos (este es el
predeterminado si no se utiliza ningún modificador).

- Rechace este protocolo, eliminándolo de la lista de protocolos ya permitidos.

= Permitir solo este protocolo (ignorando la lista ya permitida), aunque el tema
para modificaciones posteriores mediante entradas posteriores en la lista separada por comas.

Por ejemplo:

--proto -ftps usa los protocolos predeterminados, pero deshabilita ftps

--proto -todos, https, + http
solo habilita http y https

--proto = http, https
también solo habilita http y https

Los protocolos desconocidos producen una advertencia. Esto permite que los scripts se basen de forma segura en
capaz de deshabilitar protocolos potencialmente peligrosos, sin depender del soporte para
ese protocolo está integrado en curl para evitar un error.

Esta opción se puede utilizar varias veces, en cuyo caso el efecto es el mismo que
concatenando los protocolos en una instancia de la opción.

(Agregado en 7.20.2)

--proto-predeterminado
Le dice a curl que use protocolo para cualquier URL a la que le falte un nombre de esquema.

Ejemplo:

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

Un protocolo desconocido o no compatible provoca un error CURLE_UNSUPPORTED_PROTOCOL.

Esta opción no cambia el protocolo de proxy predeterminado (http).

Sin esta opción, curl haría una suposición basada en el host, consulte --url para obtener más detalles.

(Agregado en 7.45.0)

--proto-redir
Le dice a curl que use los protocolos enumerados en la redirección. Vea --proto para saber cómo los protocolos
están representados.

Ejemplo:

--proto-redir -todos, http, https
Permita solo HTTP y HTTPS en la redirección.

Por defecto, curl permitirá todos los protocolos en la redirección, excepto varios deshabilitados por seguridad.
razones: Dado que 7.19.4 FILE y SCP están deshabilitados, y desde 7.40.0 SMB y SMBS también
discapacitado. Especificando todos or + todo habilita todos los protocolos de redireccionamiento, incluidos los
discapacitados por seguridad.

(Agregado en 7.20.2)

--proxy-anyauth
Le dice a curl que elija un método de autenticación adecuado cuando se comunique con el
proxy dado. Esto podría causar un viaje de ida y vuelta de solicitud / respuesta adicional. (Agregado en
7.13.2).

--proxy-básico
Le dice a curl que use la autenticación HTTP básica cuando se comunique con el
apoderado. Usar --básico para habilitar HTTP Basic con un host remoto. Básico es el predeterminado
método de autenticación que utiliza curl con proxies.

--digestión indirecta
Le dice a curl que use la autenticación HTTP Digest cuando se comunique con el
apoderado. Usar --digerir para habilitar HTTP Digest con un host remoto.

--proxy-negociar
Le dice a curl que use la autenticación HTTP Negotiate (SPNEGO) cuando se comunique con
el proxy dado. Usar --negociar para habilitar HTTP Negotiate (SPNEGO) con un control remoto
anfitrión. (Agregado en 7.17.1)

--proxy-ntlm
Le dice a curl que use la autenticación HTTP NTLM cuando se comunique con el proxy dado.
Uso --ntlm para habilitar NTLM con un host remoto.

--proxy-service-name
Esta opción le permite cambiar el nombre del servicio para la negociación del proxy.

Ejemplos: --proxy-negociación nombre-proxy --proxy-servicio-nombre sockd usaría
sockd / nombre-proxy. (Agregado en 7.43.0).

--proxy1.0
Utilice el proxy HTTP 1.0 especificado. Si no se especifica el número de puerto, es
asumido en el puerto 1080.

La única diferencia entre esto y la opción de proxy HTTP (-X, --apoderado), es eso
los intentos de usar CONNECT a través del proxy especificarán un protocolo HTTP 1.0 en su lugar
del HTTP 1.1 predeterminado.

--pubkey
(SSH) Nombre de archivo de clave pública. Le permite proporcionar su clave pública en este
archivo.

Si esta opción se usa varias veces, se usará la última.

(A partir de 7.39.0, curl intenta extraer automáticamente la clave pública de la
archivo de clave privada, por lo que generalmente no es necesario pasar esta opción. Tenga en cuenta que esto
La extracción de clave pública requiere que libcurl esté vinculado a una copia de libssh2 1.2.8
o superior que está vinculado a OpenSSL.)

-q Si se utiliza como primer parámetro en la línea de comando, curlrc archivo de configuración no
ser leído y utilizado. Ver el -K, --config para obtener detalles sobre el archivo de configuración predeterminado
ruta de búsqueda.

-Q, --citar
(FTP / SFTP) Envíe un comando arbitrario al servidor FTP o SFTP remoto. Cita
Los comandos se envían ANTES de que se lleve a cabo la transferencia (justo después de la PWD inicial
comando en una transferencia FTP, para ser exactos). Para hacer que los comandos tengan lugar después de un
transferencia exitosa, antepóngalos con un guión '-'. Para hacer que los comandos se envíen después
curl ha cambiado el directorio de trabajo, justo antes del comando de transferencia, prefijo
el comando con un '+' (esto solo es compatible con FTP). Puede especificar cualquier número
de comandos. Si el servidor devuelve un error para uno de los comandos, todo el
la operación será abortada. Debe enviar comandos FTP sintácticamente correctos como RFC
959 define a servidores FTP, o uno de los comandos enumerados a continuación a servidores SFTP.
Esta opción se puede utilizar varias veces. Cuando hable con un servidor FTP, coloque el prefijo
comando con un asterisco (*) para hacer que curl continúe incluso si el comando falla como por
El rizo predeterminado se detendrá en el primer fallo.

SFTP es un protocolo binario. A diferencia de FTP, curl interpreta los comandos de comillas SFTP
sí mismo antes de enviarlos al servidor. Los nombres de archivo se pueden citar en estilo shell para
incrustar espacios o caracteres especiales. A continuación se muestra la lista de todos los SFTP compatibles
comandos de cotización:

archivo de grupo chgrp
El comando chgrp establece el ID de grupo del archivo nombrado por el operando del archivo en
el ID de grupo especificado por el operando de grupo. El operando de grupo es un decimal
ID de grupo entero.

archivo de modo chmod
El comando chmod modifica los bits del modo de archivo del archivo especificado. los
El operando de modo es un número de modo entero octal.

archivo de usuario chown
El comando chown establece el propietario del archivo nombrado por el operando del archivo en
el ID de usuario especificado por el operando del usuario. El operando del usuario es un decimal
ID de usuario entero.

En archivo_origen_archivo_destino
Los comandos ln y symlink crean un enlace simbólico en target_file
location apuntando a la ubicación del archivo_origen.

mkdir nombre_directorio
El comando mkdir crea el directorio nombrado por el operando nombre_directorio.

pwd El comando pwd devuelve el nombre de ruta absoluto del trabajo actual
directorio.

cambiar el nombre del destino de origen
El comando de cambio de nombre cambia el nombre del archivo o directorio nombrado por el operando de origen
a la ruta de destino nombrada por el operando de destino.

archivo rm
El comando rm elimina el archivo especificado por el operando del archivo.

directorio rmdir
El comando rmdir elimina la entrada de directorio especificada por el directorio
operando, siempre que esté vacío.

enlace simbólico archivo_origen archivo_destino
Ver ln.

-r, --rango
(HTTP / FTP / SFTP / FILE) Recupere un rango de bytes (es decir, un documento parcial) de un
Servidor HTTP / 1.1, FTP o SFTP o un ARCHIVO local. Los rangos se pueden especificar en un número
de maneras.

0 - 499 especifica los primeros 500 bytes

500 - 999 especifica los segundos 500 bytes

-500 especifica los últimos 500 bytes

9500- especifica los bytes desde el desplazamiento 9500 y hacia adelante

0-0, -1 especifica el primer y último byte solamente (*) (HTTP)

100-199,500-599
especifica dos rangos separados de 100 bytes (*) (HTTP)

(*) = ¡TENGA EN CUENTA que esto hará que el servidor responda con una respuesta multiparte!

Solo los caracteres de dígitos (0-9) son válidos en los campos 'inicio' y 'parada' del
sintaxis de rango 'start-stop'. Si se da un carácter que no sea un dígito en el rango, el
La respuesta del servidor no estará especificada, dependiendo de la configuración del servidor.

También debe tener en cuenta que muchos servidores HTTP / 1.1 no tienen esta función.
habilitado, de modo que cuando intente obtener un rango, obtendrá todo el
documento.

Las descargas de rango FTP y SFTP solo admiten la sintaxis simple de 'inicio-parada'
(opcionalmente con uno de los números omitidos). El uso de FTP depende del FTP extendido
comando TAMAÑO.

Si esta opción se usa varias veces, se usará la última.

-R, - tiempo remoto
Cuando se usa, esto hará que curl intente averiguar la marca de tiempo del control remoto
y, si está disponible, haga que el archivo local obtenga la misma marca de tiempo.

--archivo aleatorio
(SSL) Especifique el nombre de la ruta al archivo que contiene lo que se considerará aleatorio
datos. Los datos se utilizan para inicializar el motor aleatorio para conexiones SSL. Ver también el
--archivo egd .

--raw (HTTP) Cuando se usa, deshabilita toda la decodificación HTTP interna de contenido o transferencia
codificaciones y, en su lugar, las hace pasar sin alterar, sin procesar. (Agregado en 7.16.2)

--nombre-remoto-todos
Esta opción cambia la acción predeterminada para que todas las URL dadas se manejen como si
-Oh, --nombre-remoto se utilizaron para cada uno. Entonces, si desea deshabilitar eso por un
URL específica después --nombre-remoto-todos se ha utilizado, debe utilizar "-o -" o --No-
nombre-remoto. (Agregado en 7.19.0)

--resolver
Proporcione una dirección personalizada para un par de puerto y host específico. Usando esto, puedes
hacer que las solicitudes de curl usen una dirección específica y evitar que de otra manera
dirección normalmente resuelta que se utilizará. Considéralo una especie de / etc / hosts alternativa
proporcionado en la línea de comando. El número de puerto debe ser el número utilizado para la
protocolo específico para el que se utilizará el host. Significa que necesita varias entradas si
desea proporcionar una dirección para el mismo host pero diferentes puertos.

Esta opción se puede usar muchas veces para agregar muchos nombres de host para resolver.

(Agregado en 7.21.3)

--rever
Si se devuelve un error transitorio cuando curl intenta realizar una transferencia,
Vuelva a intentarlo este número de veces antes de darse por vencido. Establecer el número en 0 hace que curl funcione
sin reintentos (que es el predeterminado). Error transitorio significa: un tiempo de espera, un FTP
Código de respuesta 4xx o un código de respuesta HTTP 5xx.

Cuando curl está a punto de reintentar una transferencia, primero esperará un segundo y luego
todos los próximos reintentos duplicarán el tiempo de espera hasta que alcance los 10 minutos
que será el retraso entre el resto de reintentos. Mediante el uso --rever-
retrasar deshabilita este algoritmo de retroceso exponencial. Ver también --reintentar-tiempo-máximo a
limitar el tiempo total permitido para reintentos. (Agregado en 7.12.3)

Si esta opción se usa varias veces, se usará la última.

--retry-delay
Haga que curl duerma esta cantidad de tiempo antes de cada reintento cuando una transferencia haya fallado
con un error transitorio (cambia el algoritmo de tiempo de espera predeterminado entre
reintentos). Esta opción solo es interesante si --rever también se utiliza. Configurando esto
la demora a cero hará que curl use el tiempo de espera predeterminado. (Agregado en 7.12.3)

Si esta opción se usa varias veces, se usará la última.

--retry-max-time
El temporizador de reintento se reinicia antes del primer intento de transferencia. Los reintentos se realizarán como
habitual (ver --rever) siempre que el temporizador no haya alcanzado este límite dado. Aviso
que si el temporizador no ha alcanzado el límite, se realizará la solicitud y mientras
en ejecución, puede llevar más tiempo que este período de tiempo determinado. Para limitar un solo
tiempo máximo de solicitud, uso -metro, --máx-tiempo. Establezca esta opción en cero para que no se agote el tiempo de espera
reintentos. (Agregado en 7.12.3)

Si esta opción se usa varias veces, se usará la última.

-s, - silencioso
Modo silencioso o silencioso. No muestre el medidor de progreso ni los mensajes de error. Hace rizo
silencio. Seguirá emitiendo los datos que solicite, potencialmente incluso al
terminal / stdout a menos que lo redireccione.

--sasl-ir
Habilite la respuesta inicial en la autenticación SASL. (Agregado en 7.31.0)

--Nombre del Servicio
Esta opción le permite cambiar el nombre del servicio de SPNEGO.

Ejemplos: --negociar --Nombre del Servicio sockd usaría sockd / server-name. (Agregado en
7.43.0).

-S, --mostrar-error
Cuando se usa con -s hace que curl muestre un mensaje de error si falla.

--ssl (FTP, POP3, IMAP, SMTP) Intente utilizar SSL / TLS para la conexión. Vuelve a un no
conexión segura si el servidor no es compatible con SSL / TLS. Ver también --ftp-ssl-
control y --ssl-reqd para diferentes niveles de encriptación requeridos. (Agregado en
7.20.0).

Esta opción se conocía anteriormente como --ftp-ssl (Agregado en 7.11.0). Ese nombre de opción puede
todavía se utilizará, pero se eliminará en una versión futura.

--ssl-reqd
(FTP, POP3, IMAP, SMTP) Requiere SSL / TLS para la conexión. Termina el
conexión si el servidor no es compatible con SSL / TLS. (Agregado en 7.20.0)

Esta opción se conocía anteriormente como --ftp-ssl-reqd (agregado en 7.15.5). Esa opcion
El nombre aún se puede usar, pero se eliminará en una versión futura.

--ssl-permitir-bestia
(SSL) Esta opción le dice a curl que no solucione una falla de seguridad en SSL3 y
Protocolos TLS1.0 conocidos como BEAST. Si no se usa esta opción, la capa SSL puede usar
Soluciones alternativas que se sabe que causan problemas de interoperabilidad con algunos SSL más antiguos.
implementaciones. ADVERTENCIA: esta opción afloja la seguridad SSL, y al usar esta
bandera que pides exactamente eso. (Agregado en 7.25.0)

--ssl-no-revocar
(WinSSL) Esta opción le dice a curl que desactive las comprobaciones de revocación de certificados. ADVERTENCIA:
esta opción afloja la seguridad SSL y, al usar esta marca, solicita exactamente
ese. (Agregado en 7.44.0)

--calcetines4
Utilice el proxy SOCKS4 especificado. Si no se especifica el número de puerto, se asume
en el puerto 1080. (Agregado en 7.15.2)

Esta opción anula cualquier uso anterior de -X, --apoderado, ya que son mutuamente
exclusiva.

Desde 7.21.7, esta opción es superflua ya que puede especificar un proxy socks4 con
-X, --apoderado utilizando un prefijo de protocolo socks4: //.

Si esta opción se usa varias veces, se usará la última.

--socks4a
Utilice el proxy SOCKS4a especificado. Si no se especifica el número de puerto, se asume
en el puerto 1080. (Agregado en 7.18.0)

Esta opción anula cualquier uso anterior de -X, --apoderado, ya que son mutuamente
exclusiva.

Desde 7.21.7, esta opción es superflua ya que puede especificar un proxy socks4a con
-X, --apoderado utilizando un prefijo de protocolo socks4a: //.

Si esta opción se usa varias veces, se usará la última.

--socks5-nombre de host
Utilice el proxy SOCKS5 especificado (y deje que el proxy resuelva el nombre de host). Si el
el número de puerto no está especificado, se asume en el puerto 1080. (Agregado en 7.18.0)

Esta opción anula cualquier uso anterior de -X, --apoderado, ya que son mutuamente
exclusiva.

Desde 7.21.7, esta opción es superflua ya que puede especificar un nombre de host socks5
proxy con -X, --apoderado usando un prefijo de protocolo socks5h: //.

Si esta opción se usa varias veces, se usará la última. (Esta opción fue
previamente documentado y utilizado incorrectamente como --calcetines sin el número adjunto).

--calcetines5
Utilice el proxy SOCKS5 especificado, pero resuelva el nombre de host localmente. Si el puerto
no se especifica el número, se asume en el puerto 1080.

Esta opción anula cualquier uso anterior de -X, --apoderado, ya que son mutuamente
exclusiva.

Desde 7.21.7, esta opción es superflua ya que puede especificar un proxy socks5 con
-X, --apoderado utilizando un prefijo de protocolo socks5: //.

Si esta opción se usa varias veces, se usará la última. (Esta opción fue
previamente documentado y utilizado incorrectamente como --calcetines sin el número adjunto).

Esta opción (así como --calcetines4) no funciona con IPV6, FTPS o LDAP.

--socks5-gssapi-service
El nombre de servicio predeterminado para un servidor de socks es rcmd / server-fqdn. Esta opción permite
que lo cambie.

Ejemplos: --socks5 nombre-proxy --socks5-gssapi-servicio sockd usaría sockd / proxy-
nombre --socks5 nombre-proxy --socks5-gssapi-servicio sockd / real-name usaría
sockd / real-name para los casos en los que el nombre del proxy no coincide con el nombre principal.
(Agregado en 7.19.4).

--calcetines5-gssapi-nec
Como parte de la negociación GSS-API, se negocia un modo de protección. RFC 1961 dice
en la sección 4.3 / 4.4 debe protegerse, pero la implementación de referencia NEC
no. La opción --calcetines5-gssapi-nec permite el intercambio desprotegido de la
negociación del modo de protección. (Agregado en 7.19.4).

--stderr
En su lugar, redirija todas las escrituras a stderr al archivo especificado. Si el nombre del archivo es un
plain '-', en su lugar se escribe en stdout.

Si esta opción se usa varias veces, se usará la última.

-t, --telnet-opción
Pase las opciones al protocolo telnet. Las opciones admitidas son:

TTYPE = Establece el tipo de terminal.

XDISPLOC = Establece la ubicación de visualización de X.

NEW_ENV = Establece una variable de entorno.

-T, --upload-file
Esto transfiere el archivo local especificado a la URL remota. Si no hay parte del archivo
en la URL especificada, Curl agregará el nombre del archivo local. NOTA que debe usar
un / final en el último directorio para demostrarle realmente a Curl que no hay ningún archivo
name o curl pensará que su último nombre de directorio es el nombre de archivo remoto para
usar. Eso probablemente hará que la operación de carga falle. Si esto se usa en
un servidor HTTP (S), se utilizará el comando PUT.

Utilice el nombre de archivo "-" (un solo guión) para utilizar stdin en lugar de un archivo determinado.
Alternativamente, el nombre de archivo "." (un solo punto) se puede especificar en lugar de "-" para
use stdin en modo sin bloqueo para permitir la lectura de la salida del servidor mientras stdin está siendo
subido.

Puede especificar una -T para cada URL en la línea de comando. Cada par -T + URL
especifica qué cargar y dónde. curl también admite "globbing" de la -T
argumento, lo que significa que puede cargar varios archivos en una sola URL utilizando el
mismo estilo de globbing de URL admitido en la URL, como este:

curl -T "{archivo1, archivo2}" http://www.uploadtothissite.com

o incluso

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

--tcp-nodelay
Active la opción TCP_NODELAY. Ver el curl_easy_setopt(3) página man para más detalles
acerca de esta opción. (Agregado en 7.11.2)

--tftp-blksize
(TFTP) Configure la opción TFTP BLKSIZE (debe ser> 512). Este es el tamaño de bloque que se riza
intentará utilizar al transferir datos hacia o desde un servidor TFTP. Por defecto 512
Se utilizarán bytes.

Si esta opción se usa varias veces, se usará la última.

(Agregado en 7.20.0)

--tlsauthtype
Establezca el tipo de autenticación TLS. Actualmente, la única opción admitida es "SRP", para
TLS-SRP (RFC 5054). Si --tlusuario y --tlscontraseña se especifican pero --tlsauthtype
no es, entonces esta opción por defecto es "SRP". (Agregado en 7.21.4)

--tlspassword
Establecer contraseña para usar con el método de autenticación TLS especificado con
--tlsauthtype. Requiere eso --tlusuario también se establece. (Agregado en 7.21.4)

--tlsuser
Configure el nombre de usuario para usar con el método de autenticación TLS especificado con
--tlsauthtype. Requiere eso --tlscontraseña también se establece. (Agregado en 7.21.4)

--tlsv1.0
(SSL) Obliga a curl a utilizar TLS versión 1.0 al negociar con un servidor TLS remoto.
(Agregado en 7.34.0)

--tlsv1.1
(SSL) Obliga a curl a utilizar TLS versión 1.1 al negociar con un servidor TLS remoto.
(Agregado en 7.34.0)

--tlsv1.2
(SSL) Obliga a curl a utilizar TLS versión 1.2 al negociar con un servidor TLS remoto.
(Agregado en 7.34.0)

--tr-codificación
(HTTP) Solicite una respuesta de codificación de transferencia comprimida utilizando uno de los algoritmos
curl admite y descomprime los datos mientras los recibe.

(Agregado en 7.21.6)

--rastro
Permite un volcado de seguimiento completo de todos los datos entrantes y salientes, incluidos los descriptivos
información, al archivo de salida dado. Utilice "-" como nombre de archivo para enviar la salida
a stdout.

Esta opción anula los usos anteriores de -v, --verboso or --trace-ascii.

Si esta opción se usa varias veces, se usará la última.

--trace-ascii
Permite un volcado de seguimiento completo de todos los datos entrantes y salientes, incluidos los descriptivos
información, al archivo de salida dado. Utilice "-" como nombre de archivo para enviar la salida
a stdout.

Esto es muy similar a --rastro, pero omite la parte hexagonal y solo muestra la
Parte ASCII del volcado. Produce una salida más pequeña que podría ser más fácil de leer para
humanos no entrenados.

Esta opción anula los usos anteriores de -v, --verboso or --rastro.

Si esta opción se usa varias veces, se usará la última.

--traza-tiempo
Añade una marca de tiempo a cada trazo o línea detallada que muestra el rizo. (Agregado en
7.14.0).

--unix-socket
(HTTP) Conéctese a través de este socket de dominio Unix, en lugar de usar la red.
(Agregado en 7.40.0)

-u, --usuario
Especifique el nombre de usuario y la contraseña que se utilizarán para la autenticación del servidor. Anulaciones -norte,
--netrc y --netrc-opcional.

Si simplemente especifica el nombre de usuario, curl le pedirá una contraseña.

El nombre de usuario y las contraseñas se dividen en los primeros dos puntos, lo que lo convierte en
imposible utilizar dos puntos en el nombre de usuario con esta opción. La contraseña puede,
todavía.

Cuando utilice Kerberos V5 con un servidor basado en Windows, debe incluir Windows
nombre de dominio en el nombre de usuario, para que el servidor obtenga con éxito un
Ticket Kerberos. Si no lo hace, el protocolo de enlace de autenticación inicial puede fallar.

Cuando se utiliza NTLM, el nombre de usuario se puede especificar simplemente como el nombre de usuario, sin
el dominio, si hay un solo dominio y bosque en su configuración, por ejemplo.

Para especificar el nombre de dominio, utilice el nombre de inicio de sesión de nivel inferior o UPN (usuario principal
Nombre) formatos. Por ejemplo, EXAMPLE \ user y [email protected] respectivamente.

Si usa un binario curl habilitado para SSPI de Windows y ejecuta Kerberos V5, Negociar,
Autenticación NTLM o Digest, entonces puede decirle a curl que seleccione el nombre de usuario y
contraseña de su entorno especificando dos puntos con esta opción: "-u
: ".

Si esta opción se usa varias veces, se usará la última.

-U, --proxy-user
Especifique el nombre de usuario y la contraseña que se utilizarán para la autenticación de proxy.

Si usa un binario curl habilitado para SSPI de Windows y negocia o NTLM
autenticación, entonces puede decirle a curl que seleccione el nombre de usuario y la contraseña de
su entorno especificando dos puntos con esta opción: "-U:".

Si esta opción se usa varias veces, se usará la última.

--url
Especifique una URL para buscar. Esta opción es más útil cuando desea especificar URL (s)
en un archivo de configuración.

Si a la URL proporcionada le falta un nombre de esquema (como "http: //" o "ftp: //", etc.),
curl hará una suposición basada en el anfitrión. Si el nombre del subdominio más externo coincide
DICT, FTP, IMAP, LDAP, POP3 o SMTP, entonces se utilizará ese protocolo; de lo contrario, HTTP
se utilizará. Dado que la adivinación 7.45.0 se puede desactivar configurando un protocolo predeterminado,
ver --proto-predeterminado para obtener más detalles.

Esta opción se puede utilizar tantas veces como desee. Para controlar dónde se escribe esta URL,
utilizar el -Oh, --producción o de -Oh, --nombre-remoto .

-v, --detallado
Sea más verboso / hablador durante la operación. Útil para depurar y ver
lo que está pasando "bajo el capó". Una línea que comienza con '>' significa "datos de encabezado" enviados
por curl, '<' significa "datos de encabezado" recibidos por curl que están ocultos en casos normales,
y una línea que comienza con '*' significa información adicional proporcionada por curl.

Tenga en cuenta que si solo desea encabezados HTTP en la salida, -I, --incluir podría ser el
opción que estás buscando.

Si cree que esta opción aún no le brinda suficientes detalles, considere usar
--rastro or --trace-ascii preferiblemente.

Esta opción anula los usos anteriores de --trace-ascii or --rastro.

Uso -s, --silencio para hacer que el rizo sea tranquilo.

-w, --escribir
Haga que la información de visualización de rizo en stdout después de una transferencia completa. El formato es un
cadena que puede contener texto sin formato mezclado con cualquier número de variables. El formato
puede especificarse como una "cadena" literal, o puede hacer que curl lea el formato de una
archivo con "@filename" y decirle a curl que lea el formato de stdin que escribe
"@ -".

Las variables presentes en el formato de salida serán sustituidas por el valor o texto
ese rizo cree que encaja, como se describe a continuación. Todas las variables se especifican como
% {variable_name} y para generar un% normal, simplemente escríbalos como %%. Puede dar salida
una nueva línea usando \ n, un retorno de carro con \ r y un espacio de tabulación con \ t.

NOTA: El símbolo% es un símbolo especial en el entorno win32, donde todos
las ocurrencias de% se deben duplicar cuando se usa esta opción.

Las variables disponibles son:

tipo de contenido El tipo de contenido del documento solicitado, si lo hubiera.

filename_efectivo
El nombre de archivo definitivo en el que escribe curl. Esto es sólo
significativo si se le dice a curl que escriba en un archivo con la --nombre-remoto
or --producción opción. Es más útil en combinación con el
--nombre-encabezado-remoto opción. (Agregado en 7.25.1)

ftp_entry_path El rizo de ruta inicial terminó al iniciar sesión en el FTP remoto
servidor. (Agregado en 7.15.4)

código_http El código de respuesta numérico que se encontró en el último recuperado
Transferencia HTTP (S) o FTP (s). En 7.18.2 el alias código de respuesta fue
agregado para mostrar la misma información.

http_conectar El código numérico que se encontró en la última respuesta (de un
proxy) a una solicitud curl CONNECT. (Agregado en 7.12.4)

local_ip La dirección IP del extremo local de la conexión realizada más recientemente.
- puede ser IPv4 o IPv6 (agregado en 7.29.0)

puerto_local El número de puerto local de la conexión realizada más recientemente (agregado en
7.29.0).

num_conexiones Número de conexiones nuevas realizadas en la transferencia reciente. (Agregado en
7.12.3).

número_redirecciones Número de redireccionamientos que se siguieron en la solicitud. (Agregado en
7.12.3).

Redireccionar URL Cuando se realizó una solicitud HTTP sin -L para seguir las redirecciones, esto
la variable mostrará la URL real una redirección se Llevarte a.
(Agregado en 7.18.2)

IP remota La dirección IP remota de la conexión realizada más recientemente - se puede
ya sea IPv4 o IPv6 (agregado en 7.29.0)

Puerto remoto El número de puerto remoto de la conexión realizada más recientemente (agregado
en 7.29.0)

tamaño_descargar La cantidad total de bytes que se descargaron.

tamaño_encabezado La cantidad total de bytes de los encabezados descargados.

solicitud_tamaño La cantidad total de bytes que se enviaron en la solicitud HTTP.

tamaño_subir La cantidad total de bytes que se cargaron.

velocidad_descargar La velocidad de descarga promedio que midió el rizo para el
descargar. Bytes por segundo.

subir_velocidad La velocidad de carga promedio que midió el rizo para la carga completa.
Bytes por segundo.

ssl_verify_resultado
El resultado de la verificación del certificado de pares SSL que fue
solicitado. 0 significa que la verificación se realizó correctamente. (Agregado en
7.19.0).

time_appconnect
El tiempo, en segundos, que tomó desde el inicio hasta que SSL / SSH / etc.
Se completó la conexión / protocolo de enlace con el host remoto. (Agregado en
7.19.0).

tiempo_conectar El tiempo, en segundos, que tomó desde el inicio hasta que el TCP se conectó
al host remoto (o proxy) se completó.

búsqueda de nombre_hora
El tiempo, en segundos, que tomó desde el inicio hasta el nombre
se completó la resolución.

tiempo_pretransferencia
El tiempo, en segundos, que tomó desde el inicio hasta la transferencia del archivo
estaba a punto de comenzar. Esto incluye todos los comandos previos a la transferencia y
Negociaciones que son específicas de los protocolos en particular.
involucrado.

time_redirect El tiempo, en segundos, que tardaron todos los pasos de redireccionamiento, incluido el nombre
buscar, conectar, pretransferir y transferir antes de la final
se inició la transacción. time_redirect muestra la ejecución completa
tiempo para múltiples redirecciones. (Agregado en 7.12.3)

transferencia_hora_inicio
El tiempo, en segundos, que tomó desde el inicio hasta el primer byte
estaba a punto de ser transferido. Esto incluye time_pretransfer y
también el tiempo que el servidor necesitó para calcular el resultado.

tiempo_total El tiempo total, en segundos, que duró la operación completa. El tiempo
se mostrará con una resolución de milisegundos.

url_efectivo La URL que se obtuvo en último lugar. Esto es más significativo si ha
le dijo a curl que siguiera la ubicación: encabezados.

Si esta opción se usa varias veces, se usará la última.

-x, --proxy <[protocolo: //] [usuario: contraseña @] proxyhost [: puerto]>
Utilice el proxy especificado.

La cadena de proxy se puede especificar con un prefijo de protocolo: // para especificar una alternativa
protocolos proxy. Utilice socks4: //, socks4a: //, socks5: // o socks5h: // para solicitar el
versión específica de SOCKS a utilizar. Sin protocolo especificado, http: // y todos los demás
serán tratados como proxies HTTP. (El soporte de protocolo se agregó en curl 7.21.7)

Si el número de puerto no se especifica en la cadena de proxy, se supone que es 1080.

Esta opción anula las variables de entorno existentes que configuran el proxy para su uso. Si
hay una variable de entorno que configura un proxy, puede configurar el proxy en "" para
anularlo.

Todas las operaciones que se realizan a través de un proxy HTTP serán transparentes.
convertido a HTTP. Significa que ciertas operaciones específicas del protocolo pueden no ser
disponible. Este no es el caso si puede hacer un túnel a través del proxy, como uno con
las -pag, - túnel proxy .

El usuario y la contraseña que se pueden proporcionar en la cadena de proxy son decodificados por URL por
rizo. Esto le permite pasar caracteres especiales como @ usando% 40 o pass
en dos puntos con% 3a.

El host de proxy se puede especificar exactamente de la misma manera que el entorno de proxy
variables, incluido el prefijo de protocolo (http: //) y el usuario integrado +
contraseña.

Si esta opción se usa varias veces, se usará la última.

-X, - solicitud
(HTTP) Especifica un método de solicitud personalizado para usar cuando se comunica con HTTP
servidor. El método de solicitud especificado se utilizará en lugar del método de lo contrario
utilizado (que por defecto es GET). Lea la especificación HTTP 1.1 para obtener detalles y
explicaciones. Las solicitudes HTTP adicionales comunes incluyen PUT y DELETE, pero relacionadas
tecnologías como WebDAV ofrecen PROPFIND, COPY, MOVE y más.

Normalmente no necesita esta opción. Todo tipo de solicitudes GET, HEAD, POST y PUT
se invocan más bien mediante el uso de opciones de línea de comandos dedicadas.

Esta opción solo cambia la palabra real utilizada en la solicitud HTTP, no
alterar la forma en que se comporta curl. Entonces, por ejemplo, si quieres hacer una CABEZA adecuada
solicitud, usar -X HEAD no será suficiente. Necesitas usar el -YO, --cabeza .

La cadena de método que establezca con -X se utilizará para todas las solicitudes, que si desea
ejemplo de uso -l, --localización puede causar efectos secundarios no deseados cuando el rizo no
cambiar el método de solicitud de acuerdo con los códigos de respuesta HTTP 30x y similares.

(FTP) Especifica un comando FTP personalizado para usar en lugar de LIST al hacer listas de archivos
con FTP.

(POP3) Especifica un comando POP3 personalizado para usar en lugar de LIST o RETR. (Agregado en
7.26.0).

(IMAP) Especifica un comando IMAP personalizado para usar en lugar de LIST. (Agregado en 7.30.0)

(SMTP) Especifica un comando SMTP personalizado para usar en lugar de HELP o VRFY. (Agregado en
7.34.0).

Si esta opción se usa varias veces, se usará la última.

--xattr
Al guardar la salida en un archivo, esta opción le dice a curl que almacene ciertos metadatos del archivo
en atributos de archivo extendidos. Actualmente, la URL se almacena en xdg.origin.url
atributo y, para HTTP, el tipo de contenido se almacena en el atributo mime_type. Si
el sistema de archivos no admite atributos extendidos, se emite una advertencia.

-y, --velocidad-tiempo
Si una descarga es más lenta que los bytes de límite de velocidad por segundo durante un tiempo de velocidad
período, la descarga se aborta. Si se usa el tiempo de velocidad, el límite de velocidad predeterminado
será 1 a menos que se establezca con -Y.

Esta opción controla las transferencias y, por lo tanto, no afectará a las conexiones lentas, etc.
es una preocupación para ti, prueba el - tiempo de espera de conexión .

Si esta opción se usa varias veces, se usará la última.

-Y, - límite de velocidad
Si una descarga es más lenta que esta velocidad dada (en bytes por segundo) para el tiempo de velocidad
segundos se aborta. el tiempo de velocidad se establece con -y y es 30 si no se establece.

Si esta opción se usa varias veces, se usará la última.

-z, --time-cond |
(HTTP / FTP) Solicite un archivo que haya sido modificado más tarde de la hora indicada y
fecha, o una que haya sido modificada antes de esa hora. los puede ser
todo tipo de cadenas de fecha o si no coincide con ninguna interna, se toma como
un nombre de archivo e intenta obtener la fecha de modificación (mtime) de en lugar de. Ver
las curl_getdate(3) páginas de manual para obtener detalles de la expresión de fecha.

Inicie la expresión de fecha con un guión (-) para solicitar un documento que sea
más antiguo que la fecha / hora indicadas, el valor predeterminado es un documento más nuevo que el
fecha / hora especificadas.

Si esta opción se usa varias veces, se usará la última.

-h, --ayuda
Ayuda de uso. Aquí se enumeran todas las opciones actuales de la línea de comandos con una breve descripción.

-M, --manual
Manual. Muestre el enorme texto de ayuda.

-V, --versión
Muestra información sobre curl y la versión de libcurl que usa.

La primera línea incluye la versión completa de curl, libcurl y otros terceros
bibliotecas vinculadas con el ejecutable.

La segunda línea (comienza con "Protocolos:") muestra todos los protocolos que libcurl informa
apoyar.

La tercera línea (comienza con "Funciones:") muestra funciones específicas a las que libcurl informa
oferta. Las características disponibles incluyen:

IPv6 Puede utilizar IPv6 con esto.

krb4 Krb4 para FTP es compatible.

SSL Se admiten las versiones SSL de varios protocolos, como HTTPS, FTPS, POP3S
y así sucesivamente.

libz Se admite la descompresión automática de archivos comprimidos a través de HTTP.

NTLM Se admite la autenticación NTLM.

Depurar Este curl usa una libcurl construida con Debug. Esto permite un mayor seguimiento de errores
y depuración de memoria, etc. ¡Solo para desarrolladores de curl!

AsynchDNS
Este rizo utiliza resuelve de nombres asincrónicos. Las resoluciones de nombres asincrónicas pueden ser
hecho usando c-ares o los backends de resolución de subprocesos.

Se admite la autenticación SPNEGO SPNEGO.

Largefile
Este rizo admite transferencias de archivos grandes, archivos de más de 2 GB.

IDN Este rizo admite IDN: nombres de dominio internacionales.

API GSS
Se admite GSS-API.

SSPI SSPI es compatible.

TLS-SRP
La autenticación SRP (contraseña remota segura) es compatible con TLS.

Se ha incorporado compatibilidad con HTTP2 HTTP / 2.

enlace metálico
Este rizo es compatible con Metalink (tanto la versión 3 como la 4 (RFC 5854)), que
describe espejos y hashes. curl usará espejos para la conmutación por error si hay
son errores (como que el archivo o el servidor no están disponibles).

Use curl en línea usando los servicios de onworks.net