rubbos/app/httpd-2.0.64/docs/man/htdigest.1

   1 .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2 .\" DO NOT EDIT! Generated from XML source.
   3 .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   4 .de Sh \" Subsection
   5 .br
   6 .if t .Sp
   7 .ne 5
   8 .PP
   9 \fB\\$1\fR
  10 .PP
  11 ..
  12 .de Sp \" Vertical space (when we can't use .PP)
  13 .if t .sp .5v
  14 .if n .sp
  15 ..
  16 .de Ip \" List item
  17 .br
  18 .ie \\n(.$>=3 .ne \\$3
  19 .el .ne 3
  20 .IP "\\$1" \\$2
  21 ..
  22 .TH "HTDIGEST" 1 "2004-01-06" "Apache HTTP Server" "htdigest"
  23
  24 .SH NAME
  25 htdigest \- manage user files for digest authentication
  26
  27 .SH "SYNOPSIS"
  28
  29 .PP
  30 \fBhtdigest\fR [ -\fBc\fR ] \fIpasswdfile\fR \fIrealm\fR \fIusername\fR
  31
  32
  33 .SH "SUMMARY"
  34
  35 .PP
  36 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\&.
  37
  38 .PP
  39 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/\&.
  40
  41
  42 .SH "OPTIONS"
  43
  44
  45 .TP
  46 -c
  47 Create the \fIpasswdfile\fR\&. If \fIpasswdfile\fR already exists, it is deleted first\&.
  48 .TP
  49 \fIpasswdfile\fR
  50 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\&.
  51 .TP
  52 \fIrealm\fR
  53 The realm name to which the user name belongs\&.
  54 .TP
  55 \fIusername\fR
  56 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\&.
  57