Lancement à partir de la ligne de commande

Sans argument

L'interface utilisateur doit pour accéder aux messages, se connecter à une base de données manitou existante. Soit les paramètres de connexion sont fournis en ligne de commande, soit le programme affiche cette boîte de dialogue:

Fenêtre affichée au démarrage quand des paramètres de connexion ne sont pas fournis.
Les champs laissés vides dans cette fenêtre prennent des valeurs par défaut prévus dans l'API cliente PostgreSQL:

Nom de la base: par défaut, c'est le nom de connexion (login) de l'utilisateur unix courant.
Login: également le nom de connexion de l'utilisateur unix courant.
Password: vide.
Host: vide, ce qui signifie connexion locale via "unix domain socket".
More parameters: vide.

Ces valeurs par défaut peuvent elles-mêmes être ignorées et remplacées par les valeurs des variables d'environnement PGHOST, PGUSER or PGPORT, que celles-ci sont positionnées.

Arguments optionnels

Les arguments possibles sont:

--dbcnx: une liste de couples nom=valeur séparés entre eux par des espaces, et regroupées dans une chaîne de caractères (sous un shell, la chaîne doit être incluse entre guillemets ou apostrophes, si elle contient des espaces). Les paramètres les plus communs sont:
- user
- password
- host
- port
- dbname
Pour une description complète de tous les paramètres possibles, se référer dans la documentation PostgreSQL, à la section du manuel liée à la connexion à une base.
--config: un nom de configuration. Voir la section sur les configurations pour plus d'informations.
--debug-output: une valeur entière entre 1 et 10. Utile seulement aux développeurs.

Unix version

La syntaxe est --nom_option=valeur_option, les différentes options étant séparées par des espaces. Les options peuvent aussi être abrégées par leurs premières, par exemple -d au lieu de --dbcnx

Exemple:

$ manitou --dbcnx="dbname=mail user=dan host=pgserver" --config danconf

Sous X11, le programme accepte aussi des arguments spécifiques au système de fenêtrage, comme -display, -fn, -geometry... Se référer à une documentation X-Window documentation pour plus d'informations.

VersionMS-Windows

La version Windows accepte aussi les arguments en ligne de commande, excepté --debug-output. Ces arguments peuvent être tapés en lançant le programme dans une fenêtre shell (de type cmd.exe), ou en créant un raccourci vers manitou.exe avec ces arguments dans la définition du raccourci. Exemple:

c:\programs\manitou\manitou.exe --dbcnx "dbname=mail user=dan host=pgserver" --config myconf

(A noter qu'un signe égal entre le nom et la valeur de l'option n'est PAS permis, contrairement à la version Unix).