DROPUSER(1) PostgreSQL Client Applications DROPUSER(1)
NAME dropuser - remove a PostgreSQL user account
SYNOPSIS dropuser [ option... ] [ username ]
DESCRIPTION dropuser removes an existing PostgreSQL user. Only superusers and users with the CREATEROLE privilege can remove PostgreSQL users. (To remove a superuser, you must yourself be a superuser.)
dropuser is a wrapper around the SQL command DROP ROLE [drop_role(7)]. There is no effective difference between dropping users via this util- ity and via other methods for accessing the server.
OPTIONS dropuser accepts the following command-line arguments:
username Specifies the name of the PostgreSQL user to be removed. You will be prompted for a name if none is specified on the command line.
--echo Echo the commands that dropuser generates and sends to the server.
--interactive Prompt for confirmation before actually removing the user.
dropuser also accepts the following command-line arguments for connec- tion parameters:
--host host Specifies the host name of the machine on which the server is running. If the value begins with a slash, it is used as the directory for the Unix domain socket.
--port port Specifies the TCP port or local Unix domain socket file exten- sion on which the server is listening for connections.
--username username User name to connect as (not the user name to drop).
--no-password Never issue a password prompt. If the server requires password authentication and a password is not available by other means such as a .pgpass file, the connection attempt will fail. This option can be useful in batch jobs and scripts where no user is present to enter a password.
--password Force dropuser to prompt for a password before connecting to a database.
This option is never essential, since dropuser will automati- cally prompt for a password if the server demands password authentication. However, dropuser will waste a connection attempt finding out that the server wants a password. In some cases it is worth typing -W to avoid the extra connection attempt.
PGUSER Default connection parameters
This utility, like most other PostgreSQL utilities, also uses the envi- ronment variables supported by libpq (see in the documentation).
DIAGNOSTICS In case of difficulty, see DROP ROLE [drop_role(7)] and psql(1) for discussions of potential problems and error messages. The database server must be running at the targeted host. Also, any default connec- tion settings and environment variables used by the libpq front-end library will apply.
EXAMPLES To remove user joe from the default database server:
$ dropuser joe
To remove user joe using the server on host eden, port 5000, with veri- fication and a peek at the underlying command:
$ dropuser -p 5000 -h eden -i -e joe Role "joe" will be permanently removed. Are you sure? (y/n) y DROP ROLE joe;
SEE ALSO createuser(1), DROP ROLE [drop_role(7)]
Application 2014-02-17 DROPUSER(1)