Command line invocation
Without arguments
The user interface first has to connect to an existing manitou database.
Either the connection parameters are given on the command line, or
the program will display this dialog window:
Startup window when no connection parameters are passed
Fields left empty in this window get default values provided by
the PostgreSQL client-API:
- Database name: login name of the current unix user.
- Login: also the login name of the current unix user.
- Password: empty.
- Host: empty, which means connect locally to an unix domain socket.
- More parameters: empty.
These defaults can themselves be overriden with some PostgreSQL specific
environment variables, such as PGHOST, PGUSER or PGPORT.
Optional arguments
The possible arguments are:
- --dbcnx: list of space-separated
name=value parameters, all grouped
in one string (under a shell, the string should be enclosed in simple
or double quotes if it contains spaces).The more common parameters
are:
- user
- password
- host
- port
- dbname
For a full description of all possible parameters,
see the PostgreSQL
manual's section related to connecting to the database.
- --config: a configuration's name. See the
section about configurations for details.
- --debug-output: an integer debug level between 1 and 10. Useful only
for developpers.
Unix version
The syntax is --option_name=option value or option_name
option_value, different options being separated by white
spaces. Options can also be abbreviated by their first letters, for
example -d instead of --dbcnx.
Example:
$ manitou --dbcnx="dbname=mail user=dan host=pgserver" --config danconf
On X11, the program also accepts arguments for the windowing system, such as
-display, -fn, -geometry... Refer to your X-Window documentation for a complete
description.
MS-Windows version
The windows version also accepts arguments. They can either be
supplied when launching the program on a command line, or by creating
a desktop shortcut to manitou.exe with those arguments in the shortcut
"Target" entry.
Example:
c:\programs\manitou\manitou.exe --dbcnx "dbname=mail user=dan host=pgserver" --config myconf
(Note that an equal sign between the name and value of the options is NOT
permitted, contrary to the Unix version).