Add man page for Gonzalo's new tool. It needs a better example, and better explanations

svn path=/trunk/mono/; revision=69975

1 files changed, 71 insertions, 0 deletions

diff --git a/man/httpcfg.1 b/man/httpcfg.1
new file mode 100644
index 00000000000..9fafb8eaf2d
--- /dev/null
+++ b/man/httpcfg.1
@@ -0,0 +1,71 @@
+.\" 
+.\" httpcfg manual page.
+.\" Copyright 2006 Novell
+.\" Author:
+.\"   Miguel de Icaza (miguel@novell.com)
+.\"
+.TH Mono "httpcfg"
+.SH NAME
+httpcfg \- Mono Certificate Management for HttpListener
+.SH SYNOPSIS
+.PP
+.B httpcfg [options] certificate
+.SH DESCRIPTION
+This tool is used to manage the certificates used by the HttpListener
+embeddable server class when the HttpListener is configured as an
+HTTPS server instead of an HTTP server.   
+.PP
+You must select one of the possible actions: add, delete or list.
+.PP
+When adding a certificate (-add), you must provide the following
+information: a certificate (with the -cert flag) a Private Key file
+(with the -pvk argument, the filename is typically "pvk") and a port
+number (with the -port flag).
+.PP
+When deleting a certificate (-del or -delete) you need to provide the
+port number.
+.SH PARAMETERS
+.TP
+.I "-add"
+Adds a new certificate/private key combination for being used at a
+given port by the HttpListener API.
+.TP
+.I "-del," "-delete"
+Deletes the certificates associated for the port specified (must be
+specified separatedly).
+.TP
+.I "-list"
+List all known certificates. 
+.TP
+.I "-port PORT"
+Specifies the port to add certificates to, or remove certificates
+from. 
+.TP
+.I "-pvk FILE"
+Specifies the Private Key file.
+.TP
+.I "-cert CERT"
+Specifies the certificate file to use.
+.SH EXAMPLES
+.nf
+httpcfg -add -port 8081 -pvk myfile.pvk -cert MyCert
+.fi
+.PP
+.SH FILES
+The certificates are stored in the ~/.mono/httplistener directory
+.SH AUTHOR
+.B httpcfg
+was written by Gonzalo Paniagua.
+.SH COPYRIGHT
+Copyright (C) 2006 Novell. 
+.SH MAILING LISTS
+Visit http://lists.ximian.com/mailman/listinfo/mono-devel-list for details.
+.SH WEB SITE
+Visit http://www.mono-project.com for details
+.SH SEE ALSO
+.B makecert(1), signcode(1), cert2spc(1)
+.PP
+The private key format:
+.nf
+http://www.drh-consultancy.demon.co.uk/pvk.html
+.fi
\ No newline at end of file