POPsy currently ``exports'' 11 procedures, 8 of these are concerned with the user authentication database:
| Name | Meaning |
|---|---|
| popsy_shutdown | No arguments. The process receiving this command will exit immediately. Currently the only way to have a clean shutdown, with unregistration of the process at the name service |
| popsy_logto | One argument required, has to be either empty or a 2-element list. In the first case remote logging will be switched off. Interpreted as hostname and portnumber in the 2nd form, in this order. The receiving process will send its log to the specified address from then on. |
| popsy_configuration | No arguments. Returns the current configuration of the server as 4-element list. It contains, in this order: path to the base mailfolder, path to the user authentiction database file, the port used by the server and a 2-element list containing information about remote logging. This list contains the host and the port number to log to, in this order. |
| popsy_add_user | Three arguments, the name of the new user, its password and the spooldirectory to use. Adds the given information to the user authentication database. Neither name nor spooldir must be used by another entry. The spooldir is interpreted as a path relative to the base mailfolder. In case of a missing or empty spooldir argument the user name is used. |
| popsy_remove_user | Deletes the information about the user whose name was given as first and only argument. The spooldir is removed too, together with messages residing in it. |
| popsy_rename_user | Two arguments, the name of the user to be renamed, and its new identity. The new name must not be used by another entry. |
| popsy_cd_user | Changes the spooldirectory associated to the user. Two arguments, the name of the user to operate on, and the new path. The new path must not be used by another entry. |
| popsy_cp_user | Changes the password of the given user. Two arguments, the name of the user to operate on, and the new password. |
| popsy_query_user | Requests the information stored in the user authentication database about the user whose name was given as first and only argument. Return value is a 2-element list containing password and spooldirectory, in this order. |
| popsy_users | No arguments. Returns a list containing the names of all users known to the user authentication database. |
| popsy_user_save | No arguments. Saves the in-memory user authentication database back into the external file. Alternative description: Changes made to the database are made persistent. |
See apps/popsymon, apps/popsy_man for examples of their usage.
Generated by AutoDoc 2.4 at 09/14/2000, invoked by Andreas Kupries