Apache HTTP Server 2.1 Documentation Status File.
-Last modified: $Date: 2003/04/30 23:25:08 $
+Last modified: $Date: 2003/05/01 00:39:16 $
For more information on how to contribute to the Apache Documentation
Project, please see http://httpd.apache.org/docs-project/
developer/API.html
# converting from nroff to xml
-programs/htdigest.html
programs/htpasswd.html
programs/other.html
-.TH htdigest 1 "January 2001"
-.\" The Apache Software License, Version 1.1
-.\"
-.\" Copyright (c) 2000-2003 The Apache Software Foundation. All rights
-.\" reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\"
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in
-.\" the documentation and/or other materials provided with the
-.\" distribution.
-.\"
-.\" 3. The end-user documentation included with the redistribution,
-.\" if any, must include the following acknowledgment:
-.\" "This product includes software developed by the
-.\" Apache Software Foundation (http://www.apache.org/)."
-.\" Alternately, this acknowledgment may appear in the software itself,
-.\" if and wherever such third-party acknowledgments normally appear.
-.\"
-.\" 4. The names "Apache" and "Apache Software Foundation" must
-.\" not be used to endorse or promote products derived from this
-.\" software without prior written permission. For written
-.\" permission, please contact apache@apache.org.
-.\"
-.\" 5. Products derived from this software may not be called "Apache",
-.\" nor may "Apache" appear in their name, without prior written
-.\" permission of the Apache Software Foundation.
-.\"
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
-.\" WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
-.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-.\" DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
-.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
-.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
-.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\" This software consists of voluntary contributions made by many
-.\" individuals on behalf of the Apache Software Foundation. For more
-.\" information on the Apache Software Foundation, please see
-.\" <http://www.apache.org/>.
-.\"
+.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+.\" DO NOT EDIT! Generated from XML source.
+.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+.de Sh \" Subsection
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Ip \" List item
+.br
+.ie \\n(.$>=3 .ne \\$3
+.el .ne 3
+.IP "\\$1" \\$2
+..
+.TH "HTDIGEST" 1 "2003-05-01" "Apache HTTP Server" "htdigest"
+
.SH NAME
-htdigest \- Create and update user authentication files
-.SH SYNOPSIS
-.B htdigest
-[
-.B \-c
-]
-.I passwdfile
-.I realm
-.I username
-.SH DESCRIPTION
-.B htdigest
-is used to create and update the flat-files used to store
-usernames, realm and password for digest authentication of HTTP users.
-Resources available from the
-.B httpd
-Apache web server can be restricted to just the users listed
-in the files created by
-.B htdigest.
+htdigest \- manage user files for digest authentication
+
+.SH "SYNOPSIS"
+
+.PP
+\fBhtdigest\fR [ -\fBc\fR ] \fIpasswdfile\fR \fIrealm\fR \fIusername\fR
+
+
+.SH "SUMMARY"
+
+.PP
+htdigest is used to create and update the flat-files used to store usernames, realm and password for digest authentication of HTTP users\&. Resources available from the Apache HTTP server can be restricted to just the users listed in the files created by htdigest\&.
+
.PP
-This manual page only lists the command line arguments. For details of
-the directives necessary to configure digest authentication in
-.B httpd
-see
-the Apache manual, which is part of the Apache distribution or can be
-found at http://www.apache.org/.
-.SH OPTIONS
-.IP \-c
-Create the \fIpasswdfile\fP. If \fIpasswdfile\fP already exists, it
-is deleted first.
-.IP \fB\fIpasswdfile\fP
-Name of the file to contain the username, realm and password. If \-c
-is given, this file is created if it does not already exist,
-or deleted and recreated if it does exist.
-.IP \fB\fIrealm\fP
-The realm name to which the user name belongs.
-.IP \fB\fIusername\fP
-The user name to create or update in \fBpasswdfile\fP. If
-\fIusername\fP does not exist is this file, an entry is added. If it
-does exist, the password is changed.
-.SH SEE ALSO
-.BR httpd(8)
-.
+This manual page only lists the command line arguments\&. For details of the directives necessary to configure digest authentication in httpd see the Apache manual, which is part of the Apache distribution or can be found at http://httpd\&.apache\&.org/\&.
+
+
+.SH "OPTIONS"
+
+.RS
+
+.TP
+-c
+Create the \fIpasswdfile\fR\&. If \fIpasswdfile\fR already exists, it is deleted first\&.
+.TP
+\fIpasswdfile\fR
+Name of the file to contain the username, realm and password\&. If -c is given, this file is created if it does not already exist, or deleted and recreated if it does exist\&.
+.TP
+\fIrealm\fR
+The realm name to which the user name belongs\&.
+.TP
+\fIusername\fR
+The user name to create or update in \fIpasswdfile\fR\&. If \fIusername\fR does not exist is this file, an entry is added\&. If it does exist, the password is changed\&.
+.RE
+
+++ /dev/null
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta name="generator" content="HTML Tidy, see www.w3.org" />
-
- <title>Manual Page: htdigest - Apache HTTP Server</title>
- </head>
-
- <body bgcolor="#ffffff" text="#000000" link="#0000ff"
- vlink="#000080" alink="#ff0000">
- <div align="center">
- <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" />
-
- <h3>Apache HTTP Server Version 2.1</h3>
- </div>
-
-
-
- <h1 align="center">Manual Page: htdigest</h1>
- <!-- This document was autogenerated from the man page -->
-<pre>
-<strong>NAME</strong>
- htdigest - Create and update user authentication files
-
-<strong>SYNOPSIS</strong>
- <strong>htdigest</strong> [ -<strong>c</strong> ] <em>passwdfile realm username</em>
-
-<strong>DESCRIPTION</strong>
- <strong>htdigest</strong> is used to create and update the flat-files used to
- store usernames, realm and password for digest authentica-
- tion of HTTP users. Resources available from the <strong>httpd</strong>
- Apache web server can be restricted to just the users listed
- in the files created by <strong>htdigest.</strong>
-
- This manual page only lists the command line arguments. For
- details of the directives necessary to configure digest
- authentication in <strong>httpd</strong> see the Apache manual, which is part
- of the Apache distribution or can be found at
- http://www.apache.org/.
-
-<strong>OPTIONS</strong>
- -c Create the <em>passwdfile</em>. If <em>passwdfile</em> already exists, it
- is deleted first.
-
- <em>passwdfile</em>
- Name of the file to contain the username, realm and
- password. If -c is given, this file is created if it
- does not already exist, or deleted and recreated if it
- does exist.
-
- <em>realm</em>
- The realm name to which the user name belongs.
-
- <em>username</em>
- The user name to create or update in <strong>passwdfile</strong>. If
- <em>username</em> does not exist is this file, an entry is
- added. If it does exist, the password is changed.
-
-<strong>SEE ALSO</strong>
- <strong>httpd(8)</strong>
-
-</pre>
- <hr />
-
- <h3 align="center">Apache HTTP Server Version 2.1</h3>
- <a href="./"><img src="../images/index.gif" alt="Index" /></a>
- <a href="../"><img src="../images/home.gif" alt="Home" /></a>
-
-
- </body>
-</html>
-
--- /dev/null
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>htdigest - manage user files for digest authentication - Apache HTTP Server</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
+<p class="apache">Apache HTTP Server Version 2.1</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>htdigest - manage user files for digest authentication</h1>
+ <p><code>htdigest</code> is used to create and update the flat-files used
+ to store usernames, realm and password for digest authentication of HTTP
+ users. Resources available from the Apache HTTP server can be restricted
+ to just the users listed in the files created by <code>htdigest</code>.</p>
+
+ <p>This manual page only lists the command line arguments. For details of
+ the directives necessary to configure digest authentication in
+ <a href="httpd.html">httpd</a> see the Apache manual, which is part
+ of the Apache distribution or can be found at
+ <a href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
+</ul><h3>See also</h3><ul class="seealso"><li><a href="httpd.html">httpd</a></li><li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li></ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="synopsis" id="synopsis">Synopsis</a></h2>
+ <p><code><strong>htdigest</strong> [ -<strong>c</strong> ]
+ <var>passwdfile</var> <var>realm</var> <var>username</var></code></p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="options" id="options">Options</a></h2>
+ <dl>
+ <dt><code>-c</code></dt>
+ <dd>Create the <var>passwdfile</var>. If <var>passwdfile</var> already
+ exists, it is deleted first.</dd>
+
+ <dt><code><var>passwdfile</var></code></dt>
+ <dd>Name of the file to contain the username, realm and password. If
+ <code>-c</code> is given, this file is created if it does not already
+ exist, or deleted and recreated if it does exist.</dd>
+
+ <dt><code><var>realm</var></code></dt>
+ <dd>The realm name to which the user name belongs.</dd>
+
+ <dt><code><var>username</var></code></dt>
+ <dd>The user name to create or update in <var>passwdfile</var>. If
+ <var>username</var> does not exist is this file, an entry is added. If it
+ does exist, the password is changed.</dd>
+ </dl>
+</div></div>
+<div id="footer">
+<p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
+</body></html>
\ No newline at end of file
--- /dev/null
+<?xml version='1.0' encoding='UTF-8' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
+<manualpage metafile="htdigest.xml.meta">
+<parentdocument href="./">Programs</parentdocument>
+
+<title>htdigest - manage user files for digest authentication</title>
+
+<summary>
+ <p><code>htdigest</code> is used to create and update the flat-files used
+ to store usernames, realm and password for digest authentication of HTTP
+ users. Resources available from the Apache HTTP server can be restricted
+ to just the users listed in the files created by <code>htdigest</code>.</p>
+
+ <p>This manual page only lists the command line arguments. For details of
+ the directives necessary to configure digest authentication in
+ <a href="httpd.html">httpd</a> see the Apache manual, which is part
+ of the Apache distribution or can be found at
+ <a href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
+</summary>
+<seealso><a href="httpd.html">httpd</a></seealso>
+<seealso><module>mod_auth_digest</module></seealso>
+
+<section id="synopsis"><title>Synopsis</title>
+ <p><code><strong>htdigest</strong> [ -<strong>c</strong> ]
+ <var>passwdfile</var> <var>realm</var> <var>username</var></code></p>
+</section>
+
+<section id="options"><title>Options</title>
+ <dl>
+ <dt><code>-c</code></dt>
+ <dd>Create the <var>passwdfile</var>. If <var>passwdfile</var> already
+ exists, it is deleted first.</dd>
+
+ <dt><code><var>passwdfile</var></code></dt>
+ <dd>Name of the file to contain the username, realm and password. If
+ <code>-c</code> is given, this file is created if it does not already
+ exist, or deleted and recreated if it does exist.</dd>
+
+ <dt><code><var>realm</var></code></dt>
+ <dd>The realm name to which the user name belongs.</dd>
+
+ <dt><code><var>username</var></code></dt>
+ <dd>The user name to create or update in <var>passwdfile</var>. If
+ <var>username</var> does not exist is this file, an entry is added. If it
+ does exist, the password is changed.</dd>
+ </dl>
+</section>
+
+</manualpage>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<metafile>
+ <basename>htdigest</basename>
+ <path>/programs/</path>
+ <relpath>..</relpath>
+
+ <variants>
+ <variant>en</variant>
+ </variants>
+</metafile>
<!-- documents not converted (yet?). -->
<not-exists>
<file>developer/API.xml</file>
- <file>programs/htdigest.xml</file>
<file>programs/htpasswd.xml</file>
<file>programs/other.xml</file>
</not-exists>