.\" Copyright (c) 2003
.\"	Dirk-Willem van Gulik.  All rights reserved.
.\"	See http://www.webweaving.org/LICENSE for licensing details.
.\"
.Dd Januari, 2002
.Dt POSTER 1
.Os
.Sh NAME
.Nm poster
.Nd posts a file to a web site using the HTTP POST method.
.Sh SYNOPSIS
.Nm
.Op Fl v
.Op key=value
uploadfield 
.Op file
URL
.Sh DESCRIPTION
The
.Nm
utility post the file specified (or stdin)  to the web site using HTTP POST; and acts
in much the same way as the 'Upload' buttons commonly seen in html forms.
.Pp
The
.Fl key=value
contains additional parameters.
.Pp
.Fl v
flag makes the process verbose.
.Sh BUGS
You cannot have things like binary 0 values in normal key/field names. And the length
field is always set to 1 Mbyte as perl's 'CGI.pm' insists on a lenght of sorts and I do
not fancy calculating the lenght up front.
.Sh EXIT CODES
The utility will return a non zero exit code on error. A zero exit code
signals that the web server replied with a '200 OK'.
.Sh HISTORY
Written from scratch in May 2003 by Dirk-Willem van Gulik for the
WirelssLeiden.nl dumpster project.