| .\" 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 "2026-05-08" "Apache HTTP Server" "htdigest" | |
| .SH NAME | |
| htdigest \- manage user files for digest authentication | |
| .SH "SYNOPSIS" | |
| .PP | |
| \fB\fBhtdigest\fR [ -\fBc\fR ] \fIpasswdfile\fR \fIrealm\fR \fIusername\fR\fR | |
| .SH "SUMMARY" | |
| .PP | |
| \fBhtdigest\fR 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 \fBhtdigest\fR\&. | |
| .PP | |
| This manual page only lists the command line arguments\&. For details of the directives necessary to configure digest authentication in \fBhttpd\fR see the Apache manual, which is part of the Apache distribution or can be found at http://httpd\&.apache\&.org/\&. | |
| .SH "OPTIONS" | |
| .TP | |
| \fB-c\fR | |
| Create the \fIpasswdfile\fR\&. If \fIpasswdfile\fR already exists, it is deleted first\&. | |
| .TP | |
| \fB\fIpasswdfile\fR\fR | |
| Name of the file to contain the username, realm and password\&. If \fB-c\fR is given, this file is created if it does not already exist, or deleted and recreated if it does exist\&. | |
| .TP | |
| \fB\fIrealm\fR\fR | |
| The realm name to which the user name belongs\&. See 2617 for more details\&. | |
| .TP | |
| \fB\fIusername\fR\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\&. | |
| .SH "SECURITY CONSIDERATIONS" | |
| .PP | |
| This program is not safe as a setuid executable\&. Do \fInot\fR make it setuid\&. | |
| .SH "FILES" | |
| .PP | |
| The digest authentication file path is specified as an argument on the command line and may be located anywhere on the filesystem\&. | |
| .TP | |
| \fIpasswdfile\fR | |
| The flat-file containing usernames, realms, and password hashes\&. | |