LWP::Simple − simple procedural interface to LWP


 perl −MLWP::Simple −e 'getprint "http://www.sn.no"'
 use LWP::Simple;
 $content = get("http://www.sn.no/");
 die "Couldn't get it!" unless defined $content;
 if (mirror("http://www.sn.no/", "foo") == RC_NOT_MODIFIED) {
 if (is_success(getprint("http://www.sn.no/"))) {


This module is meant for people who want a simplified view of the libwww-perl library. It should also be suitable for one-liners. If you need more control or access to the header fields in the requests sent and responses received, then you should use the full object-oriented interface provided by the "LWP::UserAgent" module.

The following functions are provided (and exported) by this module:

The get() function will fetch the document identified by the given URL and return it. It returns "undef" if it fails. The $url argument can be either a string or a reference to a URI object.

You will not be able to examine the response code or response headers (like ’Content−Type’) when you are accessing the web using this function. If you need that information you should use the full OO interface (see LWP::UserAgent).


Get document headers. Returns the following 5 values if successful: ($content_type, $document_length, $modified_time, $expires, $server)

Returns an empty list if it fails. In scalar context returns TRUE if successful.


Get and print a document identified by a URL . The document is printed to the selected default filehandle for output (normally STDOUT ) as data is received from the network. If the request fails, then the status code and message are printed on STDERR . The return value is the HTTP response code.

getstore($url, $file)

Gets a document identified by a URL and stores it in the file. The return value is the HTTP response code.

mirror($url, $file)

Get and store a document identified by a URL , using If-modified-since, and checking the Content-Length. Returns the HTTP response code.

This module also exports the HTTP::Status constants and procedures. You can use them when you check the response code from getprint(), getstore() or mirror(). The constants are:


The HTTP::Status classification functions are:

True if response code indicated a successful request.


True if response code indicated that an error occurred.

The module will also export the LWP::UserAgent object as $ua if you ask for it explicitly.

The user agent created by this module will identify itself as "LWP::Simple/#.##" and will initialize its proxy defaults from the environment (by calling $ua−>env_proxy).


Note that if you are using both LWP::Simple and the very popular CGI .pm module, you may be importing a "head" function from each module, producing a warning like "Prototype mismatch: sub main::head ($) vs none". Get around this problem by just not importing LWP::Simple’s "head" function, like so:

        use LWP::Simple qw(!head);
        use CGI qw(:standard);  # then only CGI.pm defines a head()

Then if you do need LWP::Simple’s "head" function, you can just call it as "LWP::Simple::head($url)".


LWP , lwpcook, LWP::UserAgent, HTTP::Status, lwp-request, lwp-mirror

More Linux Commands

glVertex2d(3gl) - specify a vertex - Linux manual page......
glVertex commands are used within glBegin/glEnd pairs to specify point, line, and polygon vertices. The current color, normal, and texture coordinates are assoc

imaxdiv(3) - compute quotient and remainder of an integer di
imaxdiv.3 - The div() function computes the value numerator/denominator and returns the quotient and remainder in a structure named div_t that contains two inte

atq(1) - queue, examine or delete jobs for later execution
at and batch read commands from standard input or a specified file which are to be executed at a later time, using /bin/sh. at executes commands at a specified

XrmQPutStringResource(3) - store database resources.........
If database contains NULL, XrmPutResource creates a new database and returns a pointer to it. XrmPutResource is a convenience function that calls XrmStringToBin

ldap_destroy(3) - Duplicate and destroy LDAP session handles
ldap_dup() duplicates an existing LDAP (LDAP *) session handle. The new session handle may be used concurrently with the original session handle. In a threaded

exp10(3) - base-10 exponential function - Linux manual page
The exp10() function returns the value of 10 raised to the power of x. RETURN VALUE On success, these functions return the base-10 exponential value of x. For v

pmap_getport(3) - library routines for remote procedure call
These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the s

process-keyring(7) Per-process shared keyring (Man Page)....
The process keyring is a keyring used to anchor keys on behalf of a process. It is only created when a process requests it. A special serial number value, KEY_S

blkdiscard(8) discard sectors on a device - Linux man page
blkdiscard is used to discard device sectors. This is useful for solid-state drivers (SSDs) and thinly-provisioned storage. Unlike fstrim(8), this command is us

glColor3s(3gl) - set the current color - Linux manual page
The GL stores both a current single-valued color index and a current four-valued RGBA color. glColor sets a new four-valued RGBA color. glColor has two major va

ldap_set_rebind_proc(3) - LDAP bind routines (Man Page).....
These routines provide various interfaces to the LDAP bind operation. After an association with an LDAP server is made using ldap_init(3), an LDAP bind operatio

mono-shlib-cop(1) - Shared Library Usage Checker (Man Page)
mono-shlib-cop is a tool that inspects a managed assembly looking for erroneous or suspecious usage of shared libraries. The tool takes one or more assembly fil

We can't live, work or learn in freedom unless the software we use is free.