1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
2 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"
4 <!ENTITY % local SYSTEM "local.ent">
6 <!ENTITY % entities SYSTEM "entities.ent">
8 <!ENTITY % idcommon SYSTEM "common/common.ent">
11 <refentry id="yaz-url">
13 <productname>YAZ</productname>
14 <productnumber>&version;</productnumber>
15 <info><orgname>Index Data</orgname></info>
19 <refentrytitle>yaz-url</refentrytitle>
20 <manvolnum>1</manvolnum>
21 <refmiscinfo class="manual">Commands</refmiscinfo>
25 <refname>yaz-url</refname>
26 <refpurpose>YAZ URL fetch utility</refpurpose>
31 <command>yaz-url</command>
32 <arg>-H <replaceable>name:value</replaceable></arg>
33 <arg>-m <replaceable>method</replaceable></arg>
34 <arg>-O <replaceable>fname</replaceable></arg>
35 <arg>-p <replaceable>fname</replaceable></arg>
36 <arg>-R <replaceable>num</replaceable></arg>
37 <arg>-u <replaceable>user/password</replaceable></arg>
39 <arg>-x <replaceable>proxy</replaceable></arg>
40 <arg rep="repeat">url</arg>
44 <refsect1><title>DESCRIPTION</title>
46 <command>yaz-url</command> is utility to get web content. It is very
47 limited in functionality compared to programs such as curl, wget.
50 The options must precede the URL given on the command line, to take
54 Fetched HTTP content is written to stdout, unless option -O is given.
58 <refsect1><title>OPTIONS</title>
61 <term>-H <replaceable>name:value</replaceable></term>
63 Specifies HTTP header content with name and value. This
64 option can be given multiple times (for different names,
70 <term>-m <replaceable>method</replaceable></term>
72 Specifies the HTTP method to be used for the next URL.
73 Default is method "GET". However, option -p sets it to "POST".
78 <term>-O <replaceable>fname</replaceable></term>
80 Sets output filename for HTTP content.
85 <term>-p <replaceable>fname</replaceable></term>
87 Sets a file to be POSTed in the folloing URL.
92 <term>-R <replaceable>num</replaceable></term>
94 Sets maximum number of HTTP redirects to be followed.
95 A value of zero disables follow of HTTP redirects.
100 <term>-u <replaceable>user/password</replaceable></term>
102 Specifies a user and a password to be uesd in HTTP
103 basic authentication in the following URL fetch. The user
104 and password must be separated by a slash (thus it is not
105 possible to specify a user with a slash in it).
112 Makes yaz-url dump each HTTP request/response to stdout.
117 <term>-x <replaceable>proxy</replaceable></term>
119 Specifies a proxy to be used for URL fetch.
125 <refsect1><title>SEE ALSO</title>
128 <refentrytitle>yaz</refentrytitle>
129 <manvolnum>7</manvolnum>
135 <!-- Keep this comment at the end of the file