lwp-request

Sinopsis

        lwp-request [-afPuUsSedvhx] [-m yöntem] [-b taban_URL] [-t zaman_aşımı]
                   [-i if-modified-since] [-c içerik_türü]
                   [-C kimlik_bilgileri] [-p vekil_sunucu_url] [-o biçim] url...

Açıklama

Bu program WWW sunucularına ve yerel dosya sisteminize istek göndermek için kullanılabilir. POST ve PUT yöntemleri için istek içeriği stdin'den (standart girdi) okunur. Yanıtın içeriği stdout'a (standart çıktı) yazdırılır. Hata mesajları stderr'e (standart hata) yazdırılır. Program, başarısız olan URL sayısını gösteren bir durum değeri döndürür.

Seçenekler şunlardır:

• -m yöntem: İstek için hangi yöntemin (method) kullanılacağını ayarlar. Bu seçenek kullanılmazsa, yöntem programın adından türetilir.

• -f: Program yöntemin geçersiz olduğunu düşünse bile isteği zorla gönderir. Sunucu nihayetinde isteği reddedebilir.

• -b uri: Bu URI, argüman olarak verilen tüm göreceli URI'leri çözmek için taban URI (base URI) olarak kullanılacaktır.

• -t zaman_aşımı: İstekler için zaman aşımı değerini ayarlar. Zaman aşımı, programın başarısız olmadan önce uzak sunucudan bir yanıt almak için bekleyeceği süredir. Zaman aşımı değerinin varsayılan birimi saniyedir. Zaman aşımı değerinin sonuna sırasıyla dakika veya saat yapmak için "m" (minute) veya "h" (hour) ekleyebilirsiniz. Varsayılan zaman aşımı '3m', yani 3 dakikadır.

• -i zaman: İstekte If-Modified-Since başlığını (header) ayarlar. Zaman değeri bir dosya adı ise, bu dosyanın değişiklik zaman damgası (modification timestamp) kullanılır. Zaman değeri bir dosya değilse, düz bir tarih olarak ayrıştırılır. Kabul edilen biçimler için HTTP::Date belgesine göz atın.

• -c içerik_türü: İstek için Content-Type (İçerik Türü) başlığını ayarlar. Bu seçeneğe yalnızca içerik alan istekler için (yani POST ve PUT) izin verilir. "-f" seçeneğini "-c" ile birlikte kullanarak yöntemleri içerik almaya zorlayabilirsiniz. POST için varsayılan Content-Type değeri "application/x-www-form-urlencoded" şeklindedir. Diğerleri için varsayılan Content-Type değeri "text/plain" şeklindedir.

• -p vekil_sunucu_url: İstekler için kullanılacak vekil sunucuyu (proxy) ayarlar. Program ayrıca proxy ayarlarını ortamdan (environment) yükler. Bunu "-P" seçeneğiyle devre dışı bırakabilirsiniz.

• -P: Proxy ayarlarını ortamdan yüklemez.

• -H başlık: Her istekle birlikte bu HTTP başlığını gönderir. Birden fazla belirtebilirsiniz, örneğin:

  lwp-request \
  -H 'Referer: http://other.url/' \
  -H 'Host: somehost' \
  http://this.url/
  

• -C kullanıcı_adı:parola: Temel Kimlik Doğrulama (Basic Authentication) ile korunan belgeler için kimlik bilgilerini sağlar. Belge korunuyorsa ve bu seçenekle kullanıcı adı ve parolayı belirtmediyseniz, bu değerleri sağlamanız için size bir bilgi istemi sunulacaktır.

Aşağıdaki seçenekler program tarafından neyin görüntüleneceğini denetler:

• -u: İstekler yapıldıkça istek yöntemini ve mutlak URL'yi yazdırır.

• -U: İstek yöntemine ve mutlak URL'ye ek olarak istek başlıklarını (headers) yazdırır.

• -s: Yanıt durum kodunu yazdırır. Bu seçenek HEAD istekleri için her zaman etkindir.

• -S: Yanıt durum zincirini yazdırır. Bu, kütüphane tarafından işlenen yönlendirme (redirect) ve yetkilendirme isteklerini gösterir.

• -e: Yanıt başlıklarını yazdırır. Bu seçenek HEAD istekleri için her zaman etkindir.

• -E: Tam yanıt başlıklarıyla birlikte yanıt durum zincirini yazdırır.

• -d: Yanıtın içeriğini yazdırmaz.

• -o biçim: HTML içeriğini yazdırmadan önce çeşitli şekillerde işler. Yanıtın içerik türü HTML değilse, bu seçeneğin hiçbir etkisi yoktur. Geçerli biçim değerleri şunlardır: "text", "ps", "links", "html" ve "dump".

  "text" biçimini belirtirseniz, HTML düz "latin1" metni olarak biçimlendirilecektir. "ps" biçimini belirtirseniz, Postscript olarak biçimlendirilecektir.

  "links" biçimi, HTML belgesinde bulunan tüm bağlantıları çıktı olarak verecektir. Göreceli bağlantılar mutlak bağlantılara genişletilecektir.

  "html" biçimi HTML kodunu yeniden biçimlendirecek ve "dump" biçimi yalnızca HTML sözdizimi ağacını dökecektir.

  Bu seçeneğin çalışması için "HTML-Tree" dağıtımının kurulu olması gerektiğini unutmayın. Ayrıca "-o text" veya "-o ps" seçeneklerinin çalışması için "HTML-Format" dağıtımının kurulu olması gerekir.

• -v: Programın sürüm numarasını yazdırır ve çıkar.

• -h: Kullanım mesajını yazdırır ve çıkar.

• -a: İçerik girdisi ve çıktısı için metin (ascii) modunu ayarlar. Bu seçenek kullanılmazsa, içerik girdisi ve çıktısı ikili (binary) modda gerçekleştirilir.

Bu program LWP kütüphanesi kullanılarak uygulandığı için, yalnızca LWP'nin desteklediği protokolleri destekleyecektir.

Ayrıca Bakınız

lwp-mirror, LWP

Telif Hakkı

Telif Hakkı 1995-1999 Gisle Aas.

Bu kütüphane özgür yazılımdır; Perl'in kendisiyle aynı koşullar altında yeniden dağıtabilir ve/veya değiştirebilirsiniz.

Yazar

Gisle Aas gisle@aas.no

perl v5.34.0                        2020-04-14                    LWP-REQUEST(1)