Adding Users with the Command Line Utility
The Add User program is a command line utility for WS_FTP Server; you can use it to add, modify, or delete users on an FTP host.
| Note: You cannot use this utility to add users to an FTP host that uses the Windows NT, or the IMail Server user database. |
The Add User utility accepts input from the MS-DOS prompt and returns messages to the MS_DOS display. You can type Add User commands at the MS-DOS prompt or run them in a batch file.
To start the Add User utility:
- Open an MS-DOS window and change directories to the WS_FTP Server directory.
- For a list of command options, enter: iftpaddu /?
If you invoke the utility with no command line options (by entering only iftpaddu at the MS-DOS prompt), you can then manually input commands, pressing Enter after each line. If you do this, press CTRL-Z to exit the utility when you are done.
Basic Command Syntax
iftpaddu -u userid [-h hostname] [-n "full name"] [-p password] [options]
iftpaddu -modify -u userid [-h hostname] [-n "full name"] [-p password] [options]
iftpaddu -kill -u userid [-h hostname
iftpaddu -all [-h hostname] [-x number -s number] [options]
| Argument |
When to use |
| -u userid |
Adds a user ID, where userid is the ID you want to add. This is the only required argument. Only one userid can be added in a single command. |
| -h hostname |
Specifies the user's FTP host, where hostname is the name of the FTP host. The primary FTP host is used if no host is specified. |
| -n "full name" |
Specifies the full name of the user in double quotes. |
| -p password |
Specifies a password for the user. If you omit this argument, the user's password is "password." |
| -s number |
Specifies a maximum number of files. |
| -x number |
Specifies a maximum amount of space in bytes. |
| -modify |
Use before entering any other arguments when you want to modify an existing user. |
| -kill |
Use to delete a user. You must enter -u userid. If the user is not on the primary FTP host, you must also enter -h hostname. |
| +active |
Enables the user to log on. (This is the default setting when adding a new user.) |
| -active |
Disables the user's ability to log on. |
| +chgpass |
Enables the user to change password from an FTP client. |
| -chgpass |
Disables the user's ability to change password from an FTP client. |
| +sysadm |
Grants the user System Administrator permissions. |
| -sysadm |
Removes System Administrator permissions from the user. |
| +hostadm |
Grants the user Host Administrator permissions. |
| -hostadm |
Removes Host Administrator permissions from the user. |
| +lockuser |
Locks a user to their home directory. May be used with the -all, -add, and -modify flags. |
| -lockuser |
Unlocks a user from their home directory. May be used with the -all, -add, and -modify flags. |
| -all |
This flag can be used in conjunction with the active, chgpass, sysadm, hostadm options to grant or remove permissions to all users on the system. It can also be used with the -s number and -x number arguments to set these parameters on all user accounts currently on the system. |
Adding a User
The following examples add a user ID of test01.
iftpaddu -h myhost.com -u test01 -n "ms test" -p yourpass
iftpaddu -u test01 -n "mr test" -p newpass
iftpaddu -u test01
Modifying a User
The following examples modify a user ID.
iftpaddu -modify -h myhost.com -u test01 -p newpass
iftpaddu -modify -h myhost.com -u test01 -chgpass
iftpaddu -modify -u test01 -active
Deleting a User
The following example deletes a user ID.
iftpaddu -kill -u test01 -h myhost.com
