htadm command

Purpose

Use the htadm command to control your server password files. Your server uses password files to control access to your files. You can add a user name to a password file, delete a user from a password file, verify a user’s password, and create an empty password file. You can also change a password for a user by first deleting the user's password and then creating a new one.

Note:
When you use the htadm command to add a user, change a password, or check a password, you must enter the password on the command line. Because the command destroys the password from the command line as soon as possible, it is highly unlikely that you can see a user’s password by looking at the process listing on the machine (with the ps command, for example).

Format

htadm -Flag  [Modifier]

Parameters

-adduser password-file user-name [password [real-name]]
Adds a user and password into the password file. If you enter the command with only password-file, you are prompted for the other parameters.
password-file
The path and name of the password file to which you want to add the user.
user-name
The name of the user you want to add.

Use only alphabetic and numeric characters for the user name; do not use special characters.

The command fails if there is already a user of the same name in the password file.

password
The password you want to define for the user name.

Passwords can be up to 32 characters long. Use only alphabetic and numeric characters for the password; do not use special characters.

Notes:
  1. Some browsers are unable to read and send passwords longer than eight characters. Because of this limitation, if you define a password longer than eight characters, the server recognizes either the complete password or just the first eight characters of the password as valid.
  2. The administrator user name and password are case-sensitive even if the operating system is not case-sensitive. Be sure to input the exact user name and password entered using the htadm command when accessing the Configuration and Administration forms.
real-name
A comment or name you want to use to identify the user name you are adding. Whatever you enter will be written into the password file.
-deluser password-file [user-name]
Deletes a user from the password file. If you enter the command with only password-file, you are prompted for the user-name parameter.
password-file
The path and name of the password file from which you want to delete a user.
user-name
The name of the user you want to delete. The command fails if the user name you specify does not exist in the password file.
-passwd password-file [user-name [password]]
Changes the password for a user name already defined in the password file. If you enter the command with only password-file, you are prompted for the other parameters.
password-file
The path and name of the password file that contains the user name whose password you want to change.
user-name
The user name whose password you want to change. The command fails if the user name you specify does not exist in the password file.
password
The new password you want to define for the user name.

Passwords can be up to 32 characters long. Use only alphabetic and numeric characters for the password; do not use special characters.

Notes:
  1. Some browsers are unable to read and send passwords longer than eight characters. Because of this limitation, if you define a password longer than eight characters, the server recognizes either the complete password or just the first eight characters of the password as valid.
  2. The administrator user name and password are case-sensitive even if the operating system is not case-sensitive. Be sure to input the exact user name and password entered using the htadm command when accessing the Configuration and Administration forms.
-check password-file [user-name [password]]
Verifies the password for a user name already defined in the password file and lets you know if it is correct or not. If you enter the command with only password-file, you are prompted for the other parameters.
password-file
The path and name of the password file that contains the user name whose password you want to verify.
user-name
The user name whose password you want to verify. The command fails if the user name you specify does not exist in the password file.
password
The password that you want to verify. If the password you enter is the one defined for the user name, the command writes Correct to standard output and completes with a 0 return code. If the password you enter is not the one defined for the user name, the command writes Incorrect to standard output.
-create password-file
Create an empty password file.
password-file
The path and name of the password file that you want to create.

Examples