man-pages/man1/lwp-dump.1p.html
2021-03-31 01:06:50 +01:00

100 lines
2.6 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of LWP-DUMP</TITLE>
</HEAD><BODY>
<H1>LWP-DUMP</H1>
Section: User Contributed Perl Documentation (1p)<BR>Updated: 2019-11-29<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
lwp-dump - See what headers and content is returned for a URL
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>lwp-dump</B> [ <I>options</I> ] <I></I><FONT SIZE="-1"><I>URL</I></FONT><I></I>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
The <B>lwp-dump</B> program will get the resource identified by the <FONT SIZE="-1">URL</FONT> and then
dump the response object to <FONT SIZE="-1">STDOUT.</FONT> This will display the headers returned and
the initial part of the content, escaped so that it's safe to display even
binary content. The escapes syntax used is the same as for Perl's double
quoted strings. If there is no content the string ``(no content)'' is shown in
its place.
<P>
The following options are recognized:
<DL COMPACT>
<DT id="1"><B>--agent</B> <I>string</I><DD>
Override the user agent string passed to the server.
<DT id="2"><B>--keep-client-headers</B><DD>
<FONT SIZE="-1">LWP</FONT> internally generate various <TT>&quot;Client-*&quot;</TT> headers that are stripped by
<B>lwp-dump</B> in order to show the headers exactly as the server provided them.
This option will suppress this.
<DT id="3"><B>--max-length</B> <I>n</I><DD>
How much of the content to show. The default is 512. Set this
to 0 for unlimited.
<P>
If the content is longer then the string is chopped at the
limit and the string ``...\n(### more bytes not shown)''
appended.
<DT id="4"><B>--method</B> <I>string</I><DD>
Use the given method for the request instead of the default ``<FONT SIZE="-1">GET''.</FONT>
<DT id="5"><B>--parse-head</B><DD>
By default <B>lwp-dump</B> will not try to initialize headers by looking at the
head section of <FONT SIZE="-1">HTML</FONT> documents. This option enables this. This corresponds to
``parse_head'' in LWP::UserAgent.
<DT id="6"><B>--request</B><DD>
Also dump the request sent.
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>SEE ALSO</H2>
lwp-request, <FONT SIZE="-1">LWP</FONT>, ``dump'' in HTTP::Message
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
<DT id="8"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="9"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="10"><A HREF="#lbAE">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:18 GMT, March 31, 2021
</BODY>
</HTML>