<-
Apache > HTTP Server > Documentation > Version 2.0 > Programs

htdbm - Управляют базами данных пароля DBM

htdbm используется, чтобы управлять файлами формата DBM, используемыми, чтобы хранить имена пользователя и пароль для базовой аутентификации пользователей HTTP через mod_auth_dbm . см. dbmmanage документация за дополнительной информацией об этих файлах DBM.

см. также

top

Synopsis

htdbm [ - T DBTYPE ] [ - c ] [ - m | - d | - p | - s ] [ - t ] [ - v ] [ - x ] filename username

htdbm - b [ - T DBTYPE ] [ - c ] [ - m | - d | - p | - s ] [ - t ] [ - v ] filename username password

htdbm - n [ - c ] [ - m | - d | - p | - s ] [ - t ] [ - v ] username

htdbm - nb [ - c ] [ - m | - d | - p | - s ] [ - t ] [ - v ] username password

htdbm - v [ - T DBTYPE ] [ - c ] [ - m | - d | - p | - s ] [ - t ] [ - v ] filename username

htdbm - vb [ - T DBTYPE ] [ - c ] [ - m | - d | - p | - s ] [ - t ] [ - v ] filename username password

htdbm - x [ - T DBTYPE ] [ - m | - d | - p | - s ] filename username

htdbm - l [ - T DBTYPE ]

top

Options

-b
пакетный режим использования; то есть. , получите пароль от линии команды вместо того, чтобы вызвать для этого. Этот выбор должен использоваться с чрезвычайной заботой, с тех пор пароль ясно видим на линии команды.
-c
создать passwdfile . если passwdfile уже существует, это переписано и обрезано. Этот выбор не может быть объединен с -n выбор.
-n
показать результаты на стандартной продукции вместо того, чтобы обновить базу данных. Этот выбор изменяет синтаксис линии команды, начиная с passwdfile аргумент (обычно первый) опущен. Это не может быть объединено с -c выбор.
-m
использовать шифрование MD5 для паролей. На Windows, Сетевом обеспечении и TPF, это - неплатеж.
-d
использование crypt() шифрование для паролей. Неплатеж на всех платформах, но Windows, Сетевом обеспечении и TPF. Хотя возможно поддержано htdbm на всех платформах, это не поддержано httpd сервер на Windows, Сетевом обеспечении и TPF.
-s
Использовать шифрование SHA для паролей. Облегчает перемещение из/в серверы Netscape, используя Директивный Формат Обмена LDAP (ldif).
-p
пароли обычного текста использования. Хотя htdbm поддержит создание на всех платформах, httpd демон только примет простые пароли текста на Windows, Сетевом обеспечении и TPF.
-l
напечатать каждое из имен пользователя и комментариев от базы данных по stdout.
-t
интерпретировать заключительный параметр как комментарий. Когда этот выбор определен, дополнительная вереница может быть приложена к линии команды; эта вереница будет сохранена в области "Comment" базы данных, связанной с указанным именем пользователя.
-v
проверить имя пользователя и пароль. Программа напечатает сообщение, указывающее, действителен ли поставляемый пароль. Если пароль недействителен, выходы программы с ошибочным кодексом 3.
-x
удалить пользователя. Если имя пользователя будет существовать в указанном файле DBM, то это будет удалено.
filename
имя файла DBM форматирует файл. Обычно без расширения .db , .pag , или .dir . если -c дается, файл DBM создан, если это уже не существует, или обновленный, если это действительно существует.
username
имя пользователя, чтобы создать или обновлять в passwdfile . если имя пользователя не существует в этом файле, вход добавлен. Если это действительно существует, пароль изменен.
password
пароль обычного текста, который будет зашифрован и сохранен в файле DBM. Используемый только с -b флаг.
-T DBTYPE
тип файла DBM (SDBM, GDBM, ДЕЦИБЕЛ, или "неплатеж").
top

Bugs

нужно знать, что есть множество различных форматов файла DBM, уже существующих, и со всей вероятностью, библиотеки для больше чем одного формата могут существовать на вашей системе. Три первичных примера - SDBM, NDBM, ГНУ GDBM, и ДЕЦИБЕЛ Berkeley/Sleepycat 2/3/4. К сожалению, все эти библиотеки используют различные форматы файла, и Вы должны удостовериться что формат файла, используемый имя файла является тем же самым форматом это htdbm ожидает видеть. htdbm в настоящее время не имеет никакого способа определить, на какой файл DBM это смотрит. Если используется против неправильного формата, просто не возвратит ничто, или может создать различный файл DBM с различным названием, или в худшем случае, это может развратить файл DBM, если Вы пытались написать этому.

можно обычно использовать file программа снабжала большинством систем Unix, чтобы видеть, каков форматируют файл DBM, находится в.

top

Exit Status

htdbm возвращает нулевой статус ("верный"), если имя пользователя и пароль были успешно добавлены или обновлены в Файле DBM. htdbm возвращения 1 если это сталкивается с некоторой проблемой, получающей доступ к файлам, 2 если была проблема синтаксиса с линией команды, 3 если пароль был введен в интерактивном режиме, и вход проверки не соответствовал, 4 если его операция была прервана, 5 если ценность слишком длинна (имя пользователя, имя файла, пароль, или финал вычисленный отчет), 6 если имя пользователя содержит незаконные характеры (см. Restrictions section ), и 7 если файл не действительный файл пароля DBM.

top

Examples

htdbm /usr/local/etc/apache/.htdbm-users jsmith

добавляет или изменяет пароль для пользователя jsmith . пользователь побужден для пароля. Если выполнено на системе Windows, пароль будет зашифрован, используя измененный Apache алгоритм MD5; иначе, система crypt() рутина будет использоваться. Если файл не существует, htdbm не сделает ничего кроме возвращения ошибка.

htdbm -c /home/doe/public_html/.htdbm jane

создает новый файл и хранит отчет в этом для пользователя jane . пользователь побужден для пароля. Если файл существует и не может быть прочитан, или не может быть написан, это не изменено и htdbm покажет сообщение и возвратит ошибочный статус.

htdbm -mb /usr/web/.htdbm-all jones Pwd4Steve

зашифровал пароль от линии команды ( Pwd4Steve ) использование алгоритма MD5, и складов это в указанном файле.

top

Security Considerations

файлы пароля сети, типа управляемых htdbm если нет быть в пределах места ТУРОВ Web-сервера - то есть, они не должны быть fetchable с браузером.

использование -b выбору препятствуют, с тех пор, когда это используется, незашифрованный пароль появляется на линии команды.

top

Restrictions

на Windows и платформах MPE, пароли, зашифрованные с htdbm ограничены не больше, чем 255 характеры в длине. Более длинные пароли будут обрезаны к 255 характерам.

алгоритм MD5, используемый htdbm является определенным для Apacheского программного обеспечения; пароли, зашифрованные, используя это не будут годны к употреблению с другими Web-серверами.

имена пользователя ограничены 255 байты и, возможно, не включают характер : .